diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 00000000..1a676efb
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,63 @@
+# Git
+.git
+.gitignore
+
+# Docker
+.dockerignore
+Dockerfile
+docker-compose*.yml
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+venv/
+.venv/
+
+# Data directories (mounted as volumes)
+data/
+uploads/
+instance/
+exports/
+auto-process/
+
+# Non-runtime directories
+temp/
+docs/
+site/
+plan/
+unraid/
+tests/
+.claude/
+.migrate/
+.github/
+
+# IDE and editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Logs and misc
+*.log
+*.md
+!requirements*.txt
+LICENSE
+CLAUDE.md
diff --git a/.env.example b/.env.example
deleted file mode 100644
index 32f662f1..00000000
--- a/.env.example
+++ /dev/null
@@ -1,21 +0,0 @@
-# OpenRouter API Configuration
-OPENROUTER_API_KEY=your_openrouter_api_key_here
-OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
-# Choose a model compatible with function calling / JSON mode on OpenRouter
-# Example: "openai/gpt-3.5-turbo" or "google/gemini-pro" (check OpenRouter docs for compatible models)
-OPENROUTER_MODEL_NAME="openai/gpt-4o-mini"
-
-# OpenAI API Configuration (for transcription)
-TRANSCRIPTION_API_KEY=your_openai_api_key_here
-TRANSCRIPTION_BASE_URL=http://your_local_api_url:port/v1/
-
-# Whisper Model Configuration
-# Default: "Systran/faster-distil-whisper-large-v3"
-WHISPER_MODEL="Systran/faster-distil-whisper-large-v3"
-
-# Application Settings
-# Set to "false" to disable new account registration
-ALLOW_REGISTRATION="true"
-
-# Security
-SECRET_KEY=your_secret_key_here
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..8653a3fc
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,29 @@
+# Ensure shell scripts always use LF line endings, even on Windows
+*.sh text eol=lf
+
+# Ensure Python files use LF line endings
+*.py text eol=lf
+
+# Docker files should use LF
+Dockerfile text eol=lf
+docker-compose*.yml text eol=lf
+.dockerignore text eol=lf
+
+# Config files should use LF
+*.example text eol=lf
+*.conf text eol=lf
+*.config text eol=lf
+
+# Documentation uses LF
+*.md text eol=lf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.ico binary
+*.gif binary
+*.webp binary
+*.db binary
+*.pyc binary
+
diff --git a/.github/CLA-SETUP.md b/.github/CLA-SETUP.md
new file mode 100644
index 00000000..e008176f
--- /dev/null
+++ b/.github/CLA-SETUP.md
@@ -0,0 +1,200 @@
+# CLA Assistant Setup Instructions
+
+This document explains how to set up automated CLA checking for Speakr.
+
+## What We're Using
+
+**CLA Assistant** - A free, open-source GitHub Action that automatically:
+- Comments on PRs asking contributors to sign the CLA
+- Tracks who has signed
+- Blocks PR merging until CLA is signed
+- Stores signatures in a JSON file
+
+## Setup Steps
+
+### 1. Create a Personal Access Token (PAT)
+
+The CLA Assistant needs a GitHub Personal Access Token to create commits for storing signatures.
+
+1. Go to GitHub Settings → Developer Settings → Personal Access Tokens → Tokens (classic)
+   - Or visit: https://github.com/settings/tokens
+
+2. Click "Generate new token" → "Generate new token (classic)"
+
+3. Give it a descriptive name: `Speakr CLA Assistant`
+
+4. Set expiration: `No expiration` (or your preferred duration)
+
+5. Select scopes:
+   - ✅ `repo` (Full control of private repositories)
+   - ✅ `workflow` (Update GitHub Action workflows)
+
+6. Click "Generate token"
+
+7. **IMPORTANT**: Copy the token immediately (you won't see it again!)
+
+### 2. Add Token to Repository Secrets
+
+1. Go to your repository: https://github.com/murtaza-nasir/speakr
+
+2. Navigate to: Settings → Secrets and variables → Actions
+
+3. Click "New repository secret"
+
+4. Name: `PERSONAL_ACCESS_TOKEN`
+
+5. Value: Paste the token you copied in step 1
+
+6. Click "Add secret"
+
+### 3. Commit the CLA Files
+
+The files have been created locally. Commit them:
+
+```bash
+git add CLA.md CONTRIBUTING.md .github/workflows/cla.yml .github/CLA-SETUP.md
+git commit -m "Add Contributor License Agreement and automated CLA checking"
+git push
+```
+
+### 4. Create the Signatures Branch
+
+The CLA Assistant will store signatures in a separate branch:
+
+```bash
+# Create and push the signatures branch
+git checkout -b cla-signatures
+git push -u origin cla-signatures
+git checkout master  # or main
+```
+
+### 5. Update README.md (Optional but Recommended)
+
+Add a badge to show CLA status. Add this near the top of README.md:
+
+```markdown
+[![CLA assistant](https://cla-assistant.io/readme/badge/murtaza-nasir/speakr)](https://cla-assistant.io/murtaza-nasir/speakr)
+```
+
+Add a link in the Contributing section:
+
+```markdown
+## Contributing
+
+We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) to learn about our CLA process and development workflow.
+```
+
+### 6. Test the Setup
+
+1. Create a test PR from a different account or ask someone to create one
+
+2. The CLA bot should automatically comment asking for signature
+
+3. They sign by commenting: `I have read the CLA Document and I hereby sign the CLA`
+
+4. The bot updates the PR with a success message
+
+## How It Works
+
+### For Contributors
+
+1. They open a PR
+2. Bot comments with CLA instructions
+3. They read [CLA.md](../CLA.md)
+4. They comment: `I have read the CLA Document and I hereby sign the CLA`
+5. Bot records signature in `.github/signatures/cla.json` on `cla-signatures` branch
+6. Bot marks PR as CLA-signed ✅
+7. Future PRs from same user are auto-approved
+
+### For Maintainers
+
+- You'll see CLA status checks on PRs
+- Signatures are stored in `.github/signatures/cla.json`
+- You can manually check signatures anytime
+- Merging is only possible after CLA is signed
+
+## Viewing Signatures
+
+All signatures are stored in:
+```
+https://github.com/murtaza-nasir/speakr/blob/cla-signatures/.github/signatures/cla.json
+```
+
+Format:
+```json
+{
+  "signedContributors": [
+    {
+      "name": "username",
+      "id": 12345,
+      "comment_id": 67890,
+      "created_at": "2025-01-18T12:34:56Z",
+      "repoId": 123456789,
+      "pullRequestNo": 42
+    }
+  ]
+}
+```
+
+## Troubleshooting
+
+### Bot Not Commenting on PRs
+
+- Check that PERSONAL_ACCESS_TOKEN secret is set
+- Verify token has correct permissions
+- Check GitHub Actions are enabled for repo
+- Look at Actions tab for error logs
+
+### "Branch 'cla-signatures' not found"
+
+```bash
+git checkout -b cla-signatures
+git push -u origin cla-signatures
+git checkout master
+```
+
+### Need to Reset Signatures
+
+To remove all signatures (use carefully!):
+```bash
+git checkout cla-signatures
+rm .github/signatures/cla.json
+git commit -m "Reset CLA signatures"
+git push
+```
+
+### Want Someone to Re-sign
+
+Delete their entry from `.github/signatures/cla.json` and commit:
+```bash
+git checkout cla-signatures
+# Edit .github/signatures/cla.json to remove the user
+git add .github/signatures/cla.json
+git commit -m "Remove CLA signature for username"
+git push
+git checkout master
+```
+
+## Customization
+
+You can customize the CLA bot messages by editing `.github/workflows/cla.yml`:
+
+- `custom-notsigned-prcomment` - Message shown to unsigned contributors
+- `custom-pr-sign-comment` - Message after signing
+- `custom-allsigned-prcomment` - Message when all have signed
+- `allowlist` - Users who don't need to sign (bots, etc.)
+
+## Alternative: Lighter Weight DCO
+
+If you want something simpler, consider using **Developer Certificate of Origin (DCO)** instead:
+- Contributors add `Signed-off-by: Name <email>` to commits
+- No separate signature required
+- Less formal but still legally binding
+- Used by Linux kernel and many projects
+
+Let me know if you'd prefer DCO instead!
+
+## Support
+
+- CLA Assistant Docs: https://github.com/contributor-assistant/github-action
+- Issues with setup? Open an issue in this repo
diff --git a/.github/workflows/cla.yml b/.github/workflows/cla.yml
new file mode 100644
index 00000000..fe77eb84
--- /dev/null
+++ b/.github/workflows/cla.yml
@@ -0,0 +1,39 @@
+name: "CLA Reminder"
+on:
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  cla-reminder:
+    if: github.event_name == 'pull_request_target'
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Post CLA Reminder"
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const prNumber = context.payload.pull_request?.number;
+            if (!prNumber) {
+              console.log('No PR number found, skipping');
+              return;
+            }
+            const body = `Thank you for your contribution!
+
+            By submitting this pull request, you agree to the terms of our [Contributor License Agreement (CLA)](https://github.com/${context.repo.owner}/${context.repo.repo}/blob/master/CLA.md).
+
+            **Key points:**
+            - You retain copyright ownership of your contribution
+            - You grant us permission to use your contribution under our dual-license model (AGPLv3 and Commercial)
+            - This allows us to include your contribution in both the open source and commercial versions of Speakr
+
+            If you have any questions about the CLA, please let us know!`.replace(/^ {12}/gm, '');
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+              body: body
+            });
diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml
new file mode 100644
index 00000000..b2e17abc
--- /dev/null
+++ b/.github/workflows/docker-publish.yml
@@ -0,0 +1,178 @@
+name: Docker Build and Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+env:
+  # Use docker.io for Docker Hub if empty
+  REGISTRY: docker.io
+  # Use explicit image name instead of github.repository
+  IMAGE_NAME: learnedmachine/speakr
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: speakr
+          POSTGRES_PASSWORD: speakr
+          POSTGRES_DB: speakr_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U speakr"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run static migration compatibility tests
+        run: python tests/test_migration_compatibility.py
+
+      - name: Run migrations against PostgreSQL
+        env:
+          TEST_DATABASE_URI: postgresql://speakr:speakr@localhost:5432/speakr_test
+        run: python tests/test_postgres_migrations.py
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      # This is used to complete the identity challenge
+      # with sigstore/fulcio when running outside of PRs.
+      id-token: write
+
+    steps:
+      # Free up disk space on the runner (~30GB)
+      - name: Free disk space
+        run: |
+          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache
+          sudo docker image prune -af
+          df -h /
+
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      # Set up QEMU for multi-platform builds
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      # Set up Docker Buildx
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      # Login to Docker Hub
+      - name: Log into registry ${{ env.REGISTRY }}
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      # Extract metadata (tags, labels) for Docker
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=match,pattern=v(.*),group=1
+            type=sha
+            type=raw,value=latest,enable=${{ github.event_name == 'workflow_dispatch' || github.event_name == 'release' }}
+
+      # Build and push full Docker image
+      - name: Build and push Docker image
+        id: build-and-push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          build-args: |
+            PRODUCTION=1
+
+  build-lite:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
+
+    steps:
+      # Free up disk space on the runner (~30GB)
+      - name: Free disk space
+        run: |
+          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache
+          sudo docker image prune -af
+          df -h /
+
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      # Set up QEMU for multi-platform builds
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      # Set up Docker Buildx
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      # Login to Docker Hub
+      - name: Log into registry ${{ env.REGISTRY }}
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      # Extract metadata for lite image
+      - name: Extract Docker metadata (lite)
+        id: meta-lite
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=lite,enable=${{ github.event_name == 'workflow_dispatch' || github.event_name == 'release' }}
+            type=match,pattern=v(.*),group=1,suffix=-lite
+            type=sha,suffix=-lite
+
+      # Build and push lightweight Docker image (no PyTorch/sentence-transformers)
+      - name: Build and push lite Docker image
+        id: build-and-push-lite
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta-lite.outputs.tags }}
+          labels: ${{ steps.meta-lite.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          build-args: |
+            PRODUCTION=1
+            LIGHTWEIGHT=1
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..053ab34d
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,64 @@
+name: Deploy Documentation
+
+on:
+  release:
+    types: [published]
+  push:
+    tags: [ 'v*.*.*' ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+          
+      - name: Install MkDocs and dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -r docs/requirements-docs.txt
+          
+      - name: Build documentation
+        env:
+          CI: true  # This enables git-revision-date plugin in CI
+        run: |
+          cd docs
+          # Update site_url for GitHub Pages if needed
+          if [ "${{ github.repository }}" != "murtaza-nasir/speakr" ]; then
+            sed -i "s|site_url:.*|site_url: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}|" mkdocs.yml
+          fi
+          mkdocs build --strict --site-dir _site
+          
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: ./docs/_site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
\ No newline at end of file
diff --git a/.github/workflows/docs1.yml b/.github/workflows/docs1.yml
new file mode 100644
index 00000000..cd9a3bff
--- /dev/null
+++ b/.github/workflows/docs1.yml
@@ -0,0 +1,61 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [ master, main ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+          
+      - name: Install MkDocs and dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -r docs/requirements-docs.txt
+          
+      - name: Build documentation
+        env:
+          CI: true  # This enables git-revision-date plugin in CI
+        run: |
+          # Update site_url for GitHub Pages if needed
+          if [ "${{ github.repository }}" != "murtaza-nasir/speakr" ]; then
+            sed -i "s|site_url:.*|site_url: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}|" mkdocs.yml
+          fi
+          mkdocs build --strict
+          
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: ./site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
diff --git a/.gitignore b/.gitignore
index 79420b2e..2017e92f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
+.playwright-mcp/
 venv/
 __pycache__/
 instance/
@@ -7,4 +8,45 @@ uploads/
 __pycache__/
 *.pyc
 *.log
-.env
\ No newline at end of file
+*.env
+.migrate/
+project_files.md
+*.md
+notes.md
+docker-compose.yml
+changes.txt
+
+!README.md
+!CLA.md
+!CONTRIBUTING.md
+!.github/CLA-SETUP.md
+!docs/**/*.md
+docker-compose.dev.yml
+docker-compose.lite.yml
+docker-compose.postgres.yml
+.clinerules
+temp/
+.claude/
+plan/
+
+# Offline vendor dependencies (downloaded during Docker build)
+static/vendor/
+
+# Docs build artifacts
+docs/_site/
+docs/.jekyll-cache/
+docs/README.md
+site/
+.cache/
+docs/overrides/.cache/
+
+# Documentation deployment files (examples only)
+docs/.github-deploy.yml
+
+# Documentation conversion scripts (one-time use)
+scripts/convert_to_mkdocs.py
+unraid/
+
+# Frontend test tooling (Vitest)
+node_modules/
+package-lock.json
diff --git a/CLA.md b/CLA.md
new file mode 100644
index 00000000..e107481c
--- /dev/null
+++ b/CLA.md
@@ -0,0 +1,83 @@
+# Speakr Contributor License Agreement
+
+Thank you for your interest in contributing to Speakr ("We" or "Us").
+
+This contributor agreement ("Agreement") documents the rights granted by contributors to Us. To make this document effective, please follow the instructions at [CONTRIBUTING.md](CONTRIBUTING.md).
+
+This is a legally binding document, so please read it carefully before agreeing to it. The Agreement may cover more than one software project managed by Us.
+
+## 1. Definitions
+
+"You" means the individual who Submits a Contribution to Us.
+
+"Contribution" means any work of authorship that is Submitted by You to Us in which You own or assert ownership of the Copyright.
+
+"Copyright" means all rights protecting works of authorship owned or controlled by You, including copyright, moral and neighboring rights, as appropriate, for the full term of their existence including any extensions by You.
+
+"Material" means the work of authorship which is made available by Us to third parties.
+
+"Submit" means any form of electronic, verbal, or written communication sent to Us or our representatives, including but not limited to electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, Us for the purpose of discussing and improving the Material, but excluding communication that is conspicuously marked or otherwise designated in writing by You as "Not a Contribution."
+
+## 2. Grant of Rights
+
+### 2.1 Copyright License
+
+(a) You retain ownership of the Copyright in Your Contribution and have the same rights to use or license the Contribution which You would have had without entering into the Agreement.
+
+(b) To the maximum extent permitted by the relevant law, You grant to Us a perpetual, worldwide, non-exclusive, transferable, royalty-free, irrevocable license under the Copyright covering the Contribution, with the right to sublicense such rights through multiple tiers of sublicensees, to reproduce, modify, display, perform and distribute the Contribution as part of the Material; provided that this license is conditioned upon compliance with Section 2.3.
+
+### 2.2 Patent License
+
+For patent claims including, without limitation, method, process, and apparatus claims which You own, control or have the right to grant, now or in the future, You grant to Us a perpetual, worldwide, non-exclusive, transferable, royalty-free, irrevocable patent license, with the right to sublicense these rights to multiple tiers of sublicensees, to make, have made, use, sell, offer for sale, import and otherwise transfer the Contribution and the Contribution in combination with the Material (and portions of such combination). This license is granted only to the extent that the exercise of the licensed rights infringes such patent claims; and provided that this license is conditioned upon compliance with Section 2.3.
+
+### 2.3 Outbound License
+
+Based on the grant of rights in Sections 2.1 and 2.2, if We include Your Contribution in a Material, We may license the Contribution under any license, including copyleft, permissive, commercial, or proprietary licenses. As a condition on the exercise of this right, We agree to also license the Contribution under the terms of the license or licenses which We are using for the Material on the Submission Date.
+
+### 2.4 Moral Rights
+
+If moral rights apply to the Contribution, to the maximum extent permitted by law, You waive and agree not to assert such moral rights against Us or our successors in interest, or any of our licensees, either direct or indirect.
+
+### 2.5 Our Rights
+
+You acknowledge that We are not obligated to use Your Contribution as part of the Material and may decide to include any Contribution We consider appropriate.
+
+### 2.6 Reservation of Rights
+
+Any rights not expressly licensed under this section are expressly reserved by You.
+
+## 3. Agreement
+
+You confirm that:
+
+(a) You have the legal authority to enter into this Agreement.
+
+(b) You own the Copyright and patent claims covering the Contribution which are required to grant the rights under Section 2.
+
+(c) The grant of rights under Section 2 does not violate any grant of rights which You have made to third parties, including Your employer. If You are an employee, You have had Your employer approve this Agreement or sign the Entity version of this document. If You are less than eighteen years old, please have Your parents or guardian sign the Agreement.
+
+(d) You have followed the instructions in [CONTRIBUTING.md](CONTRIBUTING.md), if You do not own the Copyright in the entire work of authorship Submitted.
+
+## 4. Disclaimer
+
+EXCEPT FOR THE EXPRESS WARRANTIES IN SECTION 3, THE CONTRIBUTION IS PROVIDED "AS IS". MORE PARTICULARLY, ALL EXPRESS OR IMPLIED WARRANTIES INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE EXPRESSLY DISCLAIMED BY YOU TO US. TO THE EXTENT THAT ANY SUCH WARRANTIES CANNOT BE DISCLAIMED, SUCH WARRANTY IS LIMITED IN DURATION TO THE MINIMUM PERIOD PERMITTED BY LAW.
+
+## 5. Consequential Damage Waiver
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT WILL YOU BE LIABLE FOR ANY LOSS OF PROFITS, LOSS OF ANTICIPATED SAVINGS, LOSS OF DATA, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL AND EXEMPLARY DAMAGES ARISING OUT OF THIS AGREEMENT REGARDLESS OF THE LEGAL OR EQUITABLE THEORY (CONTRACT, TORT OR OTHERWISE) UPON WHICH THE CLAIM IS BASED.
+
+## 6. Miscellaneous
+
+6.1 This Agreement will be governed by and construed in accordance with the laws of the jurisdiction in which the copyright holder primarily resides, excluding its conflicts of law provisions.
+
+6.2 This Agreement sets out the entire agreement between You and Us for Your Contributions to Us and overrides all other agreements or understandings.
+
+6.3 If You or We assign the rights or obligations received through this Agreement to a third party, as a condition of the assignment, that third party must agree in writing to abide by all the rights and obligations in the Agreement.
+
+6.4 The failure of either party to require performance by the other party of any provision of this Agreement in one situation shall not affect the right of a party to require such performance at any time in the future. A waiver of performance under a provision in one situation shall not be considered a waiver of the performance of the provision in the future or a waiver of the provision in its entirety.
+
+6.5 If any provision of this Agreement is found void and unenforceable, such provision will be replaced to the extent possible with a provision that comes closest to the meaning of the original provision and which is enforceable. The terms and conditions set forth in this Agreement shall apply notwithstanding any failure of essential purpose of this Agreement or any limited remedy to the maximum extent possible under law.
+
+---
+
+**By signing this agreement, you grant the Speakr project maintainers the rights described above, which allows us to maintain dual licensing (AGPLv3 and Commercial) while ensuring your valuable contributions remain part of the project.**
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..271d3d4d
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,150 @@
+# Contributing to Speakr
+
+Thank you for your interest in contributing to Speakr! We appreciate your time and effort in helping improve this project.
+
+## Ways to Contribute
+
+There are many ways to contribute to Speakr:
+
+- **Report Bugs**: [Open an issue](https://github.com/murtaza-nasir/speakr/issues) describing the problem
+- **Suggest Features**: [Start a discussion](https://github.com/murtaza-nasir/speakr/discussions) about your idea
+- **Improve Documentation**: Help us make our docs clearer and more comprehensive
+- **Translate**: Help translate Speakr into more languages
+- **Sponsor**: Support the project financially to enable continued development
+
+## Code Contributions
+
+We welcome code contributions! However, due to the dual-licensing nature of Speakr (AGPLv3 and Commercial), all code contributions are subject to our Contributor License Agreement (CLA).
+
+### Contributor License Agreement (CLA)
+
+Speakr is dual-licensed under:
+1. **AGPLv3** - Open source license for the community
+2. **Commercial License** - For organizations that cannot comply with AGPLv3
+
+The CLA allows us to:
+- Accept your valuable contributions
+- Include them in both the open source and commercial versions
+- Maintain flexibility to update licenses if needed in the future
+- Protect the project from legal issues
+
+**Important**: You retain copyright ownership of your contribution. The CLA simply grants us permission to use it.
+
+### Accepting the CLA
+
+**By submitting a pull request to this repository, you agree to the terms of our [Contributor License Agreement](CLA.md).**
+
+Please review the [CLA document](CLA.md) before submitting your contribution. When you open a PR, our bot will post a reminder about the CLA terms.
+
+### Contribution Process
+
+1. **Fork** the repository
+2. **Create a branch** for your feature: `git checkout -b feature/my-awesome-feature`
+3. **Make your changes** following our coding standards
+4. **Test your changes** thoroughly
+5. **Commit** with clear, descriptive messages (see our commit policy below)
+6. **Push** to your fork: `git push origin feature/my-awesome-feature`
+7. **Open a Pull Request** with a clear description of your changes
+8. **Respond to feedback** from maintainers
+
+### Coding Standards
+
+- Follow the existing code style (Python PEP 8 for backend, Vue 3 conventions for frontend)
+- Write clear, descriptive commit messages (see below)
+- Include comments for complex logic
+- Test your changes before submitting
+- Keep PRs focused on a single feature or fix
+
+### Commit Message Guidelines
+
+Follow the format used in the project:
+
+```
+Brief description of what was done
+
+Optional longer explanation if needed
+```
+
+**Good examples:**
+- `Add inline transcript editing in speaker identification modal`
+- `Fix undefined handle_openai_api_error function call in summary error handler`
+- `Optimize recording view for mobile with compact layout`
+
+**Avoid:**
+- `Fixed bug`
+- `Update`
+- `Changes`
+
+### Pull Request Guidelines
+
+- Keep PRs focused on a single feature or bug fix
+- Reference related issues: `Fixes #123` or `Relates to #456`
+- Provide clear description of what changed and why
+- Include screenshots for UI changes
+- Ensure all tests pass (if applicable)
+- Be responsive to review feedback
+
+## Development Setup
+
+See [CLAUDE.md](CLAUDE.md) for detailed development setup instructions.
+
+### Quick Start
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR-USERNAME/speakr.git
+cd speakr
+
+# Set up development environment
+docker-compose -f docker-compose.dev.yml up -d --build
+
+# Or for local development
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements.txt
+python src/app.py --debug
+```
+
+## What Happens After You Submit a PR?
+
+1. **CLA Reminder**: Our bot posts a reminder about the CLA terms (by submitting, you've accepted them)
+2. **Automated Tests**: CI/CD pipeline runs (if configured)
+3. **Code Review**: Maintainers review your code
+4. **Feedback**: You may be asked to make changes
+5. **Merge**: Once approved, we merge your PR!
+
+## Other Ways to Help
+
+There are many ways to contribute without code:
+
+- **Bug Reports**: Detailed bug reports are incredibly valuable
+- **Feature Requests**: Share your ideas and use cases
+- **Documentation**: Typo fixes, clarifications, examples
+- **Translations**: Help translate the UI
+- **Community Support**: Help others in discussions and issues
+- **Spread the Word**: Blog posts, social media, talks about Speakr
+
+## Questions?
+
+- **General Questions**: [GitHub Discussions](https://github.com/murtaza-nasir/speakr/discussions)
+- **Bug Reports**: [GitHub Issues](https://github.com/murtaza-nasir/speakr/issues)
+
+## Code of Conduct
+
+Be respectful, inclusive, and professional. We're all here to build something great together.
+
+- Be kind and courteous
+- Respect differing viewpoints
+- Accept constructive criticism gracefully
+- Focus on what's best for the community
+- Show empathy towards others
+
+Violations may result in being blocked from contributing.
+
+## License
+
+By contributing to Speakr, you agree that your contributions will be licensed under the project's dual-license model (AGPLv3 and Commercial), as specified in the [CLA](CLA.md).
+
+---
+
+**Thank you for contributing to Speakr!** 🎉
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 00000000..b91bae3a
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,82 @@
+###############################################################################
+# Stage 1: Builder — install Python deps and download vendor assets
+###############################################################################
+FROM python:3.11-slim AS builder
+
+ARG PRODUCTION=0
+ARG LIGHTWEIGHT=0
+
+WORKDIR /app
+
+# gcc is needed to compile C extensions during pip install
+RUN apt-get update && apt-get install -y --no-install-recommends gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies
+COPY requirements.txt requirements-embeddings.txt constraints.txt ./
+RUN pip install --no-cache-dir --prefix=/install -c constraints.txt -r requirements.txt && \
+    if [ "$LIGHTWEIGHT" = "0" ]; then \
+        pip install --no-cache-dir --prefix=/install -c constraints.txt -r requirements-embeddings.txt; \
+    fi
+
+# Download vendor assets (JS/CSS/fonts)
+RUN mkdir -p /app/static/vendor
+COPY scripts/download_offline_deps.py scripts/
+RUN pip install --no-cache-dir requests && \
+    PRODUCTION=${PRODUCTION} python scripts/download_offline_deps.py && \
+    echo "✓ Vendor dependencies downloaded successfully"
+
+###############################################################################
+# Stage 2: FFmpeg — download static binaries (much smaller than apt ffmpeg)
+###############################################################################
+FROM python:3.11-slim AS ffmpeg-stage
+
+RUN apt-get update && apt-get install -y --no-install-recommends wget xz-utils \
+    && rm -rf /var/lib/apt/lists/* \
+    && ARCH=$(dpkg --print-architecture) \
+    && wget -q https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-${ARCH}-static.tar.xz -O /tmp/ff.tar.xz \
+    && mkdir -p /tmp/ffmpeg-dir \
+    && tar xf /tmp/ff.tar.xz -C /tmp/ffmpeg-dir --strip-components=1 \
+    && mv /tmp/ffmpeg-dir/ffmpeg /usr/local/bin/ffmpeg \
+    && mv /tmp/ffmpeg-dir/ffprobe /usr/local/bin/ffprobe \
+    && chmod +x /usr/local/bin/ffmpeg /usr/local/bin/ffprobe \
+    && rm -rf /tmp/ff.tar.xz /tmp/ffmpeg-dir
+
+###############################################################################
+# Stage 3: Runtime — lean final image with only what's needed
+###############################################################################
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Copy static ffmpeg binaries (~150MB vs ~450MB from apt)
+COPY --from=ffmpeg-stage /usr/local/bin/ffmpeg /usr/local/bin/ffmpeg
+COPY --from=ffmpeg-stage /usr/local/bin/ffprobe /usr/local/bin/ffprobe
+
+# Copy installed Python packages from builder
+COPY --from=builder /install /usr/local
+
+# Copy downloaded vendor assets from builder
+COPY --from=builder /app/static/vendor /app/static/vendor
+
+# Copy application code
+COPY . .
+
+# Create necessary directories
+RUN mkdir -p /data/uploads /data/instance && chmod 755 /data/uploads /data/instance
+
+# Set environment variables
+ENV FLASK_APP=src/app.py
+ENV SQLALCHEMY_DATABASE_URI=sqlite:////data/instance/transcriptions.db
+ENV UPLOAD_FOLDER=/data/uploads
+ENV PYTHONPATH=/app
+ENV HF_HOME=/data/instance/huggingface
+
+# Add entrypoint script
+COPY scripts/docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+EXPOSE 8899
+
+ENTRYPOINT ["docker-entrypoint.sh"]
+CMD ["gunicorn", "--workers", "3", "--bind", "0.0.0.0:8899", "--timeout", "600", "src.app:app"]
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 00000000..0ad25db4
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,661 @@
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+  A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate.  Many developers of free software are heartened and
+encouraged by the resulting cooperation.  However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+  The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community.  It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server.  Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+  An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals.  This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU Affero General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Remote Network Interaction; Use with the GNU General Public License.
+
+  Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your version
+supports such interaction) an opportunity to receive the Corresponding
+Source of your version by providing access to the Corresponding Source
+from a network server at no charge, through some standard or customary
+means of facilitating copying of software.  This Corresponding Source
+shall include the Corresponding Source for any work covered by version 3
+of the GNU General Public License that is incorporated pursuant to the
+following paragraph.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU Affero General Public License from time to time.  Such new versions
+will be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Affero General Public License as published
+    by the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU Affero General Public License for more details.
+
+    You should have received a copy of the GNU Affero General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source.  For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code.  There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for the
+specific requirements.
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU AGPL, see
+<https://www.gnu.org/licenses/>.
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..9f9dad17
--- /dev/null
+++ b/README.md
@@ -0,0 +1,393 @@
+<div align="center">
+    <img src="static/img/icon-32x32.png" alt="Speakr Logo" width="32"/>
+</div>
+
+<h1 align="center">Speakr</h1>
+<p align="center">Self-hosted AI transcription and intelligent note-taking platform</p>
+
+<p align="center">
+  <a href="https://www.gnu.org/licenses/agpl-3.0"><img alt="AGPL v3" src="https://img.shields.io/badge/License-AGPL_v3-blue.svg"></a>
+  <a href="https://github.com/murtaza-nasir/speakr/actions/workflows/docker-publish.yml"><img alt="Docker Build" src="https://github.com/murtaza-nasir/speakr/actions/workflows/docker-publish.yml/badge.svg"></a>
+  <a href="https://hub.docker.com/r/learnedmachine/speakr"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/learnedmachine/speakr"></a>
+  <a href="https://github.com/murtaza-nasir/speakr/releases/latest"><img alt="Latest Version" src="https://img.shields.io/badge/version-0.8.20--alpha-brightgreen.svg"></a>
+</p>
+
+<p align="center">
+  <a href="https://murtaza-nasir.github.io/speakr">Documentation</a> •
+  <a href="https://murtaza-nasir.github.io/speakr/getting-started">Quick Start</a> •
+  <a href="https://murtaza-nasir.github.io/speakr/screenshots">Screenshots</a> •
+  <a href="https://hub.docker.com/r/learnedmachine/speakr">Docker Hub</a> •
+  <a href="https://github.com/murtaza-nasir/speakr/releases">Releases</a>
+</p>
+
+---
+
+## Overview
+
+Speakr transforms your audio recordings into organized, searchable, and intelligent notes. Built for privacy-conscious groups and individuals, it runs entirely on your own infrastructure, ensuring your sensitive conversations remain completely private.
+
+<div align="center">
+    <img src="docs/assets/images/screenshots/Main view.png" alt="Speakr Main Interface" width="750"/>
+</div>
+
+## Key Features
+
+### Core Functionality
+- **Smart Recording & Upload** - Record directly in browser or upload existing audio files
+- **AI Transcription** - High-accuracy transcription with speaker identification
+- **Voice Profiles** - AI-powered speaker recognition with voice embeddings (requires WhisperX ASR service)
+- **REST API v1** - Complete API with Swagger UI for automation tools (n8n, Zapier, Make) and dashboard widgets
+- **Single Sign-On** - Authenticate with any OIDC provider (Keycloak, Azure AD, Google, Auth0, Pocket ID)
+- **Audio-Transcript Sync** - Click transcript to jump to audio, auto-highlight current text, follow mode for hands-free playback
+- **Interactive Chat** - Ask questions about your recordings and get AI-powered answers
+- **Inquire Mode** - Semantic search across all recordings using natural language
+- **Internationalization** - Full support for English, Spanish, French, German, Chinese, and Russian
+- **Beautiful Themes** - Light and dark modes with customizable color schemes
+
+### Collaboration & Sharing
+- **Internal Sharing** - Share recordings with specific users with granular permissions (view/edit/reshare)
+- **Group Management** - Create groups with automatic sharing via group-scoped tags
+- **Public Sharing** - Generate secure links to share recordings externally (admin-controlled)
+- **Group Tags** - Tags that automatically share recordings with all group members
+
+### Organization & Management
+- **Smart Tagging** - Organize with tags that include custom AI prompts and ASR settings
+- **Tag Prompt Stacking** - Combine multiple tags to layer AI instructions for powerful transformations
+- **Tag Protection** - Prevent specific recordings from being auto-deleted
+- **Group Retention Policies** - Set custom retention periods per group tag
+- **Auto-Deletion** - Automatic cleanup of old recordings with flexible retention policies
+
+## Real-World Use Cases
+
+Different people use Speakr's collaboration and retention features in different ways:
+
+| Use Case | Setup | What It Does |
+|----------|-------|-------------|
+| **Family memories** | Create "Family" group with protected tag | Everyone gets access to trips and events automatically, recordings preserved forever |
+| **Book club discussions** | "Book Club" group, tag monthly meetings | All members auto-share discussions, can add personal notes about what resonated |
+| **Work project group** | Share individually with 3 teammates | Temporary collaboration, easy to revoke when project ends |
+| **Daily group standups** | Group tag with 14-day retention | Auto-share with group, auto-cleanup of routine meetings |
+| **Architecture decisions** | Engineering group tag, protected from deletion | Technical discussions automatically shared, preserved permanently as reference |
+| **Client consultations** | Individual share with view-only permission | Controlled external access, clients can't accidentally edit |
+| **Research interviews** | Protected tag + Obsidian export | Preserve recordings indefinitely, transcripts auto-import to note-taking system |
+| **Legal consultations** | Group tag with 7-year retention | Automatic sharing with legal group, compliance-based retention |
+| **Sales calls** | Group tag with 1-year retention | Whole sales group learns from each call, cleanup after sales cycle |
+
+### Creative Tag Prompt Examples
+
+Tags with custom prompts transform raw recordings into exactly what you need:
+
+- **Recipe recordings**: Record yourself cooking while narrating - tag with "Recipe" to convert messy speech into formatted recipes with ingredient lists and numbered steps
+- **Lecture notes**: Students tag lectures with "Study Notes" to get organized outlines with concepts, examples, and definitions instead of raw transcripts
+- **Code reviews**: "Code Review" tag extracts issues, suggested changes, and action items in technical language developers can use directly
+- **Meeting summaries**: "Action Items" tag ignores discussion and returns just decisions, tasks, and deadlines
+
+### Tag Stacking for Combined Effects
+
+Stack multiple tags to layer instructions:
+- "Recipe" + "Gluten Free" = Formatted recipe with gluten substitution suggestions
+- "Lecture" + "Biology 301" = Study notes format focused on biological terminology
+- "Client Meeting" + "Legal Review" = Client requirements plus legal implications highlighted
+
+The order can matter - start with format tags, then add focus tags for best results.
+
+### Integration Examples
+
+- **Obsidian/Logseq**: Enable auto-export to write completed transcripts directly to your vault using your custom template - no manual export needed
+- **Documentation wikis**: Map auto-export to your wiki's import folder for seamless transcript publishing
+- **Content creation**: Create SRT subtitle templates from your audio recordings for podcasts or video content
+- **Project management**: Extract action items with custom tag prompts, then auto-export for automated task creation
+
+## Quick Start
+
+### Using Docker (Recommended)
+
+```bash
+# Create project directory
+mkdir speakr && cd speakr
+
+# Download docker-compose configuration:
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/docker-compose.example.yml -O docker-compose.yml
+
+# Download the environment template:
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.transcription.example -O .env
+
+# Configure your API keys and launch
+nano .env
+docker compose up -d
+
+# Access at http://localhost:8899
+```
+
+> **Lightweight image:** Use `learnedmachine/speakr:lite` for a smaller image (~725MB vs ~4.4GB) that skips PyTorch. All features work normally — only Inquire Mode's semantic search falls back to basic text search.
+
+**Required API Keys:**
+- `TRANSCRIPTION_API_KEY` - For speech-to-text (OpenAI) or `ASR_BASE_URL` for self-hosted
+- `TEXT_MODEL_API_KEY` - For summaries, titles, and chat (OpenRouter or OpenAI)
+
+### Transcription Options
+
+Speakr uses a **connector-based architecture** that auto-detects your transcription provider:
+
+| Option | Setup | Speaker Diarization | Voice Profiles |
+|--------|-------|---------------------|----------------|
+| **OpenAI Transcribe** | Just API key | ✅ `gpt-4o-transcribe-diarize` | ❌ |
+| **WhisperX ASR** | GPU container | ✅ Best quality | ✅ |
+| **Mistral Voxtral** | Just API key | ✅ Built-in | ❌ |
+| **VibeVoice ASR** | Self-hosted (vLLM) | ✅ Built-in | ❌ |
+| **Legacy Whisper** | Just API key | ❌ | ❌ |
+
+**Simplest setup (OpenAI with diarization):**
+```bash
+TRANSCRIPTION_API_KEY=sk-your-openai-key
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+```
+
+**Best quality (Self-hosted WhisperX):**
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+ASR_RETURN_SPEAKER_EMBEDDINGS=true  # Enable voice profiles
+```
+Requires [WhisperX ASR Service](https://github.com/murtaza-nasir/whisperx-asr-service) container with GPU.
+
+**Mistral Voxtral (cloud diarization):**
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-mistral-key
+TRANSCRIPTION_MODEL=voxtral-mini-latest
+```
+
+**VibeVoice ASR (self-hosted, no cloud dependency):**
+```bash
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+TRANSCRIPTION_MODEL=vibevoice
+```
+Requires [VibeVoice](https://huggingface.co/microsoft/VibeVoice-ASR) served via vLLM with GPU.
+
+> **⚠️ PyTorch 2.6 Users:** If you encounter a "Weights only load failed" error with WhisperX, add `TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true` to your ASR container. See [troubleshooting](https://murtaza-nasir.github.io/speakr/troubleshooting#pytorch-26-weights-loading-error-whisperx-asr-service) for details.
+
+**[View Full Installation Guide →](https://murtaza-nasir.github.io/speakr/getting-started/installation)**
+
+## Documentation
+
+Complete documentation is available at **[murtaza-nasir.github.io/speakr](https://murtaza-nasir.github.io/speakr)**
+
+- [Getting Started](https://murtaza-nasir.github.io/speakr/getting-started) - Quick setup guide
+- [User Guide](https://murtaza-nasir.github.io/speakr/user-guide/) - Learn all features
+- [Admin Guide](https://murtaza-nasir.github.io/speakr/admin-guide/) - Administration and configuration
+- [Troubleshooting](https://murtaza-nasir.github.io/speakr/troubleshooting) - Common issues and solutions
+- [FAQ](https://murtaza-nasir.github.io/speakr/faq) - Frequently asked questions
+
+## Latest Release (v0.8.20-alpha)
+
+**Security: open-redirect fix in `is_safe_url` (CWE-601).** Patch release on top of v0.8.19-alpha.
+
+- The `is_safe_url()` helper validated `urljoin(request.host_url, target)` while `redirect()` was called with the raw `target`. A scheme-relative input such as `////evil.com` resolved to a same-host URL during validation but was emitted verbatim in the `Location` header, where browsers interpret it as a network-path-relative redirect to an attacker-controlled host.
+- `is_safe_url()` now validates the raw target against a local-path allowlist: leading `/` required, scheme-relative URLs (`//`, `/\`), backslashes, control characters, and any value with a scheme or netloc are rejected. The duplicate copy in `src/api/auth.py` was removed; password login and the SSO `next` / callback flow share one validator.
+- Reported by **RacerZ and Fushuling**. Tracked as a GitHub Security Advisory; CVE pending. Users on v0.8.19-alpha or earlier should upgrade promptly.
+
+No new features, no breaking changes.
+
+### Previous Release (v0.8.19-alpha)
+
+**Inquire-mode performance and re-embed reliability.** Patch release on top of v0.8.18-alpha. Vectorised chunk similarity search (60s → 2-3s on large libraries), embedding API retries with backoff, transactional rollback when a partial embedding response would otherwise drop chunks, and Re-embed all retry passes that include stale-chunk recordings regardless of status.
+
+### Previous Release (v0.8.18-alpha)
+
+**API v1 folder operations.** Patch release on top of v0.8.17-alpha (#274 follow-up).
+
+- `GET /api/v1/recordings?folder_id=<id>` (or `?folder_id=none`) filters list responses by folder
+- `PATCH /api/v1/recordings/{id}` accepts `folder_id` to move a recording (or `null` to remove it from any folder)
+- `PATCH /api/v1/recordings/batch` accepts `folder_id` inside `updates` for bulk moves
+- OpenAPI schema documents all of the above plus the previously-undocumented batch fields (`is_inbox`, `is_highlighted`, `add_tag_ids`, `remove_tag_ids`)
+
+No breaking changes. The folder *resource* endpoints (CRUD on `/api/v1/folders`) shipped in v0.8.16-alpha; this release lets recordings actually be moved into and out of those folders.
+
+### Previous Release (v0.8.17-alpha)
+
+**Bug fixes and CI maintenance.** Patch release on top of v0.8.16-alpha.
+
+- Reprocess summary modal: prompt-variables panel and Append/Replace toggle now reflect the prompt source the user actually picked (was showing the recording's original tag variables and offering Append/Replace for tag-source prompts where it does not apply)
+- Docs: corrected reverse-proxy nginx example so the WebSocket `Connection: upgrade` header is forwarded conditionally rather than set unconditionally (caused 500s on file uploads through the proxy with Gunicorn). Added a Nginx Proxy Manager section noting that NPM's default `client_max_body_size` is `2000m` and that the `Advanced` tab is the right place for per-host overrides.
+- CI: bumped all GitHub Actions to Node 24 versions to clear deprecation warnings.
+
+No new features, no breaking changes.
+
+### Previous Release (v0.8.16-alpha)
+
+**Prompt Templating, Transcription UX Polish, Per-Recording Model Selection, and Observability**
+
+**Prompt templating and summary control**
+
+- **Prompt Template Variables** - Tag, folder, user-default, and admin-default summary prompts can contain `{{name}}` placeholders. Selecting a tag with `{{agenda}}` exposes an agenda input on the upload form; the value is stored on the recording, substituted into the prompt at summarisation time, and remains editable from the reprocess summary modal. Caps: 8,000 chars per value, 32,000 total. Single-pass `re.sub` substitution so values cannot introduce new placeholders or reach Python attributes.
+- **Append vs Replace Mode** - The reprocess summary modal and the new "Customise summary prompt" modal each let you Append text to the resolved prompt (combine your saved prompt with extra context) or Replace it entirely (use only the text you paste). Append mode runs variable substitution after the append step so appended text can use the same `{{var}}` placeholders.
+- **Customise Summary Prompt Split-Button** - A new control next to **Generate Summary** opens the Append/Replace modal for recordings that don't have a summary yet, so one-off context (an agenda, custom focus instructions) can be passed in without rewriting your saved prompt.
+- **Full LLM Prompt Structure Preview** - Both the admin Default Prompts page and the user Customise-prompts tab now show the complete two-message payload (system prompt with context block, user message with transcription wrapper and language directive). Placeholder chips colour-code system tokens (blue, replaced by the framework) versus user-supplied variables (amber). The user-side preview re-renders live as you type into your custom prompt.
+
+**Per-recording transcription control**
+
+- **Per-Upload / Per-Tag / Per-Folder Transcription Model** - Set `TRANSCRIPTION_MODELS_AVAILABLE` and the upload form, reprocess modal, and tag/folder edit forms all gain a model dropdown. Tag and folder edit forms warn if a previously-selected default is no longer in the configured list. The dropdown is hidden when only one option would be visible.
+- **Admin-Managed Transcription Model List** - When the connector exposes `/v1/models` discovery, admins can curate the list from the dashboard rather than via env var. Stored in the database; overrides `TRANSCRIPTION_MODELS_AVAILABLE` when set.
+- **Per-Connector Capability Gating** - The hotwords, initial-prompt, and speaker-count UI elements are now hidden for connectors that don't support them, instead of accepting input that is silently ignored.
+- **Mistral Voxtral Chunking** - `MISTRAL_ENABLE_CHUNKING=true` (with `MISTRAL_MAX_DURATION_SECONDS`) opts the Mistral connector into app-side chunking for recordings approaching Voxtral's 3-hour timeout.
+
+**ASR transcript editor**
+
+- **Autosave** - Saves edits 2 seconds after the last keystroke when the user opts in (`Account → Preferences → Autosave editor`).
+- **Save Without Closing + Ctrl+S** - New button keeps the editor open after saving; Ctrl+S triggers a save from anywhere in the editor.
+- **Scroll Memory** - Reopening the editor restores the previous scroll position instead of jumping to the top.
+- **Double-Click to Edit** - Double-clicking a transcript row in the simple view jumps into the editor with that segment highlighted.
+- **Row Highlight After Jump** - Briefly tints the row when navigating into it from the simple view so the target is obvious.
+
+**Account preferences**
+
+- **Preferences Tab** - Account settings has a new **Preferences** tab (split from the language settings) using a two-column layout for transcript display, editor behaviour, and language preferences.
+- **Compact Timestamps** - Optional `mm:ss` (or `h:mm:ss`) timestamps in the simple transcript view, rendered as a two-part pill alongside the speaker label. The leading segment shows "Start" instead of `00:00`.
+- **Persist Recording-List Sort** - The Created date / Meeting date toggle now sticks across reloads and sessions on the same browser (#263).
+
+**Embeddings and inquire mode**
+
+- **Configurable Embedding Model** - `EMBEDDING_MODEL` swaps `all-MiniLM-L6-v2` for any sentence-transformers model.
+- **API-Mode Embeddings** - `EMBEDDING_BASE_URL`, `EMBEDDING_API_KEY`, and `EMBEDDING_DIMENSIONS` route embeddings through any OpenAI-compatible provider (vLLM, OpenRouter, OpenAI, Together, etc.). Inquire startup banner reflects the active provider.
+- **Embedding Token Tracking + Re-Embed-All** - The Vector Store admin tab now tracks embedding API token usage and cost separately from LLM usage, and exposes a "Re-embed all" action for after a model or dimensionality change. Speakr warns at startup if the embedding identifier changed since data was stored.
+
+**Observability and admin**
+
+- **Per-Operation Token Stats** - Admin token statistics now break out title, summary, chat, event extraction, and embeddings as separate categories with their own cards and charts. Embedding usage is shown as a distinct cost line.
+- **Granular Token Budgets** - `TITLE_MAX_TOKENS` and `EVENT_MAX_TOKENS` join the existing `SUMMARY_MAX_TOKENS` / `CHAT_MAX_TOKENS` so reasoning models that consume budget on hidden thinking tokens can be tuned per operation. The resolved `max_tokens` is logged with each LLM call.
+- **LLM Timeout Visibility** - The configured `LLM_REQUEST_TIMEOUT` is logged at startup, and `APITimeoutError` log entries now include elapsed time so it is clear whether the timeout was the actual bound that fired.
+
+**API v1**
+
+- **Folder CRUD** - New `/api/v1/folders` endpoints for list, create, update, delete.
+- **Connector Discovery** - New endpoint exposing the active transcription connector and its capabilities for companion-app integrations.
+- **Recording Field Parity** - `/api/v1/recordings` and `/api/v1/recordings/{id}` now expose `audio_duration`, transcription/summarization durations, folder, events (detail only), `deletion_exempt`, `prompt_variables`, and the per-recording transcription model.
+- **Forwarded Per-Request Overrides** - The `/api/v1/transcribe` endpoint now forwards `transcription_model`, `hotwords`, and `initial_prompt`. The custom-ASR-endpoint connector forwards a `?model=` query param so WhisperX runtime model switching works through the API.
+
+**Bug fixes**
+
+- Reprocessing now applies tag/folder/user default hotwords + initial_prompt (#265, previously only at upload time)
+- Legacy user records with `transcription_language="français"` are normalised to ISO 639-1 codes on upgrade so WhisperX no longer 500s on display names (#256)
+- Title generation no longer leaks `\\uXXXX` escape sequences into the LLM prompt for non-ASCII transcripts; truncation now happens after `format_transcription_for_llm` (#260)
+- The Vector Store "recordings to process" message now uses the i18n params API instead of inline brace replace
+- CSRF token added to the Preferences form so submissions are accepted
+
+**Infrastructure**
+
+- **Vitest Frontend Tests** - Pure-helper modules in `static/js/modules/utils/` are now covered by Vitest. Run `npm test`. Currently exercises the prompt-variable extraction and priority-chain logic.
+
+**Docs**
+
+- nginx reverse-proxy `proxy_request_buffering off` and `client_max_body_size` notes for large uploads
+- Google Gemini OpenAI-compatible endpoint setup example
+- Prompt template variables guide
+- Per-upload / per-tag / per-folder model selection documentation
+- `EMBEDDING_BASE_URL` API mode documentation across inquire-mode, vector-store, and troubleshooting
+
+---
+
+**Older releases:** see the [GitHub Releases page](https://github.com/murtaza-nasir/speakr/releases) for tagged versions, or the [release history on the docs site](https://murtaza-nasir.github.io/speakr/#latest-updates) for narrative changelog entries going back to earlier v0.x lines.
+
+## Screenshots
+
+<table align="center" border="0">
+  <tr>
+    <td align="center">
+      <img src="docs/assets/images/screenshots/Main view.png" alt="Main Screen" width="400"/>
+      <br><em>Main Screen with Chat</em>
+    </td>
+    <td align="center">
+      <img src="docs/assets/images/screenshots/video-playback.png" alt="Video Playback" width="400"/>
+      <br><em>Video Playback with Transcript</em>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <img src="docs/assets/images/screenshots/Inquire mode.png" alt="Inquire Mode" width="400"/>
+      <br><em>AI-Powered Semantic Search</em>
+    </td>
+    <td align="center">
+      <img src="docs/assets/images/screenshots/chat-interface.png" alt="Transcription with Chat" width="400"/>
+      <br><em>Interactive Transcription & Chat</em>
+    </td>
+  </tr>
+</table>
+
+**[View Full Screenshot Gallery →](https://murtaza-nasir.github.io/speakr/screenshots)**
+
+## Technology Stack
+
+- **Backend**: Python/Flask with SQLAlchemy
+- **Frontend**: Vue.js 3 with Tailwind CSS
+- **AI/ML**: OpenAI Whisper, OpenRouter, Ollama support
+- **Database**: SQLite (default) or PostgreSQL
+- **Deployment**: Docker, Docker Compose
+
+## Roadmap
+
+### Completed
+- ✅ Speaker voice profiles with AI-powered identification (v0.5.9)
+- ✅ Group workspaces with shared recordings (v0.5.9)
+- ✅ PWA enhancements with offline support and background sync (v0.5.10)
+- ✅ Multi-user job queue with fair scheduling (v0.6.0)
+- ✅ SSO integration with OIDC providers (v0.7.0)
+- ✅ Token usage tracking and per-user budgets (v0.7.2)
+- ✅ Connector-based transcription architecture with auto-detection (v0.8.0)
+- ✅ Comprehensive REST API with Swagger UI documentation (v0.8.0)
+- ✅ Video retention with in-browser video playback (v0.8.11)
+- ✅ Parallel uploads with duplicate detection (v0.8.11)
+- ✅ Fullscreen video mode with live subtitles (v0.8.14)
+- ✅ Custom vocabulary and transcription hints (v0.8.14)
+
+### Near-term
+- Quick language switching for transcription
+- Automated workflow triggers
+
+### Long-term
+- Plugin system for custom integrations
+- End-to-end encryption option
+
+### Reporting Issues
+
+- [Report bugs](https://github.com/murtaza-nasir/speakr/issues)
+- [Request features](https://github.com/murtaza-nasir/speakr/discussions)
+
+## License
+
+This project is **dual-licensed**:
+
+1.  **GNU Affero General Public License v3.0 (AGPLv3)**
+    [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+
+    Speakr is offered under the AGPLv3 as its open-source license. You are free to use, modify, and distribute this software under the terms of the AGPLv3. A key condition of the AGPLv3 is that if you run a modified version on a network server and provide access to it for others, you must also make the source code of your modified version available to those users under the AGPLv3.
+
+    * You **must** create a file named `LICENSE` (or `COPYING`) in the root of your repository and paste the full text of the [GNU AGPLv3 license](https://www.gnu.org/licenses/agpl-3.0.txt) into it.
+    * Read the full license text carefully to understand your rights and obligations.
+
+2.  **Commercial License**
+
+    For users or organizations who cannot or do not wish to comply with the terms of the AGPLv3 (for example, if you want to integrate Speakr into a proprietary commercial product or service without being obligated to share your modifications under AGPLv3), a separate commercial license is available.
+
+    Please contact **speakr maintainers** for details on obtaining a commercial license.
+
+**You must choose one of these licenses** under which to use, modify, or distribute this software. If you are using or distributing the software without a commercial license agreement, you must adhere to the terms of the AGPLv3.
+
+## Contributing
+
+We welcome contributions to Speakr! There are many ways to help:
+
+- **Bug Reports & Feature Requests**: [Open an issue](https://github.com/murtaza-nasir/speakr/issues)
+- **Discussions**: [Share ideas and ask questions](https://github.com/murtaza-nasir/speakr/discussions)
+- **Documentation**: Help improve our docs
+- **Translations**: Contribute translations for internationalization
+
+### Code Contributions
+
+By submitting a pull request, you agree to our [Contributor License Agreement (CLA)](CLA.md). This ensures we can maintain our dual-license model (AGPLv3 and Commercial). You retain copyright ownership of your contribution — the CLA simply grants us permission to include it in both the open source and commercial versions of Speakr. Our bot will post a reminder when you open a PR.
+
+**See our [Contributing Guide](CONTRIBUTING.md) for complete details on:**
+- How the CLA works and why we need it
+- Step-by-step contribution process
+- Development setup instructions
+- Coding standards and best practices
diff --git a/VERSION b/VERSION
new file mode 100644
index 00000000..cedaa4cb
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+v0.8.20-alpha
diff --git a/app.ipynb b/app.ipynb
deleted file mode 100644
index b1b26aab..00000000
--- a/app.ipynb
+++ /dev/null
@@ -1,243 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "I'll continue with the remaining JavaScript code and add the deployment instructions.\n",
-    "\n",
-    "\n",
-    "\n",
-    "```html\n",
-    "alert('Save failed: ' + error)\n",
-    "                    }\n",
-    "                },\n",
-    "                async loadRecordings() {\n",
-    "                    try {\n",
-    "                        const response = await fetch('/recordings')\n",
-    "                        const data = await response.json()\n",
-    "                        this.recordings = data\n",
-    "                    } catch (error) {\n",
-    "                        alert('Failed to load recordings: ' + error)\n",
-    "                    }\n",
-    "                },\n",
-    "                selectRecording(recording) {\n",
-    "                    this.selectedRecording = recording\n",
-    "                }\n",
-    "            },\n",
-    "            mounted() {\n",
-    "                this.loadRecordings()\n",
-    "            }\n",
-    "        }).mount('#app')\n",
-    "    </script>\n",
-    "</body>\n",
-    "</html>\n",
-    "\n",
-    "```\n",
-    "\n",
-    "Now, let's create a deployment script and requirements file for easy setup on Ubuntu:\n",
-    "\n",
-    "```text\n",
-    "# requirements.txt\n",
-    "flask==2.3.3\n",
-    "flask-sqlalchemy==3.1.1\n",
-    "openai==1.3.0\n",
-    "werkzeug==2.3.7\n",
-    "gunicorn==21.2.0\n",
-    "\n",
-    "# deployment/setup.sh\n",
-    "#!/bin/bash\n",
-    "\n",
-    "# Update system\n",
-    "sudo apt-get update\n",
-    "sudo apt-get upgrade -y\n",
-    "\n",
-    "# Install Python and pip if not already installed\n",
-    "sudo apt-get install -y python3 python3-pip python3-venv\n",
-    "\n",
-    "# Create directory for the application\n",
-    "sudo mkdir -p /opt/transcription-app\n",
-    "sudo chown $USER:$USER /opt/transcription-app\n",
-    "\n",
-    "# Create and activate virtual environment\n",
-    "python3 -m venv /opt/transcription-app/venv\n",
-    "source /opt/transcription-app/venv/bin/activate\n",
-    "\n",
-    "# Install requirements\n",
-    "pip install -r requirements.txt\n",
-    "\n",
-    "# Create systemd service file\n",
-    "sudo tee /etc/systemd/system/transcription.service << EOF\n",
-    "[Unit]\n",
-    "Description=Transcription Web Application\n",
-    "After=network.target\n",
-    "\n",
-    "[Service]\n",
-    "User=$USER\n",
-    "WorkingDirectory=/opt/transcription-app\n",
-    "Environment=\"PATH=/opt/transcription-app/venv/bin\"\n",
-    "ExecStart=/opt/transcription-app/venv/bin/gunicorn --workers 3 --bind 0.0.0.0:5000 app:app\n",
-    "\n",
-    "[Install]\n",
-    "WantedBy=multi-user.target\n",
-    "EOF\n",
-    "\n",
-    "# Create directories for uploads and database\n",
-    "mkdir -p /opt/transcription-app/uploads\n",
-    "mkdir -p /opt/transcription-app/instance\n",
-    "\n",
-    "# Reload systemd and start service\n",
-    "sudo systemctl daemon-reload\n",
-    "sudo systemctl start transcription\n",
-    "sudo systemctl enable transcription\n",
-    "\n",
-    "echo \"Installation complete! The application should be running on port 5000.\"\n",
-    "\n",
-    "```\n",
-    "\n",
-    "To deploy this application on Ubuntu:\n",
-    "\n",
-    "1. First, create a new directory for your project and copy all the files into it:\n",
-    "   ```bash\n",
-    "   mkdir transcription-app\n",
-    "   cd transcription-app\n",
-    "   ```\n",
-    "\n",
-    "2. Create the following directory structure:\n",
-    "   ```\n",
-    "   transcription-app/\n",
-    "   ├── app.py\n",
-    "   ├── requirements.txt\n",
-    "   ├── deployment/\n",
-    "   │   └── setup.sh\n",
-    "   └── templates/\n",
-    "       └── index.html\n",
-    "   ```\n",
-    "\n",
-    "3. Make the setup script executable and run it:\n",
-    "   ```bash\n",
-    "   chmod +x deployment/setup.sh\n",
-    "   ./deployment/setup.sh\n",
-    "   ```\n",
-    "\n",
-    "The application will be installed as a system service and will:\n",
-    "- Run on port 5000\n",
-    "- Auto-start on system boot\n",
-    "- Use gunicorn for production-grade serving\n",
-    "- Store uploads in `/opt/transcription-app/uploads`\n",
-    "- Store the SQLite database in `/opt/transcription-app/instance`\n",
-    "\n",
-    "Key features of the application:\n",
-    "\n",
-    "1. Upload Page:\n",
-    "   - Drag and drop interface for audio files\n",
-    "   - Visual feedback during drag operations\n",
-    "   - Automatic transition to input page after upload\n",
-    "\n",
-    "2. Input Page:\n",
-    "   - Split view with transcription and metadata\n",
-    "   - Auto-save functionality (saves 1 second after last edit)\n",
-    "   - Manual save button for peace of mind\n",
-    "   - Clean, modern interface\n",
-    "\n",
-    "3. Gallery Page:\n",
-    "   - Time-based grouping (This Week, Last Week, Older)\n",
-    "   - Audio playback functionality\n",
-    "   - Detailed view of selected recording\n",
-    "   - Easy navigation between recordings\n",
-    "\n",
-    "4. Database:\n",
-    "   - SQLite for simplicity and portability\n",
-    "   - Stores all metadata and file paths\n",
-    "   - Automatic timestamps\n",
-    "\n",
-    "5. Security Features:\n",
-    "   - Secure filename handling\n",
-    "   - File size limits\n",
-    "   - File type validation\n",
-    "\n",
-    "To customize the application, you can:\n",
-    "1. Modify the upload folder location in `app.py`\n",
-    "2. Adjust the maximum file size (currently 16MB)\n",
-    "3. Add additional metadata fields by updating both the database model and the frontend form\n",
-    "4. Customize the styling using Tailwind classes\n",
-    "5. Add user authentication if needed\n",
-    "\n",
-    "Would you like me to explain any particular part in more detail or make any modifications to the application?"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "Here's how to run the app directly using Python:\n",
-    "\n",
-    "\n",
-    "\n",
-    "1. First, activate the virtual environment. If you used the setup script, it would be:\n",
-    "```bash\n",
-    "source /opt/transcription-app/venv/bin/activate\n",
-    "```\n",
-    "\n",
-    "You'll know the virtual environment is activated when you see `(venv)` at the start of your command prompt.\n",
-    "\n",
-    "2. Navigate to the application directory:\n",
-    "```bash\n",
-    "cd /opt/transcription-app\n",
-    "```\n",
-    "\n",
-    "3. Run the application directly with Python:\n",
-    "```bash\n",
-    "python app.py\n",
-    "```\n",
-    "\n",
-    "If you want to run it in development mode but on a different port:\n",
-    "```bash\n",
-    "export FLASK_ENV=development\n",
-    "export FLASK_DEBUG=1\n",
-    "python app.py\n",
-    "```\n",
-    "\n",
-    "Alternative way using Flask CLI:\n",
-    "```bash\n",
-    "export FLASK_APP=app.py\n",
-    "flask run --host=0.0.0.0 --port=8080\n",
-    "```\n",
-    "\n",
-    "To stop the application, press `Ctrl+C`.\n",
-    "\n",
-    "Some useful commands for virtual environment management:\n",
-    "```bash\n",
-    "# Deactivate the virtual environment when you're done\n",
-    "deactivate\n",
-    "\n",
-    "# If you need to install additional packages\n",
-    "pip install package_name\n",
-    "\n",
-    "# To see all installed packages\n",
-    "pip list\n",
-    "\n",
-    "# To update requirements.txt after installing new packages\n",
-    "pip freeze > requirements.txt\n",
-    "```\n",
-    "\n",
-    "If you're developing and want to see the logs in real-time:\n",
-    "```bash\n",
-    "# In development mode, logs will show directly in the terminal\n",
-    "# If you want to see more detailed logs, you can add this to app.py:\n",
-    "import logging\n",
-    "logging.basicConfig(level=logging.DEBUG)\n",
-    "```\n",
-    "\n",
-    "Would you like me to help you set up any specific development configuration?"
-   ]
-  }
- ],
- "metadata": {
-  "language_info": {
-   "name": "python"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 2
-}
diff --git a/app.py b/app.py
deleted file mode 100644
index 8eb86bba..00000000
--- a/app.py
+++ /dev/null
@@ -1,939 +0,0 @@
-# Speakr - Audio Transcription and Summarization App
-import os
-import sys
-from flask import Flask, render_template, request, jsonify, send_file, Markup, redirect, url_for, flash
-from flask_sqlalchemy import SQLAlchemy
-from datetime import datetime
-from openai import OpenAI # Keep using the OpenAI library
-import json
-from werkzeug.utils import secure_filename
-from werkzeug.exceptions import RequestEntityTooLarge
-from sqlalchemy import select
-import threading
-from dotenv import load_dotenv # Import load_dotenv
-import httpx 
-import re
-import markdown
-from flask_login import LoginManager, UserMixin, login_user, logout_user, login_required, current_user
-from flask_bcrypt import Bcrypt
-from flask_wtf import FlaskForm
-from wtforms import StringField, PasswordField, SubmitField, BooleanField
-from wtforms.validators import DataRequired, Length, Email, EqualTo, ValidationError
-
-# Load environment variables from .env file
-load_dotenv()
-
-# Initialize Flask-Bcrypt
-bcrypt = Bcrypt()
-
-# Helper function to convert markdown to HTML
-def md_to_html(text):
-    if not text:
-        return ""
-    # Convert markdown to HTML with extensions for tables, code highlighting, etc.
-    html = markdown.markdown(text, extensions=[
-        'tables',           # Support for tables
-        'fenced_code',      # Support for ```code blocks```
-        'codehilite',       # Syntax highlighting for code blocks
-        'nl2br',            # Convert newlines to <br> tags
-        'sane_lists',       # Better list handling
-        'smarty'            # Smart quotes, dashes, etc.
-    ])
-    return html
-
-app = Flask(__name__)
-# Ensure the path uses the directory structure from your setup script
-app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////opt/transcription-app/instance/transcriptions.db'
-app.config['UPLOAD_FOLDER'] = '/opt/transcription-app/uploads' # Use absolute path based on setup
-app.config['MAX_CONTENT_LENGTH'] = 250 * 1024 * 1024  # 250MB max file size
-# Set a secret key for session management and CSRF protection
-app.config['SECRET_KEY'] = os.environ.get('SECRET_KEY', 'default-dev-key-change-in-production')
-db = SQLAlchemy()
-db.init_app(app)
-
-# Initialize Flask-Login
-login_manager = LoginManager()
-login_manager.init_app(app)
-login_manager.login_view = 'login'
-login_manager.login_message_category = 'info'
-bcrypt.init_app(app)
-
-# Add context processor to make 'now' available to all templates
-@app.context_processor
-def inject_now():
-    return {'now': datetime.now()}
-
-# Ensure upload and instance directories exist
-os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
-# Assuming the instance folder is handled correctly by Flask or created by setup.sh
-# os.makedirs(os.path.dirname(app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '/')), exist_ok=True)
-
-
-# --- User loader for Flask-Login ---
-@login_manager.user_loader
-def load_user(user_id):
-    return db.session.get(User, int(user_id))
-
-# --- Database Models ---
-class User(db.Model, UserMixin):
-    id = db.Column(db.Integer, primary_key=True)
-    username = db.Column(db.String(20), unique=True, nullable=False)
-    email = db.Column(db.String(120), unique=True, nullable=False)
-    password = db.Column(db.String(60), nullable=False)
-    is_admin = db.Column(db.Boolean, default=False)
-    recordings = db.relationship('Recording', backref='owner', lazy=True)
-    
-    def __repr__(self):
-        return f"User('{self.username}', '{self.email}')"
-class Recording(db.Model):
-    # Add user_id foreign key to associate recordings with users
-    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=True)
-    id = db.Column(db.Integer, primary_key=True)
-    # Title will now often be AI-generated, maybe start with filename?
-    title = db.Column(db.String(200), nullable=True) # Allow Null initially
-    participants = db.Column(db.String(500))
-    notes = db.Column(db.Text)
-    transcription = db.Column(db.Text, nullable=True)
-    summary = db.Column(db.Text, nullable=True) # <-- ADDED: Summary field
-    status = db.Column(db.String(50), default='PENDING') # PENDING, PROCESSING, SUMMARIZING, COMPLETED, FAILED
-    audio_path = db.Column(db.String(500))
-    created_at = db.Column(db.DateTime, default=datetime.utcnow)
-    meeting_date = db.Column(db.Date, nullable=True) # <-- ADDED: Meeting Date field
-    file_size = db.Column(db.Integer)  # Store file size in bytes
-    original_filename = db.Column(db.String(500), nullable=True) # Store the original uploaded filename
-
-    def to_dict(self):
-        return {
-            'id': self.id,
-            'title': self.title,
-            'participants': self.participants,
-            'notes': self.notes,
-            'notes_html': md_to_html(self.notes) if self.notes else "",
-            'transcription': self.transcription,
-            'summary': self.summary,
-            'summary_html': md_to_html(self.summary) if self.summary else "",
-            'status': self.status,
-            'created_at': self.created_at.isoformat() if self.created_at else None,
-            'meeting_date': self.meeting_date.isoformat() if self.meeting_date else None, # <-- ADDED: Include meeting_date
-            'file_size': self.file_size,
-            'original_filename': self.original_filename, # <-- ADDED: Include original filename
-            'user_id': self.user_id
-        }
-
-# --- Forms for Authentication ---
-class RegistrationForm(FlaskForm):
-    username = StringField('Username', validators=[DataRequired(), Length(min=2, max=20)])
-    email = StringField('Email', validators=[DataRequired(), Email()])
-    password = PasswordField('Password', validators=[DataRequired(), Length(min=8)])
-    confirm_password = PasswordField('Confirm Password', validators=[DataRequired(), EqualTo('password')])
-    submit = SubmitField('Sign Up')
-    
-    def validate_username(self, username):
-        user = User.query.filter_by(username=username.data).first()
-        if user:
-            raise ValidationError('That username is already taken. Please choose a different one.')
-    
-    def validate_email(self, email):
-        user = User.query.filter_by(email=email.data).first()
-        if user:
-            raise ValidationError('That email is already registered. Please use a different one.')
-
-class LoginForm(FlaskForm):
-    email = StringField('Email', validators=[DataRequired(), Email()])
-    password = PasswordField('Password', validators=[DataRequired()])
-    remember = BooleanField('Remember Me')
-    submit = SubmitField('Login')
-
-with app.app_context():
-    db.create_all()
-
-# --- API client setup for OpenRouter ---
-# Use environment variables from .env
-openrouter_api_key = os.environ.get("OPENROUTER_API_KEY")
-openrouter_base_url = os.environ.get("OPENROUTER_BASE_URL", "https://openrouter.ai/api/v1")
-openrouter_model_name = os.environ.get("OPENROUTER_MODEL_NAME", "openai/gpt-3.5-turbo") # Default if not set
-
-http_client_no_proxy = httpx.Client(verify=True) # verify=True is default, but good to be explicit
-
-if not openrouter_api_key:
-    app.logger.warning("OPENROUTER_API_KEY not found. Title/Summary generation DISABLED.")
-else:
-    try:
-        # ---> Pass the custom httpx_client <---
-        client = OpenAI(
-            api_key=openrouter_api_key,
-            base_url=openrouter_base_url,
-            http_client=http_client_no_proxy # Pass the proxy-disabled client
-        )
-        app.logger.info(f"OpenRouter client initialized. Using model: {openrouter_model_name}")
-    except Exception as client_init_e:
-         app.logger.error(f"Failed to initialize OpenRouter client: {client_init_e}", exc_info=True)
-
-# Store details for the transcription client (potentially different)
-transcription_api_key = os.environ.get("TRANSCRIPTION_API_KEY", "cant-be-empty")
-transcription_base_url = os.environ.get("TRANSCRIPTION_BASE_URL", "https://openrouter.ai/api/v1")
-
-app.logger.info(f"Using OpenRouter model for summaries: {openrouter_model_name}")
-
-# --- Background Transcription & Summarization Task ---
-def transcribe_audio_task(app_context, recording_id, filepath, original_filename):
-    """Runs the transcription and summarization in a background thread."""
-    with app_context: # Need app context for db operations in thread
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            app.logger.error(f"Error: Recording {recording_id} not found for transcription.")
-            return
-
-        try:
-            app.logger.info(f"Starting transcription for recording {recording_id} ({original_filename})...")
-            recording.status = 'PROCESSING'
-            db.session.commit()
-
-            # --- Step 1: Transcription ---
-            with open(filepath, 'rb') as audio_file:
-                # NOTE: This still uses the hardcoded Whisper model.
-                # If you want OpenRouter for transcription too, change the model here
-                # and potentially adjust the API call if needed.
-                # For now, assuming Whisper via a local compatible endpoint.
-                # You might need a *separate* client for Whisper if it's at a different URL.
-                # Example using the configured client (assuming it points to Whisper or OpenRouter handles it):
-                transcription_client = OpenAI(
-                    api_key=transcription_api_key,
-                    base_url=transcription_base_url,
-                    http_client=http_client_no_proxy # Reuse the same client configuration
-                )
-                # Get the Whisper model name from environment variables
-                whisper_model = os.environ.get("WHISPER_MODEL", "Systran/faster-distil-whisper-large-v3")
-                transcript = transcription_client.audio.transcriptions.create(
-                    model=whisper_model, # Use model from environment variables
-                    file=audio_file,
-                    language="en" # Specify language if known
-                )
-            recording.transcription = transcript.text
-            app.logger.info(f"Transcription completed for recording {recording_id}. Text length: {len(recording.transcription)}")
-            # Don't commit yet, proceed to summarization
-
-            # --- Step 2: Title & Summary Generation using OpenRouter ---
-            if client is None: # Check if OpenRouter client initialized successfully earlier
-                app.logger.warning(f"Skipping summary for {recording_id}: OpenRouter client not configured.")
-                recording.summary = "[Summary skipped: OpenRouter client not configured]"
-                recording.status = 'COMPLETED'
-                db.session.commit()
-                return # Exit cleanly
-            
-            recording.status = 'SUMMARIZING' # Update status
-            db.session.commit()
-            app.logger.info(f"Requesting title and summary from OpenRouter for recording {recording_id} using model {openrouter_model_name}...")
-
-            if not recording.transcription or len(recording.transcription.strip()) < 10: # Basic check for valid transcript
-                 app.logger.warning(f"Transcription for recording {recording_id} is too short or empty. Skipping summarization.")
-                 recording.status = 'COMPLETED' # Mark as completed even without summary
-                 recording.summary = "[Summary skipped due to short transcription]"
-                 db.session.commit()
-                 return # Exit the task cleanly
-
-            # Prepare the prompt for OpenRouter
-            prompt_text = f"""Analyze the following audio transcription and generate a concise title and a brief summary.
-
-Transcription:
-\"\"\"
-{recording.transcription[:30000]}
-\"\"\"
-
-Respond STRICTLY with a JSON object containing two keys: "title" (a short, descriptive title, max 15 words) and "summary" (a paragraph summarizing the key points, max 150 words).
-Example Format:
-{{
-  "title": "Example Meeting Discussion on Q3 Results",
-  "summary": "The meeting covered the financial results for Q3, highlighting key achievements and areas for improvement. Action items were assigned for follow-up."
-}}
-
-JSON Response:""" # The prompt guides the model towards the desired output
-
-            try:
-                # Use the OpenRouter client configured earlier
-                completion = client.chat.completions.create(
-                    model=openrouter_model_name,
-                    messages=[
-                        {"role": "system", "content": "You are an AI assistant that generates titles and summaries for meeting transcripts. Respond only with the requested JSON object."},
-                        {"role": "user", "content": prompt_text}
-                    ],
-                    temperature=0.5, # Adjust temperature as needed
-                    max_tokens=300, # Adjust based on expected title+summary length
-                    response_format={"type": "json_object"} # Request JSON output
-                )
-
-                response_content = completion.choices[0].message.content
-                app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-                
-                try:
-                    response_content = completion.choices[0].message.content
-                    app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-
-                    # Use regex to extract JSON content from potential markdown code blocks
-                    # This looks for content between markdown code blocks or just takes the whole content
-                    json_match = re.search(r'```(?:json)?(.*?)```|(.+)', response_content, re.DOTALL)
-                    
-                    if json_match:
-                        # Use the first group that matched (either between ``` or the whole content)
-                        sanitized_response = json_match.group(1) if json_match.group(1) else json_match.group(2)
-                        sanitized_response = sanitized_response.strip()
-                    else:
-                        sanitized_response = response_content.strip()
-                        
-                    summary_data = json.loads(response_content)
-                    generated_title = summary_data.get("title")
-                    generated_summary = summary_data.get("summary")
-
-                    if generated_title and generated_summary:
-                        # Update recording with AI generated content
-                        recording.title = generated_title.strip()
-                        recording.summary = generated_summary.strip()
-                        recording.status = 'COMPLETED'
-                        app.logger.info(f"Title and summary generated successfully for recording {recording_id}.")
-                    else:
-                        app.logger.warning(f"OpenRouter response for {recording_id} lacked 'title' or 'summary' key. Response: {response_content}")
-                        recording.summary = "[AI summary generation failed: Invalid JSON structure]"
-                        recording.status = 'COMPLETED' # Still completed, but summary failed
-
-                except json.JSONDecodeError as json_e:
-                    app.logger.error(f"Failed to parse JSON response from OpenRouter for {recording_id}: {json_e}. Response: {response_content}")
-                    recording.summary = f"[AI summary generation failed: Invalid JSON response ({json_e})]"
-                    recording.status = 'COMPLETED' # Mark as completed, summary failed
-
-            except Exception as summary_e:
-                app.logger.error(f"Error calling OpenRouter API for summary ({recording_id}): {str(summary_e)}")
-                # Keep transcription, but mark summary failed. Don't change status from SUMMARIZING yet.
-                recording.summary = f"[AI summary generation failed: API Error ({str(summary_e)})]"
-                recording.status = 'COMPLETED' # Even if summary fails, transcription worked.
-
-
-            db.session.commit() # Final commit for this step
-
-        except Exception as e:
-            db.session.rollback() # Rollback if any step failed critically
-            app.logger.error(f"Processing FAILED for recording {recording_id}: {str(e)}", exc_info=True)
-            # Retrieve recording again in case session was rolled back
-            recording = db.session.get(Recording, recording_id)
-            if recording:
-                 # Ensure status reflects failure even after rollback/retrieve attempt
-                if recording.status not in ['COMPLETED', 'FAILED']: # Avoid overwriting final state
-                    recording.status = 'FAILED'
-                if not recording.transcription: # If transcription itself failed
-                     recording.transcription = f"Processing failed: {str(e)}"
-                # Add error note to summary if appropriate stage was reached
-                if recording.status == 'SUMMARIZING' and not recording.summary:
-                     recording.summary = f"[Processing failed during summarization: {str(e)}]"
-
-                db.session.commit()
-
-# --- Chat with Transcription ---
-@app.route('/chat', methods=['POST'])
-@login_required
-def chat_with_transcription():
-    try:
-        data = request.json
-        if not data:
-            return jsonify({'error': 'No data provided'}), 400
-        
-        recording_id = data.get('recording_id')
-        user_message = data.get('message')
-        message_history = data.get('message_history', [])
-        
-        if not recording_id:
-            return jsonify({'error': 'No recording ID provided'}), 400
-        if not user_message:
-            return jsonify({'error': 'No message provided'}), 400
-            
-        # Get the recording
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to chat with this recording'}), 403
-            
-        # Check if OpenRouter client is available
-        if client is None:
-            return jsonify({'error': 'Chat service is not available (OpenRouter client not configured)'}), 503
-            
-        # Prepare the system prompt with the transcription
-        system_prompt = f"""You are a professional meeting analyst working with Murtaza Nasir, Assistant Professor at Wichita State University. Analyze the following meeting information and respond to the specific request.
-
-Following are the meeting participants and their roles:
-{recording.participants or "No specific participants information provided."}
-
-Following is the meeting transcript:
-<<start transcript>>
-{recording.transcription or "No transcript available."}
-<<end transcript>>
-
-Additional context and notes about the meeting:
-{recording.notes or "none"}
-"""
-        
-        # Call the LLM
-        try:
-            # Prepare messages array with system prompt and conversation history
-            messages = [{"role": "system", "content": system_prompt}]
-            
-            # Add message history if provided
-            if message_history:
-                messages.extend(message_history)
-            
-            # Add the current user message
-            messages.append({"role": "user", "content": user_message})
-            
-            completion = client.chat.completions.create(
-                model=openrouter_model_name,
-                messages=messages,
-                temperature=0.7,
-                max_tokens=1000
-            )
-            
-            response_content = completion.choices[0].message.content
-            
-            # Convert markdown in the response to HTML
-            response_html = md_to_html(response_content)
-            
-            return jsonify({
-                'response': response_content,
-                'response_html': response_html,
-                'success': True
-            })
-            
-        except Exception as chat_error:
-            app.logger.error(f"Error calling OpenRouter API for chat: {str(chat_error)}")
-            return jsonify({'error': f'Chat service error: {str(chat_error)}'}), 500
-            
-    except Exception as e:
-        app.logger.error(f"Error in chat endpoint: {str(e)}")
-        return jsonify({'error': str(e)}), 500
-
-
-# --- Authentication Routes ---
-@app.route('/register', methods=['GET', 'POST'])
-def register():
-    # Check if registration is allowed
-    allow_registration = os.environ.get('ALLOW_REGISTRATION', 'true').lower() == 'true'
-    
-    if not allow_registration:
-        flash('Registration is currently disabled. Please contact the administrator.', 'danger')
-        return redirect(url_for('login'))
-        
-    if current_user.is_authenticated:
-        return redirect(url_for('index'))
-    
-    form = RegistrationForm()
-    if form.validate_on_submit():
-        hashed_password = bcrypt.generate_password_hash(form.password.data).decode('utf-8')
-        user = User(username=form.username.data, email=form.email.data, password=hashed_password)
-        db.session.add(user)
-        db.session.commit()
-        flash('Your account has been created! You can now log in.', 'success')
-        return redirect(url_for('login'))
-    
-    return render_template('register.html', title='Register', form=form)
-
-@app.route('/login', methods=['GET', 'POST'])
-def login():
-    if current_user.is_authenticated:
-        return redirect(url_for('index'))
-    
-    form = LoginForm()
-    if form.validate_on_submit():
-        user = User.query.filter_by(email=form.email.data).first()
-        if user and bcrypt.check_password_hash(user.password, form.password.data):
-            login_user(user, remember=form.remember.data)
-            next_page = request.args.get('next')
-            return redirect(next_page) if next_page else redirect(url_for('index'))
-        else:
-            flash('Login unsuccessful. Please check email and password.', 'danger')
-    
-    return render_template('login.html', title='Login', form=form)
-
-@app.route('/logout')
-def logout():
-    logout_user()
-    return redirect(url_for('index'))
-
-@app.route('/account', methods=['GET'])
-@login_required
-def account():
-    return render_template('account.html', title='Account')
-
-@app.route('/change_password', methods=['POST'])
-@login_required
-def change_password():
-    current_password = request.form.get('current_password')
-    new_password = request.form.get('new_password')
-    confirm_password = request.form.get('confirm_password')
-    
-    # Validate form data
-    if not current_password or not new_password or not confirm_password:
-        flash('All fields are required.', 'danger')
-        return redirect(url_for('account'))
-    
-    if new_password != confirm_password:
-        flash('New password and confirmation do not match.', 'danger')
-        return redirect(url_for('account'))
-    
-    # Check if current password is correct
-    if not bcrypt.check_password_hash(current_user.password, current_password):
-        flash('Current password is incorrect.', 'danger')
-        return redirect(url_for('account'))
-    
-    # Update password
-    current_user.password = bcrypt.generate_password_hash(new_password).decode('utf-8')
-    db.session.commit()
-    
-    flash('Your password has been updated successfully.', 'success')
-    return redirect(url_for('account'))
-
-# --- Admin Routes ---
-@app.route('/admin', methods=['GET'])
-@login_required
-def admin():
-    # Check if user is admin
-    if not current_user.is_admin:
-        flash('You do not have permission to access the admin page.', 'danger')
-        return redirect(url_for('index'))
-    return render_template('admin.html', title='Admin Dashboard')
-
-@app.route('/admin/users', methods=['GET'])
-@login_required
-def admin_get_users():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    users = User.query.all()
-    user_data = []
-    
-    for user in users:
-        # Get recordings count and storage used
-        recordings_count = len(user.recordings)
-        storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
-        
-        user_data.append({
-            'id': user.id,
-            'username': user.username,
-            'email': user.email,
-            'is_admin': user.is_admin,
-            'recordings_count': recordings_count,
-            'storage_used': storage_used
-        })
-    
-    return jsonify(user_data)
-
-@app.route('/admin/users', methods=['POST'])
-@login_required
-def admin_add_user():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    data = request.json
-    if not data:
-        return jsonify({'error': 'No data provided'}), 400
-    
-    # Validate required fields
-    required_fields = ['username', 'email', 'password']
-    for field in required_fields:
-        if field not in data:
-            return jsonify({'error': f'Missing required field: {field}'}), 400
-    
-    # Check if username or email already exists
-    if User.query.filter_by(username=data['username']).first():
-        return jsonify({'error': 'Username already exists'}), 400
-    
-    if User.query.filter_by(email=data['email']).first():
-        return jsonify({'error': 'Email already exists'}), 400
-    
-    # Create new user
-    hashed_password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
-    new_user = User(
-        username=data['username'],
-        email=data['email'],
-        password=hashed_password,
-        is_admin=data.get('is_admin', False)
-    )
-    
-    db.session.add(new_user)
-    db.session.commit()
-    
-    return jsonify({
-        'id': new_user.id,
-        'username': new_user.username,
-        'email': new_user.email,
-        'is_admin': new_user.is_admin,
-        'recordings_count': 0,
-        'storage_used': 0
-    }), 201
-
-@app.route('/admin/users/<int:user_id>', methods=['PUT'])
-@login_required
-def admin_update_user(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    data = request.json
-    if not data:
-        return jsonify({'error': 'No data provided'}), 400
-    
-    # Update user fields
-    if 'username' in data and data['username'] != user.username:
-        # Check if username already exists
-        if User.query.filter_by(username=data['username']).first():
-            return jsonify({'error': 'Username already exists'}), 400
-        user.username = data['username']
-    
-    if 'email' in data and data['email'] != user.email:
-        # Check if email already exists
-        if User.query.filter_by(email=data['email']).first():
-            return jsonify({'error': 'Email already exists'}), 400
-        user.email = data['email']
-    
-    if 'password' in data and data['password']:
-        user.password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
-    
-    if 'is_admin' in data:
-        user.is_admin = data['is_admin']
-    
-    db.session.commit()
-    
-    # Get recordings count and storage used
-    recordings_count = len(user.recordings)
-    storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
-    
-    return jsonify({
-        'id': user.id,
-        'username': user.username,
-        'email': user.email,
-        'is_admin': user.is_admin,
-        'recordings_count': recordings_count,
-        'storage_used': storage_used
-    })
-
-@app.route('/admin/users/<int:user_id>', methods=['DELETE'])
-@login_required
-def admin_delete_user(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Prevent deleting self
-    if user_id == current_user.id:
-        return jsonify({'error': 'Cannot delete your own account'}), 400
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    # Delete user's recordings and audio files
-    for recording in user.recordings:
-        try:
-            if recording.audio_path and os.path.exists(recording.audio_path):
-                os.remove(recording.audio_path)
-        except Exception as e:
-            app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
-    
-    # Delete user
-    db.session.delete(user)
-    db.session.commit()
-    
-    return jsonify({'success': True})
-
-@app.route('/admin/users/<int:user_id>/toggle-admin', methods=['POST'])
-@login_required
-def admin_toggle_admin(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Prevent changing own admin status
-    if user_id == current_user.id:
-        return jsonify({'error': 'Cannot change your own admin status'}), 400
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    # Toggle admin status
-    user.is_admin = not user.is_admin
-    db.session.commit()
-    
-    return jsonify({'success': True, 'is_admin': user.is_admin})
-
-@app.route('/admin/stats', methods=['GET'])
-@login_required
-def admin_get_stats():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Get total users
-    total_users = User.query.count()
-    
-    # Get total recordings
-    total_recordings = Recording.query.count()
-    
-    # Get recordings by status
-    completed_recordings = Recording.query.filter_by(status='COMPLETED').count()
-    processing_recordings = Recording.query.filter(Recording.status.in_(['PROCESSING', 'SUMMARIZING'])).count()
-    pending_recordings = Recording.query.filter_by(status='PENDING').count()
-    failed_recordings = Recording.query.filter_by(status='FAILED').count()
-    
-    # Get total storage used
-    total_storage = db.session.query(db.func.sum(Recording.file_size)).scalar() or 0
-    
-    # Get top users by storage
-    top_users_query = db.session.query(
-        User.id,
-        User.username,
-        db.func.count(Recording.id).label('recordings_count'),
-        db.func.sum(Recording.file_size).label('storage_used')
-    ).join(Recording, User.id == Recording.user_id, isouter=True) \
-     .group_by(User.id) \
-     .order_by(db.func.sum(Recording.file_size).desc()) \
-     .limit(5)
-    
-    top_users = []
-    for user_id, username, recordings_count, storage_used in top_users_query:
-        top_users.append({
-            'id': user_id,
-            'username': username,
-            'recordings_count': recordings_count or 0,
-            'storage_used': storage_used or 0
-        })
-    
-    # Get total queries (chat requests)
-    # This is a placeholder - you would need to track this in your database
-    total_queries = 0
-    
-    return jsonify({
-        'total_users': total_users,
-        'total_recordings': total_recordings,
-        'completed_recordings': completed_recordings,
-        'processing_recordings': processing_recordings,
-        'pending_recordings': pending_recordings,
-        'failed_recordings': failed_recordings,
-        'total_storage': total_storage,
-        'top_users': top_users,
-        'total_queries': total_queries
-    })
-
-# --- Flask Routes ---
-@app.route('/')
-def index():
-    return render_template('index.html')
-
-@app.route('/recordings', methods=['GET'])
-def get_recordings():
-    try:
-        # Check if user is logged in
-        if not current_user.is_authenticated:
-            return jsonify([])  # Return empty array if not logged in
-            
-        # Filter recordings by the current user
-        stmt = select(Recording).where(Recording.user_id == current_user.id).order_by(Recording.created_at.desc())
-        recordings = db.session.execute(stmt).scalars().all()
-        return jsonify([recording.to_dict() for recording in recordings])
-    except Exception as e:
-        app.logger.error(f"Error fetching recordings: {e}")
-        return jsonify({'error': str(e)}), 500
-
-@app.route('/save', methods=['POST'])
-@login_required
-def save_metadata():
-    try:
-        data = request.json
-        if not data: return jsonify({'error': 'No data provided'}), 400
-        recording_id = data.get('id')
-        if not recording_id: return jsonify({'error': 'No recording ID provided'}), 400
-
-        recording = db.session.get(Recording, recording_id)
-        if not recording: return jsonify({'error': 'Recording not found'}), 404
-        
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
-
-        # Update fields if provided
-        if 'title' in data: recording.title = data['title']
-        if 'participants' in data: recording.participants = data['participants']
-        if 'notes' in data: recording.notes = data['notes']
-        if 'summary' in data: recording.summary = data['summary'] # <-- ADDED: Allow saving edited summary
-        if 'meeting_date' in data:
-            try:
-                # Attempt to parse date string (e.g., "YYYY-MM-DD")
-                date_str = data['meeting_date']
-                if date_str:
-                    recording.meeting_date = datetime.strptime(date_str, '%Y-%m-%d').date()
-                else:
-                    recording.meeting_date = None # Allow clearing the date
-            except (ValueError, TypeError) as e:
-                app.logger.warning(f"Could not parse meeting_date '{data.get('meeting_date')}': {e}")
-                # Optionally return an error or just ignore the invalid date
-                # return jsonify({'error': f"Invalid date format for meeting_date. Use YYYY-MM-DD."}), 400
-
-        # Do not update transcription or status here
-        db.session.commit()
-        return jsonify({'success': True, 'recording': recording.to_dict()})
-
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error saving metadata for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-@app.route('/upload', methods=['POST'])
-@login_required
-def upload_file():
-    try:
-        if 'file' not in request.files:
-            return jsonify({'error': 'No file provided'}), 400
-
-        file = request.files['file']
-        if file.filename == '':
-            return jsonify({'error': 'No file selected'}), 400
-
-        original_filename = file.filename # <-- ADDED: Capture original filename
-        safe_filename = secure_filename(original_filename)
-        # Ensure filepath uses the configured UPLOAD_FOLDER
-        filepath = os.path.join(app.config['UPLOAD_FOLDER'], f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{safe_filename}")
-
-        # Get file size before saving
-        file.seek(0, os.SEEK_END)
-        file_size = file.tell()
-        file.seek(0)
-
-        # Check size limit again
-        if file_size > app.config['MAX_CONTENT_LENGTH']:
-            raise RequestEntityTooLarge()
-
-        file.save(filepath)
-        app.logger.info(f"File saved to {filepath}")
-
-        # Create initial database entry with PENDING status and filename as placeholder title
-        recording = Recording(
-            audio_path=filepath,
-            original_filename=original_filename, # <-- ADDED: Save original filename
-            # Use original filename (without path part) as initial title
-            title=f"Recording - {original_filename}",
-            file_size=file_size,
-            status='PENDING', # Explicitly set status
-            meeting_date=datetime.utcnow().date(), # <-- ADDED: Default meeting_date to today
-            user_id=current_user.id # Associate with the current user
-        )
-        db.session.add(recording)
-        db.session.commit()
-        app.logger.info(f"Initial recording record created with ID: {recording.id}")
-
-        # --- Start transcription & summarization in background thread ---
-        thread = threading.Thread(
-            target=transcribe_audio_task,
-            # Pass original filename for logging clarity
-            args=(app.app_context(), recording.id, filepath, original_filename) # Pass original_filename here too
-        )
-        thread.start()
-        app.logger.info(f"Background processing thread started for recording ID: {recording.id}")
-
-        # Return the initial recording data and ID immediately
-        return jsonify(recording.to_dict()), 202 # 202 Accepted
-
-    except RequestEntityTooLarge:
-        max_size_mb = app.config['MAX_CONTENT_LENGTH'] / (1024 * 1024)
-        app.logger.warning(f"Upload failed: File too large (>{max_size_mb}MB)")
-        return jsonify({
-            'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
-            'max_size_mb': max_size_mb
-        }), 413
-    except Exception as e:
-        db.session.rollback() # Rollback if initial save failed
-        app.logger.error(f"Error during file upload: {e}", exc_info=True)
-        return jsonify({'error': str(e)}), 500
-
-
-# Status Endpoint
-@app.route('/status/<int:recording_id>', methods=['GET'])
-@login_required
-def get_status(recording_id):
-    """Endpoint to check the transcription/summarization status."""
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-        
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to view this recording'}), 403
-            
-        return jsonify(recording.to_dict())
-    except Exception as e:
-        app.logger.error(f"Error fetching status for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Get Audio Endpoint
-@app.route('/audio/<int:recording_id>')
-@login_required
-def get_audio(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording or not recording.audio_path:
-            return jsonify({'error': 'Recording or audio file not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to access this audio file'}), 403
-        if not os.path.exists(recording.audio_path):
-            app.logger.error(f"Audio file missing from server: {recording.audio_path}")
-            return jsonify({'error': 'Audio file missing from server'}), 404
-        return send_file(recording.audio_path)
-    except Exception as e:
-        app.logger.error(f"Error serving audio for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Delete Recording Endpoint
-@app.route('/recording/<int:recording_id>', methods=['DELETE'])
-@login_required
-def delete_recording(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to delete this recording'}), 403
-
-        # Delete the audio file first
-        try:
-            if recording.audio_path and os.path.exists(recording.audio_path):
-                os.remove(recording.audio_path)
-                app.logger.info(f"Deleted audio file: {recording.audio_path}")
-        except Exception as e:
-            app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
-
-        # Delete the database record
-        db.session.delete(recording)
-        db.session.commit()
-        app.logger.info(f"Deleted recording record ID: {recording_id}")
-
-        return jsonify({'success': True})
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error deleting recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-if __name__ == '__main__':
-    # Consider using waitress or gunicorn for production
-    # waitress-serve --host 0.0.0.0 --port 8899 app:app
-    # For development:
-    app.run(host='0.0.0.0', port=8899, debug=True) # Set debug=False if thread issues arise
diff --git a/app.py.bak b/app.py.bak
deleted file mode 100644
index e8f17f61..00000000
--- a/app.py.bak
+++ /dev/null
@@ -1,519 +0,0 @@
-# Speakr - Audio Transcription and Summarization App
-import os
-import sys
-from flask import Flask, render_template, request, jsonify, send_file, Markup
-from flask_sqlalchemy import SQLAlchemy
-from datetime import datetime
-from openai import OpenAI # Keep using the OpenAI library
-import json
-from werkzeug.utils import secure_filename
-from werkzeug.exceptions import RequestEntityTooLarge
-from sqlalchemy import select
-import threading
-from dotenv import load_dotenv # Import load_dotenv
-import httpx 
-import re
-import markdown
-
-# Load environment variables from .env file
-load_dotenv()
-
-# Helper function to convert markdown to HTML
-def md_to_html(text):
-    if not text:
-        return ""
-    # Convert markdown to HTML with extensions for tables, code highlighting, etc.
-    html = markdown.markdown(text, extensions=[
-        'tables',           # Support for tables
-        'fenced_code',      # Support for ```code blocks```
-        'codehilite',       # Syntax highlighting for code blocks
-        'nl2br',            # Convert newlines to <br> tags
-        'sane_lists',       # Better list handling
-        'smarty'            # Smart quotes, dashes, etc.
-    ])
-    return html
-
-app = Flask(__name__)
-# Ensure the path uses the directory structure from your setup script
-app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////opt/transcription-app/instance/transcriptions.db'
-app.config['UPLOAD_FOLDER'] = '/opt/transcription-app/uploads' # Use absolute path based on setup
-app.config['MAX_CONTENT_LENGTH'] = 250 * 1024 * 1024  # 250MB max file size
-db = SQLAlchemy()
-db.init_app(app)
-
-# Ensure upload and instance directories exist
-os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
-# Assuming the instance folder is handled correctly by Flask or created by setup.sh
-# os.makedirs(os.path.dirname(app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '/')), exist_ok=True)
-
-
-# --- Database Models ---
-class Recording(db.Model):
-    id = db.Column(db.Integer, primary_key=True)
-    # Title will now often be AI-generated, maybe start with filename?
-    title = db.Column(db.String(200), nullable=True) # Allow Null initially
-    participants = db.Column(db.String(500))
-    notes = db.Column(db.Text)
-    transcription = db.Column(db.Text, nullable=True)
-    summary = db.Column(db.Text, nullable=True) # <-- ADDED: Summary field
-    status = db.Column(db.String(50), default='PENDING') # PENDING, PROCESSING, SUMMARIZING, COMPLETED, FAILED
-    audio_path = db.Column(db.String(500))
-    created_at = db.Column(db.DateTime, default=datetime.utcnow)
-    meeting_date = db.Column(db.Date, nullable=True) # <-- ADDED: Meeting Date field
-    file_size = db.Column(db.Integer)  # Store file size in bytes
-
-    def to_dict(self):
-        return {
-            'id': self.id,
-            'title': self.title,
-            'participants': self.participants,
-            'notes': self.notes,
-            'notes_html': md_to_html(self.notes) if self.notes else "",
-            'transcription': self.transcription,
-            'summary': self.summary,
-            'summary_html': md_to_html(self.summary) if self.summary else "",
-            'status': self.status,
-            'created_at': self.created_at.isoformat() if self.created_at else None,
-            'meeting_date': self.meeting_date.isoformat() if self.meeting_date else None, # <-- ADDED: Include meeting_date
-            'file_size': self.file_size
-        }
-
-with app.app_context():
-    db.create_all()
-
-# --- API client setup for OpenRouter ---
-# Use environment variables from .env
-openrouter_api_key = os.environ.get("OPENROUTER_API_KEY")
-openrouter_base_url = os.environ.get("OPENROUTER_BASE_URL", "https://openrouter.ai/api/v1")
-openrouter_model_name = os.environ.get("OPENROUTER_MODEL_NAME", "openai/gpt-3.5-turbo") # Default if not set
-
-http_client_no_proxy = httpx.Client(verify=True) # verify=True is default, but good to be explicit
-
-if not openrouter_api_key:
-    app.logger.warning("OPENROUTER_API_KEY not found. Title/Summary generation DISABLED.")
-else:
-    try:
-        # ---> Pass the custom httpx_client <---
-        client = OpenAI(
-            api_key=openrouter_api_key,
-            base_url=openrouter_base_url,
-            http_client=http_client_no_proxy # Pass the proxy-disabled client
-        )
-        app.logger.info(f"OpenRouter client initialized. Using model: {openrouter_model_name}")
-    except Exception as client_init_e:
-         app.logger.error(f"Failed to initialize OpenRouter client: {client_init_e}", exc_info=True)
-
-# Store details for the transcription client (potentially different)
-transcription_api_key = os.environ.get("OPENAI_API_KEY", "cant-be-empty")
-transcription_base_url = os.environ.get("OPENAI_BASE_URL", "http://192.168.68.85:1611/v1/")
-
-app.logger.info(f"Using OpenRouter model for summaries: {openrouter_model_name}")
-
-# --- Background Transcription & Summarization Task ---
-def transcribe_audio_task(app_context, recording_id, filepath, original_filename):
-    """Runs the transcription and summarization in a background thread."""
-    with app_context: # Need app context for db operations in thread
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            app.logger.error(f"Error: Recording {recording_id} not found for transcription.")
-            return
-
-        try:
-            app.logger.info(f"Starting transcription for recording {recording_id} ({original_filename})...")
-            recording.status = 'PROCESSING'
-            db.session.commit()
-
-            # --- Step 1: Transcription ---
-            with open(filepath, 'rb') as audio_file:
-                # NOTE: This still uses the hardcoded Whisper model.
-                # If you want OpenRouter for transcription too, change the model here
-                # and potentially adjust the API call if needed.
-                # For now, assuming Whisper via a local compatible endpoint.
-                # You might need a *separate* client for Whisper if it's at a different URL.
-                # Example using the configured client (assuming it points to Whisper or OpenRouter handles it):
-                transcription_client = OpenAI(
-                    api_key=transcription_api_key,
-                    base_url=transcription_base_url,
-                    http_client=http_client_no_proxy # Reuse the same client configuration
-                )
-                transcript = transcription_client.audio.transcriptions.create(
-                    model="Systran/faster-distil-whisper-large-v3", # Your Whisper model
-                    file=audio_file,
-                    language="en" # Specify language if known
-                )
-            recording.transcription = transcript.text
-            app.logger.info(f"Transcription completed for recording {recording_id}. Text length: {len(recording.transcription)}")
-            # Don't commit yet, proceed to summarization
-
-            # --- Step 2: Title & Summary Generation using OpenRouter ---
-            if client is None: # Check if OpenRouter client initialized successfully earlier
-                app.logger.warning(f"Skipping summary for {recording_id}: OpenRouter client not configured.")
-                recording.summary = "[Summary skipped: OpenRouter client not configured]"
-                recording.status = 'COMPLETED'
-                db.session.commit()
-                return # Exit cleanly
-            
-            recording.status = 'SUMMARIZING' # Update status
-            db.session.commit()
-            app.logger.info(f"Requesting title and summary from OpenRouter for recording {recording_id} using model {openrouter_model_name}...")
-
-            if not recording.transcription or len(recording.transcription.strip()) < 10: # Basic check for valid transcript
-                 app.logger.warning(f"Transcription for recording {recording_id} is too short or empty. Skipping summarization.")
-                 recording.status = 'COMPLETED' # Mark as completed even without summary
-                 recording.summary = "[Summary skipped due to short transcription]"
-                 db.session.commit()
-                 return # Exit the task cleanly
-
-            # Prepare the prompt for OpenRouter
-            prompt_text = f"""Analyze the following audio transcription and generate a concise title and a brief summary.
-
-Transcription:
-\"\"\"
-{recording.transcription[:30000]}
-\"\"\"
-
-Respond STRICTLY with a JSON object containing two keys: "title" (a short, descriptive title, max 15 words) and "summary" (a paragraph summarizing the key points, max 150 words).
-Example Format:
-{{
-  "title": "Example Meeting Discussion on Q3 Results",
-  "summary": "The meeting covered the financial results for Q3, highlighting key achievements and areas for improvement. Action items were assigned for follow-up."
-}}
-
-JSON Response:""" # The prompt guides the model towards the desired output
-
-            try:
-                # Use the OpenRouter client configured earlier
-                completion = client.chat.completions.create(
-                    model=openrouter_model_name,
-                    messages=[
-                        {"role": "system", "content": "You are an AI assistant that generates titles and summaries for meeting transcripts. Respond only with the requested JSON object."},
-                        {"role": "user", "content": prompt_text}
-                    ],
-                    temperature=0.5, # Adjust temperature as needed
-                    max_tokens=300, # Adjust based on expected title+summary length
-                    response_format={"type": "json_object"} # Request JSON output
-                )
-
-                response_content = completion.choices[0].message.content
-                app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-                
-                try:
-                    response_content = completion.choices[0].message.content
-                    app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-
-                    # Use regex to extract JSON content from potential markdown code blocks
-                    # This looks for content between markdown code blocks or just takes the whole content
-                    json_match = re.search(r'```(?:json)?(.*?)```|(.+)', response_content, re.DOTALL)
-                    
-                    if json_match:
-                        # Use the first group that matched (either between ``` or the whole content)
-                        sanitized_response = json_match.group(1) if json_match.group(1) else json_match.group(2)
-                        sanitized_response = sanitized_response.strip()
-                    else:
-                        sanitized_response = response_content.strip()
-                        
-                    summary_data = json.loads(response_content)
-                    generated_title = summary_data.get("title")
-                    generated_summary = summary_data.get("summary")
-
-                    if generated_title and generated_summary:
-                        # Update recording with AI generated content
-                        recording.title = generated_title.strip()
-                        recording.summary = generated_summary.strip()
-                        recording.status = 'COMPLETED'
-                        app.logger.info(f"Title and summary generated successfully for recording {recording_id}.")
-                    else:
-                        app.logger.warning(f"OpenRouter response for {recording_id} lacked 'title' or 'summary' key. Response: {response_content}")
-                        recording.summary = "[AI summary generation failed: Invalid JSON structure]"
-                        recording.status = 'COMPLETED' # Still completed, but summary failed
-
-                except json.JSONDecodeError as json_e:
-                    app.logger.error(f"Failed to parse JSON response from OpenRouter for {recording_id}: {json_e}. Response: {response_content}")
-                    recording.summary = f"[AI summary generation failed: Invalid JSON response ({json_e})]"
-                    recording.status = 'COMPLETED' # Mark as completed, summary failed
-
-            except Exception as summary_e:
-                app.logger.error(f"Error calling OpenRouter API for summary ({recording_id}): {str(summary_e)}")
-                # Keep transcription, but mark summary failed. Don't change status from SUMMARIZING yet.
-                recording.summary = f"[AI summary generation failed: API Error ({str(summary_e)})]"
-                recording.status = 'COMPLETED' # Even if summary fails, transcription worked.
-
-
-            db.session.commit() # Final commit for this step
-
-        except Exception as e:
-            db.session.rollback() # Rollback if any step failed critically
-            app.logger.error(f"Processing FAILED for recording {recording_id}: {str(e)}", exc_info=True)
-            # Retrieve recording again in case session was rolled back
-            recording = db.session.get(Recording, recording_id)
-            if recording:
-                 # Ensure status reflects failure even after rollback/retrieve attempt
-                if recording.status not in ['COMPLETED', 'FAILED']: # Avoid overwriting final state
-                    recording.status = 'FAILED'
-                if not recording.transcription: # If transcription itself failed
-                     recording.transcription = f"Processing failed: {str(e)}"
-                # Add error note to summary if appropriate stage was reached
-                if recording.status == 'SUMMARIZING' and not recording.summary:
-                     recording.summary = f"[Processing failed during summarization: {str(e)}]"
-
-                db.session.commit()
-
-# --- Chat with Transcription ---
-@app.route('/chat', methods=['POST'])
-def chat_with_transcription():
-    try:
-        data = request.json
-        if not data:
-            return jsonify({'error': 'No data provided'}), 400
-        
-        recording_id = data.get('recording_id')
-        user_message = data.get('message')
-        message_history = data.get('message_history', [])
-        
-        if not recording_id:
-            return jsonify({'error': 'No recording ID provided'}), 400
-        if not user_message:
-            return jsonify({'error': 'No message provided'}), 400
-            
-        # Get the recording
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-            
-        # Check if OpenRouter client is available
-        if client is None:
-            return jsonify({'error': 'Chat service is not available (OpenRouter client not configured)'}), 503
-            
-        # Prepare the system prompt with the transcription
-        system_prompt = f"""You are a professional meeting analyst working with Murtaza Nasir, Assistant Professor at Wichita State University. Analyze the following meeting information and respond to the specific request.
-
-Following are the meeting participants and their roles:
-{recording.participants or "No specific participants information provided."}
-
-Following is the meeting transcript:
-<<start transcript>>
-{recording.transcription or "No transcript available."}
-<<end transcript>>
-
-Additional context and notes about the meeting:
-{recording.notes or "none"}
-"""
-        
-        # Call the LLM
-        try:
-            # Prepare messages array with system prompt and conversation history
-            messages = [{"role": "system", "content": system_prompt}]
-            
-            # Add message history if provided
-            if message_history:
-                messages.extend(message_history)
-            
-            # Add the current user message
-            messages.append({"role": "user", "content": user_message})
-            
-            completion = client.chat.completions.create(
-                model=openrouter_model_name,
-                messages=messages,
-                temperature=0.7,
-                max_tokens=1000
-            )
-            
-            response_content = completion.choices[0].message.content
-            
-            # Convert markdown in the response to HTML
-            response_html = md_to_html(response_content)
-            
-            return jsonify({
-                'response': response_content,
-                'response_html': response_html,
-                'success': True
-            })
-            
-        except Exception as chat_error:
-            app.logger.error(f"Error calling OpenRouter API for chat: {str(chat_error)}")
-            return jsonify({'error': f'Chat service error: {str(chat_error)}'}), 500
-            
-    except Exception as e:
-        app.logger.error(f"Error in chat endpoint: {str(e)}")
-        return jsonify({'error': str(e)}), 500
-
-
-# --- Flask Routes ---
-@app.route('/')
-def index():
-    return render_template('index.html')
-
-@app.route('/recordings', methods=['GET'])
-def get_recordings():
-    try:
-        stmt = select(Recording).order_by(Recording.created_at.desc())
-        recordings = db.session.execute(stmt).scalars().all()
-        return jsonify([recording.to_dict() for recording in recordings])
-    except Exception as e:
-        app.logger.error(f"Error fetching recordings: {e}")
-        return jsonify({'error': str(e)}), 500
-
-@app.route('/save', methods=['POST'])
-def save_metadata():
-    try:
-        data = request.json
-        if not data: return jsonify({'error': 'No data provided'}), 400
-        recording_id = data.get('id')
-        if not recording_id: return jsonify({'error': 'No recording ID provided'}), 400
-
-        recording = db.session.get(Recording, recording_id)
-        if not recording: return jsonify({'error': 'Recording not found'}), 404
-
-        # Update fields if provided
-        if 'title' in data: recording.title = data['title']
-        if 'participants' in data: recording.participants = data['participants']
-        if 'notes' in data: recording.notes = data['notes']
-        if 'summary' in data: recording.summary = data['summary'] # <-- ADDED: Allow saving edited summary
-        if 'meeting_date' in data:
-            try:
-                # Attempt to parse date string (e.g., "YYYY-MM-DD")
-                date_str = data['meeting_date']
-                if date_str:
-                    recording.meeting_date = datetime.strptime(date_str, '%Y-%m-%d').date()
-                else:
-                    recording.meeting_date = None # Allow clearing the date
-            except (ValueError, TypeError) as e:
-                app.logger.warning(f"Could not parse meeting_date '{data.get('meeting_date')}': {e}")
-                # Optionally return an error or just ignore the invalid date
-                # return jsonify({'error': f"Invalid date format for meeting_date. Use YYYY-MM-DD."}), 400
-
-        # Do not update transcription or status here
-        db.session.commit()
-        return jsonify({'success': True, 'recording': recording.to_dict()})
-
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error saving metadata for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-@app.route('/upload', methods=['POST'])
-def upload_file():
-    try:
-        if 'file' not in request.files:
-            return jsonify({'error': 'No file provided'}), 400
-
-        file = request.files['file']
-        if file.filename == '':
-            return jsonify({'error': 'No file selected'}), 400
-
-        filename = secure_filename(file.filename)
-        # Ensure filepath uses the configured UPLOAD_FOLDER
-        filepath = os.path.join(app.config['UPLOAD_FOLDER'], f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{filename}")
-
-        # Get file size before saving
-        file.seek(0, os.SEEK_END)
-        file_size = file.tell()
-        file.seek(0)
-
-        # Check size limit again
-        if file_size > app.config['MAX_CONTENT_LENGTH']:
-            raise RequestEntityTooLarge()
-
-        file.save(filepath)
-        app.logger.info(f"File saved to {filepath}")
-
-        # Create initial database entry with PENDING status and filename as placeholder title
-        recording = Recording(
-            audio_path=filepath,
-            # Use filename (without path part) as initial title
-            title=f"Recording - {filename}",
-            file_size=file_size,
-            status='PENDING', # Explicitly set status
-            meeting_date=datetime.utcnow().date() # <-- ADDED: Default meeting_date to today
-        )
-        db.session.add(recording)
-        db.session.commit()
-        app.logger.info(f"Initial recording record created with ID: {recording.id}")
-
-        # --- Start transcription & summarization in background thread ---
-        thread = threading.Thread(
-            target=transcribe_audio_task,
-            # Pass original filename for logging clarity
-            args=(app.app_context(), recording.id, filepath, filename)
-        )
-        thread.start()
-        app.logger.info(f"Background processing thread started for recording ID: {recording.id}")
-
-        # Return the initial recording data and ID immediately
-        return jsonify(recording.to_dict()), 202 # 202 Accepted
-
-    except RequestEntityTooLarge:
-        max_size_mb = app.config['MAX_CONTENT_LENGTH'] / (1024 * 1024)
-        app.logger.warning(f"Upload failed: File too large (>{max_size_mb}MB)")
-        return jsonify({
-            'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
-            'max_size_mb': max_size_mb
-        }), 413
-    except Exception as e:
-        db.session.rollback() # Rollback if initial save failed
-        app.logger.error(f"Error during file upload: {e}", exc_info=True)
-        return jsonify({'error': str(e)}), 500
-
-
-# Status Endpoint (no changes needed, it returns the full recording dict)
-@app.route('/status/<int:recording_id>', methods=['GET'])
-def get_status(recording_id):
-    """Endpoint to check the transcription/summarization status."""
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-        return jsonify(recording.to_dict())
-    except Exception as e:
-        app.logger.error(f"Error fetching status for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Get Audio Endpoint (no changes needed)
-@app.route('/audio/<int:recording_id>')
-def get_audio(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording or not recording.audio_path:
-            return jsonify({'error': 'Recording or audio file not found'}), 404
-        if not os.path.exists(recording.audio_path):
-            app.logger.error(f"Audio file missing from server: {recording.audio_path}")
-            return jsonify({'error': 'Audio file missing from server'}), 404
-        return send_file(recording.audio_path)
-    except Exception as e:
-        app.logger.error(f"Error serving audio for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Delete Recording Endpoint (no changes needed functionally)
-@app.route('/recording/<int:recording_id>', methods=['DELETE'])
-def delete_recording(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-
-        # Delete the audio file first
-        try:
-            if recording.audio_path and os.path.exists(recording.audio_path):
-                os.remove(recording.audio_path)
-                app.logger.info(f"Deleted audio file: {recording.audio_path}")
-        except Exception as e:
-            app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
-
-        # Delete the database record
-        db.session.delete(recording)
-        db.session.commit()
-        app.logger.info(f"Deleted recording record ID: {recording_id}")
-
-        return jsonify({'success': True})
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error deleting recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-if __name__ == '__main__':
-    # Consider using waitress or gunicorn for production
-    # waitress-serve --host 0.0.0.0 --port 8899 app:app
-    # For development:
-    app.run(host='0.0.0.0', port=8899, debug=True) # Set debug=False if thread issues arise
diff --git a/config/docker-compose.example.yml b/config/docker-compose.example.yml
new file mode 100644
index 00000000..3e238dd4
--- /dev/null
+++ b/config/docker-compose.example.yml
@@ -0,0 +1,65 @@
+services:
+  app:
+    # Use 'lite' tag for a smaller image (~700MB vs ~4.4GB) without PyTorch
+    # Semantic search in Inquire Mode falls back to text search; all other features work normally
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+
+    # --- Configuration ---
+    # Environment variables are loaded from the .env file.
+    #
+    # To get started:
+    # 1. Copy this file to your project root:
+    #    cp config/docker-compose.example.yml docker-compose.yml
+    #
+    # 2. Copy the unified transcription config (RECOMMENDED):
+    #    cp config/env.transcription.example .env
+    #
+    #    This supports all providers with auto-detection:
+    #    - OpenAI GPT-4o with diarization (set TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize)
+    #    - Self-hosted ASR/WhisperX (set ASR_BASE_URL=http://your-asr:9000)
+    #    - Legacy Whisper (set TRANSCRIPTION_MODEL=whisper-1)
+    #
+    #    Legacy config files (still supported):
+    #    - config/env.whisper.example    - Standard Whisper API
+    #    - config/env.whisperx.example   - WhisperX with voice profiles
+    #    - config/env.asr.example        - Basic ASR with diarization
+    #
+    # 3. Edit the .env file to add your API keys:
+    #    - TRANSCRIPTION_API_KEY (for OpenAI) or ASR_BASE_URL (for self-hosted)
+    #    - TEXT_MODEL_API_KEY (REQUIRED for summaries, titles, and chat)
+    #
+    # 4. Start Speakr:
+    #    docker compose up -d
+    env_file:
+      - .env
+    
+    environment:
+      # Set log level for troubleshooting
+      # Use ERROR for production (minimal logs)
+      # Use INFO for debugging issues (recommended when troubleshooting)
+      # Use DEBUG for detailed development logging
+      - LOG_LEVEL=ERROR
+
+    # --- Volume Configuration ---
+    # Choose ONE of the following volume configurations.
+    # Option 1 (Recommended): Bind mounts to local folders.
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+      # Optional: Uncomment if using auto-export feature (ENABLE_AUTO_EXPORT=true)
+      # - ./exports:/data/exports
+      # Optional: Uncomment if using auto-processing feature (ENABLE_AUTO_PROCESSING=true)
+      # - ./auto-process:/data/auto-process
+
+    # Option 2: Docker-managed volumes.
+    # volumes:
+    #   - speakr-uploads:/data/uploads
+    #   - speakr-instance:/data/instance
+    #   # Optional: Uncomment if using auto-export feature
+    #   # - speakr-exports:/data/exports
+    #   # Optional: Uncomment if using auto-processing feature
+    #   # - speakr-auto-process:/data/auto-process
diff --git a/config/env.asr.example b/config/env.asr.example
new file mode 100644
index 00000000..158db342
--- /dev/null
+++ b/config/env.asr.example
@@ -0,0 +1,269 @@
+# -----------------------------------------------------------------------------
+# Speakr Configuration: ASR Endpoint (Legacy)
+#
+# ⚠️  DEPRECATION NOTICE: This configuration style is still supported but
+# we recommend using the new unified configuration in env.transcription.example
+# which supports all transcription providers with auto-detection.
+#
+# Migration: Simply set ASR_BASE_URL and the connector will auto-detect ASR mode.
+# USE_ASR_ENDPOINT=true is no longer required (but still works for backwards compat).
+#
+# Instructions:
+# 1. Copy this file to a new file named .env
+#    cp env.asr.example .env
+# 2. Fill in the required URLs, API keys, and settings below.
+# -----------------------------------------------------------------------------
+
+# --- Text Generation Model (for summaries, titles, etc.) ---
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_api_key
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+
+# --- GPT-5 Specific Settings (only used with OpenAI API and GPT-5 models) ---
+# If using GPT-5 models (gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-chat-latest) with OpenAI API,
+# these parameters will be used instead of temperature.
+#
+# Example GPT-5 configuration:
+# TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+# TEXT_MODEL_NAME=gpt-5-mini
+#
+# Reasoning effort: minimal, low, medium, high (default: medium)
+# - minimal: Fastest responses, minimal reasoning tokens
+# - low: Fast responses with basic reasoning
+# - medium: Balanced reasoning and speed (recommended)
+# - high: Maximum reasoning for complex tasks
+GPT5_REASONING_EFFORT=medium
+#
+# Verbosity: low, medium, high (default: medium)
+# - low: Concise responses
+# - medium: Balanced detail
+# - high: Detailed explanations
+GPT5_VERBOSITY=medium
+
+# --- Chat Model Configuration (Optional) ---
+# Configure a separate model for real-time chat interactions.
+# If not set, chat will use the TEXT_MODEL_* settings above.
+#
+# Use cases:
+# - Use a faster model for chat while using a more capable model for summarization
+# - Use a cheaper model for interactive chat to reduce costs
+# - Use different service tiers for different operations
+#
+# CHAT_MODEL_API_KEY=your_chat_api_key
+# CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+# CHAT_MODEL_NAME=openai/gpt-4o
+
+# --- Chat GPT-5 Settings (only used with OpenAI API and GPT-5 chat models) ---
+# These settings allow independent control of GPT-5 parameters for chat.
+# If not set, falls back to the main GPT5_* settings above.
+#
+# CHAT_GPT5_REASONING_EFFORT=medium
+# CHAT_GPT5_VERBOSITY=medium
+
+# --- LLM Timeout & Retry ---
+# Read timeout for LLM requests in seconds (default 600). Increase for local
+# models (Ollama, vLLM) that need more time for long transcripts.
+# Connect/write timeouts stay at 30s so bad URLs fail fast.
+# LLM_REQUEST_TIMEOUT=1800
+#
+# Max retries on timeout (default 2). Set to 0 for local inference to avoid
+# queuing duplicate requests when your model is still processing the first one.
+# LLM_MAX_RETRIES=0
+
+# --- LLM Streaming Compatibility ---
+# Some LLM servers (e.g., certain vLLM configurations) don't support OpenAI's
+# stream_options parameter. If chat streaming hangs or fails, try disabling this.
+# Note: When disabled, token usage tracking for chat will not be available.
+# ENABLE_STREAM_OPTIONS=false
+
+# --- Transcription Service (ASR Endpoint) ---
+# New connector architecture auto-detects ASR mode when ASR_BASE_URL is set.
+# USE_ASR_ENDPOINT=true is deprecated but still works for backwards compatibility.
+#
+# Note: ASR endpoints handle chunking internally - CHUNK_LIMIT settings are ignored.
+
+# ASR Endpoint URL (setting this auto-enables ASR mode)
+# For containers in same docker-compose: Use container name and internal port
+# Example: http://whisper-asr:9000 (NOT the host port 6002 or external IP)
+# For external ASR: Use http://192.168.1.100:9000 or http://asr.example.com:9000
+ASR_BASE_URL=http://whisper-asr:9000
+
+# Deprecated: No longer needed, kept for backwards compatibility
+# USE_ASR_ENDPOINT=true
+
+# Speaker diarization options
+ASR_DIARIZE=true
+# ASR_MIN_SPEAKERS=1         # Hint for minimum speakers
+# ASR_MAX_SPEAKERS=5         # Hint for maximum speakers
+# ASR_RETURN_SPEAKER_EMBEDDINGS=false  # Only enable for WhisperX ASR service
+
+# --- ASR Chunking (for GPUs with limited memory) ---
+# Self-hosted ASR services may crash on long files due to GPU memory exhaustion.
+# Enable app-level chunking to split long files before sending to ASR.
+# Default: false (ASR service handles files internally)
+# ASR_ENABLE_CHUNKING=true
+
+# Maximum audio duration per chunk in seconds (default: 7200 = 2 hours)
+# Lower this value if your GPU runs out of memory on long files.
+# Common values: 600 (10 min), 1200 (20 min), 1800 (30 min), 3600 (1 hour)
+# ASR_MAX_DURATION_SECONDS=7200
+
+# --- Application Settings ---
+# Set to "true" to allow user registration, "false" to disable
+ALLOW_REGISTRATION=false
+# Comma-separated list of allowed email domains for registration.
+# Leave empty to allow all domains. Example: company.com,subsidiary.org
+REGISTRATION_ALLOWED_DOMAINS=
+SUMMARY_MAX_TOKENS=8000
+CHAT_MAX_TOKENS=5000
+
+# Timezone for displaying dates and times in the UI
+# Use a valid TZ database name (e.g., "America/New_York", "Europe/London", "UTC")
+TIMEZONE="UTC"
+
+# Set the logging level for the application.
+# Options: DEBUG, INFO, WARNING, ERROR
+LOG_LEVEL="INFO"
+
+# --- Audio Compression ---
+# Automatically compress lossless uploads (WAV, AIFF) to save storage
+AUDIO_COMPRESS_UPLOADS=true
+
+# Target codec: mp3 (lossy, smallest), flac (lossless), opus (lossy, efficient)
+AUDIO_CODEC=mp3
+
+# Bitrate for lossy codecs (ignored for FLAC)
+AUDIO_BITRATE=128k
+
+# Unsupported codecs - comma-separated list of codecs to exclude from supported list
+# Use this if your transcription service doesn't support certain codecs
+# Supported codecs by default: pcm_s16le, pcm_s24le, pcm_f32le, mp3, flac, opus, vorbis, aac
+# Example: AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+# AUDIO_UNSUPPORTED_CODECS=
+
+# --- Admin User (created on first run) ---
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=changeme
+
+# --- Inquire Mode (AI search across all recordings) ---
+# Set to "true" to enable semantic search and chat across all recordings
+# Requires additional dependencies (already included in Docker image)
+ENABLE_INQUIRE_MODE=false
+
+# --- Automated File Processing (Black Hole Directory) ---
+# Set to "true" to enable automated file processing
+ENABLE_AUTO_PROCESSING=false
+
+# --- Automated Export Settings ---
+# Automatically export transcriptions and summaries to markdown files
+ENABLE_AUTO_EXPORT=false
+
+# Directory where exports will be saved (per-user subdirectories created automatically)
+AUTO_EXPORT_DIR=/data/exports
+
+# What to include in exports
+AUTO_EXPORT_TRANSCRIPTION=true
+AUTO_EXPORT_SUMMARY=true
+
+# Processing mode: admin_only, user_directories, or single_user
+AUTO_PROCESS_MODE=admin_only
+
+# Directory to watch for new audio files
+AUTO_PROCESS_WATCH_DIR=/data/auto-process
+
+# How often to check for new files (seconds)
+AUTO_PROCESS_CHECK_INTERVAL=30
+
+# How long to wait (seconds) to confirm a file has stopped changing before processing.
+# Increase for slow network transfers (NFS, SMB). Default: 5
+# AUTO_PROCESS_STABILITY_TIME=5
+
+# Default username for single_user mode (only used if AUTO_PROCESS_MODE=single_user)
+# AUTO_PROCESS_DEFAULT_USERNAME=admin
+
+# --- Auto-Deletion & Retention Settings ---
+# Enable automated deletion of old recordings
+ENABLE_AUTO_DELETION=false
+
+# Number of days to retain recordings (0 = disabled)
+# Example: 90 means recordings older than 90 days will be processed
+GLOBAL_RETENTION_DAYS=90
+
+# Deletion mode: 'audio_only' keeps transcription, 'full_recording' deletes everything
+# audio_only: Deletes audio file but keeps transcription/summary/notes (recommended)
+# full_recording: Permanently deletes the entire recording from database
+DELETION_MODE=audio_only
+
+# --- Permission-Based Deletion Controls ---
+# Allow all users to delete their recordings, or restrict to admins only
+# true: All users can delete their own recordings (default)
+# false: Only admins can delete recordings
+USERS_CAN_DELETE=true
+
+# Delete speaker profiles when all their recordings are removed.
+# Default: false (speaker profiles and voice embeddings are preserved)
+# Set to true for privacy-sensitive deployments where biometric voice data
+# should not outlive the recordings it was derived from.
+# DELETE_ORPHANED_SPEAKERS=false
+
+# --- Internal Sharing Settings ---
+# Enable user-to-user sharing of recordings (works independently of groups)
+ENABLE_INTERNAL_SHARING=false
+
+# Show usernames in the UI (when sharing/viewing shared recordings)
+# true: Display usernames throughout the interface
+# false: Hide usernames (users must know each other's usernames to share)
+SHOW_USERNAMES_IN_UI=false
+
+# --- Public Sharing Settings ---
+# Enable creation of public share links (anonymous access)
+# true: Users can create public links to share recordings externally (default)
+# false: Public sharing is disabled globally
+ENABLE_PUBLIC_SHARING=true
+
+# Note: Admins can control public sharing permissions per-user in the admin dashboard
+# even when ENABLE_PUBLIC_SHARING is true
+
+# --- Incognito Mode (HIPAA-friendly) ---
+# Enable incognito mode for privacy-sensitive transcriptions
+# When enabled, users can upload recordings that are:
+# - Processed on the server but NOT saved to the database
+# - Stored only in the browser's sessionStorage (lost when tab closes)
+# - Audio files are immediately deleted after processing
+# Useful for HIPAA compliance or sensitive recordings
+# Default: false (feature hidden)
+ENABLE_INCOGNITO_MODE=false
+
+# Make incognito mode the default for in-app recordings (toggle starts ON)
+INCOGNITO_MODE_DEFAULT=false
+
+# --- Video Retention ---
+# When enabled, uploaded video files keep their video stream for in-browser playback
+# The audio is extracted to a temp file for transcription, then cleaned up
+# Default: false (video uploads extract audio only, video stream is discarded)
+VIDEO_RETENTION=false
+
+# --- Concurrent Uploads ---
+# Maximum number of simultaneous file uploads (default: 3)
+MAX_CONCURRENT_UPLOADS=3
+
+# --- Background Processing Queues ---
+# Separate queues for transcription (slow) and summary (fast) jobs
+# This prevents slow ASR jobs from blocking quick summary generation
+
+# Transcription queue workers (for ASR processing, default: 2)
+JOB_QUEUE_WORKERS=2
+
+# Summary queue workers (for LLM summarization, default: 2)
+SUMMARY_QUEUE_WORKERS=2
+
+# Maximum retry attempts for failed jobs (default: 3)
+JOB_MAX_RETRIES=3
+
+# --- Docker Settings (rarely need to be changed) ---
+# Database URI - SQLite (default) or PostgreSQL
+SQLALCHEMY_DATABASE_URI=sqlite:////data/instance/transcriptions.db
+# For PostgreSQL, use: postgresql://username:password@hostname:5432/database_name
+# Example: postgresql://speakr:password@postgres:5432/speakr
+UPLOAD_FOLDER=/data/uploads
diff --git a/config/env.email.example b/config/env.email.example
new file mode 100644
index 00000000..80590f7d
--- /dev/null
+++ b/config/env.email.example
@@ -0,0 +1,109 @@
+###############################################################################
+# Email Verification & Password Reset Configuration
+###############################################################################
+
+# Enable email verification for new user registrations.
+# When enabled, new users must verify their email before full access.
+# Default: false
+ENABLE_EMAIL_VERIFICATION=false
+
+# Require email verification to log in.
+# Only effective when ENABLE_EMAIL_VERIFICATION=true.
+# When true, users cannot log in until they verify their email.
+# Default: false
+REQUIRE_EMAIL_VERIFICATION=false
+
+###############################################################################
+# SMTP Configuration
+###############################################################################
+
+# SMTP server hostname (required for email functionality)
+# Examples: smtp.gmail.com, smtp.sendgrid.net, smtp.mailgun.org
+SMTP_HOST=smtp.gmail.com
+
+# SMTP server port
+# Common ports: 587 (TLS/STARTTLS), 465 (SSL), 25 (unencrypted)
+# Default: 587
+SMTP_PORT=587
+
+# SMTP authentication username (usually your email address)
+SMTP_USERNAME=your-email@gmail.com
+
+# SMTP authentication password
+# For Gmail: Use an App Password (not your regular password)
+# https://support.google.com/accounts/answer/185833
+SMTP_PASSWORD=your-app-password
+
+# Use TLS/STARTTLS encryption (recommended for port 587)
+# Default: true
+SMTP_USE_TLS=true
+
+# Use SSL encryption (for port 465)
+# Note: Only enable one of SMTP_USE_TLS or SMTP_USE_SSL
+# Default: false
+SMTP_USE_SSL=false
+
+# Email address that appears in the "From" field
+# Should be a valid email address, ideally matching your domain
+SMTP_FROM_ADDRESS=noreply@yourdomain.com
+
+# Display name that appears alongside the from address
+# Default: Speakr
+SMTP_FROM_NAME=Speakr
+
+###############################################################################
+# Provider-Specific Examples
+###############################################################################
+
+# --- Gmail ---
+# SMTP_HOST=smtp.gmail.com
+# SMTP_PORT=587
+# SMTP_USE_TLS=true
+# SMTP_USERNAME=your-email@gmail.com
+# SMTP_PASSWORD=your-app-password  # Generate at https://myaccount.google.com/apppasswords
+
+# --- SendGrid ---
+# SMTP_HOST=smtp.sendgrid.net
+# SMTP_PORT=587
+# SMTP_USE_TLS=true
+# SMTP_USERNAME=apikey
+# SMTP_PASSWORD=your-sendgrid-api-key
+
+# --- Mailgun ---
+# SMTP_HOST=smtp.mailgun.org
+# SMTP_PORT=587
+# SMTP_USE_TLS=true
+# SMTP_USERNAME=postmaster@your-domain.mailgun.org
+# SMTP_PASSWORD=your-mailgun-password
+
+# --- Amazon SES ---
+# SMTP_HOST=email-smtp.us-east-1.amazonaws.com
+# SMTP_PORT=587
+# SMTP_USE_TLS=true
+# SMTP_USERNAME=your-ses-smtp-username
+# SMTP_PASSWORD=your-ses-smtp-password
+
+# --- Microsoft 365 / Outlook ---
+# SMTP_HOST=smtp.office365.com
+# SMTP_PORT=587
+# SMTP_USE_TLS=true
+# SMTP_USERNAME=your-email@yourdomain.com
+# SMTP_PASSWORD=your-password
+
+###############################################################################
+# Notes
+###############################################################################
+
+# Token Expiry Times:
+# - Email verification links expire after 24 hours
+# - Password reset links expire after 1 hour
+
+# Migration Behavior:
+# - Existing users are automatically marked as email_verified=true
+# - New users (when feature is enabled) start as email_verified=false
+
+# Security Recommendations:
+# - Always use TLS or SSL encryption
+# - Use app-specific passwords when available (Gmail, etc.)
+# - Consider using a dedicated email service (SendGrid, Mailgun, SES)
+# - Set a strong SECRET_KEY in your Flask configuration
diff --git a/config/env.sso.example b/config/env.sso.example
new file mode 100644
index 00000000..418c9d64
--- /dev/null
+++ b/config/env.sso.example
@@ -0,0 +1,32 @@
+###############################################################################
+# SSO (OIDC) Authentication
+###############################################################################
+
+# Enable SSO (Single Sign-On) authentication. Requires discovery URL and client credentials.
+ENABLE_SSO=false
+
+# Display name for the provider (shown in UI button)
+SSO_PROVIDER_NAME=Keycloak
+
+# OIDC client credentials
+SSO_CLIENT_ID=speakr
+SSO_CLIENT_SECRET=change-me
+
+# OIDC discovery document URL (well-known endpoint)
+SSO_DISCOVERY_URL=https://keycloak.example.com/realms/master/.well-known/openid-configuration
+
+# Public redirect URI exposed by Speakr (must be registered in the IdP)
+SSO_REDIRECT_URI=https://speakr.example.com/auth/sso/callback
+
+# Auto-registration settings
+# Allow automatic account creation for new users signing in via SSO.
+SSO_AUTO_REGISTER=true
+
+# Comma-separated list of allowed email domains for auto-registration.
+# Leave empty to allow all domains (e.g., example.com,company.org).
+SSO_ALLOWED_DOMAINS=
+
+# Claims used to map user profile fields
+SSO_DEFAULT_USERNAME_CLAIM=preferred_username
+SSO_DEFAULT_NAME_CLAIM=name
+
diff --git a/config/env.transcription.example b/config/env.transcription.example
new file mode 100644
index 00000000..5d91e020
--- /dev/null
+++ b/config/env.transcription.example
@@ -0,0 +1,335 @@
+# =============================================================================
+# Transcription Connector Configuration
+# =============================================================================
+#
+# Speakr supports multiple transcription providers through a connector-based
+# architecture. This file documents all available configuration options.
+#
+# Quick Start (Simplified):
+# 1. For OpenAI with diarization: Set TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+# 2. For self-hosted ASR: Set ASR_BASE_URL=http://your-asr:9000
+# 3. For legacy Whisper: Set TRANSCRIPTION_API_KEY and optionally TRANSCRIPTION_MODEL
+#
+# Auto-Detection Priority:
+# 1. TRANSCRIPTION_CONNECTOR - explicit connector name (if you need full control)
+# 2. ASR_BASE_URL - if set, uses ASR endpoint connector
+# 3. TRANSCRIPTION_MODEL contains 'gpt-4o' - uses OpenAI Transcribe connector
+# 4. Default - uses OpenAI Whisper connector with TRANSCRIPTION_MODEL or whisper-1
+
+# =============================================================================
+# TEXT GENERATION MODEL (REQUIRED for summaries, titles, chat)
+# =============================================================================
+# Speakr uses a text/LLM model for generating summaries, titles, and chat.
+# This is separate from the transcription model (STT).
+#
+# You can use OpenRouter (recommended - access to many models) or direct OpenAI API.
+
+# OpenRouter example (recommended - supports many models):
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_api_key
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+
+# OpenAI direct example:
+# TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+# TEXT_MODEL_API_KEY=sk-your_openai_api_key
+# TEXT_MODEL_NAME=gpt-4o-mini
+
+# --- GPT-5 Specific Settings (only used with OpenAI API and GPT-5 models) ---
+# Reasoning effort: minimal, low, medium, high (default: medium)
+GPT5_REASONING_EFFORT=medium
+# Verbosity: low, medium, high (default: medium)
+GPT5_VERBOSITY=medium
+
+# --- Chat Model Configuration (Optional) ---
+# Configure a separate model for real-time chat interactions.
+# If not set, chat will use the TEXT_MODEL_* settings above.
+# CHAT_MODEL_API_KEY=your_chat_api_key
+# CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+# CHAT_MODEL_NAME=openai/gpt-4o
+
+# =============================================================================
+# CONNECTOR SELECTION (Auto-detected if not set)
+# =============================================================================
+# Options: openai_whisper, openai_transcribe, asr_endpoint, mistral, vibevoice
+# Leave empty to auto-detect based on other settings
+# TRANSCRIPTION_CONNECTOR=
+
+# Feature flag to enable/disable new connector architecture (default: true)
+# Set to false to use legacy code path for troubleshooting
+# USE_NEW_TRANSCRIPTION_ARCHITECTURE=true
+
+# =============================================================================
+# OPENAI CONFIGURATION (Required for openai_whisper and openai_transcribe)
+# =============================================================================
+TRANSCRIPTION_API_KEY=your_openai_api_key
+TRANSCRIPTION_BASE_URL=https://api.openai.com/v1
+
+# Model Selection - determines which connector is used:
+#
+# whisper-1              - Legacy Whisper model, no diarization, $0.006/min
+#                          Supports: srt, vtt, json, verbose_json output formats
+#
+# gpt-4o-transcribe      - High quality transcription, no diarization, $0.006/min
+#                          Better accuracy than whisper-1, accepts prompts
+#
+# gpt-4o-mini-transcribe - Cost-effective option, no diarization, $0.003/min
+#                          Good for high-volume, budget-conscious use
+#
+# gpt-4o-transcribe-diarize - Speaker diarization!, $0.006/min
+#                             Identifies speakers as A, B, C, D...
+#                             Requires chunking_strategy for audio >30s
+#
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+
+# Legacy Whisper model name (used when TRANSCRIPTION_MODEL is not set)
+# WHISPER_MODEL=whisper-1
+
+# =============================================================================
+# ASR ENDPOINT CONFIGURATION (For self-hosted whisper services)
+# =============================================================================
+# Note: USE_ASR_ENDPOINT is deprecated. Just set ASR_BASE_URL instead.
+# The connector will auto-detect ASR mode when ASR_BASE_URL is set.
+# USE_ASR_ENDPOINT=true  # Deprecated - kept for backwards compatibility
+
+# Base URL of your ASR service (required if USE_ASR_ENDPOINT=true)
+# Supports: whisper-asr-webservice, WhisperX, and compatible services
+# ASR_BASE_URL=http://whisper-asr:9000
+
+# Request timeout in seconds (default: 1800 = 30 minutes)
+# Increase for very long audio files
+# ASR_TIMEOUT=1800
+
+# Enable speaker diarization (default: true)
+# ASR_DIARIZE=true
+
+# Speaker count hints (optional, helps with diarization accuracy)
+# ASR_MIN_SPEAKERS=1
+# ASR_MAX_SPEAKERS=5
+
+# Return speaker embeddings for speaker identification (WhisperX only)
+# Enables automatic speaker matching across recordings
+# ASR_RETURN_SPEAKER_EMBEDDINGS=false
+
+# =============================================================================
+# MISTRAL / VOXTRAL CONFIGURATION
+# =============================================================================
+# Mistral's Voxtral model provides cloud-based transcription with built-in
+# speaker diarization and language detection. Requires a Mistral API key.
+#
+# TRANSCRIPTION_CONNECTOR=mistral
+# TRANSCRIPTION_API_KEY=your_mistral_api_key
+# TRANSCRIPTION_MODEL=voxtral-mini-latest
+#
+# To use a custom Mistral-compatible endpoint:
+# TRANSCRIPTION_BASE_URL=https://api.mistral.ai
+
+# =============================================================================
+# VIBEVOICE CONFIGURATION (Self-hosted via vLLM)
+# =============================================================================
+# Microsoft's VibeVoice ASR model provides transcription with speaker
+# diarization, timestamps, and language detection for 50+ languages. It runs
+# on your own hardware via vLLM and handles up to 60 minutes per request.
+# Longer files are automatically chunked by the app.
+#
+# Requirements:
+# - vLLM server with the VibeVoice model loaded
+# - GPU(s) with enough VRAM (bf16 needs ~18GB, fits on 2x consumer GPUs)
+#
+# TRANSCRIPTION_CONNECTOR=vibevoice
+# TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+# TRANSCRIPTION_MODEL=vibevoice
+#
+# If your vLLM server requires authentication:
+# TRANSCRIPTION_API_KEY=your_api_key
+
+# =============================================================================
+# CHUNKING CONFIGURATION (For large files)
+# =============================================================================
+# Chunking is now connector-aware with this priority:
+# 1. Connector handles internally (openai_transcribe, asr_endpoint, mistral) → No app chunking
+# 2. ENABLE_CHUNKING=false → Disable chunking (only affects openai_whisper)
+# 3. CHUNK_LIMIT set → Use your settings
+# 4. Connector defaults → Use connector's recommended limits
+# 5. App default → 20MB size-based
+#
+# For openai_transcribe/asr_endpoint/mistral: These settings are IGNORED (connector handles it)
+# For openai_whisper: These settings control chunking behavior
+# For vibevoice: App chunks files >58 min into ~50 min pieces automatically
+
+# ENABLE_CHUNKING=false  # Uncomment to disable chunking for openai_whisper
+
+# Chunk limit - supports size (20MB) or duration (600s, 10m)
+CHUNK_LIMIT=20MB
+
+# Overlap between chunks in seconds (helps with transcription accuracy at boundaries)
+CHUNK_OVERLAP_SECONDS=3
+
+# =============================================================================
+# EXAMPLE CONFIGURATIONS (Simplified)
+# =============================================================================
+#
+# --- OpenAI with Speaker Diarization (Recommended) ---
+# Just two environment variables needed:
+# TRANSCRIPTION_API_KEY=sk-xxx
+# TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+#
+# --- Self-hosted WhisperX (Best for privacy) ---
+# Just one environment variable needed (auto-detects ASR mode):
+# ASR_BASE_URL=http://whisper-asr:9000
+# Optional:
+# ASR_DIARIZE=true
+# ASR_RETURN_SPEAKER_EMBEDDINGS=true
+#
+# --- OpenAI Whisper (Legacy, no diarization) ---
+# TRANSCRIPTION_API_KEY=sk-xxx
+# TRANSCRIPTION_MODEL=whisper-1
+#
+# --- Custom Whisper model (local or compatible endpoint) ---
+# TRANSCRIPTION_API_KEY=not-needed
+# TRANSCRIPTION_BASE_URL=http://localhost:8080/v1
+# TRANSCRIPTION_MODEL=Systran/faster-distil-whisper-large-v3
+#
+# --- Mistral Voxtral (cloud diarization) ---
+# TRANSCRIPTION_CONNECTOR=mistral
+# TRANSCRIPTION_API_KEY=your-mistral-key
+# TRANSCRIPTION_MODEL=voxtral-mini-latest
+#
+# --- VibeVoice ASR (self-hosted diarization) ---
+# TRANSCRIPTION_CONNECTOR=vibevoice
+# TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+# TRANSCRIPTION_MODEL=vibevoice
+
+# =============================================================================
+# APPLICATION SETTINGS
+# =============================================================================
+
+# --- Admin User (created on first run) ---
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=changeme
+
+# --- Registration & Access ---
+ALLOW_REGISTRATION=false
+# Comma-separated list of allowed email domains for registration.
+# Leave empty to allow all domains. Example: company.com,subsidiary.org
+REGISTRATION_ALLOWED_DOMAINS=
+
+# --- Token Limits ---
+SUMMARY_MAX_TOKENS=8000
+CHAT_MAX_TOKENS=5000
+
+# --- Timezone ---
+# Use a valid TZ database name (e.g., "America/New_York", "Europe/London", "UTC")
+TIMEZONE="UTC"
+
+# --- Logging ---
+LOG_LEVEL="INFO"
+
+# =============================================================================
+# AUDIO PROCESSING
+# =============================================================================
+
+# --- Audio Compression ---
+# Automatically compress lossless uploads (WAV, AIFF) to save storage
+AUDIO_COMPRESS_UPLOADS=true
+
+# Target codec: mp3 (lossy, smallest), flac (lossless), opus (lossy, efficient)
+AUDIO_CODEC=mp3
+
+# Bitrate for lossy codecs (ignored for FLAC)
+AUDIO_BITRATE=128k
+
+# Unsupported codecs - comma-separated list of codecs to exclude
+# Example: AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+# AUDIO_UNSUPPORTED_CODECS=
+
+# =============================================================================
+# OPTIONAL FEATURES
+# =============================================================================
+
+# --- Inquire Mode (AI search across all recordings) ---
+ENABLE_INQUIRE_MODE=false
+
+# --- Automated File Processing (Black Hole Directory) ---
+ENABLE_AUTO_PROCESSING=false
+# AUTO_PROCESS_MODE=admin_only
+# AUTO_PROCESS_WATCH_DIR=/data/auto-process
+
+# --- Automated Export ---
+ENABLE_AUTO_EXPORT=false
+# AUTO_EXPORT_DIR=/data/exports
+
+# --- Auto-Deletion & Retention ---
+ENABLE_AUTO_DELETION=false
+# GLOBAL_RETENTION_DAYS=90
+# DELETION_MODE=audio_only
+
+# --- Sharing Settings ---
+ENABLE_INTERNAL_SHARING=false
+ENABLE_PUBLIC_SHARING=true
+# SHOW_USERNAMES_IN_UI=false
+
+# --- Permission Controls ---
+USERS_CAN_DELETE=true
+
+# Delete speaker profiles when all their recordings are removed.
+# Default: false (speaker profiles and voice embeddings are preserved)
+# Set to true for privacy-sensitive deployments where biometric voice data
+# should not outlive the recordings it was derived from.
+# DELETE_ORPHANED_SPEAKERS=false
+
+# --- Video Retention ---
+# When enabled, uploaded video files keep their video stream for in-browser playback
+# The audio is extracted to a temp file for transcription, then cleaned up
+# Default: false (video uploads extract audio only, video stream is discarded)
+VIDEO_RETENTION=false
+
+# --- Video Passthrough to ASR ---
+# Send original video files directly to ASR without extracting audio.
+# Useful for custom ASR backends that handle video internally (e.g., multi-track audio extraction).
+# When enabled, video files bypass audio extraction, codec conversion, and chunking.
+# Only affects video files — audio uploads are processed normally.
+# Default: false
+# VIDEO_PASSTHROUGH_ASR=false
+
+# --- Concurrent Uploads ---
+# Maximum number of simultaneous file uploads (default: 3)
+MAX_CONCURRENT_UPLOADS=3
+
+# =============================================================================
+# BACKGROUND PROCESSING
+# =============================================================================
+
+# Transcription queue workers (default: 2)
+JOB_QUEUE_WORKERS=2
+
+# Summary queue workers (default: 2)
+SUMMARY_QUEUE_WORKERS=2
+
+# Maximum retry attempts for failed jobs (default: 3)
+JOB_MAX_RETRIES=3
+
+# =============================================================================
+# DOCKER/DATABASE SETTINGS
+# =============================================================================
+
+# Database URI - SQLite (default) or PostgreSQL
+SQLALCHEMY_DATABASE_URI=sqlite:////data/instance/transcriptions.db
+# For PostgreSQL: postgresql://username:password@hostname:5432/database_name
+
+UPLOAD_FOLDER=/data/uploads
+
+# =============================================================================
+# ADDITIONAL PROVIDER NOTES
+# =============================================================================
+# The connector architecture is designed to support additional providers.
+# Currently available: openai_whisper, openai_transcribe, asr_endpoint,
+#                      azure_openai_transcribe, mistral, vibevoice
+#
+# Future connectors may include:
+#
+# - Deepgram: Known for excellent diarization and real-time transcription
+# - AssemblyAI: Strong diarization with speaker labels
+# - Google Cloud Speech-to-Text: Enterprise-grade with speaker diarization
+#
+# To request a new connector, please open an issue on GitHub.
diff --git a/config/env.whisper.example b/config/env.whisper.example
new file mode 100644
index 00000000..4971fdf5
--- /dev/null
+++ b/config/env.whisper.example
@@ -0,0 +1,266 @@
+# -----------------------------------------------------------------------------
+# Speakr Configuration: Standard Whisper API (Legacy)
+#
+# ⚠️  DEPRECATION NOTICE: This configuration style is still supported but
+# we recommend using the new unified configuration in env.transcription.example
+# which supports all transcription providers with auto-detection.
+#
+# Migration: See TRANSCRIPTION_CONNECTOR documentation in env.transcription.example
+# For OpenAI Whisper, simply set:
+#   TRANSCRIPTION_API_KEY=your_key
+#   TRANSCRIPTION_MODEL=whisper-1  (or gpt-4o-transcribe-diarize for diarization)
+#
+# Instructions:
+# 1. Copy this file to a new file named .env
+#    cp env.whisper.example .env
+# 2. Fill in the required API keys and settings below.
+# -----------------------------------------------------------------------------
+
+# --- Text Generation Model (for summaries, titles, etc.) ---
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_api_key
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+
+# --- GPT-5 Specific Settings (only used with OpenAI API and GPT-5 models) ---
+# If using GPT-5 models (gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-chat-latest) with OpenAI API,
+# these parameters will be used instead of temperature.
+#
+# Example GPT-5 configuration:
+# TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+# TEXT_MODEL_NAME=gpt-5-mini
+#
+# Reasoning effort: minimal, low, medium, high (default: medium)
+# - minimal: Fastest responses, minimal reasoning tokens
+# - low: Fast responses with basic reasoning
+# - medium: Balanced reasoning and speed (recommended)
+# - high: Maximum reasoning for complex tasks
+GPT5_REASONING_EFFORT=medium
+#
+# Verbosity: low, medium, high (default: medium)
+# - low: Concise responses
+# - medium: Balanced detail
+# - high: Detailed explanations
+GPT5_VERBOSITY=medium
+
+# --- Chat Model Configuration (Optional) ---
+# Configure a separate model for real-time chat interactions.
+# If not set, chat will use the TEXT_MODEL_* settings above.
+#
+# Use cases:
+# - Use a faster model for chat while using a more capable model for summarization
+# - Use a cheaper model for interactive chat to reduce costs
+# - Use different service tiers for different operations
+#
+# CHAT_MODEL_API_KEY=your_chat_api_key
+# CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+# CHAT_MODEL_NAME=openai/gpt-4o
+
+# --- Chat GPT-5 Settings (only used with OpenAI API and GPT-5 chat models) ---
+# These settings allow independent control of GPT-5 parameters for chat.
+# If not set, falls back to the main GPT5_* settings above.
+#
+# CHAT_GPT5_REASONING_EFFORT=medium
+# CHAT_GPT5_VERBOSITY=medium
+
+# --- LLM Timeout & Retry ---
+# Read timeout for LLM requests in seconds (default 600). Increase for local
+# models (Ollama, vLLM) that need more time for long transcripts.
+# Connect/write timeouts stay at 30s so bad URLs fail fast.
+# LLM_REQUEST_TIMEOUT=1800
+#
+# Max retries on timeout (default 2). Set to 0 for local inference to avoid
+# queuing duplicate requests when your model is still processing the first one.
+# LLM_MAX_RETRIES=0
+
+# --- LLM Streaming Compatibility ---
+# Some LLM servers (e.g., certain vLLM configurations) don't support OpenAI's
+# stream_options parameter. If chat streaming hangs or fails, try disabling this.
+# Note: When disabled, token usage tracking for chat will not be available.
+# ENABLE_STREAM_OPTIONS=false
+
+# --- Transcription Service (OpenAI Whisper API) ---
+# New connector architecture is enabled by default.
+# Available models:
+#   whisper-1              - Legacy, no diarization
+#   gpt-4o-transcribe      - High quality, no diarization
+#   gpt-4o-mini-transcribe - Cost-effective, no diarization
+#   gpt-4o-transcribe-diarize - Speaker diarization! (recommended)
+TRANSCRIPTION_BASE_URL=https://api.openai.com/v1
+TRANSCRIPTION_API_KEY=your_openai_api_key
+TRANSCRIPTION_MODEL=whisper-1
+
+# Legacy model name (deprecated, use TRANSCRIPTION_MODEL instead)
+# WHISPER_MODEL=whisper-1
+
+# --- Application Settings ---
+# Set to "true" to allow user registration, "false" to disable
+ALLOW_REGISTRATION=false
+# Comma-separated list of allowed email domains for registration.
+# Leave empty to allow all domains. Example: company.com,subsidiary.org
+REGISTRATION_ALLOWED_DOMAINS=
+SUMMARY_MAX_TOKENS=8000
+CHAT_MAX_TOKENS=5000
+
+# Timezone for displaying dates and times in the UI
+# Use a valid TZ database name (e.g., "America/New_York", "Europe/London", "UTC")
+TIMEZONE="UTC"
+
+# Set the logging level for the application.
+# Options: DEBUG, INFO, WARNING, ERROR
+LOG_LEVEL="INFO"
+
+# --- Large File Chunking ---
+# Chunking is now connector-aware:
+# - openai_transcribe/asr_endpoint: Handled internally, these settings ignored
+# - openai_whisper: Uses these settings for files >25MB
+#
+# ENABLE_CHUNKING=false  # Uncomment to disable (only for openai_whisper)
+
+# Chunk limit - supports size (20MB) or duration (600s, 10m)
+CHUNK_LIMIT=20MB
+
+# Overlap between chunks (seconds)
+CHUNK_OVERLAP_SECONDS=3
+
+# --- Audio Compression ---
+# Automatically compress lossless uploads (WAV, AIFF) to save storage
+AUDIO_COMPRESS_UPLOADS=true
+
+# Target codec: mp3 (lossy, smallest), flac (lossless), opus (lossy, efficient)
+AUDIO_CODEC=mp3
+
+# Bitrate for lossy codecs (ignored for FLAC)
+AUDIO_BITRATE=128k
+
+# Unsupported codecs - comma-separated list of codecs to exclude from supported list
+# Use this if your transcription service doesn't support certain codecs
+# Supported codecs by default: pcm_s16le, pcm_s24le, pcm_f32le, mp3, flac, opus, vorbis, aac
+# Example: AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+# AUDIO_UNSUPPORTED_CODECS=
+
+# --- Admin User (created on first run) ---
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=changeme
+
+# --- Inquire Mode (AI search across all recordings) ---
+# Set to "true" to enable semantic search and chat across all recordings
+# Requires additional dependencies (already included in Docker image)
+ENABLE_INQUIRE_MODE=false
+
+# --- Automated File Processing (Black Hole Directory) ---
+# Set to "true" to enable automated file processing
+ENABLE_AUTO_PROCESSING=false
+
+# --- Automated Export Settings ---
+# Automatically export transcriptions and summaries to markdown files
+ENABLE_AUTO_EXPORT=false
+
+# Directory where exports will be saved (per-user subdirectories created automatically)
+AUTO_EXPORT_DIR=/data/exports
+
+# What to include in exports
+AUTO_EXPORT_TRANSCRIPTION=true
+AUTO_EXPORT_SUMMARY=true
+
+# Processing mode: admin_only, user_directories, or single_user
+AUTO_PROCESS_MODE=admin_only
+
+# Directory to watch for new audio files
+AUTO_PROCESS_WATCH_DIR=/data/auto-process
+
+# How often to check for new files (seconds)
+AUTO_PROCESS_CHECK_INTERVAL=30
+
+# How long to wait (seconds) to confirm a file has stopped changing before processing.
+# Increase for slow network transfers (NFS, SMB). Default: 5
+# AUTO_PROCESS_STABILITY_TIME=5
+
+# Default username for single_user mode (only used if AUTO_PROCESS_MODE=single_user)
+# AUTO_PROCESS_DEFAULT_USERNAME=admin
+
+# --- Auto-Deletion & Retention Settings ---
+# Enable automated deletion of old recordings
+ENABLE_AUTO_DELETION=false
+
+# Number of days to retain recordings (0 = disabled)
+# Example: 90 means recordings older than 90 days will be processed
+GLOBAL_RETENTION_DAYS=90
+
+# Deletion mode: 'audio_only' keeps transcription, 'full_recording' deletes everything
+# audio_only: Deletes audio file but keeps transcription/summary/notes (recommended)
+# full_recording: Permanently deletes the entire recording from database
+DELETION_MODE=audio_only
+
+# --- Permission-Based Deletion Controls ---
+# Allow all users to delete their recordings, or restrict to admins only
+# true: All users can delete their own recordings (default)
+# false: Only admins can delete recordings
+USERS_CAN_DELETE=true
+
+# Delete speaker profiles when all their recordings are removed.
+# Default: false (speaker profiles and voice embeddings are preserved)
+# Set to true for privacy-sensitive deployments where biometric voice data
+# should not outlive the recordings it was derived from.
+# DELETE_ORPHANED_SPEAKERS=false
+
+# --- Internal Sharing Settings ---
+# Enable user-to-user sharing of recordings (works independently of groups)
+ENABLE_INTERNAL_SHARING=false
+
+# Show usernames in the UI (when sharing/viewing shared recordings)
+# true: Display usernames throughout the interface
+# false: Hide usernames (users must know each other's usernames to share)
+SHOW_USERNAMES_IN_UI=false
+
+# --- Public Sharing Settings ---
+# Enable creation of public share links (anonymous access)
+# true: Users can create public links to share recordings externally (default)
+# false: Public sharing is disabled globally
+ENABLE_PUBLIC_SHARING=true
+
+# Note: Admins can control public sharing permissions per-user in the admin dashboard
+# even when ENABLE_PUBLIC_SHARING is true
+
+# --- Incognito Mode (HIPAA-friendly) ---
+# Enable incognito mode for privacy-sensitive transcriptions
+# When enabled, users can upload recordings that are:
+# - Processed on the server but NOT saved to the database
+# - Stored only in the browser's sessionStorage (lost when tab closes)
+# - Audio files are immediately deleted after processing
+# Useful for HIPAA compliance or sensitive recordings
+# Default: false (feature hidden)
+ENABLE_INCOGNITO_MODE=false
+
+# Make incognito mode the default for in-app recordings (toggle starts ON)
+INCOGNITO_MODE_DEFAULT=false
+
+# --- Video Retention ---
+# When enabled, uploaded video files keep their video stream for in-browser playback
+# The audio is extracted to a temp file for transcription, then cleaned up
+# Default: false (video uploads extract audio only, video stream is discarded)
+VIDEO_RETENTION=false
+
+# --- Concurrent Uploads ---
+# Maximum number of simultaneous file uploads (default: 3)
+MAX_CONCURRENT_UPLOADS=3
+
+# --- Background Processing Queues ---
+# Separate queues for transcription (slow) and summary (fast) jobs
+# This prevents slow ASR jobs from blocking quick summary generation
+
+# Transcription queue workers (for ASR processing, default: 2)
+JOB_QUEUE_WORKERS=2
+
+# Summary queue workers (for LLM summarization, default: 2)
+SUMMARY_QUEUE_WORKERS=2
+
+# Maximum retry attempts for failed jobs (default: 3)
+JOB_MAX_RETRIES=3
+
+# --- Docker Settings (rarely need to be changed) ---
+# Database URI - SQLite (default) or PostgreSQL
+SQLALCHEMY_DATABASE_URI=sqlite:////data/instance/transcriptions.db
+# For PostgreSQL, use: postgresql://username:password@hostname:5432/database_name
+# Example: postgresql://speakr:password@postgres:5432/speakr
+UPLOAD_FOLDER=/data/uploads
diff --git a/config/env.whisperx.example b/config/env.whisperx.example
new file mode 100644
index 00000000..2198be8b
--- /dev/null
+++ b/config/env.whisperx.example
@@ -0,0 +1,241 @@
+# -----------------------------------------------------------------------------
+# Speakr Configuration: WhisperX ASR Endpoint (with Voice Profiles)
+#
+# ⚠️  DEPRECATION NOTICE: This configuration style is still supported but
+# we recommend using the new unified configuration in env.transcription.example
+# which supports all transcription providers with auto-detection.
+#
+# Migration: Simply set ASR_BASE_URL and the connector will auto-detect ASR mode.
+# USE_ASR_ENDPOINT=true is no longer required (but still works for backwards compat).
+#
+# This configuration is for use with the WhisperX ASR Service:
+# https://github.com/murtaza-nasir/whisperx-asr-service
+#
+# Features supported:
+# - Speaker diarization with pyannote/speaker-diarization-community-1
+# - Voice profile embeddings (256-dimensional) for speaker recognition
+# - Automatic speaker matching across recordings
+# - Better timestamp alignment between speakers and words
+#
+# Instructions:
+# 1. Copy this file to a new file named .env
+#    cp config/env.whisperx.example .env
+# 2. Fill in the required URLs, API keys, and settings below.
+# 3. Set up WhisperX ASR Service (see installation guide)
+# -----------------------------------------------------------------------------
+
+# --- Text Generation Model (for summaries, titles, etc.) ---
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_api_key
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+
+# --- GPT-5 Specific Settings (only used with OpenAI API and GPT-5 models) ---
+# If using GPT-5 models (gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-chat-latest) with OpenAI API,
+# these parameters will be used instead of temperature.
+#
+# Example GPT-5 configuration:
+# TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+# TEXT_MODEL_NAME=gpt-5-mini
+#
+# Reasoning effort: minimal, low, medium, high (default: medium)
+# - minimal: Fastest responses, minimal reasoning tokens
+# - low: Fast responses with basic reasoning
+# - medium: Balanced reasoning and speed (recommended)
+# - high: Maximum reasoning for complex tasks
+GPT5_REASONING_EFFORT=medium
+#
+# Verbosity: low, medium, high (default: medium)
+# - low: Concise responses
+# - medium: Balanced detail
+# - high: Detailed explanations
+GPT5_VERBOSITY=medium
+
+# --- Auto-Identify Speaker Response Format ---
+# When enabled, auto-identify uses JSON Schema response format (structured outputs)
+# to constrain LLM output to valid SPEAKER_XX keys. Falls back to json_object mode
+# if the model doesn't support it. Leave disabled for widest model compatibility.
+# AUTO_IDENTIFY_RESPONSE_SCHEMA=1
+
+# --- Chat Model Configuration (Optional) ---
+# Configure a separate model for real-time chat interactions.
+# If not set, chat will use the TEXT_MODEL_* settings above.
+#
+# Use cases:
+# - Use a faster model for chat while using a more capable model for summarization
+# - Use a cheaper model for interactive chat to reduce costs
+# - Use different service tiers for different operations
+#
+# CHAT_MODEL_API_KEY=your_chat_api_key
+# CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+# CHAT_MODEL_NAME=openai/gpt-4o
+
+# --- Chat GPT-5 Settings (only used with OpenAI API and GPT-5 chat models) ---
+# These settings allow independent control of GPT-5 parameters for chat.
+# If not set, falls back to the main GPT5_* settings above.
+#
+# CHAT_GPT5_REASONING_EFFORT=medium
+# CHAT_GPT5_VERBOSITY=medium
+
+# --- Transcription Service (WhisperX ASR Endpoint) ---
+# New connector architecture auto-detects ASR mode when ASR_BASE_URL is set.
+# USE_ASR_ENDPOINT=true is deprecated but still works for backwards compatibility.
+#
+# Note: ASR endpoints handle chunking internally - CHUNK_LIMIT settings are ignored.
+
+# WhisperX ASR Endpoint URL (setting this auto-enables ASR mode)
+# For containers in same docker-compose: Use container name and internal port
+# Example: http://whisperx-asr:9000 (NOT the host port or external IP)
+# For external ASR: Use http://192.168.1.100:9000 or http://asr.example.com:9000
+ASR_BASE_URL=http://whisperx-asr:9000
+
+# Deprecated: No longer needed, kept for backwards compatibility
+# USE_ASR_ENDPOINT=true
+
+# Speaker diarization options
+ASR_DIARIZE=true
+# ASR_MIN_SPEAKERS=1         # Hint for minimum speakers
+# ASR_MAX_SPEAKERS=5         # Default maximum speakers
+
+# Enable speaker embeddings for voice profile matching (WhisperX only)
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+
+# --- Application Settings ---
+# Set to "true" to allow user registration, "false" to disable
+ALLOW_REGISTRATION=false
+# Comma-separated list of allowed email domains for registration.
+# Leave empty to allow all domains. Example: company.com,subsidiary.org
+REGISTRATION_ALLOWED_DOMAINS=
+SUMMARY_MAX_TOKENS=8000
+CHAT_MAX_TOKENS=5000
+
+# Timezone for displaying dates and times in the UI
+# Use a valid TZ database name (e.g., "America/New_York", "Europe/London", "UTC")
+TIMEZONE="UTC"
+
+# Set the logging level for the application.
+# Options: DEBUG, INFO, WARNING, ERROR
+LOG_LEVEL="INFO"
+
+# --- Audio Compression ---
+# Automatically compress lossless uploads (WAV, AIFF) to save storage
+AUDIO_COMPRESS_UPLOADS=true
+
+# Target codec: mp3 (lossy, smallest), flac (lossless), opus (lossy, efficient)
+AUDIO_CODEC=mp3
+
+# Bitrate for lossy codecs (ignored for FLAC)
+AUDIO_BITRATE=128k
+
+# --- Admin User (created on first run) ---
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=changeme
+
+# --- Inquire Mode (AI search across all recordings) ---
+# Set to "true" to enable semantic search and chat across all recordings
+# Requires additional dependencies (already included in Docker image)
+ENABLE_INQUIRE_MODE=false
+
+# --- Automated File Processing (Black Hole Directory) ---
+# Set to "true" to enable automated file processing
+ENABLE_AUTO_PROCESSING=false
+
+# --- Automated Export Settings ---
+# Automatically export transcriptions and summaries to markdown files
+ENABLE_AUTO_EXPORT=false
+
+# Directory where exports will be saved (per-user subdirectories created automatically)
+AUTO_EXPORT_DIR=/data/exports
+
+# What to include in exports
+AUTO_EXPORT_TRANSCRIPTION=true
+AUTO_EXPORT_SUMMARY=true
+
+# Processing mode: admin_only, user_directories, or single_user
+AUTO_PROCESS_MODE=admin_only
+
+# Directory to watch for new audio files
+AUTO_PROCESS_WATCH_DIR=/data/auto-process
+
+# How often to check for new files (seconds)
+AUTO_PROCESS_CHECK_INTERVAL=30
+
+# How long to wait (seconds) to confirm a file has stopped changing before processing.
+# Increase for slow network transfers (NFS, SMB). Default: 5
+# AUTO_PROCESS_STABILITY_TIME=5
+
+# Default username for single_user mode (only used if AUTO_PROCESS_MODE=single_user)
+# AUTO_PROCESS_DEFAULT_USERNAME=admin
+
+# --- Auto-Deletion & Retention Settings ---
+# Enable automated deletion of old recordings
+ENABLE_AUTO_DELETION=false
+
+# Number of days to retain recordings (0 = disabled)
+# Example: 90 means recordings older than 90 days will be processed
+GLOBAL_RETENTION_DAYS=90
+
+# Deletion mode: 'audio_only' keeps transcription, 'full_recording' deletes everything
+# audio_only: Deletes audio file but keeps transcription/summary/notes (recommended)
+# full_recording: Permanently deletes the entire recording from database
+DELETION_MODE=audio_only
+
+# --- Permission-Based Deletion Controls ---
+# Allow all users to delete their recordings, or restrict to admins only
+# true: All users can delete their own recordings (default)
+# false: Only admins can delete recordings
+USERS_CAN_DELETE=true
+
+# Delete speaker profiles when all their recordings are removed.
+# Default: false (speaker profiles and voice embeddings are preserved)
+# Set to true for privacy-sensitive deployments where biometric voice data
+# should not outlive the recordings it was derived from.
+# DELETE_ORPHANED_SPEAKERS=false
+
+# --- Internal Sharing Settings ---
+# Enable user-to-user sharing of recordings (works independently of groups)
+ENABLE_INTERNAL_SHARING=false
+
+# Show usernames in the UI (when sharing/viewing shared recordings)
+# true: Display usernames throughout the interface
+# false: Hide usernames (users must know each other's usernames to share)
+SHOW_USERNAMES_IN_UI=false
+
+# --- Public Sharing Settings ---
+# Enable creation of public share links (anonymous access)
+# true: Users can create public links to share recordings externally (default)
+# false: Public sharing is disabled globally
+ENABLE_PUBLIC_SHARING=true
+
+# Note: Admins can control public sharing permissions per-user in the admin dashboard
+# even when ENABLE_PUBLIC_SHARING is true
+
+# --- Video Retention ---
+# When enabled, uploaded video files keep their video stream for in-browser playback
+# The audio is extracted to a temp file for transcription, then cleaned up
+# Default: false (video uploads extract audio only, video stream is discarded)
+VIDEO_RETENTION=false
+
+# --- Concurrent Uploads ---
+# Maximum number of simultaneous file uploads (default: 3)
+MAX_CONCURRENT_UPLOADS=3
+
+# --- Background Processing Queues ---
+# Separate queues for transcription (slow) and summary (fast) jobs
+# This prevents slow ASR jobs from blocking quick summary generation
+
+# Transcription queue workers (for ASR processing, default: 2)
+JOB_QUEUE_WORKERS=2
+
+# Summary queue workers (for LLM summarization, default: 2)
+SUMMARY_QUEUE_WORKERS=2
+
+# Maximum retry attempts for failed jobs (default: 3)
+JOB_MAX_RETRIES=3
+
+# --- Docker Settings (rarely need to be changed) ---
+# Database URI - SQLite (default) or PostgreSQL
+SQLALCHEMY_DATABASE_URI=sqlite:////data/instance/transcriptions.db
+# For PostgreSQL, use: postgresql://username:password@hostname:5432/database_name
+# Example: postgresql://speakr:password@postgres:5432/speakr
+UPLOAD_FOLDER=/data/uploads
diff --git a/constraints.txt b/constraints.txt
new file mode 100644
index 00000000..51369e32
--- /dev/null
+++ b/constraints.txt
@@ -0,0 +1 @@
+scipy<1.15
diff --git a/deployment/setup.sh b/deployment/setup.sh
index 9a7c70fa..5a469f4f 100755
--- a/deployment/setup.sh
+++ b/deployment/setup.sh
@@ -1,6 +1,8 @@
 #!/bin/bash
 
 # Create directory for the application
+sudo systemctl stop transcription
+
 sudo mkdir -p /opt/transcription-app
 sudo chown $USER:$USER /opt/transcription-app
 
@@ -8,9 +10,8 @@ sudo chown $USER:$USER /opt/transcription-app
 cp app.py /opt/transcription-app/
 cp -r templates /opt/transcription-app/
 cp requirements.txt /opt/transcription-app/
-cp reset_db.py /opt/transcription-app/
-cp migrate_db.py /opt/transcription-app/
-cp create_admin.py /opt/transcription-app/
+cp scripts/reset_db.py /opt/transcription-app/
+cp scripts/create_admin.py /opt/transcription-app/
 cp .env /opt/transcription-app/  # Copy the .env file with API keys
 
 # Add SECRET_KEY to .env file if it doesn't exist
@@ -70,6 +71,7 @@ EOF
 # Reload systemd and start service
 sudo systemctl daemon-reload
 sudo systemctl restart transcription
+sudo systemctl disable transcription
 sudo systemctl enable transcription
 
 # Check service status
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 00000000..9c4f4ad5
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,31 @@
+# Jekyll build output
+_site/
+.sass-cache/
+.jekyll-cache/
+.jekyll-metadata
+
+# Bundle directory
+.bundle/
+vendor/
+
+# Local development files
+_config_local.yml
+local-serve.sh
+docker-serve.sh
+simple-serve.sh
+serve-local.sh
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+
+# Ruby version files
+.ruby-version
+.ruby-gemset
+
+# Documentation verification (internal use)
+DOCUMENTATION_VERIFICATION_CHECKLIST.md
\ No newline at end of file
diff --git a/docs/Dockerfile b/docs/Dockerfile
new file mode 100644
index 00000000..99ce2b2a
--- /dev/null
+++ b/docs/Dockerfile
@@ -0,0 +1,28 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install git (required for git-revision-date plugin)
+RUN apt-get update && \
+    apt-get install -y git && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install requirements
+COPY requirements-docs.txt .
+RUN pip install --no-cache-dir -r requirements-docs.txt
+
+# Create docs directory structure
+RUN mkdir -p docs
+
+# Copy mkdocs config to root
+COPY mkdocs.yml .
+
+# Copy all documentation files to docs subdirectory
+COPY . ./docs/
+
+# Expose MkDocs development server port
+EXPOSE 8000
+
+# Run MkDocs server
+CMD ["mkdocs", "serve", "--dev-addr=0.0.0.0:8000"]
\ No newline at end of file
diff --git a/docs/Gemfile.simple b/docs/Gemfile.simple
new file mode 100644
index 00000000..9ca69719
--- /dev/null
+++ b/docs/Gemfile.simple
@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3"
+gem "jekyll-seo-tag"
+gem "jekyll-sitemap"
+gem "jekyll-feed"
+gem "webrick", "~> 1.8"
+gem "kramdown-parser-gfm"
\ No newline at end of file
diff --git a/docs/PUSH_NOTIFICATIONS_SETUP.md b/docs/PUSH_NOTIFICATIONS_SETUP.md
new file mode 100644
index 00000000..df4c824d
--- /dev/null
+++ b/docs/PUSH_NOTIFICATIONS_SETUP.md
@@ -0,0 +1,324 @@
+# Push Notifications Setup Guide
+
+This guide explains how to complete the push notification setup for Speakr.
+
+## Overview
+
+The client-side push notification infrastructure is now complete. To enable push notifications, you need to:
+
+1. Generate VAPID keys
+2. Configure the client with the public key
+3. Implement backend endpoints to store subscriptions and send notifications
+
+## Step 1: Generate VAPID Keys
+
+### Method A: Using web-push (Node.js)
+
+```bash
+npm install -g web-push
+web-push generate-vapid-keys
+```
+
+### Method B: Using Python
+
+```bash
+pip install pywebpush
+```
+
+```python
+from pywebpush import vapid_keys
+
+vapid_keys = vapid_keys()
+print("Public Key:", vapid_keys['publicKey'])
+print("Private Key:", vapid_keys['privateKey'])
+```
+
+### Method C: Using pywebpush CLI
+
+```bash
+pywebpush generate-vapid-keys
+```
+
+**IMPORTANT:** Keep the private key secret! Never commit it to version control.
+
+## Step 2: Configure Client
+
+1. Open `static/js/config/push-config.js`
+2. Set `ENABLED: true`
+3. Add your VAPID public key to `VAPID_PUBLIC_KEY`
+4. Update `CONTACT_INFO` with your admin email or website
+
+```javascript
+export const PUSH_CONFIG = {
+    ENABLED: true,
+    VAPID_PUBLIC_KEY: 'YOUR_PUBLIC_KEY_HERE',
+    CONTACT_INFO: 'mailto:admin@yourdomain.com'
+};
+```
+
+## Step 3: Implement Backend Endpoints
+
+### Required Backend Endpoints
+
+#### 1. Store Push Subscription
+
+**Endpoint:** `POST /api/push/subscribe`
+
+**Purpose:** Save user's push subscription to database
+
+**Request Body:**
+```json
+{
+    "endpoint": "https://fcm.googleapis.com/fcm/send/...",
+    "keys": {
+        "p256dh": "...",
+        "auth": "..."
+    }
+}
+```
+
+**Response:**
+```json
+{
+    "success": true,
+    "message": "Subscription saved"
+}
+```
+
+**Implementation Example (Flask):**
+
+```python
+from flask import Blueprint, request, jsonify
+from flask_login import login_required, current_user
+from models import db, PushSubscription
+
+push_bp = Blueprint('push', __name__)
+
+@push_bp.route('/api/push/subscribe', methods=['POST'])
+@login_required
+def subscribe():
+    """Store push subscription for current user"""
+    subscription_data = request.json
+
+    # Check if subscription already exists
+    existing = PushSubscription.query.filter_by(
+        user_id=current_user.id,
+        endpoint=subscription_data['endpoint']
+    ).first()
+
+    if existing:
+        return jsonify({'success': True, 'message': 'Already subscribed'})
+
+    # Create new subscription
+    subscription = PushSubscription(
+        user_id=current_user.id,
+        endpoint=subscription_data['endpoint'],
+        p256dh_key=subscription_data['keys']['p256dh'],
+        auth_key=subscription_data['keys']['auth']
+    )
+
+    db.session.add(subscription)
+    db.session.commit()
+
+    return jsonify({'success': True, 'message': 'Subscription saved'})
+```
+
+#### 2. Remove Push Subscription
+
+**Endpoint:** `POST /api/push/unsubscribe`
+
+**Purpose:** Remove user's push subscription from database
+
+**Request Body:** Same as subscribe
+
+**Response:**
+```json
+{
+    "success": true,
+    "message": "Subscription removed"
+}
+```
+
+**Implementation Example:**
+
+```python
+@push_bp.route('/api/push/unsubscribe', methods=['POST'])
+@login_required
+def unsubscribe():
+    """Remove push subscription for current user"""
+    subscription_data = request.json
+
+    subscription = PushSubscription.query.filter_by(
+        user_id=current_user.id,
+        endpoint=subscription_data['endpoint']
+    ).first()
+
+    if subscription:
+        db.session.delete(subscription)
+        db.session.commit()
+        return jsonify({'success': True, 'message': 'Subscription removed'})
+
+    return jsonify({'success': False, 'message': 'Subscription not found'}), 404
+```
+
+## Step 4: Database Model
+
+Add a `PushSubscription` model to your database:
+
+```python
+from models import db
+from sqlalchemy import Column, Integer, String, ForeignKey, DateTime
+from sqlalchemy.sql import func
+
+class PushSubscription(db.Model):
+    __tablename__ = 'push_subscriptions'
+
+    id = Column(Integer, primary_key=True)
+    user_id = Column(Integer, ForeignKey('users.id'), nullable=False)
+    endpoint = Column(String(500), nullable=False, unique=True)
+    p256dh_key = Column(String(200), nullable=False)
+    auth_key = Column(String(100), nullable=False)
+    created_at = Column(DateTime, server_default=func.now())
+
+    __table_args__ = (
+        db.Index('idx_user_endpoint', 'user_id', 'endpoint'),
+    )
+```
+
+Create the migration:
+
+```bash
+flask db migrate -m "Add push subscriptions table"
+flask db upgrade
+```
+
+## Step 5: Send Push Notifications
+
+Use the `pywebpush` library to send notifications when transcription is complete:
+
+```python
+from pywebpush import webpush, WebPushException
+import json
+import os
+
+def send_push_notification(user_id, title, body, data=None):
+    """Send push notification to all subscriptions for a user"""
+    subscriptions = PushSubscription.query.filter_by(user_id=user_id).all()
+
+    vapid_private_key = os.getenv('VAPID_PRIVATE_KEY')
+    vapid_contact = os.getenv('VAPID_CONTACT', 'mailto:admin@example.com')
+
+    notification_data = {
+        'title': title,
+        'body': body,
+        'icon': '/static/img/icon-192x192.png',
+        'badge': '/static/img/icon-192x192.png',
+        'data': data or {}
+    }
+
+    for subscription in subscriptions:
+        try:
+            webpush(
+                subscription_info={
+                    'endpoint': subscription.endpoint,
+                    'keys': {
+                        'p256dh': subscription.p256dh_key,
+                        'auth': subscription.auth_key
+                    }
+                },
+                data=json.dumps(notification_data),
+                vapid_private_key=vapid_private_key,
+                vapid_claims={'sub': vapid_contact}
+            )
+            print(f'Push notification sent to user {user_id}')
+        except WebPushException as e:
+            print(f'Failed to send push to {subscription.endpoint}: {e}')
+            # If subscription is expired, remove it
+            if e.response and e.response.status_code in [404, 410]:
+                db.session.delete(subscription)
+                db.session.commit()
+```
+
+## Step 6: Integrate with Transcription
+
+Call the push notification function when transcription is complete:
+
+```python
+# In your transcription completion handler
+def on_transcription_complete(recording_id):
+    recording = AudioFile.query.get(recording_id)
+
+    if recording:
+        send_push_notification(
+            user_id=recording.user_id,
+            title='Transcription Complete',
+            body=f'"{recording.display_name or recording.filename}" has been transcribed',
+            data={
+                'recording_id': recording_id,
+                'url': f'/recording/{recording_id}'
+            }
+        )
+```
+
+## Step 7: Environment Variables
+
+Add these environment variables to your `.env` file:
+
+```bash
+# VAPID keys for push notifications
+VAPID_PRIVATE_KEY=your_private_key_here
+VAPID_CONTACT=mailto:admin@yourdomain.com
+```
+
+## Testing Push Notifications
+
+1. Open the app in a browser
+2. Open Developer Tools > Console
+3. Run: `await pwaComposable.subscribeToPushNotifications()`
+4. Check database to verify subscription was saved
+5. Trigger a test notification from the backend
+6. Verify notification appears
+
+## Browser Support
+
+| Browser | Desktop | Mobile |
+|---------|---------|--------|
+| Chrome  | ✅      | ✅     |
+| Edge    | ✅      | ✅     |
+| Firefox | ✅      | ✅     |
+| Safari  | ✅      | ⚠️ iOS 16.4+ |
+| Opera   | ✅      | ✅     |
+
+**Note:** iOS Safari requires iOS 16.4+ and the app must be added to the home screen.
+
+## Troubleshooting
+
+### Subscription fails with "NotAllowedError"
+- User denied notification permission
+- Ask user to enable notifications in browser settings
+
+### Subscription not saving on server
+- Check backend endpoint is accessible
+- Verify CSRF token is valid
+- Check server logs for errors
+
+### Push notifications not received
+- Verify VAPID keys match between client and server
+- Check subscription is in database
+- Test with browser developer tools
+- Ensure service worker is registered
+
+## Security Considerations
+
+1. **Never expose private VAPID key** - Keep it on server only
+2. **Validate subscriptions** - Ensure they belong to authenticated users
+3. **Rate limit subscriptions** - Prevent abuse
+4. **Clean up expired subscriptions** - Remove 404/410 responses
+5. **Use HTTPS** - Required for push notifications
+
+## Additional Resources
+
+- [Web Push Protocol](https://datatracker.ietf.org/doc/html/rfc8030)
+- [VAPID Specification](https://datatracker.ietf.org/doc/html/rfc8292)
+- [pywebpush Documentation](https://github.com/web-push-libs/pywebpush)
+- [MDN Push API](https://developer.mozilla.org/en-US/docs/Web/API/Push_API)
diff --git a/docs/_includes/sidebar.html b/docs/_includes/sidebar.html
new file mode 100644
index 00000000..9e522354
--- /dev/null
+++ b/docs/_includes/sidebar.html
@@ -0,0 +1,33 @@
+<nav class="sidebar">
+  <div class="sidebar-header">
+    <img src="{{ '/assets/images/logo.png' | relative_url }}" alt="Speakr Logo" class="sidebar-logo">
+    <h2 class="sidebar-title">Speakr Docs</h2>
+  </div>
+  
+  <div class="sidebar-content">
+    {% for section in site.navigation %}
+    <div class="sidebar-section">
+      <h3 class="sidebar-section-title">{{ section.title }}</h3>
+      <ul class="sidebar-list">
+        {% for item in section.items %}
+        <li class="sidebar-item">
+          <a href="{{ item.url | relative_url }}" 
+             class="sidebar-link {% if page.url == item.url %}active{% endif %}">
+            {{ item.title }}
+          </a>
+        </li>
+        {% endfor %}
+      </ul>
+    </div>
+    {% endfor %}
+  </div>
+  
+  <div class="sidebar-footer">
+    <a href="https://github.com/murtaza-nasir/speakr" class="github-link">
+      <svg class="github-icon" viewBox="0 0 16 16" width="20" height="20">
+        <path fill="currentColor" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path>
+      </svg>
+      GitHub
+    </a>
+  </div>
+</nav>
\ No newline at end of file
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
new file mode 100644
index 00000000..9c0c02d6
--- /dev/null
+++ b/docs/_layouts/default.html
@@ -0,0 +1,403 @@
+<!DOCTYPE html>
+<html lang="{{ site.lang | default: 'en-US' }}">
+<head>
+    <meta charset="UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+
+    {% seo %}
+    <link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
+    <link rel="icon" type="image/png" href="{{ '/assets/images/logo.png' | relative_url }}">
+    
+    <!-- Custom fonts -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+    
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        
+        body {
+            font-family: 'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+            line-height: 1.6;
+            color: #1f2937;
+            font-size: 15px;
+        }
+        
+        .docs-wrapper {
+            display: flex;
+            min-height: 100vh;
+        }
+        
+        /* Sidebar Styles */
+        .sidebar {
+            position: fixed;
+            left: 0;
+            top: 0;
+            width: 280px;
+            height: 100vh;
+            background: #f9fafb;
+            border-right: 1px solid #e5e7eb;
+            overflow-y: auto;
+            z-index: 100;
+        }
+        
+        .sidebar-header {
+            padding: 1.5rem;
+            background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%);
+            color: white;
+            text-align: center;
+        }
+        
+        .sidebar-logo {
+            width: 60px;
+            height: 60px;
+            border-radius: 12px;
+            margin-bottom: 0.5rem;
+        }
+        
+        .sidebar-title {
+            font-size: 1.25rem;
+            font-weight: 600;
+            margin: 0;
+        }
+        
+        .sidebar-content {
+            padding: 1rem 0;
+        }
+        
+        .sidebar-section {
+            margin-bottom: 1.5rem;
+        }
+        
+        .sidebar-section-title {
+            font-size: 0.75rem;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.05em;
+            color: #6b7280;
+            padding: 0 1.5rem;
+            margin-bottom: 0.5rem;
+        }
+        
+        .sidebar-list {
+            list-style: none;
+        }
+        
+        .sidebar-item {
+            margin: 0;
+        }
+        
+        .sidebar-link {
+            display: block;
+            padding: 0.5rem 1.5rem;
+            color: #4b5563;
+            text-decoration: none;
+            transition: all 0.2s ease;
+            font-size: 0.95rem;
+        }
+        
+        .sidebar-link:hover {
+            background: #e5e7eb;
+            color: #1f2937;
+        }
+        
+        .sidebar-link.active {
+            background: #6366f1;
+            color: white;
+            font-weight: 500;
+        }
+        
+        .sidebar-footer {
+            padding: 1rem 1.5rem;
+            border-top: 1px solid #e5e7eb;
+            margin-top: auto;
+        }
+        
+        .github-link {
+            display: flex;
+            align-items: center;
+            gap: 0.5rem;
+            color: #6b7280;
+            text-decoration: none;
+            font-size: 0.9rem;
+            transition: color 0.2s;
+        }
+        
+        .github-link:hover {
+            color: #1f2937;
+        }
+        
+        .github-icon {
+            flex-shrink: 0;
+        }
+        
+        /* Main Content Styles */
+        .main-content {
+            flex: 1;
+            margin-left: 280px;
+            min-width: 0;
+        }
+        
+        .content-wrapper {
+            max-width: 900px;
+            margin: 0 auto;
+            padding: 2rem 3rem;
+        }
+        
+        /* Content Typography */
+        .content-wrapper h1 {
+            color: #1f2937;
+            font-size: 1.875rem;
+            font-weight: 700;
+            margin-bottom: 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 2px solid #6366f1;
+        }
+        
+        .content-wrapper h2 {
+            color: #1f2937;
+            font-size: 1.5rem;
+            font-weight: 600;
+            margin-top: 2rem;
+            margin-bottom: 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 1px solid #e5e7eb;
+        }
+        
+        .content-wrapper h3 {
+            color: #374151;
+            font-size: 1.25rem;
+            font-weight: 600;
+            margin-top: 1.5rem;
+            margin-bottom: 0.75rem;
+        }
+        
+        .content-wrapper h4 {
+            color: #4b5563;
+            font-size: 1.125rem;
+            font-weight: 600;
+            margin-top: 1.25rem;
+            margin-bottom: 0.5rem;
+        }
+        
+        .content-wrapper p {
+            margin-bottom: 1rem;
+            line-height: 1.6;
+            font-size: 0.95rem;
+        }
+        
+        .content-wrapper img {
+            max-width: 100%;
+            height: auto;
+            border-radius: 12px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.1);
+            margin: 2rem 0;
+        }
+        
+        .content-wrapper code {
+            background: #f3f4f6;
+            padding: 0.125rem 0.375rem;
+            border-radius: 4px;
+            color: #dc2626;
+            font-size: 0.85em;
+            font-family: 'Monaco', 'Courier New', monospace;
+            font-weight: 500;
+        }
+        
+        .content-wrapper pre {
+            background: #2d3748;
+            color: #e2e8f0;
+            padding: 1rem;
+            border-radius: 8px;
+            overflow-x: auto;
+            margin: 1rem 0;
+            border: 1px solid #4a5568;
+        }
+        
+        .content-wrapper pre code {
+            background: none;
+            color: #e2e8f0;
+            padding: 0;
+            font-weight: normal;
+        }
+        
+        /* Override syntax highlighting for better contrast */
+        .content-wrapper .highlight pre {
+            background: #1f2937;
+        }
+        
+        .content-wrapper .highlight code {
+            color: #f3f4f6;
+        }
+        
+        .content-wrapper ul, .content-wrapper ol {
+            margin-bottom: 1rem;
+            padding-left: 2rem;
+        }
+        
+        .content-wrapper li {
+            margin-bottom: 0.5rem;
+            font-size: 0.95rem;
+        }
+        
+        .content-wrapper blockquote {
+            border-left: 4px solid #6366f1;
+            padding-left: 1rem;
+            margin: 1rem 0;
+            font-style: italic;
+            color: #6b7280;
+        }
+        
+        .content-wrapper table {
+            width: 100%;
+            border-collapse: collapse;
+            margin: 1rem 0;
+        }
+        
+        .content-wrapper th, .content-wrapper td {
+            padding: 0.75rem;
+            text-align: left;
+            border: 1px solid #e5e7eb;
+        }
+        
+        .content-wrapper th {
+            background: #f9fafb;
+            font-weight: 600;
+        }
+        
+        .content-wrapper a {
+            color: #4f46e5;
+            text-decoration: none;
+            font-weight: 500;
+        }
+        
+        .content-wrapper a:hover {
+            text-decoration: underline;
+            color: #4338ca;
+        }
+        
+        /* Ensure inline code in links is visible */
+        .content-wrapper a code {
+            color: inherit;
+        }
+        
+        /* Override Jekyll/Rouge syntax highlighting for better contrast */
+        .highlighter-rouge .highlight {
+            background: #2d3748 !important;
+        }
+        
+        .highlight {
+            background: #2d3748 !important;
+            color: #e2e8f0 !important;
+        }
+        
+        .highlight pre {
+            background: #2d3748 !important;
+            color: #e2e8f0 !important;
+        }
+        
+        /* Make all text light by default */
+        .highlight * {
+            color: #e2e8f0 !important;
+        }
+        
+        /* Then override specific elements */
+        .highlight .c { color: #718096 !important; } /* Comment */
+        .highlight .s, .highlight .s1, .highlight .s2 { color: #68d391 !important; } /* String */
+        .highlight .k { color: #b794f4 !important; } /* Keyword */
+        .highlight .o { color: #f6ad55 !important; } /* Operator */
+        .highlight .m { color: #f6ad55 !important; } /* Number */
+        .highlight .nb { color: #63b3ed !important; } /* Builtin */
+        .highlight .nv { color: #fc8181 !important; } /* Variable */
+        
+        /* Ensure operators like -O are visible */
+        .highlight .p { color: #cbd5e0 !important; } /* Punctuation */
+        .highlight .nt { color: #63b3ed !important; } /* Tag */
+        .highlight .na { color: #f6ad55 !important; } /* Attribute */
+        
+        /* Mobile Responsiveness */
+        @media (max-width: 768px) {
+            .sidebar {
+                transform: translateX(-100%);
+                transition: transform 0.3s ease;
+            }
+            
+            .sidebar.active {
+                transform: translateX(0);
+            }
+            
+            .main-content {
+                margin-left: 0;
+            }
+            
+            .content-wrapper {
+                padding: 1.5rem;
+            }
+        }
+        
+        /* Home page special styles */
+        .home-header {
+            text-align: center;
+            padding: 3rem 0;
+            background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%);
+            color: white;
+            margin: -2rem -3rem 2rem -3rem;
+            border-radius: 12px;
+        }
+        
+        .project-logo {
+            width: 100px;
+            height: 100px;
+            margin: 0 auto 1rem;
+            display: block;
+            border-radius: 20px;
+            box-shadow: 0 10px 25px rgba(0,0,0,0.2);
+        }
+    </style>
+</head>
+<body>
+    <div class="docs-wrapper">
+        {% include sidebar.html %}
+        
+        <main class="main-content">
+            <div class="content-wrapper">
+                {{ content }}
+            </div>
+        </main>
+    </div>
+    
+    <script>
+        // Mobile sidebar toggle
+        document.addEventListener('DOMContentLoaded', function() {
+            const sidebar = document.querySelector('.sidebar');
+            const toggleBtn = document.createElement('button');
+            toggleBtn.innerHTML = '☰';
+            toggleBtn.style.cssText = 'position:fixed;top:1rem;left:1rem;z-index:200;padding:0.5rem 0.75rem;background:white;border:1px solid #e5e7eb;border-radius:8px;cursor:pointer;display:none;';
+            
+            if (window.innerWidth <= 768) {
+                toggleBtn.style.display = 'block';
+            }
+            
+            toggleBtn.onclick = function() {
+                sidebar.classList.toggle('active');
+            };
+            
+            document.body.appendChild(toggleBtn);
+            
+            window.addEventListener('resize', function() {
+                if (window.innerWidth <= 768) {
+                    toggleBtn.style.display = 'block';
+                } else {
+                    toggleBtn.style.display = 'none';
+                    sidebar.classList.remove('active');
+                }
+            });
+        });
+    </script>
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/_layouts/docs.html b/docs/_layouts/docs.html
new file mode 100644
index 00000000..820db4f3
--- /dev/null
+++ b/docs/_layouts/docs.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{% if page.title %}{{ page.title }} - {% endif %}{{ site.title }}</title>
+  <meta name="description" content="{% if page.description %}{{ page.description }}{% else %}{{ site.description }}{% endif %}">
+  <link rel="stylesheet" href="{{ '/assets/css/style.css' | relative_url }}">
+  <link rel="icon" type="image/png" href="{{ '/assets/images/logo.png' | relative_url }}">
+</head>
+<body>
+  <div class="docs-wrapper">
+    {% include sidebar.html %}
+    
+    <main class="main-content">
+      <div class="content-wrapper">
+        {{ content }}
+      </div>
+    </main>
+  </div>
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/admin-guide/email-setup.md b/docs/admin-guide/email-setup.md
new file mode 100644
index 00000000..84871b21
--- /dev/null
+++ b/docs/admin-guide/email-setup.md
@@ -0,0 +1,226 @@
+# Email Verification & Password Reset
+
+This guide explains how to configure email functionality in Speakr, enabling email verification for new user registrations and password reset capabilities for all users.
+
+## Overview
+
+Email features in Speakr are completely opt-in. When configured, they provide:
+
+- **Email Verification**: Require new users to verify their email address before accessing the system
+- **Password Reset**: Allow users to reset forgotten passwords via email
+
+Both features work independently of domain restrictions—you can use email verification even with open registration (`ALLOW_REGISTRATION=true`) and no domain restrictions.
+
+## Prerequisites
+
+- SMTP server credentials (Gmail, SendGrid, Mailgun, Amazon SES, or any SMTP provider)
+- Speakr instance accessible via the URL you configure (for email links to work)
+
+## Configuration
+
+### Required Environment Variables
+
+Set these variables in your `.env` file (see `config/env.email.example` for a complete template):
+
+```bash
+# Enable email features
+ENABLE_EMAIL_VERIFICATION=true
+REQUIRE_EMAIL_VERIFICATION=false
+
+# SMTP Configuration
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USERNAME=your-email@gmail.com
+SMTP_PASSWORD=your-app-password
+SMTP_USE_TLS=true
+SMTP_FROM_ADDRESS=noreply@yourdomain.com
+SMTP_FROM_NAME=Speakr
+```
+
+Restart Speakr after updating environment variables.
+
+### Configuration Options
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ENABLE_EMAIL_VERIFICATION` | `false` | Enable email verification for new registrations |
+| `REQUIRE_EMAIL_VERIFICATION` | `false` | Block login for unverified users (only works when verification is enabled) |
+| `SMTP_HOST` | (none) | SMTP server hostname |
+| `SMTP_PORT` | `587` | SMTP server port |
+| `SMTP_USERNAME` | (none) | SMTP authentication username |
+| `SMTP_PASSWORD` | (none) | SMTP authentication password |
+| `SMTP_USE_TLS` | `true` | Use STARTTLS encryption (port 587) |
+| `SMTP_USE_SSL` | `false` | Use SSL encryption (port 465) |
+| `SMTP_FROM_ADDRESS` | `noreply@yourdomain.com` | Email address shown in "From" field |
+| `SMTP_FROM_NAME` | `Speakr` | Display name shown alongside from address |
+
+### Understanding the Two Verification Modes
+
+**Soft Verification** (`ENABLE_EMAIL_VERIFICATION=true`, `REQUIRE_EMAIL_VERIFICATION=false`):
+
+- New users receive a verification email after registration
+- Users can log in immediately without verifying
+- Useful for encouraging email verification without blocking access
+
+**Strict Verification** (`ENABLE_EMAIL_VERIFICATION=true`, `REQUIRE_EMAIL_VERIFICATION=true`):
+
+- New users receive a verification email after registration
+- Users cannot log in until they verify their email
+- Best for environments requiring confirmed email addresses
+
+### Combining with Other Registration Settings
+
+Email verification works seamlessly with other registration controls:
+
+```bash
+# Open registration with email verification
+ALLOW_REGISTRATION=true
+ENABLE_EMAIL_VERIFICATION=true
+REQUIRE_EMAIL_VERIFICATION=true
+
+# Domain-restricted registration with verification
+ALLOW_REGISTRATION=true
+REGISTRATION_ALLOWED_DOMAINS=company.com,subsidiary.org
+ENABLE_EMAIL_VERIFICATION=true
+REQUIRE_EMAIL_VERIFICATION=true
+
+# Closed registration (admin creates accounts)
+ALLOW_REGISTRATION=false
+# Email verification not applicable - admin creates verified accounts
+```
+
+## Provider-Specific Setup
+
+### Gmail
+
+```bash
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USE_TLS=true
+SMTP_USERNAME=your-email@gmail.com
+SMTP_PASSWORD=your-app-password
+```
+
+**Important:** Use an [App Password](https://support.google.com/accounts/answer/185833), not your regular Gmail password. App Passwords are required when 2-factor authentication is enabled (recommended).
+
+### SendGrid
+
+```bash
+SMTP_HOST=smtp.sendgrid.net
+SMTP_PORT=587
+SMTP_USE_TLS=true
+SMTP_USERNAME=apikey
+SMTP_PASSWORD=your-sendgrid-api-key
+```
+
+### Mailgun
+
+```bash
+SMTP_HOST=smtp.mailgun.org
+SMTP_PORT=587
+SMTP_USE_TLS=true
+SMTP_USERNAME=postmaster@your-domain.mailgun.org
+SMTP_PASSWORD=your-mailgun-password
+```
+
+### Amazon SES
+
+```bash
+SMTP_HOST=email-smtp.us-east-1.amazonaws.com
+SMTP_PORT=587
+SMTP_USE_TLS=true
+SMTP_USERNAME=your-ses-smtp-username
+SMTP_PASSWORD=your-ses-smtp-password
+```
+
+### Microsoft 365 / Outlook
+
+```bash
+SMTP_HOST=smtp.office365.com
+SMTP_PORT=587
+SMTP_USE_TLS=true
+SMTP_USERNAME=your-email@yourdomain.com
+SMTP_PASSWORD=your-password
+```
+
+### SSL vs TLS
+
+- **Port 587 with TLS** (recommended): Set `SMTP_USE_TLS=true`, `SMTP_USE_SSL=false`
+- **Port 465 with SSL**: Set `SMTP_USE_TLS=false`, `SMTP_USE_SSL=true`
+- **Port 25 (unencrypted)**: Not recommended for security reasons
+
+## User Experience
+
+### Registration Flow (with verification enabled)
+
+1. User fills out registration form
+2. Account is created with `email_verified=false`
+3. Verification email is sent automatically
+4. User sees "Check your email" page with option to resend
+5. User clicks verification link in email
+6. Account is marked as verified
+7. User can now log in (if `REQUIRE_EMAIL_VERIFICATION=true`)
+
+### Password Reset Flow
+
+1. User clicks "Forgot password?" on login page
+2. User enters their email address
+3. If account exists, reset email is sent (no indication if account doesn't exist for security)
+4. User clicks reset link in email
+5. User sets new password
+6. User is redirected to login
+
+### Token Expiry
+
+- **Email verification links**: Valid for 24 hours
+- **Password reset links**: Valid for 1 hour
+
+Users can request new links if their tokens expire.
+
+## Migration Behavior
+
+When enabling email verification on an existing instance:
+
+- **Existing users are automatically marked as verified** (grandfathered)
+- Only new registrations after enabling the feature require verification
+- No action needed for current users
+
+## Security Considerations
+
+1. **Use secure SMTP connections**: Always enable TLS or SSL
+2. **Use app-specific passwords**: When available (Gmail, etc.)
+3. **Set a strong SECRET_KEY**: Token security depends on your Flask secret key
+4. **Consider dedicated email services**: SendGrid, Mailgun, and SES offer better deliverability than personal email accounts
+
+## Troubleshooting
+
+### Emails not sending
+
+1. Check Docker logs: `docker compose logs -f app`
+2. Verify SMTP credentials are correct
+3. Ensure SMTP port is not blocked by firewall
+4. Try sending a test email using the same credentials from another tool
+
+### Emails going to spam
+
+1. Use a proper `SMTP_FROM_ADDRESS` that matches your domain
+2. Configure SPF and DKIM records for your domain
+3. Consider using a dedicated email service with good reputation
+
+### Verification link not working
+
+1. Ensure `SECRET_KEY` hasn't changed since the email was sent
+2. Check if the link has expired (24 hours for verification, 1 hour for reset)
+3. Verify your Speakr instance is accessible at the URL in the email
+
+### "SMTP not configured" errors
+
+Ensure all required SMTP variables are set:
+
+- `SMTP_HOST`
+- `SMTP_USERNAME`
+- `SMTP_PASSWORD`
+
+---
+
+Next: [SSO Setup](sso-setup.md) →
diff --git a/docs/admin-guide/group-management.md b/docs/admin-guide/group-management.md
new file mode 100644
index 00000000..65afe227
--- /dev/null
+++ b/docs/admin-guide/group-management.md
@@ -0,0 +1,414 @@
+---
+layout: default
+title: Group Management
+parent: Admin Guide
+nav_order: 6
+---
+
+# Group Management
+
+Groups enable organized collaboration in multi-user Speakr instances by grouping users and automating recording access through group-specific tags. This powerful feature reduces administrative overhead while maintaining security and control over content access.
+
+## Prerequisites
+
+Before enabling groups, ensure internal sharing is configured. Groups build on Speakr's internal sharing infrastructure to automatically grant access when users apply group tags.
+
+### Required Configuration
+
+Add these settings to your `.env` file:
+
+```bash
+# Enable internal sharing (required for groups)
+ENABLE_INTERNAL_SHARING=true
+
+# Control username visibility
+SHOW_USERNAMES_IN_UI=true   # Show usernames in UI
+# OR
+SHOW_USERNAMES_IN_UI=false  # Hide usernames (users type usernames manually to share)
+```
+
+After modifying `.env`, restart your Speakr instance for changes to take effect. The Groups tab will appear in the admin dashboard once internal sharing is enabled.
+
+### Privacy Considerations
+
+The `SHOW_USERNAMES_IN_UI` setting affects the entire instance. When enabled (`true`), users see actual usernames when searching for colleagues and viewing shared content. This improves usability in small, trusted groups where everyone knows each other.
+
+When disabled (`false`), usernames are hidden from the interface. Users must know each other's usernames to share recordings - they type the username manually when creating shares. This privacy-focused approach suits organizations where username visibility should be restricted. Group functionality works identically in both modes - only the display changes.
+
+## Creating and Managing Groups
+
+Groups are created and managed exclusively through the admin dashboard. Regular users cannot create groups, ensuring centralized control over organizational structure.
+
+### Creating a Group
+
+Navigate to the Admin Dashboard and select the Groups tab. Click "Create Group" to open the creation modal. Provide a group name that clearly identifies the group's purpose - "Engineering", "Sales EMEA", "Project Phoenix", etc. Descriptive names help users understand each group's scope and purpose.
+
+The description field is optional but recommended. Use it to explain the group's purpose, which projects or departments it serves, or who should be members. Good descriptions help future administrators understand group organization and make membership decisions.
+
+Click "Create Group" to finalize creation. The group appears in your groups list immediately, though it starts with no members. The creating user (you) doesn't automatically join - membership must be explicitly granted even for group creators.
+
+### Managing Group Membership
+
+Click the users-cog icon next to any group to open the group management modal. This interface shows current members, their roles, and provides tools for adding or removing members.
+
+To add a member, select a user from the dropdown and choose their role:
+
+- **Member**: Can use group tags and access group-tagged recordings. Suitable for most group participants who need to collaborate on content.
+- **Admin**: All member capabilities plus the ability to manage group membership, create and delete group tags, and access group management features. Useful for group leads or managers who need administrative control.
+
+Click "Add Member" to grant access. The user immediately gains visibility to group tags and will receive future group-tagged recordings. They don't automatically gain access to existing group-tagged recordings - only new ones tagged after they join.
+
+### Changing Member Roles
+
+Group roles can change as responsibilities evolve. Click the role dropdown next to any member to toggle them between Member and Admin. Role changes take effect immediately.
+
+Promoting members to admin grants them access to group management capabilities. They'll see a "Group Management" link in their interface and can add/remove members, create tags, and manage the group independently. This distributes administrative workload and empowers group leads.
+
+Demoting admins to members removes their management capabilities but preserves their group membership. They retain access to group tags and recordings but can no longer manage group membership or tags.
+
+### Removing Group Members
+
+Click the red user-times icon next to any member to remove them from the group. Removal is immediate and has several effects:
+
+- The user loses access to group tags
+- They won't receive new group-tagged recordings
+- Their access to previously-shared group recordings persists
+- Their personal notes on group recordings are preserved
+
+If you need to fully revoke access to existing group recordings, you must manually revoke those internal shares through the recording's share management interface. Group removal only prevents future automatic sharing.
+
+### Deleting Groups
+
+Click the red trash icon next to a group to delete it entirely. A confirmation dialog prevents accidental deletion. Deleting a group:
+
+- Removes all group memberships
+- Deletes all group tags (via database cascade)
+- Preserves all recordings (including previously group-tagged ones)
+- Preserves all internal shares created by group tags
+
+Group deletion is irreversible. Once deleted, the group structure is gone, though recordings and access permissions created by the group persist. If you need to temporarily disable a group, consider removing all members instead of deleting the group itself.
+
+## Group Tags
+
+Group tags power automatic sharing within groups. Unlike personal tags that organize individual content, group tags trigger access grants across all group members whenever applied.
+
+### Creating Group Tags
+
+From the Groups tab, click the purple tags icon next to the relevant group. This opens the group tags modal showing existing tags and a creation form.
+
+Provide a tag name that describes the content type or purpose. Good names are specific and clear: "Sprint Reviews", "Customer Calls", "Legal Contracts". Avoid generic names like "Important" or "Group" that don't convey useful information.
+
+Select a color to visually distinguish the tag. Colors help users quickly identify content categories in the interface. Consider establishing color conventions - blue for technical content, green for sales, red for legal, etc.
+
+### Tag Retention Policies
+
+Group tags can override global retention settings with tag-specific retention periods. This powerful feature lets different content types have different lifecycles within the same instance.
+
+Leave the retention field empty to use global retention settings. The tag won't affect how long recordings are kept - they'll follow the instance-wide `GLOBAL_RETENTION_DAYS` setting.
+
+Enter a number of days to set custom retention for this tag. Recordings with this tag will be auto-deleted after the specified period, regardless of global settings. For example:
+
+- Legal group: 2555 days (7 years) for contracts and compliance recordings
+- Operations group: 14 days for daily stand-ups
+- Marketing group: 180 days for campaign planning sessions
+
+When a recording has multiple tags with different retention periods, the shortest period applies. This ensures content is never kept longer than its most restrictive tag allows.
+
+### Protection from Deletion
+
+Enable "Protect from deletion" to make recordings with this tag immune to automatic deletion. Protected recordings are never auto-deleted regardless of age, global retention settings, or other tag retention periods.
+
+Use protection for recordings that must be permanently preserved:
+
+- Legal and compliance records
+- Critical business decisions
+- Training and onboarding materials
+- Reference documentation
+- Historical archives
+
+Protection can be removed by editing the tag later if preservation requirements change. Removing protection doesn't immediately delete recordings - they'll be evaluated for deletion on the next retention check based on their age and other applicable retention policies.
+
+### Auto-Share Settings
+
+Group tags support two levels of automatic sharing that trigger when any group member applies the tag to a recording:
+
+**Share with All Group Members** is the default and recommended approach. When enabled, applying this tag shares the recording with every group member (excluding the owner). All members receive view and edit permissions, enabling full collaboration.
+
+**Share with Group Leads Only** restricts automatic sharing to group admins. When enabled, only users with the admin role in this group receive automatic access. Regular members don't get automatic access, though group admins can manually share with them if needed. This option suits sensitive content that requires administrative oversight before wider distribution.
+
+Both options can be enabled simultaneously, though this is redundant - sharing with all members already includes group leads. Use one or the other based on your content sensitivity and group structure.
+
+### Managing Group Tags
+
+Existing group tags appear in the group tags modal with their current settings. Click the edit icon to modify a tag's name, color, retention, protection, or sharing settings. Changes affect the tag going forward but don't retroactively change already-applied tags or shares.
+
+Delete group tags by clicking the trash icon. Deleted tags:
+
+- Are removed from all recordings they were applied to
+- Disappear from tag selectors for all group members
+- Don't delete the recordings themselves
+- Don't revoke access already granted through the tag
+
+If a tag was widely used, consider the impact before deletion. Users may have organized content around that tag, and deletion removes that organizational structure. In most cases, retaining unused tags causes no harm.
+
+### Syncing Group Shares
+
+If your instance enabled group features after recordings were already tagged, or if group membership changed significantly, you might have group-tagged recordings that weren't automatically shared with current group members. The "Sync Group Shares" feature addresses this.
+
+Click "Sync Group Shares" in the group management modal to open the sync dialog. Review the information about what the sync will do - it applies automatic sharing retroactively to all existing recordings with this group's tags.
+
+The sync operation:
+
+- Identifies all recordings tagged with any of this group's tags
+- Checks each recording for existing shares with current group members
+- Creates missing shares for group members who should have access but don't
+- Respects the tag's sharing settings (all members vs. group leads only)
+- Skips recordings where members already have access
+
+Confirm the sync to execute. Depending on the number of tagged recordings and group size, this might take a few seconds to several minutes. A result modal shows how many shares were created and how many recordings were processed.
+
+Sync is safe to run multiple times - it won't create duplicate shares. Use it after adding many new members, after fixing misconfigured tags, or when migrating from older Speakr versions that didn't have full group support.
+
+## Group Admin Role
+
+Group admins are group members with elevated permissions within their group's scope. Unlike full instance administrators who can manage all groups and system settings, group admins can only manage groups where they have the admin role.
+
+### Granting Group Admin Access
+
+When adding a member to a group, select "Admin" from the role dropdown. The user immediately gains group admin capabilities for that group only. They cannot manage other groups or access system-wide administrative features.
+
+Group admins see a "Group Management" link in their user menu instead of the full admin link. Clicking this takes them to a focused admin interface showing only groups they administer. The interface is identical to the Groups tab regular admins see, but scoped to their groups.
+
+### Group Admin Capabilities
+
+Group admins can perform these actions within their groups:
+
+- Add new members from the instance's user base
+- Remove existing members (excluding themselves)
+- Change member roles between admin and member
+- Create new group tags with full configuration options
+- Edit existing group tags including retention and sharing settings
+- Delete group tags
+- Sync group shares for their groups
+
+Group admins cannot:
+
+- Create new groups
+- Delete groups
+- Manage groups they're not admins of
+- Access system-wide admin features (users, settings, statistics)
+- Grant themselves admin access to other groups
+
+This scoped access lets you distribute group management responsibility to group leads without granting full administrative access. Group leads can manage their groups independently while you maintain control over instance-wide settings and group creation.
+
+### Security Boundaries
+
+Group admins have powerful capabilities within their groups but cannot escalate their privileges. They cannot:
+
+- Make themselves full instance administrators
+- Grant themselves admin roles in other groups
+- Access or modify system settings
+- View statistics for other groups or the entire instance
+- Delete recordings owned by other users (even within their group)
+
+The database enforces these boundaries at the API level. Even if a group admin could somehow call instance-wide admin APIs, the backend verifies permissions and rejects unauthorized requests. The UI simply hides controls group admins can't use, but security doesn't rely on UI hiding.
+
+## Configuration Reference
+
+### Environment Variables
+
+```bash
+# Internal Sharing (Required)
+ENABLE_INTERNAL_SHARING=true|false
+
+# Username Display
+SHOW_USERNAMES_IN_UI=true|false
+
+# Public Sharing Control (Affects group members' public sharing)
+ENABLE_PUBLIC_SHARING=true|false
+
+# Retention Settings (Groups can override)
+ENABLE_AUTO_DELETION=true|false
+GLOBAL_RETENTION_DAYS=90
+DELETION_MODE=audio_only|full_recording
+```
+
+### Database Schema
+
+Groups use several database tables that work together:
+
+**Group Table**:
+
+- `id`: Primary key
+- `name`: Group name (max 100 chars)
+- `description`: Optional group description
+- `created_by`: User ID of creator (full admin)
+- `created_at`: Creation timestamp
+
+**TeamMembership Table**:
+
+- `id`: Primary key
+- `team_id`: References Group
+- `user_id`: References User
+- `role`: "admin" or "member"
+- `joined_at`: Membership timestamp
+
+**Tag Table** (Extended):
+
+- `team_id`: References Group (null for personal tags)
+- `retention_days`: Custom retention override (null uses global)
+- `protect_from_deletion`: Boolean protection flag
+- `auto_share_on_apply`: Boolean (share with all members)
+- `share_with_team_lead`: Boolean (share with group admins only)
+
+Cascade deletion is configured so deleting a group deletes its tags and memberships, but preserves recordings and shares.
+
+## Troubleshooting
+
+### Groups Tab Not Visible
+
+**Cause**: Internal sharing not enabled or not configured correctly.
+
+**Solution**:
+
+1. Check `.env` contains `ENABLE_INTERNAL_SHARING=true`
+2. Restart Speakr after `.env` changes
+3. Clear browser cache and reload
+4. Check application logs for startup errors
+
+### Users Can't See Group Tags
+
+**Cause**: User not added to group, or internal sharing disabled.
+
+**Solution**:
+
+1. Verify user is listed in group membership
+2. Confirm `ENABLE_INTERNAL_SHARING=true` in `.env`
+3. Check user is logged in (group tags hidden for anonymous users)
+4. Refresh the page to load updated tag lists
+
+### Auto-Sharing Not Working
+
+**Cause**: Group tag misconfigured or internal sharing disabled.
+
+**Solution**:
+
+1. Edit the group tag and verify "Share with all group members" or "Share with group leads" is enabled
+2. Confirm `ENABLE_INTERNAL_SHARING=true` in `.env`
+3. Check application logs when applying tags for sharing errors
+4. Try manually sharing the recording to verify sharing infrastructure works
+
+### Group Admin Can't Access Admin Interface
+
+**Cause**: User doesn't have admin role in any group, or routing issue.
+
+**Solution**:
+
+1. Verify user role is "admin" not "member" in group membership
+2. Have user log out and back in to refresh session
+3. Check "Group Management" link appears in user menu (not "Admin")
+4. Review application logs for permission errors
+
+### Recordings Not Deleted Per Retention Policy
+
+**Cause**: Protected tags, misconfigured retention, or auto-deletion disabled.
+
+**Solution**:
+
+1. Check if recording has protected group tags
+2. Verify `ENABLE_AUTO_DELETION=true` in `.env`
+3. Confirm `GLOBAL_RETENTION_DAYS` is set if no tag retention applies
+4. Review cron scheduler logs for deletion errors
+5. Check tag retention_days is set correctly (null = use global)
+
+### Sync Group Shares Shows Zero Shares Created
+
+**Cause**: All applicable shares already exist, or no recordings have group tags.
+
+**Solution**:
+
+1. Verify recordings actually have tags from this group
+2. Check if group members already have access via other shares
+3. Review whether recordings are owned by current group members (no self-sharing)
+4. Confirm group has members beyond the recording owners
+
+## Best Practices
+
+### Group Structure
+
+**Small Organizations (<10 users)**:
+Create groups per department (Engineering, Sales, HR). Use group tags for project names or content types. Liberal use of groups promotes collaboration since everyone knows everyone.
+
+**Large Organizations (>10 users)**:
+Create groups per product, division, or major project. Use nested organizational patterns if needed (separate groups for Product A Engineering and Product A Sales). More selective group membership prevents information overload.
+
+### Tag Naming Conventions
+
+Establish conventions early and document them for consistency:
+
+```
+Project-Based: "Project-Phoenix", "Initiative-Q3-2024"
+Content-Type: "Sprint-Reviews", "Customer-Calls", "Legal-Contracts"
+Department: "Eng-Architecture", "Sales-Training", "HR-Interviews"
+```
+
+Avoid generic names that don't communicate purpose:
+❌ "Important", "Misc", "Other", "Temp", "Group"
+✓ "Executive-Briefings", "Tech-Specs", "Client-Demos"
+
+### Retention Strategy
+
+Set thoughtful defaults that balance storage costs with compliance needs:
+
+```
+Global Default: 90 days (captures most content)
+Legal Group Tags: 2555 days (7 years for legal records)
+Compliance Tags: Protected (permanent retention)
+Meeting Tags: 180 days (reasonable collaboration window)
+Stand-up Tags: 14 days (ephemeral daily content)
+```
+
+Review retention policies quarterly to ensure they remain appropriate as business needs change.
+
+### Group Admin Distribution
+
+Grant group admin roles to natural group leaders - project managers, department heads, tech leads. This distributes administrative workload and empowers groups to self-manage.
+
+Avoid granting group admin too liberally. While it's scoped to individual groups, group admins can add members and create tags that affect access. Limit the role to trusted individuals who understand security implications.
+
+Document each group's admins in the group description or external documentation. Future administrators will appreciate knowing who to contact about group-specific questions.
+
+## Integration with Other Features
+
+### Inquire Mode
+
+Group tags automatically appear in Inquire Mode's available filters, enabling group-scoped semantic search. Users can search for "budget discussions" and filter to just their project group, finding relevant conversations without noise from other groups.
+
+Recordings shared via group tags are included in semantic search results. The vector store indexes all accessible recordings, meaning group content becomes part of users' searchable knowledge base automatically.
+
+### Retention and Auto-Deletion
+
+Tag-level retention policies integrate with Speakr's auto-deletion system. The nightly retention check evaluates each recording's tags to determine applicable retention periods:
+
+1. If recording has protected tags → Never deleted
+2. If recording has tags with `retention_days` → Use shortest tag retention
+3. Otherwise → Use global `GLOBAL_RETENTION_DAYS`
+
+This cascading system lets groups set specific policies while maintaining instance-wide defaults for untagged content.
+
+### Public Sharing
+
+Group membership doesn't affect public sharing capabilities. Users' ability to create public share links is controlled by:
+
+1. Global `ENABLE_PUBLIC_SHARING` setting
+2. Per-user `can_share_publicly` permission (if global is enabled)
+
+Group members can create public links for group recordings if they have appropriate permissions, enabling external stakeholder communication while maintaining group-internal collaboration.
+
+---
+
+Groups transform multi-user Speakr instances into collaborative platforms where information flows automatically to relevant people. Proper configuration and management ensure security while enabling seamless knowledge sharing.
+
+For user-focused group documentation, see the [Group Collaboration](../user-guide/groups.md) guide.
+
+Return to [Admin Guide](index.md) →
diff --git a/docs/admin-guide/index.md b/docs/admin-guide/index.md
new file mode 100644
index 00000000..ca37d14b
--- /dev/null
+++ b/docs/admin-guide/index.md
@@ -0,0 +1,142 @@
+# Admin Guide
+
+Welcome to the Speakr Admin Guide! As an administrator, you control the heart of your Speakr instance, managing users, monitoring system health, and configuring AI behavior.
+
+## Administrative Controls
+
+<div class="guide-cards">
+  <div class="guide-card">
+    <div class="card-icon">👥</div>
+    <h3>User Management</h3>
+    <p>Create accounts, manage permissions, monitor usage, and control access to your Speakr instance.</p>
+    <a href="user-management" class="card-link">Manage Users →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🤝</div>
+    <h3>Group Management</h3>
+    <p>Create groups, assign roles, configure auto-sharing tags, and enable organized collaboration.</p>
+    <a href="group-management" class="card-link">Manage Groups →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">📊</div>
+    <h3>System Statistics</h3>
+    <p>Monitor system health, track usage patterns, and identify potential issues before they affect users.</p>
+    <a href="statistics" class="card-link">View Statistics →</a>
+  </div>
+  
+  <div class="guide-card">
+    <div class="card-icon">🔧</div>
+    <h3>System Settings</h3>
+    <p>Configure global limits, timeouts, file sizes, and system-wide behavior that affects all users.</p>
+    <a href="system-settings" class="card-link">Configure System →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🤖</div>
+    <h3>Model Configuration</h3>
+    <p>Configure AI models for text generation, including GPT-5 support and provider selection.</p>
+    <a href="model-configuration" class="card-link">Configure Models →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">✨</div>
+    <h3>Default Prompts</h3>
+    <p>Customize AI behavior with default summary prompts that shape how content is processed.</p>
+    <a href="prompts" class="card-link">Set Prompts →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🔍</div>
+    <h3>Vector Store</h3>
+    <p>Manage semantic search capabilities, monitor embedding status, and control Inquire Mode.</p>
+    <a href="vector-store" class="card-link">Manage Search →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🗑️</div>
+    <h3>Retention & Auto-Deletion</h3>
+    <p>Configure automated data lifecycle management with flexible retention policies and smart deletion rules.</p>
+    <a href="retention" class="card-link">Manage Retention →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">📧</div>
+    <h3>Email Setup</h3>
+    <p>Configure email verification for new registrations and enable password reset functionality.</p>
+    <a href="email-setup" class="card-link">Setup Email →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🔐</div>
+    <h3>SSO Setup</h3>
+    <p>Integrate with identity providers like Keycloak, Azure AD, Google, or Auth0 using OpenID Connect.</p>
+    <a href="sso-setup" class="card-link">Configure SSO →</a>
+  </div>
+</div>
+
+## Quick Actions
+
+<div class="action-cards">
+  <div class="action-card">
+    <span class="action-icon">➕</span>
+    <div>
+      <strong>Add New User</strong>
+      <p>User Management → Add User Button → Enter details → Set permissions</p>
+    </div>
+  </div>
+
+  <div class="action-card">
+    <span class="action-icon">🤝</span>
+    <div>
+      <strong>Create a Group</strong>
+      <p>Group Management → Create Group → Add members → Configure group tags</p>
+    </div>
+  </div>
+
+  <div class="action-card">
+    <span class="action-icon">📈</span>
+    <div>
+      <strong>Check System Health</strong>
+      <p>System Statistics → Review metrics → Check processing status → Monitor storage</p>
+    </div>
+  </div>
+  
+  <div class="action-card">
+    <span class="action-icon">⚙️</span>
+    <div>
+      <strong>Update Settings</strong>
+      <p>System Settings → Adjust limits → Configure timeouts → Save changes</p>
+    </div>
+  </div>
+  
+  <div class="action-card">
+    <span class="action-icon">🔄</span>
+    <div>
+      <strong>Process Embeddings</strong>
+      <p>Vector Store → Check status → Process pending → Monitor progress</p>
+    </div>
+  </div>
+</div>
+
+## Need Admin Help?
+
+<div class="help-section">
+  <div class="help-item">
+    <span class="help-icon">📖</span>
+    <span>Review the detailed <a href="../troubleshooting.md">Troubleshooting Guide</a></span>
+  </div>
+  <div class="help-item">
+    <span class="help-icon">🐛</span>
+    <span>Check Docker logs: <code>docker compose logs -f app</code></span>
+  </div>
+  <div class="help-item">
+    <span class="help-icon">💾</span>
+    <span>Backup your data directory regularly</span>
+  </div>
+</div>
+
+---
+
+Ready to manage your Speakr instance? Start with [User Management](user-management.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/migration-guide.md b/docs/admin-guide/migration-guide.md
new file mode 100644
index 00000000..50af4c6a
--- /dev/null
+++ b/docs/admin-guide/migration-guide.md
@@ -0,0 +1,245 @@
+# Migration Guide: Connector Architecture
+
+This guide helps you migrate from the legacy transcription configuration to the new connector-based architecture introduced in Speakr v0.8.
+
+## Overview
+
+Speakr now uses a **connector-based architecture** for transcription services. This provides:
+
+- **Simplified configuration** - Fewer environment variables needed
+- **Auto-detection** - Speakr can attempt to automatically select the right connector
+- **Better feature support** - Data-driven UI that adapts to connector capabilities
+- **Extensibility** - Possibility to add custom connectors for new providers
+
+## Backwards Compatibility
+
+**Your existing configuration will continue to work.** The new architecture maintains full backwards compatibility with legacy environment variables. However, you may see deprecation warnings in the logs for certain settings.
+
+## What's Changed
+
+### Deprecated Environment Variables
+
+| Deprecated Variable | Status | Migration |
+|---------------------|--------|-----------|
+| `USE_ASR_ENDPOINT=true` | Still works, logs warning | Just set `ASR_BASE_URL` instead |
+| `WHISPER_MODEL` | Still works, logs warning | Use `TRANSCRIPTION_MODEL` instead |
+
+### New Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `TRANSCRIPTION_CONNECTOR` | Explicit connector selection (optional, auto-detected) |
+| `TRANSCRIPTION_MODEL` | Model name for OpenAI connectors |
+
+### Auto-Detection Priority
+
+Speakr automatically selects a connector based on your configuration:
+
+1. **Explicit selection** - If `TRANSCRIPTION_CONNECTOR` is set, use that connector
+2. **ASR mode** - If `ASR_BASE_URL` is set, use the ASR Endpoint connector
+3. **OpenAI Transcribe** - If `TRANSCRIPTION_MODEL` contains `gpt-4o`, use OpenAI Transcribe connector
+4. **Default** - Use OpenAI Whisper connector with `TRANSCRIPTION_MODEL` or `whisper-1`
+
+## Migration Examples
+
+### From Legacy ASR Configuration
+
+**Before (Legacy):**
+```bash
+USE_ASR_ENDPOINT=true
+ASR_BASE_URL=http://whisperx-asr:9000
+ASR_DIARIZE=true
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+**After (New - Minimal):**
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+The `USE_ASR_ENDPOINT=true` is no longer needed—setting `ASR_BASE_URL` automatically enables ASR mode. Diarization is enabled by default for ASR endpoints.
+
+### From Legacy Whisper Configuration
+
+**Before (Legacy):**
+```bash
+TRANSCRIPTION_BASE_URL=https://api.openai.com/v1
+TRANSCRIPTION_API_KEY=sk-xxx
+WHISPER_MODEL=whisper-1
+```
+
+**After (New):**
+```bash
+TRANSCRIPTION_API_KEY=sk-xxx
+TRANSCRIPTION_MODEL=whisper-1
+```
+
+The base URL defaults to OpenAI's API, and `TRANSCRIPTION_MODEL` replaces the deprecated `WHISPER_MODEL`.
+
+### Upgrading to OpenAI Diarization
+
+If you want speaker diarization without running a self-hosted ASR service:
+
+**New Configuration:**
+```bash
+TRANSCRIPTION_API_KEY=sk-xxx
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+```
+
+This uses OpenAI's built-in diarization. The connector is auto-detected from the model name.
+
+### Using Mistral Voxtral
+
+Mistral's Voxtral provides cloud-based transcription with diarization:
+
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-mistral-key
+TRANSCRIPTION_MODEL=voxtral-mini-latest
+```
+
+### Using VibeVoice ASR (Self-Hosted)
+
+VibeVoice runs on your own hardware via vLLM, with no cloud dependency:
+
+```bash
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+TRANSCRIPTION_MODEL=vibevoice
+```
+
+Both connectors support speaker diarization, timestamps, and automatic language detection.
+
+## Chunking Behavior Changes
+
+The new architecture makes chunking **connector-aware**:
+
+| Connector | Chunking Behavior |
+|-----------|-------------------|
+| **ASR Endpoint** | Handled internally—your `CHUNK_*` settings are ignored |
+| **OpenAI Transcribe** | Handled internally via `chunking_strategy=auto`—your settings are ignored |
+| **Mistral** | Handled internally—your `CHUNK_*` settings are ignored |
+| **VibeVoice** | App chunks files over ~58 minutes into ~50 minute pieces automatically |
+| **OpenAI Whisper** | Uses your `CHUNK_LIMIT` and `CHUNK_OVERLAP_SECONDS` settings |
+
+If you were manually configuring chunking for ASR endpoints, you can remove those settings as they no longer have any effect.
+
+## UI Feature Changes
+
+Some UI features are now **data-driven** rather than configuration-driven:
+
+| Feature | Old Behavior | New Behavior |
+|---------|--------------|--------------|
+| Speaker identification button | Shown when `USE_ASR_ENDPOINT=true` | Shown when transcription has diarization data |
+| Min/Max speakers in reprocess | Always shown for ASR | Only shown when connector supports it |
+| Bubble view toggle | Based on config | Based on whether transcription has dialogue |
+
+This means features automatically appear when available, regardless of which connector produced the transcription.
+
+## Verifying Your Migration
+
+After updating your configuration:
+
+1. **Check the logs** - Look for deprecation warnings:
+   ```bash
+   docker compose logs app | grep -i deprecat
+   ```
+
+2. **Test transcription** - Upload a test file and verify it transcribes correctly
+
+3. **Check system info** - Visit `/api/system/info` to see the active connector:
+   ```json
+   {
+     "transcription": {
+       "connector": "asr_endpoint",
+       "supports_diarization": true,
+       "supports_speaker_embeddings": true
+     }
+   }
+   ```
+
+## Recommended Configuration
+
+### For Mistral Voxtral (Cloud Diarization)
+
+```bash
+# Transcription
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-mistral-key
+TRANSCRIPTION_MODEL=voxtral-mini-latest
+
+# Text generation
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=sk-or-v1-xxx
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+### For VibeVoice ASR (Self-Hosted, No Cloud)
+
+```bash
+# Transcription
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+TRANSCRIPTION_MODEL=vibevoice
+
+# Text generation
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=sk-or-v1-xxx
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+### For Self-Hosted (Best Quality)
+
+Using WhisperX ASR Service for superior transcription and diarization:
+
+```bash
+# Transcription
+ASR_BASE_URL=http://whisperx-asr:9000
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+
+# Text generation
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=sk-or-v1-xxx
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+### For Cloud-Based (No Self-Hosting)
+
+Using OpenAI's transcription with diarization:
+
+```bash
+# Transcription
+TRANSCRIPTION_API_KEY=sk-xxx
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+
+# Text generation
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=sk-or-v1-xxx
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+## Troubleshooting
+
+### "Connector not found" Error
+
+Ensure you have the correct environment variables set. Check the auto-detection priority above.
+
+### Features Missing After Migration
+
+If UI features like speaker identification are missing:
+
+- Verify the transcription actually contains diarization data
+- Check that your connector supports the feature (e.g., voice profiles require ASR endpoint)
+
+### Deprecation Warnings in Logs
+
+These are informational only—your configuration still works. Update your `.env` file at your convenience to use the new variable names.
+
+## Getting Help
+
+If you encounter issues during migration:
+
+1. Check the [troubleshooting guide](../troubleshooting.md)
+2. Review the [installation guide](../getting-started/installation.md) for complete configuration examples
+3. Open an issue on [GitHub](https://github.com/murtaza-nasir/speakr/issues)
diff --git a/docs/admin-guide/model-configuration.md b/docs/admin-guide/model-configuration.md
new file mode 100644
index 00000000..94ce6fb2
--- /dev/null
+++ b/docs/admin-guide/model-configuration.md
@@ -0,0 +1,542 @@
+# Model Configuration
+
+This guide covers how to configure AI models for text generation in Speakr, including support for OpenAI's GPT-5 series and other language models.
+
+## Overview
+
+Speakr uses AI models for several key features:
+
+- **Summary Generation**: Creating intelligent summaries of your transcriptions
+- **Title Generation**: Automatically generating descriptive titles for recordings
+- **Event Extraction**: Identifying calendar-worthy events from conversations
+- **Interactive Chat**: Answering questions about your recordings
+- **Speaker Identification**: Detecting speaker names from conversation context
+
+These features are powered by large language models (LLMs) configured through your `.env` file.
+
+## Basic Configuration
+
+The text generation model is configured using three environment variables:
+
+```bash
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_api_key_here
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+### Choosing a Provider
+
+**OpenRouter** (recommended for most users): Provides access to multiple AI models through a single API, often at competitive prices. Supports GPT-4, Claude, and many other models. Configure using `TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1`.
+
+**OpenAI Direct**: Use OpenAI's API directly for access to their latest models including GPT-5. Configure using `TEXT_MODEL_BASE_URL=https://api.openai.com/v1`. This option is required for GPT-5 models with their specialized parameters.
+
+**Custom Endpoints**: Speakr works with any OpenAI-compatible API endpoint, including self-hosted solutions like LocalAI, Ollama with OpenAI compatibility, or enterprise API gateways.
+
+**Google Gemini (OpenAI-compatible)**: Google exposes Gemini models behind an OpenAI-compatible URL. Point Speakr at it like any other base URL:
+
+```bash
+TEXT_MODEL_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
+TEXT_MODEL_API_KEY=your_google_api_key
+TEXT_MODEL_NAME=gemini-2.0-flash
+```
+
+No special connector is needed; Speakr's standard LLM client works with the endpoint directly.
+
+## GPT-5 Support
+
+Speakr fully supports OpenAI's GPT-5 model family, automatically detecting and adjusting API parameters when you use GPT-5 models with the official OpenAI API.
+
+### Requirements
+
+- **OpenAI Python SDK**: Version 2.2.0 or higher (included in `requirements.txt`)
+- **OpenAI API**: Must use `TEXT_MODEL_BASE_URL=https://api.openai.com/v1`
+- **Valid API Key**: An OpenAI API key with GPT-5 access
+
+### Supported GPT-5 Models
+
+- **gpt-5**: Best for complex reasoning, broad world knowledge, and code-heavy tasks
+- **gpt-5-mini**: Cost-optimized reasoning and chat; balances speed, cost, and capability
+- **gpt-5-nano**: High-throughput tasks, especially simple instruction-following
+- **gpt-5-chat-latest**: Latest GPT-5 chat model
+
+### Key Differences from GPT-4
+
+GPT-5 models use different parameters than previous models:
+
+**Unsupported Parameters** (will cause errors if used):
+
+- `temperature` - Replaced by `reasoning_effort` and `verbosity`
+- `top_p` - Not supported
+- `logprobs` - Not supported
+
+**New GPT-5 Parameters**:
+
+**Reasoning Effort**: Controls how many reasoning tokens the model generates before producing a response.
+
+- **minimal**: Fastest responses, minimal reasoning tokens (best for simple tasks)
+- **low**: Fast responses with basic reasoning
+- **medium**: Balanced reasoning and speed (default, recommended)
+- **high**: Maximum reasoning for complex tasks like coding and multi-step planning
+
+**Verbosity**: Controls how many output tokens are generated.
+
+- **low**: Concise responses
+- **medium**: Balanced detail (default)
+- **high**: Thorough explanations and detailed code
+
+**Token Limits**: GPT-5 uses `max_completion_tokens` instead of `max_tokens`.
+
+### Configuring GPT-5
+
+Add these settings to your `.env` file:
+
+```bash
+# Use OpenAI API endpoint
+TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+TEXT_MODEL_API_KEY=your_openai_api_key
+TEXT_MODEL_NAME=gpt-5-mini
+
+# GPT-5 specific parameters (optional, defaults shown)
+GPT5_REASONING_EFFORT=medium
+GPT5_VERBOSITY=medium
+```
+
+### GPT-5 Configuration Examples
+
+**Fast Summarization (Low Cost)**:
+```bash
+TEXT_MODEL_NAME=gpt-5-nano
+GPT5_REASONING_EFFORT=minimal
+GPT5_VERBOSITY=low
+```
+
+**Standard Usage (Recommended)**:
+```bash
+TEXT_MODEL_NAME=gpt-5-mini
+GPT5_REASONING_EFFORT=medium
+GPT5_VERBOSITY=medium
+```
+
+**Complex Analysis (High Quality)**:
+```bash
+TEXT_MODEL_NAME=gpt-5
+GPT5_REASONING_EFFORT=high
+GPT5_VERBOSITY=high
+```
+
+### Automatic Detection
+
+Speakr automatically detects when you're using:
+
+1. A GPT-5 model (based on model name)
+2. The official OpenAI API (based on base URL containing `api.openai.com`)
+
+When both conditions are met, Speakr automatically:
+
+- Removes `temperature` parameter from API calls
+- Adds `reasoning_effort` parameter
+- Adds `verbosity` parameter
+- Uses `max_completion_tokens` instead of `max_tokens`
+- Logs that GPT-5 parameters are being used
+
+Check your logs for confirmation:
+```
+Using GPT-5 model: gpt-5-mini - applying GPT-5 specific parameters
+```
+
+### Using GPT-5 Through OpenRouter
+
+If you use GPT-5 models through OpenRouter or other proxy services, the automatic GPT-5 parameter handling will **not** activate. These services typically handle parameter translation themselves, so Speakr uses standard parameters (temperature, max_tokens, etc.).
+
+### Use Cases
+
+**Summarization**:
+
+- Fast summaries: `gpt-5-nano` with `minimal` effort and `low` verbosity
+- Standard summaries: `gpt-5-mini` with `medium` effort and `medium` verbosity
+- Detailed summaries: `gpt-5` with `medium` effort and `high` verbosity
+
+**Chat**:
+
+- Quick Q&A: `gpt-5-mini` with `minimal` effort and `low` verbosity
+- Standard conversation: `gpt-5-mini` with `low` effort and `medium` verbosity
+- Complex analysis: `gpt-5` with `high` effort and `medium` verbosity
+
+### Troubleshooting GPT-5
+
+**Error: "Unsupported parameter 'temperature'"**
+
+This means GPT-5 detection failed. Check that:
+
+1. `TEXT_MODEL_BASE_URL` contains `api.openai.com`
+2. `TEXT_MODEL_NAME` starts with `gpt-5` or is one of: `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-5-chat-latest`
+
+**Error: "Invalid reasoning_effort value"**
+
+Valid values are: `minimal`, `low`, `medium`, `high`
+
+**Error: "Invalid verbosity value"**
+
+Valid values are: `low`, `medium`, `high`
+
+### Migrating from GPT-4 to GPT-5
+
+1. **Update dependencies** (required for GPT-5):
+   ```bash
+   pip install -r requirements.txt
+   ```
+   This upgrades the OpenAI SDK to version 2.2.0 or higher.
+
+2. Update your `.env` file:
+   ```bash
+   TEXT_MODEL_NAME=gpt-5-mini  # or gpt-5, gpt-5-nano
+   ```
+
+3. Add GPT-5 parameters (optional):
+   ```bash
+   GPT5_REASONING_EFFORT=medium
+   GPT5_VERBOSITY=medium
+   ```
+
+4. Restart Speakr:
+   ```bash
+   docker compose restart
+   ```
+
+5. Check logs for confirmation:
+   ```
+   Using GPT-5 model: gpt-5-mini - applying GPT-5 specific parameters
+   ```
+
+### Performance Considerations
+
+- **Cost**: `gpt-5-nano` < `gpt-5-mini` < `gpt-5`
+- **Speed**: `minimal` < `low` < `medium` < `high` reasoning effort
+- **Quality**: Generally increases with model size and reasoning effort
+- **Token usage**: Higher verbosity = more output tokens
+
+For most use cases, we recommend:
+
+- **Model**: `gpt-5-mini`
+- **Reasoning**: `medium`
+- **Verbosity**: `medium`
+
+This provides a good balance of cost, speed, and quality.
+
+## Separate Chat Model Configuration
+
+Speakr allows you to configure a separate model specifically for real-time chat interactions, while using a different model for background tasks like summarization and title generation. This enables you to:
+
+- **Use different service tiers**: Configure a faster, more expensive model for interactive chat while using a cheaper model for background processing
+- **Optimize costs**: Use a budget-friendly model for summarization while keeping a high-quality model for chat
+- **Balance speed and quality**: Prioritize low latency for chat while accepting slower processing for summaries
+
+### Configuration
+
+Add these optional environment variables to your `.env` file:
+
+```bash
+# Chat Model Configuration (Optional)
+# If not set, chat will use TEXT_MODEL_* settings
+CHAT_MODEL_API_KEY=your_chat_api_key
+CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+CHAT_MODEL_NAME=openai/gpt-4o
+```
+
+### Fallback Behavior
+
+| Configuration | Behavior |
+|--------------|----------|
+| No `CHAT_MODEL_*` variables set | Chat uses `TEXT_MODEL_*` settings (default) |
+| Only `CHAT_MODEL_NAME` set | Falls back to `TEXT_MODEL_*` (API key required) |
+| Only `CHAT_MODEL_API_KEY` set | Falls back to `TEXT_MODEL_*` (model name required) |
+| `CHAT_MODEL_API_KEY` + `CHAT_MODEL_NAME` set | Uses chat config with `TEXT_MODEL_BASE_URL` |
+| All `CHAT_MODEL_*` variables set | Uses fully dedicated chat configuration |
+
+### GPT-5 Settings for Chat
+
+If you use GPT-5 models for chat, you can configure separate GPT-5 parameters:
+
+```bash
+# Chat-specific GPT-5 settings (optional)
+# Falls back to GPT5_* settings if not specified
+CHAT_GPT5_REASONING_EFFORT=medium
+CHAT_GPT5_VERBOSITY=medium
+```
+
+### Example Configurations
+
+**Cheap Summarization + Premium Chat**:
+```bash
+# Background tasks: Use budget model
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_key
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+
+# Interactive chat: Use premium model
+CHAT_MODEL_API_KEY=your_openai_key
+CHAT_MODEL_BASE_URL=https://api.openai.com/v1
+CHAT_MODEL_NAME=gpt-5-mini
+CHAT_GPT5_REASONING_EFFORT=low
+CHAT_GPT5_VERBOSITY=medium
+```
+
+**Same Provider, Different Models**:
+```bash
+# Background tasks: Smaller model
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_api_key
+TEXT_MODEL_NAME=google/gemini-2.5-flash-lite
+
+# Interactive chat: Larger model (same provider)
+CHAT_MODEL_NAME=openai/gpt-4o
+# Note: CHAT_MODEL_API_KEY not needed if using same key
+# Note: CHAT_MODEL_BASE_URL not needed if using same endpoint
+```
+
+**Different Service Tiers (OpenAI)**:
+```bash
+# Background tasks: Standard tier
+TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+TEXT_MODEL_API_KEY=your_standard_tier_key
+TEXT_MODEL_NAME=gpt-4o-mini
+
+# Interactive chat: Priority tier for faster responses
+CHAT_MODEL_API_KEY=your_priority_tier_key
+CHAT_MODEL_NAME=gpt-4o
+```
+
+### When to Use Separate Chat Models
+
+**Recommended for**:
+
+- High-volume deployments where chat responsiveness is critical
+- Users who need different service tiers for different operations
+- Cost optimization when chat usage is significantly higher than summarization
+
+**Not needed for**:
+
+- Small deployments with low usage
+- When using the same model for all operations is acceptable
+- Simple setups where configuration simplicity is preferred
+
+## Model Selection Guidelines
+
+### For Summaries
+
+The model you choose significantly impacts summary quality:
+
+- **GPT-4 or better**: Produces nuanced, context-aware summaries with excellent understanding of complex topics
+- **GPT-5-mini**: Excellent balance of quality and cost for most summarization needs
+- **GPT-3.5/4o-mini**: Budget-friendly option, suitable for straightforward content
+- **Claude models**: Strong performance on structured content and technical material
+
+### For Chat
+
+Chat features benefit from more capable models:
+
+- **GPT-5**: Best for complex multi-turn conversations and detailed analysis
+- **GPT-5-mini**: Recommended for most chat use cases
+- **Claude**: Excellent for technical discussions and code-related queries
+
+### Cost Optimization
+
+To reduce costs while maintaining quality:
+
+1. **Use smaller models for simple tasks**: `gpt-5-nano` or `gpt-4o-mini` handle straightforward summaries well
+2. **Adjust GPT-5 reasoning effort**: Use `minimal` or `low` for quick tasks
+3. **Set token limits**: Configure `SUMMARY_MAX_TOKENS` and `CHAT_MAX_TOKENS` in your `.env`
+4. **Use OpenRouter**: Often provides better rates than direct API access
+
+### Testing Configuration
+
+After changing model configuration:
+
+1. Restart the Speakr container
+2. Create a test recording
+3. Review the generated summary and title
+4. Test the chat feature
+5. Monitor logs for any errors or warnings
+
+## Environment Variables Reference
+
+```bash
+# Required: API endpoint
+TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+
+# Required: API key
+TEXT_MODEL_API_KEY=your_api_key_here
+
+# Required: Model identifier
+TEXT_MODEL_NAME=gpt-5-mini
+
+# Optional: Maximum tokens for summaries (default: 8000)
+SUMMARY_MAX_TOKENS=8000
+
+# Optional: Maximum tokens for chat responses (default: 2000)
+CHAT_MAX_TOKENS=2000
+
+# Optional: Maximum tokens for AI title generation (default: 100)
+# Bump for reasoning models (o1, Kimi 2.5, etc.) that consume budget on hidden thinking tokens
+TITLE_MAX_TOKENS=200
+
+# Optional: Maximum tokens for event extraction from transcripts (default: 4000)
+EVENT_MAX_TOKENS=4000
+
+# GPT-5 specific (only used with GPT-5 models and OpenAI API)
+GPT5_REASONING_EFFORT=medium  # minimal, low, medium, high
+GPT5_VERBOSITY=medium          # low, medium, high
+
+# Chat model configuration (optional - falls back to TEXT_MODEL_* if not set)
+CHAT_MODEL_API_KEY=your_chat_api_key
+CHAT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+CHAT_MODEL_NAME=openai/gpt-4o
+
+# Chat-specific GPT-5 settings (optional - falls back to GPT5_* if not set)
+CHAT_GPT5_REASONING_EFFORT=medium  # minimal, low, medium, high
+CHAT_GPT5_VERBOSITY=medium          # low, medium, high
+```
+
+## Per-Upload, Per-Tag, Per-Folder Transcription Models
+
+By default Speakr uses the single `TRANSCRIPTION_MODEL` set in `.env` for every recording. If your users transcribe different kinds of recordings (calls, meetings, dictations, multi-speaker interviews) you can publish a list of models they're allowed to choose from at upload time.
+
+```bash
+# Comma-separated list of model identifiers users can pick.
+TRANSCRIPTION_MODELS_AVAILABLE=whisper-1,gpt-4o-transcribe,gpt-4o-transcribe-diarize,vibevoice
+# Optional parallel list of display names. Falls back to the model id when omitted.
+TRANSCRIPTION_MODEL_LABELS=Whisper,GPT-4o,GPT-4o (Diarize),VibeVoice
+```
+
+When the list is non-empty, a "Transcription model" dropdown appears in the upload form's Advanced ASR Options and in the reprocess modal. Tags and folders also gain a "Default transcription model" field in their edit forms — set one and any recording uploaded with that tag or in that folder uses the chosen model unless the user picks a different one at upload time.
+
+Resolution order at upload time:
+
+1. Per-upload selection (Advanced ASR Options dropdown)
+2. First tag's `default_transcription_model`
+3. Folder's `default_transcription_model`
+4. Global `TRANSCRIPTION_MODEL` env var (current behaviour)
+
+If the override isn't in `TRANSCRIPTION_MODELS_AVAILABLE`, it's silently dropped and Speakr falls back to the global default — useful as a safety net against stale browser caches sending old model ids.
+
+The override is propagated to the connector via the `model` field on `TranscriptionRequest`. Connectors that key on a model name (OpenAI Whisper / Transcribe, Mistral, VibeVoice) honour it directly. The `asr_endpoint` connector forwards the override as a `model=` query parameter; the [whisperx-asr-service](https://github.com/murtaza-nasir/whisperx-asr-service) fork uses it to switch the loaded Whisper model on demand, while the upstream `ahmetoner/whisper-asr-webservice` ignores unknown query parameters, so the override is safe in either case.
+
+!!! warning "List only models compatible with the active connector"
+    The dropdown changes the model name **within the currently active connector**; it does not switch between providers. Speakr selects exactly one connector at startup based on `TRANSCRIPTION_CONNECTOR`, `USE_ASR_ENDPOINT`, and `TRANSCRIPTION_BASE_URL`, and every transcription request is routed there. If the list contains a model name the active connector does not recognise (for example, putting `gpt-4o-transcribe` in the list while `USE_ASR_ENDPOINT=true` is set), requests for that model fail with a 500 from the upstream service.
+
+    For a WhisperX backend, list Whisper variants (`large-v3`, `medium`, `distil-medium.en`, etc.). For OpenAI's API, list `whisper-1`, `gpt-4o-transcribe`, `gpt-4o-mini-transcribe`, `gpt-4o-transcribe-diarize`. Mixing providers in one dropdown is a planned feature for a future release.
+
+### Admin-Managed Model List with `/v1/models` Discovery
+
+For connectors that expose an OpenAI-compatible `/v1/models` endpoint (OpenAI, Azure OpenAI, vLLM, and the WhisperX ASR service when configured to advertise its loaded models), admins can curate the available list directly from the **Default Prompts → Transcription Models** section of the admin dashboard rather than via env var. Click "Refresh from connector" to query `/v1/models`, tick the models you want users to see, and save.
+
+The DB-backed list (stored in the `system_setting` table) overrides `TRANSCRIPTION_MODELS_AVAILABLE` when set. To revert to env-var control, clear the list in the dashboard. The env var is still useful for installations where the connector does not advertise its models or where you want config-as-code behaviour.
+
+When a connector returns a richer model object (display name, description, supported languages), those fields are used to render the dropdown labels. Otherwise the model id is used as both id and label, the same as with `TRANSCRIPTION_MODEL_LABELS`.
+
+!!! note "Localising model labels"
+    Model identifiers are typically brand names (Whisper, GPT-4o, VibeVoice) and are not translated by Speakr's i18n system. If you want localised labels for users on a non-English UI, set `TRANSCRIPTION_MODEL_LABELS` to your translated names: the labels you provide are used verbatim in the dropdown regardless of UI language. The same applies to admin-managed lists curated from the dashboard.
+
+## Configurable Embedding Model
+
+Speakr's Inquire mode (semantic search) uses [sentence-transformers](https://www.sbert.net/) to embed transcript chunks locally by default. The default model is `all-MiniLM-L6-v2` (384-dim vectors), which is fast, small, and sufficient for most use cases.
+
+To use a different local model, set:
+
+```bash
+EMBEDDING_MODEL=all-mpnet-base-v2          # 768-dim, higher quality
+# or
+EMBEDDING_MODEL=multi-qa-MiniLM-L6-cos-v1  # tuned for question-answering
+```
+
+Any sentence-transformers compatible model name works.
+
+### Remote (API-based) Embeddings
+
+If you would rather offload embeddings to an OpenAI-compatible HTTP endpoint (vLLM, OpenRouter, OpenAI, Together, or any other compatible provider), set `EMBEDDING_BASE_URL` and Speakr switches to API mode. The same `EMBEDDING_MODEL` env var becomes the model identifier sent in each request.
+
+```bash
+# OpenAI directly
+EMBEDDING_BASE_URL=https://api.openai.com/v1
+EMBEDDING_API_KEY=sk-...
+EMBEDDING_MODEL=text-embedding-3-small
+EMBEDDING_DIMENSIONS=768   # optional, only honoured by providers that support output-dim trimming
+```
+
+```bash
+# Self-hosted vLLM serving an embedding model
+EMBEDDING_BASE_URL=http://vllm-host:8000/v1
+EMBEDDING_API_KEY=not-needed
+EMBEDDING_MODEL=BAAI/bge-large-en-v1.5
+```
+
+```bash
+# OpenRouter
+EMBEDDING_BASE_URL=https://openrouter.ai/api/v1
+EMBEDDING_API_KEY=sk-or-...
+EMBEDDING_MODEL=openai/text-embedding-3-large
+```
+
+API mode does not require sentence-transformers to be installed, so the lightweight Docker image (`learnedmachine/speakr:lite`) can now run full semantic search by combining `EMBEDDING_BASE_URL` with any compatible provider. The lite image already ships `openai` and `scikit-learn`, so no further dependencies are needed.
+
+### Compatibility Note
+
+The active embedding identifier (provider plus model) is recorded in `system_setting` on first startup. If you later change `EMBEDDING_MODEL` or `EMBEDDING_BASE_URL`, Speakr logs a warning at startup and Inquire mode will return wrong results until you reprocess affected recordings, because chunks embedded with the previous configuration occupy a different vector space. To rebuild embeddings after a change, reprocess each recording.
+
+## Mistral Voxtral Chunking
+
+Voxtral handles up to 3 hours per request natively, but the cloud API can time out near that limit on long meeting recordings. To opt into app-side chunking for the Mistral connector:
+
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+MISTRAL_ENABLE_CHUNKING=true
+MISTRAL_MAX_DURATION_SECONDS=7200   # 2 hours; chunks at 80% of this
+```
+
+Diarization across chunks: Mistral doesn't return voice embeddings, so speakers are remapped per chunk (`SPEAKER_00` in chunk 1 ≠ `SPEAKER_00` in chunk 2). If you need consistent speaker identity across an entire long recording, use `gpt-4o-transcribe-diarize` (uses known-speaker references) or `whisperx-asr-service` with embeddings enabled.
+
+## Troubleshooting
+
+### Model Not Responding
+
+Check logs for authentication errors:
+```bash
+docker compose logs -f app | grep "LLM"
+```
+
+Common issues:
+
+- Invalid API key
+- Model name not available on your plan
+- Rate limits exceeded
+- Insufficient credits
+
+### Poor Summary Quality
+
+Try these adjustments:
+
+- Upgrade to a more capable model
+- Increase `SUMMARY_MAX_TOKENS`
+- Review and refine [custom prompts](prompts.md)
+- For GPT-5: increase reasoning effort to `medium` or `high`
+
+### High Costs
+
+Reduce costs with:
+
+- Switch to smaller models (`gpt-5-nano`, `gpt-4o-mini`)
+- Lower token limits
+- For GPT-5: reduce reasoning effort to `minimal` or `low`
+- Use OpenRouter for better rates
+
+## Additional Resources
+
+- [OpenAI GPT-5 Documentation](https://platform.openai.com/docs/guides/latest-model)
+- [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat)
+- [OpenRouter Documentation](https://openrouter.ai/docs)
+- [Custom Prompts Guide](prompts.md)
+- [System Settings](system-settings.md)
+
+---
+
+Next: [Default Prompts](prompts.md) | Back to [Admin Guide](index.md)
diff --git a/docs/admin-guide/prompts.md b/docs/admin-guide/prompts.md
new file mode 100644
index 00000000..a8fde0e6
--- /dev/null
+++ b/docs/admin-guide/prompts.md
@@ -0,0 +1,163 @@
+# Default Prompts
+
+The Default Prompts tab lets you shape how AI interprets and [summarizes recordings](../features.md#automatic-summarization) across your entire Speakr instance. This is where you establish the baseline intelligence that users experience when they haven't customized their own [personal prompts](../user-guide/settings.md#custom-prompts-tab).
+
+![Default Prompts](../assets/images/screenshots/Admin default prompts.png)
+
+## Understanding Prompt Hierarchy
+
+Speakr uses a sophisticated hierarchy to determine which prompt to use for any given recording. This system provides flexibility while maintaining control, ensuring users get appropriate summaries while allowing customization where needed.
+
+At the top of the hierarchy are tag-specific prompts. When a recording has [tags](../user-guide/settings.md#tag-management-tab) with associated prompts, these take absolute priority. Learn about [tag management](../features.md#tagging-system) in the features guide. Multiple tag prompts concatenate intelligently, allowing sophisticated prompt stacking for specialized content types.
+
+Next comes the user's personal custom prompt, set in their [account settings](../user-guide/settings.md#custom-prompts-tab). Users can also configure [language preferences](../user-guide/settings.md#language-preferences) for their summaries. This allows individuals to tailor summaries to their specific needs without affecting others. Many users never set this, making your admin default even more important.
+
+Your admin default prompt, configured on this page, serves as the foundation for most summaries. This is what new users experience and what long-term users rely on when they haven't customized their settings. It shapes the overall intelligence and utility of your Speakr instance.
+
+Finally, if all else fails, a hardcoded system fallback ensures summaries are always generated. You'll rarely see this in practice, but it provides a safety net ensuring the system never fails to produce output.
+
+## Crafting Effective Default Prompts
+
+Your default prompt is more than technical instruction - it's a template for understanding. The prompt shown in the interface demonstrates a balanced approach, requesting key issues, decisions, and action items. This structure works well for business meetings but might not suit all contexts.
+
+Consider your user base when designing prompts. A research institution might emphasize methodologies and findings. A legal firm could focus on case details and precedents. For multi-language support, see [language configuration](../features.md#language-support) and [troubleshooting language issues](../troubleshooting.md#summary-language-doesnt-match-preference). A creative agency might highlight concepts and client feedback. The prompt should reflect what matters most to your users.
+
+The AI responds best to clear, structured requests. Use bullet points or numbered sections to organize the output. Specify the level of detail you want - "brief overview" versus "comprehensive analysis" produces very different results. Include examples if certain formats are crucial.
+
+Remember that this prompt applies to everything from five-minute check-ins to two-hour workshops. Design for versatility. Avoid overly specific requirements that might not apply to all content. Focus on extracting universally valuable information while allowing the AI flexibility to adapt to different recording types.
+
+## The Default Prompt Editor
+
+The large text area displays your current default prompt, with full markdown support for formatting. You can use bold for emphasis, lists for structure, and even code blocks if you need to show example formats. The editor expands to accommodate longer prompts, though conciseness generally produces better results.
+
+Changes save immediately when you click the Save Changes button. There's no draft or staging - modifications affect all new summaries instantly. Users can [regenerate summaries](../user-guide/transcripts.md) to apply updated prompts to existing recordings. The Reset to Default button provides a safety net, reverting to the original prompt if your customizations don't work as expected.
+
+The timestamp shows when the prompt was last modified, helpful for tracking changes over time. If multiple admins manage your instance, this helps coordinate who changed what and when.
+
+## Understanding the LLM Prompt Structure
+
+The expandable "View Full LLM Prompt Structure" section reveals how your prompt fits into the complete instruction sent to the AI. This technical view shows the system prompt, your custom prompt, and the transcript integration.
+
+Understanding this structure helps you write better prompts. You'll see that certain instructions are already handled by the system prompt, so you don't need to repeat them. You'll understand how your prompt interacts with the transcript text and why certain phrasings work better than others.
+
+This transparency also helps with troubleshooting. If summaries aren't meeting expectations, reviewing the full prompt structure often reveals why. Perhaps your instructions conflict with system instructions, or maybe you're requesting information that isn't typically in transcripts.
+
+## Practical Prompt Strategies
+
+Start with a proven structure and iterate based on results. The default prompt works well because it requests concrete, actionable information. Key issues provide context, decisions document outcomes, and action items drive follow-up.
+
+Test your prompts with various recording types before deploying widely. A prompt that works beautifully for formal presentations might fail for casual conversations. Upload test recordings with different characteristics and evaluate the summaries produced.
+
+Consider seasonal or project-based adjustments. During planning seasons, you might emphasize goals and strategies. During execution phases, focus on progress and blockers. You can update the default prompt as organizational needs evolve.
+
+Monitor user feedback about summary quality. If users frequently edit summaries or complain about missing information, your prompt might need adjustment. The best prompt is one users rarely need to modify.
+
+## Advanced Prompt Techniques
+
+Layer instructions for nuanced output. Instead of just requesting "action items," specify "action items with responsible parties and due dates if mentioned." This precision helps the AI extract more valuable information when it's available.
+
+Use conditional language for flexibility. Phrases like "if applicable" or "when discussed" allow the AI to skip sections that don't apply to every recording. This prevents forced, irrelevant content in summaries.
+
+Consider the AI model's strengths and limitations. Current models excel at identifying themes, extracting specific information, and organizing content. They struggle with complex reasoning, mathematical calculations, and information not explicitly stated. Design prompts that play to these strengths.
+
+Balance detail with readability. Extremely detailed prompts might produce comprehensive summaries that users don't read. Sometimes a concise, focused summary serves users better than exhaustive documentation.
+
+## Creative Tag Prompt Use Cases
+
+Tags with custom prompts unlock powerful transformation capabilities. Here are creative ways people use this feature:
+
+### Recipe Recordings
+
+Create a "Recipe" tag with a prompt like: "Convert this free-form cooking narration into a properly formatted recipe with ingredients list, step-by-step instructions, cooking times, and servings. Organize ingredients by quantity and item. Number the steps clearly."
+
+When you record yourself cooking while talking through what you're doing - "okay I'm adding maybe two cups of flour, bit more actually, and then half a cup of sugar, no wait three quarters" - the AI transforms that messy stream-of-consciousness into a clean, usable recipe format with organized ingredients and numbered steps.
+
+### Lecture Notes
+
+A "Lecture" tag could use: "Extract the main concepts, supporting examples, key terminology with definitions, and any practical applications mentioned. Organize in an outline format suitable for study notes."
+
+Students record lectures as they happen. The messy 90-minute recording becomes organized study notes with concepts clearly labeled, examples pulled out, and terminology defined. Much more useful than trying to review the raw transcript.
+
+### Meeting Action Items
+
+Create a "Project Meeting" tag with: "Focus exclusively on action items, decisions made, and next steps. For each action item, identify who is responsible and any mentioned deadlines. Ignore general discussion."
+
+The group spends an hour talking about a project. The summary ignores all the background discussion and debate, giving you just the concrete outcomes - who's doing what and when.
+
+### Brainstorming Sessions
+
+A "Ideas" tag with: "List every distinct idea mentioned, no matter how brief the discussion. For each idea, note any immediate reactions or concerns raised. Don't evaluate or synthesize - just capture everything."
+
+Free-flowing creative sessions produce transcripts full of half-formed thoughts and tangents. This prompt pulls out every idea fragment so nothing gets lost in the noise.
+
+### Code Review Sessions
+
+"Code Review" tag: "For each piece of code or system discussed, list: 1) What was reviewed, 2) Issues identified, 3) Suggested changes, 4) Who will implement fixes. Use technical language, don't simplify."
+
+Technical discussions stay technical. The summary uses proper terminology and maintains the level of detail needed for developers to act on the feedback.
+
+## Tag Stacking and Order
+
+When a recording has multiple tags with prompts, they concatenate in the order tags were applied. This creates powerful combinations:
+
+### Example: Personal Lecture + Specific Course
+
+You have a personal "My Lectures" tag with: "Organize as study notes with clear headers."
+
+You also tag with "Biology 301" which adds: "Pay special attention to biological processes, terminology, and diagrams mentioned."
+
+The result combines both: study notes format focused on biological content. The order doesn't matter much here since they're complementary.
+
+### Example: Client Meeting + Legal Review
+
+"Client Meeting" tag: "Extract client requirements, concerns, and preferences."
+
+"Legal Review" tag: "Identify any legal considerations, compliance requirements, or risk factors mentioned."
+
+Together, you get client needs plus legal implications in one summary - useful when client calls touch on contractual matters. If you tagged "Legal Review" first and "Client Meeting" second, the legal aspects would be emphasized first, then client concerns.
+
+### Example: Recipe + Dietary Restriction
+
+"Recipe" tag: "Convert to formatted recipe."
+
+"Gluten Free" tag: "Note which ingredients contain gluten and suggest substitutions."
+
+The recipe gets formatted properly, plus you get automatic gluten-free adaptation notes. Perfect when you're adapting traditional recipes for dietary needs.
+
+### When Order Matters
+
+More specific prompts should generally come last, as they refine the output from general prompts. Start broad (format type) then add specifics (focus areas).
+
+If you tag "Technical Details" + "Executive Summary", you're asking for detailed technical content presented as an executive summary - probably condensed but still technical.
+
+Reverse it to "Executive Summary" + "Technical Details" and you're requesting executive-level content with technical depth where applicable - probably less detailed overall.
+
+Test your tag combinations with sample recordings to see which order produces the results you want.
+
+## Coordinating with User Prompts
+
+Your default prompt should complement, not compete with, user customization. Design it as a solid foundation that works for most cases while encouraging power users to customize for their specific needs.
+
+Communicate your prompt strategy to users. Let them know what the default prompt emphasizes so they can decide whether customization would benefit them. Share examples of effective user prompts that build on your default.
+
+Consider documenting prompt best practices for your users. If certain departments need specialized summaries, provide recommended prompts they can use. This empowers users while maintaining consistency where it matters.
+
+## Measuring Prompt Effectiveness
+
+Track how often users modify AI-generated summaries. Frequent edits suggest your prompt isn't capturing what users need. Minimal edits indicate your prompt effectively extracts valuable information.
+
+Review a sample of summaries periodically. Do they consistently include the requested sections? Is the information accurate and relevant? Are users adding similar information that the prompt should request?
+
+Gather feedback during user reviews or support interactions. Ask specifically about summary quality and whether the default format meets their needs. Users who don't customize their prompts rely entirely on your default, making their feedback crucial.
+
+## Common Prompt Pitfalls
+
+Avoid overly restrictive prompts that force structure onto incompatible content. Not every recording has "decisions" or "action items." Forcing the AI to find these when they don't exist produces meaningless filler.
+
+Don't request information the AI can't provide. Asking for "unspoken concerns" or "what wasn't discussed" goes beyond transcript analysis. The AI can only work with what was actually said and recorded.
+
+Resist the temptation to make prompts too long. Each instruction adds complexity and potential confusion. Focus on what's most important rather than trying to capture every possible detail.
+
+---
+
+Next: [Vector Store](vector-store.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/retention.md b/docs/admin-guide/retention.md
new file mode 100644
index 00000000..ddf7116c
--- /dev/null
+++ b/docs/admin-guide/retention.md
@@ -0,0 +1,461 @@
+---
+layout: default
+title: Retention & Auto-Deletion
+parent: Admin Guide
+nav_order: 7
+---
+
+# Auto-Deletion and Retention Policies
+
+This document describes the automated retention and deletion system for Speakr recordings.
+
+## Overview
+
+The auto-deletion system provides automated lifecycle management for your recordings, helping you:
+
+- **Comply with data retention policies** - Automatically remove recordings after a specified retention period
+- **Manage storage** - Prevent unlimited growth of audio files
+- **Maintain critical data** - Keep transcriptions and metadata even after audio deletion
+- **Protect important recordings** - Exempt specific recordings from automatic deletion
+
+## Configuration
+
+### Environment Variables
+
+Add these to your `.env` file to configure auto-deletion:
+
+```bash
+# Enable or disable the auto-deletion feature
+ENABLE_AUTO_DELETION=false  # Set to 'true' to enable
+
+# Global retention period in days (0 = disabled)
+GLOBAL_RETENTION_DAYS=90    # Recordings older than this will be processed
+
+# Deletion mode: what to delete
+DELETION_MODE=full_recording  # Options: 'audio_only' or 'full_recording'
+```
+
+### Deletion Modes
+
+#### Audio-Only Mode (`DELETION_MODE=audio_only`)
+- **Deletes**: Audio file only
+- **Keeps**: Transcription, summary, notes, metadata
+- **Use case**: Long-term record keeping with storage optimization
+- **Result**: Recordings appear in "Archived" view, transcription remains searchable
+
+#### Full Recording Mode (`DELETION_MODE=full_recording`)
+- **Deletes**: Complete recording including audio, transcription, summary, notes
+- **Keeps**: Nothing - recording is permanently removed
+- **Use case**: Complete data removal for compliance
+- **Result**: Recording is completely removed from the system
+
+## Multi-Tier Retention System
+
+Speakr uses a hierarchical retention policy system:
+
+### 1. Global Retention (System-Wide)
+Set via `GLOBAL_RETENTION_DAYS` environment variable. Applies to all recordings unless overridden.
+
+```bash
+GLOBAL_RETENTION_DAYS=90  # All recordings older than 90 days
+```
+
+### 2. Tag-Based Retention
+Tags can override the global retention period with custom retention periods. This is especially powerful with group tags, where group admins can set retention policies for their group's content.
+
+```
+Global: 90 days
+Tag "Legal Records": 2555 days (7 years)  # Longer retention
+Tag "Daily Standups": 14 days  # Shorter retention
+Untagged recordings: Uses global (90 days)
+```
+
+When a recording has multiple tags with different retention periods, the **shortest** period applies.
+
+### 3. Tag-Based Protection
+Individual tags can protect recordings from auto-deletion entirely.
+
+**Example Hierarchy:**
+
+- Global retention: 90 days
+- Tag "Sprint Reviews": 180 days (longer than global)
+- Tag "Daily Standups": 14 days (shorter than global)
+- Tag "Legal" with protection enabled: Never deleted (permanent)
+
+## Protecting Recordings from Deletion
+
+1. Go to **Account Settings** → **Tags** tab
+2. Click **Create Tag** or **Edit** an existing tag
+3. Enable **"Protect from Auto-Deletion"** checkbox
+4. Apply this tag to recordings you want to protect
+
+**When protected:**
+
+- ✅ Recordings with protected tags are exempt from auto-deletion
+- ✅ Works regardless of age or retention period
+- ✅ Applies to all recordings with that tag
+
+## Archived Recordings
+
+When `DELETION_MODE=audio_only`, recordings become "archived" after audio deletion.
+
+### Accessing Archived Recordings
+
+1. Open the **Recordings** sidebar
+2. Click **Advanced Filters**
+3. Toggle **"Archived Recordings"** ON
+
+### What You Can Do with Archived Recordings
+
+| Feature | Available | Notes |
+|---------|-----------|-------|
+| View transcription | ✅ | Full transcript accessible |
+| Search content | ✅ | Text search still works |
+| Read summary | ✅ | AI summary preserved |
+| View/edit notes | ✅ | All metadata accessible |
+| Play audio | ❌ | Audio file deleted |
+| Re-process | ❌ | Source audio unavailable |
+| Share | ✅ | Can share transcription |
+| Export | ✅ | Download transcript, summary, notes |
+
+### Archived Recording Indicators
+
+- **Sidebar**: Gray "Archived" badge next to recording title
+- **Player**: Info banner: "Audio file has been deleted, but the transcription remains available"
+- **Filter**: Separate "Archived" view toggle in advanced filters
+
+## Admin Controls
+
+### Running Auto-Deletion
+
+Auto-deletion runs automatically based on configured schedule. Admins can also trigger manually:
+
+**API Endpoint:**
+```bash
+POST /admin/auto-deletion/run
+```
+
+**Response:**
+```json
+{
+  "checked": 150,
+  "deleted_audio_only": 45,
+  "deleted_full": 0,
+  "exempted": 12,
+  "errors": 0
+}
+```
+
+### Checking Auto-Deletion Stats
+
+**API Endpoint:**
+```bash
+GET /admin/auto-deletion/stats
+```
+
+**Response:**
+```json
+{
+  "enabled": true,
+  "global_retention_days": 90,
+  "deletion_mode": "audio_only",
+  "eligible_count": 45,
+  "exempted_count": 12,
+  "archived_count": 128
+}
+```
+
+## Speaker Data Cleanup
+
+By default, speaker profiles and voice embeddings are preserved even when all associated recordings are deleted. This is because voice embeddings are aggregated values that cannot be reconstructed from individual recordings.
+
+To enable automatic cleanup of orphaned speaker profiles, set `DELETE_ORPHANED_SPEAKERS=true` in your environment.
+
+### What Gets Cleaned Up
+
+When `DELETE_ORPHANED_SPEAKERS=true` and the auto-deletion job runs, the system:
+
+1. **Removes orphaned speaker profiles**: Speakers with no remaining recordings are deleted
+2. **Cleans embedding references**: Recording IDs are removed from speaker voice profile metadata
+3. **Applies to both deletion modes**: Works with both `audio_only` and `full_recording` deletion modes
+
+### Cleanup Schedule
+
+Speaker cleanup runs on the same schedule as auto-deletion:
+
+- **Frequency**: Daily at 2:00 AM (server time)
+- **Trigger**: Automatically when `ENABLE_AUTO_DELETION=true` and `DELETE_ORPHANED_SPEAKERS=true`
+
+### When Speakers Are Deleted
+
+A speaker is considered "orphaned" and deleted when:
+
+- `DELETE_ORPHANED_SPEAKERS=true` is set
+- No `SpeakerSnippet` records exist for the speaker (no voice samples in any recordings)
+- No valid recording references remain in the speaker's voice profile metadata
+
+**Note**: Speakers are preserved as long as they have at least one active recording with speaker identifications.
+
+### Privacy & GDPR Compliance
+
+For deployments that need to treat voice embeddings as biometric data, enable `DELETE_ORPHANED_SPEAKERS=true` to ensure:
+
+- **Data Minimization**: Removes voice data when no longer needed
+- **Right to Erasure**: Deletes voice profiles when recordings are removed
+- **Transparency**: Cleanup activity is logged for audit purposes
+- **Automatic**: No manual intervention required when combined with retention policies
+
+### Monitoring Cleanup Activity
+
+View cleanup statistics in:
+
+- **System logs**: Check application logs for cleanup counts and activity
+- **Auto-deletion response**: Speaker cleanup counts included in scheduled job output
+
+Example log entry:
+```
+INFO - Speaker cleanup completed: 5 speakers deleted, 12 embedding references removed
+```
+
+The cleanup process includes these statistics in the auto-deletion job response:
+
+```json
+{
+  "checked": 123,
+  "deleted_audio_only": 45,
+  "deleted_full": 0,
+  "exempted": 12,
+  "speakers_deleted": 5,
+  "embeddings_cleaned": 12,
+  "speakers_evaluated": 94
+}
+```
+
+### What Data Is Retained
+
+The system preserves:
+
+- **Active speakers**: Speakers with at least one recording containing their voice
+- **Speaker names**: Names are retained as long as associated recordings exist
+- **Voice profiles**: Embedding data is kept when recordings reference the speaker
+
+### What Data Is Removed
+
+The system removes:
+
+- **Orphaned voice embeddings**: Biometric voice data for speakers with no recordings
+- **Speaker records**: Entire speaker profile when completely orphaned
+- **Invalid references**: Recording IDs in embedding history that point to deleted recordings
+- **Usage statistics**: Use counts and timestamps for deleted speakers
+
+This ensures that biometric data is only retained when there's a legitimate purpose (active recordings), fulfilling GDPR's data minimization requirement.
+
+## Practical Use Cases
+
+The retention system solves real problems people have with accumulating recordings. Here's how it gets used:
+
+### Personal Use
+
+You record everything during your workday to capture ideas and discussions. Most of these recordings are ephemeral - useful for a week or two, then forgotten. Set a 30-day global retention with audio-only deletion. After a month, the audio files disappear but the searchable transcriptions remain. You can still find what was said in old recordings, but you're not paying to store hours of audio you'll never listen to again.
+
+If something turns out to be important, tag it with a protected tag before the 30 days expire. The tag prevents deletion, preserving both audio and transcript for as long as you need.
+
+### Group Collaboration
+
+Different types of group content need different lifecycles:
+
+| Content Type | Retention Approach | Why |
+|--------------|-------------------|-----|
+| Daily standups | Group tag with 14-day retention | Routine updates, no long-term value |
+| Sprint planning | Group tag with 90-day retention | Reference value for current quarter |
+| Architecture decisions | Group tag with protection enabled | Document important choices permanently |
+| Customer calls (sales) | Group tag with 1-year retention | Sales cycle duration + follow-up window |
+| Interviews (HR) | Group tag with 2-year retention | Typical employment litigation window |
+| Legal meetings | Protected tag | Indefinite retention for compliance |
+
+Each group sets up their tags once with appropriate retention. Members just tag recordings normally, and lifecycle management happens automatically. Nobody has to remember which recordings to keep or delete.
+
+### Compliance Requirements
+
+Organizations with data retention policies can enforce them automatically. Healthcare organization needs 7-year retention for patient consultations - set that in the relevant group tag. Law firm needs indefinite retention for client meetings - use protected tags. Financial services deletes routine internal calls after 90 days but keeps compliance-related recordings for 7 years - different tags with different retention.
+
+The system enforces policy without requiring anyone to remember the rules. Tag correctly, and retention happens automatically.
+
+### Storage Cost Management
+
+Audio files are large - a one-hour meeting might be 50-100MB. Transcriptions are text - the same meeting might be 10-20KB. Audio-only deletion mode keeps the valuable searchable text while reclaiming storage.
+
+Run audio-only deletion with a 90-day retention. Recordings older than 90 days lose their audio but remain fully searchable. You can still use Inquire Mode to find information, read transcripts, review summaries, and see notes. You just can't play the original audio. For most use cases, that's fine - once you've extracted the information into text, the audio serves no purpose.
+
+This approach lets you keep years of searchable conversation history without accumulating terabytes of audio files.
+
+## Best Practices
+
+### For Compliance
+
+1. **Set appropriate retention periods**
+    ```bash
+    # Example: 7-year retention for financial records
+    GLOBAL_RETENTION_DAYS=2555  # 7 years × 365 days
+    DELETION_MODE=full_recording
+    ```
+
+2. **Use tag-based protection** for records requiring indefinite retention
+    - Create "Legal Hold" or "Permanent" tags
+    - Enable protection on these tags
+    - Apply to relevant recordings
+
+3. **Document your retention policy** in your organization's compliance documentation
+
+### For Storage Management
+
+1. **Start with audio-only deletion**
+    ```bash
+    DELETION_MODE=audio_only
+    ```
+    - Keeps searchable transcriptions
+    - Frees up 95%+ of storage (audio files are large)
+    - Maintains business value of conversations
+
+2. **Use shorter retention periods** for routine recordings
+    ```bash
+    GLOBAL_RETENTION_DAYS=30  # Routine meetings
+    ```
+
+3. **Protect important content** with tags
+    - "Executive Meetings" tag → protect from deletion
+    - "Daily Standup" tag → no protection (routine)
+
+### For Groups
+
+When groups are enabled:
+
+1. **Set conservative global retention** (shorter period as a baseline)
+2. **Configure group tags with custom retention** to match each group's needs
+3. **Use protected group tags** for group content requiring permanent retention
+4. **Document retention policies** so group members understand lifecycle expectations
+
+Example group tag retention configuration:
+
+- Engineering group "Architecture Decisions": Protected (never deleted)
+- Sales group "Customer Calls": 365 days
+- HR group "Interviews": 90 days
+- Operations group "Daily Standups": 14 days
+
+## Deletion Process Flow
+
+```
+1. Automated Check (Daily/Manual Trigger)
+   ↓
+2. Find recordings older than retention period
+   ↓
+3. For each recording:
+   - Check manual exemption flag
+   - Check tags for protection
+   - Skip if exempt
+   ↓
+4. Delete based on mode:
+   - audio_only: Remove file, keep DB record, set audio_deleted_at
+   - full_recording: Remove file and DB record
+   ↓
+5. Return statistics
+```
+
+## Migration Guide
+
+### Enabling Auto-Deletion on Existing System
+
+1. **Test with audio-only mode first:**
+    ```bash
+    ENABLE_AUTO_DELETION=true
+    GLOBAL_RETENTION_DAYS=365  # Start with long period
+    DELETION_MODE=audio_only   # Test safely
+    ```
+
+2. **Protect existing important content:**
+    - Create protected tags
+    - Apply to critical recordings
+    - Verify exemptions via `/admin/auto-deletion/stats`
+
+3. **Run manual test:**
+    ```bash
+    POST /admin/auto-deletion/run
+    ```
+
+4. **Monitor results** and adjust retention period as needed
+
+### Reverting Changes
+
+If you need to disable auto-deletion:
+```bash
+ENABLE_AUTO_DELETION=false
+```
+
+**Note:** Already deleted audio files cannot be recovered. Database records (if using audio-only mode) remain intact.
+
+## API Reference
+
+### Run Auto-Deletion (Admin Only)
+
+```http
+POST /admin/auto-deletion/run
+```
+
+Manually trigger the auto-deletion process.
+
+### Get Deletion Statistics (Admin Only)
+
+```http
+GET /admin/auto-deletion/stats
+```
+
+Get statistics about eligible recordings and current configuration.
+
+## Troubleshooting
+
+### Auto-Deletion Not Running
+
+**Check:**
+
+1. `ENABLE_AUTO_DELETION=true` in `.env`
+2. `GLOBAL_RETENTION_DAYS > 0`
+3. Admin status for manual triggers
+4. Server logs for errors
+
+### Too Many Recordings Being Deleted
+
+**Solutions:**
+
+1. Increase `GLOBAL_RETENTION_DAYS`
+2. Add protected tags to important categories
+3. Check tag assignments on recordings
+4. Review exemption status via stats endpoint
+
+### Archived Recordings Not Showing
+
+**Check:**
+
+1. Toggle "Archived Recordings" filter in sidebar
+2. Verify `DELETION_MODE=audio_only` (full_recording doesn't archive)
+3. Check `audio_deleted_at` field in database
+
+## Security Considerations
+
+1. **Admin-only endpoints**: Auto-deletion triggers require admin authentication
+2. **Irreversible deletion**: Deleted audio files cannot be recovered
+3. **Audit trail**: Check server logs for deletion events
+4. **GDPR compliance**: Full deletion mode helps meet "right to be forgotten" requirements
+
+## Support
+
+For issues or questions about auto-deletion:
+
+1. Check server logs for detailed error messages
+2. Verify environment variable configuration
+3. Test with `/admin/auto-deletion/stats` endpoint
+4. Review this documentation
+5. Submit issues on GitHub with logs attached
+
+---
+
+Return to [Admin Guide](index.md) →
diff --git a/docs/admin-guide/sso-setup.md b/docs/admin-guide/sso-setup.md
new file mode 100644
index 00000000..d213fe49
--- /dev/null
+++ b/docs/admin-guide/sso-setup.md
@@ -0,0 +1,124 @@
+# SSO Setup (OIDC)
+
+This guide explains how to enable Single Sign-On (SSO) for Speakr using any OpenID Connect (OIDC) identity provider such as Keycloak, Azure AD/Entra ID, Google, or Auth0.
+
+## Prerequisites
+
+- Speakr server reachable by the IdP at the redirect URL you configure.
+- Client ID and Client Secret issued by your IdP.
+- OIDC discovery (well-known) URL from your IdP.
+
+## Required environment variables
+
+Set these variables (see `config/env.sso.example`):
+
+```
+ENABLE_SSO=true
+SSO_PROVIDER_NAME=Keycloak
+SSO_CLIENT_ID=speakr
+SSO_CLIENT_SECRET=change-me
+SSO_DISCOVERY_URL=https://keycloak.example.com/realms/master/.well-known/openid-configuration
+SSO_REDIRECT_URI=https://speakr.example.com/auth/sso/callback
+
+# Auto-registration (email domain filter)
+SSO_AUTO_REGISTER=true
+SSO_ALLOWED_DOMAINS=example.com,company.org
+
+# Disable password login for regular users (optional)
+SSO_DISABLE_PASSWORD_LOGIN=false
+
+# Claim mapping (optional)
+SSO_DEFAULT_USERNAME_CLAIM=preferred_username
+SSO_DEFAULT_NAME_CLAIM=name
+```
+
+Restart Speakr after updating environment variables.
+
+## Claim expectations
+
+- `sub` (required): stable subject identifier.
+- `email` (recommended): used for matching and domain allowlist.
+- `preferred_username` or `name`: used for username/full name if provided.
+
+## Keycloak quick start
+
+1. In Keycloak, create a new client (e.g., `speakr`) with:
+    - **Client Type**: OpenID Connect
+    - **Access Type**: Confidential
+    - **Valid Redirect URI**: `https://your-host/auth/sso/callback`
+    - **Web Origins**: `+` (or your domain)
+2. Copy the **Client ID** and **Client Secret**.
+3. Note the **OpenID Endpoint Configuration** (discovery) URL, typically:
+    `https://<host>/realms/<realm>/.well-known/openid-configuration`
+
+4. Set the environment variables accordingly and restart Speakr.
+
+## Azure AD / Entra ID quick start
+
+1. Create an App Registration.
+2. Add a **Web Redirect URI**: `https://your-host/auth/sso/callback`.
+3. Grant API permissions: `openid`, `profile`, `email`.
+4. Create a client secret.
+5. Discovery URL format:
+    `https://login.microsoftonline.com/<tenant-id>/v2.0/.well-known/openid-configuration`
+
+6. Set variables and restart.
+
+## Google quick start
+
+1. Create OAuth credentials (Web application).
+2. Add authorized redirect URI: `https://your-host/auth/sso/callback`.
+3. Use discovery URL:
+    `https://accounts.google.com/.well-known/openid-configuration`
+
+4. Set variables and restart.
+
+## Auth0 quick start
+
+1. Create a Regular Web Application.
+2. Allowed Callback URLs: `https://your-host/auth/sso/callback`.
+3. Discovery URL:
+    `https://<your-tenant>.auth0.com/.well-known/openid-configuration`
+
+4. Set variables and restart.
+
+## Auto-registration behavior
+
+- If `SSO_AUTO_REGISTER=true`, new users are created on first login when their email domain is allowed (or when allowlist is empty).
+- If `SSO_AUTO_REGISTER=false`, only existing users with a linked SSO subject can sign in.
+- Email domain allowlist is enforced only when an email is present.
+
+## Disabling password login
+
+Set `SSO_DISABLE_PASSWORD_LOGIN=true` to enforce SSO-only authentication for regular users. When enabled:
+
+- The login page shows only the SSO sign-in button
+- Regular users cannot log in with email/password
+- **Administrators can still use password login** as a fallback (hidden behind "Administrator login" link)
+
+This is useful for organizations that want to enforce SSO for all users while keeping emergency admin access available.
+
+## Security note
+
+When a user logs in via SSO with an email that matches an existing Speakr account, the accounts are automatically linked. This is convenient for most setups but relies on trusting your IdP to provide accurate email information.
+
+For self-hosted deployments where you control both Speakr and the IdP, this is generally not a concern. If you're using an IdP where users can set unverified email addresses, be aware that this could allow account linking without email ownership verification. Consider using `SSO_ALLOWED_DOMAINS` to restrict which email domains can authenticate.
+
+## Linking existing users
+
+- In **Account > Single Sign-On**, click **Link {PROVIDER} account** while logged in.
+- If the SSO subject is already linked to another user, the link is rejected.
+
+## Unlinking SSO
+
+Users can unlink their SSO account from **Account > Single Sign-On** by clicking **Unlink {PROVIDER} account**. This removes the SSO association while keeping the local account intact.
+
+**Important:** Users who created their account via SSO (and have no password set) must first set a password before unlinking. Otherwise they would be locked out of their account.
+
+## Troubleshooting
+
+- **Login fails immediately**: verify `SSO_DISCOVERY_URL`, client credentials, and that the redirect URI matches exactly.
+- **User created without email**: some IdPs do not return `email`; user is created with a placeholder email based on `sub`.
+- **Domain rejected**: confirm `SSO_ALLOWED_DOMAINS` and that the IdP returns an `email` claim.
+- **Already linked**: ensure each SSO subject is unique; users can unlink from Account settings to re-link to a different account.
+
diff --git a/docs/admin-guide/statistics.md b/docs/admin-guide/statistics.md
new file mode 100644
index 00000000..4944f8af
--- /dev/null
+++ b/docs/admin-guide/statistics.md
@@ -0,0 +1,83 @@
+# System Statistics
+
+The System Statistics tab transforms raw data into actionable insights about your Speakr instance. At a glance, you can see how many users you're serving, how many recordings they've created, how much storage they're consuming, and whether everything is processing smoothly.
+
+![System Statistics](../assets/images/screenshots/Admin stats.png)
+
+## Key Metrics Overview
+
+Four prominent cards at the top of the statistics page give you immediate insight into your system's scale. Total Users shows your current user base size, helping you understand your instance's reach. Total Recordings reveals the cumulative content in your system, while Total Storage presents the actual disk space consumed. Total Queries, when Inquire Mode is enabled, indicates how actively users are searching their recordings.
+
+These numbers tell a story about your instance's health and growth. A growing user count with proportional recording growth suggests healthy adoption. Storage growing faster than recordings might indicate users are uploading longer files. Query counts reveal whether users are finding value in the semantic search features.
+
+## Recording Status Distribution
+
+The status distribution section breaks down your recordings into four critical states. Completed recordings are fully processed and ready for use - this should be the vast majority of your content. Processing recordings are currently being transcribed or analyzed. Pending recordings are queued and waiting their turn. Failed recordings encountered errors and need attention.
+
+In a healthy system, you'll see mostly completed recordings with perhaps a few processing at any given moment. A large number of pending recordings might indicate your system is overwhelmed or that background processing has stopped. Failed recordings always deserve investigation - they might reveal configuration issues, API problems, or corrupted files that users are trying to upload.
+
+## Storage Analysis
+
+The "Top Users by Storage" section reveals who's consuming the most resources in your system. Each user is listed with their total storage consumption and recording count, giving you context about whether they have many small files or fewer large ones.
+
+This information proves invaluable for capacity planning and user education. If one user consumes disproportionate storage, you might need to understand their use case better. Are they recording multi-hour meetings? Keeping everything forever? Understanding the why behind the numbers helps you make better policy decisions.
+
+## Understanding Usage Patterns
+
+Statistics aren't just numbers - they're insights waiting to be discovered. Sudden spikes in recordings might coincide with project kickoffs, academic semesters, or company initiatives. Storage growth that outpaces recording growth could indicate users are uploading longer content or higher quality audio files.
+
+Regular monitoring helps you spot trends before they become problems. If storage grows 10% monthly, you can project when you'll need to expand capacity. If failed recordings suddenly spike, you can investigate whether an API key expired or a service is down.
+
+## Capacity Planning
+
+System statistics are your crystal ball for infrastructure needs. Storage growth trends tell you when you'll need more disk space. User growth patterns indicate when you might need to scale your server resources. Processing queues reveal whether your current setup can handle the workload.
+
+Use these insights proactively. If you see storage growing at 50GB monthly and you have 200GB free, you know you have about four months before needing intervention. This lead time lets you budget for upgrades, plan migrations, or implement retention policies before hitting critical limits.
+
+## Token Usage Statistics
+
+The Token Usage section provides visibility into LLM API consumption across your instance. Two cards split usage between **LLM operations** (title generation, summarization, chat, event extraction) and **embeddings** (Inquire mode), since they typically come from different providers and the embedding cost is otherwise easy to miss.
+
+**Per-Operation Breakdown**: LLM token usage is broken down by operation type so you can see where the spend is going. Title generation, summarization, chat, and event extraction each get their own line with input tokens, output tokens, and estimated cost. Embedding usage is shown as a separate card with its own daily/monthly chart, so a model swap or a re-embed-all run is visible without polluting the LLM-side numbers. This separation matters because the embedding API price (per million tokens) is usually orders of magnitude lower than chat-completion pricing, and mixing them makes both numbers harder to read.
+
+**Daily and Monthly Charts**: Interactive charts display token consumption trends over the last 30 days and 12 months for both LLM and embedding usage. These visualisations help identify usage patterns and predict future costs.
+
+**Per-User Breakdown**: A detailed table shows each user's monthly token consumption alongside their budget limit (if set). Progress bars indicate how much of their budget has been used:
+
+- Green: Under 80% of budget
+- Yellow: Between 80-100% (warning zone)
+- Red: At or over 100% (blocked)
+
+**Cost Tracking**: When using OpenRouter or other providers that return cost information, the statistics include estimated costs based on actual API responses. For embeddings, the cost is calculated from the configured per-million-token price for the active embedding provider. This helps with budgeting and identifying high-cost operations.
+
+Use token statistics to identify heavy users, validate budget allocations, and forecast API costs. If certain users consistently hit their limits, you may need to increase their budgets or investigate their usage patterns. See [Token Budget Management](user-management.md#token-budget-management) for setting individual user limits.
+
+## Transcription Usage Statistics
+
+The Transcription Usage section provides visibility into speech-to-text API consumption across your instance. This is separate from token usage and tracks audio transcription specifically.
+
+**Summary Cards**: Four cards at the top show:
+
+- **Today's Minutes**: Transcription minutes used today across all users
+- **This Month**: Total minutes transcribed in the current calendar month
+- **Monthly Cost**: Estimated costs based on connector pricing (OpenAI Whisper/Transcribe charges, $0 for self-hosted ASR)
+- **Budget Warnings**: Count of users approaching (80%+) or exceeding (100%) their transcription budgets
+
+**Per-User Breakdown**: A detailed list shows each user's monthly transcription usage alongside their budget limit (if set). Progress bars indicate budget consumption:
+
+- Green: Under 80% of budget
+- Yellow: Between 80-100% (warning zone)
+- Red: At or over 100% (blocked from new transcriptions)
+
+**Cost Estimation**: The system calculates estimated costs based on the transcription connector used:
+
+- OpenAI Whisper API: $0.006 per minute
+- OpenAI Transcribe (gpt-4o-transcribe): $0.006 per minute
+- OpenAI Transcribe (gpt-4o-mini-transcribe): $0.003 per minute
+- Self-hosted ASR endpoints: $0 (no external API costs)
+
+Use transcription statistics to monitor usage patterns, identify heavy users, and validate budget allocations. Organizations using cloud transcription services can forecast costs accurately, while those with self-hosted ASR can track capacity utilization. See [Transcription Budget Management](user-management.md#transcription-budget-management) for setting individual user limits.
+
+---
+
+Next: [System Settings](system-settings.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/system-settings.md b/docs/admin-guide/system-settings.md
new file mode 100644
index 00000000..a18d8616
--- /dev/null
+++ b/docs/admin-guide/system-settings.md
@@ -0,0 +1,248 @@
+# System Settings
+
+System Settings is where you configure the fundamental behaviors that affect every user and recording in your Speakr instance. These global parameters shape how the system operates, from technical limits to user-facing features.
+
+![System Settings](../assets/images/screenshots/Admin system settings.png)
+
+## Transcript Length Limit
+
+The transcript length limit determines how much text gets sent to the AI when generating summaries or responding to chats. This seemingly simple number has a big effect on both quality and cost.
+
+When set to "No Limit," the entire transcript goes to the AI regardless of length. This ensures the AI has complete context but can become expensive for long recordings. A two-hour meeting might generate 20,000 words of transcript, consuming significant API tokens and potentially overwhelming the AI model's context window. This limit will also be applied to the speaker auto-detection feature in the speaker identification modal.
+
+Setting a character limit (like 50,000 characters) creates a ceiling on API consumption. The system will truncate very long transcripts, sending only the beginning portion to the AI. This keeps costs predictable but might mean the AI misses important content from later in the recording.
+
+The sweet spot depends on your use case. For typical meetings under an hour, 50,000 characters usually captures everything. For longer sessions, you might increase this limit or train users to split recordings. Monitor your API costs and user feedback to find the right balance.
+
+## Maximum File Size
+
+The file size limit protects your system from being overwhelmed by massive uploads while ensuring users can work with reasonable recordings. The default 300MB accommodates several hours of compressed audio, which covers most use cases.
+
+Raising this limit allows longer recordings but requires careful consideration. Larger files take longer to upload, consume more storage, and might timeout during processing. Your server needs enough memory to handle these files, and your storage must accommodate them. Network timeouts, browser limitations, and user patience all factor into what's practical.
+
+If users frequently hit the limit, consider whether they really need single recordings that long. Often, splitting long sessions into logical segments produces better results - easier to review, faster to process, and more focused summaries.
+
+## ASR Timeout Settings
+
+The ASR timeout determines how long Speakr will wait for advanced transcription services to complete their work. The default 1,800 seconds (30 minutes) handles most recordings, but you might need to adjust based on your transcription service and typical file sizes.
+
+Setting this too low causes longer recordings to fail even when the transcription service is working normally. The recording appears stuck in processing, then eventually fails, frustrating users who must retry or give up. Setting it too high ties up system resources waiting for services that might have actually failed.
+
+Your optimal timeout depends on your transcription service's performance and your users' recording lengths. Monitor processing times for successful transcriptions and set the timeout comfortably above your longest normal processing time. If you regularly process multi-hour recordings, you might need 3,600 seconds or more.
+
+## Recording Disclaimer
+
+The recording disclaimer appears before users start any recording session, making it perfect for legal notices, policy reminders, or usage guidelines. This markdown-formatted message ensures users understand their responsibilities before creating content.
+
+Organizations often use this for compliance requirements - reminding users about consent requirements, data handling policies, or appropriate use guidelines. Educational institutions might note that recordings are for academic purposes only. Healthcare organizations could reference HIPAA compliance requirements.
+
+!!! info "Full Markdown Support (v0.6.2+)"
+    The recording disclaimer now supports **full markdown formatting**, including:
+
+    - **Headings** - Structure your disclaimer with `# Main Title` and `## Sections`
+    - **Lists** - Bulleted and numbered lists for clear requirements
+    - **Bold and Italic** - Emphasize important terms with `**bold**` or `*italic*`
+    - **Links** - Reference detailed policies with `[Privacy Policy](https://yoursite.com/privacy)`
+    - **Code blocks** - Include examples or technical requirements
+    - **Blockquotes** - Highlight key legal notices
+
+    Example markdown disclaimer:
+    ```markdown
+    ## Recording Consent Required
+
+    By starting this recording, you agree to:
+
+    1. Obtain consent from all participants
+    2. Comply with [company privacy policy](https://example.com/privacy)
+    3. Handle recordings according to **GDPR** requirements
+
+    > **Important**: Recordings containing sensitive information must be deleted within 30 days.
+    ```
+
+Keep disclaimers concise and relevant. Users see this message frequently, so lengthy legal text becomes an ignored click-through. Focus on the most important points, and link to detailed policies if needed. The markdown support lets you format the message clearly for better readability and comprehension.
+
+## Upload Disclaimer
+
+The upload disclaimer works just like the recording disclaimer, but it appears when users upload files rather than when they start recording. Every time a user drags and drops files or selects files for upload, they'll see this notice and must accept it before the files are queued for processing.
+
+This is useful when uploaded files may contain third-party content or when your organization needs to remind users about data handling before they submit files to the system. The disclaimer supports full markdown formatting, just like the recording disclaimer.
+
+!!! example "Example upload disclaimer"
+    ```markdown
+    ## Upload Policy
+
+    By uploading files, you confirm that:
+
+    - You have the right to share this content
+    - No sensitive personal data is included without authorization
+    - Files will be processed by external transcription services
+
+    > See our [data handling policy](https://example.com/policy) for details.
+    ```
+
+Leave this field empty to disable the upload disclaimer entirely. When empty, file uploads proceed immediately without any prompt.
+
+## Custom Banner
+
+The custom banner displays a persistent message across the top of the main content area for all users. It's useful for announcements, maintenance notices, compliance reminders, or any message you want everyone to see when they use Speakr.
+
+The banner appears below the header and above the main content. Users can dismiss it by clicking the X button, but it reappears on page refresh, ensuring the message stays visible as long as you have it configured.
+
+Like the disclaimers, the banner supports full markdown formatting, so you can include bold text, links, and other formatting. Keep banner text short and to the point since it takes up screen space.
+
+!!! example "Example banners"
+    ```markdown
+    **System update** — Speakr will be briefly unavailable on Sunday 10pm-12am for maintenance.
+    ```
+
+    ```markdown
+    All recordings are subject to our [acceptable use policy](https://example.com/aup). Contact IT with questions.
+    ```
+
+Leave this field empty to hide the banner completely.
+
+## System-Wide Impact
+
+Every setting on this page affects all users immediately. Changes take effect as soon as you save them, without requiring system restarts or user logouts. This immediate application means you should test changes carefully and communicate significant modifications to your users.
+
+The refresh button reloads settings from the database, useful if multiple admins might be making changes or if you want to ensure you're seeing the latest values. The interface shows when each setting was last updated, helping you track changes over time.
+
+## Troubleshooting Common Issues
+
+When recordings fail consistently, check if they're hitting your configured limits. The error logs will indicate if files are too large or if processing is timing out. Users might not realize their recordings exceed limits, especially if they're uploading existing content rather than recording directly.
+
+If API costs spike unexpectedly, review your transcript length limit. A single user uploading many long recordings could dramatically increase consumption if no limit is set. The combination of user activity and system settings determines your actual costs.
+
+Processing backlogs might indicate your timeout is too high. If the system waits 30 minutes for each failed transcription attempt, a series of problematic files could block the queue for hours. Balance patience for slow processing with the need to fail fast when services are actually down.
+
+## Environment Variable Configuration
+
+Beyond the UI-configurable settings above, several environment variables in your `.env` file control fundamental system behaviors. These require instance restart to take effect.
+
+### Collaboration & Sharing
+
+**ENABLE_INTERNAL_SHARING**: Controls user-to-user sharing capabilities. Set to `true` to enable internal sharing features, allowing users to share recordings with specific colleagues. Required for group functionality. Default: `false`.
+
+**SHOW_USERNAMES_IN_UI**: Controls username visibility in the interface. When `true`, usernames are displayed throughout the UI when sharing and collaborating. When `false`, usernames are hidden - users must know each other's usernames to share recordings (they type the username manually). Default: `false`.
+
+**ENABLE_PUBLIC_SHARING**: Controls whether public share links can be created. When `true`, authorized users can generate secure links for external sharing. When `false`, only internal sharing is available. Default: `false`.
+
+### User Permissions
+
+**USERS_CAN_DELETE**: Determines whether regular users can delete their own recordings. When `true`, users see delete buttons for their recordings. When `false`, only administrators can delete recordings. This helps prevent accidental data loss and maintains content retention for compliance. Default: `true`.
+
+### Retention & Auto-Deletion
+
+**ENABLE_AUTO_DELETION**: Enables the automated retention system. When `true`, recordings older than the retention period are automatically processed for deletion. Default: `false`.
+
+**DEFAULT_RETENTION_DAYS**: Global retention period in days for recordings without tag-specific retention. Set to `0` to disable auto-deletion. Tag-level retention policies can override this default. Default: `0` (disabled).
+
+**DELETION_MODE**: Controls what gets deleted: `audio_only` removes audio files but preserves transcriptions and metadata, while `full_recording` removes everything. Audio-only mode maintains searchable records while saving storage space. Default: `audio_only`.
+
+For detailed retention configuration, see the [Retention & Auto-Deletion](retention.md) guide.
+
+### Background Processing Queues
+
+Speakr uses separate job queues for transcription and summarization to prevent slow ASR processing from blocking quick summary generation.
+
+**JOB_QUEUE_WORKERS**: Number of workers for transcription jobs (ASR processing). These are slow jobs that can take 5-30 minutes. Default: `2`.
+
+**SUMMARY_QUEUE_WORKERS**: Number of workers for summary jobs (LLM API calls). These are fast jobs that typically complete in under a minute. Default: `2`.
+
+**JOB_MAX_RETRIES**: How many times a failed job will be retried before being marked as failed. Default: `3`.
+
+Jobs are persisted to the database and survive application restarts. If Speakr restarts while jobs are processing, they automatically resume from where they left off.
+
+### Folders Feature
+
+**ENABLE_FOLDERS**: Enable the folders organization feature. When `true`, users can create folders to organize recordings with per-folder custom prompts and ASR settings. Default: `false`.
+
+### Public Share Page Rendering
+
+**READABLE_PUBLIC_LINKS**: When `true`, transcripts on public share pages are server-side rendered in HTML, making them accessible to LLMs, scrapers, and accessibility tools. When `false`, transcripts are rendered client-side via JavaScript. Default: `false`.
+
+### Admin User Creation
+
+**SKIP_EMAIL_DOMAIN_CHECK**: When `true`, bypasses DNS validation of email domains when creating admin users via the setup script. Useful for development or when DNS lookups are restricted. Default: `false`.
+
+### Speaker Profile Cleanup
+
+**DELETE_ORPHANED_SPEAKERS**: Controls whether speaker profiles are automatically deleted when all their associated recordings are removed. When `false` (the default), speaker profiles and voice embeddings are preserved. When `true`, speakers with no remaining recordings are automatically cleaned up. Default: `false`.
+
+### Video Retention
+
+**VIDEO_RETENTION**: When enabled, uploaded video files keep their video stream for in-browser playback instead of extracting audio and discarding the video. The audio is extracted to a temporary file for transcription only, then cleaned up after processing. The video renders with a native `<video>` player alongside the transcript, with full seeking support via HTTP Range requests. All player controls (play/pause, seek, speed, volume) work identically. Ideal for presentations, lectures, and screen recordings. Default: `false`.
+
+### Video Passthrough to ASR
+
+**VIDEO_PASSTHROUGH_ASR**: When enabled, original video files are sent directly to the ASR backend without extracting audio first. This is useful for custom ASR backends that accept video files and handle audio extraction internally — for example, containers that extract multiple audio tracks from a video for separate processing. When active, video files bypass audio extraction, codec conversion, and chunking entirely. Audio file uploads are unaffected. This setting is independent of `VIDEO_RETENTION` — you can use either or both. Default: `false`.
+
+!!! warning
+    Only enable this if your ASR backend actually accepts video files. Standard services like OpenAI's Whisper API will reject video input.
+
+### Concurrent Uploads
+
+**MAX_CONCURRENT_UPLOADS**: Controls how many files can be uploaded simultaneously when batch uploading. Higher values speed up batch uploads but use more bandwidth and server resources. Default: `3`.
+
+### Audio Compression
+
+Speakr can automatically compress lossless audio uploads (WAV, AIFF) to save storage space. This happens transparently on upload - the original file is replaced with the compressed version.
+
+**AUDIO_COMPRESS_UPLOADS**: Enable automatic compression of lossless uploads. When `true`, WAV and AIFF files are compressed on upload. Already-compressed formats (MP3, AAC, OGG, etc.) are never re-encoded. Default: `true`.
+
+**AUDIO_CODEC**: Target compression format. Options:
+
+- `mp3` - Lossy, excellent compatibility, smallest files (~90% reduction)
+- `flac` - Lossless, preserves full quality (~50-70% reduction)
+- `opus` - Modern lossy codec, efficient for speech
+
+Default: `mp3`.
+
+**AUDIO_BITRATE**: Bitrate for lossy codecs (MP3, Opus). Common values: `64k`, `128k`, `192k`. Ignored for FLAC. Default: `128k`.
+
+### Configuration Example
+
+```bash
+# Enable collaboration features
+ENABLE_INTERNAL_SHARING=true
+SHOW_USERNAMES_IN_UI=true
+ENABLE_PUBLIC_SHARING=false
+
+# User permissions
+USERS_CAN_DELETE=false  # Only admins can delete
+
+# Retention policy
+ENABLE_AUTO_DELETION=true
+DEFAULT_RETENTION_DAYS=90
+DELETION_MODE=audio_only
+
+# Audio compression (enabled by default)
+AUDIO_COMPRESS_UPLOADS=true
+AUDIO_CODEC=mp3
+AUDIO_BITRATE=128k
+
+# Speaker cleanup (preserve profiles by default)
+DELETE_ORPHANED_SPEAKERS=false
+
+# Video retention (keep video files for playback)
+VIDEO_RETENTION=false
+
+# Video passthrough (send raw video to ASR, for custom backends)
+# VIDEO_PASSTHROUGH_ASR=false
+
+# Concurrent uploads (default: 3)
+MAX_CONCURRENT_UPLOADS=3
+
+# Processing queue
+JOB_QUEUE_WORKERS=2
+JOB_MAX_RETRIES=3
+```
+
+After modifying environment variables, restart your Speakr instance for changes to take effect:
+```bash
+docker compose restart
+```
+
+---
+
+Next: [Default Prompts](prompts.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/user-management.md b/docs/admin-guide/user-management.md
new file mode 100644
index 00000000..59e1e431
--- /dev/null
+++ b/docs/admin-guide/user-management.md
@@ -0,0 +1,89 @@
+# User Management
+
+The User Management tab is command central for controlling who has access to your Speakr instance and what they can do with it. Every user account flows through here, from initial creation to eventual removal, with all the monitoring and adjustments needed along the way. For system-wide usage patterns, check [system statistics](statistics.md).
+
+![User Management](../assets/images/screenshots/Admin dashboard.png)
+
+## Understanding the User Table
+
+When you open User Management, you're greeted with a comprehensive table showing every user in your system. Each row tells a story - the email address identifies the user, the admin badge shows their privilege level, the recording count reveals their activity level, and the storage measurement demonstrates their resource consumption.
+
+The search bar at the top responds instantly as you type, filtering the table to help you find specific users quickly. This becomes invaluable as your user base grows beyond what fits on a single screen. The table updates in real-time when you make changes, so you always see the current state of your system.
+
+## Adding New Users
+
+Creating a user account starts with clicking the Add User button in the top right corner. The modal that appears asks for the essentials - username, email address, and password. You'll also decide immediately whether this person needs admin privileges, though you can always change this later.
+
+The username becomes their identity within Speakr, appearing in the interface and organizing their recordings. The email address serves dual purposes - it's their login credential and their contact point for any system communications. The password you set is temporary; users should change it immediately after their first login through their [account settings](../user-guide/settings.md). Configure initial [language preferences](../user-guide/settings.md#language-preferences) and [custom prompts](../user-guide/settings.md#custom-prompts-tab).
+
+Admin privileges are powerful and should be granted sparingly. Admin users can see and modify all [system settings](system-settings.md), manage other users including other admins, configure [default prompts](prompts.md), and monitor the [vector store](vector-store.md). Most users will never need these capabilities.
+
+### User Permissions
+
+Beyond the admin role, Speakr offers granular per-user permissions that control specific capabilities:
+
+**Public Sharing Permission**: The public sharing icon button (globe icon) in each user's row toggles their ability to create public share links. When enabled (green), the user can generate secure links to share recordings externally with anyone. When disabled (gray), the user can only use internal sharing to share with other Speakr users. This permission is only available if `ENABLE_PUBLIC_SHARING=true` in your environment configuration.
+
+Use this permission to control external information sharing on a per-user basis. You might grant public sharing to executives, sales groups, or marketing staff who regularly communicate with external stakeholders, while restricting it for users handling sensitive internal data.
+
+### Token Budget Management
+
+Control LLM costs by setting monthly token budgets for individual users. When creating or editing a user, you can specify a monthly token limit that restricts their AI usage.
+
+![User Token Budget](../assets/images/screenshots/admin-user-create-token-budget.png)
+
+**How Token Budgets Work**:
+
+- **Warning at 80%**: Users see a yellow warning indicator when they reach 80% of their monthly budget
+- **Blocked at 100%**: Once the budget is exhausted, AI operations (chat, summarization, etc.) are blocked until the next month
+- **Budget Reset**: Token counts reset automatically at the start of each calendar month
+- **No Limit**: Leave the budget field empty for unlimited usage
+
+Token budgets are set in increments of 10,000 tokens with a minimum of 100,000. The budget covers all AI operations including summarization, chat, title generation, and event extraction. View detailed token usage statistics in the [System Statistics](statistics.md#token-usage-statistics) section.
+
+### Transcription Budget Management
+
+Control transcription costs by setting monthly transcription budgets for individual users. When creating or editing a user, you can specify a monthly limit (in minutes) that restricts their speech-to-text usage.
+
+**How Transcription Budgets Work**:
+
+- **Warning at 80%**: Users see a yellow warning indicator when they reach 80% of their monthly transcription budget
+- **Blocked at 100%**: Once the budget is exhausted, new transcriptions are blocked until the next month
+- **Budget Reset**: Transcription minutes reset automatically at the start of each calendar month
+- **No Limit**: Leave the budget field empty for unlimited transcription usage
+
+Transcription budgets are set in minutes with a minimum of 10 minutes. The budget covers all transcription operations regardless of which connector is used (OpenAI Whisper, OpenAI Transcribe, or self-hosted ASR). View detailed transcription usage statistics in the [System Statistics](statistics.md#transcription-usage-statistics) section.
+
+**Cost Tracking**: The system tracks estimated costs based on the transcription connector used:
+
+- **OpenAI Whisper**: $0.006 per minute
+- **OpenAI Transcribe**: $0.003-$0.006 per minute depending on model
+- **Self-hosted ASR**: $0 (no external API costs)
+
+## Managing Existing Users
+
+Each user row includes action buttons that give you complete control over that account. The edit button opens a modal where you can update their username or email address. This is useful when people change names, switch email providers, or when you need to correct initial entry mistakes.
+
+The admin toggle is perhaps the most powerful single click in the interface. Promoting a user to admin grants them access to everything you can see and do. Demoting an admin back to regular user immediately revokes all their administrative capabilities. The system prevents you from removing admin rights from your own account, ensuring you can't accidentally lock yourself out.
+
+The delete button requires careful consideration. Removing a user is permanent and cannot be undone through the interface. All their recordings, notes, and settings will be deleted along with their account. The system asks for confirmation, but once confirmed, the removal is immediate and complete.
+
+## Monitoring Usage Patterns
+
+The recording count and storage columns reveal how users interact with your Speakr instance. High recording counts might indicate power users who rely heavily on the system, while low counts could suggest users who need training or might not need accounts at all.
+
+Storage consumption tells another important story. Users with disproportionately high storage might be uploading very long recordings, keeping everything indefinitely, or possibly misusing the system. You can adjust [file size limits](system-settings.md#maximum-file-size) and review [chunking settings](../troubleshooting.md#files-over-25mb-fail-with-openai) if needed. This information helps you have informed conversations about resource usage and establish appropriate policies.
+
+Patterns often emerge when you regularly review this data. You might notice seasonal variations in academic settings, project-based spikes in corporate environments, or gradual growth that signals the need for infrastructure expansion.
+
+## Security Implications
+
+Every user account is a potential security vector. Strong passwords are your first defense, but they're not enough alone. Encourage users to use unique passwords, change them regularly, and never share them with others.
+
+Admin accounts require extra vigilance. Each admin can do everything you can do, including creating more admins or deleting all users. Limit admin access to the absolute minimum needed for operations. When someone no longer needs admin privileges, revoke them immediately.
+
+Inactive accounts pose particular risks. They might have weak or compromised passwords that no one is monitoring. Regular audits help you identify and remove these vulnerabilities before they become problems.
+
+---
+
+Next: [System Statistics](statistics.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/vector-store.md b/docs/admin-guide/vector-store.md
new file mode 100644
index 00000000..9d44fb2a
--- /dev/null
+++ b/docs/admin-guide/vector-store.md
@@ -0,0 +1,90 @@
+# Vector Store Management
+
+The Vector Store tab controls the intelligence behind Inquire Mode, Speakr's semantic search capability that lets users find information across all their recordings using natural language questions. This is where you monitor and manage the embedding system that transforms transcripts into searchable knowledge.
+
+![Vector Store Management](../assets/images/screenshots/Admin vector store.png)
+
+## Understanding Inquire Mode
+
+Before diving into management, it's worth understanding what you're managing. Inquire Mode breaks each transcript into overlapping chunks of text, converts these chunks into mathematical representations called embeddings, and stores them in a searchable format. When users ask questions, their query gets converted to the same mathematical format and compared against all stored chunks to find the most relevant information.
+
+This approach goes beyond simple keyword matching. The system understands that "budget concerns" relates to "financial constraints" and "cost overruns" even though the exact words differ. This semantic understanding makes Inquire Mode powerful for discovering information that users might not remember precisely.
+
+!!! note "Lightweight Image"
+    The `lite` Docker image (`learnedmachine/speakr:lite`) ships without the local sentence-transformers model. Two options to enable semantic search on lite:
+    - Set `EMBEDDING_BASE_URL` to an OpenAI-compatible embeddings endpoint (vLLM, OpenRouter, OpenAI, etc.). Inquire Mode then runs in full semantic-search mode using API-generated vectors. See [Model Configuration](model-configuration.md#configurable-embedding-model) for setup.
+    - Switch to the `latest` image tag, which includes the local sentence-transformers model.
+
+    Without either, Inquire Mode falls back to keyword-based text search.
+
+## The Embedding Model
+
+By default, Speakr uses the all-MiniLM-L6-v2 model. It generates 384-dimensional vectors and runs efficiently on CPU-only systems, which makes advanced search accessible without GPU infrastructure. The default is suitable for English-dominant deployments and small-to-medium recording libraries.
+
+For larger libraries, multilingual content, or higher-quality semantic matching, the `EMBEDDING_MODEL` environment variable accepts any sentence-transformers identifier (`all-mpnet-base-v2`, `paraphrase-multilingual-MiniLM-L12-v2`, and similar). For deployments that prefer not to load embedding models locally, setting `EMBEDDING_BASE_URL` switches Speakr to an OpenAI-compatible HTTP endpoint, allowing the use of providers such as OpenAI, OpenRouter, or a self-hosted vLLM server. See [Model Configuration → Configurable Embedding Model](model-configuration.md#configurable-embedding-model) for the full set of supported environment variables and migration guidance.
+
+Changing the model or provider on an existing instance produces vectors that do not match what is stored. Speakr records the active configuration in `system_setting` on first run and logs a warning at startup if it changes. After such a change, reprocess recordings to rebuild the index.
+
+## Processing Status Overview
+
+The status cards give you immediate insight into your vector store's health. Total Recordings shows how many audio files exist in your system, while Processed for Inquire indicates how many have been converted to searchable embeddings. These numbers should eventually match, though there's often a lag as background processing catches up.
+
+Need Processing reveals recordings waiting for embedding generation. This number grows when users upload new content and shrinks as the background processor works through the queue. A consistently high number might indicate processing has stalled or your system is overwhelmed.
+
+Total Chunks shows the granular pieces your recordings have been divided into. A typical one-hour recording might generate 50-60 chunks, depending on transcript density. This chunking ensures relevant segments can be found even in very long recordings.
+
+The Embeddings Status indicator provides a quick health check. "Available" in green means everything is working correctly. Other states might indicate the model is loading, processing is running, or attention is needed.
+
+## Processing Progress
+
+The processing progress bar shows real-time advancement through the embedding queue. When at 100%, all recordings are processed and searchable. Lower percentages indicate work in progress, with the bar filling as recordings are completed.
+
+This visual feedback helps you understand system status at a glance. A stuck progress bar suggests processing has stopped. Slow progress might indicate system resource constraints. Rapid progress shows everything is working efficiently.
+
+## Managing the Processing Queue
+
+The Refresh Status button updates all statistics and progress indicators, useful for monitoring active processing or verifying recent uploads have been queued. The interface doesn't auto-refresh, so manual refreshes ensure you're seeing current information.
+
+When the system shows recordings need processing but progress isn't advancing, several factors might be at play. The background processor might have stopped, the embedding model might have failed to load, or system resources might be exhausted. Check your logs for specific error messages.
+
+The processing system is designed to be resilient. If processing fails for a specific recording, the system marks it and moves on rather than getting stuck. These failures appear in your logs and might require manual intervention to resolve.
+
+## Re-Embed All
+
+The **Re-embed all** button at the top of the Vector Store tab clears every stored embedding and queues every recording for re-processing through the current embedding configuration. Use it after changing `EMBEDDING_MODEL`, switching from local to API-mode (`EMBEDDING_BASE_URL`), or changing `EMBEDDING_DIMENSIONS`, since old vectors generated by the previous configuration cannot be compared meaningfully against new query vectors.
+
+A confirmation modal appears before the action runs. Re-embedding a large library is bandwidth-intensive when API-mode is configured (every chunk goes back to the embedding provider) and CPU-intensive in local mode, so plan for the workload. Embedding token usage from the run shows up on the Statistics tab's separate embedding card so you can attribute the cost cleanly.
+
+If only a subset of recordings is affected by the configuration change (for example, you re-uploaded one folder), reprocessing those recordings individually is more efficient than the global re-embed.
+
+## Embedding Token Tracking
+
+The Vector Store tab also shows embedding API token usage and estimated cost when API-mode is configured (`EMBEDDING_BASE_URL` is set). This is tracked separately from LLM operations because embedding pricing is typically much lower per token but request volume is much higher (every chunk of every recording is one or more requests). The same numbers feed the dedicated embedding card on the Statistics tab — see [System Statistics](statistics.md#token-usage-statistics) for the per-day and per-month breakdown.
+
+## Optimizing Performance
+
+Processing performance depends heavily on your system resources. The embedding model needs about 500MB of RAM when loaded, plus additional memory for processing text. CPU speed directly impacts how quickly embeddings are generated - a modern multi-core processor can handle several recordings simultaneously.
+
+Disk I/O also matters. The system reads transcripts, processes them, and writes embeddings back to the database. Fast storage, particularly SSDs, significantly improves processing throughput. If your vector store is on a different disk than your transcripts, ensure both have adequate performance.
+
+Network latency shouldn't affect processing since everything happens locally, but database performance matters. Regular database maintenance, including index optimization and vacuum operations, keeps queries fast even as your vector store grows.
+
+## Troubleshooting Common Issues
+
+When Inquire Mode returns poor results despite processed recordings, the issue might be query formulation rather than the vector store. Encourage users to ask complete questions rather than typing keywords. "What did John say about the budget?" works better than just "John budget."
+
+If processing seems frozen, check whether the sentence-transformers library is properly installed. The system gracefully degrades without it, disabling Inquire Mode rather than crashing, but processing won't advance. Your logs will show whether the embedding model loaded successfully.
+
+Memory errors during processing usually indicate your system is trying to process too much simultaneously. The chunking system prevents individual recordings from overwhelming memory, but processing multiple large recordings in parallel might exceed available RAM.
+
+## Scaling Considerations
+
+The vector store grows predictably with your content. Each chunk requires about 2KB of storage for its embedding and metadata. A typical one-hour recording generating 50 chunks needs about 100KB of embedding storage. Ten thousand hours of recordings might require 100MB for embeddings - manageable even on modest systems.
+
+Search performance remains fast even with large vector stores thanks to efficient indexing. However, extremely large instances (hundreds of thousands of recordings) might benefit from dedicated vector database solutions rather than the built-in SQLite storage.
+
+If your instance grows beyond comfortable limits, consider archiving old recordings. The vector store only includes active recordings, so removing obsolete content improves both storage and search performance.
+
+---
+
+Return to [Admin Guide Overview](index.md) →
\ No newline at end of file
diff --git a/docs/admin-guide/whisperx-setup.md b/docs/admin-guide/whisperx-setup.md
new file mode 100644
index 00000000..54996321
--- /dev/null
+++ b/docs/admin-guide/whisperx-setup.md
@@ -0,0 +1,426 @@
+---
+layout: default
+title: WhisperX ASR Setup
+parent: Admin Guide
+nav_order: 8
+---
+
+# WhisperX ASR Service Setup
+
+WhisperX is an advanced ASR (Automatic Speech Recognition) service that provides superior speaker diarization and word-level timestamps compared to standard Whisper implementations. This guide covers setting up WhisperX as an alternative ASR backend for Speakr.
+
+## Overview
+
+**WhisperX Benefits:**
+
+- ✅ Better speaker diarization accuracy (Pyannote.audio 4.0)
+- ✅ More precise word-level timestamps
+- ✅ Improved multi-speaker handling
+- ✅ **Voice profile support** with 256-dimensional speaker embeddings
+- ✅ Automatic speaker recognition across recordings
+- ✅ Active development and updates
+- ✅ Production-ready Docker deployment
+
+**vs. Standard Whisper ASR:**
+
+- Standard: Simple, lightweight, good for single speakers, no voice profiles
+- WhisperX: Advanced diarization, voice profiles, better for meetings/conversations
+
+## Prerequisites
+
+### Hardware Requirements
+
+**Minimum:**
+
+- NVIDIA GPU with 8GB+ VRAM (RTX 3060, RTX 2080, etc.)
+- 16GB RAM
+- 50GB free disk space
+
+**Recommended:**
+
+- NVIDIA GPU with 16GB+ VRAM (RTX 3080, RTX 4080, A100)
+- 32GB RAM
+- 100GB SSD storage
+
+### Software Requirements
+
+- Docker and Docker Compose
+- NVIDIA Container Toolkit
+- Hugging Face account with model access
+
+## Quick Start
+
+### 1. Get the WhisperX Service
+
+The WhisperX ASR service is maintained in a separate repository:
+
+```bash
+# Clone the WhisperX ASR service
+git clone https://github.com/murtaza-nasir/whisperx-asr-service.git
+cd whisperx-asr-service
+```
+
+### 2. Configure Hugging Face Access
+
+**Complete ALL steps below to enable speaker diarization:**
+
+#### Step 1: Create Account
+- Visit: [https://huggingface.co/join](https://huggingface.co/join)
+- Sign up with your email
+
+#### Step 2: Accept Model Agreements (CRITICAL - ALL THREE REQUIRED)
+
+You must accept agreements for **all three models** used by the diarization pipeline:
+
+1. **Main diarization model:**
+    - [https://huggingface.co/pyannote/speaker-diarization-community-1](https://huggingface.co/pyannote/speaker-diarization-community-1)
+
+2. **Segmentation model:**
+    - [https://huggingface.co/pyannote/segmentation-3.0](https://huggingface.co/pyannote/segmentation-3.0)
+
+3. **Speaker diarization 3.1:**
+    - [https://huggingface.co/pyannote/speaker-diarization-3.1](https://huggingface.co/pyannote/speaker-diarization-3.1)
+
+For each model:
+
+- Click the **"Agree and access repository"** button
+- Fill out form (Company/university: your organization, Use case: "Meeting note taker")
+- Submit (approval is instant)
+
+#### Step 3: Generate Access Token
+- Visit: [https://huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
+- Click **"New token"**
+- Name: `whisperx-diarization`
+- Permission: **Read**
+- Click **"Generate token"**
+- Copy the token (starts with `hf_...`)
+
+**⚠️ Important:** You MUST accept the model agreement in Step 2. Without this, you'll get "403 Access Denied" errors even with a valid token.
+
+### 3. Set Up Environment
+
+```bash
+# Copy example configuration
+cp .env.example .env
+
+# Edit and add your Hugging Face token
+nano .env
+```
+
+Update `.env`:
+```bash
+HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+DEVICE=cuda
+COMPUTE_TYPE=float16
+BATCH_SIZE=16
+```
+
+### 4. Deploy the Service
+
+```bash
+# Build Docker image
+docker compose build
+
+# Start service
+docker compose up -d
+
+# Check logs
+docker compose logs -f
+```
+
+### 5. Test the Service
+
+```bash
+# Health check
+curl http://localhost:9000/health
+
+# Should return:
+{
+  "status": "healthy",
+  "device": "cuda",
+  "loaded_models": []
+}
+```
+
+## Integration with Speakr
+
+### Same Machine Deployment
+
+If WhisperX is running on the same machine as Speakr:
+
+Update Speakr's `.env` file:
+
+```bash
+# Enable ASR endpoint
+USE_ASR_ENDPOINT=true
+
+# Point to WhisperX service
+ASR_BASE_URL=http://whisperx-asr-api:9000
+
+# Enable voice profile features (speaker embeddings)
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+> **Important:** The `ASR_RETURN_SPEAKER_EMBEDDINGS=true` setting is required to enable voice profile features. This setting is only supported by WhisperX and should not be enabled when using the basic OpenAI Whisper ASR Webservice.
+
+Restart Speakr:
+
+```bash
+docker compose restart
+```
+
+### Separate GPU Machine Deployment
+
+If WhisperX is on a dedicated GPU server:
+
+**On GPU Machine:**
+
+1. Expose service to network in `docker-compose.yml`:
+    ```yaml
+    ports:
+     - "0.0.0.0:9000:9000"
+    ```
+
+2. Configure firewall:
+    ```bash
+    sudo ufw allow 9000/tcp
+    ```
+
+**On Speakr Machine:**
+
+Update Speakr's `.env`:
+
+```bash
+USE_ASR_ENDPOINT=true
+ASR_BASE_URL=http://GPU_MACHINE_IP:9000
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+Replace `GPU_MACHINE_IP` with actual IP address.
+
+## Configuration
+
+### Performance Tuning
+
+Edit WhisperX service `.env`:
+
+**High-End GPU (RTX 3080+, A100):**
+```bash
+BATCH_SIZE=32
+COMPUTE_TYPE=float16
+```
+
+**Mid-Range GPU (RTX 3060, RTX 2080):**
+```bash
+BATCH_SIZE=16
+COMPUTE_TYPE=float16
+```
+
+**Low-End GPU (GTX 1660, RTX 2060):**
+```bash
+BATCH_SIZE=8
+COMPUTE_TYPE=int8
+```
+
+### Model Selection
+
+Models are selected per-recording in Speakr. Available options:
+
+| Model | Quality | Speed | VRAM Required |
+|-------|---------|-------|---------------|
+| tiny | Low | Fastest | 1GB |
+| base | Low | Very Fast | 1GB |
+| small | Medium | Fast | 2GB |
+| medium | Good | Moderate | 5GB |
+| large-v2 | Excellent | Slow | 10GB |
+| large-v3 | Best | Slow | 10GB |
+
+**Recommendation:** Use `large-v3` for best quality, `small` for speed.
+
+## Custom Vocabulary & Transcription Hints
+
+WhisperX supports both **hotwords** and **initial_prompt** parameters to improve transcription accuracy for domain-specific content.
+
+- **Hotwords** - Comma-separated terms the model should prioritize (brand names, acronyms, jargon). Passed as the `hotwords` query parameter to the ASR endpoint.
+- **Initial Prompt** - Context text that guides the model's word choices. Passed as the `initial_prompt` query parameter.
+
+Set these at any level in Speakr: per-user defaults, per-tag, per-folder, or per-upload in the Advanced ASR Options. See the [Custom Vocabulary feature docs](../features.md#custom-vocabulary--transcription-hints) for details on the precedence hierarchy.
+
+!!! note "ASR Service Compatibility"
+    The WhisperX ASR service (`learnedmachine/whisperx-asr-service`) fully supports both `hotwords` and `initial_prompt` parameters. The community `whisper-asr-webservice` by ahmetoner supports `initial_prompt` but does not currently expose a `hotwords` parameter through its API.
+
+## Speaker Diarization
+
+WhisperX provides superior speaker diarization compared to standard implementations.
+
+### Settings in Speakr
+
+When uploading or processing recordings:
+
+- **Min Speakers:** Minimum expected number of speakers
+- **Max Speakers:** Maximum expected number of speakers
+- Leave blank for automatic detection
+
+**Tips:**
+
+- Set `min_speakers=2` and `max_speakers=6` for typical meetings
+- For interviews: `min_speakers=2`, `max_speakers=2`
+- For panels: `min_speakers=3`, `max_speakers=8`
+
+### After Transcription
+
+Use Speakr's speaker identification feature to assign real names to detected speakers. WhisperX's improved diarization makes this more accurate.
+
+## Monitoring
+
+### Check Service Health
+
+```bash
+# Container status
+cd /path/to/whisperx-asr-service
+docker compose ps
+
+# View logs
+docker compose logs -f
+
+# Check GPU usage
+nvidia-smi -l 1
+```
+
+### Performance Metrics
+
+Monitor in Speakr's admin interface:
+
+- Transcription times
+- Error rates
+- Model usage statistics
+
+## Troubleshooting
+
+### WhisperX Service Won't Start
+
+**Check logs:**
+```bash
+docker compose logs whisperx-asr
+```
+
+**Common issues:**
+
+- GPU not accessible: Verify `nvidia-smi` works
+- Invalid HF_TOKEN: Check token and model agreements
+- Port conflict: Change port in `docker-compose.yml`
+
+### Speakr Can't Connect
+
+**Test connectivity:**
+```bash
+curl http://ASR_BASE_URL/health
+```
+
+**Solutions:**
+
+- Verify firewall rules
+- Check network connectivity
+- Ensure service is running
+- Try IP address instead of hostname
+
+### Slow Processing
+
+**Solutions:**
+
+- Increase `BATCH_SIZE` (if GPU has memory)
+- Use smaller model (`small` instead of `large-v3`)
+- Disable diarization for faster processing
+- Check GPU usage with `nvidia-smi`
+
+### Out of Memory
+
+**Error:** `CUDA out of memory`
+
+**Solutions:**
+
+1. Reduce `BATCH_SIZE`: Set to `8` or `4`
+2. Use smaller model
+3. Use `COMPUTE_TYPE=int8`
+4. Close other GPU applications
+
+### Speaker Diarization Fails
+
+**Check:**
+
+1. HF_TOKEN is set correctly in `.env`
+2. Accepted pyannote model agreements
+3. Service has internet access (for first-time model download)
+
+**Solutions:**
+
+- Regenerate HF token
+- Accept model agreements again
+- Check logs for specific errors
+
+## Upgrading
+
+### Update WhisperX Service
+
+```bash
+cd /path/to/whisperx-asr-service
+
+# Pull latest changes (if using Git)
+git pull
+
+# Rebuild image
+docker compose build --no-cache
+
+# Restart service
+docker compose up -d
+```
+
+### Update Models
+
+Models are cached automatically. To use newer models:
+
+```bash
+# Remove cache volume
+docker compose down -v
+
+# Restart (models will re-download)
+docker compose up -d
+```
+
+## Performance Benchmarks
+
+Tested on RTX 3080 (10GB VRAM):
+
+| Model | 10min Audio | Processing Time | Real-time Factor |
+|-------|-------------|-----------------|------------------|
+| small | 10 min | 45 sec | 13x |
+| medium | 10 min | 90 sec | 6.7x |
+| large-v3 | 10 min | 180 sec | 3.3x |
+
+*With diarization: add ~30% processing time*
+
+## Comparison: WhisperX vs Standard Whisper
+
+| Feature | Standard Whisper | WhisperX |
+|---------|-----------------|----------|
+| Transcription Quality | Excellent | Excellent |
+| Word Timestamps | Good | Excellent |
+| Speaker Diarization | Good | Excellent |
+| Voice Profiles | ❌ Not supported | ✅ 256-dim embeddings |
+| Speaker Recognition | ❌ Manual only | ✅ Automatic matching |
+| Setup Complexity | Low | Medium |
+| Resource Usage | Lower | Higher |
+| Active Development | Moderate | High |
+| Production Ready | Yes | Yes |
+
+> **Note:** To enable voice profile features with WhisperX, you must set `ASR_RETURN_SPEAKER_EMBEDDINGS=true` in Speakr's `.env` file. This setting is disabled by default for compatibility with the basic ASR webservice.
+
+## Getting Help
+
+- **Service Documentation:** See WhisperX service README
+- **WhisperX Issues:** [GitHub](https://github.com/m-bain/whisperX/issues)
+- **Speakr Integration:** Check Speakr logs and admin dashboard
+
+---
+
+For detailed setup instructions, see the [WhisperX Service Setup Guide](https://github.com/murtaza-nasir/whisperx-asr-service/blob/main/SETUP_GUIDE.md).
diff --git a/docs/advanced/custom-connectors.md b/docs/advanced/custom-connectors.md
new file mode 100644
index 00000000..9ec5145c
--- /dev/null
+++ b/docs/advanced/custom-connectors.md
@@ -0,0 +1,549 @@
+# Creating Custom Transcription Connectors
+
+This guide explains how to create custom transcription connectors for Speakr. Connectors allow you to integrate new transcription providers like Deepgram, AssemblyAI, Google Cloud Speech-to-Text, or your own custom services.
+
+## Architecture Overview
+
+Speakr uses a connector-based architecture where each transcription provider is implemented as a connector class that extends `BaseTranscriptionConnector`. The connector registry manages all available connectors and handles auto-detection from environment variables.
+
+```
+src/services/transcription/
+├── base.py              # Base classes and data types
+├── registry.py          # Connector registry and factory
+├── exceptions.py        # Custom exceptions
+└── connectors/
+    ├── __init__.py
+    ├── openai_whisper.py    # OpenAI Whisper connector
+    ├── openai_transcribe.py # OpenAI GPT-4o transcribe connector
+    └── asr_endpoint.py      # Self-hosted ASR connector
+```
+
+## Base Classes
+
+### TranscriptionCapability
+
+Capabilities that connectors can declare support for:
+
+```python
+from enum import Enum, auto
+
+class TranscriptionCapability(Enum):
+    DIARIZATION = auto()           # Speaker diarization
+    CHUNKING = auto()              # Automatic file chunking for large files
+    TIMESTAMPS = auto()            # Word/segment timestamps
+    LANGUAGE_DETECTION = auto()    # Auto language detection
+    KNOWN_SPEAKERS = auto()        # Support for known speaker references
+    SPEAKER_EMBEDDINGS = auto()    # Return speaker embeddings
+    SPEAKER_COUNT_CONTROL = auto() # Support for min/max speaker count
+    STREAMING = auto()             # Real-time streaming transcription
+```
+
+### ConnectorSpecifications
+
+Provider-specific constraints and requirements:
+
+```python
+from dataclasses import dataclass
+from typing import Optional, FrozenSet
+
+@dataclass
+class ConnectorSpecifications:
+    # Size constraints
+    max_file_size_bytes: Optional[int] = None  # None = unlimited
+
+    # Duration constraints
+    max_duration_seconds: Optional[int] = None
+    min_duration_for_chunking: Optional[int] = None
+
+    # Chunking behavior
+    handles_chunking_internally: bool = False  # Provider handles large files
+    requires_chunking_param: bool = False      # Must send chunking_strategy param
+    recommended_chunk_seconds: int = 600       # 10 minutes default
+
+    # Audio format support
+    supported_codecs: Optional[FrozenSet[str]] = None    # Override defaults
+    unsupported_codecs: Optional[FrozenSet[str]] = None  # Exclude from defaults
+```
+
+### Request/Response Types
+
+```python
+@dataclass
+class TranscriptionRequest:
+    audio_file: BinaryIO
+    filename: str
+    mime_type: Optional[str] = None
+    language: Optional[str] = None
+
+    # Diarization options
+    diarize: bool = False
+    min_speakers: Optional[int] = None
+    max_speakers: Optional[int] = None
+
+    # Advanced options
+    prompt: Optional[str] = None          # Initial prompt for context/guidance
+    hotwords: Optional[str] = None        # Comma-separated words to bias recognition
+    temperature: Optional[float] = None
+    extra_options: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class TranscriptionSegment:
+    text: str
+    speaker: Optional[str] = None
+    start_time: Optional[float] = None
+    end_time: Optional[float] = None
+    confidence: Optional[float] = None
+    words: Optional[List[Dict[str, Any]]] = None
+
+
+@dataclass
+class TranscriptionResponse:
+    text: str
+    segments: Optional[List[TranscriptionSegment]] = None
+    language: Optional[str] = None
+    duration: Optional[float] = None
+    speakers: Optional[List[str]] = None
+    speaker_embeddings: Optional[Dict[str, List[float]]] = None
+    provider: str = ""
+    model: str = ""
+    raw_response: Optional[Dict[str, Any]] = None
+```
+
+## Creating a Custom Connector
+
+### Step 1: Create the Connector File
+
+Create a new file in `src/services/transcription/connectors/`:
+
+```python
+# src/services/transcription/connectors/deepgram.py
+
+"""
+Deepgram transcription connector.
+
+Integrates with Deepgram's speech-to-text API.
+"""
+
+import logging
+import httpx
+from typing import Dict, Any, Set
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError, ProviderError
+
+logger = logging.getLogger(__name__)
+
+
+class DeepgramConnector(BaseTranscriptionConnector):
+    """Connector for Deepgram speech-to-text API."""
+
+    # Declare what capabilities this connector supports
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.DIARIZATION,
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        TranscriptionCapability.SPEAKER_COUNT_CONTROL,
+    }
+
+    PROVIDER_NAME = "deepgram"
+
+    # Define provider constraints
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=2 * 1024 * 1024 * 1024,  # 2GB
+        handles_chunking_internally=True,  # Deepgram handles large files
+    )
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the Deepgram connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - api_key: Deepgram API key (required)
+                - model: Model name (default: 'nova-2')
+                - language: Default language (optional)
+        """
+        super().__init__(config)
+
+        self.api_key = config['api_key']
+        self.model = config.get('model', 'nova-2')
+        self.default_language = config.get('language')
+        self.base_url = 'https://api.deepgram.com/v1/listen'
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('api_key'):
+            raise ConfigurationError("api_key is required for Deepgram connector")
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using Deepgram.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse with segments and speaker information
+        """
+        try:
+            # Build query parameters
+            params = {
+                'model': self.model,
+                'punctuate': 'true',
+                'utterances': 'true',
+            }
+
+            # Add diarization if requested
+            if request.diarize:
+                params['diarize'] = 'true'
+                if request.min_speakers:
+                    params['diarize_version'] = '2'  # Required for speaker count
+                if request.max_speakers:
+                    params['diarize_version'] = '2'
+
+            # Add language
+            language = request.language or self.default_language
+            if language:
+                params['language'] = language
+            else:
+                params['detect_language'] = 'true'
+
+            # Prepare headers
+            headers = {
+                'Authorization': f'Token {self.api_key}',
+                'Content-Type': request.mime_type or 'audio/wav',
+            }
+
+            # Read audio content
+            audio_content = request.audio_file.read()
+
+            # Make request
+            timeout = httpx.Timeout(300.0, connect=60.0)
+
+            with httpx.Client() as client:
+                response = client.post(
+                    self.base_url,
+                    params=params,
+                    headers=headers,
+                    content=audio_content,
+                    timeout=timeout
+                )
+                response.raise_for_status()
+                data = response.json()
+
+            return self._parse_response(data)
+
+        except httpx.HTTPStatusError as e:
+            raise ProviderError(
+                f"Deepgram request failed with status {e.response.status_code}",
+                provider=self.PROVIDER_NAME,
+                status_code=e.response.status_code
+            ) from e
+
+        except Exception as e:
+            raise TranscriptionError(f"Deepgram transcription failed: {e}") from e
+
+    def _parse_response(self, data: Dict[str, Any]) -> TranscriptionResponse:
+        """Parse Deepgram response into standardized format."""
+        segments = []
+        speakers = set()
+
+        # Extract from utterances (for diarization)
+        results = data.get('results', {})
+        utterances = results.get('utterances', [])
+
+        for utt in utterances:
+            speaker = f"SPEAKER_{utt.get('speaker', 0):02d}"
+            speakers.add(speaker)
+
+            segments.append(TranscriptionSegment(
+                text=utt.get('transcript', ''),
+                speaker=speaker,
+                start_time=utt.get('start'),
+                end_time=utt.get('end'),
+                confidence=utt.get('confidence')
+            ))
+
+        # Get full transcript
+        channels = results.get('channels', [])
+        full_text = ''
+        if channels:
+            alternatives = channels[0].get('alternatives', [])
+            if alternatives:
+                full_text = alternatives[0].get('transcript', '')
+
+        # Get detected language
+        detected_language = None
+        if channels:
+            detected_language = channels[0].get('detected_language')
+
+        return TranscriptionResponse(
+            text=full_text,
+            segments=segments if segments else None,
+            speakers=sorted(list(speakers)) if speakers else None,
+            language=detected_language,
+            provider=self.PROVIDER_NAME,
+            model=self.model,
+            raw_response=data
+        )
+
+    def health_check(self) -> bool:
+        """Check if Deepgram API is reachable."""
+        try:
+            with httpx.Client(timeout=10.0) as client:
+                response = client.get(
+                    'https://api.deepgram.com/v1/projects',
+                    headers={'Authorization': f'Token {self.api_key}'}
+                )
+                return response.status_code < 500
+        except Exception:
+            return False
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["api_key"],
+            "properties": {
+                "api_key": {
+                    "type": "string",
+                    "description": "Deepgram API key"
+                },
+                "model": {
+                    "type": "string",
+                    "default": "nova-2",
+                    "description": "Deepgram model name"
+                },
+                "language": {
+                    "type": "string",
+                    "description": "Default language code (e.g., 'en')"
+                }
+            }
+        }
+```
+
+### Step 2: Register the Connector
+
+Add your connector to the registry in `src/services/transcription/registry.py`:
+
+```python
+def _register_builtin_connectors(self):
+    """Register all built-in connectors."""
+    from .connectors.openai_whisper import OpenAIWhisperConnector
+    from .connectors.openai_transcribe import OpenAITranscribeConnector
+    from .connectors.asr_endpoint import ASREndpointConnector
+    from .connectors.deepgram import DeepgramConnector  # Add this
+
+    self.register('openai_whisper', OpenAIWhisperConnector)
+    self.register('openai_transcribe', OpenAITranscribeConnector)
+    self.register('asr_endpoint', ASREndpointConnector)
+    self.register('deepgram', DeepgramConnector)  # Add this
+```
+
+### Step 3: Add Environment Configuration
+
+Add config building logic to `_build_config_from_env()` in the registry:
+
+```python
+def _build_config_from_env(self, connector_name: str) -> Dict[str, Any]:
+    # ... existing code ...
+
+    elif connector_name == 'deepgram':
+        return {
+            'api_key': os.environ.get('DEEPGRAM_API_KEY', ''),
+            'model': os.environ.get('DEEPGRAM_MODEL', 'nova-2'),
+            'language': os.environ.get('DEEPGRAM_LANGUAGE'),
+        }
+
+    # ... rest of method ...
+```
+
+### Step 4: Add Auto-Detection (Optional)
+
+If you want auto-detection based on environment variables, add logic to `initialize_from_env()`:
+
+```python
+def initialize_from_env(self) -> BaseTranscriptionConnector:
+    # ... existing code ...
+
+    # Add before the default case:
+    elif os.environ.get('DEEPGRAM_API_KEY'):
+        connector_name = 'deepgram'
+        logger.info("Auto-detected Deepgram from DEEPGRAM_API_KEY")
+
+    # ... rest of method ...
+```
+
+## Usage
+
+### Manual Selection
+
+Explicitly select the connector in the `.env` file:
+
+```bash
+TRANSCRIPTION_CONNECTOR=deepgram
+DEEPGRAM_API_KEY=your-api-key
+DEEPGRAM_MODEL=nova-2
+```
+
+### Auto-Detection
+
+If you added auto-detection logic, just setting the API key is enough:
+
+```bash
+DEEPGRAM_API_KEY=your-api-key
+```
+
+## Best Practices
+
+### Error Handling
+
+Use the appropriate exception types:
+
+```python
+from ..exceptions import TranscriptionError, ConfigurationError, ProviderError
+
+# For configuration issues (missing API key, invalid settings)
+raise ConfigurationError("api_key is required")
+
+# For provider-specific errors (API errors, rate limits)
+raise ProviderError(
+    "Rate limit exceeded",
+    provider=self.PROVIDER_NAME,
+    status_code=429
+)
+
+# For general transcription failures
+raise TranscriptionError("Failed to process audio")
+```
+
+### Logging
+
+Use structured logging for debugging:
+
+```python
+import logging
+logger = logging.getLogger(__name__)
+
+logger.info(f"Sending request to {self.base_url}")
+logger.debug(f"Request params: {params}")
+logger.error(f"Transcription failed: {error}")
+```
+
+### Capability Declaration
+
+Only declare capabilities your connector actually supports:
+
+```python
+CAPABILITIES: Set[TranscriptionCapability] = {
+    TranscriptionCapability.DIARIZATION,      # If you support speaker labels
+    TranscriptionCapability.TIMESTAMPS,        # If you return timing info
+    TranscriptionCapability.LANGUAGE_DETECTION,# If you can detect language
+    TranscriptionCapability.SPEAKER_COUNT_CONTROL, # If you support min/max speakers
+}
+```
+
+### Specifications
+
+Accurately declare your provider's constraints:
+
+```python
+SPECIFICATIONS = ConnectorSpecifications(
+    max_file_size_bytes=100 * 1024 * 1024,  # Provider's file size limit
+    max_duration_seconds=14400,              # 4 hours max
+    handles_chunking_internally=True,        # Set True if provider handles large files
+    unsupported_codecs=frozenset({'opus'}),  # Codecs to convert before sending
+)
+```
+
+### Config Schema
+
+Provide a config schema for documentation and validation:
+
+```python
+@classmethod
+def get_config_schema(cls) -> Dict[str, Any]:
+    return {
+        "type": "object",
+        "required": ["api_key"],
+        "properties": {
+            "api_key": {
+                "type": "string",
+                "description": "Your API key"
+            },
+            # ... other properties
+        }
+    }
+```
+
+## Testing Your Connector
+
+Create a test file to verify your connector works:
+
+```python
+# tests/test_deepgram_connector.py
+
+import os
+import io
+import pytest
+from src.services.transcription.connectors.deepgram import DeepgramConnector
+from src.services.transcription.base import TranscriptionRequest
+
+@pytest.fixture
+def connector():
+    config = {
+        'api_key': os.environ.get('DEEPGRAM_API_KEY', 'test-key'),
+        'model': 'nova-2'
+    }
+    return DeepgramConnector(config)
+
+def test_config_validation():
+    with pytest.raises(ConfigurationError):
+        DeepgramConnector({})  # Missing api_key
+
+def test_capabilities(connector):
+    assert connector.supports_diarization
+    assert TranscriptionCapability.TIMESTAMPS in connector.CAPABILITIES
+
+def test_transcribe(connector):
+    # Load a test audio file
+    with open('tests/fixtures/test_audio.wav', 'rb') as f:
+        request = TranscriptionRequest(
+            audio_file=f,
+            filename='test.wav',
+            mime_type='audio/wav',
+            diarize=True
+        )
+        response = connector.transcribe(request)
+
+    assert response.text
+    assert response.provider == 'deepgram'
+```
+
+## Contributing
+
+If you create a connector for a popular provider, consider contributing it back to the project:
+
+1. Fork the repository
+2. Add your connector following this guide
+3. Add tests and documentation
+4. Submit a pull request
+
+Popular providers we'd love to see connectors for:
+
+- Deepgram
+- AssemblyAI
+- Google Cloud Speech-to-Text
+- Amazon Transcribe
+- ~~Azure Speech Services~~ → **Azure OpenAI connector now available (experimental, v0.8.6+)**
+- ~~Mistral Voxtral~~ → **Mistral connector now available**
+- ~~VibeVoice ASR~~ → **VibeVoice connector now available (self-hosted via vLLM)**
diff --git a/docs/advanced/job-queue-system.md b/docs/advanced/job-queue-system.md
new file mode 100644
index 00000000..440f9ac9
--- /dev/null
+++ b/docs/advanced/job-queue-system.md
@@ -0,0 +1,414 @@
+# Job Queue & Progress Tracking System
+
+This document describes the backend job queue system and frontend unified progress tracking implementation. This architecture handles audio processing jobs (transcription, summarization) with fair scheduling across users and provides real-time progress feedback.
+
+## Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           FRONTEND                                       │
+│  ┌─────────────────┐    ┌──────────────────┐    ┌───────────────────┐  │
+│  │  Upload Queue   │───▶│ Unified Progress │◀───│  Job Queue API    │  │
+│  │  (client-side)  │    │    Items         │    │  (polling)        │  │
+│  └─────────────────┘    └──────────────────┘    └───────────────────┘  │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           BACKEND                                        │
+│  ┌─────────────────┐    ┌──────────────────┐    ┌───────────────────┐  │
+│  │  Upload API     │───▶│ ProcessingJob    │◀───│  Job Queue        │  │
+│  │  /upload        │    │    Model         │    │  Service          │  │
+│  └─────────────────┘    └──────────────────┘    └───────────────────┘  │
+│                                │                         │              │
+│                                ▼                         ▼              │
+│                         ┌──────────────────┐    ┌───────────────────┐  │
+│                         │    SQLite DB     │    │  Worker Thread    │  │
+│                         │  processing_job  │    │  (background)     │  │
+│                         └──────────────────┘    └───────────────────┘  │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+## Backend Components
+
+### 1. ProcessingJob Model (`src/models/processing_job.py`)
+
+Database model for persistent job tracking:
+
+```python
+class ProcessingJob(db.Model):
+    __tablename__ = 'processing_job'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id'), nullable=False)
+
+    # Job type: transcribe, summarize, reprocess_transcription, reprocess_summary
+    job_type = db.Column(db.String(50), nullable=False)
+
+    # Status: queued, processing, completed, failed
+    status = db.Column(db.String(20), default='queued', nullable=False)
+
+    # JSON blob for job-specific parameters
+    params = db.Column(db.Text, nullable=True)
+
+    # Error tracking
+    error_message = db.Column(db.Text, nullable=True)
+    retry_count = db.Column(db.Integer, default=0, nullable=False)
+
+    # Track if this is a new upload (vs reprocessing) - for cleanup on failure
+    is_new_upload = db.Column(db.Boolean, default=False, nullable=False)
+
+    # Timestamps
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    started_at = db.Column(db.DateTime, nullable=True)
+    completed_at = db.Column(db.DateTime, nullable=True)
+```
+
+**Key Fields:**
+
+- `is_new_upload`: When `True` and job fails permanently, the associated recording and audio file are deleted. When `False` (reprocessing), only the recording status is set to FAILED.
+- `status`: Job lifecycle state
+- `retry_count`: Jobs retry up to 3 times before permanent failure
+
+### 2. Job Queue Service (`src/services/job_queue.py`)
+
+Background worker that processes jobs fairly across users.
+
+**Key Features:**
+
+#### Fair Scheduling (Round-Robin per User)
+```python
+def _claim_next_job(self, job_types, queue_name):
+    # Find the next user who has waiting jobs
+    # Round-robin through users to ensure fairness
+    users_with_jobs = db.session.query(ProcessingJob.user_id).filter(
+        ProcessingJob.status == 'queued',
+        ProcessingJob.job_type.in_(job_types)
+    ).distinct().all()
+
+    # Pick next user in rotation
+    user_id = self._get_next_user_in_rotation(users_with_jobs)
+
+    # Claim oldest job for that user
+    job = ProcessingJob.query.filter(
+        ProcessingJob.user_id == user_id,
+        ProcessingJob.status == 'queued'
+    ).order_by(ProcessingJob.created_at.asc()).first()
+```
+
+#### Race Condition Prevention
+SQLite doesn't support `FOR UPDATE SKIP LOCKED`, so we use an atomic UPDATE with a WHERE clause that checks the status is still 'queued'. This ensures only one worker can claim a job, even with multiple processes:
+
+```python
+def _claim_next_job(self, job_types, queue_name):
+    # Find candidate job
+    candidate_job = ProcessingJob.query.filter(
+        ProcessingJob.status == 'queued'
+    ).first()
+
+    if candidate_job:
+        # Atomic claim - only succeeds if status is still 'queued'
+        result = db.session.execute(
+            update(ProcessingJob)
+            .where(
+                ProcessingJob.id == candidate_job.id,
+                ProcessingJob.status == 'queued'  # Critical check
+            )
+            .values(status='processing', started_at=datetime.utcnow())
+        )
+
+        if result.rowcount == 0:
+            # Job was already claimed by another worker
+            return None
+
+        db.session.commit()
+        return candidate_job
+```
+
+This prevents the race condition where multiple workers could claim the same job when running as separate processes (fixed in v0.7.1).
+
+#### Session Management
+Jobs are claimed in one database session context, then processed in another to avoid detached object issues:
+
+```python
+def _process_job(self, job):
+    # Save job attributes before context ends
+    job_id = job.id
+    job_type = job.job_type
+    recording_id = job.recording_id
+    is_new_upload = job.is_new_upload
+
+    with self._app_context():
+        # Re-fetch job in new session
+        job = db.session.get(ProcessingJob, job_id)
+        # ... process job
+```
+
+#### Failed Upload Cleanup
+When a new upload fails permanently:
+
+```python
+if is_new_upload and recording:
+    # Delete audio file
+    if recording.audio_path and os.path.exists(recording.audio_path):
+        os.remove(recording.audio_path)
+    # Delete all processing jobs for this recording
+    ProcessingJob.query.filter_by(recording_id=recording_id).delete()
+    # Delete the recording
+    db.session.delete(recording)
+```
+
+### 3. Job Queue API (`src/api/recordings.py`)
+
+#### Get Job Queue Status
+`GET /api/recordings/job-queue-status`
+
+Returns all jobs for the current user (active + completed/failed from last hour):
+
+```json
+{
+  "jobs": [
+    {
+      "id": 123,
+      "recording_id": 456,
+      "recording_title": "Meeting Notes",
+      "job_status": "processing",
+      "job_type": "transcribe",
+      "queue_type": "transcription",
+      "position": null,
+      "is_new_upload": true,
+      "error_message": null,
+      "created_at": "2025-11-27T01:00:00",
+      "started_at": "2025-11-27T01:00:05",
+      "completed_at": null
+    }
+  ]
+}
+```
+
+**Queue Types:**
+
+- `transcription`: transcribe, reprocess_transcription
+- `summary`: summarize, reprocess_summary
+
+#### Retry Failed Job
+`POST /api/recordings/jobs/<id>/retry`
+
+Resets job status to `queued` for another attempt.
+
+#### Delete Job
+`DELETE /api/recordings/jobs/<id>`
+
+Deletes a job. If it's a failed new upload, also deletes the recording and audio file.
+
+#### Clear Completed Jobs
+`POST /api/recordings/jobs/clear-completed`
+
+Removes all completed jobs for the current user.
+
+### 4. Recording Deletion Cascade
+
+When deleting a recording, associated processing jobs must be deleted first due to the NOT NULL constraint on `recording_id`:
+
+```python
+# In delete_recording(), delete_job(), job_queue._process_job(), retention.py
+ProcessingJob.query.filter_by(recording_id=recording_id).delete()
+db.session.delete(recording)
+```
+
+## Frontend Components
+
+### 1. Unified Progress Tracking System (`static/js/app.modular.js`)
+
+The frontend merges multiple data sources into a single unified list to prevent duplicate entries.
+
+#### Data Sources
+1. **Backend Jobs** (`allJobs`) - Polled from `/api/recordings/job-queue-status`
+2. **Upload Queue** (`uploadQueue`) - Client-side tracking of uploads
+3. **Global Progress Refs** - `currentlyProcessingFile`, `processingProgress`, `processingMessage`
+
+#### Unified Progress Items
+```javascript
+const unifiedProgressItems = computed(() => {
+    const items = new Map(); // Key by recordingId or clientId
+
+    // 1. Add backend jobs (most accurate status)
+    for (const job of allJobs.value) {
+        const key = `rec_${job.recording_id}`;
+        items.set(key, {
+            id: key,
+            recordingId: job.recording_id,
+            jobId: job.id,
+            title: job.recording_title,
+            status: mapJobStatus(job),
+            progress: getProgress(job),
+            progressMessage: getMessage(job),
+            // ...
+        });
+    }
+
+    // 2. Add/merge upload queue items
+    for (const upload of uploadQueue.value) {
+        // If recordingId exists and matches a job, merge
+        // Otherwise create new entry
+        // Use global progress refs for currently uploading file
+    }
+
+    // Sort by status priority
+    return Array.from(items.values()).sort(byStatusPriority);
+});
+```
+
+#### Unified Status States
+| Status | Description | Icon | Color |
+|--------|-------------|------|-------|
+| `uploading` | File uploading to server | cloud-upload-alt | blue |
+| `transcribing` | Server transcribing audio | microphone-alt | purple |
+| `summarizing` | Server generating summary | file-alt | green |
+| `queued` | Waiting in server queue | clock | yellow |
+| `ready` | Waiting to upload | clock | gray |
+| `completed` | Processing finished | check-circle | green |
+| `failed` | Server processing failed | exclamation-circle | red |
+| `upload_failed` | Upload failed | exclamation-circle | red |
+
+#### Filtered Views
+```javascript
+const activeProgressItems = computed(() =>
+    unifiedProgressItems.value.filter(item =>
+        ['uploading', 'transcribing', 'summarizing', 'queued', 'ready'].includes(item.status)
+    )
+);
+
+const completedProgressItems = computed(() =>
+    unifiedProgressItems.value.filter(item => item.status === 'completed')
+);
+
+const failedProgressItems = computed(() =>
+    unifiedProgressItems.value.filter(item =>
+        ['failed', 'upload_failed'].includes(item.status)
+    )
+);
+```
+
+#### Key Deduplication Logic
+- Items keyed by `rec_${recordingId}` when recordingId is known
+- Items keyed by `client_${clientId}` for uploads without recordingId yet
+- When upload completes and gets recordingId, it merges with any existing job entry
+- Backend job data takes precedence for status (more accurate)
+- Upload progress refs used for live progress during upload phase
+
+### 2. Progress Popup Template (`templates/components/progress-popup.html`)
+
+Displays unified progress items in a single list:
+
+```html
+<!-- Active Items -->
+<div v-for="item in activeProgressItems" :key="item.id">
+    <i :class="getStatusDisplay(item.status).icon"></i>
+    <span>${item.title}</span>
+    <div v-if="item.status === 'uploading'" class="progress-bar">
+        <div :style="{width: item.progress + '%'}"></div>
+    </div>
+    <p>${item.progressMessage}</p>
+</div>
+
+<!-- Failed Items (with retry/delete buttons) -->
+<div v-for="item in failedProgressItems" :key="item.id">
+    <span>${item.title}</span>
+    <span v-if="item.errorMessage">${item.errorMessage}</span>
+    <button @click="retryProgressItem(item)">Retry</button>
+    <button @click="removeProgressItem(item)">Delete</button>
+</div>
+
+<!-- Completed Items -->
+<div v-for="item in completedProgressItems" :key="item.id">
+    <span>${item.title}</span>
+    <span>Done</span>
+</div>
+```
+
+## Job Lifecycle Flow
+
+### New Upload Flow
+```
+1. User drops file
+   └─▶ uploadQueue.push({status: 'queued', clientId: 'client-xxx'})
+
+2. User clicks Upload
+   └─▶ item.status = 'ready'
+
+3. Upload starts
+   └─▶ item.status = 'uploading'
+   └─▶ processingProgress updates (10%, 20%, ...)
+
+4. Upload completes (HTTP 202)
+   └─▶ item.recordingId = response.id
+   └─▶ item.status = 'pending'
+   └─▶ Recording created in DB with status='PENDING'
+   └─▶ ProcessingJob created with status='queued', is_new_upload=true
+
+5. Job Queue Worker claims job
+   └─▶ job.status = 'processing'
+   └─▶ Recording.status = 'PROCESSING'
+
+6. Transcription completes
+   └─▶ job.status = 'completed' (if no auto-summary)
+   └─▶ OR Recording.status = 'SUMMARIZING' (if auto-summary)
+
+7. Summary completes (if applicable)
+   └─▶ Summary job.status = 'completed'
+   └─▶ Recording.status = 'COMPLETED'
+```
+
+### Reprocessing Flow
+```
+1. User clicks Reprocess
+   └─▶ ProcessingJob created with is_new_upload=false
+
+2. Job Queue Worker processes
+   └─▶ On failure: Recording.status = 'FAILED' (recording NOT deleted)
+
+3. User can retry or manually fix
+```
+
+## Database Migrations
+
+The `is_new_upload` column was added via auto-migration in `src/init_db.py`:
+
+```python
+if add_column_if_not_exists(engine, 'processing_job', 'is_new_upload', 'BOOLEAN DEFAULT 0'):
+    app.logger.info("Added is_new_upload column to processing_job table")
+```
+
+## Error Handling
+
+### Upload Failures
+- Stored in IndexedDB for background sync retry
+- Shown in progress popup with retry button
+
+### Processing Failures
+- `is_new_upload=true`: Recording and audio file deleted
+- `is_new_upload=false`: Recording marked as FAILED, can be retried
+
+### Race Conditions
+- Atomic UPDATE with WHERE clause prevents multiple workers claiming same job (v0.7.1+)
+- SQLite WAL mode enabled for better concurrency
+
+## API Endpoints Summary
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/recordings/job-queue-status` | GET | Get all jobs for current user |
+| `/api/recordings/jobs/<id>/retry` | POST | Retry a failed job |
+| `/api/recordings/jobs/<id>` | DELETE | Delete a job (and recording if failed new upload) |
+| `/api/recordings/jobs/clear-completed` | POST | Clear all completed jobs |
+
+## Future Improvements
+
+1. **WebSocket Support**: Replace polling with WebSocket for real-time updates
+2. **Job Priority**: Add priority levels for urgent jobs
+3. **Batch Operations**: Support batch retry/delete operations
+4. **Progress Estimation**: More accurate progress based on file size/duration
+5. **Distributed Workers**: Support for multiple worker processes/servers
+6. **Job Cancellation**: Allow canceling in-progress jobs
diff --git a/docs/assets/css/style.scss b/docs/assets/css/style.scss
new file mode 100644
index 00000000..00be0b30
--- /dev/null
+++ b/docs/assets/css/style.scss
@@ -0,0 +1,347 @@
+---
+---
+
+@import "{{ site.theme }}";
+
+// Custom colors
+:root {
+  --primary-color: #6366f1;
+  --secondary-color: #8b5cf6;
+  --accent-color: #ec4899;
+  --success-color: #10b981;
+  --warning-color: #f59e0b;
+  --danger-color: #ef4444;
+  --dark-bg: #1f2937;
+  --light-bg: #f9fafb;
+}
+
+// Override theme colors
+.page-header {
+  background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
+  padding: 3rem 1rem;
+}
+
+.site-footer {
+  background: var(--dark-bg);
+  color: #e5e7eb;
+  padding: 2rem 1rem;
+  margin-top: 3rem;
+}
+
+// Logo in header
+.project-logo {
+  width: 60px;
+  height: 60px;
+  margin-bottom: 1rem;
+  border-radius: 12px;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+}
+
+.project-name {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+}
+
+// Navigation cards
+.grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.5rem;
+  margin: 2rem 0;
+}
+
+.card {
+  background: white;
+  border: 1px solid #e5e7eb;
+  border-radius: 12px;
+  padding: 1.5rem;
+  transition: all 0.3s ease;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+}
+
+.card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.15);
+  border-color: var(--primary-color);
+}
+
+.card h3 {
+  color: var(--primary-color);
+  margin-top: 0;
+  margin-bottom: 0.5rem;
+  font-size: 1.25rem;
+}
+
+.card p {
+  color: #6b7280;
+  margin-bottom: 1rem;
+  line-height: 1.6;
+}
+
+.card .btn {
+  display: inline-block;
+  background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
+  color: white;
+  padding: 0.5rem 1.25rem;
+  border-radius: 8px;
+  text-decoration: none;
+  font-weight: 500;
+  transition: opacity 0.3s ease;
+}
+
+.card .btn:hover {
+  opacity: 0.9;
+}
+
+// Feature badges
+.badge {
+  display: inline-block;
+  padding: 0.25rem 0.75rem;
+  border-radius: 9999px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  margin: 0 0.25rem;
+}
+
+.badge-new {
+  background: var(--success-color);
+  color: white;
+}
+
+.badge-beta {
+  background: var(--warning-color);
+  color: white;
+}
+
+// Screenshots
+img[src*="screenshots"] {
+  border: 1px solid #e5e7eb;
+  border-radius: 12px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+  margin: 1.5rem 0;
+  max-width: 100%;
+  height: auto;
+}
+
+// Code blocks
+pre {
+  background: #1f2937;
+  color: #e5e7eb;
+  border-radius: 8px;
+  padding: 1rem;
+  overflow-x: auto;
+  margin: 1rem 0;
+  border: 1px solid #374151;
+}
+
+code {
+  background: #f3f4f6;
+  padding: 0.125rem 0.375rem;
+  border-radius: 4px;
+  font-size: 0.875em;
+  color: var(--primary-color);
+}
+
+pre code {
+  background: none;
+  padding: 0;
+  color: inherit;
+}
+
+// Tables
+table {
+  width: 100%;
+  border-collapse: separate;
+  border-spacing: 0;
+  border: 1px solid #e5e7eb;
+  border-radius: 8px;
+  overflow: hidden;
+  margin: 1.5rem 0;
+}
+
+th {
+  background: var(--light-bg);
+  padding: 0.75rem;
+  text-align: left;
+  font-weight: 600;
+  color: #374151;
+  border-bottom: 2px solid #e5e7eb;
+}
+
+td {
+  padding: 0.75rem;
+  border-bottom: 1px solid #e5e7eb;
+}
+
+tr:last-child td {
+  border-bottom: none;
+}
+
+tr:hover {
+  background: #f9fafb;
+}
+
+// Alerts and callouts
+.note, .warning, .tip {
+  padding: 1rem 1.25rem;
+  border-radius: 8px;
+  margin: 1.5rem 0;
+  border-left: 4px solid;
+}
+
+.note {
+  background: #eff6ff;
+  border-color: var(--primary-color);
+  color: #1e40af;
+}
+
+.warning {
+  background: #fef3c7;
+  border-color: var(--warning-color);
+  color: #92400e;
+}
+
+.tip {
+  background: #d1fae5;
+  border-color: var(--success-color);
+  color: #065f46;
+}
+
+// Sidebar navigation
+.sidebar {
+  background: white;
+  border-radius: 12px;
+  padding: 1.5rem;
+  border: 1px solid #e5e7eb;
+  margin-bottom: 2rem;
+}
+
+.sidebar h3 {
+  color: var(--primary-color);
+  margin-top: 0;
+  margin-bottom: 1rem;
+  font-size: 1.125rem;
+}
+
+.sidebar ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.sidebar li {
+  margin-bottom: 0.5rem;
+}
+
+.sidebar a {
+  color: #6b7280;
+  text-decoration: none;
+  display: block;
+  padding: 0.5rem 0.75rem;
+  border-radius: 6px;
+  transition: all 0.2s ease;
+}
+
+.sidebar a:hover {
+  background: var(--light-bg);
+  color: var(--primary-color);
+}
+
+.sidebar a.active {
+  background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
+  color: white;
+}
+
+// Feature list
+.feature-list {
+  list-style: none;
+  padding: 0;
+}
+
+.feature-list li {
+  padding: 0.75rem 0;
+  border-bottom: 1px solid #e5e7eb;
+  display: flex;
+  align-items: flex-start;
+}
+
+.feature-list li:last-child {
+  border-bottom: none;
+}
+
+.feature-list li:before {
+  content: "✓";
+  color: var(--success-color);
+  font-weight: bold;
+  margin-right: 0.75rem;
+  font-size: 1.25rem;
+}
+
+// Responsive design
+@media (max-width: 768px) {
+  .grid {
+    grid-template-columns: 1fr;
+  }
+  
+  .page-header {
+    padding: 2rem 1rem;
+  }
+  
+  .project-name {
+    font-size: 1.75rem;
+  }
+}
+
+// Smooth scrolling
+html {
+  scroll-behavior: smooth;
+}
+
+// Better typography
+.main-content {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+  line-height: 1.7;
+  color: #374151;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  font-weight: 600;
+  line-height: 1.3;
+  margin-top: 2rem;
+  margin-bottom: 1rem;
+}
+
+h1 {
+  font-size: 2.5rem;
+  color: var(--primary-color);
+}
+
+h2 {
+  font-size: 2rem;
+  color: #1f2937;
+  border-bottom: 2px solid #e5e7eb;
+  padding-bottom: 0.5rem;
+}
+
+h3 {
+  font-size: 1.5rem;
+  color: #374151;
+}
+
+// Animations
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.main-content > * {
+  animation: fadeIn 0.5s ease-out;
+}
\ No newline at end of file
diff --git a/docs/assets/images/logo.png b/docs/assets/images/logo.png
new file mode 100644
index 00000000..7def29e9
Binary files /dev/null and b/docs/assets/images/logo.png differ
diff --git a/docs/assets/images/main2.png b/docs/assets/images/main2.png
new file mode 100644
index 00000000..5b863a2a
Binary files /dev/null and b/docs/assets/images/main2.png differ
diff --git a/docs/assets/images/screenshots/Admin dashboard.png b/docs/assets/images/screenshots/Admin dashboard.png
new file mode 100644
index 00000000..160a8d4e
Binary files /dev/null and b/docs/assets/images/screenshots/Admin dashboard.png differ
diff --git a/docs/assets/images/screenshots/Admin default prompts.png b/docs/assets/images/screenshots/Admin default prompts.png
new file mode 100644
index 00000000..79163599
Binary files /dev/null and b/docs/assets/images/screenshots/Admin default prompts.png differ
diff --git a/docs/assets/images/screenshots/Admin stats.png b/docs/assets/images/screenshots/Admin stats.png
new file mode 100644
index 00000000..2e36df2a
Binary files /dev/null and b/docs/assets/images/screenshots/Admin stats.png differ
diff --git a/docs/assets/images/screenshots/Admin system settings.png b/docs/assets/images/screenshots/Admin system settings.png
new file mode 100644
index 00000000..ce3a15c6
Binary files /dev/null and b/docs/assets/images/screenshots/Admin system settings.png differ
diff --git a/docs/assets/images/screenshots/Admin vector store.png b/docs/assets/images/screenshots/Admin vector store.png
new file mode 100644
index 00000000..f8fcef66
Binary files /dev/null and b/docs/assets/images/screenshots/Admin vector store.png differ
diff --git a/docs/assets/images/screenshots/Filters.png b/docs/assets/images/screenshots/Filters.png
new file mode 100644
index 00000000..cc5fa2c8
Binary files /dev/null and b/docs/assets/images/screenshots/Filters.png differ
diff --git a/docs/assets/images/screenshots/Inquire mode.png b/docs/assets/images/screenshots/Inquire mode.png
new file mode 100644
index 00000000..508fed8c
Binary files /dev/null and b/docs/assets/images/screenshots/Inquire mode.png differ
diff --git a/docs/assets/images/screenshots/Main view.png b/docs/assets/images/screenshots/Main view.png
new file mode 100644
index 00000000..3eaadba6
Binary files /dev/null and b/docs/assets/images/screenshots/Main view.png differ
diff --git a/docs/assets/images/screenshots/Multilingual.png b/docs/assets/images/screenshots/Multilingual.png
new file mode 100644
index 00000000..15212e06
Binary files /dev/null and b/docs/assets/images/screenshots/Multilingual.png differ
diff --git a/docs/assets/images/screenshots/Record mic or system audio (for online meetings) and take markdown notes.png b/docs/assets/images/screenshots/Record mic or system audio (for online meetings) and take markdown notes.png
new file mode 100644
index 00000000..1b72b549
Binary files /dev/null and b/docs/assets/images/screenshots/Record mic or system audio (for online meetings) and take markdown notes.png differ
diff --git a/docs/assets/images/screenshots/Recording interface.png b/docs/assets/images/screenshots/Recording interface.png
new file mode 100644
index 00000000..09bd9116
Binary files /dev/null and b/docs/assets/images/screenshots/Recording interface.png differ
diff --git a/docs/assets/images/screenshots/Share link.png b/docs/assets/images/screenshots/Share link.png
new file mode 100644
index 00000000..536c0d0f
Binary files /dev/null and b/docs/assets/images/screenshots/Share link.png differ
diff --git a/docs/assets/images/screenshots/Share modal.png b/docs/assets/images/screenshots/Share modal.png
new file mode 100644
index 00000000..b5e65c7f
Binary files /dev/null and b/docs/assets/images/screenshots/Share modal.png differ
diff --git a/docs/assets/images/screenshots/Summary View.png b/docs/assets/images/screenshots/Summary View.png
new file mode 100644
index 00000000..c19fb6ca
Binary files /dev/null and b/docs/assets/images/screenshots/Summary View.png differ
diff --git a/docs/assets/images/screenshots/admin-edit-group-modal.png b/docs/assets/images/screenshots/admin-edit-group-modal.png
new file mode 100644
index 00000000..bf4eb143
Binary files /dev/null and b/docs/assets/images/screenshots/admin-edit-group-modal.png differ
diff --git a/docs/assets/images/screenshots/admin-manage-group-modal.png b/docs/assets/images/screenshots/admin-manage-group-modal.png
new file mode 100644
index 00000000..44e39947
Binary files /dev/null and b/docs/assets/images/screenshots/admin-manage-group-modal.png differ
diff --git a/docs/assets/images/screenshots/admin-manage-group-tags.png b/docs/assets/images/screenshots/admin-manage-group-tags.png
new file mode 100644
index 00000000..e905637b
Binary files /dev/null and b/docs/assets/images/screenshots/admin-manage-group-tags.png differ
diff --git a/docs/assets/images/screenshots/admin-user-create-token-budget.png b/docs/assets/images/screenshots/admin-user-create-token-budget.png
new file mode 100644
index 00000000..01d64d84
Binary files /dev/null and b/docs/assets/images/screenshots/admin-user-create-token-budget.png differ
diff --git a/docs/assets/images/screenshots/admin-user-groups.png b/docs/assets/images/screenshots/admin-user-groups.png
new file mode 100644
index 00000000..9d0546e0
Binary files /dev/null and b/docs/assets/images/screenshots/admin-user-groups.png differ
diff --git a/docs/assets/images/screenshots/after recording, finalize tags and settings and notes before uploading or discard.png b/docs/assets/images/screenshots/after recording, finalize tags and settings and notes before uploading or discard.png
new file mode 100644
index 00000000..3bf32799
Binary files /dev/null and b/docs/assets/images/screenshots/after recording, finalize tags and settings and notes before uploading or discard.png differ
diff --git a/docs/assets/images/screenshots/api-swagger-ui.png b/docs/assets/images/screenshots/api-swagger-ui.png
new file mode 100644
index 00000000..d4a76331
Binary files /dev/null and b/docs/assets/images/screenshots/api-swagger-ui.png differ
diff --git a/docs/assets/images/screenshots/archived-recording.png b/docs/assets/images/screenshots/archived-recording.png
new file mode 100644
index 00000000..bf318ddd
Binary files /dev/null and b/docs/assets/images/screenshots/archived-recording.png differ
diff --git a/docs/assets/images/screenshots/audio-sync-bubble-view.png b/docs/assets/images/screenshots/audio-sync-bubble-view.png
new file mode 100644
index 00000000..e9f3f393
Binary files /dev/null and b/docs/assets/images/screenshots/audio-sync-bubble-view.png differ
diff --git a/docs/assets/images/screenshots/audio-sync-simple-view.png b/docs/assets/images/screenshots/audio-sync-simple-view.png
new file mode 100644
index 00000000..30aa97d9
Binary files /dev/null and b/docs/assets/images/screenshots/audio-sync-simple-view.png differ
diff --git a/docs/assets/images/screenshots/chat view with question.png b/docs/assets/images/screenshots/chat view with question.png
new file mode 100644
index 00000000..748248db
Binary files /dev/null and b/docs/assets/images/screenshots/chat view with question.png differ
diff --git a/docs/assets/images/screenshots/chat-chinese.png b/docs/assets/images/screenshots/chat-chinese.png
new file mode 100644
index 00000000..fc1d5af9
Binary files /dev/null and b/docs/assets/images/screenshots/chat-chinese.png differ
diff --git a/docs/assets/images/screenshots/chat-interface.png b/docs/assets/images/screenshots/chat-interface.png
new file mode 100644
index 00000000..885e07d5
Binary files /dev/null and b/docs/assets/images/screenshots/chat-interface.png differ
diff --git a/docs/assets/images/screenshots/edit recording modal.png b/docs/assets/images/screenshots/edit recording modal.png
new file mode 100644
index 00000000..85bf7367
Binary files /dev/null and b/docs/assets/images/screenshots/edit recording modal.png differ
diff --git a/docs/assets/images/screenshots/edit recording tags modal.png b/docs/assets/images/screenshots/edit recording tags modal.png
new file mode 100644
index 00000000..9d22da61
Binary files /dev/null and b/docs/assets/images/screenshots/edit recording tags modal.png differ
diff --git a/docs/assets/images/screenshots/edit transcript with ASR.png b/docs/assets/images/screenshots/edit transcript with ASR.png
new file mode 100644
index 00000000..37cccf90
Binary files /dev/null and b/docs/assets/images/screenshots/edit transcript with ASR.png differ
diff --git a/docs/assets/images/screenshots/edit-tags.png b/docs/assets/images/screenshots/edit-tags.png
new file mode 100644
index 00000000..b3670b36
Binary files /dev/null and b/docs/assets/images/screenshots/edit-tags.png differ
diff --git a/docs/assets/images/screenshots/edit-transcription-modal.png b/docs/assets/images/screenshots/edit-transcription-modal.png
new file mode 100644
index 00000000..4ba15f82
Binary files /dev/null and b/docs/assets/images/screenshots/edit-transcription-modal.png differ
diff --git a/docs/assets/images/screenshots/event extraction.png b/docs/assets/images/screenshots/event extraction.png
new file mode 100644
index 00000000..1f87f6ac
Binary files /dev/null and b/docs/assets/images/screenshots/event extraction.png differ
diff --git a/docs/assets/images/screenshots/filters-sidebar-expanded.png b/docs/assets/images/screenshots/filters-sidebar-expanded.png
new file mode 100644
index 00000000..99c0c99e
Binary files /dev/null and b/docs/assets/images/screenshots/filters-sidebar-expanded.png differ
diff --git a/docs/assets/images/screenshots/follow-mode-auto-scroll.png b/docs/assets/images/screenshots/follow-mode-auto-scroll.png
new file mode 100644
index 00000000..03c739f0
Binary files /dev/null and b/docs/assets/images/screenshots/follow-mode-auto-scroll.png differ
diff --git a/docs/assets/images/screenshots/full recording reprocessing.png b/docs/assets/images/screenshots/full recording reprocessing.png
new file mode 100644
index 00000000..42f94a61
Binary files /dev/null and b/docs/assets/images/screenshots/full recording reprocessing.png differ
diff --git a/docs/assets/images/screenshots/highlighted-transcript-following-simple-dark.png b/docs/assets/images/screenshots/highlighted-transcript-following-simple-dark.png
new file mode 100644
index 00000000..e7b9e787
Binary files /dev/null and b/docs/assets/images/screenshots/highlighted-transcript-following-simple-dark.png differ
diff --git a/docs/assets/images/screenshots/highlighted-transcript-following-simple-light.png b/docs/assets/images/screenshots/highlighted-transcript-following-simple-light.png
new file mode 100644
index 00000000..56aa2ff0
Binary files /dev/null and b/docs/assets/images/screenshots/highlighted-transcript-following-simple-light.png differ
diff --git a/docs/assets/images/screenshots/identify-speakers-modal.png b/docs/assets/images/screenshots/identify-speakers-modal.png
new file mode 100644
index 00000000..bb982d9f
Binary files /dev/null and b/docs/assets/images/screenshots/identify-speakers-modal.png differ
diff --git a/docs/assets/images/screenshots/iinquire mode contextual searches.png b/docs/assets/images/screenshots/iinquire mode contextual searches.png
new file mode 100644
index 00000000..4e5ba34f
Binary files /dev/null and b/docs/assets/images/screenshots/iinquire mode contextual searches.png differ
diff --git a/docs/assets/images/screenshots/inquire mode 2.png b/docs/assets/images/screenshots/inquire mode 2.png
new file mode 100644
index 00000000..933413e6
Binary files /dev/null and b/docs/assets/images/screenshots/inquire mode 2.png differ
diff --git a/docs/assets/images/screenshots/inquire-dark-mode.png b/docs/assets/images/screenshots/inquire-dark-mode.png
new file mode 100644
index 00000000..45d2b2a9
Binary files /dev/null and b/docs/assets/images/screenshots/inquire-dark-mode.png differ
diff --git a/docs/assets/images/screenshots/live recording view with notes.png b/docs/assets/images/screenshots/live recording view with notes.png
new file mode 100644
index 00000000..48a6438c
Binary files /dev/null and b/docs/assets/images/screenshots/live recording view with notes.png differ
diff --git a/docs/assets/images/screenshots/main view no diarization.png b/docs/assets/images/screenshots/main view no diarization.png
new file mode 100644
index 00000000..1723ef6a
Binary files /dev/null and b/docs/assets/images/screenshots/main view no diarization.png differ
diff --git a/docs/assets/images/screenshots/main-view-notes-tab.png b/docs/assets/images/screenshots/main-view-notes-tab.png
new file mode 100644
index 00000000..80297d4d
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-notes-tab.png differ
diff --git a/docs/assets/images/screenshots/main-view-recipe-example.png b/docs/assets/images/screenshots/main-view-recipe-example.png
new file mode 100644
index 00000000..23cb3c77
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-recipe-example.png differ
diff --git a/docs/assets/images/screenshots/main-view-summary-tab.png b/docs/assets/images/screenshots/main-view-summary-tab.png
new file mode 100644
index 00000000..204281b0
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-summary-tab.png differ
diff --git a/docs/assets/images/screenshots/main-view-token-usage.png b/docs/assets/images/screenshots/main-view-token-usage.png
new file mode 100644
index 00000000..b99957c0
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-token-usage.png differ
diff --git a/docs/assets/images/screenshots/main-view-upload-token-usage.png b/docs/assets/images/screenshots/main-view-upload-token-usage.png
new file mode 100644
index 00000000..6c3d1bf7
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-upload-token-usage.png differ
diff --git a/docs/assets/images/screenshots/main-view-with-speakers.png b/docs/assets/images/screenshots/main-view-with-speakers.png
new file mode 100644
index 00000000..7454f3e2
Binary files /dev/null and b/docs/assets/images/screenshots/main-view-with-speakers.png differ
diff --git a/docs/assets/images/screenshots/markdown-editor-fullscreen.png b/docs/assets/images/screenshots/markdown-editor-fullscreen.png
new file mode 100644
index 00000000..911a5a5d
Binary files /dev/null and b/docs/assets/images/screenshots/markdown-editor-fullscreen.png differ
diff --git a/docs/assets/images/screenshots/markdown-editor.png b/docs/assets/images/screenshots/markdown-editor.png
new file mode 100644
index 00000000..585e161c
Binary files /dev/null and b/docs/assets/images/screenshots/markdown-editor.png differ
diff --git a/docs/assets/images/screenshots/multilingual-chinese.png b/docs/assets/images/screenshots/multilingual-chinese.png
new file mode 100644
index 00000000..6fcc6dbb
Binary files /dev/null and b/docs/assets/images/screenshots/multilingual-chinese.png differ
diff --git a/docs/assets/images/screenshots/new recording view.png b/docs/assets/images/screenshots/new recording view.png
new file mode 100644
index 00000000..13b9565a
Binary files /dev/null and b/docs/assets/images/screenshots/new recording view.png differ
diff --git a/docs/assets/images/screenshots/notes tab.png b/docs/assets/images/screenshots/notes tab.png
new file mode 100644
index 00000000..b4f5ae0c
Binary files /dev/null and b/docs/assets/images/screenshots/notes tab.png differ
diff --git a/docs/assets/images/screenshots/processing-tooltip.png b/docs/assets/images/screenshots/processing-tooltip.png
new file mode 100644
index 00000000..9b76f87e
Binary files /dev/null and b/docs/assets/images/screenshots/processing-tooltip.png differ
diff --git a/docs/assets/images/screenshots/record from screen.png b/docs/assets/images/screenshots/record from screen.png
new file mode 100644
index 00000000..57ec65b8
Binary files /dev/null and b/docs/assets/images/screenshots/record from screen.png differ
diff --git a/docs/assets/images/screenshots/record from tab.png b/docs/assets/images/screenshots/record from tab.png
new file mode 100644
index 00000000..a3beb1c9
Binary files /dev/null and b/docs/assets/images/screenshots/record from tab.png differ
diff --git a/docs/assets/images/screenshots/recording view with simple transcription view and chat visible.png b/docs/assets/images/screenshots/recording view with simple transcription view and chat visible.png
new file mode 100644
index 00000000..9ed3b395
Binary files /dev/null and b/docs/assets/images/screenshots/recording view with simple transcription view and chat visible.png differ
diff --git a/docs/assets/images/screenshots/recording-dual-source.png b/docs/assets/images/screenshots/recording-dual-source.png
new file mode 100644
index 00000000..2f15b343
Binary files /dev/null and b/docs/assets/images/screenshots/recording-dual-source.png differ
diff --git a/docs/assets/images/screenshots/recording-single-source.png b/docs/assets/images/screenshots/recording-single-source.png
new file mode 100644
index 00000000..ed7b2679
Binary files /dev/null and b/docs/assets/images/screenshots/recording-single-source.png differ
diff --git a/docs/assets/images/screenshots/recording-upload-modal.png b/docs/assets/images/screenshots/recording-upload-modal.png
new file mode 100644
index 00000000..3872cb95
Binary files /dev/null and b/docs/assets/images/screenshots/recording-upload-modal.png differ
diff --git a/docs/assets/images/screenshots/settings Tags that allow custom prompts stackable and custom asr settings.png b/docs/assets/images/screenshots/settings Tags that allow custom prompts stackable and custom asr settings.png
new file mode 100644
index 00000000..c13e8ec1
Binary files /dev/null and b/docs/assets/images/screenshots/settings Tags that allow custom prompts stackable and custom asr settings.png differ
diff --git a/docs/assets/images/screenshots/settings about page.png b/docs/assets/images/screenshots/settings about page.png
new file mode 100644
index 00000000..df9fc0b2
Binary files /dev/null and b/docs/assets/images/screenshots/settings about page.png differ
diff --git a/docs/assets/images/screenshots/settings account info.png b/docs/assets/images/screenshots/settings account info.png
new file mode 100644
index 00000000..7c665a4b
Binary files /dev/null and b/docs/assets/images/screenshots/settings account info.png differ
diff --git a/docs/assets/images/screenshots/settings custom prompts.png b/docs/assets/images/screenshots/settings custom prompts.png
new file mode 100644
index 00000000..1b6c8d12
Binary files /dev/null and b/docs/assets/images/screenshots/settings custom prompts.png differ
diff --git a/docs/assets/images/screenshots/settings shared transcripts.png b/docs/assets/images/screenshots/settings shared transcripts.png
new file mode 100644
index 00000000..f55a09b5
Binary files /dev/null and b/docs/assets/images/screenshots/settings shared transcripts.png differ
diff --git a/docs/assets/images/screenshots/settings speakr management.png b/docs/assets/images/screenshots/settings speakr management.png
new file mode 100644
index 00000000..d447369f
Binary files /dev/null and b/docs/assets/images/screenshots/settings speakr management.png differ
diff --git a/docs/assets/images/screenshots/settings-create-tag-modal.png b/docs/assets/images/screenshots/settings-create-tag-modal.png
new file mode 100644
index 00000000..448b0be2
Binary files /dev/null and b/docs/assets/images/screenshots/settings-create-tag-modal.png differ
diff --git a/docs/assets/images/screenshots/share recording modal.png b/docs/assets/images/screenshots/share recording modal.png
new file mode 100644
index 00000000..bd075daf
Binary files /dev/null and b/docs/assets/images/screenshots/share recording modal.png differ
diff --git a/docs/assets/images/screenshots/share recording.png b/docs/assets/images/screenshots/share recording.png
new file mode 100644
index 00000000..00b3a3ec
Binary files /dev/null and b/docs/assets/images/screenshots/share recording.png differ
diff --git a/docs/assets/images/screenshots/share-notes-view.png b/docs/assets/images/screenshots/share-notes-view.png
new file mode 100644
index 00000000..bb3ec394
Binary files /dev/null and b/docs/assets/images/screenshots/share-notes-view.png differ
diff --git a/docs/assets/images/screenshots/share-summary-view.png b/docs/assets/images/screenshots/share-summary-view.png
new file mode 100644
index 00000000..db78e42a
Binary files /dev/null and b/docs/assets/images/screenshots/share-summary-view.png differ
diff --git a/docs/assets/images/screenshots/share-translated.png b/docs/assets/images/screenshots/share-translated.png
new file mode 100644
index 00000000..3bc38d6a
Binary files /dev/null and b/docs/assets/images/screenshots/share-translated.png differ
diff --git a/docs/assets/images/screenshots/shared recording.png b/docs/assets/images/screenshots/shared recording.png
new file mode 100644
index 00000000..81d81fc5
Binary files /dev/null and b/docs/assets/images/screenshots/shared recording.png differ
diff --git a/docs/assets/images/screenshots/shared transcript modal.png b/docs/assets/images/screenshots/shared transcript modal.png
new file mode 100644
index 00000000..9340b618
Binary files /dev/null and b/docs/assets/images/screenshots/shared transcript modal.png differ
diff --git a/docs/assets/images/screenshots/speaker id modal.png b/docs/assets/images/screenshots/speaker id modal.png
new file mode 100644
index 00000000..1345e587
Binary files /dev/null and b/docs/assets/images/screenshots/speaker id modal.png differ
diff --git a/docs/assets/images/screenshots/speaker-identification-voice-profiles.png b/docs/assets/images/screenshots/speaker-identification-voice-profiles.png
new file mode 100644
index 00000000..0d03654f
Binary files /dev/null and b/docs/assets/images/screenshots/speaker-identification-voice-profiles.png differ
diff --git a/docs/assets/images/screenshots/speakers-management-voice-profiles.png b/docs/assets/images/screenshots/speakers-management-voice-profiles.png
new file mode 100644
index 00000000..a11df7f8
Binary files /dev/null and b/docs/assets/images/screenshots/speakers-management-voice-profiles.png differ
diff --git a/docs/assets/images/screenshots/summary reprocessing modal.png b/docs/assets/images/screenshots/summary reprocessing modal.png
new file mode 100644
index 00000000..921f4b04
Binary files /dev/null and b/docs/assets/images/screenshots/summary reprocessing modal.png differ
diff --git a/docs/assets/images/screenshots/tag selection and stacking.png b/docs/assets/images/screenshots/tag selection and stacking.png
new file mode 100644
index 00000000..413e2671
Binary files /dev/null and b/docs/assets/images/screenshots/tag selection and stacking.png differ
diff --git a/docs/assets/images/screenshots/tag-management-enhanced-badges.png b/docs/assets/images/screenshots/tag-management-enhanced-badges.png
new file mode 100644
index 00000000..577df1a5
Binary files /dev/null and b/docs/assets/images/screenshots/tag-management-enhanced-badges.png differ
diff --git a/docs/assets/images/screenshots/tag-management.png b/docs/assets/images/screenshots/tag-management.png
new file mode 100644
index 00000000..8bed8b4a
Binary files /dev/null and b/docs/assets/images/screenshots/tag-management.png differ
diff --git a/docs/assets/images/screenshots/template-selector.png b/docs/assets/images/screenshots/template-selector.png
new file mode 100644
index 00000000..5bb9b0cd
Binary files /dev/null and b/docs/assets/images/screenshots/template-selector.png differ
diff --git a/docs/assets/images/screenshots/ui-chinese.png b/docs/assets/images/screenshots/ui-chinese.png
new file mode 100644
index 00000000..e5c3edab
Binary files /dev/null and b/docs/assets/images/screenshots/ui-chinese.png differ
diff --git a/docs/assets/images/screenshots/upload-interface.png b/docs/assets/images/screenshots/upload-interface.png
new file mode 100644
index 00000000..2874c035
Binary files /dev/null and b/docs/assets/images/screenshots/upload-interface.png differ
diff --git a/docs/assets/images/screenshots/video-playback.png b/docs/assets/images/screenshots/video-playback.png
new file mode 100644
index 00000000..ef1b8627
Binary files /dev/null and b/docs/assets/images/screenshots/video-playback.png differ
diff --git a/docs/assets/images/speakr-logo.png b/docs/assets/images/speakr-logo.png
new file mode 100644
index 00000000..7def29e9
Binary files /dev/null and b/docs/assets/images/speakr-logo.png differ
diff --git a/docs/ci-cd-setup.md b/docs/ci-cd-setup.md
new file mode 100644
index 00000000..4fe134fc
--- /dev/null
+++ b/docs/ci-cd-setup.md
@@ -0,0 +1,89 @@
+# CI/CD Setup for Speakr
+
+This document explains how the Continuous Integration and Continuous Deployment (CI/CD) pipeline is set up for the Speakr project.
+
+## Automatic Docker Image Building and Publishing
+
+The Speakr project uses GitHub Actions to automatically build and publish Docker images to Docker Hub whenever changes are pushed to the repository.
+
+### How It Works
+
+1. When code is pushed to the `master` branch or a new tag is created (in the format `v*.*.*`), the GitHub Actions workflow is triggered.
+2. The workflow builds a Docker image using the project's Dockerfile.
+3. If the trigger was a push to the `master` branch, the image is tagged with:
+    - `latest`
+    - The short SHA of the commit
+    - The branch name (`master`)
+4. If the trigger was a new tag (e.g., `v1.2.3`), the image is tagged with:
+    - The full version (`1.2.3`)
+    - The major.minor version (`1.2`)
+    - The tag name (`v1.2.3`)
+5. The image is then pushed to Docker Hub under your account.
+
+### Setup Instructions
+
+To set up automatic Docker image publishing, follow these steps:
+
+1. **Create a Docker Hub Account** (if you don't already have one):
+    - Go to [Docker Hub](https://hub.docker.com/) and sign up for an account.
+    - Create a repository named `speakr`.
+
+2. **Create a Docker Hub Access Token**:
+    - Log in to Docker Hub.
+    - Go to your account settings by clicking on your username in the top-right corner and selecting "Account Settings".
+    - Navigate to the "Security" tab.
+    - Click "New Access Token".
+    - Give your token a name (e.g., "GitHub Actions") and set the appropriate permissions (at least "Read & Write").
+    - Copy the generated token (you won't be able to see it again).
+
+3. **Add Docker Hub Credentials to GitHub Secrets**:
+    - Go to your GitHub repository.
+    - Click on "Settings" > "Secrets and variables" > "Actions".
+    - Click "New repository secret".
+    - Add the following secrets:
+     - Name: `DOCKERHUB_USERNAME`, Value: Your Docker Hub username
+     - Name: `DOCKERHUB_TOKEN`, Value: The access token you generated in the previous step
+
+4. **Verify the Workflow**:
+    - The workflow file is located at `.github/workflows/docker-publish.yml`.
+    - It's already configured to build and push Docker images to Docker Hub.
+    - You can customize it further if needed.
+
+5. **Trigger the Workflow**:
+    - Push a change to the `master` branch or create a new tag to trigger the workflow.
+    - Go to the "Actions" tab in your GitHub repository to monitor the workflow's progress.
+
+### Using the Published Docker Images
+
+Once the images are published to Docker Hub, you can use them in your docker-compose.yml file:
+
+```yaml
+version: '3.8'
+
+services:
+  app:
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+    env_file:
+      - .env
+```
+
+### Versioning Strategy
+
+To create a new version of your application:
+
+1. Make your changes and commit them to the repository.
+2. Create a new tag following semantic versioning:
+    ```bash
+    git tag v1.0.0  # Replace with the appropriate version number
+    git push origin v1.0.0
+    ```
+3. The GitHub Actions workflow will automatically build and publish a new Docker image with the appropriate version tags.
+
+This allows users to choose between using the latest version (`learnedmachine/speakr:latest`) or a specific version (`learnedmachine/speakr:1.0.0`).
diff --git a/create_docs.py b/docs/create_docs.py
similarity index 100%
rename from create_docs.py
rename to docs/create_docs.py
diff --git a/docs/faq.md b/docs/faq.md
new file mode 100644
index 00000000..f917cf54
--- /dev/null
+++ b/docs/faq.md
@@ -0,0 +1,276 @@
+# Frequently Asked Questions
+
+These are the questions that come up most often when people start using Speakr. The answers here will save you time and help you understand how to get the most from the platform.
+
+## General Questions
+
+### What is Speakr exactly?
+
+Speakr is a self-hosted web application that transforms your audio recordings into organized, searchable, and intelligent notes. It combines [transcription](features.md#core-transcription-features), [AI summarization](features.md#automatic-summarization), [speaker identification](features.md#speaker-diarization), and [semantic search](user-guide/inquire-mode.md) into a single platform you control completely. If you self-host an ASR model like a Whisper endpoint or the recommended ASR service, and an openAI compatible API for LLMs, your data never leaves your infrastructure, giving you complete privacy and control.
+
+### How is Speakr different from other transcription services?
+
+The key difference is self-hosting - you run Speakr on your own server, keeping complete control of your data. Beyond privacy, Speakr integrates transcription with AI-powered features like [intelligent summarization](features.md#automatic-summarization), [interactive chat](user-guide/transcripts.md) with your recordings, and [semantic search](user-guide/inquire-mode.md) across all your content. It's not just about converting speech to text; it's about making that text useful and accessible.
+
+### What audio formats does Speakr support?
+
+Speakr handles most common audio formats including MP3, WAV, M4A, OGG, FLAC, and more. The system uses FFmpeg internally to process audio, so essentially any format FFmpeg supports will work. Video files containing audio tracks are also supported - Speakr will extract and process the audio component.
+
+### Can multiple people use the same Speakr instance?
+
+Yes, Speakr is designed as a multi-user system. Each user has their own account with separate recordings, settings, and speaker libraries. Admins can [create and manage user accounts](admin-guide/user-management.md). See [system statistics](admin-guide/statistics.md) to monitor usage, monitor usage, and configure system-wide settings. Users can't see each other's recordings unless explicitly shared through [share links](user-guide/sharing.md). Learn about [sharing security](user-guide/sharing.md#security-and-privacy-considerations).
+
+## Installation and Setup
+
+### What are the minimum system requirements?
+
+Speakr runs comfortably on modest hardware. You need at least 2GB of RAM, though 4GB is recommended for better performance. CPU requirements depend on your usage - a dual-core processor handles single-user instances fine, while busy multi-user installations benefit from more cores. Storage needs depend on your recording volume, but start with at least 20GB free space for the application and initial recordings.
+
+### Do I need to know Docker to install Speakr?
+
+Basic Docker knowledge helps but isn't essential. The [quick start guide](getting-started.md) provides exact commands to copy and run. For production deployments, see the [installation guide](getting-started/installation.md). You'll need to install Docker and Docker Compose on your server, create a configuration file with your API keys, then run a single command to start everything. The hardest part is usually getting your API keys from OpenAI or OpenRouter.
+
+### Can I run Speakr on a Raspberry Pi?
+
+Yes, Speakr can run on a Raspberry Pi 4 or newer with at least 4GB of RAM. Performance won't match a full server, especially for transcription processing, but it's perfectly usable for personal use. The ARM-compatible Docker images work out of the box. Just be patient with longer processing times for large recordings.
+
+### Can I use the ASR webservice for speaker diarization on Mac?
+
+The optional ASR webservice (`onerahmet/openai-whisper-asr-webservice`) that provides [speaker diarization](features.md#speaker-diarization) has specific requirements on macOS:
+
+**GPU limitation**: GPU passthrough doesn't work on macOS because Docker runs containers within a Linux VM. This is a fundamental Docker limitation on Mac.
+
+**Solution**: Use the standard CPU image instead of the GPU version:
+
+- Use `onerahmet/openai-whisper-asr-webservice:latest` (NOT `:latest-gpu`)
+- The `:latest` tag provides both amd64 (Intel) and arm64 (Apple Silicon) architectures
+- Processing will be slower without GPU acceleration but fully functional
+
+Example configuration for Mac:
+```bash
+docker run -d -p 9000:9000 \
+  -e ASR_MODEL=base \
+  -e ASR_ENGINE=whisperx \
+  -e HF_TOKEN=your_huggingface_token \
+  onerahmet/openai-whisper-asr-webservice:latest
+```
+
+Note: If you don't need speaker identification in your transcriptions, you can use Speakr with the standard Whisper API instead, which doesn't require this additional container.
+
+### Can Speakr run offline?
+
+Yes, Speakr can run completely offline once set up. The Docker image contains all dependencies. For offline use:
+
+- Use a local ASR endpoint (like the WhisperX container) for transcription
+- Use Ollama or another local LLM for summaries
+- **Inquire Mode**: The embedding model downloads automatically on first use and caches to `instance/huggingface/`. After the initial download, it loads from cache without needing internet access.
+
+Run Speakr once with internet access to cache the embedding model, then disconnect - everything works offline.
+
+### How do I backup my Speakr data?
+
+Your Speakr data consists of three essential components: the SQLite database in the `instance/` directory, audio files and transcriptions in the `uploads/` directory, and your configuration in the `.env` file. To create a complete backup, stop the container first to ensure database consistency, then backup all three directories:
+
+```bash
+docker compose down
+tar czf speakr_backup_$(date +%Y%m%d).tar.gz uploads/ instance/ .env
+docker compose up -d
+```
+
+Regular automated backups are highly recommended for production use.
+
+## Transcription and AI Features
+
+### How accurate is the transcription?
+
+Transcription accuracy depends on several factors - audio quality, speaker clarity, background noise, and technical vocabulary. See the [troubleshooting guide](troubleshooting.md#poor-transcription-quality) for tips. Configure [custom prompts](admin-guide/prompts.md) for technical vocabulary. With good audio, expect 90-95% accuracy for clear English speech. Accuracy decreases with heavy accents, multiple overlapping speakers, or poor recording quality. The ASR endpoint with speaker diarization often provides better practical usability even if raw accuracy is similar.
+
+### What's the difference between Whisper API and ASR endpoints?
+
+Whisper API provides basic transcription - converting speech to text without speaker identification. The [recommended ASR container](getting-started.md#option-b-custom-asr-endpoint-configuration) (`onerahmet/openai-whisper-asr-webservice`) offers advanced features like [speaker diarization](features.md#speaker-diarization), which identifies and labels different speakers in the conversation. Learn to [manage speakers](user-guide/transcripts.md#speaker-identification) after transcription. Diarization is essential for meetings with multiple participants, while Whisper API works fine for single-speaker recordings like dictations or podcasts.
+
+OpenAI's `gpt-4o-transcribe-diarize` model also offers cloud-based diarization. For longer files (over ~23 minutes), speaker tracking supports up to 4 speakers - recordings with more speakers may have inconsistent labels across sections.
+
+Mistral's Voxtral model is another cloud option with built-in diarization and language detection. If you prefer self-hosted, VibeVoice ASR runs on your own GPU(s) via vLLM and provides diarization with timestamps for 50+ languages.
+
+**Note on ASR engines**: For speaker diarization to work properly with the ASR webservice, you must use `ASR_ENGINE=whisperx`, not `faster_whisper`. While faster_whisper provides transcription, it doesn't support speaker identification.
+
+### Can Speakr transcribe languages other than English?
+
+Yes, Speakr supports multiple languages through its transcription services. Whisper models handle dozens of languages with varying accuracy - major languages like Spanish, French, German, and Chinese work well, while less common languages may have reduced accuracy. Set your preferred language in [account settings](user-guide/settings.md#language-preferences) or leave it blank for automatic detection. See [language support details](features.md#language-support).
+
+**Important for Chinese transcription**: When using ASR endpoints for Chinese audio, avoid using distil models (e.g., distil-large-v3) as they may incorrectly recognize Chinese as English. Use the full large-v3 model or similar non-distilled models for accurate Chinese transcription.
+
+### How long can my recordings be?
+
+There's no hard limit on recording length, but practical considerations apply. Very long recordings (over 2-3 hours) take longer to process, use more API credits, and can make the interface sluggish. The file upload limit defaults to 300MB, which accommodates several hours of compressed audio. For very long content like all-day workshops, consider splitting into logical segments.
+
+### What AI model generates the summaries?
+
+Summary generation uses the language model configured in your [environment file](getting-started.md#step-3-configure-your-transcription-service). Customize summaries with [AI prompts](admin-guide/prompts.md) - through a local LLM endpoint or a Cloud provider like OpenAI or OpenRouter. The model choice affects [summary quality](features.md#automatic-summarization), cost, and processing speed. Monitor performance in [system statistics](admin-guide/statistics.md).
+
+### Can I use different models for chat and summaries?
+
+Yes! You can configure a separate model specifically for real-time chat interactions while using a different model for background tasks like summarization. This is useful for:
+
+- **Different service tiers**: Use a faster, premium model for interactive chat while using a budget model for background processing
+- **Cost optimization**: Use cheaper models for summarization while keeping high-quality responses for chat
+- **Speed optimization**: Prioritize low latency for chat while accepting slower processing for summaries
+
+Configure this using the optional `CHAT_MODEL_*` environment variables. See the [Model Configuration](admin-guide/model-configuration.md#separate-chat-model-configuration) guide for details.
+
+## Privacy and Security
+
+### Is my data really private?
+
+When self-hosted properly, your audio and transcriptions never leave your server. However, the transcription and summarization APIs (OpenAI, OpenRouter) do process your content on their servers. For complete privacy, you'd need to use local models for both transcription and summarization, which requires significant computational resources.
+
+### Can I use Speakr for confidential business meetings?
+
+Yes, with appropriate precautions. Self-hosting keeps data under your control, but consider your API provider's data policies. OpenAI and OpenRouter have different data retention and usage policies. For maximum security, use local transcription and summarization models, though this requires powerful hardware and technical expertise.
+
+### Are share links secure?
+
+[Share links](user-guide/sharing.md) use cryptographically secure random tokens that are impossible to guess. Manage shared recordings from the [sharing dashboard](user-guide/sharing.md#managing-your-shared-recordings). However, anyone with the link can access the shared content without authentication. Treat share links like passwords - only send them through secure channels and revoke access when no longer needed. For sensitive content, consider alternative sharing methods that require authentication.
+
+### Who can see my recordings?
+
+Only you can see your recordings by default. [Admin users](admin-guide/user-management.md) cannot directly view other users' recordings through the interface, though they can monitor [usage patterns](admin-guide/statistics.md), though they have database access that could theoretically allow it. Shared recordings are accessible to anyone with the share link. Other users on the same Speakr instance cannot see your recordings unless you explicitly share them.
+
+## Features and Functionality
+
+### What is Inquire Mode?
+
+[Inquire Mode](user-guide/inquire-mode.md) is Speakr's semantic search feature that lets you find information across all your recordings using natural language questions. The [vector store](admin-guide/vector-store.md) must be configured for this to work. Instead of searching for exact keywords, you can ask questions like "What did we decide about the marketing budget?" and get relevant excerpts from any recording that discussed that topic. It uses AI embeddings to understand meaning and context.
+
+### How do speaker profiles work?
+
+When you [identify speakers](user-guide/transcripts.md#speaker-identification) in a transcription by clicking on generic labels (SPEAKER_01, etc.) and assigning names, Speakr saves these as speaker profiles. Manage them in [account settings](user-guide/settings.md#speakers-management-tab). In future updates, we intend to add functionality to allow recordings can then use these profiles to automatically suggest speaker identities based on voice characteristics. Over time, you build a library of recognized speakers that makes multi-person transcriptions much more useful.
+
+### Can I edit transcriptions after they're generated?
+
+Yes, transcriptions are fully editable. Click the Edit button above any transcription to make corrections. See the [transcripts guide](user-guide/transcripts.md#editing-transcriptions) for editing options. This is particularly useful for fixing misrecognized technical terms, proper names, or correcting speaker assignments. Your edits are preserved - they won't be lost if you regenerate the summary or use the [chat feature](user-guide/transcripts.md). Export edited transcripts using [various formats](user-guide/transcripts.md).
+
+### What export formats are available?
+
+Speakr can export recordings in multiple formats. Copy transcriptions directly to your clipboard for pasting into other applications. Learn about [export options](features.md#export-options) and [sharing](user-guide/sharing.md). Download complete recordings as Word documents (.docx) including transcription, summary, and notes. [Share links](user-guide/sharing.md) provide read-only web access. Configure what's visible in [share settings](user-guide/sharing.md#creating-a-share-link). The chat history can also be exported for documentation purposes.
+
+## Troubleshooting
+
+### Why is transcription taking so long?
+
+Several factors affect transcription speed - file size, API service load, network speed, and model selection. Large files naturally take longer. API services can slow down during peak usage. Slow internet connections create bottlenecks uploading audio. Using larger, more accurate models like Whisper Large takes longer than smaller models.
+
+### My recordings are stuck in "pending" status
+
+This usually means the background processor has stopped or encountered an error. Check the Docker logs for error messages. See the [troubleshooting guide](troubleshooting.md#transcription-never-starts) for details. Monitor processing in [vector store](admin-guide/vector-store.md). Common causes include invalid API keys, exceeded API quotas, or network connectivity issues. Restarting the container often resolves temporary issues. Check your API provider's dashboard for usage limits or billing problems.
+
+### Why are all speakers showing as "UNKNOWN_SPEAKER"?
+
+This is a common issue when speaker diarization isn't configured correctly. Here's how to fix it:
+
+1. **Check ASR_ENGINE**: Ensure you're using `ASR_ENGINE=whisperx` in your ASR container, not `faster_whisper`
+2. **Verify ASR_DIARIZE**: While this is set to `true` by default when `USE_ASR_ENDPOINT=true`, explicitly set `ASR_DIARIZE=true` in your .env file
+3. **HuggingFace Token**: The ASR container needs a valid `HF_TOKEN` environment variable for downloading diarization models
+4. **Docker networking**: If containers are in the same docker-compose, use the container name (e.g., `http://whisper-asr:9000`), not localhost or external IPs
+5. **Check logs**: Look for pyannote/VAD messages in your ASR container logs to confirm diarization is active
+
+The ASR service should return speaker labels like "SPEAKER_00", "SPEAKER_01" in the transcription. You can then [identify these speakers](user-guide/transcripts.md#speaker-identification) with real names.
+
+### Why can't I share recordings?
+
+[Sharing](user-guide/sharing.md) requires your Speakr instance to be accessible from the internet with HTTPS/SSL encryption. Check [sharing requirements](user-guide/sharing.md#requirements-for-sharing) and [troubleshooting](troubleshooting.md#sharing-links-dont-work). Local installations or non-HTTPS setups cannot generate working share links. The system disables sharing features when these requirements aren't met. To enable sharing, deploy Speakr on a public server with a domain name and SSL certificate.
+
+### The interface is slow with large transcriptions
+
+Browsers struggle displaying very large amounts of text, especially in the bubble view with speaker diarization. For recordings over 2 hours, consider using the simple view instead of bubble view. Clear your browser cache if performance degrades over time. Breaking very long recordings into segments improves both performance and usability.
+
+## Best Practices
+
+### How should I organize my recordings?
+
+Develop a consistent [tagging system](user-guide/settings.md#tag-management-tab) early. Create tags for different projects, meeting types, or clients. Tags can include [custom prompts](admin-guide/prompts.md) for specialized processing. Use descriptive titles that will help you find recordings months later. Add notes immediately after recordings while context is fresh. Regular maintenance - archiving old recordings and cleaning up test files - keeps your library manageable.
+
+### Do I need to inform people they're being recorded?
+
+Legal requirements vary by jurisdiction. Many regions require explicit consent from all parties being recorded. Speakr includes a configurable [recording disclaimer](admin-guide/system-settings.md#recording-disclaimer) feature. See [compliance considerations](troubleshooting.md#recording-disclaimer-for-legal-compliance). Set appropriate legal text that displays before recordings start. Consult local laws to ensure compliance - this is especially important in regions with strict recording laws like the EU, California, or Australia.
+
+### What's the best audio quality for transcription?
+
+Record in quiet environments when possible. Use a good microphone positioned close to speakers. For meetings, place the recording device centrally where all participants are clearly audible. Avoid background music or TV noise. Higher quality audio not only improves transcription accuracy but also reduces processing time and API costs.
+
+### Certain specialized words don't get transcribed properly. How do I fix this?
+
+This is common with brand names, acronyms, technical jargon, or proper nouns that the transcription model hasn't seen frequently during training. Speakr provides two features to address this:
+
+**Hotwords** let you provide a comma-separated list of terms the transcription engine should prioritize. For example, if "PyAnnote" keeps being transcribed as "piano" or "pie annotate", adding it to your hotwords list biases the model toward the correct spelling.
+
+**Initial Prompt** gives the transcription engine broader context about your recording's content, helping it make better word choices when audio is ambiguous.
+
+You can set these at multiple levels, from most to least priority:
+
+1. **Per-upload** - In the Advanced ASR Options when uploading
+2. **Per-tag** - In tag settings (applied automatically when that tag is selected)
+3. **Per-folder** - In folder settings (applied to all recordings in that folder)
+4. **Per-user** - In [Account Settings → Prompt Options](user-guide/settings.md#transcription-hints) (your personal defaults)
+
+!!! note "ASR Service Compatibility"
+    Hotwords and initial prompt are fully supported by [WhisperX ASR](admin-guide/whisperx-setup.md). For OpenAI connectors (Whisper, Transcribe), hotwords are combined into the prompt field since the OpenAI API doesn't have a dedicated hotwords parameter. The community `whisper-asr-webservice` by ahmetoner supports `initial_prompt` but does not currently expose a `hotwords` parameter through its API.
+
+### How can I maximize transcription accuracy?
+
+Speak clearly and avoid talking over others. Minimize background noise and echo. For technical content, use [hotwords and initial prompts](#certain-specialized-words-dont-get-transcribed-properly-how-do-i-fix-this) to help the transcription engine with domain-specific vocabulary. You can set these through [tags](user-guide/settings.md#transcription-hints-hotwords--initial-prompt), [folders](user-guide/folders.md), or your [personal defaults](user-guide/settings.md#transcription-hints). Users can also set [custom summary prompts](user-guide/settings.md#custom-prompts-tab) for their recordings. Use the appropriate [language setting](user-guide/settings.md#language-preferences) rather than relying on auto-detection. Review [language support](features.md#language-support) for best results. For multi-speaker recordings, use the [ASR endpoint](getting-started.md#option-b-custom-asr-endpoint-configuration) with appropriate speaker count settings. [Identify speakers](user-guide/transcripts.md#speaker-identification) after transcription for best results.
+
+For Chinese transcription specifically, use the large-v3 model as smaller models may not output Chinese characters correctly. For other languages, test different models to find the best accuracy for your specific language and accent.
+
+### What's the difference between chunking by size vs duration?
+
+Chunking by file size (e.g., CHUNK_LIMIT=20MB) works well for consistent bitrate audio. Chunking by duration (e.g., CHUNK_LIMIT=1400s) is better when your transcription service has time limits, like Azure's 1500-second maximum. Duration-based chunking ensures no chunk exceeds the time limit regardless of file compression or quality.
+
+### Does Speakr compress my audio files?
+
+Yes, by default. Speakr automatically compresses lossless uploads (WAV, AIFF) to save storage space. A typical 500MB WAV file becomes roughly 50MB after compression - a 90% reduction. This happens transparently when you upload.
+
+**What gets compressed:**
+
+- WAV and AIFF files (uncompressed/lossless formats)
+
+**What stays unchanged:**
+
+- Already-compressed formats: MP3, AAC, OGG, M4A, FLAC, etc.
+- These are never re-encoded to avoid quality loss
+
+**Configuration options** (in your `.env` file):
+```bash
+AUDIO_COMPRESS_UPLOADS=true   # Enable/disable (default: true)
+AUDIO_CODEC=mp3               # mp3, flac, or opus (default: mp3)
+AUDIO_BITRATE=128k            # For lossy codecs (default: 128k)
+```
+
+If you need to preserve original audio quality, set `AUDIO_CODEC=flac` for lossless compression, or set `AUDIO_COMPRESS_UPLOADS=false` to disable compression entirely.
+
+### Which audio codec should I choose?
+
+The three codec options serve different needs:
+
+| Codec | Type | Size Reduction | Best For |
+|-------|------|----------------|----------|
+| **mp3** | Lossy | ~90% from WAV | General use, maximum storage savings |
+| **flac** | Lossless | ~50-70% from WAV | Archival, when quality preservation matters |
+| **opus** | Lossy | ~90% from WAV | Speech-focused recordings, modern systems |
+
+For most users, the default **mp3 at 128k** provides excellent quality for speech while maximizing storage savings. If you're archiving important recordings and want to preserve full audio fidelity, use **flac**. The **opus** codec is efficient for speech but has slightly less universal compatibility than MP3.
+
+### What if my transcription service doesn't support certain codecs?
+
+Some self-hosted transcription services (like vLLM-hosted Whisper) don't support all audio codecs. If you're getting "format not recognised" errors, you can exclude specific codecs from Speakr's supported list:
+
+```bash
+AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+```
+
+Files using these codecs will be automatically converted to your target format before transcription. See the [troubleshooting guide](troubleshooting.md#format-not-recognised-errors) for more details.
+
+---
+
+Return to [Home](index.md) →
\ No newline at end of file
diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644
index 00000000..edf51c57
Binary files /dev/null and b/docs/favicon.ico differ
diff --git a/docs/features.md b/docs/features.md
new file mode 100644
index 00000000..39b47944
--- /dev/null
+++ b/docs/features.md
@@ -0,0 +1,292 @@
+# Features
+
+Speakr combines powerful transcription capabilities with intelligent AI features to transform your audio recordings into valuable, actionable knowledge. Every feature is designed to save time and extract maximum value from your spoken content.
+
+## Core Transcription Features
+
+### Multi-Engine Support
+
+Speakr supports multiple transcription engines to match your needs and budget. Use [OpenAI's Whisper API](getting-started.md#option-a-openai-whisper-configuration) for quick, cloud-based transcription with excellent accuracy. Deploy the [recommended ASR container](getting-started.md#option-b-custom-asr-endpoint-configuration) for advanced features like speaker diarization and local processing. Use [Mistral Voxtral](getting-started/installation.md#for-mistral-voxtral-cloud-based-diarization) for cloud-based diarization via the Mistral API, or run [VibeVoice ASR](getting-started/installation.md#for-vibevoice-asr-self-hosted-via-vllm) on your own hardware for fully self-hosted transcription with diarization. See the [installation guide](getting-started/installation.md) for detailed setup instructions. The system automatically handles different audio formats, converting them as needed for optimal transcription quality.
+
+### Speaker Diarization
+
+When using the [ASR endpoint](getting-started.md#option-b-custom-asr-endpoint-configuration), Speakr automatically identifies different speakers in your recordings. If you encounter issues, check the [troubleshooting guide](troubleshooting.md#speaker-identification-not-working). Each speaker gets a unique label that you can later customize with actual names. The system remembers these speaker profiles, building a library that improves identification accuracy over time. Manage your speaker library in [account settings](user-guide/settings.md). This feature transforms multi-person meetings from walls of text into organized conversations.
+
+**Cloud Diarization with OpenAI**: When using OpenAI's `gpt-4o-transcribe-diarize` model, speaker diarization is also available with speakers labeled as A, B, C, etc. For longer files (over ~23 minutes) that require chunking, the system maintains speaker identity across chunks using audio reference samples. This technique supports **up to 4 speakers** - recordings with more speakers may have inconsistent labels across different sections of the transcript.
+
+**Cloud Diarization with Mistral**: Mistral's Voxtral model provides built-in speaker diarization and automatic language detection. It handles chunking internally, so long files work without extra configuration.
+
+**Self-Hosted Diarization with VibeVoice**: Microsoft's VibeVoice ASR model runs on your own hardware via vLLM and provides speaker diarization with timestamps and language detection for 50+ languages. It's a good option if you want the quality of a dedicated ASR model without any cloud dependency.
+
+### Interactive Audio Synchronization
+
+Speakr provides seamless bidirectional synchronization between audio playback and transcript text for recordings with speaker diarization. Click any part of the transcript to jump directly to that moment in the audio, making it easy to review specific sections. As the audio plays, the system automatically highlights the currently spoken text in real-time with smooth visual feedback. Enable auto-scroll follow mode to keep the active segment centered in view, allowing you to follow along effortlessly during playback.
+
+<div style="max-width: 800px; margin: 2em auto;">
+  <img src="assets/images/screenshots/audio-sync-simple-view.png" alt="Audio synchronization in simple view" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+  <p style="text-align: center; margin-top: 0.5rem; font-style: italic; color: #666;">Active segment highlighting in simple view - click any text to jump to that moment in audio</p>
+</div>
+
+<div style="max-width: 800px; margin: 2em auto;">
+  <img src="assets/images/screenshots/follow-mode-auto-scroll.png" alt="Auto-scroll follow mode" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+  <p style="text-align: center; margin-top: 0.5rem; font-style: italic; color: #666;">Auto-scroll follow mode keeps the current segment centered during playback</p>
+</div>
+
+This interactive experience works across both simple and bubble view modes. Learn more about [audio synchronization features](user-guide/transcripts.md#audio-synchronization-and-follow-mode).
+
+### Language Support
+
+Transcribe content in dozens of languages with automatic detection or manual selection. Major languages like English, Spanish, French, German, and Chinese receive excellent support with high accuracy. The system handles multilingual content gracefully, switching between languages as needed within the same recording.
+
+## AI-Powered Intelligence
+
+### Automatic Summarization
+
+Every recording receives an AI-generated summary that captures key points, decisions, and action items. Configure this through [custom prompts](admin-guide/prompts.md). Users can also set [personal prompts](user-guide/settings.md#custom-prompts-tab) for their recordings. Summaries adapt to your content type - technical meetings get detailed technical summaries, while casual conversations receive lighter overviews. Custom prompts let you shape summaries to match your specific needs. For optimal results, Speakr supports [advanced AI models](admin-guide/model-configuration.md) including OpenAI's GPT-5 series with specialized parameters for reasoning depth and output verbosity.
+
+### Event Extraction
+
+Speakr can automatically extract calendar-worthy events from your recordings during the summary process. When enabled in your account settings, the system identifies mentions of meetings, deadlines, appointments, and other time-sensitive items. Each detected event can be exported as an ICS file compatible with any calendar application. The feature intelligently parses relative date references and provides sensible defaults when specific times aren't mentioned. Learn more about [using event extraction](user-guide/transcripts.md#event-extraction) in your workflow.
+
+### Interactive Chat
+
+Transform static transcripts into dynamic conversations with the integrated chat feature. Learn how to use AI chat effectively in the [transcripts guide](user-guide/transcripts.md). Ask questions about your recordings and receive intelligent answers based on the actual content. Request custom summaries, extract specific information, or generate derivative content like emails or reports. The AI maintains context throughout the conversation, allowing complex multi-turn interactions.
+
+### Semantic Search (Inquire Mode)
+
+Search across all your recordings using natural language questions instead of keywords through [Inquire Mode](user-guide/inquire-mode.md). The [vector store](admin-guide/vector-store.md) must be configured for this feature to work. The semantic search understands meaning and context, finding relevant content even when exact words don't match. Ask questions like "When did we discuss the budget increase?" and get results from any recording that covered that topic, regardless of the specific terminology used.
+
+## Organization and Management
+
+### Folders
+
+Organize recordings into folders for clean, project-based organization. Each recording belongs to exactly one folder (or no folder), providing a simple hierarchical structure alongside the flexible tagging system.
+
+**Folder Features:**
+
+- **Per-Folder Settings** - Each folder can have its own custom AI prompts, default transcription language, and ASR speaker settings
+- **Sidebar Selector** - Quick folder dropdown to filter recordings by folder
+- **Folder Pills** - Visual indicators showing which folder a recording belongs to
+- **Group Folders** - Share folders with groups for automatic access when recordings are added
+- **Retention Policies** - Set folder-specific retention periods or protect folder contents from auto-deletion
+
+Folders complement tags rather than replacing them. Use folders for primary organization (by project, client, or meeting type) and tags for cross-cutting categorization (status, topics, follow-ups).
+
+!!! note "Enabling Folders"
+    Folders are disabled by default. Administrators must set `enable_folders` to `true` in System Settings or set `ENABLE_FOLDERS=true` in the environment.
+
+See the [Folders Guide](user-guide/folders.md) for detailed usage instructions.
+
+### Bulk Operations
+
+Select multiple recordings in the sidebar to perform batch operations efficiently. Enter multi-select mode by clicking the checkbox icon or using keyboard shortcuts, then select individual recordings or use Ctrl/Cmd+A to select all visible recordings.
+
+**Available bulk actions:**
+
+- **Delete** - Remove multiple recordings at once with confirmation
+- **Add/Remove Tags** - Apply or remove tags from all selected recordings
+- **Reprocess** - Regenerate transcriptions or summaries for multiple recordings
+- **Toggle Inbox/Highlight** - Mark recordings as inbox items or toggle highlight status
+
+The floating action bar appears when recordings are selected, showing the count and available operations. Press Escape to exit multi-select mode or click outside the selection area.
+
+### Tagging System
+
+Organize recordings with a flexible [tagging system](user-guide/settings.md#tag-management-tab) that goes beyond simple labels. Tags can include [custom AI prompts](admin-guide/prompts.md) for specialized processing. Each tag can carry [custom AI prompts](admin-guide/prompts.md) and transcription settings, enabling automatic specialized processing based on content type, automatically applying specialized processing to tagged recordings. Tags use colors for visual organization and stack intelligently when multiple tags apply to the same recording.
+
+### Retention Policies and Auto-Deletion
+
+Implement intelligent data lifecycle management with flexible retention policies. Set a global retention period for automatic cleanup of old recordings, with the choice to delete just audio files (preserving valuable transcriptions) or complete recordings. Tags can override global retention with custom retention periods - keep legal records for 7 years, marketing content for 6 months, and general meetings for 90 days, all through tag-level configuration. Protected tags prevent specific recordings from ever being auto-deleted, perfect for compliance requirements and permanent archives. Group tags can enforce group-wide retention policies. The system provides preview functionality to see exactly what will be deleted before any changes occur, and administrators can control whether users can delete their own recordings or if deletion requires admin approval.
+
+**Integrated Speaker Data Cleanup**: When recordings are deleted through auto-deletion or manual deletion, the system automatically manages associated speaker voice profiles to maintain privacy compliance. Orphaned speaker profiles (those with no remaining recordings) are automatically removed during scheduled cleanup, ensuring biometric voice data is not retained unnecessarily. This automatic cleanup works with both audio-only and full recording deletion modes, providing GDPR-compliant data minimization without requiring manual intervention.
+
+### Speaker Management
+
+Build and maintain a library of speaker profiles that persist across recordings. [Identify speakers](user-guide/transcripts.md#speaker-identification) after each transcription to build your library. Once identified, speakers are remembered and suggested in future recordings. The system tracks usage statistics, showing how often each speaker appears and when they were last identified. Bulk management tools help maintain a clean, organized speaker library.
+
+**Voice Profile Recognition**: The system builds voice recognition profiles from speaker identifications across multiple recordings. These profiles use 256-dimensional voice embeddings to suggest speaker matches when processing new recordings, making speaker identification faster and more consistent. The voice matching system calculates similarity scores to help identify speakers across recordings, even when audio quality varies. Voice profiles are automatically updated as more recordings are processed, improving recognition accuracy over time.
+
+**Auto Speaker Labeling**: Enable automatic speaker identification in your [account settings](user-guide/settings.md#processing-preferences). When enabled, new recordings are automatically analyzed against your speaker profiles, and matching speakers are labeled without manual intervention. Configure the confidence threshold to balance between more matches (low threshold) and higher accuracy (high threshold). This feature requires WhisperX ASR with speaker embeddings enabled.
+
+**Speaker Profile Preservation**: By default, speaker profiles and voice embeddings are preserved even when all associated recordings are deleted. Set `DELETE_ORPHANED_SPEAKERS=true` to automatically clean up speakers with no remaining recordings.
+
+### Custom Prompts
+
+Shape AI behavior with [custom prompts](admin-guide/prompts.md) at multiple levels. Understand the [prompt hierarchy](admin-guide/prompts.md#understanding-prompt-hierarchy) for effective configuration. Personal prompts apply to all your recordings, while tag-specific prompts activate for particular content types. The hierarchical system ensures the right prompt applies to each recording, with intelligent stacking when multiple prompts are relevant.
+
+## Sharing and Collaboration
+
+Speakr provides comprehensive collaboration features that scale from individual sharing to organization-wide group management. Choose the right sharing method for each situation - collaborate with specific colleagues through user-to-user sharing, automate access for groups through group tags, or create public links for external stakeholders.
+
+### Internal Sharing (User-to-User)
+
+Share recordings directly with other users in your Speakr instance through secure, tracked internal shares. Search for colleagues by username and grant precisely the access level they need - view-only for information distribution, edit permissions for collaborative documentation, or re-share rights for group coordinators who need to extend access to others.
+
+Recipients with view access can read transcriptions, review summaries and notes, listen to audio, and use the AI chat feature to explore content. Edit permissions add the ability to modify metadata, update notes, and manage tags. Re-share permissions enable recipients to share with additional users and manage those downstream shares.
+
+Each user can maintain completely private personal notes on shared recordings. These notes remain invisible to the recording owner and other recipients, providing a secure space for individual observations and follow-ups. Access revocation is immediate and thorough - when you revoke someone's access, they lose all capabilities and their personal notes are automatically removed.
+
+The centralized share management interface shows all current shares with each recipient's permission level and share creation date. Modify permissions or revoke access instantly, maintaining complete control over collaborative access throughout the recording's lifecycle. Read more in the [Sharing & Collaboration guide](user-guide/sharing.md).
+
+### Group Management
+
+Organize users into groups for streamlined collaboration on projects, departments, or any grouping that regularly works together. Groups eliminate the tedious process of individually sharing each recording with multiple colleagues by automating access through group tags.
+
+Full instance administrators create groups and can assign group admin roles to group leads or managers. Group admins can manage membership, add or remove users, change roles, and control their group's organizational structure without requiring global administrative access. This distributed administration scales group management while maintaining security boundaries.
+
+Group members see group-specific tags in their interface and automatically receive recordings when any teammate applies group tags. This creates a collaborative space where information flows naturally to everyone who needs it. Groups integrate seamlessly with personal organization - users maintain their private tags alongside group tags, creating systems that serve both individual and group needs. Learn more in the [Group Collaboration guide](user-guide/groups.md).
+
+### Group Tags with Auto-Share
+
+Group tags are the automation engine for group collaboration. Unlike personal tags that organize individual content, group tags trigger automatic sharing with all group members when applied to any recording.
+
+Any group member can apply group tags to their recordings. The moment a group tag is applied, Speakr creates internal shares for all group members (excluding the owner), granting view and edit permissions. This automatic sharing happens intelligently - existing shares aren't duplicated, group leads can create admin-only tags for sensitive content, and the system tracks all sharing for audit purposes.
+
+Group tags appear with a distinctive users icon (👥) throughout the interface, making group content immediately recognizable. Apply multiple group tags to share with multiple groups simultaneously, enabling cross-functional collaboration. Custom retention policies can be attached to group tags, automatically managing content lifecycle based on group-specific requirements.
+
+Advanced auto-sharing options let group admins control sharing scope. Share with all group members for full collaboration, or restrict to group leads only for sensitive content requiring administrative oversight. Retroactive syncing can share existing group-tagged recordings with current members after group restructuring. See the [Group Management guide](admin-guide/group-management.md) for administrative details.
+
+### Secure Share Links
+
+Generate cryptographically secure links to [share recordings](user-guide/sharing.md) with people outside your Speakr instance - clients, partners, or anyone who needs access without an account. Each link uses unguessable tokens and works over HTTPS for security, providing read-only access to exactly the content you choose to share.
+
+Control precisely what recipients see by including or excluding summaries and notes. The transcription is always included as the core content, but you decide whether to add AI-generated insights or your personal annotations. Recipients get a clean, professional view optimized for content consumption without access to your administrative interface or other recordings.
+
+Administrators can control public sharing at multiple levels. Disable public sharing globally to prevent all public link creation, or leave it enabled and grant permissions per-user for granular control. This flexibility supports organizations with varying security requirements - some users might need external sharing capabilities while others should only share internally.
+
+Share links remain valid until explicitly revoked through the central share management interface. Modify what's included in a share without generating new links, or delete shares instantly to revoke access. All your shared recordings are tracked in one interface for easy management and audit. Security best practices are enforced - HTTPS is required for sharing operations, and the system warns against posting links publicly or sharing sensitive content inappropriately.
+
+### Export Options
+
+Export recordings in multiple formats for different purposes. Generate Word documents with complete transcripts, summaries, and notes for formal documentation. Copy formatted text to clipboards for quick sharing. Export individual components like summaries or notes for focused distribution. Download transcriptions with [customizable templates](user-guide/transcript-templates.md) that format your content for different use cases, from subtitles to interview formats.
+
+### Real-Time Monitoring
+
+Track all your shared recordings from a central location. See what's been shared, when, and with what permissions. Modify share settings without generating new links, or instantly revoke access when shares are no longer appropriate. View shared recordings alongside your own content with clear visual indicators showing ownership and group affiliation.
+
+## API Access
+
+### Personal Access Tokens
+
+Speakr provides [API token authentication](user-guide/api-tokens.md) for programmatic access to your recordings. Create personal access tokens from your Account Settings to authenticate automation tools, scripts, and custom integrations without sharing your password.
+
+Tokens work with multiple authentication methods - the standard Authorization Bearer header, custom X-API-Token or API-Token headers, or query parameters for simple integrations. Each token is tied to your user account and provides the same access as logging in through the web interface.
+
+### Integration Support
+
+Build powerful workflows with popular automation platforms:
+
+- **n8n / Zapier / Make** - Trigger transcriptions, retrieve recordings, and integrate Speakr into your automation workflows
+- **Custom scripts** - Access your recordings programmatically with Python, JavaScript, or any language that supports HTTP
+- **CI/CD pipelines** - Automate audio processing as part of development workflows
+- **Mobile apps** - Build custom interfaces that connect to your Speakr instance
+
+### Token Security
+
+All tokens are hashed using SHA-256 before storage - the plaintext token is shown only once at creation. Set custom expiration periods for temporary integrations, or create non-expiring tokens for permanent workflows. Revoke tokens instantly from the Account Settings if compromised.
+
+## Advanced Capabilities
+
+### Audio Chunking
+
+Handle large audio files that exceed API limits through intelligent chunking. See the [troubleshooting guide](troubleshooting.md#files-over-25mb-fail-with-openai) for configuration details. Learn about [chunking strategies](faq.md#whats-the-difference-between-chunking-by-size-vs-duration) in the FAQ. The system automatically splits long recordings into manageable segments, processes them separately, then seamlessly reassembles the results. Configure chunk size by duration or file size to match your API provider's requirements.
+
+### Black Hole Processing
+
+Set up a watched directory where dropped audio files are automatically processed. Configure this in [system settings](admin-guide/system-settings.md) for automated workflows. Perfect for automation workflows or batch processing, the black hole directory monitors for new files and queues them for transcription without manual intervention.
+
+### Automated Export
+
+Automatically export completed transcriptions and summaries to markdown files after processing. Configure the export directory to point to your Obsidian vault, Logseq directory, or any other note-taking system for seamless integration. Choose what to export (transcription, summary, or both) and let Speakr maintain synchronized copies of your recordings in your preferred format. Custom export templates allow you to format the output to match your note-taking workflow. Exports are organized in per-user subdirectories for multi-user instances.
+
+### Custom Vocabulary & Transcription Hints
+
+Improve transcription accuracy for domain-specific content with two complementary features:
+
+- **Hotwords** - Provide comma-separated terms (brand names, acronyms, technical jargon) that the transcription engine should prioritize. This biases the model toward correctly recognizing words it might otherwise misspell.
+- **Initial Prompt** - Give the transcription engine context about the recording content, helping it make better overall word choices when audio is ambiguous.
+
+Set these at any level - [per-user defaults](user-guide/settings.md#transcription-hints), [per-tag](user-guide/settings.md#transcription-hints-hotwords--initial-prompt), [per-folder](user-guide/folders.md), or per-upload in the Advanced ASR Options. Values cascade with upload form taking highest priority, then tags, folders, and finally user defaults. See the [FAQ](faq.md#certain-specialized-words-dont-get-transcribed-properly-how-do-i-fix-this) for practical usage tips.
+
+### Custom ASR Configuration
+
+Fine-tune transcription for specific scenarios with custom ASR settings. See [ASR configuration](troubleshooting.md#asr-endpoint-returns-405-or-404-errors) for common setup issues. Set expected speaker counts for different meeting types. Configure specialized models for technical vocabulary or specific accents. Apply these settings automatically through the tagging system.
+
+## User Experience
+
+### Progressive Web App
+
+Install Speakr as a progressive web app for a native-like experience on any device. The PWA works offline for viewing existing recordings and syncs when connectivity returns. Mobile-optimized interfaces ensure smooth operation on phones and tablets.
+
+### Dark Mode
+
+Reduce eye strain with a full dark mode implementation that affects every interface element. The theme preference persists across sessions and devices, automatically applying your choice whenever you log in.
+
+### Video Retention
+
+When enabled (`VIDEO_RETENTION=true`), uploaded video files preserve their video stream for in-browser playback. Instead of extracting audio and discarding the video, Speakr keeps the original file and renders it with a native `<video>` player alongside the transcript. Audio is extracted to a temporary file for transcription only, then cleaned up automatically. All existing player controls (play/pause, seek, speed, volume) work identically with video since HTML5 `<video>` and `<audio>` share the same media API. HTTP Range requests enable efficient seeking without downloading the entire file. This feature is ideal for presentations, lectures, and screen recordings where the visual context adds value to the transcript. Default: `false` (current behavior preserved — video uploads extract audio only).
+
+<div style="max-width: 800px; margin: 2em auto;">
+  <img src="assets/images/screenshots/video-playback.png" alt="Video playback alongside transcript" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+  <p style="text-align: center; margin-top: 0.5rem; font-style: italic; color: #666;">In-browser video playback alongside speaker-labeled transcript and summary</p>
+</div>
+
+### Video Passthrough to ASR
+
+For advanced self-hosted setups, Speakr can send original video files directly to the ASR backend without extracting audio first (`VIDEO_PASSTHROUGH_ASR=true`). This is designed for custom ASR containers that accept video input and handle audio extraction internally — for example, backends that process multiple audio tracks from a single video file. When enabled, video uploads skip audio extraction, codec conversion, and chunking entirely, letting the ASR backend control the full pipeline. Audio file uploads continue to work normally. This setting is independent of `VIDEO_RETENTION` — you can combine both to keep the video for playback while also sending it raw to ASR.
+
+### Playback Speed Control
+
+Adjust audio playback speed from 0.5x to 3x on all audio/video players throughout the application. This is useful for quickly reviewing long recordings or slowing down complex content. Your speed preference is saved to localStorage and persists across sessions.
+
+### Incognito Mode
+
+Process transcriptions without saving anything to the database. When incognito mode is enabled (`ENABLE_INCOGNITO_MODE=true`), users can upload and transcribe audio files with the assurance that the audio is deleted immediately after processing and no record is stored in the database. Close the tab and it's gone - perfect for sensitive content that shouldn't persist.
+
+### Responsive Design
+
+Access Speakr from any device with interfaces that adapt to screen size. Desktop users get a full three-panel layout with simultaneous access to recordings, transcripts, and chat. Mobile users receive a streamlined interface optimized for touch interaction and smaller screens.
+
+## Administrative Control
+
+### Multi-User Support
+
+Run a single Speakr instance for your entire group with isolated user spaces. See [user management](admin-guide/user-management.md) for details. The [FAQ](faq.md#can-multiple-people-use-the-same-speakr-instance) explains the multi-user architecture. Each user maintains their own recordings, settings, and speaker libraries. Administrators manage users, monitor usage, and configure system-wide settings without accessing individual recordings.
+
+### Single Sign-On (SSO)
+
+Integrate with your existing identity provider using OpenID Connect. Speakr supports any OIDC-compliant provider including Keycloak, Azure AD/Entra ID, Google, Auth0, and self-hosted options like Pocket ID or Authentik. Users can link existing accounts to SSO or have accounts created automatically on first login. Domain filtering lets you restrict registration to specific email domains. See the [SSO Setup Guide](admin-guide/sso-setup.md) for configuration details.
+
+### Email Verification & Password Reset
+
+Secure your instance with email verification for new registrations and enable self-service password recovery. When email verification is enabled, new users must confirm their email address before gaining access—works with both open registration and domain-restricted setups. Users can reset forgotten passwords through a secure, time-limited email link from the login page. Configure any SMTP provider including Gmail, SendGrid, Mailgun, or Amazon SES. Existing users are automatically grandfathered as verified when enabling this feature. See the [Email Setup Guide](admin-guide/email-setup.md) for configuration details.
+
+### System Monitoring
+
+Track system health with comprehensive statistics and metrics. Monitor transcription queues, storage usage, and processing performance. Identify bottlenecks and optimize configuration based on actual usage patterns.
+
+### Token Usage Tracking & Budgets
+
+Monitor and control LLM API consumption with per-user token tracking and budget enforcement. The system tracks all AI operations including summarization, chat, title generation, and event extraction.
+
+**Per-User Budgets**: Set monthly token limits for individual users to control costs. Users see their remaining budget in the interface and receive warnings at 80% consumption. Once a budget is exhausted, AI operations are blocked until the next month.
+
+**Admin Dashboard**: View detailed token statistics including daily trends, monthly totals, and per-user breakdowns. Cost tracking is available when using OpenRouter or other providers that return cost information. See the [admin guide](admin-guide/statistics.md#token-usage-statistics) for details.
+
+### Transcription Usage Tracking & Budgets
+
+Monitor and control speech-to-text API consumption separately from LLM tokens. The system tracks all transcription operations across different connectors (OpenAI Whisper, OpenAI Transcribe, and self-hosted ASR).
+
+**Per-User Budgets**: Set monthly transcription limits (in minutes) for individual users. Users receive warnings at 80% consumption, and new transcriptions are blocked when the budget is exhausted until the next month.
+
+**Cost Estimation**: The system calculates estimated transcription costs based on the connector used - $0.006/minute for OpenAI Whisper, $0.003-$0.006/minute for OpenAI Transcribe models, and $0 for self-hosted ASR endpoints. This helps organizations forecast costs and identify heavy users.
+
+**Admin Dashboard**: View transcription statistics including today's usage, monthly totals, estimated costs, and per-user breakdowns with budget status indicators. See the [admin guide](admin-guide/statistics.md#transcription-usage-statistics) for details.
+
+### Flexible Configuration
+
+Configure every aspect of Speakr through [environment variables](getting-started.md#step-3-configure-your-transcription-service) and [admin settings](admin-guide/index.md). Check [system settings](admin-guide/system-settings.md) for global configuration options. Set API endpoints, adjust processing limits, enable or disable features, and customize the user experience. The system adapts to your infrastructure and requirements.
+
+---
+
+Return to [Home](index.md) →
\ No newline at end of file
diff --git a/docs/getting-started.md b/docs/getting-started.md
new file mode 100644
index 00000000..fdf92e4e
--- /dev/null
+++ b/docs/getting-started.md
@@ -0,0 +1,266 @@
+# Quick Start Guide
+
+Get Speakr up and running in just a few minutes using the pre-built Docker image! This guide will walk you through the fastest way to deploy Speakr with either OpenAI Whisper API or a [custom ASR endpoint](features.md#speaker-diarization).
+
+> **Note:** If you want to use the ASR endpoint option for speaker diarization features, you'll need to run an additional Docker container (`onerahmet/openai-whisper-asr-webservice`). See [Running ASR Service for Speaker Diarization](getting-started/installation.md#running-asr-service-for-speaker-diarization) for detailed setup instructions.
+
+## Prerequisites
+
+Before you begin, make sure you have Docker and Docker Compose installed on your system. You'll also need an API key for either OpenAI or OpenRouter (or a compatible service), at least 2GB of available RAM, and about 10GB of available disk space for storing recordings and transcriptions.
+
+## Step 1: Create Project Directory
+
+First, create a directory for your Speakr installation and navigate into it:
+
+```bash
+mkdir speakr
+cd speakr
+```
+
+## Step 2: Download Configuration Files
+
+Download the Docker Compose configuration and the unified environment template:
+
+```bash
+# Download docker compose example
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/docker-compose.example.yml -O docker-compose.yml
+
+# Download the unified configuration template (supports all providers)
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.transcription.example -O .env
+```
+
+The unified configuration auto-detects your transcription provider based on your settings:
+
+- **OpenAI with diarization**: Set `TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize`
+- **Self-hosted ASR/WhisperX**: Set `ASR_BASE_URL=http://your-asr:9000`
+- **Legacy Whisper**: Set `TRANSCRIPTION_MODEL=whisper-1`
+
+> **Note:** For self-hosted ASR with speaker diarization, you'll need an additional Docker container. See [Running ASR Service for Speaker Diarization](getting-started/installation.md#running-asr-service-for-speaker-diarization) for complete setup instructions.
+
+## Step 3: Configure Your API Keys
+
+Open the `.env` file in your preferred text editor. Speakr requires **two types of API keys**:
+
+### Required: Text Generation Model (for summaries, titles, chat)
+
+```bash
+# For text generation - OpenRouter (recommended, access to many models)
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=your_openrouter_api_key_here
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+OpenRouter provides access to multiple models including GPT-4, Claude, and others. Alternatively, you can use OpenAI directly:
+
+```bash
+# For text generation - OpenAI direct
+TEXT_MODEL_BASE_URL=https://api.openai.com/v1
+TEXT_MODEL_API_KEY=sk-your_openai_api_key
+TEXT_MODEL_NAME=gpt-4o-mini
+```
+
+For OpenAI's latest GPT-5 models (`gpt-5`, `gpt-5-mini`, `gpt-5-nano`), you must use the OpenAI API directly. See the [Model Configuration Guide](admin-guide/model-configuration.md) for detailed GPT-5 setup.
+
+### Required: Transcription Service
+
+Choose ONE of the following options:
+
+**Option A: OpenAI with Speaker Diarization (Recommended)**
+```bash
+TRANSCRIPTION_API_KEY=sk-your_openai_api_key
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+```
+This provides high-quality transcription with automatic speaker identification - no GPU or self-hosted service required. Note: For longer files (over ~23 minutes), speaker tracking across chunks supports up to 4 speakers.
+
+**Option B: Self-hosted ASR/WhisperX (Best for privacy)**
+```bash
+ASR_BASE_URL=http://whisper-asr:9000
+ASR_DIARIZE=true
+# Optional: Enable voice profiles (WhisperX only)
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+Requires running an additional ASR container. See [Running ASR Service for Speaker Diarization](getting-started/installation.md#running-asr-service-for-speaker-diarization) for setup instructions.
+
+**Option C: Legacy Whisper (No diarization)**
+```bash
+TRANSCRIPTION_API_KEY=sk-your_openai_api_key
+TRANSCRIPTION_MODEL=whisper-1
+```
+
+When using ASR or OpenAI diarization models, [speaker diarization](features.md#speaker-diarization) is automatically enabled, allowing Speakr to identify different speakers in your recordings. After transcription, you'll need to [identify speakers](user-guide/transcripts.md#speaker-identification) to build your speaker library.
+
+## Step 4: Configure Admin Account
+
+Speakr automatically creates an admin user on first startup. Configure these credentials in your `.env` file before launching:
+
+```bash
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=changeme
+```
+
+Make sure to change these values to something secure, especially the password. This admin account will be created automatically when you first start Speakr, and you'll use these credentials to log in. The first user created through this method becomes the system administrator with full access to all features including user management and system settings.
+
+## Step 5: Launch Speakr
+
+With your configuration complete, start Speakr using Docker Compose:
+
+```bash
+docker compose up -d
+```
+
+The first launch will take a few minutes as Docker downloads the pre-built image (about 3GB) and initializes the database. You can monitor the startup process by viewing the logs:
+
+```bash
+docker compose logs -f app
+```
+
+Look for a message indicating that the Flask application is running and ready to accept connections. Press Ctrl+C to exit the log view (this won't stop the container).
+
+## Step 6: Access Speakr
+
+Once the container is running, open your web browser and navigate to:
+
+```
+http://localhost:8899
+```
+
+Log in using the admin credentials you configured in Step 4. You should now see the Speakr main screen, ready for your first recording.
+
+## Your First Recording
+
+After logging in, you can immediately start using Speakr. Click the "New Recording" button in the top navigation to either upload an existing audio file or start a [live recording](user-guide/recording.md). For detailed instructions, see the [recording guide](user-guide/recording.md). For uploads, Speakr supports [common audio formats](faq.md#what-audio-formats-does-speakr-support) like MP3, M4A, WAV, and more, with files up to 500MB by default. You can adjust this limit in [system settings](admin-guide/system-settings.md). For live recording, you can capture from your microphone, system audio, or both simultaneously.
+
+## Setting Up Collaboration (Optional)
+
+If you're using Speakr with your family or team, you can leverage powerful collaboration features including groups, group tags, and automatic sharing. These features work great for project teams, departments, or families who want to automatically share certain types of recordings.
+
+### Creating a Group
+
+As an admin, you can create groups to organize users who regularly collaborate:
+
+1. Navigate to **Admin → User Groups** in the admin dashboard
+2. Click "Create New Group" and enter a group name (e.g., "Engineering Team", "Family", "Sales Department")
+3. Optionally assign a group lead who can manage group settings
+4. Add members by searching for usernames and clicking to add them
+5. Save the group
+
+### Creating Group Tags
+
+Group tags automatically share recordings with all group members when applied:
+
+1. While editing or creating a group, navigate to the **Tags** section
+2. Click "Create Group Tag" and enter:
+    - **Tag Name**: What the tag will be called (e.g., "Team Meetings", "Family Events")
+    - **Color**: Choose a color for easy visual identification
+    - **Custom Prompt** (optional): AI instructions for how to summarize recordings with this tag
+    - **Protected**: Enable to prevent automatic deletion by retention policies
+    - **Retention Days** (optional): Auto-delete recordings after this many days (leave blank to keep forever)
+3. Save the tag
+
+When any group member applies this tag to a recording, all group members automatically get access to it.
+
+### Sharing a Recording with a Group
+
+There are two ways to share recordings with groups:
+
+**Method 1: Using Group Tags** (Automatic)
+
+1. When uploading or after creating a recording, click the tag icon
+2. Select any group tag you have access to
+3. All group members automatically receive access to this recording
+4. Future group members will NOT see historical recordings, only new ones tagged after they join
+
+**Method 2: Individual Sharing** (Manual)
+
+1. Open any recording and click the share icon (users icon) in the toolbar
+2. Search for and select users to share with
+3. Choose permission level: view-only, edit, or reshare
+4. Each user receives immediate access
+
+For more details on collaboration features, see the [Sharing & Collaboration guide](user-guide/sharing.md).
+
+## Optional Features
+
+### Enable Inquire Mode
+
+[Inquire Mode](user-guide/inquire-mode.md) allows you to search across all your recordings using natural language questions. Learn more about [semantic search capabilities](features.md#semantic-search-inquire-mode) in the features guide. To enable it, set this in your `.env` file:
+
+```bash
+ENABLE_INQUIRE_MODE=true
+```
+
+Then restart the container with `docker compose restart` for the change to take effect.
+
+### Enable User Registration
+
+By default, only the admin can create new users. Learn more about [user management](admin-guide/user-management.md) in the admin guide. To allow self-registration, set:
+
+```bash
+ALLOW_REGISTRATION=true
+```
+
+To restrict registration to specific email domains (e.g., for company use), set:
+
+```bash
+REGISTRATION_ALLOWED_DOMAINS=company.com,subsidiary.org
+```
+
+Leave empty to allow all domains.
+
+### Enable Email Verification & Password Reset
+
+Speakr supports email verification for new registrations and password reset functionality. This works with both open registration and domain-restricted registration. Configure SMTP settings to enable:
+
+```bash
+# Enable email features
+ENABLE_EMAIL_VERIFICATION=true
+REQUIRE_EMAIL_VERIFICATION=true  # Block login until email is verified
+
+# SMTP Configuration
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USERNAME=your-email@gmail.com
+SMTP_PASSWORD=your-app-password  # Use App Password for Gmail
+SMTP_USE_TLS=true
+SMTP_FROM_ADDRESS=noreply@yourdomain.com
+SMTP_FROM_NAME=Speakr
+```
+
+When enabled, new users receive a verification email after registration. Password reset is available from the login page via "Forgot password?" link. See the [Email Setup Guide](admin-guide/email-setup.md) for detailed configuration including provider-specific examples for Gmail, SendGrid, Mailgun, and more.
+
+### Configure Your Timezone
+
+Set your local timezone for accurate timestamp display:
+
+```bash
+TIMEZONE="America/New_York"
+```
+
+Use any valid timezone from the TZ database like "Europe/London", "Asia/Tokyo", or "UTC".
+
+## Stopping and Starting Speakr
+
+To stop Speakr while preserving all your data:
+
+```bash
+docker compose down
+```
+
+To start it again:
+
+```bash
+docker compose up -d
+```
+
+Your recordings, transcriptions, and settings are preserved in the `./uploads` and `./instance` directories on your host system.
+
+## Troubleshooting
+
+If Speakr doesn't start properly, check the logs for error messages using `docker compose logs app`. For more detailed help, see the [Troubleshooting Guide](troubleshooting.md), particularly the [installation issues](troubleshooting.md#installation-and-setup-issues) section. Common issues include incorrect API keys, which will show authentication errors in the logs, or port conflicts if another service is using port 8899. You can change the port by editing the `docker-compose.yml` file and modifying the ports section.
+
+If transcription fails, verify your API keys are correct and you have sufficient credits with your chosen service. The logs will show detailed error messages that can help identify the issue.
+
+---
+
+Next: [Installation Guide](getting-started/installation.md) for production deployments and advanced configuration
\ No newline at end of file
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
new file mode 100644
index 00000000..5eb2a95c
--- /dev/null
+++ b/docs/getting-started/installation.md
@@ -0,0 +1,1080 @@
+# Installation Guide
+
+This comprehensive guide covers deploying Speakr for production use, including detailed configuration options, performance tuning, and deployment best practices. While the Quick Start guide gets you running quickly, this guide provides everything you need for a robust production deployment.
+
+## Understanding Speakr's Architecture
+
+Before diving into installation, it's helpful to understand how Speakr works. The application integrates with external APIs for two main purposes: transcription services that convert your audio to text, and text generation services that power features like summaries, titles, and interactive chat. Speakr is designed to be flexible, supporting both cloud-based services like OpenAI and self-hosted solutions running on your own infrastructure.
+
+Speakr uses a **connector-based architecture** for transcription services, providing a unified interface regardless of which provider you choose. The following connectors are currently available:
+
+1. **ASR Endpoint** (Recommended for best quality) - For self-hosted solutions like WhisperX that offer GPU-accelerated transcription with superior accuracy, voice profiles, and speaker diarization
+2. **OpenAI Transcribe** - Uses `gpt-4o-transcribe-diarize` for cloud-based speaker diarization without requiring additional containers
+3. **Mistral Voxtral** - Cloud-based transcription with built-in diarization and language detection via the Mistral API
+4. **VibeVoice ASR** - Microsoft's self-hosted multimodal ASR model with diarization, timestamps, and 50+ language support, served via vLLM
+5. **OpenAI Whisper** - Legacy whisper-1 model for basic transcription using any legacy OpenAI compatible whisper API
+
+The connector can be specified or inferred based on your configuration. For text generation, Speakr uses the OpenAI Chat Completions API format with the `/chat/completions` endpoint, which is widely supported across different AI providers.
+
+## Prerequisites
+
+For a production deployment, ensure your system meets these requirements. You'll need Docker Engine version 20.10 or later and Docker Compose version 2.0 or later. The system should have at least 4GB of RAM, with 8GB recommended for optimal performance, especially if you're processing longer recordings. Plan for at least 20GB of free disk space to accommodate recordings and transcriptions, though actual requirements will depend on your usage patterns. The server should have a stable internet connection for API calls to transcription and AI services, unless you're running everything locally.
+
+## Choosing Your Deployment Method
+
+You have two main options for deploying Speakr. The first and recommended approach is using the pre-built Docker image from Docker Hub, which requires no source code and gets you running quickly. The second option is building from source, which is useful if you need to modify the code or prefer to build your own images. Both methods use Docker Compose for orchestration and management.
+
+## Standard Installation Using Pre-Built Image
+
+### Step 1: Create Installation Directory
+
+Choose an appropriate location for your Speakr installation. This directory will contain your configuration files and data volumes. For production deployments, using a dedicated directory like `/opt/speakr` or `/srv/speakr` is recommended as it provides a clear separation from user home directories and follows Linux filesystem hierarchy standards.
+
+```bash
+mkdir -p /opt/speakr
+cd /opt/speakr
+```
+
+If you're just testing or running Speakr for personal use, you can create the directory in your home folder instead. The location isn't critical, but keeping everything organized in one place makes management easier.
+
+### Step 2: Create Docker Compose Configuration
+
+Create a `docker-compose.yml` file with the following configuration:
+
+```yaml
+services:
+  app:
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    env_file:
+      - .env
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+```
+
+**Choosing an image tag:**
+
+| Tag | Size | Description |
+|-----|------|-------------|
+| `latest` | ~4.4GB | Full image with semantic search via PyTorch embeddings |
+| `lite` | ~725MB | Lightweight image without PyTorch — all features work, Inquire Mode falls back to text search |
+
+If you don't plan to use Inquire Mode's semantic search (or are fine with basic text search), the `lite` tag is recommended for faster pulls and less disk usage. Just replace `latest` with `lite` in the configuration above.
+
+Or download the example configuration:
+
+```bash
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/docker-compose.example.yml -O docker-compose.yml
+```
+
+The restart policy `unless-stopped` ensures Speakr automatically starts after system reboots unless you've explicitly stopped it. The volumes mount local directories for persistent storage of uploads and database files.
+
+### Step 3: Environment Configuration
+
+The environment configuration is where you tell Speakr which AI services to use and how to connect to them. Download the appropriate environment template based on your transcription service choice. This template contains all the configuration variables with helpful comments explaining each setting.
+
+#### For OpenAI with Speaker Diarization (Cloud-Based)
+
+If you don't want to self-host a transcription service, the easiest way to get speaker diarization is using OpenAI's `gpt-4o-transcribe-diarize` model. This requires only an OpenAI API key—no additional containers needed.
+
+Download the unified transcription configuration template:
+
+```bash
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.transcription.example -O .env
+```
+
+Configure your transcription service with just two key settings:
+
+```bash
+TRANSCRIPTION_API_KEY=sk-your-openai-key-here
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+```
+
+The connector automatically detects that you want the OpenAI Transcribe connector based on the model name. Other available models:
+
+- `gpt-4o-transcribe` - High quality without diarization
+- `gpt-4o-mini-transcribe` - Cost-effective option
+- `whisper-1` - Legacy model (uses Whisper connector)
+
+> **Note:** For longer files (over ~23 minutes) using `gpt-4o-transcribe-diarize`, speaker tracking across chunks supports up to 4 speakers. Recordings with more speakers may have inconsistent labels across sections.
+
+Now configure the text generation model that powers summaries, titles, and chat features. OpenRouter is recommended here because it provides access to multiple AI models at competitive prices, but you can use any OpenAI-compatible service:
+
+```bash
+TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
+TEXT_MODEL_API_KEY=sk-or-v1-your-key-here
+TEXT_MODEL_NAME=openai/gpt-4o-mini
+```
+
+If you prefer to use OpenAI directly for text generation, simply change the base URL to `https://api.openai.com/v1` and use your OpenAI API key. You can also use local models through Ollama or LM Studio by pointing to `http://localhost:11434/v1` or similar.
+
+> **Tip:** For advanced model configuration options—including GPT-5 support, separate chat model settings for different service tiers, and cost optimization strategies—see the [Model Configuration](../admin-guide/model-configuration.md) guide.
+
+#### For Legacy OpenAI Whisper API
+
+If you prefer the legacy Whisper API (without diarization), you can still use the legacy configuration:
+
+```bash
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.whisper.example -O .env
+```
+
+Configure the transcription service:
+
+```bash
+TRANSCRIPTION_BASE_URL=https://api.openai.com/v1
+TRANSCRIPTION_API_KEY=sk-your-openai-key-here
+TRANSCRIPTION_MODEL=whisper-1
+```
+
+> **Note:** The `WHISPER_MODEL` variable is deprecated. Use `TRANSCRIPTION_MODEL` instead.
+
+#### For Self-Hosted ASR Endpoint (Recommended for Best Quality)
+
+For the best transcription and diarization quality, self-hosting an ASR service is recommended. Based on testing, the WhisperX ASR Service with the latest pyannote models provides significantly better transcription accuracy and speaker diarization than cloud-based alternatives, especially when using large models like `large-v3`. **This requires running an additional Docker container** alongside Speakr, but provides powerful features including voice profiles that remember speakers across recordings.
+
+**ASR Service Options:**
+
+1. **WhisperX ASR Service (Recommended)** - Best transcription quality with voice profile support
+    - Repository: [murtaza-nasir/whisperx-asr-service](https://github.com/murtaza-nasir/whisperx-asr-service)
+    - Uses `pyannote/speaker-diarization-community-1` model with exclusive diarization
+    - **Superior transcription and diarization quality** with large models (large-v3, distil-large-v3)
+    - Supports 256-dimensional speaker embeddings for voice profile identification
+    - Better timestamp alignment between speakers and words
+    - **Required for:** Voice profiles, automatic speaker recognition, speaker embeddings
+    - **Environment file:** `config/env.whisperx.example`
+    - **Required setting:** `ASR_RETURN_SPEAKER_EMBEDDINGS=true` to enable voice profile features
+
+2. **OpenAI Whisper ASR Webservice** - For basic speaker diarization without voice profiles
+    - Repository: [ahmetoner/whisper-asr-webservice](https://github.com/ahmetoner/whisper-asr-webservice)
+    - Uses `pyannote/speaker-diarization-3.1` model
+    - Simpler setup, less resource intensive
+    - **Supports:** Basic speaker identification (Speaker 1, Speaker 2, etc.)
+    - **Does not support:** Voice profiles, speaker embeddings, automatic speaker recognition
+    - **Environment file:** `config/env.asr.example`
+    - **Note:** Do not set `ASR_RETURN_SPEAKER_EMBEDDINGS=true` with this service as it will cause errors
+
+> **Important:** Before proceeding with this configuration, you'll need to set up one of the ASR service containers. See [Running ASR Service for Speaker Diarization](#running-asr-service-for-speaker-diarization) for complete instructions on deploying both containers together or separately.
+
+Download the appropriate ASR configuration template:
+
+```bash
+# For WhisperX ASR Service (with voice profiles):
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.whisperx.example -O .env
+
+# OR for basic ASR (without voice profiles):
+wget https://raw.githubusercontent.com/murtaza-nasir/speakr/master/config/env.asr.example -O .env
+```
+
+The ASR configuration tells Speakr where to find your ASR service. Simply set the base URL and Speakr will automatically detect ASR mode:
+
+```bash
+# For WhisperX ASR Service:
+ASR_BASE_URL=http://whisperx-asr:9000
+
+# OR for basic ASR Webservice:
+ASR_BASE_URL=http://whisper-asr:9000
+```
+
+> **Note:** The `USE_ASR_ENDPOINT=true` setting is deprecated. Just setting `ASR_BASE_URL` automatically enables ASR mode.
+
+The ASR_BASE_URL depends on your deployment architecture:
+
+- **Same Docker Compose stack:** Use the service name (e.g., `http://whisperx-asr:9000` or `http://whisper-asr:9000`) - Docker's internal networking
+- **Separate machine:** Use the full URL with IP address or domain name (e.g., `http://192.168.1.100:9000`)
+
+Speaker diarization is automatically enabled when using ASR endpoints. The system will identify different speakers in your recordings and label them as Speaker 1, Speaker 2, and so on. You can optionally override the default speaker detection settings by uncommenting and adjusting ASR_MIN_SPEAKERS and ASR_MAX_SPEAKERS in your environment file.
+
+**Voice Profile Configuration:**
+
+If you're using WhisperX ASR Service and want to enable voice profile features (automatic speaker recognition across recordings), add this to your `.env` file:
+
+```bash
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+This setting is disabled by default because it's only supported by WhisperX. If you're using the basic OpenAI Whisper ASR Webservice, leave this setting disabled or omit it entirely to avoid errors.
+
+#### For Mistral Voxtral (Cloud-Based Diarization)
+
+Mistral's Voxtral model provides cloud-based transcription with built-in speaker diarization and automatic language detection. It requires a Mistral API key and no additional infrastructure. Voxtral handles chunking internally, so large files work without any extra configuration.
+
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-mistral-api-key
+TRANSCRIPTION_MODEL=voxtral-mini-latest
+```
+
+Configure the text generation model as described above for summaries and chat features.
+
+#### For VibeVoice ASR (Self-Hosted via vLLM)
+
+Microsoft's VibeVoice ASR model provides transcription with speaker diarization, timestamps, and language detection for 50+ languages. It runs entirely on your own hardware via vLLM, so there's no cloud dependency. The model handles up to 60 minutes of audio per request, and longer files are automatically chunked by the app.
+
+You'll need a vLLM server with the VibeVoice model loaded. The bf16 model requires roughly 18GB of VRAM, which fits on two consumer GPUs (like 2x RTX 3090) using tensor parallelism. See the [VibeVoice model page](https://huggingface.co/microsoft/VibeVoice-ASR) for vLLM setup instructions.
+
+```bash
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+TRANSCRIPTION_MODEL=vibevoice
+```
+
+If your vLLM server requires authentication, also set `TRANSCRIPTION_API_KEY`. Configure the text generation model as described above for summaries and chat features.
+
+### Step 4: Configure System Settings
+
+One of Speakr's conveniences is automatic admin account creation. Instead of going through a registration process, you define the admin credentials in your environment file, and Speakr creates the account automatically on first startup. This ensures you can log in immediately without any additional setup steps:
+
+```bash
+ADMIN_USERNAME=admin
+ADMIN_EMAIL=admin@your-domain.com
+ADMIN_PASSWORD=your-secure-password-here
+```
+
+Choose a strong password for this account as it has full system access, including the ability to manage users and view all recordings. The admin account is special and cannot be created through the regular registration process, only through these environment variables.
+
+Next, configure how the application behaves. These settings control user access and system operation:
+
+```bash
+ALLOW_REGISTRATION=false
+REGISTRATION_ALLOWED_DOMAINS=
+TIMEZONE="America/New_York"
+LOG_LEVEL="INFO"
+```
+
+Setting `ALLOW_REGISTRATION=false` means only the admin can create new user accounts, which is recommended for private installations where you want to control access. If you're running Speakr for a group or family, this prevents random people from creating accounts. If you enable registration and want to restrict it to specific email domains (e.g., for corporate use), set `REGISTRATION_ALLOWED_DOMAINS` to a comma-separated list of domains like `company.com,subsidiary.org`. Leave it empty to allow all domains. The timezone setting affects how dates and times are displayed throughout the interface, so set it to your local timezone for convenience. The log level controls how much information Speakr writes to its logs. Use `INFO` during initial setup and testing to see what's happening, then switch to `ERROR` for production to reduce log volume and improve performance.
+
+### Step 5: Configure Advanced Features
+
+#### Large File Handling
+
+Speakr automatically handles large audio files through intelligent chunking. The behavior depends on which transcription connector you're using:
+
+**Connector-Aware Chunking:**
+
+| Connector | Chunking Behavior |
+|-----------|-------------------|
+| **ASR Endpoint** | Handled internally by the ASR service—no app-level chunking needed |
+| **OpenAI Transcribe** | Handled internally using `chunking_strategy=auto`—no app-level chunking needed |
+| **OpenAI Whisper** | App-level chunking for files >25MB using your configured settings |
+
+For the OpenAI Whisper connector, you can customize chunking behavior:
+
+```bash
+ENABLE_CHUNKING=true
+CHUNK_LIMIT=20MB
+CHUNK_OVERLAP_SECONDS=3
+```
+
+When chunking is enabled, Speakr automatically detects when a file exceeds the configured limit and splits it into smaller pieces. Each chunk is processed separately, and the transcriptions are seamlessly merged back together. The overlap setting ensures that no words are lost at chunk boundaries, which is especially important for continuous speech. The chunk limit can be specified as a file size like `20MB` or as a duration like `20m` for 20 minutes.
+
+> **Note:** These chunking settings are ignored when using ASR Endpoint or OpenAI Transcribe connectors, as those services handle large files internally.
+
+#### Audio Compression
+
+Speakr can automatically compress lossless audio uploads to save storage space. This is particularly useful when users upload large WAV or AIFF files from professional recording equipment or phone apps that record in uncompressed formats.
+
+```bash
+AUDIO_COMPRESS_UPLOADS=true
+AUDIO_CODEC=mp3
+AUDIO_BITRATE=128k
+```
+
+When enabled (the default), lossless files are automatically converted on upload:
+
+| Setting | Options | Description |
+|---------|---------|-------------|
+| `AUDIO_COMPRESS_UPLOADS` | `true`/`false` | Enable automatic compression (default: `true`) |
+| `AUDIO_CODEC` | `mp3`, `flac`, `opus` | Target format (default: `mp3`) |
+| `AUDIO_BITRATE` | e.g., `64k`, `128k`, `192k` | Bitrate for lossy codecs (default: `128k`) |
+
+**Codec options:**
+
+- **mp3** - Lossy compression, excellent compatibility, smallest files (~90% reduction from WAV)
+- **flac** - Lossless compression, preserves full audio quality (~50-70% reduction from WAV)
+- **opus** - Modern lossy codec, efficient compression, good for speech
+
+Already-compressed formats (MP3, AAC, OGG, M4A, etc.) are never re-encoded to avoid quality degradation. Only truly lossless formats (WAV, AIFF) are compressed.
+
+**Excluding unsupported codecs:**
+
+Some transcription services don't support certain audio codecs. For example, vLLM-hosted Whisper instances may not support Opus. If you encounter "format not recognised" errors, you can exclude specific codecs from Speakr's supported list, forcing them to be converted before transcription:
+
+```bash
+# Exclude a single codec
+AUDIO_UNSUPPORTED_CODECS=opus
+
+# Exclude multiple codecs (comma-separated)
+AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+```
+
+Supported codecs by default: `pcm_s16le`, `pcm_s24le`, `pcm_f32le`, `mp3`, `flac`, `opus`, `vorbis`, `aac`. Any codec listed in `AUDIO_UNSUPPORTED_CODECS` will be automatically converted to your target format (set by `AUDIO_CODEC`) before being sent to the transcription service.
+
+!!! tip "Storage Savings Example"
+    A 500MB WAV recording compressed to MP3 at 128k becomes roughly 50MB - a 90% reduction. For lossless preservation, FLAC typically achieves 50-70% reduction while maintaining perfect audio quality.
+
+#### Video Retention
+
+By default, when users upload video files, Speakr extracts the audio and discards the video stream. If you want to preserve video for in-browser playback alongside the transcript, enable video retention:
+
+```bash
+VIDEO_RETENTION=true
+```
+
+When enabled, the original video file is kept and served with a native `<video>` player. Audio is extracted to a temporary file for transcription only, then cleaned up automatically. All player controls (seek, speed, volume) work identically. This is particularly useful for presentations, lectures, and screen recordings where the visual context adds value. Storage overhead is modest — video streams are typically only 10-20% of the total file size for presentation-style content.
+
+#### Video Passthrough to ASR
+
+If you run a custom ASR backend that accepts video files directly (e.g., one that extracts multiple audio tracks internally), you can skip Speakr's audio extraction entirely:
+
+```bash
+VIDEO_PASSTHROUGH_ASR=true
+```
+
+When enabled, video files are sent as-is to the ASR connector — no audio extraction, codec conversion, or chunking is performed. This only affects video uploads; audio files are processed normally. You can combine this with `VIDEO_RETENTION=true` to also keep the video for in-browser playback.
+
+!!! warning
+    Only enable this if your ASR backend actually accepts video files. Standard transcription APIs (OpenAI, etc.) will reject raw video input.
+
+#### Concurrent Upload Limit
+
+Control how many files upload simultaneously when batch uploading:
+
+```bash
+MAX_CONCURRENT_UPLOADS=3  # default
+```
+
+Higher values speed up batch uploads but use more bandwidth and server resources.
+
+#### Inquire Mode for Semantic Search
+
+Inquire Mode transforms Speakr from a simple transcription tool into a knowledge base of all your recordings. When enabled, you can search across all your transcriptions using natural language questions:
+
+```bash
+ENABLE_INQUIRE_MODE=true
+```
+
+With Inquire Mode active, Speakr creates embeddings of your transcriptions that enable semantic search. This means you can ask questions like "When did we discuss the marketing budget?" and find relevant recordings even if those exact words weren't used. The feature requires additional processing during transcription but provides powerful search capabilities that become more valuable as your recording library grows.
+
+#### Automated File Processing
+
+The automated file processing feature, sometimes called the "black hole" directory, monitors a designated folder for new audio files and automatically processes them without manual intervention. This is perfect for integrating with recording devices, automated workflows, or batch processing scenarios:
+
+```bash
+ENABLE_AUTO_PROCESSING=true
+AUTO_PROCESS_MODE=admin_only
+AUTO_PROCESS_WATCH_DIR=/data/auto-process
+AUTO_PROCESS_CHECK_INTERVAL=30
+```
+
+When enabled, Speakr checks the watch directory every 30 seconds for new audio files. Any files found are automatically moved to the uploads directory and processed using your configured transcription settings. The `admin_only` mode assigns all processed files to the admin user, but you can also configure it for multi-user scenarios with separate directories for each user.
+
+To use this feature, you'll need to mount an additional volume in your Docker Compose configuration, which we'll cover in the next steps.
+
+### Step 6: Set Up Data Directories
+
+Speakr needs local directories to store your data persistently. These directories are mounted as Docker volumes, ensuring your recordings and database survive container updates and restarts:
+
+```bash
+mkdir -p uploads instance
+chmod 755 uploads instance
+```
+
+The `uploads` directory stores all your audio files and their transcriptions, organized by user. The `instance` directory contains the SQLite database that tracks all your recordings, users, and settings. Setting the permissions to 755 ensures the Docker container can read and write to these directories while maintaining reasonable security.
+
+If you're using the automated file processing feature, create that directory as well:
+
+```bash
+mkdir -p auto-process
+chmod 755 auto-process
+```
+
+#### Using PostgreSQL Instead of SQLite
+
+By default, Speakr uses SQLite for its database, which is perfect for most installations and requires no additional setup.
+However, if you need the scalability and concurrent access capabilities of PostgreSQL, Speakr fully supports it.
+
+**Configuration:**
+
+To use PostgreSQL, set the `SQLALCHEMY_DATABASE_URI` environment variable in your `.env` file:
+
+```bash
+SQLALCHEMY_DATABASE_URI=postgresql://username:password@hostname:5432/database_name
+```
+
+### Step 7: Launch Speakr
+
+With everything configured, you're ready to start Speakr. The `-d` flag runs the container in detached mode, meaning it continues running in the background:
+
+```bash
+docker compose up -d
+```
+
+The first time you run this command, Docker will download the Speakr image from Docker Hub. The `latest` image is approximately 4.4GB (or ~725MB for the `lite` tag) and contains all the dependencies needed to run Speakr, including FFmpeg for audio processing and various Python libraries. The download time depends on your internet connection speed.
+
+Monitor the startup process to ensure everything is working correctly:
+
+```bash
+docker compose logs -f app
+```
+
+Watch the logs for any error messages. You should see messages about database initialization, admin user creation, and finally a message indicating the Flask application is running on port 8899. Press Ctrl+C to stop following the logs (this won't stop the container, just the log viewing).
+
+### Step 8: Verify Installation
+
+Open your web browser and navigate to `http://your-server:8899`, replacing `your-server` with your actual server address or `localhost` if you're running locally. You should see the Speakr login page with its distinctive gradient design.
+
+Log in using the admin credentials you configured in the environment file. If login fails, check your Docker logs to ensure the admin user was created successfully. Sometimes typos in the environment file can cause issues.
+
+Once logged in, test the installation by creating a test recording or uploading a sample audio file. The recording interface should show options for microphone, system audio, or both. Try uploading a small audio file first to verify that your API keys are working correctly. The transcription process should complete within a few moments for short files, and you should see the transcribed text appear along with an AI-generated summary.
+
+If transcription fails, check the Docker logs for API authentication errors or connection issues. Common problems include incorrect API keys, insufficient API credits, or network connectivity issues.
+
+## Advanced Deployment Scenarios
+
+### Running ASR Service for Speaker Diarization
+
+If you need speaker diarization to identify different speakers in your recordings, you'll need to run an ASR service alongside Speakr. There are two options depending on whether you need voice profile features:
+
+#### Option 1: WhisperX ASR Service (Recommended - Supports Voice Profiles)
+
+**Use this if you want:**
+
+- AI-powered speaker voice profiles with automatic recognition
+- 256-dimensional speaker embeddings
+- Better speaker-to-word timestamp alignment
+- Exclusive diarization for cleaner speaker transitions
+
+**Prerequisites:**
+
+1. **Hugging Face Account & Model Access** - Visit and accept terms for ALL models:
+    - [pyannote/speaker-diarization-community-1](https://huggingface.co/pyannote/speaker-diarization-community-1)
+    - [pyannote/speaker-diarization-3.1](https://huggingface.co/pyannote/speaker-diarization-3.1)
+    - [pyannote/segmentation-3.0](https://huggingface.co/pyannote/segmentation-3.0)
+
+2. **Generate HF Token** - Create a read-access token at [Hugging Face Settings](https://huggingface.co/settings/tokens)
+
+3. **GPU Requirements** - NVIDIA GPU with 14GB+ VRAM for large-v3 model (RTX 3090/4090 recommended)
+
+**Setup Instructions:**
+
+Clone the WhisperX ASR Service repository:
+```bash
+git clone https://github.com/murtaza-nasir/whisperx-asr-service.git
+cd whisperx-asr-service
+
+# Copy environment file
+cp .env.example .env
+
+# Edit .env and add your Hugging Face token
+nano .env  # Set HF_TOKEN=hf_xxxxx...
+
+# Build and start
+docker compose up -d
+
+# Verify it's running
+curl http://localhost:9000/health
+```
+
+See the [WhisperX ASR Service README](https://github.com/murtaza-nasir/whisperx-asr-service#readme) for detailed configuration options, troubleshooting, and performance tuning.
+
+!!! warning "PyTorch 2.6 Compatibility"
+    If you encounter a "Weights only load failed" error, add `TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true` to your ASR container's environment variables in docker-compose.yml. See [troubleshooting](../troubleshooting.md#pytorch-26-weights-loading-error-whisperx-asr-service) for details.
+
+#### Option 2: OpenAI Whisper ASR Webservice (Basic Diarization Only)
+
+**Use this if you:**
+
+- Only need basic speaker identification (Speaker 1, Speaker 2, etc.)
+- Don't need voice profiles or speaker embeddings
+- Want simpler setup with lower resource requirements
+
+**Prerequisites:**
+
+1. **Hugging Face Account & Model Access** - Visit and accept terms:
+    - [pyannote/speaker-diarization-3.1](https://huggingface.co/pyannote/speaker-diarization-3.1)
+    - [pyannote/segmentation-3.0](https://huggingface.co/pyannote/segmentation-3.0)
+
+2. **Generate HF Token** - Create a read-access token at [Hugging Face Settings](https://huggingface.co/settings/tokens)
+
+**Setup Instructions:**
+
+Visit the [ahmetoner/whisper-asr-webservice repository](https://github.com/ahmetoner/whisper-asr-webservice) for complete setup instructions.
+
+#### Deploying ASR Service with Speakr
+
+Once you've chosen and set up your ASR service, you can deploy it alongside Speakr in several ways:
+
+**Same Machine - Combined Docker Compose (Recommended)**
+
+Example with WhisperX ASR Service (for voice profiles):
+
+```yaml
+services:
+  whisperx-asr:
+    build:
+      context: ./whisperx-asr-service
+      dockerfile: Dockerfile
+    container_name: whisperx-asr-api
+    restart: unless-stopped
+    ports:
+      - "9000:9000"
+    environment:
+      - DEVICE=cuda
+      - COMPUTE_TYPE=float16
+      - BATCH_SIZE=16
+      - HF_TOKEN=your_huggingface_token_here
+      - TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true  # Required for PyTorch 2.6+
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: all
+              capabilities: [gpu]
+    volumes:
+      - whisperx-cache:/.cache
+    networks:
+      - speakr-network
+
+  app:
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    env_file:
+      - .env
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+    depends_on:
+      - whisperx-asr
+    networks:
+      - speakr-network
+
+networks:
+  speakr-network:
+    driver: bridge
+
+volumes:
+  whisperx-cache:
+    driver: local
+```
+
+In Speakr's `.env` file:
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+```
+
+> **Note for Mac users:** GPU passthrough doesn't work on macOS due to Docker's architecture. Use CPU mode by setting `DEVICE=cpu` and `COMPUTE_TYPE=float32` in the environment variables. The ASR service will use CPU processing, which is slower but fully functional.
+
+**Important:** When running both services in the same Docker Compose file, use the service name (e.g., `whisperx-asr` or `whisper-asr`) in `ASR_BASE_URL`, not `localhost` or an IP address.
+
+#### Running Services in Separate Docker Compose Files
+
+If you prefer to manage the services independently or are adding the ASR service to an existing Speakr installation, you can run them in separate Docker Compose files. This approach gives you more flexibility and works whether the services are on the same machine or different machines.
+
+##### Option 1: Same Machine with Shared Network
+
+If both services run on the same machine, you can use Docker's internal networking for communication:
+
+First, create a shared Docker network:
+
+```bash
+docker network create speakr-network
+```
+
+Create `docker-compose.asr.yml` for the ASR service:
+
+```yaml
+services:
+  whisper-asr:
+    image: onerahmet/openai-whisper-asr-webservice:latest-gpu
+    container_name: whisper-asr-webservice
+    ports:
+      - "9000:9000"
+    environment:
+      - ASR_MODEL=distil-large-v3
+      - ASR_COMPUTE_TYPE=int8
+      - ASR_ENGINE=whisperx
+      - HF_TOKEN=your_huggingface_token_here
+      - TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true  # Required for PyTorch 2.6+
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              capabilities: [gpu]
+              device_ids: ["0"]
+    restart: unless-stopped
+    networks:
+      - speakr-network
+
+networks:
+  speakr-network:
+    external: true
+```
+
+Update your Speakr `docker-compose.yml` to use the shared network:
+
+```yaml
+services:
+  app:
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    env_file:
+      - .env
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+    networks:
+      - speakr-network
+
+networks:
+  speakr-network:
+    external: true
+```
+
+In your `.env` file, use the container name:
+```bash
+ASR_BASE_URL=http://whisper-asr-webservice:9000
+```
+
+##### Option 2: Separate Machines
+
+When running on different machines, you don't need the shared network. Each service runs independently and communicates over the network using IP addresses or hostnames.
+
+On the ASR server, create `docker-compose.asr.yml`:
+
+```yaml
+services:
+  whisper-asr:
+    image: onerahmet/openai-whisper-asr-webservice:latest-gpu
+    container_name: whisper-asr-webservice
+    ports:
+      - "9000:9000"  # Exposed to the network
+    environment:
+      - ASR_MODEL=distil-large-v3
+      - ASR_COMPUTE_TYPE=int8
+      - ASR_ENGINE=whisperx
+      - HF_TOKEN=your_huggingface_token_here
+      - TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true  # Required for PyTorch 2.6+
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              capabilities: [gpu]
+              device_ids: ["0"]
+    restart: unless-stopped
+```
+
+On the Speakr server, use the standard `docker-compose.yml`:
+
+```yaml
+services:
+  app:
+    image: learnedmachine/speakr:latest
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    env_file:
+      - .env
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+```
+
+In your Speakr `.env` file, use the ASR server's IP address or hostname:
+```bash
+# Using IP address
+ASR_BASE_URL=http://192.168.1.100:9000
+
+# Or using hostname
+ASR_BASE_URL=http://asr-server.local:9000
+```
+
+Start both services on their respective machines:
+
+```bash
+# On ASR server
+docker compose -f docker-compose.asr.yml up -d
+
+# On Speakr server
+docker compose up -d
+```
+
+Make sure port 9000 is accessible between the machines (check firewall rules if needed).
+
+## Production Considerations
+
+### Using a Reverse Proxy for SSL
+
+For production deployments, running Speakr behind a reverse proxy is essential for security and enabling all features. The browser recording feature, particularly system audio capture, requires HTTPS to work due to browser security restrictions. A reverse proxy handles SSL termination, meaning it manages the HTTPS certificates while communicating with Speakr over HTTP internally.
+
+Here's a complete nginx configuration for Speakr:
+
+```nginx
+server {
+    listen 443 ssl http2;
+    server_name speakr.yourdomain.com;
+
+    ssl_certificate /path/to/certificate.crt;
+    ssl_certificate_key /path/to/private.key;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+
+    # Allow large uploads — match or exceed your Speakr MAX_CONTENT_LENGTH /
+    # max_file_size_mb. Set to 0 for unlimited.
+    client_max_body_size 4000M;
+
+    location / {
+        proxy_pass http://localhost:8899;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # Stream the upload through to Speakr instead of buffering the whole
+        # file on the proxy first. Useful safety net for very large uploads
+        # that would otherwise exhaust the proxy's temp space.
+        proxy_request_buffering off;
+
+        # WebSocket support for live features. Forward the client's
+        # Connection header verbatim ($http_connection) so a regular POST
+        # upload keeps `Connection: keep-alive` and an actual WebSocket
+        # handshake keeps `Connection: upgrade`. Setting it to a literal
+        # "upgrade" on every request causes Gunicorn (Speakr's WSGI server)
+        # to return 500 errors on uploads.
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection $http_connection;
+
+        # Timeouts for large file uploads
+        proxy_read_timeout 300s;
+        proxy_send_timeout 300s;
+    }
+}
+
+# Redirect HTTP to HTTPS
+server {
+    listen 80;
+    server_name speakr.yourdomain.com;
+    return 301 https://$server_name$request_uri;
+}
+```
+
+!!! warning "If your existing nginx config sets `Connection: "upgrade"` unconditionally"
+    A common pitfall: setting `proxy_set_header Connection "upgrade"` directly inside `location /` forwards `Connection: upgrade` on every request, including plain POST uploads. Gunicorn does not handle this gracefully on non-WebSocket requests and may return 500 errors with "Service unavailable" when uploading files through the proxy. The fix is to forward the client's actual Connection header instead: change the line to `proxy_set_header Connection $http_connection;` (a single-word change). An equivalent and slightly stricter alternative is the `map $http_upgrade $connection_upgrade { default upgrade; '' close; }` block in the http section paired with `proxy_set_header Connection $connection_upgrade;` inside `location /`. Both approaches work; the `$http_connection` form is what Nginx Proxy Manager uses internally and needs no http-block changes.
+
+The WebSocket configuration is important for real-time features in Speakr. The timeout settings ensure large file uploads don't get interrupted. You can obtain free SSL certificates from Let's Encrypt using Certbot, making HTTPS accessible for everyone.
+
+#### Nginx Proxy Manager
+
+Nginx Proxy Manager handles the WebSocket-upgrade pattern correctly in its default templates (it uses `proxy_set_header Connection $http_connection` in each generated proxy host), so a vanilla NPM proxy host pointed at `http://<speakr-host>:8899` typically works without any custom nginx tuning. Three notes worth knowing:
+
+- NPM bakes `client_max_body_size 2000m` into its main `nginx.conf`, so every proxy host inherits a 2 GB default unless you override it. Plenty for normal Speakr uploads. If you need higher (or unlimited), put `client_max_body_size 0;` in the **Advanced** tab on the Speakr proxy host.
+- Anything pasted into a proxy host's Advanced tab is rendered into the per-host `.conf` file under `/data/nginx/proxy_host/`. Use this for per-host tweaks like `proxy_request_buffering off;` on a constrained proxy host.
+- Global tweaks across every host go into the files under `/data/nginx/custom/`: `http_top.conf` for the http block, `server_proxy.conf` for directives inside every proxy host's server block. Useful for headers and rate limiting that should apply everywhere.
+
+If you prefer Apache, here's an equivalent configuration:
+
+```apache
+<VirtualHost *:443>
+    ServerName speakr.yourdomain.com
+
+    SSLEngine on
+    SSLCertificateFile /path/to/certificate.pem
+    SSLCertificateKeyFile /path/to/private.key
+
+    # Security Headers
+    Header always set X-Frame-Options "SAMEORIGIN"
+    Header always set X-Content-Type-Options "nosniff"
+    Header always set X-XSS-Protection "1; mode=block"
+
+    # Proxy settings
+    ProxyPreserveHost On
+    ProxyRequests Off
+
+    # Handle WebSockets for real-time features
+    RewriteEngine On
+    RewriteCond %{HTTP:Upgrade} websocket [NC]
+    RewriteCond %{HTTP:Connection} upgrade [NC]
+    RewriteRule ^/?(.*) "ws://localhost:8899/$1" [P,L]
+
+    <Location />
+        ProxyPass http://localhost:8899/
+        ProxyPassReverse http://localhost:8899/
+        RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
+    </Location>
+
+    # Timeout for large uploads
+    ProxyTimeout 300
+</VirtualHost>
+
+<VirtualHost *:80>
+    ServerName speakr.yourdomain.com
+
+    # Redirect to HTTPS
+    RewriteEngine On
+    RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [END,NE,R=permanent]
+</VirtualHost>
+```
+
+Apache requires these modules: `sudo a2enmod ssl proxy proxy_http proxy_wstunnel rewrite headers`
+
+### Backup Strategy
+
+Regular backups are essential for production deployments. Your Speakr data consists of three critical components that need backing up: the SQLite database in the `instance` directory, the audio files and transcriptions in the `uploads` directory, and your configuration in the `.env` file.
+
+Create a backup script that captures all three components:
+
+```bash
+#!/bin/bash
+BACKUP_DIR="/backup/speakr"
+DATE=$(date +%Y%m%d_%H%M%S)
+
+# Create backup directory if it doesn't exist
+mkdir -p "$BACKUP_DIR"
+
+# Create the backup
+tar czf "$BACKUP_DIR/speakr_backup_$DATE.tar.gz" \
+    /opt/speakr/instance \
+    /opt/speakr/uploads \
+    /opt/speakr/.env
+
+# Optional: Keep only last 30 days of backups
+find "$BACKUP_DIR" -name "speakr_backup_*.tar.gz" -mtime +30 -delete
+
+echo "Backup completed: speakr_backup_$DATE.tar.gz"
+```
+
+Make the script executable and schedule it with cron for automated daily backups:
+
+```bash
+chmod +x /opt/speakr/backup.sh
+crontab -e
+# Add this line for daily backups at 2 AM:
+0 2 * * * /opt/speakr/backup.sh
+```
+
+For critical deployments, consider copying backups to remote storage or cloud services for additional redundancy. The compressed backup size is typically much smaller than the original data, as audio files compress well.
+
+### Monitoring and Maintenance
+
+Proactive monitoring helps prevent issues before they impact users. Audio files can consume significant storage over time, especially if you're recording long meetings regularly. Set up disk space monitoring with alerts when usage exceeds 80%. A simple monitoring approach uses cron with df:
+
+```bash
+#!/bin/bash
+USAGE=$(df /opt/speakr | tail -1 | awk '{print $5}' | sed 's/%//')
+if [ $USAGE -gt 80 ]; then
+    echo "Warning: Speakr disk usage is at ${USAGE}%" | mail -s "Speakr Disk Alert" admin@example.com
+fi
+```
+
+Monitor the Docker container health and logs regularly. You can use Docker's built-in health check feature or external monitoring tools. Check for patterns like repeated API failures, authentication errors, or processing timeouts. Also track your API usage and costs with your transcription service provider, as costs can add up with heavy usage.
+
+### Security Hardening
+
+Production deployments require additional security measures beyond the default configuration. Start by ensuring strong passwords for all accounts, especially the admin account. Never use default or simple passwords in production.
+
+Restrict network access using firewall rules. If Speakr is only used internally, limit access to your organization's IP ranges:
+
+```bash
+# Example using ufw
+ufw allow from 192.168.1.0/24 to any port 8899
+ufw deny 8899
+```
+
+Implement rate limiting at the reverse proxy level to prevent abuse and API exhaustion. In nginx, you can add:
+
+```nginx
+limit_req_zone $binary_remote_addr zone=speakr:10m rate=10r/s;
+limit_req zone=speakr burst=20;
+```
+
+Keep the Docker image updated with the latest security patches. Check for updates regularly and plan maintenance windows for updates. Always backup before updating, and test updates in a staging environment first if possible.
+
+## Updating Speakr
+
+Keeping Speakr updated ensures you have the latest features and security patches. The update process is straightforward but should be done carefully to avoid data loss.
+
+First, always create a backup before updating:
+
+```bash
+# Create a backup
+tar czf speakr_backup_before_update.tar.gz uploads/ instance/ .env
+
+# Pull the latest image
+docker compose pull
+
+# Stop the current container
+docker compose down
+
+# Start with the new image
+docker compose up -d
+
+# Check the logs to ensure successful startup
+docker compose logs -f app
+```
+
+The update process preserves all your data since it's stored in mounted volumes outside the container. However, checking the release notes is important as some updates might require configuration changes or have breaking changes that need attention.
+
+If an update causes issues, you can rollback by specifying the previous version in your docker-compose.yml file:
+
+```yaml
+image: learnedmachine/speakr:v1.2.3  # Replace with your previous version
+```
+
+## Troubleshooting Common Issues
+
+### Container Won't Start
+
+When the container fails to start, the logs usually tell you exactly what's wrong. Check them first:
+
+```bash
+docker compose logs app
+```
+
+Common startup issues include missing or malformed `.env` files. Ensure your `.env` file exists and has proper syntax. Each line should be `KEY=value` with no spaces around the equals sign. Comments start with `#`.
+
+Port conflicts are another common issue. Check if port 8899 is already in use:
+
+```bash
+netstat -tulpn | grep 8899
+# Or on macOS:
+lsof -i :8899
+```
+
+If the port is in use, either stop the conflicting service or change Speakr's port in docker-compose.yml.
+
+### Transcription Failures
+
+Transcription failures usually stem from API configuration issues. Check the Docker logs for specific error messages:
+
+```bash
+docker compose logs app | grep -i error
+```
+
+Common transcription issues include incorrect API keys, which show as authentication errors in the logs. Double-check your keys in the `.env` file and ensure they're for the correct service. Insufficient API credits will show as quota or payment errors. Check your account balance with your API provider. Network connectivity issues appear as connection timeouts or DNS resolution failures.
+
+For ASR endpoints, verify the service is running and accessible:
+
+```bash
+# Test ASR endpoint connectivity
+curl http://your-asr-service:9000/docs
+```
+
+If using Docker networking with service names, remember that containers must be on the same network to communicate.
+
+### Performance Issues
+
+Slow performance can have multiple causes. Start by checking system resources:
+
+```bash
+# Check memory usage
+free -h
+
+# Check disk I/O
+iotop
+
+# Check Docker resource usage
+docker stats speakr
+```
+
+If memory is constrained, consider adding swap space or upgrading your server. For disk I/O issues, ensure you're using SSD storage for the uploads and instance directories. Traditional hard drives can significantly slow down operations, especially with multiple concurrent users.
+
+For large file processing, ensure chunking is properly configured. Without chunking, large files might timeout or fail completely. The chunk size should be slightly below your API's limit to account for encoding overhead.
+
+If you're seeing slow transcription with many concurrent users, you might be hitting API rate limits. Check your API provider's documentation for rate limits and consider upgrading your plan if needed.
+
+### Browser Recording Issues
+
+If browser recording isn't working, especially system audio, the most common cause is using HTTP instead of HTTPS. Browsers require secure connections for audio capture due to privacy concerns. Either set up SSL with a reverse proxy or, for local development only, modify your browser's security settings to treat your local URL as secure.
+
+In Chrome, navigate to `chrome://flags`, search for "insecure origins", and add your URL to the list. Remember this reduces security and should only be used for development.
+
+## Building from Source
+
+If you need to modify Speakr's code or prefer building your own images, you can build from source. This requires cloning the repository and using Docker's build capability.
+
+First, clone the repository and navigate to it:
+
+```bash
+git clone https://github.com/murtaza-nasir/speakr.git
+cd speakr
+```
+
+Modify the docker-compose.yml to build locally instead of using the pre-built image:
+
+```yaml
+services:
+  app:
+    build:
+      context: .
+      args:
+        LIGHTWEIGHT: 0  # Set to 1 for a smaller image without PyTorch
+    image: speakr:custom  # Tag for your custom build
+    container_name: speakr
+    restart: unless-stopped
+    ports:
+      - "8899:8899"
+    env_file:
+      - .env
+    volumes:
+      - ./uploads:/data/uploads
+      - ./instance:/data/instance
+```
+
+Build and start your custom version:
+
+```bash
+docker compose up -d --build
+```
+
+To build a lightweight image without PyTorch directly:
+
+```bash
+docker build --build-arg LIGHTWEIGHT=1 -t speakr:lite .
+```
+
+The `--build` flag forces Docker to rebuild the image even if one exists. This is useful when you've made code changes and want to test them.
+
+## Performance Optimization
+
+For high-volume deployments or when processing many large files, optimization becomes important. Start with model selection if using ASR. For English-only content, the `distil-large-v3` model offers an excellent balance of speed and accuracy. For multilingual content, use `large-v3-turbo` which performs well across languages while being faster and using less memory than the full `large-v3` model.
+
+Optimize Docker resource allocation for your workload:
+
+```yaml
+services:
+  app:
+    image: learnedmachine/speakr:latest
+    deploy:
+      resources:
+        limits:
+          memory: 8G
+          cpus: '4'
+        reservations:
+          memory: 4G
+          cpus: '2'
+```
+
+This ensures Speakr has enough resources while preventing it from consuming everything on shared servers.
+
+For storage performance, use SSD drives for the Docker volumes. The database benefits significantly from fast random I/O, and large audio file processing is much faster with SSDs. If using network storage, ensure low latency connections.
+
+---
+
+Next: [User Guide](../user-guide/index.md) to learn how to use all of Speakr's features
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..b69832d3
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,386 @@
+# Welcome to Speakr
+
+Speakr is a powerful self-hosted transcription platform that helps you capture, transcribe, and understand your audio content. Whether you're recording meetings, interviews, lectures, or personal notes, Speakr transforms spoken words into valuable, searchable knowledge.
+
+<div style="max-width: 80%; margin: 2em auto;">
+  <img src="assets/images/screenshots/Main view.png" alt="Main Interface" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+</div>
+
+!!! warning "Latest Release: v0.8.20-alpha - Security Patch (Open Redirect)"
+    **Open-redirect fix in `is_safe_url` (CWE-601).** Users on v0.8.19-alpha or earlier should upgrade promptly.
+
+    - The validator previously checked `urljoin`-normalised URLs while `redirect()` used the raw value, so `next=////evil.com` could redirect users off-site after sign-in.
+    - `is_safe_url()` now validates the raw target against a local-path allowlist; the SSO `next` / callback flow and password login share one validator.
+    - Reported by **RacerZ and Fushuling**. Tracked as a GitHub Security Advisory; CVE pending.
+
+## Quick Navigation
+
+<div class="grid cards">
+  <div class="card">
+    <div class="card-icon">📚</div>
+    <h3>Getting Started</h3>
+    <p>New to Speakr? Start here for a quick overview and setup guide.</p>
+    <a href="getting-started" class="card-link">Get Started →</a>
+  </div>
+  
+  <div class="card">
+    <div class="card-icon">🚀</div>
+    <h3>Installation</h3>
+    <p>Step-by-step instructions for Docker and manual installation.</p>
+    <a href="getting-started/installation" class="card-link">Install Now →</a>
+  </div>
+  
+  <div class="card">
+    <div class="card-icon">👤</div>
+    <h3>User Guide</h3>
+    <p>Learn how to <a href="user-guide/recording">record</a>, <a href="user-guide/transcripts">transcribe</a>, and manage your audio content.</p>
+    <a href="user-guide/" class="card-link">Learn More →</a>
+  </div>
+  
+  <div class="card">
+    <div class="card-icon">⚙️</div>
+    <h3>Admin Guide</h3>
+    <p>Configure <a href="admin-guide/user-management">users</a>, <a href="admin-guide/prompts">system settings</a>, and manage your instance.</p>
+    <a href="admin-guide/" class="card-link">Configure →</a>
+  </div>
+  
+  <div class="card">
+    <div class="card-icon">❓</div>
+    <h3>FAQ</h3>
+    <p>Find answers to commonly asked questions about Speakr.</p>
+    <a href="faq" class="card-link">View FAQ →</a>
+  </div>
+  
+  <div class="card">
+    <div class="card-icon">🔧</div>
+    <h3>Troubleshooting</h3>
+    <p>Solutions for <a href="troubleshooting#transcription-problems">transcription issues</a> and <a href="troubleshooting#performance-issues">performance problems</a>.</p>
+    <a href="troubleshooting" class="card-link">Get Help →</a>
+  </div>
+</div>
+
+## Core Features
+
+<div class="feature-grid">
+  <div class="feature-card">
+    <h4>🎙️ Smart Recording</h4>
+    <ul>
+      <li>Audio capture from mic or system</li>
+      <li>Take notes while recording</li>
+      <li>Generate <a href="features#automatic-summarization">smart summaries</a></li>
+    </ul>
+  </div>
+  
+  <div class="feature-card">
+    <h4>🤖 AI Transcription</h4>
+    <ul>
+      <li><a href="features#language-support">Multi-language support</a></li>
+      <li><a href="features#speaker-diarization">Speaker identification</a></li>
+      <li><a href="features#speaker-management">Voice profiles with AI recognition</a></li>
+      <li>Custom vocabularies</li>
+    </ul>
+  </div>
+  
+  <div class="feature-card">
+    <h4>🔍 Intelligent Search</h4>
+    <ul>
+      <li><a href="user-guide/inquire-mode">Semantic search</a></li>
+      <li>Natural language queries</li>
+      <li>Cross-recording search</li>
+    </ul>
+  </div>
+  
+  <div class="feature-card">
+    <h4>📊 Organization</h4>
+    <ul>
+      <li><a href="features#tagging-system">Smart tagging system</a></li>
+      <li><a href="admin-guide/prompts">Custom AI prompts with stacking</a></li>
+      <li><a href="features#speaker-management">Speaker voice profiles with auto-cleanup</a></li>
+    </ul>
+  </div>
+  
+  <div class="feature-card">
+    <h4>🌍 International</h4>
+    <ul>
+      <li>5+ languages supported</li>
+      <li>Automatic UI translation</li>
+      <li>Localized summaries</li>
+    </ul>
+  </div>
+  
+  <div class="feature-card">
+    <h4>🔒 Privacy First</h4>
+    <ul>
+      <li><a href="getting-started/installation">Self-hosting ready</a></li>
+      <li><a href="troubleshooting#offline-deployment">Offline-ready</a></li>
+      <li><a href="user-guide/sharing">Secure sharing</a></li>
+    </ul>
+  </div>
+
+  <div class="feature-card">
+    <h4>🔑 REST API</h4>
+    <ul>
+      <li><a href="user-guide/api-reference">Full REST API v1</a></li>
+      <li><a href="user-guide/api-tokens">Personal access tokens</a></li>
+      <li>Interactive <a href="user-guide/api-reference#openapi-specification">Swagger UI docs</a></li>
+      <li>n8n, Zapier, Make integration</li>
+    </ul>
+  </div>
+</div>
+
+## Interactive Audio Synchronization
+
+Experience seamless bidirectional synchronization between your audio and transcript. Click any part of the transcript to jump directly to that moment in the audio, or watch as the system automatically highlights the currently spoken text as the audio plays. Enable auto-scroll follow mode to keep the active segment centered in view, creating an effortless reading experience for even the longest recordings.
+
+<div style="max-width: 90%; margin: 2em auto;">
+  <img src="assets/images/screenshots/audio-sync-bubble-view.png" alt="Real-time audio-transcript synchronization" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+  <p style="text-align: center; margin-top: 0.5rem; font-style: italic; color: #666;">Real-time transcript highlighting synchronized with audio playback, with auto-scroll follow mode</p>
+</div>
+
+Learn more about [audio synchronization features](user-guide/transcripts.md#audio-synchronization-and-follow-mode) in the user guide.
+
+!!! tip "Transform Your Recordings with Custom Tag Prompts"
+    Tags aren't just for organization - they transform content. Create a "Recipe" tag to convert cooking narration into formatted recipes. Use "Study Notes" tags to turn lecture recordings into organized outlines. Stack tags like "Client Meeting" + "Legal Review" for combined analysis. Learn more in the [Custom Prompts guide](admin-guide/prompts.md#creative-tag-prompt-use-cases).
+
+## Latest Updates
+
+!!! info "Version 0.8.19-alpha - Inquire-mode performance and re-embed reliability"
+    Patch release on top of v0.8.18-alpha. No new features, no breaking changes.
+
+    - Vectorised chunk similarity search. Per-query Inquire search drops from 13-20s to under 1s on a ~17k-chunk library. A 4-enriched-query inquire turn now completes in 2-3s instead of ~60s.
+    - Embedding API retries on transient errors (rate limits, timeouts, 5xx, connection blips) with exponential backoff. Tunable via `EMBEDDING_API_MAX_RETRIES` and `EMBEDDING_API_BACKOFF_SECONDS`.
+    - `process_recording_chunks` rolls back when `generate_embeddings` returns fewer vectors than expected, preserving existing chunks instead of silently deleting them. Fixes the silent partial-failure mode that produced stale chunks across embedding-model swaps.
+    - Re-embed all loop has retry passes (default 2) and now picks up any recording with chunks in the table, regardless of current status.
+
+!!! info "Version 0.8.18-alpha - API v1 folder operations"
+    Patch release on top of v0.8.17-alpha. Closes the gap from #274 follow-up where folder CRUD shipped in v0.8.16-alpha but recordings could not actually be moved between folders via the API.
+
+    - `GET /api/v1/recordings?folder_id=<id>` (or `?folder_id=none`) filters list responses by folder
+    - `PATCH /api/v1/recordings/{id}` accepts `folder_id` (null to remove from any folder)
+    - `PATCH /api/v1/recordings/batch` accepts `folder_id` inside `updates`
+    - OpenAPI schema documents these plus previously-undocumented batch fields
+
+!!! info "Version 0.8.17-alpha - Bug fixes and CI maintenance"
+    Patch release on top of v0.8.16-alpha. No new features, no breaking changes.
+
+    - Reprocess summary modal: prompt-variables panel and Append/Replace toggle now reflect the prompt source the user picked, rather than the recording's original tag
+    - Docs: corrected reverse-proxy nginx example (`Connection` header forwarded conditionally to avoid 500s on uploads through the proxy with Gunicorn). New Nginx Proxy Manager section.
+    - CI: bumped all GitHub Actions to Node 24 versions to clear deprecation warnings
+
+!!! info "Version 0.8.16-alpha - Prompt Templating, Transcription UX, and Observability"
+    **Prompt templating and summary control**
+
+    - **Prompt Template Variables** - `{{name}}` placeholders in tag, folder, user-default, and admin-default summary prompts; values entered on the upload form, stored on the recording, and editable via reprocess
+    - **Append vs Replace Mode** - Reprocess summary modal and the new Customise summary prompt modal each let you Append to or Replace the resolved prompt
+    - **Customise Summary Prompt Split-Button** - A control next to **Generate Summary** opens the Append/Replace modal for recordings without a summary yet
+    - **Full LLM Prompt Structure Preview** - Admin and account pages show the complete two-message payload with chip-coded placeholders (blue for system tokens, amber for user variables); the user-side preview re-renders live as you type
+
+    **Per-recording transcription control**
+
+    - **Per-Upload / Per-Tag / Per-Folder Transcription Model** - `TRANSCRIPTION_MODELS_AVAILABLE` exposes a model dropdown across upload, reprocess, and tag/folder edit forms
+    - **Admin-Managed Model List** - Connectors with `/v1/models` discovery let admins curate the list from the dashboard
+    - **Per-Connector Capability Gating** - Hotwords, initial-prompt, and speaker-count UI hidden for connectors that don't support them
+    - **Mistral Voxtral Chunking** - `MISTRAL_ENABLE_CHUNKING=true` opts into app-side chunking for long recordings
+
+    **ASR transcript editor**
+
+    - **Autosave** - Saves 2s after the last keystroke when opted in
+    - **Save Without Closing + Ctrl+S** - New button keeps the editor open; Ctrl+S triggers save from anywhere in the editor
+    - **Scroll Memory** - Reopening the editor restores the previous scroll position
+    - **Double-Click to Edit** - Double-clicking a transcript row jumps into the editor with that segment highlighted
+
+    **Account preferences**
+
+    - **Preferences Tab** - New tab (split from Languages) with two-column layout for transcript display, editor behaviour, and language preferences
+    - **Compact Timestamps** - Opt-in `mm:ss` timestamps as two-part pill with speaker label; "Start" label on the leading segment
+    - **Persist Recording-List Sort** - Created/Meeting date toggle persists across sessions per browser (#263)
+
+    **Embeddings and inquire mode**
+
+    - **Configurable Embedding Model** - `EMBEDDING_MODEL` for local models
+    - **API-Mode Embeddings** - `EMBEDDING_BASE_URL`, `EMBEDDING_API_KEY`, `EMBEDDING_DIMENSIONS` route embeddings through any OpenAI-compatible provider
+    - **Embedding Token Tracking + Re-Embed-All** - Vector Store tab tracks embedding API cost separately and exposes a re-embed action
+
+    **Observability and admin**
+
+    - **Per-Operation Token Stats** - Title, summary, chat, event extraction, and embeddings as separate cards and charts
+    - **Granular Token Budgets** - `TITLE_MAX_TOKENS` and `EVENT_MAX_TOKENS` join the existing `SUMMARY_MAX_TOKENS` / `CHAT_MAX_TOKENS`
+    - **LLM Timeout Visibility** - Configured timeout logged at startup; `APITimeoutError` log entries include elapsed time
+
+    **API v1**
+
+    - **Folder CRUD** + **Connector Discovery** endpoints
+    - **Recording Field Parity** - `audio_duration`, durations, folder, events, `deletion_exempt`, `prompt_variables`, transcription model
+    - **Forwarded Overrides** - `/api/v1/transcribe` forwards `transcription_model`, `hotwords`, `initial_prompt`; custom-ASR connector forwards `?model=` for WhisperX runtime switching
+
+    **Bug fixes**
+
+    - Reprocess now applies tag/folder/user default hotwords + initial_prompt (#265)
+    - Legacy `transcription_language="français"` normalised to ISO 639-1 on upgrade (#256)
+    - Title generation no longer leaks `\\uXXXX` escapes for non-ASCII transcripts (#260)
+    - CSRF token on Preferences form
+
+    **Docs** - prompt template variables guide; per-upload/tag/folder model selection; `EMBEDDING_BASE_URL` API mode across inquire-mode/vector-store/troubleshooting; nginx large-upload settings; Google Gemini OpenAI-compatible setup
+
+!!! info "Version 0.8.15-alpha - New Transcription Connectors & Upload API"
+    - **Mistral/Voxtral Connector** - Cloud-based transcription with built-in speaker diarization via Mistral's Voxtral models
+    - **VibeVoice Connector** - Self-hosted transcription via vLLM with speaker diarization and automatic chunking
+    - **Upload API: title & meeting_date** - Optional metadata fields for integrations
+    - **Regenerate Title** - Button to re-generate recording title with AI
+    - **Default Transcription Language** - User-configurable default that auto-fills forms
+    - **Tag-Driven Auto-Processing** - Watch folders auto-apply tags and trigger via API
+    - **Bug Fixes** - Azure inquire crash, chat API serialization, user deletion, chunking limits
+
+!!! info "Version 0.8.13-alpha - Video Retention Fix"
+    - Fixed large video files silently losing their video stream during upload when `VIDEO_RETENTION=true`
+    - Probe timeout now scales with file size; falls back to extension-based detection if probing fails
+
+!!! info "Version 0.8.12-alpha - Speaker Search, Shared Page Improvements & Bug Fixes"
+    - **Speaker Name Filter** - Search/filter speakers by name on the Speakers Management page with bulk operation support
+    - **Shared Page Auto-scroll** - Follow-along mode on public shared transcript pages, matching the main app experience
+    - **Dynamic Footer Year** - Shared page footer year no longer hardcoded
+    - **Duplicate Detection** - SHA-256 file hashing with warning toasts and clickable copies indicator in sidebar/header
+    - **Volume Controls** - Volume slider popups and mute visual indicators on all audio/video players
+    - **Speaker Enhancements** - Split button UI, apply suggested names, name sanitization, JSON schema option, new speaker API endpoints
+    - **Localization** - Complete translations for folders, API tokens, recording recovery, events, and speakers management
+    - **Bug Fixes** - ASR_DIARIZE=false ignored, bulk delete cascade, file monitor stability, speaker snippets, null transcription, clean_llm_response too aggressive
+
+!!! info "Version 0.8.7 - Export Templates & Localization"
+    - **Customizable Export Templates** - Create markdown templates for exports with variables (`{{title}}`, `{{summary}}`, `{{notes}}`) and conditionals for optional sections
+    - **Localized Labels** - Use `{{label.metadata}}`, `{{label.summary}}` etc. for automatically translated labels based on user's UI language
+    - **Localized Dates** - Export dates formatted per user's language preference (e.g., "15. Januar 2026" for German)
+    - **Improvements** - Opt-in ASR chunking, speaker ID remapping, ASR validation fixes
+
+    Fully backwards compatible with v0.8.x.
+
+!!! info "Version 0.8.3 - Naming Templates"
+    - **Custom Title Formatting** - Create templates with variables (`{{ai_title}}`, `{{filename}}`, `{{date}}`) and regex patterns to extract data from filenames
+    - **Tag or User Default** - Assign templates to tags or set a user-wide default; templates without `{{ai_title}}` skip the AI call to save tokens
+    - **API v1 Upload** - New `/api/v1/upload` endpoint for programmatic recording uploads
+    - **Improvements** - Tag drag-and-drop reordering, registration domain restriction, event delete button, WebM seeking fix
+
+    Fully backwards compatible with v0.8.x.
+
+!!! info "Version 0.8.2 - Transcription Usage Tracking"
+    - **Transcription Budget Management** - Set monthly transcription limits (in minutes) per user with 80% warnings and 100% blocking
+    - **Usage Statistics** - Track transcription minutes and estimated costs across all connectors
+    - **Admin Dashboard Improvements** - Redesigned stats layout with summary cards and per-user tables
+
+!!! info "Version 0.8.0 - Connector Architecture & REST API"
+    - **Connector-Based Transcription** - Modular architecture with auto-detection for transcription providers
+    - **OpenAI Diarization** - Use `gpt-4o-transcribe-diarize` for speaker identification without self-hosting
+    - **REST API v1** - Complete API for automation tools with Swagger UI at `/api/v1/docs`
+
+    See the [Migration Guide](admin-guide/migration-guide.md) and [API Reference](user-guide/api-reference.md).
+
+!!! warning "PyTorch 2.6 Compatibility Issue with WhisperX ASR"
+    If you're using the WhisperX ASR service and encounter a "Weights only load failed" error after a recent update, add this environment variable to your ASR container in docker-compose.yml:
+    ```yaml
+    environment:
+      - TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true
+    ```
+    This is caused by a PyTorch 2.6 change. See [troubleshooting](troubleshooting.md#pytorch-26-weights-loading-error-whisperx-asr-service) for details.
+
+!!! info "Version 0.6.6 - Filter & Compress"
+    **New Features** - Audio compression and enhanced filtering
+
+    - **Auto Compression** - Lossless uploads automatically compressed (configurable codec/bitrate)
+    - **Speaker Filtering** - Filter recordings by speaker, starred/inbox toggles
+    - **Sorting Fix** - Sort toggle works correctly, added Upcoming group for future dates
+    - **Format Support** - .weba format, FFmpeg fallback for unknown formats
+
+    ✅ Fully backward compatible. Optional env vars: `AUDIO_COMPRESS_UPLOADS`, `AUDIO_CODEC`, `AUDIO_BITRATE`
+
+!!! info "Version 0.6.5 - Separate Chat Model Configuration"
+    **New Feature** - Configure different AI models for chat vs background tasks
+
+    - **Separate Chat Model** - Use different service tiers for chat and summarization (#143)
+    - **Custom Datetime Picker** - New themed calendar and time selection modal
+    - **Bug Fixes** - Audio chunking after refactor (#140), username display (#138)
+
+    ✅ Fully backward compatible. Optional `CHAT_MODEL_*` environment variables.
+
+!!! success "Version 0.6.3 - API Token Authentication"
+    **New Feature** - Programmatic API access for automation tools
+
+    - **API Tokens** - Create personal access tokens for programmatic API access
+    - **Multiple Auth Methods** - Bearer token, X-API-Token header, API-Token header, or query parameter
+    - **Token Management** - Create, revoke, and track token usage from Account Settings
+    - **Flexible Expiration** - Set custom expiration periods or create non-expiring tokens
+    - **Secure Storage** - Tokens are hashed (SHA-256) and never stored in plaintext
+
+    ✅ Fully backward compatible with v0.6.x. No configuration changes required.
+
+!!! success "Version 0.6.2 - UX Polish & Bug Fixes"
+    - Standardized modal UX with backdrop click and consistent X button placement
+    - Recording disclaimer markdown support
+    - IndexedDB crash recovery fixes
+    - Processing queue cleanup on delete
+
+!!! success "Version 0.6.1 - Offline Ready"
+    - **HuggingFace Model Caching** - Embedding model persists across container restarts
+    - **Offline Deployment** - Run once with internet, then works fully offline
+
+!!! success "Version 0.6.0 - Queue Control"
+    - **Multi-User Job Queue** - Fair round-robin scheduling with automatic retry for failed jobs
+    - **Unified Progress Tracking** - Single view merging uploads and backend processing
+    - **Media Support** - Added video format support and fixed Firefox system audio recording
+
+!!! warning "Version 0.5.9 - Major Release"
+    **⚠️ Major architectural changes** - Backup data before upgrading!
+
+    - **Internal Sharing System** - Share recordings with granular permissions (view/edit/reshare)
+    - **Group Management** - Create groups with leads, group tags, custom retention policies
+    - **Speaker Voice Profiles** - AI-powered recognition with embeddings (requires WhisperX)
+    - **Audio-Transcript Sync** - Click-to-jump, auto-highlight, and follow mode
+    - **Auto-Deletion & Retention** - Global and group-level policies with tag protection
+    - **Modular Architecture** - Backend refactored into blueprints, frontend composables
+
+    Previous release (v0.5.8):
+
+    - **Inline Transcript Editing** - Edit speaker assignments and text directly in the speaker identification modal
+    - **Add Speaker Functionality** - Dynamically add new speakers during transcript review
+    - **Enhanced Speaker Modal** - Improved UX with hover-based edit controls and real-time updates
+
+    Previous release (v0.5.7):
+
+    - **GPT-5 Support** - Full support for OpenAI's GPT-5 model family with automatic parameter detection
+    - **Custom Summary Prompts on Reprocessing** - Experiment with different prompts when regenerating summaries
+    - **PWA Enhancements** - Service worker for wake lock to prevent screen sleep on mobile
+
+    Previous release (v0.5.6):
+
+    - Event extraction for automatically identifying calendar-worthy events
+    - Transcript templates for customizable download formats
+    - Enhanced export options and improved mobile UI
+
+## Getting Help
+
+Need assistance? We're here to help:
+
+<div class="help-grid">
+  <div class="help-card">
+    <h4>📖 Documentation</h4>
+    <p>You're already here! Browse our comprehensive guides:</p>
+    <ul>
+      <li><a href="faq">Frequently Asked Questions</a></li>
+      <li><a href="troubleshooting">Troubleshooting Guide</a></li>
+      <li><a href="user-guide/">User Documentation</a></li>
+      <li><a href="admin-guide/">Admin Documentation</a></li>
+    </ul>
+  </div>
+  
+  <div class="help-card">
+    <h4>💬 Community</h4>
+    <p>Connect with other users and get support:</p>
+    <ul>
+      <li><a href="https://github.com/murtaza-nasir/speakr/issues">Report Issues</a></li>
+      <li><a href="https://github.com/murtaza-nasir/speakr/discussions">Join Discussions</a></li>
+      <li><a href="https://github.com/murtaza-nasir/speakr">Star on GitHub</a></li>
+    </ul>
+  </div>
+</div>
+
+---
+
+Ready to transform your audio into actionable insights? [Get started now](getting-started.md) →
\ No newline at end of file
diff --git a/docs/javascripts/extra.js b/docs/javascripts/extra.js
new file mode 100644
index 00000000..2fef1b23
--- /dev/null
+++ b/docs/javascripts/extra.js
@@ -0,0 +1,125 @@
+// Custom JavaScript for Speakr documentation
+
+document.addEventListener('DOMContentLoaded', function() {
+  // Add smooth scrolling for anchor links
+  document.querySelectorAll('a[href^="#"]').forEach(anchor => {
+    anchor.addEventListener('click', function (e) {
+      const href = this.getAttribute('href');
+      if (href === '#') return;
+      
+      e.preventDefault();
+      const target = document.querySelector(href);
+      if (target) {
+        target.scrollIntoView({
+          behavior: 'smooth',
+          block: 'start'
+        });
+        
+        // Update URL without jumping
+        history.pushState(null, null, href);
+      }
+    });
+  });
+  
+  // Add external link indicators
+  document.querySelectorAll('a[href^="http"]').forEach(link => {
+    if (!link.hostname.includes(window.location.hostname)) {
+      link.setAttribute('target', '_blank');
+      link.setAttribute('rel', 'noopener noreferrer');
+      
+      // Add external icon if not already present
+      if (!link.querySelector('.external-icon')) {
+        const icon = document.createElement('span');
+        icon.className = 'external-icon';
+        icon.innerHTML = ' ↗';
+        icon.style.fontSize = '0.75em';
+        icon.style.verticalAlign = 'super';
+        link.appendChild(icon);
+      }
+    }
+  });
+  
+  // Enhance search functionality
+  const searchInput = document.querySelector('.md-search__input');
+  if (searchInput) {
+    // Add keyboard shortcut hint
+    searchInput.setAttribute('placeholder', 'Search (Press "/" to focus)');
+    
+    // Add "/" keyboard shortcut
+    document.addEventListener('keydown', function(e) {
+      if (e.key === '/' && !searchInput.matches(':focus')) {
+        e.preventDefault();
+        searchInput.focus();
+      }
+    });
+  }
+  
+  // Add responsive tables wrapper
+  document.querySelectorAll('table').forEach(table => {
+    if (!table.parentElement.classList.contains('table-wrapper')) {
+      const wrapper = document.createElement('div');
+      wrapper.className = 'table-wrapper';
+      wrapper.style.overflowX = 'auto';
+      table.parentElement.insertBefore(wrapper, table);
+      wrapper.appendChild(table);
+    }
+  });
+  
+  // Add image zoom functionality
+  document.querySelectorAll('.md-content img').forEach(img => {
+    img.style.cursor = 'zoom-in';
+    img.addEventListener('click', function() {
+      const overlay = document.createElement('div');
+      overlay.style.position = 'fixed';
+      overlay.style.top = '0';
+      overlay.style.left = '0';
+      overlay.style.width = '100%';
+      overlay.style.height = '100%';
+      overlay.style.background = 'rgba(0, 0, 0, 0.9)';
+      overlay.style.zIndex = '9999';
+      overlay.style.display = 'flex';
+      overlay.style.alignItems = 'center';
+      overlay.style.justifyContent = 'center';
+      overlay.style.cursor = 'zoom-out';
+      
+      const zoomedImg = document.createElement('img');
+      zoomedImg.src = img.src;
+      zoomedImg.style.maxWidth = '90%';
+      zoomedImg.style.maxHeight = '90%';
+      zoomedImg.style.objectFit = 'contain';
+      
+      overlay.appendChild(zoomedImg);
+      document.body.appendChild(overlay);
+      
+      overlay.addEventListener('click', function() {
+        document.body.removeChild(overlay);
+      });
+      
+      // Close on Escape key
+      document.addEventListener('keydown', function closeOnEscape(e) {
+        if (e.key === 'Escape' && document.body.contains(overlay)) {
+          document.body.removeChild(overlay);
+          document.removeEventListener('keydown', closeOnEscape);
+        }
+      });
+    });
+  });
+});
+
+// Add loading indicator for slow operations
+window.addEventListener('load', function() {
+  // Remove any loading indicators
+  const loader = document.querySelector('.page-loader');
+  if (loader) {
+    loader.style.display = 'none';
+  }
+});
+
+// Print-friendly styling
+window.addEventListener('beforeprint', function() {
+  document.body.classList.add('print-mode');
+});
+
+window.addEventListener('afterprint', function() {
+  document.body.classList.remove('print-mode');
+});
\ No newline at end of file
diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
new file mode 100644
index 00000000..c036a342
--- /dev/null
+++ b/docs/requirements-docs.txt
@@ -0,0 +1,16 @@
+# MkDocs and Material theme
+mkdocs>=1.5.3
+mkdocs-material>=9.5.0
+mkdocs-material-extensions>=1.3
+
+# MkDocs plugins
+mkdocs-minify-plugin>=0.7.2
+mkdocs-git-revision-date-localized-plugin>=1.2.2
+
+# Markdown extensions
+pymdown-extensions>=10.5
+pygments>=2.17.0
+
+# Additional utilities
+Pillow>=10.1.0  # For image optimization
+cairosvg>=2.7.1  # For SVG support
\ No newline at end of file
diff --git a/docs/screenshots.md b/docs/screenshots.md
new file mode 100644
index 00000000..baaa17d2
--- /dev/null
+++ b/docs/screenshots.md
@@ -0,0 +1,416 @@
+# Screenshots Gallery
+
+Explore Speakr's powerful features through our visual gallery. Click on any image to view it in full size.
+
+## Main Interface
+
+### Main Views
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Main view.png" alt="Main Screen" />
+    <p class="caption">Main screen with chat interface and token usage indicator</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/main-view-token-usage.png" alt="Token Usage" />
+    <p class="caption">Token usage indicator showing monthly budget consumption</p>
+  </div>
+</div>
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/main-view-recipe-example.png" alt="Recipe Example" />
+    <p class="caption">Recipe transcription with family sharing enabled</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/filters-sidebar-expanded.png" alt="Expanded Filters" />
+    <p class="caption">Advanced filtering options in expanded sidebar</p>
+  </div>
+</div>
+
+### Multi-language Support
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/ui-chinese.png" alt="Chinese UI" />
+    <p class="caption">Full interface in Chinese with language switching</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/multilingual-chinese.png" alt="Multilingual Chat" />
+    <p class="caption">AI chat and transcription translation in multiple languages</p>
+  </div>
+</div>
+
+## Recording & Upload
+
+### New Recording Interface
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Recording interface.png" alt="Recording Interface" />
+    <p class="caption">Upload or record audio directly in your browser</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/upload-interface.png" alt="File Upload Interface" />
+    <p class="caption">Multi-file drag and drop with advanced options and tag selection</p>
+  </div>
+</div>
+
+### Recording Options
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/recording-dual-source.png" alt="Dual Source Recording" />
+    <p class="caption">Record both system audio and microphone simultaneously</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/recording-single-source.png" alt="Single Source Recording" />
+    <p class="caption">Single source recording with real-time notes</p>
+  </div>
+</div>
+
+### Post-Recording
+
+<div class="screenshot-item">
+  <img src="../assets/images/screenshots/recording-upload-modal.png" alt="Post-Recording Options" />
+  <p class="caption">Add tags, notes, and configure settings before processing</p>
+</div>
+
+## Transcription Features
+
+### Video Playback
+
+<div class="screenshot-item">
+  <img src="../assets/images/screenshots/video-playback.png" alt="Video Playback" />
+  <p class="caption">In-browser video playback alongside speaker-labeled transcript and summary</p>
+</div>
+
+### Interactive Audio Synchronization
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/audio-sync-simple-view.png" alt="Audio Sync Simple View" />
+    <p class="caption">Real-time transcript highlighting in simple view with auto-scroll follow mode</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/audio-sync-bubble-view.png" alt="Audio Sync Bubble View" />
+    <p class="caption">Interactive audio-transcript synchronization in bubble view</p>
+  </div>
+</div>
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/highlighted-transcript-following-simple-light.png" alt="Follow Mode Light Theme" />
+    <p class="caption">Auto-scroll follow mode - click any text to jump to that point in audio</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/highlighted-transcript-following-simple-dark.png" alt="Follow Mode Dark Theme" />
+    <p class="caption">Follow mode in dark theme with active segment highlighting</p>
+  </div>
+</div>
+
+### Transcription Views
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/main-view-with-speakers.png" alt="Transcription with Speakers" />
+    <p class="caption">Transcription with identified speakers and metadata</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/main-view-summary-tab.png" alt="Summary View" />
+    <p class="caption">AI-generated summary with key points</p>
+  </div>
+</div>
+
+### Speaker Identification
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/speaker-identification-voice-profiles.png" alt="Voice Profile Speaker Identification" />
+    <p class="caption">AI-powered speaker identification with voice profile suggestions and confidence scores</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/edit-transcription-modal.png" alt="ASR Transcript Editor" />
+    <p class="caption">Advanced segment-based editor for ASR transcriptions</p>
+  </div>
+</div>
+
+## AI-Powered Features
+
+### Interactive Chat
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/chat-interface.png" alt="AI Chat Interface" />
+    <p class="caption">Ask questions about your recordings with expanded chat view</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/main-view-notes-tab.png" alt="Notes Tab" />
+    <p class="caption">Organize your thoughts with markdown notes</p>
+  </div>
+</div>
+
+### Inquire Mode
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Inquire mode.png" alt="Inquire Mode Search" />
+    <p class="caption">Semantic search across all your recordings</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/inquire-dark-mode.png" alt="Inquire Mode Dark" />
+    <p class="caption">Inquire mode with dark theme</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/chat-chinese.png" alt="Multilingual Inquire" />
+    <p class="caption">Chat and inquire in multiple languages</p>
+  </div>
+</div>
+
+## Organization & Management
+
+### Tags and Filtering
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/edit-tags.png" alt="Edit Tags" />
+    <p class="caption">Edit and organize tags for recordings</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/tag-management-enhanced-badges.png" alt="Enhanced Tag Management" />
+    <p class="caption">Comprehensive tag management with visual badges for retention policies, sharing settings, and custom prompts</p>
+  </div>
+</div>
+
+### Recording Management
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/edit recording modal.png" alt="Edit Recording" />
+    <p class="caption">Edit recording metadata and settings</p>
+  </div>
+  
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/edit recording tags modal.png" alt="Edit Tags" />
+    <p class="caption">Manage tags for better organization</p>
+  </div>
+</div>
+
+## Sharing & Collaboration
+
+### Share Recordings
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Share modal.png" alt="Share Modal" />
+    <p class="caption">Generate secure share links with customizable permissions</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Share link.png" alt="Shared Recording View" />
+    <p class="caption">Clean public view for shared recordings</p>
+  </div>
+</div>
+
+### Manage Shares
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/share-notes-view.png" alt="Shared Notes View" />
+    <p class="caption">Public notes view for shared recordings</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/share-summary-view.png" alt="Shared Summary View" />
+    <p class="caption">Summary view of shared recordings</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/share-translated.png" alt="Shared Translated Recording" />
+    <p class="caption">Shared recording with AI translation</p>
+  </div>
+</div>
+
+## Content Creation & Editing
+
+### Markdown Editor
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/markdown-editor.png" alt="Markdown Editor" />
+    <p class="caption">Rich markdown editor for notes and summaries</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/markdown-editor-fullscreen.png" alt="Fullscreen Markdown Editor" />
+    <p class="caption">Fullscreen markdown editor with side-by-side preview</p>
+  </div>
+</div>
+
+### Template Export
+
+<div class="screenshot-item">
+  <img src="../assets/images/screenshots/template-selector.png" alt="Template Selector" />
+  <p class="caption">Select templates for downloading transcripts in various formats</p>
+</div>
+
+## User Settings
+
+### Account Configuration
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/settings account info.png" alt="Account Settings" />
+    <p class="caption">Personal information and language preferences</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/settings-create-tag-modal.png" alt="Create Tag" />
+    <p class="caption">Create custom tags with specific processing options</p>
+  </div>
+</div>
+
+### Speaker Management
+
+<div class="screenshot-item">
+  <img src="../assets/images/screenshots/speakers-management-voice-profiles.png" alt="Enhanced Speaker Management" />
+  <p class="caption">Manage your speaker library with voice profile statistics, confidence scores, and voice sample playback</p>
+</div>
+
+## Admin Features
+
+### User Management
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Admin dashboard.png" alt="Admin Dashboard" />
+    <p class="caption">Manage users and monitor system usage</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/admin-user-create-token-budget.png" alt="User Token Budget" />
+    <p class="caption">Create user with monthly token budget setting</p>
+  </div>
+</div>
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/admin-user-groups.png" alt="User Groups" />
+    <p class="caption">Manage user groups and permissions</p>
+  </div>
+</div>
+
+### Group Management
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/admin-edit-group-modal.png" alt="Edit Group" />
+    <p class="caption">Edit group settings and properties</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/admin-manage-group-modal.png" alt="Manage Group Members" />
+    <p class="caption">Manage group members and permissions</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/admin-manage-group-tags.png" alt="Manage Group Tags" />
+    <p class="caption">Configure tags for specific user groups</p>
+  </div>
+</div>
+
+### System Configuration
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Admin system settings.png" alt="System Settings" />
+    <p class="caption">Configure global system parameters</p>
+  </div>
+  
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Admin default prompts.png" alt="Default Prompts" />
+    <p class="caption">Set default AI prompts for all users</p>
+  </div>
+</div>
+
+### Monitoring & Analytics
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Admin stats.png" alt="System Statistics" />
+    <p class="caption">Monitor system health and usage patterns</p>
+  </div>
+  
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/Admin vector store.png" alt="Vector Store Management" />
+    <p class="caption">Manage semantic search infrastructure</p>
+  </div>
+</div>
+
+## Processing & Reprocessing
+
+<div class="screenshot-grid">
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/processing-tooltip.png" alt="Processing Tooltip" />
+    <p class="caption">View transcription and summary processing times</p>
+  </div>
+
+  <div class="screenshot-item">
+    <img src="../assets/images/screenshots/archived-recording.png" alt="Archived Recording" />
+    <p class="caption">Archived recordings are marked in sidebar with no audio playback</p>
+  </div>
+</div>
+
+---
+
+<style>
+.screenshot-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+  gap: 2rem;
+  margin: 2rem 0;
+}
+
+.screenshot-item {
+  text-align: center;
+  margin: 2rem 0;
+}
+
+.screenshot-item img {
+  width: 100%;
+  max-width: 800px;
+  border-radius: 8px;
+  box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+  cursor: pointer;
+  transition: transform 0.2s;
+}
+
+.screenshot-item img:hover {
+  transform: scale(1.02);
+}
+
+.caption {
+  margin-top: 0.5rem;
+  font-style: italic;
+  color: #666;
+}
+
+@media (max-width: 768px) {
+  .screenshot-grid {
+    grid-template-columns: 1fr;
+  }
+}
+</style>
\ No newline at end of file
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
new file mode 100644
index 00000000..77b96765
--- /dev/null
+++ b/docs/stylesheets/extra.css
@@ -0,0 +1,572 @@
+/* Custom styles for Speakr documentation */
+
+/* Logo styling */
+.md-header__button.md-logo img,
+.md-header__button.md-logo svg {
+  height: 1.6rem;
+  width: auto;
+}
+
+/* Better code blocks */
+.highlight {
+  margin: 1em 0;
+}
+
+/* Custom admonition colors */
+.md-typeset .admonition.info,
+.md-typeset details.info {
+  border-color: rgb(0, 123, 255);
+}
+
+.md-typeset .admonition.info > .admonition-title,
+.md-typeset details.info > summary {
+  background-color: rgba(0, 123, 255, 0.1);
+  border-color: rgb(0, 123, 255);
+}
+
+/* Better image display */
+.md-typeset img {
+  border-radius: 8px;
+  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+  margin: 1.5em 0;
+}
+
+/* Improve table styling */
+.md-typeset table:not([class]) {
+  margin: 1.5em 0;
+}
+
+.md-typeset table:not([class]) th {
+  background-color: var(--md-default-bg-color--light);
+  font-weight: 600;
+}
+
+/* Custom navigation styling */
+.md-nav__item--active > .md-nav__link {
+  font-weight: 600;
+}
+
+/* Better search results */
+.md-search-result__title {
+  font-weight: 600;
+}
+
+/* Responsive video embeds */
+.video-wrapper {
+  position: relative;
+  padding-bottom: 56.25%;
+  height: 0;
+  overflow: hidden;
+  max-width: 100%;
+  margin: 1.5em 0;
+}
+
+.video-wrapper iframe {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  border-radius: 8px;
+}
+
+/* Custom badges */
+.badge {
+  display: inline-block;
+  padding: 0.25em 0.6em;
+  font-size: 0.75em;
+  font-weight: 600;
+  line-height: 1;
+  color: #fff;
+  text-align: center;
+  white-space: nowrap;
+  vertical-align: baseline;
+  border-radius: 0.25rem;
+  margin: 0 0.25em;
+}
+
+.badge-primary {
+  background-color: #007bff;
+}
+
+.badge-success {
+  background-color: #28a745;
+}
+
+.badge-warning {
+  background-color: #ffc107;
+  color: #212529;
+}
+
+.badge-danger {
+  background-color: #dc3545;
+}
+
+/* Screenshot styling */
+.screenshot-container {
+  max-width: 80%;
+  margin: 2em auto;
+}
+
+.screenshot-container img {
+  width: 100%;
+  height: auto;
+  border-radius: 8px;
+  box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+}
+
+/* Navigation cards grid */
+.grid.cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+  gap: 1.5em;
+  margin: 2em 0 3em 0;
+}
+
+.grid.cards .card {
+  background: var(--md-code-bg-color);
+  border: 1px solid var(--md-default-fg-color--lightest);
+  border-radius: 12px;
+  padding: 1.75em;
+  text-align: center;
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  position: relative;
+  overflow: hidden;
+}
+
+.grid.cards .card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+  border-color: var(--md-primary-fg-color);
+}
+
+.grid.cards .card::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 3px;
+  background: linear-gradient(90deg, var(--md-primary-fg-color), var(--md-accent-fg-color));
+  transform: scaleX(0);
+  transition: transform 0.3s ease;
+}
+
+.grid.cards .card:hover::before {
+  transform: scaleX(1);
+}
+
+.card-icon {
+  font-size: 2.5em;
+  margin-bottom: 0.5em;
+  opacity: 0.9;
+}
+
+.grid.cards .card h3 {
+  margin: 0.5em 0;
+  color: var(--md-default-fg-color);
+  font-size: 1.25em;
+}
+
+.grid.cards .card p {
+  color: var(--md-default-fg-color--light);
+  margin: 0.75em 0 1.25em 0;
+  line-height: 1.6;
+}
+
+.card-link {
+  display: inline-block;
+  color: var(--md-primary-fg-color);
+  text-decoration: none;
+  font-weight: 600;
+  transition: all 0.2s ease;
+}
+
+.card-link:hover {
+  color: var(--md-accent-fg-color);
+  transform: translateX(4px);
+}
+
+/* Feature cards grid */
+.feature-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.25em;
+  margin: 2em 0;
+}
+
+.feature-card {
+  background: var(--md-code-bg-color);
+  padding: 1.5em;
+  border: 1px solid var(--md-default-fg-color--lightest);
+  border-radius: 8px;
+  transition: all 0.3s ease;
+}
+
+.feature-card:hover {
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);
+  transform: translateY(-2px);
+  border-color: var(--md-primary-fg-color--light);
+}
+
+.feature-card h4 {
+  margin: 0 0 0.75em 0;
+  color: var(--md-default-fg-color);
+  font-size: 1.1em;
+  display: flex;
+  align-items: center;
+  gap: 0.5em;
+}
+
+.feature-card ul {
+  margin: 0;
+  padding-left: 1.25em;
+  color: var(--md-default-fg-color--light);
+}
+
+.feature-card li {
+  margin: 0.4em 0;
+  font-size: 0.95em;
+}
+
+/* Help section grid */
+.help-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+  gap: 2em;
+  margin: 2em 0;
+}
+
+.help-card {
+  background: var(--md-code-bg-color);
+  padding: 1.75em;
+  border-radius: 8px;
+  border: 1px solid var(--md-default-fg-color--lightest);
+}
+
+.help-card h4 {
+  margin-top: 0;
+  color: var(--md-default-fg-color);
+  font-size: 1.2em;
+}
+
+.help-card p {
+  color: var(--md-default-fg-color--light);
+  margin: 0.75em 0;
+}
+
+.help-card ul {
+  margin: 0.5em 0;
+  padding-left: 1.5em;
+}
+
+.help-card li {
+  margin: 0.5em 0;
+}
+
+.help-card a {
+  color: var(--md-primary-fg-color);
+  text-decoration: none;
+  transition: color 0.2s ease;
+}
+
+.help-card a:hover {
+  color: var(--md-accent-fg-color);
+  text-decoration: underline;
+}
+
+/* Custom tabs styling */
+.md-typeset .tabbed-set > input:checked + label {
+  font-weight: 600;
+}
+
+/* Improve inline code */
+.md-typeset code {
+  padding: 0.15em 0.3em;
+  border-radius: 0.25em;
+}
+
+/* Version selector styling */
+.md-version__current {
+  font-weight: 600;
+}
+
+/* Footer improvements */
+.md-footer-meta {
+  background-color: var(--md-footer-bg-color);
+}
+
+/* Dark mode adjustments */
+[data-md-color-scheme="slate"] .grid.cards .card {
+  background: var(--md-code-bg-color);
+  border-color: var(--md-default-fg-color--lighter);
+}
+
+[data-md-color-scheme="slate"] .feature-card {
+  background: var(--md-code-bg-color);
+}
+
+[data-md-color-scheme="slate"] .help-card {
+  background: var(--md-code-bg-color);
+}
+
+/* Guide cards for User/Admin guides */
+.guide-cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+  gap: 1.5em;
+  margin: 2em 0 3em 0;
+}
+
+.guide-card {
+  background: var(--md-code-bg-color);
+  border: 1px solid var(--md-default-fg-color--lightest);
+  border-radius: 12px;
+  padding: 1.75em;
+  text-align: center;
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  position: relative;
+  overflow: hidden;
+}
+
+.guide-card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+  border-color: var(--md-primary-fg-color);
+}
+
+.guide-card::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 3px;
+  background: linear-gradient(90deg, var(--md-primary-fg-color), var(--md-accent-fg-color));
+  transform: scaleX(0);
+  transition: transform 0.3s ease;
+}
+
+.guide-card:hover::before {
+  transform: scaleX(1);
+}
+
+.guide-card .card-icon {
+  font-size: 2.5em;
+  margin-bottom: 0.5em;
+  opacity: 0.9;
+}
+
+.guide-card h3 {
+  margin: 0.5em 0;
+  color: var(--md-default-fg-color);
+  font-size: 1.25em;
+}
+
+.guide-card p {
+  color: var(--md-default-fg-color--light);
+  margin: 0.75em 0 1.25em 0;
+  line-height: 1.6;
+  font-size: 0.95em;
+}
+
+/* Tips grid */
+.tips-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.25em;
+  margin: 2em 0;
+}
+
+.tip-card {
+  background: var(--md-code-bg-color);
+  padding: 1.25em;
+  border-radius: 8px;
+  border: 1px solid var(--md-default-fg-color--lightest);
+  transition: all 0.2s ease;
+}
+
+.tip-card:hover {
+  border-color: var(--md-primary-fg-color--light);
+  transform: translateY(-2px);
+}
+
+.tip-card h4 {
+  margin: 0 0 0.5em 0;
+  color: var(--md-default-fg-color);
+  font-size: 1em;
+}
+
+.tip-card p {
+  margin: 0;
+  color: var(--md-default-fg-color--light);
+  font-size: 0.9em;
+  line-height: 1.5;
+}
+
+/* Responsibility grid */
+.responsibility-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+  gap: 1.25em;
+  margin: 2em 0;
+}
+
+.resp-card {
+  background: linear-gradient(135deg, var(--md-code-bg-color), var(--md-default-bg-color--light));
+  padding: 1.5em;
+  border-radius: 10px;
+  border: 1px solid var(--md-default-fg-color--lightest);
+}
+
+.resp-card h4 {
+  margin: 0 0 0.75em 0;
+  color: var(--md-primary-fg-color);
+  font-size: 1.1em;
+}
+
+.resp-card p {
+  margin: 0;
+  color: var(--md-default-fg-color--light);
+  font-size: 0.9em;
+  line-height: 1.5;
+}
+
+/* Action cards */
+.action-cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+  gap: 1.25em;
+  margin: 2em 0;
+}
+
+.action-card {
+  display: flex;
+  align-items: flex-start;
+  gap: 1em;
+  background: var(--md-code-bg-color);
+  padding: 1.25em;
+  border-radius: 8px;
+  border: 1px solid var(--md-default-fg-color--lightest);
+  transition: all 0.2s ease;
+}
+
+.action-card:hover {
+  border-color: var(--md-primary-fg-color);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
+}
+
+.action-icon {
+  font-size: 1.5em;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2em;
+  height: 2em;
+  background: var(--md-primary-fg-color--light);
+  color: white;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.action-card strong {
+  display: block;
+  margin-bottom: 0.25em;
+  color: var(--md-default-fg-color);
+}
+
+.action-card p {
+  margin: 0;
+  color: var(--md-default-fg-color--light);
+  font-size: 0.85em;
+}
+
+/* Best practices */
+.best-practices {
+  display: grid;
+  gap: 1em;
+  margin: 2em 0;
+}
+
+.practice-item {
+  background: var(--md-code-bg-color);
+  padding: 1em 1.25em;
+  border-left: 4px solid var(--md-primary-fg-color);
+  border-radius: 4px;
+}
+
+.practice-item strong {
+  color: var(--md-default-fg-color);
+  font-size: 1em;
+}
+
+.practice-item p {
+  margin: 0.5em 0 0 0;
+  color: var(--md-default-fg-color--light);
+  font-size: 0.9em;
+}
+
+/* Help section styling */
+.help-section {
+  background: var(--md-code-bg-color);
+  padding: 1.5em;
+  border-radius: 8px;
+  margin: 2em 0;
+}
+
+.help-item {
+  display: flex;
+  align-items: center;
+  gap: 1em;
+  margin: 0.75em 0;
+}
+
+.help-icon {
+  font-size: 1.25em;
+  display: inline-block;
+  width: 1.5em;
+}
+
+.help-item span:last-child {
+  color: var(--md-default-fg-color--light);
+}
+
+.help-item a {
+  color: var(--md-primary-fg-color);
+  text-decoration: none;
+}
+
+.help-item a:hover {
+  text-decoration: underline;
+}
+
+.help-item code {
+  background: var(--md-code-bg-color);
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-size: 0.9em;
+}
+
+/* Mobile optimization */
+@media screen and (max-width: 768px) {
+  .grid.cards {
+    grid-template-columns: 1fr;
+  }
+  
+  .feature-grid {
+    grid-template-columns: 1fr;
+  }
+  
+  .help-grid {
+    grid-template-columns: 1fr;
+  }
+  
+  .md-typeset img {
+    max-width: 100%;
+    height: auto;
+  }
+  
+  .card-icon {
+    font-size: 2em;
+  }
+}
\ No newline at end of file
diff --git a/docs/testing/connector-testing-checklist.md b/docs/testing/connector-testing-checklist.md
new file mode 100644
index 00000000..394a4074
--- /dev/null
+++ b/docs/testing/connector-testing-checklist.md
@@ -0,0 +1,530 @@
+# Connector Architecture Testing Checklist
+
+This checklist covers manual testing scenarios for the transcription connector architecture. Use this alongside the automated tests (`tests/test_connector_architecture.py`) for comprehensive coverage.
+
+## Prerequisites
+
+- Speakr running in Docker
+- Access to at least one of:
+  - OpenAI API key (for OpenAI connectors)
+  - Self-hosted ASR service (for ASR endpoint connector)
+- Test audio files:
+  - Short file (<1 minute, single speaker)
+  - Longer file (>5 minutes, multiple speakers)
+  - Opus format file (for codec conversion testing)
+
+---
+
+## 1. Connector Auto-Detection
+
+### Test 1.1: OpenAI Transcribe Auto-Detection
+**Config:**
+```bash
+TRANSCRIPTION_API_KEY=sk-xxx
+TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize
+```
+
+**Expected:**
+
+- [ ] Logs show "Auto-detected OpenAI Transcribe"
+- [ ] `/api/system/info` shows `connector: "openai_transcribe"`
+- [ ] Transcription works with speaker labels (A, B, C...)
+
+### Test 1.2: ASR Endpoint Auto-Detection
+**Config:**
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+```
+
+**Expected:**
+
+- [ ] Logs show "Auto-detected ASR endpoint"
+- [ ] `/api/system/info` shows `connector: "asr_endpoint"`
+- [ ] No deprecation warning (USE_ASR_ENDPOINT not set)
+
+### Test 1.3: Legacy USE_ASR_ENDPOINT Backwards Compatibility
+**Config:**
+```bash
+USE_ASR_ENDPOINT=true
+ASR_BASE_URL=http://whisperx-asr:9000
+```
+
+**Expected:**
+
+- [ ] Logs show deprecation warning for USE_ASR_ENDPOINT
+- [ ] Connector still works correctly
+- [ ] `/api/system/info` shows `connector: "asr_endpoint"`
+
+### Test 1.4: Explicit Connector Selection
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=openai_whisper
+TRANSCRIPTION_API_KEY=sk-xxx
+ASR_BASE_URL=http://whisperx-asr:9000  # Should be ignored
+```
+
+**Expected:**
+
+- [ ] Uses openai_whisper despite ASR_BASE_URL being set
+- [ ] `/api/system/info` shows `connector: "openai_whisper"`
+
+---
+
+## 2. Speaker Diarization
+
+### Test 2.1: OpenAI Transcribe Diarization
+**Config:** Use `TRANSCRIPTION_MODEL=gpt-4o-transcribe-diarize`
+
+**Steps:**
+
+1. Upload audio with 2+ speakers
+2. Wait for transcription to complete
+
+**Expected:**
+
+- [ ] Transcription shows speaker labels (A, B, C...)
+- [ ] Speaker identification button appears in UI
+- [ ] Bubble view toggle available
+- [ ] Can rename speakers
+
+### Test 2.2: ASR Endpoint Diarization
+**Config:** Use ASR endpoint with `ASR_DIARIZE=true`
+
+**Steps:**
+
+1. Upload audio with 2+ speakers
+2. Wait for transcription to complete
+
+**Expected:**
+
+- [ ] Transcription shows speaker labels (SPEAKER_00, SPEAKER_01...)
+- [ ] Speaker identification button appears in UI
+- [ ] Min/max speakers options visible in upload form
+- [ ] Min/max speakers options visible in reprocess modal
+
+### Test 2.3: OpenAI Whisper (No Diarization)
+**Config:** Use `TRANSCRIPTION_MODEL=whisper-1`
+
+**Steps:**
+
+1. Upload audio with 2+ speakers
+2. Wait for transcription to complete
+
+**Expected:**
+
+- [ ] Transcription is plain text (no speaker labels)
+- [ ] Speaker identification button NOT visible
+- [ ] Bubble view toggle NOT available
+
+### Test 2.4: Mistral Voxtral Diarization
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-key
+TRANSCRIPTION_MODEL=voxtral-mini-latest
+```
+
+**Steps:**
+
+1. Upload audio with 2+ speakers
+2. Wait for transcription to complete
+
+**Expected:**
+
+- [ ] Transcription shows speaker labels (speaker_0, speaker_1...)
+- [ ] Speaker identification button appears in UI
+- [ ] Bubble view toggle available
+- [ ] Can rename speakers
+
+### Test 2.5: VibeVoice ASR Diarization
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+TRANSCRIPTION_MODEL=vibevoice
+```
+
+**Steps:**
+
+1. Upload audio with 2+ speakers
+2. Wait for transcription to complete
+
+**Expected:**
+
+- [ ] Transcription shows speaker labels (SPEAKER_00, SPEAKER_01...)
+- [ ] Speaker identification button appears in UI
+- [ ] Bubble view toggle available
+- [ ] Non-speech segments ([Silence], [Human Sounds]) are attributed to the previous speaker
+- [ ] Can rename speakers
+
+---
+
+## 3. UI Feature Visibility
+
+### Test 3.1: Speaker Count Controls (ASR Only)
+**ASR Config:**
+
+- [ ] Min speakers field visible in upload form
+- [ ] Max speakers field visible in upload form
+- [ ] Min/max speakers visible in reprocess modal
+
+**OpenAI Config:**
+
+- [ ] Min speakers field NOT visible
+- [ ] Max speakers field NOT visible
+
+### Test 3.2: Speaker Identification Based on Data
+Upload the same file with different connectors and verify:
+
+- [ ] Speaker ID button shows when transcription HAS diarization
+- [ ] Speaker ID button hidden when transcription has NO diarization
+- [ ] Behavior is the same regardless of current connector config
+
+---
+
+## 4. Chunking Behavior
+
+### Test 4.1: ASR Endpoint (Internal Chunking)
+**Config:**
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+ENABLE_CHUNKING=true
+CHUNK_LIMIT=10MB
+```
+
+**Steps:**
+
+1. Upload file >10MB
+
+**Expected:**
+
+- [ ] File uploads without app-level chunking
+- [ ] Logs show "Connector handles chunking internally"
+- [ ] No chunk progress in UI
+
+### Test 4.2: OpenAI Whisper (App Chunking)
+**Config:**
+```bash
+TRANSCRIPTION_MODEL=whisper-1
+ENABLE_CHUNKING=true
+CHUNK_LIMIT=10MB
+```
+
+**Steps:**
+
+1. Upload file >10MB
+
+**Expected:**
+
+- [ ] File is chunked by the app
+- [ ] Logs show chunk processing
+- [ ] Transcription merges correctly
+
+### Test 4.3: Mistral (Internal Chunking)
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=mistral
+TRANSCRIPTION_API_KEY=your-key
+```
+
+**Steps:**
+
+1. Upload file >10 minutes
+
+**Expected:**
+
+- [ ] File uploads without app-level chunking
+- [ ] Mistral handles chunking internally
+- [ ] Transcription completes successfully
+
+### Test 4.4: VibeVoice (App Chunking for Long Files)
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=vibevoice
+TRANSCRIPTION_BASE_URL=http://your-vllm-server:8000
+```
+
+**Steps:**
+
+1. Upload file >60 minutes
+
+**Expected:**
+
+- [ ] App splits into ~50 minute chunks
+- [ ] Each chunk transcribes successfully
+- [ ] Segments merge correctly across chunk boundaries
+
+### Test 4.5: Chunking Disabled
+**Config:**
+```bash
+TRANSCRIPTION_MODEL=whisper-1
+ENABLE_CHUNKING=false
+```
+
+**Steps:**
+
+1. Upload file >25MB
+
+**Expected:**
+
+- [ ] Upload fails with file size error (OpenAI 25MB limit)
+- [ ] Error message is clear
+
+---
+
+## 5. Codec Handling
+
+### Test 5.1: Opus File with OpenAI Connector
+**Config:** Any OpenAI connector
+
+**Steps:**
+
+1. Upload an opus format audio file
+2. Check logs
+
+**Expected:**
+
+- [ ] File is converted before transcription
+- [ ] Logs show codec conversion
+- [ ] Transcription succeeds
+
+### Test 5.2: AUDIO_UNSUPPORTED_CODECS Override
+**Config:**
+```bash
+AUDIO_UNSUPPORTED_CODECS=aac
+```
+
+**Steps:**
+
+1. Upload an AAC format audio file
+2. Check logs
+
+**Expected:**
+
+- [ ] File is converted before transcription
+- [ ] Logs show "Excluding codecs from supported list"
+
+### Test 5.3: Supported Format (No Conversion)
+**Steps:**
+
+1. Upload an MP3 file
+
+**Expected:**
+
+- [ ] No conversion occurs
+- [ ] Transcription proceeds directly
+
+---
+
+## 6. Error Handling
+
+### Test 6.1: Invalid API Key
+**Config:**
+```bash
+TRANSCRIPTION_API_KEY=invalid-key
+```
+
+**Expected:**
+
+- [ ] Clear error message about authentication
+- [ ] Job fails gracefully
+- [ ] UI shows error state
+
+### Test 6.2: Unreachable ASR Endpoint
+**Config:**
+```bash
+ASR_BASE_URL=http://nonexistent:9000
+```
+
+**Expected:**
+
+- [ ] Connection error logged
+- [ ] Job fails with timeout/connection error
+- [ ] UI shows error state
+
+### Test 6.3: Invalid Connector Name
+**Config:**
+```bash
+TRANSCRIPTION_CONNECTOR=nonexistent
+```
+
+**Expected:**
+
+- [ ] App fails to start (or logs critical error)
+- [ ] Error message lists available connectors
+
+---
+
+## 7. Voice Profiles (ASR Only)
+
+### Test 7.1: Speaker Embeddings
+**Config:**
+```bash
+ASR_BASE_URL=http://whisperx-asr:9000
+ASR_RETURN_SPEAKER_EMBEDDINGS=true
+```
+
+**Steps:**
+
+1. Upload audio with known speaker
+2. Create voice profile from transcription
+3. Upload another audio with same speaker
+
+**Expected:**
+
+- [ ] Speaker embeddings returned in response
+- [ ] Voice profile creation works
+- [ ] Automatic speaker matching works
+
+### Test 7.2: Embeddings Disabled
+**Config:**
+```bash
+ASR_RETURN_SPEAKER_EMBEDDINGS=false
+```
+
+**Expected:**
+
+- [ ] Voice profile features not available
+- [ ] No embeddings in response
+
+---
+
+## 8. System Info API
+
+### Test 8.1: Connector Capabilities Exposed
+**Endpoint:** `GET /api/system/info`
+
+**Expected Response Structure:**
+```json
+{
+  "transcription": {
+    "connector": "asr_endpoint",
+    "supports_diarization": true,
+    "supports_speaker_embeddings": true,
+    "supports_speaker_count": true
+  }
+}
+```
+
+- [ ] connector field matches active connector
+- [ ] supports_diarization accurate
+- [ ] supports_speaker_embeddings accurate
+- [ ] supports_speaker_count accurate
+
+---
+
+## 9. Reprocessing
+
+### Test 9.1: Reprocess with Different Language
+**Steps:**
+
+1. Transcribe file (auto-detect language)
+2. Reprocess with specific language
+
+**Expected:**
+
+- [ ] Reprocess uses selected language
+- [ ] Transcription updates correctly
+
+### Test 9.2: Reprocess with Speaker Count (ASR)
+**Steps:**
+
+1. Transcribe file with auto speaker detection
+2. Reprocess with min_speakers=2, max_speakers=3
+
+**Expected:**
+
+- [ ] Min/max speakers respected
+- [ ] Diarization quality may improve
+
+---
+
+## 10. Hotwords & Initial Prompt
+
+### Test 10.1: ASR Endpoint with Hotwords
+**Config:** ASR endpoint connector
+
+**Steps:**
+
+1. Upload audio containing domain-specific terms
+2. Set hotwords in Advanced ASR Options (e.g., "Speakr, CTranslate2, PyAnnote")
+
+**Expected:**
+
+- [ ] Hotwords passed as `hotwords` query parameter to ASR
+- [ ] Transcription accuracy improves for specified terms
+- [ ] Server logs show hotwords in request
+
+### Test 10.2: ASR Endpoint with Initial Prompt
+**Config:** ASR endpoint connector
+
+**Steps:**
+
+1. Upload audio file
+2. Set initial prompt in Advanced ASR Options
+
+**Expected:**
+
+- [ ] Initial prompt passed as `initial_prompt` query parameter to ASR
+- [ ] Server logs show initial_prompt in request
+
+### Test 10.3: OpenAI Connector with Hotwords + Prompt
+**Config:** OpenAI Whisper or OpenAI Transcribe connector
+
+**Steps:**
+
+1. Upload audio with both hotwords and initial prompt set
+
+**Expected:**
+
+- [ ] Hotwords and initial prompt combined into single `prompt` parameter
+- [ ] Combined with `. ` separator
+
+### Test 10.4: Precedence Hierarchy
+**Steps:**
+
+1. Set user-level hotwords in Account Settings
+2. Create a tag with different hotwords
+3. Upload with tag applied but no form-level hotwords
+
+**Expected:**
+
+- [ ] Tag hotwords used (overrides user defaults)
+- [ ] Upload form values override tag when explicitly set
+
+---
+
+## 11. Performance & Edge Cases
+
+### Test 11.1: Very Long Audio
+Upload audio >1 hour
+
+**Expected:**
+
+- [ ] Processing completes (may take time)
+- [ ] No timeout errors
+- [ ] Transcription is complete
+
+### Test 11.2: Empty/Silent Audio
+Upload silent audio file
+
+**Expected:**
+
+- [ ] Transcription returns empty or minimal text
+- [ ] No errors
+
+### Test 11.3: Corrupt Audio File
+Upload corrupt/invalid audio file
+
+**Expected:**
+
+- [ ] Clear error message
+- [ ] Job fails gracefully
+
+---
+
+## Notes
+
+- Run automated tests first: `docker exec speakr-dev python /app/tests/test_connector_architecture.py`
+- After significant changes, test with all three connectors
+- Voice profile tests only work with WhisperX ASR Service
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
new file mode 100644
index 00000000..5b391e13
--- /dev/null
+++ b/docs/troubleshooting.md
@@ -0,0 +1,256 @@
+# Troubleshooting
+
+When something goes wrong with Speakr, this guide helps you identify and resolve common issues quickly. Most problems fall into a few categories - [installation issues](getting-started/installation.md), transcription failures, performance problems, or feature-specific quirks. Also check the [FAQ](faq.md) for common questions. Understanding where to look and what to check saves hours of frustration.
+
+## Installation and Setup Issues
+
+### Container Won't Start
+
+When your Docker container refuses to start or immediately exits, the problem usually lies in your configuration. Check your [environment file](getting-started.md#step-3-configure-your-transcription-service) first - a single typo in API keys or mismatched quotes can prevent startup. Review the [installation guide](getting-started/installation.md) for proper setup. Run `docker compose logs app` to see the actual error messages. Common culprits include port conflicts (another service using 8899), missing volume mounts, or incorrect file permissions on your data directory.
+
+If you see database connection errors, ensure your database file has proper permissions. The container runs as a specific user and needs read/write access to the data directories. On Linux systems, you might need to adjust ownership with `chown -R 1000:1000 ./uploads ./instance`.
+
+### Can't Access the Web Interface
+
+When Speakr starts successfully but you can't reach the web interface, network configuration is usually the issue. First, verify the container is actually running with `docker ps`. Check that port 8899 is properly mapped - the docker-compose file should show `"8899:8899"` in the ports section.
+
+Firewall rules often block access, especially on cloud servers. Ensure port 8899 is open in your firewall, security groups (AWS), or network policies. If accessing from another machine, remember that `localhost` won't work - use the server's actual IP address or hostname.
+
+### Admin Login Fails
+
+If you can't log in with your [admin credentials](getting-started.md#step-4-configure-admin-account), first verify you're using the exact username and password from your environment file. For user management issues, see the [admin guide](admin-guide/user-management.md). These are case-sensitive and must match exactly. Check the Docker logs for admin user creation messages - you should see "Admin user created successfully" during first startup.
+
+Sometimes the admin user creation fails silently if the password doesn't meet requirements. Ensure your admin password is at least 8 characters long. If the admin user wasn't created, you might need to remove the database file and restart the container to trigger initialization again.
+
+## Transcription Problems
+
+### Transcription Never Starts
+
+When recordings stay in "pending" or "queued" status indefinitely, check these common causes:
+
+**QUEUED status**: Recordings show "Queued" when waiting for an available worker. By default, 2 workers process jobs concurrently. If many recordings are queued, they'll be processed in fair round-robin order across users - no single user can monopolize the queue. Increase `JOB_QUEUE_WORKERS` in your environment file for faster throughput.
+
+**Background processor stopped**: Check the logs for error messages about the [transcription service](features.md#multi-engine-support). Monitor processing status in the [vector store](admin-guide/vector-store.md) admin panel.
+
+**API key issues**: The most common cause - verify your OpenAI or OpenRouter API key is valid and has available credits.
+
+**Network connectivity**: The container needs to reach external API endpoints. If you're behind a corporate proxy, you'll need to configure proxy settings in your Docker environment.
+
+### Transcription Fails Immediately
+
+Quick failures usually indicate API authentication problems. Double-check your API keys in the environment file. Remember that OpenAI and OpenRouter use different key formats. OpenAI keys start with "sk-" while OpenRouter keys look different. Ensure you're using the right key for your configured service.
+
+API rate limits or insufficient credits also cause immediate failures. Log into your API provider's dashboard to check your usage and limits. Some API plans have restrictive rate limits that Speakr might exceed with large files.
+
+### ASR Endpoint Returns 405 or 404 Errors
+
+If you're getting "405 Method Not Allowed" or "404 Not Found" errors with the Whisper ASR webservice, check your ASR_BASE_URL configuration. The URL should not include trailing comments or descriptions - remove anything after the # symbol in your environment file. For the Whisper ASR webservice, use just the base URL like `http://whisper-asr:9000` without `/asr` at the end.
+
+When using Docker Compose, always use container names rather than IP addresses for service communication. Instead of `http://192.168.1.132:9000`, use `http://whisper-asr-webservice:9000` where `whisper-asr-webservice` is your container name.
+
+### Poor Transcription Quality
+
+Transcription accuracy depends heavily on audio quality. Background noise, multiple overlapping speakers, or poor microphone placement all degrade results. The AI models work best with clear, single-speaker audio or well-separated multiple speakers.
+
+Language mismatches cause poor results too. If you've set a specific transcription language in settings but upload audio in a different language, accuracy suffers. Either set the correct language or leave it blank for auto-detection.
+
+For domain-specific terminology, brand names, or acronyms that keep getting misspelled, use the [custom vocabulary (hotwords) and initial prompt](features.md#custom-vocabulary--transcription-hints) features. Set these per-upload in Advanced ASR Options, or configure them on your tags, folders, or user defaults for automatic application. See the [FAQ entry](faq.md#certain-specialized-words-dont-get-transcribed-properly-how-do-i-fix-this) for practical guidance.
+
+For recordings with multiple speakers, using the [ASR endpoint with speaker diarization](features.md#speaker-diarization) dramatically improves usability. Learn how to [identify speakers](user-guide/transcripts.md#speaker-identification) after transcription, even if the raw transcription accuracy is similar.
+
+### "Format Not Recognised" Errors
+
+If your transcription service returns "format not recognised" or similar codec errors, your service may not support certain audio formats that Speakr considers supported by default.
+
+This commonly occurs with:
+
+- **vLLM-hosted Whisper instances** that don't support Opus codec
+- **Self-hosted ASR services** with limited codec support
+- **WebM recordings** (which typically use Opus audio)
+
+**Solution:** Add unsupported codecs to your `.env` file:
+
+```bash
+# Exclude codecs your service doesn't support
+AUDIO_UNSUPPORTED_CODECS=opus
+
+# Multiple codecs can be excluded
+AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+```
+
+Files using these codecs will be automatically converted to your target format (MP3 by default) before transcription. See the [audio compression settings](getting-started/installation.md#audio-compression) for more details.
+
+### Chinese Transcription Issues
+
+For [Chinese language transcription](features.md#language-support), model selection is critical. See the [FAQ on language support](faq.md#can-speakr-transcribe-languages-other-than-english) for more details.
+
+**Important**: Distil models (like distil-large-v3) do not support Chinese transcription properly. Even when you set the language to "zh", these models may recognize Chinese audio as English and produce incorrect output. Always use the full large-v3 model or similar non-distilled models for Chinese content. If you're getting English transcription for Chinese audio or romanized output instead of Chinese characters, switch from a distil model to large-v3.
+
+### Summary Language Doesn't Match Preference
+
+If [summaries](features.md#automatic-summarization) revert to English when you click "Reprocess Summary" despite having [language preferences](user-guide/settings.md#language-preferences) set, this might be a model limitation. Configure [custom prompts](admin-guide/prompts.md) to enforce language requirements. Some models like Qwen3-30B don't always follow language instructions correctly. Try using a different model that better respects language directives, or ensure your custom prompt explicitly specifies the output language.
+
+## Performance Issues
+
+### Slow Transcription Processing
+
+Large audio files naturally take longer to process, but excessive delays indicate problems. Check your [server resources](getting-started.md#prerequisites) and review [system statistics](admin-guide/statistics.md) for performance metrics - Speakr needs adequate CPU and RAM, especially when processing multiple recordings simultaneously. The `docker stats` command shows current resource usage.
+
+Network speed affects transcription time since audio must upload to API services. Slow internet connections create bottlenecks, particularly for large files. Consider chunking settings if you consistently work with long recordings.
+
+The choice of transcription model impacts speed. Whisper Large is more accurate but slower than Whisper Base. If speed matters more than perfect accuracy, consider using a smaller model through your API settings.
+
+### Recordings Stuck After Restart
+
+If Speakr crashed or restarted while recordings were processing, they automatically resume on next startup. The job queue persists to the database, so no uploads are lost. Check the logs for "Recovered orphaned jobs" messages confirming jobs were resumed.
+
+### Deleted Recordings Still in Processing Queue (Fixed in v0.6.2)
+
+!!! success "Fixed in v0.6.2"
+    Prior to v0.6.2, deleted recordings could remain visible in the processing queue as "ghost entries." Clicking on these would open an empty recording window. This has been resolved - deleted recordings are now immediately removed from both the frontend queue and backend job tracking.
+
+If you're on v0.6.1 or earlier and see this behavior, upgrade to v0.6.2. The fix ensures that when you delete a recording:
+
+- It's removed from your library
+- It's removed from the processing queue display
+- Any associated backend jobs are cleaned up
+- No ghost entries remain clickable
+
+### Files Over 25MB Fail with OpenAI
+
+OpenAI's Whisper API has a 25MB file size limit. For larger files, enable [chunking](features.md#audio-chunking) in your environment configuration. Learn about [chunking strategies](faq.md#whats-the-difference-between-chunking-by-size-vs-duration):
+```
+ENABLE_CHUNKING=true
+CHUNK_LIMIT=20MB  # or use duration: CHUNK_LIMIT=1400s
+CHUNK_OVERLAP_SECONDS=3
+```
+
+You can specify chunk limits either by file size (MB) or duration (seconds). For models with specific duration limits like Azure's 1500-second maximum, use duration-based chunking. The system will automatically split your recordings and reassemble the transcription.
+
+### ASR Timeout on Long Recordings
+
+Long recordings (over 30 minutes) may timeout during ASR processing. Increase the timeout in Admin Settings > System Settings > "ASR Timeout Seconds". For a 2-hour recording, set it to at least 7200 seconds (2 hours). Very long recordings like 3+ hour files may need longer timeouts depending on the GPU you are using for transcription (if local).
+
+### Web Interface Feels Sluggish
+
+Browser performance degrades with very large transcriptions. Recordings over 2 hours can generate massive amounts of text that some browsers may struggle to display smoothly. The bubble view for speaker-labeled transcriptions is particularly resource-intensive.
+
+Clear your browser cache if the interface gradually becomes slower over time. Speakr caches data locally for performance, but this cache can become corrupted. In Chrome or Firefox, hard refresh with Ctrl+Shift+R to reload fresh assets.
+
+## Feature-Specific Issues
+
+### Speaker Identification Not Working
+
+[Speaker diarization](features.md#speaker-diarization) requires the [ASR endpoint](getting-started.md#option-b-custom-asr-endpoint-configuration), not standard Whisper API. Configure speaker settings in [system settings](admin-guide/system-settings.md). Verify you've configured ASR settings correctly in your environment file. The ASR_BASE_URL should point to a valid ASR service that supports diarization.
+
+Even with ASR enabled, you must explicitly request diarization when uploading or reprocessing recordings. Speakr should do this by default, but user settings may override this behavior. Check the speaker count settings - if you set min and max speakers to 1, diarization effectively disables. Use reasonable ranges like 2-6 speakers for most recordings.
+
+After transcription, speakers appear as generic labels (SPEAKER_01, etc.). You must manually [identify speakers](user-guide/transcripts.md#speaker-identification) by clicking the labels and assigning names. Manage your [speaker library](user-guide/settings.md#speakers-management-tab) in account settings.
+
+### PyTorch 2.6 Weights Loading Error (WhisperX ASR Service)
+
+If you're getting an error like this when trying to transcribe:
+
+```
+Weights only load failed. This file can still be loaded...
+WeightsUnpickler error: Unsupported global: GLOBAL omegaconf.listconfig.ListConfig was not an allowed global by default.
+```
+
+This is caused by a breaking change in PyTorch 2.6 where the default value of `weights_only` in `torch.load` changed from `False` to `True`. The pyannote models used for voice activity detection in WhisperX are affected.
+
+**Solution**: Add this environment variable to your WhisperX ASR service container in your docker-compose.yml:
+
+```yaml
+whisper-asr:
+  image: learnedmachine/whisperx-asr-service:latest
+  environment:
+    - TORCH_FORCE_NO_WEIGHTS_ONLY_LOAD=true
+    # ... your other environment variables
+```
+
+!!! warning "Important"
+    This environment variable must be set directly in the docker-compose.yml file under the `environment` section of the ASR service container. Setting it in a `.env` file may not work reliably.
+
+After adding this variable, restart your ASR container:
+```bash
+docker compose down whisper-asr
+docker compose up -d whisper-asr
+```
+
+For more details, see the [WhisperX issue discussion](https://github.com/m-bain/whisperX/issues/1304).
+
+### WhisperX Shows UNKNOWN_SPEAKER
+
+If WhisperX only shows "UNKNOWN_SPEAKER" instead of numbered speakers (SPEAKER_00, SPEAKER_01, etc.), check these common issues:
+
+1. **Wrong ASR_ENGINE**: You must use `ASR_ENGINE=whisperx` in your ASR container's Docker environment. The `faster_whisper` engine does NOT support speaker diarization, even though it can transcribe audio.
+
+2. **Missing or invalid HF_TOKEN**: The ASR container needs a valid HuggingFace token to download the diarization models. Ensure your `HF_TOKEN` environment variable is set in the ASR container configuration.
+
+3. **ASR_DIARIZE not enabled**: While this should be automatic when `USE_ASR_ENDPOINT=true`, explicitly set `ASR_DIARIZE=true` in your Speakr .env file if speakers aren't being detected.
+
+4. **Docker networking issues**: If using the Speakr and ASR webservice containers in the same docker-compose, containers must communicate via service names (e.g., `http://whisper-asr:9000`), not localhost or external IPs.
+
+Check your ASR container logs for pyannote/VAD messages to confirm diarization models are loading correctly.
+
+### ASR Service on Mac Shows GPU Errors
+
+If you're running the ASR webservice on macOS and getting GPU-related errors or "no matching manifest" errors:
+
+- **Use the CPU image**: Replace `onerahmet/openai-whisper-asr-webservice:latest-gpu` with `onerahmet/openai-whisper-asr-webservice:latest`
+- **Remove GPU configuration**: Delete the entire `deploy` section with GPU device reservations from your docker-compose.yml
+- **Expect slower processing**: CPU-based transcription works but is significantly slower than GPU acceleration
+
+This is a Docker limitation on macOS - GPU passthrough isn't supported because Docker runs in a Linux VM. See the [FAQ](faq.md#can-i-use-the-asr-webservice-for-speaker-diarization-on-mac) for complete Mac configuration.
+
+### Sharing Links Don't Work
+
+[Sharing](user-guide/sharing.md) requires your Speakr instance to be accessible from the internet with HTTPS. See [sharing requirements](user-guide/sharing.md#requirements-for-sharing) and [security considerations](user-guide/sharing.md#security-and-privacy-considerations). Local installations or non-SSL setups cannot generate working share links. The share button will be disabled or show an error explaining the requirements.
+
+If your instance meets the requirements but shares still fail, check that your configured URL in the environment matches reality. Mismatched URLs cause share links to point to the wrong location. The URL must be exactly what external users will use to access your instance.
+
+### Inquire Mode Returns No Results
+
+[Semantic search](user-guide/inquire-mode.md) requires the embedding model to be properly installed and initialized. Check the [Vector Store tab](admin-guide/vector-store.md) in admin settings and review [vector store troubleshooting](admin-guide/vector-store.md#troubleshooting-common-issues) - it should show "Available" status. If not, the sentence-transformers library might be missing or failed to load.
+
+All recordings need processing before they're searchable. The Vector Store tab shows how many recordings are processed versus pending. Use the process button to manually trigger embedding generation if automatic processing has stalled.
+
+Query formulation matters enormously. [Inquire Mode](user-guide/inquire-mode.md) understands context and meaning, not just keywords. Learn [effective search strategies](user-guide/inquire-mode.md#asking-effective-questions) in the user guide. Ask complete questions rather than typing isolated words. "What did we decide about the budget?" works better than just "budget decision".
+
+## Additional Considerations
+
+### Recording Disclaimer for Legal Compliance
+
+In many jurisdictions, you must inform participants they're being recorded. Enable a recording disclaimer in [System Settings](admin-guide/system-settings.md#recording-disclaimer). Check the [FAQ on recording compliance](faq.md#do-i-need-to-inform-people-theyre-being-recorded). Set custom text that appears before any recording starts, such as legal notices about consent requirements. This feature is particularly important in regions with strict recording laws like Australia or California.
+
+A separate [upload disclaimer](admin-guide/system-settings.md#upload-disclaimer) can be configured to show a notice before file uploads. You can also display a persistent [custom banner](admin-guide/system-settings.md#custom-banner) at the top of the page for announcements or policy reminders.
+
+### Offline Deployment
+
+Speakr can run completely offline as all dependencies are built into the Docker image. For offline deployments, use local models via Ollama for [text generation](features.md#automatic-summarization) and ensure your ASR endpoint is hosted locally. The system will work without internet access once properly configured.
+
+**Inquire Mode (Semantic Search)**: If you use Inquire Mode with the default local embedding model (all-MiniLM-L6-v2, or any value configured via `EMBEDDING_MODEL`), the model is automatically cached in the persistent `instance/huggingface/` directory on first use. Run Speakr once with internet access to download the model, then it will load from cache on subsequent restarts and no further network access is required. Configurations that use `EMBEDDING_BASE_URL` to offload embeddings to an API provider naturally require network access to that provider on every request.
+
+### Non-Docker Installation
+
+While Docker is the only officially supported installation method, you can attempt manual installation using npm and Python. You'll need to handle dependencies, environment setup, and configuration yourself. This approach is not recommended for regular use and you'll need to troubleshoot issues independently.
+
+## Getting Help
+
+### Check the Logs
+
+Docker logs contain valuable debugging information. Use `docker compose logs -f app` to see real-time logs. Look for ERROR or WARNING messages that correspond to when problems occurred. Python tracebacks indicate code-level issues that might require support.
+
+For ASR issues, also check the ASR container logs: `docker compose logs -f whisper-asr-webservice`
+
+### System Information
+
+When requesting help, provide your system configuration from the About tab in account settings. Include the Speakr version, configured AI model, transcription service type, and any error messages. This context helps others understand your specific setup.
+
+### Community Support
+
+The GitHub repository's issue tracker is your best resource for reporting bugs or requesting features. Search existing issues first - someone might have already encountered and solved your problem. When creating new issues, include specific steps to reproduce the problem.
+
+---
+
+Next: [FAQ](faq.md) →
\ No newline at end of file
diff --git a/docs/user-guide/api-reference.md b/docs/user-guide/api-reference.md
new file mode 100644
index 00000000..682a9169
--- /dev/null
+++ b/docs/user-guide/api-reference.md
@@ -0,0 +1,936 @@
+# API Reference
+
+Speakr provides a comprehensive REST API (v1) for automation tools, dashboard widgets, and custom integrations. This reference documents all available endpoints.
+
+!!! tip "Interactive Documentation"
+    Access the interactive Swagger UI documentation at `/api/v1/docs` on your Speakr instance. You can test endpoints directly from your browser.
+
+## Base URL
+
+All API v1 endpoints are prefixed with `/api/v1`:
+
+```
+https://your-speakr-instance.com/api/v1/
+```
+
+## Authentication
+
+All endpoints require authentication. See [API Tokens](api-tokens.md) for details on creating and managing tokens.
+
+=== "Bearer Token (Recommended)"
+    ```bash
+    curl -H "Authorization: Bearer YOUR_TOKEN" \
+         https://speakr.example.com/api/v1/stats
+    ```
+
+=== "X-API-Token Header"
+    ```bash
+    curl -H "X-API-Token: YOUR_TOKEN" \
+         https://speakr.example.com/api/v1/stats
+    ```
+
+=== "Query Parameter"
+    ```bash
+    curl "https://speakr.example.com/api/v1/stats?token=YOUR_TOKEN"
+    ```
+
+## OpenAPI Specification
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /api/v1/docs` | Interactive Swagger UI |
+| `GET /api/v1/openapi.json` | OpenAPI 3.0 specification |
+
+<div style="max-width: 90%; margin: 1.5em auto;">
+  <img src="../../assets/images/screenshots/api-swagger-ui.png" alt="Swagger UI Documentation" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);">
+  <p style="text-align: center; margin-top: 0.5rem; font-style: italic; color: #666;">Interactive API documentation with Swagger UI at /api/v1/docs</p>
+</div>
+
+---
+
+## Stats
+
+Dashboard-compatible statistics endpoint, designed for integration with homepage widgets like [gethomepage.dev](https://gethomepage.dev/).
+
+### Get Statistics
+
+```http
+GET /api/v1/stats
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `scope` | string | `user` | `user` for personal stats, `all` for global (admin only) |
+
+**Response:**
+
+```json
+{
+  "recordings": {
+    "total": 150,
+    "completed": 120,
+    "processing": 5,
+    "pending": 20,
+    "failed": 5
+  },
+  "storage": {
+    "used_bytes": 5368709120,
+    "used_human": "5.0 GB"
+  },
+  "queue": {
+    "jobs_queued": 3,
+    "jobs_processing": 1
+  },
+  "tokens": {
+    "used_this_month": 450000,
+    "budget": 1000000,
+    "percentage": 45.0
+  },
+  "transcription": {
+    "used_this_month_seconds": 3600,
+    "used_this_month_minutes": 60,
+    "budget_seconds": 36000,
+    "budget_minutes": 600,
+    "percentage": 10.0,
+    "estimated_cost": 0.36
+  },
+  "activity": {
+    "recordings_today": 3,
+    "last_transcription": "2024-01-15T14:30:00Z"
+  }
+}
+```
+
+??? example "gethomepage.dev Widget Configuration"
+    ```yaml
+    - Speakr:
+        widget:
+          type: customapi
+          url: https://speakr.example.com/api/v1/stats
+          headers:
+            Authorization: Bearer YOUR_TOKEN
+          mappings:
+            - field: recordings.completed
+              label: Completed
+            - field: storage.used_human
+              label: Storage
+            - field: tokens.percentage
+              label: Token Usage
+              format: percent
+            - field: transcription.percentage
+              label: Transcription
+              format: percent
+            - field: activity.recordings_today
+              label: Today
+    ```
+
+---
+
+## Recordings
+
+### Upload Recording
+
+```http
+POST /api/v1/recordings/upload
+```
+
+Upload a recording as multipart form-data and immediately queue transcription.
+
+**Form Fields:**
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `file` | file | yes | Audio file to upload |
+| `notes` | string | no | Optional notes |
+| `file_last_modified` | string | no | Client file lastModified (ms epoch) |
+| `language` | string | no | Language hint (ISO 639-1) |
+| `min_speakers` | integer | no | Min speaker count |
+| `max_speakers` | integer | no | Max speaker count |
+| `tag_ids[0]`, `tag_ids[1]`, ... | integer | no | Tag IDs (multi) |
+| `tag_id` | integer | no | Single tag ID (legacy) |
+
+**Response:**
+
+```json
+// 202 Accepted
+{
+  "id": 123,
+  "title": "Recording - meeting.mp3",
+  "status": "PENDING",
+  "created_at": "2024-01-15T10:00:00Z",
+  "meeting_date": "2024-01-15T09:00:00Z",
+  "file_size": 15728640,
+  "original_filename": "meeting.mp3",
+  "mime_type": "audio/mpeg",
+  "notes": "Quick test upload"
+}
+```
+
+**Example:**
+
+```bash
+curl -X POST \
+  -H "X-API-Token: YOUR_TOKEN" \
+  -F "file=@/path/to/audio.mp3" \
+  -F "notes=Quick test upload" \
+  -F "language=en" \
+  https://speakr.example.com/api/v1/recordings/upload
+```
+
+### List Recordings
+
+```http
+GET /api/v1/recordings
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `page` | integer | 1 | Page number |
+| `per_page` | integer | 25 | Items per page (max: 100) |
+| `status` | string | `all` | Filter: `all`, `pending`, `processing`, `completed`, `failed` |
+| `sort_by` | string | `created_at` | Sort field: `created_at`, `meeting_date`, `title`, `file_size` |
+| `sort_order` | string | `desc` | Sort order: `asc`, `desc` |
+| `date_from` | string | - | Filter from date (ISO format) |
+| `date_to` | string | - | Filter to date (ISO format) |
+| `tag_id` | integer | - | Filter by tag ID |
+| `q` | string | - | Search query (title, participants) |
+| `inbox` | boolean | - | Filter by inbox status |
+| `starred` | boolean | - | Filter by starred status |
+
+**Response:**
+
+```json
+{
+  "recordings": [
+    {
+      "id": 123,
+      "title": "Team Meeting",
+      "status": "COMPLETED",
+      "created_at": "2024-01-15T10:00:00Z",
+      "meeting_date": "2024-01-15T09:00:00Z",
+      "file_size": 15728640,
+      "original_filename": "meeting.mp3",
+      "participants": "Alice, Bob",
+      "is_inbox": false,
+      "is_highlighted": true,
+      "audio_available": true,
+      "has_transcription": true,
+      "has_summary": true,
+      "tags": [
+        {"id": 1, "name": "Work", "color": "#3B82F6"}
+      ]
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "per_page": 25,
+    "total": 150,
+    "total_pages": 6,
+    "has_next": true,
+    "has_prev": false
+  }
+}
+```
+
+### Get Recording Details
+
+```http
+GET /api/v1/recordings/{id}
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `format` | string | `full` | `full` or `minimal` (excludes large text fields) |
+| `include` | string | `transcription,summary,notes` | Comma-separated fields to include |
+
+**Response:**
+
+```json
+{
+  "id": 123,
+  "title": "Team Meeting",
+  "status": "COMPLETED",
+  "participants": "Alice, Bob",
+  "created_at": "2024-01-15T10:00:00Z",
+  "meeting_date": "2024-01-15T09:00:00Z",
+  "completed_at": "2024-01-15T10:05:00Z",
+  "file_size": 15728640,
+  "original_filename": "meeting.mp3",
+  "mime_type": "audio/mpeg",
+  "is_inbox": false,
+  "is_highlighted": true,
+  "audio_available": true,
+  "processing_time_seconds": 45.2,
+  "transcription": "Alice: Hello everyone...",
+  "summary": "## Meeting Summary\n- Key point 1...",
+  "notes": "Personal notes...",
+  "tags": [{"id": 1, "name": "Work", "color": "#3B82F6"}]
+}
+```
+
+!!! note "Transcript Formatting"
+    The `transcription` field is automatically formatted using your default transcript template. Configure templates in Account Settings → Transcript Templates.
+
+### Get Transcript
+
+```http
+GET /api/v1/recordings/{id}/transcript
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `format` | string | `json` | Output format: `json`, `text`, `srt`, `vtt` |
+
+=== "JSON Format"
+    ```json
+    {
+      "format": "json",
+      "segments": [
+        {
+          "speaker": "Alice",
+          "sentence": "Hello everyone",
+          "start_time": 0.0,
+          "end_time": 2.5
+        }
+      ]
+    }
+    ```
+
+=== "Text Format"
+    Uses your default transcript template:
+    ```json
+    {
+      "format": "text",
+      "content": "Alice: Hello everyone\n\nBob: Hi Alice..."
+    }
+    ```
+
+=== "SRT Format"
+    ```json
+    {
+      "format": "srt",
+      "content": "1\n00:00:00,000 --> 00:00:02,500\nHello everyone\n\n2\n..."
+    }
+    ```
+
+=== "VTT Format"
+    ```json
+    {
+      "format": "vtt",
+      "content": "WEBVTT\n\n00:00:00.000 --> 00:00:02.500\n<v Alice>Hello everyone\n\n..."
+    }
+    ```
+
+### Get Summary
+
+```http
+GET /api/v1/recordings/{id}/summary
+```
+
+**Response:**
+
+```json
+{
+  "summary": "## Meeting Summary\n\n### Key Points\n- Point 1...",
+  "has_summary": true
+}
+```
+
+### Get Notes
+
+```http
+GET /api/v1/recordings/{id}/notes
+```
+
+**Response:**
+
+```json
+{
+  "notes": "My personal notes about this meeting...",
+  "has_notes": true
+}
+```
+
+### Get Processing Status
+
+```http
+GET /api/v1/recordings/{id}/status
+```
+
+**Response:**
+
+```json
+{
+  "id": 123,
+  "status": "PROCESSING",
+  "queue_position": 2,
+  "error_message": null,
+  "completed_at": null
+}
+```
+
+**Status Values:**
+
+| Status | Description |
+|--------|-------------|
+| `PENDING` | Waiting in queue |
+| `PROCESSING` | Transcription in progress |
+| `SUMMARIZING` | Summary generation in progress |
+| `COMPLETED` | Processing finished successfully |
+| `FAILED` | Processing failed (check `error_message`) |
+
+### Update Recording
+
+```http
+PATCH /api/v1/recordings/{id}
+```
+
+**Request Body:**
+
+```json
+{
+  "title": "Updated Title",
+  "participants": "Alice, Bob, Charlie",
+  "notes": "Updated notes...",
+  "summary": "Updated summary...",
+  "meeting_date": "2024-01-15T09:00:00Z",
+  "is_inbox": false,
+  "is_highlighted": true
+}
+```
+
+All fields are optional.
+
+### Replace Notes
+
+```http
+PUT /api/v1/recordings/{id}/notes
+```
+
+**Request Body:**
+
+```json
+{
+  "notes": "New notes content..."
+}
+```
+
+### Replace Summary
+
+```http
+PUT /api/v1/recordings/{id}/summary
+```
+
+**Request Body:**
+
+```json
+{
+  "summary": "## New Summary\n- Point 1..."
+}
+```
+
+### Delete Recording
+
+```http
+DELETE /api/v1/recordings/{id}
+```
+
+**Response:**
+
+```json
+{
+  "success": true,
+  "message": "Recording deleted"
+}
+```
+
+---
+
+## Tags
+
+### List Tags
+
+```http
+GET /api/v1/tags
+```
+
+Returns both personal tags and group tags you have access to.
+
+**Response:**
+
+```json
+{
+  "tags": [
+    {
+      "id": 1,
+      "name": "Work Meetings",
+      "color": "#3B82F6",
+      "is_group_tag": false,
+      "group_id": null,
+      "custom_prompt": "Focus on action items...",
+      "default_language": "en",
+      "default_min_speakers": 2,
+      "default_max_speakers": 10,
+      "protect_from_deletion": false,
+      "can_edit": true
+    }
+  ]
+}
+```
+
+### Create Tag
+
+```http
+POST /api/v1/tags
+```
+
+**Request Body:**
+
+```json
+{
+  "name": "Interviews",
+  "color": "#10B981",
+  "custom_prompt": "Extract candidate qualifications...",
+  "default_language": "en",
+  "default_min_speakers": 2,
+  "default_max_speakers": 3,
+  "group_id": null
+}
+```
+
+### Update Tag
+
+```http
+PUT /api/v1/tags/{id}
+```
+
+**Request Body:**
+
+```json
+{
+  "name": "Updated Name",
+  "color": "#EF4444",
+  "custom_prompt": "New prompt..."
+}
+```
+
+### Delete Tag
+
+```http
+DELETE /api/v1/tags/{id}
+```
+
+### Add Tags to Recording
+
+```http
+POST /api/v1/recordings/{id}/tags
+```
+
+**Request Body:**
+
+```json
+{
+  "tag_ids": [1, 2, 3]
+}
+```
+
+### Remove Tag from Recording
+
+```http
+DELETE /api/v1/recordings/{id}/tags/{tag_id}
+```
+
+---
+
+## Speakers
+
+### List Speakers
+
+```http
+GET /api/v1/speakers
+```
+
+**Response:**
+
+```json
+{
+  "speakers": [
+    {
+      "id": 1,
+      "name": "John Doe",
+      "use_count": 45,
+      "last_used": "2024-01-15T14:30:00Z",
+      "confidence_score": 0.87,
+      "has_voice_profile": true
+    }
+  ]
+}
+```
+
+### Create Speaker
+
+```http
+POST /api/v1/speakers
+```
+
+**Request Body:**
+
+```json
+{
+  "name": "Jane Smith"
+}
+```
+
+### Update Speaker
+
+```http
+PUT /api/v1/speakers/{id}
+```
+
+Updates the speaker name and cascades changes to all recordings.
+
+**Request Body:**
+
+```json
+{
+  "name": "Jane Doe"
+}
+```
+
+### Delete Speaker
+
+```http
+DELETE /api/v1/speakers/{id}
+```
+
+### Get Recording Speakers
+
+```http
+GET /api/v1/recordings/{id}/speakers
+```
+
+Returns speakers in the recording with voice-based identification suggestions.
+
+**Response:**
+
+```json
+{
+  "speakers": [
+    {
+      "label": "SPEAKER_00",
+      "identified_name": "John Doe",
+      "speaker_id": 1,
+      "segment_count": 23
+    }
+  ],
+  "suggestions": {
+    "SPEAKER_01": [
+      {"speaker_id": 2, "name": "Jane Smith", "similarity": 89.5}
+    ]
+  }
+}
+```
+
+---
+
+## Processing Operations
+
+### Queue Transcription
+
+```http
+POST /api/v1/recordings/{id}/transcribe
+```
+
+**Request Body:**
+
+```json
+{
+  "language": "en",
+  "min_speakers": 1,
+  "max_speakers": 5
+}
+```
+
+All parameters are optional.
+
+**Response:**
+
+```json
+{
+  "success": true,
+  "job_id": "abc123",
+  "status": "QUEUED",
+  "message": "Transcription queued"
+}
+```
+
+### Queue Summarization
+
+```http
+POST /api/v1/recordings/{id}/summarize
+```
+
+**Request Body:**
+
+```json
+{
+  "custom_prompt": "Focus on technical decisions and action items only"
+}
+```
+
+The custom prompt overrides the recording's tag prompts and user defaults.
+
+---
+
+## Chat
+
+### Chat with Recording
+
+```http
+POST /api/v1/recordings/{id}/chat
+```
+
+Ask questions about a recording's content using AI.
+
+**Request Body:**
+
+```json
+{
+  "message": "What were the main action items discussed?",
+  "conversation_history": [
+    {"role": "user", "content": "Who attended?"},
+    {"role": "assistant", "content": "John and Jane attended..."}
+  ]
+}
+```
+
+**Response:**
+
+```json
+{
+  "response": "The main action items were:\n1. Complete the report by Friday\n2. Schedule follow-up meeting...",
+  "sources": []
+}
+```
+
+---
+
+## Events
+
+### Get Calendar Events
+
+```http
+GET /api/v1/recordings/{id}/events
+```
+
+Returns calendar events extracted from the recording.
+
+**Response:**
+
+```json
+{
+  "events": [
+    {
+      "id": 1,
+      "title": "Follow-up Meeting",
+      "start_datetime": "2024-01-22T10:00:00Z",
+      "end_datetime": "2024-01-22T11:00:00Z",
+      "description": "Discuss project progress",
+      "location": "Conference Room A"
+    }
+  ]
+}
+```
+
+### Download Events as ICS
+
+```http
+GET /api/v1/recordings/{id}/events/ics
+```
+
+Returns an ICS file containing all events from the recording.
+
+---
+
+## Audio
+
+### Download Audio
+
+```http
+GET /api/v1/recordings/{id}/audio
+```
+
+**Query Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `download` | boolean | `false` | `true` to force download, `false` to stream |
+
+---
+
+## Batch Operations
+
+### Batch Update Recordings
+
+```http
+PATCH /api/v1/recordings/batch
+```
+
+**Request Body:**
+
+```json
+{
+  "recording_ids": [1, 2, 3],
+  "updates": {
+    "is_inbox": false,
+    "is_highlighted": true,
+    "add_tag_ids": [5],
+    "remove_tag_ids": [2]
+  }
+}
+```
+
+**Response:**
+
+```json
+{
+  "success": true,
+  "updated": 3,
+  "failed": 0,
+  "results": [
+    {"id": 1, "success": true},
+    {"id": 2, "success": true},
+    {"id": 3, "success": true}
+  ]
+}
+```
+
+### Batch Delete Recordings
+
+```http
+DELETE /api/v1/recordings/batch
+```
+
+**Request Body:**
+
+```json
+{
+  "recording_ids": [1, 2, 3]
+}
+```
+
+### Batch Queue Transcriptions
+
+```http
+POST /api/v1/recordings/batch/transcribe
+```
+
+**Request Body:**
+
+```json
+{
+  "recording_ids": [1, 2, 3]
+}
+```
+
+---
+
+## Error Responses
+
+All endpoints return consistent error responses:
+
+```json
+{
+  "error": "Error message description"
+}
+```
+
+**Common HTTP Status Codes:**
+
+| Code | Description |
+|------|-------------|
+| `200` | Success |
+| `201` | Created |
+| `400` | Bad Request - Invalid parameters |
+| `401` | Unauthorized - Invalid or missing token |
+| `403` | Forbidden - No permission for this resource |
+| `404` | Not Found - Resource doesn't exist |
+| `500` | Internal Server Error |
+
+---
+
+## Rate Limits
+
+API endpoints are rate-limited to prevent abuse:
+
+| Endpoint Type | Limit |
+|---------------|-------|
+| Stats | 60 requests/minute |
+| GET endpoints | 100 requests/minute |
+| PATCH/DELETE | 30 requests/minute |
+| Processing operations | 10 requests/minute |
+| Batch operations | 10 requests/minute |
+
+---
+
+## Integration Examples
+
+### Python SDK Pattern
+
+```python
+import requests
+
+class SpeakrAPI:
+    def __init__(self, base_url, token):
+        self.base_url = base_url.rstrip('/')
+        self.session = requests.Session()
+        self.session.headers['Authorization'] = f'Bearer {token}'
+
+    def get_stats(self):
+        return self.session.get(f'{self.base_url}/api/v1/stats').json()
+
+    def list_recordings(self, status='all', page=1):
+        return self.session.get(
+            f'{self.base_url}/api/v1/recordings',
+            params={'status': status, 'page': page}
+        ).json()
+
+    def get_transcript(self, recording_id, format='text'):
+        return self.session.get(
+            f'{self.base_url}/api/v1/recordings/{recording_id}/transcript',
+            params={'format': format}
+        ).json()
+
+# Usage
+api = SpeakrAPI('https://speakr.example.com', 'YOUR_TOKEN')
+stats = api.get_stats()
+print(f"Total recordings: {stats['recordings']['total']}")
+```
+
+### n8n Workflow
+
+1. Use **HTTP Request** node
+2. Set **Method** to `GET`
+3. Set **URL** to `https://your-instance/api/v1/recordings`
+4. In **Authentication**, select **Header Auth**
+5. Add header: `Authorization` = `Bearer YOUR_TOKEN`
+
+### Zapier Integration
+
+Use the **Webhooks by Zapier** app with:
+
+- **Trigger**: Custom webhook
+- **Action**: GET request to `/api/v1/recordings`
+- **Headers**: `Authorization: Bearer YOUR_TOKEN`
+
+---
+
+Next: Learn about [API Tokens](api-tokens.md) for authentication setup.
diff --git a/docs/user-guide/api-tokens.md b/docs/user-guide/api-tokens.md
new file mode 100644
index 00000000..c1b4bf48
--- /dev/null
+++ b/docs/user-guide/api-tokens.md
@@ -0,0 +1,223 @@
+# API Tokens
+
+API tokens enable programmatic access to your Speakr instance, allowing you to integrate with automation tools like n8n, Zapier, Make, or custom scripts. Each token is tied to your user account and provides the same access as logging in through the web interface.
+
+## Overview
+
+API tokens are personal access tokens that authenticate API requests on your behalf. They're perfect for:
+
+- **Automation workflows** - Trigger transcriptions from n8n, Zapier, or Make
+- **Custom scripts** - Build integrations with your existing tools
+- **CI/CD pipelines** - Automate audio processing in development workflows
+- **Mobile apps** - Access your recordings from custom applications
+
+!!! warning "Security Notice"
+    Treat API tokens like passwords. They provide full access to your account. Never share tokens publicly, commit them to version control, or expose them in client-side code.
+
+## Creating a Token
+
+1. Navigate to **Account Settings** → **API Tokens** tab
+2. Click **Create Token**
+3. Enter a descriptive name (e.g., "n8n automation", "CLI access")
+4. Choose an expiration period:
+    - **No expiration** - Token remains valid until manually revoked
+    - **30 days**, **90 days**, **1 year** - Token automatically expires
+5. Click **Create**
+
+!!! important "Save Your Token"
+    The token value is only shown once after creation. Copy it immediately and store it securely. If you lose it, you'll need to create a new token.
+
+## Using Your Token
+
+Speakr accepts tokens through multiple methods, giving you flexibility based on your integration needs.
+
+### Authorization Header (Recommended)
+
+The most secure and standard method:
+
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN_HERE" \
+     https://your-speakr-instance.com/api/v1/recordings
+```
+
+### X-API-Token Header
+
+Alternative header format:
+
+```bash
+curl -H "X-API-Token: YOUR_TOKEN_HERE" \
+     https://your-speakr-instance.com/api/v1/recordings
+```
+
+### API-Token Header
+
+Another alternative:
+
+```bash
+curl -H "API-Token: YOUR_TOKEN_HERE" \
+     https://your-speakr-instance.com/api/v1/recordings
+```
+
+### Query Parameter
+
+For simple integrations (less secure - token visible in logs):
+
+```bash
+curl "https://your-speakr-instance.com/api/v1/recordings?token=YOUR_TOKEN_HERE"
+```
+
+## Available API Endpoints
+
+Speakr provides a comprehensive REST API with endpoints for recordings, tags, speakers, processing operations, and more.
+
+!!! tip "Full API Documentation"
+    See the complete [API Reference](api-reference.md) for all endpoints, parameters, and examples. You can also access interactive documentation at `/api/v1/docs` on your instance.
+
+**Quick reference of common endpoints:**
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/v1/stats` | GET | Dashboard statistics (gethomepage.dev compatible) |
+| `/api/v1/recordings` | GET | List recordings with filtering and pagination |
+| `/api/v1/recordings/<id>` | GET | Get recording details |
+| `/api/v1/recordings/<id>/transcript` | GET | Get transcript (json, text, srt, vtt) |
+| `/api/v1/recordings/<id>/summary` | GET | Get AI-generated summary |
+| `/api/v1/recordings/<id>/transcribe` | POST | Queue transcription |
+| `/api/v1/recordings/<id>/summarize` | POST | Queue summarization |
+| `/api/v1/tags` | GET | List your tags |
+| `/api/v1/speakers` | GET | List your speakers |
+
+### Example: List Recordings
+
+```bash
+curl -H "Authorization: Bearer YOUR_TOKEN_HERE" \
+     "https://your-speakr-instance.com/api/v1/recordings?page=1&per_page=25"
+```
+
+Response:
+```json
+{
+  "pagination": {
+    "page": 1,
+    "per_page": 25,
+    "total": 42,
+    "total_pages": 2,
+    "has_next": true,
+    "has_prev": false
+  },
+  "recordings": [
+    {
+      "id": 123,
+      "title": "Team Meeting Notes",
+      "status": "COMPLETED",
+      "created_at": "Nov 27, 2025, 2:30:00 PM",
+      "tags": [...]
+    }
+  ]
+}
+```
+
+## Managing Tokens
+
+### Viewing Active Tokens
+
+The API Tokens tab shows all your active tokens with:
+
+- **Name** - The descriptive name you assigned
+- **Status** - Active, expired, or revoked
+- **Created date** - When the token was created
+- **Last used** - When the token was last used for authentication
+- **Expiration** - When the token will expire (if set)
+
+### Revoking Tokens
+
+Click the trash icon next to any token to revoke it immediately. Revoked tokens:
+
+- Stop working instantly
+- Cannot be restored
+- Should be replaced with a new token if needed
+
+!!! tip "Best Practice"
+    Revoke tokens you no longer need. If you suspect a token has been compromised, revoke it immediately and create a new one.
+
+## Security Best Practices
+
+### Do's
+
+- ✅ Use descriptive names to track token purposes
+- ✅ Set expiration dates for temporary integrations
+- ✅ Revoke unused tokens promptly
+- ✅ Store tokens in secure credential managers
+- ✅ Use environment variables in scripts
+
+### Don'ts
+
+- ❌ Share tokens with others (create separate tokens per user)
+- ❌ Commit tokens to version control
+- ❌ Include tokens in client-side JavaScript
+- ❌ Use the same token for multiple purposes
+- ❌ Log full token values in application logs
+
+## Integration Examples
+
+### n8n Workflow
+
+In n8n, use the HTTP Request node with:
+
+- **Authentication**: Header Auth
+- **Name**: `Authorization`
+- **Value**: `Bearer YOUR_TOKEN_HERE`
+
+### Python Script
+
+```python
+import requests
+
+TOKEN = "YOUR_TOKEN_HERE"
+BASE_URL = "https://your-speakr-instance.com"
+
+headers = {"Authorization": f"Bearer {TOKEN}"}
+
+# List recordings
+response = requests.get(f"{BASE_URL}/api/v1/recordings", headers=headers)
+recordings = response.json()["recordings"]
+
+for recording in recordings:
+    print(f"{recording['id']}: {recording['title']}")
+```
+
+### Shell Script
+
+```bash
+#!/bin/bash
+TOKEN="YOUR_TOKEN_HERE"
+BASE_URL="https://your-speakr-instance.com"
+
+# Get all recordings
+curl -s -H "Authorization: Bearer $TOKEN" \
+     "$BASE_URL/api/v1/recordings" | jq '.recordings[].title'
+```
+
+## Troubleshooting
+
+### Token Not Working
+
+1. **Check token value** - Ensure you copied the complete token without extra spaces
+2. **Verify header format** - The Bearer prefix requires a space: `Bearer TOKEN`
+3. **Check expiration** - Expired tokens silently fail authentication
+4. **Verify endpoint** - Ensure you're using the correct URL
+
+### 401 Unauthorized
+
+- Token may be expired or revoked
+- Check the token is being sent correctly
+- Verify the endpoint requires authentication
+
+### 403 Forbidden
+
+- Token is valid but you don't have permission for that resource
+- Check if the recording belongs to your account
+
+---
+
+Next: Return to [Account Settings](settings.md) →
diff --git a/docs/user-guide/first-steps.md b/docs/user-guide/first-steps.md
new file mode 100644
index 00000000..9b18f877
--- /dev/null
+++ b/docs/user-guide/first-steps.md
@@ -0,0 +1,164 @@
+# Main View
+
+The Speakr main view is where you'll spend most of your time. It's designed as a three-panel interface that makes it easy to navigate your recordings, review transcriptions, and interact with your content. Understanding each component will help you work more efficiently with your audio recordings.
+
+![Main View Interface](../assets/images/screenshots/Main view.png)
+
+## Understanding the Interface Layout
+
+The main view is organized into three distinct sections that work together seamlessly. On the left, you have the recordings sidebar where all your audio files are listed and can be filtered. The center panel displays the full transcription of your selected recording. If your recording was processed with ASR and speaker diarization, you'll see speaker labels and can click any sentence to jump to that position in the audio. The right panel contains the AI-generated summary, your personal notes, and an interactive chat interface. Above both the center and right panels, spanning across the top, is the metadata bar with recording information and action buttons.
+
+## Top Navigation Bar
+
+The navigation bar at the top of the screen provides quick access to essential features:
+
+![Navigation Elements](../assets/images/screenshots/Main view.png)
+
+Starting from the left, you'll find the Speakr logo which always brings you back to the main view from anywhere in the application. The Inquire button opens the semantic search interface, allowing you to search across all your recordings using natural language questions. The New Recording button is your gateway to creating new content, either by uploading existing audio files or recording directly in your browser. On the right side, your username appears with a dropdown menu containing access to settings, language preferences, and the logout option.
+
+## Left Sidebar - Recording List and Filters
+
+The left sidebar is your command center for organizing and finding recordings. At the top, you'll see a search bar that lets you quickly find recordings by title or content. Below that, the filter system helps you narrow down your recording list.
+
+### Using Filters
+
+![Filter Interface](../assets/images/screenshots/filters-sidebar-expanded.png)
+
+The filter system in Speakr is designed to be both powerful and intuitive. Click on "Active filters" to expand the filtering panel. You can filter by tags, which appear as colored pills that you can click to select or deselect. The date range filter offers convenient presets like "Today", "Yesterday", "This Week", and "Last Week", or you can set a custom date range using the date pickers. When filters are active, their count appears next to the filter label, and a clear button lets you reset all filters at once.
+
+### Recording List
+
+Below the filters, your recordings are displayed as cards showing essential information at a glance. Each recording card displays the title prominently, followed by metadata including the participants (if speaker diarization was used), the recording date, and the duration. Colored tag pills show which categories have been assigned to each recording. The small icons on the right indicate the recording's processing status, with different colors for completed, processing, or failed transcriptions.
+
+## Center Panel - Transcription View
+
+The center panel is where you'll read and interact with your transcription. This is the heart of Speakr, displaying the complete text of your recording.
+
+### Transcription Display
+
+![Transcription with Speakers](../assets/images/screenshots/main-view-with-speakers.png)
+![Summary View](../assets/images/screenshots/main-view-summary-tab.png)
+
+The transcription display varies depending on how your audio was processed. If you used a standard Whisper API endpoint, you'll see a simple continuous text transcription without speaker identification. The text flows as a single narrative, which works well for single-speaker recordings or when speaker identification isn't needed.
+
+If you've used an ASR endpoint with speaker diarization enabled, each speaker's contributions are clearly labeled with colored tags like "SPEAKER_01", "SPEAKER_02", etc. These labels are color-coded to help you follow multi-person conversations visually. While timestamps aren't displayed in the text, clicking on any sentence will automatically move the audio player to that exact position, making it easy to navigate through the recording.
+
+### View Options
+
+Above the transcription, several buttons control how the content is displayed. The Copy button lets you copy the entire transcription to your clipboard. The Edit button enables inline editing of the transcription if you need to make corrections.
+
+If your recording was processed with speaker diarization, you'll also see a Simple/Bubble toggle that switches between a flowing text view and a conversation bubble format. This toggle is only available when speaker identification is present in the transcription.
+
+## Recording Metadata Bar
+
+Spanning across the top of both the center and right panels, the metadata bar displays important recording information and provides quick access to actions. From left to right, you'll see the recording title, participant names (if identified), recording date and time, file size, and duration. The action buttons on the right side of this bar allow you to bookmark the recording (star icon), edit recording details (pencil icon), manage tags (tag icon), reprocess the transcription (refresh icon), share the recording (share icon), and delete the recording (trash icon).
+
+## Right Panel - Playback, Summary, Notes, and Chat
+
+The right panel contains three tabbed sections that enhance your transcription with AI-powered features and personal annotations.
+
+### Playback Controls
+
+At the top of the right panel, you'll find the audio player controls. The play button starts and pauses playback, while the timeline shows your current position in the recording. You can click anywhere on the timeline to jump to that point. The speed control lets you adjust playback from 0.5x to 2x speed, which is particularly useful for quickly reviewing content or carefully analyzing specific sections.
+
+If your recording has speaker diarization, clicking on any sentence in the transcription will automatically seek the audio player to that exact moment, providing seamless navigation through the recording.
+
+### Summary Tab
+
+The Summary tab displays an AI-generated overview of your recording. This summary captures the key points, decisions, and action items from your recording, saving you time when reviewing content. The summary is automatically generated after transcription completes but can be regenerated with different settings if needed.
+
+### Notes Tab
+
+The Notes tab is your personal workspace for adding context, thoughts, or follow-up items related to the recording. These notes are private to you and searchable, making them perfect for adding meeting outcomes, personal reminders, or additional context that wasn't captured in the recording. The notes support markdown formatting, allowing you to create lists, headers, and formatted text.
+
+### Chat Tab
+
+The Chat tab provides an interactive AI assistant that can answer questions about your recording. Simply type a question like "What were the main decisions made?" or "What did John say about the budget?" and the AI will analyze the transcription to provide relevant answers. This is particularly useful for long recordings where you need to quickly find specific information.
+
+## Reprocessing Options
+
+Speakr provides two types of reprocessing to update your recordings with improved settings or different parameters.
+
+### Full Reprocessing
+
+![Full Reprocessing Modal](../assets/images/screenshots/full recording reprocessing.png)
+
+Full reprocessing completely re-transcribes your audio file using the ASR endpoint. This is useful when you want to change speaker diarization settings or use a different transcription model. Access this by clicking the refresh icon in the metadata bar and selecting "Transcription Reprocessing". You can adjust the language setting, minimum and maximum speakers for diarization, and other ASR-specific options. Note that full reprocessing will overwrite any manual edits you've made to the transcription.
+
+### Summary Reprocessing
+
+![Summary Reprocessing Modal](../assets/images/screenshots/summary reprocessing modal.png)
+
+Summary reprocessing generates a new title and summary based on the existing transcription. This is faster than full reprocessing and preserves any edits you've made to the transcription text. Use this when you want to regenerate the summary with different AI settings or after making significant edits to the transcription. Access this option from the same refresh menu by selecting "Summary Reprocessing".
+
+## Working with Multiple Recordings
+
+The main view is designed to handle large libraries of recordings efficiently. You can combine multiple filters to find exactly what you're looking for. For example, you might filter for all "Meeting" tagged recordings from last week that mention "budget" in the transcription. The filters work together, narrowing down your results with each additional criterion.
+
+When working with many recordings, consider using the sort options to organize by either creation date (when you uploaded or recorded) or meeting date (when the recording actually took place). This distinction is particularly useful when you're uploading older recordings or processing a backlog of audio files.
+
+## Tips for Effective Use
+
+To get the most out of the main view, develop a consistent tagging strategy early on. Create tags for different projects, clients, or meeting types, and apply them consistently. This small investment of time pays dividends when you need to find specific recordings later.
+
+The search function is powerful but works best with specific terms. Instead of searching for common words like "the" or "meeting", search for unique terms, project names, or specific topics discussed in your recordings.
+
+Make use of the notes section immediately after meetings while the context is fresh in your mind. These personal annotations become invaluable when revisiting recordings weeks or months later.
+
+For long recordings, the chat interface can save significant time. Instead of reading through an entire hour-long transcription, ask the AI specific questions about decisions made, action items assigned, or topics discussed.
+
+Remember that the interface updates in real-time. When you upload a new recording or when transcription completes, the interface will automatically refresh to show the latest status. You don't need to manually reload the page to see updates.
+
+## Collaboration Features (Optional)
+
+If you're working with a team or family, Speakr's collaboration features help you automatically share recordings with the right people. This section covers groups, group tags, and sharing - all optional but powerful when you need them.
+
+### Understanding Groups and Group Tags
+
+**Groups** are collections of users who regularly work together (e.g., "Engineering Team", "Family", "Sales Department"). Your administrator creates and manages groups, and you're automatically a member of any groups you've been added to.
+
+**Group Tags** are special tags that belong to a group. When you apply a group tag to a recording, all current members of that group automatically get access to it. This is perfect for project-specific content, department meetings, or family events that everyone should see.
+
+### Using Group Tags to Share Recordings
+
+If your administrator has created groups and group tags for you:
+
+1. When creating or editing a recording, click the **tag icon** in the metadata bar
+2. Look for tags that show a group indicator (these are your group tags)
+3. Select any group tag to apply it
+4. All group members instantly receive access to this recording
+
+Group tags can also include custom AI prompts for specialized summaries and retention policies for automatic cleanup. For example, a "Daily Standup" group tag might auto-delete recordings after 14 days, while a "Legal Consultations" tag keeps recordings permanently.
+
+### Individual Sharing
+
+For one-off collaborations or sharing with specific people outside your groups:
+
+1. Open the recording you want to share
+2. Click the **share icon** (users icon) in the toolbar
+3. Search for the user's name and select them
+4. Choose their permission level:
+    - **View Only**: Can read and listen, but not edit
+    - **Edit**: Can modify metadata, notes, and summary
+    - **Reshare**: Can share with additional users
+5. Click to add them - they immediately receive access
+
+### Personal Notes on Shared Recordings
+
+When someone shares a recording with you, you can add your own private notes that only you can see. This is perfect for tracking your action items or personal observations without cluttering the shared content. Your notes are completely separate from the recording owner's notes and the shared summary.
+
+To add personal notes to a shared recording, simply click on the **Notes** tab and start typing. These notes are yours alone and won't be visible to the recording owner or other people who have access.
+
+### Viewing Recordings Shared With You
+
+Recordings that others have shared with you appear in your main recording list with a subtle visual indicator. Use the **"Shared with Me"** filter in the sidebar to view only recordings others have shared with you, making it easy to focus on collaborative content.
+
+For complete details on all collaboration features, see the [Sharing & Collaboration guide](sharing.md).
+
+## Creating New Content
+
+Now that you understand how to navigate and interact with existing recordings in the main view, let's explore how to create new content. Speakr offers two ways to add recordings to your library: uploading existing audio files or recording directly in your browser.
+
+---
+
+Next: [Recording and Uploading Audio](recording.md) →
\ No newline at end of file
diff --git a/docs/user-guide/folders.md b/docs/user-guide/folders.md
new file mode 100644
index 00000000..7a12ceaf
--- /dev/null
+++ b/docs/user-guide/folders.md
@@ -0,0 +1,147 @@
+# Folders
+
+Folders provide a simple way to organize your recordings into logical groups. Unlike tags which can be applied multiple times to categorize content, each recording belongs to exactly one folder (or no folder). Think of folders like directories on your computer - a clean, hierarchical way to keep related recordings together.
+
+## Enabling Folders
+
+Folders are disabled by default. An administrator must enable the feature before users can create and use folders.
+
+**For Administrators:**
+
+1. Go to Admin Panel → System Settings
+2. Find the `enable_folders` setting and set it to `true`
+3. Save changes
+
+Or set the environment variable:
+```bash
+ENABLE_FOLDERS=true
+```
+
+Once enabled, all users will see folder management options in their Account Settings and folder selectors throughout the interface.
+
+## Creating Folders
+
+Access folder management from **Account Settings → Folders** tab.
+
+Click **Create Folder** to add a new folder. Each folder has:
+
+- **Name** - A short, descriptive name (required)
+- **Color** - Visual identifier shown on folder pills and in the sidebar
+
+### Folder Settings
+
+Each folder can have custom settings that apply to recordings placed in it:
+
+| Setting | Description |
+|---------|-------------|
+| **Custom Prompt** | AI summarization instructions specific to this folder. May include `{{name}}` placeholders that are filled at upload time — see [Prompt Variables](settings.md#prompt-variables) |
+| **Default Language** | Transcription language for new recordings |
+| **Default Transcription Model** | Model the transcription connector should use when an admin has configured `TRANSCRIPTION_MODELS_AVAILABLE` (or curated a list from the admin dashboard) |
+| **Min/Max Speakers** | Speaker count hints for ASR diarization |
+| **Hotwords** | Comma-separated vocabulary hints for transcription accuracy |
+| **Initial Prompt** | Context description to guide transcription |
+| **Retention Days** | Override global retention for recordings in this folder |
+| **Protection** | Exempt folder contents from auto-deletion |
+
+These settings work like tag settings - when you add a recording to a folder, the folder's custom prompt and ASR settings are applied during processing. Tag-level defaults take precedence over folder-level defaults; per-upload selections take precedence over both.
+
+## Using Folders
+
+### Sidebar Folder Selector
+
+The sidebar includes a folder dropdown at the top. Use it to:
+
+- **Filter by folder** - Select a folder to show only recordings in that folder
+- **View all recordings** - Select "All Folders" to see everything
+- **View unfiled** - Select "No Folder" to see recordings not in any folder
+
+### Moving Recordings to Folders
+
+There are several ways to assign recordings to folders:
+
+1. **During upload** - Select a folder before uploading
+2. **From recording detail** - Use the folder selector in the recording header
+3. **Bulk operations** - Select multiple recordings and use the folder action
+
+### Folder Pills
+
+Recordings display a small colored pill showing their folder name. This appears in:
+
+- The sidebar recording list
+- The recording detail header
+- Search results
+
+Click the pill to quickly filter to that folder.
+
+### Title Bar Icon
+
+When viewing a recording that's in a folder, a folder icon appears in the title bar next to the recording title. Click it to see folder details or change the folder assignment.
+
+## Group Folders
+
+If your organization uses groups, folders can be group-scoped:
+
+- **Personal folders** - Visible only to you
+- **Group folders** - Shared with all group members
+
+Group folders work like group tags with auto-sharing:
+
+| Setting | Description |
+|---------|-------------|
+| **Auto Share on Apply** | Automatically share recordings with group members when moved to this folder |
+| **Share with Group Lead** | Also share with group administrators |
+
+When you move a recording to a group folder with auto-share enabled, all group members receive access automatically.
+
+## Folders vs Tags
+
+Both folders and tags help organize recordings, but they serve different purposes:
+
+| Aspect | Folders | Tags |
+|--------|---------|------|
+| **Assignment** | One folder per recording | Multiple tags per recording |
+| **Purpose** | Primary organization | Categorization and filtering |
+| **Hierarchy** | Flat list | Flat list |
+| **Settings** | Custom prompt, ASR, retention | Custom prompt, ASR, retention |
+| **Visual** | Pill badge, sidebar filter | Colored badges |
+
+**Use folders for:** Project-based organization, client separation, meeting types
+
+**Use tags for:** Cross-cutting concerns, status tracking, topic categorization
+
+You can use both together - put a recording in the "Client A" folder and tag it with "Action Items" and "Follow-up Needed".
+
+## Best Practices
+
+### Naming Conventions
+
+Choose clear, consistent folder names:
+
+- **By project:** "Website Redesign", "Q1 Planning", "Product Launch"
+- **By client:** "Acme Corp", "Beta Inc", "Gamma LLC"
+- **By type:** "Team Standups", "Client Calls", "Interviews"
+
+### Folder Prompts
+
+Use folder-specific prompts for consistent summaries:
+
+```
+For client meetings, create a summary with:
+- Discussion topics
+- Client requests and concerns
+- Commitments made
+- Next steps with owners
+```
+
+### Retention Strategies
+
+Set folder-level retention to match content needs:
+
+- **Active projects:** No retention limit
+- **Completed projects:** 90 days after project close
+- **Routine meetings:** 30 days
+- **Compliance recordings:** Use protection flag
+
+---
+
+Next: [Tags](settings.md#tag-management-tab) →
diff --git a/docs/user-guide/groups.md b/docs/user-guide/groups.md
new file mode 100644
index 00000000..b9302f12
--- /dev/null
+++ b/docs/user-guide/groups.md
@@ -0,0 +1,158 @@
+---
+layout: default
+title: Group Collaboration
+parent: User Guide
+nav_order: 6
+---
+
+# Group Collaboration
+
+Groups transform how groups work together in Speakr, enabling seamless collaboration without manual sharing overhead. When your organization uses groups, recordings automatically reach the right people at the right time, eliminating the tedious process of individually sharing each conversation with every relevant group member.
+
+## Understanding Groups
+
+Groups in Speakr are organized groups of users who regularly need access to the same recordings. Unlike individual sharing where you manually grant access user-by-user, groups use smart tags that automatically share content with all group members when applied. This automation makes groups perfect for departments, project groups, or any collection of people who work together regularly.
+
+Your administrator creates and manages groups through the admin dashboard. Once you're added to a group, you gain access to group-specific tags and automatically receive recordings when teammates apply group tags. This creates a collaborative space where everyone stays informed without constant manual intervention.
+
+Groups work alongside personal organization tools. Your personal tags remain private and independent, while group tags create shared context. You can combine both - use personal tags for your workflow organization and group tags for automatic collaboration, creating a system that serves both individual and group needs.
+
+## Group Tags
+
+Group tags are the engine that powers group collaboration. They look and work like regular tags but carry special automatic sharing capabilities. When anyone applies a group tag to a recording, every group member instantly gains access without additional steps.
+
+### Recognizing Group Tags
+
+Group tags display with a distinctive users icon (👥) throughout the Speakr interface, making them immediately identifiable. Whether you're browsing the tag selector, viewing a recording's tags, or managing tags in settings, the users icon clearly marks group versus personal tags.
+
+In your tag management interface, group tags show the group name and cannot be deleted by regular users. Only group admins can create or remove group tags, ensuring centralized control over group-wide organizational systems. This prevents confusion where different group members create conflicting organizational structures.
+
+### Applying Group Tags
+
+Applying a group tag works exactly like applying a personal tag - open a recording, click the tags button, and select from your available tags. The difference happens behind the scenes: the moment you apply a group tag, Speakr automatically creates internal shares for every group member.
+
+This automatic sharing grants group members both view and edit access. They can read transcriptions and summaries, listen to audio, modify notes and metadata, and add their own tags. However, even with edit access, only the recording's original owner can delete it. This balance enables collaboration while protecting content ownership.
+
+The automatic sharing is intelligent. If a group member already has access through a previous share, Speakr doesn't create duplicates. If someone is added to the group later, they don't automatically gain access to old recordings - only recordings tagged after they join. This prevents retroactive access leakage while maintaining security.
+
+### Using Group Tags Effectively
+
+Apply group tags immediately after important meetings or discussions to ensure group-wide visibility while context is fresh. This creates a shared understanding quickly, letting everyone review content and add notes while details are clear. Prompt tagging turns recordings from individual resources into group knowledge.
+
+Combine group tags with personal tags for powerful organization. Use group tags to identify the audience (which group needs access) and personal tags for workflow status or content type. For example, tag a recording with both the "Engineering" group tag and your personal "Action Required" tag. The group tag shares with colleagues, while your personal tag tracks your follow-ups.
+
+When recordings touch multiple groups, you can apply multiple group tags. Each group tag grants access to its respective group members, creating overlapping access that matches cross-functional work. Be thoughtful with multi-group tagging - ensure all tagged groups actually need access to avoid overcommunicating.
+
+### Group Tag Features
+
+Some group tags carry special capabilities beyond basic sharing. Your administrator might configure group tags with custom retention policies that override global deletion rules. A "Legal Records" group tag might preserve recordings for seven years, while a "Daily Stand-ups" tag might auto-delete after two weeks. These tag-specific retention policies happen automatically - you just apply the tag and the system enforces the appropriate lifecycle.
+
+Protected group tags prevent automatic deletion entirely, regardless of age. Recordings with protected tags are never auto-deleted, making them perfect for compliance requirements, important decisions, or reference material. The protection is permanent until someone removes the tag, ensuring critical content remains accessible.
+
+Group tags can also include custom AI prompts that generate specialized summaries. When you apply a tag with a custom prompt, reprocessing the summary uses that prompt instead of your default. This lets different types of group content receive appropriate AI treatment - technical reviews get detailed technical summaries, while executive briefings get high-level overviews.
+
+## Working with Group Recordings
+
+Recordings shared via group tags appear in your main interface alongside your own recordings. Clear visual indicators help distinguish content sources and access levels, so you always know what you're looking at and what you can do with it.
+
+### Identifying Group Content
+
+The recording cards show multiple badges that communicate status at a glance. A blue "Group" badge indicates the recording has group tags applied, signaling it's group content. If you don't own the recording, a purple "Shared" badge appears, showing you've received access through sharing. Hovering over shared recordings reveals the owner's username, maintaining clarity about content source.
+
+Group tags themselves appear on recording cards, each marked with the users icon. When you see multiple tags on a recording, the icon helps identify which are group-wide (accessible to all group members) versus personal tags (visible only to the owner).
+
+The "Shared with Me" filter in the sidebar isolates recordings others have shared with you, including those shared via group tags. This filtered view helps focus on collaborative content when you need to review group discussions without distraction from your personal recordings.
+
+### Your Permissions on Group Recordings
+
+As a group member, you receive edit permissions on recordings with group tags. This means you can modify the title to add clarity, update the participant list with correct names, adjust the meeting date if needed, edit notes to add context or corrections, and add tags for better organization.
+
+Your edit capabilities come with important limitations. You cannot delete group recordings even with edit access - only the original owner can delete content. This prevents accidental data loss while enabling collaborative enhancement. You also cannot share group recordings with users outside the group without re-share permissions, which are typically reserved for group administrators.
+
+### Personal Notes on Group Recordings
+
+When you access a group recording, you can add personal notes that remain completely private. These personal notes never appear to the recording owner or other group members - they're your private space for observations, follow-ups, questions, or action items.
+
+Personal notes persist as long as you have access to the recording. If you leave the group or a group admin revokes your access, your personal notes are automatically deleted. This cleanup prevents orphaned data and ensures notes don't persist after access ends.
+
+Use personal notes to track what matters to you without cluttering shared notes. The recording owner's notes should contain universal context, while your personal notes capture your specific perspective, tasks, or concerns. This separation keeps shared notes focused while giving everyone space for individual tracking.
+
+## Group Membership
+
+Your group membership determines which group tags you can see and which recordings you automatically receive when teammates tag content. Group administrators can adjust membership as projects and roles evolve.
+
+### Joining a Group
+
+Group membership is managed by administrators through the admin dashboard. When you're added to a group, you immediately gain access to that group's tags and can apply them to your recordings. You also begin receiving recordings when teammates use group tags going forward.
+
+New group membership doesn't grant retroactive access. If a group has been using group tags before you joined, you won't automatically see older group-tagged recordings. This prevents information leakage and maintains security. Group admins can manually share historical recordings if needed.
+
+### Group Roles
+
+Groups have two roles that determine capabilities within the group structure. Regular members can use group tags on their recordings and access recordings tagged by others. They see group content, contribute their recordings to the group space, and participate in collaborative discussions.
+
+Group admins have additional responsibilities. They can add or remove group members, promoting collaboration flexibility. They can create new group tags with custom settings, defining the organizational structure for group content. They can modify or delete existing group tags, maintaining the group's tag taxonomy as needs evolve. For administrators, group admins can access a limited version of the admin dashboard focused solely on group management.
+
+### Leaving Groups
+
+When you leave a group (either voluntarily or through admin action), several things happen automatically. You lose access to group tags, so they disappear from your tag selectors. Your access to group-shared recordings continues if you received them before leaving, but you won't receive new group recordings going forward. Any personal notes you created on group recordings are preserved if you retain access through other sharing mechanisms.
+
+## Group Administration for Group Admins
+
+If you're a group admin rather than a regular member, you have access to group management capabilities through a special admin interface. This limited admin dashboard focuses exclusively on group management without exposing system-wide administrative features.
+
+### Accessing Group Management
+
+Group admins see a "Group Management" link in their account menu, replacing the regular admin link. Clicking this takes you to a focused interface showing only groups you administer. You cannot see or manage other groups, maintaining security boundaries between different group administrators.
+
+The group management interface lets you view group members with their roles, add new members from your organization, change member roles between admin and regular member, remove members who no longer need access, and manage group tags including retention and protection settings.
+
+### Managing Group Members
+
+Adding members to your group makes them immediately eligible to receive group-tagged recordings. Search for users by username, select their initial role, and add them. They gain access to group tags right away and will receive future group recordings.
+
+Changing roles between member and admin adjusts capabilities. Promoting a member to admin grants them group management abilities, useful for distributing administrative workload. Demoting an admin to member removes management capabilities while preserving their group access.
+
+Removing members cuts off their access to future group recordings. They keep access to recordings they've already received, but new group tags won't share with them anymore. If you need to fully revoke access to existing content, you'll need to manually revoke those internal shares.
+
+### Creating and Managing Group Tags
+
+Group tags are your group's organizational vocabulary. Create tags that match how your group thinks about content - project names, content types, meeting categories, or whatever organizational scheme makes sense for your work.
+
+When creating group tags, you can set custom retention periods that override global settings. This lets your group manage content lifecycle based on group-specific requirements. Legal groups might set long retention, while operations groups might prefer shorter retention for routine recordings.
+
+Protection flags prevent automatic deletion entirely. Use protection for recordings that must be kept permanently - compliance records, critical decisions, reference materials. Protected tags ensure content survives regardless of age or global retention policies.
+
+### Syncing Group Shares
+
+If your group started using group tags before automatic sharing was fully implemented, you might have tagged recordings that didn't automatically share with current group members. The "Sync Group Shares" feature retroactively applies automatic sharing to existing group-tagged recordings.
+
+This sync operation runs through all recordings with your group's tags and creates internal shares for current group members who don't already have access. It's a one-time operation that brings historical content into alignment with current group membership, useful after enabling new group features or fixing configuration issues.
+
+## Best Practices for Group Collaboration
+
+Start using group tags from the beginning of projects or group formation. This builds a complete record of group discussions from inception, creating valuable historical context. Retroactively organizing recordings is possible but more tedious than tagging promptly.
+
+Establish group conventions for when to use group tags versus individual sharing. Some content naturally belongs to the whole group, while other recordings might be relevant to specific individuals. Clear guidelines prevent over-sharing while ensuring important information reaches everyone who needs it.
+
+Use descriptive group tag names that clearly communicate content type or purpose. Names like "Sprint Planning" or "Customer Feedback" immediately convey content without requiring detective work. Avoid generic tags like "Important" or "Misc" that don't add meaningful organization.
+
+Review group tags periodically with your group admin to ensure they remain relevant. Projects end, organizational structures change, and tag systems that once made sense can become outdated. Regular maintenance keeps group organization clean and useful.
+
+Contribute to shared notes when you add valuable context, but avoid duplicating information. Read existing notes before adding your own to prevent redundant content. Well-maintained shared notes become valuable group resources, while cluttered notes lose utility.
+
+Use personal notes liberally for your individual tracking needs. Don't worry about perfect notes since only you see them. Personal notes are your space for rough thoughts, action items, questions, and observations that might not be polished enough for shared notes.
+
+## Integration with Inquire Mode
+
+When your instance has Inquire Mode enabled, groups enhance semantic search capabilities. Group tags appear in Inquire Mode's filter options, letting you scope searches to specific group contexts. Search for "budget discussion" and filter to just your project group, finding relevant conversations without noise from other groups.
+
+Recordings shared via group tags are automatically included in your Inquire Mode searches. This means semantic search spans both your personal recordings and group content, creating a comprehensive knowledge base. The AI understands context across all accessible recordings, providing better answers by drawing on collective group knowledge.
+
+Your personal notes on group recordings remain private even in Inquire Mode. When semantic search uses a group recording to answer questions, it draws on the transcription and shared notes, but never exposes your personal annotations. This maintains the privacy boundary while enabling powerful group-wide search.
+
+---
+
+Ready to start collaborating? If you're not yet part of any groups, contact your administrator about joining relevant groups. If you're a group admin, learn more in the [Group Management](../admin-guide/group-management.md) guide.
+
+Return to [User Guide](index.md) →
diff --git a/docs/user-guide/index.md b/docs/user-guide/index.md
new file mode 100644
index 00000000..d0303232
--- /dev/null
+++ b/docs/user-guide/index.md
@@ -0,0 +1,143 @@
+# User Guide
+
+Welcome to the Speakr User Guide! This documentation will help you master every feature, from basic recording to advanced AI-powered search capabilities.
+
+## Quick Navigation
+
+<div class="guide-cards">
+  <div class="guide-card">
+    <div class="card-icon">🖥️</div>
+    <h3>Main View</h3>
+    <p>Navigate the three-panel interface, use smart filters, and manage your recordings efficiently.</p>
+    <a href="first-steps" class="card-link">Learn the Interface →</a>
+  </div>
+  
+  <div class="guide-card">
+    <div class="card-icon">📱</div>
+    <h3>Progressive Web App</h3>
+    <p>Install as a PWA for offline access and wake lock support during recording.</p>
+    <a href="pwa" class="card-link">Learn About PWA →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🎙️</div>
+    <h3>Recording & Uploading</h3>
+    <p>Upload audio files or record directly in your browser with live note-taking capabilities.</p>
+    <a href="recording" class="card-link">Start Recording →</a>
+  </div>
+  <div class="guide-card">
+    <div class="card-icon">📝</div>
+    <h3>Working with Transcripts</h3>
+    <p>Edit transcriptions, identify speakers, and use AI chat to explore your content.</p>
+    <a href="transcripts" class="card-link">Master Transcripts →</a>
+  </div>
+  
+  <div class="guide-card">
+    <div class="card-icon">🔍</div>
+    <h3>Inquire Mode</h3>
+    <p>Search across all recordings using natural language and semantic understanding.</p>
+    <a href="inquire-mode" class="card-link">Explore Inquire Mode →</a>
+  </div>
+  
+  <div class="guide-card">
+    <div class="card-icon">🔗</div>
+    <h3>Sharing & Collaboration</h3>
+    <p>Share recordings internally with colleagues or create public links for external stakeholders.</p>
+    <a href="sharing" class="card-link">Share Content →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">👥</div>
+    <h3>Group Collaboration</h3>
+    <p>Work with groups using auto-sharing tags and organized group access to recordings.</p>
+    <a href="groups" class="card-link">Collaborate with Groups →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">📁</div>
+    <h3>Folders</h3>
+    <p>Organize recordings into folders with per-folder prompts, ASR settings, and retention policies.</p>
+    <a href="folders" class="card-link">Organize with Folders →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">⚙️</div>
+    <h3>Account Settings</h3>
+    <p>Configure preferences, manage speakers, create tags, and customize AI prompts.</p>
+    <a href="settings" class="card-link">Customize →</a>
+  </div>
+
+  <div class="guide-card">
+    <div class="card-icon">🔑</div>
+    <h3>API Tokens</h3>
+    <p>Create personal access tokens for automation tools, scripts, and programmatic API access.</p>
+    <a href="api-tokens" class="card-link">API Access →</a>
+  </div>
+</div>
+
+## Pro Tips for Success
+
+<div class="tips-grid">
+  <div class="tip-card">
+    <h4>🏷️ Organize with Tags</h4>
+    <p>Create a consistent tagging system early. Tags with custom AI prompts can automatically generate specialized summaries for different content types.</p>
+  </div>
+  
+  <div class="tip-card">
+    <h4>🎤 Recording Best Practices</h4>
+    <p>Use combined microphone and system audio for meetings. Take live notes to mark important moments without interrupting the recording.</p>
+  </div>
+  
+  <div class="tip-card">
+    <h4>👥 Identify Speakers</h4>
+    <p>After transcription, identify speakers to build your speaker library. Future recordings will suggest known speakers automatically.</p>
+  </div>
+  
+  <div class="tip-card">
+    <h4>💬 Chat Efficiently</h4>
+    <p>For long recordings, ask specific questions like "What were the action items?" instead of reading the entire transcript.</p>
+  </div>
+  
+  <div class="tip-card">
+    <h4>🔎 Search Smartly</h4>
+    <p>Inquire Mode understands context, not just keywords. Ask natural questions to find information across all your recordings.</p>
+  </div>
+  
+  <div class="tip-card">
+    <h4>📊 Custom Summaries</h4>
+    <p>Set personal summary prompts in settings to get summaries tailored to your specific needs and workflow.</p>
+  </div>
+</div>
+
+## Getting Started
+
+The best way to learn Speakr is by doing. Start with these simple steps:
+
+1. **Upload a test file** - Try a short audio recording to see the transcription process
+2. **Explore the interface** - Click through the different views and panels
+3. **Try the AI chat** - Ask questions about your recording to see the AI in action
+4. **Create your first tag** - Set up organization from the beginning
+5. **Test Inquire Mode** - Search for something specific in your recordings
+
+As you grow comfortable with basics, explore advanced features like speaker diarization, custom AI prompts, and bulk operations.
+
+## Need Help?
+
+<div class="help-section">
+  <div class="help-item">
+    <span class="help-icon">📚</span>
+    <span>Browse the complete <a href="../faq">FAQ</a> for quick answers</span>
+  </div>
+  <div class="help-item">
+    <span class="help-icon">🔧</span>
+    <span>Check <a href="../troubleshooting">Troubleshooting</a> for common issues</span>
+  </div>
+  <div class="help-item">
+    <span class="help-icon">💬</span>
+    <span>Report issues on <a href="https://github.com/murtaza-nasir/speakr/issues">GitHub</a></span>
+  </div>
+</div>
+
+---
+
+Ready to become a Speakr power user? Start with [First Steps](first-steps.md) →
\ No newline at end of file
diff --git a/docs/user-guide/inquire-mode.md b/docs/user-guide/inquire-mode.md
new file mode 100644
index 00000000..453c4eb3
--- /dev/null
+++ b/docs/user-guide/inquire-mode.md
@@ -0,0 +1,100 @@
+---
+layout: default
+title: Inquire Mode
+parent: User Guide
+nav_order: 4
+---
+
+# Inquire Mode - Semantic Search
+
+Inquire Mode transforms your entire recording library into an intelligent knowledge base that you can search using natural language questions. Instead of hunting through individual recordings or trying to remember which meeting contained a specific discussion, you can simply ask questions and receive comprehensive answers drawn from all your relevant recordings.
+
+![Inquire Mode Interface](../assets/images/screenshots/Inquire mode.png)
+
+## Understanding Inquire Mode
+
+Think of Inquire Mode as having a knowledgeable assistant who has listened to every recording in your library and can instantly recall and synthesize information from any of them. When you ask a question, the system searches across all your transcriptions, understands the context and meaning behind your query, and provides a coherent answer with citations back to the source recordings.
+
+This semantic search capability goes far beyond simple keyword matching. The system understands concepts, relationships, and context. If you ask about "budget concerns," it will find discussions about financial constraints, cost overruns, funding issues, and resource limitations - even if the exact phrase "budget concerns" was never spoken.
+
+## Getting Started with Inquire Mode
+
+Access Inquire Mode by clicking the Inquire button in the top navigation bar. The interface opens with a clean search area at the top and powerful filtering options on the left side. Your search results appear in the main content area, organized and formatted for easy reading.
+
+The beauty of Inquire Mode is its simplicity. You don't need to learn special search syntax or commands. Just type your question as you would ask a colleague, and the system handles the complexity of finding and synthesizing the relevant information.
+
+## Using Filters to Focus Your Search
+
+The left sidebar contains filters that help you narrow your search to specific recordings before asking your question. This is particularly useful when you have a large library and want to focus on certain contexts.
+
+The tag filter lets you select recordings with specific tags, which is perfect when you want to search within a particular project, client, or type of meeting. If you've tagged your recordings consistently, this becomes a powerful way to segment your searches. The system shows how many recordings match each tag, helping you understand the scope of your search.
+
+Speaker filtering allows you to focus on what specific people have said across recordings. This is invaluable when you need to track commitments from a particular person, understand someone's perspective on various topics, or prepare for a meeting with specific individuals.
+
+Date range filtering helps you focus on recent discussions or search within a specific time period. This is particularly useful for tracking how discussions have evolved over time or finding information from a specific quarter or project phase.
+
+## Asking Effective Questions
+
+![Inquire Mode Example Results](../assets/images/screenshots/inquire-dark-mode.png)
+
+The key to getting great results from Inquire Mode is asking clear, specific questions. The system works best when you provide context and be specific about what you're looking for.
+
+Instead of searching for single words like "deadline," ask complete questions like "What are the upcoming deadlines for the mobile app project?" This helps the AI understand not just what information you want, but why you want it and how to present it most usefully.
+
+The system excels at different types of queries. You can ask for summaries of specific topics across multiple meetings, request lists of action items or decisions, search for specific statements or commitments, analyze patterns or trends in discussions, or identify problems and proposed solutions.
+
+## Understanding Your Results
+
+![Contextual Search Results](../assets/images/screenshots/Inquire mode.png)
+
+When Inquire Mode returns results, it provides a synthesized answer that draws from all relevant recordings. The response isn't just a list of search hits - it's a coherent narrative that combines information from multiple sources into a unified answer.
+
+Each piece of information includes a citation in the format (Recording ID: XX) that links directly to the source recording. Clicking these links takes you to the full recording where you can see the complete context. This transparency ensures you can always verify the information and dive deeper when needed.
+
+The system intelligently organizes information, grouping related points together and presenting them in a logical flow. If multiple recordings discuss the same topic, the answer will synthesize these discussions, showing how the conversation evolved over time while maintaining clear attribution to each source.
+
+## Practical Applications
+
+Inquire Mode shines in numerous real-world scenarios. When preparing for meetings, you can quickly review what was previously discussed about agenda topics, what questions remained unresolved, and what commitments were made. This ensures you walk into meetings fully informed without spending hours reviewing old recordings.
+
+For project management, the system helps track decisions across multiple meetings, identify all action items assigned to group members, and monitor how project requirements or priorities have changed over time. You can ask questions like "What risks have been identified for the product launch?" and receive a comprehensive list drawn from all relevant discussions.
+
+Research and analysis become dramatically more efficient. Whether you're analyzing customer feedback patterns, tracking competitor mentions, or identifying recurring themes across interviews, Inquire Mode can surface insights that might otherwise remain buried in hours of recordings.
+
+The system also serves as an excellent compliance and documentation tool. You can quickly find specific commitments made to clients, locate discussions about regulatory requirements, or verify what was agreed upon in negotiations. The citation system provides an audit trail back to the original recordings.
+
+## Advanced Search Strategies
+
+As you become more comfortable with Inquire Mode, you can develop sophisticated search strategies. Start with broader questions to understand the landscape of available information, then drill down with increasingly specific queries. This iterative approach helps you discover information you might not have known to ask about directly.
+
+Combine filters strategically. For instance, when preparing for a client meeting, filter by that client's tag and the relevant date range, then ask about outstanding issues or commitments. This focused approach yields highly relevant results without noise from unrelated recordings.
+
+Pay attention to how the system interprets your questions. If results aren't quite what you expected, try rephrasing with different terms or adding more context. The system learns from the patterns in your recordings, so using terminology consistent with your actual discussions often yields better results.
+
+## Technical Considerations
+
+Inquire Mode's power comes from its semantic understanding capabilities. When embeddings are enabled (with sentence-transformers installed), the system creates mathematical representations of meaning that allow it to understand concepts beyond simple keyword matching. This means it can find relevant information even when different words are used to express the same ideas.
+
+Speakr defaults to the all-MiniLM-L6-v2 embedding model, a deliberately lightweight choice that balances performance with resource efficiency. This model generates 384-dimensional vectors and runs comfortably on CPU-only systems, which is crucial since most Speakr deployments are on standard servers or personal machines without dedicated GPUs. The default provides solid semantic understanding for conversational content while remaining responsive even when processing hundreds of recordings. Administrators who want a different trade-off can override the model via the `EMBEDDING_MODEL` environment variable, or offload embedding generation entirely to an OpenAI-compatible API provider (vLLM, OpenRouter, OpenAI, and similar) by setting `EMBEDDING_BASE_URL`. See [Model Configuration](../admin-guide/model-configuration.md#configurable-embedding-model) for details.
+
+The system processes recordings in chunks, allowing it to search through even very long recordings efficiently. Each chunk is analyzed independently but results are synthesized to maintain context and continuity. This approach ensures both speed and accuracy, even with large recording libraries.
+
+Performance scales well with proper setup. The initial indexing of recordings happens automatically after transcription, and subsequent searches leverage this pre-computed index. Response times typically range from a few seconds for focused searches to slightly longer for complex queries across large libraries.
+
+## Making the Most of Inquire Mode
+
+To maximize the value of Inquire Mode, maintain good recording hygiene. Ensure your recordings have clear audio quality for accurate transcription, use speaker identification to track who said what, and apply consistent tags to organize your content. The better your input data, the more powerful your searches become.
+
+Take advantage of the iterative nature of search. Start with a general question, review the results, then ask follow-up questions to drill deeper. The system maintains context within a session, making it easy to refine your search based on initial results.
+
+Remember that Inquire Mode complements, not replaces, the standard recording interface. Use Inquire Mode for discovery and synthesis across recordings, but when you need deep focus on a single recording, the standard transcription view with its chat interface might be more appropriate.
+
+## Limitations to Keep in Mind
+
+While powerful, Inquire Mode has boundaries. It searches only transcribed text, not audio directly, so any errors in transcription will affect search results. The system cannot infer information that isn't explicitly stated in recordings - it finds and synthesizes what was said, not what was meant but left unsaid.
+
+Language support depends on the configured embedding model. The default all-MiniLM-L6-v2 was trained primarily on English, so non-English content works with varying results; switching to a multilingual model (e.g., `paraphrase-multilingual-MiniLM-L12-v2`) or a large API model such as `openai/text-embedding-3-large` significantly improves cross-lingual quality. Very long recordings might be summarized rather than fully indexed if they exceed processing limits. The system requires recordings to be fully processed before they are searchable, so very recent recordings may not appear immediately in results.
+
+---
+
+Next: [Sharing Recordings](sharing.md) →
\ No newline at end of file
diff --git a/docs/user-guide/pwa.md b/docs/user-guide/pwa.md
new file mode 100644
index 00000000..c622495d
--- /dev/null
+++ b/docs/user-guide/pwa.md
@@ -0,0 +1,343 @@
+# Progressive Web App (PWA)
+
+Speakr is a Progressive Web App that can be installed on your device for a more native-app like experience and wake lock support to prevent screen sleep during recording.
+
+## What is a PWA?
+
+A Progressive Web App combines the best of web and mobile apps:
+
+- **Installable** - Add to your home screen like a native app
+- **Fast loading** - Cached assets load instantly
+- **Wake lock** - Prevents screen from auto-sleeping during recording
+- **No app store** - Install directly from your browser
+- **Auto-updates** - Always get the latest version automatically
+
+## Installing Speakr as a PWA
+
+### On Android (Chrome/Edge)
+
+1. **Open Speakr** in Chrome or Edge browser
+2. Look for the **"Add to Home Screen"** prompt at the bottom of the screen
+3. Tap **"Add"** or **"Install"**
+4. Alternatively:
+    - Tap the three-dot menu (⋮) in the browser
+    - Select **"Add to Home screen"** or **"Install app"**
+    - Follow the prompts
+
+5. **Launch** the app from your home screen
+
+!!! tip "Banner Prompt"
+    If you don't see the install prompt, you may need to visit Speakr a few times first. The browser will offer installation after detecting regular usage.
+
+### On iOS (Safari)
+
+1. **Open Speakr** in Safari
+2. Tap the **Share** button (□↑) at the bottom of the screen
+3. Scroll down and tap **"Add to Home Screen"**
+4. Edit the name if desired and tap **"Add"**
+5. **Launch** the app from your home screen
+
+!!! note "iOS Limitations"
+    iOS has some restrictions on PWAs:
+    - Wake Lock API requires iOS 16.4+ (Safari 16.4+)
+    - Background execution is more limited than Android
+    - Some features work better on iOS 17+
+
+### On Desktop (Chrome/Edge/Brave)
+
+1. **Open Speakr** in your browser
+2. Look for the **install icon** (⊕) in the address bar
+3. Click it and select **"Install"**
+4. Alternatively:
+    - Click the three-dot menu
+    - Select **"Install Speakr"** or **"Add to applications"**
+
+5. **Launch** from your applications menu or desktop shortcut
+
+## PWA Features
+
+### Offline Support
+
+Once installed, Speakr caches essential files for offline use:
+
+- Application interface and UI
+- CSS stylesheets and fonts
+- JavaScript application code
+- Icons and images
+
+Note: API calls and file uploads require internet connection.
+
+!!! info "Offline Capabilities"
+    While you can access the app offline, transcription and AI features require an internet connection to your configured API endpoints.
+
+### Mobile Recording Features
+
+#### Wake Lock API
+Prevents your device screen from auto-sleeping while app is visible:
+
+- **Automatic activation** - Enabled when you start recording
+- **Keeps screen on** - Prevents screen from turning off while app is in foreground
+- **Auto-recovery** - Re-acquires if released during recording
+- **Battery consideration** - Only active during recording sessions
+
+#### Persistent Notifications
+Shows recording status in your notification tray (mobile only):
+
+- **Status indicator** - Visual reminder that recording is active
+- **One-tap return** - Tap notification to return to the app
+- **Silent** - No sound or vibration
+
+#### Page Visibility Detection
+Monitors when the app goes to background:
+
+- **Detects minimization** - Knows when app is backgrounded
+- **Smart recovery** - Re-activates wake lock when returning to app
+- **State awareness** - Tracks recording state across visibility changes
+
+### How Background Recording Works
+
+!!! danger "Critical Limitation: Keep App Visible on Mobile"
+    **Mobile browsers (Chrome, Safari, etc.) suspend audio recording when the app is minimized or the screen is locked.** This is a fundamental browser limitation that cannot be overcome with PWA features.
+
+    **What this means:**
+    - Recording **will pause** if you minimize the window
+    - Recording **will pause** if you lock your screen
+    - Recording **will pause** if you switch to another app
+    - Recording **continues** if you keep Speakr visible in foreground
+    - Wake lock **prevents screen from auto-sleeping** while Speakr is visible
+
+    **For long meetings on mobile**, you have two options:
+    1. **Keep Speakr visible** - Don't minimize, lock screen, or switch apps
+    2. **Use native recorder** - Use your phone's built-in voice recorder app, then upload the file to Speakr afterward
+
+**Why this happens:**
+
+Mobile browsers intentionally suspend web pages in the background to save battery. This affects:
+
+- JavaScript execution (timers, code)
+- MediaRecorder API (audio capture)
+- Audio context (audio processing)
+
+Native apps don't have this limitation because they use platform-specific APIs that run outside the browser.
+
+**Desktop browsers work differently:**
+
+- Recording continues when window is minimized
+- Can switch to other apps
+- Only stops when browser is completely closed
+
+**Starting a recording on mobile (with limitations):**
+
+1. Start recording (microphone or system audio)
+2. Wake lock prevents screen from auto-sleeping
+3. Notification appears in notification tray
+4. **Keep Speakr visible** in the foreground
+5. Do not minimize, lock screen, or switch apps
+
+**If you accidentally minimize:**
+
+- Recording audio will pause (silence)
+- Timer continues counting
+- When you return to app, recording resumes
+- Silent gap will be in the final recording
+
+## Permissions
+
+### Required Permissions
+
+#### Microphone Access
+- **When**: Starting a microphone recording
+- **Why**: Capture audio from your device's microphone
+- **Scope**: Only active during recording
+
+#### System Audio Access (Desktop)
+- **When**: Recording system audio or both mic + system
+- **Why**: Capture audio from browser tabs, applications
+- **Scope**: Only active during recording
+
+### Recommended Permissions
+
+#### Notification Permission (Mobile)
+- **When**: First recording on mobile device
+- **Why**: Show visual reminder that recording is active
+- **Impact**: Provides quick access to return to app
+- **Scope**: Only shown during active recordings
+
+!!! tip "Granting Permissions"
+    If you accidentally deny a permission, you can reset it in your browser/device settings:
+
+    - **Android Chrome**: Settings → Site settings → Speakr URL → Permissions
+    - **iOS Safari**: Settings → Safari → Speakr URL → Permissions
+    - **Desktop**: Click the lock icon (🔒) in the address bar → Permissions
+
+## Service Worker
+
+Speakr uses a service worker to provide PWA capabilities:
+
+### What it Does
+
+- **Caches static assets** - For offline access and faster loading
+- **Manages updates** - Automatically updates cached content
+- **Handles notifications** - Manages persistent recording notifications
+- **Background sync** - Foundation for future features like upload retry
+
+### Viewing Service Worker Status
+
+**Chrome DevTools:**
+
+1. Press F12 to open DevTools
+2. Go to **Application** tab
+3. Select **Service Workers** in the sidebar
+4. See registration status and version
+
+**Console Logs:**
+
+The service worker logs its activity to the browser console:
+
+```
+[Service Worker] Installing...
+[Service Worker] Caching static assets
+[Service Worker] Activating...
+[Service Worker] Script loaded
+```
+
+### Updating Service Worker
+
+The service worker automatically updates:
+
+- **Check interval**: Every 60 seconds while app is open
+- **Update process**: Downloads new version in background
+- **Activation**: Takes effect on next page reload
+
+To force an update:
+
+1. Close all Speakr tabs/windows
+2. Reopen Speakr
+3. New service worker activates automatically
+
+## Browser Compatibility
+
+### Mobile Browsers
+
+| Feature | Chrome Android | Safari iOS | Samsung Internet |
+|---------|----------------|------------|------------------|
+| PWA Install | ✅ Android 5+ | ✅ iOS 11.3+ | ✅ 4.0+ |
+| Service Worker | ✅ Chrome 40+ | ✅ iOS 11.3+ | ✅ 4.0+ |
+| Wake Lock | ✅ Chrome 84+ | ✅ iOS 16.4+ | ✅ 13.0+ |
+| Notifications | ✅ Chrome 42+ | ✅ iOS 16.4+ | ✅ 4.0+ |
+| Page Visibility | ✅ All versions | ✅ All versions | ✅ All versions |
+
+### Desktop Browsers
+
+| Feature | Chrome | Edge | Brave | Firefox | Safari |
+|---------|--------|------|-------|---------|--------|
+| PWA Install | ✅ 73+ | ✅ 79+ | ✅ All | ⚠️ Limited | ⚠️ Limited |
+| Service Worker | ✅ 40+ | ✅ 17+ | ✅ All | ✅ 44+ | ✅ 11.1+ |
+| Wake Lock | ✅ 84+ | ✅ 84+ | ✅ All | ❌ | ✅ 16.4+ |
+
+!!! info "Firefox & Safari Desktop"
+    Firefox and Safari have limited PWA install support on desktop but all core features work in the browser.
+
+## Troubleshooting
+
+### Recording Stops When Screen Locks
+
+**This is expected behavior on mobile browsers.** Recording will pause when you minimize the app or lock the screen.
+
+**Solutions:**
+
+1. **Keep app visible** - Don't minimize or lock screen during recording
+2. **Wake lock prevents auto-sleep** - Screen won't turn off automatically while recording
+3. **Use native recorder** - For long meetings, use your phone's built-in voice recorder
+4. **Desktop works differently** - Recording continues when minimized on desktop browsers
+
+### PWA Not Offered for Installation
+
+**Solutions:**
+
+1. **Visit the app multiple times** - Browser may require several visits
+2. **Check HTTPS** - PWA requires secure connection (https://)
+3. **Try different browser** - Use Chrome/Edge for best support
+4. **Clear browser cache** - Force refresh of manifest
+
+### Service Worker Not Registering
+
+**Check console for errors:**
+
+```javascript
+// Open browser console (F12)
+// Look for service worker errors
+```
+
+**Solutions:**
+
+1. **Verify HTTPS** - Service workers require secure context
+2. **Check browser support** - Update to latest browser version
+3. **Clear site data** - Browser settings → Clear site data
+4. **Hard reload** - Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
+
+### Offline Features Not Working
+
+**Verify:**
+
+1. Service worker is registered (check DevTools → Application)
+2. Assets are cached (check DevTools → Application → Cache Storage)
+3. You've visited the site at least once while online
+
+**Solutions:**
+
+- Reload the page while online
+- Clear cache and reload
+- Uninstall and reinstall PWA
+
+## Best Practices
+
+### For Mobile Recording
+
+1. **Keep app visible** - Don't minimize, lock screen, or switch apps
+2. **Keep phone plugged in** for long recordings
+3. **Close unnecessary apps** to free memory
+4. **Avoid taking calls** during recording (will pause)
+5. **For long meetings** - Consider using native recorder app instead
+
+### For Optimal Performance
+
+1. **Install as PWA** for better performance
+2. **Keep browser updated** for latest features
+3. **Clear old recordings** to free space
+4. **Monitor storage** in device settings
+
+### Privacy Considerations
+
+1. **Microphone access** - Only granted during recording
+2. **Notifications** - Only shown during recording (mobile)
+3. **Cached data** - Stored locally on your device
+4. **Service worker** - Can be unregistered in browser settings
+
+## Uninstalling the PWA
+
+### Android
+
+1. Long-press the app icon on home screen
+2. Select **"App info"** or drag to **"Remove"**
+3. Tap **"Uninstall"**
+
+### iOS
+
+1. Long-press the app icon
+2. Select **"Remove App"**
+3. Confirm **"Delete App"**
+
+### Desktop
+
+1. Open installed app
+2. Click three-dot menu
+3. Select **"Uninstall Speakr"**
+
+Alternatively, remove from:
+
+- **Chrome**: `chrome://apps` → Right-click app → Remove
+- **Edge**: `edge://apps` → Click ⋮ on app → Uninstall
+---
+
+Have questions about PWA features? Check the [FAQ](../faq.md) or [Troubleshooting Guide](../troubleshooting.md).
diff --git a/docs/user-guide/recording.md b/docs/user-guide/recording.md
new file mode 100644
index 00000000..cc07cf82
--- /dev/null
+++ b/docs/user-guide/recording.md
@@ -0,0 +1,280 @@
+# Recording and Uploading Audio
+
+Speakr provides two powerful ways to add content to your library: uploading existing audio files for transcription or recording new audio directly in your browser. Both methods include the same powerful features for organization, [tagging](settings.md#tag-management-tab), and processing. After recording, you can [work with transcriptions](transcripts.md) and use [AI features](../features.md#ai-powered-intelligence).
+
+## Important: Browser Requirements for Recording
+
+Before you start recording, it's crucial to understand that browser security features can affect your ability to record audio, especially system audio. For security reasons, most browsers require HTTPS connections for audio recording features. If you're accessing Speakr locally (not via localhost), you may need to configure your browser to allow audio recording on HTTP connections. Detailed browser configuration instructions are provided at the bottom of this page.
+
+When recording system audio, you'll need to grant screen sharing permissions and specifically enable the "Also share system audio" option. Without this, only your microphone will be recorded. Different browsers may phrase this option differently, but it's essential for capturing computer audio.
+
+## Accessing the New Recording Screen
+
+Click the "+ New Recording" button in the top navigation bar to access the recording interface. This opens a dedicated screen where you can either upload files or start a live recording.
+
+![New Recording View](../assets/images/screenshots/Recording interface.png)
+
+## Uploading Audio Files
+
+The upload interface provides a simple drag-and-drop area at the top of the screen. You can either drag audio files directly from your file manager onto this area, or click the area to open a file browser and select files.
+
+Speakr supports a [wide range of audio and video formats](../faq.md#what-audio-formats-does-speakr-support). Common audio formats like MP3, WAV, M4A, FLAC, AAC, and OGG work perfectly. You can also upload video files including MP4, MOV, and AVI, and Speakr will extract and process the audio track. Mobile recordings in formats like AMR, 3GP, and 3GPP are also supported. The default file size limit is 500MB, though this can be configured by your administrator in [system settings](../admin-guide/system-settings.md#maximum-file-size). For files over 25MB with OpenAI, see [chunking configuration](../troubleshooting.md#files-over-25mb-fail-with-openai).
+
+!!! info "Automatic Audio Compression"
+    Speakr automatically compresses lossless uploads (WAV, AIFF) to save storage space. A 500MB WAV file typically becomes ~50MB after compression. This happens transparently on upload - you don't need to pre-convert your files. Already-compressed formats like MP3 are kept as-is. See [audio compression settings](../admin-guide/system-settings.md#audio-compression) for configuration options.
+
+When you upload a file, it immediately appears in the upload queue with a progress bar showing the upload status. Once uploaded, you can add [tags](settings.md#tag-management-tab), set a custom title, and configure processing options before starting transcription. Tags can include [custom AI prompts](../admin-guide/prompts.md) for specialized processing.
+
+## Recording Live Audio
+
+Below the upload area, you'll find the audio recording section with three distinct recording modes, each designed for different scenarios:
+
+![Recording Options](../assets/images/screenshots/recording-upload-modal.png)
+
+### Microphone Recording
+
+The red microphone button captures audio from your selected microphone. This mode is perfect for recording in-person meetings, personal voice notes, or interviews. When you click this option, your browser will request microphone permission if it hasn't been granted already. You can select which microphone to use if you have multiple input devices connected.
+
+### System Audio Recording
+
+The blue system audio button captures all sound playing through your computer. This is ideal for recording online meetings when you're primarily listening, webinars, online presentations, podcasts, or any audio content playing on your computer. This feature uses the browser's screen capture API, so you'll need to select which screen or application to share when you start recording. Make sure to check the "Share system audio" checkbox in the sharing dialog.
+
+### Combined Recording (Microphone + System)
+
+The purple combined button records both your microphone and system audio simultaneously into a single synchronized track. This is the recommended mode for online meetings where you're an active participant, as it captures both sides of the conversation. The system intelligently mixes both audio sources, ensuring clear recording of both your voice and the meeting audio.
+
+## How to Enable System Audio Recording
+
+When you click to record system audio (or both microphone and system), your browser will display a screen sharing dialog. This might seem confusing at first since you want to record audio, not share your screen, but this is how browsers provide access to system audio.
+
+### Recording from a Browser Tab
+
+Choose the tab option if the audio you want to record is playing within a specific browser tab, such as audio/video content on YouTube, web-based meeting platforms (like Google Meet or browser-based Zoom), or online training sessions.
+
+![Tab Selection with Audio](../assets/images/screenshots/record from tab.png)
+
+When selecting a tab, you'll see a preview of all your open tabs. Choose the tab containing your audio source, then make sure to enable the **"Also share tab audio"** checkbox at the bottom of the dialog. This checkbox is critical - without it enabled, you'll only record silence. The exact wording may vary by browser (Chrome might say "Share tab audio" while Edge might phrase it slightly differently), but there will always be an audio-related checkbox that must be checked.
+
+This option will only capture audio from that specific tab, so make sure all the audio you're interested in is within that single tab before starting your recording.
+
+### Recording from Your Entire Screen
+
+Choose the screen option if the audio you want to record is coming from desktop applications or multiple sources.
+
+![Screen Selection Dialog](../assets/images/screenshots/record from screen.png)
+
+This is the recommended option when recording:
+
+- Desktop applications like Zoom client, Microsoft Groups, Skype, or Discord
+- Audio from multiple browser tabs simultaneously
+- System sounds or notifications you want to capture
+- Any combination of audio sources on your computer
+
+When you select "Your Entire Screen", you'll see previews of all your available screens (if you have multiple monitors). It doesn't matter which screen you choose since Speakr only records audio, not video. The critical step is to enable the **"Also share system audio"** checkbox at the bottom of the dialog. Without this checkbox enabled, you'll only record silence.
+
+**Important macOS Limitation:** The "Also share system audio" option is available on Windows and Linux, but may not be available on macOS due to operating system limitations. macOS users may only be able to record audio from browser tabs, not from the entire system or desktop applications. This is a limitation imposed by macOS's security model, not by Speakr or your browser.
+
+## During Recording - Live Interface
+
+Once you start recording, the interface transforms to show the active recording session:
+
+![Live Recording Interface](../assets/images/screenshots/recording-dual-source.png)
+
+### Real-Time Audio Monitoring
+
+The recording interface displays live audio visualizers for each active input source. When recording from your microphone, you'll see a real-time waveform showing your voice levels. For system audio recording, a separate visualizer displays the computer audio levels. These visualizers help you confirm that audio is being captured properly and at appropriate levels.
+
+A prominent timer at the top shows the elapsed recording time in minutes and seconds, updating in real-time. Below the timer, you'll see an estimate of the file size based on the current recording duration and quality settings. This helps you stay aware of how much storage space your recording will require.
+
+### Live Note-Taking with Markdown
+
+One of Speakr's most powerful features is the ability to take structured notes while recording. The note-taking area appears below the audio visualizers and supports full markdown formatting.
+
+![Note Taking During Recording](../assets/images/screenshots/recording-single-source.png)
+
+The markdown editor includes a formatting toolbar with buttons for common formatting options like bold, italic, headers, quotes, lists, and links. You can also type markdown syntax directly if you prefer. The editor supports all standard markdown elements, allowing you to create well-structured notes that complement your recording.
+
+Your notes are saved automatically and will be associated with the recording. They appear in the Notes tab when viewing the recording later and are fully searchable alongside the transcription. This makes it easy to capture important context, decisions, or action items that might not be explicitly stated in the audio.
+
+Common use cases for live notes include capturing action items and deadlines during meetings, noting important timestamps for later reference, recording participant names and roles, documenting decisions and their rationale, and adding context that might not be clear from the audio alone.
+
+## Finalizing Your Recording
+
+After stopping a recording or selecting an uploaded file, you'll see the finalization screen where you can add metadata and configure processing options:
+
+![Upload Modal](../assets/images/screenshots/recording-upload-modal.png)
+
+### Adding Tags
+
+The tag system is one of Speakr's most powerful organizational features. Tags appear as colored pills that you can select to categorize your recording. You can apply multiple tags to a single recording, making it easy to cross-reference content across different categories.
+
+![Tag Selection and Stacking](../assets/images/screenshots/tag selection and stacking.png)
+
+It's important to select relevant tags before uploading your file so that the appropriate summary prompts are applied during summarization. Each tag can have custom AI prompts associated with it, which influence how the summary is generated. For example, a "Meeting" tag might focus the summary on action items and decisions, while a "Lecture" tag might emphasize key concepts and learning points.
+
+**Intelligent Prompt Stacking:** When you select multiple tags, their associated prompts are concatenated in the order you select them, allowing for intelligent stacking of instructions. This powerful feature lets you combine general and specific prompts. For instance, you might have a standard "Meetings" tag with general meeting instructions, then add a project, client, or situation specific tag that adds additional context and instructions for the summarization. The AI will apply both sets of instructions by concatenating general meeting requirements with the specific modifications. This allows you to create sophisticated summarization rules without having to create a separate tag for every possible combination. To create and manage tags with custom prompts, see [Tag Management in Account Settings](settings.md#tag-management-tab).
+
+As shown in the interface, if you add tags that include summarization instructions, you will get an indication of this in the UI. The order matters - select your primary tag first, then add modifying tags to layer additional instructions. Tags are also searchable and filterable in the main view, making it easy to find related recordings later.
+
+### Advanced ASR Options
+
+If your administrator has configured ASR endpoints with speaker diarization, you'll see an expandable "Advanced ASR Options" section. Here you can specify the transcription language if your content is not in English, set the minimum and maximum number of expected speakers for better diarization accuracy, and configure other ASR-specific settings based on your setup.
+
+These settings are particularly useful for meetings with known participants, as setting accurate speaker counts improves the AI's ability to separate different voices in the transcription.
+
+#### Custom Vocabulary (Hotwords)
+
+The **Hotwords** field lets you provide a comma-separated list of words or phrases that the transcription engine should prioritize. This is especially useful for domain-specific terminology, brand names, acronyms, or proper nouns that the model might otherwise misspell or miss entirely. For example, entering `Speakr, CTranslate2, PyAnnote` helps the engine correctly recognize these terms in your audio.
+
+#### Initial Prompt
+
+The **Initial Prompt** field provides context to the transcription engine about what the recording contains. Think of it as a brief description that steers the model's expectations. For example: "This is a meeting about AI-powered audio transcription tools." This helps the model make better word choices when the audio is ambiguous.
+
+Both fields follow a precedence hierarchy: values you set in the upload form override tag defaults, which override folder defaults, which override your personal defaults in [account settings](settings.md#custom-prompts-tab). If you regularly transcribe similar content, set your defaults at the tag or user level so you don't have to enter them every time.
+
+#### Transcription Model
+
+When your administrator has configured `TRANSCRIPTION_MODELS_AVAILABLE` (or curated a model list from the admin dashboard), the upload form gains a **Transcription model** dropdown that lets you pick the specific model used for this recording. The default option uses whichever model the resolved tag, folder, or admin default specifies. The dropdown is hidden if only one option would be available, since there is no real choice to offer.
+
+Like hotwords and initial prompt, the resolved model follows the precedence chain: per-upload selection beats tag default beats folder default beats the admin default. This is useful when you want to use a higher-quality model for an important recording without changing your defaults, or to fall back to a faster model for a quick transcript.
+
+#### Prompt Variables
+
+If a selected tag, folder, or your account default summary prompt contains `{{name}}` placeholders (for example `{{agenda}}` or `{{location}}`), the upload form shows a **Prompt variables** panel under the tag picker with one input per placeholder. Values entered here are stored on the recording and substituted into the summary prompt at summarisation time. See the [Prompt Variables guide](settings.md#prompt-variables) for the full feature.
+
+### Final Actions
+
+At the bottom of the modal, you have three options for proceeding. The "Upload" or "Start Processing" button begins transcription immediately with your selected settings. The recording will appear in your library with a processing indicator while transcription runs in the background. The "Discard" option deletes the recording without saving, useful if you made a test recording or captured the wrong content. Some configurations may also offer a "Save Draft" option to store the recording without processing it immediately.
+
+## Crash Recovery (v0.6.2+)
+
+!!! success "Automatic Crash Recovery"
+    Speakr now automatically saves your in-progress recordings to browser storage every 5 seconds. If your browser crashes, tab closes accidentally, or your computer restarts unexpectedly during a recording, you won't lose your work.
+
+When you return to Speakr after a crash, you'll see a recovery modal offering to restore your interrupted recording:
+
+**What Gets Recovered:**
+
+- All recorded audio up to the point of interruption
+- Recording mode (microphone, system audio, or combined)
+- Any notes you had entered
+- Selected tags and settings
+- Exact timestamp when recording started
+
+**How Recovery Works:**
+
+1. When you return to Speakr after a crash, a modal automatically appears
+2. Review the recording details (duration, size, timestamp)
+3. Click "Restore Recording" to continue where you left off, or "Discard" to start fresh
+4. Recovered recordings appear in the finalization screen ready for processing
+
+**Limitations:**
+
+- Recovery data is stored in your browser's IndexedDB storage (per-browser, per-device)
+- Clearing browser data will delete recovery information
+- Recording chunks are saved every 5 seconds, so up to 5 seconds of audio may be lost
+
+This feature provides peace of mind for long recordings - you can now record multi-hour sessions without fear of losing everything if something goes wrong.
+
+## Best Practices for Quality Recordings
+
+### Mobile Recording Considerations
+
+!!! danger "Keep App Visible on Mobile Devices"
+    **Critical Limitation**: Mobile browsers (Chrome, Safari, etc.) will **pause audio recording** when you minimize the app or lock your screen. This is a fundamental browser limitation that cannot be overcome.
+
+    **To record successfully on mobile:**
+    - **Keep Speakr visible** in the foreground at all times
+    - **Don't minimize** the window or switch to other apps
+    - **Don't lock** your screen during recording
+    - Wake Lock will **prevent screen from auto-sleeping** while app is visible
+
+    **For long meetings on mobile:**
+    1. **Option 1**: Keep Speakr open and visible (wake lock prevents screen sleep)
+    2. **Option 2**: Use your phone's native voice recorder app, then upload the file to Speakr when done
+
+    **Desktop browsers don't have this limitation** - recording continues even when minimized.
+
+**Installing as a PWA** - For the best mobile experience, install Speakr as a Progressive Web App. This provides:
+
+- Wake Lock API to prevent screen from auto-sleeping while recording
+- Faster load times with offline caching
+- Native app-like experience
+- Persistent notification during recording
+
+See the [PWA Guide](pwa.md) for installation instructions and important limitations.
+
+### Optimizing Audio Quality
+
+The quality of your transcription starts with the quality of your recording. When using a microphone, find a quiet space with minimal echo and background noise. Soft furnishings and carpeted rooms generally provide better acoustics than empty rooms with hard surfaces. Position your microphone consistently, about 6-12 inches from your mouth, and speak at a steady volume.
+
+**Important Note for Phone Recordings:** Many smartphones have aggressive noise cancellation algorithms designed to enhance single-speaker calls. When recording meetings or conversations with multiple speakers using a phone's microphone, these noise cancellation features may incorrectly identify other speakers as background noise and filter them out. This can result in muffled or missing audio from speakers who are farther from the phone. This is not a limitation of Speakr but rather how modern phones process audio. For multi-speaker recordings, consider using an external microphone without noise cancellation or positioning the phone equidistant from all speakers.
+
+For system audio recording, close unnecessary applications that might produce notification sounds or background audio. If you're recording an online call or web meeting, ensure you have a stable internet connection to avoid audio dropouts. Using wired internet instead of WiFi can improve stability for important recordings.
+
+When recording both microphone and system audio, use headphones to prevent echo and feedback. This ensures that the system audio doesn't get picked up by your microphone, which would create a confusing double recording.
+
+### Effective Organization from the Start
+
+Develop a consistent approach to naming and tagging your recordings. Include key information in titles such as the meeting type, main topic, or project name. If the original meeting date is different from the upload date, make sure you update the meeting date on upload, making chronological sorting easier.
+
+Apply tags before or immediately after recording while the context is fresh in your mind. Consider creating a standard set of tags for different types of content like meetings, lectures, interviews, or personal notes. If your organization uses specific project codes or client names, incorporate these into your tagging system.
+
+Take advantage of the live note-taking feature to capture information that might not be clear from audio alone. Note participant names at the beginning of meetings, mark important timestamps when key decisions are made, and document any visual information that was shared but won't be captured in the audio.
+
+
+## Browser Configuration for Local Deployments
+
+### System Audio Recording Requirements
+
+System audio recording requires specific browser support and configuration. The feature works best in Chrome and other Chromium-based browsers like Edge or Brave. Firefox has limited support, and Safari currently doesn't support system audio recording at all.
+
+For production deployments using HTTPS, audio recording works without additional configuration. However, if you're accessing Speakr over HTTP (except for localhost), you'll need to configure your browser to allow audio recording on insecure connections.
+
+### Chrome Configuration for HTTP Access
+
+If you're accessing Speakr over HTTP (not localhost), Chrome will block audio recording by default. To enable it:
+
+1. Open Chrome and navigate to `chrome://flags`
+2. Search for "Insecure origins treated as secure"
+3. In the text field, enter your Speakr URL (e.g., `http://192.168.1.100:8899`)
+4. Set the dropdown to "Enabled"
+5. Click "Relaunch" to restart Chrome with the new settings
+
+This configuration tells Chrome to treat your specific HTTP URL as if it were secure, enabling all audio recording features.
+
+### Firefox Configuration for HTTP Access
+
+Firefox requires a different approach to enable microphone access on HTTP sites:
+
+1. Open Firefox and navigate to `about:config`
+2. Click "Accept the Risk and Continue" when warned
+3. Search for `media.devices.insecure.enabled`
+4. Double-click the setting to change it from `false` to `true`
+5. Restart Firefox for the change to take effect
+
+Note that even with this setting, Firefox's system audio capture may not work reliably. For system audio recording, Chrome is strongly recommended.
+
+### Security Considerations
+
+These browser configurations reduce security and should only be used for local development or trusted internal networks. For production deployments, always use HTTPS with proper SSL certificates. This ensures all browser features work correctly and maintains security for your users.
+
+### Common Issues and Solutions
+
+If your microphone isn't detected, first check that your browser has permission to access it. Click the padlock or information icon in the address bar and ensure microphone access is allowed. Verify your microphone is properly connected and selected as the default input device in your system settings. If problems persist, try using a different browser or restarting your current browser.
+
+When system audio recording isn't working, the most common issue is forgetting to check the "Also share system audio" checkbox when selecting what to share. This checkbox appears at the bottom of the screen/tab selection dialog and must be enabled. Make sure you're selecting either the entire screen or a browser tab, not an individual application window, as application audio sharing is often not supported.
+
+If you're on a locally hosted instance and can't record audio, check whether you're accessing Speakr via HTTP. Browsers block audio recording on insecure connections for security reasons. Either set up HTTPS with a reverse proxy or configure your browser using the instructions above to allow audio recording on your specific HTTP URL.
+
+If a recording stops unexpectedly, check your available disk space as browsers have limits on local storage. Ensure your internet connection is stable, especially if you have auto-save features enabled. Check the browser's developer console (F12) for any error messages that might indicate the problem.
+
+For poor audio quality issues, start by checking your microphone placement and gain settings. External USB microphones often provide better quality than built-in laptop microphones. Reduce background noise by closing windows, turning off fans, and muting other devices. If recording system audio, ensure the source audio quality is good, as Speakr can't improve poor source audio.
+
+## Moving Forward
+
+Now that you understand how to create and upload recordings, you're ready to explore how to work with transcriptions and leverage Speakr's AI-powered features for summarization and chat.
+
+---
+
+Next: [Working with Transcriptions](transcripts.md) →
\ No newline at end of file
diff --git a/docs/user-guide/settings.md b/docs/user-guide/settings.md
new file mode 100644
index 00000000..c98f8a8d
--- /dev/null
+++ b/docs/user-guide/settings.md
@@ -0,0 +1,348 @@
+# Account Settings
+
+Your account settings are the control center for personalizing Speakr to work exactly how you need it. Every preference you set here shapes your daily experience, from the language you see to how AI summarizes your recordings. Access these settings by clicking your username in the top navigation and selecting Account.
+
+## Account Information Tab
+
+![Account Information](../assets/images/screenshots/settings account info.png)
+
+The Account Information tab presents a comprehensive view of your profile, statistics, and account actions.
+
+### Personal Information
+
+On the left side, you'll find fields to update your full name, job title, and company or organization. These details help identify you in collaborative environments and provide context for your recordings. Keeping these current ensures colleagues can recognize your contributions and administrators can manage users effectively.
+
+Language preferences (interface language, default transcription language, and preferred output language) live on the **Preferences** tab. See the [Preferences Tab](#preferences-tab) section below.
+
+### Account Statistics
+
+The right side displays your recording metrics at a glance. You'll see your total recordings count and how many have been completed processing. Below that, the number of recordings currently processing and any that have failed provide immediate insight into your content status.
+
+### User Details
+
+Your username and email address appear here as read-only fields. The email serves as your login credential and cannot be changed without administrator assistance.
+
+### Processing Preferences
+
+Control how your recordings are automatically processed:
+
+#### Auto-Summarization
+
+The **Auto-Summarization** toggle controls whether summaries are automatically generated after transcription completes. When enabled (the default), every recording receives an AI-generated summary using your custom prompt or the system default. Disable this if you prefer to manually trigger summarization or if you only need transcripts.
+
+#### Auto Speaker Labeling
+
+When you have speaker voice profiles with embeddings (from WhisperX ASR), the **Auto Speaker Labeling** feature can automatically identify and label speakers in new recordings.
+
+- **Enable/Disable** - Toggle automatic speaker identification
+- **Confidence Threshold** - Choose how strict the matching should be:
+  - **Low** - More matches, but may have false positives
+  - **Medium** - Balanced accuracy (recommended)
+  - **High** - Fewer matches, but higher confidence
+
+Auto speaker labeling works by comparing voice embeddings from the new recording against your saved speaker profiles. When a match exceeds your confidence threshold, the speaker is automatically labeled with the known name.
+
+!!! tip "Building Voice Profiles"
+    Auto speaker labeling requires voice profiles with embeddings. These are created when you identify speakers in recordings processed with WhisperX ASR (with `ASR_RETURN_SPEAKER_EMBEDDINGS=true`). The more recordings you identify a speaker in, the better the matching becomes.
+
+### Account Actions
+
+The account actions section provides quick access to essential functions. The prominent "Go to Recordings" button takes you directly to your recording library. The "Change Password" button opens a secure dialog for updating your credentials. The "Manage Speakers" link provides a shortcut to speaker profile management, though this functionality is also accessible via its dedicated tab.
+
+## Custom Prompts Tab
+
+![Custom Prompts](../assets/images/screenshots/settings custom prompts.png)
+
+The Custom Prompts tab unlocks one of Speakr's most powerful features - the ability to shape how AI interprets and summarizes your recordings.
+
+### Your Custom Summary Prompt
+
+The large text area accepts detailed instructions in natural language that become the AI's instruction set. Think of it as teaching an assistant exactly how you want meeting notes prepared. You might request specific sections like "Key Technical Decisions" for engineering meetings or "Patient Observations" for medical consultations.
+
+### Current Default Prompt
+
+Below your custom prompt area, you'll see the default prompt that applies when you leave yours blank. This transparency shows exactly what baseline instructions the AI follows - typically requesting key issues, decisions, and action items. Use this as a foundation to build upon or completely replace with your own approach.
+
+### Prompt Hierarchy
+
+Understanding prompt precedence helps you use this feature effectively. Tag prompts have the highest priority - when you tag a recording with "Legal" or "Sales," any prompts associated with those tags override everything else. Your personal custom prompt comes next, applying to all recordings without tag-specific prompts. Below that sits the admin default set by your Speakr administrator, with a system fallback ensuring summaries always generate.
+
+### Prompt Stacking
+
+Multiple tag prompts combine intelligently when applied together. A recording tagged with both "Client" and "Technical" receives both sets of instructions, creating comprehensive summaries without needing complex single prompts trying to cover every scenario.
+
+### Transcription Hints
+
+Below the summary prompt, you'll find the **Transcription Hints** section with two fields that help improve transcription accuracy:
+
+- **Default Hotwords** - A comma-separated list of words or phrases the transcription engine should prioritize, such as brand names, acronyms, or specialized terminology (e.g., `Speakr, CTranslate2, PyAnnote`).
+- **Default Initial Prompt** - A brief description of the typical content of your recordings that provides context to the transcription engine (e.g., "This is a meeting about software development and AI tools.").
+
+These defaults apply to all your recordings unless overridden by tag defaults, folder defaults, or values you set in the upload form's Advanced ASR Options. This is the lowest priority level in the precedence hierarchy, making it a good place to set general-purpose hints that apply across most of your content.
+
+!!! tip "When to use hotwords vs initial prompt"
+    Use **hotwords** for specific terms the model tends to misspell - proper nouns, brand names, technical acronyms. Use **initial prompt** for broader context that helps the model understand the domain and make better overall word choices.
+
+### Writing Effective Prompts
+
+Craft prompts based on how you actually use summaries. Do you extract action items for project management? Look for decisions that affect strategy? Track technical details for documentation? Your prompt should request exactly what you need for these next steps.
+
+### Tips for Better Prompts
+
+The expandable tips section provides guidance on crafting better instructions. Focus on clarity, structure your requests with sections or bullet points, and be specific about the level of detail you need. Remember that your prompt applies to all recordings without tag-specific prompts, so design for versatility.
+
+## Preferences Tab
+
+The Preferences tab is the home for display and editor behaviour settings that should follow you across devices.
+
+### Language Preferences
+
+Three language settings shape your Speakr experience. The interface language dropdown immediately transforms all menus, buttons, and messages to your chosen language; the transcription language field sets a default ISO 639-1 code that the recognition service uses to optimise accuracy when auto-detect is too slow or ambiguous; and the preferred output language controls the language of titles, summaries, and chat responses regardless of the source audio's language. Leaving the transcription language on **Auto-detect** is the right default for multilingual content.
+
+These settings used to live on the Account Information tab. They moved here so all preferences that affect your day-to-day Speakr experience live in one place.
+
+### Transcript Display
+
+**Show timestamps in simple view.** When enabled, a compact `mm:ss` (or `h:mm:ss` for long recordings) timestamp appears next to each speaker label in the simple transcript view, making it easier to navigate long meetings. The bubble view is unaffected. Off by default to keep the existing aesthetic for users who prefer a clean read.
+
+### Transcript Editor
+
+**Auto-save edits in the transcript editor.** When enabled, edits made in the transcript editor are saved automatically a couple of seconds after you stop typing, with a small `Saved` indicator to confirm. When disabled (the default), saves are explicit via the Save buttons or the `Ctrl+S` keyboard shortcut. Auto-save is useful for long editing sessions where the risk of losing work outweighs the predictability of explicit writes.
+
+## Shared Transcripts Tab
+
+![Shared Transcripts](../assets/images/screenshots/settings shared transcripts.png)
+
+The Shared Transcripts tab provides complete visibility and control over every recording you've shared.
+
+### Initial State
+
+When first accessing this tab, you'll see "You have not shared any transcripts yet" - this changes once you create your first share link from any recording.
+
+### Share Information Display
+
+Once you've shared recordings, each entry displays the recording title, when you created the share link, what information you included (summary and/or notes), and the complete URL for access. The interface matches what you see in the sharing modal, maintaining consistency across the application.
+
+### Managing Share Settings
+
+The Share Summary checkbox determines whether recipients see your AI-generated summary - useful for giving quick overviews without requiring full transcript reading. The Share Notes checkbox controls access to your personal notes, those additional thoughts and context you've added after the recording.
+
+You can modify these settings anytime without generating new links. Toggle summary or notes on or off, and the change applies immediately to anyone accessing that link. This flexibility lets you adjust sharing based on evolving needs or feedback from recipients.
+
+### Revoking Access
+
+The delete button (trash icon) immediately revokes access. Once deleted, anyone trying to access that link sees an error message. This instant revocation provides security when you've accidentally shared with wrong parties or when access is no longer appropriate. Remember that deletion can't retrieve information already viewed or downloaded by recipients.
+
+## Speakers Management Tab
+
+![Speakers Management with Voice Profiles](../assets/images/screenshots/speakers-management-voice-profiles.png)
+*Speakers Management with voice profile statistics, confidence scores, and voice sample playback*
+
+The Speakers Management tab provides a comprehensive interface for managing all speakers identified across your recordings, including advanced voice profile capabilities.
+
+### Automatic Speaker Creation
+
+Speakers are automatically saved when you identify them during transcription editing. The system builds your library over time as you consistently name participants across recordings. When speaker diarization is enabled, Speakr automatically collects voice embeddings to build recognition profiles.
+
+### Speaker Card Information
+
+Each speaker card displays essential information in a clean, scannable format. The speaker's name appears prominently, followed by usage statistics showing how many times they've been identified across your recordings. The last used date helps you understand which speakers are current versus historical. When a speaker was added to your library is tracked for reference.
+
+#### Voice Profile Information
+
+For speakers with voice recognition data, each card displays additional information:
+
+- **Voice Profile Badge**: Shows confidence level (high/medium/low) based on the number and quality of voice samples collected
+- **Sample Count**: Number of voice embeddings collected from different recordings, helping assess profile strength
+- **Voice Samples Button**: Click to hear representative audio clips of this speaker's voice for verification
+- **Profile Strength Indicator**: Visual feedback showing how well the system can recognize this speaker in future recordings
+
+The voice profile data improves speaker suggestion accuracy when identifying speakers in new recordings. When you open the speaker identification modal, Speakr analyzes voice patterns and suggests likely matches with confidence scores, making the identification process faster and more accurate over time.
+
+### Interface Layout
+
+The grid layout accommodates multiple speakers per row, making efficient use of screen space while maintaining readability. Each card includes action buttons - an edit icon for updating speaker details and a delete icon for removal. The red trash icon on each card provides individual deletion, while the "Delete All" button at the bottom enables bulk cleanup when needed.
+
+### Library Statistics
+
+At the bottom of the interface, a count shows your total saved speakers - "77 speakers saved" in the example. This helps you track the size of your speaker library and understand when maintenance might be needed.
+
+### Maintenance Best Practices
+
+Regular maintenance keeps your speaker library relevant. Remove speakers who no longer appear in recordings, consolidate duplicates created with slight name variations, and ensure names are consistent for better transcript coherence. Periodic reviews help keep your library manageable and useful.
+
+### Automatic Speaker Cleanup
+
+When recordings are deleted (either manually or through auto-deletion), Speakr automatically manages speaker voice profiles to protect your privacy:
+
+- **Speakers with remaining recordings**: Voice profiles are preserved and continue to provide recognition suggestions
+- **Speakers with no recordings**: Preserved by default. If `DELETE_ORPHANED_SPEAKERS=true` is set, they are automatically removed during the next scheduled cleanup
+
+**Note**: Protected recordings (with protected tags) will always preserve their associated speakers.
+
+## Tag Management Tab
+
+![Tag Management with Enhanced Badges](../assets/images/screenshots/tag-management-enhanced-badges.png)
+*Tag Management with visual badges for retention policies, protection status, sharing settings, and ASR defaults*
+
+Tag Management transforms simple labels into powerful processing instructions. Each tag you create carries multiple capabilities - a color for visual identification, an optional custom prompt that shapes AI summaries, default ASR (Automatic Speech Recognition) settings, retention policies, and sharing configurations.
+
+### Tag Display and Features
+
+The interface displays your tags as cards with clear visual badges indicating their configuration. Each card shows the tag name with its color indicator, and visual badges that make it easy to see at a glance:
+
+- **Retention Policy Badges**: Display retention periods (e.g., "90 days") or protection status (∞ infinity symbol for protected tags)
+- **Sharing Badges**: Indicate if this is a group tag with auto-share capabilities (👥 users icon)
+- **Language Badges**: Show custom language settings for transcription or summarization
+- **Speaker Range Badges**: Display ASR defaults like "Max 10" speakers for meetings with many participants
+- **Custom Prompts**: Preview of tag-specific AI summarization instructions
+
+These visual indicators make it immediately clear which tags have special behaviors, helping you quickly select the right tags when uploading or organizing recordings.
+
+### Creating New Tags
+
+Creating a new tag happens through the prominent "Create Tag" button. The system guides you through choosing a name, selecting a color from a palette, and optionally adding a custom prompt. The ASR defaults section appears when you're using advanced transcription services, letting you preset the expected number of speakers for recordings with this tag.
+
+### Prompt Stacking
+
+Tag prompts stack intelligently when multiple tags are applied. If you tag a recording with both "BSB Meetings" and "Student Meetings," both prompts combine, creating a comprehensive summary that addresses all specified requirements. This powerful stacking eliminates the need for complex single prompts trying to anticipate every combination.
+
+### Prompt Variables
+
+Tag and folder custom prompts may contain `{{name}}` placeholders that are filled in per recording at upload time. A "Council Meetings" tag whose prompt reads `Generate minutes for this council meeting. Agenda: {{agenda}}. Attendees: {{attendees}}.` will cause Speakr's upload form to display two input fields ("Agenda", "Attendees") whenever that tag is selected. The values are stored on the recording and substituted into the prompt at summarisation time, including on reprocessing.
+
+**Naming rules.** Variable names use ASCII identifier characters only (letters, digits, and underscores; must start with a letter or underscore). Names with non-ASCII characters such as `{{дата}}` are not recognised as placeholders and remain in the prompt as literal text. Labels in the upload form are derived automatically (`meeting_date` becomes "Meeting date").
+
+**Limits.** Up to 50 variables per recording, 8000 characters per value, 32000 characters total. Excess input is truncated server-side.
+
+**Single-pass substitution.** Variables are replaced once. A value that itself contains `{{anothervar}}` is treated as literal text rather than recursively expanded.
+
+**Drop-folder uploads.** Recordings ingested through the auto-process watch directory bypass the upload form and therefore have no opportunity to fill variables. Their stored `prompt_variables` is empty and any placeholders substitute to empty strings on the first summary run. Reprocess after upload to fill values, or use only non-templated prompts on tags applied to drop-folder content.
+
+**Editing values after upload.** Stored variable values are not yet editable from the recording detail or reprocess modal. To change a value, re-upload the recording or wait for that capability in a future release.
+
+**Where variables are surfaced.** The upload form mirrors the same priority chain that the summarisation task uses to pick a prompt. The first non-empty layer wins and its variables become inputs on the form: selected tags first, then the selected folder, then your personal summary prompt, then the site default set by the admin. Lower layers are not scanned because their prompt would not run.
+
+**Drop-folder ingest is the exception.** Recordings ingested through the auto-process watch directory bypass the upload form entirely, so any tag prompt with placeholders attached to such a recording silently substitutes to empty strings. Tag Management surfaces a warning when a tag is configured as a watch-folder tag and its custom prompt contains `{{...}}` placeholders. Either keep watch-folder tags variable-free, or reprocess after upload to fill the values.
+
+### ASR Defaults
+
+The ASR defaults feature is particularly valuable for consistent meeting types. Setting "Max 10" for a "Court Action" tag ensures the transcription service looks for up to 10 distinct speakers, improving accuracy for multi-party proceedings. A "One-on-One" tag might default to exactly 2 speakers, while a "Webinar" tag could specify 1-3 speakers.
+
+### Transcription Hints (Hotwords & Initial Prompt)
+
+Tags can also carry default **hotwords** and an **initial prompt** to improve transcription accuracy for specialized content. Hotwords are comma-separated terms the transcription engine should prioritize (e.g., brand names, acronyms, technical jargon). The initial prompt provides broader context about the recording content, helping the engine make better word choices.
+
+For example, a "Medical Rounds" tag might include hotwords like `epinephrine, tachycardia, intubation` and an initial prompt like "This is a medical team discussion about patient care in an ICU setting." When you upload a recording with this tag, these hints are automatically applied during transcription.
+
+These values follow a precedence hierarchy: upload form values take highest priority, then tag defaults, then folder defaults, then your personal defaults in [account settings](#custom-prompts-tab). They apply both at initial upload and when reprocessing the transcription, so changes you make to a tag's defaults will affect future reprocesses of recordings carrying that tag.
+
+### Default Transcription Model
+
+When your administrator has configured a transcription model list (via `TRANSCRIPTION_MODELS_AVAILABLE` or the admin dashboard), tag and folder edit forms gain a **Default transcription model** dropdown. Recordings with that tag will use the chosen model unless the upload form, folder default, or admin default overrides it. The precedence chain mirrors hotwords and initial prompt: per-upload selection beats tag default beats folder default beats admin default.
+
+If a tag has a default model set and the model is later removed from the configured list, the edit form shows a compact warning so you know to pick a replacement. The default itself is preserved in the database in case the model is added back, and the precedence chain falls through to the next available layer in the meantime.
+
+### Managing Tags
+
+Edit and delete buttons on each card provide full control. Edit to refine prompts based on results, adjust colors for better organization, or update ASR defaults as meeting patterns change. Delete removes tags no longer needed, though this doesn't affect recordings already tagged - they retain their labels for historical accuracy.
+
+## API Tokens Tab
+
+The API Tokens tab enables programmatic access to your Speakr instance through personal access tokens. These tokens allow automation tools, scripts, and custom integrations to authenticate as your user account.
+
+### Creating Tokens
+
+Click the **Create Token** button to generate a new token. You'll provide a descriptive name (like "n8n automation" or "CLI scripts") and optionally set an expiration period. The token value is shown only once after creation - copy it immediately and store it securely.
+
+!!! warning "Token Security"
+    Treat API tokens like passwords. They provide full access to your account. Never share tokens publicly, commit them to version control, or expose them in client-side code.
+
+### Token Display
+
+Active tokens appear as compact cards showing:
+
+- **Name** - The descriptive name you assigned
+- **Status badge** - Active (green), expired (yellow), or revoked (red)
+- **Created date** - When the token was created
+- **Last used** - When the token last authenticated a request
+- **Expiration** - When the token expires, or "No expiration" for permanent tokens
+
+### Using Tokens
+
+Tokens can authenticate API requests through multiple methods:
+
+```bash
+# Authorization header (recommended)
+curl -H "Authorization: Bearer YOUR_TOKEN" https://speakr.example.com/api/recordings
+
+# X-API-Token header
+curl -H "X-API-Token: YOUR_TOKEN" https://speakr.example.com/api/recordings
+
+# Query parameter (less secure)
+curl "https://speakr.example.com/api/recordings?token=YOUR_TOKEN"
+```
+
+### Revoking Tokens
+
+Click the trash icon on any token card to revoke it immediately. Revoked tokens stop working instantly and cannot be restored. Create a new token if you need continued access.
+
+### Best Practices
+
+- Use descriptive names to track each token's purpose
+- Set expiration dates for temporary integrations
+- Revoke tokens you no longer need
+- Create separate tokens for different integrations
+- Never share tokens between users - each person should create their own
+
+For detailed API documentation and integration examples, see the [API Tokens Guide](api-tokens.md).
+
+## About Tab
+
+![About](../assets/images/screenshots/settings about page.png)
+
+The About tab presents a comprehensive overview of your Speakr installation, combining version information, system configuration, feature highlights, and quick access to resources.
+
+### Version Information
+
+At the top, the Speakr logo and tagline "AI-Powered Audio Transcription & Note-Taking" remind you of the system's core purpose. The version badge (v0.5.5 in the example) immediately tells you which release you're running, essential information for troubleshooting and determining available features.
+
+### System Configuration
+
+This section provides complete transparency about your instance's capabilities. The Large Language Model field shows which AI model powers summaries and chat - here using the OpenRouter endpoint with a specific model. The Speech Recognition section details your transcription setup, showing whether you're using the standard Whisper API or advanced ASR endpoints. When ASR is enabled, you'll see additional configuration like the endpoint URL, indicating enhanced transcription features including speaker diarization.
+
+### Project Links
+
+Quick access buttons connect you to essential resources. The GitHub Repository button links to source code, issues, and releases - your primary channel for reporting bugs or requesting features. The Docker Hub button provides access to official container images for deployment and updates. The Documentation button opens setup guides and user manuals, ensuring help is always one click away.
+
+### Key Features
+
+Colorful cards remind you of Speakr's core capabilities. Audio Transcription highlights support for both Whisper API and custom ASR with high accuracy. AI Summarization emphasizes the OpenRouter and Ollama integrations for flexible, powerful summary generation. Speaker Diarization showcases the ability to identify and label different speakers automatically. Interactive Chat demonstrates the conversational AI capabilities for exploring transcripts. Inquire Mode highlights semantic search across all recordings. Sharing & Export emphasizes the ability to share recordings and export to various formats.
+
+### Using This Information
+
+This information-rich tab serves multiple purposes. For troubleshooting, it provides all the version and configuration details support groups need. For planning, it shows which features are available and properly configured. For learning, it links to all the resources needed to master Speakr's capabilities.
+
+## Privacy and Security Considerations
+
+Your account settings contain sensitive information that shapes your entire Speakr experience. The custom prompts you create might reveal organizational priorities or confidential project details. Speaker profiles could indicate who you meet with regularly. Share histories show what information you've distributed.
+
+Always log out when using shared computers. Speakr maintains sessions for convenience, but this means anyone with access to your browser can access your account. The logout button in the user menu immediately terminates your session and requires re-authentication.
+
+Review your shared recordings regularly. Links you created months ago might still be active, providing access to outdated or sensitive information. The Shared Transcripts tab makes this review easy - scan through periodically and revoke anything no longer needed.
+
+Consider the implications of language settings in international contexts. If you set Chinese as your interface language on a shared computer, the next user might struggle to navigate. Similarly, output language settings affect all AI interactions, so ensure they match your actual needs.
+
+## Optimizing Your Settings
+
+The most effective Speakr setup evolves with your needs. Start with basic configuration - your name, language preferences, and a simple custom prompt. As you become comfortable, add tags for organization, refine your prompts for better summaries, and build your speaker library for improved transcripts.
+
+Monitor which settings you actually use. If you never change certain preferences, they're probably fine at defaults. If you constantly adjust others, consider whether different base settings would reduce this friction. Your settings should work for you, not require constant attention.
+
+Share successful configurations with your group. If you've crafted an excellent prompt for technical summaries, share it with colleagues who might benefit. If your tag taxonomy works well, document it for others to adopt. Collective improvement benefits everyone.
+
+Remember that settings are tools for productivity, not endpoints themselves. The goal isn't perfect configuration but effective recording management. When your settings fade into the background and Speakr just works how you expect, you've achieved the right balance.
+
+---
+
+Next: Return to [User Guide](index.md) →
\ No newline at end of file
diff --git a/docs/user-guide/sharing.md b/docs/user-guide/sharing.md
new file mode 100644
index 00000000..452d3a61
--- /dev/null
+++ b/docs/user-guide/sharing.md
@@ -0,0 +1,225 @@
+---
+layout: default
+title: Sharing & Collaboration
+parent: User Guide
+nav_order: 5
+---
+
+# Sharing & Collaboration
+
+Speakr offers flexible collaboration options to match your workflow. Share recordings internally with group members for collaborative work, organize access through groups for seamless project management, or create public links for external stakeholders. Each sharing method serves different needs while maintaining security and control over your content.
+
+## Internal Sharing (User-to-User)
+
+Internal sharing enables direct collaboration between users in your Speakr instance. Share recordings one-on-one with family or colleagues, grant precise permissions based on trust levels, and maintain control over who can access your content.
+
+### Understanding Internal Sharing
+
+Unlike public share links that work for anyone with the URL, internal sharing creates secure connections between authenticated users within your Speakr instance. When you share internally, the recipient must log in to access the recording, and their permissions are tracked and enforceable. This makes internal sharing ideal for sensitive content and ongoing collaboration.
+
+### Requirements for Internal Sharing
+
+Your Speakr administrator must enable internal sharing before this feature becomes available. Once enabled, you'll see sharing buttons in the recording detail view. If you don't see these options, contact your administrator about enabling the `ENABLE_INTERNAL_SHARING` feature.
+
+### Sharing a Recording with Another User
+
+![Share with User Modal](../assets/images/screenshots/Share modal.png)
+
+When viewing any recording you own, look for the blue users icon button in the toolbar. Clicking this opens the share modal where you can search for colleagues and configure access permissions.
+
+The search functionality makes finding the right person quick and intuitive. Type at least two characters of a username to see matching results. The system filters out your own name since you can't share recordings with yourself, and shows only other users in your instance.
+
+Before sharing, consider what level of access makes sense for this collaboration. Speakr offers three permission levels that build on each other, letting you grant exactly the access needed without oversharing control.
+
+**View-Only Access** provides the foundation - recipients can read the transcription, review your summary and notes, listen to the audio if it hasn't been deleted, and use the AI chat feature to ask questions about the content. They cannot modify anything, ensuring your original content remains intact. This works well when you're distributing information but don't need input or edits.
+
+**Edit Permissions** add the ability to modify the recording's metadata and shared content. Recipients with edit access can change the title, update participant lists, adjust the meeting date and time, modify the shared summary, and add or remove tags. However, they still cannot delete the recording or share it with others. Edit access works well for collaborative documentation where multiple group members contribute context and refinements. Note that all users can maintain their own personal notes regardless of edit permissions.
+
+**Re-share Permissions** grant the highest level of access short of full ownership. Recipients can do everything editors can do, plus share the recording with additional users and manage those shares by revoking access. This creates a chain of trust where you empower certain colleagues to extend access as needed. However, even with re-share permissions, recipients cannot delete the recording - only the original owner can do that.
+
+To share with view-only access, simply search for the user and click their name in the results. For edit or re-share permissions, check the appropriate boxes before clicking the username. The share takes effect immediately, and the recipient gains access to the recording in their main interface.
+
+### Managing Your Shares
+
+![Manage Shares Modal](../assets/images/screenshots/Share modal.png)
+
+The unified share modal shows everyone who has access to a recording, making it easy to track and control sharing. Each entry displays the recipient's name, their permissions level, and when you granted access. The red user-times icon lets you instantly revoke access when collaboration ends or circumstances change.
+
+Revoking access is immediate and thorough. When you revoke someone's access, they lose the ability to view the recording, and any personal notes they created on the shared recording are removed. This ensures complete separation when collaboration ends.
+
+### Personal Notes on Shared Recordings
+
+One of internal sharing's most powerful features is support for personal notes. When someone shares a recording with you, you can add your own private notes that only you can see. These personal notes never appear to the original owner or other recipients - they're your private space for observations, follow-ups, or context.
+
+**Important: Notes vs. Summaries**
+
+- **Notes**: Always personal and private. Each user (owner and shared recipients) can create their own notes that only they can see. No edit permission is required to add personal notes to a shared recording.
+- **Summary**: Shared globally. The recording owner's AI-generated summary is visible to all users who have access to the recording. Only users with edit permission can modify the summary.
+
+This separation means you can freely annotate shared recordings with your own thoughts and action items without cluttering the shared content or requiring special permissions. The owner maintains control over the official summary while everyone can maintain their own personal notes.
+
+Personal notes persist until access is revoked. If the owner removes your access, your personal notes are automatically deleted since you no longer need notes on content you can't access. This automatic cleanup prevents orphaned data and maintains security.
+
+### Independent Inbox and Favorite Status
+
+Each user maintains their own inbox and favorite status for shared recordings. Your inbox and starred items are completely independent from other users - when you mark a shared recording as read or favorite it, this doesn't affect how it appears to the owner or other recipients. This allows everyone to organize their personal workspace without interfering with collaborators' views.
+
+### Viewing Recordings Shared With You
+
+Recordings that others have shared with you appear in your main recording list with distinctive visual indicators. Shared recordings display with an accent-colored title and a subtle border to make them immediately distinguishable from your own recordings. When you hover over a shared recording, you can see the owner's username (if your administrator has enabled username visibility), so you always know the content source.
+
+The "Shared with Me" toggle in the sidebar filters your view to show only recordings that others have shared with you. This focused view helps when you need to review collaborative content without distraction from your own recordings.
+
+Your permissions determine what you can do with shared recordings. View-only access means read and listen capabilities, while edit permissions let you contribute to the recording's metadata and shared summary. Regardless of your permission level, you can always add and edit your own personal notes - these are private to you and don't require any special permissions. The interface adapts to your permissions, showing or hiding controls based on your access level.
+
+### Security and Privacy
+
+Internal sharing implements multiple security layers to protect your content. Only authenticated users in your Speakr instance can receive shares - external parties cannot gain access through internal sharing mechanisms. Each share creates a tracked database record that links specific users to specific recordings with defined permissions.
+
+The permission system enforces strict boundaries. View-only recipients cannot accidentally or intentionally modify content. Edit permissions don't include deletion rights, preventing data loss from collaborative editing. Re-share permissions create an audit trail of who granted access to whom, maintaining accountability.
+
+When you delete a recording, all associated shares are automatically removed. Recipients lose access immediately, ensuring that content deletion is complete and final. Similarly, if an administrator disables a user's account, all their shares (both granted and received) become inactive.
+
+### Practical Use Cases
+
+Internal sharing and group features work together to handle different collaboration scenarios. Here's how people actually use them:
+
+### One-on-One Sharing
+
+Share individual recordings with specific people when you need targeted collaboration. Your manager asks about yesterday's client call - share it directly with view access so they can review what was discussed. A colleague missed the group meeting - share it with edit access so they can add their notes and questions. You're working on a project with someone from another department - share relevant recordings as you create them to keep them in the loop.
+
+This works well when the collaboration is temporary or involves people who don't regularly need access to your recordings. You control exactly who sees what, and you can revoke access when the collaboration ends.
+
+### Group-Based Sharing
+
+Groups automate sharing for groups who regularly work together. Create an engineering group and apply group tags to architecture discussions - everyone on the group automatically gets access. Sales group members tag customer calls with group tags so the whole group learns from each interaction. HR group shares interview recordings with all interviewers without manually sharing each one.
+
+Group sharing makes sense when the same group of people consistently needs access to similar content. Set it up once, and recordings flow to the right people automatically. The group structure persists, so new recordings tagged for the group reach all members without additional work.
+
+### Combining Both Approaches
+
+You can use groups for regular collaboration and individual sharing for exceptions. Your engineering group has automatic access to technical discussions through group tags. When a design decision needs executive review, you individually share that specific recording with your VP. The group gets their automated access, and you layer on targeted sharing for special cases.
+
+This combination handles both routine collaboration (groups) and exceptional needs (individual shares) without creating organizational overhead.
+
+### Real-World Scenarios
+
+| Scenario | Approach | Why It Works |
+|----------|----------|--------------|
+| Family recording memories | Create "Family" group, tag trips and events | Everyone gets access automatically, can add their own notes |
+| Book club discussions | Create "Book Club" group with protected tag | Recordings preserved permanently, all members auto-share |
+| Work project with 3 people | Share individually with edit access | Temporary collaboration, easy to revoke when project ends |
+| Department meetings | Create department group, tag all meetings | New group members get future meetings, not historical ones |
+| Client presentations | Individual share with view-only | Controlled access, clients can't accidentally edit |
+| Research group | Group with custom 7-year retention | Automatic sharing + compliance with retention policies |
+| Daily standups | Group with 14-day retention | Auto-share with group, auto-cleanup of routine recordings |
+
+### Combining with Retention Policies
+
+Group tags can enforce retention policies that match how your group works. Your daily standup group tag auto-deletes recordings after two weeks since they're routine updates. Your architecture decisions group tag protects recordings permanently because those discussions document important choices. Your client calls group tag keeps recordings for one year to match your data retention policy.
+
+This means the same recordings that automatically share with your group also automatically follow the right lifecycle. Tag it once, and both sharing and retention happen correctly.
+
+## Best Practices for Internal Sharing
+
+Share recordings promptly after meetings or discussions while context is fresh. Recipients can review content, add notes, and ask questions through the AI chat while details are still top-of-mind. This immediacy makes collaboration more effective and valuable.
+
+Use view-only access by default, granting edit permissions only when recipients truly need to contribute. This prevents accidental modifications while still enabling information sharing. Reserve re-share permissions for trusted group leads or project managers who need to coordinate access for their groups.
+
+Periodically review your shared recordings to ensure access remains appropriate. Group members change roles, projects end, and sensitive content that once needed sharing might now warrant restricted access. The manage shares interface makes regular audits quick and straightforward.
+
+When collaborating on sensitive content, verify recipient permissions match their role and need. Legal discussions might need view-only access even for close colleagues, while brainstorming sessions benefit from liberal edit permissions. Match permissions to content sensitivity and collaboration needs.
+
+## Public Share Links
+
+Sometimes you need to share a recording with someone who doesn't have a Speakr account - perhaps a client needs to review a meeting, a colleague missed an important discussion, or you want to provide documentation to stakeholders. Speakr's public sharing feature lets you create secure, read-only links to your recordings while maintaining complete control over what information is shared.
+
+### Understanding Public Shares
+
+When you share a recording, Speakr generates a unique, secure link that provides access to that specific recording without requiring the recipient to log in or have an account. Each share link is cryptographically secure and impossible to guess, ensuring that only people you explicitly share with can access your content.
+
+The sharing system gives you granular control over what recipients can see. You decide whether to include your AI-generated summary, your personal notes, or both. The transcription itself is always included, as it forms the core content of the recording. Recipients get a clean, professional view of your recording without any of the administrative interface or your other recordings.
+
+## Requirements for Sharing
+
+Before you can share recordings, your Speakr instance must meet two critical requirements. First, it must be accessible via HTTPS with a valid SSL certificate. Second, it must be reachable from the internet with a proper domain name or public IP address.
+
+These requirements exist because share links need to be accessible to recipients who don't have accounts and may be accessing from anywhere. A local network installation or non-HTTPS setup cannot generate shareable links - the share button will either be disabled or display an error message explaining that sharing requires a secure, internet-accessible connection. If you're running Speakr internally without SSL or public access, you'll need to work with your IT group to set up proper HTTPS and internet routing before the sharing feature becomes available.
+
+## Creating a Share Link
+
+![Share Recording Modal](../assets/images/screenshots/Share modal.png)
+
+Once your instance meets the requirements, sharing a recording takes just a few clicks. While viewing any recording, click the share button in the toolbar to open the sharing modal. This presents you with two simple checkboxes that control what information will be visible to recipients.
+
+The "Share Summary" option determines whether recipients can see the AI-generated summary of your recording. This is particularly useful when sharing with executives or stakeholders who need a quick overview without reading the entire transcription. The summary provides them with key points, decisions, and action items in a digestible format.
+
+The "Share Notes" option controls whether your personal notes are visible. These are the markdown notes you've added to provide context, follow-ups, or additional thoughts about the recording. Consider carefully whether these notes are appropriate for your audience - they might contain internal observations or personal reminders that aren't meant for external viewing.
+
+Once you've selected your options, click "Create Share Link" to generate the secure URL. The link appears immediately in the modal, ready to copy to your clipboard. This link is permanent until you explicitly revoke it, so recipients can bookmark it for future reference.
+
+## What Recipients Experience
+
+![Shared Recording View](../assets/images/screenshots/Share link.png)
+
+When someone clicks your share link, they're taken to a streamlined view of your recording designed for easy consumption without distractions. The interface is clean and professional, branded with Speakr but showing only the content you've chosen to share.
+
+At the top of the page, recipients see the recording title prominently displayed along with a note indicating it's a shared recording. The audio player sits just below, providing full playback controls so they can listen to the original recording at their own pace. The player shows the total duration and current position, allowing recipients to navigate to specific moments or replay important sections.
+
+The main content area is divided between the transcription and summary (if you've chosen to share it). The transcription appears with clear formatting, including speaker labels if your recording includes speaker diarization. Each identified speaker appears as a colored tag, making it easy to follow multi-person conversations. The interface includes view options like Simple and Bubble modes if speaker identification is present, and a copy button to easily extract the text.
+
+If you've enabled summary sharing, it appears in a dedicated panel with its own copy functionality. The summary is rendered with full markdown formatting, presenting a professional overview of the key points from your recording. Your notes, if shared, would appear in a similar panel, providing additional context and insights.
+
+At the bottom of the page, recipients see a subtle footer indicating the content is "Powered by advanced AI transcription" with a link to Speakr. This gives your shares a professional appearance while maintaining the focus on your content. The entire experience is read-only - recipients cannot edit anything, cannot access your other recordings, and cannot see any of your account information or settings.
+
+## Managing Your Shared Recordings
+
+![Shared Transcripts](../assets/images/screenshots/share-summary-view.png)
+
+All your shared recordings are centrally managed through the Shared Transcripts section in your account settings. This gives you a complete overview of everything you've shared and with whom.
+
+The shared transcripts list shows each recording you've shared, when you created the share link, and what options you selected (summary and/or notes). Each entry includes the full share URL that you can copy again if needed - perhaps you've lost the original link or need to reshare with additional people.
+
+You can modify what's included in a share by toggling the summary and notes checkboxes directly in this interface. These changes take effect immediately for anyone accessing the link. This is useful when you initially share just the transcription but later decide to include the summary, or when you want to remove notes that are no longer relevant.
+
+The delete button next to each share instantly revokes access. Once deleted, the share link becomes invalid and anyone trying to access it will see an error message. This gives you complete control over the lifecycle of your shared content.
+
+## Security and Privacy Considerations
+
+Speakr requires HTTPS for all sharing operations, ensuring that share links can only be created and accessed over secure connections. This protects the content during transmission and prevents interception of sensitive recordings.
+
+Each share link contains a cryptographically secure random token that's unique to that specific share. These tokens are generated using security best practices and are long enough to make guessing or brute-force attacks infeasible. Even if someone knows you've shared other recordings, they cannot derive or guess the links to those shares.
+
+It's important to understand that share links don't require authentication - anyone with the link can access the recording. This makes sharing convenient but means you should treat these links with the same care you'd treat sensitive documents. Share them only through secure channels like encrypted email or private messages, never post them publicly, and revoke access when it's no longer needed.
+
+The system doesn't track who accesses shared links or how often they're viewed. This respects recipient privacy but means you won't know if a link has been forwarded to others. If you need tighter access control, consider asking recipients to create Speakr accounts instead of using public sharing.
+
+## Best Practices for Sharing
+
+When sharing internally within your organization, you can generally include both summaries and notes since colleagues have context about the discussions and need complete information. The notes often contain valuable action items, follow-ups, and clarifications that help group members understand not just what was said, but what needs to happen next.
+
+For external sharing with clients or partners, consider sharing only the summary without your internal notes. The summary provides them with professional, polished takeaways while your notes remain private for internal use. Review the content before sharing to ensure nothing confidential or inappropriate is included.
+
+When sharing for documentation or compliance purposes, focus on the transcription itself as the authoritative record. The word-for-word transcription with timestamps provides an accurate account of what was discussed, while summaries and notes represent interpretations that might not be appropriate for official records.
+
+Always review what you're sharing before sending the link. Once someone has accessed the content, they could save or screenshot it, so revoking the link later won't remove their access to information they've already viewed. If you realize you've shared something inappropriate, revoke the link immediately to prevent further access, but assume that previous viewers may have retained the information.
+
+## Common Sharing Scenarios
+
+Meeting participants often appreciate receiving a share link after important discussions. Include both the summary and notes to give them a complete picture of decisions made and actions required. This is especially valuable for participants who may have missed parts of the meeting or need to review specific details.
+
+When updating clients on project progress, share recordings of internal discussions with summaries but without internal notes. This gives them transparency into your process and decisions while maintaining appropriate boundaries about internal deliberations.
+
+For training and onboarding, shared recordings become valuable learning resources. New group members can listen to past discussions to understand project history, decision rationale, and group dynamics. Include comprehensive notes to provide context that might not be obvious from the transcription alone.
+
+Legal and compliance groups may require unedited transcriptions of important conversations. In these cases, share only the transcription without summaries or notes that could be seen as interpretation or editorial commentary. The raw transcription provides an objective record of what was said.
+
+## Limitations and Considerations
+
+Share links are designed for occasional sharing with individuals or small groups, not for mass distribution or public posting. The system isn't optimized for hundreds of concurrent viewers, and publicly posted links could expose sensitive information to unintended audiences.
+
+Currently, shares don't expire automatically, though this feature may be added in future updates. Once created, a share link remains valid until you manually revoke it. This means you should periodically review your shared recordings and remove access to those no longer needed.
+
+The sharing feature is only available over HTTPS connections for security reasons. If you're running Speakr on a local network without SSL certificates, you won't be able to create share links. This is a deliberate security measure to prevent sensitive recordings from being shared over unencrypted connections.
+
+Recipients need a modern web browser to view shared recordings. The audio player and transcription display require JavaScript and HTML5 support. While this covers the vast majority of users, recipients using very old browsers or restrictive corporate environments might experience issues.
\ No newline at end of file
diff --git a/docs/user-guide/transcript-templates.md b/docs/user-guide/transcript-templates.md
new file mode 100644
index 00000000..62f68c66
--- /dev/null
+++ b/docs/user-guide/transcript-templates.md
@@ -0,0 +1,365 @@
+# Transcript Templates Guide
+
+## Overview
+
+Transcript Templates in Speakr allow you to customize how your transcriptions are formatted when downloading them. Instead of a fixed format, you can create multiple templates for different use cases - whether you need timestamps for subtitles, speaker-focused formats for interviews, or screenplay-style formatting for media production.
+
+## Accessing Transcript Templates
+
+1. Click on your username in the top-right corner
+2. Navigate to **Account Settings**
+3. Select the **Transcript Templates** tab
+
+## Understanding Template Variables
+
+Templates use placeholders (variables) that get replaced with actual transcript data:
+
+### Available Variables
+
+- `{{index}}` - Sequential number of the transcript segment (1, 2, 3...)
+- `{{speaker}}` - Name of the speaker (e.g., "Speaker 1", "John", etc.)
+- `{{text}}` - The actual spoken text/content
+- `{{start_time}}` - When the segment starts (format: HH:MM:SS)
+- `{{end_time}}` - When the segment ends (format: HH:MM:SS)
+
+### Filters
+
+Variables can be modified using filters by adding a pipe (|) symbol:
+
+- `{{speaker|upper}}` - Converts speaker name to UPPERCASE
+- `{{text|upper}}` - Converts text to UPPERCASE
+- `{{start_time|srt}}` - Formats time for SRT subtitles (HH:MM:SS,mmm)
+- `{{end_time|srt}}` - Formats time for SRT subtitles (HH:MM:SS,mmm)
+
+## Creating Your First Template
+
+### Step 1: Click "Create Template"
+In the Transcript Templates section, click the **Create Template** button.
+
+### Step 2: Fill in Template Details
+
+**Template Name**: Give your template a descriptive name
+
+- Examples: "Interview Format", "Subtitles SRT", "Meeting Minutes"
+
+**Description** (Optional): Add a brief description of when to use this template
+
+- Example: "Use for client interview transcriptions"
+
+**Template**: Enter your format pattern using variables
+
+- Example: `[{{start_time}}] {{speaker}}: {{text}}`
+
+### Step 3: Set Default (Optional)
+Check "Set as default template" if you want this template to be pre-selected when downloading transcripts.
+
+### Step 4: Save
+Click **Save** to create your template.
+
+## Common Template Examples
+
+### 1. Simple Conversation
+```
+{{speaker}}: {{text}}
+```
+**Output:**
+```
+John: Hello, how are you today?
+Sarah: I'm doing great, thanks for asking!
+```
+
+### 2. Timestamped Format
+```
+[{{start_time}} - {{end_time}}] {{speaker}}: {{text}}
+```
+**Output:**
+```
+[00:00:01 - 00:00:03] John: Hello, how are you today?
+[00:00:04 - 00:00:07] Sarah: I'm doing great, thanks for asking!
+```
+
+### 3. Interview/Q&A Format
+```
+{{speaker|upper}}:
+{{text}}
+
+```
+**Output:**
+```
+INTERVIEWER:
+What brought you to this field?
+
+GUEST:
+I've always been passionate about technology...
+```
+
+### 4. SRT Subtitle Format
+```
+{{index}}
+{{start_time|srt}} --> {{end_time|srt}}
+{{text}}
+
+```
+**Output:**
+```
+1
+00:00:01,000 --> 00:00:03,000
+Hello, how are you today?
+
+2
+00:00:04,000 --> 00:00:07,000
+I'm doing great, thanks for asking!
+```
+
+### 5. Meeting Minutes Style
+```
+• [{{start_time}}] {{speaker}}: {{text}}
+```
+**Output:**
+```
+• [00:00:01] John: Let's begin today's meeting with updates.
+• [00:00:05] Sarah: I'll start with the marketing report.
+```
+
+### 6. Screenplay Format
+```
+                    {{speaker|upper}}
+        {{text}}
+
+```
+**Output:**
+```
+                    JOHN
+        Hello, how are you today?
+
+                    SARAH
+        I'm doing great, thanks for asking!
+```
+
+### 7. Court Transcript Style
+```
+{{index}}    {{speaker|upper}}: {{text}}
+```
+**Output:**
+```
+1    ATTORNEY: Please state your name for the record.
+2    WITNESS: My name is John Smith.
+```
+
+## Using Templates When Downloading
+
+### Method 1: From the Transcript View
+1. Open a recording with a transcription
+2. Click the **Download** button next to the transcript
+3. Select your desired template from the popup
+4. The transcript will download in your chosen format
+
+### Method 2: Set a Default Template
+1. Edit a template and check "Set as default template"
+2. This template will be pre-selected when downloading
+3. You can still choose a different template at download time
+
+### Method 3: Download Raw Transcript
+- Select "No Template (Raw Export)" to download the transcript without any formatting
+- Useful when you need to process the text in another application
+
+## Managing Templates
+
+### Editing Templates
+1. Click on any template in the list to open it
+2. Modify the name, description, or format
+3. Click **Save** to update
+
+### Deleting Templates
+1. Open the template you want to delete
+2. Click the **Delete** button
+3. Confirm the deletion
+
+### Creating Default Templates
+If you have no templates, click **Create Default Templates** to generate a comprehensive set of starter templates:
+
+- Simple Conversation - Clean format with just speaker names
+- Timestamped - Basic format with time ranges
+- Interview Q&A - Professional interview format
+- Meeting Minutes - Bulleted format for meeting notes
+- Court Transcript - Legal deposition style with line numbers
+- SRT Subtitle - Standard subtitle format for content creation
+- Screenplay - Script formatting for creative projects
+
+## Advanced Tips
+
+### 1. Multi-line Templates
+You can create templates with multiple lines by adding line breaks:
+```
+=================
+Time: {{start_time}}
+Speaker: {{speaker}}
+Message: {{text}}
+=================
+```
+
+### 2. Combining Filters
+Use multiple filters in the same template:
+```
+[{{start_time|srt}}] {{speaker|upper}}: {{text}}
+```
+
+### 3. Creating Separators
+Add visual separators between segments:
+```
+{{speaker}}: {{text}}
+---
+```
+
+### 4. Indentation for Readability
+Use spaces or tabs for indentation:
+```
+    {{start_time}} | {{speaker}}
+        {{text}}
+```
+
+## Use Cases
+
+### For Journalists
+Create an "Interview Format" template with timestamps and speaker labels for easy reference when writing articles.
+
+### For Researchers
+Use a numbered format with timestamps to cite specific moments in recorded interviews or focus groups.
+
+### For Content Creators
+Export in SRT format for adding captions to podcasts or other multimedia content, or use screenplay format for creative audio scripts and productions.
+
+### For Business Meetings
+Create a "Meeting Minutes" template that clearly shows who said what and when, perfect for action items and follow-ups.
+
+### For Legal Professionals
+Use court transcript style formatting with line numbers and uppercase speaker names for depositions and testimonies.
+
+### For Podcasters
+Format transcripts for show notes with timestamps that listeners can click to jump to specific topics.
+
+## Integrating with External Tools
+
+Transcript templates become even more powerful when you combine them with external applications. Here are some practical integrations people use:
+
+### Obsidian and Note-Taking Apps
+
+If you use Obsidian, Logseq, or similar markdown-based note apps, you can set up automatic export of your transcripts. Speakr includes an auto-export feature that automatically writes completed transcripts to markdown files.
+
+Enable auto-export by adding these settings to your `.env` file:
+```bash
+ENABLE_AUTO_EXPORT=true
+AUTO_EXPORT_DIR=/data/exports
+AUTO_EXPORT_TRANSCRIPTION=true
+AUTO_EXPORT_SUMMARY=true
+```
+
+Then map the exports directory to your note app's folder in `docker-compose.yml`:
+```yaml
+volumes:
+  - ./uploads:/data/uploads
+  - ./instance:/data/instance
+  - /Users/username/Documents/Obsidian/Transcripts:/data/exports
+```
+
+Create a default transcript template in your Speakr settings that formats the way you want - the auto-export system uses your default template. When a recording finishes processing, Speakr automatically writes a markdown file to the exports directory with metadata, summary, and formatted transcription.
+
+Files are organized into subdirectories by username, so multiple users can export to the same vault without conflicts. Obsidian picks up these markdown files automatically, and you can reference them in daily notes, link them to related content, and search across all your transcripts.
+
+### Automated Processing Workflows
+
+Mount Speakr's upload directory as a Docker volume pointing to a location your automation tools can access. Create a template that exports in a structured format (like JSON or CSV), then use scripts to process the files automatically.
+
+For example, export client call transcripts to a folder that triggers a script to extract action items and add them to your project management tool. Or export interview transcripts to a research folder where analysis software picks them up for coding and categorization.
+
+The key is creating a template that produces the exact format your downstream tool expects, then using file system watching or scheduled scripts to move the files where they need to go.
+
+### Subtitle and Content Creation Workflows
+
+Create SRT-format templates and export transcripts for use in content creation projects. The SRT format provides time-coded text that can be used for subtitles in multimedia content, podcast show notes with timestamps, or any project where you need synchronized text.
+
+If you're creating multimedia content, you can export these transcripts to folders that your editing software monitors. Some tools watch specific directories for subtitle files - save your Speakr transcripts there, and they appear automatically for integration.
+
+This eliminates the manual export-import-format cycle when you're producing content from your audio recordings.
+
+### Documentation Systems
+
+Groups using wikis or documentation platforms can create templates that match their documentation format. Export meeting transcripts in the right format, clean them up minimally, and publish them to the group wiki. Some groups have scripts that take Speakr exports and create wiki pages automatically, preserving the discussion context for future reference.
+
+### Example: Obsidian Auto-Export Setup
+
+Here's a complete setup for automatic export to Obsidian:
+
+1. **Enable auto-export in `.env`**:
+    ```bash
+    ENABLE_AUTO_EXPORT=true
+    AUTO_EXPORT_DIR=/data/exports
+    AUTO_EXPORT_TRANSCRIPTION=true
+    AUTO_EXPORT_SUMMARY=true
+    ```
+
+2. **Map exports to Obsidian vault in `docker-compose.yml`**:
+    ```yaml
+    volumes:
+     - ./uploads:/data/uploads
+     - ./instance:/data/instance
+     - /Users/username/Documents/Obsidian/Transcripts:/data/exports
+    ```
+
+3. **Create a default transcript template** in Speakr settings with the format you want:
+    ```
+    [{{start_time}}] {{speaker}}: {{text}}
+    ```
+
+4. **Restart Speakr** to apply the changes:
+    ```bash
+    docker compose restart
+    ```
+
+Now when any recording finishes processing, Speakr automatically writes a markdown file to your Obsidian vault with:
+
+- Metadata (date, participants, tags, processing times)
+- Notes (if you added any)
+- AI-generated summary
+- Formatted transcription using your template
+
+Files appear in subdirectories by username, so `alice` gets her transcripts in `Transcripts/alice/` and `bob` gets his in `Transcripts/bob/`. Obsidian indexes these automatically, and you can link to them from daily notes, search across all transcripts, and reference them alongside your other knowledge.
+
+This same approach works with Logseq, Notion (if you set the export directory to Notion's import folder), or any markdown-based knowledge management system.
+
+## Troubleshooting
+
+### Template Not Appearing
+- Ensure you've saved the template
+- Refresh the page if needed
+- Check that you're logged into the correct account
+
+### Variables Not Replacing
+- Verify variable names are spelled correctly
+- Ensure double curly braces `{{}}` are used
+- Check that the transcript has the required data (speakers, timestamps)
+
+### Download Issues
+- Ensure the recording has a completed transcription
+- Try downloading without a template first to verify the transcript exists
+- Check your browser's download settings
+
+## Best Practices
+
+1. **Name Templates Clearly**: Use descriptive names that indicate the purpose
+2. **Test Your Templates**: Download a sample transcript to verify formatting
+3. **Keep Multiple Templates**: Create different templates for different use cases
+4. **Document Complex Templates**: Use the description field to explain when to use each template
+5. **Start Simple**: Begin with basic templates and add complexity as needed
+
+## Need Help?
+
+If you encounter issues or have questions about transcript templates:
+
+1. Check this guide for examples and troubleshooting
+2. Try the default templates as a starting point
+3. Report issues at [GitHub Issues](https://github.com/anthropics/claude-code/issues)
+
+---
+
+*Last updated: December 2024*
\ No newline at end of file
diff --git a/docs/user-guide/transcripts.md b/docs/user-guide/transcripts.md
new file mode 100644
index 00000000..e88f5ed2
--- /dev/null
+++ b/docs/user-guide/transcripts.md
@@ -0,0 +1,295 @@
+# Working with Transcriptions
+
+Once your audio has been processed, Speakr provides a rich set of tools for viewing, editing, and interacting with your transcriptions. This section covers everything you need to know about working with transcribed content. For information on the transcription process itself, see [transcription features](../features.md#core-transcription-features).
+
+## Understanding the Transcription View
+
+When you select a recording from the sidebar, the center panel displays the full transcription. The layout is designed for easy reading and navigation, with clear visual indicators for different speakers and timestamps.
+
+![Transcription View with Audio Sync](../assets/images/screenshots/audio-sync-bubble-view.png)
+*Transcription view with real-time audio synchronization and active segment highlighting*
+
+## Speaker Identification
+
+If your recording was processed with [speaker diarization](../features.md#speaker-diarization) enabled, each speaker's contributions are labeled with colored tags like SPEAKER_01, SPEAKER_02, and so on. This requires the [ASR endpoint](../getting-started.md#option-b-custom-asr-endpoint-configuration). These labels are automatically generated during transcription and help you follow multi-person conversations.
+
+### Identifying Speakers
+
+When you need to assign real names to speaker labels, click the speaker identification button in the toolbar. This opens a modal where you can:
+
+![Speaker ID Modal with Voice Profiles](../assets/images/screenshots/speaker-identification-voice-profiles.png)
+*Speaker identification modal with AI-powered voice profile suggestions based on previous recordings*
+
+The speaker identification modal shows each detected speaker with a sample of their dialogue to help you identify them. When you've identified speakers in previous recordings, Speakr's voice recognition system analyzes voice embeddings and provides intelligent suggestions with confidence scores. You can enter real names for each speaker, and these names will replace the generic labels throughout the transcription. The system remembers these assignments and builds voice profiles, making it easier and faster to identify the same speakers in subsequent recordings.
+
+### Managing Saved Speakers
+
+All speakers you identify are automatically saved to your speaker database. You can manage these saved speakers through the dedicated [Speakers Management tab](settings.md#speakers-management-tab) in your [account settings](settings.md). Navigate to Account > Speakers Management to view all your saved speakers.
+
+![Speakers Management](../assets/images/screenshots/settings speakr management.png)
+
+The Speakers Management interface displays all your saved speakers in a responsive grid layout. Each speaker card shows the speaker's name, usage statistics including how many times they've been identified, when they were last used in a recording, and when they were first added to your database. The interface includes internal scrolling to handle large numbers of speakers while keeping the header and action buttons always visible.
+
+You can delete individual speakers by clicking the trash icon on their card, or use the "Delete All" button to clear your entire speaker database. This is useful for maintaining privacy or when you need to start fresh with a new set of speakers. The speaker count at the bottom keeps track of how many speakers you have saved.
+
+The system uses these saved speakers to provide suggestions when you're identifying speakers in new recordings, making the identification process faster over time as you build up your speaker database.
+
+## Editing Transcriptions
+
+Speakr provides two different editing modes depending on the type of transcription you're working with.
+
+### Simple Text Editing
+
+For standard transcriptions without speaker diarization, click the Edit button in the toolbar to enter a simple text editor. Your edits are preserved even when you [regenerate summaries](../features.md#automatic-summarization) or use the chat feature. This allows you to make corrections to the entire transcription as a single text block. You can fix transcription errors, add punctuation, insert clarifications, and improve formatting. Your changes are saved when you click the Save button.
+
+### Advanced ASR Segment Editing
+
+For transcriptions processed with [ASR](../features.md#speaker-diarization) and speaker diarization, Speakr offers a powerful segment-based editor that preserves the structure and timing of your transcription. If you encounter issues with speaker identification, see [troubleshooting](../troubleshooting.md#speaker-identification-not-working).
+
+![ASR Transcription Editor](../assets/images/screenshots/edit-transcription-modal.png)
+
+The ASR editor presents your transcription as a table of segments, where each row represents a single utterance with its associated metadata. For each segment, you can:
+
+**Edit Speaker Names**: Each segment shows who is speaking. You can click on any speaker field to change it, with an intelligent dropdown that suggests speakers from your saved speaker database. As you type, the system filters suggestions to help you quickly find the right speaker. This is particularly useful for correcting misidentified speakers or standardizing speaker names across the transcription.
+
+**Adjust Timestamps**: The start and end times for each segment can be fine-tuned using the adjustment arrows. This is helpful when the automatic segmentation isn't quite right, allowing you to precisely mark when each person starts and stops speaking.
+
+**Edit Text Content**: The main content of each utterance can be edited directly in its text field. You can correct transcription errors, fix grammar, add punctuation, or clarify unclear speech while maintaining the segment structure.
+
+**Manage Segments**: Use the trash icon to remove segments that shouldn't be in the transcription (such as false detections or noise). You can also add new segments if the ASR system missed something, positioning them with appropriate timestamps.
+
+The ASR editor maintains the JSON structure of your transcription, which is essential for features like speaker-based search, audio synchronization (clicking on text to jump to that point in the audio), and proper display in bubble view. When you save changes in the ASR editor, the system preserves all timing and speaker information while applying your corrections.
+
+Your edits are saved to the database when you click "Save Changes". The system maintains a record that the transcription has been manually edited, which is useful for quality control and audit purposes. Note that if you reprocess the transcription later with full transcription reprocessing, your manual edits will be overwritten. To preserve your edits while updating the summary, use summary-only reprocessing instead.
+
+#### Editor Productivity Features
+
+The ASR editor includes several quality-of-life features for working through long transcripts:
+
+**Autosave**: When enabled in your account preferences (`Account → Preferences → Autosave editor`), edits are saved automatically two seconds after the last keystroke. The Save indicator briefly flashes "Saved" each time a save completes. Autosave is opt-in so users who prefer explicit control over save points can leave it off.
+
+**Save Without Closing**: The save button next to the close button keeps the editor open after saving, useful when you want to commit progress mid-edit without losing your scroll position.
+
+**Ctrl+S**: Pressing `Ctrl+S` (or `Cmd+S` on macOS) anywhere in the editor saves without closing. Equivalent to clicking the save-without-closing button.
+
+**Scroll Memory**: The editor remembers your scroll position when you close it. Reopening the editor for the same recording returns you to where you were instead of jumping to the top.
+
+**Double-Click to Edit**: Double-clicking any segment in the simple transcript view opens the ASR editor and scrolls directly to that segment. The target row is briefly highlighted so it stands out among the others.
+
+## View Options
+
+The transcription panel offers two display modes to suit different preferences:
+
+### Simple View
+
+The default simple view presents the transcription as flowing text with inline speaker labels. This format is ideal for reading through content quickly and copying text for use in other applications. The clean, document-like appearance makes it easy to focus on the content without visual distractions.
+
+When the **Show timestamps in simple view** preference is on (`Account → Preferences → Transcript Display`), each segment is preceded by a compact `mm:ss` (or `h:mm:ss` for longer recordings) timestamp paired with the speaker label as a two-part pill. The leading segment displays "Start" instead of `00:00` to read as a label rather than a bare number. Double-clicking the pill or its row opens the ASR editor at that segment.
+
+### Bubble View
+
+The bubble view formats the transcription like a chat conversation, with each speaker's contributions in separate message bubbles. This format works particularly well for interviews, debates, or any recording with back-and-forth dialogue. The visual separation makes it easier to follow who said what in rapid exchanges.
+
+## Audio Synchronization and Follow Mode
+
+For recordings processed with [speaker diarization](../features.md#speaker-diarization), Speakr provides bidirectional synchronization between the audio player and transcript, creating an interactive reading experience.
+
+### Click-to-Play Navigation
+
+Click on any part of the transcript to jump directly to that moment in the audio. This works in both simple and bubble views, allowing you to quickly navigate to specific portions of the conversation you want to hear. Each transcript segment includes timestamp information that seamlessly syncs with the audio player.
+
+### Active Segment Highlighting
+
+As your audio plays, Speakr automatically highlights the currently spoken text in the transcript. The active segment is displayed with a prominent rounded box and subtle animation, making it effortless to follow along with the audio. This real-time highlighting works in both view modes:
+
+- **Simple View**: The current speaker segment is highlighted with rounded corners and increased padding for clear visibility
+- **Bubble View**: The active message bubble scales slightly and receives the same highlight treatment
+
+### Auto-Scroll Follow Mode
+
+Enable follow mode using the compact checkbox control in the transcript header (indicated by vertical arrows icon). When active, the transcript panel automatically scrolls to keep the currently playing segment centered in view. This is particularly useful for:
+
+- Following along during long recordings without manual scrolling
+- Reviewing specific sections while listening at different playback speeds
+- Accessibility - keeping visual and audio content synchronized
+
+Your follow mode preference is saved automatically and persists across sessions and different recordings. The feature intelligently resets when you switch between recordings, ensuring a clean slate for each playback session.
+
+### Follow Mode in Action
+
+The auto-scroll follow mode works seamlessly in both view modes and adapts to your theme preference:
+
+![Follow Mode Simple View - Dark Theme](../assets/images/screenshots/highlighted-transcript-following-simple-dark.png)
+*Auto-scroll follow mode in simple view with dark theme - transcript automatically scrolls to keep current segment visible*
+
+![Follow Mode Simple View - Light Theme](../assets/images/screenshots/highlighted-transcript-following-simple-light.png)
+*Follow mode works seamlessly in light theme, maintaining perfect readability and visual clarity*
+
+The highlighted segment uses rounded corners and subtle animations to draw your eye to the currently playing text without being distracting. The auto-scroll behavior is smooth and intelligent, maintaining the active segment in the center of your view for comfortable reading during long recordings.
+
+## Using the Summary Feature
+
+The Summary tab in the right panel contains an AI-generated overview of your recording. This summary is automatically created after transcription and captures key points, decisions, and action items.
+
+![Summary View](../assets/images/screenshots/main-view-summary-tab.png)
+
+The summary is designed to save you time by highlighting the most important information from your recording. It typically includes main topics discussed, key decisions or conclusions reached, action items and assignments, important dates or deadlines mentioned, and any significant problems or concerns raised.
+
+### Customizing Summary Prompts
+
+Speakr provides multiple levels of customization for summary generation, allowing you to tailor the AI's output to your specific needs. The summary prompt can be customized at three different levels:
+
+**Admin Level**: System administrators can set a default summary prompt that applies to all users who haven't configured their own. This is configured in the Admin Dashboard under Default Prompts and serves as the baseline for the entire system.
+
+**User Level**: Individual users can set their personal summary prompt in [Account Settings under Custom Prompts](settings.md#custom-prompts-tab). This overrides the admin default and applies to all of their recordings unless a tag-specific prompt is used.
+
+**Tag Level**: Each tag can have its own custom prompt configured. When creating or editing a tag, you can specify a summary prompt that will be used for any recording with that tag. This is particularly powerful for different types of content - for example, a "Legal Meeting" tag might focus on compliance issues and risk factors, while a "Product Planning" tag might emphasize features and timelines.
+
+### Prompt Precedence and Stacking
+
+When generating a summary, Speakr follows a clear precedence order to determine which prompt to use:
+
+1. **Tag Custom Prompts** (highest priority): If a recording has tags with custom prompts, these take precedence. When multiple tags with custom prompts are applied to a recording, Speakr intelligently combines them in the order the tags were added. This creates a sophisticated stacking effect where you can have a base tag like "Meeting" with general instructions, then add modifier tags like "Client-Facing" or "Technical Discussion" that add specific requirements. The prompts are seamlessly merged to create comprehensive instructions for the AI.
+
+2. **User Summary Prompt**: If no tag prompts are present, the system uses your personal summary prompt configured in your account settings.
+
+3. **Admin Default Prompt**: When neither tag nor user prompts are configured, the system falls back to the administrator-configured default prompt.
+
+4. **System Fallback**: If no custom prompts exist at any level, Speakr uses a built-in default that generates sections for key issues, decisions, and action items.
+
+### Summary Quality Factors
+
+The quality of your generated summaries depends on two key factors:
+
+**Prompt Design**: Well-crafted prompts that clearly specify what information you want extracted will produce more useful summaries. Consider including specific sections you want, the level of detail needed, and any particular focus areas relevant to your use case.
+
+**LLM Selection**: The AI model you use significantly impacts summary quality. More advanced models like GPT-4 or Claude will generally produce more nuanced and accurate summaries compared to smaller models. The model can be configured by your administrator in the system settings, balancing between quality and cost.
+
+### Editing and Exporting Summaries
+
+The summary is fully editable using a markdown editor similar to the one in the Notes section. Click the edit button (pencil icon) in the summary toolbar to enter edit mode. The markdown editor provides a rich editing experience with formatting tools for bold, italic, headings, lists, links, and more. You can restructure the summary, add additional insights, or refine the AI-generated content to better suit your needs. Changes are auto-saved as you type, ensuring you don't lose your edits.
+
+You can export the summary in multiple ways. The copy button copies the entire summary to your clipboard in markdown format, ready to paste into emails, documents, or other applications. The download button exports the summary as a Microsoft Word (.docx) file, preserving formatting and making it easy to share with colleagues who prefer traditional documents. The downloaded file is named using the recording title and date for easy identification.
+
+### Customise Summary Prompt at Generation Time
+
+For recordings without a summary yet, the **Generate Summary** button is paired with a small slider icon. Clicking the slider opens a Customise summary prompt modal that lets you supply one-off context (an agenda, a specific focus, additional constraints) before the first summary is generated. The modal supports two modes:
+
+**Append**: combines your saved prompt (or the resolved tag/folder/user/admin prompt) with the text you paste. Useful when you want your usual structure plus extra per-recording context. This is the default mode because most ad-hoc context is additive.
+
+**Replace**: uses only the text you paste, ignoring all higher-priority prompts for this single generation.
+
+The modal is the recommended way to add a meeting agenda or one-off instructions when you don't want to create a tag for it. If you turn off auto-summarisation in account preferences, the workflow becomes: upload, wait for transcription, click the slider next to Generate Summary, paste your context, and submit.
+
+### Reprocessing Summaries with Custom Prompts
+
+Speakr provides powerful flexibility when you need to regenerate a summary with different instructions. The summary reprocessing feature allows you to experiment with various prompts without permanently changing your recording's configuration.
+
+To reprocess a summary, click the reprocess button in the summary toolbar. This opens the reprocessing modal, which offers three distinct prompt options plus an Append/Replace mode toggle:
+
+**Use Default Prompt**: This option applies the standard prompt hierarchy based on your current settings—using tag prompts if present, falling back to your personal prompt, then the admin default, and finally the system fallback. This is useful when you want to update the summary using your standard configuration, perhaps after editing the transcription.
+
+**Use Prompt from Tag**: If you have created tags with custom summarization prompts in your account settings, you can select any of them to apply that tag's prompt to this specific regeneration—even if the recording doesn't have that tag applied. This is particularly powerful for experimentation: you might have a "Technical Deep Dive" tag with prompts focused on implementation details, a "Executive Summary" tag that emphasizes high-level decisions, or a "Client Presentation" tag that formats information for external audiences. You can try each one to see which produces the most useful summary for your current needs, all without changing the recording's actual tags.
+
+When you select a tag, a preview displays the first portion of that tag's custom prompt, helping you confirm you've chosen the right one. This preview is especially helpful when you've created multiple tags with similar names but different focuses.
+
+**Enter Custom Prompt**: For complete control, you can enter a one-time custom prompt directly in the reprocessing modal. This freeform text field lets you provide specific instructions for this single regeneration without saving the prompt anywhere. This is ideal for edge cases where you need a unique perspective on the content—perhaps "Extract all technical terms and their definitions" or "Create a summary focusing only on budget discussions" or "List all mentioned deadlines in chronological order."
+
+**Append vs Replace mode**: when a tag prompt or custom prompt is selected, you can choose whether it **Replaces** the resolved default (the historic behaviour) or is **Appended** as additional context after the resolved default. Append mode is useful when your standard prompt produces good structure but you want to nudge a specific run toward a particular focus without rewriting the whole prompt.
+
+The custom prompt option is temporary and won't affect future regenerations or other recordings. If you find yourself using the same custom prompt repeatedly, consider creating a new tag with that prompt in your account settings so you can easily reuse it.
+
+After selecting your prompt source and any additional options, the system processes only the summary—your transcription remains untouched. This means you can experiment freely with different summary approaches without any risk to your original content. The reprocessing respects your current transcription, including any manual edits you've made, and generates a fresh summary based solely on the prompt you've chosen.
+
+#### Editing Stored Prompt Variables on Reprocess
+
+If the recording was uploaded with a tag, folder, or user-default prompt that uses `{{name}}` placeholders, the values you supplied at upload time are stored on the recording and pre-filled into the reprocess modal. You can edit them before regenerating. Updated values are persisted on the recording so subsequent reprocesses (and exports referencing the variables) see the new values. See the [Prompt Variables guide](settings.md#prompt-variables) for the full feature.
+
+## Event Extraction
+
+When event extraction is enabled in your account settings, Speakr automatically identifies calendar-worthy events from your recordings during the summary generation process. This feature intelligently detects meetings, deadlines, appointments, and other time-sensitive items mentioned in your conversations.
+
+![Event Extraction](../assets/images/screenshots/event extraction.png)
+
+### Viewing Extracted Events
+
+After a recording is processed with event extraction enabled, an Events tab appears in the right panel if any events were detected. The tab shows a clean list of identified events, each displaying the event title, date, time, and description extracted from the conversation. Events are automatically parsed with intelligent date recognition that understands relative references like "next Tuesday" or "in two weeks" based on the recording date.
+
+### Exporting to Calendar
+
+Each extracted event can be exported as an ICS file that's compatible with virtually any calendar application including Google Calendar, Outlook, Apple Calendar, and Thunderbird. Simply click the download button next to any event to save it as a calendar file. The ICS file includes the event title, date and time, and a description with context from the recording. When no specific time is mentioned in the conversation, events default to 9 AM to ensure they appear prominently in your calendar.
+
+### Enabling Event Extraction
+
+Event extraction can be toggled on or off in your Account Settings under the Custom Prompts tab. When enabled, the system adds event extraction instructions to your summary prompt, asking the AI to identify calendar-worthy items during summary generation. This feature works with any LLM provider configured in your system and adapts to different conversation styles, from formal meetings to casual discussions. The quality of event extraction depends on the AI model being used, with more advanced models providing better detection of nuanced scheduling references.
+
+## Interactive Chat
+
+The Chat tab provides an AI assistant that can answer questions about your recording. This feature is particularly powerful for long recordings where finding specific information might be time-consuming.
+
+![Chat Interface](../assets/images/screenshots/chat-interface.png)
+
+### Effective Chat Queries
+
+The AI chat understands context and can answer various types of questions about your recording. You can ask for specific information like "What did Sarah say about the budget?" or "When is the deadline for the project?" The AI can also provide analysis, such as "What were the main concerns raised?" or "Summarize the action items for the marketing group."
+
+The chat maintains context throughout your conversation, so you can ask follow-up questions. For example, after asking about budget discussions, you might follow up with "What solutions were proposed?" The AI will understand you're still talking about the budget topic.
+
+### Chat Best Practices
+
+For best results with the chat feature, be specific in your questions rather than asking overly broad queries. Reference specific topics, people, or timeframes when possible. If the AI's response isn't quite what you're looking for, try rephrasing your question with more context.
+
+The chat feature works best for factual questions about what was said in the recording. It's less effective for subjective interpretations or reading between the lines, though it can identify tone and sentiment to some degree.
+
+### Exporting Chat Conversations
+
+Your entire chat conversation can be exported for future reference or sharing. The chat interface provides two export options:
+
+**Copy to Clipboard**: Click the copy button to copy the entire chat conversation to your clipboard. This preserves the question-and-answer format, making it easy to paste into emails, reports, or documentation. Each message includes a label indicating whether it's from you or the AI assistant.
+
+**Download as Word Document**: The download button exports your complete chat history as a formatted Microsoft Word (.docx) file. This includes all questions and responses in a clean, professional format that's easy to share with group members or include in reports. The file is automatically named with the recording title and export date, making it easy to organize multiple chat exports.
+
+These export features are particularly useful when you've used the chat to extract specific insights or conduct a detailed analysis of the recording, allowing you to preserve and share your findings without having to recreate the conversation.
+
+## Adding and Managing Notes
+
+The Notes tab is your personal workspace for adding context and thoughts about the recording. These notes are **always private** - only you can see them, whether you own the recording or it's been shared with you. This is different from summaries, which are shared with all users who have access to the recording.
+
+**Important: Notes are Personal, Summaries are Shared**
+
+- **Notes**: Always private to each user. You can add and edit your own notes on any recording (owned or shared) without needing any special permissions. Other users cannot see your notes, and you cannot see theirs.
+- **Summary**: Shared content created by the recording owner. Only users with edit permission can modify the summary, and all users with access to the recording see the same summary.
+
+![Notes Tab](../assets/images/screenshots/main-view-notes-tab.png)
+
+Notes support full markdown formatting, allowing you to create structured documents with headers, lists, links, and emphasis. The markdown editor provides a toolbar with formatting options and supports keyboard shortcuts for efficient note-taking. You can switch between edit and preview modes to see how your formatted notes will appear.
+
+Common uses for notes include:
+
+- Personal reflections on the meeting or conversation that you want to keep private
+- Follow-up tasks that you need to complete based on the discussion
+- Additional context about decisions made or why certain topics were discussed
+- Links to related documents or resources mentioned in the recording
+- Questions you want to research or clarify later
+
+Your notes are fully searchable alongside transcriptions, making them valuable for future reference. You can search for a specific term and find it whether it appears in a transcription or in your personal notes. The search will only find results in your own personal notes - you cannot search through other users' notes on shared recordings since notes are always private. Notes are auto-saved as you type, ensuring you never lose your thoughts.
+
+When viewing a shared recording, you can always add and edit your own notes without needing any special permissions. This allows you to annotate shared content with your own thoughts, action items, and follow-ups while keeping them completely private from the recording owner and other users.
+
+## Copying and Exporting
+
+The Copy button in the transcription toolbar copies the entire transcription to your clipboard in plain text format. This maintains paragraph structure, making it easy to paste into documents or emails.
+
+### Downloading Transcriptions
+
+Next to the Copy button, you'll find the Download button that offers flexible export options through customizable templates. When you click Download, a popup appears allowing you to select from your saved [transcript templates](transcript-templates.md) or export the raw transcript without formatting. Templates let you control exactly how your transcript is formatted, whether you need timestamps for subtitles, speaker-focused formats for interviews, or screenplay-style formatting. You can create and manage these templates in your account settings.
+
+If your recording was processed with ASR and speaker diarization, the exported text will include speaker identifiers (either the generic labels like SPEAKER_01 or the actual names if you've identified them). For recordings without speaker diarization, the transcription is exported as continuous text. The format remains consistent regardless of whether you're viewing the transcription in simple or bubble view - the exported text uses the structured format from the underlying data, formatted according to your chosen template.
+
+## Next Steps
+
+Now that you understand how to work with transcriptions, let's explore Speakr's powerful search capabilities with Inquire Mode, which allows you to search across all your recordings using natural language.
+
+---
+
+Next: [Inquire Mode - Semantic Search](inquire-mode.md) →
\ No newline at end of file
diff --git a/migrate_db.py b/migrate_db.py
deleted file mode 100644
index baf5db00..00000000
--- a/migrate_db.py
+++ /dev/null
@@ -1,120 +0,0 @@
-#!/usr/bin/env python3
-
-import os
-import sys
-from sqlalchemy import inspect, Column, Integer, ForeignKey
-from sqlalchemy.exc import OperationalError
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, User, Recording
-    except ImportError as e:
-        print(f"Error: Could not import 'app' and 'db': {e}")
-        print("Make sure migrate_db.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_database():
-    """
-    Migrate the database schema without losing data:
-    1. Check if User table exists, create it if not
-    2. Check if Recording.user_id column exists, add it if not
-    """
-    print("Starting database migration...")
-    
-    with app.app_context():
-        inspector = inspect(db.engine)
-        existing_tables = inspector.get_table_names()
-        
-        # Check if User table exists
-        if 'user' not in existing_tables:
-            print("Creating User table...")
-            # Create User table
-            class TempUser(db.Model):
-                __tablename__ = 'user'
-                id = db.Column(db.Integer, primary_key=True)
-                username = db.Column(db.String(20), unique=True, nullable=False)
-                email = db.Column(db.String(120), unique=True, nullable=False)
-                password = db.Column(db.String(60), nullable=False)
-            
-            # Create only the User table
-            db.create_all(tables=[TempUser.__table__])
-            print("User table created successfully!")
-        else:
-            print("User table already exists.")
-        
-        # Check if Recording.user_id column exists
-        recording_columns = [column['name'] for column in inspector.get_columns('recording')]
-        if 'user_id' not in recording_columns:
-            print("Adding user_id column to Recording table...")
-            try:
-                # Add user_id column to Recording table
-                with db.engine.begin() as conn:
-                    conn.execute(db.text("ALTER TABLE recording ADD COLUMN user_id INTEGER REFERENCES user(id)"))
-                print("user_id column added successfully!")
-            except OperationalError as e:
-                print(f"Error adding user_id column: {e}")
-                print("Attempting alternative approach...")
-                try:
-                    # SQLite doesn't support ALTER TABLE ADD COLUMN with foreign keys
-                    # So we need to create a new table, copy data, drop old table, rename new table
-                    
-                    # 1. Create temporary table with new schema
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            CREATE TABLE recording_new (
-                                id INTEGER PRIMARY KEY,
-                                title VARCHAR(200),
-                                participants VARCHAR(500),
-                                notes TEXT,
-                                transcription TEXT,
-                                summary TEXT,
-                                status VARCHAR(50),
-                                audio_path VARCHAR(500),
-                                created_at DATETIME,
-                                meeting_date DATE,
-                                file_size INTEGER,
-                                user_id INTEGER REFERENCES user(id)
-                            )
-                        """))
-                    
-                    # 2. Copy data from old table to new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            INSERT INTO recording_new (
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size
-                            )
-                            SELECT 
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size
-                            FROM recording
-                        """))
-                    
-                    # 3. Drop old table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("DROP TABLE recording"))
-                    
-                    # 4. Rename new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("ALTER TABLE recording_new RENAME TO recording"))
-                    
-                    print("user_id column added successfully using table recreation!")
-                except Exception as e2:
-                    print(f"Error during table recreation: {e2}")
-                    sys.exit(1)
-        else:
-            print("user_id column already exists in Recording table.")
-        
-        print("Database migration completed successfully!")
-
-if __name__ == "__main__":
-    print("Attempting to migrate the database...")
-    migrate_database()
-    print("Database migration process finished.")
diff --git a/migrate_is_admin.py b/migrate_is_admin.py
deleted file mode 100644
index 7ecadaef..00000000
--- a/migrate_is_admin.py
+++ /dev/null
@@ -1,54 +0,0 @@
-#!/usr/bin/env python3
-
-import os
-import sys
-from flask import Flask
-from flask_sqlalchemy import SQLAlchemy
-from sqlalchemy import Column, Boolean
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-        User = app.extensions['sqlalchemy'].db.metadata.tables['user']
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, User
-    except ImportError as e:
-        print(f"Error: Could not import required modules: {e}")
-        print("Make sure migrate_is_admin.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_is_admin_field():
-    """
-    Add is_admin field to User model if it doesn't exist
-    """
-    print("Migrating database to add is_admin field to User model")
-    print("=====================================================")
-    
-    with app.app_context():
-        # Check if is_admin column exists
-        inspector = db.inspect(db.engine)
-        columns = [column['name'] for column in inspector.get_columns('user')]
-        
-        if 'is_admin' in columns:
-            print("is_admin column already exists in User table.")
-            return
-        
-        # Add is_admin column
-        print("Adding is_admin column to User table...")
-        try:
-            db.engine.execute('ALTER TABLE user ADD COLUMN is_admin BOOLEAN DEFAULT 0')
-            print("Column added successfully.")
-        except Exception as e:
-            print(f"Error adding column: {e}")
-            sys.exit(1)
-        
-        print("\nMigration completed successfully!")
-        print("You can now use the create_admin.py script to create admin users.")
-
-if __name__ == "__main__":
-    migrate_is_admin_field()
diff --git a/migrate_original_filename.py b/migrate_original_filename.py
deleted file mode 100644
index acb29499..00000000
--- a/migrate_original_filename.py
+++ /dev/null
@@ -1,101 +0,0 @@
-#!/usr/bin/env python3
-
-import os
-import sys
-from sqlalchemy import inspect
-from sqlalchemy.exc import OperationalError
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, Recording
-    except ImportError as e:
-        print(f"Error: Could not import 'app' and 'db': {e}")
-        print("Make sure migrate_original_filename.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_database():
-    """
-    Migrate the database schema to add original_filename column without losing data
-    """
-    print("Starting database migration for original_filename column...")
-    
-    with app.app_context():
-        inspector = inspect(db.engine)
-        
-        # Check if Recording.original_filename column exists
-        recording_columns = [column['name'] for column in inspector.get_columns('recording')]
-        if 'original_filename' not in recording_columns:
-            print("Adding original_filename column to Recording table...")
-            try:
-                # Add original_filename column to Recording table
-                with db.engine.begin() as conn:
-                    conn.execute(db.text("ALTER TABLE recording ADD COLUMN original_filename VARCHAR(500)"))
-                print("original_filename column added successfully!")
-            except OperationalError as e:
-                print(f"Error adding original_filename column: {e}")
-                print("Attempting alternative approach...")
-                try:
-                    # SQLite doesn't support ALTER TABLE ADD COLUMN with foreign keys
-                    # So we need to create a new table, copy data, drop old table, rename new table
-                    
-                    # 1. Create temporary table with new schema
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            CREATE TABLE recording_new (
-                                id INTEGER PRIMARY KEY,
-                                title VARCHAR(200),
-                                participants VARCHAR(500),
-                                notes TEXT,
-                                transcription TEXT,
-                                summary TEXT,
-                                status VARCHAR(50),
-                                audio_path VARCHAR(500),
-                                created_at DATETIME,
-                                meeting_date DATE,
-                                file_size INTEGER,
-                                user_id INTEGER REFERENCES user(id),
-                                original_filename VARCHAR(500)
-                            )
-                        """))
-                    
-                    # 2. Copy data from old table to new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            INSERT INTO recording_new (
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size, user_id
-                            )
-                            SELECT 
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size, user_id
-                            FROM recording
-                        """))
-                    
-                    # 3. Drop old table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("DROP TABLE recording"))
-                    
-                    # 4. Rename new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("ALTER TABLE recording_new RENAME TO recording"))
-                    
-                    print("original_filename column added successfully using table recreation!")
-                except Exception as e2:
-                    print(f"Error during table recreation: {e2}")
-                    sys.exit(1)
-        else:
-            print("original_filename column already exists in Recording table.")
-        
-        print("Database migration completed successfully!")
-
-if __name__ == "__main__":
-    print("Attempting to migrate the database to add original_filename column...")
-    migrate_database()
-    print("Database migration process finished.")
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 00000000..af748c8b
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,183 @@
+site_name: Speakr
+site_description: AI-Powered Audio Transcription & Note-Taking Platform
+site_url: https://speakr.yourdomain.com
+repo_url: https://github.com/murtaza-nasir/speakr
+repo_name: speakr
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  logo: assets/images/speakr-logo.png
+  favicon: assets/images/speakr-logo.png
+  palette:
+    # Light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  
+  features:
+    - navigation.instant
+    - navigation.instant.progress
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.sections
+    - navigation.expand
+    - navigation.path
+    - navigation.indexes
+    - navigation.top
+    - navigation.footer
+    - toc.follow
+    - toc.integrate
+    - search.suggest
+    - search.highlight
+    - search.share
+    - header.autohide
+    - content.action.edit
+    - content.action.view
+    - content.code.copy
+    - content.code.annotate
+    - content.tooltips
+
+plugins:
+  - search:
+      separator: '[\s\-\.\_]+'
+      lang:
+        - en
+  - minify:
+      minify_html: true
+      minify_js: true
+      minify_css: true
+      htmlmin_opts:
+        remove_comments: true
+  - git-revision-date-localized:
+      enable_creation_date: true
+      type: iso_date
+      enabled: !ENV [CI, false]  # Only enable in CI/production
+
+markdown_extensions:
+  # Python Markdown
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - meta
+  - tables
+  - toc:
+      permalink: true
+      title: On this page
+  
+  # Python Markdown Extensions
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.critic
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.snippets:
+      auto_append:
+        - includes/abbreviations.md
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+      combine_header_slug: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/murtaza-nasir/speakr
+    - icon: fontawesome/brands/docker
+      link: https://hub.docker.com/r/learnedmachine/speakr
+  
+  analytics:
+    provider: google
+    property: G-XXXXXXXXXX
+    feedback:
+      title: Was this page helpful?
+      ratings:
+        - icon: material/emoticon-happy-outline
+          name: This page was helpful
+          data: 1
+          note: Thanks for your feedback!
+        - icon: material/emoticon-sad-outline
+          name: This page could be improved
+          data: 0
+          note: Thanks for your feedback!
+
+extra_css:
+  - stylesheets/extra.css
+
+extra_javascript:
+  - javascripts/extra.js
+
+exclude_docs: |
+  README.md
+  DOCUMENTATION_VERIFICATION_CHECKLIST.md
+  ci-cd-setup.md
+  .github-deploy.yml
+
+nav:
+  - Home:
+    - index.md
+    - Screenshots: screenshots.md
+    - Features: features.md
+  - Getting Started: getting-started.md
+  - Installation: getting-started/installation.md
+  
+  - User Guide:
+    - user-guide/index.md
+    - First Steps: user-guide/first-steps.md
+    - Recording Audio: user-guide/recording.md
+    - Understanding Transcripts: user-guide/transcripts.md
+    - Transcript Templates: user-guide/transcript-templates.md
+    - Inquire Mode: user-guide/inquire-mode.md
+    - Sharing Recordings: user-guide/sharing.md
+    - Folders: user-guide/folders.md
+    - Account Settings: user-guide/settings.md
+    - API Tokens: user-guide/api-tokens.md
+    - API Reference: user-guide/api-reference.md
+    
+  - Admin Guide:
+    - admin-guide/index.md
+    - User Management: admin-guide/user-management.md
+    - System Statistics: admin-guide/statistics.md
+    - System Settings: admin-guide/system-settings.md
+    - Default Prompts: admin-guide/prompts.md
+    - Vector Store: admin-guide/vector-store.md
+    - Migration Guide: admin-guide/migration-guide.md
+  
+  - Troubleshooting: troubleshooting.md
+  - FAQ: faq.md
\ No newline at end of file
diff --git a/notes.md b/notes.md
deleted file mode 100644
index 795ff947..00000000
--- a/notes.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## Create flat file:
-
-python create_docs.py
-
-## start/stop
-
-source venv/bin/activate
-gunicorn --workers 3 --bind 0.0.0.0:8899 --timeout 600 app:app
-
-## logs
-sudo journalctl -u transcription.service -n 100 --no-pager
\ No newline at end of file
diff --git a/package.json b/package.json
new file mode 100644
index 00000000..eb7d12d9
--- /dev/null
+++ b/package.json
@@ -0,0 +1,14 @@
+{
+  "name": "speakr-frontend-tests",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "description": "Frontend unit tests for Speakr. Pure-helper modules in static/js/modules/utils are tested with Vitest. Vue components are still rendered server-side by Flask and Vue is loaded from CDN at runtime, so this package.json exists only to host dev-time test tooling.",
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0"
+  }
+}
diff --git a/project_files.md b/project_files.md
deleted file mode 100644
index 0bbee7e1..00000000
--- a/project_files.md
+++ /dev/null
@@ -1,5080 +0,0 @@
-# Project Files
-
-Generated documentation of all project files.
-
-
-## migrate_is_admin.py
-
-```python
-
-#!/usr/bin/env python3
-
-import os
-import sys
-from flask import Flask
-from flask_sqlalchemy import SQLAlchemy
-from sqlalchemy import Column, Boolean
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-        User = app.extensions['sqlalchemy'].db.metadata.tables['user']
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, User
-    except ImportError as e:
-        print(f"Error: Could not import required modules: {e}")
-        print("Make sure migrate_is_admin.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_is_admin_field():
-    """
-    Add is_admin field to User model if it doesn't exist
-    """
-    print("Migrating database to add is_admin field to User model")
-    print("=====================================================")
-    
-    with app.app_context():
-        # Check if is_admin column exists
-        inspector = db.inspect(db.engine)
-        columns = [column['name'] for column in inspector.get_columns('user')]
-        
-        if 'is_admin' in columns:
-            print("is_admin column already exists in User table.")
-            return
-        
-        # Add is_admin column
-        print("Adding is_admin column to User table...")
-        try:
-            db.engine.execute('ALTER TABLE user ADD COLUMN is_admin BOOLEAN DEFAULT 0')
-            print("Column added successfully.")
-        except Exception as e:
-            print(f"Error adding column: {e}")
-            sys.exit(1)
-        
-        print("\nMigration completed successfully!")
-        print("You can now use the create_admin.py script to create admin users.")
-
-if __name__ == "__main__":
-    migrate_is_admin_field()
-
-```
-
-
-## reset_db.py
-
-```python
-
-#!/usr/bin/env python3
-
-# Add this near the top if you run this standalone often outside app context
-import os
-import sys
-import shutil
-# Add project root to path if necessary for 'app' import
-# sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
-
-# Load environment variables in case DB path relies on them (optional here)
-# from dotenv import load_dotenv
-# load_dotenv()
-
-# Check if running within app context already (e.g., via Flask command)
-try:
-    from flask import current_app
-    # Ensure app context is pushed if needed for config access
-    app = current_app._get_current_object()
-    # Make sure db is initialized within the app context if needed
-    # (SQLAlchemy initialization in app.py handles this mostly)
-    with app.app_context():
-      db = app.extensions['sqlalchemy'].db # Access db via extensions
-except (RuntimeError, AttributeError, KeyError):
-     # If not in app context, import directly
-    try:
-        # Ensure this import reflects the updated app.py with the new model
-        from app import app, db
-    except ImportError as e:
-        print(f"Error: Could not import 'app' and 'db': {e}")
-        print("Make sure reset_db.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def reset_database(delete_uploads=True):
-    # Determine the database path relative to the instance folder
-    # Use app config if available
-    instance_path = app.instance_path if hasattr(app, 'instance_path') else os.path.join(os.getcwd(), 'instance')
-    try:
-        # Ensure app context for config access if not already present
-        with app.app_context():
-             # Use absolute path from config
-             db_uri = app.config.get('SQLALCHEMY_DATABASE_URI', 'sqlite:///instance/transcriptions.db')
-             # Handle relative vs absolute paths specified in URI
-             if db_uri.startswith('sqlite:///'):
-                 # Assume absolute path from URI root if starts with '///'
-                 db_path = db_uri.replace('sqlite:///', '/', 1) # Replace only first
-                 # Ensure instance path reflects the directory containing the DB
-                 instance_path = os.path.dirname(db_path)
-             elif db_uri.startswith('sqlite://'):
-                 # Assume relative path from instance folder
-                 db_filename = db_uri.split('/')[-1]
-                 db_path = os.path.join(instance_path, db_filename)
-             else: # Handle other DB types or formats if needed
-                 print(f"Warning: Non-SQLite URI detected: {db_uri}. Deletion logic might need adjustment.")
-                 # Attempt to parse or fallback
-                 db_filename = db_uri.split('/')[-1] # Best guess
-                 db_path = os.path.join(instance_path, db_filename)
-
-    except Exception as config_e:
-        print(f"Error accessing app config for DB path: {config_e}. Using default.")
-        # Fallback if config access fails
-        instance_path = os.path.join(os.getcwd(), 'instance')
-        db_filename = 'transcriptions.db'
-        db_path = os.path.join(instance_path, db_filename)
-
-    # Ensure instance directory exists
-    print(f"Ensuring instance directory exists: {instance_path}")
-    os.makedirs(instance_path, exist_ok=True)
-    print(f"Database path identified as: {db_path}")
-
-    # Remove existing database if it exists
-    if os.path.exists(db_path):
-        print(f"Removing existing database at {db_path}")
-        try:
-            os.remove(db_path)
-            # Also remove journal file if it exists
-            journal_path = db_path + "-journal"
-            if os.path.exists(journal_path):
-                os.remove(journal_path)
-                print(f"Removing existing journal file at {journal_path}")
-        except OSError as e:
-            print(f"Error removing database file: {e}. Check permissions or if it's in use.")
-            # Decide whether to exit or continue
-            # sys.exit(1)
-
-    # Create application context to work with the database
-    try:
-        with app.app_context():
-            print("Creating new database schema (including 'summary' column)...")
-            # Create all tables defined in models (app.py)
-            db.create_all()
-            print("Database schema created successfully!")
-    except Exception as e:
-        print(f"Error creating database schema: {e}")
-        # Attempt rollback if possible (though less relevant for create_all)
-        try:
-             db.session.rollback()
-        except Exception as rb_e:
-             print(f"Rollback attempt failed: {rb_e}")
-        sys.exit(1)
-        
-    # Delete all files in the uploads directory if requested
-    if delete_uploads:
-        try:
-            uploads_dir = os.path.join(os.getcwd(), 'uploads')
-            if os.path.exists(uploads_dir):
-                print(f"Deleting all files in uploads directory: {uploads_dir}")
-                for filename in os.listdir(uploads_dir):
-                    file_path = os.path.join(uploads_dir, filename)
-                    try:
-                        if os.path.isfile(file_path):
-                            os.remove(file_path)
-                            print(f"Deleted file: {file_path}")
-                        elif os.path.isdir(file_path):
-                            shutil.rmtree(file_path)
-                            print(f"Deleted directory: {file_path}")
-                    except Exception as e:
-                        print(f"Error deleting {file_path}: {e}")
-                print("All files in uploads directory have been deleted.")
-            else:
-                print(f"Uploads directory not found: {uploads_dir}")
-                # Create the directory if it doesn't exist
-                os.makedirs(uploads_dir, exist_ok=True)
-                print(f"Created uploads directory: {uploads_dir}")
-        except Exception as e:
-            print(f"Error cleaning uploads directory: {e}")
-
-if __name__ == "__main__":
-    print("Attempting to reset the database and clean up all data...")
-    reset_database(delete_uploads=True)
-    print("Database reset process finished.")
-
-```
-
-
-## migrate_original_filename.py
-
-```python
-
-#!/usr/bin/env python3
-
-import os
-import sys
-from sqlalchemy import inspect
-from sqlalchemy.exc import OperationalError
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, Recording
-    except ImportError as e:
-        print(f"Error: Could not import 'app' and 'db': {e}")
-        print("Make sure migrate_original_filename.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_database():
-    """
-    Migrate the database schema to add original_filename column without losing data
-    """
-    print("Starting database migration for original_filename column...")
-    
-    with app.app_context():
-        inspector = inspect(db.engine)
-        
-        # Check if Recording.original_filename column exists
-        recording_columns = [column['name'] for column in inspector.get_columns('recording')]
-        if 'original_filename' not in recording_columns:
-            print("Adding original_filename column to Recording table...")
-            try:
-                # Add original_filename column to Recording table
-                with db.engine.begin() as conn:
-                    conn.execute(db.text("ALTER TABLE recording ADD COLUMN original_filename VARCHAR(500)"))
-                print("original_filename column added successfully!")
-            except OperationalError as e:
-                print(f"Error adding original_filename column: {e}")
-                print("Attempting alternative approach...")
-                try:
-                    # SQLite doesn't support ALTER TABLE ADD COLUMN with foreign keys
-                    # So we need to create a new table, copy data, drop old table, rename new table
-                    
-                    # 1. Create temporary table with new schema
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            CREATE TABLE recording_new (
-                                id INTEGER PRIMARY KEY,
-                                title VARCHAR(200),
-                                participants VARCHAR(500),
-                                notes TEXT,
-                                transcription TEXT,
-                                summary TEXT,
-                                status VARCHAR(50),
-                                audio_path VARCHAR(500),
-                                created_at DATETIME,
-                                meeting_date DATE,
-                                file_size INTEGER,
-                                user_id INTEGER REFERENCES user(id),
-                                original_filename VARCHAR(500)
-                            )
-                        """))
-                    
-                    # 2. Copy data from old table to new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            INSERT INTO recording_new (
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size, user_id
-                            )
-                            SELECT 
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size, user_id
-                            FROM recording
-                        """))
-                    
-                    # 3. Drop old table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("DROP TABLE recording"))
-                    
-                    # 4. Rename new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("ALTER TABLE recording_new RENAME TO recording"))
-                    
-                    print("original_filename column added successfully using table recreation!")
-                except Exception as e2:
-                    print(f"Error during table recreation: {e2}")
-                    sys.exit(1)
-        else:
-            print("original_filename column already exists in Recording table.")
-        
-        print("Database migration completed successfully!")
-
-if __name__ == "__main__":
-    print("Attempting to migrate the database to add original_filename column...")
-    migrate_database()
-    print("Database migration process finished.")
-
-```
-
-
-## create_admin.py
-
-```python
-
-#!/usr/bin/env python3
-
-import os
-import sys
-import getpass
-from email_validator import validate_email, EmailNotValidError
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-        User = app.extensions['sqlalchemy'].db.metadata.tables['user']
-        bcrypt = app.extensions.get('bcrypt')
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, User, bcrypt
-    except ImportError as e:
-        print(f"Error: Could not import required modules: {e}")
-        print("Make sure create_admin.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def create_admin_user():
-    """
-    Create an admin user interactively.
-    """
-    print("Creating admin user for Speakr application")
-    print("=========================================")
-    
-    # Get username
-    while True:
-        username = input("Enter username (min 3 characters): ").strip()
-        if len(username) < 3:
-            print("Username must be at least 3 characters long.")
-            continue
-        
-        # Check if username already exists
-        with app.app_context():
-            existing_user = db.session.query(User).filter_by(username=username).first()
-            if existing_user:
-                print(f"Username '{username}' already exists. Please choose another.")
-                continue
-            break
-    
-    # Get email
-    while True:
-        email = input("Enter email address: ").strip()
-        try:
-            # Validate email
-            validate_email(email)
-            
-            # Check if email already exists
-            with app.app_context():
-                existing_email = db.session.query(User).filter_by(email=email).first()
-                if existing_email:
-                    print(f"Email '{email}' already exists. Please use another.")
-                    continue
-                break
-        except EmailNotValidError as e:
-            print(f"Invalid email: {str(e)}")
-    
-    # Get password
-    while True:
-        password = getpass.getpass("Enter password (min 8 characters): ")
-        if len(password) < 8:
-            print("Password must be at least 8 characters long.")
-            continue
-        
-        confirm_password = getpass.getpass("Confirm password: ")
-        if password != confirm_password:
-            print("Passwords do not match. Please try again.")
-            continue
-        break
-    
-    # Create user
-    with app.app_context():
-        hashed_password = bcrypt.generate_password_hash(password).decode('utf-8')
-        new_user = User(username=username, email=email, password=hashed_password, is_admin=True)
-        db.session.add(new_user)
-        db.session.commit()
-        
-        print("\nAdmin user created successfully!")
-        print(f"Username: {username}")
-        print(f"Email: {email}")
-        print("You can now log in to the application with these credentials.")
-
-if __name__ == "__main__":
-    create_admin_user()
-
-```
-
-
-## app.py
-
-```python
-
-# Speakr - Audio Transcription and Summarization App
-import os
-import sys
-from flask import Flask, render_template, request, jsonify, send_file, Markup, redirect, url_for, flash
-from flask_sqlalchemy import SQLAlchemy
-from datetime import datetime
-from openai import OpenAI # Keep using the OpenAI library
-import json
-from werkzeug.utils import secure_filename
-from werkzeug.exceptions import RequestEntityTooLarge
-from sqlalchemy import select
-import threading
-from dotenv import load_dotenv # Import load_dotenv
-import httpx 
-import re
-import markdown
-from flask_login import LoginManager, UserMixin, login_user, logout_user, login_required, current_user
-from flask_bcrypt import Bcrypt
-from flask_wtf import FlaskForm
-from wtforms import StringField, PasswordField, SubmitField, BooleanField
-from wtforms.validators import DataRequired, Length, Email, EqualTo, ValidationError
-
-# Load environment variables from .env file
-load_dotenv()
-
-# Initialize Flask-Bcrypt
-bcrypt = Bcrypt()
-
-# Helper function to convert markdown to HTML
-def md_to_html(text):
-    if not text:
-        return ""
-    # Convert markdown to HTML with extensions for tables, code highlighting, etc.
-    html = markdown.markdown(text, extensions=[
-        'tables',           # Support for tables
-        'fenced_code',      # Support for ```code blocks```
-        'codehilite',       # Syntax highlighting for code blocks
-        'nl2br',            # Convert newlines to <br> tags
-        'sane_lists',       # Better list handling
-        'smarty'            # Smart quotes, dashes, etc.
-    ])
-    return html
-
-app = Flask(__name__)
-# Ensure the path uses the directory structure from your setup script
-app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////opt/transcription-app/instance/transcriptions.db'
-app.config['UPLOAD_FOLDER'] = '/opt/transcription-app/uploads' # Use absolute path based on setup
-app.config['MAX_CONTENT_LENGTH'] = 250 * 1024 * 1024  # 250MB max file size
-# Set a secret key for session management and CSRF protection
-app.config['SECRET_KEY'] = os.environ.get('SECRET_KEY', 'default-dev-key-change-in-production')
-db = SQLAlchemy()
-db.init_app(app)
-
-# Initialize Flask-Login
-login_manager = LoginManager()
-login_manager.init_app(app)
-login_manager.login_view = 'login'
-login_manager.login_message_category = 'info'
-bcrypt.init_app(app)
-
-# Add context processor to make 'now' available to all templates
-@app.context_processor
-def inject_now():
-    return {'now': datetime.now()}
-
-# Ensure upload and instance directories exist
-os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
-# Assuming the instance folder is handled correctly by Flask or created by setup.sh
-# os.makedirs(os.path.dirname(app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '/')), exist_ok=True)
-
-
-# --- User loader for Flask-Login ---
-@login_manager.user_loader
-def load_user(user_id):
-    return db.session.get(User, int(user_id))
-
-# --- Database Models ---
-class User(db.Model, UserMixin):
-    id = db.Column(db.Integer, primary_key=True)
-    username = db.Column(db.String(20), unique=True, nullable=False)
-    email = db.Column(db.String(120), unique=True, nullable=False)
-    password = db.Column(db.String(60), nullable=False)
-    is_admin = db.Column(db.Boolean, default=False)
-    recordings = db.relationship('Recording', backref='owner', lazy=True)
-    
-    def __repr__(self):
-        return f"User('{self.username}', '{self.email}')"
-class Recording(db.Model):
-    # Add user_id foreign key to associate recordings with users
-    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=True)
-    id = db.Column(db.Integer, primary_key=True)
-    # Title will now often be AI-generated, maybe start with filename?
-    title = db.Column(db.String(200), nullable=True) # Allow Null initially
-    participants = db.Column(db.String(500))
-    notes = db.Column(db.Text)
-    transcription = db.Column(db.Text, nullable=True)
-    summary = db.Column(db.Text, nullable=True) # <-- ADDED: Summary field
-    status = db.Column(db.String(50), default='PENDING') # PENDING, PROCESSING, SUMMARIZING, COMPLETED, FAILED
-    audio_path = db.Column(db.String(500))
-    created_at = db.Column(db.DateTime, default=datetime.utcnow)
-    meeting_date = db.Column(db.Date, nullable=True) # <-- ADDED: Meeting Date field
-    file_size = db.Column(db.Integer)  # Store file size in bytes
-    original_filename = db.Column(db.String(500), nullable=True) # Store the original uploaded filename
-
-    def to_dict(self):
-        return {
-            'id': self.id,
-            'title': self.title,
-            'participants': self.participants,
-            'notes': self.notes,
-            'notes_html': md_to_html(self.notes) if self.notes else "",
-            'transcription': self.transcription,
-            'summary': self.summary,
-            'summary_html': md_to_html(self.summary) if self.summary else "",
-            'status': self.status,
-            'created_at': self.created_at.isoformat() if self.created_at else None,
-            'meeting_date': self.meeting_date.isoformat() if self.meeting_date else None, # <-- ADDED: Include meeting_date
-            'file_size': self.file_size,
-            'original_filename': self.original_filename, # <-- ADDED: Include original filename
-            'user_id': self.user_id
-        }
-
-# --- Forms for Authentication ---
-class RegistrationForm(FlaskForm):
-    username = StringField('Username', validators=[DataRequired(), Length(min=2, max=20)])
-    email = StringField('Email', validators=[DataRequired(), Email()])
-    password = PasswordField('Password', validators=[DataRequired(), Length(min=8)])
-    confirm_password = PasswordField('Confirm Password', validators=[DataRequired(), EqualTo('password')])
-    submit = SubmitField('Sign Up')
-    
-    def validate_username(self, username):
-        user = User.query.filter_by(username=username.data).first()
-        if user:
-            raise ValidationError('That username is already taken. Please choose a different one.')
-    
-    def validate_email(self, email):
-        user = User.query.filter_by(email=email.data).first()
-        if user:
-            raise ValidationError('That email is already registered. Please use a different one.')
-
-class LoginForm(FlaskForm):
-    email = StringField('Email', validators=[DataRequired(), Email()])
-    password = PasswordField('Password', validators=[DataRequired()])
-    remember = BooleanField('Remember Me')
-    submit = SubmitField('Login')
-
-with app.app_context():
-    db.create_all()
-
-# --- API client setup for OpenRouter ---
-# Use environment variables from .env
-openrouter_api_key = os.environ.get("OPENROUTER_API_KEY")
-openrouter_base_url = os.environ.get("OPENROUTER_BASE_URL", "https://openrouter.ai/api/v1")
-openrouter_model_name = os.environ.get("OPENROUTER_MODEL_NAME", "openai/gpt-3.5-turbo") # Default if not set
-
-http_client_no_proxy = httpx.Client(verify=True) # verify=True is default, but good to be explicit
-
-if not openrouter_api_key:
-    app.logger.warning("OPENROUTER_API_KEY not found. Title/Summary generation DISABLED.")
-else:
-    try:
-        # ---> Pass the custom httpx_client <---
-        client = OpenAI(
-            api_key=openrouter_api_key,
-            base_url=openrouter_base_url,
-            http_client=http_client_no_proxy # Pass the proxy-disabled client
-        )
-        app.logger.info(f"OpenRouter client initialized. Using model: {openrouter_model_name}")
-    except Exception as client_init_e:
-         app.logger.error(f"Failed to initialize OpenRouter client: {client_init_e}", exc_info=True)
-
-# Store details for the transcription client (potentially different)
-transcription_api_key = os.environ.get("OPENAI_API_KEY", "cant-be-empty")
-transcription_base_url = os.environ.get("OPENAI_BASE_URL", "http://192.168.68.85:1611/v1/")
-
-app.logger.info(f"Using OpenRouter model for summaries: {openrouter_model_name}")
-
-# --- Background Transcription & Summarization Task ---
-def transcribe_audio_task(app_context, recording_id, filepath, original_filename):
-    """Runs the transcription and summarization in a background thread."""
-    with app_context: # Need app context for db operations in thread
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            app.logger.error(f"Error: Recording {recording_id} not found for transcription.")
-            return
-
-        try:
-            app.logger.info(f"Starting transcription for recording {recording_id} ({original_filename})...")
-            recording.status = 'PROCESSING'
-            db.session.commit()
-
-            # --- Step 1: Transcription ---
-            with open(filepath, 'rb') as audio_file:
-                # NOTE: This still uses the hardcoded Whisper model.
-                # If you want OpenRouter for transcription too, change the model here
-                # and potentially adjust the API call if needed.
-                # For now, assuming Whisper via a local compatible endpoint.
-                # You might need a *separate* client for Whisper if it's at a different URL.
-                # Example using the configured client (assuming it points to Whisper or OpenRouter handles it):
-                transcription_client = OpenAI(
-                    api_key=transcription_api_key,
-                    base_url=transcription_base_url,
-                    http_client=http_client_no_proxy # Reuse the same client configuration
-                )
-                transcript = transcription_client.audio.transcriptions.create(
-                    model="Systran/faster-distil-whisper-large-v3", # Your Whisper model
-                    file=audio_file,
-                    language="en" # Specify language if known
-                )
-            recording.transcription = transcript.text
-            app.logger.info(f"Transcription completed for recording {recording_id}. Text length: {len(recording.transcription)}")
-            # Don't commit yet, proceed to summarization
-
-            # --- Step 2: Title & Summary Generation using OpenRouter ---
-            if client is None: # Check if OpenRouter client initialized successfully earlier
-                app.logger.warning(f"Skipping summary for {recording_id}: OpenRouter client not configured.")
-                recording.summary = "[Summary skipped: OpenRouter client not configured]"
-                recording.status = 'COMPLETED'
-                db.session.commit()
-                return # Exit cleanly
-            
-            recording.status = 'SUMMARIZING' # Update status
-            db.session.commit()
-            app.logger.info(f"Requesting title and summary from OpenRouter for recording {recording_id} using model {openrouter_model_name}...")
-
-            if not recording.transcription or len(recording.transcription.strip()) < 10: # Basic check for valid transcript
-                 app.logger.warning(f"Transcription for recording {recording_id} is too short or empty. Skipping summarization.")
-                 recording.status = 'COMPLETED' # Mark as completed even without summary
-                 recording.summary = "[Summary skipped due to short transcription]"
-                 db.session.commit()
-                 return # Exit the task cleanly
-
-            # Prepare the prompt for OpenRouter
-            prompt_text = f"""Analyze the following audio transcription and generate a concise title and a brief summary.
-
-Transcription:
-\"\"\"
-{recording.transcription[:30000]}
-\"\"\"
-
-Respond STRICTLY with a JSON object containing two keys: "title" (a short, descriptive title, max 15 words) and "summary" (a paragraph summarizing the key points, max 150 words).
-Example Format:
-{{
-  "title": "Example Meeting Discussion on Q3 Results",
-  "summary": "The meeting covered the financial results for Q3, highlighting key achievements and areas for improvement. Action items were assigned for follow-up."
-}}
-
-JSON Response:""" # The prompt guides the model towards the desired output
-
-            try:
-                # Use the OpenRouter client configured earlier
-                completion = client.chat.completions.create(
-                    model=openrouter_model_name,
-                    messages=[
-                        {"role": "system", "content": "You are an AI assistant that generates titles and summaries for meeting transcripts. Respond only with the requested JSON object."},
-                        {"role": "user", "content": prompt_text}
-                    ],
-                    temperature=0.5, # Adjust temperature as needed
-                    max_tokens=300, # Adjust based on expected title+summary length
-                    response_format={"type": "json_object"} # Request JSON output
-                )
-
-                response_content = completion.choices[0].message.content
-                app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-                
-                try:
-                    response_content = completion.choices[0].message.content
-                    app.logger.debug(f"Raw OpenRouter response for {recording_id}: {response_content}")
-
-                    # Use regex to extract JSON content from potential markdown code blocks
-                    # This looks for content between markdown code blocks or just takes the whole content
-                    json_match = re.search(r'```(?:json)?(.*?)```|(.+)', response_content, re.DOTALL)
-                    
-                    if json_match:
-                        # Use the first group that matched (either between ``` or the whole content)
-                        sanitized_response = json_match.group(1) if json_match.group(1) else json_match.group(2)
-                        sanitized_response = sanitized_response.strip()
-                    else:
-                        sanitized_response = response_content.strip()
-                        
-                    summary_data = json.loads(response_content)
-                    generated_title = summary_data.get("title")
-                    generated_summary = summary_data.get("summary")
-
-                    if generated_title and generated_summary:
-                        # Update recording with AI generated content
-                        recording.title = generated_title.strip()
-                        recording.summary = generated_summary.strip()
-                        recording.status = 'COMPLETED'
-                        app.logger.info(f"Title and summary generated successfully for recording {recording_id}.")
-                    else:
-                        app.logger.warning(f"OpenRouter response for {recording_id} lacked 'title' or 'summary' key. Response: {response_content}")
-                        recording.summary = "[AI summary generation failed: Invalid JSON structure]"
-                        recording.status = 'COMPLETED' # Still completed, but summary failed
-
-                except json.JSONDecodeError as json_e:
-                    app.logger.error(f"Failed to parse JSON response from OpenRouter for {recording_id}: {json_e}. Response: {response_content}")
-                    recording.summary = f"[AI summary generation failed: Invalid JSON response ({json_e})]"
-                    recording.status = 'COMPLETED' # Mark as completed, summary failed
-
-            except Exception as summary_e:
-                app.logger.error(f"Error calling OpenRouter API for summary ({recording_id}): {str(summary_e)}")
-                # Keep transcription, but mark summary failed. Don't change status from SUMMARIZING yet.
-                recording.summary = f"[AI summary generation failed: API Error ({str(summary_e)})]"
-                recording.status = 'COMPLETED' # Even if summary fails, transcription worked.
-
-
-            db.session.commit() # Final commit for this step
-
-        except Exception as e:
-            db.session.rollback() # Rollback if any step failed critically
-            app.logger.error(f"Processing FAILED for recording {recording_id}: {str(e)}", exc_info=True)
-            # Retrieve recording again in case session was rolled back
-            recording = db.session.get(Recording, recording_id)
-            if recording:
-                 # Ensure status reflects failure even after rollback/retrieve attempt
-                if recording.status not in ['COMPLETED', 'FAILED']: # Avoid overwriting final state
-                    recording.status = 'FAILED'
-                if not recording.transcription: # If transcription itself failed
-                     recording.transcription = f"Processing failed: {str(e)}"
-                # Add error note to summary if appropriate stage was reached
-                if recording.status == 'SUMMARIZING' and not recording.summary:
-                     recording.summary = f"[Processing failed during summarization: {str(e)}]"
-
-                db.session.commit()
-
-# --- Chat with Transcription ---
-@app.route('/chat', methods=['POST'])
-@login_required
-def chat_with_transcription():
-    try:
-        data = request.json
-        if not data:
-            return jsonify({'error': 'No data provided'}), 400
-        
-        recording_id = data.get('recording_id')
-        user_message = data.get('message')
-        message_history = data.get('message_history', [])
-        
-        if not recording_id:
-            return jsonify({'error': 'No recording ID provided'}), 400
-        if not user_message:
-            return jsonify({'error': 'No message provided'}), 400
-            
-        # Get the recording
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to chat with this recording'}), 403
-            
-        # Check if OpenRouter client is available
-        if client is None:
-            return jsonify({'error': 'Chat service is not available (OpenRouter client not configured)'}), 503
-            
-        # Prepare the system prompt with the transcription
-        system_prompt = f"""You are a professional meeting analyst working with Murtaza Nasir, Assistant Professor at Wichita State University. Analyze the following meeting information and respond to the specific request.
-
-Following are the meeting participants and their roles:
-{recording.participants or "No specific participants information provided."}
-
-Following is the meeting transcript:
-<<start transcript>>
-{recording.transcription or "No transcript available."}
-<<end transcript>>
-
-Additional context and notes about the meeting:
-{recording.notes or "none"}
-"""
-        
-        # Call the LLM
-        try:
-            # Prepare messages array with system prompt and conversation history
-            messages = [{"role": "system", "content": system_prompt}]
-            
-            # Add message history if provided
-            if message_history:
-                messages.extend(message_history)
-            
-            # Add the current user message
-            messages.append({"role": "user", "content": user_message})
-            
-            completion = client.chat.completions.create(
-                model=openrouter_model_name,
-                messages=messages,
-                temperature=0.7,
-                max_tokens=1000
-            )
-            
-            response_content = completion.choices[0].message.content
-            
-            # Convert markdown in the response to HTML
-            response_html = md_to_html(response_content)
-            
-            return jsonify({
-                'response': response_content,
-                'response_html': response_html,
-                'success': True
-            })
-            
-        except Exception as chat_error:
-            app.logger.error(f"Error calling OpenRouter API for chat: {str(chat_error)}")
-            return jsonify({'error': f'Chat service error: {str(chat_error)}'}), 500
-            
-    except Exception as e:
-        app.logger.error(f"Error in chat endpoint: {str(e)}")
-        return jsonify({'error': str(e)}), 500
-
-
-# --- Authentication Routes ---
-@app.route('/register', methods=['GET', 'POST'])
-def register():
-    # Check if registration is allowed
-    allow_registration = os.environ.get('ALLOW_REGISTRATION', 'true').lower() == 'true'
-    
-    if not allow_registration:
-        flash('Registration is currently disabled. Please contact the administrator.', 'danger')
-        return redirect(url_for('login'))
-        
-    if current_user.is_authenticated:
-        return redirect(url_for('index'))
-    
-    form = RegistrationForm()
-    if form.validate_on_submit():
-        hashed_password = bcrypt.generate_password_hash(form.password.data).decode('utf-8')
-        user = User(username=form.username.data, email=form.email.data, password=hashed_password)
-        db.session.add(user)
-        db.session.commit()
-        flash('Your account has been created! You can now log in.', 'success')
-        return redirect(url_for('login'))
-    
-    return render_template('register.html', title='Register', form=form)
-
-@app.route('/login', methods=['GET', 'POST'])
-def login():
-    if current_user.is_authenticated:
-        return redirect(url_for('index'))
-    
-    form = LoginForm()
-    if form.validate_on_submit():
-        user = User.query.filter_by(email=form.email.data).first()
-        if user and bcrypt.check_password_hash(user.password, form.password.data):
-            login_user(user, remember=form.remember.data)
-            next_page = request.args.get('next')
-            return redirect(next_page) if next_page else redirect(url_for('index'))
-        else:
-            flash('Login unsuccessful. Please check email and password.', 'danger')
-    
-    return render_template('login.html', title='Login', form=form)
-
-@app.route('/logout')
-def logout():
-    logout_user()
-    return redirect(url_for('index'))
-
-@app.route('/account', methods=['GET'])
-@login_required
-def account():
-    return render_template('account.html', title='Account')
-
-@app.route('/change_password', methods=['POST'])
-@login_required
-def change_password():
-    current_password = request.form.get('current_password')
-    new_password = request.form.get('new_password')
-    confirm_password = request.form.get('confirm_password')
-    
-    # Validate form data
-    if not current_password or not new_password or not confirm_password:
-        flash('All fields are required.', 'danger')
-        return redirect(url_for('account'))
-    
-    if new_password != confirm_password:
-        flash('New password and confirmation do not match.', 'danger')
-        return redirect(url_for('account'))
-    
-    # Check if current password is correct
-    if not bcrypt.check_password_hash(current_user.password, current_password):
-        flash('Current password is incorrect.', 'danger')
-        return redirect(url_for('account'))
-    
-    # Update password
-    current_user.password = bcrypt.generate_password_hash(new_password).decode('utf-8')
-    db.session.commit()
-    
-    flash('Your password has been updated successfully.', 'success')
-    return redirect(url_for('account'))
-
-# --- Admin Routes ---
-@app.route('/admin', methods=['GET'])
-@login_required
-def admin():
-    # Check if user is admin
-    if not current_user.is_admin:
-        flash('You do not have permission to access the admin page.', 'danger')
-        return redirect(url_for('index'))
-    return render_template('admin.html', title='Admin Dashboard')
-
-@app.route('/admin/users', methods=['GET'])
-@login_required
-def admin_get_users():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    users = User.query.all()
-    user_data = []
-    
-    for user in users:
-        # Get recordings count and storage used
-        recordings_count = len(user.recordings)
-        storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
-        
-        user_data.append({
-            'id': user.id,
-            'username': user.username,
-            'email': user.email,
-            'is_admin': user.is_admin,
-            'recordings_count': recordings_count,
-            'storage_used': storage_used
-        })
-    
-    return jsonify(user_data)
-
-@app.route('/admin/users', methods=['POST'])
-@login_required
-def admin_add_user():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    data = request.json
-    if not data:
-        return jsonify({'error': 'No data provided'}), 400
-    
-    # Validate required fields
-    required_fields = ['username', 'email', 'password']
-    for field in required_fields:
-        if field not in data:
-            return jsonify({'error': f'Missing required field: {field}'}), 400
-    
-    # Check if username or email already exists
-    if User.query.filter_by(username=data['username']).first():
-        return jsonify({'error': 'Username already exists'}), 400
-    
-    if User.query.filter_by(email=data['email']).first():
-        return jsonify({'error': 'Email already exists'}), 400
-    
-    # Create new user
-    hashed_password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
-    new_user = User(
-        username=data['username'],
-        email=data['email'],
-        password=hashed_password,
-        is_admin=data.get('is_admin', False)
-    )
-    
-    db.session.add(new_user)
-    db.session.commit()
-    
-    return jsonify({
-        'id': new_user.id,
-        'username': new_user.username,
-        'email': new_user.email,
-        'is_admin': new_user.is_admin,
-        'recordings_count': 0,
-        'storage_used': 0
-    }), 201
-
-@app.route('/admin/users/<int:user_id>', methods=['PUT'])
-@login_required
-def admin_update_user(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    data = request.json
-    if not data:
-        return jsonify({'error': 'No data provided'}), 400
-    
-    # Update user fields
-    if 'username' in data and data['username'] != user.username:
-        # Check if username already exists
-        if User.query.filter_by(username=data['username']).first():
-            return jsonify({'error': 'Username already exists'}), 400
-        user.username = data['username']
-    
-    if 'email' in data and data['email'] != user.email:
-        # Check if email already exists
-        if User.query.filter_by(email=data['email']).first():
-            return jsonify({'error': 'Email already exists'}), 400
-        user.email = data['email']
-    
-    if 'password' in data and data['password']:
-        user.password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
-    
-    if 'is_admin' in data:
-        user.is_admin = data['is_admin']
-    
-    db.session.commit()
-    
-    # Get recordings count and storage used
-    recordings_count = len(user.recordings)
-    storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
-    
-    return jsonify({
-        'id': user.id,
-        'username': user.username,
-        'email': user.email,
-        'is_admin': user.is_admin,
-        'recordings_count': recordings_count,
-        'storage_used': storage_used
-    })
-
-@app.route('/admin/users/<int:user_id>', methods=['DELETE'])
-@login_required
-def admin_delete_user(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Prevent deleting self
-    if user_id == current_user.id:
-        return jsonify({'error': 'Cannot delete your own account'}), 400
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    # Delete user's recordings and audio files
-    for recording in user.recordings:
-        try:
-            if recording.audio_path and os.path.exists(recording.audio_path):
-                os.remove(recording.audio_path)
-        except Exception as e:
-            app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
-    
-    # Delete user
-    db.session.delete(user)
-    db.session.commit()
-    
-    return jsonify({'success': True})
-
-@app.route('/admin/users/<int:user_id>/toggle-admin', methods=['POST'])
-@login_required
-def admin_toggle_admin(user_id):
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Prevent changing own admin status
-    if user_id == current_user.id:
-        return jsonify({'error': 'Cannot change your own admin status'}), 400
-    
-    user = db.session.get(User, user_id)
-    if not user:
-        return jsonify({'error': 'User not found'}), 404
-    
-    # Toggle admin status
-    user.is_admin = not user.is_admin
-    db.session.commit()
-    
-    return jsonify({'success': True, 'is_admin': user.is_admin})
-
-@app.route('/admin/stats', methods=['GET'])
-@login_required
-def admin_get_stats():
-    # Check if user is admin
-    if not current_user.is_admin:
-        return jsonify({'error': 'Unauthorized'}), 403
-    
-    # Get total users
-    total_users = User.query.count()
-    
-    # Get total recordings
-    total_recordings = Recording.query.count()
-    
-    # Get recordings by status
-    completed_recordings = Recording.query.filter_by(status='COMPLETED').count()
-    processing_recordings = Recording.query.filter(Recording.status.in_(['PROCESSING', 'SUMMARIZING'])).count()
-    pending_recordings = Recording.query.filter_by(status='PENDING').count()
-    failed_recordings = Recording.query.filter_by(status='FAILED').count()
-    
-    # Get total storage used
-    total_storage = db.session.query(db.func.sum(Recording.file_size)).scalar() or 0
-    
-    # Get top users by storage
-    top_users_query = db.session.query(
-        User.id,
-        User.username,
-        db.func.count(Recording.id).label('recordings_count'),
-        db.func.sum(Recording.file_size).label('storage_used')
-    ).join(Recording, User.id == Recording.user_id, isouter=True) \
-     .group_by(User.id) \
-     .order_by(db.func.sum(Recording.file_size).desc()) \
-     .limit(5)
-    
-    top_users = []
-    for user_id, username, recordings_count, storage_used in top_users_query:
-        top_users.append({
-            'id': user_id,
-            'username': username,
-            'recordings_count': recordings_count or 0,
-            'storage_used': storage_used or 0
-        })
-    
-    # Get total queries (chat requests)
-    # This is a placeholder - you would need to track this in your database
-    total_queries = 0
-    
-    return jsonify({
-        'total_users': total_users,
-        'total_recordings': total_recordings,
-        'completed_recordings': completed_recordings,
-        'processing_recordings': processing_recordings,
-        'pending_recordings': pending_recordings,
-        'failed_recordings': failed_recordings,
-        'total_storage': total_storage,
-        'top_users': top_users,
-        'total_queries': total_queries
-    })
-
-# --- Flask Routes ---
-@app.route('/')
-def index():
-    return render_template('index.html')
-
-@app.route('/recordings', methods=['GET'])
-def get_recordings():
-    try:
-        # Check if user is logged in
-        if not current_user.is_authenticated:
-            return jsonify([])  # Return empty array if not logged in
-            
-        # Filter recordings by the current user
-        stmt = select(Recording).where(Recording.user_id == current_user.id).order_by(Recording.created_at.desc())
-        recordings = db.session.execute(stmt).scalars().all()
-        return jsonify([recording.to_dict() for recording in recordings])
-    except Exception as e:
-        app.logger.error(f"Error fetching recordings: {e}")
-        return jsonify({'error': str(e)}), 500
-
-@app.route('/save', methods=['POST'])
-@login_required
-def save_metadata():
-    try:
-        data = request.json
-        if not data: return jsonify({'error': 'No data provided'}), 400
-        recording_id = data.get('id')
-        if not recording_id: return jsonify({'error': 'No recording ID provided'}), 400
-
-        recording = db.session.get(Recording, recording_id)
-        if not recording: return jsonify({'error': 'Recording not found'}), 404
-        
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
-
-        # Update fields if provided
-        if 'title' in data: recording.title = data['title']
-        if 'participants' in data: recording.participants = data['participants']
-        if 'notes' in data: recording.notes = data['notes']
-        if 'summary' in data: recording.summary = data['summary'] # <-- ADDED: Allow saving edited summary
-        if 'meeting_date' in data:
-            try:
-                # Attempt to parse date string (e.g., "YYYY-MM-DD")
-                date_str = data['meeting_date']
-                if date_str:
-                    recording.meeting_date = datetime.strptime(date_str, '%Y-%m-%d').date()
-                else:
-                    recording.meeting_date = None # Allow clearing the date
-            except (ValueError, TypeError) as e:
-                app.logger.warning(f"Could not parse meeting_date '{data.get('meeting_date')}': {e}")
-                # Optionally return an error or just ignore the invalid date
-                # return jsonify({'error': f"Invalid date format for meeting_date. Use YYYY-MM-DD."}), 400
-
-        # Do not update transcription or status here
-        db.session.commit()
-        return jsonify({'success': True, 'recording': recording.to_dict()})
-
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error saving metadata for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-@app.route('/upload', methods=['POST'])
-@login_required
-def upload_file():
-    try:
-        if 'file' not in request.files:
-            return jsonify({'error': 'No file provided'}), 400
-
-        file = request.files['file']
-        if file.filename == '':
-            return jsonify({'error': 'No file selected'}), 400
-
-        original_filename = file.filename # <-- ADDED: Capture original filename
-        safe_filename = secure_filename(original_filename)
-        # Ensure filepath uses the configured UPLOAD_FOLDER
-        filepath = os.path.join(app.config['UPLOAD_FOLDER'], f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{safe_filename}")
-
-        # Get file size before saving
-        file.seek(0, os.SEEK_END)
-        file_size = file.tell()
-        file.seek(0)
-
-        # Check size limit again
-        if file_size > app.config['MAX_CONTENT_LENGTH']:
-            raise RequestEntityTooLarge()
-
-        file.save(filepath)
-        app.logger.info(f"File saved to {filepath}")
-
-        # Create initial database entry with PENDING status and filename as placeholder title
-        recording = Recording(
-            audio_path=filepath,
-            original_filename=original_filename, # <-- ADDED: Save original filename
-            # Use original filename (without path part) as initial title
-            title=f"Recording - {original_filename}",
-            file_size=file_size,
-            status='PENDING', # Explicitly set status
-            meeting_date=datetime.utcnow().date(), # <-- ADDED: Default meeting_date to today
-            user_id=current_user.id # Associate with the current user
-        )
-        db.session.add(recording)
-        db.session.commit()
-        app.logger.info(f"Initial recording record created with ID: {recording.id}")
-
-        # --- Start transcription & summarization in background thread ---
-        thread = threading.Thread(
-            target=transcribe_audio_task,
-            # Pass original filename for logging clarity
-            args=(app.app_context(), recording.id, filepath, original_filename) # Pass original_filename here too
-        )
-        thread.start()
-        app.logger.info(f"Background processing thread started for recording ID: {recording.id}")
-
-        # Return the initial recording data and ID immediately
-        return jsonify(recording.to_dict()), 202 # 202 Accepted
-
-    except RequestEntityTooLarge:
-        max_size_mb = app.config['MAX_CONTENT_LENGTH'] / (1024 * 1024)
-        app.logger.warning(f"Upload failed: File too large (>{max_size_mb}MB)")
-        return jsonify({
-            'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
-            'max_size_mb': max_size_mb
-        }), 413
-    except Exception as e:
-        db.session.rollback() # Rollback if initial save failed
-        app.logger.error(f"Error during file upload: {e}", exc_info=True)
-        return jsonify({'error': str(e)}), 500
-
-
-# Status Endpoint
-@app.route('/status/<int:recording_id>', methods=['GET'])
-@login_required
-def get_status(recording_id):
-    """Endpoint to check the transcription/summarization status."""
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-        
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to view this recording'}), 403
-            
-        return jsonify(recording.to_dict())
-    except Exception as e:
-        app.logger.error(f"Error fetching status for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Get Audio Endpoint
-@app.route('/audio/<int:recording_id>')
-@login_required
-def get_audio(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording or not recording.audio_path:
-            return jsonify({'error': 'Recording or audio file not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to access this audio file'}), 403
-        if not os.path.exists(recording.audio_path):
-            app.logger.error(f"Audio file missing from server: {recording.audio_path}")
-            return jsonify({'error': 'Audio file missing from server'}), 404
-        return send_file(recording.audio_path)
-    except Exception as e:
-        app.logger.error(f"Error serving audio for recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-# Delete Recording Endpoint
-@app.route('/recording/<int:recording_id>', methods=['DELETE'])
-@login_required
-def delete_recording(recording_id):
-    try:
-        recording = db.session.get(Recording, recording_id)
-        if not recording:
-            return jsonify({'error': 'Recording not found'}), 404
-            
-        # Check if the recording belongs to the current user
-        if recording.user_id and recording.user_id != current_user.id:
-            return jsonify({'error': 'You do not have permission to delete this recording'}), 403
-
-        # Delete the audio file first
-        try:
-            if recording.audio_path and os.path.exists(recording.audio_path):
-                os.remove(recording.audio_path)
-                app.logger.info(f"Deleted audio file: {recording.audio_path}")
-        except Exception as e:
-            app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
-
-        # Delete the database record
-        db.session.delete(recording)
-        db.session.commit()
-        app.logger.info(f"Deleted recording record ID: {recording_id}")
-
-        return jsonify({'success': True})
-    except Exception as e:
-        db.session.rollback()
-        app.logger.error(f"Error deleting recording {recording_id}: {e}")
-        return jsonify({'error': str(e)}), 500
-
-
-if __name__ == '__main__':
-    # Consider using waitress or gunicorn for production
-    # waitress-serve --host 0.0.0.0 --port 8899 app:app
-    # For development:
-    app.run(host='0.0.0.0', port=8899, debug=True) # Set debug=False if thread issues arise
-
-```
-
-
-## migrate_db.py
-
-```python
-
-#!/usr/bin/env python3
-
-import os
-import sys
-from sqlalchemy import inspect, Column, Integer, ForeignKey
-from sqlalchemy.exc import OperationalError
-
-# Try to import from app context
-try:
-    from flask import current_app
-    app = current_app._get_current_object()
-    with app.app_context():
-        db = app.extensions['sqlalchemy'].db
-except (RuntimeError, AttributeError, KeyError):
-    # If not in app context, import directly
-    try:
-        from app import app, db, User, Recording
-    except ImportError as e:
-        print(f"Error: Could not import 'app' and 'db': {e}")
-        print("Make sure migrate_db.py is runnable and PYTHONPATH is set.")
-        sys.exit(1)
-
-def migrate_database():
-    """
-    Migrate the database schema without losing data:
-    1. Check if User table exists, create it if not
-    2. Check if Recording.user_id column exists, add it if not
-    """
-    print("Starting database migration...")
-    
-    with app.app_context():
-        inspector = inspect(db.engine)
-        existing_tables = inspector.get_table_names()
-        
-        # Check if User table exists
-        if 'user' not in existing_tables:
-            print("Creating User table...")
-            # Create User table
-            class TempUser(db.Model):
-                __tablename__ = 'user'
-                id = db.Column(db.Integer, primary_key=True)
-                username = db.Column(db.String(20), unique=True, nullable=False)
-                email = db.Column(db.String(120), unique=True, nullable=False)
-                password = db.Column(db.String(60), nullable=False)
-            
-            # Create only the User table
-            db.create_all(tables=[TempUser.__table__])
-            print("User table created successfully!")
-        else:
-            print("User table already exists.")
-        
-        # Check if Recording.user_id column exists
-        recording_columns = [column['name'] for column in inspector.get_columns('recording')]
-        if 'user_id' not in recording_columns:
-            print("Adding user_id column to Recording table...")
-            try:
-                # Add user_id column to Recording table
-                with db.engine.begin() as conn:
-                    conn.execute(db.text("ALTER TABLE recording ADD COLUMN user_id INTEGER REFERENCES user(id)"))
-                print("user_id column added successfully!")
-            except OperationalError as e:
-                print(f"Error adding user_id column: {e}")
-                print("Attempting alternative approach...")
-                try:
-                    # SQLite doesn't support ALTER TABLE ADD COLUMN with foreign keys
-                    # So we need to create a new table, copy data, drop old table, rename new table
-                    
-                    # 1. Create temporary table with new schema
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            CREATE TABLE recording_new (
-                                id INTEGER PRIMARY KEY,
-                                title VARCHAR(200),
-                                participants VARCHAR(500),
-                                notes TEXT,
-                                transcription TEXT,
-                                summary TEXT,
-                                status VARCHAR(50),
-                                audio_path VARCHAR(500),
-                                created_at DATETIME,
-                                meeting_date DATE,
-                                file_size INTEGER,
-                                user_id INTEGER REFERENCES user(id)
-                            )
-                        """))
-                    
-                    # 2. Copy data from old table to new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("""
-                            INSERT INTO recording_new (
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size
-                            )
-                            SELECT 
-                                id, title, participants, notes, transcription, summary, 
-                                status, audio_path, created_at, meeting_date, file_size
-                            FROM recording
-                        """))
-                    
-                    # 3. Drop old table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("DROP TABLE recording"))
-                    
-                    # 4. Rename new table
-                    with db.engine.begin() as conn:
-                        conn.execute(db.text("ALTER TABLE recording_new RENAME TO recording"))
-                    
-                    print("user_id column added successfully using table recreation!")
-                except Exception as e2:
-                    print(f"Error during table recreation: {e2}")
-                    sys.exit(1)
-        else:
-            print("user_id column already exists in Recording table.")
-        
-        print("Database migration completed successfully!")
-
-if __name__ == "__main__":
-    print("Attempting to migrate the database...")
-    migrate_database()
-    print("Database migration process finished.")
-
-```
-
-
-## create_docs.py
-
-```python
-
-import os
-from pathlib import Path
-
-def create_markdown_doc(base_dir):
-    output = []
-    
-    # Add header
-    output.append("# Project Files\n")
-    output.append("Generated documentation of all project files.\n")
-
-    # Function to read and format file content
-    def add_file_content(filepath, relative_path):
-        output.append(f"\n## {relative_path}\n")
-        output.append("```" + get_file_extension(filepath) + "\n")
-        try:
-            with open(filepath, 'r', encoding='utf-8') as f:
-                output.append(f.read())
-        except Exception as e:
-            output.append(f"Error reading file: {e}")
-        output.append("```\n")
-
-    def get_file_extension(filepath):
-        ext = os.path.splitext(filepath)[1][1:].lower()
-        # Map file extensions to markdown code block languages
-        extension_map = {
-            'py': 'python',
-            'html': 'html',
-            'js': 'javascript',
-            'css': 'css',
-            'sh': 'bash',
-            'md': 'markdown',
-            'txt': 'text'
-        }
-        return extension_map.get(ext, '')
-
-    # List of important file patterns to include
-    patterns = [
-        '*.py',
-        '*.html',
-        '*.js',
-        '*.css',
-        '*.sh',
-        'requirements.txt'
-    ]
-
-    # Walk through directory and add files
-    for root, _, _ in os.walk(base_dir):
-        for pattern in patterns:
-            for filepath in Path(root).glob(pattern):
-                if 'venv' not in str(filepath) and '__pycache__' not in str(filepath):
-                    relative_path = os.path.relpath(filepath, base_dir)
-                    add_file_content(filepath, relative_path)
-
-    # Write to output file
-    output_path = os.path.join(base_dir, 'project_files.md')
-    with open(output_path, 'w', encoding='utf-8') as f:
-        f.write('\n'.join(output))
-    
-    return output_path
-
-if __name__ == "__main__":
-    # Get the current directory
-    current_dir = os.getcwd()
-    
-    # Create the markdown file
-    output_file = create_markdown_doc(current_dir)
-    print(f"Created markdown documentation at: {output_file}")
-```
-
-
-## requirements.txt
-
-```text
-
-flask==2.3.3
-flask-sqlalchemy==3.1.1
-flask-login==0.6.3
-flask-wtf==1.2.2
-flask-bcrypt==1.0.1
-email-validator==2.2.0
-openai==1.3.0
-werkzeug==2.3.7
-gunicorn==21.2.0
-python-dotenv==1.0.0
-markdown==3.5.1
-
-```
-
-
-## templates/account.html
-
-```html
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
-
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-    </style>
-</head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
-            </h1>
-            <div class="flex items-center space-x-2">
-                <button id="darkModeToggle" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200">
-                    <i id="darkModeIcon" class="fas fa-moon"></i>
-                </button>
-                <div class="relative" id="userDropdown">
-                    <button id="userDropdownButton" class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
-                        <i class="fas fa-user mr-2"></i>
-                        <span>{{ current_user.username }}</span>
-                        <i class="fas fa-chevron-down ml-2"></i>
-                    </button>
-                    <div id="userDropdownMenu" class="hidden absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-home mr-2"></i> Home
-                        </a>
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
-                            <i class="fas fa-user-circle mr-2"></i> Account
-                        </a>
-                        {% if current_user.is_admin %}
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
-                        </a>
-                        {% endif %}
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
-                        </a>
-                    </div>
-                </div>
-            </div>
-        </header>
-
-        <main class="flex-grow">
-            <div class="bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Account Information</h2>
-                
-                {% with messages = get_flashed_messages(with_categories=true) %}
-                    {% if messages %}
-                        {% for category, message in messages %}
-                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
-                                {{ message }}
-                            </div>
-                        {% endfor %}
-                    {% endif %}
-                {% endwith %}
-                
-                <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
-                    <div>
-                        <div class="mb-6">
-                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">User Details</h3>
-                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
-                                <div class="mb-3">
-                                    <span class="block text-sm font-medium text-[var(--text-muted)]">Username</span>
-                                    <span class="block text-[var(--text-primary)]">{{ current_user.username }}</span>
-                                </div>
-                                <div>
-                                    <span class="block text-sm font-medium text-[var(--text-muted)]">Email</span>
-                                    <span class="block text-[var(--text-primary)]">{{ current_user.email }}</span>
-                                </div>
-                            </div>
-                        </div>
-                        
-                        <div>
-                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">Account Actions</h3>
-                            <div class="flex flex-col space-y-3">
-                                <a href="{{ url_for('index') }}" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
-                                    <i class="fas fa-microphone mr-2"></i> Go to Recordings
-                                </a>
-                                <button id="changePasswordBtn" class="inline-flex items-center px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
-                                    <i class="fas fa-key mr-2"></i> Change Password
-                                </button>
-                            </div>
-                        </div>
-                    </div>
-                    
-                    <div>
-                        <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">Account Statistics</h3>
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
-                            <div class="grid grid-cols-2 gap-4">
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-accent)]">{{ current_user.recordings|length }}</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Total Recordings</span>
-                                </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-accent)]">
-                                        {% set completed_count = current_user.recordings|selectattr('status', 'equalto', 'COMPLETED')|list|length %}
-                                        {{ completed_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Completed</span>
-                                </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-warn-strong)]">
-                                        {% set processing_count = current_user.recordings|selectattr('status', 'in', ['PENDING', 'PROCESSING', 'SUMMARIZING'])|list|length %}
-                                        {{ processing_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Processing</span>
-                                </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-danger)]">
-                                        {% set failed_count = current_user.recordings|selectattr('status', 'equalto', 'FAILED')|list|length %}
-                                        {{ failed_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Failed</span>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; {{ now.year }}
-        </footer>
-    </div>
-
-    <!-- Change Password Modal -->
-    <div id="changePasswordModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
-        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
-            <div class="flex justify-between items-center mb-4">
-                <h3 class="text-xl font-semibold text-[var(--text-primary)]">Change Password</h3>
-                <button id="closeModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
-            </div>
-            <form id="changePasswordForm" method="POST" action="{{ url_for('change_password') }}">
-                <div class="mb-4">
-                    <label for="current_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Current Password</label>
-                    <input type="password" id="current_password" name="current_password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                </div>
-                <div class="mb-4">
-                    <label for="new_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">New Password</label>
-                    <input type="password" id="new_password" name="new_password" required minlength="8" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    <p class="text-xs text-[var(--text-muted)] mt-1">Password must be at least 8 characters long</p>
-                </div>
-                <div class="mb-6">
-                    <label for="confirm_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Confirm New Password</label>
-                    <input type="password" id="confirm_password" name="confirm_password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                </div>
-                <div class="flex justify-end space-x-3">
-                    <button type="button" id="cancelBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                    <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Change Password</button>
-                </div>
-            </form>
-        </div>
-    </div>
-
-    <script>
-        // Dark mode toggle functionality
-        const darkModeToggle = document.getElementById('darkModeToggle');
-        const darkModeIcon = document.getElementById('darkModeIcon');
-        
-        // Initialize dark mode based on localStorage or system preference
-        function initializeDarkMode() {
-            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-            const savedMode = localStorage.getItem('darkMode');
-            
-            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
-                document.documentElement.classList.add('dark');
-                darkModeIcon.classList.remove('fa-moon');
-                darkModeIcon.classList.add('fa-sun');
-            } else {
-                document.documentElement.classList.remove('dark');
-                darkModeIcon.classList.remove('fa-sun');
-                darkModeIcon.classList.add('fa-moon');
-            }
-        }
-        
-        // Toggle dark mode
-        darkModeToggle.addEventListener('click', () => {
-            const isDarkMode = document.documentElement.classList.toggle('dark');
-            localStorage.setItem('darkMode', isDarkMode);
-            
-            if (isDarkMode) {
-                darkModeIcon.classList.remove('fa-moon');
-                darkModeIcon.classList.add('fa-sun');
-            } else {
-                darkModeIcon.classList.remove('fa-sun');
-                darkModeIcon.classList.add('fa-moon');
-            }
-        });
-        
-        // User dropdown functionality
-        const userDropdownButton = document.getElementById('userDropdownButton');
-        const userDropdownMenu = document.getElementById('userDropdownMenu');
-        
-        userDropdownButton.addEventListener('click', () => {
-            userDropdownMenu.classList.toggle('hidden');
-        });
-        
-        // Close dropdown when clicking outside
-        document.addEventListener('click', (event) => {
-            if (!userDropdownButton.contains(event.target) && !userDropdownMenu.contains(event.target)) {
-                userDropdownMenu.classList.add('hidden');
-            }
-        });
-        
-        // Initialize dark mode on page load
-        initializeDarkMode();
-        
-        // Change Password Modal functionality
-        const changePasswordBtn = document.getElementById('changePasswordBtn');
-        const changePasswordModal = document.getElementById('changePasswordModal');
-        const closeModalBtn = document.getElementById('closeModalBtn');
-        const cancelBtn = document.getElementById('cancelBtn');
-        const changePasswordForm = document.getElementById('changePasswordForm');
-        const newPasswordInput = document.getElementById('new_password');
-        const confirmPasswordInput = document.getElementById('confirm_password');
-        
-        // Open modal
-        changePasswordBtn.addEventListener('click', () => {
-            changePasswordModal.classList.remove('hidden');
-            // Reset form
-            changePasswordForm.reset();
-        });
-        
-        // Close modal functions
-        function closeModal() {
-            changePasswordModal.classList.add('hidden');
-        }
-        
-        closeModalBtn.addEventListener('click', closeModal);
-        cancelBtn.addEventListener('click', closeModal);
-        
-        // Close modal when clicking outside
-        changePasswordModal.addEventListener('click', (event) => {
-            if (event.target === changePasswordModal) {
-                closeModal();
-            }
-        });
-        
-        // Form validation
-        changePasswordForm.addEventListener('submit', (event) => {
-            if (newPasswordInput.value !== confirmPasswordInput.value) {
-                event.preventDefault();
-                alert('New password and confirmation do not match.');
-            }
-        });
-    </script>
-</body>
-</html>
-
-```
-
-
-## templates/admin.html
-
-```html
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Admin Dashboard - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
-
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-        .custom-scrollbar::-webkit-scrollbar { width: 6px; }
-        .custom-scrollbar::-webkit-scrollbar-track { background: var(--scrollbar-track); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); }
-    </style>
-</head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div id="app" class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
-            </h1>
-            <div class="flex items-center space-x-2">
-                <button @click="toggleDarkMode" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isDarkMode ? 'Switch to Light Mode' : 'Switch to Dark Mode'">
-                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
-                </button>
-                <div class="relative" @click.away="isDropdownOpen = false">
-                    <button @click="isDropdownOpen = !isDropdownOpen" class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
-                        <i class="fas fa-user-shield mr-2"></i>
-                        <span>{{ current_user.username }}</span>
-                        <i class="fas fa-chevron-down ml-2"></i>
-                    </button>
-                    <div v-show="isDropdownOpen" class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-home mr-2"></i> Home
-                        </a>
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user mr-2"></i> Account
-                        </a>
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
-                        </a>
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
-                        </a>
-                    </div>
-                </div>
-            </div>
-        </header>
-
-        <main class="flex-grow">
-            <div class="bg-[var(--bg-secondary)] p-6 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Admin Dashboard</h2>
-                
-                {% with messages = get_flashed_messages(with_categories=true) %}
-                    {% if messages %}
-                        {% for category, message in messages %}
-                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
-                                {{ message }}
-                            </div>
-                        {% endfor %}
-                    {% endif %}
-                {% endwith %}
-                
-                <!-- Tabs -->
-                <div class="border-b border-[var(--border-primary)] mb-6">
-                    <nav class="-mb-px flex space-x-8" aria-label="Tabs">
-                        <button @click="activeTab = 'users'" 
-                                :class="activeTab === 'users' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                class="whitespace-nowrap py-4 px-1 border-b-2 font-medium text-sm">
-                            <i class="fas fa-users mr-2"></i> User Management
-                        </button>
-                        <button @click="activeTab = 'stats'" 
-                                :class="activeTab === 'stats' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                class="whitespace-nowrap py-4 px-1 border-b-2 font-medium text-sm">
-                            <i class="fas fa-chart-bar mr-2"></i> System Statistics
-                        </button>
-                    </nav>
-                </div>
-                
-                <!-- User Management Tab -->
-                <div v-show="activeTab === 'users'">
-                    <div class="flex justify-between items-center mb-4">
-                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">User Management</h3>
-                        <button @click="showAddUserModal = true" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                            <i class="fas fa-user-plus mr-2"></i> Add User
-                        </button>
-                    </div>
-                    
-                    <!-- Search and Filter -->
-                    <div class="mb-4 flex">
-                        <div class="relative flex-grow">
-                            <input type="text" v-model="userSearchQuery" placeholder="Search users..." class="w-full px-4 py-2 border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                            <button v-if="userSearchQuery" @click="userSearchQuery = ''" class="absolute right-3 top-2.5 text-[var(--text-muted)] hover:text-[var(--text-secondary)]">
-                                <i class="fas fa-times"></i>
-                            </button>
-                        </div>
-                    </div>
-                    
-                    <!-- Users Table -->
-                    <div class="overflow-x-auto">
-                        <table class="min-w-full divide-y divide-[var(--border-primary)]">
-                            <thead class="bg-[var(--bg-tertiary)]">
-                                <tr>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">ID</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Username</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Email</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Admin</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Recordings</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Storage Used</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Actions</th>
-                                </tr>
-                            </thead>
-                            <tbody class="bg-[var(--bg-secondary)] divide-y divide-[var(--border-primary)]">
-                                <tr v-for="user in filteredUsers" :key="user.id" class="hover:bg-[var(--bg-tertiary)]">
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ user.id }</td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm font-medium text-[var(--text-primary)]">${ user.username }</td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ user.email }</td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">
-                                        <span v-if="user.is_admin" class="px-2 inline-flex text-xs leading-5 font-semibold rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">Yes</span>
-                                        <span v-else class="px-2 inline-flex text-xs leading-5 font-semibold rounded-full bg-[var(--bg-pending-light)] text-[var(--text-pending-strong)]">No</span>
-                                    </td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ user.recordings_count }</td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ formatFileSize(user.storage_used) }</td>
-                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">
-                                        <div class="flex space-x-2">
-                                            <button @click="editUser(user)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]" title="Edit User">
-                                                <i class="fas fa-edit"></i>
-                                            </button>
-                                            <button @click="toggleAdminStatus(user)" :class="user.is_admin ? 'text-[var(--text-warn-strong)]' : 'text-[var(--text-info-strong)]'" :title="user.is_admin ? 'Remove Admin' : 'Make Admin'">
-                                                <i class="fas" :class="user.is_admin ? 'fa-user-minus' : 'fa-user-shield'"></i>
-                                            </button>
-                                            <button @click="confirmDeleteUser(user)" class="text-[var(--text-danger)] hover:text-[var(--text-danger-hover)]" title="Delete User">
-                                                <i class="fas fa-trash"></i>
-                                            </button>
-                                        </div>
-                                    </td>
-                                </tr>
-                                <tr v-if="filteredUsers.length === 0">
-                                    <td colspan="7" class="px-6 py-4 text-center text-sm text-[var(--text-muted)]">
-                                        <div v-if="isLoadingUsers">
-                                            <i class="fas fa-spinner fa-spin mr-2"></i> Loading users...
-                                        </div>
-                                        <div v-else>
-                                            No users found.
-                                        </div>
-                                    </td>
-                                </tr>
-                            </tbody>
-                        </table>
-                    </div>
-                </div>
-                
-                <!-- System Statistics Tab -->
-                <div v-show="activeTab === 'stats'">
-                    <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statistics</h3>
-                    
-                    <!-- Summary Cards -->
-                    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4 mb-6">
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <div class="flex items-center">
-                                <div class="p-3 rounded-full bg-[var(--bg-info-light)] text-[var(--text-info-strong)]">
-                                    <i class="fas fa-users text-xl"></i>
-                                </div>
-                                <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Users</p>
-                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_users }</p>
-                                </div>
-                            </div>
-                        </div>
-                        
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <div class="flex items-center">
-                                <div class="p-3 rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">
-                                    <i class="fas fa-file-audio text-xl"></i>
-                                </div>
-                                <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Recordings</p>
-                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_recordings }</p>
-                                </div>
-                            </div>
-                        </div>
-                        
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <div class="flex items-center">
-                                <div class="p-3 rounded-full bg-[var(--bg-warn-light)] text-[var(--text-warn-strong)]">
-                                    <i class="fas fa-database text-xl"></i>
-                                </div>
-                                <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Storage Used</p>
-                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ formatFileSize(stats.total_storage) }</p>
-                                </div>
-                            </div>
-                        </div>
-                        
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <div class="flex items-center">
-                                <div class="p-3 rounded-full bg-[var(--bg-accent)] text-[var(--text-accent)]">
-                                    <i class="fas fa-comments text-xl"></i>
-                                </div>
-                                <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Queries</p>
-                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_queries }</p>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                    
-                    <!-- Status Distribution -->
-                    <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-6">
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Recording Status Distribution</h4>
-                            <div class="grid grid-cols-2 gap-4">
-                                <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-2xl font-bold text-[var(--text-success-strong)]">${ stats.completed_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Completed</span>
-                                </div>
-                                <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-2xl font-bold text-[var(--text-warn-strong)]">${ stats.processing_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Processing</span>
-                                </div>
-                                <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-2xl font-bold text-[var(--text-pending-strong)]">${ stats.pending_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Pending</span>
-                                </div>
-                                <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-2xl font-bold text-[var(--text-danger-strong)]">${ stats.failed_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Failed</span>
-                                </div>
-                            </div>
-                        </div>
-                        
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Top Users by Storage</h4>
-                            <div class="space-y-3">
-                                <div v-for="user in stats.top_users" :key="user.id" class="flex justify-between items-center p-2 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
-                                    <div class="flex items-center">
-                                        <i class="fas fa-user text-[var(--text-accent)] mr-2"></i>
-                                        <span class="text-sm font-medium text-[var(--text-primary)]">${ user.username }</span>
-                                    </div>
-                                    <div class="text-sm text-[var(--text-secondary)]">
-                                        <span class="font-medium">${ formatFileSize(user.storage_used) }</span>
-                                        <span class="text-[var(--text-muted)] ml-2">(${ user.recordings_count} recordings)</span>
-                                    </div>
-                                </div>
-                                <div v-if="stats.top_users.length === 0" class="text-center text-sm text-[var(--text-muted)] p-2">
-                                    No data available
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; {{ now.year }}
-        </footer>
-        
-        <!-- Add User Modal -->
-        <div v-if="showAddUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
-            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
-                <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Add New User</h3>
-                    <button @click="showAddUserModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
-                </div>
-                <form @submit.prevent="addUser">
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Username</label>
-                        <input v-model="newUser.username" type="text" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Email</label>
-                        <input v-model="newUser.email" type="email" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Password</label>
-                        <input v-model="newUser.password" type="password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Confirm Password</label>
-                        <input v-model="newUser.confirmPassword" type="password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4 flex items-center">
-                        <input v-model="newUser.isAdmin" type="checkbox" id="isAdmin" class="rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
-                        <label for="isAdmin" class="ml-2 text-sm text-[var(--text-secondary)]">Admin User</label>
-                    </div>
-                    <div class="flex justify-end space-x-3">
-                        <button type="button" @click="showAddUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
-                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Add User</button>
-                    </div>
-                </form>
-            </div>
-        </div>
-        
-        <!-- Edit User Modal -->
-        <div v-if="showEditUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
-            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
-                <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Edit User</h3>
-                    <button @click="showEditUserModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
-                </div>
-                <form @submit.prevent="updateUser">
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Username</label>
-                        <input v-model="editingUser.username" type="text" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Email</label>
-                        <input v-model="editingUser.email" type="email" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">New Password (leave blank to keep current)</label>
-                        <input v-model="editingUser.password" type="password" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div class="mb-4 flex items-center">
-                        <input v-model="editingUser.is_admin" type="checkbox" id="editIsAdmin" class="rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
-                        <label for="editIsAdmin" class="ml-2 text-sm text-[var(--text-secondary)]">Admin User</label>
-                    </div>
-                    <div class="flex justify-end space-x-3">
-                        <button type="button" @click="showEditUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
-                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Update User</button>
-                    </div>
-                </form>
-            </div>
-        </div>
-        
-        <!-- Delete User Confirmation Modal -->
-        <div v-if="showDeleteUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
-            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
-                <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
-                    <button @click="showDeleteUserModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
-                </div>
-                <p class="mb-4 text-[var(--text-secondary)]">Are you sure you want to delete the user <span class="font-semibold">${ userToDelete?.username }</span>? This action cannot be undone.</p>
-                <div class="flex justify-end space-x-3">
-                    <button @click="showDeleteUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
-                    <button @click="deleteUser" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">Delete User</button>
-                </div>
-            </div>
-        </div>
-    </div>
-    
-    <script>
-        const { createApp, ref, computed, onMounted, watch } = Vue
-        
-        createApp({
-            setup() {
-                // State
-                const activeTab = ref('users');
-                const users = ref([]);
-                const stats = ref({
-                    total_users: 0,
-                    total_recordings: 0,
-                    total_storage: 0,
-                    total_queries: 0,
-                    completed_recordings: 0,
-                    processing_recordings: 0,
-                    pending_recordings: 0,
-                    failed_recordings: 0,
-                    top_users: []
-                });
-                const isLoadingUsers = ref(true);
-                const userSearchQuery = ref('');
-                const isDarkMode = ref(false);
-                const isDropdownOpen = ref(false);
-                
-                // Modal state
-                const showAddUserModal = ref(false);
-                const showEditUserModal = ref(false);
-                const showDeleteUserModal = ref(false);
-                const newUser = ref({
-                    username: '',
-                    email: '',
-                    password: '',
-                    confirmPassword: '',
-                    isAdmin: false
-                });
-                const editingUser = ref(null);
-                const userToDelete = ref(null);
-                
-                // Computed properties
-                const filteredUsers = computed(() => {
-                    if (!userSearchQuery.value) return users.value;
-                    
-                    const query = userSearchQuery.value.toLowerCase();
-                    return users.value.filter(user => 
-                        user.username.toLowerCase().includes(query) || 
-                        user.email.toLowerCase().includes(query)
-                    );
-                });
-                
-                // Methods
-                const loadUsers = async () => {
-                    isLoadingUsers.value = true;
-                    try {
-                        const response = await fetch('/admin/users');
-                        if (!response.ok) throw new Error('Failed to load users');
-                        
-                        const data = await response.json();
-                        users.value = data;
-                    } catch (error) {
-                        console.error('Error loading users:', error);
-                        // Show error notification
-                    } finally {
-                        isLoadingUsers.value = false;
-                    }
-                };
-                
-                const loadStats = async () => {
-                    try {
-                        const response = await fetch('/admin/stats');
-                        if (!response.ok) throw new Error('Failed to load statistics');
-                        
-                        const data = await response.json();
-                        stats.value = data;
-                    } catch (error) {
-                        console.error('Error loading statistics:', error);
-                        // Show error notification
-                    }
-                };
-                
-                const addUser = async () => {
-                    if (newUser.value.password !== newUser.value.confirmPassword) {
-                        alert('Passwords do not match');
-                        return;
-                    }
-                    
-                    try {
-                        const response = await fetch('/admin/users', {
-                            method: 'POST',
-                            headers: {
-                                'Content-Type': 'application/json'
-                            },
-                            body: JSON.stringify({
-                                username: newUser.value.username,
-                                email: newUser.value.email,
-                                password: newUser.value.password,
-                                is_admin: newUser.value.isAdmin
-                            })
-                        });
-                        
-                        if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to add user');
-                        }
-                        
-                        // Reset form and close modal
-                        newUser.value = {
-                            username: '',
-                            email: '',
-                            password: '',
-                            confirmPassword: '',
-                            isAdmin: false
-                        };
-                        showAddUserModal.value = false;
-                        
-                        // Reload users
-                        await loadUsers();
-                        await loadStats();
-                        
-                    } catch (error) {
-                        console.error('Error adding user:', error);
-                        alert(error.message);
-                    }
-                };
-                
-                const editUser = (user) => {
-                    editingUser.value = { ...user, password: '' };
-                    showEditUserModal.value = true;
-                };
-                
-                const updateUser = async () => {
-                    try {
-                        const payload = {
-                            username: editingUser.value.username,
-                            email: editingUser.value.email,
-                            is_admin: editingUser.value.is_admin
-                        };
-                        
-                        // Only include password if it was changed
-                        if (editingUser.value.password) {
-                            payload.password = editingUser.value.password;
-                        }
-                        
-                        const response = await fetch(`/admin/users/${editingUser.value.id}`, {
-                            method: 'PUT',
-                            headers: {
-                                'Content-Type': 'application/json'
-                            },
-                            body: JSON.stringify(payload)
-                        });
-                        
-                        if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to update user');
-                        }
-                        
-                        // Close modal and reload users
-                        showEditUserModal.value = false;
-                        await loadUsers();
-                        
-                    } catch (error) {
-                        console.error('Error updating user:', error);
-                        alert(error.message);
-                    }
-                };
-                
-                const confirmDeleteUser = (user) => {
-                    userToDelete.value = user;
-                    showDeleteUserModal.value = true;
-                };
-                
-                const deleteUser = async () => {
-                    try {
-                        const response = await fetch(`/admin/users/${userToDelete.value.id}`, {
-                            method: 'DELETE'
-                        });
-                        
-                        if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to delete user');
-                        }
-                        
-                        // Close modal and reload users
-                        showDeleteUserModal.value = false;
-                        await loadUsers();
-                        await loadStats();
-                        
-                    } catch (error) {
-                        console.error('Error deleting user:', error);
-                        alert(error.message);
-                    }
-                };
-                
-                const toggleAdminStatus = async (user) => {
-                    try {
-                        const response = await fetch(`/admin/users/${user.id}/toggle-admin`, {
-                            method: 'POST'
-                        });
-                        
-                        if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to toggle admin status');
-                        }
-                        
-                        // Reload users
-                        await loadUsers();
-                        
-                    } catch (error) {
-                        console.error('Error toggling admin status:', error);
-                        alert(error.message);
-                    }
-                };
-                
-                const formatFileSize = (bytes) => {
-                    if (!bytes || bytes === 0) return '0 Bytes';
-                    
-                    const k = 1024;
-                    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-                    const i = Math.floor(Math.log(bytes) / Math.log(k));
-                    
-                    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
-                };
-                
-                const toggleDarkMode = () => {
-                    isDarkMode.value = !isDarkMode.value;
-                    if (isDarkMode.value) {
-                        document.documentElement.classList.add('dark');
-                        localStorage.setItem('darkMode', 'true');
-                    } else {
-                        document.documentElement.classList.remove('dark');
-                        localStorage.setItem('darkMode', 'false');
-                    }
-                };
-                
-                // Initialize dark mode
-                const initializeDarkMode = () => {
-                    const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-                    const savedMode = localStorage.getItem('darkMode');
-                    
-                    if (savedMode === 'true' || (savedMode === null && prefersDark)) {
-                        isDarkMode.value = true;
-                        document.documentElement.classList.add('dark');
-                    } else {
-                        isDarkMode.value = false;
-                        document.documentElement.classList.remove('dark');
-                    }
-                };
-                
-                // Lifecycle hooks
-                onMounted(() => {
-                    loadUsers();
-                    loadStats();
-                    initializeDarkMode();
-                });
-                
-                // Watch for tab changes to reload data
-                watch(activeTab, (newTab) => {
-                    if (newTab === 'users') {
-                        loadUsers();
-                    } else if (newTab === 'stats') {
-                        loadStats();
-                    }
-                });
-                
-                return {
-                    // State
-                    activeTab,
-                    users,
-                    stats,
-                    isLoadingUsers,
-                    userSearchQuery,
-                    isDarkMode,
-                    isDropdownOpen,
-                    
-                    // Modal state
-                    showAddUserModal,
-                    showEditUserModal,
-                    showDeleteUserModal,
-                    newUser,
-                    editingUser,
-                    userToDelete,
-                    
-                    // Computed
-                    filteredUsers,
-                    
-                    // Methods
-                    loadUsers,
-                    loadStats,
-                    addUser,
-                    editUser,
-                    updateUser,
-                    confirmDeleteUser,
-                    deleteUser,
-                    toggleAdminStatus,
-                    formatFileSize,
-                    toggleDarkMode
-                };
-            },
-            delimiters: ['${', '}'] // Use different delimiters to avoid conflict with Flask's Jinja2
-        }).mount('#app');
-    </script>
-</body>
-</html>
-
-```
-
-
-## templates/index.html
-
-```html
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-            --bg-audio-player: linear-gradient(to right, #eff6ff, #eef2ff); /* blue-50, indigo-50 */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-            
-            --scrollbar-track: #f1f1f1;
-            --scrollbar-thumb: #c5c5c5;
-            --scrollbar-thumb-hover: #a8a8a8;
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-            --bg-audio-player: linear-gradient(to right, #374151, #4b5563); /* gray-700, gray-600 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-            
-            --scrollbar-track: #2d3748; /* gray-800 */
-            --scrollbar-thumb: #4a5568; /* gray-600 */
-            --scrollbar-thumb-hover: #718096; /* gray-500 */
-        }
-
-        /* Modern UI styles */
-        .drag-area { transition: background-color 0.3s ease, border-color 0.3s ease; }
-        .custom-scrollbar::-webkit-scrollbar { width: 6px; }
-        .custom-scrollbar::-webkit-scrollbar-track { background: var(--scrollbar-track); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); }
-        html { /* Apply base colors to html for smoother transitions */
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-        #app { min-height: 100%; display: flex; flex-direction: column; }
-        main { flex-grow: 1; position: relative; }
-        .progress-popup { position: fixed; bottom: 1rem; left: 1rem; z-index: 100; transition: all 0.3s ease-in-out; min-width: 300px; border-radius: 12px; overflow: hidden; }
-        .progress-popup.minimized { transform: translateY(calc(100% - 45px)); }
-        .progress-list-item { display: grid; grid-template-columns: auto 1fr auto; gap: 0.5rem; align-items: center; }
-         /* Modern style for summary box */
-        .summary-box {
-            background-color: #f9fafb; /* bg-gray-50 */
-            padding: 1rem; /* p-4 */
-            border-radius: 0.75rem; /* rounded-xl */
-            border: 1px solid #e5e7eb; /* border-gray-200 */
-            min-height: 60px; /* min-h-[60px] or adjust as needed */
-            /* max-height removed to allow full height */
-            overflow-y: auto;
-            white-space: pre-wrap;
-            font-family: inherit; /* Use body font */
-            font-size: 0.875rem; /* text-sm */
-            line-height: 1.5; /* Improved line height */
-            box-shadow: 0 1px 2px rgba(0,0,0,0.03); /* Subtle shadow */
-        }
-        
-        /* Standardize border radius for all content boxes */
-        .transcription-box, 
-        .summary-box, 
-        .chat-container,
-        textarea,
-        div[v-if="!editingParticipants"],
-        div[v-if="!editingNotes"] {
-            border-radius: 0.75rem !important; /* rounded-xl */
-        }
-        
-        /* Ensure consistent height for tab content boxes */
-        .tab-content-box {
-            height: 200px !important;
-            overflow-y: auto;
-        }
-        .chat-content-box {
-            height: 650px !important;
-            overflow-y: auto;
-        }
-        .metadata-panel {
-            background-color: var(--bg-tertiary);
-            border: 1px solid var(--border-primary);
-            border-radius: 0.75rem; /* rounded-xl to match others */
-            padding: 1rem; /* p-4 to be consistent */
-            /* margin-top removed to align with other boxes */
-            font-size: 0.875rem; /* text-sm */
-            color: var(--text-secondary);
-        }
-        .metadata-panel dt {
-            font-weight: 500;
-            color: var(--text-primary);
-            margin-bottom: 0.1rem;
-        }
-        .metadata-panel dd {
-            margin-left: 0;
-            margin-bottom: 0.5rem;
-            word-break: break-all; /* Wrap long filenames */
-        }
-         .status-badge {
-             display: inline-block;
-             padding: 0.15rem 0.6rem; /* Smaller padding */
-             font-size: 0.65rem; /* Smaller text */
-             font-weight: 500; /* font-medium */
-             border-radius: 9999px; /* rounded-full */
-             /* margin-top: 0.5rem; /* mt-2 */ /* Removed margin-top */
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             letter-spacing: 0.025em;
-             vertical-align: middle; /* Align with text */
-             margin-left: 0.75rem; /* Add some space */
-         }
-         .status-processing { color: #1d4ed8; background-color: #dbeafe; } /* text-blue-800 bg-blue-100 */
-         .status-summarizing { color: #92400e; background-color: #fef3c7; } /* text-amber-800 bg-amber-100 */
-         .status-completed { color: #065f46; background-color: #d1fae5; } /* text-green-800 bg-green-100 */
-         .status-failed { color: #991b1b; background-color: #fee2e2; } /* text-red-800 bg-red-100 */
-         .status-pending { color: #57534e; background-color: #f5f5f4; } /* text-stone-700 bg-stone-100 */
-         
-         /* Fixed height transcription box */
-         .transcription-box {
-             height: 400px;
-             overflow-y: auto;
-             position: relative;
-         }
-         
-         /* Modern copy button styles */
-         .copy-btn {
-             position: sticky;
-             top: 10px;
-             right: 10px;
-             float: right;
-             background-color: rgba(255, 255, 255, 0.9);
-             border: 1px solid #e5e7eb;
-             border-radius: 0.5rem;
-             padding: 0.35rem 0.75rem;
-             font-size: 0.75rem;
-             cursor: pointer;
-             z-index: 10;
-             transition: all 0.2s cubic-bezier(0.25, 0.1, 0.25, 1);
-             margin-bottom: 10px;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-         }
-         
-         .copy-btn:hover {
-             background-color: #f3f4f6;
-             transform: translateY(-1px);
-             box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-         }
-         
-         /* Hover edit button styles */
-         .content-box {
-             position: relative;
-         }
-         
-         .hover-edit-btn {
-             position: absolute;
-             top: 10px;
-             right: 10px;
-             background-color: rgba(255, 255, 255, 0.9);
-             border: 1px solid #e5e7eb;
-             border-radius: 0.5rem;
-             padding: 0.35rem 0.75rem;
-             font-size: 0.75rem;
-             cursor: pointer;
-             z-index: 10;
-             transition: all 0.2s ease;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             opacity: 0;
-         }
-         
-         .content-box:hover .hover-edit-btn {
-             opacity: 1;
-         }
-         
-         .hover-edit-btn:hover {
-             background-color: #f3f4f6;
-             transform: translateY(-1px);
-             box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-         }
-         
-         .dark .hover-edit-btn {
-             background-color: rgba(55, 65, 81, 0.9);
-             border-color: #4b5563;
-         }
-         
-         .dark .hover-edit-btn:hover {
-             background-color: #4b5563;
-         }
-         
-         /* Modern chat section styles */
-         .chat-container {
-             border: 1px solid #e5e7eb;
-             border-radius: 0.75rem;
-             display: flex;
-             flex-direction: column;
-             height: 100%;
-             box-shadow: 0 1px 3px rgba(0,0,0,0.05);
-             overflow: hidden;
-         }
-         
-         .chat-messages {
-             flex-grow: 1;
-             overflow-y: auto;
-             padding: 1.25rem;
-         }
-         
-         .chat-input-container {
-             border-top: 1px solid #e5e7eb;
-             padding: 0.75rem;
-             display: flex;
-             background-color: var(--bg-tertiary);
-         }
-         
-         .message {
-             margin-bottom: 1.25rem;
-             max-width: 80%;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             line-height: 1.5;
-         }
-         
-         .user-message {
-             background-color: #dbeafe;
-             border-radius: 1.25rem 1.25rem 0.25rem 1.25rem;
-             padding: 0.875rem 1rem;
-             margin-left: auto;
-         }
-         
-         .ai-message {
-             background-color: #f3f4f6;
-             border-radius: 1.25rem 1.25rem 1.25rem 0.25rem;
-             padding: 0.875rem 1rem;
-         }
-         
-         .copyable {
-             position: relative;
-         }
-         
-         /* Markdown styling */
-         .ai-message h1, .ai-message h2, .ai-message h3, 
-         .summary-box h1, .summary-box h2, .summary-box h3 {
-             font-weight: 600;
-             margin-top: 1rem;
-             margin-bottom: 0.5rem;
-         }
-         
-         .ai-message h1, .summary-box h1 { font-size: 1.25rem; }
-         .ai-message h2, .summary-box h2 { font-size: 1.15rem; }
-         .ai-message h3, .summary-box h3 { font-size: 1.05rem; }
-         
-         .ai-message p, .summary-box p {
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message ul, .ai-message ol,
-         .summary-box ul, .summary-box ol {
-             margin-left: 1.5rem;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message ul, .summary-box ul { list-style-type: disc; }
-         .ai-message ol, .summary-box ol { list-style-type: decimal; }
-         
-         .ai-message code, .summary-box code {
-             background-color: #f1f1f1;
-             padding: 0.1rem 0.3rem;
-             border-radius: 0.25rem;
-             font-family: monospace;
-             font-size: 0.9em;
-         }
-         
-         .ai-message pre, .summary-box pre {
-             background-color: #f1f1f1;
-             padding: 0.75rem;
-             border-radius: 0.25rem;
-             overflow-x: auto;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message pre code, .summary-box pre code {
-             background-color: transparent;
-             padding: 0;
-             border-radius: 0;
-         }
-         
-         .ai-message table, .summary-box table {
-             border-collapse: collapse;
-             width: 100%;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message th, .ai-message td,
-         .summary-box th, .summary-box td {
-             border: 1px solid #ddd;
-             padding: 0.5rem;
-             text-align: left;
-         }
-         
-         .ai-message th, .summary-box th {
-             background-color: #f1f1f1;
-             font-weight: 600;
-         }
-         
-         .ai-message blockquote, .summary-box blockquote {
-             border-left: 4px solid #ddd;
-             padding-left: 1rem;
-             margin-left: 0;
-             margin-bottom: 0.75rem;
-             color: #666;
-         }
-         
-         /* Modern toast notification styles */
-         .toast-container {
-             position: fixed;
-             bottom: 20px;
-             right: 20px;
-             z-index: 1000;
-             display: flex;
-             flex-direction: column;
-             align-items: flex-end;
-             gap: 12px;
-         }
-         
-         .toast {
-             padding: 12px 18px;
-             border-radius: 8px;
-             background-color: #4CAF50;
-             color: white;
-             font-size: 14px;
-             box-shadow: 0 4px 12px rgba(0,0,0,0.1);
-             opacity: 0;
-             transform: translateY(20px);
-             transition: all 0.3s cubic-bezier(0.25, 0.1, 0.25, 1);
-             display: flex;
-             align-items: center;
-             min-width: 200px;
-         }
-         
-         .toast.show {
-             opacity: 1;
-             transform: translateY(0);
-         }
-         
-         .toast i {
-             margin-right: 8px;
-         }
-         
-         /* Copy button animation */
-         @keyframes copy-success {
-             0% { transform: scale(1); }
-             50% { transform: scale(1.2); }
-             100% { transform: scale(1); }
-         }
-         
-         .copy-success {
-             animation: copy-success 0.3s ease;
-             color: #4CAF50 !important;
-         }
-
-    </style>
-</head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div id="app" class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-             <h1 class="text-3xl font-bold text-[var(--text-primary)] cursor-pointer" @click="switchToGalleryView" title="Go to Gallery">
-                Speakr
-            </h1>
-            <div class="flex items-center space-x-2">
-                 <button @click="toggleDarkMode" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isDarkMode ? 'Switch to Light Mode' : 'Switch to Dark Mode'">
-                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
-                </button>
-                {% if current_user.is_authenticated %}
-                <button @click="switchToUploadView" class="px-4 py-2 mr-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                    <i class="fas fa-plus mr-1"></i> New Recording
-                </button>
-                <button
-                    @click="switchToGalleryView"
-                    :class="{
-                        'bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)]': currentView !== 'gallery',
-                        'bg-[var(--bg-accent)] text-[var(--text-accent)] border border-[var(--border-accent)]': currentView === 'gallery'
-                    }"
-                    class="px-4 py-2 rounded-lg shadow-sm hover:bg-[var(--bg-tertiary)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-1 transition duration-150 ease-in-out">
-                    <i class="fas fa-images mr-1"></i> Gallery
-                </button>
-                <!-- User dropdown menu -->
-                <div class="relative ml-2">
-                    <button @click="isUserMenuOpen = !isUserMenuOpen" class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
-                        <i class="fas fa-user mr-2"></i>
-                        <span>{{ current_user.username }}</span>
-                        <i class="fas fa-chevron-down ml-2"></i>
-                    </button>
-                    <div v-if="isUserMenuOpen" class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-circle mr-2"></i> Account
-                        </a>
-                        {% if current_user.is_admin %}
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
-                        </a>
-                        {% endif %}
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
-                        </a>
-                    </div>
-                </div>
-                {% else %}
-                <a href="{{ url_for('login') }}" class="px-4 py-2 ml-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                    <i class="fas fa-sign-in-alt mr-1"></i> Login
-                </a>
-                <a href="{{ url_for('register') }}" class="px-4 py-2 ml-2 text-[var(--text-secondary)] hover:text-[var(--text-accent)] border border-[var(--border-secondary)] rounded-lg">
-                    <i class="fas fa-user-plus mr-1"></i> Register
-                </a>
-                {% endif %}
-            </div>
-        </header>
-
-        <div v-if="globalError" class="mb-4 p-4 bg-[var(--bg-danger-light)] border border-[var(--border-danger)] text-[var(--text-danger-strong)] rounded-lg" role="alert">
-             <div class="flex justify-between items-center">
-                <div>
-                    <strong class="font-bold">Error:</strong>
-                    <span class="block sm:inline ml-2">${ globalError }</span>
-                </div>
-                <button @click="globalError = null" class="text-[var(--text-danger-strong)] hover:text-[var(--text-danger)] font-bold">&times;</button>
-            </div>
-        </div>
-
-        <!-- Sidebar toggle button will be positioned relative to the main container -->
-
-        <main class="flex-grow"
-             @dragover.prevent="dragover = true"
-             @dragleave.prevent="handleDragLeave"
-             @drop.prevent="handleDrop">
-
-            <div v-if="dragover" class="absolute inset-0 flex items-center justify-center bg-[var(--border-focus)]/20 z-10 rounded-lg pointer-events-none border-4 border-dashed border-[var(--border-focus)]">
-                <div class="text-center p-6 bg-[var(--bg-secondary)] rounded-lg shadow-xl">
-                    <i class="fas fa-upload text-4xl text-[var(--text-accent)] mb-3"></i>
-                    <p class="text-xl font-semibold text-[var(--text-secondary)]">Drop audio file(s) here to upload</p>
-                </div>
-            </div>
-
-            {% if current_user.is_authenticated %}
-            <div v-if="currentView === 'gallery'" class="flex-grow flex flex-col rounded-lg relative">
-                <!-- Sidebar toggle button that appears when sidebar is collapsed - positioned at the left edge of main content, aligned with title -->
-                <button v-if="isSidebarCollapsed" 
-                        @click="toggleSidebar" 
-                        class="absolute -left-3 top-6 z-20 bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-secondary)] p-2 pl-1 pr-3 rounded-r-lg shadow-lg text-[var(--text-accent)] hover:text-[var(--text-primary)] hover:shadow-xl transition-all duration-300 transform hover:translate-x-1 border-r border-t border-b border-[var(--border-accent)]"
-                        title="Show Sidebar">
-                    <i class="fas fa-chevron-right"></i>
-                </button>
-                
-                <div class="grid grid-cols-1 lg:grid-cols-4 gap-6 flex-grow">
-                    <div v-show="!isSidebarCollapsed" class="lg:col-span-1 bg-[var(--bg-secondary)] p-4 rounded-lg shadow-md flex flex-col relative">
-                         <div class="flex justify-between items-center mb-4 sticky top-0 bg-[var(--bg-secondary)] pb-3 border-b border-[var(--border-primary)]">
-                            <h3 class="text-lg font-semibold text-[var(--text-primary)]">Recordings</h3>
-                            <button @click="toggleSidebar" class="p-1 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isSidebarCollapsed ? 'Show Sidebar' : 'Hide Sidebar'">
-                                <i class="fas fa-chevron-left"></i>
-                             </button>
-                        </div>
-                         <div v-if="isLoadingRecordings" class="text-center text-[var(--text-muted)] py-4">
-                            <i class="fas fa-spinner fa-spin mr-2"></i> Loading recordings...
-                        </div>
-                        <div v-else-if="recordings.length === 0 && uploadQueue.length === 0" class="text-center text-[var(--text-muted)] py-4 flex-grow flex flex-col items-center justify-center">
-                             <i class="fas fa-folder-open text-4xl text-[var(--text-light)] mb-3"></i>
-                            <p>No recordings yet.</p>
-                            <p>Upload one or drag & drop anywhere!</p>
-                        </div>
-                        <div v-else class="space-y-4 overflow-y-auto custom-scrollbar flex-grow pr-1">
-                            <div v-for="group in groupedRecordings" :key="group.title" class="mb-3">
-                                <h4 class="font-medium text-[var(--text-muted)] text-xs uppercase tracking-wider mb-2 sticky top-0 bg-[var(--bg-secondary)] py-1">${ group.title }</h4>
-                                <ul class="space-y-1">
-                                    <li v-for="recording in group.items"
-                                        :key="recording.id"
-                                        @click="selectRecording(recording)"
-                                        class="cursor-pointer p-3 rounded-md flex justify-between items-center transition duration-150 ease-in-out"
-                                        :class="{
-                                            'bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] ring-1 ring-[var(--border-accent)] text-[var(--text-accent)]': selectedRecording?.id === recording.id,
-                                            'hover:bg-[var(--bg-tertiary)] text-[var(--text-primary)]': selectedRecording?.id !== recording.id
-                                        }">
-                                         <div class="flex items-center overflow-hidden mr-2">
-                                            <i class="fas fa-file-audio text-[var(--text-accent)] mr-2 flex-shrink-0"></i>
-                                            <span class="text-sm font-medium truncate" :title="recording.title || 'Loading title...'">${ recording.title || '(Processing...)' }</span>
-                                        </div>
-                                        <div class="flex space-x-2 flex-shrink-0 items-center">
-                                            <span v-if="recording.status === 'PROCESSING'" class="text-xs text-[var(--text-info-strong)] italic flex items-center" title="Transcribing...">
-                                                 <i class="fas fa-spinner fa-spin mr-1"></i> Transcribing
-                                            </span>
-                                             <span v-else-if="recording.status === 'SUMMARIZING'" class="text-xs text-[var(--text-warn-strong)] italic flex items-center" title="Generating Summary...">
-                                                <i class="fas fa-spinner fa-spin mr-1"></i> Summarizing
-                                            </span>
-                                            <span v-else-if="recording.status === 'PENDING'" class="text-xs text-[var(--text-pending-strong)] italic flex items-center" title="Waiting...">
-                                                <i class="fas fa-clock mr-1"></i> Pending
-                                            </span>
-                                            <span v-else-if="recording.status === 'FAILED'" class="text-xs text-[var(--text-danger-strong)] italic flex items-center" title="Processing Failed">
-                                                <i class="fas fa-exclamation-triangle mr-1"></i> Failed
-                                            </span>
-                                            <span v-else-if="recording.status === 'COMPLETED'" class="text-xs text-[var(--text-success-strong)]" title="Completed">
-                                                <i class="fas fa-check-circle"></i>
-                                            </span>
-                                             <button @click.stop="editRecording(recording)" class="text-[var(--text-muted)] hover:text-[var(--text-accent)] text-xs p-1 rounded hover:bg-[var(--bg-tertiary)]" title="Edit Details">
-                                                <i class="fas fa-edit"></i>
-                                            </button>
-                                            <button @click.stop="confirmDelete(recording)" class="text-[var(--text-muted)] hover:text-[var(--text-danger)] text-xs p-1 rounded hover:bg-[var(--bg-tertiary)]" title="Delete Recording">
-                                                <i class="fas fa-trash"></i>
-                                            </button>
-                                        </div>
-                                    </li>
-                                </ul>
-                            </div>
-                        </div>
-                    </div>
-
-                     <div :class="isSidebarCollapsed ? 'lg:col-span-4' : 'lg:col-span-3'" class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-md flex flex-col">
-                        <div v-if="selectedRecording" class="flex-grow flex flex-col">
-                            <div class="flex flex-col sm:flex-row justify-between items-start mb-4 border-b border-[var(--border-primary)] pb-4">
-                                <div class="mb-3 sm:mb-0 max-w-lg">
-                                     <h3 class="text-2xl font-semibold text-[var(--text-primary)]">${ selectedRecording.title || 'Loading...' }</h3>
-                                    <p class="text-sm text-[var(--text-muted)] mt-1">
-                                        <!-- Display Meeting Date with edit functionality -->
-                                        <span>
-                                            <i class="fas fa-calendar-alt mr-1"></i> 
-                                            <span v-if="!editingMeetingDate">
-                                                Meeting Date: 
-                                                <span @click="toggleEditMeetingDate" class="cursor-pointer hover:text-[var(--text-accent)]">
-                                                    ${ selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'Click to add' }
-                                                </span> | 
-                                            </span>
-                                            <span v-else class="inline-flex items-center">
-                                                <input type="date" v-model="selectedRecording.meeting_date" 
-                                                    @blur="saveInlineEdit('meeting_date')" 
-                                                    class="p-0 w-40 bg-transparent border-b border-[var(--border-secondary)] focus:outline-none focus:border-[var(--border-focus)]" />
-                                                <button @click="saveInlineEdit('meeting_date')" class="ml-1 text-xs text-[var(--text-accent)]">
-                                                    <i class="fas fa-check"></i>
-                                                </button>
-                                            </span>
-                                        </span>
-                                        Created: ${ new Date(selectedRecording.created_at).toLocaleString() }
-                                        <!-- Status Badge Moved Here -->
-                                        <span :class="getStatusClass(selectedRecording.status)" class="status-badge">
-                                            ${ formatStatus(selectedRecording.status) }
-                                        </span>
-                                    </p>
-                                    <!-- Removed Size from here -->
-                                    <!-- Removed separate Status Badge span -->
-                                </div>
-                                <div class="flex space-x-2 flex-shrink-0">
-                                    <button @click="editRecording(selectedRecording)" class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] text-sm shadow-sm">
-                                        <i class="fas fa-edit mr-1"></i> Edit Details
-                                    </button>
-                                    <button @click="confirmDelete(selectedRecording)" class="px-3 py-1.5 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)] text-sm shadow-sm">
-                                        <i class="fas fa-trash mr-1"></i> Delete
-                                    </button>
-                                </div>
-                            </div>
-
-                            <!-- Adjusted Grid: md:grid-cols-5 -> Transcription (2), Right Panel (3) -->
-                            <div class="grid md:grid-cols-5 gap-6 flex-grow overflow-hidden">
-                                <!-- Left Column: Participants, Transcription, Summary & Notes -->
-                                <div class="md:col-span-2 flex flex-col overflow-hidden space-y-4">
-                                    <div>
-                                        <div class="flex justify-between items-center mb-1">
-                                            <h4 class="font-semibold text-[var(--text-secondary)]">Participants</h4>
-                                            <button @click="toggleEditParticipants" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-accent)] p-1 rounded">
-                                                <i class="fas" :class="editingParticipants ? 'fa-check' : 'fa-edit'"></i>
-                                            </button>
-                                        </div>
-                                        <div v-if="!editingParticipants" class="text-sm bg-[var(--bg-tertiary)] p-3 rounded-xl border border-[var(--border-primary)] min-h-[40px] text-[var(--text-secondary)]">${ selectedRecording.participants || 'None specified' }</div>
-                                        <textarea v-else v-model="selectedRecording.participants" @blur="saveInlineEdit('participants')" class="text-sm bg-[var(--bg-tertiary)] p-3 rounded border border-[var(--border-primary)] min-h-[40px] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] text-[var(--text-secondary)]" placeholder="Enter participants"></textarea>
-                                    </div>
-                                    <div>
-                                        <div class="flex justify-between items-center mb-1">
-                                            <h4 class="font-semibold text-[var(--text-secondary)]">Transcription</h4>
-                                            <button @click="copyTranscription($event)" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-accent)] p-1 rounded" title="Copy to clipboard">
-                                                <i class="fas fa-copy"></i>
-                                            </button>
-                                        </div>
-                                        <div class="transcription-box p-4 bg-[var(--bg-tertiary)] rounded border border-[var(--border-primary)] text-sm custom-scrollbar relative text-[var(--text-secondary)]">
-                                            <div v-if="selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'SUMMARIZING'" class="copyable">
-                                                <pre class="whitespace-pre-wrap font-sans">${ selectedRecording.transcription || 'No transcription available.' }</pre>
-                                            </div>
-                                            <div v-else-if="selectedRecording.status === 'FAILED'" class="text-[var(--text-danger)]">
-                                                <p class="font-medium mb-2">Processing Failed:</p>
-                                                <pre class="whitespace-pre-wrap font-sans">${ selectedRecording.transcription || 'An unknown error occurred.' }</pre>
-                                            </div>
-                                            <div v-else class="flex items-center justify-center text-[var(--text-muted)] h-full">
-                                                <i class="fas fa-spinner fa-spin mr-2"></i> Transcription in progress...
-                                            </div>
-                                        </div>
-                                    </div>
-                                    
-                                    <!-- Tabs for Summary and Notes (Moved from right column) -->
-                                    <div class="flex flex-col overflow-hidden">
-                                        <div class="border-b border-[var(--border-primary)]">
-                                            <nav class="-mb-px flex space-x-4" aria-label="Tabs">
-                                                <button @click="selectedTab = 'summary'" 
-                                                        :class="selectedTab === 'summary' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Summary
-                                                </button>
-                                                <button @click="selectedTab = 'notes'" 
-                                                        :class="selectedTab === 'notes' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Notes
-                                                </button>
-                                                <button @click="selectedTab = 'metadata'" 
-                                                        :class="selectedTab === 'metadata' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Metadata
-                                                </button>
-                                            </nav>
-                                        </div>
-                                        <div class="pt-4">
-                                            <!-- Summary Panel -->
-                                            <div v-show="selectedTab === 'summary'" class="overflow-hidden">
-                                                <div v-if="selectedRecording.status === 'COMPLETED'">
-                                                    <div v-if="!editingSummary" class="content-box">
-                                                        <div class="summary-box custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] text-[var(--text-secondary)] tab-content-box" v-html="selectedRecording.summary_html || selectedRecording.summary || 'No summary generated.'">
-                                                        </div>
-                                                        <button @click="toggleEditSummary" class="hover-edit-btn text-[var(--text-muted)] hover:text-[var(--text-accent)]" title="Edit Summary">
-                                                            <i class="fas fa-edit"></i>
-                                                        </button>
-                                                    </div>
-                                                    <textarea v-else v-model="selectedRecording.summary" @blur="saveInlineEdit('summary')" class="summary-box custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] text-[var(--text-secondary)] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] tab-content-box" placeholder="Enter summary"></textarea>
-                                                </div>
-                                                <div v-else-if="selectedRecording.status === 'FAILED'" class="summary-box text-[var(--text-danger)] custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] tab-content-box" v-html="selectedRecording.summary_html || selectedRecording.summary || 'Summary generation failed or was skipped.'">
-                                                </div>
-                                                <div v-else class="h-24 flex items-center justify-center p-4 bg-[var(--bg-tertiary)] rounded border border-[var(--border-primary)] text-[var(--text-muted)]">
-                                                    <i class="fas fa-spinner fa-spin mr-2"></i> Summary pending...
-                                                </div>
-                                                
-                                            </div>
-                                            
-                                            <!-- Notes Panel -->
-                                            <div v-show="selectedTab === 'notes'" class="overflow-hidden">
-                                                <div v-if="!editingNotes" class="content-box">
-                                                    <div class="text-sm bg-[var(--bg-tertiary)] p-4 rounded-xl border border-[var(--border-primary)] custom-scrollbar text-[var(--text-secondary)] tab-content-box" v-html="selectedRecording.notes_html || selectedRecording.notes || 'No notes'"></div>
-                                                    <button @click="toggleEditNotes" class="hover-edit-btn text-[var(--text-muted)] hover:text-[var(--text-accent)]" title="Edit Notes">
-                                                        <i class="fas fa-edit"></i>
-                                                    </button>
-                                                </div>
-                                                <textarea v-else v-model="selectedRecording.notes" @blur="saveInlineEdit('notes')" class="text-sm bg-[var(--bg-tertiary)] p-4 rounded border border-[var(--border-primary)] custom-scrollbar text-[var(--text-secondary)] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] tab-content-box" placeholder="Enter notes"></textarea>
-                                            </div>
-                                            
-                                            <!-- Metadata Panel (in separate tab) -->
-                                            <div v-show="selectedTab === 'metadata'" class="overflow-hidden">
-                                                <div class="metadata-panel custom-scrollbar tab-content-box">
-                                                    <dl>
-                                                        <div v-if="selectedRecording.original_filename">
-                                                            <dt>Original Filename</dt>
-                                                            <dd>${ selectedRecording.original_filename }</dd>
-                                                        </div>
-                                                        <div>
-                                                            <dt>File Size</dt>
-                                                            <dd>${ formatFileSize(selectedRecording.file_size) }</dd>
-                                                        </div>
-                                                    </dl>
-                                                </div>
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-
-                                <!-- Right Column: Audio & Chat -->
-                                <div class="md:col-span-3 flex flex-col space-y-4 overflow-hidden">
-                                    <div>
-                                        <h4 class="font-semibold text-[var(--text-secondary)] mb-2">Audio Player</h4>
-                                        <!-- Beautified audio player container -->
-                                        <div class="bg-[var(--bg-audio-player)] p-3 rounded-lg shadow border border-[var(--border-primary)]">
-                                            <audio controls class="w-full h-10" :key="selectedRecording.id" :src="'/audio/' + selectedRecording.id">
-                                                Your browser does not support the audio element.
-                                            </audio>
-                                        </div>
-                                    </div>
-
-                                    <!-- Chat Section (Fixed height to match left column) -->
-                                    <div class="flex flex-col overflow-hidden">
-                                        <h4 class="font-semibold text-[var(--text-secondary)] mb-2 flex-shrink-0">Chat with Transcript</h4>
-                                        <!-- Chat container with fixed height matching left column -->
-                                        <div class="chat-container border-[var(--border-primary)] bg-[var(--bg-secondary)] chat-content-box"> 
-                                            <div class="chat-messages custom-scrollbar" ref="chatMessagesRef">
-                                                <div v-if="chatMessages.length === 0" class="flex items-center justify-center h-full text-[var(--text-muted)]">
-                                                    <div class="text-center">
-                                                        <i class="fas fa-comments text-2xl mb-2"></i>
-                                                        <p>Ask questions about the transcript</p>
-                                                    </div>
-                                                </div>
-                                                <div v-for="(message, index) in chatMessages" :key="index" class="message" :class="message.role === 'user' ? 'user-message bg-[var(--bg-accent)] text-[var(--text-accent)]' : 'ai-message bg-[var(--bg-tertiary)] text-[var(--text-secondary)]'">
-                                                    <div class="flex justify-between items-start">
-                                                        <div class="flex-grow" v-if="message.role === 'user'">${ message.content }</div>
-                                                        <div class="flex-grow" v-else v-html="message.html || message.content"></div>
-                                                        <button v-if="message.role === 'assistant'" @click="copyMessage(message.content, $event)" class="ml-2 text-[var(--text-light)] hover:text-[var(--text-muted)]" title="Copy response">
-                                                            <i class="fas fa-copy text-xs"></i>
-                                                        </button>
-                                                    </div>
-                                                </div>
-                                                <div v-if="isChatLoading" class="message ai-message bg-[var(--bg-tertiary)] text-[var(--text-secondary)]">
-                                                    <div class="flex items-center">
-                                                        <i class="fas fa-spinner fa-spin mr-2"></i> Thinking...
-                                                    </div>
-                                                </div>
-                                            </div>
-                                            <div class="chat-input-container border-t-[var(--border-primary)]">
-                                                <input 
-                                                    v-model="chatInput" 
-                                                    @keyup.enter="sendChatMessage"
-                                                    type="text" 
-                                                    placeholder="Ask about the transcript..." 
-                                                    class="flex-grow px-3 py-2 border-0 focus:ring-0 focus:outline-none bg-[var(--bg-input)] text-[var(--text-primary)] placeholder-[var(--text-muted)]"
-                                                    :disabled="isChatLoading || !selectedRecording || selectedRecording.status !== 'COMPLETED'"
-                                                >
-                                                <button 
-                                                    @click="sendChatMessage" 
-                                                    class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed"
-                                                    :disabled="!chatInput.trim() || isChatLoading || !selectedRecording || selectedRecording.status !== 'COMPLETED'"
-                                                >
-                                                    <i class="fas fa-paper-plane"></i>
-                                                </button>
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                        <div v-else class="flex flex-col items-center justify-center text-center text-[var(--text-muted)] flex-grow">
-                             <i class="fas fa-hand-pointer text-4xl text-[var(--text-light)] mb-4"></i>
-                            <p class="text-lg font-medium mb-2">Select a recording from the list to view details.</p>
-                            <p>Or, drag and drop audio file(s) anywhere on this page to upload.</p>
-                        </div>
-                    </div>
-                </div>
-            </div>
-
-             <div v-if="currentView === 'upload'"
-                 class="flex-grow flex items-center justify-center p-4">
-                 <div class="w-full max-w-lg bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)] text-center drag-area"
-                     :class="{'border-[var(--border-focus)] bg-[var(--bg-accent)]': dragover}">
-                    <div class="py-8">
-                        <i class="fas fa-cloud-upload-alt text-5xl mb-5 text-[var(--text-accent)]"></i>
-                         <h2 class="text-xl font-semibold text-[var(--text-secondary)] mb-2">Upload New Recordings</h2>
-                        <p class="text-[var(--text-muted)] mb-4">Drag & drop your audio files here or click below.</p>
-                         <input type="file" @change="handleFileSelect" accept="audio/*" class="hidden" ref="fileInput" multiple>
-                        <button @click="$refs.fileInput.click()" class="mt-4 px-6 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] shadow-sm transition duration-150 ease-in-out">
-                            <i class="fas fa-file-import mr-2"></i> Select Files
-                        </button>
-                         <p class="text-xs text-[var(--text-light)] mt-4">Max file size per file: ${ maxFileSizeMB } MB</p>
-                    </div>
-                </div>
-            </div>
-
-            {% else %}
-            <div class="flex-grow flex items-center justify-center">
-                <div class="text-center max-w-lg p-8 bg-[var(--bg-secondary)] rounded-xl shadow-lg border border-[var(--border-primary)]">
-                    <i class="fas fa-lock text-5xl mb-4 text-[var(--text-accent)]"></i>
-                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Welcome to Speakr</h2>
-                    <p class="text-[var(--text-secondary)] mb-6">
-                        Speakr is an audio transcription and summarization app that helps you convert your audio recordings into text and generate summaries.
-                    </p>
-                    <div class="flex flex-col sm:flex-row justify-center space-y-3 sm:space-y-0 sm:space-x-4">
-                        <a href="{{ url_for('login') }}" class="px-6 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                            <i class="fas fa-sign-in-alt mr-2"></i> Login
-                        </a>
-                        <a href="{{ url_for('register') }}" class="px-6 py-2 text-[var(--text-secondary)] hover:text-[var(--text-accent)] border border-[var(--border-secondary)] rounded-lg">
-                            <i class="fas fa-user-plus mr-2"></i> Register
-                        </a>
-                    </div>
-                </div>
-            </div>
-            {% endif %}
-            </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; ${ new Date().getFullYear() }
-        </footer>
-
-         <div v-if="showEditModal" class="fixed inset-0 bg-black bg-opacity-60 flex items-center justify-center z-50 p-4">
-             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-lg max-h-[90vh] overflow-y-auto custom-scrollbar">
-                 <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Edit Recording Details</h3>
-                    <button @click="cancelEdit" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
-                </div>
-                <div v-if="editingRecording" class="space-y-4">
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Title</label>
-                        <input v-model="editingRecording.title" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Participants</label>
-                        <input v-model="editingRecording.participants" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <!-- Add Meeting Date Input -->
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Meeting Date</label>
-                        <input type="date" v-model="editingRecording.meeting_date" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                     <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Summary</label>
-                        <textarea v-model="editingRecording.summary" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]" rows="5"></textarea>
-                    </div>
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Notes</label>
-                        <textarea v-model="editingRecording.notes" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]" rows="4"></textarea>
-                    </div>
-                    <div class="flex justify-end space-x-3 pt-4">
-                        <button @click="cancelEdit" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                        <button @click="saveEdit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Save Changes</button>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <div v-if="showDeleteModal" class="fixed inset-0 bg-black bg-opacity-60 flex items-center justify-center z-50 p-4">
-             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl max-w-md w-full">
-                <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-4">Confirm Delete</h3>
-                 <p v-if="recordingToDelete" class="mb-2 text-[var(--text-secondary)]">Are you sure you want to permanently delete the recording titled "<strong>${ recordingToDelete.title }</strong>"?</p>
-                <p class="text-sm text-[var(--text-danger)] mb-6">This action cannot be undone and will delete the record, transcription, summary, and the audio file.</p>
-                <div class="flex justify-end space-x-3">
-                    <button @click="cancelDelete" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                    <button @click="deleteRecording" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">Delete Permanently</button>
-                </div>
-            </div>
-        </div>
-
-        <div v-if="(uploadQueue.length > 0 || currentlyProcessingFile) && !progressPopupClosed"
-             class="progress-popup bg-[var(--bg-secondary)] rounded-lg shadow-xl border border-[var(--border-primary)] overflow-hidden"
-             :class="{ 'minimized': progressPopupMinimized }">
-
-            <div class="flex justify-between items-center p-2 bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)]">
-                <h4 class="text-sm font-semibold text-[var(--text-secondary)] cursor-pointer" @click="progressPopupMinimized = !progressPopupMinimized">
-                    <i class="fas fa-upload mr-2 text-[var(--text-accent)]"></i>
-                    Upload & Process Progress (${ completedInQueue }/${ totalInQueue } completed)
-                </h4>
-                <div class="flex items-center">
-                    <button class="text-[var(--text-muted)] hover:text-[var(--text-secondary)] mr-2" @click="progressPopupMinimized = !progressPopupMinimized">
-                        <i :class="progressPopupMinimized ? 'fa-chevron-up' : 'fa-chevron-down'" class="fas fa-fw"></i>
-                    </button>
-                    <button class="text-[var(--text-muted)] hover:text-[var(--text-danger)]" @click="progressPopupClosed = true" title="Close">
-                        <i class="fas fa-times fa-fw"></i>
-                    </button>
-                </div>
-            </div>
-
-             <div class="p-3 max-h-60 overflow-y-auto custom-scrollbar" v-show="!progressPopupMinimized">
-                 <div v-if="currentlyProcessingFile" class="mb-3 pb-3 border-b border-dashed border-[var(--border-secondary)]">
-                    <div class="flex items-center justify-between mb-1">
-                        <p class="text-xs font-medium text-[var(--text-primary)] truncate mr-2" :title="currentlyProcessingFile.file.name">
-                            <i class="fas fa-spinner fa-spin text-[var(--text-accent)] mr-1"></i> Processing: ${ currentlyProcessingFile.file.name }
-                        </p>
-                        <span class="text-xs text-[var(--text-muted)] flex-shrink-0">${ formatFileSize(currentlyProcessingFile.file.size) }</span>
-                    </div>
-                     <p class="text-xs text-[var(--text-secondary)] mb-1 italic">${ processingMessage }</p>
-                    <div class="w-full bg-[var(--border-primary)] rounded-full h-1.5">
-                         <div class="bg-[var(--text-accent)] h-1.5 rounded-full transition-all duration-300" :style="{ width: processingProgress + '%' }"></div>
-                    </div>
-                </div>
-
-                 <div v-if="queuedFiles.length > 0" class="mb-2">
-                    <p class="text-xs font-semibold text-[var(--text-muted)] mb-1">${ queuedFiles.length } file(s) queued:</p>
-                    <ul class="space-y-1">
-                        <li v-for="item in queuedFiles" :key="item.clientId" class="text-xs text-[var(--text-secondary)] progress-list-item">
-                            <i class="fas fa-clock text-[var(--text-light)] fa-fw"></i>
-                            <span class="truncate" :title="item.file.name">${ item.file.name }</span>
-                            <span class="text-[var(--text-light)] flex-shrink-0">${ formatFileSize(item.file.size) }</span>
-                        </li>
-                    </ul>
-                </div>
-
-                <div v-if="finishedFilesInQueue.length > 0" class="mt-2 pt-2 border-t border-dashed border-[var(--border-secondary)]">
-                    <p class="text-xs font-semibold text-[var(--text-muted)] mb-1">Recently finished:</p>
-                    <ul class="space-y-1">
-                         <li v-for="item in finishedFilesInQueue.slice(-5)" :key="item.clientId" class="text-xs progress-list-item">
-                             <i v-if="item.status === 'completed'" class="fas fa-check-circle text-[var(--text-success-strong)] fa-fw"></i>
-                            <i v-else-if="item.status === 'failed'" class="fas fa-exclamation-triangle text-[var(--text-danger-strong)] fa-fw"></i>
-                             <i v-else class="fas fa-question-circle text-[var(--text-light)] fa-fw"></i>
-                            <span class="truncate text-[var(--text-secondary)]" :title="item.file.name">${ item.file.name }</span>
-                             <span v-if="item.status === 'failed'" class="text-[var(--text-danger)] text-xs italic flex-shrink-0">Failed</span>
-                            <span v-else class="text-[var(--text-light)] flex-shrink-0">${ formatFileSize(item.file.size) }</span>
-                        </li>
-                    </ul>
-                </div>
-
-                 <div v-if="uploadQueue.length > 0 && queuedFiles.length === 0 && !currentlyProcessingFile" class="text-xs text-center text-[var(--text-muted)] py-2">
-                    All uploads processed.
-                </div>
-            </div>
-        </div>
-
-    </div>
-    
-    <!-- Toast container for notifications -->
-    <div class="toast-container" id="toastContainer"></div>
-    
-    {% raw %}
-    <script>
-        const { createApp, ref, reactive, computed, onMounted, watch, nextTick } = Vue
-
-        createApp({
-            setup() {
-                const currentView = ref('gallery');
-                const dragover = ref(false);
-                const recordings = ref([]);
-                const selectedRecording = ref(null);
-                const selectedTab = ref('summary'); // For Summary/Notes tabs
-
-                // --- Multi-Upload State ---
-                // Status: 'queued'|'uploading'|'processing'|'summarizing'|'completed'|'failed'
-                const uploadQueue = ref([]);
-                const currentlyProcessingFile = ref(null);
-                const processingProgress = ref(0);
-                const processingMessage = ref('');
-                const isProcessingActive = ref(false);
-                const pollInterval = ref(null);
-                const progressPopupMinimized = ref(false);
-
-                const showEditModal = ref(false);
-                const showDeleteModal = ref(false);
-                const editingRecording = ref(null); // Holds a *copy* for the modal
-                const recordingToDelete = ref(null);
-                // const autoSaveTimeout = ref(null); // Autosave not implemented for modal
-                const isLoadingRecordings = ref(true);
-                const globalError = ref(null);
-                const maxFileSizeMB = ref(250); // Default, could fetch from config if needed
-                const isDarkMode = ref(false); // Dark mode state
-                const isSidebarCollapsed = ref(false); // Sidebar state
-                const isUserMenuOpen = ref(false); // User dropdown menu state
-                
-                // Inline editing state
-                const editingParticipants = ref(false);
-                const editingMeetingDate = ref(false);
-                const editingSummary = ref(false);
-                const editingNotes = ref(false);
-
-                // --- Computed Properties ---
-                const groupedRecordings = computed(() => {
-                    const sortedRecordings = [...recordings.value].sort((a, b) => new Date(b.created_at) - new Date(a.created_at));
-                    // Grouping logic (same as before)...
-                    const groups = { today: [], yesterday: [], thisWeek: [], older: [] };
-                    const now = new Date();
-                    const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());
-                    const yesterdayStart = new Date(todayStart);
-                    yesterdayStart.setDate(todayStart.getDate() - 1);
-                    const currentDayOfWeek = now.getDay();
-                    const daysToSubtract = currentDayOfWeek === 0 ? 6 : currentDayOfWeek - 1;
-                    const weekStart = new Date(todayStart);
-                    weekStart.setDate(todayStart.getDate() - daysToSubtract);
-
-                    sortedRecordings.forEach(r => {
-                         const date = new Date(r.created_at);
-                        if (date >= todayStart) groups.today.push(r);
-                        else if (date >= yesterdayStart) groups.yesterday.push(r);
-                        else if (date >= weekStart) groups.thisWeek.push(r);
-                        else groups.older.push(r);
-                    });
-                     return [
-                        { title: 'Today', items: groups.today },
-                        { title: 'Yesterday', items: groups.yesterday },
-                        { title: 'This Week', items: groups.thisWeek },
-                        { title: 'Older', items: groups.older }
-                    ].filter(g => g.items.length > 0);
-                });
-
-                 const totalInQueue = computed(() => uploadQueue.value.length);
-                const completedInQueue = computed(() => uploadQueue.value.filter(item => item.status === 'completed' || item.status === 'failed').length);
-                const queuedFiles = computed(() => uploadQueue.value.filter(item => item.status === 'queued'));
-                // Filter finished: includes completed and failed
-                 const finishedFilesInQueue = computed(() => uploadQueue.value.filter(item => ['completed', 'failed'].includes(item.status)));
-
-
-                // --- Methods ---
-                const setGlobalError = (message, duration = 7000) => {
-                     globalError.value = message;
-                     if (duration > 0) {
-                        setTimeout(() => { if (globalError.value === message) globalError.value = null; }, duration);
-                    }
-                };
-
-                 const formatFileSize = (bytes) => {
-                     if (bytes == null || bytes === 0) return '0 Bytes';
-                    const k = 1024;
-                    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-                     if (bytes < 0) bytes = 0;
-                    const i = bytes === 0 ? 0 : Math.max(0, Math.floor(Math.log(bytes) / Math.log(k)));
-                     const size = i === 0 ? bytes : parseFloat((bytes / Math.pow(k, i)).toFixed(2));
-                    return size + ' ' + sizes[i];
-                };
-
-                // --- Dark Mode ---
-                const toggleDarkMode = () => {
-                    isDarkMode.value = !isDarkMode.value;
-                    if (isDarkMode.value) {
-                        document.documentElement.classList.add('dark');
-                        localStorage.setItem('darkMode', 'true');
-                    } else {
-                        document.documentElement.classList.remove('dark');
-                        localStorage.setItem('darkMode', 'false');
-                    }
-                };
-
-                const initializeDarkMode = () => {
-                    const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-                    const savedMode = localStorage.getItem('darkMode');
-                    if (savedMode === 'true' || (savedMode === null && prefersDark)) {
-                        isDarkMode.value = true;
-                        document.documentElement.classList.add('dark');
-                    } else {
-                        isDarkMode.value = false;
-                        document.documentElement.classList.remove('dark');
-                    }
-                };
-                // --- End Dark Mode ---
-
-                // --- Sidebar Toggle ---
-                const toggleSidebar = () => {
-                    isSidebarCollapsed.value = !isSidebarCollapsed.value;
-                    // Optional: Save state to localStorage if persistence is desired
-                    // localStorage.setItem('sidebarCollapsed', isSidebarCollapsed.value);
-                };
-                // --- End Sidebar Toggle ---
-                
-                // Helper to format date for display (e.g., "May 4, 2025")
-                const formatDisplayDate = (dateString) => {
-                    if (!dateString) return '';
-                    try {
-                        // Input is expected as 'YYYY-MM-DD'
-                        const date = new Date(dateString + 'T00:00:00'); // Add time to avoid timezone issues
-                        return date.toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' });
-                    } catch (e) {
-                        console.error("Error formatting date:", e);
-                        return dateString; // Return original string if formatting fails
-                    }
-                };
-
-                // Helper for status display
-                 const formatStatus = (status) => {
-                     if (!status) return 'Unknown';
-                     // Capitalize first letter, handle 'SUMMARIZING' specifically
-                     return status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
-                };
-
-                // Helper for status badge class
-                const getStatusClass = (status) => {
-                    switch(status) {
-                        case 'PENDING': return 'status-pending';
-                        case 'PROCESSING': return 'status-processing';
-                        case 'SUMMARIZING': return 'status-summarizing';
-                        case 'COMPLETED': return 'status-completed';
-                        case 'FAILED': return 'status-failed';
-                        default: return 'status-pending'; // Default or unknown
-                    }
-                };
-
-
-                const resetCurrentFileProcessingState = () => {
-                    if (pollInterval.value) clearInterval(pollInterval.value);
-                    pollInterval.value = null;
-                    currentlyProcessingFile.value = null;
-                    processingProgress.value = 0;
-                    processingMessage.value = '';
-                };
-
-                const switchToUploadView = () => {
-                    currentView.value = 'upload';
-                    selectedRecording.value = null;
-                 };
-
-                const switchToGalleryView = async () => {
-                    currentView.value = 'gallery';
-                     await loadRecordings(); // Refresh recordings when switching back
-                };
-
-                const handleDragLeave = (e) => {
-                    if (e.relatedTarget && e.currentTarget.contains(e.relatedTarget)) {
-                         return;
-                    }
-                    dragover.value = false;
-                }
-
-                const handleDrop = (e) => {
-                    dragover.value = false;
-                    addFilesToQueue(e.dataTransfer.files);
-                 };
-
-                const handleFileSelect = (e) => {
-                    addFilesToQueue(e.target.files);
-                    e.target.value = null; // Reset input
-                };
-
-                // --- Queue Management ---
-                const addFilesToQueue = (files) => {
-                    let filesAdded = 0;
-                    for (const file of files) {
-                        if (file && file.type.startsWith('audio/')) {
-                             if (file.size > maxFileSizeMB.value * 1024 * 1024) {
-                                setGlobalError(`File "${file.name}" exceeds the maximum size of ${maxFileSizeMB.value} MB and was skipped.`);
-                                continue;
-                            }
-                             const clientId = `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-                            uploadQueue.value.push({
-                                file: file, status: 'queued', recordingId: null, clientId: clientId, error: null
-                            });
-                            filesAdded++;
-                        } else if (file) {
-                            setGlobalError(`Invalid file type "${file.name}". Only audio files are accepted. File skipped.`);
-                        }
-                    }
-                     if(filesAdded > 0) {
-                        console.log(`Added ${filesAdded} file(s) to the queue.`);
-                        progressPopupMinimized.value = false; // Show popup
-                        if (!isProcessingActive.value) {
-                            startProcessingQueue();
-                        }
-                    }
-                };
-
-                 const startProcessingQueue = async () => {
-                    console.log("Attempting to start processing queue...");
-                    if (isProcessingActive.value) {
-                        console.log("Queue processor already active.");
-                        return;
-                    }
-
-                    isProcessingActive.value = true;
-                    resetCurrentFileProcessingState();
-
-                     const nextFileItem = uploadQueue.value.find(item => item.status === 'queued');
-
-                    if (nextFileItem) {
-                        console.log(`Processing next file: ${nextFileItem.file.name} (Client ID: ${nextFileItem.clientId})`);
-                        currentlyProcessingFile.value = nextFileItem;
-                        nextFileItem.status = 'uploading';
-                        processingMessage.value = 'Preparing upload...';
-                        processingProgress.value = 5;
-
-                        try {
-                            const formData = new FormData();
-                            formData.append('file', nextFileItem.file);
-
-                            processingMessage.value = 'Uploading file...';
-                            processingProgress.value = 10;
-
-                            const response = await fetch('/upload', { method: 'POST', body: formData });
-                            const data = await response.json();
-
-                            if (!response.ok) {
-                                let errorMsg = data.error || `Upload failed with status ${response.status}`;
-                                if (response.status === 413) errorMsg = data.error || `File too large. Max: ${data.max_size_mb?.toFixed(0) || maxFileSizeMB.value} MB.`;
-                                throw new Error(errorMsg);
-                            }
-
-                             if (response.status === 202 && data.id) {
-                                console.log(`File ${nextFileItem.file.name} uploaded. Recording ID: ${data.id}. Starting status poll.`);
-                                // Status is now 'PENDING' on backend, will be updated by poll
-                                nextFileItem.status = 'pending'; // Reflect initial backend status
-                                nextFileItem.recordingId = data.id;
-                                processingMessage.value = 'Upload complete. Waiting for processing...';
-                                processingProgress.value = 30;
-
-                                 // Add preliminary record to gallery immediately
-                                recordings.value.unshift(data);
-                                // Optionally select the new item
-                                // selectRecording(data);
-
-                                pollProcessingStatus(nextFileItem); // Start polling
-
-                            } else {
-                                throw new Error('Unexpected success response from server after upload.');
-                            }
-
-                        } catch (error) {
-                            console.error(`Upload/Processing Error for ${nextFileItem.file.name} (Client ID: ${nextFileItem.clientId}):`, error);
-                            nextFileItem.status = 'failed';
-                            nextFileItem.error = error.message;
-                             // Find the potentially added preliminary record and mark it failed
-                             const failedRecordIndex = recordings.value.findIndex(r => r.id === nextFileItem.recordingId);
-                             if(failedRecordIndex !== -1) {
-                                recordings.value[failedRecordIndex].status = 'FAILED';
-                                recordings.value[failedRecordIndex].transcription = `Upload/Processing failed: ${error.message}`;
-                             } else {
-                                // If record wasn't even created, add a note
-                                setGlobalError(`Failed to process "${nextFileItem.file.name}": ${error.message}`);
-                             }
-
-                             // Reset state and try next file
-                             resetCurrentFileProcessingState();
-                             isProcessingActive.value = false;
-                             await nextTick();
-                             startProcessingQueue();
-                         }
-                    } else {
-                        console.log("Upload queue is empty or no files are queued.");
-                        isProcessingActive.value = false;
-                        // Optional: Auto-minimize popup after a delay
-                         // setTimeout(() => {
-                        //     if (!isProcessingActive.value && uploadQueue.value.every(f => ['completed', 'failed'].includes(f.status))) {
-                         //         progressPopupMinimized.value = true;
-                        //     }
-                         // }, 5000);
-                    }
-                };
-
-                const pollProcessingStatus = (fileItem) => {
-                     if (pollInterval.value) clearInterval(pollInterval.value);
-
-                    const recordingId = fileItem.recordingId;
-                    if (!recordingId) {
-                        console.error("Cannot poll status without recording ID for", fileItem.file.name);
-                        fileItem.status = 'failed';
-                        fileItem.error = 'Internal error: Missing recording ID for polling.';
-                        resetCurrentFileProcessingState();
-                        isProcessingActive.value = false;
-                        nextTick(startProcessingQueue); // Try next file
-                        return;
-                    }
-
-                    // Initial message based on fileItem status (should be 'pending' initially)
-                    processingMessage.value = 'Waiting for transcription...';
-                    processingProgress.value = 40;
-
-                    pollInterval.value = setInterval(async () => {
-                        // Check if the item is still the one being processed and hasn't finished/failed
-                         if (!currentlyProcessingFile.value || currentlyProcessingFile.value.clientId !== fileItem.clientId || ['completed', 'failed'].includes(fileItem.status)) {
-                             console.log(`Polling stopped for ${fileItem.clientId} as it's no longer active or finished.`);
-                            clearInterval(pollInterval.value);
-                            pollInterval.value = null;
-                             // If this was the active file, allow queue to restart
-                            if (currentlyProcessingFile.value && currentlyProcessingFile.value.clientId === fileItem.clientId) {
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-                            }
-                            return;
-                        }
-
-                        try {
-                            console.log(`Polling status for recording ID: ${recordingId} (${fileItem.file.name})`);
-                            const response = await fetch(`/status/${recordingId}`);
-                            if (!response.ok) throw new Error(`Status check failed with status ${response.status}`);
-
-                            const data = await response.json();
-                             const galleryIndex = recordings.value.findIndex(r => r.id === recordingId);
-
-                            // Update item in the main recordings list
-                            if (galleryIndex !== -1) {
-                                recordings.value[galleryIndex] = data;
-                                if(selectedRecording.value?.id === recordingId) {
-                                    selectedRecording.value = data; // Update selection if viewing details
-                                }
-                            }
-
-                            // Update the status in the uploadQueue item as well
-                            fileItem.status = data.status;
-
-                            // Update progress display based on backend status
-                            if (data.status === 'COMPLETED') {
-                                console.log(`Processing COMPLETED for ${fileItem.file.name} (ID: ${recordingId})`);
-                                processingMessage.value = 'Processing complete!';
-                                processingProgress.value = 100;
-                                fileItem.status = 'completed'; // Final status for queue item
-                                // Stop polling, reset state, and trigger next item
-                                clearInterval(pollInterval.value);
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-
-                            } else if (data.status === 'FAILED') {
-                                console.log(`Processing FAILED for ${fileItem.file.name} (ID: ${recordingId})`);
-                                processingMessage.value = 'Processing failed.';
-                                processingProgress.value = 100; // Show 100% but failed state
-                                fileItem.status = 'failed'; // Final status for queue item
-                                fileItem.error = data.transcription || data.summary || 'Processing failed on server.';
-                                setGlobalError(`Processing failed for "${data.title || fileItem.file.name}".`);
-                                // Stop polling, reset state, and trigger next item
-                                clearInterval(pollInterval.value);
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-
-                            } else if (data.status === 'PROCESSING') {
-                                processingMessage.value = 'Transcription in progress...';
-                                processingProgress.value = Math.min(65, processingProgress.value + Math.random() * 5); // Mid-range progress
-                            } else if (data.status === 'SUMMARIZING') {
-                                processingMessage.value = 'Generating title & summary...';
-                                processingProgress.value = Math.min(95, processingProgress.value + Math.random() * 5); // Higher progress
-                            } else { // PENDING
-                                processingMessage.value = 'Waiting in queue...';
-                                processingProgress.value = 45; // Keep progress indication while pending
-                            }
-                        } catch (error) {
-                            console.error(`Polling Error for ${fileItem.file.name} (ID: ${recordingId}):`, error);
-                             // Assume failed if polling error occurs
-                            fileItem.status = 'failed';
-                            fileItem.error = `Error checking status: ${error.message}`;
-                            setGlobalError(`Error checking status for "${fileItem.file.name}": ${error.message}.`);
-                             // Update record in gallery if found
-                             const galleryIndex = recordings.value.findIndex(r => r.id === recordingId);
-                            if (galleryIndex !== -1) recordings.value[galleryIndex].status = 'FAILED';
-
-                            clearInterval(pollInterval.value);
-                            pollInterval.value = null;
-                            resetCurrentFileProcessingState();
-                            isProcessingActive.value = false;
-                            await nextTick();
-                            startProcessingQueue(); // Process the next file
-                        }
-                    }, 5000); // Poll every 5 seconds (adjust as needed)
-                };
-
-                // --- Gallery and Detail Methods ---
-                // AutoSave removed in favor of explicit save in modal
-                // const autoSave = () => { ... };
-
-                 const saveMetadata = async (recordingDataToSave) => {
-                    globalError.value = null;
-                    if (!recordingDataToSave || !recordingDataToSave.id) return null;
-                    console.log('Saving metadata for:', recordingDataToSave.id);
-                    try {
-                        const payload = {
-                            id: recordingDataToSave.id,
-                            title: recordingDataToSave.title,
-                            participants: recordingDataToSave.participants,
-                            notes: recordingDataToSave.notes,
-                            summary: recordingDataToSave.summary, // <-- ADDED: Include summary
-                            meeting_date: recordingDataToSave.meeting_date // <-- ADDED: Include meeting_date (should be YYYY-MM-DD)
-                        };
-                        const response = await fetch('/save', {
-                            method: 'POST',
-                            headers: { 'Content-Type': 'application/json' },
-                            body: JSON.stringify(payload)
-                        });
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to save metadata');
-
-                        console.log('Save successful:', data.recording.id);
-                        // Update the master recordings list
-                        const index = recordings.value.findIndex(r => r.id === data.recording.id);
-                        if (index !== -1) {
-                            // Update only the editable fields, preserve others like status/transcription from backend
-                             recordings.value[index].title = payload.title;
-                             recordings.value[index].participants = payload.participants;
-                             recordings.value[index].notes = payload.notes;
-                             recordings.value[index].notes_html = data.recording.notes_html;
-                             recordings.value[index].summary = payload.summary;
-                             recordings.value[index].summary_html = data.recording.summary_html;
-                             recordings.value[index].meeting_date = payload.meeting_date; // <-- ADDED: Update meeting_date
-                         }
-                         // Update selected if it's the one being saved
-                         if (selectedRecording.value?.id === data.recording.id) {
-                            selectedRecording.value.title = payload.title;
-                            selectedRecording.value.participants = payload.participants;
-                            selectedRecording.value.notes = payload.notes;
-                            selectedRecording.value.notes_html = data.recording.notes_html;
-                            selectedRecording.value.summary = payload.summary;
-                            selectedRecording.value.summary_html = data.recording.summary_html;
-                            selectedRecording.value.meeting_date = payload.meeting_date; // <-- ADDED: Update meeting_date
-                         }
-                        return data.recording; // Return the full updated object from backend
-                    } catch (error) {
-                        console.error('Save Metadata Error:', error);
-                        setGlobalError(`Save failed: ${error.message}`);
-                        return null;
-                    }
-                };
-
-                const loadRecordings = async () => {
-                    globalError.value = null;
-                    isLoadingRecordings.value = true;
-                    try {
-                        const response = await fetch('/recordings');
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to load recordings');
-                        recordings.value = data;
-
-
-                        // On load, check for any recordings stuck in PENDING, PROCESSING, or SUMMARIZING
-                        // and ensure polling is active if the queue processor isn't running.
-                        const incompleteRecordings = recordings.value.filter(r => ['PENDING', 'PROCESSING', 'SUMMARIZING'].includes(r.status));
-
-                        if (incompleteRecordings.length > 0 && !isProcessingActive.value) {
-                            console.warn(`Found ${incompleteRecordings.length} incomplete recording(s) on load. Attempting to resume polling if not already queued.`);
-                            for (const recording of incompleteRecordings) {
-                                // Is this item already being tracked in the queue?
-                                let queueItem = uploadQueue.value.find(item => item.recordingId === recording.id);
-                                if (!queueItem) {
-                                    // If not in queue (likely page reload), create a placeholder to track polling
-                                    console.log(`Re-attaching poll for recording ${recording.id}.`);
-                                    queueItem = {
-                                        // Mock file object, size might be useful for display
-                                        file: { name: recording.title || `Recording ${recording.id}`, size: recording.file_size },
-                                        status: recording.status, // Use current status from DB
-                                        recordingId: recording.id,
-                                        clientId: `reload-${recording.id}`, // Unique ID for tracking
-                                        error: null
-                                    };
-                                    // Add to the *beginning* of the visual queue *if* we want to show it there
-                                    // Or just manage polling without adding to queue visually?
-                                    // Let's add it to the queue for consistency in management.
-                                    uploadQueue.value.unshift(queueItem);
-                                    // Start processing queue if it wasn't active
-                                    if (!isProcessingActive.value) {
-                                        startProcessingQueue();
-                                    } else if (currentlyProcessingFile.value?.recordingId !== recording.id) {
-                                        // If processor is active but on a different file, just ensure polling starts
-                                        // Note: startProcessingQueue handles finding the next 'queued'. This item
-                                        // might not be 'queued'. We need direct polling.
-                                        // Let's rethink: The queue processor should handle finding PENDING/PROCESSING items.
-                                        // For simplicity, let's just trigger the queue processor. It will find this item if it's next.
-                                        // If something else is truly processing, this won't interrupt.
-                                        console.log("Triggering queue processor check due to reloaded incomplete item.")
-                                        // Ensure it's marked conceptually 'queued' for the processor to pick up
-                                        queueItem.status = 'queued';
-                                        startProcessingQueue(); // Let the queue logic handle it
-                                    }
-
-                                } else if (queueItem.status !== recording.status && !['completed', 'failed'].includes(queueItem.status)) {
-                                    // If queue status differs from DB, update queue status
-                                    console.log(`Correcting queue status for ${queueItem.clientId} from ${queueItem.status} to ${recording.status}`);
-                                    queueItem.status = recording.status;
-                                    // Restart queue processing if needed
-                                    if (!isProcessingActive.value) startProcessingQueue();
-                                }
-                            }
-                        }
-
-                    } catch (error) {
-                        console.error('Load Recordings Error:', error);
-                        setGlobalError(`Failed to load recordings: ${error.message}`);
-                        recordings.value = [];
-                    } finally {
-                        isLoadingRecordings.value = false;
-                    }
-                };
-
-                 const selectRecording = (recording) => {
-                     selectedRecording.value = recording;
-                     // Optional: Check if polling needs to be restarted if user selects an incomplete item
-                     // This logic is complex and might be redundant with the loadRecordings check.
-                     // Let's rely on loadRecordings and the queue processor for robustness.
-                 };
-
-                const editRecording = (recording) => {
-                     // Create a deep copy for the modal to prevent modifying original object directly
-                    editingRecording.value = JSON.parse(JSON.stringify(recording));
-                    showEditModal.value = true;
-                };
-
-                const cancelEdit = () => {
-                    showEditModal.value = false;
-                    editingRecording.value = null;
-                };
-
-                 const saveEdit = async () => {
-                    // Save using the saveMetadata function which updates the main list & selected item
-                     const success = await saveMetadata(editingRecording.value);
-                    if (success) {
-                        cancelEdit(); // Close modal on success
-                     }
-                     // Keep modal open on failure, error shown via globalError
-                };
-
-                const confirmDelete = (recording) => {
-                    recordingToDelete.value = recording;
-                    showDeleteModal.value = true;
-                };
-
-                const cancelDelete = () => {
-                    showDeleteModal.value = false;
-                    recordingToDelete.value = null;
-                };
-
-                const deleteRecording = async () => {
-                    globalError.value = null;
-                    if (!recordingToDelete.value) return;
-                    const idToDelete = recordingToDelete.value.id;
-                    const titleToDelete = recordingToDelete.value.title; // For logging/messaging
-                    try {
-                        const response = await fetch(`/recording/${idToDelete}`, { method: 'DELETE' });
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to delete recording');
-
-                         // Remove from gallery list
-                        recordings.value = recordings.value.filter(r => r.id !== idToDelete);
-
-                        // Find and remove from upload queue
-                        const queueIndex = uploadQueue.value.findIndex(item => item.recordingId === idToDelete);
-                         if (queueIndex !== -1) {
-                            const deletedItem = uploadQueue.value.splice(queueIndex, 1)[0];
-                             console.log(`Removed item ${deletedItem.clientId} from queue.`);
-                             // If deleting the file currently being processed, stop polling and move to next
-                            if (currentlyProcessingFile.value?.clientId === deletedItem.clientId) {
-                                console.log(`Deleting currently processing file: ${titleToDelete}. Stopping poll and moving to next.`);
-                                clearInterval(pollInterval.value); // Stop polling explicitly
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false; // Allow queue to restart
-                                await nextTick();
-                                startProcessingQueue();
-                            }
-                        }
-
-                        if (selectedRecording.value?.id === idToDelete) selectedRecording.value = null;
-                        cancelDelete();
-                        console.log(`Successfully deleted recording ${idToDelete} (${titleToDelete})`);
-
-                    } catch (error) {
-                        console.error('Delete Error:', error);
-                        setGlobalError(`Failed to delete recording "${titleToDelete}": ${error.message}`);
-                        cancelDelete(); // Still close modal on error
-                    }
-                };
-                
-                // Inline editing methods
-                const toggleEditParticipants = () => {
-                    editingParticipants.value = !editingParticipants.value;
-                    if (!editingParticipants.value) {
-                        saveInlineEdit('participants');
-                    }
-                };
-                
-                const toggleEditMeetingDate = () => {
-                    editingMeetingDate.value = !editingMeetingDate.value;
-                    if (!editingMeetingDate.value) {
-                        saveInlineEdit('meeting_date');
-                    }
-                };
-                
-                const toggleEditSummary = () => {
-                    editingSummary.value = !editingSummary.value;
-                    if (!editingSummary.value) {
-                        saveInlineEdit('summary');
-                    }
-                };
-                
-                const toggleEditNotes = () => {
-                    editingNotes.value = !editingNotes.value;
-                    if (!editingNotes.value) {
-                        saveInlineEdit('notes');
-                    }
-                };
-                
-                const saveInlineEdit = async (field) => {
-                    if (!selectedRecording.value) return;
-                    
-                    // Create a payload with just the field being edited
-                    const payload = {
-                        id: selectedRecording.value.id,
-                        [field]: selectedRecording.value[field]
-                    };
-                    
-                    // For completeness, include all editable fields in the payload
-                    // This ensures the backend has all the data it needs
-                    const fullPayload = {
-                        id: selectedRecording.value.id,
-                        title: selectedRecording.value.title,
-                        participants: selectedRecording.value.participants,
-                        notes: selectedRecording.value.notes,
-                        summary: selectedRecording.value.summary,
-                        meeting_date: selectedRecording.value.meeting_date
-                    };
-                    
-                    try {
-                        const updatedRecording = await saveMetadata(fullPayload);
-                        if (updatedRecording) {
-                            // Update the HTML versions from the response
-                            if (field === 'notes') {
-                                selectedRecording.value.notes_html = updatedRecording.notes_html;
-                            } else if (field === 'summary') {
-                                selectedRecording.value.summary_html = updatedRecording.summary_html;
-                            }
-                            
-                            // Reset the editing state for the field
-                            switch(field) {
-                                case 'participants':
-                                    editingParticipants.value = false;
-                                    break;
-                                case 'meeting_date':
-                                    editingMeetingDate.value = false;
-                                    break;
-                                case 'summary':
-                                    editingSummary.value = false;
-                                    break;
-                                case 'notes':
-                                    editingNotes.value = false;
-                                    break;
-                            }
-                            showToast(`${field.charAt(0).toUpperCase() + field.slice(1).replace('_', ' ')} updated successfully`);
-                        }
-                    } catch (error) {
-                        console.error(`Save ${field} Error:`, error);
-                        setGlobalError(`Failed to save ${field}: ${error.message}`);
-                    }
-                };
-
-                // --- Lifecycle Hooks ---
-                onMounted(() => {
-                    loadRecordings();
-                    initializeDarkMode(); // Initialize dark mode on load
-                });
-
-                // --- Watchers ---
-                 watch(uploadQueue, (newQueue, oldQueue) => {
-                    if (newQueue.length === 0 && oldQueue.length > 0 && !isProcessingActive.value) {
-                        console.log("Upload queue processing finished.");
-                        // Optional: Auto-minimize after delay
-                         // setTimeout(() => progressPopupMinimized.value = true, 3000);
-                     }
-                 }, { deep: true });
-
-
-                // --- Chat functionality ---
-                const showChat = ref(false);
-                const chatMessages = ref([]);
-                const chatInput = ref('');
-                const isChatLoading = ref(false);
-                
-                // Create a ref for the chat messages container
-                const chatMessagesRef = ref(null);
-                
-                const sendChatMessage = async () => {
-                    if (!chatInput.value.trim() || isChatLoading.value || !selectedRecording.value || selectedRecording.value.status !== 'COMPLETED') {
-                        return;
-                    }
-                    
-                    const message = chatInput.value.trim();
-
-                    // Ensure chatMessages.value is an array before pushing
-                    if (!Array.isArray(chatMessages.value)) {
-                        console.warn('chatMessages.value was not an array! Resetting. Value was:', chatMessages.value);
-                        chatMessages.value = []; // Reset if corrupted
-                    }
-
-                    chatMessages.value.push({ role: 'user', content: message });
-                    chatInput.value = '';
-                    isChatLoading.value = true;
-                    
-                    // Scroll to bottom of chat
-                    await nextTick();
-                    // Use the correctly named ref
-                    if (chatMessagesRef.value) { 
-                        chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
-                    }
-                    
-                    try {
-                        // Prepare message history for the API call
-                        // We need to convert our UI messages to the format expected by the API
-                        const messageHistory = chatMessages.value
-                            .slice(0, -1) // Exclude the message we just added (it will be sent separately)
-                            .map(msg => ({
-                                role: msg.role,
-                                content: msg.content
-                            }));
-                        
-                        const response = await fetch('/chat', {
-                            method: 'POST',
-                            headers: { 'Content-Type': 'application/json' },
-                            body: JSON.stringify({
-                                recording_id: selectedRecording.value.id,
-                                message: message,
-                                message_history: messageHistory
-                            })
-                        });
-                        
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to get chat response');
-                        
-                        chatMessages.value.push({ 
-                            role: 'assistant', 
-                            content: data.response,
-                            html: data.response_html 
-                        });
-                    } catch (error) {
-                        console.error('Chat Error:', error);
-                        setGlobalError(`Chat error: ${error.message}`);
-                        chatMessages.value.push({ role: 'assistant', content: `Error: ${error.message}` });
-                    } finally {
-                        isChatLoading.value = false;
-                        // Scroll to bottom of chat
-                        await nextTick();
-                         // Use the correctly named ref
-                        if (chatMessagesRef.value) {
-                            chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
-                        }
-                    }
-                };
-                
-                // Toast notification system
-                const showToast = (message, icon = 'fa-check-circle', duration = 2000) => {
-                    const toastContainer = document.getElementById('toastContainer');
-                    
-                    // Create toast element
-                    const toast = document.createElement('div');
-                    toast.className = 'toast';
-                    toast.innerHTML = `<i class="fas ${icon}"></i> ${message}`;
-                    
-                    // Add to container
-                    toastContainer.appendChild(toast);
-                    
-                    // Trigger animation
-                    setTimeout(() => {
-                        toast.classList.add('show');
-                    }, 10);
-                    
-                    // Remove after duration
-                    setTimeout(() => {
-                        toast.classList.remove('show');
-                        setTimeout(() => {
-                            toastContainer.removeChild(toast);
-                        }, 300);
-                    }, duration);
-                };
-                
-                // Add animation to copy button
-                const animateCopyButton = (button) => {
-                    button.classList.add('copy-success');
-                    
-                    // Store original content
-                    const originalContent = button.innerHTML;
-                    button.innerHTML = '<i class="fas fa-check"></i>';
-                    
-                    setTimeout(() => {
-                        button.classList.remove('copy-success');
-                        button.innerHTML = originalContent;
-                    }, 1500);
-                };
-                
-                const copyMessage = (text, event) => {
-                    // Get the button that was clicked
-                    const button = event.currentTarget;
-                    
-                    if (navigator.clipboard && window.isSecureContext) {
-                        // Use clipboard API if available (secure context)
-                        navigator.clipboard.writeText(text)
-                            .then(() => {
-                                showToast('Copied to clipboard!');
-                                animateCopyButton(button);
-                            })
-                            .catch(err => {
-                                console.error('Copy failed:', err);
-                                showToast('Failed to copy: ' + err.message, 'fa-exclamation-circle');
-                                fallbackCopyTextToClipboard(text, button);
-                            });
-                    } else {
-                        // Fallback for non-secure contexts
-                        fallbackCopyTextToClipboard(text, button);
-                    }
-                };
-                
-                // Fallback method using document.execCommand
-                const fallbackCopyTextToClipboard = (text, button = null) => {
-                    try {
-                        const textArea = document.createElement("textarea");
-                        textArea.value = text;
-                        
-                        // Make the textarea out of viewport
-                        textArea.style.position = "fixed";
-                        textArea.style.left = "-999999px";
-                        textArea.style.top = "-999999px";
-                        document.body.appendChild(textArea);
-                        
-                        // Select and copy
-                        textArea.focus();
-                        textArea.select();
-                        const successful = document.execCommand('copy');
-                        
-                        // Clean up
-                        document.body.removeChild(textArea);
-                        
-                        if (successful) {
-                            showToast('Copied to clipboard!');
-                            if (button) animateCopyButton(button);
-                        } else {
-                            showToast('Copy failed. Your browser may not support this feature.', 'fa-exclamation-circle');
-                        }
-                    } catch (err) {
-                        console.error('Fallback copy failed:', err);
-                        showToast('Unable to copy: ' + err.message, 'fa-exclamation-circle');
-                    }
-                };
-                
-                const copyTranscription = (event) => {
-                    if (!selectedRecording.value || !selectedRecording.value.transcription) {
-                        showToast('No transcription available to copy.', 'fa-exclamation-circle');
-                        return;
-                    }
-                    
-                    // Get the button that was clicked
-                    const button = event.currentTarget;
-                    
-                    // Show visual feedback on button
-                    animateCopyButton(button);
-                    
-                    if (navigator.clipboard && window.isSecureContext) {
-                        // Use clipboard API if available (secure context)
-                        navigator.clipboard.writeText(selectedRecording.value.transcription)
-                            .then(() => {
-                                showToast('Transcription copied to clipboard!');
-                            })
-                            .catch(err => {
-                                console.error('Copy failed:', err);
-                                showToast('Failed to copy: ' + err.message, 'fa-exclamation-circle');
-                                fallbackCopyTextToClipboard(selectedRecording.value.transcription);
-                            });
-                    } else {
-                        // Fallback for non-secure contexts
-                        fallbackCopyTextToClipboard(selectedRecording.value.transcription);
-                    }
-                };
-                
-                // Clear chat messages when recording changes
-                watch(selectedRecording, (newVal) => {
-                    chatMessages.value = [];
-                    showChat.value = false;
-                    selectedTab.value = 'summary'; // Reset tab when recording changes
-                });
-
-                return {
-                    // State
-                    currentView, dragover, recordings, selectedRecording, // currentRecording removed
-                    showEditModal, showDeleteModal, editingRecording, recordingToDelete,
-                    isLoadingRecordings, globalError, maxFileSizeMB, isDarkMode, // <-- Added isDarkMode
-                    // Multi-upload State
-                    uploadQueue, currentlyProcessingFile, processingProgress, processingMessage,
-                    isProcessingActive, progressPopupMinimized,
-                    // Chat State
-                    showChat, chatMessages, chatInput, isChatLoading, chatMessagesRef, // <-- Added chatMessagesRef
-                    // Computed
-                    groupedRecordings, totalInQueue, completedInQueue, queuedFiles, finishedFilesInQueue,
-                    // Inline editing state
-                    editingParticipants, editingMeetingDate, editingSummary, editingNotes,
-                    // Methods
-                    handleDrop, handleFileSelect, /*autoSave removed*/ loadRecordings, selectedTab, // <-- Added selectedTab
-                    selectRecording, editRecording, cancelEdit, saveEdit, confirmDelete,
-                    cancelDelete, deleteRecording, switchToUploadView, switchToGalleryView,
-                    formatFileSize, setGlobalError, handleDragLeave, formatStatus, getStatusClass,
-                    formatDisplayDate, // <-- ADDED: Expose date formatting function
-                    toggleDarkMode, // <-- Added toggleDarkMode
-                    toggleSidebar, isSidebarCollapsed, // <-- Added sidebar state and function
-                    // Inline editing methods
-                    toggleEditParticipants, toggleEditMeetingDate, toggleEditSummary, toggleEditNotes, saveInlineEdit,
-                    // Chat Methods
-                    sendChatMessage, copyMessage, copyTranscription,
-                    // User menu
-                    isUserMenuOpen,
-                 }
-            },
-            delimiters: ['${', '}'] // Keep Vue delimiters distinct from Flask's Jinja
-        }).mount('#app');
-    </script>
-{% endraw %}
-</body>
-</html>
-
-```
-
-
-## templates/register.html
-
-```html
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
-
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-    </style>
-</head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
-            </h1>
-        </header>
-
-        <main class="flex-grow flex items-center justify-center">
-            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">Create an Account</h2>
-                
-                {% with messages = get_flashed_messages(with_categories=true) %}
-                    {% if messages %}
-                        {% for category, message in messages %}
-                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
-                                {{ message }}
-                            </div>
-                        {% endfor %}
-                    {% endif %}
-                {% endwith %}
-                
-                <form method="POST" action="{{ url_for('register') }}">
-                    {{ form.hidden_tag() }}
-                    
-                    <div class="mb-4">
-                        {{ form.username.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.username.errors %}
-                            {{ form.username(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.username.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.username(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                    </div>
-                    
-                    <div class="mb-4">
-                        {{ form.email.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.email.errors %}
-                            {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.email.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                    </div>
-                    
-                    <div class="mb-4">
-                        {{ form.password.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.password.errors %}
-                            {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.password.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                        <p class="text-xs text-[var(--text-muted)] mt-1">Password must be at least 8 characters long.</p>
-                    </div>
-                    
-                    <div class="mb-6">
-                        {{ form.confirm_password.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.confirm_password.errors %}
-                            {{ form.confirm_password(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.confirm_password.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.confirm_password(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                    </div>
-                    
-                    <div class="flex flex-col space-y-4">
-                        {{ form.submit(class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]") }}
-                        
-                        <div class="text-center text-sm text-[var(--text-muted)]">
-                            <span>Already have an account?</span>
-                            <a href="{{ url_for('login') }}" class="font-medium text-[var(--text-accent)] hover:underline">Login here</a>
-                        </div>
-                    </div>
-                </form>
-            </div>
-        </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; {{ now.year }}
-        </footer>
-    </div>
-</body>
-</html>
-
-```
-
-
-## templates/login.html
-
-```html
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
-
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-    </style>
-</head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
-            </h1>
-        </header>
-
-        <main class="flex-grow flex items-center justify-center">
-            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">Login</h2>
-                
-                {% with messages = get_flashed_messages(with_categories=true) %}
-                    {% if messages %}
-                        {% for category, message in messages %}
-                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
-                                {{ message }}
-                            </div>
-                        {% endfor %}
-                    {% endif %}
-                {% endwith %}
-                
-                <form method="POST" action="{{ url_for('login') }}">
-                    {{ form.hidden_tag() }}
-                    
-                    <div class="mb-4">
-                        {{ form.email.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.email.errors %}
-                            {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.email.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                    </div>
-                    
-                    <div class="mb-6">
-                        {{ form.password.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
-                        {% if form.password.errors %}
-                            {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                            <div class="text-[var(--text-danger)] text-xs mt-1">
-                                {% for error in form.password.errors %}
-                                    <span>{{ error }}</span>
-                                {% endfor %}
-                            </div>
-                        {% else %}
-                            {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
-                        {% endif %}
-                    </div>
-                    
-                    <div class="flex items-center mb-6">
-                        {{ form.remember(class="h-4 w-4 text-[var(--text-accent)] focus:ring-[var(--ring-focus)] border-[var(--border-secondary)] rounded") }}
-                        {{ form.remember.label(class="ml-2 block text-sm text-[var(--text-secondary)]") }}
-                    </div>
-                    
-                    <div class="flex flex-col space-y-4">
-                        {{ form.submit(class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]") }}
-                        
-                        <div class="text-center text-sm text-[var(--text-muted)]">
-                            <span>Don't have an account?</span>
-                            <a href="{{ url_for('register') }}" class="font-medium text-[var(--text-accent)] hover:underline">Register here</a>
-                        </div>
-                    </div>
-                </form>
-            </div>
-        </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; {{ now.year }}
-        </footer>
-    </div>
-</body>
-</html>
-
-```
-
-
-## deployment/setup.sh
-
-```bash
-
-#!/bin/bash
-
-# Create directory for the application
-sudo mkdir -p /opt/transcription-app
-sudo chown $USER:$USER /opt/transcription-app
-
-# Copy application files
-cp app.py /opt/transcription-app/
-cp -r templates /opt/transcription-app/
-cp requirements.txt /opt/transcription-app/
-cp reset_db.py /opt/transcription-app/
-cp migrate_db.py /opt/transcription-app/
-cp create_admin.py /opt/transcription-app/
-cp .env /opt/transcription-app/  # Copy the .env file with API keys
-
-# Add SECRET_KEY to .env file if it doesn't exist
-if ! grep -q "SECRET_KEY" /opt/transcription-app/.env; then
-    echo "SECRET_KEY=$(openssl rand -hex 32)" >> /opt/transcription-app/.env
-    echo "Added SECRET_KEY to .env file"
-fi
-
-# Create and activate virtual environment
-python3 -m venv /opt/transcription-app/venv
-source /opt/transcription-app/venv/bin/activate
-
-# Install requirements
-cd /opt/transcription-app
-pip install -r requirements.txt
-
-# Create directories for uploads and database with proper permissions
-mkdir -p /opt/transcription-app/uploads
-mkdir -p /opt/transcription-app/instance
-chmod 755 /opt/transcription-app/uploads
-chmod 755 /opt/transcription-app/instance
-
-# Initialize or migrate the database
-if [ ! -f /opt/transcription-app/instance/transcriptions.db ]; then
-    # If database doesn't exist, create it from scratch
-    echo "Database doesn't exist. Creating new database..."
-    python reset_db.py
-else
-    # If database exists, migrate it to preserve data
-    echo "Database exists. Migrating schema to preserve data..."
-    python migrate_db.py
-fi
-
-# Set proper ownership for all files
-sudo chown -R $USER:$USER /opt/transcription-app
-
-# Create systemd service file
-sudo tee /etc/systemd/system/transcription.service << EOF
-[Unit]
-Description=Transcription Web Application
-After=network.target
-
-[Service]
-User=$USER
-EnvironmentFile=/opt/transcription-app/.env
-WorkingDirectory=/opt/transcription-app
-Environment="PATH=/opt/transcription-app/venv/bin"
-Environment="PYTHONPATH=/opt/transcription-app"
-ExecStart=/opt/transcription-app/venv/bin/gunicorn --workers 3 --bind 0.0.0.0:8899 --timeout 600 app:app
-Restart=always
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target
-EOF
-
-# Reload systemd and start service
-sudo systemctl daemon-reload
-sudo systemctl restart transcription
-sudo systemctl enable transcription
-
-# Check service status
-echo "Checking service status..."
-sleep 3
-sudo systemctl status transcription
-
-echo "Installation complete! The application should be running on port 8899."
-
-# Ask if user wants to create an admin user
-read -p "Do you want to create an admin user now? (y/n): " create_admin
-if [[ $create_admin == "y" || $create_admin == "Y" ]]; then
-    echo "Creating admin user..."
-    python create_admin.py
-else
-    echo "You can create an admin user later by running: python create_admin.py"
-fi
-
-```
diff --git a/readme.md b/readme.md
deleted file mode 100644
index 3e498830..00000000
--- a/readme.md
+++ /dev/null
@@ -1,248 +0,0 @@
-# Speakr
-
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) This project is dual-licensed. See the [License](#license) section for details.
-
-Speakr is a personal, self-hosted web application designed for transcribing audio recordings (like meetings), generating concise summaries and titles, and interacting with the content through a chat interface. Keep all your meeting notes and insights securely on your own server.
-
-## Screenshots
-
-*(Add screenshots of the main interface, detail view, admin panel, etc., here)*
-* `[Screenshot of Main Gallery View]`
-* `[Screenshot of Recording Detail View (Transcription/Summary/Chat)]`
-* `[Screenshot of Admin User Management]`
-
-## Features
-
-**Core Functionality:**
-
-* **Audio Upload:** Upload audio files (MP3, WAV, M4A, etc.) via drag-and-drop or file selection.
-* **Background Processing:** Transcription and summarization happen in the background without blocking the UI.
-* **Transcription:** Uses OpenAI-compatible Speech-to-Text (STT) APIs (configurable, e.g., self-hosted Whisper).
-* **AI Summarization & Titling:** Generates concise titles and summaries using configurable LLMs via OpenAI-compatible APIs (like OpenRouter).
-* **Interactive Chat:** Ask questions and interact with the transcription content using an AI model.
-* **Metadata Editing:** Edit titles, participants, meeting dates, summaries, and notes associated with recordings.
-
-**User Features:**
-
-* **Authentication:** Secure user registration and login system.
-* **Account Management:** Users can change their passwords.
-* **Recording Gallery:** View, manage, and access all personal recordings.
-* **Dark Mode:** Switch between light and dark themes.
-
-**Admin Features:**
-
-* **Admin Dashboard:** Central place for administration tasks (`/admin`).
-* **User Management:** Add, edit, delete users, and grant/revoke admin privileges.
-* **System Statistics:** View overall usage statistics (total users, recordings, storage, etc.).
-
-## Technology Stack
-
-* **Backend:** Python 3, Flask
-* **Database:** SQLAlchemy ORM with SQLite (default)
-* **WSGI Server:** Gunicorn
-* **AI Integration:** OpenAI Python library (compatible with various endpoints like OpenAI, OpenRouter, or local servers)
-* **Authentication:** Flask-Login, Flask-Bcrypt, Flask-WTF
-* **Frontend:** Jinja2 Templates, Tailwind CSS, Vue.js (for interactive components), Font Awesome
-* **Deployment:** Bash script (`setup.sh`) for Linux/Systemd environments.
-
-## Prerequisites
-
-* Python 3.8+
-* `pip` (Python package installer)
-* `venv` (Python virtual environment tool - usually included with Python)
-* Access to OpenAI-compatible API endpoints for:
-    * Speech-to-Text (e.g., Whisper - can be self-hosted)
-    * Language Model (e.g., via OpenRouter, OpenAI, or other compatible service)
-* API Keys for the chosen endpoints.
-* (For Deployment) A Linux server with `sudo` access and `systemd`.
-
-## Setup Instructions
-
-Choose either **Local Development** or **Deployment**.
-
-### 1. Local Development
-
-Follow these steps to run Speakr on your local machine for development or testing.
-
-1.  **Clone the Repository:**
-    ```bash
-    git clone [https://github.com/your-username/speakr.git](https://github.com/your-username/speakr.git) # Replace with your repo URL
-    cd speakr
-    ```
-
-2.  **Create and Activate Virtual Environment:**
-    ```bash
-    python3 -m venv venv
-    source venv/bin/activate
-    # On Windows use: venv\Scripts\activate
-    ```
-
-3.  **Install Dependencies:**
-    ```bash
-    pip install -r requirements.txt
-    ```
-
-4.  **Configure Environment Variables:**
-    * Copy the example environment file (if you create one) or create a new file named `.env` in the project root.
-    * Add the following variables, replacing placeholder values with your actual keys and endpoints:
-
-        ```dotenv
-        # --- Required for Summaries/Chat ---
-        # (Use OpenRouter or another OpenAI-compatible Chat API)
-        OPENROUTER_API_KEY="sk-or-v1-..." # Your OpenRouter or compatible API key
-        OPENROUTER_BASE_URL="[https://openrouter.ai/api/v1](https://openrouter.ai/api/v1)" # Or your chat model endpoint
-        # Recommended Models: openai/gpt-4o-mini, google/gemini-flash-1.5, etc.
-        OPENROUTER_MODEL_NAME="openai/gpt-4o-mini"
-
-        # --- Required for Transcription ---
-        # (Use OpenAI Whisper API or a compatible local/remote endpoint)
-        OPENAI_API_KEY="cant-be-empty" # Use your OpenAI key OR often "none", "NA", "cant-be-empty" for local endpoints
-        OPENAI_BASE_URL="http://YOUR_LOCAL_WHISPER_IP:PORT/v1/" # Your transcription endpoint URL
-        # Set the specific model name your transcription endpoint uses (if needed by API)
-        TRANSCRIPTION_MODEL_NAME="Systran/faster-distil-whisper-large-v3" # Or the model your endpoint expects
-
-        # --- Flask Specific ---
-        # A strong, random secret key is crucial for session security.
-        # Generate one using: python -c 'import secrets; print(secrets.token_hex(32))'
-        SECRET_KEY="YOUR_VERY_STRONG_RANDOM_SECRET_KEY"
-
-        # --- Optional ---
-        # Set to 'false' to disable new user registrations
-        ALLOW_REGISTRATION="true"
-        ```
-
-5.  **Database Setup & Migrations:**
-    * The application uses SQLite by default, stored in `instance/transcriptions.db`.
-    * Run the necessary migrations to set up or update the database schema:
-        ```bash
-        python migrate_db.py
-        python migrate_original_filename.py
-        python migrate_is_admin.py
-        ```
-    * *(Note: If you ever need to start completely fresh, you can use `python reset_db.py`, but **be careful as this deletes all data**)*
-
-6.  **Create an Admin User:**
-    * Run the interactive script to create your first user with admin privileges:
-        ```bash
-        python create_admin.py
-        ```
-    * Follow the prompts to enter a username, email, and password.
-
-7.  **Run the Application:**
-    * **Option A (Flask Development Server - recommended for local dev):**
-        ```bash
-        flask run --host=0.0.0.0 --port=8899
-        # Or (if flask command not found, ensure venv is active):
-        # python app.py
-        ```
-    * **Option B (Gunicorn - closer to production):**
-        ```bash
-        gunicorn --workers 3 --bind 0.0.0.0:8899 --timeout 600 app:app
-        ```
-
-8.  **Access Speakr:** Open your web browser and navigate to `http://localhost:8899` (or your server's IP address if running remotely).
-
-### 2. Deployment (Linux with Systemd)
-
-The `deployment/setup.sh` script automates the setup process on a Linux server using `systemd`.
-
-**Warning:** Review the script carefully before running it, especially the paths and user (`$USER`) it assumes.
-
-1.  **Copy Project:** Ensure all project files (including the `deployment` directory and your configured `.env` file) are on the target server.
-2.  **Make Script Executable:**
-    ```bash
-    chmod +x deployment/setup.sh
-    ```
-3.  **Run Setup Script:**
-    ```bash
-    sudo bash deployment/setup.sh
-    ```
-    * This script will:
-        * Create `/opt/transcription-app`.
-        * Copy necessary files.
-        * Set up Python virtual environment and install dependencies.
-        * Ensure `.env` exists and has a `SECRET_KEY`.
-        * Create `uploads` and `instance` directories.
-        * Initialize or migrate the database (`reset_db.py` on first run, `migrate_db.py` otherwise).
-        * Set file ownership.
-        * Create and enable a `systemd` service (`transcription.service`) to run the app with Gunicorn.
-        * Start the service.
-        * Prompt you to create an admin user.
-
-4.  **Service Management:**
-    * **Check Status:** `sudo systemctl status transcription.service`
-    * **Stop Service:** `sudo systemctl stop transcription.service`
-    * **Start Service:** `sudo systemctl start transcription.service`
-    * **Restart Service:** `sudo systemctl restart transcription.service`
-    * **View Logs:** `sudo journalctl -u transcription.service -f` (follow logs)
-    * **View Recent Logs:** `sudo journalctl -u transcription.service -n 100 --no-pager`
-
-5.  **Access Speakr:** Open your web browser and navigate to `http://YOUR_SERVER_IP:8899`.
-
-## Configuration
-
-Configuration is primarily handled through the `.env` file in the project root (or `/opt/transcription-app` if deployed using the script).
-
-**Key Variables:**
-
-* `OPENROUTER_API_KEY`: **Required.** Your API key for the chat/summarization model endpoint (e.g., OpenRouter API Key).
-* `OPENROUTER_BASE_URL`: *Optional.* The base URL for the chat/summarization API. Defaults to OpenRouter's URL.
-* `OPENROUTER_MODEL_NAME`: *Optional.* The specific model to use for chat/summarization (e.g., `openai/gpt-4o-mini`, `google/gemini-flash-1.5`). Defaults to `openai/gpt-4o-mini` if not set (update from code default).
-* `OPENAI_API_KEY`: **Required.** Your API key for the transcription endpoint. For local endpoints, this might be a specific string like "none" or "NA". Check your endpoint's documentation.
-* `OPENAI_BASE_URL`: **Required.** The base URL for your transcription API endpoint (e.g., `http://localhost:8787/v1/`).
-* `TRANSCRIPTION_MODEL_NAME`: *Optional.* The specific model name your transcription endpoint uses/expects (e.g., `Systran/faster-distil-whisper-large-v3`). Check your endpoint's requirements.
-* `SECRET_KEY`: **Required.** A long, random string used by Flask for session security. The `setup.sh` script generates one if it's missing.
-* `ALLOW_REGISTRATION`: *Optional.* Set to `false` to prevent new users from registering via the web UI. Defaults to `true`.
-
-## Usage
-
-1.  **Register/Login:** Access the web application via your browser. Register a new account (if enabled) or log in.
-2.  **Upload:** Go to "New Recording" or drag-and-drop audio files onto the page. Upload progress and subsequent processing status will appear in the bottom-left popup.
-3.  **View Recordings:** The main "Gallery" view lists your recordings, grouped by date. Click on a recording to view its details.
-4.  **Interact:**
-    * Listen to the audio using the player.
-    * Read the transcription.
-    * Review the AI-generated summary and title.
-    * Read or edit metadata (participants, notes, meeting date). Use the small edit icons or the "Edit Details" button.
-    * Use the "Chat with Transcript" panel to ask questions about the recording content.
-5.  **Manage:** Edit details or delete recordings using the buttons in the detail view or the icons in the recording list.
-
-## Admin Panel
-
-* Accessible at `/admin` for logged-in admin users.
-* **User Management:** View, add, edit (username, email, password, admin status), and delete users.
-* **System Statistics:** View application-wide usage data.
-
-## Database Management
-
-The following scripts are located in the application root (`/opt/transcription-app` if deployed):
-
-* `migrate_db.py`, `migrate_original_filename.py`, `migrate_is_admin.py`: Run these (in order if setting up an older version) to apply schema updates *without* losing existing data. The `setup.sh` script runs `migrate_db.py` automatically if the database already exists.
-* `reset_db.py`: **Use with caution!** This script deletes the existing database (`instance/transcriptions.db`) and the contents of the `uploads` directory, then creates a fresh, empty database schema.
-
-## License
-
-This project is **dual-licensed**:
-
-1.  **GNU Affero General Public License v3.0 (AGPLv3)**
-    [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
-
-    Speakr is offered under the AGPLv3 as its open-source license. You are free to use, modify, and distribute this software under the terms of the AGPLv3. A key condition of the AGPLv3 is that if you run a modified version on a network server and provide access to it for others, you must also make the source code of your modified version available to those users under the AGPLv3.
-
-    * You **must** create a file named `LICENSE` (or `COPYING`) in the root of your repository and paste the full text of the [GNU AGPLv3 license](https://www.gnu.org/licenses/agpl-3.0.txt) into it.
-    * Read the full license text carefully to understand your rights and obligations.
-
-2.  **Commercial License**
-
-    For users or organizations who cannot or do not wish to comply with the terms of the AGPLv3 (for example, if you want to integrate Speakr into a proprietary commercial product or service without being obligated to share your modifications under AGPLv3), a separate commercial license is available.
-
-    Please contact **[Your Name/Company Name and Email Address or Website Link for Licensing Inquiries]** for details on obtaining a commercial license.
-
-**You must choose one of these licenses** under which to use, modify, or distribute this software. If you are using or distributing the software without a commercial license agreement, you must adhere to the terms of the AGPLv3.
-
-## Contributing
-
-While direct code contributions are not the primary focus at this stage, feedback, bug reports, and feature suggestions are highly valuable! Please feel free to open an Issue on the GitHub repository.
-
-**Note on Future Contributions and CLAs:**
-Should this project begin accepting code contributions from external developers in the future, signing a **Contributor License Agreement (CLA)** will be **required** before any pull requests can be merged. This policy ensures that the project maintainer receives the necessary rights to distribute all contributions under both the AGPLv3 and the commercial license options offered. Details on the CLA process will be provided if and when the project formally opens up to external code contributions.
\ No newline at end of file
diff --git a/requirements-embeddings.txt b/requirements-embeddings.txt
new file mode 100644
index 00000000..81a9a1e2
--- /dev/null
+++ b/requirements-embeddings.txt
@@ -0,0 +1,2 @@
+sentence-transformers==2.7.0
+huggingface-hub>=0.19.0
diff --git a/requirements.txt b/requirements.txt
index 5047e6e6..976c5c6b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,9 +3,23 @@ flask-sqlalchemy==3.1.1
 flask-login==0.6.3
 flask-wtf==1.2.2
 flask-bcrypt==1.0.1
+Flask-Limiter==3.5.0
+flask-openapi3>=3.0.0
+pydantic>=2.0.0
+authlib>=1.3.0
+itsdangerous>=2.1.0
 email-validator==2.2.0
-openai==1.3.0
+openai>=2.2.0
+pywebpush==1.14.0
 werkzeug==2.3.7
 gunicorn==21.2.0
 python-dotenv==1.0.0
 markdown==3.5.1
+pytz==2024.1
+Babel==2.12.1
+bleach==6.1.0
+python-docx==1.1.0
+numpy==1.24.3
+scikit-learn==1.5.0
+scipy<1.15
+psycopg2-binary>=2.9.0
diff --git a/create_admin.py b/scripts/create_admin.py
similarity index 87%
rename from create_admin.py
rename to scripts/create_admin.py
index 1db4a075..62b4917d 100644
--- a/create_admin.py
+++ b/scripts/create_admin.py
@@ -5,6 +5,9 @@
 import getpass
 from email_validator import validate_email, EmailNotValidError
 
+# Add parent directory to path for imports
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
 # Try to import from app context
 try:
     from flask import current_app
@@ -16,7 +19,7 @@
 except (RuntimeError, AttributeError, KeyError):
     # If not in app context, import directly
     try:
-        from app import app, db, User, bcrypt
+        from src.app import app, db, User, bcrypt
     except ImportError as e:
         print(f"Error: Could not import required modules: {e}")
         print("Make sure create_admin.py is runnable and PYTHONPATH is set.")
@@ -45,12 +48,13 @@ def create_admin_user():
             break
     
     # Get email
+    skip_domain_check = os.environ.get('SKIP_EMAIL_DOMAIN_CHECK', 'false').lower() == 'true'
     while True:
         email = input("Enter email address: ").strip()
         try:
-            # Validate email
-            validate_email(email)
-            
+            # Validate email (skip DNS/MX check if SKIP_EMAIL_DOMAIN_CHECK=true)
+            validate_email(email, check_deliverability=not skip_domain_check)
+
             # Check if email already exists
             with app.app_context():
                 existing_email = db.session.query(User).filter_by(email=email).first()
diff --git a/scripts/docker-entrypoint.sh b/scripts/docker-entrypoint.sh
new file mode 100644
index 00000000..8da7d0db
--- /dev/null
+++ b/scripts/docker-entrypoint.sh
@@ -0,0 +1,25 @@
+#!/bin/bash
+set -e
+
+# Create necessary directories
+mkdir -p /data/uploads /data/instance
+chmod 755 /data/uploads /data/instance
+
+# Initialize the database if it doesn't exist
+if [ ! -f /data/instance/transcriptions.db ]; then
+    echo "Database doesn't exist. Creating new database..."
+    python -c "from src.app import app, db; app.app_context().push(); db.create_all()"
+    echo "Database created successfully."
+else
+    echo "Database exists. Checking for schema updates..."
+    python -c "from src.app import app; app.app_context().push()"
+fi
+
+# Check if we need to create an admin user (regardless of whether the database exists)
+if [ -n "$ADMIN_USERNAME" ] && [ -n "$ADMIN_EMAIL" ] && [ -n "$ADMIN_PASSWORD" ]; then
+    echo "Creating admin user using environment variables..."
+    cd /app && python scripts/docker_create_admin.py
+fi
+
+# Start the application
+exec "$@"
diff --git a/scripts/docker_create_admin.py b/scripts/docker_create_admin.py
new file mode 100644
index 00000000..801afba9
--- /dev/null
+++ b/scripts/docker_create_admin.py
@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+from email_validator import validate_email, EmailNotValidError
+
+# Add parent directory to path for imports
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+# Try to import from app context
+try:
+    from flask import current_app
+    app = current_app._get_current_object()
+    with app.app_context():
+        db = app.extensions['sqlalchemy'].db
+        User = app.extensions['sqlalchemy'].db.metadata.tables['user']
+        bcrypt = app.extensions.get('bcrypt')
+except (RuntimeError, AttributeError, KeyError):
+    # If not in app context, import directly
+    try:
+        from src.app import app, db, User, bcrypt
+    except ImportError as e:
+        print(f"Error: Could not import required modules: {e}")
+        print("Make sure docker_create_admin.py is runnable and PYTHONPATH is set.")
+        sys.exit(1)
+
+def create_admin_user_from_env():
+    """
+    Create an admin user from environment variables.
+    Required environment variables:
+    - ADMIN_USERNAME
+    - ADMIN_EMAIL
+    - ADMIN_PASSWORD
+    """
+    print("Creating admin user for Speakr application from environment variables")
+    print("=================================================================")
+    
+    # Get values from environment variables
+    username = os.environ.get('ADMIN_USERNAME')
+    email = os.environ.get('ADMIN_EMAIL')
+    password = os.environ.get('ADMIN_PASSWORD')
+    
+    # Validate required environment variables
+    if not username or not email or not password:
+        print("Error: ADMIN_USERNAME, ADMIN_EMAIL, and ADMIN_PASSWORD environment variables must be set.")
+        sys.exit(1)
+    
+    # Validate username
+    if len(username) < 3:
+        print("Error: Username must be at least 3 characters long.")
+        sys.exit(1)
+    
+    # Validate email (skip DNS/MX check if SKIP_EMAIL_DOMAIN_CHECK=true)
+    skip_domain_check = os.environ.get('SKIP_EMAIL_DOMAIN_CHECK', 'false').lower() == 'true'
+    try:
+        validate_email(email, check_deliverability=not skip_domain_check)
+    except EmailNotValidError as e:
+        print(f"Error: Invalid email: {str(e)}")
+        sys.exit(1)
+    
+    # Validate password
+    if len(password) < 8:
+        print("Error: Password must be at least 8 characters long.")
+        sys.exit(1)
+    
+    # Create user
+    with app.app_context():
+        # Check if username already exists
+        existing_user = db.session.query(User).filter_by(username=username).first()
+        if existing_user:
+            print(f"User with username '{username}' already exists.")
+            sys.exit(0)
+        
+        # Check if email already exists
+        existing_email = db.session.query(User).filter_by(email=email).first()
+        if existing_email:
+            print(f"User with email '{email}' already exists.")
+            sys.exit(0)
+        
+        # Create new admin user
+        hashed_password = bcrypt.generate_password_hash(password).decode('utf-8')
+        new_user = User(username=username, email=email, password=hashed_password, is_admin=True)
+        db.session.add(new_user)
+        db.session.commit()
+        
+        print("\nAdmin user created successfully!")
+        print(f"Username: {username}")
+        print(f"Email: {email}")
+        print("You can now log in to the application with these credentials.")
+
+if __name__ == "__main__":
+    create_admin_user_from_env()
diff --git a/scripts/download_offline_deps.py b/scripts/download_offline_deps.py
new file mode 100644
index 00000000..67c81cdd
--- /dev/null
+++ b/scripts/download_offline_deps.py
@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""
+Download all CDN dependencies for offline deployment
+"""
+
+import os
+import requests
+from pathlib import Path
+
+# Base directory for vendor files
+VENDOR_DIR = Path(__file__).parent.parent / "static" / "vendor"
+
+# Dependencies to download
+DEPENDENCIES = {
+    "css": {
+        "fontawesome.min.css": "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css",
+        "easymde.min.css": "https://cdn.jsdelivr.net/npm/easymde/dist/easymde.min.css",
+    },
+    "js": {
+        "tailwind.min.js": "https://cdn.tailwindcss.com/3.4.0",
+        "vue.global.js": "https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.js",
+        "marked.min.js": "https://cdn.jsdelivr.net/npm/marked/marked.min.js",
+        "easymde.min.js": "https://cdn.jsdelivr.net/npm/easymde/dist/easymde.min.js",
+        "axios.min.js": "https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js",
+    }
+}
+
+# Font Awesome webfonts
+FONTAWESOME_FONTS = [
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-brands-400.ttf",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-brands-400.woff2",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-regular-400.ttf",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-regular-400.woff2",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-solid-900.ttf",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-solid-900.woff2",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-v4compatibility.ttf",
+    "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/fa-v4compatibility.woff2",
+]
+
+def download_file(url, filepath):
+    """Download a file from URL to filepath"""
+    print(f"Downloading {url} to {filepath}")
+    try:
+        response = requests.get(url, timeout=30)
+        response.raise_for_status()
+
+        # Create directory if it doesn't exist
+        filepath.parent.mkdir(parents=True, exist_ok=True)
+
+        # Write file
+        with open(filepath, 'wb') as f:
+            f.write(response.content)
+        print(f"  ✓ Downloaded {filepath.name}")
+        return True
+    except Exception as e:
+        print(f"  ✗ Failed to download {url}: {e}")
+        return False
+
+def main():
+    print("Downloading offline dependencies...")
+    print(f"Vendor directory: {VENDOR_DIR}")
+    
+    # Check if we're in production mode
+    is_production = os.environ.get('FLASK_ENV') == 'production' or os.environ.get('PRODUCTION') == '1'
+    
+    if is_production:
+        print("⚙️  PRODUCTION MODE: Using production builds")
+        # Replace Vue.js development build with production build
+        DEPENDENCIES['js']['vue.global.js'] = "https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"
+    else:
+        print("⚙️  DEVELOPMENT MODE: Using development builds")
+
+    # Download CSS and JS files
+    for file_type, files in DEPENDENCIES.items():
+        print(f"\n{file_type.upper()} Files:")
+        for filename, url in files.items():
+            filepath = VENDOR_DIR / file_type / filename
+            download_file(url, filepath)
+
+    # Download Font Awesome fonts
+    print("\nFont Awesome Webfonts:")
+    for url in FONTAWESOME_FONTS:
+        filename = url.split("/")[-1]
+        filepath = VENDOR_DIR / "fonts" / "webfonts" / filename
+        download_file(url, filepath)
+
+    # Update Font Awesome CSS to use local fonts
+    fa_css_path = VENDOR_DIR / "css" / "fontawesome.min.css"
+    if fa_css_path.exists():
+        print("\nUpdating Font Awesome CSS to use local fonts...")
+        with open(fa_css_path, 'r') as f:
+            content = f.read()
+
+        # Replace CDN URLs with local paths - handle both relative and absolute URLs
+        content = content.replace(
+            "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/webfonts/",
+            "../fonts/webfonts/"
+        )
+        # Also replace any relative URLs that might be in the minified CSS
+        content = content.replace(
+            "../webfonts/",
+            "../fonts/webfonts/"
+        )
+        content = content.replace(
+            "./webfonts/",
+            "../fonts/webfonts/"
+        )
+
+        with open(fa_css_path, 'w') as f:
+            f.write(content)
+        print("  ✓ Updated Font Awesome CSS paths")
+
+    print("\n✅ All dependencies downloaded successfully!")
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/migrate_docker.sh b/scripts/migrate_docker.sh
new file mode 100644
index 00000000..c2eaa7ce
--- /dev/null
+++ b/scripts/migrate_docker.sh
@@ -0,0 +1,44 @@
+#!/bin/bash
+# Manual migration script for Docker deployments
+# NOTE: The first 10 recordings are processed automatically on startup.
+# This script is for processing any remaining recordings.
+
+echo "🎯 Inquire Mode Manual Migration for Docker"
+echo "============================================="
+
+# Check if container is running
+if ! docker compose ps | grep -q "speakr.*Up"; then
+    echo "❌ Speakr container is not running. Please start it first with:"
+    echo "   docker compose up -d"
+    exit 1
+fi
+
+echo "ℹ️  Note: The first 10 recordings are processed automatically on startup."
+echo "ℹ️  This script processes any remaining recordings that need chunking."
+echo ""
+echo "🔍 Checking how many recordings still need processing..."
+
+# First, do a dry run to see what would be processed
+docker compose exec app python migrate_existing_recordings.py --dry-run
+
+echo ""
+echo "⚠️  Do you want to proceed with processing these recordings?"
+echo "⚠️  This will create embeddings and may take several minutes."
+read -p "Continue? (y/N): " -n 1 -r
+echo
+
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+    echo "🚀 Starting migration..."
+    docker compose exec app python migrate_existing_recordings.py --process --batch-size 5
+    
+    if [ $? -eq 0 ]; then
+        echo "✅ Migration completed successfully!"
+        echo "🎉 Your existing recordings are now ready for Inquire Mode!"
+    else
+        echo "❌ Migration failed. Check the logs above for details."
+        exit 1
+    fi
+else
+    echo "❌ Migration cancelled."
+    exit 0
+fi
\ No newline at end of file
diff --git a/scripts/migrate_existing_recordings.py b/scripts/migrate_existing_recordings.py
new file mode 100644
index 00000000..203ea006
--- /dev/null
+++ b/scripts/migrate_existing_recordings.py
@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+Migration script to process existing recordings for Inquire Mode.
+This script will chunk and vectorize all existing recordings that haven't been processed yet.
+"""
+import os
+import sys
+from src.app import app, db, Recording, TranscriptChunk, process_recording_chunks
+
+def count_recordings_needing_processing():
+    """Count how many recordings need chunk processing."""
+    with app.app_context():
+        # Get all completed recordings
+        completed_recordings = Recording.query.filter_by(status='COMPLETED').all()
+        
+        # Check which ones don't have chunks
+        recordings_needing_processing = []
+        for recording in completed_recordings:
+            if recording.transcription:  # Has transcription
+                chunk_count = TranscriptChunk.query.filter_by(recording_id=recording.id).count()
+                if chunk_count == 0:  # No chunks yet
+                    recordings_needing_processing.append(recording)
+        
+        return recordings_needing_processing
+
+def migrate_existing_recordings(batch_size=10, dry_run=False):
+    """
+    Process existing recordings in batches to create chunks and embeddings.
+    
+    Args:
+        batch_size (int): Number of recordings to process at once
+        dry_run (bool): If True, just show what would be processed
+    """
+    with app.app_context():
+        recordings_to_process = count_recordings_needing_processing()
+        
+        print(f"🔍 Found {len(recordings_to_process)} recordings that need chunk processing")
+        
+        if len(recordings_to_process) == 0:
+            print("✅ All recordings are already processed!")
+            return True
+        
+        if dry_run:
+            print("\n📋 Recordings that would be processed:")
+            for i, recording in enumerate(recordings_to_process, 1):
+                print(f"  {i}. {recording.title} (ID: {recording.id}) - {len(recording.transcription)} chars")
+            print(f"\nThis is a dry run. Use --process to actually run the migration.")
+            return True
+        
+        print(f"🚀 Processing {len(recordings_to_process)} recordings in batches of {batch_size}")
+        
+        processed = 0
+        errors = 0
+        
+        for i in range(0, len(recordings_to_process), batch_size):
+            batch = recordings_to_process[i:i + batch_size]
+            print(f"\n📦 Processing batch {i//batch_size + 1} ({len(batch)} recordings)...")
+            
+            for recording in batch:
+                try:
+                    print(f"  ⏳ Processing: {recording.title} (ID: {recording.id})")
+                    
+                    success = process_recording_chunks(recording.id)
+                    if success:
+                        processed += 1
+                        # Get chunk count to report
+                        chunk_count = TranscriptChunk.query.filter_by(recording_id=recording.id).count()
+                        print(f"    ✅ Created {chunk_count} chunks")
+                    else:
+                        errors += 1
+                        print(f"    ❌ Failed to process recording {recording.id}")
+                        
+                except Exception as e:
+                    errors += 1
+                    print(f"    ❌ Error processing recording {recording.id}: {e}")
+            
+            # Commit batch
+            try:
+                db.session.commit()
+                print(f"  💾 Batch committed successfully")
+            except Exception as e:
+                db.session.rollback()
+                print(f"  ❌ Error committing batch: {e}")
+                errors += len(batch)
+        
+        print(f"\n📊 Migration Summary:")
+        print(f"  ✅ Successfully processed: {processed}")
+        print(f"  ❌ Errors: {errors}")
+        print(f"  📈 Success rate: {(processed/(processed+errors)*100):.1f}%" if (processed+errors) > 0 else "N/A")
+        
+        return errors == 0
+
+def main():
+    """Main function to handle command line arguments."""
+    import argparse
+    
+    parser = argparse.ArgumentParser(description='Migrate existing recordings for Inquire Mode')
+    parser.add_argument('--dry-run', action='store_true', 
+                       help='Show what would be processed without actually processing')
+    parser.add_argument('--process', action='store_true',
+                       help='Actually process the recordings')
+    parser.add_argument('--batch-size', type=int, default=10,
+                       help='Number of recordings to process in each batch (default: 10)')
+    
+    args = parser.parse_args()
+    
+    if not args.dry_run and not args.process:
+        print("❌ Please specify either --dry-run or --process")
+        print("Use --help for more information")
+        return False
+    
+    print("🎯 Inquire Mode Migration Tool")
+    print("=" * 40)
+    
+    try:
+        if args.dry_run:
+            success = migrate_existing_recordings(args.batch_size, dry_run=True)
+        else:
+            print("⚠️  This will process all existing recordings and create embeddings.")
+            print("⚠️  This may take a while and use significant CPU/memory.")
+            
+            confirm = input("Continue? (y/N): ")
+            if confirm.lower() != 'y':
+                print("❌ Migration cancelled by user")
+                return False
+            
+            success = migrate_existing_recordings(args.batch_size, dry_run=False)
+        
+        return success
+        
+    except KeyboardInterrupt:
+        print("\n❌ Migration cancelled by user")
+        return False
+    except Exception as e:
+        print(f"❌ Migration failed: {e}")
+        import traceback
+        traceback.print_exc()
+        return False
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1)
\ No newline at end of file
diff --git a/scripts/migrate_team_to_group.py b/scripts/migrate_team_to_group.py
new file mode 100755
index 00000000..e7546c47
--- /dev/null
+++ b/scripts/migrate_team_to_group.py
@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""
+Migration script to rename team tables to group tables.
+This handles the refactoring from team-based to group-based terminology.
+"""
+import sys
+import os
+
+# Add the parent directory to the path to import app modules
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+
+from src.app import app, db
+from sqlalchemy import text
+
+def migrate_tables():
+    """Copy data from team tables to group tables and remove old tables."""
+    with app.app_context():
+        try:
+            # Check if old tables exist
+            inspector = db.inspect(db.engine)
+            existing_tables = inspector.get_table_names()
+
+            print("Existing tables:", existing_tables)
+
+            # Check if we need to migrate data
+            if 'team' in existing_tables and 'group' in existing_tables:
+                # Both tables exist - need to copy data
+                print("\nBoth 'team' and 'group' tables exist. Copying data...")
+
+                # Check if there's data in the old table
+                result = db.session.execute(text('SELECT COUNT(*) FROM team'))
+                old_count = result.scalar()
+                print(f"Found {old_count} records in 'team' table")
+
+                if old_count > 0:
+                    # Copy data from team to group
+                    print("Copying data from 'team' to 'group'...")
+                    db.session.execute(text(
+                        'INSERT INTO "group" (id, name, description, created_at) '
+                        'SELECT id, name, description, created_at FROM team'
+                    ))
+                    db.session.commit()
+                    print(f"✓ Copied {old_count} records to 'group' table")
+
+                # Drop the old team table
+                print("Dropping old 'team' table...")
+                db.session.execute(text('DROP TABLE team'))
+                db.session.commit()
+                print("✓ Dropped old 'team' table")
+
+            elif 'team' in existing_tables and 'group' not in existing_tables:
+                # Only old table exists - rename it
+                print("\nRenaming 'team' table to 'group'...")
+                db.session.execute(text('ALTER TABLE team RENAME TO "group"'))
+                db.session.commit()
+                print("✓ Renamed 'team' to 'group'")
+            else:
+                print("\n'team' table not found or already migrated")
+
+            # Migrate team_membership
+            if 'team_membership' in existing_tables and 'group_membership' in existing_tables:
+                # Both tables exist - need to copy data
+                print("\nBoth 'team_membership' and 'group_membership' tables exist. Copying data...")
+
+                # Check if there's data in the old table
+                result = db.session.execute(text('SELECT COUNT(*) FROM team_membership'))
+                old_count = result.scalar()
+                print(f"Found {old_count} records in 'team_membership' table")
+
+                if old_count > 0:
+                    # Copy data from team_membership to group_membership
+                    print("Copying data from 'team_membership' to 'group_membership'...")
+                    db.session.execute(text(
+                        'INSERT INTO group_membership (id, user_id, group_id, role, joined_at) '
+                        'SELECT id, user_id, team_id, role, joined_at FROM team_membership'
+                    ))
+                    db.session.commit()
+                    print(f"✓ Copied {old_count} records to 'group_membership' table")
+
+                # Drop the old team_membership table
+                print("Dropping old 'team_membership' table...")
+                db.session.execute(text('DROP TABLE team_membership'))
+                db.session.commit()
+                print("✓ Dropped old 'team_membership' table")
+
+            elif 'team_membership' in existing_tables and 'group_membership' not in existing_tables:
+                # Only old table exists - rename it
+                print("\nRenaming 'team_membership' table to 'group_membership'...")
+                db.session.execute(text('ALTER TABLE team_membership RENAME TO group_membership'))
+                db.session.commit()
+                print("✓ Renamed 'team_membership' to 'group_membership'")
+            else:
+                print("\n'team_membership' table not found or already migrated")
+
+            # Migrate team_id to group_id in tags table
+            print("\nMigrating tag associations from team_id to group_id...")
+            result = db.session.execute(text(
+                'UPDATE tag SET group_id = team_id WHERE team_id IS NOT NULL AND group_id IS NULL'
+            ))
+            db.session.commit()
+            print(f"✓ Migrated {result.rowcount} tag associations")
+
+            # Migrate share_with_team_lead to share_with_group_lead in tags
+            result = db.session.execute(text(
+                'UPDATE tag SET share_with_group_lead = share_with_team_lead WHERE share_with_team_lead IS NOT NULL AND share_with_group_lead IS NULL'
+            ))
+            db.session.commit()
+            print(f"✓ Migrated {result.rowcount} share_with_lead settings")
+
+            print("\n✅ Migration completed successfully!")
+            print("\nPlease restart the application for changes to take full effect.")
+
+        except Exception as e:
+            print(f"\n❌ Error during migration: {e}")
+            db.session.rollback()
+            sys.exit(1)
+
+if __name__ == '__main__':
+    print("=" * 60)
+    print("Team to Group Migration Script")
+    print("=" * 60)
+    print("\nThis script will rename database tables:")
+    print("  - 'team' → 'group'")
+    print("  - 'team_membership' → 'group_membership'")
+
+    # Check for --yes flag to skip confirmation
+    if '--yes' in sys.argv or '-y' in sys.argv:
+        print("\nAuto-confirming migration (--yes flag detected)...\n")
+    else:
+        print("\nPress Ctrl+C to cancel, or Enter to continue...")
+        try:
+            input()
+        except KeyboardInterrupt:
+            print("\n\nMigration cancelled.")
+            sys.exit(0)
+
+    migrate_tables()
diff --git a/scripts/parse_asr_json.py b/scripts/parse_asr_json.py
new file mode 100755
index 00000000..b394ebaf
--- /dev/null
+++ b/scripts/parse_asr_json.py
@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+"""
+ASR JSON Parser - Analyzes speaker information in ASR response JSON files
+"""
+
+import json
+import sys
+from collections import defaultdict, Counter
+
+def analyze_asr_json(json_data):
+    """
+    Analyze ASR JSON data to understand speaker distribution and identify issues
+    """
+    if not isinstance(json_data, dict) or 'segments' not in json_data:
+        print("ERROR: Invalid JSON structure. Expected dict with 'segments' key.")
+        return
+    
+    segments = json_data['segments']
+    if not isinstance(segments, list):
+        print("ERROR: 'segments' should be a list.")
+        return
+    
+    print(f"=== ASR JSON Analysis ===")
+    print(f"Total segments: {len(segments)}")
+    print()
+    
+    # Track segment-level speakers
+    segment_speakers = []
+    segments_with_speaker = 0
+    segments_without_speaker = 0
+    
+    # Track word-level speakers
+    word_speakers = []
+    words_with_speaker = 0
+    words_without_speaker = 0
+    
+    # Track segments with null speakers
+    null_speaker_segments = []
+    
+    for i, segment in enumerate(segments):
+        # Analyze segment-level speaker
+        segment_speaker = segment.get('speaker')
+        if segment_speaker is not None:
+            segment_speakers.append(segment_speaker)
+            segments_with_speaker += 1
+        else:
+            segments_without_speaker += 1
+            null_speaker_segments.append(i)
+        
+        # Analyze word-level speakers
+        words = segment.get('words', [])
+        for word_data in words:
+            word_speaker = word_data.get('speaker')
+            if word_speaker is not None:
+                word_speakers.append(word_speaker)
+                words_with_speaker += 1
+            else:
+                words_without_speaker += 1
+    
+    # Print segment-level analysis
+    print("=== SEGMENT-LEVEL SPEAKERS ===")
+    print(f"Segments with speakers: {segments_with_speaker}")
+    print(f"Segments without speakers: {segments_without_speaker}")
+    
+    if segment_speakers:
+        segment_speaker_counts = Counter(segment_speakers)
+        print(f"Unique segment speakers: {sorted(segment_speaker_counts.keys())}")
+        print("Segment speaker distribution:")
+        for speaker, count in segment_speaker_counts.most_common():
+            print(f"  {speaker}: {count} segments")
+    else:
+        print("No segment-level speakers found!")
+    
+    print()
+    
+    # Print word-level analysis
+    print("=== WORD-LEVEL SPEAKERS ===")
+    print(f"Words with speakers: {words_with_speaker}")
+    print(f"Words without speakers: {words_without_speaker}")
+    
+    if word_speakers:
+        word_speaker_counts = Counter(word_speakers)
+        print(f"Unique word speakers: {sorted(word_speaker_counts.keys())}")
+        print("Word speaker distribution:")
+        for speaker, count in word_speaker_counts.most_common():
+            print(f"  {speaker}: {count} words")
+    else:
+        print("No word-level speakers found!")
+    
+    print()
+    
+    # Analyze segments without speakers
+    if null_speaker_segments:
+        print("=== SEGMENTS WITHOUT SPEAKERS ===")
+        print(f"Segment indices without speakers: {null_speaker_segments[:10]}{'...' if len(null_speaker_segments) > 10 else ''}")
+        
+        print("\nFirst few segments without speakers:")
+        for i in null_speaker_segments[:5]:
+            segment = segments[i]
+            text = segment.get('text', '').strip()
+            start = segment.get('start')
+            end = segment.get('end')
+            words = segment.get('words', [])
+            
+            print(f"  Segment {i}: '{text}' ({start}-{end}s)")
+            print(f"    Keys: {list(segment.keys())}")
+            
+            # Check if words have speakers even when segment doesn't
+            word_speakers_in_segment = [w.get('speaker') for w in words if w.get('speaker')]
+            if word_speakers_in_segment:
+                word_speaker_counts = Counter(word_speakers_in_segment)
+                print(f"    Word speakers: {dict(word_speaker_counts)}")
+            else:
+                print(f"    No word speakers either")
+            print()
+    
+    # Suggest speaker assignment strategy
+    print("=== SPEAKER ASSIGNMENT STRATEGY ===")
+    if segments_without_speaker > 0:
+        print(f"Found {segments_without_speaker} segments without speakers.")
+        
+        if words_with_speaker > 0:
+            print("RECOMMENDATION: Use word-level speaker information to assign segment speakers.")
+            print("Strategy: For segments without speakers, find the most common speaker among their words.")
+        else:
+            print("RECOMMENDATION: Assign a default speaker label (e.g., 'UNKNOWN_SPEAKER') to segments without speakers.")
+    else:
+        print("All segments have speakers assigned. No action needed.")
+
+def suggest_preprocessing_fix(json_data):
+    """
+    Suggest how to fix the preprocessing based on the JSON structure
+    """
+    print("\n=== PREPROCESSING FIX SUGGESTION ===")
+    
+    segments = json_data.get('segments', [])
+    if not segments:
+        return
+    
+    # Check if we can derive segment speakers from word speakers
+    segments_fixable = 0
+    for segment in segments:
+        if segment.get('speaker') is None:
+            words = segment.get('words', [])
+            word_speakers = [w.get('speaker') for w in words if w.get('speaker')]
+            if word_speakers:
+                segments_fixable += 1
+    
+    if segments_fixable > 0:
+        print(f"✅ {segments_fixable} segments can be fixed using word-level speaker information.")
+        print("\nSuggested code fix:")
+        print("""
+# In the ASR processing function, replace the segment processing with:
+for i, segment in enumerate(asr_response_data['segments']):
+    speaker = segment.get('speaker')
+    text = segment.get('text', '').strip()
+    
+    # If segment doesn't have a speaker, try to derive from words
+    if speaker is None:
+        words = segment.get('words', [])
+        word_speakers = [w.get('speaker') for w in words if w.get('speaker')]
+        if word_speakers:
+            # Use the most common speaker among the words
+            from collections import Counter
+            speaker_counts = Counter(word_speakers)
+            speaker = speaker_counts.most_common(1)[0][0]
+            app.logger.info(f"Derived speaker '{speaker}' for segment {i} from word-level data")
+        else:
+            speaker = 'UNKNOWN_SPEAKER'
+            app.logger.warning(f"No speaker info available for segment {i}, using UNKNOWN_SPEAKER")
+    
+    simplified_segments.append({
+        'speaker': speaker,
+        'sentence': text,
+        'start_time': segment.get('start'),
+        'end_time': segment.get('end')
+    })
+""")
+    else:
+        print("❌ Segments cannot be fixed using word-level data.")
+        print("Recommendation: Assign 'UNKNOWN_SPEAKER' to segments without speakers.")
+
+def main():
+    if len(sys.argv) != 2:
+        print("Usage: python parse_asr_json.py <json_file>")
+        print("   or: python parse_asr_json.py -")
+        print("       (use '-' to read from stdin)")
+        sys.exit(1)
+    
+    filename = sys.argv[1]
+    
+    try:
+        if filename == '-':
+            # Read from stdin
+            json_text = sys.stdin.read()
+        else:
+            # Read from file
+            with open(filename, 'r', encoding='utf-8') as f:
+                json_text = f.read()
+        
+        # Parse JSON
+        json_data = json.loads(json_text)
+        
+        # Analyze the data
+        analyze_asr_json(json_data)
+        suggest_preprocessing_fix(json_data)
+        
+    except FileNotFoundError:
+        print(f"ERROR: File '{filename}' not found.")
+        sys.exit(1)
+    except json.JSONDecodeError as e:
+        print(f"ERROR: Invalid JSON - {e}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"ERROR: {e}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/pre-commit b/scripts/pre-commit
new file mode 100755
index 00000000..592cd0d5
--- /dev/null
+++ b/scripts/pre-commit
@@ -0,0 +1,21 @@
+#!/bin/sh
+#
+# Pre-commit hook: runs PostgreSQL migration compatibility tests
+# when migration-related files are staged.
+#
+# Install: ln -sf ../../scripts/pre-commit .git/hooks/pre-commit
+
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
+
+# Only run if migration-related files are staged
+if echo "$STAGED_FILES" | grep -qE '^(src/init_db\.py|src/utils/database\.py|src/models/)'; then
+    echo "Migration files changed — running PostgreSQL compatibility checks..."
+    python tests/test_migration_compatibility.py
+    if [ $? -ne 0 ]; then
+        echo ""
+        echo "Pre-commit hook FAILED: PostgreSQL migration compatibility issues found."
+        echo "Fix the issues above before committing."
+        exit 1
+    fi
+    echo "All migration compatibility checks passed."
+fi
diff --git a/reset_db.py b/scripts/reset_db.py
similarity index 98%
rename from reset_db.py
rename to scripts/reset_db.py
index e7a2db77..240fc7a3 100644
--- a/reset_db.py
+++ b/scripts/reset_db.py
@@ -5,7 +5,7 @@
 import sys
 import shutil
 # Add project root to path if necessary for 'app' import
-# sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
 
 # Load environment variables in case DB path relies on them (optional here)
 # from dotenv import load_dotenv
@@ -24,7 +24,7 @@
      # If not in app context, import directly
     try:
         # Ensure this import reflects the updated app.py with the new model
-        from app import app, db
+        from src.app import app, db
     except ImportError as e:
         print(f"Error: Could not import 'app' and 'db': {e}")
         print("Make sure reset_db.py is runnable and PYTHONPATH is set.")
diff --git a/scripts/resize_logo.py b/scripts/resize_logo.py
new file mode 100644
index 00000000..58399ada
--- /dev/null
+++ b/scripts/resize_logo.py
@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""
+Logo Resizer Script for Speakr
+Resizes a source PNG image to all required icon sizes for PWA and favicon support.
+
+Usage:
+    python resize_logo.py <source_image.png>
+
+Requirements:
+    pip install Pillow
+
+This script will create all the necessary icon sizes in the static/img/ directory.
+"""
+
+import sys
+import os
+from PIL import Image, ImageDraw
+import argparse
+
+def create_maskable_version(image, size):
+    """Create a maskable version with safe zone padding (20% on all sides)"""
+    # Calculate the size of the logo with padding
+    logo_size = int(size * 0.6)  # Logo takes 60% of the canvas (20% padding on each side)
+    
+    # Create new image with transparent background
+    maskable = Image.new('RGBA', (size, size), (0, 0, 0, 0))
+    
+    # Resize the original logo
+    logo_resized = image.resize((logo_size, logo_size), Image.Resampling.LANCZOS)
+    
+    # Calculate position to center the logo
+    x = (size - logo_size) // 2
+    y = (size - logo_size) // 2
+    
+    # Paste the logo onto the center of the canvas
+    maskable.paste(logo_resized, (x, y), logo_resized if logo_resized.mode == 'RGBA' else None)
+    
+    return maskable
+
+def resize_logo(source_path, output_dir="static/img"):
+    """Resize the source image to all required sizes"""
+    
+    # Check if source file exists
+    if not os.path.exists(source_path):
+        print(f"Error: Source file '{source_path}' not found!")
+        return False
+    
+    # Create output directory if it doesn't exist
+    os.makedirs(output_dir, exist_ok=True)
+    
+    try:
+        # Open the source image
+        with Image.open(source_path) as img:
+            # Convert to RGBA if not already (for transparency support)
+            if img.mode != 'RGBA':
+                img = img.convert('RGBA')
+            
+            print(f"Source image: {img.size[0]}x{img.size[1]} pixels")
+            print(f"Output directory: {output_dir}")
+            print()
+            
+            # Define all the sizes we need
+            sizes = {
+                # Essential PWA icons
+                'icon-192x192.png': 192,
+                'icon-512x512.png': 512,
+                
+                # Additional recommended icons
+                'icon-16x16.png': 16,
+                'icon-32x32.png': 32,
+                'icon-180x180.png': 180,  # Apple touch icon
+                
+                # Maskable version
+                'icon-maskable-512x512.png': 512,
+            }
+            
+            # Resize to each required size
+            for filename, size in sizes.items():
+                output_path = os.path.join(output_dir, filename)
+                
+                if 'maskable' in filename:
+                    # Create maskable version with safe zone
+                    resized = create_maskable_version(img, size)
+                    print(f"✓ Created maskable icon: {filename} ({size}x{size})")
+                else:
+                    # Regular resize
+                    resized = img.resize((size, size), Image.Resampling.LANCZOS)
+                    print(f"✓ Created icon: {filename} ({size}x{size})")
+                
+                # Save the resized image
+                resized.save(output_path, 'PNG', optimize=True)
+            
+            print()
+            print("🎉 All icons created successfully!")
+            print()
+            print("Next steps:")
+            print("1. Replace static/img/favicon.svg with your SVG version (if you have one)")
+            print("2. Clear browser cache and test the new icons")
+            print("3. Test PWA installation to verify icons appear correctly")
+            
+            return True
+            
+    except Exception as e:
+        print(f"Error processing image: {e}")
+        return False
+
+def create_ico_favicon(source_path, output_dir="static/img"):
+    """Create a multi-size ICO favicon file"""
+    try:
+        with Image.open(source_path) as img:
+            if img.mode != 'RGBA':
+                img = img.convert('RGBA')
+            
+            # Create different sizes for the ICO file
+            sizes = [16, 32, 48]
+            images = []
+            
+            for size in sizes:
+                resized = img.resize((size, size), Image.Resampling.LANCZOS)
+                images.append(resized)
+            
+            # Save as ICO file
+            ico_path = os.path.join(output_dir, 'favicon.ico')
+            images[0].save(ico_path, format='ICO', sizes=[(img.width, img.height) for img in images])
+            print(f"✓ Created favicon.ico with sizes: {sizes}")
+            
+    except Exception as e:
+        print(f"Warning: Could not create favicon.ico: {e}")
+
+def main():
+    parser = argparse.ArgumentParser(description='Resize logo for Speakr PWA icons')
+    parser.add_argument('source', help='Source PNG image file')
+    parser.add_argument('--output-dir', default='static/img', help='Output directory (default: static/img)')
+    parser.add_argument('--create-ico', action='store_true', help='Also create favicon.ico file')
+    
+    args = parser.parse_args()
+    
+    print("🎨 Speakr Logo Resizer")
+    print("=" * 50)
+    
+    # Resize the logo
+    success = resize_logo(args.source, args.output_dir)
+    
+    if success and args.create_ico:
+        print()
+        create_ico_favicon(args.source, args.output_dir)
+    
+    if success:
+        print()
+        print("📁 Files created in", args.output_dir + ":")
+        for file in os.listdir(args.output_dir):
+            if file.startswith('icon-') and file.endswith('.png'):
+                file_path = os.path.join(args.output_dir, file)
+                size = os.path.getsize(file_path)
+                print(f"   {file} ({size:,} bytes)")
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python resize_logo.py <source_image.png>")
+        print("Example: python resize_logo.py my_logo.png")
+        sys.exit(1)
+    
+    main()
diff --git a/scripts/resize_logo.sh b/scripts/resize_logo.sh
new file mode 100755
index 00000000..dcf0e069
--- /dev/null
+++ b/scripts/resize_logo.sh
@@ -0,0 +1,83 @@
+#!/bin/bash
+
+# Logo Resizer Script for Speakr (ImageMagick version)
+# Resizes a source PNG image to all required icon sizes for PWA and favicon support.
+#
+# Usage: ./resize_logo.sh <source_image.png>
+# Requirements: ImageMagick (sudo apt install imagemagick)
+
+set -e
+
+# Check if source file is provided
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <source_image.png>"
+    echo "Example: $0 my_logo.png"
+    exit 1
+fi
+
+SOURCE_FILE="$1"
+OUTPUT_DIR="static/img"
+
+# Check if source file exists
+if [ ! -f "$SOURCE_FILE" ]; then
+    echo "Error: Source file '$SOURCE_FILE' not found!"
+    exit 1
+fi
+
+# Check if ImageMagick is installed
+if ! command -v convert &> /dev/null; then
+    echo "Error: ImageMagick is not installed!"
+    echo "Install it with: sudo apt install imagemagick"
+    exit 1
+fi
+
+# Create output directory if it doesn't exist
+mkdir -p "$OUTPUT_DIR"
+
+echo "🎨 Speakr Logo Resizer (ImageMagick)"
+echo "=================================================="
+echo "Source file: $SOURCE_FILE"
+echo "Output directory: $OUTPUT_DIR"
+echo
+
+# Define sizes
+declare -A SIZES=(
+    ["icon-16x16.png"]=16
+    ["icon-32x32.png"]=32
+    ["icon-180x180.png"]=180
+    ["icon-192x192.png"]=192
+    ["icon-512x512.png"]=512
+)
+
+# Resize to each size
+for filename in "${!SIZES[@]}"; do
+    size=${SIZES[$filename]}
+    output_path="$OUTPUT_DIR/$filename"
+    
+    convert "$SOURCE_FILE" -resize "${size}x${size}" "$output_path"
+    echo "✓ Created icon: $filename (${size}x${size})"
+done
+
+# Create maskable version with padding
+echo "✓ Creating maskable icon with safe zone..."
+convert "$SOURCE_FILE" -resize 307x307 -gravity center -extent 512x512 -background transparent "$OUTPUT_DIR/icon-maskable-512x512.png"
+echo "✓ Created maskable icon: icon-maskable-512x512.png (512x512)"
+
+# Create favicon.ico (optional)
+if command -v convert &> /dev/null; then
+    echo "✓ Creating favicon.ico..."
+    convert "$SOURCE_FILE" -resize 16x16 -resize 32x32 -resize 48x48 "$OUTPUT_DIR/favicon.ico"
+    echo "✓ Created favicon.ico"
+fi
+
+echo
+echo "🎉 All icons created successfully!"
+echo
+echo "📁 Files created:"
+ls -la "$OUTPUT_DIR"/icon-*.png "$OUTPUT_DIR"/favicon.ico 2>/dev/null || true
+
+echo
+echo "Next steps:"
+echo "1. Replace static/img/favicon.svg with your SVG version (if you have one)"
+echo "2. Clear browser cache and test the new icons"
+echo "3. Test PWA installation to verify icons appear correctly"
diff --git a/scripts/test-docs-build.sh b/scripts/test-docs-build.sh
new file mode 100755
index 00000000..f59b9c48
--- /dev/null
+++ b/scripts/test-docs-build.sh
@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# Test script to validate documentation build locally
+# This mimics what the GitHub Actions workflow does
+
+set -e
+
+echo "Testing documentation build..."
+
+# Check if we're in the right directory
+if [ ! -f "docs/mkdocs.yml" ]; then
+    echo "Error: docs/mkdocs.yml not found. Run this script from the project root."
+    exit 1
+fi
+
+# Create a virtual environment for testing
+echo "Creating virtual environment..."
+python3 -m venv .venv-docs-test
+source .venv-docs-test/bin/activate
+
+# Install dependencies
+echo "Installing dependencies..."
+pip install --upgrade pip
+pip install -r docs/requirements-docs.txt
+
+# Build the documentation
+echo "Building documentation..."
+cd docs
+export CI=true  # Enable git plugin in CI mode
+mkdocs build --strict --site-dir _test_site
+
+echo ""
+echo "✅ Documentation build successful!"
+echo "Built site is in: docs/_test_site"
+echo ""
+echo "To serve locally for testing:"
+echo "  cd docs && mkdocs serve"
+
+# Cleanup
+cd ..
+deactivate
+rm -rf .venv-docs-test
+
+echo "Cleanup complete."
\ No newline at end of file
diff --git a/scripts/update_version.py b/scripts/update_version.py
new file mode 100644
index 00000000..15128646
--- /dev/null
+++ b/scripts/update_version.py
@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""
+Simple script to update the VERSION file.
+Usage: python update_version.py v0.4.3
+"""
+import sys
+import re
+
+def update_version(new_version):
+    # Validate version format (basic check)
+    if not re.match(r'^v?\d+\.\d+\.\d+', new_version):
+        print(f"Warning: Version '{new_version}' doesn't follow standard format (v1.2.3)")
+    
+    # Ensure version starts with 'v'
+    if not new_version.startswith('v'):
+        new_version = 'v' + new_version
+    
+    # Write to VERSION file
+    try:
+        with open('VERSION', 'w') as f:
+            f.write(new_version)
+        print(f"✅ Updated VERSION file to: {new_version}")
+        
+        # Optional: Create git tag if in a git repo
+        import subprocess
+        try:
+            # Check if we're in a git repo
+            subprocess.check_output(['git', 'status'], stderr=subprocess.DEVNULL)
+            
+            # Create and push tag
+            subprocess.check_output(['git', 'tag', new_version], stderr=subprocess.DEVNULL)
+            print(f"✅ Created git tag: {new_version}")
+            
+            # Ask user if they want to push
+            response = input("Push tag to remote? (y/N): ").strip().lower()
+            if response == 'y':
+                subprocess.check_output(['git', 'push', 'origin', new_version])
+                print(f"✅ Pushed tag {new_version} to remote")
+            
+        except subprocess.CalledProcessError:
+            print("ℹ️  Not in a git repo or git tag already exists")
+        except Exception as e:
+            print(f"ℹ️  Git operations failed: {e}")
+            
+    except Exception as e:
+        print(f"❌ Failed to update VERSION file: {e}")
+        return False
+        
+    return True
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python update_version.py <version>")
+        print("Example: python update_version.py v0.4.3")
+        print("Example: python update_version.py 0.4.3-alpha")
+        sys.exit(1)
+    
+    new_version = sys.argv[1]
+    success = update_version(new_version)
+    sys.exit(0 if success else 1)
\ No newline at end of file
diff --git a/src/api/__init__.py b/src/api/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/src/api/admin.py b/src/api/admin.py
new file mode 100644
index 00000000..2042de22
--- /dev/null
+++ b/src/api/admin.py
@@ -0,0 +1,1514 @@
+"""
+Administrative functions and user management.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import time
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.services.retention import is_recording_exempt_from_deletion, get_retention_days_for_recording, process_auto_deletion
+from src.services.embeddings import EMBEDDINGS_AVAILABLE, process_recording_chunks
+from src.services.token_tracking import token_tracker
+from src.services.transcription_tracking import transcription_tracker
+from src.config.startup import get_file_monitor_functions
+
+# Create blueprint
+admin_bp = Blueprint('admin', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+GLOBAL_RETENTION_DAYS = int(os.environ.get('GLOBAL_RETENTION_DAYS', '0'))
+DELETION_MODE = os.environ.get('DELETION_MODE', 'hard')
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_admin_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+def csrf_exempt(f):
+    """Decorator placeholder for CSRF exemption - applied after initialization."""
+    from functools import wraps
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        return f(*args, **kwargs)
+    wrapper._csrf_exempt = True
+    return wrapper
+
+
+# --- Routes ---
+
+@admin_bp.route('/admin', methods=['GET'])
+@login_required
+def admin():
+    # Check if user is admin OR group admin
+    is_team_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_team_admin:
+        flash('You do not have permission to access the admin page.', 'danger')
+        return redirect(url_for('recordings.index'))
+
+    # Redirect group admins to their dedicated management page
+    if is_team_admin and not current_user.is_admin:
+        return redirect(url_for('admin.group_management'))
+
+    # Full admins only get here
+    user_language = current_user.ui_language if current_user.is_authenticated and current_user.ui_language else 'en'
+    return render_template('admin.html',
+                         title='Admin Dashboard',
+                         inquire_mode_enabled=ENABLE_INQUIRE_MODE,
+                         global_retention_days=GLOBAL_RETENTION_DAYS,
+                         is_group_admin_only=False,
+                         user_language=user_language)
+
+
+@admin_bp.route('/group-management', methods=['GET'])
+@login_required
+def group_management():
+    """Dedicated group management page for group admins (non-full admins)."""
+    # Check if user is a group admin
+    is_team_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not is_team_admin:
+        flash('You do not have permission to access group management.', 'danger')
+        return redirect(url_for('recordings.index'))
+
+    # If they're a full admin, redirect to main admin dashboard
+    if current_user.is_admin:
+        return redirect(url_for('admin.admin'))
+
+    user_language = current_user.ui_language if current_user.is_authenticated and current_user.ui_language else 'en'
+    return render_template('group-admin.html',
+                         title='Group Management',
+                         global_retention_days=GLOBAL_RETENTION_DAYS,
+                         user_language=user_language)
+
+
+
+@admin_bp.route('/admin/users', methods=['GET'])
+@login_required
+def admin_get_users():
+    # Check if user is admin OR group admin
+    is_team_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_team_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    users = User.query.all()
+    user_data = []
+    
+    for user in users:
+        # Get recordings count and storage used
+        recordings_count = len(user.recordings)
+        storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
+
+        # Get current month token usage
+        current_usage = token_tracker.get_monthly_usage(user.id)
+        usage_percentage = (current_usage / user.monthly_token_budget * 100) if user.monthly_token_budget else 0
+
+        # Get current month transcription usage
+        current_transcription_usage = transcription_tracker.get_monthly_usage(user.id)
+        transcription_usage_percentage = (current_transcription_usage / user.monthly_transcription_budget * 100) if user.monthly_transcription_budget else 0
+
+        user_data.append({
+            'id': user.id,
+            'username': user.username,
+            'email': user.email,
+            'is_admin': user.is_admin,
+            'can_share_publicly': user.can_share_publicly,
+            'recordings_count': recordings_count,
+            'storage_used': storage_used,
+            'monthly_token_budget': user.monthly_token_budget,
+            'current_token_usage': current_usage,
+            'token_usage_percentage': round(usage_percentage, 1),
+            'monthly_transcription_budget': user.monthly_transcription_budget,
+            'monthly_transcription_budget_minutes': (user.monthly_transcription_budget // 60) if user.monthly_transcription_budget else None,
+            'current_transcription_usage': current_transcription_usage,
+            'current_transcription_usage_minutes': current_transcription_usage // 60,
+            'transcription_usage_percentage': round(transcription_usage_percentage, 1)
+        })
+    
+    return jsonify(user_data)
+
+
+
+@admin_bp.route('/admin/users', methods=['POST'])
+@login_required
+def admin_add_user():
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+    
+    # Validate required fields
+    required_fields = ['username', 'email', 'password']
+    for field in required_fields:
+        if field not in data:
+            return jsonify({'error': f'Missing required field: {field}'}), 400
+    
+    # Check if username or email already exists
+    if User.query.filter_by(username=data['username']).first():
+        return jsonify({'error': 'Username already exists'}), 400
+    
+    if User.query.filter_by(email=data['email']).first():
+        return jsonify({'error': 'Email already exists'}), 400
+    
+    # Create new user
+    hashed_password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
+    new_user = User(
+        username=data['username'],
+        email=data['email'],
+        password=hashed_password,
+        is_admin=data.get('is_admin', False),
+        monthly_token_budget=data.get('monthly_token_budget'),
+        monthly_transcription_budget=data.get('monthly_transcription_budget')
+    )
+
+    db.session.add(new_user)
+    db.session.commit()
+
+    return jsonify({
+        'id': new_user.id,
+        'username': new_user.username,
+        'email': new_user.email,
+        'is_admin': new_user.is_admin,
+        'recordings_count': 0,
+        'storage_used': 0,
+        'monthly_token_budget': new_user.monthly_token_budget,
+        'current_token_usage': 0,
+        'token_usage_percentage': 0,
+        'monthly_transcription_budget': new_user.monthly_transcription_budget,
+        'monthly_transcription_budget_minutes': (new_user.monthly_transcription_budget // 60) if new_user.monthly_transcription_budget else None,
+        'current_transcription_usage': 0,
+        'current_transcription_usage_minutes': 0,
+        'transcription_usage_percentage': 0
+    }), 201
+
+
+
+@admin_bp.route('/admin/users/<int:user_id>', methods=['PUT'])
+@login_required
+def admin_update_user(user_id):
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    user = db.session.get(User, user_id)
+    if not user:
+        return jsonify({'error': 'User not found'}), 404
+    
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+    
+    # Update user fields
+    if 'username' in data and data['username'] != user.username:
+        # Check if username already exists
+        if User.query.filter_by(username=data['username']).first():
+            return jsonify({'error': 'Username already exists'}), 400
+        user.username = data['username']
+    
+    if 'email' in data and data['email'] != user.email:
+        # Check if email already exists
+        if User.query.filter_by(email=data['email']).first():
+            return jsonify({'error': 'Email already exists'}), 400
+        user.email = data['email']
+    
+    if 'password' in data and data['password']:
+        user.password = bcrypt.generate_password_hash(data['password']).decode('utf-8')
+    
+    if 'is_admin' in data:
+        user.is_admin = data['is_admin']
+
+    if 'can_share_publicly' in data:
+        user.can_share_publicly = data['can_share_publicly']
+
+    if 'monthly_token_budget' in data:
+        # Allow setting to None (unlimited) or a positive integer
+        budget = data['monthly_token_budget']
+        if budget is None or budget == '' or budget == 0:
+            user.monthly_token_budget = None
+        else:
+            user.monthly_token_budget = int(budget)
+
+    if 'monthly_transcription_budget' in data:
+        # Allow setting to None (unlimited) or a positive integer (in seconds)
+        budget = data['monthly_transcription_budget']
+        if budget is None or budget == '' or budget == 0:
+            user.monthly_transcription_budget = None
+        else:
+            user.monthly_transcription_budget = int(budget)
+
+    db.session.commit()
+
+    # Get recordings count and storage used
+    recordings_count = len(user.recordings)
+    storage_used = sum(r.file_size for r in user.recordings if r.file_size) or 0
+
+    # Get current month token usage
+    current_usage = token_tracker.get_monthly_usage(user.id)
+    usage_percentage = (current_usage / user.monthly_token_budget * 100) if user.monthly_token_budget else 0
+
+    # Get current month transcription usage
+    current_transcription_usage = transcription_tracker.get_monthly_usage(user.id)
+    transcription_usage_percentage = (current_transcription_usage / user.monthly_transcription_budget * 100) if user.monthly_transcription_budget else 0
+
+    return jsonify({
+        'id': user.id,
+        'username': user.username,
+        'email': user.email,
+        'is_admin': user.is_admin,
+        'can_share_publicly': user.can_share_publicly,
+        'recordings_count': recordings_count,
+        'storage_used': storage_used,
+        'monthly_token_budget': user.monthly_token_budget,
+        'current_token_usage': current_usage,
+        'token_usage_percentage': round(usage_percentage, 1),
+        'monthly_transcription_budget': user.monthly_transcription_budget,
+        'monthly_transcription_budget_minutes': (user.monthly_transcription_budget // 60) if user.monthly_transcription_budget else None,
+        'current_transcription_usage': current_transcription_usage,
+        'current_transcription_usage_minutes': current_transcription_usage // 60,
+        'transcription_usage_percentage': round(transcription_usage_percentage, 1)
+    })
+
+
+
+@admin_bp.route('/admin/users/<int:user_id>', methods=['DELETE'])
+@login_required
+def admin_delete_user(user_id):
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    # Prevent deleting self
+    if user_id == current_user.id:
+        return jsonify({'error': 'Cannot delete your own account'}), 400
+    
+    user = db.session.get(User, user_id)
+    if not user:
+        return jsonify({'error': 'User not found'}), 404
+    
+    # Delete user's recordings and audio files
+    total_chunks = 0
+    if ENABLE_INQUIRE_MODE:
+        total_chunks = TranscriptChunk.query.filter_by(user_id=user_id).count()
+        if total_chunks > 0:
+            current_app.logger.info(f"Deleting {total_chunks} transcript chunks with embeddings for user {user_id}")
+
+    for recording in user.recordings:
+        try:
+            if recording.audio_path and os.path.exists(recording.audio_path):
+                os.remove(recording.audio_path)
+        except Exception as e:
+            current_app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
+
+    # Explicitly delete related records that might not cascade properly
+    ProcessingJob.query.filter_by(user_id=user_id).delete()
+    InternalShare.query.filter(
+        (InternalShare.owner_id == user_id) | (InternalShare.shared_with_user_id == user_id)
+    ).delete()
+
+    # Delete user (cascade will handle remaining related data including chunks/embeddings)
+    db.session.delete(user)
+    db.session.commit()
+    
+    if ENABLE_INQUIRE_MODE and total_chunks > 0:
+        current_app.logger.info(f"Successfully deleted {total_chunks} embeddings and chunks for user {user_id}")
+    
+    return jsonify({'success': True})
+
+
+
+@admin_bp.route('/admin/users/<int:user_id>/toggle-admin', methods=['POST'])
+@login_required
+def admin_toggle_admin(user_id):
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    # Prevent changing own admin status
+    if user_id == current_user.id:
+        return jsonify({'error': 'Cannot change your own admin status'}), 400
+    
+    user = db.session.get(User, user_id)
+    if not user:
+        return jsonify({'error': 'User not found'}), 404
+    
+    # Toggle admin status
+    user.is_admin = not user.is_admin
+    db.session.commit()
+    
+    return jsonify({'success': True, 'is_admin': user.is_admin})
+
+
+
+@admin_bp.route('/admin/stats', methods=['GET'])
+@login_required
+def admin_get_stats():
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    # Get total users
+    total_users = User.query.count()
+    
+    # Get total recordings
+    total_recordings = Recording.query.count()
+    
+    # Get recordings by status
+    completed_recordings = Recording.query.filter_by(status='COMPLETED').count()
+    processing_recordings = Recording.query.filter(Recording.status.in_(['PROCESSING', 'SUMMARIZING'])).count()
+    pending_recordings = Recording.query.filter_by(status='PENDING').count()
+    failed_recordings = Recording.query.filter_by(status='FAILED').count()
+    
+    # Get total storage used
+    total_storage = db.session.query(db.func.sum(Recording.file_size)).scalar() or 0
+    
+    # Get top users by storage
+    top_users_query = db.session.query(
+        User.id,
+        User.username,
+        db.func.count(Recording.id).label('recordings_count'),
+        db.func.sum(Recording.file_size).label('storage_used')
+    ).join(Recording, User.id == Recording.user_id, isouter=True) \
+     .group_by(User.id) \
+     .order_by(db.func.sum(Recording.file_size).desc()) \
+     .limit(5)
+    
+    top_users = []
+    for user_id, username, recordings_count, storage_used in top_users_query:
+        top_users.append({
+            'id': user_id,
+            'username': username,
+            'recordings_count': recordings_count or 0,
+            'storage_used': storage_used or 0
+        })
+    
+    # Get total queries (chat requests)
+    # This is a placeholder - you would need to track this in your database
+    total_queries = 0
+    
+    return jsonify({
+        'total_users': total_users,
+        'total_recordings': total_recordings,
+        'completed_recordings': completed_recordings,
+        'processing_recordings': processing_recordings,
+        'pending_recordings': pending_recordings,
+        'failed_recordings': failed_recordings,
+        'total_storage': total_storage,
+        'top_users': top_users,
+        'total_queries': total_queries
+    })
+
+
+# --- Token Usage Stats ---
+
+@admin_bp.route('/admin/token-stats', methods=['GET'])
+@login_required
+def admin_get_token_stats():
+    """Get overall token usage statistics."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.models import TokenUsage
+        from sqlalchemy import func, extract
+        from datetime import date
+
+        # Get today's usage (already split into llm_/embedding_ buckets)
+        today_usage = token_tracker.get_today_usage()
+
+        # Get current month usage for all users (also bucketed by the tracker)
+        monthly_stats = token_tracker.get_monthly_stats(months=1)
+        current_month = monthly_stats[-1] if monthly_stats else {
+            'tokens': 0, 'cost': 0,
+            'llm_tokens': 0, 'llm_cost': 0,
+            'embedding_tokens': 0, 'embedding_cost': 0,
+        }
+
+        # Get per-user stats for current month
+        user_stats = token_tracker.get_user_stats()
+
+        # Per-operation breakdown for the current month so the UI can show
+        # how the total splits across summarization, chat, embedding, etc.
+        today = date.today()
+        op_rows = db.session.query(
+            TokenUsage.operation_type,
+            func.sum(TokenUsage.total_tokens).label('tokens'),
+            func.sum(TokenUsage.cost).label('cost'),
+            func.sum(TokenUsage.request_count).label('requests'),
+        ).filter(
+            extract('year', TokenUsage.date) == today.year,
+            extract('month', TokenUsage.date) == today.month,
+        ).group_by(TokenUsage.operation_type).all()
+        by_operation = [
+            {
+                'operation_type': r.operation_type,
+                'tokens': int(r.tokens or 0),
+                'cost': float(r.cost or 0.0),
+                'requests': int(r.requests or 0),
+                'is_embedding': token_tracker.is_embedding_op(r.operation_type),
+            }
+            for r in op_rows
+        ]
+
+        return jsonify({
+            'today': today_usage,
+            'current_month': {
+                'tokens': current_month.get('tokens', 0),
+                'cost': current_month.get('cost', 0),
+                'llm_tokens': current_month.get('llm_tokens', 0),
+                'llm_cost': current_month.get('llm_cost', 0),
+                'embedding_tokens': current_month.get('embedding_tokens', 0),
+                'embedding_cost': current_month.get('embedding_cost', 0),
+                'by_operation': by_operation,
+            },
+            'user_count_with_usage': len([u for u in user_stats if u['current_usage'] > 0]),
+            'users_over_80_percent': len([u for u in user_stats if u['percentage'] >= 80]),
+            'users_at_100_percent': len([u for u in user_stats if u['percentage'] >= 100])
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting token stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/token-stats/daily', methods=['GET'])
+@login_required
+def admin_get_daily_token_stats():
+    """Get daily token usage for charts (last 30 days)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        days = request.args.get('days', 30, type=int)
+        user_id = request.args.get('user_id', type=int)
+
+        daily_stats = token_tracker.get_daily_stats(days=days, user_id=user_id)
+
+        return jsonify({
+            'stats': daily_stats,
+            'days': days
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting daily token stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/token-stats/monthly', methods=['GET'])
+@login_required
+def admin_get_monthly_token_stats():
+    """Get monthly token usage for charts (last 12 months)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        months = request.args.get('months', 12, type=int)
+
+        monthly_stats = token_tracker.get_monthly_stats(months=months)
+
+        return jsonify({
+            'stats': monthly_stats,
+            'months': months
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting monthly token stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/token-stats/users', methods=['GET'])
+@login_required
+def admin_get_user_token_stats():
+    """Get per-user token usage for current month."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        user_stats = token_tracker.get_user_stats()
+
+        return jsonify({
+            'users': user_stats
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting user token stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Transcription Usage Stats ---
+
+
+@admin_bp.route('/admin/transcription-stats', methods=['GET'])
+@login_required
+def admin_get_transcription_stats():
+    """Get overall transcription usage statistics."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        # Get today's usage
+        today_usage = transcription_tracker.get_today_usage()
+
+        # Get current month usage for all users
+        monthly_stats = transcription_tracker.get_monthly_stats(months=1)
+        current_month = monthly_stats[-1] if monthly_stats else {'seconds': 0, 'minutes': 0, 'cost': 0}
+
+        # Get per-user stats for current month
+        user_stats = transcription_tracker.get_user_stats()
+
+        # Calculate totals
+        total_monthly_seconds = current_month.get('seconds', 0)
+        total_monthly_cost = current_month.get('cost', 0)
+
+        return jsonify({
+            'today': today_usage,
+            'current_month': {
+                'seconds': total_monthly_seconds,
+                'minutes': total_monthly_seconds // 60,
+                'cost': total_monthly_cost
+            },
+            'user_count_with_usage': len([u for u in user_stats if u['current_usage_seconds'] > 0]),
+            'users_over_80_percent': len([u for u in user_stats if u['percentage'] >= 80]),
+            'users_at_100_percent': len([u for u in user_stats if u['percentage'] >= 100])
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting transcription stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/transcription-stats/daily', methods=['GET'])
+@login_required
+def admin_get_daily_transcription_stats():
+    """Get daily transcription usage for charts (last 30 days)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        days = request.args.get('days', 30, type=int)
+        user_id = request.args.get('user_id', type=int)
+
+        daily_stats = transcription_tracker.get_daily_stats(days=days, user_id=user_id)
+
+        return jsonify({
+            'stats': daily_stats,
+            'days': days
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting daily transcription stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/transcription-stats/monthly', methods=['GET'])
+@login_required
+def admin_get_monthly_transcription_stats():
+    """Get monthly transcription usage for charts (last 12 months)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        months = request.args.get('months', 12, type=int)
+
+        monthly_stats = transcription_tracker.get_monthly_stats(months=months)
+
+        return jsonify({
+            'stats': monthly_stats,
+            'months': months
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting monthly transcription stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/transcription-stats/users', methods=['GET'])
+@login_required
+def admin_get_user_transcription_stats():
+    """Get per-user transcription usage for current month."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        user_stats = transcription_tracker.get_user_stats()
+
+        return jsonify({
+            'users': user_stats
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting user transcription stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Transcript Template Routes ---
+
+
+@admin_bp.route('/admin/settings', methods=['GET'])
+@login_required
+def admin_get_settings():
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    settings = SystemSetting.query.all()
+    return jsonify([setting.to_dict() for setting in settings])
+
+
+
+@admin_bp.route('/admin/settings', methods=['POST'])
+@login_required
+def admin_update_setting():
+    # Check if user is admin
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+    
+    key = data.get('key')
+    value = data.get('value')
+    description = data.get('description')
+    setting_type = data.get('setting_type', 'string')
+    
+    if not key:
+        return jsonify({'error': 'Setting key is required'}), 400
+    
+    # Validate setting type
+    valid_types = ['string', 'integer', 'boolean', 'float']
+    if setting_type not in valid_types:
+        return jsonify({'error': f'Invalid setting type. Must be one of: {", ".join(valid_types)}'}), 400
+    
+    # Validate value based on type
+    if setting_type == 'integer':
+        try:
+            int(value) if value is not None and value != '' else None
+        except (ValueError, TypeError):
+            return jsonify({'error': 'Value must be a valid integer'}), 400
+    elif setting_type == 'float':
+        try:
+            float(value) if value is not None and value != '' else None
+        except (ValueError, TypeError):
+            return jsonify({'error': 'Value must be a valid number'}), 400
+    elif setting_type == 'boolean':
+        if value not in ['true', 'false', '1', '0', 'yes', 'no', True, False, 1, 0]:
+            return jsonify({'error': 'Value must be a valid boolean (true/false, 1/0, yes/no)'}), 400
+    
+    try:
+        setting = SystemSetting.set_setting(key, value, description, setting_type)
+
+        # Update Flask's MAX_CONTENT_LENGTH immediately when file size limit changes
+        if key == 'max_file_size_mb' and value:
+            try:
+                new_limit = int(value) * 1024 * 1024
+                current_app.config['MAX_CONTENT_LENGTH'] = new_limit
+                current_app.logger.info(f"Updated MAX_CONTENT_LENGTH to {value}MB")
+            except (ValueError, TypeError):
+                pass
+
+        return jsonify(setting.to_dict())
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error updating setting {key}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+# --- Configuration API ---
+
+
+@admin_bp.route('/admin/auto-deletion/run', methods=['POST'])
+@login_required
+@csrf_exempt  # Exempt since already protected by admin authentication
+def run_auto_deletion():
+    """Admin endpoint to manually trigger auto-deletion process."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    try:
+        stats = process_auto_deletion()
+        return jsonify(stats)
+    except Exception as e:
+        current_app.logger.error(f"Error running auto-deletion: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-deletion/stats', methods=['GET'])
+@login_required
+def get_auto_deletion_stats():
+    """Get statistics about recordings eligible for auto-deletion."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    try:
+        stats = {
+            'enabled': ENABLE_AUTO_DELETION,
+            'global_retention_days': GLOBAL_RETENTION_DAYS,
+            'deletion_mode': DELETION_MODE,
+            'eligible_count': 0,
+            'exempted_count': 0,
+            'no_retention_count': 0,
+            'archived_count': 0
+        }
+
+        if ENABLE_AUTO_DELETION:
+            # Check ALL completed recordings (per-recording retention)
+            all_recordings = Recording.query.filter(
+                Recording.status == 'COMPLETED'
+            ).all()
+
+            eligible = 0
+            exempted = 0
+            no_retention = 0
+            current_time = datetime.utcnow()
+
+            for recording in all_recordings:
+                # Check if exempt from deletion entirely
+                if is_recording_exempt_from_deletion(recording):
+                    exempted += 1
+                    continue
+
+                # Get the effective retention period for this recording
+                retention_days = get_retention_days_for_recording(recording)
+
+                if not retention_days:
+                    no_retention += 1
+                    continue
+
+                # Calculate cutoff for this specific recording
+                cutoff_date = current_time - timedelta(days=retention_days)
+
+                # Check if past retention period
+                if recording.created_at < cutoff_date:
+                    eligible += 1
+
+            stats['eligible_count'] = eligible
+            stats['exempted_count'] = exempted
+            stats['no_retention_count'] = no_retention
+
+        # Count already archived recordings
+        stats['archived_count'] = Recording.query.filter(
+            Recording.audio_deleted_at.is_not(None)
+        ).count()
+
+        return jsonify(stats)
+    except Exception as e:
+        current_app.logger.error(f"Error fetching auto-deletion stats: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-deletion/preview', methods=['GET'])
+@login_required
+def preview_auto_deletion():
+    """Preview what would be deleted without actually deleting (dry-run)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    try:
+        if not ENABLE_AUTO_DELETION:
+            return jsonify({'error': 'Auto-deletion is not enabled'}), 400
+
+        # Check ALL completed recordings (per-recording retention)
+        all_recordings = Recording.query.filter(
+            Recording.status == 'COMPLETED'
+        ).all()
+
+        preview_data = {
+            'total_checked': len(all_recordings),
+            'would_delete': [],
+            'would_exempt': [],
+            'no_retention': [],
+            'deletion_mode': DELETION_MODE,
+            'global_retention_days': GLOBAL_RETENTION_DAYS,
+            'supports_per_recording_retention': True
+        }
+
+        current_time = datetime.utcnow()
+
+        for recording in all_recordings:
+            rec_data = {
+                'id': recording.id,
+                'title': recording.title,
+                'created_at': recording.created_at.isoformat(),
+                'age_days': (current_time - recording.created_at).days,
+                'tags': [tag.tag.name for tag in recording.tag_associations]
+            }
+
+            # Check if exempt from deletion entirely
+            if is_recording_exempt_from_deletion(recording):
+                rec_data['exempt_reason'] = []
+                if recording.deletion_exempt:
+                    rec_data['exempt_reason'].append('manually_exempted')
+                for tag_assoc in recording.tag_associations:
+                    if tag_assoc.tag.protect_from_deletion:
+                        rec_data['exempt_reason'].append(f'tag:{tag_assoc.tag.name}')
+                preview_data['would_exempt'].append(rec_data)
+                continue
+
+            # Get the effective retention period for this recording
+            retention_days = get_retention_days_for_recording(recording)
+
+            if not retention_days:
+                rec_data['reason'] = 'no_retention_policy'
+                preview_data['no_retention'].append(rec_data)
+                continue
+
+            rec_data['retention_days'] = retention_days
+
+            # Calculate cutoff for this specific recording
+            cutoff_date = current_time - timedelta(days=retention_days)
+
+            # Check if past retention period
+            if recording.created_at < cutoff_date:
+                rec_data['days_past_retention'] = (current_time - cutoff_date).days
+                preview_data['would_delete'].append(rec_data)
+
+        return jsonify(preview_data)
+    except Exception as e:
+        current_app.logger.error(f"Error previewing auto-deletion: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/api/admin/migrate_recordings', methods=['POST'])
+@login_required
+def migrate_existing_recordings_api():
+    """API endpoint to migrate existing recordings for inquire mode (admin only)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized. Admin access required.'}), 403
+    
+    try:
+        # Count recordings that need processing
+        completed_recordings = Recording.query.filter_by(status='COMPLETED').all()
+        recordings_needing_processing = []
+        
+        for recording in completed_recordings:
+            if recording.transcription:  # Has transcription
+                chunk_count = TranscriptChunk.query.filter_by(recording_id=recording.id).count()
+                if chunk_count == 0:  # No chunks yet
+                    recordings_needing_processing.append(recording)
+        
+        if len(recordings_needing_processing) == 0:
+            return jsonify({
+                'success': True,
+                'message': 'All recordings are already processed for inquire mode',
+                'processed': 0,
+                'total': len(completed_recordings)
+            })
+        
+        # Process in small batches to avoid timeout
+        batch_size = min(5, len(recordings_needing_processing))  # Process max 5 at a time
+        processed = 0
+        errors = 0
+        
+        for i in range(min(batch_size, len(recordings_needing_processing))):
+            recording = recordings_needing_processing[i]
+            try:
+                success = process_recording_chunks(recording.id)
+                if success:
+                    processed += 1
+                else:
+                    errors += 1
+            except Exception as e:
+                current_app.logger.error(f"Error processing recording {recording.id} for migration: {e}")
+                errors += 1
+        
+        remaining = max(0, len(recordings_needing_processing) - batch_size)
+        
+        return jsonify({
+            'success': True,
+            'message': f'Processed {processed} recordings. {remaining} remaining.',
+            'processed': processed,
+            'errors': errors,
+            'remaining': remaining,
+            'total': len(recordings_needing_processing)
+        })
+        
+    except Exception as e:
+        current_app.logger.error(f"Error in migration API: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Auto-Processing File Monitor Integration ---
+
+
+@admin_bp.route('/admin/auto-process/status', methods=['GET'])
+@login_required
+def admin_get_auto_process_status():
+    """Get the status of the automated file processing system."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    try:
+        _, _, get_file_monitor_status = get_file_monitor_functions()
+        status = get_file_monitor_status()
+        
+        # Add configuration info
+        config = {
+            'enabled': os.environ.get('ENABLE_AUTO_PROCESSING', 'false').lower() == 'true',
+            'watch_directory': os.environ.get('AUTO_PROCESS_WATCH_DIR', '/data/auto-process'),
+            'check_interval': int(os.environ.get('AUTO_PROCESS_CHECK_INTERVAL', '30')),
+            'mode': os.environ.get('AUTO_PROCESS_MODE', 'admin_only'),
+            'default_username': os.environ.get('AUTO_PROCESS_DEFAULT_USERNAME')
+        }
+        
+        return jsonify({
+            'status': status,
+            'config': config
+        })
+        
+    except Exception as e:
+        current_app.logger.error(f"Error getting auto-process status: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-process/start', methods=['POST'])
+@login_required
+def admin_start_auto_process():
+    """Start the automated file processing system."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    try:
+        start_file_monitor, _, _ = get_file_monitor_functions()
+        start_file_monitor()
+        return jsonify({'success': True, 'message': 'Auto-processing started'})
+    except Exception as e:
+        current_app.logger.error(f"Error starting auto-process: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-process/stop', methods=['POST'])
+@login_required
+def admin_stop_auto_process():
+    """Stop the automated file processing system."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    try:
+        _, stop_file_monitor, _ = get_file_monitor_functions()
+        stop_file_monitor()
+        return jsonify({'success': True, 'message': 'Auto-processing stopped'})
+    except Exception as e:
+        current_app.logger.error(f"Error stopping auto-process: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-process/config', methods=['POST'])
+@login_required
+def admin_update_auto_process_config():
+    """Update auto-processing configuration (requires restart)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+    
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No configuration data provided'}), 400
+        
+        # This endpoint would typically update environment variables or config files
+        # For now, we'll just return the current config and note that restart is required
+        return jsonify({
+            'success': True, 
+            'message': 'Configuration updated. Restart required to apply changes.',
+            'note': 'Environment variables need to be updated manually and application restarted.'
+        })
+        
+    except Exception as e:
+        current_app.logger.error(f"Error updating auto-process config: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/auto-process/trigger', methods=['POST'])
+@login_required
+def admin_trigger_auto_process():
+    """Trigger an immediate auto-process scan cycle."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.file_monitor import file_monitor
+        if not file_monitor or not file_monitor.running:
+            return jsonify({'error': 'Auto-processing is not running'}), 400
+
+        import threading
+        def run_scan():
+            try:
+                file_monitor._update_user_cache()
+                if file_monitor.mode == 'admin_only':
+                    file_monitor._scan_admin_directory()
+                elif file_monitor.mode == 'user_directories':
+                    file_monitor._scan_user_directories()
+                elif file_monitor.mode == 'single_user':
+                    file_monitor._scan_single_user_directory()
+            except Exception as e:
+                file_monitor.logger.error(f"Error during triggered scan: {e}", exc_info=True)
+
+        thread = threading.Thread(target=run_scan, daemon=True)
+        thread.start()
+
+        return jsonify({'success': True, 'message': 'Scan triggered'})
+
+    except Exception as e:
+        current_app.logger.error(f"Error triggering auto-process scan: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/transcription/discover-models', methods=['GET'])
+@login_required
+def admin_discover_transcription_models():
+    """Probe the active transcription connector's /v1/models endpoint.
+
+    Used by the admin UI to populate a "models available on this provider"
+    list when curating which models users can pick from. Returns a list of
+    {id, label, owned_by} dicts. Empty list if the connector does not
+    implement list_models() or the upstream is unreachable.
+    """
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.services.transcription import get_registry
+        registry = get_registry()
+        connector = registry.get_active_connector()
+        if not connector:
+            return jsonify({'error': 'No active transcription connector'}), 503
+
+        connector_name = registry.get_active_connector_name()
+        try:
+            models = connector.list_models()
+        except NotImplementedError:
+            return jsonify({
+                'connector': connector_name,
+                'supported': False,
+                'models': [],
+                'message': f'{connector_name} does not expose a model discovery endpoint.',
+            })
+
+        return jsonify({
+            'connector': connector_name,
+            'supported': True,
+            'models': models or [],
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error discovering transcription models: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/transcription/visible-models', methods=['GET'])
+@login_required
+def admin_get_visible_models():
+    """Return the admin-curated list of models exposed in the user dropdown.
+
+    Falls back to the TRANSCRIPTION_MODELS_AVAILABLE env var when no DB
+    setting has been saved yet. The shape matches what /api/config returns
+    so the admin UI can pre-populate its form.
+    """
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.models import SystemSetting
+        from src.config.app_config import TRANSCRIPTION_MODEL_OPTIONS
+        import json as _json
+
+        raw = SystemSetting.get_setting('transcription_models_visible_json', None)
+        if raw:
+            try:
+                parsed = _json.loads(raw)
+                if isinstance(parsed, list):
+                    return jsonify({
+                        'source': 'database',
+                        'options': parsed,
+                        'default_model': SystemSetting.get_setting('transcription_default_model', None),
+                    })
+            except (ValueError, TypeError):
+                pass
+
+        return jsonify({
+            'source': 'env' if TRANSCRIPTION_MODEL_OPTIONS else 'unset',
+            'options': TRANSCRIPTION_MODEL_OPTIONS,
+            'default_model': None,
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error reading visible transcription models: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/transcription/visible-models', methods=['POST'])
+@login_required
+def admin_save_visible_models():
+    """Save the admin-curated list of user-facing transcription models.
+
+    Body: { "options": [{"value": "...", "label": "..."}, ...],
+            "default_model": "..." | null }
+    """
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.models import SystemSetting
+        import json as _json
+
+        data = request.json or {}
+        options = data.get('options', [])
+        if not isinstance(options, list):
+            return jsonify({'error': 'options must be a list'}), 400
+
+        # Normalise each option into {value, label}.
+        normalised = []
+        for opt in options:
+            if isinstance(opt, str):
+                normalised.append({'value': opt, 'label': opt})
+            elif isinstance(opt, dict) and opt.get('value'):
+                normalised.append({
+                    'value': str(opt['value']).strip(),
+                    'label': str(opt.get('label') or opt['value']).strip(),
+                })
+
+        SystemSetting.set_setting(
+            key='transcription_models_visible_json',
+            value=_json.dumps(normalised),
+            description='Admin-curated list of transcription models exposed in user dropdowns. Overrides TRANSCRIPTION_MODELS_AVAILABLE env var when set.',
+            setting_type='string',
+        )
+
+        default_model = (data.get('default_model') or '').strip()
+        if default_model:
+            SystemSetting.set_setting(
+                key='transcription_default_model',
+                value=default_model,
+                description='Admin-selected default transcription model. Used when no per-upload, tag, or folder override is set.',
+                setting_type='string',
+            )
+        else:
+            existing = SystemSetting.query.filter_by(key='transcription_default_model').first()
+            if existing:
+                db.session.delete(existing)
+                db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'options': normalised,
+            'default_model': default_model or None,
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error saving visible transcription models: {e}")
+        db.session.rollback()
+        return jsonify({'error': str(e)}), 500
+
+
+@admin_bp.route('/admin/inquire/process-recordings', methods=['POST'])
+@login_required
+def admin_process_recordings_for_inquire():
+    """Process recordings for inquire mode (chunk and embed them).
+
+    Default behaviour processes only recordings that do not yet have chunks.
+    Pass ``force=true`` in the JSON body to re-embed every completed
+    recording regardless of existing chunks. This is the migration path after
+    swapping ``EMBEDDING_MODEL`` or ``EMBEDDING_BASE_URL``: the old vectors
+    are deleted and replaced with vectors from the new configuration.
+
+    Body fields:
+        force (bool, optional, default false): re-embed all recordings
+        batch_size (int, optional, default 10): commit cadence
+        max_recordings (int, optional): cap the number processed in one call
+    """
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        data = request.json or {}
+        batch_size = int(data.get('batch_size', 10) or 10)
+        max_recordings = data.get('max_recordings', None)
+        force = bool(data.get('force', False))
+
+        if force:
+            # Re-embed every recording that has a usable transcription, plus
+            # any recording that already has chunks stored. The chunks-already-
+            # stored case matters because a recording can be in a non-COMPLETED
+            # state (PROCESSING, SUMMARIZING, FAILED) while still holding stale
+            # vectors from the previous embedding configuration. Filtering on
+            # status alone leaves those ghost chunks behind and produces the
+            # "X.shape[1] == new while Y.shape[1] == old" warnings on every
+            # subsequent search until they are cleaned up.
+            recordings_with_chunks_subq = db.session.query(
+                TranscriptChunk.recording_id
+            ).distinct()
+            recordings_needing_processing = Recording.query.filter(
+                db.or_(
+                    db.and_(
+                        Recording.status == 'COMPLETED',
+                        Recording.transcription.isnot(None),
+                        Recording.transcription != '',
+                    ),
+                    Recording.id.in_(recordings_with_chunks_subq),
+                )
+            ).all()
+        else:
+            # Only process recordings that have no chunks yet.
+            recordings_with_chunks = db.session.query(TranscriptChunk.recording_id).distinct()
+            recordings_needing_processing = Recording.query.filter(
+                Recording.status == 'COMPLETED',
+                Recording.transcription.isnot(None),
+                Recording.transcription != '',
+                ~Recording.id.in_(recordings_with_chunks)
+            ).all()
+
+        if max_recordings:
+            recordings_needing_processing = recordings_needing_processing[:int(max_recordings)]
+
+        total_to_process = len(recordings_needing_processing)
+
+        if total_to_process == 0:
+            return jsonify({
+                'success': True,
+                'message': (
+                    'No recordings to re-embed.' if force
+                    else 'All recordings are already processed for inquire mode.'
+                ),
+                'processed': 0,
+                'total': 0,
+                'force': force,
+            })
+
+        processed = 0
+        failed = []
+
+        # Number of times to retry each recording after the first pass. The
+        # underlying _api_embed already retries transient errors; this layer
+        # catches whole-pipeline failures (DB lock contention, partial
+        # provider responses, anything that produced a False return).
+        retry_passes = max(0, int(data.get('retry_passes', 2)))
+
+        def _attempt_recording(recording, attempt_label):
+            """Run process_recording_chunks for one recording.
+
+            Returns ``(success: bool, error: Optional[str])``. Any exception
+            is caught and converted to an error string so a single bad row
+            cannot abort the whole sweep.
+            """
+            try:
+                ok = process_recording_chunks(recording.id)
+            except Exception as exc:
+                current_app.logger.error(
+                    f"Admin API: Failed to process recording {recording.id} "
+                    f"({attempt_label}): {exc}"
+                )
+                return False, str(exc)
+            if ok:
+                current_app.logger.info(
+                    f"Admin API: {'Re-embedded' if force else 'Processed chunks for'} "
+                    f"recording ({attempt_label}): {recording.title} ({recording.id})"
+                )
+                return True, None
+            return False, 'Processing returned false'
+
+        # First pass: try every recording once.
+        retry_queue = []
+        for recording in recordings_needing_processing:
+            ok, err = _attempt_recording(recording, 'pass 1')
+            if ok:
+                processed += 1
+            else:
+                retry_queue.append((recording, err))
+
+            if processed % batch_size == 0:
+                db.session.commit()
+
+        # Subsequent passes: retry any recording that did not succeed.
+        # Backoff between passes lets a temporarily overloaded provider
+        # recover before we hammer it again.
+        for pass_num in range(2, retry_passes + 2):
+            if not retry_queue:
+                break
+            import time as _t
+            _t.sleep(min(15, 2 ** (pass_num - 1)))
+            current_app.logger.info(
+                f"Admin API: retry pass {pass_num} on {len(retry_queue)} recordings"
+            )
+            still_failing = []
+            for recording, prev_err in retry_queue:
+                ok, err = _attempt_recording(recording, f'pass {pass_num}')
+                if ok:
+                    processed += 1
+                else:
+                    still_failing.append((recording, err or prev_err))
+            retry_queue = still_failing
+
+        # Anything still in retry_queue after the last pass is recorded as failed.
+        for recording, err in retry_queue:
+            failed.append({
+                'id': recording.id,
+                'title': recording.title,
+                'reason': err or 'Processing returned false',
+                'attempts': retry_passes + 1,
+            })
+
+        db.session.commit()
+
+        # On a successful force re-embed, refresh the stored identifier so the
+        # mismatch warning clears.
+        if force and processed > 0 and not failed:
+            try:
+                from src.models import SystemSetting
+                from src.services.embeddings import EMBEDDING_IDENTIFIER
+                SystemSetting.set_setting(
+                    key='embedding_identifier',
+                    value=EMBEDDING_IDENTIFIER,
+                    description='Identifier of the embedding provider and model that produced the stored chunk vectors. Used to detect dimensionality and semantic-space mismatches at startup.',
+                    setting_type='string',
+                )
+            except Exception as e:
+                current_app.logger.warning(f"Failed to refresh embedding_identifier after re-embed: {e}")
+
+        verb = 'Re-embedded' if force else 'Processed'
+        return jsonify({
+            'success': True,
+            'message': f'{verb} {processed} out of {total_to_process} recordings.',
+            'processed': processed,
+            'total': total_to_process,
+            'failed': failed,
+            'force': force,
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error in admin process recordings endpoint: {e}")
+        db.session.rollback()
+        return jsonify({'error': str(e)}), 500
+
+
+
+@admin_bp.route('/admin/inquire/status', methods=['GET'])
+@login_required
+def admin_inquire_status():
+    """Get the status of recordings for inquire mode."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Unauthorized'}), 403
+
+    try:
+        from src.services.embeddings import (
+            EMBEDDING_MODEL, EMBEDDING_BASE_URL, EMBEDDING_IDENTIFIER,
+            USE_API_EMBEDDINGS, EMBEDDING_DIMENSIONS,
+        )
+        from src.models import SystemSetting, TokenUsage
+        from sqlalchemy import func
+
+        # Count total completed recordings
+        total_completed = Recording.query.filter_by(status='COMPLETED').count()
+
+        # Count recordings with transcriptions
+        recordings_with_transcriptions = Recording.query.filter(
+            Recording.status == 'COMPLETED',
+            Recording.transcription.isnot(None),
+            Recording.transcription != ''
+        ).count()
+
+        # Count recordings that have been processed for inquire mode
+        processed_recordings = db.session.query(Recording.id).join(
+            TranscriptChunk, Recording.id == TranscriptChunk.recording_id
+        ).distinct().count()
+
+        # Count recordings that still need processing (have transcription but no chunks)
+        need_processing = db.session.query(func.count(Recording.id)).filter(
+            Recording.status == 'COMPLETED',
+            Recording.transcription.isnot(None),
+            Recording.transcription != '',
+            ~Recording.id.in_(db.session.query(TranscriptChunk.recording_id).distinct())
+        ).scalar() or 0
+
+        # Total chunks across the system
+        total_chunks = TranscriptChunk.query.count()
+
+        # Detect embedded chunks that pre-date the current configuration. The
+        # stored identifier is what produced the existing vectors; if it does
+        # not match the current EMBEDDING_IDENTIFIER, those chunks are stale
+        # and Inquire mode will return wrong results until they are re-embedded.
+        stored_identifier = SystemSetting.get_setting('embedding_identifier', None)
+        if stored_identifier is None:
+            legacy = SystemSetting.get_setting('embedding_model_name', None)
+            stored_identifier = f"local::{legacy}" if legacy else None
+
+        identifier_mismatch = bool(
+            stored_identifier and stored_identifier != EMBEDDING_IDENTIFIER and total_chunks > 0
+        )
+
+        # Embedding-API usage aggregates (lifetime totals across all users).
+        usage_rows = TokenUsage.query.filter_by(operation_type='embedding').all()
+        embedding_usage = {
+            'total_tokens': sum(u.total_tokens for u in usage_rows),
+            'total_cost': sum((u.cost or 0.0) for u in usage_rows),
+            'request_count': sum(u.request_count for u in usage_rows),
+        }
+
+        return jsonify({
+            'total_completed_recordings': total_completed,
+            'recordings_with_transcriptions': recordings_with_transcriptions,
+            'processed_for_inquire': processed_recordings,
+            'need_processing': need_processing,
+            'total_chunks': total_chunks,
+            'embeddings_available': EMBEDDINGS_AVAILABLE,
+            # Embedding configuration surfaced to the UI
+            'embedding_model': EMBEDDING_MODEL,
+            'embedding_provider': 'api' if USE_API_EMBEDDINGS else 'local',
+            'embedding_base_url': EMBEDDING_BASE_URL or None,
+            'embedding_dimensions_override': EMBEDDING_DIMENSIONS,
+            'embedding_identifier': EMBEDDING_IDENTIFIER,
+            'embedding_identifier_stored': stored_identifier,
+            'embedding_identifier_mismatch': identifier_mismatch,
+            # Embedding-API usage (only meaningful in API mode; local mode = 0)
+            'embedding_usage': embedding_usage,
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting inquire status: {e}")
+        return jsonify({'error': str(e)}), 500
+
+# --- Group Management API (Admin Only) ---
+
+
diff --git a/src/api/api_v1.py b/src/api/api_v1.py
new file mode 100644
index 00000000..86668116
--- /dev/null
+++ b/src/api/api_v1.py
@@ -0,0 +1,2652 @@
+"""
+API v1 - RESTful API for external integrations.
+
+This blueprint provides a comprehensive REST API for:
+- Dashboard widgets (gethomepage.dev, etc.)
+- Automation tools (n8n, Zapier, etc.)
+- Third-party integrations
+
+All endpoints require token authentication via:
+- Authorization: Bearer <token>
+- X-API-Token: <token>
+- API-Token: <token>
+- ?token=<token> query parameter
+"""
+
+import os
+import re
+import json
+from datetime import datetime, date, timedelta
+from typing import Optional
+
+from flask import Blueprint, jsonify, request, current_app, send_file
+from flask_login import login_required, current_user
+from sqlalchemy import func, extract, or_, and_
+
+from src.database import db
+from src.models import Recording, User, Tag, RecordingTag, Speaker, Event
+from src.models.processing_job import ProcessingJob
+from src.models.token_usage import TokenUsage
+from src.models.transcription_usage import TranscriptionUsage
+from src.services.token_tracking import TokenTracker
+from src.services.transcription_tracking import transcription_tracker
+from src.file_exporter import format_transcription_with_template
+from src.api.recordings import upload_file as _upload_file_ui
+
+# Create blueprint with /api/v1 prefix
+api_v1_bp = Blueprint('api_v1', __name__, url_prefix='/api/v1')
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+get_user_recording_status = None
+set_user_recording_status = None
+enrich_recording_dict_with_user_status = None
+bcrypt = None
+csrf = None
+limiter = None
+chunking_service = None
+
+# Token tracker instance
+token_tracker = TokenTracker()
+
+
+def init_api_v1_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, get_user_recording_status, set_user_recording_status
+    global enrich_recording_dict_with_user_status, bcrypt, csrf, limiter, chunking_service
+    has_recording_access = kwargs.get('has_recording_access')
+    get_user_recording_status = kwargs.get('get_user_recording_status')
+    set_user_recording_status = kwargs.get('set_user_recording_status')
+    enrich_recording_dict_with_user_status = kwargs.get('enrich_recording_dict_with_user_status')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+    chunking_service = kwargs.get('chunking_service')
+
+
+def format_bytes(bytes_value: int) -> str:
+    """Format bytes to human-readable string."""
+    if bytes_value is None:
+        bytes_value = 0
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if bytes_value < 1024:
+            return f"{bytes_value:.1f} {unit}"
+        bytes_value /= 1024
+    return f"{bytes_value:.1f} PB"
+
+
+# =============================================================================
+# OpenAPI Documentation
+# =============================================================================
+
+OPENAPI_SPEC = {
+    "openapi": "3.0.3",
+    "info": {
+        "title": "Speakr API",
+        "description": "REST API for Speakr - Audio transcription and note-taking application.\n\n## Authentication\nAll endpoints require token authentication via one of:\n- `Authorization: Bearer <token>`\n- `X-API-Token: <token>`\n- `API-Token: <token>`\n- `?token=<token>` query parameter\n\nGenerate tokens in Settings > API Tokens.",
+        "version": "1.0.0"
+    },
+    "servers": [{"url": "/api/v1", "description": "API v1"}],
+    "components": {
+        "securitySchemes": {
+            "bearerAuth": {"type": "http", "scheme": "bearer"},
+            "apiKeyHeader": {"type": "apiKey", "in": "header", "name": "X-API-Token"},
+            "apiKeyQuery": {"type": "apiKey", "in": "query", "name": "token"}
+        },
+        "schemas": {
+            "Recording": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "title": {"type": "string"},
+                    "status": {"type": "string", "enum": ["PENDING", "PROCESSING", "SUMMARIZING", "COMPLETED", "FAILED"]},
+                    "created_at": {"type": "string", "format": "date-time"},
+                    "meeting_date": {"type": "string", "format": "date-time"},
+                    "file_size": {"type": "integer"},
+                    "audio_duration": {"type": "number", "description": "Audio duration in seconds"},
+                    "transcription_duration_seconds": {"type": "integer", "description": "Wall-clock seconds spent transcribing"},
+                    "summarization_duration_seconds": {"type": "integer", "description": "Wall-clock seconds spent summarizing"},
+                    "participants": {"type": "string"},
+                    "is_inbox": {"type": "boolean"},
+                    "is_highlighted": {"type": "boolean"},
+                    "deletion_exempt": {"type": "boolean", "description": "If true, recording is exempt from auto-deletion"},
+                    "prompt_variables": {"type": "object", "description": "Per-recording {{name}} substitutions used when summarising"},
+                    "folder_id": {"type": "integer", "nullable": True},
+                    "folder": {"type": "object", "nullable": True, "properties": {"id": {"type": "integer"}, "name": {"type": "string"}}},
+                    "events": {"type": "array", "description": "Calendar events extracted from the recording (detail endpoint only)", "items": {"type": "object"}},
+                    "tags": {"type": "array", "items": {"$ref": "#/components/schemas/Tag"}}
+                }
+            },
+            "Tag": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "name": {"type": "string"},
+                    "color": {"type": "string"},
+                    "custom_prompt": {"type": "string"},
+                    "default_language": {"type": "string"},
+                    "default_min_speakers": {"type": "integer"},
+                    "default_max_speakers": {"type": "integer"},
+                    "default_hotwords": {"type": "string"},
+                    "default_initial_prompt": {"type": "string"},
+                    "default_transcription_model": {"type": "string"}
+                }
+            },
+            "Folder": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "name": {"type": "string"},
+                    "color": {"type": "string"},
+                    "group_id": {"type": "integer", "nullable": True},
+                    "is_group_folder": {"type": "boolean"},
+                    "custom_prompt": {"type": "string"},
+                    "default_language": {"type": "string"},
+                    "default_min_speakers": {"type": "integer"},
+                    "default_max_speakers": {"type": "integer"},
+                    "default_hotwords": {"type": "string"},
+                    "default_initial_prompt": {"type": "string"},
+                    "default_transcription_model": {"type": "string"},
+                    "protect_from_deletion": {"type": "boolean"},
+                    "retention_days": {"type": "integer", "nullable": True},
+                    "recording_count": {"type": "integer"}
+                }
+            },
+            "Speaker": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "name": {"type": "string"},
+                    "use_count": {"type": "integer"},
+                    "has_voice_profile": {"type": "boolean"}
+                }
+            },
+            "Error": {
+                "type": "object",
+                "properties": {"error": {"type": "string"}}
+            }
+        }
+    },
+    "security": [{"bearerAuth": []}, {"apiKeyHeader": []}, {"apiKeyQuery": []}],
+    "paths": {
+        "/stats": {
+            "get": {
+                "tags": ["Stats"],
+                "summary": "Get system statistics",
+                "description": "Returns stats compatible with gethomepage.dev widgets",
+                "parameters": [{"name": "scope", "in": "query", "schema": {"type": "string", "enum": ["user", "all"], "default": "user"}, "description": "user=personal stats, all=global (admin only)"}],
+                "responses": {"200": {"description": "Stats object"}}
+            }
+        },
+        "/recordings": {
+            "get": {
+                "tags": ["Recordings"],
+                "summary": "List recordings",
+                "parameters": [
+                    {"name": "page", "in": "query", "schema": {"type": "integer", "default": 1}},
+                    {"name": "per_page", "in": "query", "schema": {"type": "integer", "default": 25, "maximum": 100}},
+                    {"name": "status", "in": "query", "schema": {"type": "string", "enum": ["all", "pending", "processing", "completed", "failed"]}},
+                    {"name": "sort_by", "in": "query", "schema": {"type": "string", "enum": ["created_at", "meeting_date", "title", "file_size"]}},
+                    {"name": "sort_order", "in": "query", "schema": {"type": "string", "enum": ["asc", "desc"]}},
+                    {"name": "tag_id", "in": "query", "schema": {"type": "integer"}},
+                    {"name": "folder_id", "in": "query", "schema": {"type": "string"}, "description": "Filter by folder. Pass an integer folder id to list recordings in that folder, or the literal 'none' to list recordings not in any folder. Omit for no filter."},
+                    {"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Search query"}
+                ],
+                "responses": {"200": {"description": "Paginated list of recordings"}}
+            }
+        },
+        "/recordings/{id}": {
+            "get": {
+                "tags": ["Recordings"],
+                "summary": "Get recording details",
+                "parameters": [
+                    {"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}},
+                    {"name": "format", "in": "query", "schema": {"type": "string", "enum": ["full", "minimal"]}, "description": "minimal excludes large text fields"},
+                    {"name": "include", "in": "query", "schema": {"type": "string"}, "description": "Comma-separated: transcription,summary,notes"}
+                ],
+                "responses": {"200": {"description": "Recording details"}, "404": {"description": "Not found"}}
+            },
+            "patch": {
+                "tags": ["Recordings"],
+                "summary": "Update recording",
+                "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}],
+                "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"title": {"type": "string"}, "participants": {"type": "string"}, "notes": {"type": "string"}, "summary": {"type": "string"}, "meeting_date": {"type": "string"}, "is_inbox": {"type": "boolean"}, "is_highlighted": {"type": "boolean"}, "folder_id": {"type": "integer", "nullable": True, "description": "Move recording to this folder, or null to remove from any folder. Caller must have access to the target folder."}}}}}},
+                "responses": {"200": {"description": "Updated recording"}, "403": {"description": "No access to target folder"}, "404": {"description": "Recording or folder not found"}}
+            },
+            "delete": {
+                "tags": ["Recordings"],
+                "summary": "Delete recording",
+                "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}],
+                "responses": {"200": {"description": "Deleted"}, "403": {"description": "Permission denied"}}
+            }
+        },
+        "/recordings/{id}/transcript": {
+            "get": {
+                "tags": ["Recordings"],
+                "summary": "Get transcript",
+                "parameters": [
+                    {"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}},
+                    {"name": "format", "in": "query", "schema": {"type": "string", "enum": ["json", "text", "srt", "vtt"], "default": "json"}}
+                ],
+                "responses": {"200": {"description": "Transcript in requested format"}}
+            }
+        },
+        "/recordings/{id}/summary": {
+            "get": {"tags": ["Recordings"], "summary": "Get summary", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Summary markdown"}}},
+            "put": {"tags": ["Recordings"], "summary": "Replace summary", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["summary"], "properties": {"summary": {"type": "string"}}}}}}, "responses": {"200": {"description": "Updated"}}}
+        },
+        "/recordings/{id}/notes": {
+            "get": {"tags": ["Recordings"], "summary": "Get notes", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Notes markdown"}}},
+            "put": {"tags": ["Recordings"], "summary": "Replace notes", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["notes"], "properties": {"notes": {"type": "string"}}}}}}, "responses": {"200": {"description": "Updated"}}}
+        },
+        "/recordings/{id}/status": {
+            "get": {"tags": ["Recordings"], "summary": "Get processing status", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Status with queue position"}}}
+        },
+        "/recordings/{id}/transcribe": {
+            "post": {"tags": ["Processing"], "summary": "Queue transcription", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"language": {"type": "string"}, "min_speakers": {"type": "integer"}, "max_speakers": {"type": "integer"}, "hotwords": {"type": "string", "description": "Connectors that accept hotword biasing route this to their native parameter (WhisperX hotwords, Mistral context_bias, OpenAI prompt, etc.). Connectors that ignore it drop it silently."}, "initial_prompt": {"type": "string", "description": "Free-text context hint. Same per-connector behaviour as hotwords."}, "transcription_model": {"type": "string", "description": "Per-request model override. Validated against the admin-curated visible-models list. Falls back to the configured default if absent or invalid."}}}}}}, "responses": {"200": {"description": "Job queued"}}}
+        },
+        "/recordings/{id}/summarize": {
+            "post": {"tags": ["Processing"], "summary": "Queue summarization", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"custom_prompt": {"type": "string"}}}}}}, "responses": {"200": {"description": "Job queued"}}}
+        },
+        "/recordings/{id}/chat": {
+            "post": {"tags": ["Chat"], "summary": "Chat about recording", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["message"], "properties": {"message": {"type": "string"}, "conversation_history": {"type": "array"}}}}}}, "responses": {"200": {"description": "Chat response"}}}
+        },
+        "/recordings/{id}/events": {
+            "get": {"tags": ["Events"], "summary": "Get calendar events", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "List of events"}}}
+        },
+        "/recordings/{id}/events/ics": {
+            "get": {"tags": ["Events"], "summary": "Download events as ICS", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "ICS file", "content": {"text/calendar": {}}}}}
+        },
+        "/recordings/{id}/audio": {
+            "get": {"tags": ["Audio"], "summary": "Download audio", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}, {"name": "download", "in": "query", "schema": {"type": "boolean"}}], "responses": {"200": {"description": "Audio file"}}}
+        },
+        "/recordings/{id}/tags": {
+            "post": {"tags": ["Tags"], "summary": "Add tags to recording", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"tag_ids": {"type": "array", "items": {"type": "integer"}}}}}}}, "responses": {"200": {"description": "Tags added"}}}
+        },
+        "/recordings/{id}/tags/{tag_id}": {
+            "delete": {"tags": ["Tags"], "summary": "Remove tag from recording", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}, {"name": "tag_id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Tag removed"}}}
+        },
+        "/recordings/{id}/speakers": {
+            "get": {"tags": ["Speakers"], "summary": "Get speakers in recording", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Speakers with suggestions"}}}
+        },
+        "/recordings/{id}/speakers/assign": {
+            "put": {
+                "tags": ["Speakers"],
+                "summary": "Assign speaker names to transcription",
+                "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}],
+                "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["speaker_map"], "properties": {"speaker_map": {"type": "object", "description": "Map of speaker labels to names. Values can be: string (name) or object {name, isMe}."}, "regenerate_summary": {"type": "boolean", "default": False}}}}}},
+                "responses": {"200": {"description": "Speakers assigned"}, "404": {"description": "Recording not found"}, "403": {"description": "Permission denied"}}
+            }
+        },
+        "/recordings/{id}/speakers/identify": {
+            "post": {
+                "tags": ["Speakers"],
+                "summary": "Auto-identify speakers via LLM",
+                "description": "Analyzes transcript context to suggest speaker names. Returns suggestions only - does not modify the recording.",
+                "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}],
+                "responses": {"200": {"description": "Speaker identification suggestions"}, "400": {"description": "Transcription not available or unsupported format"}}
+            }
+        },
+        "/recordings/batch": {
+            "patch": {"tags": ["Batch"], "summary": "Batch update recordings", "description": "Apply the same set of updates to multiple recordings in one call. Supported fields inside `updates`: `is_inbox`, `is_highlighted`, `add_tag_ids` (array of tag ids to add), `remove_tag_ids` (array of tag ids to remove), `folder_id` (move all to this folder, or null to remove from any folder).", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["recording_ids", "updates"], "properties": {"recording_ids": {"type": "array", "items": {"type": "integer"}}, "updates": {"type": "object", "properties": {"is_inbox": {"type": "boolean"}, "is_highlighted": {"type": "boolean"}, "add_tag_ids": {"type": "array", "items": {"type": "integer"}}, "remove_tag_ids": {"type": "array", "items": {"type": "integer"}}, "folder_id": {"type": "integer", "nullable": True, "description": "Target folder id, or null to remove all selected recordings from their folders. Caller must have access."}}}}}}}}, "responses": {"200": {"description": "Batch results"}, "403": {"description": "No access to target folder"}, "404": {"description": "Target folder not found"}}},
+            "delete": {"tags": ["Batch"], "summary": "Batch delete recordings", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["recording_ids"], "properties": {"recording_ids": {"type": "array", "items": {"type": "integer"}}}}}}}, "responses": {"200": {"description": "Batch results"}}}
+        },
+        "/recordings/batch/transcribe": {
+            "post": {"tags": ["Batch"], "summary": "Batch queue transcriptions", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["recording_ids"], "properties": {"recording_ids": {"type": "array", "items": {"type": "integer"}}}}}}}, "responses": {"200": {"description": "Batch results"}}}
+        },
+        "/recordings/upload": {
+            "post": {
+                "tags": ["Recordings"],
+                "summary": "Upload a recording (multipart form-data) and queue transcription",
+                "requestBody": {
+                    "content": {
+                        "multipart/form-data": {
+                            "schema": {
+                                "type": "object",
+                                "required": ["file"],
+                                "properties": {
+                                    "file": {"type": "string", "format": "binary"},
+                                    "notes": {"type": "string"},
+                                    "title": {"type": "string"},
+                                    "meeting_date": {"type": "string", "format": "date-time"},
+                                    "file_last_modified": {"type": "string"},
+                                    "language": {"type": "string"},
+                                    "min_speakers": {"type": "integer"},
+                                    "max_speakers": {"type": "integer"},
+                                    "hotwords": {"type": "string"},
+                                    "initial_prompt": {"type": "string"},
+                                    "transcription_model": {"type": "string"},
+                                    "prompt_variables": {"type": "string", "description": "JSON object of {variable_name: value} substituted into {{name}} placeholders in the summary prompt"},
+                                    "folder_id": {"type": "integer"},
+                                    "tag_id": {"type": "integer"},
+                                    "tag_ids[0]": {"type": "integer"},
+                                    "tag_ids[1]": {"type": "integer"}
+                                }
+                            }
+                        }
+                    }
+                },
+                "responses": {"202": {"description": "Upload accepted and queued"}}
+            }
+        },
+        "/tags": {
+            "get": {"tags": ["Tags"], "summary": "List tags", "responses": {"200": {"description": "List of tags"}}},
+            "post": {"tags": ["Tags"], "summary": "Create tag", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["name"], "properties": {"name": {"type": "string"}, "color": {"type": "string"}, "custom_prompt": {"type": "string"}, "default_language": {"type": "string"}, "default_min_speakers": {"type": "integer"}, "default_max_speakers": {"type": "integer"}}}}}}, "responses": {"201": {"description": "Tag created"}}}
+        },
+        "/tags/{id}": {
+            "put": {"tags": ["Tags"], "summary": "Update tag", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"name": {"type": "string"}, "color": {"type": "string"}, "custom_prompt": {"type": "string"}}}}}}, "responses": {"200": {"description": "Tag updated"}}},
+            "delete": {"tags": ["Tags"], "summary": "Delete tag", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Tag deleted"}}}
+        },
+        "/folders": {
+            "get": {"tags": ["Folders"], "summary": "List folders", "responses": {"200": {"description": "Array of folders the user can access", "content": {"application/json": {"schema": {"type": "array", "items": {"$ref": "#/components/schemas/Folder"}}}}}}},
+            "post": {"tags": ["Folders"], "summary": "Create folder", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["name"], "properties": {"name": {"type": "string"}, "color": {"type": "string"}, "group_id": {"type": "integer", "nullable": True}, "custom_prompt": {"type": "string"}, "default_language": {"type": "string"}, "default_min_speakers": {"type": "integer"}, "default_max_speakers": {"type": "integer"}, "default_hotwords": {"type": "string"}, "default_initial_prompt": {"type": "string"}, "default_transcription_model": {"type": "string"}, "retention_days": {"type": "integer"}}}}}}, "responses": {"201": {"description": "Folder created"}}}
+        },
+        "/folders/{id}": {
+            "get": {"tags": ["Folders"], "summary": "Get folder", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Folder", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Folder"}}}}}},
+            "patch": {"tags": ["Folders"], "summary": "Update folder", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"name": {"type": "string"}, "color": {"type": "string"}, "custom_prompt": {"type": "string"}, "default_language": {"type": "string"}, "default_min_speakers": {"type": "integer"}, "default_max_speakers": {"type": "integer"}, "default_hotwords": {"type": "string"}, "default_initial_prompt": {"type": "string"}, "default_transcription_model": {"type": "string"}, "retention_days": {"type": "integer"}}}}}}, "responses": {"200": {"description": "Folder updated"}}},
+            "delete": {"tags": ["Folders"], "summary": "Delete folder", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Folder deleted"}}}
+        },
+        "/transcription": {
+            "get": {
+                "tags": ["Transcription"],
+                "summary": "Discover the active transcription connector and its accepted models",
+                "description": "Returns the active connector name, a map of capability flags, the admin-curated model list, and the configured default model. Use this to drive client UIs and to know which values are valid for the `transcription_model` override on /recordings/{id}/transcribe and /recordings/upload.",
+                "responses": {
+                    "200": {
+                        "description": "Connector info",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "properties": {
+                                        "connector": {"type": "string", "nullable": True, "description": "Active connector name (e.g. asr_endpoint, openai_transcribe, mistral, vibevoice)"},
+                                        "capabilities": {
+                                            "type": "object",
+                                            "description": "Boolean flags indicating which optional fields the connector accepts",
+                                            "properties": {
+                                                "diarization": {"type": "boolean"},
+                                                "speaker_count_control": {"type": "boolean"},
+                                                "hotwords": {"type": "boolean"},
+                                                "initial_prompt": {"type": "boolean"},
+                                                "timestamps": {"type": "boolean"},
+                                                "language_detection": {"type": "boolean"},
+                                                "chunking": {"type": "boolean"}
+                                            }
+                                        },
+                                        "models": {
+                                            "type": "array",
+                                            "description": "Models the admin has marked visible to users (or TRANSCRIPTION_MODELS_AVAILABLE entries when no DB list is set)",
+                                            "items": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "value": {"type": "string"},
+                                                    "label": {"type": "string"}
+                                                }
+                                            }
+                                        },
+                                        "default_model": {"type": "string", "nullable": True}
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/speakers": {
+            "get": {"tags": ["Speakers"], "summary": "List speakers", "responses": {"200": {"description": "List of speakers"}}},
+            "post": {"tags": ["Speakers"], "summary": "Create speaker", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["name"], "properties": {"name": {"type": "string"}}}}}}, "responses": {"201": {"description": "Speaker created"}}}
+        },
+        "/speakers/{id}": {
+            "put": {"tags": ["Speakers"], "summary": "Update speaker", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"name": {"type": "string"}}}}}}, "responses": {"200": {"description": "Speaker updated"}}},
+            "delete": {"tags": ["Speakers"], "summary": "Delete speaker", "parameters": [{"name": "id", "in": "path", "required": True, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Speaker deleted"}}}
+        },
+        "/settings/auto-summarization": {
+            "put": {
+                "tags": ["Settings"],
+                "summary": "Toggle auto-summarization",
+                "description": "Enable or disable auto-summarization for the current user.",
+                "requestBody": {"content": {"application/json": {"schema": {"type": "object", "required": ["enabled"], "properties": {"enabled": {"type": "boolean"}}}}}},
+                "responses": {"200": {"description": "Setting updated"}}
+            }
+        }
+    },
+    "tags": [
+        {"name": "Stats", "description": "System statistics for dashboards"},
+        {"name": "Recordings", "description": "Recording CRUD operations"},
+        {"name": "Processing", "description": "Transcription and summarization"},
+        {"name": "Chat", "description": "Chat with recordings"},
+        {"name": "Events", "description": "Calendar events"},
+        {"name": "Audio", "description": "Audio file operations"},
+        {"name": "Tags", "description": "Tag management"},
+        {"name": "Folders", "description": "Folder management"},
+        {"name": "Transcription", "description": "Transcription connector and model discovery"},
+        {"name": "Speakers", "description": "Speaker management"},
+        {"name": "Batch", "description": "Batch operations"},
+        {"name": "Settings", "description": "User settings"}
+    ]
+}
+
+
+@api_v1_bp.route('/openapi.json', methods=['GET'])
+def get_openapi_spec():
+    """Return OpenAPI specification."""
+    return jsonify(OPENAPI_SPEC)
+
+
+@api_v1_bp.route('/docs', methods=['GET'])
+def get_docs():
+    """Serve Swagger UI documentation."""
+    from flask import Response
+    html = '''<!DOCTYPE html>
+<html>
+<head>
+    <title>Speakr API v1 Documentation</title>
+    <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" />
+</head>
+<body>
+    <div id="swagger-ui"></div>
+    <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
+    <script>
+        SwaggerUIBundle({
+            url: "/api/v1/openapi.json",
+            dom_id: '#swagger-ui',
+            presets: [SwaggerUIBundle.presets.apis, SwaggerUIBundle.SwaggerUIStandalonePreset],
+            layout: "BaseLayout",
+            persistAuthorization: true
+        });
+    </script>
+</body>
+</html>'''
+    return Response(html, mimetype='text/html')
+
+
+# =============================================================================
+# Stats Endpoint (Homepage Widget Compatible)
+# =============================================================================
+
+@api_v1_bp.route('/stats', methods=['GET'])
+@login_required
+def get_stats():
+    """
+    Get system/user statistics for dashboard widgets.
+
+    Query params:
+        scope: 'user' (default) or 'all' (admin only)
+
+    Returns JSON compatible with gethomepage.dev custom API widget:
+    {
+        "recordings": {"total": N, "completed": N, "processing": N, "pending": N, "failed": N},
+        "storage": {"used_bytes": N, "used_human": "X.X GB"},
+        "queue": {"jobs_queued": N, "jobs_processing": N},
+        "tokens": {"used_this_month": N, "budget": N, "percentage": N},
+        "transcription": {"used_this_month_seconds": N, "used_this_month_minutes": N, "budget_seconds": N, "budget_minutes": N, "percentage": N, "estimated_cost": N},
+        "activity": {"recordings_today": N, "last_transcription": "ISO datetime"}
+    }
+    """
+    scope = request.args.get('scope', 'user')
+
+    # Admin-only for global stats
+    if scope == 'all' and not current_user.is_admin:
+        return jsonify({'error': 'Admin access required for global stats'}), 403
+
+    # Build query filters based on scope
+    if scope == 'user':
+        recording_filter = Recording.user_id == current_user.id
+        job_filter = ProcessingJob.user_id == current_user.id
+        user_id_for_tokens = current_user.id
+    else:
+        recording_filter = True  # No filter = all recordings
+        job_filter = True
+        user_id_for_tokens = None  # Will aggregate all users
+
+    # Recording counts by status
+    total = Recording.query.filter(recording_filter).count()
+    completed = Recording.query.filter(recording_filter, Recording.status == 'COMPLETED').count()
+    processing = Recording.query.filter(
+        recording_filter,
+        Recording.status.in_(['PROCESSING', 'SUMMARIZING'])
+    ).count()
+    pending = Recording.query.filter(recording_filter, Recording.status == 'PENDING').count()
+    failed = Recording.query.filter(recording_filter, Recording.status == 'FAILED').count()
+
+    # Storage calculation
+    storage_query = db.session.query(func.sum(Recording.file_size)).filter(recording_filter)
+    storage_bytes = storage_query.scalar() or 0
+
+    # Queue status
+    jobs_queued = ProcessingJob.query.filter(
+        job_filter,
+        ProcessingJob.status == 'queued'
+    ).count()
+    jobs_processing = ProcessingJob.query.filter(
+        job_filter,
+        ProcessingJob.status == 'processing'
+    ).count()
+
+    # Token usage
+    tokens_data = {}
+    if user_id_for_tokens:
+        # Single user stats
+        monthly_usage = token_tracker.get_monthly_usage(user_id_for_tokens)
+        user = db.session.get(User, user_id_for_tokens)
+        budget = user.monthly_token_budget if user else None
+
+        tokens_data = {
+            'used_this_month': monthly_usage,
+            'budget': budget,
+            'percentage': round((monthly_usage / budget * 100), 1) if budget else None
+        }
+    else:
+        # Aggregate all users (admin scope)
+        current_year = date.today().year
+        current_month = date.today().month
+        total_usage = db.session.query(func.sum(TokenUsage.total_tokens)).filter(
+            extract('year', TokenUsage.date) == current_year,
+            extract('month', TokenUsage.date) == current_month
+        ).scalar() or 0
+
+        tokens_data = {
+            'used_this_month': total_usage,
+            'budget': None,
+            'percentage': None
+        }
+
+    # Transcription usage
+    transcription_data = {}
+    if user_id_for_tokens:
+        # Single user stats
+        monthly_transcription = transcription_tracker.get_monthly_usage(user_id_for_tokens)
+        monthly_cost = transcription_tracker.get_monthly_cost(user_id_for_tokens)
+        user = db.session.get(User, user_id_for_tokens)
+        transcription_budget = user.monthly_transcription_budget if user else None
+
+        transcription_data = {
+            'used_this_month_seconds': monthly_transcription,
+            'used_this_month_minutes': monthly_transcription // 60,
+            'budget_seconds': transcription_budget,
+            'budget_minutes': transcription_budget // 60 if transcription_budget else None,
+            'percentage': round((monthly_transcription / transcription_budget * 100), 1) if transcription_budget else None,
+            'estimated_cost': round(monthly_cost, 4)
+        }
+    else:
+        # Aggregate all users (admin scope)
+        current_year = date.today().year
+        current_month = date.today().month
+        total_seconds = db.session.query(func.sum(TranscriptionUsage.audio_duration_seconds)).filter(
+            extract('year', TranscriptionUsage.date) == current_year,
+            extract('month', TranscriptionUsage.date) == current_month
+        ).scalar() or 0
+        total_cost = db.session.query(func.sum(TranscriptionUsage.estimated_cost)).filter(
+            extract('year', TranscriptionUsage.date) == current_year,
+            extract('month', TranscriptionUsage.date) == current_month
+        ).scalar() or 0
+
+        transcription_data = {
+            'used_this_month_seconds': total_seconds,
+            'used_this_month_minutes': total_seconds // 60,
+            'budget_seconds': None,
+            'budget_minutes': None,
+            'percentage': None,
+            'estimated_cost': round(total_cost, 4)
+        }
+
+    # Recent activity
+    today_start = datetime.combine(date.today(), datetime.min.time())
+    recordings_today = Recording.query.filter(
+        recording_filter,
+        Recording.created_at >= today_start
+    ).count()
+
+    # Last completed transcription
+    last_completed = Recording.query.filter(
+        recording_filter,
+        Recording.status == 'COMPLETED',
+        Recording.completed_at.isnot(None)
+    ).order_by(Recording.completed_at.desc()).first()
+
+    last_transcription = last_completed.completed_at.isoformat() if last_completed and last_completed.completed_at else None
+
+    # Build response
+    response = {
+        'recordings': {
+            'total': total,
+            'completed': completed,
+            'processing': processing,
+            'pending': pending,
+            'failed': failed
+        },
+        'storage': {
+            'used_bytes': storage_bytes,
+            'used_human': format_bytes(storage_bytes)
+        },
+        'queue': {
+            'jobs_queued': jobs_queued,
+            'jobs_processing': jobs_processing
+        },
+        'tokens': tokens_data,
+        'transcription': transcription_data,
+        'activity': {
+            'recordings_today': recordings_today,
+            'last_transcription': last_transcription
+        }
+    }
+
+    # Add user counts for admin scope
+    if scope == 'all' and current_user.is_admin:
+        total_users = User.query.count()
+        # Active = users with recordings in last 30 days
+        cutoff = datetime.utcnow() - timedelta(days=30)
+        active_users = db.session.query(func.count(func.distinct(Recording.user_id))).filter(
+            Recording.created_at >= cutoff
+        ).scalar() or 0
+
+        response['users'] = {
+            'total': total_users,
+            'active': active_users
+        }
+
+    return jsonify(response)
+
+
+# =============================================================================
+# Recordings List with Enhanced Filtering
+# =============================================================================
+
+@api_v1_bp.route('/recordings', methods=['GET'])
+@login_required
+def list_recordings():
+    """
+    List recordings with filtering and pagination.
+
+    Query params:
+        page: Page number (default: 1)
+        per_page: Items per page (default: 25, max: 100)
+        status: Filter by status (pending, processing, completed, failed, all)
+        sort_by: Sort field (created_at, meeting_date, title, file_size, status)
+        sort_order: asc or desc (default: desc)
+        date_from: Filter from date (ISO format)
+        date_to: Filter to date (ISO format)
+        tag_id: Filter by tag ID
+        q: Search query (title, participants)
+        inbox: Filter by inbox status (true/false)
+        starred: Filter by starred status (true/false)
+    """
+    # Parse query parameters
+    page = request.args.get('page', 1, type=int)
+    per_page = min(request.args.get('per_page', 25, type=int), 100)
+    status_filter = request.args.get('status', 'all').lower()
+    sort_by = request.args.get('sort_by', 'created_at')
+    sort_order = request.args.get('sort_order', 'desc').lower()
+    date_from = request.args.get('date_from')
+    date_to = request.args.get('date_to')
+    tag_id = request.args.get('tag_id', type=int)
+    folder_filter = request.args.get('folder_id', '').strip()
+    search_query = request.args.get('q', '').strip()
+    inbox_filter = request.args.get('inbox')
+    starred_filter = request.args.get('starred')
+
+    # Base query - user's recordings
+    query = Recording.query.filter(Recording.user_id == current_user.id)
+
+    # Status filter
+    if status_filter == 'pending':
+        query = query.filter(Recording.status == 'PENDING')
+    elif status_filter == 'processing':
+        query = query.filter(Recording.status.in_(['PROCESSING', 'SUMMARIZING']))
+    elif status_filter == 'completed':
+        query = query.filter(Recording.status == 'COMPLETED')
+    elif status_filter == 'failed':
+        query = query.filter(Recording.status == 'FAILED')
+    # 'all' = no status filter
+
+    # Date filters
+    if date_from:
+        try:
+            from_date = datetime.fromisoformat(date_from.replace('Z', '+00:00'))
+            query = query.filter(Recording.created_at >= from_date)
+        except ValueError:
+            pass
+
+    if date_to:
+        try:
+            to_date = datetime.fromisoformat(date_to.replace('Z', '+00:00'))
+            query = query.filter(Recording.created_at <= to_date)
+        except ValueError:
+            pass
+
+    # Tag filter
+    if tag_id:
+        query = query.join(RecordingTag).filter(RecordingTag.tag_id == tag_id)
+
+    # Folder filter. Accepts an integer folder id, or the literal "none" to
+    # return recordings that are not in any folder. Anything else is ignored.
+    if folder_filter:
+        if folder_filter.lower() == 'none':
+            query = query.filter(Recording.folder_id.is_(None))
+        else:
+            try:
+                folder_id_int = int(folder_filter)
+                query = query.filter(Recording.folder_id == folder_id_int)
+            except ValueError:
+                pass
+
+    # Search filter
+    if search_query:
+        search_pattern = f'%{search_query}%'
+        query = query.filter(
+            or_(
+                Recording.title.ilike(search_pattern),
+                Recording.participants.ilike(search_pattern)
+            )
+        )
+
+    # Inbox filter
+    if inbox_filter is not None:
+        is_inbox = inbox_filter.lower() == 'true'
+        query = query.filter(Recording.is_inbox == is_inbox)
+
+    # Starred filter
+    if starred_filter is not None:
+        is_starred = starred_filter.lower() == 'true'
+        query = query.filter(Recording.is_highlighted == is_starred)
+
+    # Sorting
+    sort_columns = {
+        'created_at': Recording.created_at,
+        'meeting_date': Recording.meeting_date,
+        'title': Recording.title,
+        'file_size': Recording.file_size,
+        'status': Recording.status
+    }
+    sort_column = sort_columns.get(sort_by, Recording.created_at)
+
+    if sort_order == 'asc':
+        query = query.order_by(sort_column.asc())
+    else:
+        query = query.order_by(sort_column.desc())
+
+    # Pagination
+    pagination = query.paginate(page=page, per_page=per_page, error_out=False)
+
+    # Build response
+    recordings = []
+    for r in pagination.items:
+        recordings.append({
+            'id': r.id,
+            'title': r.title,
+            'status': r.status,
+            'created_at': r.created_at.isoformat() if r.created_at else None,
+            'completed_at': r.completed_at.isoformat() if r.completed_at else None,
+            'meeting_date': r.meeting_date.isoformat() if r.meeting_date else None,
+            'file_size': r.file_size,
+            'original_filename': r.original_filename,
+            'participants': r.participants,
+            'is_inbox': r.is_inbox,
+            'is_highlighted': r.is_highlighted,
+            'audio_available': r.audio_deleted_at is None,
+            'audio_duration': r.get_audio_duration(),
+            'has_transcription': bool(r.transcription),
+            'has_summary': bool(r.summary),
+            'processing_time_seconds': r.processing_time_seconds,
+            'transcription_duration_seconds': r.transcription_duration_seconds,
+            'summarization_duration_seconds': r.summarization_duration_seconds,
+            'folder_id': r.folder_id,
+            'folder': {'id': r.folder.id, 'name': r.folder.name} if r.folder else None,
+            'deletion_exempt': r.deletion_exempt,
+            'error_message': r.error_message if r.status == 'FAILED' else None,
+            'tags': [{'id': t.id, 'name': t.name, 'color': t.color} for t in r.tags]
+        })
+
+    return jsonify({
+        'recordings': recordings,
+        'pagination': {
+            'page': pagination.page,
+            'per_page': pagination.per_page,
+            'total': pagination.total,
+            'total_pages': pagination.pages,
+            'has_next': pagination.has_next,
+            'has_prev': pagination.has_prev
+        }
+    })
+
+
+# =============================================================================
+# Recording Detail
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>', methods=['GET'])
+@login_required
+def get_recording(recording_id):
+    """
+    Get full recording details.
+
+    Query params:
+        include: Comma-separated fields to include (transcription, summary, notes)
+                 Default: all fields
+        format: 'full' (default) or 'minimal' (excludes large text fields)
+    """
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    include = request.args.get('include', 'transcription,summary,notes')
+    include_fields = [f.strip() for f in include.split(',')]
+    format_type = request.args.get('format', 'full')
+
+    response = {
+        'id': recording.id,
+        'title': recording.title,
+        'status': recording.status,
+        'participants': recording.participants,
+        'created_at': recording.created_at.isoformat() if recording.created_at else None,
+        'meeting_date': recording.meeting_date.isoformat() if recording.meeting_date else None,
+        'completed_at': recording.completed_at.isoformat() if recording.completed_at else None,
+        'file_size': recording.file_size,
+        'original_filename': recording.original_filename,
+        'mime_type': recording.mime_type,
+        'is_inbox': recording.is_inbox,
+        'is_highlighted': recording.is_highlighted,
+        'audio_available': recording.audio_deleted_at is None,
+        'audio_duration': recording.get_audio_duration(),
+        'processing_time_seconds': recording.processing_time_seconds,
+        'transcription_duration_seconds': recording.transcription_duration_seconds,
+        'summarization_duration_seconds': recording.summarization_duration_seconds,
+        'folder_id': recording.folder_id,
+        'folder': {'id': recording.folder.id, 'name': recording.folder.name} if recording.folder else None,
+        'deletion_exempt': recording.deletion_exempt,
+        'events': [e.to_dict() for e in recording.events] if hasattr(recording, 'events') else [],
+        'error_message': recording.error_message if recording.status == 'FAILED' else None,
+        'tags': [{'id': t.id, 'name': t.name, 'color': t.color} for t in recording.tags],
+        'duplicate_info': recording.get_duplicate_info()
+    }
+
+    # Include large text fields based on params
+    if format_type != 'minimal':
+        if 'transcription' in include_fields:
+            # Format transcription using user's default template
+            response['transcription'] = format_transcription_with_template(
+                recording.transcription, current_user
+            ) if recording.transcription else None
+        if 'summary' in include_fields:
+            response['summary'] = recording.summary
+        if 'notes' in include_fields:
+            response['notes'] = recording.notes
+
+    return jsonify(response)
+
+
+# =============================================================================
+# Recording Transcript/Summary/Notes Individual Endpoints
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/transcript', methods=['GET'])
+@login_required
+def get_transcript(recording_id):
+    """
+    Get transcript in various formats.
+
+    Query params:
+        format: json (default), text, srt, vtt
+    """
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    if not recording.transcription:
+        return jsonify({'error': 'No transcription available'}), 404
+
+    format_type = request.args.get('format', 'json').lower()
+
+    if format_type == 'json':
+        try:
+            segments = json.loads(recording.transcription)
+            return jsonify({
+                'format': 'json',
+                'segments': segments
+            })
+        except json.JSONDecodeError:
+            return jsonify({
+                'format': 'json',
+                'segments': [],
+                'raw': recording.transcription
+            })
+
+    elif format_type == 'text':
+        # Use user's default template for text format
+        formatted = format_transcription_with_template(recording.transcription, current_user)
+        return jsonify({
+            'format': 'text',
+            'content': formatted
+        })
+
+    elif format_type in ['srt', 'vtt']:
+        try:
+            segments = json.loads(recording.transcription)
+            lines = []
+
+            if format_type == 'vtt':
+                lines.append('WEBVTT')
+                lines.append('')
+
+            for i, seg in enumerate(segments, 1):
+                start = seg.get('start_time', seg.get('start', 0))
+                end = seg.get('end_time', seg.get('end', start + 1))
+                text = seg.get('sentence') or seg.get('text', '')
+                speaker = seg.get('speaker', '')
+
+                # Format timestamps
+                def fmt_time(seconds, use_comma=False):
+                    h = int(seconds // 3600)
+                    m = int((seconds % 3600) // 60)
+                    s = int(seconds % 60)
+                    ms = int((seconds - int(seconds)) * 1000)
+                    sep = ',' if use_comma else '.'
+                    return f"{h:02d}:{m:02d}:{s:02d}{sep}{ms:03d}"
+
+                if format_type == 'srt':
+                    lines.append(str(i))
+                    lines.append(f"{fmt_time(start, True)} --> {fmt_time(end, True)}")
+                else:
+                    lines.append(f"{fmt_time(start)} --> {fmt_time(end)}")
+
+                if speaker:
+                    lines.append(f"<v {speaker}>{text}")
+                else:
+                    lines.append(text)
+                lines.append('')
+
+            return jsonify({
+                'format': format_type,
+                'content': '\n'.join(lines)
+            })
+        except (json.JSONDecodeError, TypeError):
+            return jsonify({'error': 'Cannot generate subtitle format from transcript'}), 400
+
+    return jsonify({'error': f'Unknown format: {format_type}'}), 400
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/summary', methods=['GET'])
+@login_required
+def get_summary(recording_id):
+    """Get summary markdown."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    return jsonify({
+        'summary': recording.summary,
+        'has_summary': bool(recording.summary)
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/notes', methods=['GET'])
+@login_required
+def get_notes(recording_id):
+    """Get notes markdown."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    return jsonify({
+        'notes': recording.notes,
+        'has_notes': bool(recording.notes)
+    })
+
+
+# =============================================================================
+# Recording Update Operations
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>', methods=['PATCH'])
+@login_required
+def update_recording(recording_id):
+    """
+    Update recording metadata, notes, or summary.
+
+    Request body (all fields optional):
+    {
+        "title": "Updated Title",
+        "participants": "Alice, Bob",
+        "notes": "Updated notes...",
+        "summary": "Updated summary...",
+        "meeting_date": "2024-01-15T09:00:00Z",
+        "is_inbox": false,
+        "is_highlighted": true,
+        "folder_id": 5            // or null to remove the recording from its folder
+    }
+    """
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    # Update fields if provided
+    if 'title' in data:
+        recording.title = data['title']
+    if 'participants' in data:
+        recording.participants = data['participants']
+    if 'notes' in data:
+        recording.notes = data['notes']
+    if 'summary' in data:
+        recording.summary = data['summary']
+    if 'meeting_date' in data:
+        try:
+            if data['meeting_date']:
+                recording.meeting_date = datetime.fromisoformat(data['meeting_date'].replace('Z', '+00:00'))
+            else:
+                recording.meeting_date = None
+        except ValueError:
+            return jsonify({'error': 'Invalid meeting_date format'}), 400
+    if 'is_inbox' in data:
+        recording.is_inbox = bool(data['is_inbox'])
+    if 'is_highlighted' in data:
+        recording.is_highlighted = bool(data['is_highlighted'])
+    if 'folder_id' in data:
+        new_folder_id = data['folder_id']
+        if new_folder_id is None:
+            recording.folder_id = None
+        else:
+            from src.models.organization import Folder, GroupMembership
+            target = db.session.get(Folder, new_folder_id)
+            if not target:
+                return jsonify({'error': f'Folder {new_folder_id} not found'}), 404
+            # Personal folders: must own. Group folders: must be a member.
+            if target.group_id is None:
+                if target.user_id != current_user.id:
+                    return jsonify({'error': 'No access to target folder'}), 403
+            else:
+                membership = GroupMembership.query.filter_by(
+                    user_id=current_user.id, group_id=target.group_id
+                ).first()
+                if not membership:
+                    return jsonify({'error': 'No access to target folder'}), 403
+            recording.folder_id = new_folder_id
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'recording': {
+            'id': recording.id,
+            'title': recording.title,
+            'participants': recording.participants,
+            'notes': recording.notes,
+            'summary': recording.summary,
+            'meeting_date': recording.meeting_date.isoformat() if recording.meeting_date else None,
+            'is_inbox': recording.is_inbox,
+            'is_highlighted': recording.is_highlighted,
+            'folder_id': recording.folder_id
+        }
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/notes', methods=['PUT'])
+@login_required
+def replace_notes(recording_id):
+    """Replace notes entirely."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    if not data or 'notes' not in data:
+        return jsonify({'error': 'notes field required'}), 400
+
+    recording.notes = data['notes']
+    db.session.commit()
+
+    return jsonify({'success': True, 'notes': recording.notes})
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/summary', methods=['PUT'])
+@login_required
+def replace_summary(recording_id):
+    """Replace summary entirely."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    if not data or 'summary' not in data:
+        return jsonify({'error': 'summary field required'}), 400
+
+    recording.summary = data['summary']
+    db.session.commit()
+
+    return jsonify({'success': True, 'summary': recording.summary})
+
+
+# =============================================================================
+# Recording Delete
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>', methods=['DELETE'])
+@login_required
+def delete_recording(recording_id):
+    """Delete a recording."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    # Check ownership (only owner can delete)
+    if recording.user_id != current_user.id:
+        return jsonify({'error': 'Permission denied - only owner can delete'}), 403
+
+    # Check if deletion is allowed
+    USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+    if not USERS_CAN_DELETE and not current_user.is_admin:
+        return jsonify({'error': 'Deletion not allowed'}), 403
+
+    # Delete associated files
+    if recording.audio_path:
+        try:
+            audio_path = os.path.join(current_app.config.get('UPLOAD_FOLDER', 'uploads'), recording.audio_path)
+            if os.path.exists(audio_path):
+                os.remove(audio_path)
+        except Exception:
+            pass  # Continue with DB deletion even if file deletion fails
+
+    # Delete from database
+    db.session.delete(recording)
+    db.session.commit()
+
+    return jsonify({'success': True, 'message': 'Recording deleted'})
+
+
+# =============================================================================
+# Recording Status
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/status', methods=['GET'])
+@login_required
+def get_recording_status(recording_id):
+    """Get processing status of a recording."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    # Get queue position if pending/processing
+    queue_position = None
+    if recording.status in ['PENDING', 'PROCESSING', 'SUMMARIZING']:
+        # Count jobs ahead of this one
+        job = ProcessingJob.query.filter_by(
+            recording_id=recording_id,
+            status='queued'
+        ).first()
+
+        if job:
+            queue_position = ProcessingJob.query.filter(
+                ProcessingJob.status == 'queued',
+                ProcessingJob.created_at < job.created_at
+            ).count() + 1
+
+    return jsonify({
+        'id': recording.id,
+        'status': recording.status,
+        'queue_position': queue_position,
+        'error_message': recording.error_message if recording.status == 'FAILED' else None,
+        'completed_at': recording.completed_at.isoformat() if recording.completed_at else None
+    })
+
+
+# =============================================================================
+# Title Regeneration
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/regenerate_title', methods=['POST'])
+@login_required
+def api_regenerate_title(recording_id):
+    """Regenerate the AI title for a recording based on its existing transcription."""
+    from src.api.recordings import regenerate_title
+    return regenerate_title(recording_id)
+
+
+# =============================================================================
+# Tag Management
+# =============================================================================
+
+@api_v1_bp.route('/tags', methods=['GET'])
+@login_required
+def list_tags():
+    """List available tags (personal + group tags user has access to)."""
+    from src.models.organization import GroupMembership
+
+    # Get user's personal tags
+    user_tags = Tag.query.filter_by(user_id=current_user.id, group_id=None).order_by(Tag.name).all()
+
+    # Get user's team memberships
+    memberships = GroupMembership.query.filter_by(user_id=current_user.id).all()
+    team_roles = {m.group_id: m.role for m in memberships}
+    team_ids = list(team_roles.keys())
+
+    # Get group tags
+    team_tags = []
+    if team_ids:
+        team_tags = Tag.query.filter(Tag.group_id.in_(team_ids)).order_by(Tag.name).all()
+
+    result = []
+
+    # Personal tags
+    for tag in user_tags:
+        result.append({
+            'id': tag.id,
+            'name': tag.name,
+            'color': tag.color,
+            'is_group_tag': False,
+            'group_id': None,
+            'custom_prompt': tag.custom_prompt,
+            'default_language': tag.default_language,
+            'default_min_speakers': tag.default_min_speakers,
+            'default_max_speakers': tag.default_max_speakers,
+            'protect_from_deletion': tag.protect_from_deletion,
+            'can_edit': True
+        })
+
+    # Group tags
+    for tag in team_tags:
+        user_role = team_roles.get(tag.group_id, 'member')
+        result.append({
+            'id': tag.id,
+            'name': tag.name,
+            'color': tag.color,
+            'is_group_tag': True,
+            'group_id': tag.group_id,
+            'custom_prompt': tag.custom_prompt,
+            'default_language': tag.default_language,
+            'default_min_speakers': tag.default_min_speakers,
+            'default_max_speakers': tag.default_max_speakers,
+            'protect_from_deletion': tag.protect_from_deletion,
+            'can_edit': (user_role == 'admin')
+        })
+
+    return jsonify({'tags': result})
+
+
+@api_v1_bp.route('/tags', methods=['POST'])
+@login_required
+def create_tag():
+    """Create a new tag."""
+    from src.models.organization import GroupMembership
+
+    data = request.get_json()
+    if not data or not data.get('name'):
+        return jsonify({'error': 'Tag name is required'}), 400
+
+    group_id = data.get('group_id')
+
+    # If group tag, verify admin permission
+    if group_id:
+        membership = GroupMembership.query.filter_by(
+            group_id=group_id,
+            user_id=current_user.id
+        ).first()
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can create group tags'}), 403
+
+        # Check for duplicate
+        existing = Tag.query.filter_by(name=data['name'], group_id=group_id).first()
+        if existing:
+            return jsonify({'error': 'Tag with this name already exists for this group'}), 400
+    else:
+        # Check for duplicate personal tag
+        existing = Tag.query.filter_by(name=data['name'], user_id=current_user.id, group_id=None).first()
+        if existing:
+            return jsonify({'error': 'Tag with this name already exists'}), 400
+
+    tag = Tag(
+        name=data['name'],
+        user_id=current_user.id,
+        group_id=group_id,
+        color=data.get('color', '#3B82F6'),
+        custom_prompt=data.get('custom_prompt'),
+        default_language=data.get('default_language'),
+        default_min_speakers=data.get('default_min_speakers'),
+        default_max_speakers=data.get('default_max_speakers'),
+        protect_from_deletion=data.get('protect_from_deletion', False)
+    )
+
+    db.session.add(tag)
+    db.session.commit()
+
+    return jsonify({
+        'id': tag.id,
+        'name': tag.name,
+        'color': tag.color,
+        'is_group_tag': tag.group_id is not None,
+        'group_id': tag.group_id,
+        'custom_prompt': tag.custom_prompt,
+        'default_language': tag.default_language,
+        'default_min_speakers': tag.default_min_speakers,
+        'default_max_speakers': tag.default_max_speakers,
+        'protect_from_deletion': tag.protect_from_deletion
+    }), 201
+
+
+@api_v1_bp.route('/tags/<int:tag_id>', methods=['PUT'])
+@login_required
+def update_tag(tag_id):
+    """Update a tag."""
+    from src.models.organization import GroupMembership
+
+    tag = db.session.get(Tag, tag_id)
+    if not tag:
+        return jsonify({'error': 'Tag not found'}), 404
+
+    # Check permission
+    if tag.group_id:
+        membership = GroupMembership.query.filter_by(
+            group_id=tag.group_id,
+            user_id=current_user.id
+        ).first()
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can edit group tags'}), 403
+    else:
+        if tag.user_id != current_user.id:
+            return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    if 'name' in data:
+        tag.name = data['name']
+    if 'color' in data:
+        tag.color = data['color']
+    if 'custom_prompt' in data:
+        tag.custom_prompt = data['custom_prompt']
+    if 'default_language' in data:
+        tag.default_language = data['default_language']
+    if 'default_min_speakers' in data:
+        tag.default_min_speakers = data['default_min_speakers']
+    if 'default_max_speakers' in data:
+        tag.default_max_speakers = data['default_max_speakers']
+    if 'protect_from_deletion' in data:
+        tag.protect_from_deletion = data['protect_from_deletion']
+
+    db.session.commit()
+
+    return jsonify({'success': True, 'tag': {
+        'id': tag.id,
+        'name': tag.name,
+        'color': tag.color,
+        'custom_prompt': tag.custom_prompt,
+        'default_language': tag.default_language,
+        'default_min_speakers': tag.default_min_speakers,
+        'default_max_speakers': tag.default_max_speakers,
+        'protect_from_deletion': tag.protect_from_deletion
+    }})
+
+
+@api_v1_bp.route('/tags/<int:tag_id>', methods=['DELETE'])
+@login_required
+def delete_tag(tag_id):
+    """Delete a tag."""
+    from src.models.organization import GroupMembership
+
+    tag = db.session.get(Tag, tag_id)
+    if not tag:
+        return jsonify({'error': 'Tag not found'}), 404
+
+    # Check permission
+    if tag.group_id:
+        membership = GroupMembership.query.filter_by(
+            group_id=tag.group_id,
+            user_id=current_user.id
+        ).first()
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can delete group tags'}), 403
+    else:
+        if tag.user_id != current_user.id:
+            return jsonify({'error': 'Permission denied'}), 403
+
+    # Remove all recording associations
+    RecordingTag.query.filter_by(tag_id=tag_id).delete()
+
+    db.session.delete(tag)
+    db.session.commit()
+
+    return jsonify({'success': True, 'message': 'Tag deleted'})
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/tags', methods=['POST'])
+@login_required
+def add_tags_to_recording(recording_id):
+    """Add tag(s) to a recording."""
+    from src.models.organization import GroupMembership
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    tag_ids = data.get('tag_ids', [])
+    if not tag_ids:
+        # Support single tag_id for backward compatibility
+        tag_id = data.get('tag_id')
+        if tag_id:
+            tag_ids = [tag_id]
+        else:
+            return jsonify({'error': 'tag_ids or tag_id required'}), 400
+
+    added_tags = []
+    errors = []
+
+    for tag_id in tag_ids:
+        tag = db.session.get(Tag, tag_id)
+        if not tag:
+            errors.append(f'Tag {tag_id} not found')
+            continue
+
+        # Check permission for this tag
+        if tag.group_id:
+            membership = GroupMembership.query.filter_by(
+                group_id=tag.group_id,
+                user_id=current_user.id
+            ).first()
+            if not membership:
+                errors.append(f'No access to tag {tag_id}')
+                continue
+        else:
+            if tag.user_id != current_user.id:
+                errors.append(f'No access to tag {tag_id}')
+                continue
+
+        # Check if already exists
+        existing = RecordingTag.query.filter_by(
+            recording_id=recording_id,
+            tag_id=tag_id
+        ).first()
+        if existing:
+            continue  # Skip, already added
+
+        # Get next order position
+        max_order = db.session.query(func.max(RecordingTag.order)).filter_by(
+            recording_id=recording_id
+        ).scalar() or 0
+
+        recording_tag = RecordingTag(
+            recording_id=recording_id,
+            tag_id=tag_id,
+            order=max_order + 1
+        )
+        db.session.add(recording_tag)
+        added_tags.append({'id': tag.id, 'name': tag.name})
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'added_tags': added_tags,
+        'errors': errors if errors else None
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/tags/<int:tag_id>', methods=['DELETE'])
+@login_required
+def remove_tag_from_recording(recording_id, tag_id):
+    """Remove a tag from a recording."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    recording_tag = RecordingTag.query.filter_by(
+        recording_id=recording_id,
+        tag_id=tag_id
+    ).first()
+
+    if not recording_tag:
+        return jsonify({'error': 'Tag not on this recording'}), 404
+
+    db.session.delete(recording_tag)
+    db.session.commit()
+
+    return jsonify({'success': True, 'message': 'Tag removed'})
+
+
+# =============================================================================
+# Folder Management
+#
+# These endpoints delegate to the existing web handlers in src/api/folders.py
+# so permission semantics (group folders, member vs admin) match the web UI
+# exactly. The web handlers already return jsonified, API-shaped responses
+# (`folder.to_dict()` for success, `{"error": "..."}` for errors), so the
+# delegation produces clean API output.
+#
+# Contract dependency: the v1 API's response shape on these routes is whatever
+# the corresponding handler in folders.py returns. Changing those return
+# shapes silently changes this API. A future cleanup should extract a
+# services/folder.py layer that returns data dicts, with both the web and v1
+# endpoints thin-wrapping with jsonify; that decouples the API contract from
+# the web response framing.
+# =============================================================================
+
+@api_v1_bp.route('/folders', methods=['GET'])
+@login_required
+def list_folders():
+    """List folders the user can access (personal + group folders)."""
+    from src.api.folders import get_folders as _web_get_folders
+    return _web_get_folders()
+
+
+@api_v1_bp.route('/folders', methods=['POST'])
+@login_required
+def create_folder():
+    """Create a new folder. Accepts the same JSON body as the web endpoint."""
+    from src.api.folders import create_folder as _web_create_folder
+    return _web_create_folder()
+
+
+@api_v1_bp.route('/folders/<int:folder_id>', methods=['GET'])
+@login_required
+def get_folder(folder_id):
+    """Get a single folder by id."""
+    from src.models.organization import Folder, GroupMembership
+
+    folder = db.session.get(Folder, folder_id)
+    if not folder:
+        return jsonify({'error': 'Folder not found'}), 404
+
+    # Personal folders: must own it. Group folders: must be a member.
+    if folder.group_id is None:
+        if folder.user_id != current_user.id:
+            return jsonify({'error': 'Permission denied'}), 403
+    else:
+        membership = GroupMembership.query.filter_by(
+            user_id=current_user.id, group_id=folder.group_id
+        ).first()
+        if not membership:
+            return jsonify({'error': 'Permission denied'}), 403
+
+    folder_dict = folder.to_dict()
+    if folder.group_id is None:
+        folder_dict['can_edit'] = True
+    else:
+        membership = GroupMembership.query.filter_by(
+            user_id=current_user.id, group_id=folder.group_id
+        ).first()
+        folder_dict['can_edit'] = bool(membership and membership.role == 'admin')
+    return jsonify(folder_dict)
+
+
+@api_v1_bp.route('/folders/<int:folder_id>', methods=['PATCH', 'PUT'])
+@login_required
+def update_folder(folder_id):
+    """Update a folder. Same JSON body as the web endpoint."""
+    from src.api.folders import update_folder as _web_update_folder
+    return _web_update_folder(folder_id)
+
+
+@api_v1_bp.route('/folders/<int:folder_id>', methods=['DELETE'])
+@login_required
+def delete_folder(folder_id):
+    """Delete a folder. Recordings in it are unassigned."""
+    from src.api.folders import delete_folder as _web_delete_folder
+    return _web_delete_folder(folder_id)
+
+
+# =============================================================================
+# Transcription Connector & Model Discovery
+# =============================================================================
+
+@api_v1_bp.route('/transcription', methods=['GET'])
+@login_required
+def get_transcription_info():
+    """
+    Return information about the active transcription connector so API
+    clients can know which fields are accepted and which model values are
+    valid for `transcription_model` overrides.
+
+    Response shape:
+      {
+        "connector": "openai_transcribe",
+        "capabilities": {
+          "diarization": true,
+          "speaker_count_control": false,
+          "hotwords": true,
+          "initial_prompt": true,
+          "timestamps": true,
+          "language_detection": true,
+          "chunking": false
+        },
+        "models": [
+          {"value": "gpt-4o-transcribe-diarize", "label": "GPT-4o Diarize"},
+          ...
+        ],
+        "default_model": "gpt-4o-transcribe-diarize"
+      }
+    """
+    from src.models import SystemSetting
+    from src.config.app_config import (
+        TRANSCRIPTION_MODEL,
+        USE_NEW_TRANSCRIPTION_ARCHITECTURE,
+        USE_ASR_ENDPOINT,
+    )
+
+    connector_name = None
+    capabilities = {
+        'diarization': USE_ASR_ENDPOINT,
+        'speaker_count_control': USE_ASR_ENDPOINT,
+        'hotwords': USE_ASR_ENDPOINT,
+        'initial_prompt': USE_ASR_ENDPOINT,
+        'timestamps': True,
+        'language_detection': True,
+        'chunking': False,
+    }
+    if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+        try:
+            from src.services.transcription import get_registry
+            registry = get_registry()
+            connector_name = registry.get_active_connector_name()
+            connector = registry.get_active_connector()
+            if connector:
+                capabilities = {
+                    'diarization': connector.supports_diarization,
+                    'speaker_count_control': connector.supports_speaker_count_control,
+                    'hotwords': connector.supports_hotwords,
+                    'initial_prompt': connector.supports_initial_prompt,
+                    'timestamps': True,
+                    'language_detection': True,
+                    'chunking': connector.supports_chunking,
+                }
+        except Exception as e:
+            current_app.logger.warning(f"Could not read connector capabilities: {e}")
+
+    # Visible models: admin-curated DB list takes precedence over the
+    # TRANSCRIPTION_MODELS_AVAILABLE env var.
+    models = []
+    raw = SystemSetting.get_setting('transcription_models_visible_json', None)
+    if raw:
+        try:
+            parsed = json.loads(raw)
+            if isinstance(parsed, list):
+                for item in parsed:
+                    if isinstance(item, dict) and item.get('value'):
+                        models.append({
+                            'value': item['value'],
+                            'label': item.get('label') or item['value'],
+                        })
+                    elif isinstance(item, str) and item:
+                        models.append({'value': item, 'label': item})
+        except Exception:
+            models = []
+    if not models:
+        from src.config.app_config import (
+            TRANSCRIPTION_MODELS_AVAILABLE,
+            TRANSCRIPTION_MODEL_LABELS,
+        )
+        if TRANSCRIPTION_MODELS_AVAILABLE:
+            labels = TRANSCRIPTION_MODEL_LABELS or []
+            for i, value in enumerate(TRANSCRIPTION_MODELS_AVAILABLE):
+                models.append({
+                    'value': value,
+                    'label': labels[i] if i < len(labels) else value,
+                })
+
+    default_model = SystemSetting.get_setting('transcription_default_model', None) or TRANSCRIPTION_MODEL or None
+
+    return jsonify({
+        'connector': connector_name,
+        'capabilities': capabilities,
+        'models': models,
+        'default_model': default_model,
+    })
+
+
+# =============================================================================
+# Speaker Management
+# =============================================================================
+
+@api_v1_bp.route('/speakers', methods=['GET'])
+@login_required
+def list_speakers():
+    """List all speakers for the current user."""
+    speakers = Speaker.query.filter_by(user_id=current_user.id)\
+                           .order_by(Speaker.use_count.desc(), Speaker.last_used.desc())\
+                           .all()
+
+    return jsonify({
+        'speakers': [{
+            'id': s.id,
+            'name': s.name,
+            'use_count': s.use_count,
+            'last_used': s.last_used.isoformat() if s.last_used else None,
+            'confidence_score': s.confidence_score,
+            'has_voice_profile': s.average_embedding is not None
+        } for s in speakers]
+    })
+
+
+@api_v1_bp.route('/speakers', methods=['POST'])
+@login_required
+def create_speaker():
+    """Create a new speaker."""
+    data = request.get_json()
+    if not data or not data.get('name'):
+        return jsonify({'error': 'Speaker name is required'}), 400
+
+    name = data['name'].strip()
+
+    # Check if already exists
+    existing = Speaker.query.filter_by(user_id=current_user.id, name=name).first()
+    if existing:
+        return jsonify({'error': 'Speaker with this name already exists'}), 400
+
+    speaker = Speaker(
+        name=name,
+        user_id=current_user.id,
+        use_count=0,
+        created_at=datetime.utcnow()
+    )
+    db.session.add(speaker)
+    db.session.commit()
+
+    return jsonify({
+        'id': speaker.id,
+        'name': speaker.name,
+        'use_count': speaker.use_count,
+        'created_at': speaker.created_at.isoformat()
+    }), 201
+
+
+@api_v1_bp.route('/speakers/<int:speaker_id>', methods=['PUT'])
+@login_required
+def update_speaker(speaker_id):
+    """Update a speaker (cascades name changes to recordings)."""
+    speaker = db.session.get(Speaker, speaker_id)
+    if not speaker:
+        return jsonify({'error': 'Speaker not found'}), 404
+
+    if speaker.user_id != current_user.id:
+        return jsonify({'error': 'Permission denied'}), 403
+
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    old_name = speaker.name
+    new_name = data.get('name', '').strip()
+
+    if not new_name:
+        return jsonify({'error': 'Speaker name is required'}), 400
+
+    if new_name != old_name:
+        # Update speaker name
+        speaker.name = new_name
+
+        # Update all recordings that have this speaker in their transcription
+        from src.services.speaker import update_speaker_in_recordings
+        try:
+            update_speaker_in_recordings(current_user.id, old_name, new_name)
+        except Exception as e:
+            current_app.logger.error(f"Error updating speaker in recordings: {e}")
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'speaker': {
+            'id': speaker.id,
+            'name': speaker.name,
+            'use_count': speaker.use_count
+        }
+    })
+
+
+@api_v1_bp.route('/speakers/<int:speaker_id>', methods=['DELETE'])
+@login_required
+def delete_speaker(speaker_id):
+    """Delete a speaker."""
+    speaker = db.session.get(Speaker, speaker_id)
+    if not speaker:
+        return jsonify({'error': 'Speaker not found'}), 404
+
+    if speaker.user_id != current_user.id:
+        return jsonify({'error': 'Permission denied'}), 403
+
+    db.session.delete(speaker)
+    db.session.commit()
+
+    return jsonify({'success': True, 'message': 'Speaker deleted'})
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/speakers', methods=['GET'])
+@login_required
+def get_recording_speakers(recording_id):
+    """Get speakers in a recording with suggestions."""
+    from src.services.speaker_embedding_matcher import find_matching_speakers
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    # Parse transcription to get speakers
+    speakers_in_recording = []
+    speaker_counts = {}
+
+    if recording.transcription:
+        try:
+            segments = json.loads(recording.transcription)
+            for seg in segments:
+                speaker = seg.get('speaker', 'Unknown')
+                speaker_counts[speaker] = speaker_counts.get(speaker, 0) + 1
+        except (json.JSONDecodeError, TypeError):
+            pass
+
+    # Build speaker list with identification info
+    for label, count in speaker_counts.items():
+        # Check if this speaker label has been identified
+        identified_name = None
+        speaker_id = None
+
+        # Look for speaker in user's speakers by checking recordings
+        # This is a simplified check - actual implementation would check speaker_embeddings
+        speakers_in_recording.append({
+            'label': label,
+            'identified_name': identified_name,
+            'speaker_id': speaker_id,
+            'segment_count': count
+        })
+
+    # Get voice-based suggestions
+    suggestions = {}
+    if recording.speaker_embeddings:
+        try:
+            matches = find_matching_speakers(current_user.id, recording.speaker_embeddings)
+            for label, speaker_matches in matches.items():
+                suggestions[label] = [{
+                    'speaker_id': m['speaker_id'],
+                    'name': m['name'],
+                    'similarity': round(m['similarity'] * 100, 1)
+                } for m in speaker_matches[:3]]
+        except Exception as e:
+            current_app.logger.error(f"Error getting speaker suggestions: {e}")
+
+    return jsonify({
+        'speakers': speakers_in_recording,
+        'suggestions': suggestions
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/speakers/assign', methods=['PUT'])
+@login_required
+def assign_speakers(recording_id):
+    """
+    Assign speaker names to a recording's transcription segments.
+
+    Accepts the same speaker_map format as the web UI, plus convenience
+    formats for API callers (plain strings).
+
+    Request body:
+    {
+        "speaker_map": {
+            "SPEAKER_00": "Jane Doe",                       // string shorthand
+            "SPEAKER_01": {"name": "Bob", "isMe": false}    // full object
+        },
+        "regenerate_summary": false
+    }
+    """
+    from src.services.speaker import update_speaker_usage
+    from src.services.speaker_embedding_matcher import update_speaker_embedding
+    from src.services.speaker_snippets import create_speaker_snippets
+    from src.services.job_queue import job_queue
+
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'Permission denied'}), 403
+
+        data = request.get_json()
+        if not data or 'speaker_map' not in data:
+            return jsonify({'error': 'speaker_map is required'}), 400
+
+        raw_speaker_map = data['speaker_map']
+        regenerate_summary = data.get('regenerate_summary', False)
+
+        if not isinstance(raw_speaker_map, dict):
+            return jsonify({'error': 'speaker_map must be an object'}), 400
+
+        # Normalize values to {name, isMe} format (same as web UI expects)
+        speaker_map = {}
+        for label, value in raw_speaker_map.items():
+            if isinstance(value, str):
+                speaker_map[label] = {'name': value.strip(), 'isMe': False}
+            elif isinstance(value, dict):
+                speaker_map[label] = {
+                    'name': value.get('name', '').strip() if value.get('name') else '',
+                    'isMe': value.get('isMe', False)
+                }
+            else:
+                return jsonify({'error': f'Invalid value type for speaker "{label}"'}), 400
+
+        # --- Apply names to transcription (same logic as update_speakers in recordings.py) ---
+        transcription_text = recording.transcription or ''
+        is_json = False
+        try:
+            transcription_data = json.loads(transcription_text)
+            is_json = isinstance(transcription_data, list)
+        except (json.JSONDecodeError, TypeError):
+            is_json = False
+
+        speaker_names_used = []
+
+        if is_json:
+            for segment in transcription_data:
+                original_speaker_label = segment.get('speaker')
+                if original_speaker_label in speaker_map:
+                    new_name_info = speaker_map[original_speaker_label]
+                    new_name = new_name_info.get('name', '').strip()
+                    if new_name_info.get('isMe') and not new_name:
+                        new_name = current_user.name or 'Me'
+                    if new_name:
+                        segment['speaker'] = new_name
+                        if new_name not in speaker_names_used:
+                            speaker_names_used.append(new_name)
+
+            recording.transcription = json.dumps(transcription_data)
+
+            # Update participants - exclude unresolved SPEAKER_XX labels
+            final_speakers = set()
+            for seg in transcription_data:
+                speaker = seg.get('speaker')
+                if speaker and str(speaker).strip():
+                    if not re.match(r'^SPEAKER_\d+$', str(speaker), re.IGNORECASE):
+                        final_speakers.add(speaker)
+            recording.participants = ', '.join(sorted(list(final_speakers)))
+        else:
+            # Plain text transcript
+            new_participants = []
+            for speaker_label, new_name_info in speaker_map.items():
+                new_name = new_name_info.get('name', '').strip()
+                if new_name_info.get('isMe') and not new_name:
+                    new_name = current_user.name or 'Me'
+                if new_name:
+                    transcription_text = re.sub(
+                        r'\[\s*' + re.escape(speaker_label) + r'\s*\]',
+                        f'[{new_name}]',
+                        transcription_text,
+                        flags=re.IGNORECASE
+                    )
+                    if new_name not in new_participants:
+                        new_participants.append(new_name)
+
+            recording.transcription = transcription_text
+            recording.participants = ', '.join(new_participants)
+            speaker_names_used = new_participants
+
+        # Update speaker usage statistics
+        if speaker_names_used:
+            update_speaker_usage(speaker_names_used)
+
+        # Update speaker voice embeddings if available
+        embeddings_updated = 0
+        snippets_created = 0
+        if recording.speaker_embeddings and speaker_map:
+            try:
+                embeddings_data = json.loads(recording.speaker_embeddings) if isinstance(recording.speaker_embeddings, str) else recording.speaker_embeddings
+
+                speaker_label_to_name = {}
+                for speaker_label, speaker_info in speaker_map.items():
+                    name = speaker_info.get('name', '').strip()
+                    if speaker_info.get('isMe') and not name:
+                        name = current_user.name or 'Me'
+                    if name and not re.match(r'^SPEAKER_\d+$', name, re.IGNORECASE):
+                        speaker_label_to_name[speaker_label] = name
+
+                for speaker_label, embedding in embeddings_data.items():
+                    if speaker_label in speaker_label_to_name and embedding and len(embedding) == 256:
+                        speaker_name = speaker_label_to_name[speaker_label]
+                        speaker_obj = Speaker.query.filter_by(
+                            user_id=current_user.id,
+                            name=speaker_name
+                        ).first()
+                        if speaker_obj:
+                            update_speaker_embedding(speaker_obj, embedding, recording.id)
+                            embeddings_updated += 1
+
+                if speaker_label_to_name:
+                    snippets_created = create_speaker_snippets(recording.id, speaker_map)
+            except Exception as e:
+                current_app.logger.error(f"Error updating speaker embeddings: {e}", exc_info=True)
+
+        db.session.commit()
+
+        summary_queued = False
+        if regenerate_summary:
+            job_queue.enqueue(
+                user_id=current_user.id,
+                recording_id=recording.id,
+                job_type='summarize',
+                params={'user_id': current_user.id}
+            )
+            summary_queued = True
+
+        return jsonify({
+            'success': True,
+            'message': 'Speakers updated successfully.',
+            'recording': {
+                'id': recording.id,
+                'title': recording.title,
+                'participants': recording.participants,
+                'status': recording.status
+            },
+            'summary_queued': summary_queued,
+            'embeddings_updated': embeddings_updated,
+            'snippets_created': snippets_created
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error assigning speakers for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': str(e)}), 500
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/speakers/identify', methods=['POST'])
+@login_required
+def identify_speakers(recording_id):
+    """
+    Trigger LLM-based auto-identification of speakers from transcript context.
+    Returns suggestions only - does not modify the recording.
+
+    Uses the shared identification service with JSON schema support,
+    name sanitization, and fallback logic.
+    """
+    from src.services.speaker_identification import identify_speakers_from_transcript
+
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'Permission denied'}), 403
+
+        if not recording.transcription:
+            return jsonify({'error': 'No transcription available for speaker identification'}), 400
+
+        try:
+            transcription_data = json.loads(recording.transcription)
+        except (json.JSONDecodeError, TypeError):
+            return jsonify({'error': 'Transcription format not supported for auto-identification'}), 400
+
+        if not isinstance(transcription_data, list):
+            return jsonify({'error': 'Transcription format not supported for auto-identification'}), 400
+
+        speaker_map = identify_speakers_from_transcript(transcription_data, current_user.id)
+
+        if not speaker_map:
+            return jsonify({'error': 'No speakers found in transcription'}), 400
+
+        return jsonify({'success': True, 'speaker_map': speaker_map})
+
+    except ValueError as ve:
+        return jsonify({'error': str(ve)}), 503
+    except Exception as e:
+        current_app.logger.error(f"Error during auto speaker identification for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': f'An unexpected error occurred: {str(e)}'}), 500
+
+
+# =============================================================================
+# Processing Operations
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/transcribe', methods=['POST'])
+@login_required
+def start_transcription(recording_id):
+    """Queue transcription for a recording."""
+    from src.services.job_queue import job_queue
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    # Check if audio is available
+    if recording.audio_deleted_at:
+        return jsonify({'error': 'Audio has been deleted'}), 400
+
+    data = request.get_json() or {}
+
+    # Apply the same per-request model override path as the upload/reprocess
+    # web endpoints (issue #266). Validates against the admin-curated list +
+    # env allowlist and applies the admin-saved default when nothing was sent.
+    from src.api.recordings import _resolve_transcription_model
+    transcription_model = _resolve_transcription_model(data.get('transcription_model'))
+
+    params = {
+        'language': data.get('language'),
+        'min_speakers': data.get('min_speakers'),
+        'max_speakers': data.get('max_speakers'),
+        'hotwords': data.get('hotwords'),
+        'initial_prompt': data.get('initial_prompt'),
+        'transcription_model': transcription_model,
+    }
+
+    # Queue the job
+    job_id = job_queue.enqueue(
+        user_id=current_user.id,
+        recording_id=recording_id,
+        job_type='reprocess_transcription',
+        params={k: v for k, v in params.items() if v is not None}
+    )
+
+    return jsonify({
+        'success': True,
+        'job_id': job_id,
+        'status': 'QUEUED',
+        'message': 'Transcription queued'
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/summarize', methods=['POST'])
+@login_required
+def start_summarization(recording_id):
+    """Queue summarization for a recording with optional custom prompt."""
+    from src.services.job_queue import job_queue
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_edit=True):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    # Check if transcription exists
+    if not recording.transcription:
+        return jsonify({'error': 'No transcription available - transcribe first'}), 400
+
+    data = request.get_json() or {}
+
+    params = {
+        'custom_prompt': data.get('custom_prompt'),
+        'user_id': current_user.id
+    }
+
+    # Queue the job
+    job_id = job_queue.enqueue(
+        user_id=current_user.id,
+        recording_id=recording_id,
+        job_type='reprocess_summary',
+        params={k: v for k, v in params.items() if v is not None}
+    )
+
+    return jsonify({
+        'success': True,
+        'job_id': job_id,
+        'status': 'QUEUED',
+        'message': 'Summarization queued'
+    })
+
+
+# =============================================================================
+# Chat with Recording
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/chat', methods=['POST'])
+@login_required
+def chat_with_recording(recording_id):
+    """Chat about a recording's content."""
+    from src.services.llm import chat_client, call_chat_completion
+    from src.tasks.processing import format_transcription_for_llm
+    from src.models import SystemSetting
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    if not recording.transcription:
+        return jsonify({'error': 'No transcription available'}), 400
+
+    data = request.get_json()
+    if not data or not data.get('message'):
+        return jsonify({'error': 'message is required'}), 400
+
+    user_message = data['message']
+    conversation_history = data.get('conversation_history', [])
+
+    # Check if chat client is available
+    if chat_client is None:
+        return jsonify({'error': 'Chat service not available'}), 503
+
+    # Format transcription
+    formatted_transcription = format_transcription_for_llm(recording.transcription)
+
+    # Get transcript limit
+    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+    if transcript_limit != -1:
+        formatted_transcription = formatted_transcription[:transcript_limit]
+
+    # Build system prompt
+    system_prompt = f"""You are a helpful assistant analyzing a recording. Answer questions based on the transcript below.
+
+Meeting: {recording.title}
+Participants: {recording.participants or 'Not specified'}
+
+Transcript:
+{formatted_transcription}
+
+Notes: {recording.notes or 'None'}
+"""
+
+    # Build messages
+    messages = [{"role": "system", "content": system_prompt}]
+    messages.extend(conversation_history)
+    messages.append({"role": "user", "content": user_message})
+
+    try:
+        completion = call_chat_completion(messages, user_id=current_user.id)
+        reply = completion.choices[0].message.content
+
+        return jsonify({
+            'response': reply,
+            'sources': []  # Could be enhanced to extract relevant segments
+        })
+    except Exception as e:
+        current_app.logger.error(f"Chat error: {e}")
+        return jsonify({'error': 'Chat failed'}), 500
+
+
+# =============================================================================
+# Calendar Events
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/events', methods=['GET'])
+@login_required
+def get_recording_events(recording_id):
+    """Get calendar events extracted from a recording."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    events = Event.query.filter_by(recording_id=recording_id).all()
+
+    return jsonify({
+        'events': [{
+            'id': e.id,
+            'title': e.title,
+            'start_datetime': e.start_datetime.isoformat() if e.start_datetime else None,
+            'end_datetime': e.end_datetime.isoformat() if e.end_datetime else None,
+            'description': e.description,
+            'location': e.location
+        } for e in events]
+    })
+
+
+@api_v1_bp.route('/recordings/<int:recording_id>/events/ics', methods=['GET'])
+@login_required
+def download_events_ics(recording_id):
+    """Download all events as ICS file."""
+    from src.api.events import generate_ics_content
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    events = Event.query.filter_by(recording_id=recording_id).all()
+    if not events:
+        return jsonify({'error': 'No events found'}), 404
+
+    # Generate combined ICS
+    ics_lines = ['BEGIN:VCALENDAR', 'VERSION:2.0', 'PRODID:-//Speakr//Events//EN']
+
+    for event in events:
+        ics_lines.append('BEGIN:VEVENT')
+        ics_lines.append(f'UID:{event.id}@speakr')
+        ics_lines.append(f'SUMMARY:{event.title}')
+        if event.start_datetime:
+            ics_lines.append(f'DTSTART:{event.start_datetime.strftime("%Y%m%dT%H%M%S")}')
+        if event.end_datetime:
+            ics_lines.append(f'DTEND:{event.end_datetime.strftime("%Y%m%dT%H%M%S")}')
+        if event.description:
+            ics_lines.append(f'DESCRIPTION:{event.description}')
+        if event.location:
+            ics_lines.append(f'LOCATION:{event.location}')
+        ics_lines.append('END:VEVENT')
+
+    ics_lines.append('END:VCALENDAR')
+
+    from flask import Response
+    return Response(
+        '\r\n'.join(ics_lines),
+        mimetype='text/calendar',
+        headers={'Content-Disposition': f'attachment; filename=events-{recording_id}.ics'}
+    )
+
+
+# =============================================================================
+# Audio Download
+# =============================================================================
+
+@api_v1_bp.route('/recordings/<int:recording_id>/audio', methods=['GET'])
+@login_required
+def download_audio(recording_id):
+    """Download or stream audio file."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user):
+        return jsonify({'error': 'Permission denied'}), 403
+
+    if recording.audio_deleted_at:
+        return jsonify({'error': 'Audio has been deleted'}), 404
+
+    if not recording.audio_path:
+        return jsonify({'error': 'No audio file'}), 404
+
+    audio_path = os.path.join(current_app.config.get('UPLOAD_FOLDER', 'uploads'), recording.audio_path)
+    if not os.path.exists(audio_path):
+        return jsonify({'error': 'Audio file not found'}), 404
+
+    download = request.args.get('download', 'false').lower() == 'true'
+
+    return send_file(
+        audio_path,
+        mimetype=recording.mime_type or 'audio/mpeg',
+        as_attachment=download,
+        download_name=recording.original_filename or f'recording-{recording_id}.mp3'
+    )
+
+
+# =============================================================================
+# Batch Operations
+# =============================================================================
+
+@api_v1_bp.route('/recordings/batch', methods=['PATCH'])
+@login_required
+def batch_update_recordings():
+    """Batch update multiple recordings."""
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    recording_ids = data.get('recording_ids', [])
+    updates = data.get('updates', {})
+
+    if not recording_ids:
+        return jsonify({'error': 'recording_ids required'}), 400
+
+    # If folder_id is being set on the batch, validate target folder access
+    # once up front. The same destination folder applies to every recording
+    # in the batch, so the permission check is identical for all of them.
+    target_folder_id = None
+    if 'folder_id' in updates:
+        new_folder_id = updates['folder_id']
+        if new_folder_id is not None:
+            from src.models.organization import Folder, GroupMembership
+            target = db.session.get(Folder, new_folder_id)
+            if not target:
+                return jsonify({'error': f'Folder {new_folder_id} not found'}), 404
+            if target.group_id is None:
+                if target.user_id != current_user.id:
+                    return jsonify({'error': 'No access to target folder'}), 403
+            else:
+                membership = GroupMembership.query.filter_by(
+                    user_id=current_user.id, group_id=target.group_id
+                ).first()
+                if not membership:
+                    return jsonify({'error': 'No access to target folder'}), 403
+            target_folder_id = new_folder_id
+
+    results = []
+    for recording_id in recording_ids:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            results.append({'id': recording_id, 'success': False, 'error': 'Not found'})
+            continue
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            results.append({'id': recording_id, 'success': False, 'error': 'Permission denied'})
+            continue
+
+        try:
+            if 'is_inbox' in updates:
+                recording.is_inbox = bool(updates['is_inbox'])
+            if 'is_highlighted' in updates:
+                recording.is_highlighted = bool(updates['is_highlighted'])
+            if 'folder_id' in updates:
+                # `target_folder_id` already validated above (None to remove,
+                # or a valid folder id the caller has access to).
+                recording.folder_id = target_folder_id
+
+            # Handle tag additions
+            if 'add_tag_ids' in updates:
+                for tag_id in updates['add_tag_ids']:
+                    existing = RecordingTag.query.filter_by(
+                        recording_id=recording_id,
+                        tag_id=tag_id
+                    ).first()
+                    if not existing:
+                        max_order = db.session.query(func.max(RecordingTag.order)).filter_by(
+                            recording_id=recording_id
+                        ).scalar() or 0
+                        recording_tag = RecordingTag(
+                            recording_id=recording_id,
+                            tag_id=tag_id,
+                            order=max_order + 1
+                        )
+                        db.session.add(recording_tag)
+
+            # Handle tag removals
+            if 'remove_tag_ids' in updates:
+                for tag_id in updates['remove_tag_ids']:
+                    RecordingTag.query.filter_by(
+                        recording_id=recording_id,
+                        tag_id=tag_id
+                    ).delete()
+
+            results.append({'id': recording_id, 'success': True})
+        except Exception as e:
+            results.append({'id': recording_id, 'success': False, 'error': str(e)})
+
+    db.session.commit()
+
+    success_count = sum(1 for r in results if r['success'])
+    return jsonify({
+        'success': True,
+        'updated': success_count,
+        'failed': len(results) - success_count,
+        'results': results
+    })
+
+
+@api_v1_bp.route('/recordings/batch', methods=['DELETE'])
+@login_required
+def batch_delete_recordings():
+    """Batch delete multiple recordings."""
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    recording_ids = data.get('recording_ids', [])
+    if not recording_ids:
+        return jsonify({'error': 'recording_ids required'}), 400
+
+    USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+    if not USERS_CAN_DELETE and not current_user.is_admin:
+        return jsonify({'error': 'Deletion not allowed'}), 403
+
+    results = []
+    for recording_id in recording_ids:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            results.append({'id': recording_id, 'success': False, 'error': 'Not found'})
+            continue
+
+        if recording.user_id != current_user.id and not current_user.is_admin:
+            results.append({'id': recording_id, 'success': False, 'error': 'Permission denied'})
+            continue
+
+        try:
+            # Delete audio file
+            if recording.audio_path:
+                audio_path = os.path.join(current_app.config.get('UPLOAD_FOLDER', 'uploads'), recording.audio_path)
+                if os.path.exists(audio_path):
+                    os.remove(audio_path)
+
+            db.session.delete(recording)
+            results.append({'id': recording_id, 'success': True})
+        except Exception as e:
+            results.append({'id': recording_id, 'success': False, 'error': str(e)})
+
+    db.session.commit()
+
+    success_count = sum(1 for r in results if r['success'])
+    return jsonify({
+        'success': True,
+        'deleted': success_count,
+        'failed': len(results) - success_count,
+        'results': results
+    })
+
+
+@api_v1_bp.route('/recordings/batch/transcribe', methods=['POST'])
+@login_required
+def batch_transcribe_recordings():
+    """Batch queue transcriptions for multiple recordings."""
+    from src.services.job_queue import job_queue
+
+    data = request.get_json()
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    recording_ids = data.get('recording_ids', [])
+    if not recording_ids:
+        return jsonify({'error': 'recording_ids required'}), 400
+
+    results = []
+    for recording_id in recording_ids:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            results.append({'id': recording_id, 'success': False, 'error': 'Not found'})
+            continue
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            results.append({'id': recording_id, 'success': False, 'error': 'Permission denied'})
+            continue
+
+        if recording.audio_deleted_at:
+            results.append({'id': recording_id, 'success': False, 'error': 'Audio deleted'})
+            continue
+
+        try:
+            job_id = job_queue.enqueue(
+                user_id=current_user.id,
+                recording_id=recording_id,
+                job_type='reprocess_transcription',
+                params={}
+            )
+            results.append({'id': recording_id, 'success': True, 'job_id': job_id})
+        except Exception as e:
+            results.append({'id': recording_id, 'success': False, 'error': str(e)})
+
+    success_count = sum(1 for r in results if r['success'])
+    return jsonify({
+        'success': True,
+        'queued': success_count,
+        'failed': len(results) - success_count,
+        'results': results
+    })
+
+
+# =============================================================================
+# Settings
+# =============================================================================
+
+@api_v1_bp.route('/settings/auto-summarization', methods=['PUT'])
+@login_required
+def update_auto_summarization():
+    """Toggle auto-summarization for the current user."""
+    data = request.get_json()
+
+    if data is None:
+        return jsonify({'error': 'Invalid JSON'}), 400
+
+    if 'enabled' not in data:
+        return jsonify({'error': 'enabled field is required'}), 400
+
+    current_user.auto_summarization = bool(data['enabled'])
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'auto_summarization': current_user.auto_summarization
+    })
+
+
+@api_v1_bp.route('/recordings/upload', methods=['POST'])
+@login_required
+def upload_recording():
+    """
+    Upload a recording and queue transcription (API).
+
+    Multipart form-data fields:
+      - file (required)
+      - notes (optional)
+      - title (optional)
+      - meeting_date (optional, ISO 8601)
+      - file_last_modified (optional, ms epoch)
+      - language (optional)
+      - min_speakers (optional)
+      - max_speakers (optional)
+      - hotwords (optional)
+      - initial_prompt (optional)
+      - transcription_model (optional, validated against admin-curated list)
+      - prompt_variables (optional, JSON object of `{variable_name: value}`
+        substituted into `{{name}}` placeholders in the resolved summary
+        prompt at summarisation time)
+      - folder_id (optional)
+      - tag_ids[0], tag_ids[1], ... (optional)
+      - tag_id (optional, legacy)
+    """
+    return _upload_file_ui()
diff --git a/src/api/auth.py b/src/api/auth.py
new file mode 100644
index 00000000..a432ea15
--- /dev/null
+++ b/src/api/auth.py
@@ -0,0 +1,873 @@
+"""
+Authentication and user management routes.
+
+This blueprint handles user registration, login, logout, account management,
+and password changes.
+"""
+
+import os
+import re
+import mimetypes
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, session, current_app
+from flask_login import login_user, logout_user, login_required, current_user
+from flask_wtf import FlaskForm
+from wtforms import StringField, PasswordField, SubmitField, BooleanField
+from wtforms.validators import DataRequired, Length, Email, EqualTo, ValidationError
+from werkzeug.security import generate_password_hash, check_password_hash
+import markdown
+
+from src.database import db
+from src.models import User, SystemSetting, GroupMembership
+from src.utils import password_check, is_safe_url
+from src.auth.sso import (
+    init_sso_client,
+    is_sso_enabled,
+    get_sso_config,
+    get_sso_client,
+    create_or_update_sso_user,
+    is_domain_allowed,
+    link_sso_to_existing_user,
+    update_user_profile_from_claims,
+)
+from src.services.email import (
+    is_email_verification_enabled,
+    is_email_verification_required,
+    is_smtp_configured,
+    send_verification_email,
+    send_password_reset_email,
+    verify_email_token,
+    verify_reset_token,
+    can_resend_verification,
+    can_resend_password_reset,
+)
+
+# Create blueprint
+auth_bp = Blueprint('auth', __name__)
+
+# Import these from app after initialization
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_auth_extensions(_bcrypt, _csrf, _limiter):
+    """Initialize extensions after app creation."""
+    global bcrypt, csrf, limiter
+    bcrypt = _bcrypt
+    csrf = _csrf
+    limiter = _limiter
+
+
+def rate_limit(limit_string):
+    """Decorator that applies rate limiting if limiter is available."""
+    def decorator(f):
+        from functools import wraps
+        @wraps(f)
+        def wrapper(*args, **kwargs):
+            return f(*args, **kwargs)
+        # Store the limit string for later application
+        wrapper._rate_limit = limit_string
+        return wrapper
+    return decorator
+
+
+def csrf_exempt(f):
+    """Decorator placeholder for CSRF exemption - applied after initialization."""
+    from functools import wraps
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        return f(*args, **kwargs)
+    wrapper._csrf_exempt = True
+    return wrapper
+
+
+# --- Forms ---
+
+class RegistrationForm(FlaskForm):
+    username = StringField('Username', validators=[DataRequired(), Length(min=2, max=20)])
+    email = StringField('Email', validators=[DataRequired(), Email()])
+    password = PasswordField('Password', validators=[DataRequired(), password_check])
+    confirm_password = PasswordField('Confirm Password', validators=[DataRequired(), EqualTo('password')])
+    submit = SubmitField('Sign Up')
+
+    def validate_username(self, username):
+        user = User.query.filter_by(username=username.data).first()
+        if user:
+            raise ValidationError('That username is already taken. Please choose a different one.')
+
+    def validate_email(self, email):
+        user = User.query.filter_by(email=email.data).first()
+        if user:
+            raise ValidationError('That email is already registered. Please use a different one.')
+
+
+class LoginForm(FlaskForm):
+    email = StringField('Email', validators=[DataRequired(), Email()])
+    password = PasswordField('Password', validators=[DataRequired()])
+    remember = BooleanField('Remember Me')
+    submit = SubmitField('Login')
+
+
+# --- Helper Functions ---
+
+def is_registration_domain_allowed(email: str) -> bool:
+    """Check if email domain is allowed for registration.
+
+    Returns True if no domain restrictions are configured or if the
+    email domain is in the allowed list.
+    """
+    if not email:
+        return False
+
+    domains_env = os.environ.get('REGISTRATION_ALLOWED_DOMAINS', '')
+    if not domains_env or not domains_env.strip():
+        return True  # No restriction configured
+
+    allowed = [d.strip().lower() for d in domains_env.split(',') if d.strip()]
+    if not allowed:
+        return True  # Empty after parsing
+
+    parts = email.lower().rsplit('@', 1)
+    if len(parts) != 2:
+        return False  # Invalid email format
+
+    domain = parts[1]
+    return domain in allowed
+
+
+# --- Routes ---
+
+@auth_bp.route('/register', methods=['GET', 'POST'])
+@rate_limit("10 per minute")
+def register():
+    # Check if registration is allowed
+    allow_registration = os.environ.get('ALLOW_REGISTRATION', 'true').lower() == 'true'
+
+    if not allow_registration:
+        flash('Registration is currently disabled. Please contact the administrator.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    if current_user.is_authenticated:
+        return redirect(url_for('recordings.index'))
+
+    form = RegistrationForm()
+    if form.validate_on_submit():
+        # Check if email domain is allowed
+        if not is_registration_domain_allowed(form.email.data):
+            flash('Registration is restricted. Please contact the administrator.', 'danger')
+            return render_template('register.html', title='Register', form=form)
+
+        hashed_password = bcrypt.generate_password_hash(form.password.data).decode('utf-8')
+
+        # Set email_verified based on whether verification is enabled
+        # If verification is enabled, new users start unverified
+        # If disabled, new users are considered verified by default
+        email_verified = not is_email_verification_enabled()
+
+        user = User(
+            username=form.username.data,
+            email=form.email.data,
+            password=hashed_password,
+            email_verified=email_verified
+        )
+        db.session.add(user)
+        db.session.commit()
+
+        # Send verification email if enabled
+        if is_email_verification_enabled() and is_smtp_configured():
+            if send_verification_email(user):
+                return render_template('auth/check_email.html',
+                                     title='Check Your Email',
+                                     email=user.email,
+                                     action='verification')
+            else:
+                # Email failed to send, but account was created
+                flash('Your account has been created, but we could not send a verification email. Please contact support.', 'warning')
+                return redirect(url_for('auth.login'))
+
+        flash('Your account has been created! You can now log in.', 'success')
+        return redirect(url_for('auth.login'))
+
+    return render_template('register.html', title='Register', form=form)
+
+
+@auth_bp.route('/login', methods=['GET', 'POST'])
+@rate_limit("10 per minute")
+def login():
+    if current_user.is_authenticated:
+        return redirect(url_for('recordings.index'))
+
+    sso_enabled = is_sso_enabled()
+    sso_config = get_sso_config()
+    if sso_enabled:
+        init_sso_client(current_app)
+
+    password_login_disabled = sso_enabled and sso_config.get('disable_password_login', False)
+
+    form = LoginForm()
+    if form.validate_on_submit():
+        user = User.query.filter_by(email=form.email.data).first()
+        if user and user.password:
+            # Check if password login is disabled for non-admins
+            if password_login_disabled and not user.is_admin:
+                flash('Password login is disabled. Please sign in with SSO.', 'warning')
+            elif bcrypt.check_password_hash(user.password, form.password.data):
+                # Check email verification if required
+                if is_email_verification_required() and not user.email_verified:
+                    # Store user email in session for resend functionality
+                    session['unverified_email'] = user.email
+                    return render_template('auth/check_email.html',
+                                         title='Email Verification Required',
+                                         email=user.email,
+                                         action='verification_required',
+                                         show_resend=True)
+
+                login_user(user, remember=form.remember.data)
+                next_page = request.args.get('next')
+                if not is_safe_url(next_page):
+                    return redirect(url_for('recordings.index'))
+                return redirect(next_page) if next_page else redirect(url_for('recordings.index'))
+            else:
+                flash('Login unsuccessful. Please check email and password.', 'danger')
+        elif user and not user.password:
+            flash('This account uses SSO login. Please sign in with SSO.', 'warning')
+        else:
+            flash('Login unsuccessful. Please check email and password.', 'danger')
+
+    return render_template(
+        'login.html',
+        title='Login',
+        form=form,
+        sso_enabled=sso_enabled,
+        sso_provider_name=sso_config.get('provider_name', 'SSO'),
+        password_login_disabled=password_login_disabled
+    )
+
+
+@auth_bp.route('/auth/sso/login')
+@rate_limit("10 per minute")
+def sso_login():
+    if not is_sso_enabled():
+        flash('SSO is not configured. Please contact the administrator.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    oauth = get_sso_client() or init_sso_client(current_app)
+    if not oauth:
+        flash('Failed to initialize SSO client. Check server logs.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    next_url = request.args.get('next')
+    if next_url and is_safe_url(next_url):
+        session['sso_next'] = next_url
+    else:
+        session.pop('sso_next', None)
+
+    return oauth.sso.authorize_redirect(redirect_uri=get_sso_config().get('redirect_uri'))
+
+
+@auth_bp.route('/auth/sso/callback')
+@rate_limit("20 per minute")
+def sso_callback():
+    if not is_sso_enabled():
+        flash('SSO is not configured. Please contact the administrator.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    oauth = get_sso_client() or init_sso_client(current_app)
+    if not oauth:
+        flash('Failed to initialize SSO client. Check server logs.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    try:
+        token = oauth.sso.authorize_access_token()
+        userinfo = token.get('userinfo') or oauth.sso.userinfo()
+    except Exception as e:
+        current_app.logger.warning(f"SSO callback error: {e}")
+        flash('SSO login failed. Please try again.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    subject = userinfo.get('sub')
+    if not subject:
+        flash('SSO response did not include a subject identifier.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    link_user_id = session.pop('sso_link_user_id', None)
+    next_url = session.pop('sso_next', None)
+    cfg = get_sso_config()
+
+    if link_user_id:
+        target_user = db.session.get(User, int(link_user_id))
+        if not target_user:
+            flash('Could not link account: user not found.', 'danger')
+            return redirect(url_for('auth.account'))
+
+        existing = User.query.filter_by(sso_subject=subject).first()
+        if existing and existing.id != target_user.id:
+            flash('This SSO account is already linked to another user.', 'danger')
+            return redirect(url_for('auth.account'))
+
+        update_user_profile_from_claims(target_user, userinfo)
+        target_user.sso_provider = cfg.get('provider_name', 'SSO')
+        target_user.sso_subject = subject
+        db.session.commit()
+        flash('SSO account linked successfully.', 'success')
+        return redirect(url_for('auth.account'))
+
+    try:
+        user = create_or_update_sso_user(userinfo)
+    except PermissionError as e:
+        flash(str(e), 'danger')
+        return redirect(url_for('auth.login'))
+    except ValueError as e:
+        flash(str(e), 'danger')
+        return redirect(url_for('auth.login'))
+    except Exception as e:
+        current_app.logger.warning(f"SSO login error: {e}")
+        flash('Could not complete SSO login. Please try again.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    login_user(user, remember=True)
+
+    if next_url and is_safe_url(next_url):
+        return redirect(next_url)
+    return redirect(url_for('recordings.index'))
+
+
+@auth_bp.route('/auth/sso/link', methods=['POST'])
+@login_required
+def sso_link():
+    if not is_sso_enabled():
+        flash('SSO is not configured. Please contact the administrator.', 'danger')
+        return redirect(url_for('auth.account'))
+
+    session['sso_link_user_id'] = current_user.id
+    session['sso_next'] = url_for('auth.account')
+
+    return redirect(url_for('auth.sso_login'))
+
+
+@auth_bp.route('/auth/sso/unlink', methods=['POST'])
+@login_required
+def sso_unlink():
+    if not current_user.sso_subject:
+        flash('Your account is not linked to SSO.', 'warning')
+        return redirect(url_for('auth.account'))
+
+    if not current_user.password:
+        flash('Cannot unlink SSO - you have no password set. Please set a password first.', 'danger')
+        return redirect(url_for('auth.account'))
+
+    current_user.sso_provider = None
+    current_user.sso_subject = None
+    db.session.commit()
+    flash('SSO account unlinked successfully.', 'success')
+    return redirect(url_for('auth.account'))
+
+
+@auth_bp.route('/logout')
+@csrf_exempt
+def logout():
+    logout_user()
+    return redirect(url_for('auth.login'))
+
+
+# --- Email Verification Routes ---
+
+@auth_bp.route('/verify-email/<token>')
+def verify_email(token):
+    """Verify email address using token from email link."""
+    user_id = verify_email_token(token)
+
+    if user_id is None:
+        flash('The verification link is invalid or has expired.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    user = db.session.get(User, user_id)
+    if not user:
+        flash('User not found.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    if user.email_verified:
+        flash('Your email has already been verified.', 'info')
+        return redirect(url_for('auth.login'))
+
+    # Verify the email
+    user.email_verified = True
+    user.email_verification_token = None  # Clear the token
+    db.session.commit()
+
+    return render_template('auth/verify_success.html', title='Email Verified')
+
+
+@auth_bp.route('/resend-verification', methods=['POST'])
+@rate_limit("3 per minute")
+def resend_verification():
+    """Resend verification email."""
+    if not is_email_verification_enabled():
+        flash('Email verification is not enabled.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    if not is_smtp_configured():
+        flash('Email service is not configured.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    # Get email from session (set during failed login) or form
+    email = session.get('unverified_email') or request.form.get('email')
+
+    if not email:
+        flash('Email address is required.', 'danger')
+        return redirect(url_for('auth.login'))
+
+    user = User.query.filter_by(email=email).first()
+
+    if not user:
+        # Don't reveal if user exists
+        flash('If an account exists with this email, a verification link has been sent.', 'info')
+        return redirect(url_for('auth.login'))
+
+    if user.email_verified:
+        flash('Your email has already been verified.', 'info')
+        return redirect(url_for('auth.login'))
+
+    # Check cooldown
+    can_resend, remaining = can_resend_verification(user)
+    if not can_resend:
+        flash(f'Please wait {remaining} seconds before requesting another verification email.', 'warning')
+        return render_template('auth/check_email.html',
+                             title='Check Your Email',
+                             email=email,
+                             action='verification_required',
+                             show_resend=True)
+
+    if send_verification_email(user):
+        flash('A new verification email has been sent.', 'success')
+    else:
+        flash('Failed to send verification email. Please try again later.', 'danger')
+
+    return render_template('auth/check_email.html',
+                         title='Check Your Email',
+                         email=email,
+                         action='verification',
+                         show_resend=True)
+
+
+# --- Password Reset Routes ---
+
+@auth_bp.route('/forgot-password', methods=['GET', 'POST'])
+@rate_limit("5 per minute")
+def forgot_password():
+    """Show and handle forgot password form."""
+    if current_user.is_authenticated:
+        return redirect(url_for('recordings.index'))
+
+    if not is_smtp_configured():
+        flash('Password reset is not available. Please contact the administrator.', 'warning')
+        return redirect(url_for('auth.login'))
+
+    if request.method == 'POST':
+        email = request.form.get('email')
+
+        if not email:
+            flash('Email address is required.', 'danger')
+            return render_template('auth/forgot_password.html', title='Forgot Password')
+
+        user = User.query.filter_by(email=email).first()
+
+        # Always show the same message to prevent email enumeration
+        if user:
+            # Check if user has a password (not SSO-only)
+            if user.password:
+                # Check cooldown
+                can_resend, remaining = can_resend_password_reset(user)
+                if not can_resend:
+                    flash(f'Please wait {remaining} seconds before requesting another reset email.', 'warning')
+                else:
+                    send_password_reset_email(user)
+
+        flash('If an account exists with this email, a password reset link has been sent.', 'info')
+        return render_template('auth/check_email.html',
+                             title='Check Your Email',
+                             email=email,
+                             action='password_reset')
+
+    return render_template('auth/forgot_password.html', title='Forgot Password')
+
+
+@auth_bp.route('/reset-password/<token>', methods=['GET', 'POST'])
+@rate_limit("10 per minute")
+def reset_password(token):
+    """Handle password reset form."""
+    if current_user.is_authenticated:
+        return redirect(url_for('recordings.index'))
+
+    user_id = verify_reset_token(token)
+
+    if user_id is None:
+        flash('The password reset link is invalid or has expired.', 'danger')
+        return redirect(url_for('auth.forgot_password'))
+
+    user = db.session.get(User, user_id)
+    if not user:
+        flash('User not found.', 'danger')
+        return redirect(url_for('auth.forgot_password'))
+
+    if request.method == 'POST':
+        password = request.form.get('password')
+        confirm_password = request.form.get('confirm_password')
+
+        if not password or not confirm_password:
+            flash('Both password fields are required.', 'danger')
+            return render_template('auth/reset_password.html', title='Reset Password', token=token)
+
+        if password != confirm_password:
+            flash('Passwords do not match.', 'danger')
+            return render_template('auth/reset_password.html', title='Reset Password', token=token)
+
+        # Validate password
+        try:
+            password_check(None, type('obj', (object,), {'data': password}))
+        except ValidationError as e:
+            flash(str(e), 'danger')
+            return render_template('auth/reset_password.html', title='Reset Password', token=token)
+
+        # Update password
+        hashed_password = bcrypt.generate_password_hash(password).decode('utf-8')
+        user.password = hashed_password
+        user.password_reset_token = None  # Clear the token
+        user.password_reset_sent_at = None
+
+        # Also verify email if not already verified
+        if not user.email_verified:
+            user.email_verified = True
+
+        db.session.commit()
+
+        flash('Your password has been reset. You can now log in with your new password.', 'success')
+        return redirect(url_for('auth.login'))
+
+    return render_template('auth/reset_password.html', title='Reset Password', token=token)
+
+
+@auth_bp.route('/account', methods=['GET', 'POST'])
+@login_required
+def account():
+    # Import here to avoid circular imports
+    from flask import current_app
+
+    if request.method == 'POST':
+        # Only update fields that are present in the form submission
+        # This prevents clearing data when switching between tabs
+
+        # Check if this is the account information form (has user_name field)
+        if 'user_name' in request.form:
+            # Handle personal information updates only -- language preferences
+            # have moved to the Preferences tab and are handled below.
+            user_name = request.form.get('user_name')
+            user_job_title = request.form.get('user_job_title')
+            user_company = request.form.get('user_company')
+
+            current_user.name = user_name if user_name else None
+            current_user.job_title = user_job_title if user_job_title else None
+            current_user.company = user_company if user_company else None
+
+        # Check if this is the preferences form (UI/display + language settings)
+        elif 'preferences_form' in request.form:
+            current_user.show_timestamps_simple_view = 'show_timestamps_simple_view' in request.form
+            current_user.editor_autosave = 'editor_autosave' in request.form
+
+            ui_lang = request.form.get('ui_language')
+            transcription_lang = request.form.get('transcription_language')
+            output_lang = request.form.get('output_language')
+            current_user.ui_language = ui_lang if ui_lang else 'en'
+            # Normalize transcription_language so legacy display-name values
+            # ("Français", "Deutsch", ...) can't reach the ASR call (issue #256).
+            from src.utils.language import normalize_language_code
+            current_user.transcription_language = normalize_language_code(transcription_lang)
+            current_user.output_language = output_lang if output_lang else None
+
+        # Check if this is the custom prompts form (has summary_prompt field)
+        elif 'summary_prompt' in request.form:
+            # Handle custom prompt updates
+            summary_prompt_text = request.form.get('summary_prompt')
+            current_user.summary_prompt = summary_prompt_text if summary_prompt_text else None
+            # Handle event extraction setting
+            current_user.extract_events = 'extract_events' in request.form
+            # Handle transcription hints
+            hotwords = request.form.get('transcription_hotwords')
+            current_user.transcription_hotwords = hotwords if hotwords else None
+            initial_prompt = request.form.get('transcription_initial_prompt')
+            current_user.transcription_initial_prompt = initial_prompt if initial_prompt else None
+
+        # Only update diarize if it's not locked by env var
+        if 'ASR_DIARIZE' not in os.environ:
+            current_user.diarize = 'diarize' in request.form
+
+        db.session.commit()
+
+        # Return JSON response for AJAX requests
+        if request.headers.get('X-Requested-With') == 'XMLHttpRequest' or request.accept_mimetypes.best == 'application/json':
+            return jsonify({'success': True, 'message': 'Account details updated successfully!'})
+
+        # Regular form submission with redirect
+        flash('Account details updated successfully!', 'success')
+
+        # Preserve the active tab when redirecting
+        if 'summary_prompt' in request.form:
+            return redirect(url_for('auth.account') + '#prompts')
+        else:
+            return redirect(url_for('auth.account'))
+
+    # Get admin default prompt from system settings
+    admin_default_prompt = SystemSetting.get_setting('admin_default_summary_prompt', None)
+    if admin_default_prompt:
+        default_summary_prompt_text = admin_default_prompt
+    else:
+        # Fallback to hardcoded default if admin hasn't set one
+        default_summary_prompt_text = """Generate a comprehensive summary that includes the following sections:
+- **Key Issues Discussed**: A bulleted list of the main topics
+- **Key Decisions Made**: A bulleted list of any decisions reached
+- **Action Items**: A bulleted list of tasks assigned, including who is responsible if mentioned"""
+
+    asr_diarize_locked = 'ASR_DIARIZE' in os.environ
+    ASR_DIARIZE = os.environ.get('ASR_DIARIZE', 'false').lower() == 'true'
+    USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+    USE_NEW_TRANSCRIPTION_ARCHITECTURE = os.environ.get('USE_NEW_TRANSCRIPTION_ARCHITECTURE', 'true').lower() == 'true'
+    ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+    ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+    ASR_RETURN_SPEAKER_EMBEDDINGS = os.environ.get('ASR_RETURN_SPEAKER_EMBEDDINGS', 'false').lower() == 'true'
+    ENABLE_AUTO_EXPORT = os.environ.get('ENABLE_AUTO_EXPORT', 'false').lower() == 'true'
+
+    # Get connector capabilities (new architecture)
+    connector_supports_diarization = USE_ASR_ENDPOINT  # Default to USE_ASR_ENDPOINT for backwards compat
+    connector_supports_hotwords = USE_ASR_ENDPOINT
+    connector_supports_initial_prompt = USE_ASR_ENDPOINT
+    if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+        try:
+            from src.services.transcription import get_registry
+            registry = get_registry()
+            connector = registry.get_active_connector()
+            if connector:
+                connector_supports_diarization = connector.supports_diarization
+                connector_supports_hotwords = connector.supports_hotwords
+                connector_supports_initial_prompt = connector.supports_initial_prompt
+        except Exception as e:
+            current_app.logger.warning(f"Could not get connector capabilities: {e}")
+
+    # Check if user is a team admin and get their admin groups
+    admin_memberships = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).all()
+
+    is_team_admin = len(admin_memberships) > 0
+
+    # Build list of groups where user is admin (for tag assignment)
+    user_admin_groups = []
+    for membership in admin_memberships:
+        if membership.group:
+            user_admin_groups.append({
+                'id': membership.group.id,
+                'name': membership.group.name
+            })
+
+    sso_config = get_sso_config()
+    sso_enabled = is_sso_enabled()
+    if sso_enabled:
+        init_sso_client(current_app)
+    sso_linked = bool(current_user.sso_subject)
+
+    password_login_disabled = sso_enabled and sso_config.get('disable_password_login', False)
+
+    # Check if admin has globally disabled auto-summarization
+    admin_setting = SystemSetting.get_setting('disable_auto_summarization', False)
+    admin_disabled_auto_summarization = admin_setting if isinstance(admin_setting, bool) else str(admin_setting).lower() == 'true'
+
+    # Get user's UI language preference
+    user_language = current_user.ui_language if current_user.ui_language else 'en'
+
+    return render_template('account.html',
+                           title='Account',
+                           default_summary_prompt_text=default_summary_prompt_text,
+                           use_asr_endpoint=USE_ASR_ENDPOINT,
+                           connector_supports_diarization=connector_supports_diarization,
+                           connector_supports_hotwords=connector_supports_hotwords,
+                           connector_supports_initial_prompt=connector_supports_initial_prompt,
+                           enable_auto_deletion=ENABLE_AUTO_DELETION,
+                           enable_internal_sharing=ENABLE_INTERNAL_SHARING,
+                           user_admin_groups=user_admin_groups,
+                           asr_diarize_locked=asr_diarize_locked,
+                           asr_diarize_env_value=ASR_DIARIZE,
+                           is_team_admin=is_team_admin,
+                           sso_enabled=sso_enabled,
+                           sso_provider_name=sso_config.get('provider_name', 'SSO'),
+                           sso_linked=sso_linked,
+                           sso_subject=current_user.sso_subject,
+                           has_password=bool(current_user.password),
+                           password_login_disabled=password_login_disabled,
+                           speaker_embeddings_enabled=ASR_RETURN_SPEAKER_EMBEDDINGS,
+                           auto_speaker_labelling=current_user.auto_speaker_labelling,
+                           auto_speaker_labelling_threshold=current_user.auto_speaker_labelling_threshold or 'medium',
+                           admin_disabled_auto_summarization=admin_disabled_auto_summarization,
+                           auto_summarization=current_user.auto_summarization if current_user.auto_summarization is not None else True,
+                           user_language=user_language,
+                           enable_auto_export=ENABLE_AUTO_EXPORT,
+                           enable_auto_processing=os.environ.get('ENABLE_AUTO_PROCESSING', 'false').lower() == 'true')
+
+
+@auth_bp.route('/api/user/auto-speaker-labelling', methods=['POST'])
+@login_required
+def update_auto_speaker_labelling():
+    """Update user's auto speaker labelling settings."""
+    data = request.get_json()
+
+    if data is None:
+        return jsonify({'success': False, 'error': 'Invalid JSON'}), 400
+
+    # Update enabled state
+    if 'enabled' in data:
+        current_user.auto_speaker_labelling = bool(data['enabled'])
+
+    # Update threshold (validate value)
+    if 'threshold' in data:
+        threshold = data['threshold']
+        if threshold in ('low', 'medium', 'high'):
+            current_user.auto_speaker_labelling_threshold = threshold
+        else:
+            return jsonify({'success': False, 'error': 'Invalid threshold value'}), 400
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'auto_speaker_labelling': current_user.auto_speaker_labelling,
+        'auto_speaker_labelling_threshold': current_user.auto_speaker_labelling_threshold
+    })
+
+
+@auth_bp.route('/api/user/auto-summarization', methods=['POST'])
+@login_required
+def update_auto_summarization():
+    """Update user's auto summarization setting."""
+    data = request.get_json()
+
+    if data is None:
+        return jsonify({'success': False, 'error': 'Invalid JSON'}), 400
+
+    if 'enabled' in data:
+        current_user.auto_summarization = bool(data['enabled'])
+        db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'auto_summarization': current_user.auto_summarization
+    })
+
+
+@auth_bp.route('/change_password', methods=['POST'])
+@login_required
+@rate_limit("10 per minute")
+def change_password():
+    # Check if password management is disabled for non-admins
+    sso_config = get_sso_config()
+    password_login_disabled = is_sso_enabled() and sso_config.get('disable_password_login', False)
+    if password_login_disabled and not current_user.is_admin:
+        flash('Password management is disabled. Please use SSO to sign in.', 'warning')
+        return redirect(url_for('auth.account'))
+
+    current_password = request.form.get('current_password')
+    new_password = request.form.get('new_password')
+    confirm_password = request.form.get('confirm_password')
+
+    # Check if user has an existing password
+    has_existing_password = bool(current_user.password)
+
+    # Validate form data - current password only required if user has one
+    if has_existing_password and not current_password:
+        flash('Current password is required.', 'danger')
+        return redirect(url_for('auth.account'))
+
+    if not new_password or not confirm_password:
+        flash('New password and confirmation are required.', 'danger')
+        return redirect(url_for('auth.account'))
+
+    if new_password != confirm_password:
+        flash('New password and confirmation do not match.', 'danger')
+        return redirect(url_for('auth.account'))
+
+    # Custom validation for new password
+    try:
+        password_check(None, type('obj', (object,), {'data': new_password}))
+    except ValidationError as e:
+        flash(str(e), 'danger')
+        return redirect(url_for('auth.account'))
+
+    # Verify current password only if user has one
+    if has_existing_password:
+        if not bcrypt.check_password_hash(current_user.password, current_password):
+            flash('Current password is incorrect.', 'danger')
+            return redirect(url_for('auth.account'))
+
+    # Update password
+    hashed_password = bcrypt.generate_password_hash(new_password).decode('utf-8')
+    current_user.password = hashed_password
+    db.session.commit()
+
+    flash('Your password has been updated!', 'success')
+    return redirect(url_for('auth.account'))
+
+
+@auth_bp.route('/docs/transcript-templates-guide')
+def transcript_templates_guide():
+    """Serve the transcript templates documentation."""
+    from flask import current_app
+
+    docs_path = os.path.join(current_app.root_path, '..', 'docs', 'transcript-templates-guide.md')
+
+    if not os.path.exists(docs_path):
+        return "Documentation not found", 404
+
+    with open(docs_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+
+    # Convert markdown to HTML
+    html_content = markdown.markdown(content, extensions=['tables', 'fenced_code', 'codehilite'])
+
+    # Wrap in basic HTML template with Speakr styling
+    html_template = f'''
+    <!DOCTYPE html>
+    <html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Transcript Templates Guide - Speakr</title>
+        <link rel="stylesheet" href="/static/css/output.css">
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
+        <style>
+            .markdown-body {{
+                max-width: 900px;
+                margin: 0 auto;
+                padding: 2rem;
+                line-height: 1.6;
+            }}
+            .markdown-body h1 {{ font-size: 2.5rem; margin-bottom: 1rem; }}
+            .markdown-body h2 {{ font-size: 2rem; margin-top: 2rem; margin-bottom: 1rem; }}
+            .markdown-body h3 {{ font-size: 1.5rem; margin-top: 1.5rem; margin-bottom: 0.75rem; }}
+            .markdown-body pre {{ background: #f4f4f4; padding: 1rem; border-radius: 0.5rem; overflow-x: auto; }}
+            .markdown-body code {{ background: #f4f4f4; padding: 0.2rem 0.4rem; border-radius: 0.25rem; }}
+            .markdown-body pre code {{ background: none; padding: 0; }}
+            .markdown-body ul, .markdown-body ol {{ margin-left: 2rem; margin-bottom: 1rem; }}
+            .markdown-body li {{ margin-bottom: 0.5rem; }}
+            .markdown-body blockquote {{ border-left: 4px solid #ddd; padding-left: 1rem; margin: 1rem 0; }}
+            .markdown-body table {{ border-collapse: collapse; width: 100%; margin: 1rem 0; }}
+            .markdown-body th, .markdown-body td {{ border: 1px solid #ddd; padding: 0.5rem; }}
+            .markdown-body th {{ background: #f4f4f4; font-weight: bold; }}
+        </style>
+    </head>
+    <body>
+        <div class="markdown-body">
+            <a href="/" class="btn-primary" style="display: inline-block; margin-bottom: 1rem; padding: 0.5rem 1rem; background: #3b82f6; color: white; text-decoration: none; border-radius: 0.5rem;">← Back to App</a>
+            {html_content}
+        </div>
+    </body>
+    </html>
+    '''
+
+    return html_template
diff --git a/src/api/events.py b/src/api/events.py
new file mode 100644
index 00000000..57359951
--- /dev/null
+++ b/src/api/events.py
@@ -0,0 +1,173 @@
+"""
+Calendar event extraction and export.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app, make_response
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.services.calendar import generate_ics_content
+
+# Create blueprint
+events_bp = Blueprint('events', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_events_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@events_bp.route('/api/recording/<int:recording_id>/events', methods=['GET'])
+@login_required
+def get_recording_events(recording_id):
+    """Get all events extracted from a recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'Unauthorized'}), 403
+
+        events = Event.query.filter_by(recording_id=recording_id).all()
+        return jsonify({'events': [event.to_dict() for event in events]})
+
+    except Exception as e:
+        current_app.logger.error(f"Error fetching events for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@events_bp.route('/api/event/<int:event_id>/ics', methods=['GET'])
+@login_required
+def download_event_ics(event_id):
+    """Generate and download an ICS file for a single event."""
+    try:
+        event = db.session.get(Event, event_id)
+        if not event:
+            return jsonify({'error': 'Event not found'}), 404
+
+        # Check permissions through recording access
+        if not has_recording_access(event.recording, current_user):
+            return jsonify({'error': 'Unauthorized'}), 403
+
+        # Generate ICS content
+        ics_content = generate_ics_content(event)
+
+        # Create response with ICS file
+        response = make_response(ics_content)
+        response.headers['Content-Type'] = 'text/calendar; charset=utf-8'
+        response.headers['Content-Disposition'] = f'attachment; filename="{secure_filename(event.title)}.ics"'
+
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating ICS for event {event_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@events_bp.route('/api/recording/<int:recording_id>/events/ics', methods=['GET'])
+@login_required
+def download_all_events_ics(recording_id):
+    """Generate and download an ICS file containing all events from a recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'Unauthorized'}), 403
+
+        # Get all events for this recording
+        events = Event.query.filter_by(recording_id=recording_id).all()
+        if not events:
+            return jsonify({'error': 'No events found for this recording'}), 404
+
+        # Generate combined ICS content
+        ics_lines = []
+        ics_lines.append("BEGIN:VCALENDAR")
+        ics_lines.append("VERSION:2.0")
+        ics_lines.append("PRODID:-//Speakr//Event Export//EN")
+        ics_lines.append("CALSCALE:GREGORIAN")
+        ics_lines.append("METHOD:PUBLISH")
+
+        # Add each event
+        for event in events:
+            # Get the individual event's ICS content and extract just the VEVENT portion
+            individual_ics = generate_ics_content(event)
+            # Extract VEVENT block from individual ICS
+            lines = individual_ics.split('\n')
+            in_event = False
+            for line in lines:
+                if line.startswith('BEGIN:VEVENT'):
+                    in_event = True
+                if in_event:
+                    ics_lines.append(line)
+                if line.startswith('END:VEVENT'):
+                    in_event = False
+
+        ics_lines.append("END:VCALENDAR")
+        ics_content = '\r\n'.join(ics_lines)
+
+        # Create response with ICS file
+        response = make_response(ics_content)
+        response.headers['Content-Type'] = 'text/calendar; charset=utf-8'
+        safe_title = secure_filename(recording.title) if recording.title else f'recording-{recording_id}'
+        response.headers['Content-Disposition'] = f'attachment; filename="{safe_title}-events.ics"'
+
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating ICS for all events in recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@events_bp.route('/api/event/<int:event_id>', methods=['DELETE'])
+@login_required
+def delete_event(event_id):
+    """Delete a single event."""
+    try:
+        event = db.session.get(Event, event_id)
+        if not event:
+            return jsonify({'error': 'Event not found'}), 404
+
+        # Check permissions through recording access
+        if not has_recording_access(event.recording, current_user):
+            return jsonify({'error': 'Unauthorized'}), 403
+
+        db.session.delete(event)
+        db.session.commit()
+
+        return jsonify({'success': True})
+
+    except Exception as e:
+        current_app.logger.error(f"Error deleting event {event_id}: {e}")
+        db.session.rollback()
+        return jsonify({'error': str(e)}), 500
+
+
diff --git a/src/api/export_templates.py b/src/api/export_templates.py
new file mode 100644
index 00000000..aa35374b
--- /dev/null
+++ b/src/api/export_templates.py
@@ -0,0 +1,162 @@
+"""
+Export template management API.
+
+This blueprint provides CRUD operations for export templates,
+following the same pattern as transcript templates.
+"""
+
+import os
+from datetime import datetime
+from flask import Blueprint, request, jsonify, current_app
+from flask_login import login_required, current_user
+
+from src.database import db
+from src.models import ExportTemplate
+
+# Create blueprint
+export_templates_bp = Blueprint('export_templates', __name__)
+
+# Configuration from environment
+ENABLE_AUTO_EXPORT = os.environ.get('ENABLE_AUTO_EXPORT', 'false').lower() == 'true'
+
+
+# --- Routes ---
+
+@export_templates_bp.route('/api/export-templates', methods=['GET'])
+@login_required
+def get_export_templates():
+    """Get all export templates for the current user."""
+    templates = ExportTemplate.query.filter_by(user_id=current_user.id).all()
+    return jsonify([template.to_dict() for template in templates])
+
+
+@export_templates_bp.route('/api/export-templates', methods=['POST'])
+@login_required
+def create_export_template():
+    """Create a new export template."""
+    data = request.json
+    if not data or not data.get('name') or not data.get('template'):
+        return jsonify({'error': 'Name and template are required'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        ExportTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template = ExportTemplate(
+        user_id=current_user.id,
+        name=data['name'],
+        template=data['template'],
+        description=data.get('description'),
+        is_default=data.get('is_default', False)
+    )
+
+    db.session.add(template)
+    db.session.commit()
+
+    return jsonify(template.to_dict()), 201
+
+
+@export_templates_bp.route('/api/export-templates/<int:template_id>', methods=['PUT'])
+@login_required
+def update_export_template(template_id):
+    """Update an existing export template."""
+    template = ExportTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        ExportTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template.name = data.get('name', template.name)
+    template.template = data.get('template', template.template)
+    template.description = data.get('description', template.description)
+    template.is_default = data.get('is_default', template.is_default)
+    template.updated_at = datetime.utcnow()
+
+    db.session.commit()
+
+    return jsonify(template.to_dict())
+
+
+@export_templates_bp.route('/api/export-templates/<int:template_id>', methods=['DELETE'])
+@login_required
+def delete_export_template(template_id):
+    """Delete an export template."""
+    template = ExportTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    db.session.delete(template)
+    db.session.commit()
+
+    return jsonify({'success': True})
+
+
+@export_templates_bp.route('/api/export-templates/create-defaults', methods=['POST'])
+@login_required
+def create_default_export_templates():
+    """Create default export template for the user if they don't have any."""
+    existing_templates = ExportTemplate.query.filter_by(user_id=current_user.id).count()
+
+    if existing_templates > 0:
+        return jsonify({'message': 'User already has templates'}), 200
+
+    # Default template with localized labels
+    default_template = ExportTemplate(
+        user_id=current_user.id,
+        name="Standard Export",
+        template="""# {{title}}
+
+## {{label.metadata}}
+
+{{#if meeting_date}}- **{{label.date}}:** {{meeting_date}}
+{{/if}}{{#if created_at}}- **{{label.created}}:** {{created_at}}
+{{/if}}{{#if original_filename}}- **{{label.originalFile}}:** {{original_filename}}
+{{/if}}{{#if file_size}}- **{{label.fileSize}}:** {{file_size}}
+{{/if}}{{#if participants}}- **{{label.participants}}:** {{participants}}
+{{/if}}{{#if tags}}- **{{label.tags}}:** {{tags}}
+{{/if}}
+
+{{#if notes}}## {{label.notes}}
+
+{{notes}}
+
+{{/if}}{{#if summary}}## {{label.summary}}
+
+{{summary}}
+
+{{/if}}{{#if transcription}}## {{label.transcription}}
+
+{{transcription}}
+
+{{/if}}""",
+        description="Default export template with localized labels",
+        is_default=True
+    )
+
+    db.session.add(default_template)
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'templates': [default_template.to_dict()]
+    }), 201
diff --git a/src/api/folders.py b/src/api/folders.py
new file mode 100644
index 00000000..296aa99a
--- /dev/null
+++ b/src/api/folders.py
@@ -0,0 +1,667 @@
+"""
+Folder management and assignment.
+
+This blueprint handles folder CRUD operations and recording-folder assignments.
+Folders are one-to-many (a recording can only belong to one folder).
+"""
+
+import os
+from datetime import datetime
+from flask import Blueprint, request, jsonify, current_app
+from flask_login import login_required, current_user
+
+from sqlalchemy.exc import IntegrityError
+
+from src.database import db
+from src.models import *
+
+# Create blueprint
+folders_bp = Blueprint('folders', __name__)
+
+# Configuration from environment
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+
+def init_folders_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@folders_bp.route('/api/folders', methods=['GET'])
+@login_required
+def get_folders():
+    """Get all folders for the current user, including group folders they have access to."""
+    # Check if folders feature is enabled - return empty array if not
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify([])
+
+    # Get user's personal folders
+    user_folders = Folder.query.filter_by(user_id=current_user.id, group_id=None).order_by(Folder.name).all()
+
+    # Get user's team memberships with roles
+    memberships = GroupMembership.query.filter_by(user_id=current_user.id).all()
+    team_roles = {m.group_id: m.role for m in memberships}
+    team_ids = list(team_roles.keys())
+
+    # Get group folders for all teams the user is a member of
+    team_folders = []
+    if team_ids:
+        team_folders = Folder.query.filter(Folder.group_id.in_(team_ids)).order_by(Folder.name).all()
+
+    # Build response with edit permissions
+    result = []
+
+    # Personal folders - user can always edit their own
+    for folder in user_folders:
+        folder_dict = folder.to_dict()
+        folder_dict['can_edit'] = True
+        folder_dict['user_role'] = None
+        result.append(folder_dict)
+
+    # Group folders - only admins can edit
+    for folder in team_folders:
+        folder_dict = folder.to_dict()
+        user_role = team_roles.get(folder.group_id, 'member')
+        folder_dict['can_edit'] = (user_role == 'admin')
+        folder_dict['user_role'] = user_role
+        result.append(folder_dict)
+
+    return jsonify(result)
+
+
+@folders_bp.route('/api/folders', methods=['POST'])
+@login_required
+def create_folder():
+    """Create a new folder (personal or group folder)."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    data = request.get_json()
+
+    if not data or not data.get('name'):
+        return jsonify({'error': 'Folder name is required'}), 400
+
+    group_id = data.get('group_id')
+
+    # If creating a group folder, verify user is admin of that group
+    if group_id:
+        membership = GroupMembership.query.filter_by(
+            group_id=group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can create group folders'}), 403
+
+        # Check if group folder with same name already exists for this group
+        existing_folder = Folder.query.filter_by(name=data['name'], group_id=group_id).first()
+        if existing_folder:
+            return jsonify({'error': 'A folder with this name already exists for this group'}), 400
+    else:
+        # Check if personal folder with same name already exists for this user
+        existing_folder = Folder.query.filter_by(name=data['name'], user_id=current_user.id, group_id=None).first()
+        if existing_folder:
+            return jsonify({'error': 'Folder with this name already exists'}), 400
+
+    # Handle retention_days: -1 means protected from deletion
+    retention_days = data.get('retention_days')
+    protect_from_deletion = False
+
+    if retention_days == -1:
+        # -1 indicates infinite retention (protected from auto-deletion)
+        protect_from_deletion = True if ENABLE_AUTO_DELETION else False
+
+    # Validate naming_template_id if provided
+    naming_template_id = data.get('naming_template_id')
+    if naming_template_id:
+        template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Naming template not found'}), 404
+
+    # Validate export_template_id if provided
+    export_template_id = data.get('export_template_id')
+    if export_template_id:
+        template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Export template not found'}), 404
+
+    folder = Folder(
+        name=data['name'],
+        user_id=current_user.id,
+        group_id=group_id,
+        color=data.get('color', '#10B981'),
+        custom_prompt=data.get('custom_prompt'),
+        default_language=data.get('default_language'),
+        default_min_speakers=data.get('default_min_speakers'),
+        default_max_speakers=data.get('default_max_speakers'),
+        default_hotwords=data.get('default_hotwords'),
+        default_initial_prompt=data.get('default_initial_prompt'),
+        default_transcription_model=data.get('default_transcription_model'),
+        protect_from_deletion=protect_from_deletion,
+        retention_days=retention_days,
+        auto_share_on_apply=data.get('auto_share_on_apply', True) if group_id else True,
+        share_with_group_lead=data.get('share_with_group_lead', True) if group_id else True,
+        naming_template_id=naming_template_id,
+        export_template_id=export_template_id
+    )
+
+    db.session.add(folder)
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Folder creation failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A folder with this name already exists'}), 400
+
+    return jsonify(folder.to_dict()), 201
+
+
+@folders_bp.route('/api/folders/<int:folder_id>', methods=['PUT'])
+@login_required
+def update_folder(folder_id):
+    """Update a folder."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    folder = db.session.get(Folder, folder_id)
+    if not folder:
+        return jsonify({'error': 'Folder not found'}), 404
+
+    # Check permissions
+    if folder.group_id:
+        # Group folder - user must be a team admin
+        membership = GroupMembership.query.filter_by(
+            group_id=folder.group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can edit group folders'}), 403
+    else:
+        # Personal folder - must be the owner
+        if folder.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to edit this folder'}), 403
+
+    data = request.get_json()
+
+    if 'name' in data:
+        # Check if new name conflicts with another folder
+        if folder.group_id:
+            existing_folder = Folder.query.filter_by(name=data['name'], group_id=folder.group_id).filter(Folder.id != folder_id).first()
+        else:
+            existing_folder = Folder.query.filter_by(name=data['name'], user_id=current_user.id).filter(Folder.id != folder_id).first()
+
+        if existing_folder:
+            return jsonify({'error': 'Another folder with this name already exists'}), 400
+        folder.name = data['name']
+
+    # Handle group_id changes (converting between personal and group folders)
+    if 'group_id' in data:
+        new_group_id = data['group_id'] if data['group_id'] else None
+
+        # If changing to a group folder, verify user is admin of that group
+        if new_group_id:
+            membership = GroupMembership.query.filter_by(
+                group_id=new_group_id,
+                user_id=current_user.id
+            ).first()
+
+            if not membership or membership.role != 'admin':
+                return jsonify({'error': 'Only group admins can assign folders to groups'}), 403
+
+        folder.group_id = new_group_id
+
+    if 'color' in data:
+        folder.color = data['color']
+    if 'custom_prompt' in data:
+        folder.custom_prompt = data['custom_prompt']
+    if 'default_language' in data:
+        folder.default_language = data['default_language']
+    if 'default_min_speakers' in data:
+        folder.default_min_speakers = data['default_min_speakers']
+    if 'default_max_speakers' in data:
+        folder.default_max_speakers = data['default_max_speakers']
+    if 'default_hotwords' in data:
+        folder.default_hotwords = data['default_hotwords'] or None
+    if 'default_initial_prompt' in data:
+        folder.default_initial_prompt = data['default_initial_prompt'] or None
+    if 'default_transcription_model' in data:
+        folder.default_transcription_model = data['default_transcription_model'] or None
+
+    # Handle retention_days: -1 means protected from deletion
+    if 'retention_days' in data:
+        retention_days = data['retention_days']
+
+        if retention_days == -1:
+            # -1 indicates infinite retention (protected from auto-deletion)
+            if ENABLE_AUTO_DELETION:
+                folder.protect_from_deletion = True
+                folder.retention_days = -1
+        else:
+            # Regular retention period or null (use global)
+            folder.protect_from_deletion = False
+            folder.retention_days = retention_days if retention_days else None
+    if 'auto_share_on_apply' in data:
+        # Only applicable to group folders
+        if folder.group_id:
+            folder.auto_share_on_apply = bool(data['auto_share_on_apply'])
+    if 'share_with_group_lead' in data:
+        # Only applicable to group folders
+        if folder.group_id:
+            folder.share_with_group_lead = bool(data['share_with_group_lead'])
+    if 'naming_template_id' in data:
+        naming_template_id = data['naming_template_id']
+        if naming_template_id:
+            template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+            if not template:
+                return jsonify({'error': 'Naming template not found'}), 404
+        folder.naming_template_id = naming_template_id if naming_template_id else None
+    if 'export_template_id' in data:
+        export_template_id = data['export_template_id']
+        if export_template_id:
+            template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+            if not template:
+                return jsonify({'error': 'Export template not found'}), 404
+        folder.export_template_id = export_template_id if export_template_id else None
+
+    folder.updated_at = datetime.utcnow()
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Folder update failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A folder with this name already exists'}), 400
+
+    return jsonify(folder.to_dict())
+
+
+@folders_bp.route('/api/folders/<int:folder_id>', methods=['DELETE'])
+@login_required
+def delete_folder(folder_id):
+    """Delete a folder. Recordings in this folder will have folder_id set to NULL."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    folder = db.session.get(Folder, folder_id)
+    if not folder:
+        return jsonify({'error': 'Folder not found'}), 404
+
+    # Check permissions
+    if folder.group_id:
+        # Group folder - user must be a team admin
+        membership = GroupMembership.query.filter_by(
+            group_id=folder.group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can delete group folders'}), 403
+    else:
+        # Personal folder - must belong to the user
+        if folder.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to delete this folder'}), 403
+
+    # Recordings in this folder will have folder_id set to NULL via ondelete='SET NULL'
+    db.session.delete(folder)
+    db.session.commit()
+    return jsonify({'success': True})
+
+
+@folders_bp.route('/api/groups/<int:group_id>/folders', methods=['POST'])
+@login_required
+def create_group_folder(group_id):
+    """Create a group-scoped folder (group admins only)."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Group folders require internal sharing to be enabled. Please set ENABLE_INTERNAL_SHARING=true in your configuration.'}), 403
+
+    # Verify team exists
+    team = db.session.get(Group, group_id)
+    if not team:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Verify user is a team admin
+    membership = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id
+    ).first()
+
+    if not membership or membership.role != 'admin':
+        return jsonify({'error': 'Only group admins can create group folders'}), 403
+
+    data = request.get_json()
+    name = data.get('name', '').strip()
+
+    if not name:
+        return jsonify({'error': 'Folder name is required'}), 400
+
+    # Check if a group folder with this name already exists for this team
+    existing_folder = Folder.query.filter_by(
+        name=name,
+        group_id=group_id
+    ).first()
+
+    if existing_folder:
+        return jsonify({'error': 'A group folder with this name already exists'}), 400
+
+    # Validate naming_template_id if provided
+    naming_template_id = data.get('naming_template_id')
+    if naming_template_id:
+        template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Naming template not found'}), 404
+
+    # Validate export_template_id if provided
+    export_template_id = data.get('export_template_id')
+    if export_template_id:
+        template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Export template not found'}), 404
+
+    # Create the group folder with all supported parameters
+    folder = Folder(
+        name=name,
+        user_id=current_user.id,  # Creator
+        group_id=group_id,
+        color=data.get('color', '#10B981'),
+        custom_prompt=data.get('custom_prompt'),
+        default_language=data.get('default_language'),
+        default_min_speakers=data.get('default_min_speakers'),
+        default_max_speakers=data.get('default_max_speakers'),
+        default_hotwords=data.get('default_hotwords'),
+        default_initial_prompt=data.get('default_initial_prompt'),
+        default_transcription_model=data.get('default_transcription_model'),
+        protect_from_deletion=data.get('protect_from_deletion', False),
+        retention_days=data.get('retention_days'),
+        auto_share_on_apply=data.get('auto_share_on_apply', True),  # Default to True for group folders
+        share_with_group_lead=data.get('share_with_group_lead', True),  # Default to True for group folders
+        naming_template_id=naming_template_id,
+        export_template_id=export_template_id
+    )
+
+    db.session.add(folder)
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Folder creation failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A folder with this name already exists'}), 400
+
+    return jsonify(folder.to_dict()), 201
+
+
+@folders_bp.route('/api/groups/<int:group_id>/folders', methods=['GET'])
+@login_required
+def get_group_folders(group_id):
+    """Get all folders for a team (team members only)."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    # Verify team exists
+    team = db.session.get(Group, group_id)
+    if not team:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Verify user is a team member
+    membership = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id
+    ).first()
+
+    if not membership:
+        return jsonify({'error': 'You must be a team member to view group folders'}), 403
+
+    # Get all group folders
+    folders = Folder.query.filter_by(group_id=group_id).all()
+
+    return jsonify({'folders': [folder.to_dict() for folder in folders]})
+
+
+@folders_bp.route('/api/recordings/<int:recording_id>/folder', methods=['PUT'])
+@login_required
+def assign_recording_folder(recording_id):
+    """Assign a recording to a folder (or move to a different folder)."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    # Check access to recording (require edit permission)
+    if has_recording_access:
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+    else:
+        # Fallback: only owner can assign folder
+        if recording.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+
+    data = request.get_json()
+    folder_id = data.get('folder_id')
+
+    if folder_id:
+        # Verify folder exists and user has access
+        folder = db.session.get(Folder, folder_id)
+        if not folder:
+            return jsonify({'error': 'Folder not found'}), 404
+
+        # Check if user can use this folder
+        if folder.group_id:
+            # Group folder - user must be a member
+            membership = GroupMembership.query.filter_by(
+                group_id=folder.group_id,
+                user_id=current_user.id
+            ).first()
+            if not membership:
+                return jsonify({'error': 'You do not have access to this folder'}), 403
+        else:
+            # Personal folder - must be owner
+            if folder.user_id != current_user.id:
+                return jsonify({'error': 'You do not have access to this folder'}), 403
+
+        # Handle auto-sharing for group folders
+        old_folder_id = recording.folder_id
+        recording.folder_id = folder_id
+
+        # Apply auto-shares if moving to a group folder
+        if folder.group_id and (folder.auto_share_on_apply or folder.share_with_group_lead):
+            _apply_folder_auto_shares(recording, folder)
+
+        db.session.commit()
+        current_app.logger.info(f"Recording {recording_id} moved to folder {folder_id} by user {current_user.id}")
+    else:
+        # Remove from folder
+        recording.folder_id = None
+        db.session.commit()
+        current_app.logger.info(f"Recording {recording_id} removed from folder by user {current_user.id}")
+
+    return jsonify(recording.to_dict(include_html=False, viewer_user=current_user))
+
+
+@folders_bp.route('/api/recordings/<int:recording_id>/folder', methods=['DELETE'])
+@login_required
+def remove_recording_folder(recording_id):
+    """Remove a recording from its folder."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    # Check access to recording (require edit permission)
+    if has_recording_access:
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+    else:
+        # Fallback: only owner can remove folder
+        if recording.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+
+    recording.folder_id = None
+    db.session.commit()
+    current_app.logger.info(f"Recording {recording_id} removed from folder by user {current_user.id}")
+
+    return jsonify({'success': True})
+
+
+@folders_bp.route('/api/recordings/bulk/folder', methods=['POST'])
+@login_required
+def bulk_assign_folder():
+    """Assign multiple recordings to a folder."""
+    # Check if folders feature is enabled
+    folders_enabled = SystemSetting.get_setting('enable_folders', False)
+    if not folders_enabled:
+        return jsonify({'error': 'Folders feature is not enabled'}), 403
+
+    data = request.get_json()
+    recording_ids = data.get('recording_ids', [])
+    folder_id = data.get('folder_id')  # Can be None to remove from folder
+
+    if not recording_ids:
+        return jsonify({'error': 'No recordings specified'}), 400
+
+    # Verify folder if specified
+    folder = None
+    if folder_id:
+        folder = db.session.get(Folder, folder_id)
+        if not folder:
+            return jsonify({'error': 'Folder not found'}), 404
+
+        # Check if user can use this folder
+        if folder.group_id:
+            membership = GroupMembership.query.filter_by(
+                group_id=folder.group_id,
+                user_id=current_user.id
+            ).first()
+            if not membership:
+                return jsonify({'error': 'You do not have access to this folder'}), 403
+        else:
+            if folder.user_id != current_user.id:
+                return jsonify({'error': 'You do not have access to this folder'}), 403
+
+    updated_count = 0
+    for rec_id in recording_ids:
+        recording = db.session.get(Recording, rec_id)
+        if not recording:
+            continue
+
+        # Check access (require edit permission)
+        if has_recording_access:
+            if not has_recording_access(recording, current_user, require_edit=True):
+                continue
+        else:
+            if recording.user_id != current_user.id:
+                continue
+
+        recording.folder_id = folder_id
+
+        # Apply auto-shares if moving to a group folder
+        if folder and folder.group_id and (folder.auto_share_on_apply or folder.share_with_group_lead):
+            _apply_folder_auto_shares(recording, folder)
+
+        updated_count += 1
+
+    db.session.commit()
+    action = f"moved to folder {folder_id}" if folder_id else "removed from folder"
+    current_app.logger.info(f"Bulk folder update: {updated_count} recordings {action} by user {current_user.id}")
+
+    return jsonify({'success': True, 'updated_count': updated_count})
+
+
+def _apply_folder_auto_shares(recording, folder):
+    """
+    Apply auto-shares for a group folder when a recording is assigned to it.
+
+    Args:
+        recording: Recording being assigned to the folder
+        folder: Folder with auto-share settings
+    """
+    if not ENABLE_INTERNAL_SHARING:
+        return
+
+    if not folder.group_id:
+        return
+
+    # Determine who to share with
+    if folder.auto_share_on_apply:
+        group_members = GroupMembership.query.filter_by(group_id=folder.group_id).all()
+    elif folder.share_with_group_lead:
+        group_members = GroupMembership.query.filter_by(group_id=folder.group_id, role='admin').all()
+    else:
+        return
+
+    shares_created = 0
+
+    for membership in group_members:
+        # Skip the recording owner
+        if membership.user_id == recording.user_id:
+            continue
+
+        # Check if already shared
+        existing_share = InternalShare.query.filter_by(
+            recording_id=recording.id,
+            shared_with_user_id=membership.user_id
+        ).first()
+
+        if not existing_share:
+            # Create internal share with correct permissions
+            share = InternalShare(
+                recording_id=recording.id,
+                owner_id=recording.user_id,
+                shared_with_user_id=membership.user_id,
+                can_edit=(membership.role == 'admin'),
+                can_reshare=False,
+                source_type='group_folder',
+                source_tag_id=None  # We don't use this field for folders
+            )
+            db.session.add(share)
+
+            # Create SharedRecordingState with default values for the recipient
+            state = SharedRecordingState(
+                recording_id=recording.id,
+                user_id=membership.user_id,
+                is_inbox=True,
+                is_highlighted=False
+            )
+            db.session.add(state)
+
+            shares_created += 1
+            current_app.logger.info(f"Auto-shared recording {recording.id} with user {membership.user_id} via group folder '{folder.name}'")
+
+    if shares_created > 0:
+        current_app.logger.info(f"Created {shares_created} auto-shares for recording {recording.id} via folder assignment")
diff --git a/src/api/groups.py b/src/api/groups.py
new file mode 100644
index 00000000..2eed5670
--- /dev/null
+++ b/src/api/groups.py
@@ -0,0 +1,394 @@
+"""
+Group management and collaboration.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import re
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+
+# Create blueprint
+groups_bp = Blueprint('groups', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_groups_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@groups_bp.route('/api/groups/<int:group_id>/sync-shares', methods=['POST'])
+@login_required
+def sync_team_tag_shares(group_id):
+    """Retroactively share recordings with group members based on group tags with auto-sharing enabled."""
+    # Verify group exists
+    group = db.session.get(Group, group_id)
+    if not group:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Verify user is a group admin
+    membership = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first()
+
+    if not membership:
+        return jsonify({'error': 'Only group admins can sync shares'}), 403
+
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    # Get all group tags with auto-sharing enabled
+    group_tags = Tag.query.filter(
+        Tag.group_id == group_id,
+        db.or_(
+            Tag.auto_share_on_apply == True,
+            Tag.share_with_group_lead == True
+        )
+    ).all()
+
+    shares_created = 0
+    recordings_processed = 0
+
+    for tag in group_tags:
+        # Get all completed recordings with this tag
+        recordings = db.session.query(Recording).join(RecordingTag).filter(
+            RecordingTag.tag_id == tag.id,
+            Recording.status == 'COMPLETED'
+        ).all()
+
+        for recording in recordings:
+            recordings_processed += 1
+
+            # Determine who to share with
+            if tag.auto_share_on_apply:
+                group_members = GroupMembership.query.filter_by(group_id=group_id).all()
+            elif tag.share_with_group_lead:
+                group_members = GroupMembership.query.filter_by(group_id=group_id, role='admin').all()
+            else:
+                continue
+
+            for membership_to_share in group_members:
+                # Skip the recording owner
+                if membership_to_share.user_id == recording.user_id:
+                    continue
+
+                # Check if already shared
+                existing_share = InternalShare.query.filter_by(
+                    recording_id=recording.id,
+                    shared_with_user_id=membership_to_share.user_id
+                ).first()
+
+                if not existing_share:
+                    # Create internal share with correct permissions
+                    # Group admins get edit permission, regular members get read-only
+                    share = InternalShare(
+                        recording_id=recording.id,
+                        owner_id=recording.user_id,
+                        shared_with_user_id=membership_to_share.user_id,
+                        can_edit=(membership_to_share.role == 'admin'),
+                        can_reshare=False,
+                        source_type='group_tag',
+                        source_tag_id=tag.id
+                    )
+                    db.session.add(share)
+
+                    # Create SharedRecordingState with default values for the recipient
+                    state = SharedRecordingState(
+                        recording_id=recording.id,
+                        user_id=membership_to_share.user_id,
+                        is_inbox=True,  # New shares appear in inbox by default
+                        is_highlighted=False  # Not favorited by default
+                    )
+                    db.session.add(state)
+
+                    shares_created += 1
+                    current_app.logger.info(f"Synced share: Recording {recording.id} with user {membership_to_share.user_id} (role={membership_to_share.role}) via group tag '{tag.name}'")
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'shares_created': shares_created,
+        'recordings_processed': recordings_processed,
+        'message': f'Created {shares_created} new shares across {recordings_processed} recordings'
+    })
+
+
+
+@groups_bp.route('/api/admin/groups', methods=['GET'])
+@login_required
+def get_teams():
+    """Get all groups (admin) or groups user is admin of (group admin)."""
+    # Check if user is admin OR group admin
+    is_group_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    # If full admin, return all groups; if group admin, return only their groups
+    if current_user.is_admin:
+        groups = Group.query.all()
+    else:
+        # Get groups where user is an admin
+        group_memberships = GroupMembership.query.filter_by(
+            user_id=current_user.id,
+            role='admin'
+        ).all()
+        groups = [m.group for m in group_memberships]
+
+    return jsonify({'groups': [group.to_dict() for group in groups]})
+
+
+
+@groups_bp.route('/api/admin/groups', methods=['POST'])
+@login_required
+def create_team():
+    """Create a new group (admin only)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Groups require internal sharing to be enabled. Please set ENABLE_INTERNAL_SHARING=true in your configuration.'}), 403
+
+    data = request.get_json()
+    name = data.get('name', '').strip()
+    description = data.get('description', '').strip()
+
+    if not name:
+        return jsonify({'error': 'Group name is required'}), 400
+
+    # Check if group name already exists
+    existing = Group.query.filter_by(name=name).first()
+    if existing:
+        return jsonify({'error': 'A group with this name already exists'}), 400
+
+    group = Group(name=name, description=description)
+    db.session.add(group)
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} created group: {name}")
+    return jsonify(group.to_dict()), 201
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>', methods=['GET'])
+@login_required
+def get_team(group_id):
+    """Get group details (admin or group admin)."""
+    group = db.session.get(Group, group_id)
+    if not group:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Check if user is admin OR admin of this specific group
+    is_group_admin = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    group_dict = group.to_dict()
+    group_dict['members'] = [m.to_dict() for m in group.memberships]
+    return jsonify(group_dict)
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>', methods=['PUT'])
+@login_required
+def update_team(group_id):
+    """Update group (admin or group admin)."""
+    group = db.session.get(Group, group_id)
+    if not group:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Check if user is admin OR admin of this specific group
+    is_group_admin = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    data = request.get_json()
+    name = data.get('name', '').strip()
+    description = data.get('description', '').strip()
+
+    if name:
+        # Check if new name conflicts with another group
+        existing = Group.query.filter(Group.name == name, Group.id != group_id).first()
+        if existing:
+            return jsonify({'error': 'A group with this name already exists'}), 400
+        group.name = name
+
+    group.description = description
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} updated group: {group.name}")
+    return jsonify(group.to_dict())
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>', methods=['DELETE'])
+@login_required
+def delete_team(group_id):
+    """Delete group (admin only)."""
+    if not current_user.is_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    group = db.session.get(Group, group_id)
+    if not group:
+        return jsonify({'error': 'Group not found'}), 404
+
+    group_name = group.name
+    db.session.delete(group)
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} deleted group: {group_name}")
+    return jsonify({'success': True})
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>/members', methods=['POST'])
+@login_required
+def add_team_member(group_id):
+    """Add a member to a group (admin or group admin)."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Groups require internal sharing to be enabled. Please set ENABLE_INTERNAL_SHARING=true in your configuration.'}), 403
+
+    group = db.session.get(Group, group_id)
+    if not group:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Check if user is admin OR admin of this specific group
+    is_group_admin = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    data = request.get_json()
+    user_id = data.get('user_id')
+    role = data.get('role', 'member')
+
+    if not user_id:
+        return jsonify({'error': 'User ID is required'}), 400
+
+    if role not in ['admin', 'member']:
+        return jsonify({'error': 'Role must be "admin" or "member"'}), 400
+
+    user = db.session.get(User, user_id)
+    if not user:
+        return jsonify({'error': 'User not found'}), 404
+
+    # Check if already a member
+    existing = GroupMembership.query.filter_by(group_id=group_id, user_id=user_id).first()
+    if existing:
+        return jsonify({'error': 'User is already a member of this group'}), 400
+
+    membership = GroupMembership(group_id=group_id, user_id=user_id, role=role)
+    db.session.add(membership)
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} added {user.username} to group {group.name} as {role}")
+    return jsonify(membership.to_dict()), 201
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>/members/<int:user_id>', methods=['PUT'])
+@login_required
+def update_team_member(group_id, user_id):
+    """Update group member role (admin or group admin)."""
+    membership = GroupMembership.query.filter_by(group_id=group_id, user_id=user_id).first()
+    if not membership:
+        return jsonify({'error': 'Membership not found'}), 404
+
+    # Check if user is admin OR admin of this specific group
+    is_group_admin = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    data = request.get_json()
+    role = data.get('role')
+
+    if role not in ['admin', 'member']:
+        return jsonify({'error': 'Role must be "admin" or "member"'}), 400
+
+    membership.role = role
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} updated {membership.user.username} role to {role} in group {membership.group.name}")
+    return jsonify(membership.to_dict())
+
+
+
+@groups_bp.route('/api/admin/groups/<int:group_id>/members/<int:user_id>', methods=['DELETE'])
+@login_required
+def remove_team_member(group_id, user_id):
+    """Remove a member from a group (admin or group admin)."""
+    membership = GroupMembership.query.filter_by(group_id=group_id, user_id=user_id).first()
+    if not membership:
+        return jsonify({'error': 'Membership not found'}), 404
+
+    # Check if user is admin OR admin of this specific group
+    is_group_admin = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    if not current_user.is_admin and not is_group_admin:
+        return jsonify({'error': 'Admin access required'}), 403
+
+    username = membership.user.username
+    group_name = membership.group.name
+    db.session.delete(membership)
+    db.session.commit()
+
+    current_app.logger.info(f"Admin {current_user.username} removed {username} from group {group_name}")
+    return jsonify({'success': True})
+
+
+
diff --git a/src/api/inquire.py b/src/api/inquire.py
new file mode 100644
index 00000000..440ad245
--- /dev/null
+++ b/src/api/inquire.py
@@ -0,0 +1,878 @@
+"""
+Semantic search and chat functionality.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import re
+import time
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.services.embeddings import get_accessible_recording_ids, semantic_search_chunks, EMBEDDINGS_AVAILABLE
+from src.services.llm import call_llm_completion, call_chat_completion, process_streaming_with_thinking, client, chat_client, TokenBudgetExceeded
+
+# Create blueprint
+inquire_bp = Blueprint('inquire', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_inquire_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@inquire_bp.route('/inquire')
+@login_required
+def inquire():
+    # Check if inquire mode is enabled
+    if not ENABLE_INQUIRE_MODE:
+        flash('Inquire mode is not enabled on this server.', 'warning')
+        return redirect(url_for('recordings.index'))
+
+    # Check if user is a group admin
+    is_team_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    # Render the inquire page with user context for theming
+    return render_template('inquire.html',
+                         use_asr_endpoint=USE_ASR_ENDPOINT,
+                         current_user=current_user,
+                         is_team_admin=is_team_admin)
+
+
+
+@inquire_bp.route('/api/inquire/sessions', methods=['GET'])
+@login_required
+def get_inquire_sessions():
+    """Get all inquire sessions for the current user."""
+    if not ENABLE_INQUIRE_MODE:
+        return jsonify({'error': 'Inquire mode is not enabled'}), 403
+    try:
+        sessions = InquireSession.query.filter_by(user_id=current_user.id).order_by(InquireSession.last_used.desc()).all()
+        return jsonify([session.to_dict() for session in sessions])
+    except Exception as e:
+        current_app.logger.error(f"Error getting inquire sessions: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@inquire_bp.route('/api/inquire/sessions', methods=['POST'])
+@login_required
+def create_inquire_session():
+    """Create a new inquire session with filters."""
+    if not ENABLE_INQUIRE_MODE:
+        return jsonify({'error': 'Inquire mode is not enabled'}), 403
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+        
+        session = InquireSession(
+            user_id=current_user.id,
+            session_name=data.get('session_name'),
+            filter_tags=json.dumps(data.get('filter_tags', [])),
+            filter_speakers=json.dumps(data.get('filter_speakers', [])),
+            filter_date_from=datetime.fromisoformat(data['filter_date_from']).date() if data.get('filter_date_from') else None,
+            filter_date_to=datetime.fromisoformat(data['filter_date_to']).date() if data.get('filter_date_to') else None,
+            filter_recording_ids=json.dumps(data.get('filter_recording_ids', []))
+        )
+        
+        db.session.add(session)
+        db.session.commit()
+        
+        return jsonify(session.to_dict()), 201
+        
+    except Exception as e:
+        current_app.logger.error(f"Error creating inquire session: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@inquire_bp.route('/api/inquire/search', methods=['POST'])
+@login_required
+def inquire_search():
+    """Perform semantic search within filtered transcriptions."""
+    if not ENABLE_INQUIRE_MODE:
+        return jsonify({'error': 'Inquire mode is not enabled'}), 403
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+        
+        query = data.get('query')
+        if not query:
+            return jsonify({'error': 'No query provided'}), 400
+        
+        # Build filters from request
+        filters = {}
+        if data.get('filter_tags'):
+            filters['tag_ids'] = data['filter_tags']
+        if data.get('filter_speakers'):
+            filters['speaker_names'] = data['filter_speakers']
+        if data.get('filter_recording_ids'):
+            filters['recording_ids'] = data['filter_recording_ids']
+        if data.get('filter_date_from'):
+            filters['date_from'] = datetime.fromisoformat(data['filter_date_from']).date()
+        if data.get('filter_date_to'):
+            filters['date_to'] = datetime.fromisoformat(data['filter_date_to']).date()
+        
+        # Perform semantic search
+        top_k = data.get('top_k', 5)
+        chunk_results = semantic_search_chunks(current_user.id, query, filters, top_k)
+        
+        # Format results
+        results = []
+        for chunk, similarity in chunk_results:
+            result = chunk.to_dict()
+            result['similarity'] = similarity
+            result['recording_title'] = chunk.recording.title
+            result['recording_meeting_date'] = local_datetime_filter(chunk.recording.meeting_date)
+            results.append(result)
+        
+        return jsonify({'results': results})
+        
+    except Exception as e:
+        current_app.logger.error(f"Error in inquire search: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@inquire_bp.route('/api/inquire/chat', methods=['POST'])
+@login_required
+def inquire_chat():
+    """Chat with filtered transcriptions using RAG."""
+    if not ENABLE_INQUIRE_MODE:
+        return jsonify({'error': 'Inquire mode is not enabled'}), 403
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+        
+        user_message = data.get('message')
+        message_history = data.get('message_history', [])
+        
+        if not user_message:
+            return jsonify({'error': 'No message provided'}), 400
+        
+        # Check if OpenRouter client is available
+        if client is None:
+            return jsonify({'error': 'Chat service is not available (OpenRouter client not configured)'}), 503
+        
+        # Build filters from request
+        filters = {}
+        if data.get('filter_tags'):
+            filters['tag_ids'] = data['filter_tags']
+        if data.get('filter_speakers'):
+            filters['speaker_names'] = data['filter_speakers']
+        if data.get('filter_recording_ids'):
+            filters['recording_ids'] = data['filter_recording_ids']
+        if data.get('filter_date_from'):
+            filters['date_from'] = datetime.fromisoformat(data['filter_date_from']).date()
+        if data.get('filter_date_to'):
+            filters['date_to'] = datetime.fromisoformat(data['filter_date_to']).date()
+        
+        # Debug logging
+        current_app.logger.info(f"Inquire chat - User: {current_user.username}, Query: '{user_message}', Filters: {filters}")
+        
+        # Capture user context and app before generator to avoid context issues
+        user_id = current_user.id
+        user_name = current_user.name if current_user.name else "the user"
+        user_title = current_user.job_title if current_user.job_title else "professional"
+        user_company = current_user.company if current_user.company else "their organization"
+        user_output_language = current_user.output_language if current_user.output_language else None
+        app = current_app._get_current_object()  # Capture app for use in generator
+        
+        # Enhanced query processing with enrichment and debugging
+        def create_status_response(status, message):
+            """Helper to create SSE status updates"""
+            return f"data: {json.dumps({'status': status, 'message': message})}\n\n"
+        
+        def generate_enhanced_chat():
+            # Explicitly reference outer scope variables
+            nonlocal user_id, user_name, user_title, user_company, user_output_language, data, filters
+
+            # Push app context for entire generator execution
+            # This is needed because call_llm_completion uses current_app.logger internally
+            ctx = app.app_context()
+            ctx.push()
+
+            try:
+                # Send initial status
+                yield create_status_response('processing', 'Analyzing your query...')
+                
+                # Step 1: Router - Determine if RAG lookup is needed
+                router_prompt = f"""Analyze this user query to determine if it requires searching through transcription content or if it's a simple formatting/clarification request.
+
+User query: "{user_message}"
+
+Respond with ONLY "RAG" if the query requires searching transcriptions (asking about content, conversations, specific information from recordings).
+Respond with ONLY "DIRECT" if it's a formatting request, clarification about previous responses, or doesn't require searching transcriptions.
+
+Examples:
+- "What did Beth say about the budget?" → RAG
+- "Can you format this in separate headings?" → DIRECT  
+- "Who mentioned the timeline?" → RAG
+- "Make this more structured" → DIRECT"""
+
+                try:
+                    router_response = call_llm_completion(
+                        messages=[
+                            {"role": "system", "content": "You are a query router. Respond with only 'RAG' or 'DIRECT'."},
+                            {"role": "user", "content": router_prompt}
+                        ],
+                        temperature=0.1,
+                        max_tokens=10,
+                        user_id=user_id,
+                        operation_type='query_routing'
+                    )
+
+                    raw_decision = router_response.choices[0].message.content
+                    if not raw_decision or not raw_decision.strip():
+                        app.logger.warning("Router returned empty response, defaulting to RAG")
+                        raise ValueError("Empty router response")
+
+                    route_decision = raw_decision.strip().upper()
+                    app.logger.info(f"Router decision: {route_decision}")
+
+                    if route_decision == "DIRECT":
+                        # Direct response without RAG lookup
+                        yield create_status_response('responding', 'Generating direct response...')
+
+                        direct_prompt = f"""You are assisting {user_name}. Respond to their request directly using proper markdown formatting.
+
+User request: "{user_message}"
+
+Previous conversation context (if relevant):
+{json.dumps(message_history[-2:] if message_history else [])}
+
+Use proper markdown formatting including headings (##), bold (**text**), bullet points (-), etc."""
+
+                        stream = call_llm_completion(
+                            messages=[
+                                {"role": "system", "content": direct_prompt},
+                                {"role": "user", "content": user_message}
+                            ],
+                            temperature=0.7,
+                            max_tokens=int(os.environ.get("CHAT_MAX_TOKENS", "2000")),
+                            stream=True,
+                            user_id=user_id,
+                            operation_type='chat'
+                        )
+
+                        # Use helper function to process streaming with thinking tag support
+                        for response in process_streaming_with_thinking(stream, user_id=user_id, operation_type='chat', model_name=os.environ.get('LLM_MODEL')):
+                            yield response
+                        return
+                        
+                except Exception as e:
+                    app.logger.warning(f"Router failed, defaulting to RAG: {e}")
+                
+                # Step 2: Query enrichment - generate better search terms based on user intent
+                yield create_status_response('enriching', 'Enriching search query...')
+                
+                # Use captured user context for personalized search terms
+                
+                if EMBEDDINGS_AVAILABLE:
+                    enrichment_prompt = f"""You are a query enhancement assistant. Given a user's question about transcribed meetings/recordings, generate 3-5 alternative search terms or phrases that would help find relevant content in a semantic search system.
+
+User context:
+- Name: {user_name}
+- Title: {user_title}
+- Company: {user_company}
+
+User question: "{user_message}"
+Available context: Transcribed meetings and recordings with speakers: {', '.join(data.get('filter_speakers', []))}.
+
+Generate search terms that would find relevant content. Focus on:
+1. Key concepts and topics using the user's actual name instead of generic terms like "me"
+2. Specific terminology that might be used in their professional context
+3. Alternative phrasings of the question with proper names
+4. Related terms that might appear in transcripts from their meetings
+
+Examples:
+- Instead of "what Beth told me" use "what Beth told {user_name}"
+- Instead of "my last conversation" use "{user_name}'s conversation"
+- Use their job title and company context when relevant
+
+Respond with only a JSON array of strings: ["term1", "term2", "term3", ...]"""
+                else:
+                    enrichment_prompt = f"""You are a keyword extraction assistant. Given a user's question about transcribed meetings/recordings, extract 3-5 essential keyword phrases for a basic text search (SQL LIKE matching, not semantic search).
+
+User context:
+- Name: {user_name}
+
+User question: "{user_message}"
+
+Rules:
+- Return ONLY the key terms that would actually appear in a transcript — no filler words
+- Each term should be 1-3 words maximum
+- Replace pronouns like "me", "my", "I" with the user's name "{user_name}"
+- Focus on proper nouns, topic-specific terms, and distinctive phrases
+- Do NOT include common words like "meeting", "discussion", "plan", "talk" unless they are the actual topic
+
+Examples:
+- "what is up with Railroad Retirement" → ["Railroad Retirement", "railroad", "retirement"]
+- "when did Beth mention the budget deadline" → ["Beth", "budget deadline", "budget"]
+- "what did we discuss about AI foresight" → ["AI foresight", "{user_name}", "foresight"]
+
+Respond with only a JSON array of strings: ["term1", "term2", ...]"""
+                
+                try:
+                    enrichment_response = call_llm_completion(
+                        messages=[
+                            {"role": "system", "content": "You are a query enhancement assistant. Respond only with valid JSON arrays of search terms."},
+                            {"role": "user", "content": enrichment_prompt}
+                        ],
+                        temperature=0.3,
+                        max_tokens=200,
+                        user_id=user_id,
+                        operation_type='query_enrichment'
+                    )
+
+                    raw_content = enrichment_response.choices[0].message.content
+                    if not raw_content or not raw_content.strip():
+                        app.logger.warning(f"Query enrichment returned empty response")
+                        raise ValueError("Empty response from LLM")
+
+                    # Try to extract JSON array if wrapped in other text
+                    content = raw_content.strip()
+                    if content.startswith('['):
+                        enriched_terms = json.loads(content)
+                    else:
+                        # Try to find JSON array in the response
+                        match = re.search(r'\[.*?\]', content, re.DOTALL)
+                        if match:
+                            enriched_terms = json.loads(match.group())
+                        else:
+                            app.logger.warning(f"Query enrichment response not JSON: {content[:200]}")
+                            raise ValueError("No JSON array found in response")
+
+                    app.logger.info(f"Enriched search terms: {enriched_terms}")
+                    
+                    # Combine original query with enriched terms for search
+                    search_queries = [user_message] + enriched_terms[:3]  # Use original + top 3 enriched terms
+                    
+                except Exception as e:
+                    app.logger.warning(f"Query enrichment failed, using original query: {e}")
+                    search_queries = [user_message]
+                
+                # Step 2: Semantic search with multiple queries
+                yield create_status_response('searching', 'Searching transcriptions...')
+                
+                all_chunks = []
+                seen_chunk_ids = set()
+                
+                for query in search_queries:
+                    with app.app_context():
+                        chunk_results = semantic_search_chunks(user_id, query, filters, 8)
+                        app.logger.info(f"Search query '{query}' returned {len(chunk_results)} chunks")
+                    
+                    for chunk, similarity in chunk_results:
+                        if chunk and chunk.id not in seen_chunk_ids:
+                            all_chunks.append((chunk, similarity))
+                            seen_chunk_ids.add(chunk.id)
+                
+                # Sort by similarity and take top results
+                all_chunks.sort(key=lambda x: x[1], reverse=True)
+                chunk_results = all_chunks[:data.get('context_chunks', 8)]
+
+                app.logger.info(f"Final chunk results: {len(chunk_results)} chunks with similarities: {[f'{s:.3f}' for _, s in chunk_results]}")
+                
+                # Step 2.5: Auto-detect mentioned speakers and apply filters if needed
+                with app.app_context():
+                    # Get available speakers
+                    recordings_with_participants = Recording.query.filter_by(user_id=user_id).filter(
+                        Recording.participants.isnot(None),
+                        Recording.participants != ''
+                    ).all()
+
+                    available_speakers = set()
+                    for recording in recordings_with_participants:
+                        if recording.participants:
+                            participants = [p.strip() for p in recording.participants.split(',') if p.strip()]
+                            available_speakers.update(participants)
+                    
+                    # Check if any speakers are mentioned in the user query but missing from results
+                    mentioned_speakers = []
+                    for speaker in available_speakers:
+                        if speaker.lower() in user_message.lower():
+                            # Check if this speaker appears in current chunk results
+                            speaker_in_results = False
+                            for chunk, _ in chunk_results:
+                                if chunk and (
+                                    (chunk.speaker_name and speaker.lower() in chunk.speaker_name.lower()) or
+                                    (chunk.recording and chunk.recording.participants and speaker.lower() in chunk.recording.participants.lower())
+                                ):
+                                    speaker_in_results = True
+                                    break
+                            
+                            if not speaker_in_results:
+                                mentioned_speakers.append(speaker)
+                    
+                    # If we found mentioned speakers not in results, automatically apply speaker filter
+                    if mentioned_speakers and not data.get('filter_speakers'):  # Only if no speaker filter already applied
+                        app.logger.info(f"Auto-detected mentioned speakers not in results: {mentioned_speakers}")
+                        yield create_status_response('filtering', f'Detected mention of {", ".join(mentioned_speakers)}, applying speaker filter...')
+                        
+                        # Apply automatic speaker filter
+                        auto_filters = filters.copy()
+                        auto_filters['speaker_names'] = mentioned_speakers
+                        
+                        # Re-run semantic search with speaker filter
+                        auto_filtered_chunks = []
+                        auto_filtered_seen_ids = set()
+                        
+                        for query in search_queries:
+                            with app.app_context():
+                                auto_filtered_results = semantic_search_chunks(user_id, query, auto_filters, data.get('context_chunks', 8))
+                                app.logger.info(f"Auto-filtered search for '{query}' with speakers {mentioned_speakers} returned {len(auto_filtered_results)} chunks")
+                            
+                            for chunk, similarity in auto_filtered_results:
+                                if chunk and chunk.id not in auto_filtered_seen_ids:
+                                    auto_filtered_chunks.append((chunk, similarity))
+                                    auto_filtered_seen_ids.add(chunk.id)
+                        
+                        # If auto-filter found better results, use them
+                        if len(auto_filtered_chunks) > 0:
+                            auto_filtered_chunks.sort(key=lambda x: x[1], reverse=True)
+                            chunk_results = auto_filtered_chunks[:data.get('context_chunks', 8)]
+                            app.logger.info(f"Auto speaker filter found {len(chunk_results)} relevant chunks, using filtered results")
+                            filters = auto_filters  # Update filters for context building
+                
+                # Step 3: Evaluate results and re-query if needed
+                if len(chunk_results) < 2:  # If we got very few results, try a broader search
+                    yield create_status_response('requerying', 'Expanding search scope...')
+                    
+                    # Try without speaker filter if it was applied
+                    broader_filters = filters.copy()
+                    if 'speaker_names' in broader_filters:
+                        del broader_filters['speaker_names']
+                        app.logger.info("Retrying search without speaker filter...")
+                        
+                        for query in search_queries:
+                            with app.app_context():
+                                chunk_results_broader = semantic_search_chunks(user_id, query, broader_filters, 6)
+                            for chunk, similarity in chunk_results_broader:
+                                if chunk and chunk.id not in seen_chunk_ids:
+                                    all_chunks.append((chunk, similarity))
+                                    seen_chunk_ids.add(chunk.id)
+                        
+                        # Re-sort and limit
+                        all_chunks.sort(key=lambda x: x[1], reverse=True)
+                        chunk_results = all_chunks[:data.get('context_chunks', 8)]
+                        app.logger.info(f"Broader search returned {len(chunk_results)} total chunks")
+                
+                # Build context from retrieved chunks
+                yield create_status_response('contextualizing', 'Building context...')
+                
+                # Group chunks by recording and organize properly
+                recording_chunks = {}
+                recording_ids_in_context = set()
+                
+                for chunk, similarity in chunk_results:
+                    if not chunk or not chunk.recording:
+                        continue
+                    recording_id = chunk.recording.id
+                    recording_ids_in_context.add(recording_id)
+                    
+                    if recording_id not in recording_chunks:
+                        recording_chunks[recording_id] = {
+                            'recording': chunk.recording,
+                            'chunks': []
+                        }
+                    
+                    recording_chunks[recording_id]['chunks'].append({
+                        'chunk': chunk,
+                        'similarity': similarity
+                    })
+                
+                # Build organized context pieces
+                context_pieces = []
+                
+                for recording_id, data in recording_chunks.items():
+                    recording = data['recording']
+                    chunks = data['chunks']
+                    
+                    # Sort chunks by their index to maintain chronological order
+                    chunks.sort(key=lambda x: x['chunk'].chunk_index)
+                    
+                    # Build recording header with complete metadata
+                    header = f"=== {recording.title} [Recording ID: {recording_id}] ==="
+                    if recording.meeting_date:
+                        header += f" ({recording.meeting_date})"
+                    
+                    # Add participants information
+                    if recording.participants:
+                        participants_list = [p.strip() for p in recording.participants.split(',') if p.strip()]
+                        header += f"\\nParticipants: {', '.join(participants_list)}"
+                    
+                    context_piece = header + "\\n\\n"
+                    
+                    # Process chunks and detect non-continuity
+                    prev_chunk_index = None
+                    for chunk_data in chunks:
+                        chunk = chunk_data['chunk']
+                        similarity = chunk_data['similarity']
+                        
+                        # Check for non-continuity
+                        if prev_chunk_index is not None and chunk.chunk_index != prev_chunk_index + 1:
+                            context_piece += "\\n[... gap in transcript - non-consecutive chunks ...]\\n\\n"
+                        
+                        # Add speaker information if available
+                        speaker_info = ""
+                        if chunk.speaker_name:
+                            speaker_info = f"{chunk.speaker_name}: "
+                        elif chunk.start_time is not None:
+                            speaker_info = f"[{chunk.start_time:.1f}s]: "
+                        
+                        # Add timing info if available
+                        timing_info = ""
+                        if chunk.start_time is not None and chunk.end_time is not None:
+                            timing_info = f" [{chunk.start_time:.1f}s-{chunk.end_time:.1f}s]"
+                        
+                        context_piece += f"{speaker_info}{chunk.content}{timing_info} (similarity: {similarity:.3f})\\n\\n"
+                        prev_chunk_index = chunk.chunk_index
+                    
+                    context_pieces.append(context_piece)
+                
+                app.logger.info(f"Built context from {len(chunk_results)} chunks across {len(recording_chunks)} recordings")
+                
+                # Generate response
+                yield create_status_response('responding', 'Generating response...')
+                
+                # Prepare system prompt
+                language_instruction = f"Please provide all your responses in {user_output_language}." if user_output_language else ""
+                
+                # Build filter description for context
+                filter_description = []
+                with app.app_context():
+                    if data.get('filter_tags'):
+                        tag_names = [tag.name for tag in Tag.query.filter(Tag.id.in_(data['filter_tags'])).all()]
+                        filter_description.append(f"tags: {', '.join(tag_names)}")
+                if data.get('filter_speakers'):
+                    filter_description.append(f"speakers: {', '.join(data['filter_speakers'])}")
+                if data.get('filter_date_from') or data.get('filter_date_to'):
+                    date_range = []
+                    if data.get('filter_date_from'):
+                        date_range.append(f"from {data['filter_date_from']}")
+                    if data.get('filter_date_to'):
+                        date_range.append(f"to {data['filter_date_to']}")
+                    filter_description.append(f"dates: {' '.join(date_range)}")
+                
+                filter_text = f" (filtered by {'; '.join(filter_description)})" if filter_description else ""
+                
+                context_text = "\n\n".join(context_pieces) if context_pieces else "No relevant context found."
+                
+                # Get transcript length limit setting and available speakers
+                with app.app_context():
+                    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+                    
+                    # Get all available speakers for this user
+                    recordings_with_participants = Recording.query.filter_by(user_id=user_id).filter(
+                        Recording.participants.isnot(None),
+                        Recording.participants != ''
+                    ).all()
+                    
+                    available_speakers = set()
+                    for recording in recordings_with_participants:
+                        if recording.participants:
+                            participants = [p.strip() for p in recording.participants.split(',') if p.strip()]
+                            available_speakers.update(participants)
+                    
+                    available_speakers = sorted(list(available_speakers))
+                
+                system_prompt = f"""You are a professional meeting and audio transcription analyst assisting {user_name}, who is a(n) {user_title} at {user_company}. {language_instruction}
+
+You are analyzing transcriptions from multiple recordings{filter_text}. The following context has been retrieved based on semantic similarity to the user's question:
+
+<<start context>>
+{context_text}
+<<end context>>
+
+The system has automatically analyzed your query and retrieved the most relevant context from your transcriptions. The search returned {len(chunk_results)} chunks from {len(recording_ids_in_context)} recording(s).
+
+**Available speakers in your recordings**: {', '.join(available_speakers) if available_speakers else 'None available'}
+
+**Recording IDs in context**: {list(recording_ids_in_context)}
+
+IMPORTANT FORMATTING INSTRUCTIONS:
+You MUST use proper markdown formatting in your responses. Structure your response as follows:
+
+1. **Always use markdown syntax** - Use `#`, `##`, `###` for headings, `**bold**`, `*italic*`, `-` for lists, etc.
+2. Start with a brief summary or preamble if helpful
+3. Organize information by source transcript using clear markdown headings
+4. Use the format: `## [Recording Title] - [Date if available]` 
+5. Under each heading, provide the relevant information from that specific recording using bullet points and formatting
+6. Include speaker names when referring to specific statements using **bold** formatting
+7. Use bullet points (`-`) and sub-bullets for organizing information clearly
+
+**Required Example Structure:**
+Brief summary with **key points** highlighted...
+
+## Meeting Discussion on Project Implementation - 2024-06-18
+- **Speaker A** mentioned that "there's significant support needed for implementation"
+- **Speaker B** confirmed the upcoming meeting with the technical team
+- Key topics discussed:
+  - Budget planning considerations
+  - Timeline coordination needs
+
+## Budget Planning Meeting - 2024-05-30  
+- **Speaker A** reviewed the budget document
+- **Speaker C** will approve the final version for submission
+- Important details:
+  - Budget represents approximately 1/3 of the project total
+  - Coordination needed for upcoming milestones
+
+Order your response with notes from the most recent meetings first. Always use proper markdown formatting and structure by source recording for maximum clarity and readability."""
+        
+                # Prepare messages array
+                messages = [{"role": "system", "content": system_prompt}]
+                if message_history:
+                    messages.extend(message_history)
+                messages.append({"role": "user", "content": user_message})
+
+                # Enable streaming
+                stream = call_chat_completion(
+                    messages=messages,
+                    temperature=0.7,
+                    max_tokens=int(os.environ.get("CHAT_MAX_TOKENS", "2000")),
+                    stream=True,
+                    user_id=user_id,
+                    operation_type='chat'
+                )
+
+                # Buffer content to detect full transcript requests
+                response_buffer = ""
+
+                # Buffer content to detect full transcript requests
+                response_buffer = ""
+                content_buffer = ""
+                in_thinking = False
+                thinking_buffer = ""
+                
+                for chunk in stream:
+                    if not chunk.choices:
+                        continue
+                    content = chunk.choices[0].delta.content
+                    if content:
+                        response_buffer += content
+                        content_buffer += content
+                        
+                        # Check if this is a full transcript request
+                        if response_buffer.strip().startswith("REQUEST_FULL_TRANSCRIPT:"):
+                            lines = response_buffer.split('\n')
+                            request_line = lines[0].strip()
+                            
+                            if ':' in request_line:
+                                try:
+                                    recording_id = int(request_line.split(':')[1])
+                                    app.logger.info(f"Agent requested full transcript for recording {recording_id}")
+                                    
+                                    # Fetch full transcript
+                                    yield create_status_response('fetching', f'Retrieving full transcript for recording {recording_id}...')
+                                    
+                                    with app.app_context():
+                                        recording = db.session.get(Recording, recording_id)
+                                        if recording and recording.user_id == user_id and recording.transcription:
+                                            # Apply transcript length limit
+                                            if transcript_limit == -1:
+                                                full_transcript = recording.transcription
+                                            else:
+                                                full_transcript = recording.transcription[:transcript_limit]
+                                            
+                                            # Add full transcript to context
+                                            full_context = f"{context_text}\n\n<<FULL TRANSCRIPT - {recording.title}>>\n{full_transcript}\n<<END FULL TRANSCRIPT>>"
+                                            
+                                            # Update system prompt with full transcript
+                                            updated_system_prompt = system_prompt.replace(
+                                                f"<<start context>>\n{context_text}\n<<end context>>",
+                                                f"<<start context>>\n{full_context}\n<<end context>>"
+                                            )
+                                            
+                                            # Create new messages with updated context
+                                            updated_messages = [{"role": "system", "content": updated_system_prompt}]
+                                            if message_history:
+                                                updated_messages.extend(message_history)
+                                            updated_messages.append({"role": "user", "content": user_message})
+                                            
+                                            # Generate new response with full context
+                                            yield create_status_response('responding', 'Analyzing full transcript...')
+
+                                            new_stream = call_chat_completion(
+                                                messages=updated_messages,
+                                                temperature=0.7,
+                                                max_tokens=int(os.environ.get("CHAT_MAX_TOKENS", "2000")),
+                                                stream=True,
+                                                user_id=user_id,
+                                                operation_type='chat'
+                                            )
+
+                                            # Use helper function to process streaming with thinking tag support
+                                            for response in process_streaming_with_thinking(new_stream, user_id=user_id, operation_type='chat', model_name=os.environ.get('CHAT_MODEL')):
+                                                yield response
+                                            return
+                                        else:
+                                            # Recording not found or no permission
+                                            error_msg = f"\n\nError: Unable to access full transcript for recording {recording_id}. Recording may not exist or you may not have permission."
+                                            yield f"data: {json.dumps({'delta': error_msg})}\n\n"
+                                            yield f"data: {json.dumps({'end_of_stream': True})}\n\n"
+                                            return
+                                            
+                                except (ValueError, IndexError):
+                                    app.logger.warning(f"Invalid transcript request format: {request_line}")
+                                    # Continue with normal streaming
+                                    pass
+                        
+                        # Process the buffer to detect and handle thinking tags
+                        while True:
+                            if not in_thinking:
+                                # Look for opening thinking tag
+                                think_start = re.search(r'<think(?:ing)?>', content_buffer, re.IGNORECASE)
+                                if think_start:
+                                    # Send any content before the thinking tag
+                                    before_thinking = content_buffer[:think_start.start()]
+                                    if before_thinking:
+                                        yield f"data: {json.dumps({'delta': before_thinking})}\n\n"
+                                    
+                                    # Start capturing thinking content
+                                    in_thinking = True
+                                    content_buffer = content_buffer[think_start.end():]
+                                    thinking_buffer = ""
+                                else:
+                                    # No thinking tag found, send accumulated content
+                                    if content_buffer:
+                                        yield f"data: {json.dumps({'delta': content_buffer})}\n\n"
+                                    content_buffer = ""
+                                    break
+                            else:
+                                # We're inside a thinking tag, look for closing tag
+                                think_end = re.search(r'</think(?:ing)?>', content_buffer, re.IGNORECASE)
+                                if think_end:
+                                    # Capture thinking content up to the closing tag
+                                    thinking_buffer += content_buffer[:think_end.start()]
+                                    
+                                    # Send the thinking content as a special type
+                                    if thinking_buffer.strip():
+                                        yield f"data: {json.dumps({'thinking': thinking_buffer.strip()})}\n\n"
+                                    
+                                    # Continue processing after the closing tag
+                                    in_thinking = False
+                                    content_buffer = content_buffer[think_end.end():]
+                                    thinking_buffer = ""
+                                else:
+                                    # Still inside thinking tag, accumulate content
+                                    thinking_buffer += content_buffer
+                                    content_buffer = ""
+                                    break
+                
+                # Handle any remaining content
+                if in_thinking and thinking_buffer:
+                    # Unclosed thinking tag - send as thinking content
+                    yield f"data: {json.dumps({'thinking': thinking_buffer.strip()})}\n\n"
+                elif content_buffer:
+                    # Regular content
+                    yield f"data: {json.dumps({'delta': content_buffer})}\n\n"
+                
+                yield f"data: {json.dumps({'end_of_stream': True})}\n\n"
+
+            except TokenBudgetExceeded as e:
+                app.logger.warning(f"Token budget exceeded for user {user_id}: {e}")
+                yield f"data: {json.dumps({'error': str(e), 'budget_exceeded': True})}\n\n"
+            except Exception as e:
+                app.logger.error(f"Error in enhanced chat generation: {e}")
+                yield f"data: {json.dumps({'error': str(e)})}\n\n"
+            finally:
+                ctx.pop()
+
+        return Response(generate_enhanced_chat(), mimetype='text/event-stream')
+        
+    except Exception as e:
+        current_app.logger.error(f"Error in inquire chat endpoint: {str(e)}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@inquire_bp.route('/api/inquire/available_filters', methods=['GET'])
+@login_required
+def get_available_filters():
+    """Get available filter options for the user (includes shared recordings)."""
+    if not ENABLE_INQUIRE_MODE:
+        return jsonify({'error': 'Inquire mode is not enabled'}), 403
+    try:
+        # Get user's personal tags
+        user_tags = Tag.query.filter_by(user_id=current_user.id, group_id=None).all()
+
+        # Get group tags from user's teams
+        group_tags = []
+        memberships = GroupMembership.query.filter_by(user_id=current_user.id).all()
+        group_ids = [m.group_id for m in memberships]
+        if group_ids:
+            group_tags = Tag.query.filter(Tag.group_id.in_(group_ids)).all()
+
+        # Combine all tags
+        all_tags = user_tags + group_tags
+
+        # Get all accessible recording IDs (own + shared)
+        accessible_recording_ids = get_accessible_recording_ids(current_user.id)
+
+        # Get unique speakers from accessible recordings' participants field
+        recordings_with_participants = Recording.query.filter(
+            Recording.id.in_(accessible_recording_ids),
+            Recording.participants.isnot(None),
+            Recording.participants != ''
+        ).all()
+
+        speaker_names = set()
+        for recording in recordings_with_participants:
+            if recording.participants:
+                # Split participants by comma and clean up
+                participants = [p.strip() for p in recording.participants.split(',') if p.strip()]
+                speaker_names.update(participants)
+
+        speaker_names = sorted(list(speaker_names))
+
+        # Get accessible recordings for recording-specific filtering
+        recordings = Recording.query.filter(
+            Recording.id.in_(accessible_recording_ids),
+            Recording.status == 'COMPLETED'
+        ).order_by(Recording.created_at.desc()).all()
+
+        return jsonify({
+            'tags': [tag.to_dict() for tag in all_tags],
+            'speakers': speaker_names,
+            'recordings': [{'id': r.id, 'title': r.title, 'meeting_date': f"{r.meeting_date.isoformat()}T00:00:00" if r.meeting_date else None} for r in recordings]
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting available filters: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
diff --git a/src/api/naming_templates.py b/src/api/naming_templates.py
new file mode 100644
index 00000000..beab49de
--- /dev/null
+++ b/src/api/naming_templates.py
@@ -0,0 +1,331 @@
+"""
+Naming template management.
+
+This blueprint handles CRUD operations for naming templates,
+which define how recording titles are generated from filenames,
+metadata, and AI-generated content.
+"""
+
+import json
+from datetime import datetime
+from flask import Blueprint, request, jsonify, current_app
+from flask_login import login_required, current_user
+
+from src.database import db
+from src.models import NamingTemplate
+
+# Create blueprint
+naming_templates_bp = Blueprint('naming_templates', __name__)
+
+
+# --- Routes ---
+
+@naming_templates_bp.route('/api/naming-templates', methods=['GET'])
+@login_required
+def get_naming_templates():
+    """Get all naming templates for the current user."""
+    templates = NamingTemplate.query.filter_by(user_id=current_user.id).all()
+    return jsonify([template.to_dict() for template in templates])
+
+
+@naming_templates_bp.route('/api/naming-templates', methods=['POST'])
+@login_required
+def create_naming_template():
+    """Create a new naming template."""
+    data = request.json
+    if not data or not data.get('name') or not data.get('template'):
+        return jsonify({'error': 'Name and template are required'}), 400
+
+    # Validate regex patterns if provided
+    regex_patterns = data.get('regex_patterns', {})
+    if regex_patterns:
+        if not isinstance(regex_patterns, dict):
+            return jsonify({'error': 'regex_patterns must be a dictionary'}), 400
+        # Validate each regex pattern
+        import re
+        for var_name, pattern in regex_patterns.items():
+            try:
+                re.compile(pattern)
+            except re.error as e:
+                return jsonify({'error': f'Invalid regex pattern for "{var_name}": {str(e)}'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        NamingTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template = NamingTemplate(
+        user_id=current_user.id,
+        name=data['name'],
+        template=data['template'],
+        description=data.get('description'),
+        regex_patterns=json.dumps(regex_patterns) if regex_patterns else None,
+        is_default=data.get('is_default', False)
+    )
+
+    db.session.add(template)
+    db.session.commit()
+
+    return jsonify(template.to_dict()), 201
+
+
+@naming_templates_bp.route('/api/naming-templates/<int:template_id>', methods=['GET'])
+@login_required
+def get_naming_template(template_id):
+    """Get a specific naming template."""
+    template = NamingTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    return jsonify(template.to_dict())
+
+
+@naming_templates_bp.route('/api/naming-templates/<int:template_id>', methods=['PUT'])
+@login_required
+def update_naming_template(template_id):
+    """Update an existing naming template."""
+    template = NamingTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    # Validate regex patterns if provided
+    if 'regex_patterns' in data:
+        regex_patterns = data['regex_patterns']
+        if regex_patterns:
+            if not isinstance(regex_patterns, dict):
+                return jsonify({'error': 'regex_patterns must be a dictionary'}), 400
+            import re
+            for var_name, pattern in regex_patterns.items():
+                try:
+                    re.compile(pattern)
+                except re.error as e:
+                    return jsonify({'error': f'Invalid regex pattern for "{var_name}": {str(e)}'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        NamingTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template.name = data.get('name', template.name)
+    template.template = data.get('template', template.template)
+    template.description = data.get('description', template.description)
+    template.is_default = data.get('is_default', template.is_default)
+
+    if 'regex_patterns' in data:
+        regex_patterns = data['regex_patterns']
+        template.regex_patterns = json.dumps(regex_patterns) if regex_patterns else None
+
+    template.updated_at = datetime.utcnow()
+
+    db.session.commit()
+
+    return jsonify(template.to_dict())
+
+
+@naming_templates_bp.route('/api/naming-templates/<int:template_id>', methods=['DELETE'])
+@login_required
+def delete_naming_template(template_id):
+    """Delete a naming template."""
+    template = NamingTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    # Check if any tags are using this template
+    from src.models import Tag
+    tags_using = Tag.query.filter_by(naming_template_id=template_id).count()
+    if tags_using > 0:
+        return jsonify({
+            'error': f'Cannot delete template: {tags_using} tag(s) are using this template'
+        }), 400
+
+    db.session.delete(template)
+    db.session.commit()
+
+    return jsonify({'success': True})
+
+
+@naming_templates_bp.route('/api/naming-templates/create-defaults', methods=['POST'])
+@login_required
+def create_default_naming_templates():
+    """Create default naming templates for the user if they don't have any."""
+    existing_templates = NamingTemplate.query.filter_by(user_id=current_user.id).count()
+
+    if existing_templates > 0:
+        return jsonify({'message': 'User already has naming templates'}), 200
+
+    templates = []
+
+    # Default template 1: AI Title Only (default)
+    template1 = NamingTemplate(
+        user_id=current_user.id,
+        name="AI Title Only",
+        template="{{ai_title}}",
+        description="Uses AI-generated title from transcription content",
+        is_default=True
+    )
+    templates.append(template1)
+
+    # Default template 2: Date Prefix
+    template2 = NamingTemplate(
+        user_id=current_user.id,
+        name="Date Prefix",
+        template="{{date}} - {{ai_title}}",
+        description="Prepends recording date to AI-generated title",
+        is_default=False
+    )
+    templates.append(template2)
+
+    # Default template 3: Date and Time
+    template3 = NamingTemplate(
+        user_id=current_user.id,
+        name="Date and Time",
+        template="{{datetime}} {{ai_title}}",
+        description="Includes date and time before the AI title",
+        is_default=False
+    )
+    templates.append(template3)
+
+    # Default template 4: Filename Only (no AI)
+    template4 = NamingTemplate(
+        user_id=current_user.id,
+        name="Filename Only",
+        template="{{filename}}",
+        description="Uses original filename without extension (no AI generation)",
+        is_default=False
+    )
+    templates.append(template4)
+
+    # Default template 5: Phone Call Format
+    # For filenames like: 8005551234-5559876543-20260115.wav
+    phone_call_patterns = {
+        "caller_area": "^(\\d{3})",
+        "caller_ex": "^\\d{3}(\\d{3})",
+        "caller_sub": "^\\d{6}(\\d{4})",
+        "callee_area": "^\\d{10}-(\\d{3})",
+        "callee_ex": "^\\d{10}-\\d{3}(\\d{3})",
+        "callee_sub": "^\\d{10}-\\d{6}(\\d{4})",
+        "year": "^\\d{10}-\\d{10}-(\\d{4})",
+        "month": "^\\d{10}-\\d{10}-\\d{4}(\\d{2})",
+        "day": "^\\d{10}-\\d{10}-\\d{6}(\\d{2})"
+    }
+    template5 = NamingTemplate(
+        user_id=current_user.id,
+        name="Phone Call Format",
+        template="{{caller_area}}-{{caller_ex}}-{{caller_sub}} → {{callee_area}}-{{callee_ex}}-{{callee_sub}} ({{year}}-{{month}}-{{day}})",
+        description="For phone recordings: caller-callee-YYYYMMDD filenames",
+        regex_patterns=json.dumps(phone_call_patterns),
+        is_default=False
+    )
+    templates.append(template5)
+
+    # Add all templates to database
+    for template in templates:
+        db.session.add(template)
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'templates': [template.to_dict() for template in templates]
+    }), 201
+
+
+@naming_templates_bp.route('/api/naming-templates/<int:template_id>/test', methods=['POST'])
+@login_required
+def test_naming_template(template_id):
+    """Test a naming template with sample data."""
+    template = NamingTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    data = request.json or {}
+    sample_filename = data.get('filename', 'sample-recording-2026-01-15.mp3')
+    sample_date = data.get('date')
+    sample_ai_title = data.get('ai_title', 'Meeting with Team')
+
+    # Parse sample date
+    meeting_date = None
+    if sample_date:
+        try:
+            meeting_date = datetime.fromisoformat(sample_date)
+        except ValueError:
+            pass
+
+    if not meeting_date:
+        meeting_date = datetime.now()
+
+    # Apply template
+    result = template.apply(
+        original_filename=sample_filename,
+        meeting_date=meeting_date,
+        ai_title=sample_ai_title
+    )
+
+    return jsonify({
+        'result': result or '(empty - would fall back to AI title or filename)',
+        'needs_ai_title': template.needs_ai_title(),
+        'input': {
+            'filename': sample_filename,
+            'date': meeting_date.isoformat() if meeting_date else None,
+            'ai_title': sample_ai_title
+        }
+    })
+
+
+@naming_templates_bp.route('/api/naming-templates/default', methods=['GET'])
+@login_required
+def get_default_naming_template():
+    """Get the user's default naming template."""
+    return jsonify({
+        'default_naming_template_id': current_user.default_naming_template_id
+    })
+
+
+@naming_templates_bp.route('/api/naming-templates/default', methods=['PUT'])
+@login_required
+def set_default_naming_template():
+    """Set the user's default naming template."""
+    data = request.json
+    template_id = data.get('template_id') if data else None
+
+    if template_id:
+        # Verify template belongs to user
+        template = NamingTemplate.query.filter_by(
+            id=template_id,
+            user_id=current_user.id
+        ).first()
+
+        if not template:
+            return jsonify({'error': 'Template not found'}), 404
+
+    current_user.default_naming_template_id = template_id if template_id else None
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'default_naming_template_id': current_user.default_naming_template_id
+    })
diff --git a/src/api/push_notifications.py b/src/api/push_notifications.py
new file mode 100644
index 00000000..f7b18ecf
--- /dev/null
+++ b/src/api/push_notifications.py
@@ -0,0 +1,232 @@
+"""
+Push Notification API Endpoints
+Handles push notification subscriptions and delivery
+"""
+from flask import Blueprint, request, jsonify
+from flask_login import login_required, current_user
+from src.database import db
+from src.models.push_subscription import PushSubscription
+import json
+
+
+push_bp = Blueprint('push', __name__)
+
+# VAPID config is loaded lazily to avoid startup issues
+_vapid_config = None
+
+
+def _get_vapid_config():
+    """Load VAPID configuration lazily"""
+    global _vapid_config
+    if _vapid_config is None:
+        try:
+            from src.utils.vapid_keys import VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY, VAPID_ENABLED
+            _vapid_config = {
+                'enabled': VAPID_ENABLED,
+                'public_key': VAPID_PUBLIC_KEY,
+                'private_key': VAPID_PRIVATE_KEY
+            }
+        except Exception as e:
+            print(f"[Push] Failed to load VAPID config: {e}")
+            _vapid_config = {
+                'enabled': False,
+                'public_key': None,
+                'private_key': None
+            }
+    return _vapid_config
+
+
+@push_bp.route('/api/push/config', methods=['GET'])
+def get_push_config():
+    """Get push notification configuration for client"""
+    config = _get_vapid_config()
+    return jsonify({
+        'enabled': config['enabled'],
+        'public_key': config['public_key'] if config['enabled'] else None
+    })
+
+
+@push_bp.route('/api/push/subscribe', methods=['POST'])
+@login_required
+def subscribe():
+    """Store push subscription for current user"""
+    config = _get_vapid_config()
+    if not config['enabled']:
+        return jsonify({
+            'success': False,
+            'error': 'Push notifications not available'
+        }), 503
+
+    try:
+        subscription_data = request.json
+
+        if not subscription_data or 'endpoint' not in subscription_data:
+            return jsonify({
+                'success': False,
+                'error': 'Invalid subscription data'
+            }), 400
+
+        # Check if subscription already exists
+        existing = PushSubscription.query.filter_by(
+            user_id=current_user.id,
+            endpoint=subscription_data['endpoint']
+        ).first()
+
+        if existing:
+            return jsonify({
+                'success': True,
+                'message': 'Already subscribed',
+                'subscription_id': existing.id
+            })
+
+        # Create new subscription
+        subscription = PushSubscription(
+            user_id=current_user.id,
+            endpoint=subscription_data['endpoint'],
+            p256dh_key=subscription_data.get('keys', {}).get('p256dh', ''),
+            auth_key=subscription_data.get('keys', {}).get('auth', '')
+        )
+
+        db.session.add(subscription)
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'message': 'Subscription saved',
+            'subscription_id': subscription.id
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        print(f"[Push] Subscription error: {e}")
+        return jsonify({
+            'success': False,
+            'error': str(e)
+        }), 500
+
+
+@push_bp.route('/api/push/unsubscribe', methods=['POST'])
+@login_required
+def unsubscribe():
+    """Remove push subscription for current user"""
+    config = _get_vapid_config()
+    if not config['enabled']:
+        return jsonify({'success': True, 'message': 'Push notifications not enabled'})
+
+    try:
+        subscription_data = request.json
+
+        if not subscription_data or 'endpoint' not in subscription_data:
+            return jsonify({
+                'success': False,
+                'error': 'Invalid subscription data'
+            }), 400
+
+        subscription = PushSubscription.query.filter_by(
+            user_id=current_user.id,
+            endpoint=subscription_data['endpoint']
+        ).first()
+
+        if subscription:
+            db.session.delete(subscription)
+            db.session.commit()
+            return jsonify({
+                'success': True,
+                'message': 'Subscription removed'
+            })
+
+        return jsonify({
+            'success': False,
+            'error': 'Subscription not found'
+        }), 404
+
+    except Exception as e:
+        db.session.rollback()
+        print(f"[Push] Unsubscribe error: {e}")
+        return jsonify({
+            'success': False,
+            'error': str(e)
+        }), 500
+
+
+def send_push_notification(user_id, title, body, data=None, url=None):
+    """
+    Send push notification to all subscriptions for a user
+
+    Args:
+        user_id: User ID to send notification to
+        title: Notification title
+        body: Notification body text
+        data: Optional dictionary of extra data
+        url: Optional URL to open when notification is clicked
+    """
+    config = _get_vapid_config()
+    if not config['enabled']:
+        print("[Push] Push notifications not enabled, skipping")
+        return
+
+    try:
+        from pywebpush import webpush, WebPushException
+
+        subscriptions = PushSubscription.query.filter_by(user_id=user_id).all()
+
+        if not subscriptions:
+            print(f"[Push] No subscriptions found for user {user_id}")
+            return
+
+        notification_data = {
+            'title': title,
+            'body': body,
+            'icon': '/static/img/icon-192x192.png',
+            'badge': '/static/img/icon-192x192.png',
+            'data': data or {}
+        }
+
+        if url:
+            notification_data['data']['url'] = url
+
+        sent_count = 0
+        failed_count = 0
+
+        for subscription in subscriptions:
+            try:
+                webpush(
+                    subscription_info={
+                        'endpoint': subscription.endpoint,
+                        'keys': {
+                            'p256dh': subscription.p256dh_key,
+                            'auth': subscription.auth_key
+                        }
+                    },
+                    data=json.dumps(notification_data),
+                    vapid_private_key=config['private_key'],
+                    vapid_claims={
+                        'sub': 'mailto:admin@speakr.app'
+                    }
+                )
+                sent_count += 1
+                print(f'[Push] Sent notification to user {user_id} subscription {subscription.id}')
+
+            except WebPushException as e:
+                failed_count += 1
+                print(f'[Push] Failed to send to subscription {subscription.id}: {e}')
+
+                # Remove expired subscriptions
+                if e.response and e.response.status_code in [404, 410]:
+                    print(f'[Push] Removing expired subscription {subscription.id}')
+                    db.session.delete(subscription)
+
+            except Exception as e:
+                failed_count += 1
+                print(f'[Push] Unexpected error sending to subscription {subscription.id}: {e}')
+
+        # Commit any deletions
+        if failed_count > 0:
+            db.session.commit()
+
+        print(f'[Push] Sent {sent_count} notifications, {failed_count} failed')
+
+    except ImportError:
+        print("[Push] pywebpush not installed, cannot send notifications")
+    except Exception as e:
+        print(f"[Push] Error sending notifications: {e}")
diff --git a/src/api/recordings.py b/src/api/recordings.py
new file mode 100644
index 00000000..03a7d649
--- /dev/null
+++ b/src/api/recordings.py
@@ -0,0 +1,4056 @@
+"""
+Recording upload, processing, and management.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import re
+import mimetypes
+import time
+import subprocess
+from datetime import datetime, timedelta
+from src.services.job_queue import job_queue
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app, make_response
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+from werkzeug.exceptions import RequestEntityTooLarge
+from sqlalchemy import select
+from email.utils import encode_rfc2231
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.config.app_config import ASR_MIN_SPEAKERS, ASR_MAX_SPEAKERS, ASR_DIARIZE, USE_NEW_TRANSCRIPTION_ARCHITECTURE
+
+
+def _resolve_transcription_model(value):
+    """Apply admin-curated allowlist + default to a candidate model name.
+
+    Resolution:
+      1. If the caller passed a non-empty value:
+         a. If the admin saved a visible-models list in system_setting and the
+            value is in it, accept.
+         b. Else if TRANSCRIPTION_MODELS_AVAILABLE is set and the value is in
+            it, accept.
+         c. Else if neither list is configured, accept (no allowlist enforced).
+         d. Otherwise, drop the value with a warning.
+      2. If the caller passed nothing, fall back to the admin-saved default
+         model (system_setting key `transcription_default_model`) when set.
+    Returns the validated model id or None.
+    """
+    from src.config.app_config import TRANSCRIPTION_MODELS_AVAILABLE
+    import json as _json
+
+    candidate = (value or '').strip() or None
+    visible = []
+    try:
+        raw = SystemSetting.get_setting('transcription_models_visible_json', None)
+        if raw:
+            parsed = _json.loads(raw)
+            if isinstance(parsed, list):
+                visible = [
+                    (item['value'] if isinstance(item, dict) else item)
+                    for item in parsed if item
+                ]
+    except Exception:
+        visible = []
+
+    if candidate:
+        in_db_list = bool(visible) and candidate in visible
+        in_env_list = bool(TRANSCRIPTION_MODELS_AVAILABLE) and candidate in TRANSCRIPTION_MODELS_AVAILABLE
+        if visible or TRANSCRIPTION_MODELS_AVAILABLE:
+            if not (in_db_list or in_env_list):
+                current_app.logger.warning(
+                    f"Ignoring transcription_model={candidate!r} — not in admin-curated list or TRANSCRIPTION_MODELS_AVAILABLE"
+                )
+                candidate = None
+        return candidate
+
+    # Fall back to admin-saved default when no override flowed through.
+    default = SystemSetting.get_setting('transcription_default_model', None)
+    return default or None
+from src.tasks.processing import format_transcription_for_llm
+from src.utils.ffmpeg_utils import FFmpegError, FFmpegNotFoundError
+from src.services.speaker import update_speaker_usage, identify_unidentified_speakers_from_text
+from src.services.speaker_embedding_matcher import update_speaker_embedding
+from src.services.speaker_snippets import create_speaker_snippets
+
+# Incognito mode - disabled by default, enable via environment variable
+ENABLE_INCOGNITO_MODE = os.environ.get('ENABLE_INCOGNITO_MODE', 'false').lower() == 'true'
+from src.services.document import process_markdown_to_docx
+from src.services.llm import client, chat_client, call_llm_completion, call_chat_completion, process_streaming_with_thinking, TokenBudgetExceeded
+from src.services.embeddings import process_recording_chunks
+from src.file_exporter import export_recording, mark_export_as_deleted
+from src.utils.ffprobe import get_codec_info, get_creation_date, FFProbeError
+from src.utils.audio_conversion import convert_if_needed
+from src.utils.file_hash import compute_file_sha256
+
+# Create blueprint
+recordings_bp = Blueprint('recordings', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+DELETION_MODE = os.environ.get('DELETION_MODE', 'full_recording')  # 'audio_only' or 'full_recording'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+VIDEO_RETENTION = os.environ.get('VIDEO_RETENTION', 'false').lower() == 'true'
+VIDEO_PASSTHROUGH_ASR = os.environ.get('VIDEO_PASSTHROUGH_ASR', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+ENABLE_CHUNKING = os.environ.get('ENABLE_CHUNKING', 'true').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+get_user_recording_status = None
+set_user_recording_status = None
+enrich_recording_dict_with_user_status = None
+bcrypt = None
+csrf = None
+limiter = None
+chunking_service = None
+
+def init_recordings_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, get_user_recording_status, set_user_recording_status, enrich_recording_dict_with_user_status, bcrypt, csrf, limiter, chunking_service
+    has_recording_access = kwargs.get('has_recording_access')
+    get_user_recording_status = kwargs.get('get_user_recording_status')
+    set_user_recording_status = kwargs.get('set_user_recording_status')
+    enrich_recording_dict_with_user_status = kwargs.get('enrich_recording_dict_with_user_status')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+    chunking_service = kwargs.get('chunking_service')
+
+
+# --- Routes ---
+
+@recordings_bp.route('/recording/<int:recording_id>/download/transcript')
+@login_required
+def download_transcript_with_template(recording_id):
+    """Download transcript with custom template formatting."""
+    try:
+        import re
+        from datetime import timedelta
+
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        if not recording.transcription:
+            return jsonify({'error': 'No transcription available for this recording'}), 400
+
+        # Get template ID from query params
+        template_id = request.args.get('template_id', type=int)
+
+        # Get the template
+        if template_id:
+            template = TranscriptTemplate.query.filter_by(
+                id=template_id,
+                user_id=current_user.id
+            ).first()
+        else:
+            # Use default template
+            template = TranscriptTemplate.query.filter_by(
+                user_id=current_user.id,
+                is_default=True
+            ).first()
+
+        # If no template found, use a basic format
+        if not template:
+            template_format = "[{{speaker}}]: {{text}}"
+        else:
+            template_format = template.template
+
+        # Helper functions for formatting
+        def format_time(seconds):
+            """Format seconds to HH:MM:SS"""
+            if seconds is None:
+                return "00:00:00"
+            td = timedelta(seconds=seconds)
+            hours = int(td.total_seconds() // 3600)
+            minutes = int((td.total_seconds() % 3600) // 60)
+            secs = int(td.total_seconds() % 60)
+            return f"{hours:02d}:{minutes:02d}:{secs:02d}"
+
+        def format_srt_time(seconds):
+            """Format seconds to SRT format HH:MM:SS,mmm"""
+            if seconds is None:
+                return "00:00:00,000"
+            td = timedelta(seconds=seconds)
+            hours = int(td.total_seconds() // 3600)
+            minutes = int((td.total_seconds() % 3600) // 60)
+            secs = int(td.total_seconds() % 60)
+            millis = int((td.total_seconds() % 1) * 1000)
+            return f"{hours:02d}:{minutes:02d}:{secs:02d},{millis:03d}"
+
+        # Parse transcription - handle both JSON (diarized) and plain text formats
+        is_diarized = False
+        transcription_data = None
+        try:
+            transcription_data = json.loads(recording.transcription)
+            if isinstance(transcription_data, list):
+                is_diarized = True
+        except (json.JSONDecodeError, TypeError):
+            # Not JSON, treat as plain text
+            pass
+
+        # If plain text transcription, return it as-is (no template formatting applies)
+        if not is_diarized:
+            formatted_transcript = recording.transcription
+        else:
+            # Generate formatted transcript from diarized segments
+            output_lines = []
+            for index, segment in enumerate(transcription_data, 1):
+                line = template_format
+
+                # Replace variables
+                replacements = {
+                    '{{index}}': str(index),
+                    '{{speaker}}': segment.get('speaker', 'Unknown'),
+                    '{{text}}': segment.get('sentence', ''),
+                    '{{start_time}}': format_time(segment.get('start_time')),
+                    '{{end_time}}': format_time(segment.get('end_time')),
+                }
+
+                for key, value in replacements.items():
+                    line = line.replace(key, value)
+
+                # Handle filters
+                # Upper case filter
+                line = re.sub(r'{{(.*?)\|upper}}', lambda m: replacements.get('{{' + m.group(1) + '}}', '').upper(), line)
+                # SRT time filter
+                line = re.sub(r'{{start_time\|srt}}', format_srt_time(segment.get('start_time')), line)
+                line = re.sub(r'{{end_time\|srt}}', format_srt_time(segment.get('end_time')), line)
+
+                output_lines.append(line)
+
+            # Join lines
+            formatted_transcript = '\n'.join(output_lines)
+
+        # Create response
+        response = make_response(formatted_transcript)
+        if is_diarized and template:
+            filename = f"{recording.title or 'transcript'}_{template.name}.txt"
+        elif is_diarized:
+            filename = f"{recording.title or 'transcript'}_formatted.txt"
+        else:
+            # Plain text transcription
+            filename = f"{recording.title or 'transcript'}.txt"
+        filename = re.sub(r'[^a-zA-Z0-9_\-\.]', '_', filename)
+        response.headers['Content-Type'] = 'text/plain; charset=utf-8'
+        response.headers['Content-Disposition'] = f'attachment; filename="{filename}"'
+
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error downloading transcript: {e}")
+        return jsonify({'error': 'Failed to generate transcript download'}), 500
+
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/download/summary')
+@login_required
+def download_summary_word(recording_id):
+    """Download recording summary as a Word document."""
+    try:
+        from docx import Document
+        from docx.shared import Inches
+        import re
+        from io import BytesIO
+
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        if not recording.summary:
+            return jsonify({'error': 'No summary available for this recording'}), 400
+
+        # Create Word document
+        doc = Document()
+
+        # Add title
+        title_text = f'Summary: {recording.title or "Untitled Recording"}'
+        title = doc.add_heading(title_text, 0)
+        # Check if title needs Unicode font support
+        try:
+            title_text.encode('ascii')
+        except UnicodeEncodeError:
+            # Title contains non-ASCII characters
+            from docx.oxml.ns import qn
+            for run in title.runs:
+                run.font.name = 'Arial'
+                r = run._element
+                r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+
+        # Helper function to add paragraph with Unicode support
+        def add_unicode_paragraph(doc, text):
+            p = doc.add_paragraph(text)
+            try:
+                text.encode('ascii')
+            except UnicodeEncodeError:
+                from docx.oxml.ns import qn
+                for run in p.runs:
+                    run.font.name = 'Arial'
+                    r = run._element
+                    r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+            return p
+
+        # Add metadata
+        add_unicode_paragraph(doc, f'Uploaded: {recording.created_at.strftime("%Y-%m-%d %H:%M")}')
+        if recording.meeting_date:
+            add_unicode_paragraph(doc, f'Recording Date: {recording.meeting_date.strftime("%Y-%m-%d")}')
+        if recording.participants:
+            add_unicode_paragraph(doc, f'Participants: {recording.participants}')
+        visible_tags = recording.get_visible_tags(current_user)
+        if visible_tags:
+            tags_str = ', '.join([tag.name for tag in visible_tags])
+            add_unicode_paragraph(doc, f'Tags: {tags_str}')
+        doc.add_paragraph('')  # Empty line
+
+        # Process markdown content using the helper function
+        process_markdown_to_docx(doc, recording.summary)
+
+        # Save to BytesIO
+        doc_stream = BytesIO()
+        doc.save(doc_stream)
+        doc_stream.seek(0)
+
+        # Create safe filename
+        safe_title = re.sub(r'[<>:"/\\|?*]', '', recording.title or 'Untitled')
+        safe_title = re.sub(r'[-\s]+', '-', safe_title).strip('-')
+        filename = f'summary-{safe_title}.docx' if safe_title else f'summary-recording-{recording_id}.docx'
+
+        # Create ASCII fallback for send_file - if title has non-ASCII chars, use generic name with ID
+        ascii_filename = filename.encode('ascii', 'ignore').decode('ascii')
+        if not ascii_filename.strip() or ascii_filename.strip() in ['summary-.docx', 'summary-recording-.docx']:
+            ascii_filename = f'summary-recording-{recording_id}.docx'
+
+        response = send_file(
+            doc_stream,
+            as_attachment=False,
+            mimetype='application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+        )
+        # Properly encode filename for international characters
+        # Check if filename contains non-ASCII characters
+        try:
+            # Try to encode as ASCII - if this works, use simple format
+            filename.encode('ascii')
+            # ASCII-only filename, use simple format
+            response.headers['Content-Disposition'] = f'attachment; filename="{filename}"'
+        except UnicodeEncodeError:
+            # Contains non-ASCII characters, use proper RFC 2231 encoding
+            try:
+                # Use Python's built-in RFC 2231 encoder
+                encoded_value = encode_rfc2231(filename, charset='utf-8')
+                header_value = f'attachment; filename*={encoded_value}'
+                current_app.logger.info(f"DEBUG CHINESE FILENAME (RFC2231): Original='{filename}', Header='{header_value}'")
+                response.headers['Content-Disposition'] = header_value
+            except Exception as e:
+                # Fallback to simple attachment with generic name
+                current_app.logger.error(f"RFC2231 encoding failed: {e}, using fallback")
+                response.headers['Content-Disposition'] = f'attachment; filename="download-{recording_id}.docx"'
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating summary Word document: {e}")
+        return jsonify({'error': 'Failed to generate Word document'}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/download/chat', methods=['POST'])
+@login_required
+def download_chat_word(recording_id):
+    """Download chat conversation as a Word document."""
+    try:
+        from docx import Document
+        from docx.shared import Inches
+        import re
+        from io import BytesIO
+
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        # Get chat messages from request
+        data = request.json
+        if not data or 'messages' not in data:
+            return jsonify({'error': 'No messages provided'}), 400
+
+        messages = data['messages']
+        if not messages:
+            return jsonify({'error': 'No messages to download'}), 400
+
+        # Create Word document
+        doc = Document()
+
+        # Add title
+        title_text = f'Chat Conversation: {recording.title or "Untitled Recording"}'
+        title = doc.add_heading(title_text, 0)
+        # Check if title needs Unicode font support
+        try:
+            title_text.encode('ascii')
+        except UnicodeEncodeError:
+            from docx.oxml.ns import qn
+            for run in title.runs:
+                run.font.name = 'Arial'
+                r = run._element
+                r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+
+        # Helper function to add paragraph with Unicode support
+        def add_unicode_paragraph(doc, text):
+            p = doc.add_paragraph(text)
+            try:
+                text.encode('ascii')
+            except UnicodeEncodeError:
+                from docx.oxml.ns import qn
+                for run in p.runs:
+                    run.font.name = 'Arial'
+                    r = run._element
+                    r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+            return p
+
+        # Add metadata
+        add_unicode_paragraph(doc, f'Recording Date: {recording.created_at.strftime("%Y-%m-%d %H:%M")}')
+        add_unicode_paragraph(doc, f'Chat Export Date: {datetime.utcnow().strftime("%Y-%m-%d %H:%M")}')
+        doc.add_paragraph('')  # Empty line
+
+        # Add chat messages
+        for message in messages:
+            role = message.get('role', 'unknown')
+            content = message.get('content', '')
+            thinking = message.get('thinking', '')
+
+            # Add role header
+            if role == 'user':
+                p = doc.add_paragraph()
+                run = p.add_run('You: ')
+                run.bold = True
+            elif role == 'assistant':
+                p = doc.add_paragraph()
+                run = p.add_run('Assistant: ')
+                run.bold = True
+            else:
+                p = doc.add_paragraph()
+                run = p.add_run(f'{role.title()}: ')
+                run.bold = True
+
+            # Add thinking content if present
+            if thinking and role == 'assistant':
+                p = doc.add_paragraph()
+                p.add_run('[Model Reasoning]\n').italic = True
+                p.add_run(thinking).italic = True
+                doc.add_paragraph('')  # Empty line
+
+            # Add message content with markdown formatting
+            process_markdown_to_docx(doc, content)
+
+            doc.add_paragraph('')  # Empty line between messages
+
+        # Save to BytesIO
+        doc_stream = BytesIO()
+        doc.save(doc_stream)
+        doc_stream.seek(0)
+
+        # Create safe filename
+        safe_title = re.sub(r'[<>:"/\\|?*]', '', recording.title or 'Untitled')
+        safe_title = re.sub(r'[-\s]+', '-', safe_title).strip('-')
+        filename = f'chat-{safe_title}.docx' if safe_title else f'chat-recording-{recording_id}.docx'
+
+        # Create ASCII fallback for send_file - if title has non-ASCII chars, use generic name with ID
+        ascii_filename = filename.encode('ascii', 'ignore').decode('ascii')
+        if not ascii_filename.strip() or ascii_filename.strip() in ['chat-.docx', 'chat-recording-.docx']:
+            ascii_filename = f'chat-recording-{recording_id}.docx'
+
+        response = send_file(
+            doc_stream,
+            as_attachment=False,
+            mimetype='application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+        )
+
+        # Properly encode filename for international characters
+        # Check if filename contains non-ASCII characters
+        try:
+            # Try to encode as ASCII - if this works, use simple format
+            filename.encode('ascii')
+            # ASCII-only filename, use simple format
+            response.headers['Content-Disposition'] = f'attachment; filename="{filename}"'
+        except UnicodeEncodeError:
+            # Contains non-ASCII characters, use proper RFC 2231 encoding
+            try:
+                # Use Python's built-in RFC 2231 encoder
+                encoded_value = encode_rfc2231(filename, charset='utf-8')
+                header_value = f'attachment; filename*={encoded_value}'
+                current_app.logger.info(f"DEBUG CHINESE FILENAME (RFC2231): Original='{filename}', Header='{header_value}'")
+                response.headers['Content-Disposition'] = header_value
+            except Exception as e:
+                # Fallback to simple attachment with generic name
+                current_app.logger.error(f"RFC2231 encoding failed: {e}, using fallback")
+                response.headers['Content-Disposition'] = f'attachment; filename="download-{recording_id}.docx"'
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating chat Word document: {e}")
+        return jsonify({'error': 'Failed to generate Word document'}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/download/notes')
+@login_required
+def download_notes_word(recording_id):
+    """Download recording notes as a Word document."""
+    try:
+        from docx import Document
+        from docx.shared import Inches
+        import re
+        from io import BytesIO
+
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        if not recording.notes:
+            return jsonify({'error': 'No notes available for this recording'}), 400
+
+        # Create Word document
+        doc = Document()
+
+        # Add title
+        title_text = f'Notes: {recording.title or "Untitled Recording"}'
+        title = doc.add_heading(title_text, 0)
+        # Check if title needs Unicode font support
+        try:
+            title_text.encode('ascii')
+        except UnicodeEncodeError:
+            from docx.oxml.ns import qn
+            for run in title.runs:
+                run.font.name = 'Arial'
+                r = run._element
+                r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+
+        # Helper function to add paragraph with Unicode support
+        def add_unicode_paragraph(doc, text):
+            p = doc.add_paragraph(text)
+            try:
+                text.encode('ascii')
+            except UnicodeEncodeError:
+                from docx.oxml.ns import qn
+                for run in p.runs:
+                    run.font.name = 'Arial'
+                    r = run._element
+                    r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+            return p
+
+        # Add metadata
+        add_unicode_paragraph(doc, f'Uploaded: {recording.created_at.strftime("%Y-%m-%d %H:%M")}')
+        if recording.meeting_date:
+            add_unicode_paragraph(doc, f'Recording Date: {recording.meeting_date.strftime("%Y-%m-%d")}')
+        if recording.participants:
+            add_unicode_paragraph(doc, f'Participants: {recording.participants}')
+        visible_tags = recording.get_visible_tags(current_user)
+        if visible_tags:
+            tags_str = ', '.join([tag.name for tag in visible_tags])
+            add_unicode_paragraph(doc, f'Tags: {tags_str}')
+        doc.add_paragraph('')  # Empty line
+
+        # Process markdown content using the helper function
+        process_markdown_to_docx(doc, recording.notes)
+
+        # Save to BytesIO
+        doc_stream = BytesIO()
+        doc.save(doc_stream)
+        doc_stream.seek(0)
+
+        # Create safe filename
+        safe_title = re.sub(r'[<>:"/\\|?*]', '', recording.title or 'Untitled')
+        safe_title = re.sub(r'[-\s]+', '-', safe_title).strip('-')
+        filename = f'notes-{safe_title}.docx' if safe_title else f'notes-recording-{recording_id}.docx'
+
+        # Create ASCII fallback for send_file - if title has non-ASCII chars, use generic name with ID
+        ascii_filename = filename.encode('ascii', 'ignore').decode('ascii')
+        if not ascii_filename.strip() or ascii_filename.strip() in ['notes-.docx', 'notes-recording-.docx']:
+            ascii_filename = f'notes-recording-{recording_id}.docx'
+
+        response = send_file(
+            doc_stream,
+            as_attachment=False,
+            mimetype='application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+        )
+        # Properly encode filename for international characters
+        # Check if filename contains non-ASCII characters
+        try:
+            # Try to encode as ASCII - if this works, use simple format
+            filename.encode('ascii')
+            # ASCII-only filename, use simple format
+            response.headers['Content-Disposition'] = f'attachment; filename="{filename}"'
+        except UnicodeEncodeError:
+            # Contains non-ASCII characters, use proper RFC 2231 encoding
+            try:
+                # Use Python's built-in RFC 2231 encoder
+                encoded_value = encode_rfc2231(filename, charset='utf-8')
+                header_value = f'attachment; filename*={encoded_value}'
+                current_app.logger.info(f"DEBUG CHINESE FILENAME (RFC2231): Original='{filename}', Header='{header_value}'")
+                response.headers['Content-Disposition'] = header_value
+            except Exception as e:
+                # Fallback to simple attachment with generic name
+                current_app.logger.error(f"RFC2231 encoding failed: {e}, using fallback")
+                response.headers['Content-Disposition'] = f'attachment; filename="download-{recording_id}.docx"'
+        return response
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating notes Word document: {e}")
+        return jsonify({'error': 'Failed to generate Word document'}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/generate_summary', methods=['POST'])
+@login_required
+def generate_summary_endpoint(recording_id):
+    """Generate summary for a recording that doesn't have one.
+
+    Optional JSON body:
+      - custom_prompt (string): user-supplied summarization instructions.
+      - prompt_mode ('replace' | 'append', default 'replace'): in 'replace'
+        mode the custom prompt overrides the resolved default; in 'append'
+        mode it is appended after the resolved default as additional context.
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to generate summary for this recording'}), 403
+
+        # Check if transcription exists
+        if not recording.transcription or len(recording.transcription.strip()) < 10:
+            return jsonify({'error': 'No valid transcription available for summary generation'}), 400
+
+        # Check if transcription is an error message (not actual content)
+        if is_transcription_error(recording.transcription):
+            return jsonify({'error': 'Cannot generate summary: transcription failed. Please reprocess the transcription first.'}), 400
+
+        # Check if already processing
+        if recording.status in ['PROCESSING', 'SUMMARIZING']:
+            return jsonify({'error': 'Recording is already being processed'}), 400
+
+        # Check if OpenRouter client is available
+        if client is None:
+            return jsonify({'error': 'Summary service is not available (OpenRouter client not configured)'}), 503
+
+        # Optional custom prompt + mode (issue / discussion #253)
+        data = request.get_json(silent=True) or {}
+        raw_prompt = data.get('custom_prompt')
+        custom_prompt = raw_prompt.strip() if isinstance(raw_prompt, str) and raw_prompt.strip() else None
+        prompt_mode = (data.get('prompt_mode') or 'replace').strip().lower()
+        if prompt_mode not in ('replace', 'append'):
+            prompt_mode = 'replace'
+        custom_prompt_append = bool(custom_prompt) and prompt_mode == 'append'
+
+        current_app.logger.info(
+            f"Queueing summary generation for recording {recording_id}"
+            + (f" with custom prompt (mode={prompt_mode}, length={len(custom_prompt)})" if custom_prompt else "")
+        )
+
+        # Queue summary generation job
+        job_params = {'user_id': current_user.id}
+        if custom_prompt:
+            job_params['custom_prompt'] = custom_prompt
+            job_params['custom_prompt_append'] = custom_prompt_append
+
+        job_queue.enqueue(
+            user_id=current_user.id,
+            recording_id=recording.id,
+            job_type='summarize',
+            params=job_params,
+        )
+
+        return jsonify({
+            'success': True,
+            'message': 'Summary generation queued'
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error starting summary generation for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/update_speakers', methods=['POST'])
+@login_required
+def update_speakers(recording_id):
+    """Updates speaker labels in a transcription with provided names."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
+
+        data = request.json
+        speaker_map = data.get('speaker_map')
+        regenerate_summary = data.get('regenerate_summary', False)
+
+        if speaker_map is None:
+            return jsonify({'error': 'No speaker map provided'}), 400
+
+        transcription_text = recording.transcription
+        is_json = False
+        try:
+            transcription_data = json.loads(transcription_text)
+            # Updated check for our new simplified JSON format (a list of segment objects)
+            is_json = isinstance(transcription_data, list)
+        except (json.JSONDecodeError, TypeError):
+            is_json = False
+
+        speaker_names_used = []
+
+        if is_json:
+            # Handle new simplified JSON transcript (list of segments)
+            for segment in transcription_data:
+                original_speaker_label = segment.get('speaker')
+                if original_speaker_label in speaker_map:
+                    new_name_info = speaker_map[original_speaker_label]
+                    new_name = new_name_info.get('name', '').strip()
+                    # If isMe is checked but no name provided, use current user's name
+                    if new_name_info.get('isMe') and not new_name:
+                        new_name = current_user.name or 'Me'
+
+                    if new_name:
+                        segment['speaker'] = new_name
+                        if new_name not in speaker_names_used:
+                            speaker_names_used.append(new_name)
+
+            recording.transcription = json.dumps(transcription_data)
+
+            # Update participants only from speakers that were actually given names (not default labels)
+            final_speakers = set()
+            for seg in transcription_data:
+                speaker = seg.get('speaker')
+                if speaker and str(speaker).strip():
+                    # Only include speakers that have been given actual names (not default labels like "SPEAKER_01", "SPEAKER_09", etc.)
+                    # Check if this speaker was updated with a real name (not a default label)
+                    if not re.match(r'^SPEAKER_\d+$', str(speaker), re.IGNORECASE):
+                        final_speakers.add(speaker)
+            recording.participants = ', '.join(sorted(list(final_speakers)))
+
+        else:
+            # Handle plain text transcript
+            new_participants = []
+            for speaker_label, new_name_info in speaker_map.items():
+                new_name = new_name_info.get('name', '').strip()
+                # If isMe is checked but no name provided, use current user's name
+                if new_name_info.get('isMe') and not new_name:
+                    new_name = current_user.name or 'Me'
+
+                if new_name:
+                    transcription_text = re.sub(r'\[\s*' + re.escape(speaker_label) + r'\s*\]', f'[{new_name}]', transcription_text, flags=re.IGNORECASE)
+                    if new_name not in new_participants:
+                        new_participants.append(new_name)
+
+            recording.transcription = transcription_text
+            if new_participants:
+                recording.participants = ', '.join(new_participants)
+            speaker_names_used = new_participants
+
+        # Update speaker usage statistics
+        if speaker_names_used:
+            update_speaker_usage(speaker_names_used)
+
+        # Update speaker voice embeddings if available
+        embeddings_updated = 0
+        snippets_created = 0
+        if recording.speaker_embeddings and speaker_map:
+            try:
+                # Parse embeddings from recording
+                embeddings_data = json.loads(recording.speaker_embeddings) if isinstance(recording.speaker_embeddings, str) else recording.speaker_embeddings
+
+                # Build reverse map: SPEAKER_XX -> actual name assigned
+                speaker_label_to_name = {}
+                for speaker_label, speaker_info in speaker_map.items():
+                    name = speaker_info.get('name', '').strip()
+                    # Handle isMe checkbox
+                    if speaker_info.get('isMe') and not name:
+                        name = current_user.name or 'Me'
+
+                    # Only include speakers that were given real names (not SPEAKER_XX)
+                    if name and not re.match(r'^SPEAKER_\d+$', name, re.IGNORECASE):
+                        speaker_label_to_name[speaker_label] = name
+
+                # Update embeddings for each identified speaker
+                for speaker_label, embedding in embeddings_data.items():
+                    if speaker_label in speaker_label_to_name and embedding and len(embedding) == 256:
+                        speaker_name = speaker_label_to_name[speaker_label]
+
+                        # Find or create the speaker
+                        speaker = Speaker.query.filter_by(
+                            user_id=current_user.id,
+                            name=speaker_name
+                        ).first()
+
+                        if speaker:
+                            # Update the speaker's voice embedding
+                            similarity = update_speaker_embedding(speaker, embedding, recording.id)
+                            embeddings_updated += 1
+
+                            if similarity is not None:
+                                current_app.logger.info(
+                                    f"Updated voice profile for '{speaker_name}' "
+                                    f"(similarity: {similarity*100:.1f}%)"
+                                )
+                            else:
+                                current_app.logger.info(
+                                    f"Created initial voice profile for '{speaker_name}'"
+                                )
+
+                # Create snippets for identified speakers
+                if speaker_label_to_name:
+                    snippets_created = create_speaker_snippets(recording.id, speaker_map)
+                    if snippets_created > 0:
+                        current_app.logger.info(f"Created {snippets_created} speaker snippets")
+
+            except Exception as e:
+                current_app.logger.error(f"Error updating speaker embeddings: {e}", exc_info=True)
+                # Don't fail the whole request if embedding update fails
+
+        db.session.commit()
+
+        summary_queued = False
+        if regenerate_summary:
+            current_app.logger.info(f"Queueing summary regeneration for recording {recording_id} after speaker update.")
+            job_queue.enqueue(
+                user_id=current_user.id,
+                recording_id=recording.id,
+                job_type='summarize',
+                params={'user_id': current_user.id}
+            )
+            summary_queued = True
+
+        # Return recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'message': 'Speakers updated successfully.',
+            'recording': recording_dict,
+            'summary_queued': summary_queued
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error updating speakers for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': str(e)}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/update_transcript', methods=['POST'])
+@login_required
+def update_transcript(recording_id):
+    """Updates the complete transcript data including text edits and speaker changes."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
+
+        data = request.json
+        transcript_data = data.get('transcript_data')
+        speaker_map = data.get('speaker_map', {})
+        regenerate_summary = data.get('regenerate_summary', False)
+
+        if not transcript_data or not isinstance(transcript_data, list):
+            return jsonify({'error': 'Invalid transcript data provided'}), 400
+
+        # Update speaker names in the transcript data
+        speaker_names_used = []
+        for segment in transcript_data:
+            original_speaker_label = segment.get('speaker')
+
+            # Apply speaker name mapping if provided
+            if original_speaker_label in speaker_map:
+                new_name_info = speaker_map[original_speaker_label]
+                new_name = new_name_info.get('name', '').strip()
+                if new_name_info.get('isMe'):
+                    new_name = current_user.name or 'Me'
+
+                if new_name:
+                    segment['speaker'] = new_name
+                    if new_name not in speaker_names_used:
+                        speaker_names_used.append(new_name)
+
+        # Save the updated transcript
+        recording.transcription = json.dumps(transcript_data)
+
+        # Update participants
+        final_speakers = set()
+        for seg in transcript_data:
+            speaker = seg.get('speaker')
+            if speaker and str(speaker).strip():
+                # Only include speakers with real names (not default labels)
+                if not re.match(r'^SPEAKER_\d+$', str(speaker), re.IGNORECASE):
+                    final_speakers.add(speaker)
+        recording.participants = ', '.join(sorted(list(final_speakers)))
+
+        # Update speaker usage statistics
+        if speaker_names_used:
+            update_speaker_usage(speaker_names_used)
+
+        db.session.commit()
+
+        summary_queued = False
+        if regenerate_summary:
+            current_app.logger.info(f"Queueing summary regeneration for recording {recording_id} after transcript update.")
+            job_queue.enqueue(
+                user_id=current_user.id,
+                recording_id=recording.id,
+                job_type='summarize',
+                params={'user_id': current_user.id}
+            )
+            summary_queued = True
+            # Export will happen after summary regenerates
+        else:
+            # Re-export the recording if auto-export is enabled
+            export_recording(recording_id)
+
+        # Return recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'message': 'Transcript updated successfully.',
+            'recording': recording_dict,
+            'summary_queued': summary_queued
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error updating transcript for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': str(e)}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/auto_identify_speakers', methods=['POST'])
+@login_required
+def auto_identify_speakers(recording_id):
+    """
+    Automatically identifies speakers in a transcription using an LLM.
+    Strips existing names and re-identifies all speakers from scratch.
+    """
+    from src.services.speaker_identification import identify_speakers_from_transcript
+
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+
+        if not recording.transcription:
+            return jsonify({'error': 'No transcription available for speaker identification'}), 400
+
+        try:
+            transcription_data = json.loads(recording.transcription)
+        except (json.JSONDecodeError, TypeError):
+            return jsonify({'error': 'Transcription format not supported for auto-identification'}), 400
+
+        if not isinstance(transcription_data, list):
+            return jsonify({'error': 'Transcription format not supported for auto-identification'}), 400
+
+        speaker_map = identify_speakers_from_transcript(transcription_data, current_user.id)
+
+        if not speaker_map:
+            return jsonify({'error': 'No speakers found in transcription'}), 400
+
+        return jsonify({'success': True, 'speaker_map': speaker_map})
+
+    except ValueError as ve:
+        return jsonify({'error': str(ve)}), 503
+    except Exception as e:
+        current_app.logger.error(f"Error during auto speaker identification for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': f'An unexpected error occurred: {str(e)}'}), 500
+
+# --- Chat with Transcription ---
+
+
+@recordings_bp.route('/recording/<int:recording_id>/reprocess_transcription', methods=['POST'])
+@login_required
+def reprocess_transcription(recording_id):
+    """Reprocess transcription for a given recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to reprocess this recording'}), 403
+
+        if not recording.audio_path or not os.path.exists(recording.audio_path):
+            return jsonify({'error': 'Audio file not found for reprocessing'}), 404
+
+        if recording.status in ['QUEUED', 'PROCESSING', 'SUMMARIZING']:
+            return jsonify({'error': 'Recording is already being processed'}), 400
+
+        # File path and name for processing (conversion handled in background task if needed)
+        filepath = recording.audio_path
+        filename_for_asr = recording.original_filename or os.path.basename(filepath)
+
+        # --- Proceed with reprocessing ---
+        recording.transcription = None
+        recording.summary = None
+        recording.status = 'QUEUED'  # Will change to PROCESSING when job starts
+
+        # Clear existing events since they depend on the transcription
+        Event.query.filter_by(recording_id=recording_id).delete()
+
+        db.session.commit()
+
+        current_app.logger.info(f"Queueing transcription reprocessing for recording {recording_id}")
+
+        # Prepare job parameters
+        data = request.json or {}
+        start_time = datetime.utcnow()
+        app_context = current_app._get_current_object().app_context()
+
+        # Build job parameters - language handling:
+        # - If 'language' key exists with a value (e.g., 'es'), use that language
+        # - If 'language' key exists but is empty string, keep as empty string (signals auto-detect)
+        # - If 'language' key doesn't exist at all, fall back to user's default (backwards compat)
+        if 'language' in data:
+            # User explicitly chose a language (or auto-detect with empty string)
+            language = data.get('language')  # Could be 'es', '', or None
+        else:
+            # Language not provided - use user's default (backwards compatibility)
+            language = recording.owner.transcription_language if recording.owner else None
+
+        min_speakers = data.get('min_speakers') or None
+        max_speakers = data.get('max_speakers') or None
+        hotwords = (data.get('hotwords') or '').strip() or None
+        initial_prompt = (data.get('initial_prompt') or '').strip() or None
+        transcription_model = (data.get('transcription_model') or '').strip() or None
+
+        # Convert to int if provided
+        if min_speakers:
+            try:
+                min_speakers = int(min_speakers)
+            except (ValueError, TypeError):
+                min_speakers = None
+        if max_speakers:
+            try:
+                max_speakers = int(max_speakers)
+            except (ValueError, TypeError):
+                max_speakers = None
+
+        # Apply precedence chain mirroring upload_file():
+        #   user input > tag defaults > folder defaults > env defaults > user defaults
+
+        # Tag defaults (highest priority after user input). Use the first tag's
+        # defaults when present.
+        if recording.tags:
+            for tag_association in sorted(recording.tag_associations, key=lambda x: x.order):
+                tag = tag_association.tag
+                if min_speakers is None and tag.default_min_speakers:
+                    min_speakers = tag.default_min_speakers
+                if max_speakers is None and tag.default_max_speakers:
+                    max_speakers = tag.default_max_speakers
+                if not hotwords and tag.default_hotwords:
+                    hotwords = tag.default_hotwords
+                if not initial_prompt and tag.default_initial_prompt:
+                    initial_prompt = tag.default_initial_prompt
+                if not transcription_model and tag.default_transcription_model:
+                    transcription_model = tag.default_transcription_model
+                if (min_speakers is not None and max_speakers is not None
+                        and hotwords and initial_prompt and transcription_model):
+                    break
+
+        # Folder defaults (only if recording has no tags providing the value)
+        if recording.folder:
+            folder = recording.folder
+            if min_speakers is None and folder.default_min_speakers:
+                min_speakers = folder.default_min_speakers
+            if max_speakers is None and folder.default_max_speakers:
+                max_speakers = folder.default_max_speakers
+            if not hotwords and folder.default_hotwords:
+                hotwords = folder.default_hotwords
+            if not initial_prompt and folder.default_initial_prompt:
+                initial_prompt = folder.default_initial_prompt
+            if not transcription_model and folder.default_transcription_model:
+                transcription_model = folder.default_transcription_model
+
+        # Environment variable defaults
+        if min_speakers is None and ASR_MIN_SPEAKERS:
+            try:
+                min_speakers = int(ASR_MIN_SPEAKERS)
+            except (ValueError, TypeError):
+                min_speakers = None
+        if max_speakers is None and ASR_MAX_SPEAKERS:
+            try:
+                max_speakers = int(ASR_MAX_SPEAKERS)
+            except (ValueError, TypeError):
+                max_speakers = None
+
+        # User defaults (lowest priority). The recording owner's account-level
+        # hotwords / initial_prompt apply when no tag/folder/env value was set.
+        owner = recording.owner
+        if owner:
+            if not hotwords and owner.transcription_hotwords:
+                hotwords = owner.transcription_hotwords
+            if not initial_prompt and owner.transcription_initial_prompt:
+                initial_prompt = owner.transcription_initial_prompt
+
+        # Validate against admin-curated list and apply admin default when
+        # nothing else in the chain set a model. See _resolve_transcription_model.
+        transcription_model = _resolve_transcription_model(transcription_model)
+
+        # Enqueue the job with all parameters
+        job_params = {
+            'language': language,
+            'min_speakers': min_speakers,
+            'max_speakers': max_speakers,
+            'hotwords': hotwords,
+            'initial_prompt': initial_prompt,
+            'transcription_model': transcription_model,
+        }
+
+        job_id = job_queue.enqueue(
+            user_id=current_user.id,
+            recording_id=recording.id,
+            job_type='reprocess_transcription',
+            params=job_params
+        )
+
+        # Get queue position for response
+        queue_position = job_queue.get_position_in_queue(recording.id)
+        queue_status = job_queue.get_queue_status()
+
+        # Return recording with per-user status and queue info
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'message': 'Transcription reprocessing queued',
+            'recording': recording_dict,
+            'queue_position': queue_position,
+            'queue_status': queue_status
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error reprocessing transcription for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/reprocess_summary', methods=['POST'])
+@login_required
+def reprocess_summary(recording_id):
+    """Reprocess summary for a given recording (requires existing transcription)."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to reprocess this recording'}), 403
+
+        # Check if transcription exists
+        if not recording.transcription or len(recording.transcription.strip()) < 10:
+            return jsonify({'error': 'No valid transcription available for summary generation'}), 400
+
+        # Check if transcription is an error message (not actual content)
+        if is_transcription_error(recording.transcription):
+            return jsonify({'error': 'Cannot generate summary: transcription failed. Please reprocess the transcription first.'}), 400
+
+        # Check if already processing
+        if recording.status in ['PROCESSING', 'SUMMARIZING']:
+            return jsonify({'error': 'Recording is already being processed'}), 400
+
+        # Check if OpenRouter client is available
+        if client is None:
+            return jsonify({'error': 'Summary service is not available (OpenRouter client not configured)'}), 503
+
+        # Get custom prompt + mode from request if provided
+        data = request.get_json() or {}
+        custom_prompt = data.get('custom_prompt', '').strip() if data.get('custom_prompt') else None
+        prompt_mode = (data.get('prompt_mode') or 'replace').strip().lower()
+        if prompt_mode not in ('replace', 'append'):
+            prompt_mode = 'replace'
+        custom_prompt_append = bool(custom_prompt) and prompt_mode == 'append'
+
+        # Debug logging
+        if custom_prompt:
+            current_app.logger.info(
+                f"Received custom prompt override for recording {recording_id} "
+                f"(mode={prompt_mode}, length={len(custom_prompt)})"
+            )
+        else:
+            current_app.logger.info(f"No custom prompt override provided for recording {recording_id}, will use default priority")
+
+        # Per-recording prompt-template variables. Sanitised through the same
+        # helper used at upload time so reprocess can't bypass the caps.
+        from src.utils.prompt_variables import sanitize_variable_values
+        raw_prompt_variables = data.get('prompt_variables')
+        if raw_prompt_variables is not None:
+            recording.prompt_variables = sanitize_variable_values(raw_prompt_variables)
+
+        # Clear existing summary (status will be set to QUEUED by job_queue.enqueue)
+        recording.summary = None
+
+        # Clear existing events since they might be re-extracted during summary generation
+        Event.query.filter_by(recording_id=recording_id).delete()
+
+        db.session.commit()
+
+        current_app.logger.info(f"Queueing summary reprocessing for recording {recording_id}" +
+                       (f" with custom prompt (length: {len(custom_prompt)})" if custom_prompt else ""))
+
+        # Queue summary generation job
+        job_params = {
+            'custom_prompt': custom_prompt,
+            'custom_prompt_append': custom_prompt_append,
+            'user_id': current_user.id
+        }
+        job_queue.enqueue(
+            user_id=current_user.id,
+            recording_id=recording.id,
+            job_type='reprocess_summary',
+            params=job_params
+        )
+
+        # Refresh recording to get updated status
+        db.session.refresh(recording)
+
+        # Return recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'message': 'Summary reprocessing started',
+            'recording': recording_dict
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error reprocessing summary for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@recordings_bp.route('/recording/<int:recording_id>/regenerate_title', methods=['POST'])
+@login_required
+def regenerate_title(recording_id):
+    """Regenerate the AI title for a recording based on its existing transcription."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
+
+        if not recording.transcription or len(recording.transcription.strip()) < 10:
+            return jsonify({'error': 'No valid transcription available for title generation'}), 400
+
+        if is_transcription_error(recording.transcription):
+            return jsonify({'error': 'Cannot generate title: transcription failed. Please reprocess the transcription first.'}), 400
+
+        if client is None:
+            return jsonify({'error': 'Title generation service is not available (OpenRouter client not configured)'}), 503
+
+        from src.tasks.processing import _generate_ai_title
+
+        new_title = _generate_ai_title(recording)
+        if not new_title:
+            return jsonify({'error': 'Failed to generate a title'}), 500
+
+        recording.title = new_title
+        db.session.commit()
+
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'title': new_title,
+            'recording': recording_dict
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error regenerating title for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/recording/<int:recording_id>/reset_status', methods=['POST'])
+@login_required
+def reset_status(recording_id):
+    """Resets the status of a stuck or failed recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+
+        # Allow resetting if it's stuck or failed
+        if recording.status in ['PENDING', 'PROCESSING', 'SUMMARIZING', 'FAILED']:
+            recording.status = 'FAILED'
+            recording.error_message = "Manually reset from stuck or failed state."
+            db.session.commit()
+            current_app.logger.info(f"Manually reset status for recording {recording_id} to FAILED.")
+
+            # Return recording with per-user status
+            recording_dict = recording.to_dict(viewer_user=current_user)
+            enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+            return jsonify({'success': True, 'message': 'Recording status has been reset.', 'recording': recording_dict})
+        else:
+            return jsonify({'error': f'Recording is not in a state that can be reset. Current status: {recording.status}'}), 400
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error resetting status for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+# --- Authentication Routes ---
+
+
+@recordings_bp.route('/')
+@login_required
+def index():
+    # Check if user is a group admin
+    is_team_admin = GroupMembership.query.filter_by(
+        user_id=current_user.id,
+        role='admin'
+    ).first() is not None
+
+    # Pass the ASR config, inquire mode config, and user language preference to the template
+    user_language = current_user.ui_language if current_user.is_authenticated and current_user.ui_language else 'en'
+
+    # Calculate if archive toggle should be shown (only when audio-only deletion mode is active)
+    enable_archive_toggle = ENABLE_AUTO_DELETION and DELETION_MODE == 'audio_only'
+
+    # Get connector capabilities (new architecture)
+    # Defaults to USE_ASR_ENDPOINT for backwards compatibility
+    connector_supports_diarization = USE_ASR_ENDPOINT
+    connector_supports_speaker_count = USE_ASR_ENDPOINT  # ASR endpoint supports min/max speakers
+    connector_supports_hotwords = USE_ASR_ENDPOINT
+    connector_supports_initial_prompt = USE_ASR_ENDPOINT
+    if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+        try:
+            from src.services.transcription import get_registry
+            registry = get_registry()
+            connector = registry.get_active_connector()
+            if connector:
+                connector_supports_diarization = connector.supports_diarization
+                connector_supports_speaker_count = connector.supports_speaker_count_control
+                connector_supports_hotwords = connector.supports_hotwords
+                connector_supports_initial_prompt = connector.supports_initial_prompt
+        except Exception as e:
+            current_app.logger.warning(f"Could not get connector capabilities: {e}")
+
+    return render_template('index.html',
+                         use_asr_endpoint=USE_ASR_ENDPOINT,  # Backwards compat
+                         connector_supports_diarization=connector_supports_diarization,
+                         connector_supports_speaker_count=connector_supports_speaker_count,
+                         connector_supports_hotwords=connector_supports_hotwords,
+                         connector_supports_initial_prompt=connector_supports_initial_prompt,
+                         inquire_mode_enabled=ENABLE_INQUIRE_MODE,
+                         enable_archive_toggle=enable_archive_toggle,
+                         enable_internal_sharing=ENABLE_INTERNAL_SHARING,
+                         user_language=user_language,
+                         is_team_admin=is_team_admin)
+
+
+
+def get_accessible_recording_ids(user_id):
+    """
+    Get all recording IDs that a user has access to.
+
+    Includes:
+    - Recordings owned by the user
+    - Recordings shared with the user via InternalShare
+    - Recordings shared via group tags (if team membership exists)
+
+    Args:
+        user_id (int): User ID to check access for
+
+    Returns:
+        list: List of recording IDs the user can access
+    """
+    accessible_ids = set()
+
+    # 1. User's own recordings
+    own_recordings = db.session.query(Recording.id).filter_by(user_id=user_id).all()
+    accessible_ids.update([r.id for r in own_recordings])
+
+    # 2. Internally shared recordings
+    if ENABLE_INTERNAL_SHARING:
+        shared_recordings = db.session.query(InternalShare.recording_id).filter_by(
+            shared_with_user_id=user_id
+        ).all()
+        accessible_ids.update([r.recording_id for r in shared_recordings])
+
+    return list(accessible_ids)
+
+
+@recordings_bp.route('/recordings', methods=['GET'])
+def get_recordings():
+    """Get all recordings for the current user (simple list)."""
+    try:
+        # Check if user is logged in
+        if not current_user.is_authenticated:
+            return jsonify([])  # Return empty array if not logged in
+
+        # Filter recordings by the current user
+        stmt = select(Recording).where(Recording.user_id == current_user.id).order_by(Recording.created_at.desc())
+        recordings = db.session.execute(stmt).scalars().all()
+        return jsonify([recording.to_dict(viewer_user=current_user) for recording in recordings])
+    except Exception as e:
+        current_app.logger.error(f"Error fetching recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/api/recordings', methods=['GET'])
+@login_required
+def get_recordings_paginated():
+    """Get recordings with pagination and server-side filtering (includes shared recordings)."""
+    import re
+    try:
+        # Parse query parameters
+        page = request.args.get('page', 1, type=int)
+        per_page = min(request.args.get('per_page', 25, type=int), 100)  # Cap at 100 per page
+        search_query = request.args.get('q', '').strip()
+        show_archived = request.args.get('archived', '').lower() == 'true'
+        show_shared = request.args.get('shared', '').lower() == 'true'
+        show_starred = request.args.get('starred', '').lower() == 'true'
+        show_inbox = request.args.get('inbox', '').lower() == 'true'
+        sort_by = request.args.get('sort_by', 'created_at')  # 'created_at' or 'meeting_date'
+        folder_filter = request.args.get('folder', '').strip()  # folder_id or 'none' for no folder
+
+        # Get all accessible recording IDs (own + shared)
+        accessible_recording_ids = get_accessible_recording_ids(current_user.id)
+
+        if not accessible_recording_ids:
+            return jsonify({
+                'recordings': [],
+                'pagination': {
+                    'page': page,
+                    'per_page': per_page,
+                    'total': 0,
+                    'total_pages': 0,
+                    'has_next': False,
+                    'has_prev': False
+                }
+            })
+
+        # Build base query to include accessible recordings
+        stmt = select(Recording).where(Recording.id.in_(accessible_recording_ids))
+
+        # Apply archived filter (AND with other filters)
+        if show_archived:
+            # Only show recordings where audio has been deleted
+            stmt = stmt.where(Recording.audio_deleted_at.is_not(None))
+
+        # Apply shared filter (AND with other filters)
+        if show_shared:
+            # Only show recordings shared with current user (not owned by them)
+            stmt = stmt.where(Recording.user_id != current_user.id)
+
+        # Apply starred filter (AND with other filters)
+        # For starred/inbox we need to consider both owned recordings and shared recordings
+        if show_starred:
+            from src.models.sharing import SharedRecordingState
+            # For owned recordings: check Recording.is_highlighted
+            # For shared recordings: check SharedRecordingState.is_highlighted
+            starred_subq = select(SharedRecordingState.recording_id).where(
+                db.and_(
+                    SharedRecordingState.user_id == current_user.id,
+                    SharedRecordingState.is_highlighted == True
+                )
+            ).scalar_subquery()
+            stmt = stmt.where(
+                db.or_(
+                    db.and_(Recording.user_id == current_user.id, Recording.is_highlighted == True),
+                    Recording.id.in_(starred_subq)
+                )
+            )
+
+        # Apply inbox filter (AND with other filters)
+        if show_inbox:
+            from src.models.sharing import SharedRecordingState
+            # For owned recordings: check Recording.is_inbox
+            # For shared recordings: check SharedRecordingState.is_inbox
+            inbox_subq = select(SharedRecordingState.recording_id).where(
+                db.and_(
+                    SharedRecordingState.user_id == current_user.id,
+                    SharedRecordingState.is_inbox == True
+                )
+            ).scalar_subquery()
+            stmt = stmt.where(
+                db.or_(
+                    db.and_(Recording.user_id == current_user.id, Recording.is_inbox == True),
+                    Recording.id.in_(inbox_subq)
+                )
+            )
+
+        # Apply folder filter (AND with other filters)
+        if folder_filter:
+            if folder_filter.lower() == 'none':
+                # Filter recordings with no folder
+                stmt = stmt.where(Recording.folder_id.is_(None))
+            else:
+                # Filter by specific folder_id
+                try:
+                    folder_id = int(folder_filter)
+                    stmt = stmt.where(Recording.folder_id == folder_id)
+                except ValueError:
+                    pass  # Invalid folder_id, ignore filter
+
+        # Apply search filters if provided
+        if search_query:
+            # Extract date filters
+            date_filters = re.findall(r'date:(\S+)', search_query.lower())
+            date_from_filters = re.findall(r'date_from:(\S+)', search_query.lower())
+            date_to_filters = re.findall(r'date_to:(\S+)', search_query.lower())
+            tag_filters = re.findall(r'tag:(\S+)', search_query.lower())
+            speaker_filters = re.findall(r'speaker:(\S+)', search_query.lower())
+
+            # Remove special syntax to get text search
+            text_query = re.sub(r'date:\S+', '', search_query, flags=re.IGNORECASE)
+            text_query = re.sub(r'date_from:\S+', '', text_query, flags=re.IGNORECASE)
+            text_query = re.sub(r'date_to:\S+', '', text_query, flags=re.IGNORECASE)
+            text_query = re.sub(r'tag:\S+', '', text_query, flags=re.IGNORECASE)
+            text_query = re.sub(r'speaker:\S+', '', text_query, flags=re.IGNORECASE).strip()
+
+            # Apply date filters
+            for date_filter in date_filters:
+                if date_filter == 'today':
+                    today = datetime.now().date()
+                    stmt = stmt.where(
+                        db.or_(
+                            db.func.date(Recording.meeting_date) == today,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) == today
+                            )
+                        )
+                    )
+                elif date_filter == 'yesterday':
+                    yesterday = datetime.now().date() - timedelta(days=1)
+                    stmt = stmt.where(
+                        db.or_(
+                            db.func.date(Recording.meeting_date) == yesterday,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) == yesterday
+                            )
+                        )
+                    )
+                elif date_filter == 'thisweek':
+                    today = datetime.now().date()
+                    start_of_week = today - timedelta(days=today.weekday())
+                    stmt = stmt.where(
+                        db.or_(
+                            Recording.meeting_date >= start_of_week,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) >= start_of_week
+                            )
+                        )
+                    )
+                elif date_filter == 'lastweek':
+                    today = datetime.now().date()
+                    end_of_last_week = today - timedelta(days=today.weekday())
+                    start_of_last_week = end_of_last_week - timedelta(days=7)
+                    stmt = stmt.where(
+                        db.or_(
+                            db.and_(
+                                Recording.meeting_date >= start_of_last_week,
+                                Recording.meeting_date < end_of_last_week
+                            ),
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) >= start_of_last_week,
+                                db.func.date(Recording.created_at) < end_of_last_week
+                            )
+                        )
+                    )
+                elif date_filter == 'thismonth':
+                    today = datetime.now().date()
+                    start_of_month = today.replace(day=1)
+                    stmt = stmt.where(
+                        db.or_(
+                            Recording.meeting_date >= start_of_month,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) >= start_of_month
+                            )
+                        )
+                    )
+                elif date_filter == 'lastmonth':
+                    today = datetime.now().date()
+                    first_day_this_month = today.replace(day=1)
+                    last_day_last_month = first_day_this_month - timedelta(days=1)
+                    first_day_last_month = last_day_last_month.replace(day=1)
+                    stmt = stmt.where(
+                        db.or_(
+                            db.and_(
+                                Recording.meeting_date >= first_day_last_month,
+                                Recording.meeting_date <= last_day_last_month
+                            ),
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) >= first_day_last_month,
+                                db.func.date(Recording.created_at) <= last_day_last_month
+                            )
+                        )
+                    )
+                elif re.match(r'^\d{4}-\d{2}-\d{2}$', date_filter):
+                    # Specific date format YYYY-MM-DD
+                    target_date = datetime.strptime(date_filter, '%Y-%m-%d').date()
+                    stmt = stmt.where(
+                        db.or_(
+                            db.func.date(Recording.meeting_date) == target_date,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) == target_date
+                            )
+                        )
+                    )
+                elif re.match(r'^\d{4}-\d{2}$', date_filter):
+                    # Month format YYYY-MM
+                    year, month = map(int, date_filter.split('-'))
+                    stmt = stmt.where(
+                        db.or_(
+                            db.and_(
+                                db.extract('year', Recording.meeting_date) == year,
+                                db.extract('month', Recording.meeting_date) == month
+                            ),
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.extract('year', Recording.created_at) == year,
+                                db.extract('month', Recording.created_at) == month
+                            )
+                        )
+                    )
+                elif re.match(r'^\d{4}$', date_filter):
+                    # Year format YYYY
+                    year = int(date_filter)
+                    stmt = stmt.where(
+                        db.or_(
+                            db.extract('year', Recording.meeting_date) == year,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.extract('year', Recording.created_at) == year
+                            )
+                        )
+                    )
+
+            # Apply date range filters
+            if date_from_filters and date_from_filters[0]:
+                try:
+                    date_from = datetime.strptime(date_from_filters[0], '%Y-%m-%d').date()
+                    stmt = stmt.where(
+                        db.or_(
+                            Recording.meeting_date >= date_from,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) >= date_from
+                            )
+                        )
+                    )
+                except ValueError:
+                    pass  # Invalid date format, ignore
+
+            if date_to_filters and date_to_filters[0]:
+                try:
+                    date_to = datetime.strptime(date_to_filters[0], '%Y-%m-%d').date()
+                    stmt = stmt.where(
+                        db.or_(
+                            Recording.meeting_date <= date_to,
+                            db.and_(
+                                Recording.meeting_date.is_(None),
+                                db.func.date(Recording.created_at) <= date_to
+                            )
+                        )
+                    )
+                except ValueError:
+                    pass  # Invalid date format, ignore
+
+            # Apply tag filters
+            if tag_filters:
+                # Join with tags table and filter by tag names
+                tag_conditions = []
+                for tag_filter in tag_filters:
+                    # Replace underscores back to spaces for matching
+                    tag_name = tag_filter.replace('_', ' ')
+                    tag_conditions.append(Tag.name.ilike(f'%{tag_name}%'))
+
+                stmt = stmt.join(RecordingTag).join(Tag).where(db.or_(*tag_conditions))
+
+            # Apply speaker filters
+            if speaker_filters:
+                speaker_conditions = []
+                for speaker_filter in speaker_filters:
+                    # Replace underscores back to spaces for matching
+                    speaker_name = speaker_filter.replace('_', ' ')
+                    speaker_conditions.append(Recording.participants.ilike(f'%{speaker_name}%'))
+                stmt = stmt.where(db.or_(*speaker_conditions))
+
+            # Apply text search
+            if text_query:
+                from src.models.sharing import SharedRecordingState
+
+                # Search in user-specific notes:
+                # - For owned recordings: search Recording.notes
+                # - For shared recordings: search SharedRecordingState.personal_notes
+
+                text_conditions = [
+                    Recording.title.ilike(f'%{text_query}%'),
+                    Recording.participants.ilike(f'%{text_query}%'),
+                    Recording.transcription.ilike(f'%{text_query}%'),
+                    # Search owner's notes for owned recordings
+                    db.and_(
+                        Recording.user_id == current_user.id,
+                        Recording.notes.ilike(f'%{text_query}%')
+                    )
+                ]
+
+                # Add search for personal notes in shared recordings
+                # Use a subquery to check if personal_notes match
+                shared_notes_subq = select(SharedRecordingState.recording_id).where(
+                    db.and_(
+                        SharedRecordingState.user_id == current_user.id,
+                        SharedRecordingState.personal_notes.ilike(f'%{text_query}%')
+                    )
+                ).scalar_subquery()
+
+                text_conditions.append(Recording.id.in_(shared_notes_subq))
+
+                stmt = stmt.where(db.or_(*text_conditions))
+
+        # Apply ordering based on sort_by parameter
+        if sort_by == 'meeting_date':
+            # Sort by meeting_date first, fall back to created_at if no meeting_date
+            stmt = stmt.order_by(
+                db.case(
+                    (Recording.meeting_date.is_not(None), Recording.meeting_date),
+                    else_=db.func.date(Recording.created_at)
+                ).desc(),
+                Recording.created_at.desc()
+            )
+        else:
+            # Default: sort by created_at (upload/processing date)
+            stmt = stmt.order_by(Recording.created_at.desc())
+
+        # Get total count for pagination info
+        count_stmt = select(db.func.count()).select_from(stmt.subquery())
+        total_count = db.session.execute(count_stmt).scalar()
+
+        # Apply pagination
+        offset = (page - 1) * per_page
+        stmt = stmt.offset(offset).limit(per_page)
+
+        # Execute query
+        recordings = db.session.execute(stmt).scalars().all()
+
+        # Enrich recordings with sharing metadata
+        enriched_recordings = []
+        for recording in recordings:
+            rec_dict = recording.to_list_dict(viewer_user=current_user)
+
+            # Add sharing metadata
+            is_owner = recording.user_id == current_user.id
+            rec_dict['is_owner'] = is_owner
+
+            # Get per-user status (owner uses Recording fields, recipients use SharedRecordingState)
+            user_inbox, user_highlighted = get_user_recording_status(recording, current_user)
+            rec_dict['is_inbox'] = user_inbox
+            rec_dict['is_highlighted'] = user_highlighted
+
+            # Add edit permission info (uses has_recording_access which checks group admin status)
+            rec_dict['can_edit'] = has_recording_access(recording, current_user, require_edit=True)
+
+            # Add delete permission info (only owner can delete)
+            rec_dict['can_delete'] = is_owner and (USERS_CAN_DELETE or current_user.is_admin)
+
+            if not is_owner:
+                # This is a shared recording - get owner info and share permissions
+                owner = User.query.get(recording.user_id)
+                rec_dict['owner_username'] = owner.username if owner else "Unknown"
+                rec_dict['is_shared'] = True
+                # Don't show outgoing share count for recordings you don't own
+                rec_dict['shared_with_count'] = 0
+                rec_dict['public_share_count'] = 0
+
+                # Get share permissions
+                share = InternalShare.query.filter_by(
+                    recording_id=recording.id,
+                    shared_with_user_id=current_user.id
+                ).first()
+
+                if share:
+                    rec_dict['share_info'] = {
+                        'share_id': share.id,
+                        'owner_username': owner.username if owner else "Unknown",
+                        'can_edit': share.can_edit,
+                        'can_reshare': share.can_reshare,
+                        'shared_at': share.created_at.isoformat()
+                    }
+                else:
+                    # Fallback if share record not found (shouldn't happen)
+                    rec_dict['share_info'] = {
+                        'can_edit': False,
+                        'can_reshare': False
+                    }
+            else:
+                rec_dict['is_shared'] = False
+
+            # Check if recording has group tags (among visible tags)
+            visible_tags = recording.get_visible_tags(current_user)
+            has_group_tags = any(tag.is_group_tag for tag in visible_tags)
+            rec_dict['has_group_tags'] = has_group_tags
+
+            enriched_recordings.append(rec_dict)
+
+        # Calculate pagination metadata
+        total_pages = (total_count + per_page - 1) // per_page
+        has_next = page < total_pages
+        has_prev = page > 1
+
+        return jsonify({
+            'recordings': enriched_recordings,
+            'pagination': {
+                'page': page,
+                'per_page': per_page,
+                'total': total_count,
+                'total_pages': total_pages,
+                'has_next': has_next,
+                'has_prev': has_prev
+            }
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error fetching paginated recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/save', methods=['POST'])
+@login_required
+def save_metadata():
+    """Save recording metadata (title, participants, notes, summary, etc.)."""
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+        recording_id = data.get('id')
+        if not recording_id:
+            return jsonify({'error': 'No recording ID provided'}), 400
+
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check if user has at least view access
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        # Handle notes separately - no edit permission required (user-specific)
+        if 'notes' in data:
+            if recording.user_id == current_user.id:
+                # Owner saves to Recording.notes
+                recording.notes = sanitize_html(data['notes']) if data['notes'] else data['notes']
+            else:
+                # Shared user saves to personal_notes (requires SharedRecordingState)
+                from src.models.sharing import SharedRecordingState
+                state = SharedRecordingState.query.filter_by(
+                    recording_id=recording.id,
+                    user_id=current_user.id
+                ).first()
+
+                if not state:
+                    # Create SharedRecordingState if it doesn't exist
+                    state = SharedRecordingState(
+                        recording_id=recording.id,
+                        user_id=current_user.id,
+                        is_inbox=True,
+                        is_highlighted=False
+                    )
+                    db.session.add(state)
+
+                state.personal_notes = sanitize_html(data['notes']) if data['notes'] else data['notes']
+
+        # Determine if any fields requiring edit permission are being updated
+        edit_fields = ['title', 'participants', 'summary', 'meeting_date']
+        requires_edit = any(field in data for field in edit_fields)
+
+        # If edit fields are present, check for edit permission
+        if requires_edit and not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
+
+        # Update fields requiring edit permission
+        if requires_edit:
+            if 'title' in data:
+                recording.title = data['title']
+            if 'participants' in data:
+                recording.participants = data['participants']
+            if 'summary' in data:
+                recording.summary = sanitize_html(data['summary']) if data['summary'] else data['summary']
+            if 'meeting_date' in data:
+                try:
+                    date_str = data['meeting_date']
+                    if date_str:
+                        # Try to parse as full ISO datetime first
+                        try:
+                            recording.meeting_date = datetime.fromisoformat(date_str.replace('Z', '+00:00'))
+                        except (ValueError, AttributeError):
+                            # Fall back to date-only format, preserve existing time if available
+                            parsed_date = datetime.strptime(date_str, '%Y-%m-%d')
+                            if recording.meeting_date:
+                                # Preserve existing time
+                                existing_time = recording.meeting_date.time()
+                                recording.meeting_date = datetime.combine(parsed_date.date(), existing_time)
+                            else:
+                                # No existing time, use the parsed date with midnight time
+                                recording.meeting_date = parsed_date
+                    else:
+                        recording.meeting_date = None
+                except (ValueError, TypeError) as e:
+                    current_app.logger.warning(f"Could not parse meeting_date '{data.get('meeting_date')}': {e}")
+
+        # Handle per-user status fields (only requires view permission)
+        if 'is_inbox' in data or 'is_highlighted' in data:
+            set_user_recording_status(
+                recording,
+                current_user,
+                is_inbox=data.get('is_inbox'),
+                is_highlighted=data.get('is_highlighted')
+            )
+
+        db.session.commit()
+
+        # Re-export the recording if auto-export is enabled and editable fields were changed
+        if requires_edit:
+            export_recording(recording_id)
+
+        # Return recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({'success': True, 'recording': recording_dict})
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error saving metadata for recording {data.get('id')}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred while saving.'}), 500
+
+
+@recordings_bp.route('/recording/<int:recording_id>/update_transcription', methods=['POST'])
+@login_required
+def update_transcription(recording_id):
+    """Updates the transcription content for a recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to edit this recording'}), 403
+
+        data = request.json
+        new_transcription = data.get('transcription')
+
+        if new_transcription is None:
+            return jsonify({'error': 'No transcription data provided'}), 400
+
+        # The incoming data could be a JSON string (from ASR edit) or plain text
+        recording.transcription = new_transcription
+
+        # Optional: If the transcription changes, we might want to indicate that the summary is outdated.
+        # For now, we'll just save the transcript. A "regenerate summary" button could be a good follow-up.
+
+        db.session.commit()
+        current_app.logger.info(f"Transcription for recording {recording_id} was updated.")
+
+        # Re-export the recording if auto-export is enabled
+        export_recording(recording_id)
+
+        # Return recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({'success': True, 'message': 'Transcription updated successfully.', 'recording': recording_dict})
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error updating transcription for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred while updating the transcription.'}), 500
+
+# Toggle inbox status endpoint
+
+
+@recordings_bp.route('/recording/<int:recording_id>/toggle_inbox', methods=['POST'])
+@login_required
+def toggle_inbox(recording_id):
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Only require view access (not edit) - users can manage their own inbox status
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to view this recording'}), 403
+
+        # Get current status and toggle it
+        current_inbox, current_highlighted = get_user_recording_status(recording, current_user)
+        new_inbox, new_highlighted = set_user_recording_status(recording, current_user, is_inbox=not current_inbox)
+
+        return jsonify({'success': True, 'is_inbox': new_inbox})
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error toggling inbox status for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+# Toggle highlighted status endpoint
+
+
+@recordings_bp.route('/recording/<int:recording_id>/toggle_highlight', methods=['POST'])
+@login_required
+def toggle_highlight(recording_id):
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Only require view access (not edit) - users can manage their own highlight status
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to view this recording'}), 403
+
+        # Get current status and toggle it
+        current_inbox, current_highlighted = get_user_recording_status(recording, current_user)
+        new_inbox, new_highlighted = set_user_recording_status(recording, current_user, is_highlighted=not current_highlighted)
+
+        return jsonify({'success': True, 'is_highlighted': new_highlighted})
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error toggling highlighted status for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+
+
+@recordings_bp.route('/upload', methods=['POST'])
+@login_required
+def upload_file():
+    try:
+        if 'file' not in request.files:
+            return jsonify({'error': 'No file provided'}), 400
+
+        file = request.files['file']
+        if file.filename == '':
+            return jsonify({'error': 'No file selected'}), 400
+
+        original_filename = file.filename
+        safe_filename = secure_filename(original_filename)
+        filepath = os.path.join(current_app.config['UPLOAD_FOLDER'], f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{safe_filename}")
+
+        # Get original file size
+        file.seek(0, os.SEEK_END)
+        original_file_size = file.tell()
+        file.seek(0)
+
+        # Check size limit before saving - only enforce if chunking is disabled or connector handles it
+        max_content_length = current_app.config.get('MAX_CONTENT_LENGTH')
+
+        # Get connector specifications for chunking decisions
+        connector_specs = None
+        if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+            try:
+                from src.services.transcription import get_registry
+                registry = get_registry()
+                connector = registry.get_active_connector()
+                if connector:
+                    connector_specs = connector.specifications
+            except Exception as e:
+                current_app.logger.warning(f"Could not get connector specs for upload: {e}")
+
+        # Skip size check if chunking is enabled (app-level or connector handles internally)
+        should_enforce_size_limit = True
+        if chunking_service:
+            from src.audio_chunking import get_effective_chunking_config
+            chunking_config = get_effective_chunking_config(connector_specs)
+            if chunking_config.enabled or chunking_config.source == 'connector_internal':
+                should_enforce_size_limit = False
+                if chunking_config.source == 'connector_internal':
+                    current_app.logger.info(f"Connector handles chunking internally - skipping {original_file_size/1024/1024:.1f}MB size limit check")
+                elif chunking_config.mode == 'size':
+                    current_app.logger.info(f"Size-based chunking enabled ({chunking_config.limit_value}MB, source={chunking_config.source}) - skipping {original_file_size/1024/1024:.1f}MB size limit check")
+                else:
+                    current_app.logger.info(f"Duration-based chunking enabled ({chunking_config.limit_value}s, source={chunking_config.source}) - skipping {original_file_size/1024/1024:.1f}MB size limit check")
+
+        if should_enforce_size_limit and max_content_length and original_file_size > max_content_length:
+            raise RequestEntityTooLarge()
+
+        file.save(filepath)
+        current_app.logger.info(f"File saved to {filepath}")
+
+        # Compute file hash on the ORIGINAL upload before any conversion/compression.
+        # Lossy re-encoding (e.g. FLAC→MP3) produces different bytes each run,
+        # so hashing after conversion would miss duplicates.
+        file_hash = None
+        duplicate_warning = None
+        try:
+            file_hash = compute_file_sha256(filepath)
+            existing = Recording.query.filter_by(
+                user_id=current_user.id, file_hash=file_hash
+            ).first()
+            if existing:
+                duplicate_warning = {
+                    'existing_recording_id': existing.id,
+                    'existing_title': existing.title,
+                    'existing_created_at': existing.created_at.isoformat() if existing.created_at else None
+                }
+                current_app.logger.info(
+                    f"Duplicate file detected for user {current_user.id}: "
+                    f"hash={file_hash[:12]}... matches recording {existing.id}"
+                )
+        except Exception as e:
+            current_app.logger.warning(f"Could not compute file hash: {e}")
+
+        # --- Convert files only when chunking is needed ---
+        filename_lower = original_filename.lower()
+
+        # Check if chunking will be needed for this file (uses connector-aware logic)
+        needs_chunking_for_processing = bool(
+            chunking_service and
+            chunking_service.needs_chunking(filepath, USE_ASR_ENDPOINT, connector_specs)
+        )
+
+        # Probe once and use shared conversion utility
+        # Scale timeout based on file size — large files (especially MP4 with moov at end) need more time
+        file_size_mb = os.path.getsize(filepath) / (1024 * 1024)
+        probe_timeout = max(10, min(60, int(file_size_mb / 10)))  # 10s min, scales ~1s per 10MB, 60s max
+        codec_info = None
+        try:
+            codec_info = get_codec_info(filepath, timeout=probe_timeout)
+            current_app.logger.info(
+                f"Detected codec for {original_filename}: "
+                f"audio_codec={codec_info.get('audio_codec')}, "
+                f"has_video={codec_info.get('has_video', False)}"
+            )
+        except FFProbeError as e:
+            current_app.logger.warning(f"Failed to probe {original_filename} (timeout={probe_timeout}s): {e}. Will attempt conversion.")
+            codec_info = None
+
+        # Video retention/passthrough: skip conversion for videos, processing pipeline handles extraction
+        has_video = codec_info.get('has_video', False) if codec_info else False
+
+        # Fallback: if probe failed but VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR is on, check file extension
+        # to avoid silently discarding video from files we couldn't probe
+        if codec_info is None and (VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR) and not has_video:
+            video_extensions = {'.mp4', '.mov', '.mkv', '.avi', '.webm', '.m4v', '.wmv', '.flv', '.ts', '.mts'}
+            file_ext = os.path.splitext(original_filename)[1].lower()
+            if file_ext in video_extensions:
+                has_video = True
+                current_app.logger.info(
+                    f"Probe failed but file extension '{file_ext}' indicates video — "
+                    f"treating as video for {'VIDEO_PASSTHROUGH_ASR' if VIDEO_PASSTHROUGH_ASR else 'VIDEO_RETENTION'}"
+                )
+        if (VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR) and has_video:
+            current_app.logger.info(f"Video {'passthrough' if VIDEO_PASSTHROUGH_ASR else 'retention'}: keeping original video, skipping conversion")
+        else:
+            # Use shared conversion utility - handles ALL conversion needs (codec conversion + compression)
+            try:
+                result = convert_if_needed(
+                    filepath,
+                    original_filename=original_filename,
+                    codec_info=codec_info,
+                    needs_chunking=needs_chunking_for_processing,
+                    is_asr_endpoint=USE_ASR_ENDPOINT,
+                    delete_original=True,
+                    connector_specs=connector_specs  # Pass connector specs for codec restrictions
+                )
+                filepath = result.output_path
+
+                # Log what happened
+                if result.was_converted:
+                    current_app.logger.info(f"File converted: {result.original_codec} -> {result.final_codec}")
+                if result.was_compressed:
+                    current_app.logger.info(f"File compressed: {result.size_reduction_percent:.1f}% size reduction")
+
+            except FFmpegNotFoundError as e:
+                current_app.logger.error(f"FFmpeg not found: {e}")
+                return jsonify({'error': 'Audio conversion tool (FFmpeg) not found on server.'}), 500
+            except FFmpegError as e:
+                current_app.logger.error(f"FFmpeg conversion failed for {filepath}: {e}")
+                return jsonify({'error': f'Failed to convert audio file: {str(e)}'}), 500
+
+        # Get final file size (of original or converted file)
+        final_file_size = os.path.getsize(filepath)
+
+        # (file_hash and duplicate_warning already computed above, before conversion)
+
+        # Determine MIME type of the final file
+        mime_type, _ = mimetypes.guess_type(filepath)
+        current_app.logger.info(f"Final MIME type: {mime_type} for file {filepath}")
+
+        # Get notes from the form
+        notes = request.form.get('notes')
+
+        # Get optional user-provided title and meeting_date
+        user_title = request.form.get('title')
+        user_meeting_date = request.form.get('meeting_date')
+
+        # Get file's lastModified timestamp from client (milliseconds since epoch)
+        file_last_modified = request.form.get('file_last_modified')
+
+        # Get selected tags if provided (multiple tags support)
+        selected_tags = []
+        tag_index = 0
+        while True:
+            tag_id_key = f'tag_ids[{tag_index}]'
+            tag_id = request.form.get(tag_id_key)
+            if not tag_id:
+                break
+
+            # Check if tag belongs to user OR is a group tag where user is a member
+            tag = Tag.query.filter_by(id=tag_id).first()
+            if tag:
+                # Allow tag if it's user's own tag OR it's a group tag where user is a member
+                if tag.user_id == current_user.id or (tag.group_id and GroupMembership.query.filter_by(group_id=tag.group_id, user_id=current_user.id).first()):
+                    selected_tags.append(tag)
+            tag_index += 1
+
+        # For backward compatibility with single tag uploads
+        if not selected_tags:
+            single_tag_id = request.form.get('tag_id')
+            if single_tag_id:
+                # Check if tag belongs to user OR is a group tag where user is a member
+                tag = Tag.query.filter_by(id=single_tag_id).first()
+                if tag and (tag.user_id == current_user.id or (tag.group_id and GroupMembership.query.filter_by(group_id=tag.group_id, user_id=current_user.id).first())):
+                    selected_tags.append(tag)
+
+        # Get folder_id if provided
+        selected_folder = None
+        folder_id = request.form.get('folder_id')
+        if folder_id:
+            folder = Folder.query.filter_by(id=folder_id).first()
+            if folder:
+                # Allow folder if it's user's own folder OR it's a group folder where user is a member
+                if folder.user_id == current_user.id or (folder.group_id and GroupMembership.query.filter_by(group_id=folder.group_id, user_id=current_user.id).first()):
+                    selected_folder = folder
+
+        # Get ASR advanced options if provided
+        language = request.form.get('language', '')
+        min_speakers = request.form.get('min_speakers') or None
+        max_speakers = request.form.get('max_speakers') or None
+        hotwords = request.form.get('hotwords', '').strip() or None
+        initial_prompt = request.form.get('initial_prompt', '').strip() or None
+        transcription_model = request.form.get('transcription_model', '').strip() or None
+
+        # Per-recording prompt-template variables. Sent as a JSON string from
+        # the upload form so multiple values fit in a single form field. The
+        # sanitiser enforces identifier-shaped keys and per-value / total
+        # size caps so an arbitrary JSON blob cannot bloat the column.
+        from src.utils.prompt_variables import sanitize_variable_values
+        prompt_variables = None
+        raw_prompt_variables = request.form.get('prompt_variables')
+        if raw_prompt_variables:
+            try:
+                parsed_vars = json.loads(raw_prompt_variables)
+                prompt_variables = sanitize_variable_values(parsed_vars)
+            except (TypeError, ValueError):
+                current_app.logger.warning(
+                    f"Could not parse prompt_variables form field as JSON: {raw_prompt_variables[:200]}"
+                )
+
+        # Convert to int if provided
+        if min_speakers:
+            try:
+                min_speakers = int(min_speakers)
+            except (ValueError, TypeError):
+                min_speakers = None
+        if max_speakers:
+            try:
+                max_speakers = int(max_speakers)
+            except (ValueError, TypeError):
+                max_speakers = None
+
+        # Apply precedence hierarchy: user input > tag defaults > folder defaults > environment variables > user defaults > auto-detect
+
+        # Apply folder defaults first (lower priority than tags)
+        if selected_folder and not selected_tags:
+            # Only apply folder defaults if no tags are selected (tags take priority)
+            if not language and selected_folder.default_language:
+                language = selected_folder.default_language
+            if min_speakers is None and selected_folder.default_min_speakers:
+                min_speakers = selected_folder.default_min_speakers
+            if max_speakers is None and selected_folder.default_max_speakers:
+                max_speakers = selected_folder.default_max_speakers
+            if not hotwords and selected_folder.default_hotwords:
+                hotwords = selected_folder.default_hotwords
+            if not initial_prompt and selected_folder.default_initial_prompt:
+                initial_prompt = selected_folder.default_initial_prompt
+            if not transcription_model and selected_folder.default_transcription_model:
+                transcription_model = selected_folder.default_transcription_model
+
+        # Apply tag defaults if tags are selected and values are not explicitly provided by user
+        # Use first tag's defaults (highest priority - overrides folder)
+        if selected_tags:
+            first_tag = selected_tags[0]
+            if not language and first_tag.default_language:
+                language = first_tag.default_language
+            if min_speakers is None and first_tag.default_min_speakers:
+                min_speakers = first_tag.default_min_speakers
+            if max_speakers is None and first_tag.default_max_speakers:
+                max_speakers = first_tag.default_max_speakers
+            if not hotwords and first_tag.default_hotwords:
+                hotwords = first_tag.default_hotwords
+            if not initial_prompt and first_tag.default_initial_prompt:
+                initial_prompt = first_tag.default_initial_prompt
+            if not transcription_model and first_tag.default_transcription_model:
+                transcription_model = first_tag.default_transcription_model
+
+        # Apply environment variable defaults if still no values are set
+        if min_speakers is None and ASR_MIN_SPEAKERS:
+            try:
+                min_speakers = int(ASR_MIN_SPEAKERS)
+            except (ValueError, TypeError):
+                min_speakers = None
+        if max_speakers is None and ASR_MAX_SPEAKERS:
+            try:
+                max_speakers = int(ASR_MAX_SPEAKERS)
+            except (ValueError, TypeError):
+                max_speakers = None
+
+        # Fall back to user defaults if still not set
+        if not language and current_user.transcription_language:
+            language = current_user.transcription_language
+            current_app.logger.info(f"Using user's default transcription language: {language}")
+        if not hotwords and current_user.transcription_hotwords:
+            hotwords = current_user.transcription_hotwords
+        if not initial_prompt and current_user.transcription_initial_prompt:
+            initial_prompt = current_user.transcription_initial_prompt
+
+        # Create initial database entry
+        now = datetime.utcnow()
+
+        # Determine meeting_date: prefer user-provided, then client lastModified, then file metadata, then current time
+        meeting_date = None
+
+        # First try user-provided meeting_date (ISO 8601 format)
+        if user_meeting_date:
+            try:
+                parsed = datetime.fromisoformat(user_meeting_date.replace('Z', '+00:00'))
+                # Strip timezone to store as naive datetime, consistent with other date sources
+                meeting_date = parsed.replace(tzinfo=None)
+                current_app.logger.info(f"Using user-provided meeting_date: {meeting_date}")
+            except (ValueError, TypeError) as e:
+                current_app.logger.warning(f"Could not parse user meeting_date '{user_meeting_date}': {e}")
+
+        # Then try client-provided file lastModified (most reliable for uploads)
+        if not meeting_date and file_last_modified:
+            try:
+                # JavaScript lastModified is in milliseconds since epoch
+                timestamp_ms = int(file_last_modified)
+                meeting_date = datetime.fromtimestamp(timestamp_ms / 1000)
+                current_app.logger.info(f"Using client file lastModified: {meeting_date}")
+            except (ValueError, TypeError, OSError) as e:
+                current_app.logger.warning(f"Could not parse file_last_modified '{file_last_modified}': {e}")
+
+        # Fall back to file metadata (creation_time, date tags, etc.)
+        if not meeting_date:
+            meeting_date = get_creation_date(filepath, use_file_mtime=False)
+            if meeting_date:
+                current_app.logger.info(f"Using file metadata creation date: {meeting_date}")
+
+        # Final fallback to current time
+        if not meeting_date:
+            meeting_date = now
+            current_app.logger.debug("No file date available, using current time")
+
+        recording = Recording(
+            audio_path=filepath,
+            original_filename=original_filename,
+            title=user_title.strip() if user_title and user_title.strip() else f"Recording - {original_filename}",
+            file_size=final_file_size,
+            status='PENDING',
+            meeting_date=meeting_date,
+            user_id=current_user.id,
+            mime_type=mime_type,
+            notes=notes,
+            folder_id=selected_folder.id if selected_folder else None,
+            processing_source='upload',  # Track that this was manually uploaded
+            file_hash=file_hash,
+            prompt_variables=prompt_variables,
+        )
+        db.session.add(recording)
+        db.session.commit()
+
+        # Add tags to recording if selected (preserve order)
+        for order, tag in enumerate(selected_tags, 1):
+            new_association = RecordingTag(
+                recording_id=recording.id,
+                tag_id=tag.id,
+                order=order,
+                added_at=datetime.utcnow()
+            )
+            db.session.add(new_association)
+
+        if selected_tags:
+            db.session.commit()
+            tag_names = [tag.name for tag in selected_tags]
+            current_app.logger.info(f"Added {len(selected_tags)} tags to recording {recording.id}: {', '.join(tag_names)}")
+
+        current_app.logger.info(f"Initial recording record created with ID: {recording.id}")
+
+        # Validate against admin-curated list and apply admin default when
+        # nothing else in the chain set a model.
+        transcription_model = _resolve_transcription_model(transcription_model)
+
+        # --- Queue transcription job ---
+        first_tag = selected_tags[0] if selected_tags else None
+        job_params = {
+            'language': language,
+            'min_speakers': min_speakers,
+            'max_speakers': max_speakers,
+            'tag_id': first_tag.id if first_tag else None,
+            'hotwords': hotwords,
+            'initial_prompt': initial_prompt,
+            'transcription_model': transcription_model,
+        }
+
+        current_app.logger.info(f"Queueing transcription for recording {recording.id} with params: {job_params}")
+        job_queue.enqueue(
+            user_id=current_user.id,
+            recording_id=recording.id,
+            job_type='transcribe',
+            params=job_params,
+            is_new_upload=True
+        )
+        current_app.logger.info(f"Transcription job queued for recording ID: {recording.id}")
+
+        response_data = recording.to_dict(viewer_user=current_user)
+        if duplicate_warning:
+            response_data['duplicate_warning'] = duplicate_warning
+        return jsonify(response_data), 202
+
+    except RequestEntityTooLarge:
+        max_size_mb = current_app.config['MAX_CONTENT_LENGTH'] / (1024 * 1024)
+        current_app.logger.warning(f"Upload failed: File too large (>{max_size_mb}MB)")
+        return jsonify({
+            'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
+            'max_size_mb': max_size_mb
+        }), 413
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error during file upload: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred during upload.'}), 500
+
+
+@recordings_bp.route('/api/recordings/incognito', methods=['POST'])
+@login_required
+def upload_incognito():
+    """
+    Process audio in incognito mode - no database storage.
+    Returns transcript/summary directly in response.
+
+    This endpoint is designed for HIPAA-friendly transcription where
+    audio data is processed but never persisted to the database.
+    Results are returned directly and only stored client-side in sessionStorage.
+    """
+    # Check if incognito mode is enabled
+    if not ENABLE_INCOGNITO_MODE:
+        return jsonify({'error': 'Incognito mode is not enabled on this server'}), 403
+
+    import tempfile
+    from datetime import datetime
+    from src.tasks.processing import transcribe_incognito, generate_incognito_summary
+
+    temp_filepath = None
+
+    try:
+        if 'file' not in request.files:
+            return jsonify({'error': 'No file provided'}), 400
+
+        file = request.files['file']
+        if file.filename == '':
+            return jsonify({'error': 'No file selected'}), 400
+
+        original_filename = file.filename
+        safe_filename = secure_filename(original_filename)
+
+        # Get file size
+        file.seek(0, os.SEEK_END)
+        file_size = file.tell()
+        file.seek(0)
+
+        # Check size limit
+        max_content_length = current_app.config.get('MAX_CONTENT_LENGTH')
+        if max_content_length and file_size > max_content_length:
+            max_size_mb = max_content_length / (1024 * 1024)
+            return jsonify({
+                'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
+                'max_size_mb': max_size_mb
+            }), 413
+
+        # Save to temp file - use secure temp directory
+        with tempfile.NamedTemporaryFile(delete=False, suffix=f'_{safe_filename}') as tmp:
+            temp_filepath = tmp.name
+            file.save(temp_filepath)
+            current_app.logger.info(f"[Incognito] Temp file saved: {temp_filepath}")
+
+        # Get optional parameters
+        # Note: Empty string '' means auto-detect, don't convert to None
+        language = request.form.get('language', '')
+        min_speakers = request.form.get('min_speakers')
+        max_speakers = request.form.get('max_speakers')
+        auto_summarize = request.form.get('auto_summarize', 'false').lower() == 'true'
+
+        # Convert to int if provided
+        if min_speakers:
+            try:
+                min_speakers = int(min_speakers)
+            except (ValueError, TypeError):
+                min_speakers = None
+        if max_speakers:
+            try:
+                max_speakers = int(max_speakers)
+            except (ValueError, TypeError):
+                max_speakers = None
+
+        # Log only metadata - NEVER log content for HIPAA compliance
+        current_app.logger.info(f"[Incognito] Processing request from user {current_user.id}: "
+                               f"filename={original_filename}, size={file_size/1024/1024:.2f}MB, "
+                               f"language={language}, auto_summarize={auto_summarize}")
+
+        # Perform transcription synchronously (no database operations)
+        result = transcribe_incognito(
+            filepath=temp_filepath,
+            original_filename=original_filename,
+            language=language,
+            min_speakers=min_speakers,
+            max_speakers=max_speakers,
+            user=current_user
+        )
+
+        if result.get('error'):
+            current_app.logger.error(f"[Incognito] Transcription failed: {result['error']}")
+            return jsonify({
+                'incognito': True,
+                'error': result['error']
+            }), 500
+
+        # Optionally generate summary
+        summary = None
+        if auto_summarize and result.get('transcription'):
+            current_app.logger.info(f"[Incognito] Auto-summarize requested, generating summary...")
+            summary = generate_incognito_summary(result['transcription'], current_user)
+
+        # Build response
+        # Render markdown to HTML for summary display
+        summary_html = None
+        if summary:
+            summary_html = md_to_html(summary)
+
+        response_data = {
+            'incognito': True,
+            'transcription': result.get('transcription'),
+            'summary': summary,
+            'summary_html': summary_html,
+            'title': result.get('title', 'Incognito Recording'),
+            'audio_duration_seconds': result.get('audio_duration_seconds'),
+            'processing_time_seconds': result.get('processing_time_seconds'),
+            'created_at': datetime.utcnow().isoformat() + 'Z',
+            'original_filename': original_filename,
+            'file_size': file_size
+        }
+
+        current_app.logger.info(f"[Incognito] Request completed successfully for user {current_user.id}")
+
+        return jsonify(response_data), 200
+
+    except RequestEntityTooLarge:
+        max_size_mb = current_app.config['MAX_CONTENT_LENGTH'] / (1024 * 1024)
+        current_app.logger.warning(f"[Incognito] Upload failed: File too large (>{max_size_mb}MB)")
+        return jsonify({
+            'incognito': True,
+            'error': f'File too large. Maximum size is {max_size_mb:.0f} MB.',
+            'max_size_mb': max_size_mb
+        }), 413
+
+    except Exception as e:
+        current_app.logger.error(f"[Incognito] Error during processing: {e}", exc_info=True)
+        return jsonify({
+            'incognito': True,
+            'error': 'An unexpected error occurred during processing.'
+        }), 500
+
+    finally:
+        # CRITICAL: Always delete temp file for HIPAA compliance
+        if temp_filepath and os.path.exists(temp_filepath):
+            try:
+                os.remove(temp_filepath)
+                current_app.logger.info(f"[Incognito] Temp file deleted: {temp_filepath}")
+            except Exception as cleanup_error:
+                current_app.logger.error(f"[Incognito] Failed to delete temp file {temp_filepath}: {cleanup_error}")
+
+
+@recordings_bp.route('/api/recordings/incognito/chat', methods=['POST'])
+@login_required
+def chat_incognito():
+    """
+    Chat with an incognito recording's transcription.
+    Since incognito recordings don't exist in the database, the transcription
+    is passed directly in the request.
+    """
+    # Check if incognito mode is enabled
+    if not ENABLE_INCOGNITO_MODE:
+        return jsonify({'error': 'Incognito mode is not enabled on this server'}), 403
+
+    from src.tasks.processing import format_transcription_for_llm
+
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+
+        transcription = data.get('transcription')
+        user_message = data.get('message')
+        message_history = data.get('message_history', [])
+        participants = data.get('participants', '')
+        notes = data.get('notes', '')
+
+        if not transcription:
+            return jsonify({'error': 'No transcription provided'}), 400
+        if not user_message:
+            return jsonify({'error': 'No message provided'}), 400
+
+        # Check if chat client is available
+        if chat_client is None:
+            return jsonify({'error': 'Chat service is not available (chat client not configured)'}), 503
+
+        # Prepare the system prompt with the transcription
+        user_chat_output_language = current_user.output_language if current_user.is_authenticated else None
+
+        language_instruction = ""
+        if user_chat_output_language:
+            language_instruction = f"Please provide all your responses in {user_chat_output_language}."
+
+        user_name = current_user.name if current_user.is_authenticated and current_user.name else "User"
+        user_title = current_user.job_title if current_user.is_authenticated and current_user.job_title else "a professional"
+        user_company = current_user.company if current_user.is_authenticated and current_user.company else "their organization"
+
+        formatted_transcription = format_transcription_for_llm(transcription)
+
+        # Get configurable transcript length limit for chat
+        transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+        if transcript_limit == -1:
+            chat_transcript = formatted_transcription
+        else:
+            chat_transcript = formatted_transcription[:transcript_limit]
+
+        system_prompt = f"""You are a professional meeting and audio transcription analyst assisting {user_name}, who is a(n) {user_title} at {user_company}. {language_instruction} Analyze the following meeting information and respond to the specific request.
+
+Following are the meeting participants and their roles:
+{participants or "No specific participants information provided."}
+
+Following is the meeting transcript:
+<<start transcript>>
+{chat_transcript or "No transcript available."}
+<<end transcript>>
+
+Additional context and notes about the meeting:
+{notes or "none"}
+
+Note: This is an incognito recording - no data is stored on the server.
+"""
+
+        # Prepare messages array with system prompt and conversation history
+        messages = [{"role": "system", "content": system_prompt}]
+        if message_history:
+            messages.extend(message_history)
+        messages.append({"role": "user", "content": user_message})
+
+        # Get model info
+        chat_model = os.environ.get('TEXT_MODEL_NAME', os.environ.get('OPENAI_CHAT_MODEL', 'gpt-4o-mini'))
+        user_id = current_user.id
+
+        current_app.logger.info(f"[Incognito Chat] User {user_id} sending message")
+
+        def generate():
+            """Stream the chat response."""
+            try:
+                response = chat_client.chat.completions.create(
+                    model=chat_model,
+                    messages=messages,
+                    temperature=0.7,
+                    stream=True
+                )
+
+                for chunk in response:
+                    if chunk.choices and len(chunk.choices) > 0:
+                        delta = chunk.choices[0].delta
+                        if hasattr(delta, 'content') and delta.content:
+                            yield f"data: {json.dumps({'content': delta.content})}\n\n"
+
+                yield "data: [DONE]\n\n"
+
+            except Exception as e:
+                current_app.logger.error(f"[Incognito Chat] Error during streaming: {e}")
+                # Provide more helpful error message for connection issues
+                error_msg = str(e).lower()
+                if 'connection' in error_msg or 'connect' in error_msg or 'refused' in error_msg:
+                    yield f"data: {json.dumps({'error': 'Could not connect to LLM server. Please check that your LLM service is running.'})}\n\n"
+                else:
+                    yield f"data: {json.dumps({'error': str(e)})}\n\n"
+
+        return Response(generate(), mimetype='text/event-stream')
+
+    except Exception as e:
+        current_app.logger.error(f"[Incognito Chat] Error: {e}", exc_info=True)
+        # Provide more helpful error message for connection issues
+        error_msg = str(e).lower()
+        if 'connection' in error_msg or 'connect' in error_msg or 'refused' in error_msg:
+            return jsonify({'error': 'Could not connect to LLM server. Please check that your LLM service is running.'}), 503
+        return jsonify({'error': 'An error occurred during chat'}), 500
+
+
+@recordings_bp.route('/api/recordings/incognito/summary', methods=['POST'])
+@login_required
+def generate_incognito_summary_endpoint():
+    """
+    Generate summary for an incognito recording on demand.
+    Since incognito recordings don't exist in the database, the transcription
+    is passed directly in the request.
+    """
+    # Check if incognito mode is enabled
+    if not ENABLE_INCOGNITO_MODE:
+        return jsonify({'error': 'Incognito mode is not enabled on this server'}), 403
+
+    from src.tasks.processing import generate_incognito_summary
+    from src.utils import md_to_html
+
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+
+        transcription = data.get('transcription')
+        if not transcription:
+            return jsonify({'error': 'No transcription provided'}), 400
+
+        # Check if LLM client is available
+        if client is None:
+            return jsonify({'error': 'Summary service is not available (LLM client not configured)'}), 503
+
+        current_app.logger.info(f"[Incognito Summary] User {current_user.id} requesting summary generation")
+
+        # Generate summary using existing function
+        summary = generate_incognito_summary(transcription, current_user)
+
+        if summary:
+            summary_html = md_to_html(summary)
+            return jsonify({
+                'summary': summary,
+                'summary_html': summary_html
+            })
+        else:
+            return jsonify({'error': 'Failed to generate summary. Please check that your LLM service is running.'}), 503
+
+    except Exception as e:
+        current_app.logger.error(f"[Incognito Summary] Error: {e}", exc_info=True)
+        # Provide more helpful error message for connection issues
+        error_msg = str(e).lower()
+        if 'connection' in error_msg or 'connect' in error_msg or 'refused' in error_msg:
+            return jsonify({'error': 'Could not connect to LLM server. Please check that your LLM service is running.'}), 503
+        return jsonify({'error': f'Failed to generate summary: {str(e)}'}), 500
+
+
+# Status Endpoint
+
+
+@recordings_bp.route('/recording/<int:recording_id>', methods=['DELETE'])
+@login_required
+def delete_recording(recording_id):
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check if the recording belongs to the current user
+        if recording.user_id and recording.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to delete this recording'}), 403
+
+        # Check deletion permissions (admin-only if USERS_CAN_DELETE is false)
+        if not USERS_CAN_DELETE and not current_user.is_admin:
+            return jsonify({'error': 'Only administrators can delete recordings'}), 403
+
+        # Delete the audio file first
+        try:
+            if recording.audio_path and os.path.exists(recording.audio_path):
+                os.remove(recording.audio_path)
+                current_app.logger.info(f"Deleted audio file: {recording.audio_path}")
+        except Exception as e:
+            current_app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
+
+        # Log embeddings cleanup for Inquire Mode if enabled
+        if ENABLE_INQUIRE_MODE:
+            chunk_count = TranscriptChunk.query.filter_by(recording_id=recording_id).count()
+            if chunk_count > 0:
+                current_app.logger.info(f"Deleting {chunk_count} transcript chunks with embeddings for recording {recording_id}")
+
+        # Delete associated records with NOT NULL recording_id constraints
+        from src.models.speaker_snippet import SpeakerSnippet
+        deleted_snippets = SpeakerSnippet.query.filter_by(recording_id=recording_id).delete()
+        if deleted_snippets > 0:
+            current_app.logger.info(f"Deleted {deleted_snippets} speaker snippets for recording {recording_id}")
+
+        from src.models.processing_job import ProcessingJob
+        deleted_jobs = ProcessingJob.query.filter_by(recording_id=recording_id).delete()
+        if deleted_jobs > 0:
+            current_app.logger.info(f"Deleted {deleted_jobs} processing jobs for recording {recording_id}")
+
+        # Delete the database record (cascade will handle chunks/embeddings)
+        db.session.delete(recording)
+        db.session.commit()
+        current_app.logger.info(f"Deleted recording record ID: {recording_id}")
+
+        if ENABLE_INQUIRE_MODE and chunk_count > 0:
+            current_app.logger.info(f"Successfully deleted embeddings and chunks for recording {recording_id}")
+
+        # Mark the export file as deleted
+        mark_export_as_deleted(recording_id)
+
+        # Clean up orphaned speakers (run after successful deletion)
+        # This is a best-effort cleanup; failures are logged but don't affect the delete operation
+        try:
+            from src.services.speaker_cleanup import cleanup_orphaned_speakers
+            speaker_stats = cleanup_orphaned_speakers()
+            if speaker_stats.get('speakers_deleted', 0) > 0:
+                current_app.logger.info(
+                    f"Cleaned up {speaker_stats['speakers_deleted']} orphaned speakers after recording deletion"
+                )
+        except Exception as cleanup_error:
+            # Log the error but don't fail the deletion
+            current_app.logger.warning(f"Speaker cleanup after recording deletion failed: {cleanup_error}")
+
+        return jsonify({'success': True})
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error deleting recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred while deleting.'}), 500
+
+
+# --- Inbox and Archive Endpoints ---
+
+@recordings_bp.route('/api/inbox_recordings', methods=['GET'])
+@login_required
+def get_inbox_recordings():
+    """Get recordings that are in the inbox and currently processing."""
+    from sqlalchemy import select
+    try:
+        stmt = select(Recording).where(
+            Recording.user_id == current_user.id,
+            Recording.is_inbox == True,
+            Recording.status.in_(['PENDING', 'PROCESSING', 'SUMMARIZING'])
+        ).order_by(Recording.created_at.desc())
+
+        recordings = db.session.execute(stmt).scalars().all()
+        return jsonify([recording.to_list_dict(viewer_user=current_user) for recording in recordings])
+    except Exception as e:
+        current_app.logger.error(f"Error fetching inbox recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/api/recordings/archived', methods=['GET'])
+@login_required
+def get_archived_recordings():
+    """Get recordings where audio has been deleted but transcription remains."""
+    from sqlalchemy import select
+    try:
+        search_query = request.args.get('q', '').strip()
+
+        # Find recordings owned by current user where audio_deleted_at is not null
+        stmt = select(Recording).where(
+            Recording.user_id == current_user.id,
+            Recording.audio_deleted_at.is_not(None)
+        ).order_by(Recording.audio_deleted_at.desc())
+
+        recordings = db.session.execute(stmt).scalars().all()
+        return jsonify([recording.to_list_dict(viewer_user=current_user) for recording in recordings])
+    except Exception as e:
+        current_app.logger.error(f"Error fetching archived recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Recording Detail and Audio Endpoints ---
+
+@recordings_bp.route('/api/recordings/<int:recording_id>', methods=['GET'])
+@login_required
+def get_recording_detail(recording_id):
+    """Get full details for a specific recording including markdown HTML."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check ownership or shared access
+        has_access = recording.user_id == current_user.id
+
+        # Check if recording has been shared with current user (if internal sharing is enabled)
+        if not has_access and ENABLE_INTERNAL_SHARING:
+            share = InternalShare.query.filter_by(
+                recording_id=recording_id,
+                shared_with_user_id=current_user.id
+            ).first()
+            has_access = share is not None
+
+        if not has_access:
+            return jsonify({'error': 'Access denied'}), 403
+
+        # Return full detail with HTML conversion
+        rec_dict = recording.to_dict(include_html=True, viewer_user=current_user)
+
+        # Add sharing metadata
+        is_owner = recording.user_id == current_user.id
+        rec_dict['is_owner'] = is_owner
+
+        # Add edit permission info (uses has_recording_access which checks group admin status)
+        rec_dict['can_edit'] = has_recording_access(recording, current_user, require_edit=True)
+
+        # Add delete permission info (only owner can delete)
+        rec_dict['can_delete'] = is_owner and (USERS_CAN_DELETE or current_user.is_admin)
+
+        # Add sharing-related fields
+        if not is_owner:
+            # This is a shared recording - get owner info and share permissions
+            owner = User.query.get(recording.user_id)
+            rec_dict['owner_username'] = owner.username if owner else "Unknown"
+            rec_dict['is_shared'] = True
+            # Don't show outgoing share count for recordings you don't own
+            rec_dict['shared_with_count'] = 0
+            rec_dict['public_share_count'] = 0
+
+            # Get share permissions
+            share = InternalShare.query.filter_by(
+                recording_id=recording.id,
+                shared_with_user_id=current_user.id
+            ).first()
+
+            if share:
+                rec_dict['share_info'] = {
+                    'share_id': share.id,
+                    'owner_username': owner.username if owner else "Unknown",
+                    'can_edit': share.can_edit,
+                    'can_reshare': share.can_reshare,
+                    'shared_at': share.created_at.isoformat()
+                }
+            else:
+                # Fallback if share record not found (shouldn't happen)
+                rec_dict['share_info'] = {
+                    'can_edit': False,
+                    'can_reshare': False
+                }
+        else:
+            rec_dict['is_shared'] = False
+
+        # Check if recording has group tags (among visible tags)
+        visible_tags = recording.get_visible_tags(current_user)
+        has_group_tags = any(tag.is_group_tag for tag in visible_tags) if visible_tags else False
+        rec_dict['has_group_tags'] = has_group_tags
+
+        # Enrich with per-user status
+        enrich_recording_dict_with_user_status(rec_dict, recording, current_user)
+
+        return jsonify(rec_dict)
+    except Exception as e:
+        current_app.logger.error(f"Error fetching recording detail: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/recording/<int:recording_id>/status', methods=['GET'])
+@login_required
+def get_recording_status_only(recording_id):
+    """
+    Lightweight endpoint that returns only the status field.
+    Used for polling during processing/summarization.
+    Note: Rate limiting exemption is configured at app level.
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to view this recording'}), 403
+
+        # Return only the status field
+        return jsonify({'status': recording.status})
+    except Exception as e:
+        current_app.logger.error(f"Error fetching status for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/batch-status', methods=['POST'])
+@login_required
+def get_batch_recording_status():
+    """
+    Batch endpoint to get status for multiple recordings at once.
+    More efficient than polling individual status endpoints.
+
+    Request body: {"recording_ids": [1, 2, 3]}
+    Response: {"statuses": {"1": "COMPLETED", "2": "PROCESSING", "3": "FAILED"}}
+    """
+    try:
+        data = request.get_json()
+        if not data or 'recording_ids' not in data:
+            return jsonify({'error': 'recording_ids is required'}), 400
+
+        recording_ids = data['recording_ids']
+        if not isinstance(recording_ids, list):
+            return jsonify({'error': 'recording_ids must be a list'}), 400
+
+        # Limit batch size to prevent abuse
+        if len(recording_ids) > 50:
+            return jsonify({'error': 'Maximum 50 recordings per batch'}), 400
+
+        # Query all recordings at once
+        recordings = Recording.query.filter(Recording.id.in_(recording_ids)).all()
+
+        # Build response with only accessible recordings
+        statuses = {}
+        for recording in recordings:
+            if has_recording_access(recording, current_user):
+                statuses[str(recording.id)] = recording.status
+
+        return jsonify({'statuses': statuses})
+    except Exception as e:
+        current_app.logger.error(f"Error fetching batch status: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/job-queue-status', methods=['GET'])
+@login_required
+def get_job_queue_status():
+    """
+    Get detailed job queue status for all jobs (active, completed, and failed).
+    Returns status for the user's jobs within the last hour.
+    """
+    try:
+        from src.models import ProcessingJob
+        from src.services.job_queue import TRANSCRIPTION_JOBS, SUMMARY_JOBS
+        from datetime import timedelta
+
+        # Expire all cached objects to ensure we see latest data from worker threads
+        db.session.expire_all()
+
+        # Get all jobs for the user (active + recent completed/failed within last hour)
+        cutoff_time = datetime.utcnow() - timedelta(hours=1)
+        all_jobs = ProcessingJob.query.filter(
+            ProcessingJob.user_id == current_user.id,
+            db.or_(
+                ProcessingJob.status.in_(['queued', 'processing']),
+                db.and_(
+                    ProcessingJob.status.in_(['completed', 'failed']),
+                    ProcessingJob.completed_at >= cutoff_time
+                )
+            )
+        ).order_by(ProcessingJob.created_at.desc()).all()
+
+        job_details = []
+        for job in all_jobs:
+            recording = db.session.get(Recording, job.recording_id)
+            recording_title = None
+            if recording:
+                recording_title = recording.title or recording.original_filename or 'Untitled'
+
+            # Determine queue type
+            queue_type = 'summary' if job.job_type in SUMMARY_JOBS else 'transcription'
+
+            # Calculate position if queued
+            position = None
+            if job.status == 'queued':
+                job_types = SUMMARY_JOBS if job.job_type in SUMMARY_JOBS else TRANSCRIPTION_JOBS
+                ahead_in_queue = ProcessingJob.query.filter(
+                    ProcessingJob.status == 'queued',
+                    ProcessingJob.job_type.in_(job_types),
+                    ProcessingJob.created_at < job.created_at
+                ).count()
+                currently_processing = ProcessingJob.query.filter(
+                    ProcessingJob.status == 'processing',
+                    ProcessingJob.job_type.in_(job_types)
+                ).count()
+                position = ahead_in_queue + currently_processing + 1
+
+            job_details.append({
+                'id': job.id,
+                'recording_id': job.recording_id,
+                'recording_title': recording_title,
+                'job_status': job.status,
+                'job_type': job.job_type,
+                'queue_type': queue_type,
+                'position': position,
+                'is_new_upload': job.is_new_upload,
+                'error_message': job.error_message,
+                'created_at': job.created_at.isoformat() if job.created_at else None,
+                'started_at': job.started_at.isoformat() if job.started_at else None,
+                'completed_at': job.completed_at.isoformat() if job.completed_at else None
+            })
+
+        return jsonify({'jobs': job_details})
+    except Exception as e:
+        current_app.logger.error(f"Error fetching job queue status: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/jobs/<int:job_id>/retry', methods=['POST'])
+@login_required
+def retry_failed_job(job_id):
+    """Retry a failed job."""
+    try:
+        from src.models import ProcessingJob
+
+        job = db.session.get(ProcessingJob, job_id)
+        if not job:
+            return jsonify({'error': 'Job not found'}), 404
+
+        if job.user_id != current_user.id:
+            return jsonify({'error': 'Access denied'}), 403
+
+        if job.status != 'failed':
+            return jsonify({'error': 'Only failed jobs can be retried'}), 400
+
+        # Reset job for retry
+        job.status = 'queued'
+        job.error_message = None
+        job.retry_count = 0
+        job.started_at = None
+        job.completed_at = None
+        db.session.commit()
+
+        current_app.logger.info(f"Job {job_id} queued for retry by user {current_user.id}")
+        return jsonify({'success': True, 'message': 'Job queued for retry'})
+
+    except Exception as e:
+        current_app.logger.error(f"Error retrying job {job_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/jobs/<int:job_id>', methods=['DELETE'])
+@login_required
+def delete_job(job_id):
+    """Delete a job (clear from queue or history)."""
+    try:
+        from src.models import ProcessingJob
+        import os
+
+        job = db.session.get(ProcessingJob, job_id)
+        if not job:
+            return jsonify({'error': 'Job not found'}), 404
+
+        if job.user_id != current_user.id:
+            return jsonify({'error': 'Access denied'}), 403
+
+        # If it's a failed new upload, also delete the recording
+        if job.status == 'failed' and job.is_new_upload:
+            recording = db.session.get(Recording, job.recording_id)
+            if recording:
+                # Delete audio file
+                if recording.audio_path and os.path.exists(recording.audio_path):
+                    try:
+                        os.remove(recording.audio_path)
+                    except Exception as e:
+                        current_app.logger.error(f"Error deleting audio file: {e}")
+                # Delete ALL processing jobs for this recording first
+                ProcessingJob.query.filter_by(recording_id=recording.id).delete()
+                db.session.delete(recording)
+        else:
+            # Just delete this job
+            db.session.delete(job)
+        db.session.commit()
+
+        current_app.logger.info(f"Job {job_id} deleted by user {current_user.id}")
+        return jsonify({'success': True, 'message': 'Job deleted'})
+
+    except Exception as e:
+        current_app.logger.error(f"Error deleting job {job_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/jobs/clear-completed', methods=['POST'])
+@login_required
+def clear_completed_jobs():
+    """Clear all completed jobs for the current user."""
+    try:
+        from src.models import ProcessingJob
+
+        deleted = ProcessingJob.query.filter(
+            ProcessingJob.user_id == current_user.id,
+            ProcessingJob.status == 'completed'
+        ).delete(synchronize_session=False)
+
+        db.session.commit()
+        current_app.logger.info(f"Cleared {deleted} completed jobs for user {current_user.id}")
+        return jsonify({'success': True, 'deleted': deleted})
+
+    except Exception as e:
+        current_app.logger.error(f"Error clearing completed jobs: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/status/<int:recording_id>', methods=['GET'])
+@login_required
+def get_status(recording_id):
+    """Endpoint to check the transcription/summarization status (full recording data)."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to view this recording'}), 403
+
+        # Ensure events are loaded (refresh the recording to get latest relationships)
+        db.session.refresh(recording)
+
+        # Get recording dict and enrich with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+
+        return jsonify(recording_dict)
+    except Exception as e:
+        current_app.logger.error(f"Error fetching status for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/audio/<int:recording_id>')
+@login_required
+def get_audio(recording_id):
+    """Serve audio file for a recording.
+
+    Query parameters:
+        download: If 'true', serves file as attachment for download
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording or not recording.audio_path:
+            return jsonify({'error': 'Recording or audio file not found'}), 404
+
+        # Check if the recording belongs to the current user or has been shared with them
+        has_access = recording.user_id == current_user.id
+
+        # Check if recording has been shared with current user (if internal sharing is enabled)
+        if not has_access and ENABLE_INTERNAL_SHARING:
+            share = InternalShare.query.filter_by(
+                recording_id=recording_id,
+                shared_with_user_id=current_user.id
+            ).first()
+            has_access = share is not None
+
+        if not has_access:
+            return jsonify({'error': 'You do not have permission to access this audio file'}), 403
+        if not os.path.exists(recording.audio_path):
+            current_app.logger.error(f"Audio file missing from server: {recording.audio_path}")
+            return jsonify({'error': 'Audio file missing from server'}), 404
+
+        # Check if download is requested
+        download = request.args.get('download', 'false').lower() == 'true'
+        if download:
+            # Generate filename from recording title or use default
+            filename = recording.title or f'recording_{recording_id}'
+            # Sanitize filename and add extension
+            filename = "".join(c for c in filename if c.isalnum() or c in (' ', '-', '_')).strip()
+            ext = os.path.splitext(recording.audio_path)[1] or '.mp3'
+            filename = f"{filename}{ext}"
+            return send_file(recording.audio_path, as_attachment=True, download_name=filename, mimetype=recording.mime_type, conditional=True)
+
+        return send_file(recording.audio_path, mimetype=recording.mime_type, conditional=True)
+    except Exception as e:
+        current_app.logger.error(f"Error serving audio for recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+# --- Chat with Transcription ---
+
+@recordings_bp.route('/chat', methods=['POST'])
+@login_required
+def chat_with_transcription():
+    """Chat with a specific recording's transcription."""
+    try:
+        data = request.json
+        if not data:
+            return jsonify({'error': 'No data provided'}), 400
+
+        recording_id = data.get('recording_id')
+        user_message = data.get('message')
+        message_history = data.get('message_history', [])
+
+        if not recording_id:
+            return jsonify({'error': 'No recording ID provided'}), 400
+        if not user_message:
+            return jsonify({'error': 'No message provided'}), 400
+
+        # Get the recording
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user):
+            return jsonify({'error': 'You do not have permission to chat with this recording'}), 403
+
+        # Check if transcription exists
+        if not recording.transcription or len(recording.transcription.strip()) < 10:
+            return jsonify({'error': 'No transcription available for this recording'}), 400
+
+        # Check if transcription is an error message (not actual content)
+        if is_transcription_error(recording.transcription):
+            return jsonify({'error': 'Cannot chat: transcription failed. Please reprocess the transcription first.'}), 400
+
+        # Check if chat client is available
+        if chat_client is None:
+            return jsonify({'error': 'Chat service is not available (chat client not configured)'}), 503
+
+        # Prepare the system prompt with the transcription
+        user_chat_output_language = current_user.output_language if current_user.is_authenticated else None
+
+        language_instruction = ""
+        if user_chat_output_language:
+            language_instruction = f"Please provide all your responses in {user_chat_output_language}."
+
+        user_name = current_user.name if current_user.is_authenticated and current_user.name else "User"
+        user_title = current_user.job_title if current_user.is_authenticated and current_user.job_title else "a professional"
+        user_company = current_user.company if current_user.is_authenticated and current_user.company else "their organization"
+
+        formatted_transcription = format_transcription_for_llm(recording.transcription)
+
+        # Get configurable transcript length limit for chat
+        transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+        if transcript_limit == -1:
+            # No limit
+            chat_transcript = formatted_transcription
+        else:
+            chat_transcript = formatted_transcription[:transcript_limit]
+
+        system_prompt = f"""You are a professional meeting and audio transcription analyst assisting {user_name}, who is a(n) {user_title} at {user_company}. {language_instruction} Analyze the following meeting information and respond to the specific request.
+
+Following are the meeting participants and their roles:
+{recording.participants or "No specific participants information provided."}
+
+Following is the meeting transcript:
+<<start transcript>>
+{chat_transcript or "No transcript available."}
+<<end transcript>>
+
+Additional context and notes about the meeting:
+{recording.notes or "none"}
+"""
+
+        # Prepare messages array with system prompt and conversation history
+        messages = [{"role": "system", "content": system_prompt}]
+        if message_history:
+            messages.extend(message_history)
+        messages.append({"role": "user", "content": user_message})
+
+        # Capture context before generator starts (app context may not be available inside generator)
+        user_id = current_user.id
+        app = current_app._get_current_object()
+
+        def generate():
+            # Push app context for entire generator execution
+            # This is needed because call_chat_completion checks budget which requires db access
+            ctx = app.app_context()
+            ctx.push()
+            try:
+                # Enable streaming with user_id for budget enforcement
+                stream = call_chat_completion(
+                    messages=messages,
+                    temperature=0.7,
+                    max_tokens=int(os.environ.get("CHAT_MAX_TOKENS", "2000")),
+                    stream=True,
+                    user_id=user_id,
+                    operation_type='chat'
+                )
+
+                # Use helper function to process streaming with thinking tag support
+                for response in process_streaming_with_thinking(stream, user_id=user_id, operation_type='chat', app=app):
+                    yield response
+
+            except TokenBudgetExceeded as e:
+                app.logger.warning(f"Token budget exceeded for user {user_id}: {e}")
+                yield f"data: {json.dumps({'error': str(e), 'budget_exceeded': True})}\n\n"
+            except Exception as e:
+                app.logger.error(f"Error during chat stream generation: {str(e)}")
+                # Provide more helpful error message for connection issues
+                error_msg = str(e).lower()
+                if 'connection' in error_msg or 'connect' in error_msg or 'refused' in error_msg:
+                    yield f"data: {json.dumps({'error': 'Could not connect to LLM server. Please check that your LLM service is running.'})}\n\n"
+                else:
+                    yield f"data: {json.dumps({'error': str(e)})}\n\n"
+            finally:
+                ctx.pop()
+
+        return Response(generate(), mimetype='text/event-stream')
+
+    except Exception as e:
+        current_app.logger.error(f"Error in chat endpoint: {str(e)}")
+        error_msg = str(e).lower()
+        if 'connection' in error_msg or 'connect' in error_msg or 'refused' in error_msg:
+            return jsonify({'error': 'Could not connect to LLM server. Please check that your LLM service is running.'}), 503
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Tag Management for Recordings ---
+
+@recordings_bp.route('/api/recordings/<int:recording_id>/tags', methods=['POST'])
+@login_required
+def add_tag_to_recording(recording_id):
+    """Add a tag to a recording. Triggers auto-share for group tags."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check if user has view access to this recording
+        # (Edit permission will be checked for group tags specifically)
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        data = request.get_json()
+        tag_id = data.get('tag_id')
+
+        if not tag_id:
+            return jsonify({'error': 'Tag ID is required'}), 400
+
+        tag = db.session.get(Tag, tag_id)
+        if not tag:
+            return jsonify({'error': 'Tag not found'}), 404
+
+        # Check if user has access to this tag and permission to apply it
+        if tag.group_id:
+            # Group tag - check membership first
+            membership = GroupMembership.query.filter_by(
+                group_id=tag.group_id,
+                user_id=current_user.id
+            ).first()
+            if not membership:
+                return jsonify({'error': 'You do not have access to this tag'}), 403
+
+            # Only file owner or group admin can apply group tags
+            if recording.user_id != current_user.id and membership.role != 'admin':
+                return jsonify({'error': 'Only recording owner or group admin can apply group tags'}), 403
+
+            # Group tags require edit permission
+            if not has_recording_access(recording, current_user, require_edit=True):
+                return jsonify({'error': 'You do not have permission to apply group tags to this recording'}), 403
+        else:
+            # Personal tag - only the tag owner can use it (view access is sufficient)
+            if tag.user_id != current_user.id:
+                return jsonify({'error': 'You can only apply your own personal tags'}), 403
+
+        # Check if tag is already on the recording
+        existing = RecordingTag.query.filter_by(
+            recording_id=recording_id,
+            tag_id=tag_id
+        ).first()
+
+        if existing:
+            return jsonify({'error': 'Tag is already on this recording'}), 400
+
+        # Get the next order position
+        max_order = db.session.query(db.func.max(RecordingTag.order)).filter_by(
+            recording_id=recording_id
+        ).scalar() or 0
+
+        # Add the tag
+        recording_tag = RecordingTag(
+            recording_id=recording_id,
+            tag_id=tag_id,
+            order=max_order + 1
+        )
+        db.session.add(recording_tag)
+
+        # If this is a group tag with sharing enabled, automatically share the recording
+        # Only auto-share if recording is completed (not during processing)
+        if tag.group_id and ENABLE_INTERNAL_SHARING and recording.status == 'COMPLETED' and (tag.auto_share_on_apply or tag.share_with_group_lead):
+            # Determine who to share with
+            if tag.auto_share_on_apply:
+                group_members = GroupMembership.query.filter_by(group_id=tag.group_id).all()
+            elif tag.share_with_group_lead:
+                group_members = GroupMembership.query.filter_by(group_id=tag.group_id, role='admin').all()
+            else:
+                group_members = []
+
+            shares_created = 0
+            for membership_to_share in group_members:
+                # Skip the recording owner
+                if membership_to_share.user_id == recording.user_id:
+                    continue
+
+                # Check if already shared
+                existing_share = InternalShare.query.filter_by(
+                    recording_id=recording_id,
+                    shared_with_user_id=membership_to_share.user_id
+                ).first()
+
+                if not existing_share:
+                    # Create internal share with correct permissions
+                    # Group admins get edit permission, regular members get read-only
+                    share = InternalShare(
+                        recording_id=recording_id,
+                        owner_id=recording.user_id,
+                        shared_with_user_id=membership_to_share.user_id,
+                        can_edit=(membership_to_share.role == 'admin'),
+                        can_reshare=False,
+                        source_type='group_tag',
+                        source_tag_id=tag.id
+                    )
+                    db.session.add(share)
+
+                    # Check if SharedRecordingState already exists (might exist from previous share)
+                    existing_state = SharedRecordingState.query.filter_by(
+                        recording_id=recording_id,
+                        user_id=membership_to_share.user_id
+                    ).first()
+
+                    if not existing_state:
+                        # Create SharedRecordingState with default values for the recipient
+                        state = SharedRecordingState(
+                            recording_id=recording_id,
+                            user_id=membership_to_share.user_id,
+                            is_inbox=True,  # New shares appear in inbox by default
+                            is_highlighted=False  # Not favorited by default
+                        )
+                        db.session.add(state)
+
+                    shares_created += 1
+                    current_app.logger.info(f"Auto-shared recording {recording_id} with user {membership_to_share.user_id} (role={membership_to_share.role}) via group tag '{tag.name}'")
+
+            if shares_created > 0:
+                current_app.logger.info(f"Created {shares_created} auto-shares for recording {recording_id} via group tag '{tag.name}'")
+
+        db.session.commit()
+
+        # Return updated recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'recording': recording_dict,
+            'tag': tag.to_dict()
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error adding tag to recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/<int:recording_id>/tags/<int:tag_id>', methods=['DELETE'])
+@login_required
+def remove_tag_from_recording(recording_id, tag_id):
+    """Remove a tag from a recording. Cleans up auto-shares for group tags."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check if user has view access to this recording
+        # (Edit permission will be checked for group tags specifically)
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        # Find the recording-tag association
+        recording_tag = RecordingTag.query.filter_by(
+            recording_id=recording_id,
+            tag_id=tag_id
+        ).first()
+
+        if not recording_tag:
+            return jsonify({'error': 'Tag is not on this recording'}), 404
+
+        # Get the tag to check permissions and for cleanup
+        tag = db.session.get(Tag, tag_id)
+        if tag:
+            # Check permissions to remove this specific tag
+            if tag.group_id:
+                # Group tag - only file owner or group admin can remove
+                membership = GroupMembership.query.filter_by(
+                    group_id=tag.group_id,
+                    user_id=current_user.id
+                ).first()
+                if recording.user_id != current_user.id:
+                    if not membership or membership.role != 'admin':
+                        return jsonify({'error': 'Only recording owner or group admin can remove group tags'}), 403
+
+                # Group tags require edit permission
+                if not has_recording_access(recording, current_user, require_edit=True):
+                    return jsonify({'error': 'You do not have permission to remove group tags from this recording'}), 403
+            else:
+                # Personal tag - can be removed by tag owner (view access) or recording owner (edit access)
+                if tag.user_id != current_user.id:
+                    # Not the tag owner, must be recording owner with edit permission
+                    if not has_recording_access(recording, current_user, require_edit=True):
+                        return jsonify({'error': 'You can only remove your own personal tags'}), 403
+
+        # Remove the association
+        db.session.delete(recording_tag)
+
+        # Clean up shares created by this group tag
+        if tag and tag.group_id and ENABLE_INTERNAL_SHARING:
+            shares_to_check = InternalShare.query.filter_by(
+                recording_id=recording_id,
+                source_tag_id=tag_id
+            ).all()
+
+            shares_removed = 0
+            for share in shares_to_check:
+                # Check if user still has access via another group tag on this recording
+                other_team_tag_access = db.session.query(Tag).join(
+                    RecordingTag, RecordingTag.tag_id == Tag.id
+                ).join(
+                    GroupMembership, GroupMembership.group_id == Tag.group_id
+                ).filter(
+                    RecordingTag.recording_id == recording_id,
+                    GroupMembership.user_id == share.shared_with_user_id,
+                    Tag.id != tag_id,  # Exclude the tag being removed
+                    Tag.group_id.isnot(None),
+                    db.or_(Tag.auto_share_on_apply == True, Tag.share_with_group_lead == True)
+                ).first()
+
+                # Only remove share if user has no other group tag access
+                if not other_team_tag_access:
+                    db.session.delete(share)
+                    shares_removed += 1
+                    current_app.logger.info(f"Removed auto-share for user {share.shared_with_user_id} from recording {recording_id} (group tag '{tag.name}' removed)")
+
+            if shares_removed > 0:
+                current_app.logger.info(f"Cleaned up {shares_removed} auto-shares for recording {recording_id} after removing group tag '{tag.name}'")
+
+        db.session.commit()
+
+        # Return updated recording with per-user status
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'recording': recording_dict
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error removing tag from recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@recordings_bp.route('/api/recordings/<int:recording_id>/tags/reorder', methods=['PUT'])
+@login_required
+def reorder_recording_tags(recording_id):
+    """Reorder tags on a recording. Updates the order field for each RecordingTag."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check if user has edit access to this recording
+        if not has_recording_access(recording, current_user, require_edit=True):
+            return jsonify({'error': 'You do not have permission to modify this recording'}), 403
+
+        data = request.get_json()
+        if not data or 'tag_ids' not in data:
+            return jsonify({'error': 'Missing tag_ids in request body'}), 400
+
+        tag_ids = data.get('tag_ids', [])
+        if not isinstance(tag_ids, list):
+            return jsonify({'error': 'tag_ids must be a list'}), 400
+
+        # Update order for each tag
+        for order, tag_id in enumerate(tag_ids, 1):
+            recording_tag = RecordingTag.query.filter_by(
+                recording_id=recording_id,
+                tag_id=tag_id
+            ).first()
+            if recording_tag:
+                recording_tag.order = order
+
+        db.session.commit()
+
+        # Return updated recording
+        recording_dict = recording.to_dict(viewer_user=current_user)
+        enrich_recording_dict_with_user_status(recording_dict, recording, current_user)
+        return jsonify({
+            'success': True,
+            'recording': recording_dict
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error reordering tags on recording {recording_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+# --- Bulk Operations ---
+
+@recordings_bp.route('/api/recordings/bulk', methods=['DELETE'])
+@login_required
+def bulk_delete_recordings():
+    """Delete multiple recordings at once."""
+    try:
+        data = request.get_json()
+        if not data or 'recording_ids' not in data:
+            return jsonify({'error': 'Missing recording_ids'}), 400
+
+        recording_ids = data.get('recording_ids', [])
+        if not isinstance(recording_ids, list) or len(recording_ids) == 0:
+            return jsonify({'error': 'recording_ids must be a non-empty list'}), 400
+
+        # Limit bulk operations to prevent abuse
+        if len(recording_ids) > 100:
+            return jsonify({'error': 'Cannot delete more than 100 recordings at once'}), 400
+
+        # Check deletion permissions
+        if not USERS_CAN_DELETE and not current_user.is_admin:
+            return jsonify({'error': 'Only administrators can delete recordings'}), 403
+
+        deleted_ids = []
+        errors = []
+
+        for recording_id in recording_ids:
+            try:
+                recording = db.session.get(Recording, recording_id)
+                if not recording:
+                    errors.append(f"Recording {recording_id} not found")
+                    continue
+
+                # Check ownership
+                if recording.user_id and recording.user_id != current_user.id:
+                    errors.append(f"No permission for recording {recording_id}")
+                    continue
+
+                # Delete audio file
+                if recording.audio_path and os.path.exists(recording.audio_path):
+                    try:
+                        os.remove(recording.audio_path)
+                    except Exception as e:
+                        current_app.logger.error(f"Error deleting audio file {recording.audio_path}: {e}")
+
+                # Delete associated records with NOT NULL recording_id constraints
+                from src.models import ProcessingJob
+                from src.models.speaker_snippet import SpeakerSnippet
+                SpeakerSnippet.query.filter_by(recording_id=recording_id).delete()
+                ProcessingJob.query.filter_by(recording_id=recording_id).delete()
+
+                # Delete the recording
+                db.session.delete(recording)
+                deleted_ids.append(recording_id)
+
+            except Exception as e:
+                current_app.logger.error(f"Error deleting recording {recording_id}: {e}")
+                errors.append(f"Error with recording {recording_id}")
+
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'deleted_ids': deleted_ids,
+            'deleted_count': len(deleted_ids),
+            'errors': errors if errors else None
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error in bulk delete: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred'}), 500
+
+
+@recordings_bp.route('/api/recordings/bulk-tags', methods=['POST'])
+@login_required
+def bulk_update_tags():
+    """Add or remove a tag from multiple recordings."""
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({'error': 'Missing request body'}), 400
+
+        recording_ids = data.get('recording_ids', [])
+        tag_id = data.get('tag_id')
+        action = data.get('action', 'add')  # 'add' or 'remove'
+
+        if not recording_ids or not tag_id:
+            return jsonify({'error': 'Missing recording_ids or tag_id'}), 400
+
+        if action not in ['add', 'remove']:
+            return jsonify({'error': 'Action must be "add" or "remove"'}), 400
+
+        if len(recording_ids) > 100:
+            return jsonify({'error': 'Cannot update more than 100 recordings at once'}), 400
+
+        # Verify tag exists and user has access
+        tag = db.session.get(Tag, tag_id)
+        if not tag:
+            return jsonify({'error': 'Tag not found'}), 404
+
+        if tag.user_id != current_user.id and not tag.group_id:
+            return jsonify({'error': 'No permission to use this tag'}), 403
+
+        affected_ids = []
+
+        for recording_id in recording_ids:
+            try:
+                recording = db.session.get(Recording, recording_id)
+                if not recording:
+                    continue
+
+                # Check ownership or edit access
+                if not has_recording_access(recording, current_user, require_edit=True):
+                    continue
+
+                if action == 'add':
+                    # Check if tag already exists
+                    existing = RecordingTag.query.filter_by(
+                        recording_id=recording_id,
+                        tag_id=tag_id
+                    ).first()
+
+                    if not existing:
+                        # Get max order for this recording
+                        max_order = db.session.query(db.func.max(RecordingTag.order)).filter_by(
+                            recording_id=recording_id
+                        ).scalar() or 0
+
+                        new_tag = RecordingTag(
+                            recording_id=recording_id,
+                            tag_id=tag_id,
+                            order=max_order + 1
+                        )
+                        db.session.add(new_tag)
+                        affected_ids.append(recording_id)
+
+                else:  # remove
+                    recording_tag = RecordingTag.query.filter_by(
+                        recording_id=recording_id,
+                        tag_id=tag_id
+                    ).first()
+
+                    if recording_tag:
+                        db.session.delete(recording_tag)
+                        affected_ids.append(recording_id)
+
+            except Exception as e:
+                current_app.logger.error(f"Error updating tag for recording {recording_id}: {e}")
+
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'affected_ids': affected_ids,
+            'affected_count': len(affected_ids)
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error in bulk tag update: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred'}), 500
+
+
+@recordings_bp.route('/api/recordings/bulk-reprocess', methods=['POST'])
+@login_required
+def bulk_reprocess():
+    """Queue multiple recordings for reprocessing."""
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({'error': 'Missing request body'}), 400
+
+        recording_ids = data.get('recording_ids', [])
+        reprocess_type = data.get('type', 'summary')  # 'transcription' or 'summary'
+
+        if not recording_ids:
+            return jsonify({'error': 'Missing recording_ids'}), 400
+
+        if reprocess_type not in ['transcription', 'summary']:
+            return jsonify({'error': 'Type must be "transcription" or "summary"'}), 400
+
+        if len(recording_ids) > 50:
+            return jsonify({'error': 'Cannot reprocess more than 50 recordings at once'}), 400
+
+        queued_ids = []
+
+        for recording_id in recording_ids:
+            try:
+                recording = db.session.get(Recording, recording_id)
+                if not recording:
+                    continue
+
+                # Check ownership
+                if recording.user_id != current_user.id:
+                    continue
+
+                # Only reprocess completed or failed recordings
+                if recording.status not in ['COMPLETED', 'FAILED']:
+                    continue
+
+                # For transcription reprocess, need audio file
+                if reprocess_type == 'transcription':
+                    if not recording.audio_path or not os.path.exists(recording.audio_path):
+                        continue
+                    job_type = 'reprocess_transcription'
+                else:
+                    # For summary, need transcription
+                    if not recording.transcription:
+                        continue
+                    job_type = 'reprocess_summary'
+
+                # Queue the job
+                job_queue.enqueue(
+                    user_id=current_user.id,
+                    recording_id=recording.id,
+                    job_type=job_type,
+                    params={'user_id': current_user.id}
+                )
+
+                queued_ids.append(recording_id)
+
+            except Exception as e:
+                current_app.logger.error(f"Error queueing reprocess for recording {recording_id}: {e}")
+
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'queued_ids': queued_ids,
+            'queued_count': len(queued_ids)
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error in bulk reprocess: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred'}), 500
+
+
+@recordings_bp.route('/api/recordings/bulk-toggle', methods=['POST'])
+@login_required
+def bulk_toggle():
+    """Toggle inbox or highlight for multiple recordings."""
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({'error': 'Missing request body'}), 400
+
+        recording_ids = data.get('recording_ids', [])
+        field = data.get('field')  # 'inbox' or 'highlight'
+        value = data.get('value')  # True or False
+
+        if not recording_ids or field is None or value is None:
+            return jsonify({'error': 'Missing recording_ids, field, or value'}), 400
+
+        if field not in ['inbox', 'highlight']:
+            return jsonify({'error': 'Field must be "inbox" or "highlight"'}), 400
+
+        if len(recording_ids) > 100:
+            return jsonify({'error': 'Cannot update more than 100 recordings at once'}), 400
+
+        affected_ids = []
+
+        for recording_id in recording_ids:
+            try:
+                recording = db.session.get(Recording, recording_id)
+                if not recording:
+                    continue
+
+                # Use set_user_recording_status which handles both owners and shared users
+                if field == 'inbox':
+                    set_user_recording_status(recording, current_user, is_inbox=value)
+                else:
+                    set_user_recording_status(recording, current_user, is_highlighted=value)
+
+                affected_ids.append(recording_id)
+
+            except Exception as e:
+                current_app.logger.error(f"Error toggling {field} for recording {recording_id}: {e}")
+
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'affected_ids': affected_ids,
+            'affected_count': len(affected_ids)
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error in bulk toggle: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred'}), 500
+
+
+# --- Auto-deletion and Chunks Processing ---
+
+@recordings_bp.route('/api/recordings/<int:recording_id>/toggle_deletion_exempt', methods=['POST'])
+@login_required
+def toggle_deletion_exempt(recording_id):
+    """Toggle the deletion_exempt flag for a recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        # Check ownership
+        if recording.user_id != current_user.id and not current_user.is_admin:
+            return jsonify({'error': 'Permission denied'}), 403
+
+        # Toggle the flag
+        recording.deletion_exempt = not recording.deletion_exempt
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'deletion_exempt': recording.deletion_exempt
+        })
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error toggling deletion exempt for recording {recording_id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@recordings_bp.route('/api/recording/<int:recording_id>/process_chunks', methods=['POST'])
+@login_required
+def process_recording_chunks_endpoint(recording_id):
+    """Process chunks for a specific recording."""
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if recording.user_id != current_user.id:
+            return jsonify({'error': 'Permission denied'}), 403
+
+        success = process_recording_chunks(recording_id)
+        if success:
+            return jsonify({'message': 'Chunks processed successfully'})
+        else:
+            return jsonify({'error': 'Failed to process chunks'}), 500
+
+    except Exception as e:
+        current_app.logger.error(f"Error in process chunks endpoint: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- Inquire Mode API Endpoints ---
diff --git a/src/api/shares.py b/src/api/shares.py
new file mode 100644
index 00000000..010dca1f
--- /dev/null
+++ b/src/api/shares.py
@@ -0,0 +1,621 @@
+"""
+Sharing routes for public and internal recording shares.
+
+This blueprint handles:
+- Public sharing (shareable links)
+- Internal sharing (user-to-user sharing)
+- Share management (CRUD operations)
+"""
+
+import os
+import re
+import json
+from flask import Blueprint, render_template, request, redirect, url_for, jsonify, send_file, current_app
+from flask_login import login_required, current_user
+
+from src.database import db
+from src.models import Recording, Share, InternalShare, SharedRecordingState, User, TranscriptChunk, ShareAuditLog
+from src.utils import md_to_html
+
+# Configuration from environment
+ENABLE_PUBLIC_SHARING = os.environ.get('ENABLE_PUBLIC_SHARING', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+SHOW_USERNAMES_IN_UI = os.environ.get('SHOW_USERNAMES_IN_UI', 'false').lower() == 'true'
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+READABLE_PUBLIC_LINKS = os.environ.get('READABLE_PUBLIC_LINKS', 'false').lower() == 'true'
+
+# Create blueprint
+shares_bp = Blueprint('shares', __name__)
+
+# Import has_recording_access from app context
+has_recording_access = None
+
+def init_shares_helpers(_has_recording_access):
+    """Initialize helper functions from app."""
+    global has_recording_access
+    has_recording_access = _has_recording_access
+
+
+def process_transcription_for_template(transcription_str):
+    """
+    Process transcription JSON into a format ready for server-side rendering.
+
+    Returns a dict with:
+    - is_json: bool - whether transcription is valid JSON
+    - has_speakers: bool - whether diarization data exists
+    - segments: list - processed segments with speaker info and colors
+    - speakers: list - unique speakers with colors
+    - plain_text: str - plain text version for non-JSON or fallback
+    """
+    if not transcription_str:
+        return {'is_json': False, 'has_speakers': False, 'segments': [], 'speakers': [], 'plain_text': ''}
+
+    try:
+        data = json.loads(transcription_str)
+    except (json.JSONDecodeError, TypeError):
+        # Plain text transcription
+        return {
+            'is_json': False,
+            'has_speakers': False,
+            'segments': [],
+            'speakers': [],
+            'plain_text': transcription_str
+        }
+
+    if not isinstance(data, list):
+        return {
+            'is_json': False,
+            'has_speakers': False,
+            'segments': [],
+            'speakers': [],
+            'plain_text': transcription_str
+        }
+
+    # Check if diarized (has speaker info)
+    has_speakers = any(seg.get('speaker') for seg in data)
+
+    # Get unique speakers and assign colors
+    speakers = []
+    speaker_colors = {}
+    if has_speakers:
+        unique_speakers = list(dict.fromkeys(seg.get('speaker') for seg in data if seg.get('speaker')))
+        for i, speaker in enumerate(unique_speakers):
+            color = f'speaker-color-{(i % 8) + 1}'
+            speaker_colors[speaker] = color
+            speakers.append({'name': speaker, 'color': color})
+
+    # Process segments
+    segments = []
+    last_speaker = None
+    for seg in data:
+        speaker = seg.get('speaker', '')
+        segment = {
+            'text': seg.get('sentence', ''),
+            'speaker': speaker,
+            'start_time': seg.get('start_time') or seg.get('startTime', ''),
+            'end_time': seg.get('end_time') or seg.get('endTime', ''),
+            'color': speaker_colors.get(speaker, 'speaker-color-1'),
+            'show_speaker': speaker != last_speaker
+        }
+        segments.append(segment)
+        last_speaker = speaker
+
+    # Build plain text version
+    if has_speakers:
+        plain_text = '\n'.join(f"[{seg['speaker']}]: {seg['text']}" for seg in segments)
+    else:
+        plain_text = '\n'.join(seg['text'] for seg in segments)
+
+    return {
+        'is_json': True,
+        'has_speakers': has_speakers,
+        'segments': segments,
+        'speakers': speakers,
+        'plain_text': plain_text
+    }
+
+
+# --- Public Sharing Routes ---
+
+@shares_bp.route('/share/<string:public_id>', methods=['GET'])
+def view_shared_recording(public_id):
+    """View a publicly shared recording."""
+    share = Share.query.filter_by(public_id=public_id).first_or_404()
+    recording = share.recording
+
+    # Process transcription for server-side rendering (only if READABLE_PUBLIC_LINKS is enabled)
+    processed_transcript = None
+    if READABLE_PUBLIC_LINKS:
+        processed_transcript = process_transcription_for_template(recording.transcription)
+
+    # Create a limited dictionary for the public view
+    recording_data = {
+        'id': recording.id,
+        'public_id': share.public_id,
+        'title': recording.title,
+        'participants': recording.participants,
+        'transcription': recording.transcription,
+        'summary': md_to_html(recording.summary) if share.share_summary else None,
+        'summary_raw': recording.summary if share.share_summary else None,
+        'notes': md_to_html(recording.notes) if share.share_notes else None,
+        'notes_raw': recording.notes if share.share_notes else None,
+        'meeting_date': f"{recording.meeting_date.isoformat()}T00:00:00" if recording.meeting_date else None,
+        'mime_type': recording.mime_type,
+        'audio_deleted_at': recording.audio_deleted_at.isoformat() if recording.audio_deleted_at else None,
+        'audio_duration': recording.get_audio_duration()
+    }
+
+    return render_template('share.html', recording=recording_data, transcript=processed_transcript, readable_mode=READABLE_PUBLIC_LINKS)
+
+
+@shares_bp.route('/share/audio/<string:public_id>')
+def get_shared_audio(public_id):
+    """Serve audio file for a publicly shared recording."""
+    try:
+        share = Share.query.filter_by(public_id=public_id).first_or_404()
+        recording = share.recording
+        if not recording or not recording.audio_path:
+            return jsonify({'error': 'Recording or audio file not found'}), 404
+        if not os.path.exists(recording.audio_path):
+            current_app.logger.error(f"Audio file missing from server: {recording.audio_path}")
+            return jsonify({'error': 'Audio file missing from server'}), 404
+        return send_file(recording.audio_path, conditional=True)
+    except Exception as e:
+        current_app.logger.error(f"Error serving shared audio for public_id {public_id}: {e}", exc_info=True)
+        return jsonify({'error': 'An unexpected error occurred.'}), 500
+
+
+@shares_bp.route('/api/recording/<int:recording_id>/share', methods=['GET'])
+@login_required
+def get_existing_share(recording_id):
+    """Check if a share already exists for this recording."""
+    recording = db.session.get(Recording, recording_id)
+    if not recording or recording.user_id != current_user.id:
+        return jsonify({'error': 'Recording not found or you do not have permission to view it.'}), 404
+
+    existing_share = Share.query.filter_by(
+        recording_id=recording.id,
+        user_id=current_user.id
+    ).order_by(Share.created_at.desc()).first()
+
+    if existing_share:
+        share_url = url_for('shares.view_shared_recording', public_id=existing_share.public_id, _external=True)
+        return jsonify({
+            'success': True,
+            'exists': True,
+            'share_url': share_url,
+            'share': existing_share.to_dict()
+        }), 200
+    else:
+        return jsonify({
+            'success': True,
+            'exists': False
+        }), 200
+
+
+@shares_bp.route('/api/recording/<int:recording_id>/share', methods=['POST'])
+@login_required
+def create_share(recording_id):
+    """Create a public share link for a recording."""
+    # Check if public sharing is globally enabled
+    if not ENABLE_PUBLIC_SHARING:
+        return jsonify({'error': 'Public sharing is not enabled on this server'}), 403
+
+    # Check if user has permission to create public shares
+    if not current_user.can_share_publicly:
+        return jsonify({'error': 'You do not have permission to create public share links. Contact your administrator.'}), 403
+
+    if not request.is_secure:
+        return jsonify({'error': 'Sharing is only available over a secure (HTTPS) connection.'}), 403
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording or recording.user_id != current_user.id:
+        return jsonify({'error': 'Recording not found or you do not have permission to share it.'}), 404
+
+    data = request.json
+    share_summary = data.get('share_summary', True)
+    share_notes = data.get('share_notes', True)
+    force_new = data.get('force_new', False)
+
+    # Check if ANY share already exists for this recording by this user
+    existing_share = Share.query.filter_by(
+        recording_id=recording.id,
+        user_id=current_user.id
+    ).order_by(Share.created_at.desc()).first()
+
+    if existing_share and not force_new:
+        # Update the share permissions if they've changed
+        if existing_share.share_summary != share_summary or existing_share.share_notes != share_notes:
+            existing_share.share_summary = share_summary
+            existing_share.share_notes = share_notes
+            db.session.commit()
+
+        # Return existing share info
+        share_url = url_for('shares.view_shared_recording', public_id=existing_share.public_id, _external=True)
+        return jsonify({
+            'success': True,
+            'share_url': share_url,
+            'share': existing_share.to_dict(),
+            'existing': True,
+            'message': 'Using existing share link for this recording'
+        }), 200
+
+    # Create new share
+    share = Share(
+        recording_id=recording.id,
+        user_id=current_user.id,
+        share_summary=share_summary,
+        share_notes=share_notes
+    )
+    db.session.add(share)
+    db.session.commit()
+
+    share_url = url_for('shares.view_shared_recording', public_id=share.public_id, _external=True)
+
+    return jsonify({
+        'success': True,
+        'share_url': share_url,
+        'share': share.to_dict(),
+        'existing': False
+    }), 201
+
+
+@shares_bp.route('/api/shares', methods=['GET'])
+@login_required
+def get_shares():
+    """Get all public shares for the current user."""
+    shares = Share.query.filter_by(user_id=current_user.id).order_by(Share.created_at.desc()).all()
+    return jsonify([share.to_dict() for share in shares])
+
+
+@shares_bp.route('/api/share/<int:share_id>', methods=['PUT'])
+@login_required
+def update_share(share_id):
+    """Update a public share's settings."""
+    share = Share.query.filter_by(id=share_id, user_id=current_user.id).first_or_404()
+    data = request.json
+
+    if 'share_summary' in data:
+        share.share_summary = data['share_summary']
+    if 'share_notes' in data:
+        share.share_notes = data['share_notes']
+
+    db.session.commit()
+    return jsonify({'success': True, 'share': share.to_dict()})
+
+
+@shares_bp.route('/api/share/<int:share_id>', methods=['DELETE'])
+@login_required
+def delete_share(share_id):
+    """Delete a public share."""
+    share = Share.query.filter_by(id=share_id, user_id=current_user.id).first_or_404()
+    db.session.delete(share)
+    db.session.commit()
+    return jsonify({'success': True})
+
+
+# --- Internal Sharing Routes ---
+
+@shares_bp.route('/api/users/search', methods=['GET'])
+@login_required
+def search_users():
+    """Search for users by username (for internal sharing)."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    query = request.args.get('q', '').strip()
+
+    # If SHOW_USERNAMES_IN_UI is enabled and no query, return all users for quick selection
+    if SHOW_USERNAMES_IN_UI and len(query) < 2:
+        users = User.query.filter(User.id != current_user.id).order_by(User.username).all()
+    elif len(query) < 2:
+        # If usernames are hidden and no query, return empty
+        return jsonify([])
+    else:
+        if SHOW_USERNAMES_IN_UI:
+            # If usernames are shown, allow partial match (autocomplete)
+            users = User.query.filter(
+                User.id != current_user.id,
+                User.username.ilike(f'%{query}%')
+            ).limit(10).all()
+        else:
+            # If usernames are hidden (privacy mode), require exact match only
+            users = User.query.filter(
+                User.id != current_user.id,
+                User.username == query
+            ).all()
+
+    return jsonify([{
+        'id': user.id,
+        'username': user.username,
+        'email': user.email if SHOW_USERNAMES_IN_UI else None
+    } for user in users])
+
+
+@shares_bp.route('/api/recordings/<int:recording_id>/share-internal', methods=['POST'])
+@login_required
+def share_recording_internal(recording_id):
+    """Share a recording with another user internally."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    try:
+        data = request.json
+        shared_with_user_id = data.get('user_id')
+        can_edit = data.get('can_edit', False)
+        can_reshare = data.get('can_reshare', False)
+
+        if not shared_with_user_id:
+            return jsonify({'error': 'User ID is required'}), 400
+
+        # Check recording exists and user has permission to share it
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_reshare=True):
+            return jsonify({'error': 'You do not have permission to share this recording'}), 403
+
+        # Check target user exists
+        target_user = db.session.get(User, shared_with_user_id)
+        if not target_user:
+            return jsonify({'error': 'Target user not found'}), 404
+
+        # Prevent sharing back to owner (circular share)
+        if shared_with_user_id == recording.user_id:
+            return jsonify({'error': 'Cannot share a recording with its owner'}), 400
+
+        # Prevent sharing with self
+        if shared_with_user_id == current_user.id:
+            return jsonify({'error': 'Cannot share a recording with yourself'}), 400
+
+        # Check if already shared
+        existing_share = InternalShare.query.filter_by(
+            recording_id=recording_id,
+            shared_with_user_id=shared_with_user_id
+        ).first()
+
+        if existing_share:
+            return jsonify({'error': 'Recording already shared with this user'}), 409
+
+        # PERMISSION VALIDATION: Validate that current user can grant the requested permissions
+        requested_permissions = {'can_edit': can_edit, 'can_reshare': can_reshare}
+        is_valid, error_message = InternalShare.validate_reshare_permissions(
+            recording, current_user, requested_permissions
+        )
+
+        if not is_valid:
+            return jsonify({'error': error_message}), 403
+
+        # Get current user's permissions for audit log
+        actor_permissions = InternalShare.get_user_max_permissions(recording, current_user)
+
+        # Create share
+        share = InternalShare(
+            recording_id=recording_id,
+            owner_id=current_user.id,
+            shared_with_user_id=shared_with_user_id,
+            can_edit=can_edit,
+            can_reshare=can_reshare
+        )
+        db.session.add(share)
+
+        # Create or update SharedRecordingState for the recipient
+        state = SharedRecordingState.query.filter_by(
+            recording_id=recording_id,
+            user_id=shared_with_user_id
+        ).first()
+
+        if not state:
+            # Create new state if it doesn't exist
+            state = SharedRecordingState(
+                recording_id=recording_id,
+                user_id=shared_with_user_id,
+                is_inbox=True,  # New shares appear in inbox by default
+                is_highlighted=False  # Not favorited by default
+            )
+            db.session.add(state)
+        else:
+            # Reset to inbox if it already exists (e.g., from previous share that was deleted)
+            state.is_inbox = True
+
+        db.session.commit()
+
+        # AUDIT LOGGING: Log the share creation
+        try:
+            ShareAuditLog.log_share_created(
+                recording_id=recording_id,
+                actor_id=current_user.id,
+                target_user_id=shared_with_user_id,
+                permissions={'can_edit': can_edit, 'can_reshare': can_reshare},
+                actor_permissions=actor_permissions,
+                notes=f"Shared by {'owner' if recording.user_id == current_user.id else 'delegated user'}",
+                ip_address=request.remote_addr
+            )
+            db.session.commit()
+        except Exception as audit_error:
+            # Don't fail the share if audit logging fails
+            current_app.logger.error(f"Failed to log share creation: {audit_error}")
+
+        return jsonify({
+            'success': True,
+            'share': share.to_dict()
+        }), 201
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error sharing recording internally: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@shares_bp.route('/api/recordings/<int:recording_id>/shares-internal', methods=['GET'])
+@login_required
+def get_internal_shares(recording_id):
+    """Get list of users a recording is shared with, including owner."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    # Check recording exists and user has permission to view shares
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return jsonify({'error': 'Recording not found'}), 404
+
+    if not has_recording_access(recording, current_user, require_reshare=True):
+        return jsonify({'error': 'You do not have permission to view shares for this recording'}), 403
+
+    # Get all internal shares
+    shares = InternalShare.query.filter_by(recording_id=recording_id).all()
+    shares_list = [share.to_dict() for share in shares]
+
+    # Add owner as first entry (owner always has full permissions)
+    owner = db.session.get(User, recording.user_id)
+    if owner:
+        owner_entry = {
+            'id': None,  # No share ID for owner
+            'recording_id': recording_id,
+            'owner_id': owner.id,
+            'owner_username': owner.username,
+            'user_id': owner.id,
+            'username': owner.username,
+            'can_edit': True,
+            'can_reshare': True,
+            'is_owner': True,  # Mark as owner
+            'source_type': 'owner',
+            'source_tag_id': None,
+            'created_at': recording.created_at.isoformat() if recording.created_at else None
+        }
+        # Insert owner at the beginning
+        shares_list.insert(0, owner_entry)
+
+    return jsonify({'shares': shares_list})
+
+
+@shares_bp.route('/api/internal-shares/<int:share_id>', methods=['DELETE'])
+@login_required
+def revoke_internal_share(share_id):
+    """Revoke an internal share with cascade revocation."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    share = db.session.get(InternalShare, share_id)
+    if not share:
+        return jsonify({'error': 'Share not found'}), 404
+
+    # Only owner can revoke
+    if share.owner_id != current_user.id:
+        return jsonify({'error': 'You do not have permission to revoke this share'}), 403
+
+    recording_id = share.recording_id
+    revoked_user_id = share.shared_with_user_id
+    revoked_count = 0
+
+    try:
+        # CASCADE REVOCATION: Find downstream shares created by the user losing access
+        downstream_shares = InternalShare.find_downstream_shares(recording_id, revoked_user_id)
+
+        # Recursively revoke downstream shares that don't have alternate paths
+        for downstream in downstream_shares:
+            # Check for alternate access paths (diamond pattern protection)
+            has_alternate = InternalShare.has_alternate_access_path(
+                recording_id,
+                downstream.shared_with_user_id,
+                excluding_grantor_id=revoked_user_id
+            )
+
+            if not has_alternate:
+                # No alternate path - cascade revoke
+                # Audit log cascade revocation
+                try:
+                    ShareAuditLog.log_share_revoked(
+                        share_id=downstream.id,
+                        recording_id=recording_id,
+                        actor_id=current_user.id,
+                        target_user_id=downstream.shared_with_user_id,
+                        was_cascade=True,
+                        notes=f"Cascaded from revoking user {revoked_user_id}",
+                        ip_address=request.remote_addr
+                    )
+                except Exception as audit_error:
+                    current_app.logger.error(f"Failed to log cascade revocation: {audit_error}")
+
+                db.session.delete(downstream)
+                revoked_count += 1
+
+        # Audit log the primary revocation
+        try:
+            ShareAuditLog.log_share_revoked(
+                share_id=share.id,
+                recording_id=recording_id,
+                actor_id=current_user.id,
+                target_user_id=revoked_user_id,
+                was_cascade=False,
+                notes=f"Revoked by user {current_user.id}, cascaded to {revoked_count} downstream shares",
+                ip_address=request.remote_addr
+            )
+        except Exception as audit_error:
+            current_app.logger.error(f"Failed to log revocation: {audit_error}")
+
+        # Delete the primary share
+        db.session.delete(share)
+        db.session.commit()
+
+        return jsonify({
+            'success': True,
+            'revoked_count': revoked_count + 1,  # Include primary share
+            'cascaded': revoked_count
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error revoking internal share: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@shares_bp.route('/api/recordings/shared-with-me', methods=['GET'])
+@login_required
+def get_shared_with_me():
+    """Get recordings that have been shared with the current user."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Internal sharing is not enabled'}), 403
+
+    try:
+        # Get shares where current user is the recipient
+        shares = InternalShare.query.filter_by(shared_with_user_id=current_user.id).all()
+
+        result = []
+        for share in shares:
+            recording = share.recording
+            if recording and recording.status == 'COMPLETED':
+                rec_data = recording.to_list_dict(viewer_user=current_user)
+                # Mark as shared recording with owner info
+                rec_data['is_shared'] = True
+                rec_data['owner_username'] = share.owner.username if SHOW_USERNAMES_IN_UI else None
+                # Don't show outgoing share counts for recordings you don't own
+                rec_data['shared_with_count'] = 0
+                rec_data['public_share_count'] = 0
+                # Check if recording has group tags (among visible tags)
+                visible_tags = recording.get_visible_tags(current_user)
+                rec_data['has_group_tags'] = any(tag.is_group_tag for tag in visible_tags) if visible_tags else False
+                rec_data['share_info'] = {
+                    'share_id': share.id,
+                    'owner_username': share.owner.username if SHOW_USERNAMES_IN_UI else None,
+                    'can_edit': share.can_edit,
+                    'can_reshare': share.can_reshare,
+                    'shared_at': share.created_at.isoformat()
+                }
+                result.append(rec_data)
+
+        return jsonify(result)
+
+    except Exception as e:
+        current_app.logger.error(f"Error fetching shared recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@shares_bp.route('/api/permissions/can-share-publicly', methods=['GET'])
+@login_required
+def can_share_publicly():
+    """Check if the current user has permission to create public shares."""
+    return jsonify({
+        'can_share_publicly': current_user.can_share_publicly and ENABLE_PUBLIC_SHARING
+    })
diff --git a/src/api/speakers.py b/src/api/speakers.py
new file mode 100644
index 00000000..2151edf6
--- /dev/null
+++ b/src/api/speakers.py
@@ -0,0 +1,583 @@
+"""
+Speaker identification and management.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import time
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.utils.ffmpeg_utils import extract_audio_segment, FFmpegError, FFmpegNotFoundError
+from src.utils.ffprobe import get_codec_info, FFProbeError
+from src.services.speaker_embedding_matcher import find_matching_speakers
+from src.services.speaker_snippets import get_speaker_snippets, get_speaker_recordings_with_snippets
+from src.services.speaker_merge import merge_speakers, preview_merge, can_merge_speakers
+
+# Create blueprint
+speakers_bp = Blueprint('speakers', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_speakers_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@speakers_bp.route('/speakers', methods=['GET'])
+@login_required
+def get_speakers():
+    """Get all speakers for the current user, ordered by usage frequency and recency."""
+    try:
+        speakers = Speaker.query.filter_by(user_id=current_user.id)\
+                               .order_by(Speaker.use_count.desc(), Speaker.last_used.desc())\
+                               .all()
+        return jsonify([speaker.to_dict() for speaker in speakers])
+    except Exception as e:
+        current_app.logger.error(f"Error fetching speakers: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@speakers_bp.route('/speakers/search', methods=['GET'])
+@login_required
+def search_speakers():
+    """Search speakers by name for autocomplete functionality."""
+    try:
+        query = request.args.get('q', '').strip()
+        if not query:
+            return jsonify([])
+        
+        speakers = Speaker.query.filter_by(user_id=current_user.id)\
+                               .filter(Speaker.name.ilike(f'%{query}%'))\
+                               .order_by(Speaker.use_count.desc(), Speaker.last_used.desc())\
+                               .limit(10)\
+                               .all()
+        
+        return jsonify([speaker.to_dict() for speaker in speakers])
+    except Exception as e:
+        current_app.logger.error(f"Error searching speakers: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@speakers_bp.route('/speakers', methods=['POST'])
+@login_required
+def create_speaker():
+    """Create a new speaker or update existing one."""
+    try:
+        data = request.json
+        name = data.get('name', '').strip()
+        
+        if not name:
+            return jsonify({'error': 'Speaker name is required'}), 400
+        
+        # Check if speaker already exists for this user
+        existing_speaker = Speaker.query.filter_by(user_id=current_user.id, name=name).first()
+        
+        if existing_speaker:
+            # Update usage statistics
+            existing_speaker.use_count += 1
+            existing_speaker.last_used = datetime.utcnow()
+            db.session.commit()
+            return jsonify(existing_speaker.to_dict())
+        else:
+            # Create new speaker
+            speaker = Speaker(
+                name=name,
+                user_id=current_user.id,
+                use_count=1,
+                created_at=datetime.utcnow(),
+                last_used=datetime.utcnow()
+            )
+            db.session.add(speaker)
+            db.session.commit()
+            return jsonify(speaker.to_dict()), 201
+            
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error creating speaker: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@speakers_bp.route('/speakers/<int:speaker_id>', methods=['PUT'])
+@login_required
+def update_speaker(speaker_id):
+    """Update a speaker's name and cascade the change to all recordings."""
+    try:
+        speaker = Speaker.query.filter_by(id=speaker_id, user_id=current_user.id).first()
+        if not speaker:
+            return jsonify({'error': 'Speaker not found'}), 404
+
+        data = request.json
+        new_name = data.get('name', '').strip()
+
+        if not new_name:
+            return jsonify({'error': 'Speaker name cannot be empty'}), 400
+
+        # Check if another speaker with this name already exists for this user
+        existing_speaker = Speaker.query.filter_by(user_id=current_user.id, name=new_name).first()
+        if existing_speaker and existing_speaker.id != speaker_id:
+            return jsonify({'error': f'A speaker named "{new_name}" already exists'}), 400
+
+        # Store old name for updating transcript chunks and recordings
+        old_name = speaker.name
+
+        # Update the speaker name
+        speaker.name = new_name
+
+        # Update all transcript chunks that reference this speaker's old name
+        # This ensures the name change cascades to all recordings
+        from src.models import TranscriptChunk
+        chunks_updated = TranscriptChunk.query.filter_by(
+            user_id=current_user.id,
+            speaker_name=old_name
+        ).update({'speaker_name': new_name})
+
+        # Update Recording.participants field (comma-separated list of speakers)
+        # AND update speaker names in the transcription JSON
+        recordings_updated = 0
+        user_recordings = Recording.query.filter_by(user_id=current_user.id).all()
+
+        for recording in user_recordings:
+            updated = False
+
+            # Update participants field if it contains the old name
+            if recording.participants and old_name in recording.participants:
+                # Replace exact speaker name matches in participants list
+                # Handle various formats: "Ross", "Ross, John", "John, Ross", etc.
+                participants_list = [p.strip() for p in recording.participants.split(',')]
+                if old_name in participants_list:
+                    # Replace the old name with new name
+                    participants_list = [new_name if p == old_name else p for p in participants_list]
+                    recording.participants = ', '.join(participants_list)
+                    updated = True
+
+            # Update speaker names in the transcription JSON
+            # This is what displays in the transcript view speaker badges
+            if recording.transcription:
+                try:
+                    transcription_data = json.loads(recording.transcription)
+
+                    # Handle JSON format (array of segments with speaker field)
+                    if isinstance(transcription_data, list):
+                        segments_updated = False
+                        for segment in transcription_data:
+                            if segment.get('speaker') == old_name:
+                                segment['speaker'] = new_name
+                                segments_updated = True
+
+                        if segments_updated:
+                            recording.transcription = json.dumps(transcription_data)
+                            updated = True
+                except (json.JSONDecodeError, TypeError):
+                    # Not JSON or invalid format, skip
+                    pass
+
+            if updated:
+                recordings_updated += 1
+
+        db.session.commit()
+
+        current_app.logger.info(
+            f"Updated speaker {speaker_id} from '{old_name}' to '{new_name}': "
+            f"{chunks_updated} transcript chunks, {recordings_updated} recordings"
+        )
+
+        return jsonify({
+            'success': True,
+            'speaker': speaker.to_dict(),
+            'chunks_updated': chunks_updated,
+            'recordings_updated': recordings_updated
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error updating speaker: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/<int:speaker_id>', methods=['DELETE'])
+@login_required
+def delete_speaker(speaker_id):
+    """Delete a speaker."""
+    try:
+        speaker = Speaker.query.filter_by(id=speaker_id, user_id=current_user.id).first()
+        if not speaker:
+            return jsonify({'error': 'Speaker not found'}), 404
+
+        db.session.delete(speaker)
+        db.session.commit()
+        return jsonify({'success': True})
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error deleting speaker: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+@speakers_bp.route('/speakers/delete_all', methods=['DELETE'])
+@login_required
+def delete_all_speakers():
+    """Delete all speakers for the current user."""
+    try:
+        deleted_count = Speaker.query.filter_by(user_id=current_user.id).delete()
+        db.session.commit()
+        return jsonify({'success': True, 'deleted_count': deleted_count})
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error deleting all speakers: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/suggestions/<int:recording_id>', methods=['GET'])
+@login_required
+def get_speaker_suggestions(recording_id):
+    """
+    Get speaker suggestions based on voice embeddings from a recording.
+
+    For each speaker in the recording, returns matching speakers from the user's
+    speaker database based on voice similarity.
+
+    Returns:
+        {
+            'SPEAKER_00': [
+                {'speaker_id': 5, 'name': 'John', 'similarity': 85.3, 'confidence': 0.92},
+                ...
+            ],
+            'SPEAKER_01': [...],
+            ...
+        }
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        # Get speaker embeddings from recording
+        if not recording.speaker_embeddings:
+            return jsonify({'suggestions': {}, 'message': 'No speaker embeddings available'}), 200
+
+        try:
+            embeddings_data = json.loads(recording.speaker_embeddings) if isinstance(recording.speaker_embeddings, str) else recording.speaker_embeddings
+        except (json.JSONDecodeError, TypeError):
+            return jsonify({'error': 'Invalid speaker embeddings data'}), 500
+
+        # Get similarity threshold from query params (default 70%)
+        threshold = float(request.args.get('threshold', 0.70))
+
+        # Find matches for each speaker
+        suggestions = {}
+        for speaker_label, embedding in embeddings_data.items():
+            if embedding and len(embedding) == 256:  # Validate embedding dimension
+                matches = find_matching_speakers(embedding, current_user.id, threshold)
+                suggestions[speaker_label] = matches
+            else:
+                suggestions[speaker_label] = []
+
+        return jsonify({
+            'success': True,
+            'suggestions': suggestions,
+            'recording_id': recording_id
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting speaker suggestions: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/<int:speaker_id>/snippets', methods=['GET'])
+@login_required
+def get_snippets(speaker_id):
+    """
+    Get representative speech snippets for a speaker.
+
+    Returns recent quotes from recordings where this speaker appeared.
+    """
+    try:
+        # Verify speaker belongs to user
+        speaker = Speaker.query.filter_by(id=speaker_id, user_id=current_user.id).first()
+        if not speaker:
+            return jsonify({'error': 'Speaker not found'}), 404
+
+        limit = int(request.args.get('limit', 5))
+        snippets = get_speaker_snippets(speaker_id, limit)
+
+        return jsonify({
+            'success': True,
+            'speaker_id': speaker_id,
+            'speaker_name': speaker.name,
+            'snippets': snippets
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting speaker snippets: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/<int:speaker_id>/recordings', methods=['GET'])
+@login_required
+def get_speaker_recordings(speaker_id):
+    """
+    Get list of recordings that contain snippets from this speaker.
+
+    Returns recording metadata with snippet counts.
+    """
+    try:
+        # Verify speaker belongs to user
+        speaker = Speaker.query.filter_by(id=speaker_id, user_id=current_user.id).first()
+        if not speaker:
+            return jsonify({'error': 'Speaker not found'}), 404
+
+        recordings = get_speaker_recordings_with_snippets(speaker_id)
+
+        return jsonify({
+            'success': True,
+            'speaker_id': speaker_id,
+            'speaker_name': speaker.name,
+            'recordings': recordings
+        })
+
+    except Exception as e:
+        current_app.logger.error(f"Error getting speaker recordings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/<int:speaker_id>/clear_embeddings', methods=['POST'])
+@login_required
+def clear_speaker_embeddings(speaker_id):
+    """
+    Clear all voice embeddings for a speaker.
+
+    This removes all voice recognition data but keeps the speaker name and metadata.
+    Useful for resetting voice profiles or removing outdated/incorrect voice data.
+    """
+    try:
+        # Verify speaker belongs to user
+        speaker = Speaker.query.filter_by(id=speaker_id, user_id=current_user.id).first()
+        if not speaker:
+            return jsonify({'error': 'Speaker not found'}), 404
+
+        # Clear all embeddings
+        speaker.voice_embeddings = None
+        speaker.embedding_count = 0
+        speaker.confidence_score = None
+
+        db.session.commit()
+
+        current_app.logger.info(f"Cleared voice embeddings for speaker {speaker_id} ({speaker.name})")
+
+        return jsonify({
+            'success': True,
+            'message': f'Voice profile cleared for {speaker.name}',
+            'speaker': {
+                'id': speaker.id,
+                'name': speaker.name,
+                'embedding_count': 0
+            }
+        })
+
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error clearing speaker embeddings: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/snippet-audio/<int:recording_id>', methods=['GET'])
+@login_required
+def get_snippet_audio(recording_id):
+    """
+    Serve a short audio snippet from a recording.
+
+    Query parameters:
+        start: Start time in seconds (float)
+        duration: Duration in seconds (float, max 5.0)
+
+    Returns:
+        Audio file segment in the original format
+    """
+    import tempfile
+    import os
+    from pathlib import Path
+
+    try:
+        # Get query parameters
+        start_time = float(request.args.get('start', 0))
+        duration = min(float(request.args.get('duration', 4.0)), 5.0)  # Max 5 seconds
+
+        # Get the recording
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            return jsonify({'error': 'Recording not found'}), 404
+
+        if not has_recording_access(recording, current_user, require_edit=False):
+            return jsonify({'error': 'You do not have permission to access this recording'}), 403
+
+        if recording.audio_deleted_at:
+            return jsonify({'error': 'Audio file has been deleted'}), 410
+
+        if not recording.audio_path or not os.path.exists(recording.audio_path):
+            return jsonify({'error': 'Audio file not found'}), 404
+
+        # Detect audio codec to pick the right output container for stream copy
+        codec_to_container = {
+            'mp3': ('.mp3', 'audio/mpeg'),
+            'aac': ('.m4a', 'audio/mp4'),
+            'opus': ('.ogg', 'audio/ogg'),
+            'vorbis': ('.ogg', 'audio/ogg'),
+            'flac': ('.flac', 'audio/flac'),
+            'pcm_s16le': ('.wav', 'audio/wav'),
+            'pcm_s24le': ('.wav', 'audio/wav'),
+            'pcm_s32le': ('.wav', 'audio/wav'),
+            'pcm_f32le': ('.wav', 'audio/wav'),
+        }
+        snippet_ext = '.mp3'
+        snippet_mime = 'audio/mpeg'
+        try:
+            codec_info = get_codec_info(recording.audio_path, timeout=10)
+            audio_codec = codec_info.get('audio_codec')
+            if audio_codec and audio_codec in codec_to_container:
+                snippet_ext, snippet_mime = codec_to_container[audio_codec]
+        except FFProbeError:
+            pass  # Fall back to mp3
+
+        # Create temporary file for the snippet
+        with tempfile.NamedTemporaryFile(delete=False, suffix=snippet_ext) as tmp_file:
+            output_path = tmp_file.name
+
+        try:
+            # Use centralized FFmpeg utility to extract the audio segment
+            extract_audio_segment(
+                recording.audio_path,
+                output_path,
+                start_time,
+                duration
+            )
+
+            # Send the file
+            response = send_file(
+                output_path,
+                mimetype=snippet_mime,
+                as_attachment=False,
+                download_name=f'snippet_{recording_id}_{start_time:.1f}s{snippet_ext}'
+            )
+
+            # Clean up temporary file after sending
+            @response.call_on_close
+            def cleanup():
+                try:
+                    os.unlink(output_path)
+                except:
+                    pass
+
+            return response
+
+        except FFmpegNotFoundError as e:
+            current_app.logger.error(f"FFmpeg not found: {e}")
+            try:
+                os.unlink(output_path)
+            except:
+                pass
+            return jsonify({'error': 'FFmpeg not found on server'}), 500
+        except FFmpegError as e:
+            current_app.logger.error(f"FFmpeg error extracting snippet: {e}")
+            try:
+                os.unlink(output_path)
+            except:
+                pass
+            return jsonify({'error': 'Failed to extract audio snippet'}), 500
+
+    except ValueError:
+        return jsonify({'error': 'Invalid start time or duration'}), 400
+    except Exception as e:
+        current_app.logger.error(f"Error serving audio snippet: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+@speakers_bp.route('/speakers/merge', methods=['POST'])
+@login_required
+def merge_speaker_profiles():
+    """
+    Merge multiple speaker profiles into one.
+
+    Request body:
+        {
+            'target_id': 5,  # Speaker to keep
+            'source_ids': [6, 7, 8],  # Speakers to merge into target
+            'preview': false  # Optional: if true, just preview without executing
+        }
+
+    Returns merged speaker data or preview statistics.
+    """
+    try:
+        data = request.json
+        target_id = data.get('target_id')
+        source_ids = data.get('source_ids', [])
+        preview = data.get('preview', False)
+
+        if not target_id:
+            return jsonify({'error': 'target_id is required'}), 400
+
+        if not source_ids or not isinstance(source_ids, list):
+            return jsonify({'error': 'source_ids must be a non-empty list'}), 400
+
+        # Validate speakers can be merged
+        can_merge, error_msg = can_merge_speakers([target_id] + source_ids, current_user.id)
+        if not can_merge:
+            return jsonify({'error': error_msg}), 400
+
+        if preview:
+            # Just return preview statistics
+            preview_data = preview_merge(target_id, source_ids, current_user.id)
+            return jsonify({
+                'success': True,
+                'preview': preview_data
+            })
+        else:
+            # Execute the merge
+            merged_speaker = merge_speakers(target_id, source_ids, current_user.id)
+            return jsonify({
+                'success': True,
+                'message': f'Successfully merged {len(source_ids)} speaker(s) into {merged_speaker.name}',
+                'speaker': merged_speaker.to_dict()
+            })
+
+    except ValueError as e:
+        return jsonify({'error': str(e)}), 400
+    except Exception as e:
+        db.session.rollback()
+        current_app.logger.error(f"Error merging speakers: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
diff --git a/src/api/system.py b/src/api/system.py
new file mode 100644
index 00000000..78efb9e1
--- /dev/null
+++ b/src/api/system.py
@@ -0,0 +1,349 @@
+"""
+System info and configuration.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+from src.config.version import get_version
+from src.services.llm import TEXT_MODEL_BASE_URL, TEXT_MODEL_NAME
+from src.config.app_config import ASR_BASE_URL, USE_NEW_TRANSCRIPTION_ARCHITECTURE, TRANSCRIPTION_MODEL_OPTIONS
+from src.services.token_tracking import token_tracker
+from src.services.transcription import TranscriptionCapability
+
+# Create blueprint
+system_bp = Blueprint('system', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+DELETION_MODE = os.environ.get('DELETION_MODE', 'full_recording')  # 'audio_only' or 'full_recording'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+ENABLE_CHUNKING = os.environ.get('ENABLE_CHUNKING', 'true').lower() == 'true'
+SHOW_USERNAMES_IN_UI = os.environ.get('SHOW_USERNAMES_IN_UI', 'false').lower() == 'true'
+ENABLE_AUTO_EXPORT = os.environ.get('ENABLE_AUTO_EXPORT', 'false').lower() == 'true'
+ENABLE_INCOGNITO_MODE = os.environ.get('ENABLE_INCOGNITO_MODE', 'false').lower() == 'true'
+INCOGNITO_MODE_DEFAULT = os.environ.get('INCOGNITO_MODE_DEFAULT', 'false').lower() == 'true'
+VIDEO_RETENTION = os.environ.get('VIDEO_RETENTION', 'false').lower() == 'true'
+MAX_CONCURRENT_UPLOADS = int(os.environ.get('MAX_CONCURRENT_UPLOADS', '3'))
+
+# Import chunking service (will be set from app)
+chunking_service = None
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_system_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter, chunking_service
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+    chunking_service = kwargs.get('chunking_service')
+
+
+def csrf_exempt(f):
+    """Decorator placeholder for CSRF exemption - applied after initialization."""
+    from functools import wraps
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        return f(*args, **kwargs)
+    wrapper._csrf_exempt = True
+    return wrapper
+
+
+# --- Routes ---
+
+@system_bp.route('/api/user/preferences', methods=['POST'])
+@login_required
+def save_user_preferences():
+    """Save user preferences including UI language"""
+    data = request.json
+    
+    if 'language' in data:
+        current_user.ui_language = data['language']
+    
+    db.session.commit()
+    
+    return jsonify({
+        'success': True,
+        'message': 'Preferences saved successfully',
+        'ui_language': current_user.ui_language
+    })
+
+
+@system_bp.route('/api/user/token-budget', methods=['GET'])
+@login_required
+def get_user_token_budget():
+    """Get current user's token budget status."""
+    try:
+        user = current_user
+
+        # If user has no budget, return null to indicate unlimited
+        if not user.monthly_token_budget:
+            return jsonify({
+                'has_budget': False,
+                'budget': None,
+                'usage': 0,
+                'percentage': 0
+            })
+
+        # Get current usage
+        current_usage = token_tracker.get_monthly_usage(user.id)
+        percentage = (current_usage / user.monthly_token_budget) * 100
+
+        return jsonify({
+            'has_budget': True,
+            'budget': user.monthly_token_budget,
+            'usage': current_usage,
+            'percentage': round(percentage, 1)
+        })
+    except Exception as e:
+        current_app.logger.error(f"Error getting token budget for user {current_user.id}: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+# --- System Info API Endpoint ---
+
+
+@system_bp.route('/api/system/info', methods=['GET'])
+def get_system_info():
+    """Get system information including version and model details."""
+    try:
+        # Use the same version detection logic as startup
+        version = get_version()
+
+        # Get transcription connector info
+        transcription_info = {
+            'connector': 'unknown',
+            'model': None,
+            'supports_diarization': USE_ASR_ENDPOINT,  # Backwards compatible default
+            'supports_speaker_embeddings': False,
+        }
+
+        if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+            try:
+                from src.services.transcription import get_registry
+                registry = get_registry()
+                connector = registry.get_active_connector()
+                if connector:
+                    transcription_info = {
+                        'connector': registry.get_active_connector_name(),
+                        'model': getattr(connector, 'model', None),  # Model name if available
+                        'supports_diarization': connector.supports_diarization,
+                        'supports_speaker_embeddings': connector.supports(TranscriptionCapability.SPEAKER_EMBEDDINGS),
+                    }
+            except Exception as e:
+                current_app.logger.warning(f"Could not get connector info: {e}")
+
+        # Determine ASR status from connector (new arch) or env var (legacy)
+        is_asr_connector = transcription_info.get('connector') == 'asr_endpoint'
+        asr_enabled = is_asr_connector or USE_ASR_ENDPOINT
+
+        # Determine the active transcription endpoint based on which connector is in use
+        if asr_enabled:
+            active_endpoint = ASR_BASE_URL
+        else:
+            active_endpoint = os.environ.get('TRANSCRIPTION_BASE_URL', 'https://api.openai.com/v1')
+
+        return jsonify({
+            'version': version,
+            'llm_endpoint': TEXT_MODEL_BASE_URL,
+            'llm_model': TEXT_MODEL_NAME,
+            'transcription_endpoint': active_endpoint,  # The actual endpoint being used
+            'asr_enabled': asr_enabled,
+            # Legacy fields for backwards compatibility
+            'whisper_endpoint': os.environ.get('TRANSCRIPTION_BASE_URL', 'https://api.openai.com/v1'),
+            'asr_endpoint': ASR_BASE_URL if asr_enabled else None,
+            'transcription': transcription_info,
+        })
+    except Exception as e:
+        current_app.logger.error(f"Error getting system info: {e}")
+        return jsonify({'error': 'Unable to retrieve system information'}), 500
+
+# --- Tag API Endpoints ---
+
+
+def _get_transcription_model_options():
+    """Return the configured per-upload transcription model dropdown options.
+
+    Resolution order:
+      1. SystemSetting `transcription_models_visible_json` (admin UI overrides)
+      2. TRANSCRIPTION_MODELS_AVAILABLE env var
+      3. Empty list (dropdown hidden)
+    Issue #266.
+    """
+    try:
+        from src.models import SystemSetting
+        import json as _json
+        raw = SystemSetting.get_setting('transcription_models_visible_json', None)
+        if raw:
+            parsed = _json.loads(raw)
+            if isinstance(parsed, list):
+                return parsed
+    except Exception:
+        pass
+    return list(TRANSCRIPTION_MODEL_OPTIONS)
+
+
+@system_bp.route('/api/config', methods=['GET'])
+def get_config():
+    """Get application configuration settings for the frontend."""
+    try:
+        # Get configurable file size limit
+        max_file_size_mb = SystemSetting.get_setting('max_file_size_mb', 250)
+
+        # Get chunking configuration (supports both legacy and new formats)
+        chunking_info = {}
+        if ENABLE_CHUNKING and chunking_service:
+            mode, limit_value = chunking_service.parse_chunk_limit()
+            chunking_info = {
+                'chunking_enabled': True,
+                'chunking_mode': mode,  # 'size' or 'duration'
+                'chunking_limit': limit_value,  # Value in MB or seconds
+                'chunking_limit_display': f"{limit_value}{'MB' if mode == 'size' else 's'}"
+            }
+        else:
+            chunking_info = {
+                'chunking_enabled': False,
+                'chunking_mode': 'size',
+                'chunking_limit': 20,
+                'chunking_limit_display': '20MB'
+            }
+
+        # Check if current user can delete (for authenticated requests)
+        can_delete = True  # Default to true for unauthenticated config requests
+        try:
+            from flask_login import current_user
+            if current_user and current_user.is_authenticated:
+                can_delete = USERS_CAN_DELETE or current_user.is_admin
+        except:
+            pass  # If not authenticated, use default
+
+        # Calculate if archive toggle should be shown (only when audio-only deletion mode is active)
+        enable_archive_toggle = ENABLE_AUTO_DELETION and DELETION_MODE == 'audio_only'
+
+        # Get connector capabilities (new architecture)
+        # Defaults to USE_ASR_ENDPOINT for backwards compatibility
+        connector_supports_diarization = USE_ASR_ENDPOINT
+        connector_supports_speaker_count = USE_ASR_ENDPOINT  # ASR endpoint supports min/max speakers
+        connector_supports_hotwords = USE_ASR_ENDPOINT
+        connector_supports_initial_prompt = USE_ASR_ENDPOINT
+        is_asr_connector = False
+        if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+            try:
+                from src.services.transcription import get_registry
+                registry = get_registry()
+                connector = registry.get_active_connector()
+                if connector:
+                    connector_supports_diarization = connector.supports_diarization
+                    connector_supports_speaker_count = connector.supports_speaker_count_control
+                    connector_supports_hotwords = connector.supports_hotwords
+                    connector_supports_initial_prompt = connector.supports_initial_prompt
+                    is_asr_connector = registry.get_active_connector_name() == 'asr_endpoint'
+            except Exception as e:
+                current_app.logger.warning(f"Could not get connector capabilities: {e}")
+
+        # Derive ASR status from connector or legacy env var
+        asr_enabled = is_asr_connector or USE_ASR_ENDPOINT
+
+        # Get user's default transcription language if authenticated
+        user_transcription_language = ''
+        user_summary_prompt = ''
+        try:
+            from flask_login import current_user
+            if current_user and current_user.is_authenticated:
+                if current_user.transcription_language:
+                    user_transcription_language = current_user.transcription_language
+                if current_user.summary_prompt:
+                    user_summary_prompt = current_user.summary_prompt
+        except:
+            pass
+
+        # Admin-defined default summary prompt. Used by the upload form to
+        # surface `{{name}}` placeholders that would otherwise substitute to
+        # empty strings on uploads that fall through to this prompt.
+        admin_default_summary_prompt = SystemSetting.get_setting('admin_default_summary_prompt', '') or ''
+
+        return jsonify({
+            'max_file_size_mb': max_file_size_mb,
+            'recording_disclaimer': SystemSetting.get_setting('recording_disclaimer', ''),
+            'upload_disclaimer': SystemSetting.get_setting('upload_disclaimer', ''),
+            'custom_banner': SystemSetting.get_setting('custom_banner', ''),
+            'use_asr_endpoint': asr_enabled,  # Derived from connector or legacy env var
+            'connector_supports_diarization': connector_supports_diarization,  # Connector capability
+            'connector_supports_speaker_count': connector_supports_speaker_count,  # Min/max speakers
+            'connector_supports_hotwords': connector_supports_hotwords,
+            'connector_supports_initial_prompt': connector_supports_initial_prompt,
+            'enable_internal_sharing': ENABLE_INTERNAL_SHARING,
+            'enable_archive_toggle': enable_archive_toggle,
+            'show_usernames_in_ui': SHOW_USERNAMES_IN_UI,
+            'can_delete_recordings': can_delete,
+            'users_can_delete_enabled': USERS_CAN_DELETE,
+            'enable_incognito_mode': ENABLE_INCOGNITO_MODE,
+            'incognito_mode_default': INCOGNITO_MODE_DEFAULT,
+            'enable_folders': SystemSetting.get_setting('enable_folders', False) == True,
+            'enable_auto_export': ENABLE_AUTO_EXPORT,
+            'video_retention': VIDEO_RETENTION,
+            'max_concurrent_uploads': MAX_CONCURRENT_UPLOADS,
+            'user_transcription_language': user_transcription_language,
+            'user_summary_prompt': user_summary_prompt,
+            'admin_default_summary_prompt': admin_default_summary_prompt,
+            'transcription_model_options': _get_transcription_model_options(),
+            **chunking_info
+        })
+    except Exception as e:
+        current_app.logger.error(f"Error fetching configuration: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
+
+@system_bp.route('/api/csrf-token', methods=['GET'])
+@csrf_exempt  # Exempt this endpoint from CSRF protection since it's providing tokens
+def get_csrf_token():
+    """Get a fresh CSRF token for the frontend."""
+    try:
+        from flask_wtf.csrf import generate_csrf
+        token = generate_csrf()
+        current_app.logger.info("Fresh CSRF token generated successfully")
+        return jsonify({'csrf_token': token})
+    except Exception as e:
+        current_app.logger.error(f"Error generating CSRF token: {e}")
+        return jsonify({'error': str(e)}), 500
+
+# --- Flask Routes ---
+
+
+@system_bp.route('/api/permissions/can-delete', methods=['GET'])
+@login_required
+def check_deletion_permission():
+    """Check if the current user can delete recordings."""
+    try:
+        can_delete = USERS_CAN_DELETE or current_user.is_admin
+        return jsonify({
+            'can_delete': can_delete,
+            'is_admin': current_user.is_admin,
+            'users_can_delete_enabled': USERS_CAN_DELETE
+        })
+    except Exception as e:
+        current_app.logger.error(f"Error checking deletion permissions: {e}")
+        return jsonify({'error': str(e)}), 500
+
+
+
diff --git a/src/api/tags.py b/src/api/tags.py
new file mode 100644
index 00000000..ddab5a8b
--- /dev/null
+++ b/src/api/tags.py
@@ -0,0 +1,560 @@
+"""
+Tag management and assignment.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import time
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+import re
+from pathlib import Path
+
+from sqlalchemy.exc import IntegrityError
+
+from src.database import db
+from src.models import *
+from src.utils import *
+
+# Create blueprint
+tags_bp = Blueprint('tags', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+ENABLE_AUTO_PROCESSING = os.environ.get('ENABLE_AUTO_PROCESSING', 'false').lower() == 'true'
+
+
+def _sanitize_folder_name(name):
+    """Convert a tag name to a filesystem-safe folder name."""
+    # Lowercase and replace spaces/underscores with hyphens
+    folder = name.lower().strip()
+    folder = re.sub(r'[\s_]+', '-', folder)
+    # Remove anything that isn't alphanumeric, hyphen, or dot
+    folder = re.sub(r'[^a-z0-9\-.]', '', folder)
+    # Collapse multiple hyphens
+    folder = re.sub(r'-{2,}', '-', folder)
+    # Strip leading/trailing hyphens
+    folder = folder.strip('-')
+    return folder or 'tag'
+
+
+def _get_auto_process_base_dir(user):
+    """Return the base auto-process directory for a user based on AUTO_PROCESS_MODE."""
+    watch_dir = os.environ.get('AUTO_PROCESS_WATCH_DIR', '/data/auto-process')
+    mode = os.environ.get('AUTO_PROCESS_MODE', 'admin_only')
+
+    if mode == 'user_directories':
+        return Path(watch_dir) / f'user{user.id}'
+    else:
+        # admin_only and single_user both use the base directory
+        return Path(watch_dir)
+
+
+def _ensure_auto_process_folder(tag, user):
+    """Create the auto-process watch folder for a tag. Returns (success, path_or_error)."""
+    if not tag.auto_process_folder_name:
+        return False, 'No folder name set'
+
+    base_dir = _get_auto_process_base_dir(user)
+    folder_path = base_dir / tag.auto_process_folder_name
+
+    try:
+        folder_path.mkdir(parents=True, exist_ok=True)
+        return True, str(folder_path)
+    except OSError as e:
+        return False, str(e)
+
+
+def _remove_auto_process_folder(tag, user):
+    """Remove the auto-process watch folder if it's empty. Returns (removed, message)."""
+    if not tag.auto_process_folder_name:
+        return False, 'No folder name set'
+
+    base_dir = _get_auto_process_base_dir(user)
+    folder_path = base_dir / tag.auto_process_folder_name
+
+    if not folder_path.exists():
+        return True, 'Folder does not exist'
+
+    try:
+        # Only remove if empty
+        if not any(folder_path.iterdir()):
+            folder_path.rmdir()
+            return True, 'Folder removed'
+        else:
+            return False, 'Folder not empty, leaving in place'
+    except OSError as e:
+        return False, str(e)
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_tags_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@tags_bp.route('/api/tags', methods=['GET'])
+@login_required
+def get_tags():
+    """Get all tags for the current user, including group tags they have access to."""
+    # Get user's personal tags
+    user_tags = Tag.query.filter_by(user_id=current_user.id, group_id=None).order_by(Tag.name).all()
+
+    # Get user's team memberships with roles
+    memberships = GroupMembership.query.filter_by(user_id=current_user.id).all()
+    team_roles = {m.group_id: m.role for m in memberships}
+    team_ids = list(team_roles.keys())
+
+    # Get group tags for all teams the user is a member of
+    team_tags = []
+    if team_ids:
+        team_tags = Tag.query.filter(Tag.group_id.in_(team_ids)).order_by(Tag.name).all()
+
+    # Build response with edit permissions
+    result = []
+
+    # Personal tags - user can always edit their own
+    for tag in user_tags:
+        tag_dict = tag.to_dict()
+        tag_dict['can_edit'] = True
+        tag_dict['user_role'] = None
+        result.append(tag_dict)
+
+    # Group tags - only admins can edit
+    for tag in team_tags:
+        tag_dict = tag.to_dict()
+        user_role = team_roles.get(tag.group_id, 'member')
+        tag_dict['can_edit'] = (user_role == 'admin')
+        tag_dict['user_role'] = user_role
+        result.append(tag_dict)
+
+    return jsonify(result)
+
+
+
+@tags_bp.route('/api/tags', methods=['POST'])
+@login_required
+def create_tag():
+    """Create a new tag (personal or group tag)."""
+    data = request.get_json()
+
+    if not data or not data.get('name'):
+        return jsonify({'error': 'Tag name is required'}), 400
+
+    group_id = data.get('group_id')
+
+    # If creating a group tag, verify user is admin of that group
+    if group_id:
+        membership = GroupMembership.query.filter_by(
+            group_id=group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can create group tags'}), 403
+
+        # Check if group tag with same name already exists for this group
+        existing_tag = Tag.query.filter_by(name=data['name'], group_id=group_id).first()
+        if existing_tag:
+            return jsonify({'error': 'A tag with this name already exists for this group'}), 400
+    else:
+        # Check if personal tag with same name already exists for this user
+        existing_tag = Tag.query.filter_by(name=data['name'], user_id=current_user.id, group_id=None).first()
+        if existing_tag:
+            return jsonify({'error': 'Tag with this name already exists'}), 400
+
+    # Handle retention_days: -1 means protected from deletion
+    retention_days = data.get('retention_days')
+    protect_from_deletion = False
+
+    if retention_days == -1:
+        # -1 indicates infinite retention (protected from auto-deletion)
+        protect_from_deletion = True if ENABLE_AUTO_DELETION else False
+
+    # Validate naming_template_id if provided
+    naming_template_id = data.get('naming_template_id')
+    if naming_template_id:
+        from src.models import NamingTemplate
+        template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Naming template not found'}), 404
+
+    # Validate export_template_id if provided
+    export_template_id = data.get('export_template_id')
+    if export_template_id:
+        from src.models import ExportTemplate
+        template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Export template not found'}), 404
+
+    # Handle auto-process
+    is_auto_process = data.get('is_auto_process', False)
+    auto_process_folder_name = None
+    if is_auto_process:
+        if not ENABLE_AUTO_PROCESSING:
+            return jsonify({'error': 'Auto-processing is not enabled'}), 400
+        if group_id:
+            return jsonify({'error': 'Watch folders are not available for group tags'}), 400
+        auto_process_folder_name = _sanitize_folder_name(data['name'])
+
+    tag = Tag(
+        name=data['name'],
+        user_id=current_user.id,
+        group_id=group_id,
+        color=data.get('color', '#3B82F6'),
+        custom_prompt=data.get('custom_prompt'),
+        default_language=data.get('default_language'),
+        default_min_speakers=data.get('default_min_speakers'),
+        default_max_speakers=data.get('default_max_speakers'),
+        default_hotwords=data.get('default_hotwords'),
+        default_initial_prompt=data.get('default_initial_prompt'),
+        default_transcription_model=data.get('default_transcription_model'),
+        protect_from_deletion=protect_from_deletion,
+        retention_days=retention_days,
+        auto_share_on_apply=data.get('auto_share_on_apply', True) if group_id else True,
+        share_with_group_lead=data.get('share_with_group_lead', True) if group_id else True,
+        naming_template_id=naming_template_id,
+        export_template_id=export_template_id,
+        is_auto_process=is_auto_process,
+        auto_process_folder_name=auto_process_folder_name
+    )
+
+    db.session.add(tag)
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Tag creation failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A tag with this name already exists'}), 400
+
+    response = tag.to_dict()
+
+    # Create the watch folder after commit
+    if is_auto_process:
+        success, path_or_error = _ensure_auto_process_folder(tag, current_user)
+        if success:
+            response['auto_process_folder_path'] = path_or_error
+            current_app.logger.info(f"Created auto-process folder for tag '{tag.name}': {path_or_error}")
+        else:
+            response['auto_process_folder_warning'] = f'Could not create watch folder: {path_or_error}'
+            current_app.logger.warning(f"Failed to create auto-process folder for tag '{tag.name}': {path_or_error}")
+
+    return jsonify(response), 201
+
+
+
+@tags_bp.route('/api/tags/<int:tag_id>', methods=['PUT'])
+@login_required
+def update_tag(tag_id):
+    """Update a tag."""
+    tag = db.session.get(Tag, tag_id)
+    if not tag:
+        return jsonify({'error': 'Tag not found'}), 404
+
+    # Check permissions
+    if tag.group_id:
+        # Group tag - user must be a team admin
+        membership = GroupMembership.query.filter_by(
+            group_id=tag.group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can edit group tags'}), 403
+    else:
+        # Personal tag - must be the owner
+        if tag.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to edit this tag'}), 403
+
+    data = request.get_json()
+
+    if 'name' in data:
+        # Check if new name conflicts with another tag
+        if tag.group_id:
+            existing_tag = Tag.query.filter_by(name=data['name'], group_id=tag.group_id).filter(Tag.id != tag_id).first()
+        else:
+            existing_tag = Tag.query.filter_by(name=data['name'], user_id=current_user.id).filter(Tag.id != tag_id).first()
+
+        if existing_tag:
+            return jsonify({'error': 'Another tag with this name already exists'}), 400
+        tag.name = data['name']
+
+    # Handle group_id changes (converting between personal and group tags)
+    if 'group_id' in data:
+        new_group_id = data['group_id'] if data['group_id'] else None
+
+        # If changing to a group tag, verify user is admin of that group
+        if new_group_id:
+            membership = GroupMembership.query.filter_by(
+                group_id=new_group_id,
+                user_id=current_user.id
+            ).first()
+
+            if not membership or membership.role != 'admin':
+                return jsonify({'error': 'Only group admins can assign tags to groups'}), 403
+
+        tag.group_id = new_group_id
+
+    if 'color' in data:
+        tag.color = data['color']
+    if 'custom_prompt' in data:
+        tag.custom_prompt = data['custom_prompt']
+    if 'default_language' in data:
+        tag.default_language = data['default_language']
+    if 'default_min_speakers' in data:
+        tag.default_min_speakers = data['default_min_speakers']
+    if 'default_max_speakers' in data:
+        tag.default_max_speakers = data['default_max_speakers']
+    if 'default_hotwords' in data:
+        tag.default_hotwords = data['default_hotwords'] or None
+    if 'default_initial_prompt' in data:
+        tag.default_initial_prompt = data['default_initial_prompt'] or None
+    if 'default_transcription_model' in data:
+        tag.default_transcription_model = data['default_transcription_model'] or None
+
+    # Handle retention_days: -1 means protected from deletion
+    if 'retention_days' in data:
+        retention_days = data['retention_days']
+
+        if retention_days == -1:
+            # -1 indicates infinite retention (protected from auto-deletion)
+            if ENABLE_AUTO_DELETION:
+                tag.protect_from_deletion = True
+                tag.retention_days = -1
+        else:
+            # Regular retention period or null (use global)
+            tag.protect_from_deletion = False
+            tag.retention_days = retention_days if retention_days else None
+    if 'auto_share_on_apply' in data:
+        # Only applicable to group tags
+        if tag.group_id:
+            tag.auto_share_on_apply = bool(data['auto_share_on_apply'])
+    if 'share_with_group_lead' in data:
+        # Only applicable to group tags
+        if tag.group_id:
+            tag.share_with_group_lead = bool(data['share_with_group_lead'])
+    if 'naming_template_id' in data:
+        naming_template_id = data['naming_template_id']
+        if naming_template_id:
+            from src.models import NamingTemplate
+            template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+            if not template:
+                return jsonify({'error': 'Naming template not found'}), 404
+        tag.naming_template_id = naming_template_id if naming_template_id else None
+    if 'export_template_id' in data:
+        export_template_id = data['export_template_id']
+        if export_template_id:
+            from src.models import ExportTemplate
+            template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+            if not template:
+                return jsonify({'error': 'Export template not found'}), 404
+        tag.export_template_id = export_template_id if export_template_id else None
+
+    # Handle auto-process toggle
+    if 'is_auto_process' in data:
+        new_value = bool(data['is_auto_process'])
+        if new_value and not tag.is_auto_process:
+            # Enabling auto-process
+            if not ENABLE_AUTO_PROCESSING:
+                return jsonify({'error': 'Auto-processing is not enabled'}), 400
+            if tag.group_id:
+                return jsonify({'error': 'Watch folders are not available for group tags'}), 400
+            if not tag.auto_process_folder_name:
+                tag.auto_process_folder_name = _sanitize_folder_name(tag.name)
+            tag.is_auto_process = True
+        elif not new_value and tag.is_auto_process:
+            # Disabling auto-process
+            tag.is_auto_process = False
+
+    tag.updated_at = datetime.utcnow()
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Tag update failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A tag with this name already exists'}), 400
+
+    response = tag.to_dict()
+
+    # Create or remove folder after commit
+    if 'is_auto_process' in data:
+        if tag.is_auto_process:
+            success, path_or_error = _ensure_auto_process_folder(tag, current_user)
+            if success:
+                response['auto_process_folder_path'] = path_or_error
+            else:
+                response['auto_process_folder_warning'] = f'Could not create watch folder: {path_or_error}'
+        else:
+            _remove_auto_process_folder(tag, current_user)
+
+    return jsonify(response)
+
+
+
+@tags_bp.route('/api/tags/<int:tag_id>', methods=['DELETE'])
+@login_required
+def delete_tag(tag_id):
+    """Delete a tag."""
+    tag = db.session.get(Tag, tag_id)
+    if not tag:
+        return jsonify({'error': 'Tag not found'}), 404
+
+    # Check permissions
+    if tag.group_id:
+        # Group tag - user must be a team admin
+        membership = GroupMembership.query.filter_by(
+            group_id=tag.group_id,
+            user_id=current_user.id
+        ).first()
+
+        if not membership or membership.role != 'admin':
+            return jsonify({'error': 'Only group admins can delete group tags'}), 403
+    else:
+        # Personal tag - must belong to the user
+        if tag.user_id != current_user.id:
+            return jsonify({'error': 'You do not have permission to delete this tag'}), 403
+
+    # Clean up auto-process folder if enabled
+    if tag.is_auto_process:
+        user = db.session.get(User, tag.user_id)
+        if user:
+            _remove_auto_process_folder(tag, user)
+
+    db.session.delete(tag)
+    db.session.commit()
+    return jsonify({'success': True})
+
+
+
+@tags_bp.route('/api/groups/<int:group_id>/tags', methods=['POST'])
+@login_required
+def create_group_tag(group_id):
+    """Create a group-scoped tag (group admins only)."""
+    if not ENABLE_INTERNAL_SHARING:
+        return jsonify({'error': 'Group tags require internal sharing to be enabled. Please set ENABLE_INTERNAL_SHARING=true in your configuration.'}), 403
+
+    # Verify team exists
+    team = db.session.get(Group, group_id)
+    if not team:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Verify user is a team admin
+    membership = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id
+    ).first()
+
+    if not membership or membership.role != 'admin':
+        return jsonify({'error': 'Only group admins can create group tags'}), 403
+
+    data = request.get_json()
+    name = data.get('name', '').strip()
+
+    if not name:
+        return jsonify({'error': 'Tag name is required'}), 400
+
+    # Check if a group tag with this name already exists for this team
+    existing_tag = Tag.query.filter_by(
+        name=name,
+        group_id=group_id
+    ).first()
+
+    if existing_tag:
+        return jsonify({'error': 'A group tag with this name already exists'}), 400
+
+    # Validate naming_template_id if provided
+    naming_template_id = data.get('naming_template_id')
+    if naming_template_id:
+        from src.models import NamingTemplate
+        template = NamingTemplate.query.filter_by(id=naming_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Naming template not found'}), 404
+
+    # Validate export_template_id if provided
+    export_template_id = data.get('export_template_id')
+    if export_template_id:
+        from src.models import ExportTemplate
+        template = ExportTemplate.query.filter_by(id=export_template_id, user_id=current_user.id).first()
+        if not template:
+            return jsonify({'error': 'Export template not found'}), 404
+
+    # Create the group tag with all supported parameters
+    tag = Tag(
+        name=name,
+        user_id=current_user.id,  # Creator
+        group_id=group_id,
+        color=data.get('color', '#3B82F6'),
+        custom_prompt=data.get('custom_prompt'),
+        default_language=data.get('default_language'),
+        default_min_speakers=data.get('default_min_speakers'),
+        default_max_speakers=data.get('default_max_speakers'),
+        default_hotwords=data.get('default_hotwords'),
+        default_initial_prompt=data.get('default_initial_prompt'),
+        default_transcription_model=data.get('default_transcription_model'),
+        protect_from_deletion=data.get('protect_from_deletion', False),
+        retention_days=data.get('retention_days'),
+        auto_share_on_apply=data.get('auto_share_on_apply', True),  # Default to True for group tags
+        share_with_group_lead=data.get('share_with_group_lead', True),  # Default to True for group tags
+        naming_template_id=naming_template_id,
+        export_template_id=export_template_id
+    )
+
+    db.session.add(tag)
+
+    try:
+        db.session.commit()
+    except IntegrityError as e:
+        db.session.rollback()
+        current_app.logger.error(f"Tag creation failed due to integrity constraint: {str(e)}")
+        return jsonify({'error': 'A tag with this name already exists'}), 400
+
+    return jsonify(tag.to_dict()), 201
+
+
+
+@tags_bp.route('/api/groups/<int:group_id>/tags', methods=['GET'])
+@login_required
+def get_group_tags(group_id):
+    """Get all tags for a team (team members only)."""
+    # Verify team exists
+    team = db.session.get(Group, group_id)
+    if not team:
+        return jsonify({'error': 'Group not found'}), 404
+
+    # Verify user is a team member
+    membership = GroupMembership.query.filter_by(
+        group_id=group_id,
+        user_id=current_user.id
+    ).first()
+
+    if not membership:
+        return jsonify({'error': 'You must be a team member to view group tags'}), 403
+
+    # Get all group tags
+    tags = Tag.query.filter_by(group_id=group_id).all()
+
+    return jsonify({'tags': [tag.to_dict() for tag in tags]})
+
+
+
diff --git a/src/api/templates.py b/src/api/templates.py
new file mode 100644
index 00000000..2f4724ce
--- /dev/null
+++ b/src/api/templates.py
@@ -0,0 +1,232 @@
+"""
+Transcript template management.
+
+This blueprint was auto-generated from app.py route extraction.
+"""
+
+import os
+import json
+import time
+from datetime import datetime, timedelta
+from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, send_file, Response, current_app
+from flask_login import login_required, current_user
+from werkzeug.utils import secure_filename
+
+from src.database import db
+from src.models import *
+from src.utils import *
+
+# Create blueprint
+templates_bp = Blueprint('templates', __name__)
+
+# Configuration from environment
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+
+# Global helpers (will be injected from app)
+has_recording_access = None
+bcrypt = None
+csrf = None
+limiter = None
+
+def init_templates_helpers(**kwargs):
+    """Initialize helper functions and extensions from app."""
+    global has_recording_access, bcrypt, csrf, limiter
+    has_recording_access = kwargs.get('has_recording_access')
+    bcrypt = kwargs.get('bcrypt')
+    csrf = kwargs.get('csrf')
+    limiter = kwargs.get('limiter')
+
+
+# --- Routes ---
+
+@templates_bp.route('/api/transcript-templates', methods=['GET'])
+@login_required
+def get_transcript_templates():
+    """Get all transcript templates for the current user."""
+    templates = TranscriptTemplate.query.filter_by(user_id=current_user.id).all()
+    return jsonify([template.to_dict() for template in templates])
+
+
+
+@templates_bp.route('/api/transcript-templates', methods=['POST'])
+@login_required
+def create_transcript_template():
+    """Create a new transcript template."""
+    data = request.json
+    if not data or not data.get('name') or not data.get('template'):
+        return jsonify({'error': 'Name and template are required'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        TranscriptTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template = TranscriptTemplate(
+        user_id=current_user.id,
+        name=data['name'],
+        template=data['template'],
+        description=data.get('description'),
+        is_default=data.get('is_default', False)
+    )
+
+    db.session.add(template)
+    db.session.commit()
+
+    return jsonify(template.to_dict()), 201
+
+
+
+@templates_bp.route('/api/transcript-templates/<int:template_id>', methods=['PUT'])
+@login_required
+def update_transcript_template(template_id):
+    """Update an existing transcript template."""
+    template = TranscriptTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    data = request.json
+    if not data:
+        return jsonify({'error': 'No data provided'}), 400
+
+    # If this is set as default, unset other defaults
+    if data.get('is_default'):
+        TranscriptTemplate.query.filter_by(
+            user_id=current_user.id,
+            is_default=True
+        ).update({'is_default': False})
+
+    template.name = data.get('name', template.name)
+    template.template = data.get('template', template.template)
+    template.description = data.get('description', template.description)
+    template.is_default = data.get('is_default', template.is_default)
+    template.updated_at = datetime.utcnow()
+
+    db.session.commit()
+
+    return jsonify(template.to_dict())
+
+
+
+@templates_bp.route('/api/transcript-templates/<int:template_id>', methods=['DELETE'])
+@login_required
+def delete_transcript_template(template_id):
+    """Delete a transcript template."""
+    template = TranscriptTemplate.query.filter_by(
+        id=template_id,
+        user_id=current_user.id
+    ).first()
+
+    if not template:
+        return jsonify({'error': 'Template not found'}), 404
+
+    db.session.delete(template)
+    db.session.commit()
+
+    return jsonify({'success': True})
+
+
+
+@templates_bp.route('/api/transcript-templates/create-defaults', methods=['POST'])
+@login_required
+def create_default_templates():
+    """Create default templates for the user if they don't have any."""
+    existing_templates = TranscriptTemplate.query.filter_by(user_id=current_user.id).count()
+
+    if existing_templates > 0:
+        return jsonify({'message': 'User already has templates'}), 200
+
+    templates = []
+
+    # Default template 1: Simple conversation
+    template1 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Simple Conversation",
+        template="{{speaker}}: {{text}}",
+        description="Clean format with just speaker names and text",
+        is_default=True
+    )
+    templates.append(template1)
+
+    # Default template 2: Timestamped format
+    template2 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Timestamped",
+        template="[{{start_time}} - {{end_time}}] {{speaker}}: {{text}}",
+        description="Format with timestamps and speaker names",
+        is_default=False
+    )
+    templates.append(template2)
+
+    # Default template 3: Interview Q&A
+    template3 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Interview Q&A",
+        template="{{speaker|upper}}:\n{{text}}\n",
+        description="Interview format with speaker names in uppercase",
+        is_default=False
+    )
+    templates.append(template3)
+
+    # Default template 4: Meeting Minutes
+    template4 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Meeting Minutes",
+        template="• [{{start_time}}] {{speaker}}: {{text}}",
+        description="Bulleted format ideal for meeting notes",
+        is_default=False
+    )
+    templates.append(template4)
+
+    # Default template 5: Court Transcript
+    template5 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Court Transcript",
+        template="{{index}}    {{speaker|upper}}: {{text}}",
+        description="Legal deposition format with line numbers",
+        is_default=False
+    )
+    templates.append(template5)
+
+    # Default template 6: SRT Subtitle
+    template6 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="SRT Subtitle",
+        template="{{index}}\n{{start_time|srt}} --> {{end_time|srt}}\n{{text}}\n",
+        description="SRT subtitle format for video editing",
+        is_default=False
+    )
+    templates.append(template6)
+
+    # Default template 7: Screenplay
+    template7 = TranscriptTemplate(
+        user_id=current_user.id,
+        name="Screenplay",
+        template="                    {{speaker|upper}}\n        {{text}}\n",
+        description="Film script format with centered names",
+        is_default=False
+    )
+    templates.append(template7)
+
+    # Add all templates to database
+    for template in templates:
+        db.session.add(template)
+
+    db.session.commit()
+
+    return jsonify({
+        'success': True,
+        'templates': [template.to_dict() for template in templates]
+    }), 201
+
+
+
diff --git a/src/api/tokens.py b/src/api/tokens.py
new file mode 100644
index 00000000..1c19339b
--- /dev/null
+++ b/src/api/tokens.py
@@ -0,0 +1,187 @@
+"""
+API Token management routes.
+
+This blueprint handles creating, listing, and revoking API tokens
+for user authentication.
+"""
+
+import secrets
+from datetime import datetime, timedelta
+from flask import Blueprint, request, jsonify
+from flask_login import login_required, current_user
+
+from src.database import db
+from src.models import APIToken
+from src.utils.token_auth import hash_token
+
+# Create blueprint
+tokens_bp = Blueprint('tokens', __name__, url_prefix='/api/tokens')
+
+# Extensions (injected after app initialization)
+bcrypt = None
+csrf = None
+limiter = None
+
+
+def init_tokens_helpers(_bcrypt, _csrf, _limiter):
+    """Initialize extensions after app creation."""
+    global bcrypt, csrf, limiter
+    bcrypt = _bcrypt
+    csrf = _csrf
+    limiter = _limiter
+
+
+def rate_limit(limit_string):
+    """Decorator that applies rate limiting if limiter is available."""
+    def decorator(f):
+        from functools import wraps
+        @wraps(f)
+        def wrapper(*args, **kwargs):
+            return f(*args, **kwargs)
+        wrapper._rate_limit = limit_string
+        return wrapper
+    return decorator
+
+
+def generate_token():
+    """
+    Generate a secure random API token.
+
+    Returns:
+        str: A cryptographically secure random token
+    """
+    return secrets.token_urlsafe(32)
+
+
+@tokens_bp.route('', methods=['GET'])
+@login_required
+def list_tokens():
+    """
+    List all API tokens for the current user.
+
+    Returns:
+        JSON: List of token objects (without the actual token values)
+    """
+    tokens = APIToken.query.filter_by(user_id=current_user.id).all()
+    return jsonify({
+        'tokens': [token.to_dict() for token in tokens]
+    })
+
+
+@tokens_bp.route('', methods=['POST'])
+@login_required
+@rate_limit("10 per hour")
+def create_token():
+    """
+    Create a new API token for the current user.
+
+    Request JSON:
+        name (str, optional): A friendly name for the token
+        expires_in_days (int, optional): Number of days until expiration (0 = no expiration)
+
+    Returns:
+        JSON: The new token object including the plaintext token (shown only once)
+    """
+    data = request.get_json()
+
+    # Validate input
+    name = data.get('name', 'Unnamed Token')
+    expires_in_days = data.get('expires_in_days', 0)
+
+    # Validate expiration
+    if not isinstance(expires_in_days, int) or expires_in_days < 0:
+        return jsonify({'error': 'expires_in_days must be a non-negative integer'}), 400
+
+    # Generate the token
+    plaintext_token = generate_token()
+    token_hash = hash_token(plaintext_token)
+
+    # Calculate expiration date
+    expires_at = None
+    if expires_in_days > 0:
+        expires_at = datetime.utcnow() + timedelta(days=expires_in_days)
+
+    # Create the token record
+    api_token = APIToken(
+        user_id=current_user.id,
+        token_hash=token_hash,
+        name=name,
+        expires_at=expires_at
+    )
+
+    db.session.add(api_token)
+    db.session.commit()
+
+    # Return the token data INCLUDING the plaintext token
+    # This is the only time the plaintext token will be shown
+    response = api_token.to_dict()
+    response['token'] = plaintext_token
+
+    return jsonify(response), 201
+
+
+@tokens_bp.route('/<int:token_id>', methods=['DELETE'])
+@login_required
+@rate_limit("20 per hour")
+def revoke_token(token_id):
+    """
+    Revoke (delete) an API token.
+
+    Args:
+        token_id (int): The ID of the token to revoke
+
+    Returns:
+        JSON: Success message
+    """
+    # Find the token
+    api_token = APIToken.query.filter_by(
+        id=token_id,
+        user_id=current_user.id
+    ).first()
+
+    if not api_token:
+        return jsonify({'error': 'Token not found'}), 404
+
+    # Delete the token
+    db.session.delete(api_token)
+    db.session.commit()
+
+    return jsonify({'message': 'Token revoked successfully'}), 200
+
+
+@tokens_bp.route('/<int:token_id>', methods=['PATCH'])
+@login_required
+@rate_limit("20 per hour")
+def update_token(token_id):
+    """
+    Update an API token's metadata (name only).
+
+    Args:
+        token_id (int): The ID of the token to update
+
+    Request JSON:
+        name (str): The new name for the token
+
+    Returns:
+        JSON: Updated token object
+    """
+    # Find the token
+    api_token = APIToken.query.filter_by(
+        id=token_id,
+        user_id=current_user.id
+    ).first()
+
+    if not api_token:
+        return jsonify({'error': 'Token not found'}), 404
+
+    # Update the name
+    data = request.get_json()
+    new_name = data.get('name')
+
+    if not new_name:
+        return jsonify({'error': 'name is required'}), 400
+
+    api_token.name = new_name
+    db.session.commit()
+
+    return jsonify(api_token.to_dict()), 200
diff --git a/src/app.py b/src/app.py
new file mode 100644
index 00000000..a5b22aff
--- /dev/null
+++ b/src/app.py
@@ -0,0 +1,658 @@
+# Speakr - Audio Transcription and Summarization App
+import os
+import sys
+from flask import Flask, render_template, request, jsonify, send_file, redirect, url_for, flash, Response, make_response
+from urllib.parse import urlparse, urljoin, quote
+from email.utils import encode_rfc2231
+from markupsafe import Markup
+from flask_sqlalchemy import SQLAlchemy
+from datetime import datetime, timedelta
+from openai import OpenAI # Keep using the OpenAI library
+import json
+from werkzeug.utils import secure_filename
+from werkzeug.exceptions import RequestEntityTooLarge
+from werkzeug.middleware.proxy_fix import ProxyFix
+from sqlalchemy import select
+from sqlalchemy.orm import joinedload
+import threading
+from dotenv import load_dotenv # Import load_dotenv
+import httpx 
+import re
+import subprocess
+import mimetypes
+import markdown
+import bleach
+
+# Add common audio MIME type mappings that might be missing
+mimetypes.add_type('audio/mp4', '.m4a')
+mimetypes.add_type('audio/aac', '.aac')
+mimetypes.add_type('audio/x-m4a', '.m4a')
+mimetypes.add_type('audio/webm', '.webm')
+mimetypes.add_type('audio/flac', '.flac')
+mimetypes.add_type('audio/ogg', '.ogg')
+from flask_login import LoginManager, UserMixin, login_user, logout_user, login_required, current_user
+from flask_bcrypt import Bcrypt
+from flask_wtf import FlaskForm
+from flask_wtf.csrf import CSRFProtect
+from wtforms import StringField, PasswordField, SubmitField, BooleanField
+from wtforms.validators import DataRequired, Length, Email, EqualTo, ValidationError
+from flask_limiter import Limiter
+from flask_limiter.util import get_remote_address
+import pytz
+from babel.dates import format_datetime
+import ast
+import logging
+import secrets
+import time
+from src.audio_chunking import AudioChunkingService, ChunkProcessingError, ChunkingNotSupportedError
+
+# Optional imports for embedding functionality
+try:
+    import numpy as np
+    from sentence_transformers import SentenceTransformer
+    from sklearn.metrics.pairwise import cosine_similarity
+    EMBEDDINGS_AVAILABLE = True
+except ImportError as e:
+    EMBEDDINGS_AVAILABLE = False
+    # Create dummy classes to prevent import errors
+    class SentenceTransformer:
+        def __init__(self, *args, **kwargs):
+            pass
+        def encode(self, *args, **kwargs):
+            return []
+    
+    np = None
+    cosine_similarity = None
+
+# Load environment variables from .env file
+load_dotenv()
+
+# Early check for Inquire Mode configuration (needed for startup message)
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+
+# Auto-deletion and retention configuration
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+GLOBAL_RETENTION_DAYS = int(os.environ.get('GLOBAL_RETENTION_DAYS', '0'))  # 0 = disabled
+DELETION_MODE = os.environ.get('DELETION_MODE', 'full_recording')  # 'audio_only' or 'full_recording'
+
+# Permission-based deletion control
+USERS_CAN_DELETE = os.environ.get('USERS_CAN_DELETE', 'true').lower() == 'true'  # true = all users can delete, false = admin only
+
+# Internal sharing configuration
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+SHOW_USERNAMES_IN_UI = os.environ.get('SHOW_USERNAMES_IN_UI', 'false').lower() == 'true'
+
+# Public sharing configuration
+ENABLE_PUBLIC_SHARING = os.environ.get('ENABLE_PUBLIC_SHARING', 'true').lower() == 'true'
+
+# Video retention - when enabled, video files keep their video stream for playback
+VIDEO_RETENTION = os.environ.get('VIDEO_RETENTION', 'false').lower() == 'true'
+
+# Log embedding status on startup. Two paths can power Inquire mode: a local
+# sentence-transformers model (full image) or an OpenAI-compatible HTTP
+# provider (works in the lite image too, as long as scikit-learn is present
+# for cosine similarity, which it is in both images).
+_inquire_uses_api = bool(os.environ.get('EMBEDDING_BASE_URL', '').strip())
+try:
+    from sklearn.metrics.pairwise import cosine_similarity as _has_sklearn  # noqa: F401
+    _SKLEARN_AVAILABLE = True
+except ImportError:
+    _SKLEARN_AVAILABLE = False
+
+if ENABLE_INQUIRE_MODE and EMBEDDINGS_AVAILABLE:
+    print("✅ Inquire Mode: Full semantic search enabled (local embedding model)")
+elif ENABLE_INQUIRE_MODE and _inquire_uses_api and _SKLEARN_AVAILABLE:
+    print("✅ Inquire Mode: Full semantic search enabled (API embedding provider)")
+elif ENABLE_INQUIRE_MODE and _inquire_uses_api and not _SKLEARN_AVAILABLE:
+    print("⚠️  Inquire Mode: Basic text search only (scikit-learn missing, cannot rank API embeddings)")
+elif ENABLE_INQUIRE_MODE and not EMBEDDINGS_AVAILABLE:
+    print("⚠️  Inquire Mode: Basic text search only (embedding dependencies not available)")
+    print("   To enable semantic search, install sentence-transformers locally OR set EMBEDDING_BASE_URL to use an OpenAI-compatible API.")
+elif not ENABLE_INQUIRE_MODE:
+    print("ℹ️  Inquire Mode: Disabled (set ENABLE_INQUIRE_MODE=true to enable)")
+
+# Log auto-deletion status
+if ENABLE_AUTO_DELETION:
+    if GLOBAL_RETENTION_DAYS > 0:
+        print(f"✅ Auto-deletion: Enabled (global retention: {GLOBAL_RETENTION_DAYS} days, mode: {DELETION_MODE})")
+    else:
+        print("⚠️  Auto-deletion: Enabled but no global retention period set (configure GLOBAL_RETENTION_DAYS)")
+else:
+    print("ℹ️  Auto-deletion: Disabled (set ENABLE_AUTO_DELETION=true to enable)")
+
+# Log deletion permissions
+if USERS_CAN_DELETE:
+    print("ℹ️  User deletion: Enabled (all users can delete their recordings)")
+else:
+    print("🔒 User deletion: Restricted (only admins can delete recordings)")
+
+# Log internal sharing status
+if ENABLE_INTERNAL_SHARING:
+    username_visibility = "visible" if SHOW_USERNAMES_IN_UI else "hidden"
+    print(f"✅ Internal sharing: Enabled (usernames {username_visibility})")
+else:
+    print("ℹ️  Internal sharing: Disabled (set ENABLE_INTERNAL_SHARING=true to enable)")
+
+# Log public sharing status
+if ENABLE_PUBLIC_SHARING:
+    print("✅ Public sharing: Enabled (users can create public share links)")
+else:
+    print("🔒 Public sharing: Disabled (public share links are not allowed)")
+
+# Log video retention status
+if VIDEO_RETENTION:
+    print("✅ Video retention: Enabled (video files preserve video stream for playback)")
+else:
+    print("ℹ️  Video retention: Disabled (video uploads extract audio only)")
+
+# Configure logging
+log_level = os.environ.get('LOG_LEVEL', 'INFO').upper()
+handler = logging.StreamHandler(sys.stdout)
+handler.setLevel(log_level)
+formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+handler.setFormatter(formatter)
+
+# Get the root logger and clear any existing handlers to avoid duplicates
+root_logger = logging.getLogger()
+root_logger.handlers.clear()
+root_logger.setLevel(log_level)
+root_logger.addHandler(handler)
+
+# Silence noisy markdown extension debug logs
+markdown_logger = logging.getLogger('MARKDOWN')
+markdown_logger.setLevel(logging.WARNING)
+
+# --- Initialize Markdown Once (Performance Optimization) ---
+# Create a single reusable Markdown instance to avoid reinitializing extensions on every call
+_markdown_instance = markdown.Markdown(extensions=[
+    'fenced_code',      # Fenced code blocks
+    'tables',           # Table support
+    'attr_list',        # Attribute lists
+    'def_list',         # Definition lists
+    'footnotes',        # Footnotes
+    'abbr',             # Abbreviations
+    'codehilite',       # Syntax highlighting for code blocks
+    'smarty'            # Smart quotes, dashes, etc.
+])
+
+# --- Rate Limiting Setup (will be configured after app creation) ---
+# TEMPORARILY INCREASED FOR TESTING - REVERT FOR PRODUCTION!
+limiter = Limiter(
+    get_remote_address,
+    app=None,  # Defer initialization
+    default_limits=["5000 per day", "1000 per hour"]  # Increased from 200/day, 50/hour for testing
+)
+
+# --- Utility Functions ---
+# Utility functions (JSON parsing, markdown, datetime, security) have been extracted
+# to src/utils/ and imported at the top of this file
+
+def has_recording_access(recording, user, require_edit=False, require_reshare=False):
+    """
+    Check if a user has access to a recording.
+
+    Args:
+        recording: Recording object to check access for
+        user: User object (typically current_user)
+        require_edit: If True, check for edit permission (default: False for view-only)
+        require_reshare: If True, check for reshare permission (default: False)
+
+    Returns:
+        Boolean indicating if user has the required access level
+    """
+    # Owner always has full access
+    if recording.user_id == user.id:
+        return True
+
+    # If internal sharing is not enabled, only owner has access
+    if not ENABLE_INTERNAL_SHARING:
+        return False
+
+    # Check for shared access
+    share = InternalShare.query.filter_by(
+        recording_id=recording.id,
+        shared_with_user_id=user.id
+    ).first()
+
+    if not share:
+        return False
+
+    # If edit permission is required, check for it
+    if require_edit:
+        # First check if share directly grants edit permission
+        if share.can_edit:
+            pass  # Has direct edit permission
+        else:
+            # Check if user is a group admin for any group tag on this recording
+            # This grants edit permission even if share.can_edit is False
+            is_group_admin_for_recording = db.session.query(GroupMembership).join(
+                Tag, Tag.group_id == GroupMembership.group_id
+            ).join(
+                RecordingTag, RecordingTag.tag_id == Tag.id
+            ).filter(
+                RecordingTag.recording_id == recording.id,
+                GroupMembership.user_id == user.id,
+                GroupMembership.role == 'admin',
+                Tag.group_id.isnot(None),
+                db.or_(Tag.auto_share_on_apply == True, Tag.share_with_group_lead == True)
+            ).first()
+
+            if not is_group_admin_for_recording:
+                return False
+
+    # If reshare permission is required, check for it
+    if require_reshare and not share.can_reshare:
+        return False
+
+    # User has at least view access
+    return True
+
+
+def get_user_recording_status(recording, user):
+    """
+    Get the inbox and highlighted status for a recording from a user's perspective.
+
+    For owners: Returns status from Recording model
+    For shared recipients: Returns status from SharedRecordingState (creates default if not exists)
+
+    Args:
+        recording: Recording object
+        user: User object (typically current_user)
+
+    Returns:
+        Tuple of (is_inbox, is_highlighted)
+    """
+    # Owner uses the Recording model's global fields
+    if recording.user_id == user.id:
+        return (recording.is_inbox, recording.is_highlighted)
+
+    # Shared recipient uses SharedRecordingState
+    state = SharedRecordingState.query.filter_by(
+        recording_id=recording.id,
+        user_id=user.id
+    ).first()
+
+    if state:
+        return (state.is_inbox, state.is_highlighted)
+    else:
+        # Return defaults if no state exists yet (inbox=True, highlighted=False)
+        return (True, False)
+
+
+def set_user_recording_status(recording, user, is_inbox=None, is_highlighted=None):
+    """
+    Set the inbox and/or highlighted status for a recording from a user's perspective.
+
+    For owners: Updates Recording model
+    For shared recipients: Updates or creates SharedRecordingState
+
+    Args:
+        recording: Recording object
+        user: User object (typically current_user)
+        is_inbox: Boolean or None (None means don't change)
+        is_highlighted: Boolean or None (None means don't change)
+
+    Returns:
+        Tuple of (is_inbox, is_highlighted) after update
+    """
+    # Owner updates the Recording model's global fields
+    if recording.user_id == user.id:
+        if is_inbox is not None:
+            recording.is_inbox = is_inbox
+        if is_highlighted is not None:
+            recording.is_highlighted = is_highlighted
+        db.session.commit()
+        return (recording.is_inbox, recording.is_highlighted)
+
+    # Shared recipient uses SharedRecordingState
+    state = SharedRecordingState.query.filter_by(
+        recording_id=recording.id,
+        user_id=user.id
+    ).first()
+
+    if not state:
+        # Create new state with defaults
+        state = SharedRecordingState(
+            recording_id=recording.id,
+            user_id=user.id,
+            is_inbox=True,
+            is_highlighted=False
+        )
+        db.session.add(state)
+
+    # Update the requested fields
+    if is_inbox is not None:
+        state.is_inbox = is_inbox
+    if is_highlighted is not None:
+        state.is_highlighted = is_highlighted
+
+    db.session.commit()
+    return (state.is_inbox, state.is_highlighted)
+
+
+def enrich_recording_dict_with_user_status(recording_dict, recording, user):
+    """
+    Enrich a recording dictionary with per-user status (inbox, highlighted).
+
+    This should be called after recording.to_dict() or recording.to_list_dict()
+    to replace the owner's status with the current user's per-user status.
+
+    Args:
+        recording_dict: Dictionary from recording.to_dict() or recording.to_list_dict()
+        recording: Recording object
+        user: User object (typically current_user)
+
+    Returns:
+        The enriched recording_dict (modified in place, but also returned for convenience)
+    """
+    user_inbox, user_highlighted = get_user_recording_status(recording, user)
+    recording_dict['is_inbox'] = user_inbox
+    recording_dict['is_highlighted'] = user_highlighted
+    return recording_dict
+
+
+app = Flask(__name__, 
+            template_folder='../templates',
+            static_folder='../static')
+# Use environment variables or default paths for Docker compatibility
+app.config['SQLALCHEMY_DATABASE_URI'] = os.environ.get('SQLALCHEMY_DATABASE_URI', 'sqlite:////data/instance/transcriptions.db')
+app.config['UPLOAD_FOLDER'] = os.environ.get('UPLOAD_FOLDER', '/data/uploads')
+
+# SQLite concurrency settings for multi-worker job queue
+if 'sqlite' in app.config['SQLALCHEMY_DATABASE_URI']:
+    app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
+        'connect_args': {
+            'timeout': 30,  # Wait up to 30 seconds for locked database
+            'check_same_thread': False  # Allow multi-threaded access
+        },
+        'pool_pre_ping': True  # Verify connections before use
+    }
+# MAX_CONTENT_LENGTH will be set dynamically after database initialization
+# Set a secret key for session management and CSRF protection
+app.config['SECRET_KEY'] = os.environ.get('SECRET_KEY', 'default-dev-key-change-in-production')
+
+# Apply ProxyFix to handle headers from a reverse proxy (like Nginx or Caddy)
+# This is crucial for request.is_secure to work correctly behind an SSL-terminating proxy.
+trusted_proxy_hops = int(os.environ.get('TRUSTED_PROXY_HOPS', '1'))
+app.wsgi_app = ProxyFix(
+    app.wsgi_app, 
+    x_for=trusted_proxy_hops, 
+    x_proto=trusted_proxy_hops, 
+    x_host=trusted_proxy_hops, 
+    x_prefix=trusted_proxy_hops
+)
+
+# --- Secure Session Cookie Configuration ---
+# For local network usage, disable secure cookies to allow HTTP connections
+# Only enable secure cookies in production when HTTPS is actually being used
+app.config['SESSION_COOKIE_SECURE'] = False  # Allow HTTP for local network usage
+app.config['SESSION_COOKIE_HTTPONLY'] = True  # Still protect against XSS
+app.config['SESSION_COOKIE_SAMESITE'] = 'Lax'  # CSRF protection
+
+# Import database instance from extracted module
+from src.database import db
+db.init_app(app)
+
+# Import all models from extracted modules
+from src.models import (
+    User, Speaker, Recording, TranscriptChunk, Share, InternalShare,
+    SharedRecordingState, Group, GroupMembership, Tag, RecordingTag,
+    Event, TranscriptTemplate, InquireSession, SystemSetting, PushSubscription,
+    APIToken, NamingTemplate, Folder, SpeakerSnippet, ShareAuditLog,
+    ProcessingJob, TokenUsage, TranscriptionUsage
+)
+
+# Import utility functions from extracted modules
+from src.utils import (
+    auto_close_json, safe_json_loads, preprocess_json_escapes, extract_json_object,
+    md_to_html, sanitize_html, local_datetime_filter, password_check,
+    add_column_if_not_exists, is_safe_url
+)
+
+# Import service layer functions
+from src.services.embeddings import (
+    get_embedding_model, chunk_transcription, generate_embeddings,
+    serialize_embedding, deserialize_embedding, get_accessible_recording_ids,
+    process_recording_chunks, basic_text_search_chunks, semantic_search_chunks
+)
+from src.services.llm import (
+    is_gpt5_model, is_using_openai_api, call_llm_completion, format_api_error_message
+)
+from src.services.document import process_markdown_to_docx
+from src.services.retention import (
+    is_recording_exempt_from_deletion, get_retention_days_for_recording, process_auto_deletion
+)
+from src.services.calendar import generate_ics_content, escape_ical_text
+from src.services.speaker import (
+    update_speaker_usage, identify_speakers_from_text, identify_unidentified_speakers_from_text
+)
+
+# Import background task functions
+from src.tasks.processing import (
+    generate_title_task, generate_summary_only_task, extract_events_from_transcript,
+    extract_audio_from_video, transcribe_audio_task, transcribe_with_connector,
+    transcribe_chunks_with_connector, transcribe_incognito
+)
+
+# Import configuration helpers
+from src.config.version import get_version
+
+# Initialize Flask-Login and other extensions
+login_manager = LoginManager()
+login_manager.init_app(app)
+login_manager.login_view = 'auth.login'
+login_manager.login_message_category = 'info'
+bcrypt = Bcrypt()
+bcrypt.init_app(app)
+limiter.init_app(app)  # Initialize the limiter (uses in-memory storage by default)
+
+# Exempt frequently-polled status endpoints from rate limiting
+@limiter.request_filter
+def exempt_status_endpoints():
+    """Exempt status polling endpoints from rate limiting."""
+    from flask import request
+    # Exempt status endpoints that are polled frequently during processing
+    if '/status' in request.path and request.method == 'GET':
+        return True
+    if request.path.endswith('/batch-status') and request.method == 'POST':
+        return True
+    # Exempt job queue status polling (polled every 5-30 seconds during processing)
+    if request.path == '/api/recordings/job-queue-status' and request.method == 'GET':
+        return True
+    return False
+
+csrf = CSRFProtect(app)
+
+
+# Exempt token-authenticated requests from CSRF protection
+@csrf.exempt
+@app.before_request
+def csrf_exempt_for_api_tokens():
+    """
+    Exempt API token-authenticated requests from CSRF validation.
+
+    This allows automation tools (n8n, Zapier, curl, etc.) to make
+    authenticated requests without needing CSRF tokens.
+    """
+    from src.utils.token_auth import is_token_authenticated
+
+    # If request has a valid token, skip CSRF check
+    if is_token_authenticated():
+        # Mark this view as CSRF exempt
+        if hasattr(request, 'endpoint') and request.endpoint:
+            view_func = app.view_functions.get(request.endpoint)
+            if view_func:
+                csrf.exempt(view_func)
+
+
+# Add context processor to make 'now' available to all templates
+@app.context_processor
+def inject_now():
+    return {'now': datetime.now()}
+
+@app.context_processor
+def inject_group_admin_status():
+    """Inject is_group_admin flag into all templates."""
+    from flask_login import current_user
+    from src.models.organization import GroupMembership
+
+    is_group_admin = False
+    if current_user.is_authenticated:
+        is_group_admin = GroupMembership.query.filter_by(
+            user_id=current_user.id,
+            role='admin'
+        ).first() is not None
+
+    return {'is_group_admin': is_group_admin}
+
+# --- Timezone Formatting Filter ---
+@app.template_filter('localdatetime')
+def local_datetime_filter(dt):
+    """Format a UTC datetime object to the user's local timezone."""
+    if dt is None:
+        return ""
+    
+    # Get timezone from .env, default to UTC
+    user_tz_name = os.environ.get('TIMEZONE', 'UTC')
+    try:
+        user_tz = pytz.timezone(user_tz_name)
+    except pytz.UnknownTimeZoneError:
+        user_tz = pytz.utc
+        app.logger.warning(f"Invalid TIMEZONE '{user_tz_name}' in .env. Defaulting to UTC.")
+
+    # If the datetime object is naive, assume it's UTC
+    if dt.tzinfo is None:
+        dt = pytz.utc.localize(dt)
+
+    # Convert to the user's timezone
+    local_dt = dt.astimezone(user_tz)
+    
+    # Format it nicely
+    return format_datetime(local_dt, format='medium', locale='en_US')
+
+# Ensure upload and instance directories exist
+os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
+
+# Ensure upload and instance directories exist
+os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
+# Assuming the instance folder is handled correctly by Flask or created by setup.sh
+# os.makedirs(os.path.dirname(app.config['SQLALCHEMY_DATABASE_URI'].replace('sqlite:///', '/')), exist_ok=True)
+
+
+# --- User loader for Flask-Login ---
+@login_manager.user_loader
+def load_user(user_id):
+    return db.session.get(User, int(user_id))
+
+
+@login_manager.request_loader
+def load_user_from_request(request):
+    """
+    Load user from API token in the request.
+
+    This enables token-based authentication for API access
+    (e.g., from curl, n8n, Zapier, etc.).
+    """
+    from src.utils.token_auth import load_user_from_token
+    return load_user_from_token()
+
+
+# --- Embedding and Chunking Utilities ---
+
+from src.api.auth import auth_bp, init_auth_extensions
+from src.api.tokens import tokens_bp, init_tokens_helpers
+from src.api.shares import shares_bp, init_shares_helpers
+from src.api.recordings import recordings_bp, init_recordings_helpers
+from src.api.tags import tags_bp, init_tags_helpers
+from src.api.folders import folders_bp, init_folders_helpers
+from src.api.groups import groups_bp, init_groups_helpers
+from src.api.admin import admin_bp, init_admin_helpers
+from src.api.speakers import speakers_bp, init_speakers_helpers
+from src.api.inquire import inquire_bp, init_inquire_helpers
+from src.api.templates import templates_bp, init_templates_helpers
+from src.api.naming_templates import naming_templates_bp
+from src.api.export_templates import export_templates_bp
+from src.api.events import events_bp, init_events_helpers
+from src.api.system import system_bp, init_system_helpers
+from src.api.push_notifications import push_bp
+from src.api.api_v1 import api_v1_bp, init_api_v1_helpers
+
+# Database initialization (extracted to src/init_db.py)
+from src.init_db import initialize_database
+with app.app_context():
+    initialize_database(app)
+
+# Application configuration (extracted to src/config/app_config.py)
+from src.config.app_config import initialize_config
+client, chunking_service, version = initialize_config(app)
+
+# Initialize blueprint helpers (inject extensions and utility functions)
+init_auth_extensions(bcrypt, csrf, limiter)
+init_tokens_helpers(bcrypt, csrf, limiter)
+init_shares_helpers(has_recording_access)
+init_recordings_helpers(has_recording_access=has_recording_access, get_user_recording_status=get_user_recording_status, set_user_recording_status=set_user_recording_status, enrich_recording_dict_with_user_status=enrich_recording_dict_with_user_status, bcrypt=bcrypt, csrf=csrf, limiter=limiter, chunking_service=chunking_service)
+init_tags_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_folders_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_groups_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_admin_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_speakers_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_inquire_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_templates_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_events_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter)
+init_system_helpers(has_recording_access=has_recording_access, bcrypt=bcrypt, csrf=csrf, limiter=limiter, chunking_service=chunking_service)
+init_api_v1_helpers(has_recording_access=has_recording_access, get_user_recording_status=get_user_recording_status, set_user_recording_status=set_user_recording_status, enrich_recording_dict_with_user_status=enrich_recording_dict_with_user_status, bcrypt=bcrypt, csrf=csrf, limiter=limiter, chunking_service=chunking_service)
+
+# Register blueprints
+app.register_blueprint(auth_bp)
+app.register_blueprint(tokens_bp)
+app.register_blueprint(shares_bp)
+app.register_blueprint(recordings_bp)
+app.register_blueprint(tags_bp)
+app.register_blueprint(folders_bp)
+app.register_blueprint(groups_bp)
+app.register_blueprint(admin_bp)
+app.register_blueprint(speakers_bp)
+app.register_blueprint(inquire_bp)
+app.register_blueprint(templates_bp)
+app.register_blueprint(naming_templates_bp)
+app.register_blueprint(export_templates_bp)
+app.register_blueprint(events_bp)
+app.register_blueprint(system_bp)
+app.register_blueprint(push_bp)
+app.register_blueprint(api_v1_bp)
+csrf.exempt(api_v1_bp)  # API v1 uses token auth, not CSRF
+
+# File monitor and scheduler initialization functions below
+
+# Startup functions (extracted to src/config/startup.py)
+from src.config.startup import initialize_file_monitor, get_file_monitor_functions, initialize_auto_deletion_scheduler, run_startup_tasks
+
+# Run startup tasks
+run_startup_tasks(app)
+
+# --- No-Crawl System: HTTP Headers ---
+@app.after_request
+def add_no_crawl_headers(response):
+    """
+    Add HTTP headers to discourage search engine crawling and indexing.
+    This provides defense-in-depth alongside robots.txt and meta tags.
+    """
+    response.headers['X-Robots-Tag'] = 'noindex, nofollow, noarchive, nosnippet, noimageindex'
+    return response
+
+# --- No-Crawl System: Serve robots.txt ---
+@app.route('/robots.txt')
+def robots_txt():
+    """Serve robots.txt to instruct crawlers not to index the site."""
+    return send_file(os.path.join(app.static_folder, 'robots.txt'), mimetype='text/plain')
+
+if __name__ == '__main__':
+    import argparse
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--debug', action='store_true', help='Run in debug mode')
+    args = parser.parse_args()
+
+    # Consider using waitress or gunicorn for production
+    # waitress-serve --host 0.0.0.0 --port 8899 app:app
+    # For development:
+    app.run(host='0.0.0.0', port=8899, debug=args.debug)
diff --git a/src/audio_chunking.py b/src/audio_chunking.py
new file mode 100644
index 00000000..995283ff
--- /dev/null
+++ b/src/audio_chunking.py
@@ -0,0 +1,1203 @@
+"""
+Audio Chunking Service for Large File Processing with OpenAI Whisper API
+
+This module provides functionality to split large audio files into smaller chunks
+that comply with OpenAI's 25MB file size limit, process them individually,
+and reassemble the transcriptions while maintaining accuracy and speaker continuity.
+"""
+
+import os
+import json
+import subprocess
+import tempfile
+import logging
+import math
+import re
+from dataclasses import dataclass
+from typing import List, Dict, Any, Optional, Tuple, TYPE_CHECKING
+from datetime import datetime
+import mimetypes
+
+from src.utils.ffmpeg_utils import convert_to_mp3, FFmpegError, FFmpegNotFoundError
+
+if TYPE_CHECKING:
+    from src.services.transcription.base import ConnectorSpecifications
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class EffectiveChunkingConfig:
+    """Effective chunking configuration after resolving connector specs and ENV settings."""
+    enabled: bool
+    mode: str  # 'size' or 'duration'
+    limit_value: float  # MB for size, seconds for duration
+    overlap_seconds: int
+    source: str  # 'disabled', 'connector_internal', 'env', 'connector_default', 'app_default'
+
+
+def get_effective_chunking_config(
+    connector_specs: Optional['ConnectorSpecifications'] = None
+) -> EffectiveChunkingConfig:
+    """
+    Determine effective chunking configuration based on connector specs and ENV settings.
+
+    Logic:
+    1. Gather connector constraints (max_duration_seconds, max_file_size_bytes)
+    2. Gather user settings (CHUNK_LIMIT, CHUNK_SIZE_MB, ENABLE_CHUNKING)
+    3. If connector has hard limits:
+       - Chunking is REQUIRED (can't disable)
+       - Use MIN(connector_limit, user_limit) - user can go smaller but not larger
+    4. If connector has no hard limits:
+       - If handles_chunking_internally=True → no app chunking
+       - If ENABLE_CHUNKING=false → no chunking
+       - Otherwise use user settings or app defaults
+
+    Args:
+        connector_specs: Optional ConnectorSpecifications from the active connector
+
+    Returns:
+        EffectiveChunkingConfig with resolved settings
+    """
+    overlap_seconds = int(os.environ.get('CHUNK_OVERLAP_SECONDS', '3'))
+    enable_chunking_env = os.environ.get('ENABLE_CHUNKING', '').lower()
+
+    # --- Step 1: Determine connector's hard limits ---
+    connector_duration_limit = None
+    connector_size_limit_mb = None
+
+    if connector_specs:
+        if connector_specs.max_duration_seconds:
+            # Use recommended if available, otherwise 85% of max for safety
+            if connector_specs.recommended_chunk_seconds:
+                connector_duration_limit = connector_specs.recommended_chunk_seconds
+            else:
+                connector_duration_limit = int(connector_specs.max_duration_seconds * 0.85)
+
+        if connector_specs.max_file_size_bytes:
+            # Use 80% of max for safety margin
+            connector_size_limit_mb = (connector_specs.max_file_size_bytes / (1024 * 1024)) * 0.8
+
+    has_hard_limits = connector_duration_limit is not None or connector_size_limit_mb is not None
+
+    # --- Step 2: Parse user settings ---
+    user_duration_limit = None
+    user_size_limit_mb = None
+
+    chunk_limit = os.environ.get('CHUNK_LIMIT', '').strip()
+    chunk_size_mb_env = os.environ.get('CHUNK_SIZE_MB', '').strip()
+
+    if chunk_limit:
+        chunk_limit_upper = chunk_limit.upper()
+        try:
+            if chunk_limit_upper.endswith('MB'):
+                user_size_limit_mb = float(re.sub(r'[^0-9.]', '', chunk_limit_upper))
+            elif chunk_limit_upper.endswith('S'):
+                user_duration_limit = float(re.sub(r'[^0-9.]', '', chunk_limit_upper))
+            elif chunk_limit_upper.endswith('M') and not chunk_limit_upper.endswith('MB'):
+                user_duration_limit = float(re.sub(r'[^0-9.]', '', chunk_limit_upper)) * 60
+        except ValueError:
+            logger.warning(f"Invalid CHUNK_LIMIT format: {chunk_limit}")
+    elif chunk_size_mb_env:
+        try:
+            user_size_limit_mb = float(chunk_size_mb_env)
+        except ValueError:
+            logger.warning(f"Invalid CHUNK_SIZE_MB format: {chunk_size_mb_env}")
+
+    # --- Step 3: If connector has hard limits, chunking is REQUIRED ---
+    if has_hard_limits:
+        # Prefer duration-based if connector has duration limit
+        if connector_duration_limit is not None:
+            # Use minimum of connector limit and user limit (if user set one)
+            if user_duration_limit is not None:
+                effective_limit = min(connector_duration_limit, user_duration_limit)
+                source = 'user_and_connector'
+                logger.info(f"Chunking: Using MIN(connector={connector_duration_limit}s, user={user_duration_limit}s) = {effective_limit}s")
+            else:
+                effective_limit = connector_duration_limit
+                source = 'connector_limit'
+                logger.info(f"Chunking: Connector requires duration limit {effective_limit}s (max_duration={connector_specs.max_duration_seconds}s)")
+
+            return EffectiveChunkingConfig(
+                enabled=True,
+                mode='duration',
+                limit_value=effective_limit,
+                overlap_seconds=overlap_seconds,
+                source=source
+            )
+
+        # Fall back to size-based if only size limit exists
+        elif connector_size_limit_mb is not None:
+            if user_size_limit_mb is not None:
+                effective_limit = min(connector_size_limit_mb, user_size_limit_mb)
+                source = 'user_and_connector'
+                logger.info(f"Chunking: Using MIN(connector={connector_size_limit_mb:.1f}MB, user={user_size_limit_mb}MB) = {effective_limit:.1f}MB")
+            else:
+                effective_limit = connector_size_limit_mb
+                source = 'connector_limit'
+                logger.info(f"Chunking: Connector requires size limit {effective_limit:.1f}MB (max_size={connector_specs.max_file_size_bytes/(1024*1024):.1f}MB)")
+
+            return EffectiveChunkingConfig(
+                enabled=True,
+                mode='size',
+                limit_value=effective_limit,
+                overlap_seconds=overlap_seconds,
+                source=source
+            )
+
+    # --- Step 4: No hard limits - chunking is optional ---
+
+    # Connector handles chunking internally
+    if connector_specs and connector_specs.handles_chunking_internally:
+        logger.info("Chunking: Connector handles chunking internally, no app-level chunking needed")
+        return EffectiveChunkingConfig(
+            enabled=False,
+            mode='none',
+            limit_value=0,
+            overlap_seconds=overlap_seconds,
+            source='connector_internal'
+        )
+
+    # User explicitly disabled chunking
+    if enable_chunking_env == 'false':
+        logger.info("Chunking: Disabled via ENABLE_CHUNKING=false")
+        return EffectiveChunkingConfig(
+            enabled=False,
+            mode='none',
+            limit_value=0,
+            overlap_seconds=overlap_seconds,
+            source='disabled'
+        )
+
+    # User set explicit limits - use them
+    if user_duration_limit is not None:
+        logger.info(f"Chunking: Using user CHUNK_LIMIT={user_duration_limit}s")
+        return EffectiveChunkingConfig(
+            enabled=True,
+            mode='duration',
+            limit_value=user_duration_limit,
+            overlap_seconds=overlap_seconds,
+            source='env'
+        )
+
+    if user_size_limit_mb is not None:
+        logger.info(f"Chunking: Using user CHUNK_LIMIT={user_size_limit_mb}MB")
+        return EffectiveChunkingConfig(
+            enabled=True,
+            mode='size',
+            limit_value=user_size_limit_mb,
+            overlap_seconds=overlap_seconds,
+            source='env'
+        )
+
+    # Connector has recommended settings (but no hard limits)
+    if connector_specs and connector_specs.recommended_chunk_seconds:
+        logger.info(f"Chunking: Using connector recommended={connector_specs.recommended_chunk_seconds}s")
+        return EffectiveChunkingConfig(
+            enabled=True,
+            mode='duration',
+            limit_value=connector_specs.recommended_chunk_seconds,
+            overlap_seconds=overlap_seconds,
+            source='connector_recommended'
+        )
+
+    # App defaults
+    if enable_chunking_env != 'false':
+        logger.info("Chunking: Using app defaults (20MB size-based)")
+        return EffectiveChunkingConfig(
+            enabled=True,
+            mode='size',
+            limit_value=20.0,
+            overlap_seconds=overlap_seconds,
+            source='app_default'
+        )
+
+    # Final fallback: disabled
+    return EffectiveChunkingConfig(
+        enabled=False,
+        mode='none',
+        limit_value=0,
+        overlap_seconds=overlap_seconds,
+        source='disabled'
+    )
+
+class AudioChunkingService:
+    """Service for chunking large audio files and processing them with OpenAI Whisper API."""
+    
+    def __init__(self, max_chunk_size_mb: int = 20, overlap_seconds: int = 3, max_chunk_duration_seconds: int = None):
+        """
+        Initialize the chunking service.
+        
+        Args:
+            max_chunk_size_mb: Maximum size for each chunk in MB (default 20MB for safety margin)
+            overlap_seconds: Overlap between chunks in seconds for context continuity
+            max_chunk_duration_seconds: Maximum duration for each chunk in seconds (optional)
+        """
+        self.max_chunk_size_mb = max_chunk_size_mb
+        self.overlap_seconds = overlap_seconds
+        self.max_chunk_size_bytes = max_chunk_size_mb * 1024 * 1024
+        self.max_chunk_duration_seconds = max_chunk_duration_seconds
+        self.chunk_stats = []  # Track processing statistics
+        
+    def needs_chunking(
+        self,
+        file_path: str,
+        use_asr_endpoint: bool = False,
+        connector_specs: Optional['ConnectorSpecifications'] = None
+    ) -> bool:
+        """
+        Check if a file needs to be chunked based on connector specs, ENV settings, and file size.
+
+        Priority order for chunking configuration:
+        1. If connector handles_chunking_internally=True → no app-level chunking
+        2. If ENABLE_CHUNKING=false → no chunking
+        3. If CHUNK_LIMIT or CHUNK_SIZE_MB is explicitly set → use ENV settings
+        4. If connector has specs → use connector defaults
+        5. Fallback: 20MB size-based chunking
+
+        NOTE: For duration-based limits, this may return True even if chunking isn't needed,
+        because we need to convert the file first to check duration. The actual chunking
+        decision is made after conversion in calculate_optimal_chunking().
+
+        Args:
+            file_path: Path to the audio file
+            use_asr_endpoint: DEPRECATED - use connector_specs instead
+            connector_specs: Optional ConnectorSpecifications from the active connector
+
+        Returns:
+            True if file might need chunking, False otherwise
+        """
+        # Get effective chunking configuration
+        chunking_config = get_effective_chunking_config(connector_specs)
+
+        # If chunking is disabled (by connector or user), return False
+        if not chunking_config.enabled:
+            logger.info(f"Chunking disabled (source: {chunking_config.source})")
+            return False
+
+        # Legacy fallback: if no connector_specs provided, check use_asr_endpoint
+        if connector_specs is None and use_asr_endpoint:
+            logger.info("Chunking: ASR endpoint detected (legacy), no chunking needed")
+            return False
+
+        try:
+            file_size = os.path.getsize(file_path)
+
+            if chunking_config.mode == 'size':
+                # For size-based limits, we can determine immediately
+                chunk_size_bytes = chunking_config.limit_value * 1024 * 1024
+                needs_it = file_size > chunk_size_bytes
+                logger.info(f"Chunking check (size, source={chunking_config.source}): "
+                           f"{file_size/1024/1024:.1f}MB vs limit {chunking_config.limit_value}MB - needs chunking: {needs_it}")
+                return needs_it
+            elif chunking_config.mode == 'duration':
+                # For duration-based limits, we need to check the actual duration
+                # Try to get duration without conversion first (fast check)
+                duration = self.get_audio_duration(file_path)
+                if duration:
+                    needs_it = duration > chunking_config.limit_value
+                    logger.info(f"Chunking check (duration, source={chunking_config.source}): "
+                               f"{duration:.1f}s vs limit {chunking_config.limit_value}s - needs chunking: {needs_it}")
+                    return needs_it
+                else:
+                    # Can't determine duration without conversion, assume might need chunking
+                    logger.info(f"Duration-based limit set ({chunking_config.limit_value}s) but can't check duration yet - will check after conversion")
+                    return True  # Proceed to conversion and check
+            else:
+                # Mode is 'none', shouldn't reach here but handle gracefully
+                return False
+
+        except OSError:
+            logger.error(f"Could not get file size for {file_path}")
+            return False
+
+    def needs_chunking_with_config(
+        self,
+        file_path: str,
+        connector_specs: Optional['ConnectorSpecifications'] = None
+    ) -> Tuple[bool, EffectiveChunkingConfig]:
+        """
+        Check if a file needs chunking and return the effective configuration.
+
+        This is useful when you need both the decision and the configuration
+        for subsequent processing.
+
+        Args:
+            file_path: Path to the audio file
+            connector_specs: Optional ConnectorSpecifications from the active connector
+
+        Returns:
+            Tuple of (needs_chunking, EffectiveChunkingConfig)
+        """
+        chunking_config = get_effective_chunking_config(connector_specs)
+        needs_it = self.needs_chunking(file_path, connector_specs=connector_specs)
+        return needs_it, chunking_config
+    
+    def get_audio_duration(self, file_path: str) -> Optional[float]:
+        """
+        Get the duration of an audio file in seconds using ffprobe.
+        
+        Args:
+            file_path: Path to the audio file
+            
+        Returns:
+            Duration in seconds, or None if unable to determine
+        """
+        try:
+            result = subprocess.run([
+                'ffprobe', '-v', 'error', '-show_entries', 'format=duration',
+                '-of', 'default=noprint_wrappers=1:nokey=1', file_path
+            ], capture_output=True, text=True, check=True)
+            
+            duration = float(result.stdout.strip())
+            return duration
+        except (subprocess.CalledProcessError, ValueError, FileNotFoundError) as e:
+            logger.error(f"Error getting audio duration for {file_path}: {e}")
+            return None
+    
+    def convert_to_mp3_and_get_info(self, file_path: str, temp_dir: str) -> Tuple[str, float, float]:
+        """
+        Convert the input file to MP3 format for consistency and get its size and duration info.
+
+        If the input is already MP3, skips conversion and just copies it.
+
+        Args:
+            file_path: Path to the source audio file
+            temp_dir: Directory to store the temporary MP3 file
+
+        Returns:
+            Tuple of (mp3_file_path, duration_seconds, size_bytes)
+        """
+        try:
+            import shutil
+
+            # Generate MP3 filename
+            base_name = os.path.splitext(os.path.basename(file_path))[0]
+            mp3_filename = f"{base_name}_converted.mp3"
+            mp3_path = os.path.join(temp_dir, mp3_filename)
+
+            # Check if input is already MP3 - skip conversion
+            file_ext = os.path.splitext(file_path)[1].lower()
+            if file_ext == '.mp3':
+                logger.info(f"Input {file_path} is already MP3, skipping conversion")
+                shutil.copy2(file_path, mp3_path)
+            else:
+                logger.info(f"Converting {file_path} to 128kbps MP3 format for chunking...")
+                # Use centralized FFmpeg utility for conversion
+                convert_to_mp3(file_path, mp3_path)
+
+            if not os.path.exists(mp3_path):
+                raise ValueError("MP3 file was not created")
+
+            # Get the size and duration of the MP3 file
+            mp3_size = os.path.getsize(mp3_path)
+            mp3_duration = self.get_audio_duration(mp3_path)
+
+            if not mp3_duration:
+                raise ValueError("Could not determine MP3 file duration")
+
+            logger.info(f"MP3 ready for chunking: {mp3_size/1024/1024:.1f}MB, {mp3_duration:.1f}s")
+
+            # Optionally preserve converted file for debugging (set PRESERVE_CHUNK_DEBUG=true in env)
+            if os.getenv('PRESERVE_CHUNK_DEBUG', 'false').lower() == 'true':
+                # Save debug files in /data/uploads/debug/ directory
+                debug_dir = '/data/uploads/debug'
+                os.makedirs(debug_dir, exist_ok=True)
+                debug_filename = os.path.basename(mp3_path).replace('_converted', '_converted_debug')
+                debug_path = os.path.join(debug_dir, debug_filename)
+                shutil.copy2(mp3_path, debug_path)
+                logger.info(f"Debug: Preserved converted file as {debug_path}")
+
+            return mp3_path, mp3_duration, mp3_size
+
+        except (FFmpegError, FFmpegNotFoundError) as e:
+            logger.error(f"Error converting file to MP3: {e}")
+            raise
+        except Exception as e:
+            logger.error(f"Error converting file to MP3: {e}")
+            raise
+
+    def parse_chunk_limit(self) -> Tuple[str, float]:
+        """
+        Parse the CHUNK_LIMIT environment variable to determine chunking mode and value.
+        
+        Supports formats:
+        - Size-based: "20MB", "10MB" 
+        - Duration-based: "1200s", "20m"
+        - Legacy: CHUNK_SIZE_MB environment variable (for backwards compatibility)
+        
+        Returns:
+            Tuple of (mode, value) where mode is 'size' or 'duration'
+        """
+        chunk_limit = os.environ.get('CHUNK_LIMIT', '').strip().upper()
+        
+        # Check for new CHUNK_LIMIT format
+        if chunk_limit:
+            # Size-based: ends with MB
+            if chunk_limit.endswith('MB'):
+                try:
+                    size_mb = float(re.sub(r'[^0-9.]', '', chunk_limit))
+                    return 'size', size_mb
+                except ValueError:
+                    logger.warning(f"Invalid CHUNK_LIMIT format: {chunk_limit}")
+            
+            # Duration-based: ends with s or m
+            elif chunk_limit.endswith('S'):
+                try:
+                    seconds = float(re.sub(r'[^0-9.]', '', chunk_limit))
+                    return 'duration', seconds
+                except ValueError:
+                    logger.warning(f"Invalid CHUNK_LIMIT format: {chunk_limit}")
+            
+            elif chunk_limit.endswith('M'):
+                try:
+                    minutes = float(re.sub(r'[^0-9.]', '', chunk_limit))
+                    return 'duration', minutes * 60
+                except ValueError:
+                    logger.warning(f"Invalid CHUNK_LIMIT format: {chunk_limit}")
+        
+        # Fallback to legacy CHUNK_SIZE_MB for backwards compatibility
+        legacy_size = os.environ.get('CHUNK_SIZE_MB', '20')
+        try:
+            size_mb = float(legacy_size)
+            logger.info(f"Using legacy CHUNK_SIZE_MB: {size_mb}MB")
+            return 'size', size_mb
+        except ValueError:
+            logger.warning(f"Invalid CHUNK_SIZE_MB format: {legacy_size}")
+            return 'size', 20.0  # Ultimate fallback
+    
+    def calculate_optimal_chunking(self, converted_size: float, total_duration: float, connector_specs=None) -> Tuple[int, float]:
+        """
+        Calculate optimal number of chunks and chunk duration based on the configured limit.
+
+        Args:
+            converted_size: Size of the converted audio file in bytes
+            total_duration: Total duration of the audio file in seconds
+            connector_specs: Optional ConnectorSpecifications with hard limits
+
+        Returns:
+            Tuple of (num_chunks, chunk_duration_seconds)
+        """
+        try:
+            # Use effective chunking config which respects connector hard limits
+            chunking_config = get_effective_chunking_config(connector_specs)
+            mode = chunking_config.mode
+            limit_value = chunking_config.limit_value
+
+            logger.info(f"Chunking config: mode={mode}, limit={limit_value}, source={chunking_config.source}")
+            
+            if mode == 'size':
+                # Size-based chunking
+                max_size_bytes = limit_value * 1024 * 1024 * 0.95  # 95% safety factor
+                num_chunks = max(1, math.ceil(converted_size / max_size_bytes))
+                
+                logger.info(f"Size-based chunking: {limit_value}MB limit")
+                logger.info(f"File size {converted_size/1024/1024:.1f}MB requires {num_chunks} chunks")
+                
+            else:  # duration-based
+                # Use the limit from the connector/config directly — connectors already
+                # declare their recommended_chunk_seconds with appropriate safety margins
+                num_chunks = max(1, math.ceil(total_duration / limit_value))
+
+                logger.info(f"Duration-based chunking: {limit_value}s limit")
+                logger.info(f"File duration {total_duration:.1f}s requires {num_chunks} chunks")
+            
+            # Calculate chunk duration
+            chunk_duration = total_duration / num_chunks
+            
+            # Apply minimum duration (5 minutes) but don't exceed file duration
+            chunk_duration = min(max(300, chunk_duration), total_duration)
+            
+            # Log final chunking plan
+            expected_chunk_size_mb = (converted_size / num_chunks) / (1024 * 1024)
+            logger.info(f"Chunking plan: {num_chunks} chunks of ~{chunk_duration:.1f}s each (~{expected_chunk_size_mb:.1f}MB each)")
+            
+            return num_chunks, chunk_duration
+            
+        except Exception as e:
+            logger.error(f"Error calculating optimal chunking: {e}")
+            # Conservative fallback
+            fallback_chunks = max(2, math.ceil(total_duration / 600))  # 10-minute chunks
+            fallback_duration = total_duration / fallback_chunks
+            return fallback_chunks, fallback_duration
+    
+    def create_chunks(self, file_path: str, temp_dir: str, connector_specs=None) -> List[Dict[str, Any]]:
+        """
+        Split audio file into overlapping chunks.
+
+        First converts the file to MP3 format to get accurate size information,
+        then calculates optimal chunk duration based on the actual MP3 file size.
+
+        Args:
+            file_path: Path to the source audio file
+            temp_dir: Directory to store temporary chunk files
+            connector_specs: Optional ConnectorSpecifications with hard limits
+
+        Returns:
+            List of chunk information dictionaries
+        """
+        chunks = []
+        wav_path = None
+
+        try:
+            # Step 1: Convert to MP3 and get accurate size/duration info
+            mp3_path, mp3_duration, mp3_size = self.convert_to_mp3_and_get_info(file_path, temp_dir)
+
+            # Step 2: Calculate optimal chunking strategy (respects connector hard limits)
+            num_chunks, chunk_duration = self.calculate_optimal_chunking(mp3_size, mp3_duration, connector_specs)
+            
+            # If only 1 chunk needed, no actual chunking required
+            if num_chunks == 1:
+                logger.info(f"File duration {mp3_duration:.1f}s is within limit - no chunking needed")
+                # Return the single "chunk" as the whole file
+                base_name = os.path.splitext(os.path.basename(file_path))[0]
+                chunk_filename = f"{base_name}_chunk_000.mp3"
+                chunk_path = os.path.join(temp_dir, chunk_filename)
+                
+                # Copy the converted file as the single chunk
+                import shutil
+                shutil.copy2(mp3_path, chunk_path)
+                
+                chunk_info = {
+                    'index': 0,
+                    'path': chunk_path,
+                    'filename': chunk_filename,
+                    'start_time': 0,
+                    'end_time': mp3_duration,
+                    'duration': mp3_duration,
+                    'size_bytes': mp3_size,
+                    'size_mb': mp3_size / (1024 * 1024)
+                }
+                chunks.append(chunk_info)
+                logger.info(f"Created single chunk for entire file: {mp3_duration:.1f}s")
+                return chunks
+            
+            # Calculate step size to create exactly num_chunks with overlap
+            # Total coverage needed: mp3_duration + (overlap * (num_chunks - 1))
+            # Each chunk covers: chunk_duration
+            # Step between chunks to get exactly num_chunks
+            if num_chunks > 1:
+                step_duration = (mp3_duration - chunk_duration) / (num_chunks - 1)
+            else:
+                step_duration = mp3_duration
+            
+            current_start = 0
+            chunk_index = 0
+            
+            logger.info(f"Splitting {file_path} into {num_chunks} chunks of ~{chunk_duration:.1f}s with {self.overlap_seconds}s overlap")
+            
+            for chunk_index in range(num_chunks):
+                # Calculate start position for this chunk
+                if chunk_index > 0:
+                    current_start = chunk_index * step_duration
+                
+                # Calculate end time for this chunk
+                chunk_end = min(current_start + chunk_duration, mp3_duration)
+                actual_duration = chunk_end - current_start
+                
+                # Skip very short chunks at the end (shouldn't happen with proper calculation)
+                if actual_duration < 10:  # Less than 10 seconds
+                    logger.warning(f"Skipping short chunk {chunk_index}: {actual_duration:.1f}s")
+                    break
+                
+                # Generate chunk filename
+                base_name = os.path.splitext(os.path.basename(file_path))[0]
+                chunk_filename = f"{base_name}_chunk_{chunk_index:03d}.mp3"
+                chunk_path = os.path.join(temp_dir, chunk_filename)
+                
+                # Extract chunk from the converted MP3 file (more efficient than re-converting)
+                cmd = [
+                    'ffmpeg', '-i', mp3_path,
+                    '-ss', str(current_start),
+                    '-t', str(actual_duration),
+                    '-acodec', 'copy',  # Copy codec since it's already in the right format
+                    '-y',  # Overwrite output file
+                    chunk_path
+                ]
+                
+                result = subprocess.run(cmd, capture_output=True, text=True)
+                if result.returncode != 0:
+                    logger.error(f"ffmpeg failed for chunk {chunk_index}: {result.stderr}")
+                    continue
+                
+                # Verify chunk was created and get its size
+                if os.path.exists(chunk_path):
+                    chunk_size = os.path.getsize(chunk_path)
+                    
+                    # Verify chunk size is within limits (only relevant for size-based chunking)
+                    if chunk_size > self.max_chunk_size_bytes:
+                        logger.debug(f"Chunk {chunk_index} is {chunk_size/1024/1024:.1f}MB (size limit: {self.max_chunk_size_mb}MB)")
+                    
+                    chunk_info = {
+                        'index': chunk_index,
+                        'path': chunk_path,
+                        'filename': chunk_filename,
+                        'start_time': current_start,
+                        'end_time': chunk_end,
+                        'duration': actual_duration,
+                        'size_bytes': chunk_size,
+                        'size_mb': chunk_size / (1024 * 1024)
+                    }
+                    
+                    chunks.append(chunk_info)
+                    logger.info(f"Created chunk {chunk_index}: {current_start:.1f}s-{chunk_end:.1f}s ({chunk_size/1024/1024:.1f}MB)")
+                    
+                    # Optionally preserve chunks for debugging (set PRESERVE_CHUNK_DEBUG=true in env)
+                    if os.getenv('PRESERVE_CHUNK_DEBUG', 'false').lower() == 'true':
+                        import shutil
+                        # Save debug chunks in /data/uploads/debug/ directory
+                        debug_dir = '/data/uploads/debug'
+                        os.makedirs(debug_dir, exist_ok=True)
+                        debug_filename = os.path.basename(chunk_path).replace('.mp3', '_debug.mp3')
+                        debug_path = os.path.join(debug_dir, debug_filename)
+                        shutil.copy2(chunk_path, debug_path)
+                        logger.info(f"Debug: Preserved chunk as {debug_path}")
+                else:
+                    logger.error(f"Chunk file not created: {chunk_path}")
+            
+            logger.info(f"Created {len(chunks)} chunks for {file_path}")
+            return chunks
+            
+        except Exception as e:
+            logger.error(f"Error creating chunks for {file_path}: {e}")
+            # Clean up any partial chunks
+            for chunk in chunks:
+                try:
+                    if os.path.exists(chunk['path']):
+                        os.remove(chunk['path'])
+                except Exception:
+                    pass
+            raise
+        finally:
+            # Clean up the temporary WAV file
+            if wav_path and os.path.exists(wav_path):
+                try:
+                    os.remove(wav_path)
+                    logger.debug(f"Cleaned up temporary WAV file: {wav_path}")
+                except Exception as e:
+                    logger.warning(f"Error cleaning up temporary WAV file: {e}")
+    
+    def merge_transcriptions(self, chunk_results: List[Dict[str, Any]]) -> str:
+        """
+        Merge transcription results from multiple chunks, handling overlaps.
+        
+        Args:
+            chunk_results: List of transcription results from chunks
+            
+        Returns:
+            Merged transcription text
+        """
+        if not chunk_results:
+            return ""
+        
+        if len(chunk_results) == 1:
+            return chunk_results[0].get('transcription', '')
+        
+        # Sort chunks by start time to ensure correct order
+        sorted_chunks = sorted(chunk_results, key=lambda x: x.get('start_time', 0))
+        
+        merged_text = ""
+        
+        for i, chunk in enumerate(sorted_chunks):
+            chunk_text = chunk.get('transcription', '').strip()
+            
+            if not chunk_text:
+                continue
+            
+            if i == 0:
+                # First chunk: use entire transcription
+                merged_text = chunk_text
+            else:
+                # Subsequent chunks: try to handle overlap
+                merged_text = self._merge_overlapping_text(
+                    merged_text, 
+                    chunk_text, 
+                    chunk.get('start_time', 0),
+                    sorted_chunks[i-1].get('end_time', 0)
+                )
+        
+        return merged_text
+    
+    def _merge_overlapping_text(self, existing_text: str, new_text: str, 
+                               new_start_time: float, prev_end_time: float) -> str:
+        """
+        Merge overlapping transcription text, attempting to remove duplicates.
+        
+        Args:
+            existing_text: Previously merged text
+            new_text: New chunk text to merge
+            new_start_time: Start time of new chunk
+            prev_end_time: End time of previous chunk
+            
+        Returns:
+            Merged text with overlaps handled
+        """
+        # If there's no overlap, just concatenate
+        overlap_duration = prev_end_time - new_start_time
+        if overlap_duration <= 0:
+            return f"{existing_text}\n{new_text}"
+        
+        # For overlapping chunks, try to find common text and merge intelligently
+        # This is a simplified approach - in practice, you might want more sophisticated
+        # text similarity matching
+        
+        # Split texts into sentences/phrases
+        existing_sentences = self._split_into_sentences(existing_text)
+        new_sentences = self._split_into_sentences(new_text)
+        
+        if not existing_sentences or not new_sentences:
+            return f"{existing_text}\n{new_text}"
+        
+        # Try to find overlap by comparing last few sentences of existing text
+        # with first few sentences of new text
+        overlap_found = False
+        merge_point = len(existing_sentences)
+        
+        # Look for common sentences (simple approach)
+        for i in range(min(3, len(existing_sentences))):  # Check last 3 sentences
+            last_sentence = existing_sentences[-(i+1)].strip().lower()
+            
+            for j in range(min(3, len(new_sentences))):  # Check first 3 sentences
+                first_sentence = new_sentences[j].strip().lower()
+                
+                # If sentences are similar enough, consider it an overlap
+                if last_sentence and first_sentence and self._sentences_similar(last_sentence, first_sentence):
+                    merge_point = len(existing_sentences) - i
+                    new_start_index = j + 1
+                    overlap_found = True
+                    break
+            
+            if overlap_found:
+                break
+        
+        if overlap_found:
+            # Merge at the found overlap point
+            merged_sentences = existing_sentences[:merge_point] + new_sentences[new_start_index:]
+            return ' '.join(merged_sentences)
+        else:
+            # No clear overlap found, concatenate with a separator
+            return f"{existing_text}\n{new_text}"
+    
+    def _split_into_sentences(self, text: str) -> List[str]:
+        """Split text into sentences for overlap detection."""
+        import re
+        # Simple sentence splitting - could be improved with more sophisticated NLP
+        sentences = re.split(r'[.!?]+', text)
+        return [s.strip() for s in sentences if s.strip()]
+    
+    def _sentences_similar(self, sent1: str, sent2: str, threshold: float = 0.8) -> bool:
+        """Check if two sentences are similar enough to be considered the same."""
+        # Simple similarity check based on common words
+        words1 = set(sent1.split())
+        words2 = set(sent2.split())
+        
+        if not words1 or not words2:
+            return False
+        
+        intersection = len(words1.intersection(words2))
+        union = len(words1.union(words2))
+        
+        similarity = intersection / union if union > 0 else 0
+        return similarity >= threshold
+    
+    def analyze_chunk_audio_properties(self, chunk_path: str) -> Dict[str, Any]:
+        """
+        Analyze audio properties of a chunk that might affect processing time.
+        
+        Args:
+            chunk_path: Path to the chunk file
+            
+        Returns:
+            Dictionary with audio analysis results
+        """
+        try:
+            # Get detailed audio information using ffprobe
+            cmd = [
+                'ffprobe', '-v', 'quiet', '-print_format', 'json',
+                '-show_format', '-show_streams', chunk_path
+            ]
+            
+            result = subprocess.run(cmd, capture_output=True, text=True, check=True)
+            probe_data = json.loads(result.stdout)
+            
+            audio_stream = None
+            for stream in probe_data.get('streams', []):
+                if stream.get('codec_type') == 'audio':
+                    audio_stream = stream
+                    break
+            
+            if not audio_stream:
+                return {'error': 'No audio stream found'}
+            
+            format_info = probe_data.get('format', {})
+            
+            analysis = {
+                'duration': float(format_info.get('duration', 0)),
+                'size_bytes': int(format_info.get('size', 0)),
+                'bitrate': int(format_info.get('bit_rate', 0)),
+                'sample_rate': int(audio_stream.get('sample_rate', 0)),
+                'channels': int(audio_stream.get('channels', 0)),
+                'codec': audio_stream.get('codec_name', 'unknown'),
+                'bits_per_sample': int(audio_stream.get('bits_per_raw_sample', 0)),
+            }
+            
+            # Calculate some derived metrics
+            if analysis['duration'] > 0:
+                analysis['effective_bitrate'] = (analysis['size_bytes'] * 8) / analysis['duration']
+                analysis['compression_ratio'] = analysis['bitrate'] / analysis['effective_bitrate'] if analysis['effective_bitrate'] > 0 else 0
+            
+            return analysis
+            
+        except Exception as e:
+            logger.warning(f"Error analyzing chunk audio properties: {e}")
+            return {'error': str(e)}
+    
+    def log_processing_statistics(self, chunk_results: List[Dict[str, Any]]) -> None:
+        """
+        Log detailed statistics about chunk processing performance.
+        
+        Args:
+            chunk_results: List of chunk processing results with timing info
+        """
+        if not chunk_results:
+            return
+        
+        logger.info("=== CHUNK PROCESSING STATISTICS ===")
+        
+        total_chunks = len(chunk_results)
+        processing_times = []
+        sizes = []
+        durations = []
+        
+        for i, result in enumerate(chunk_results):
+            processing_time = result.get('processing_time', 0)
+            chunk_size = result.get('size_mb', 0)
+            chunk_duration = result.get('duration', 0)
+            
+            processing_times.append(processing_time)
+            sizes.append(chunk_size)
+            durations.append(chunk_duration)
+            
+            # Log individual chunk stats
+            rate = chunk_duration / processing_time if processing_time > 0 else 0
+            logger.info(f"Chunk {i+1}: {processing_time:.1f}s processing, {chunk_size:.1f}MB, {chunk_duration:.1f}s audio (rate: {rate:.2f}x)")
+        
+        # Calculate summary statistics
+        if processing_times:
+            avg_time = sum(processing_times) / len(processing_times)
+            min_time = min(processing_times)
+            max_time = max(processing_times)
+            
+            avg_size = sum(sizes) / len(sizes)
+            avg_duration = sum(durations) / len(durations)
+            
+            total_audio_time = sum(durations)
+            total_processing_time = sum(processing_times)
+            overall_rate = total_audio_time / total_processing_time if total_processing_time > 0 else 0
+            
+            logger.info(f"Summary: {total_chunks} chunks, {total_audio_time:.1f}s audio in {total_processing_time:.1f}s")
+            logger.info(f"Average: {avg_time:.1f}s processing, {avg_size:.1f}MB, {avg_duration:.1f}s audio")
+            logger.info(f"Range: {min_time:.1f}s - {max_time:.1f}s processing time")
+            logger.info(f"Overall rate: {overall_rate:.2f}x realtime")
+            
+            # Identify performance outliers
+            if max_time > avg_time * 2:
+                slow_chunks = [i for i, t in enumerate(processing_times) if t > avg_time * 1.5]
+                logger.warning(f"Performance outliers detected: chunks {[i+1 for i in slow_chunks]} took significantly longer")
+                
+                # Suggest possible causes
+                logger.info("Possible causes for slow processing:")
+                logger.info("- OpenAI API server load/performance variations")
+                logger.info("- Network latency or connection issues")
+                logger.info("- Audio content complexity (silence, noise, multiple speakers)")
+                logger.info("- Temporary API rate limiting or throttling")
+        
+        logger.info("=== END STATISTICS ===")
+    
+    def get_performance_recommendations(self, chunk_results: List[Dict[str, Any]]) -> List[str]:
+        """
+        Generate performance recommendations based on processing results.
+        
+        Args:
+            chunk_results: List of chunk processing results
+            
+        Returns:
+            List of recommendation strings
+        """
+        recommendations = []
+        
+        if not chunk_results:
+            return recommendations
+        
+        processing_times = [r.get('processing_time', 0) for r in chunk_results]
+        
+        if processing_times:
+            avg_time = sum(processing_times) / len(processing_times)
+            max_time = max(processing_times)
+            
+            # Check for high variance in processing times
+            if max_time > avg_time * 3:
+                recommendations.append("High variance in processing times detected. Consider implementing retry logic with exponential backoff.")
+            
+            # Check for overall slow processing
+            total_audio = sum(r.get('duration', 0) for r in chunk_results)
+            total_processing = sum(processing_times)
+            rate = total_audio / total_processing if total_processing > 0 else 0
+            
+            if rate < 0.5:  # Less than 0.5x realtime
+                recommendations.append("Overall processing is slow. Consider using smaller chunks or a different transcription service.")
+            
+            # Check for timeout issues
+            if any(t > 300 for t in processing_times):  # 5+ minutes
+                recommendations.append("Some chunks took over 5 minutes. Consider implementing timeout handling and chunk retry logic.")
+            
+            # Check chunk size optimization
+            avg_size = sum(r.get('size_mb', 0) for r in chunk_results) / len(chunk_results)
+            if avg_size < 10:
+                recommendations.append("Chunks are relatively small. Consider increasing chunk size for better efficiency.")
+            elif avg_size > 22:
+                recommendations.append("Chunks are close to size limit. Consider reducing chunk size for more reliable processing.")
+        
+        return recommendations
+    
+    def cleanup_chunks(self, chunks: List[Dict[str, Any]], temp_mp3_path: str = None) -> None:
+        """
+        Clean up temporary chunk files and MP3 file.
+        
+        Args:
+            chunks: List of chunk information dictionaries
+            temp_mp3_path: Optional path to temporary MP3 file to clean up
+        """
+        for chunk in chunks:
+            try:
+                chunk_path = chunk.get('path')
+                if chunk_path and os.path.exists(chunk_path):
+                    os.remove(chunk_path)
+                    logger.debug(f"Cleaned up chunk file: {chunk_path}")
+            except Exception as e:
+                logger.warning(f"Error cleaning up chunk {chunk.get('filename', 'unknown')}: {e}")
+        
+        # Clean up temporary MP3 file if provided
+        if temp_mp3_path and os.path.exists(temp_mp3_path):
+            try:
+                os.remove(temp_mp3_path)
+                logger.debug(f"Cleaned up temporary MP3 file: {temp_mp3_path}")
+            except Exception as e:
+                logger.warning(f"Error cleaning up temporary MP3 file: {e}")
+
+def get_audio_duration_ffprobe(file_path: str) -> Optional[float]:
+    """Get actual audio duration using ffprobe."""
+    try:
+        result = subprocess.run([
+            'ffprobe', '-v', 'error', '-show_entries', 'format=duration',
+            '-of', 'default=noprint_wrappers=1:nokey=1', file_path
+        ], capture_output=True, text=True, check=True)
+        return float(result.stdout.strip())
+    except Exception:
+        return None
+
+
+def extract_speaker_samples(
+    audio_path: str,
+    segments: List[Dict[str, Any]],
+    output_dir: str,
+    min_duration: float = 1.5,  # OpenAI minimum is 1.2s, use 1.5s for safety
+    max_duration: float = 9.0,  # OpenAI maximum is 10.0s, use 9.0s for safety
+    max_speakers: int = 4
+) -> Dict[str, str]:
+    """
+    Extract audio samples for each unique speaker from diarized segments.
+
+    This is used to maintain speaker identity across chunks when processing
+    long audio files with the gpt-4o-transcribe-diarize model.
+
+    Args:
+        audio_path: Path to the source audio file (should be the converted chunk MP3)
+        segments: List of diarized segments with speaker, start_time, end_time
+        output_dir: Directory to store extracted speaker samples
+        min_duration: Minimum duration for a speaker sample (OpenAI requires 1.2-10s)
+        max_duration: Maximum duration for a speaker sample
+        max_speakers: Maximum number of speakers to extract (OpenAI supports up to 4)
+
+    Returns:
+        Dict mapping speaker label (e.g., "A", "B") to path of extracted audio sample
+    """
+    # OpenAI's actual limits
+    OPENAI_MIN_DURATION = 1.2
+    OPENAI_MAX_DURATION = 10.0
+
+    # Group segments by speaker
+    speaker_segments: Dict[str, List[Dict]] = {}
+    for seg in segments:
+        # Handle both dict and object segments
+        if isinstance(seg, dict):
+            speaker = seg.get('speaker', 'Unknown')
+            start = seg.get('start_time') or seg.get('start')
+            end = seg.get('end_time') or seg.get('end')
+        else:
+            speaker = getattr(seg, 'speaker', 'Unknown')
+            start = getattr(seg, 'start_time', None) or getattr(seg, 'start', None)
+            end = getattr(seg, 'end_time', None) or getattr(seg, 'end', None)
+
+        if speaker == 'Unknown' or start is None or end is None:
+            continue
+
+        if speaker not in speaker_segments:
+            speaker_segments[speaker] = []
+        speaker_segments[speaker].append({'start': start, 'end': end})
+
+    if not speaker_segments:
+        logger.warning("No valid speaker segments found for sample extraction")
+        return {}
+
+    # Sort speakers to get consistent ordering (A, B, C, D...)
+    sorted_speakers = sorted(speaker_segments.keys())[:max_speakers]
+    logger.info(f"Extracting samples for {len(sorted_speakers)} speakers: {sorted_speakers}")
+
+    speaker_samples = {}
+
+    for speaker in sorted_speakers:
+        segs = speaker_segments[speaker]
+
+        # Find the best segment for this speaker (ideally 1.5-9 seconds)
+        best_segment = None
+        best_duration = 0
+
+        for seg in segs:
+            duration = seg['end'] - seg['start']
+
+            # Prefer segments in the ideal range
+            if min_duration <= duration <= max_duration:
+                if duration > best_duration:
+                    best_segment = seg
+                    best_duration = duration
+
+        # If no segment in ideal range, try to find one we can trim
+        if not best_segment:
+            for seg in segs:
+                duration = seg['end'] - seg['start']
+                if duration >= min_duration:
+                    # Trim to max_duration if needed
+                    best_segment = {
+                        'start': seg['start'],
+                        'end': min(seg['end'], seg['start'] + max_duration)
+                    }
+                    best_duration = best_segment['end'] - best_segment['start']
+                    break
+
+        # Still no segment? Try combining multiple short segments
+        if not best_segment and len(segs) > 1:
+            # Sort by start time and try to find consecutive segments
+            sorted_segs = sorted(segs, key=lambda x: x['start'])
+            combined_start = sorted_segs[0]['start']
+            combined_end = sorted_segs[0]['end']
+
+            for i in range(1, len(sorted_segs)):
+                # If segments are close (within 1 second), combine them
+                if sorted_segs[i]['start'] - combined_end < 1.0:
+                    combined_end = sorted_segs[i]['end']
+                    if combined_end - combined_start >= min_duration:
+                        break
+
+            combined_duration = combined_end - combined_start
+            if combined_duration >= min_duration:
+                best_segment = {
+                    'start': combined_start,
+                    'end': min(combined_end, combined_start + max_duration)
+                }
+                best_duration = best_segment['end'] - best_segment['start']
+
+        if not best_segment:
+            logger.warning(f"Could not find suitable segment for speaker {speaker}")
+            continue
+
+        # Extract the audio sample using ffmpeg
+        sample_filename = f"speaker_{speaker}_sample.mp3"
+        sample_path = os.path.join(output_dir, sample_filename)
+
+        try:
+            cmd = [
+                'ffmpeg', '-i', audio_path,
+                '-ss', str(best_segment['start']),
+                '-t', str(best_duration),
+                '-acodec', 'libmp3lame',
+                '-b:a', '128k',
+                '-y',
+                sample_path
+            ]
+
+            result = subprocess.run(cmd, capture_output=True, text=True)
+            if result.returncode != 0:
+                logger.error(f"Failed to extract sample for speaker {speaker}: {result.stderr}")
+                continue
+
+            if os.path.exists(sample_path) and os.path.getsize(sample_path) > 0:
+                # Verify actual duration meets OpenAI requirements
+                actual_duration = get_audio_duration_ffprobe(sample_path)
+                if actual_duration:
+                    logger.info(f"Speaker {speaker} sample: expected {best_duration:.2f}s, actual {actual_duration:.2f}s")
+
+                    if actual_duration < OPENAI_MIN_DURATION:
+                        logger.warning(f"Sample for speaker {speaker} too short ({actual_duration:.2f}s < {OPENAI_MIN_DURATION}s), skipping")
+                        os.remove(sample_path)
+                        continue
+                    elif actual_duration > OPENAI_MAX_DURATION:
+                        logger.warning(f"Sample for speaker {speaker} too long ({actual_duration:.2f}s > {OPENAI_MAX_DURATION}s), skipping")
+                        os.remove(sample_path)
+                        continue
+
+                speaker_samples[speaker] = sample_path
+                logger.info(f"Extracted {actual_duration:.1f}s sample for speaker {speaker} "
+                           f"(from {best_segment['start']:.1f}s to {best_segment['end']:.1f}s)")
+            else:
+                logger.warning(f"Sample file not created for speaker {speaker}")
+
+        except Exception as e:
+            logger.error(f"Error extracting sample for speaker {speaker}: {e}")
+
+    return speaker_samples
+
+
+def samples_to_data_urls(speaker_samples: Dict[str, str]) -> Dict[str, str]:
+    """
+    Convert speaker sample file paths to base64-encoded data URLs.
+
+    OpenAI's known_speaker_references requires audio samples as data URLs
+    when using multipart form data.
+
+    Args:
+        speaker_samples: Dict mapping speaker label to file path
+
+    Returns:
+        Dict mapping speaker label to data URL
+    """
+    import base64
+
+    data_urls = {}
+
+    for speaker, path in speaker_samples.items():
+        try:
+            with open(path, 'rb') as f:
+                audio_data = f.read()
+
+            # Encode as base64 data URL
+            b64_data = base64.b64encode(audio_data).decode('utf-8')
+            data_url = f"data:audio/mpeg;base64,{b64_data}"
+            data_urls[speaker] = data_url
+
+            logger.debug(f"Converted speaker {speaker} sample to data URL ({len(b64_data)} bytes)")
+
+        except Exception as e:
+            logger.error(f"Error converting speaker {speaker} sample to data URL: {e}")
+
+    return data_urls
+
+
+class ChunkProcessingError(Exception):
+    """Exception raised when chunk processing fails."""
+    pass
+
+class ChunkingNotSupportedError(Exception):
+    """Exception raised when chunking is not supported for the current configuration."""
+    pass
diff --git a/src/auth/sso.py b/src/auth/sso.py
new file mode 100644
index 00000000..36e56015
--- /dev/null
+++ b/src/auth/sso.py
@@ -0,0 +1,188 @@
+import os
+import re
+from typing import Dict, Optional
+
+from authlib.integrations.flask_client import OAuth
+from flask import current_app
+
+from src.database import db
+from src.models import User
+
+# Keep a single OAuth client instance
+_oauth: Optional[OAuth] = None
+
+
+def _str_to_bool(value: str) -> bool:
+    return str(value or "").lower() == "true"
+
+
+def get_sso_config() -> Dict[str, Optional[str]]:
+    """Load SSO configuration from environment variables."""
+    return {
+        "enabled": _str_to_bool(os.environ.get("ENABLE_SSO", "false")),
+        "provider_name": os.environ.get("SSO_PROVIDER_NAME", "SSO"),
+        "client_id": os.environ.get("SSO_CLIENT_ID"),
+        "client_secret": os.environ.get("SSO_CLIENT_SECRET"),
+        "discovery_url": os.environ.get("SSO_DISCOVERY_URL"),
+        "redirect_uri": os.environ.get("SSO_REDIRECT_URI"),
+        "auto_register": _str_to_bool(os.environ.get("SSO_AUTO_REGISTER", "true")),
+        "allowed_domains": os.environ.get("SSO_ALLOWED_DOMAINS"),
+        "username_claim": os.environ.get("SSO_DEFAULT_USERNAME_CLAIM", "preferred_username"),
+        "name_claim": os.environ.get("SSO_DEFAULT_NAME_CLAIM", "name"),
+        "disable_password_login": _str_to_bool(os.environ.get("SSO_DISABLE_PASSWORD_LOGIN", "false")),
+    }
+
+
+def is_sso_enabled() -> bool:
+    cfg = get_sso_config()
+    return bool(
+        cfg["enabled"]
+        and cfg["client_id"]
+        and cfg["client_secret"]
+        and cfg["discovery_url"]
+        and cfg["redirect_uri"]
+    )
+
+
+def init_sso_client(app) -> Optional[OAuth]:
+    """Initialize OAuth client if SSO is enabled."""
+    global _oauth
+    if not is_sso_enabled():
+        return None
+
+    if _oauth:
+        return _oauth
+
+    cfg = get_sso_config()
+    oauth = OAuth(app)
+    oauth.register(
+        name="sso",
+        server_metadata_url=cfg["discovery_url"],
+        client_id=cfg["client_id"],
+        client_secret=cfg["client_secret"],
+        client_kwargs={"scope": "openid email profile"},
+    )
+    _oauth = oauth
+    app.logger.info("SSO client initialized with discovery URL %s", cfg["discovery_url"])
+    return _oauth
+
+
+def get_sso_client() -> Optional[OAuth]:
+    """Return initialized OAuth client or None."""
+    return _oauth
+
+
+def is_domain_allowed(email: Optional[str]) -> bool:
+    """Check if email domain is allowed for auto-registration."""
+    if not email:
+        return False
+    cfg = get_sso_config()
+    domains_env = cfg["allowed_domains"]
+    if not domains_env:
+        return True  # no restriction
+
+    allowed = [d.strip().lower() for d in domains_env.split(",") if d.strip()]
+    if not allowed:
+        return True
+
+    parts = email.lower().rsplit("@", 1)
+    if len(parts) != 2:
+        return False
+    domain = parts[1]
+    return domain in allowed
+
+
+def _sanitize_username(candidate: str) -> str:
+    sanitized = re.sub(r"[^a-zA-Z0-9._-]", "", candidate or "")
+    return sanitized or "user"
+
+
+def generate_unique_username(preferred: Optional[str]) -> str:
+    """Generate a unique username based on preferred value."""
+    base = _sanitize_username(preferred or "user")
+    base = base[:20]
+
+    suffix = 0
+    candidate = base
+    while User.query.filter_by(username=candidate).first():
+        suffix += 1
+        candidate = f"{base[:18]}{suffix:02d}"
+    return candidate
+
+
+def create_or_update_sso_user(userinfo: Dict[str, str]) -> User:
+    """Create or update a user from SSO (OIDC) claims."""
+    cfg = get_sso_config()
+    subject = userinfo.get("sub")
+    email = userinfo.get("email")
+    username_claim = cfg["username_claim"]
+    name_claim = cfg["name_claim"]
+
+    if not subject:
+        raise ValueError("SSO userinfo does not include 'sub'")
+
+    if not cfg["auto_register"] and not User.query.filter_by(sso_subject=subject).first():
+        raise PermissionError("SSO auto-registration is disabled")
+
+    if email and not is_domain_allowed(email):
+        raise PermissionError("Email domain is not allowed for SSO sign-up")
+
+    # Existing by subject
+    user = User.query.filter_by(sso_subject=subject).first()
+    if user:
+        _update_profile_fields(user, userinfo, name_claim)
+        db.session.commit()
+        return user
+
+    # Existing by email: attach SSO
+    if email:
+        existing_email_user = User.query.filter_by(email=email).first()
+        if existing_email_user:
+            existing_email_user.sso_provider = cfg["provider_name"]
+            existing_email_user.sso_subject = subject
+            _update_profile_fields(existing_email_user, userinfo, name_claim)
+            db.session.commit()
+            return existing_email_user
+
+    # Create new user
+    preferred_username = userinfo.get(username_claim) or (email.split("@")[0] if email else None)
+    username = generate_unique_username(preferred_username)
+    name_value = userinfo.get(name_claim) if name_claim else userinfo.get("name")
+
+    user = User(
+        username=username,
+        email=email or f"{subject}@placeholder.local",
+        password=None,
+        sso_provider=cfg["provider_name"],
+        sso_subject=subject,
+        name=name_value,
+    )
+    db.session.add(user)
+    db.session.commit()
+    return user
+
+
+def _update_profile_fields(user: User, userinfo: Dict[str, str], name_claim: Optional[str]) -> None:
+    """Update optional profile fields from SSO claims."""
+    if not user.email and userinfo.get("email"):
+        user.email = userinfo["email"]
+    if name_claim and userinfo.get(name_claim):
+        user.name = userinfo[name_claim]
+
+
+def update_user_profile_from_claims(user: User, userinfo: Dict[str, str]) -> None:
+    """Expose profile update for external callers (e.g., account linking)."""
+    cfg = get_sso_config()
+    _update_profile_fields(user, userinfo, cfg["name_claim"])
+
+
+def link_sso_to_existing_user(user: User, provider: str, subject: str) -> User:
+    """Link SSO identity to an existing user account."""
+    if user.sso_subject and user.sso_subject != subject:
+        raise ValueError("Account already linked to another SSO identity")
+
+    user.sso_provider = provider
+    user.sso_subject = subject
+    db.session.commit()
+    return user
+
diff --git a/src/config/__init__.py b/src/config/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/src/config/app_config.py b/src/config/app_config.py
new file mode 100644
index 00000000..b4111b16
--- /dev/null
+++ b/src/config/app_config.py
@@ -0,0 +1,182 @@
+"""
+Application configuration and initialization.
+"""
+
+import os
+import sys
+import httpx
+from openai import OpenAI
+
+from src.audio_chunking import AudioChunkingService
+from src.config.version import get_version
+
+# Configuration from environment
+TEXT_MODEL_API_KEY = os.environ.get("TEXT_MODEL_API_KEY")
+TEXT_MODEL_BASE_URL = os.environ.get("TEXT_MODEL_BASE_URL", "https://openrouter.ai/api/v1")
+if TEXT_MODEL_BASE_URL:
+    TEXT_MODEL_BASE_URL = TEXT_MODEL_BASE_URL.split('#')[0].strip()
+TEXT_MODEL_NAME = os.environ.get("TEXT_MODEL_NAME", "openai/gpt-3.5-turbo")
+
+transcription_api_key = os.environ.get("TRANSCRIPTION_API_KEY", "")
+transcription_base_url = os.environ.get("TRANSCRIPTION_BASE_URL", "")
+if transcription_base_url:
+    transcription_base_url = transcription_base_url.split('#')[0].strip()
+
+# New transcription connector configuration
+# TRANSCRIPTION_CONNECTOR: explicit connector name (openai_whisper, openai_transcribe, asr_endpoint)
+# TRANSCRIPTION_MODEL: model to use (e.g., gpt-4o-transcribe-diarize for diarization)
+TRANSCRIPTION_CONNECTOR = os.environ.get('TRANSCRIPTION_CONNECTOR', '').lower().strip()
+TRANSCRIPTION_MODEL = os.environ.get('TRANSCRIPTION_MODEL', '')
+if TRANSCRIPTION_MODEL:
+    TRANSCRIPTION_MODEL = TRANSCRIPTION_MODEL.split('#')[0].strip()
+
+# Optional comma-separated list of transcription models the user can pick from
+# at upload/reprocess time, or set as a default on a tag/folder. When empty,
+# the model dropdown is hidden and TRANSCRIPTION_MODEL above is the only model.
+# Example: TRANSCRIPTION_MODELS_AVAILABLE=whisper-1,gpt-4o-transcribe,gpt-4o-transcribe-diarize
+# Optional parallel labels: TRANSCRIPTION_MODEL_LABELS=Whisper,GPT-4o,GPT-4o Diarize
+def _parse_models_csv(raw):
+    return [m.strip() for m in raw.split(',') if m.strip()]
+
+TRANSCRIPTION_MODELS_AVAILABLE = _parse_models_csv(os.environ.get('TRANSCRIPTION_MODELS_AVAILABLE', ''))
+_labels_raw = os.environ.get('TRANSCRIPTION_MODEL_LABELS', '')
+_labels = _parse_models_csv(_labels_raw)
+# Pair each model with a label, falling back to the model id if no label given.
+TRANSCRIPTION_MODEL_OPTIONS = [
+    {'value': m, 'label': _labels[i] if i < len(_labels) else m}
+    for i, m in enumerate(TRANSCRIPTION_MODELS_AVAILABLE)
+]
+
+# Feature flag for new transcription architecture (default: enabled)
+USE_NEW_TRANSCRIPTION_ARCHITECTURE = os.environ.get(
+    'USE_NEW_TRANSCRIPTION_ARCHITECTURE', 'true'
+).lower() == 'true'
+
+USE_ASR_ENDPOINT = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+ASR_BASE_URL = os.environ.get('ASR_BASE_URL')
+if ASR_BASE_URL:
+    ASR_BASE_URL = ASR_BASE_URL.split('#')[0].strip()
+
+if USE_ASR_ENDPOINT:
+    ASR_DIARIZE = os.environ.get('ASR_DIARIZE', 'true').lower() == 'true'
+    ASR_MIN_SPEAKERS = os.environ.get('ASR_MIN_SPEAKERS')
+    ASR_MAX_SPEAKERS = os.environ.get('ASR_MAX_SPEAKERS')
+    # Speaker embeddings are only supported by WhisperX ASR service, not the basic whisper-asr-webservice
+    ASR_RETURN_SPEAKER_EMBEDDINGS = os.environ.get('ASR_RETURN_SPEAKER_EMBEDDINGS', 'false').lower() == 'true'
+else:
+    ASR_DIARIZE = False
+    ASR_MIN_SPEAKERS = None
+    ASR_MAX_SPEAKERS = None
+    ASR_RETURN_SPEAKER_EMBEDDINGS = False
+
+# ASR chunking configuration - enables app-level chunking for self-hosted ASR services
+# that may crash on long files due to GPU memory exhaustion
+ASR_ENABLE_CHUNKING = os.environ.get('ASR_ENABLE_CHUNKING', 'false').lower() == 'true'
+ASR_MAX_DURATION_SECONDS = int(os.environ.get('ASR_MAX_DURATION_SECONDS', '7200'))  # 2 hours default
+
+ENABLE_CHUNKING = os.environ.get('ENABLE_CHUNKING', 'true').lower() == 'true'
+CHUNK_SIZE_MB = int(os.environ.get('CHUNK_SIZE_MB', '20'))
+CHUNK_OVERLAP_SECONDS = int(os.environ.get('CHUNK_OVERLAP_SECONDS', '3'))
+
+# Audio compression settings - compress lossless uploads (WAV, AIFF) to save storage
+AUDIO_COMPRESS_UPLOADS = os.environ.get('AUDIO_COMPRESS_UPLOADS', 'true').lower() == 'true'
+AUDIO_CODEC = os.environ.get('AUDIO_CODEC', 'mp3').lower()  # mp3, flac, opus
+AUDIO_BITRATE = os.environ.get('AUDIO_BITRATE', '128k')  # For lossy codecs
+
+# Video passthrough - send original video files directly to ASR without extracting audio
+# Useful for custom ASR backends that handle video/multi-track audio internally
+VIDEO_PASSTHROUGH_ASR = os.environ.get('VIDEO_PASSTHROUGH_ASR', 'false').lower() == 'true'
+
+# Unsupported codecs - comma-separated list of codecs to exclude from the default supported list
+# Useful when your transcription service doesn't support certain codecs (e.g., vllm doesn't support opus)
+# Example: AUDIO_UNSUPPORTED_CODECS=opus,vorbis
+_unsupported_codecs_str = os.environ.get('AUDIO_UNSUPPORTED_CODECS', '')
+AUDIO_UNSUPPORTED_CODECS = {c.strip().lower() for c in _unsupported_codecs_str.split(',') if c.strip()}
+
+# Email verification configuration
+ENABLE_EMAIL_VERIFICATION = os.environ.get('ENABLE_EMAIL_VERIFICATION', 'false').lower() == 'true'
+REQUIRE_EMAIL_VERIFICATION = os.environ.get('REQUIRE_EMAIL_VERIFICATION', 'false').lower() == 'true'
+SMTP_HOST = os.environ.get('SMTP_HOST', '')
+SMTP_PORT = int(os.environ.get('SMTP_PORT', '587'))
+SMTP_USERNAME = os.environ.get('SMTP_USERNAME', '')
+SMTP_PASSWORD = os.environ.get('SMTP_PASSWORD', '')
+SMTP_USE_TLS = os.environ.get('SMTP_USE_TLS', 'true').lower() == 'true'
+SMTP_USE_SSL = os.environ.get('SMTP_USE_SSL', 'false').lower() == 'true'
+SMTP_FROM_ADDRESS = os.environ.get('SMTP_FROM_ADDRESS', 'noreply@yourdomain.com')
+SMTP_FROM_NAME = os.environ.get('SMTP_FROM_NAME', 'Speakr')
+
+# Create chunking service at module level so it can be imported by processing.py
+# Always initialize the service - the needs_chunking() method will check ENABLE_CHUNKING
+# and return False when appropriate. This allows connectors with hard limits (e.g.,
+# max_duration_seconds) to still enforce chunking even when ENABLE_CHUNKING=false.
+chunking_service = AudioChunkingService(CHUNK_SIZE_MB, CHUNK_OVERLAP_SECONDS)
+
+
+def initialize_config(app):
+    """Initialize application configuration."""
+    app_headers = {
+        "HTTP-Referer": "https://github.com/murtaza-nasir/speakr",
+        "X-Title": "Speakr - AI Audio Transcription",
+        "User-Agent": "Speakr/1.0 (https://github.com/murtaza-nasir/speakr)"
+    }
+
+    http_client_no_proxy = httpx.Client(verify=True, headers=app_headers)
+
+    client = None
+    try:
+        api_key = TEXT_MODEL_API_KEY or "not-needed"
+        from src.services.llm import llm_timeout, LLM_MAX_RETRIES
+        client = OpenAI(api_key=api_key, base_url=TEXT_MODEL_BASE_URL, http_client=http_client_no_proxy, timeout=llm_timeout, max_retries=LLM_MAX_RETRIES)
+        app.logger.info(f"LLM client initialized: {TEXT_MODEL_BASE_URL} / {TEXT_MODEL_NAME}")
+    except Exception as e:
+        app.logger.error(f"Failed to initialize LLM client: {e}")
+
+    # Use module-level chunking_service (already created above)
+    version = get_version()
+
+    app.logger.info(f"=== Speakr {version} Starting Up ===")
+
+    # Initialize transcription connector
+    if USE_NEW_TRANSCRIPTION_ARCHITECTURE:
+        try:
+            from src.services.transcription import get_registry
+            registry = get_registry()
+            connector = registry.initialize_from_env()
+            connector_name = registry.get_active_connector_name()
+            capabilities = [c.name for c in connector.get_capabilities()]
+            app.logger.info(f"Transcription connector initialized: {connector_name}")
+            app.logger.info(f"Connector capabilities: {capabilities}")
+
+            # Log diarization support prominently
+            diarize_default = getattr(connector, 'default_diarize', connector.supports_diarization)
+            if not connector.supports_diarization:
+                app.logger.info("Speaker diarization: NOT AVAILABLE (connector does not support it)")
+            elif not diarize_default:
+                app.logger.info("Speaker diarization: DISABLED (ASR_DIARIZE=false)")
+            else:
+                app.logger.info("Speaker diarization: ENABLED")
+
+        except Exception as e:
+            app.logger.error(f"Failed to initialize transcription connector: {e}")
+            app.logger.error("Falling back to legacy transcription configuration validation")
+            # Fall through to legacy validation
+            _validate_legacy_transcription_config(app)
+    else:
+        # Legacy configuration validation
+        _validate_legacy_transcription_config(app)
+
+    return client, chunking_service, version
+
+
+def _validate_legacy_transcription_config(app):
+    """Validate legacy transcription configuration (backwards compatibility)."""
+    if USE_ASR_ENDPOINT:
+        if not ASR_BASE_URL:
+            app.logger.error("ERROR: ASR enabled but ASR_BASE_URL not configured!")
+            sys.exit(1)
+        app.logger.info(f"Using ASR endpoint: {ASR_BASE_URL}")
+    else:
+        if not transcription_base_url or not transcription_api_key:
+            app.logger.error("ERROR: No transcription service configured!")
+            sys.exit(1)
+        app.logger.info(f"Using Whisper API: {transcription_base_url}")
diff --git a/src/config/startup.py b/src/config/startup.py
new file mode 100644
index 00000000..2d4f0724
--- /dev/null
+++ b/src/config/startup.py
@@ -0,0 +1,158 @@
+"""
+Application startup functions.
+"""
+
+import os
+import time
+import threading
+from datetime import datetime, timedelta
+from flask import current_app
+
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+GLOBAL_RETENTION_DAYS = int(os.environ.get('GLOBAL_RETENTION_DAYS', '0'))
+
+
+def initialize_file_monitor(app):
+    """Initialize file monitor after app is fully loaded to avoid circular imports."""
+    try:
+        # Import here to avoid circular imports
+        import src.file_monitor as file_monitor
+        file_monitor.start_file_monitor()
+        app.logger.info("File monitor initialization completed")
+    except Exception as e:
+        app.logger.warning(f"File monitor initialization failed: {e}")
+
+def get_file_monitor_functions(app):
+    """Get file monitor functions, handling import errors gracefully."""
+    try:
+        import src.file_monitor as file_monitor
+        return file_monitor.start_file_monitor, file_monitor.stop_file_monitor, file_monitor.get_file_monitor_status
+    except ImportError as e:
+        app.logger.warning(f"File monitor not available: {e}")
+
+        # Create stub functions if file_monitor is not available
+        def start_file_monitor():
+            pass
+        def stop_file_monitor():
+            pass
+        def get_file_monitor_status():
+            return {'running': False, 'error': 'File monitor module not available'}
+
+        return start_file_monitor, stop_file_monitor, get_file_monitor_status
+
+# --- Auto-Processing API Endpoints ---
+def initialize_auto_deletion_scheduler(app):
+    """Initialize the daily auto-deletion scheduler if enabled."""
+    from src.services.retention import process_auto_deletion
+
+    if not ENABLE_AUTO_DELETION:
+        app.logger.info("Auto-deletion scheduler not started (ENABLE_AUTO_DELETION=false)")
+        return
+
+    if GLOBAL_RETENTION_DAYS <= 0:
+        app.logger.info("Auto-deletion scheduler not started (GLOBAL_RETENTION_DAYS not set)")
+        return
+
+    def run_daily_deletion():
+        """Background thread that runs auto-deletion daily at 2 AM."""
+        import time
+        from datetime import datetime, timedelta
+
+        app.logger.info("Auto-deletion scheduler started - will run daily at 2:00 AM")
+
+        while True:
+            try:
+                # Calculate time until next 2 AM
+                now = datetime.now()
+                next_run = now.replace(hour=2, minute=0, second=0, microsecond=0)
+
+                # If it's past 2 AM today, schedule for tomorrow
+                if now.hour >= 2:
+                    next_run += timedelta(days=1)
+
+                sleep_seconds = (next_run - now).total_seconds()
+
+                app.logger.info(f"Next auto-deletion scheduled for: {next_run.strftime('%Y-%m-%d %H:%M:%S')} (in {sleep_seconds/3600:.1f} hours)")
+
+                # Sleep until next run time
+                time.sleep(sleep_seconds)
+
+                # Run auto-deletion
+                app.logger.info("Running scheduled auto-deletion...")
+                with app.app_context():
+                    stats = process_auto_deletion()
+                    app.logger.info(f"Scheduled auto-deletion completed: {stats}")
+
+            except Exception as e:
+                app.logger.error(f"Error in auto-deletion scheduler: {e}", exc_info=True)
+                # Sleep for 1 hour before retrying on error
+                time.sleep(3600)
+
+    # Start the scheduler thread
+    import threading
+    scheduler_thread = threading.Thread(target=run_daily_deletion, daemon=True, name="AutoDeletionScheduler")
+    scheduler_thread.start()
+    app.logger.info("✅ Auto-deletion scheduler initialized - running daily at 2:00 AM")
+
+
+def initialize_file_exporter(app):
+    """Initialize file exporter after app is fully loaded."""
+    try:
+        from src.file_exporter import initialize_export_directory, ENABLE_AUTO_EXPORT
+        if ENABLE_AUTO_EXPORT:
+            initialize_export_directory()
+            app.logger.info("✅ Auto-export initialized")
+        else:
+            app.logger.info("ℹ️  Auto-export: Disabled (set ENABLE_AUTO_EXPORT=true to enable)")
+    except Exception as e:
+        app.logger.warning(f"File exporter initialization failed: {e}")
+
+
+def initialize_job_queue(app):
+    """Initialize and start the background job queue with orphan recovery."""
+    try:
+        from src.services.job_queue import job_queue
+
+        # Initialize job queue with app context
+        job_queue.init_app(app)
+
+        # Recover any jobs that were processing when the app crashed
+        job_queue.recover_orphaned_jobs()
+
+        # Start worker threads
+        job_queue.start()
+
+        # Get queue status
+        status = job_queue.get_queue_status()
+        t_queue = status['transcription_queue']
+        s_queue = status['summary_queue']
+        app.logger.info(
+            f"Job queues started: "
+            f"transcription ({t_queue['workers']} workers, {t_queue['queued']} queued), "
+            f"summary ({s_queue['workers']} workers, {s_queue['queued']} queued)"
+        )
+    except Exception as e:
+        app.logger.error(f"Failed to start job queue: {e}", exc_info=True)
+
+
+def run_startup_tasks(app):
+    """Run all startup tasks that need to happen after app creation."""
+    from src.models import SystemSetting
+
+    with app.app_context():
+        # Set dynamic MAX_CONTENT_LENGTH based on database setting
+        max_file_size_mb = SystemSetting.get_setting('max_file_size_mb', 250)
+        app.config['MAX_CONTENT_LENGTH'] = max_file_size_mb * 1024 * 1024
+        app.logger.info(f"Set MAX_CONTENT_LENGTH to {max_file_size_mb}MB from database setting")
+
+        # Initialize job queue for background processing
+        initialize_job_queue(app)
+
+        # Initialize file monitor after app setup
+        initialize_file_monitor(app)
+
+        # Initialize file exporter
+        initialize_file_exporter(app)
+
+        # Initialize auto-deletion scheduler
+        initialize_auto_deletion_scheduler(app)
diff --git a/src/config/version.py b/src/config/version.py
new file mode 100644
index 00000000..19d66bea
--- /dev/null
+++ b/src/config/version.py
@@ -0,0 +1,29 @@
+"""
+Version information helper.
+"""
+
+import os
+
+
+
+def get_version():
+    # Try reading VERSION file first (works in Docker)
+    try:
+        with open('VERSION', 'r') as f:
+            return f.read().strip()
+    except FileNotFoundError:
+        pass
+    
+    # Fall back to git tags (works in development)
+    try:
+        import subprocess
+        return subprocess.check_output(['git', 'describe', '--tags', '--abbrev=0'], 
+                                     stderr=subprocess.DEVNULL).decode().strip()
+    except:
+        pass
+    
+    # Final fallback
+    return "unknown"
+
+
+
diff --git a/src/database.py b/src/database.py
new file mode 100644
index 00000000..2b146975
--- /dev/null
+++ b/src/database.py
@@ -0,0 +1,12 @@
+"""
+Database initialization module.
+
+This module creates and exports the SQLAlchemy database instance
+that is used across all models.
+"""
+
+from flask_sqlalchemy import SQLAlchemy
+
+# Create the SQLAlchemy database instance
+# This will be initialized with the Flask app using db.init_app(app)
+db = SQLAlchemy()
diff --git a/src/file_exporter.py b/src/file_exporter.py
new file mode 100644
index 00000000..deff627a
--- /dev/null
+++ b/src/file_exporter.py
@@ -0,0 +1,555 @@
+#!/usr/bin/env python3
+"""
+File Exporter for Automated Recording Export
+
+Exports transcriptions and summaries as markdown files to a configured directory.
+Supports per-user subdirectories based on username.
+Supports customizable export templates with localized labels.
+"""
+
+import os
+import re
+import json
+import logging
+from datetime import datetime, timedelta
+from pathlib import Path
+from werkzeug.utils import secure_filename
+
+# Configuration from environment
+ENABLE_AUTO_EXPORT = os.environ.get('ENABLE_AUTO_EXPORT', 'false').lower() == 'true'
+AUTO_EXPORT_DIR = os.environ.get('AUTO_EXPORT_DIR', '/data/exports')
+AUTO_EXPORT_TRANSCRIPTION = os.environ.get('AUTO_EXPORT_TRANSCRIPTION', 'true').lower() == 'true'
+AUTO_EXPORT_SUMMARY = os.environ.get('AUTO_EXPORT_SUMMARY', 'true').lower() == 'true'
+
+# Setup logging
+logger = logging.getLogger('file_exporter')
+logger.setLevel(logging.INFO)
+
+
+def format_transcription_with_template(transcription_text, user):
+    """
+    Format transcription using the user's default template.
+
+    Args:
+        transcription_text: Raw transcription (JSON or plain text)
+        user: User object to get template from
+
+    Returns:
+        Formatted transcription string
+    """
+    # Import here to avoid circular imports
+    from src.models import TranscriptTemplate
+
+    # Try to parse as JSON
+    try:
+        transcription_data = json.loads(transcription_text)
+        if not isinstance(transcription_data, list):
+            # Not our expected format, return as-is
+            return transcription_text
+    except (json.JSONDecodeError, TypeError):
+        # Not JSON, return as-is
+        return transcription_text
+
+    # Get user's default template
+    template = TranscriptTemplate.query.filter_by(
+        user_id=user.id,
+        is_default=True
+    ).first()
+
+    # Default format if no template set
+    if not template:
+        template_format = "[{{speaker}}]: {{text}}"
+    else:
+        template_format = template.template
+
+    # Helper functions for formatting
+    def format_time(seconds):
+        """Format seconds to HH:MM:SS"""
+        if seconds is None:
+            return "00:00:00"
+        td = timedelta(seconds=seconds)
+        hours = int(td.total_seconds() // 3600)
+        minutes = int((td.total_seconds() % 3600) // 60)
+        secs = int(td.total_seconds() % 60)
+        return f"{hours:02d}:{minutes:02d}:{secs:02d}"
+
+    def format_srt_time(seconds):
+        """Format seconds to SRT format HH:MM:SS,mmm"""
+        if seconds is None:
+            return "00:00:00,000"
+        td = timedelta(seconds=seconds)
+        hours = int(td.total_seconds() // 3600)
+        minutes = int((td.total_seconds() % 3600) // 60)
+        secs = int(td.total_seconds() % 60)
+        millis = int((td.total_seconds() % 1) * 1000)
+        return f"{hours:02d}:{minutes:02d}:{secs:02d},{millis:03d}"
+
+    # Generate formatted transcript
+    output_lines = []
+    for index, segment in enumerate(transcription_data, 1):
+        line = template_format
+
+        # Replace variables
+        replacements = {
+            '{{index}}': str(index),
+            '{{speaker}}': segment.get('speaker', 'Unknown'),
+            '{{text}}': segment.get('sentence', ''),
+            '{{start_time}}': format_time(segment.get('start_time')),
+            '{{end_time}}': format_time(segment.get('end_time')),
+        }
+
+        for key, value in replacements.items():
+            line = line.replace(key, value)
+
+        # Handle filters
+        # Upper case filter
+        line = re.sub(r'{{(.*?)\|upper}}', lambda m: replacements.get('{{' + m.group(1) + '}}', '').upper(), line)
+        # SRT time filter
+        line = re.sub(r'{{start_time\|srt}}', format_srt_time(segment.get('start_time')), line)
+        line = re.sub(r'{{end_time\|srt}}', format_srt_time(segment.get('end_time')), line)
+
+        output_lines.append(line)
+
+    return '\n'.join(output_lines)
+
+
+def get_export_directory(user):
+    """Get the export directory for a user, creating if needed."""
+    base_dir = Path(AUTO_EXPORT_DIR)
+
+    # Create per-user subdirectory based on username
+    user_dir = base_dir / secure_filename(user.username)
+    user_dir.mkdir(parents=True, exist_ok=True)
+
+    return user_dir
+
+
+def generate_safe_filename(recording):
+    """Generate a safe filename for the export based on recording ID only."""
+    # Use only recording ID for consistent filename that doesn't change
+    return f"recording_{recording.id}"
+
+
+def get_export_filepath(user, recording):
+    """Get the full export filepath for a recording."""
+    export_dir = get_export_directory(user)
+    filename = generate_safe_filename(recording)
+    return export_dir / f"{filename}.md"
+
+
+def mark_export_as_deleted(recording_id):
+    """
+    Rename the export file to indicate the recording was deleted.
+
+    Args:
+        recording_id: ID of the deleted recording
+
+    Returns:
+        New filepath if renamed, None otherwise
+    """
+    if not ENABLE_AUTO_EXPORT:
+        return None
+
+    # Import here to avoid circular imports
+    from src.app import app, db
+    from src.models import Recording, User
+
+    with app.app_context():
+        try:
+            # We need to find the file - check all user directories
+            base_dir = Path(AUTO_EXPORT_DIR)
+            if not base_dir.exists():
+                return None
+
+            # Look for the file in all user subdirectories
+            for user_dir in base_dir.iterdir():
+                if user_dir.is_dir():
+                    old_filepath = user_dir / f"recording_{recording_id}.md"
+                    if old_filepath.exists():
+                        new_filepath = user_dir / f"[deleted]_recording_{recording_id}.md"
+                        old_filepath.rename(new_filepath)
+                        logger.info(f"Marked export as deleted: {new_filepath}")
+                        return str(new_filepath)
+
+            return None
+
+        except Exception as e:
+            logger.error(f"Failed to mark export as deleted for recording {recording_id}: {e}")
+            return None
+
+
+def format_duration(seconds):
+    """Format duration in seconds to human-readable string."""
+    if not seconds:
+        return ""
+
+    hours = seconds // 3600
+    minutes = (seconds % 3600) // 60
+    secs = seconds % 60
+
+    if hours > 0:
+        return f"{hours}h {minutes}m {secs}s"
+    elif minutes > 0:
+        return f"{minutes}m {secs}s"
+    else:
+        return f"{secs}s"
+
+
+def format_file_size(bytes_size):
+    """Format file size in bytes to human-readable string."""
+    if not bytes_size:
+        return ""
+
+    for unit in ['B', 'KB', 'MB', 'GB']:
+        if bytes_size < 1024:
+            return f"{bytes_size:.1f} {unit}"
+        bytes_size /= 1024
+    return f"{bytes_size:.1f} TB"
+
+
+def get_user_export_template(user, recording=None):
+    """
+    Get the export template to use for a recording.
+
+    Resolution order:
+    1. Folder's export_template_id (if recording is in a folder)
+    2. Tag's export_template_id (first matching tag with an export template)
+    3. User's default export template (is_default=True)
+
+    Args:
+        user: User object
+        recording: Optional Recording object (for folder/tag lookup)
+
+    Returns:
+        ExportTemplate object or None
+    """
+    from src.models import ExportTemplate
+
+    # 1. Check folder's export template
+    if recording and recording.folder and recording.folder.export_template_id:
+        template = ExportTemplate.query.get(recording.folder.export_template_id)
+        if template:
+            return template
+
+    # 2. Check tags' export templates
+    if recording and recording.tags:
+        for tag in recording.tags:
+            if tag.export_template_id:
+                template = ExportTemplate.query.get(tag.export_template_id)
+                if template:
+                    return template
+
+    # 3. Fall back to user's default
+    return ExportTemplate.query.filter_by(
+        user_id=user.id,
+        is_default=True
+    ).first()
+
+
+def render_export_template(template_str, context, labels):
+    """
+    Render an export template with variable substitution and conditionals.
+
+    Args:
+        template_str: Template string with {{variables}} and {{#if var}}...{{/if}} blocks
+        context: Dictionary of variable values
+        labels: Dictionary of localized labels
+
+    Returns:
+        Rendered string
+    """
+    result = template_str
+
+    # Process conditionals first: {{#if variable}}content{{/if}}
+    def replace_conditional(match):
+        var_name = match.group(1)
+        content = match.group(2)
+        # Check if the variable exists and is truthy
+        value = context.get(var_name, '')
+        if value:
+            return content
+        return ''
+
+    # Match {{#if var}}...{{/if}} blocks (non-greedy)
+    conditional_pattern = r'\{\{#if\s+(\w+)\}\}(.*?)\{\{/if\}\}'
+    result = re.sub(conditional_pattern, replace_conditional, result, flags=re.DOTALL)
+
+    # Replace label variables: {{label.key}}
+    def replace_label(match):
+        key = match.group(1)
+        return labels.get(key, key)
+
+    result = re.sub(r'\{\{label\.(\w+)\}\}', replace_label, result)
+
+    # Replace context variables: {{variable}}
+    for key, value in context.items():
+        placeholder = '{{' + key + '}}'
+        result = result.replace(placeholder, str(value) if value else '')
+
+    return result
+
+
+def generate_markdown_content(recording, user, include_transcription=True, include_summary=True):
+    """Generate markdown content for a recording export.
+
+    Args:
+        recording: Recording object to export
+        user: User object for getting template preferences
+        include_transcription: Whether to include transcription
+        include_summary: Whether to include summary
+    """
+    from src.utils.localization import get_export_labels, format_date_localized, format_datetime_localized
+
+    # Get user's language preference (default to English)
+    user_language = getattr(user, 'ui_language', 'en') or 'en'
+
+    # Get localized labels
+    labels = get_export_labels(user_language)
+
+    # Get export template (checks folder, tags, then user default)
+    export_template = get_user_export_template(user, recording)
+
+    if export_template:
+        # Use custom template
+        return generate_from_template(
+            recording, user, export_template.template, labels, user_language,
+            include_transcription, include_summary
+        )
+    else:
+        # Use default (backwards compatible) behavior
+        return generate_default_markdown(
+            recording, user, labels, user_language,
+            include_transcription, include_summary
+        )
+
+
+def generate_from_template(recording, user, template_str, labels, user_language,
+                           include_transcription=True, include_summary=True):
+    """
+    Generate markdown content using a custom template.
+
+    Args:
+        recording: Recording object
+        user: User object
+        template_str: Template string
+        labels: Localized labels dictionary
+        user_language: User's language code
+        include_transcription: Whether to include transcription
+        include_summary: Whether to include summary
+
+    Returns:
+        Rendered markdown string
+    """
+    from src.utils.localization import format_date_localized, format_datetime_localized
+
+    # Build context with all available variables
+    context = {
+        'title': recording.title or f"Recording {recording.id}",
+        'meeting_date': format_date_localized(recording.meeting_date, user_language) if recording.meeting_date else '',
+        'created_at': format_datetime_localized(recording.created_at, user_language) if recording.created_at else '',
+        'original_filename': recording.original_filename or '',
+        'file_size': format_file_size(recording.file_size) if recording.file_size else '',
+        'participants': recording.participants or '',
+        'tags': ', '.join([tag.name for tag in recording.tags]) if recording.tags else '',
+        'transcription_duration': format_duration(recording.transcription_duration_seconds) if recording.transcription_duration_seconds else '',
+        'summarization_duration': format_duration(recording.summarization_duration_seconds) if recording.summarization_duration_seconds else '',
+        'notes': recording.notes or '' if include_summary else '',  # Notes included with summary setting
+        'summary': recording.summary or '' if include_summary else '',
+        'transcription': '',  # Will be set below
+    }
+
+    # Format transcription if included
+    if include_transcription and recording.transcription:
+        context['transcription'] = format_transcription_with_template(recording.transcription, user)
+
+    # Render template
+    rendered = render_export_template(template_str, context, labels)
+
+    # Always append hardcoded footer
+    footer = labels.get('footer', 'Generated with [Speakr](https://github.com/learnedmachine/speakr)')
+    rendered += f"\n\n---\n\n*{footer}*\n"
+
+    return rendered
+
+
+def generate_default_markdown(recording, user, labels, user_language,
+                              include_transcription=True, include_summary=True):
+    """
+    Generate markdown using the default (backwards compatible) format.
+
+    Args:
+        recording: Recording object
+        user: User object
+        labels: Localized labels dictionary
+        user_language: User's language code
+        include_transcription: Whether to include transcription
+        include_summary: Whether to include summary
+
+    Returns:
+        Rendered markdown string
+    """
+    from src.utils.localization import format_date_localized, format_datetime_localized
+
+    lines = []
+
+    # Header with title
+    title = recording.title or f"Recording {recording.id}"
+    lines.append(f"# {title}")
+    lines.append("")
+
+    # Metadata section
+    lines.append(f"## {labels.get('metadata', 'Metadata')}")
+    lines.append("")
+
+    if recording.meeting_date:
+        date_str = format_date_localized(recording.meeting_date, user_language)
+        lines.append(f"- **{labels.get('date', 'Date')}:** {date_str}")
+
+    if recording.created_at:
+        created_str = format_datetime_localized(recording.created_at, user_language)
+        lines.append(f"- **{labels.get('created', 'Created')}:** {created_str}")
+
+    if recording.original_filename:
+        lines.append(f"- **{labels.get('originalFile', 'Original File')}:** {recording.original_filename}")
+
+    if recording.file_size:
+        lines.append(f"- **{labels.get('fileSize', 'File Size')}:** {format_file_size(recording.file_size)}")
+
+    if recording.participants:
+        lines.append(f"- **{labels.get('participants', 'Participants')}:** {recording.participants}")
+
+    if recording.tags:
+        tag_names = [tag.name for tag in recording.tags]
+        lines.append(f"- **{labels.get('tags', 'Tags')}:** {', '.join(tag_names)}")
+
+    if recording.transcription_duration_seconds:
+        lines.append(f"- **{labels.get('transcriptionTime', 'Transcription Time')}:** {format_duration(recording.transcription_duration_seconds)}")
+
+    if recording.summarization_duration_seconds:
+        lines.append(f"- **{labels.get('summarizationTime', 'Summarization Time')}:** {format_duration(recording.summarization_duration_seconds)}")
+
+    lines.append("")
+
+    # Notes section (if available)
+    if recording.notes:
+        lines.append(f"## {labels.get('notes', 'Notes')}")
+        lines.append("")
+        lines.append(recording.notes)
+        lines.append("")
+
+    # Summary section
+    if include_summary and recording.summary:
+        lines.append(f"## {labels.get('summary', 'Summary')}")
+        lines.append("")
+        lines.append(recording.summary)
+        lines.append("")
+
+    # Transcription section
+    if include_transcription and recording.transcription:
+        lines.append(f"## {labels.get('transcription', 'Transcription')}")
+        lines.append("")
+        # Format transcription using user's template
+        formatted_transcription = format_transcription_with_template(recording.transcription, user)
+        lines.append(formatted_transcription)
+        lines.append("")
+
+    # Footer
+    lines.append("---")
+    lines.append("")
+    footer = labels.get('footer', 'Generated with [Speakr](https://github.com/learnedmachine/speakr)')
+    lines.append(f"*{footer}*")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+def export_recording(recording_id):
+    """
+    Export a recording to markdown file.
+
+    Args:
+        recording_id: ID of the recording to export
+
+    Returns:
+        Path to the exported file, or None if export failed/disabled
+    """
+    if not ENABLE_AUTO_EXPORT:
+        return None
+
+    # Check if we should export anything
+    if not AUTO_EXPORT_TRANSCRIPTION and not AUTO_EXPORT_SUMMARY:
+        logger.warning("Auto-export is enabled but both transcription and summary export are disabled")
+        return None
+
+    # Import here to avoid circular imports
+    from src.app import app, db
+    from src.models import Recording, User
+
+    with app.app_context():
+        try:
+            recording = db.session.get(Recording, recording_id)
+            if not recording:
+                logger.error(f"Recording {recording_id} not found for export")
+                return None
+
+            # Get the owner
+            user = db.session.get(User, recording.user_id)
+            if not user:
+                logger.error(f"User not found for recording {recording_id}")
+                return None
+
+            # Check if we have content to export
+            has_transcription = bool(recording.transcription) and AUTO_EXPORT_TRANSCRIPTION
+            has_summary = bool(recording.summary) and AUTO_EXPORT_SUMMARY
+
+            if not has_transcription and not has_summary:
+                logger.debug(f"Recording {recording_id} has no content to export")
+                return None
+
+            # Get export directory for user
+            export_dir = get_export_directory(user)
+
+            # Generate filename and path
+            filename = generate_safe_filename(recording)
+            filepath = export_dir / f"{filename}.md"
+
+            # Generate content
+            content = generate_markdown_content(
+                recording,
+                user,
+                include_transcription=AUTO_EXPORT_TRANSCRIPTION,
+                include_summary=AUTO_EXPORT_SUMMARY
+            )
+
+            # Write to file (overwrites if exists)
+            filepath.write_text(content, encoding='utf-8')
+
+            logger.info(f"Exported recording {recording_id} to {filepath}")
+            return str(filepath)
+
+        except Exception as e:
+            logger.error(f"Failed to export recording {recording_id}: {e}")
+            return None
+
+
+def initialize_export_directory():
+    """Initialize the export directory on startup."""
+    if not ENABLE_AUTO_EXPORT:
+        return
+
+    try:
+        export_dir = Path(AUTO_EXPORT_DIR)
+        export_dir.mkdir(parents=True, exist_ok=True)
+        logger.info(f"Auto-export enabled, directory: {AUTO_EXPORT_DIR}")
+
+        if AUTO_EXPORT_TRANSCRIPTION and AUTO_EXPORT_SUMMARY:
+            logger.info("Exporting: transcription and summary")
+        elif AUTO_EXPORT_TRANSCRIPTION:
+            logger.info("Exporting: transcription only")
+        elif AUTO_EXPORT_SUMMARY:
+            logger.info("Exporting: summary only")
+        else:
+            logger.warning("Auto-export enabled but no content types selected")
+
+    except Exception as e:
+        logger.error(f"Failed to initialize export directory: {e}")
diff --git a/src/file_monitor.py b/src/file_monitor.py
new file mode 100644
index 00000000..2ca5b8be
--- /dev/null
+++ b/src/file_monitor.py
@@ -0,0 +1,606 @@
+#!/usr/bin/env python3
+"""
+File Monitor for Automated Audio Processing
+Monitors directories for new audio files and automatically processes them.
+Supports multiple user modes:
+1. Admin-only: Files go to admin user only
+2. User-specific directories: Each user has their own folder (e.g., /auto-process/user123/)
+3. Single default user: All files go to one specified user
+"""
+
+import os
+import time
+import threading
+import logging
+from datetime import datetime
+from pathlib import Path
+import mimetypes
+from werkzeug.utils import secure_filename
+from src.utils.ffprobe import get_codec_info, get_creation_date, FFProbeError
+from src.utils.ffmpeg_utils import FFmpegError, FFmpegNotFoundError
+from src.utils.audio_conversion import convert_if_needed
+
+# Video retention - when enabled, video files keep their video stream for playback
+VIDEO_RETENTION = os.environ.get('VIDEO_RETENTION', 'false').lower() == 'true'
+
+# Video passthrough - send original video files directly to ASR without extracting audio
+VIDEO_PASSTHROUGH_ASR = os.environ.get('VIDEO_PASSTHROUGH_ASR', 'false').lower() == 'true'
+
+# Flask app components will be imported inside functions to avoid circular imports
+
+class FileMonitor:
+    def __init__(self, base_watch_directory, check_interval=30, mode='admin_only'):
+        """
+        Initialize the file monitor.
+        
+        Args:
+            base_watch_directory (str): Base directory to monitor for new files
+            check_interval (int): How often to check for new files (seconds)
+            mode (str): Processing mode - 'admin_only', 'user_directories', or 'single_user'
+        """
+        self.base_watch_directory = Path(base_watch_directory)
+        self.check_interval = check_interval
+        self.mode = mode
+        self.running = False
+        self.thread = None
+        
+        # Ensure base directory exists
+        self.base_watch_directory.mkdir(parents=True, exist_ok=True)
+        
+        # Setup logging
+        self.logger = logging.getLogger('file_monitor')
+        self.logger.setLevel(logging.INFO)
+        
+        # Supported audio file extensions
+        # We'll use ffprobe to detect audio files instead of extensions
+        # Keep a basic list for initial filtering to avoid probing every file
+        self.potential_audio_extensions = {
+            '.wav', '.mp3', '.flac', '.amr', '.3gp', '.3gpp', 
+            '.m4a', '.aac', '.ogg', '.wma', '.webm', '.mp4', '.mov',
+            '.opus', '.caf', '.aiff', '.ts', '.mts', '.mkv', '.avi',
+            '.m4v', '.wmv', '.flv', '.mpeg', '.mpg', '.ogv', '.vob', '.asf'
+        }
+        
+        # Cache for admin user and valid users
+        self._admin_user_id = None
+        self._valid_users = {}  # Maps user_id to username
+        self._username_to_id = {}  # Maps username to user_id
+        self._last_user_cache_update = 0
+        
+    def start(self):
+        """Start the file monitoring in a background thread."""
+        if self.running:
+            self.logger.warning("File monitor is already running")
+            return
+            
+        self.running = True
+        self.thread = threading.Thread(target=self._monitor_loop, daemon=True)
+        self.thread.start()
+        self.logger.info(f"File monitor started in '{self.mode}' mode, watching: {self.base_watch_directory}")
+        
+    def stop(self):
+        """Stop the file monitoring."""
+        self.running = False
+        if self.thread:
+            self.thread.join(timeout=5)
+        self.logger.info("File monitor stopped")
+        
+    def _update_user_cache(self):
+        """Update the cache of valid users and admin user."""
+        current_time = time.time()
+        # Update cache every 5 minutes
+        if current_time - self._last_user_cache_update < 300:
+            return
+        
+        # Import Flask components inside function to avoid circular imports
+        from src.app import app, db, User
+            
+        with app.app_context():
+            try:
+                # Find admin user
+                admin_user = User.query.filter_by(is_admin=True).first()
+                self._admin_user_id = admin_user.id if admin_user else None
+                
+                # Cache all valid users
+                users = User.query.all()
+                self._valid_users = {user.id: user.username for user in users}
+                self._username_to_id = {user.username: user.id for user in users}
+                
+                self._last_user_cache_update = current_time
+                self.logger.debug(f"Updated user cache: {len(self._valid_users)} users, admin: {self._admin_user_id}")
+                
+            except Exception as e:
+                self.logger.error(f"Error updating user cache: {e}")
+        
+    def _monitor_loop(self):
+        """Main monitoring loop."""
+        while self.running:
+            try:
+                self._update_user_cache()
+                
+                if self.mode == 'admin_only':
+                    self._scan_admin_directory()
+                elif self.mode == 'user_directories':
+                    self._scan_user_directories()
+                elif self.mode == 'single_user':
+                    self._scan_single_user_directory()
+                    
+            except Exception as e:
+                self.logger.error(f"Error during directory scan: {e}", exc_info=True)
+            
+            # Wait for next check
+            time.sleep(self.check_interval)
+            
+    def _scan_admin_directory(self):
+        """Scan the main directory for files to process as admin user."""
+        if not self._admin_user_id:
+            self.logger.warning("No admin user found, skipping admin directory scan")
+            return
+
+        self._scan_directory_for_user(self.base_watch_directory, self._admin_user_id)
+        self._scan_tag_subdirectories(self.base_watch_directory, self._admin_user_id)
+
+    def _scan_user_directories(self):
+        """Scan user-specific subdirectories."""
+        if not self.base_watch_directory.exists():
+            return
+
+        # Look for user directories (e.g., user123, user456)
+        for item in self.base_watch_directory.iterdir():
+            if not item.is_dir():
+                continue
+
+            # Extract user ID from directory name
+            user_id = self._extract_user_id_from_dirname(item.name)
+            if user_id and user_id in self._valid_users:
+                self._scan_directory_for_user(item, user_id)
+                self._scan_tag_subdirectories(item, user_id)
+            elif item.name.startswith('user'):
+                self.logger.warning(f"Found user directory '{item.name}' but user ID {user_id} is not valid")
+
+    def _scan_single_user_directory(self):
+        """Scan directory for a single configured user."""
+        default_username = os.environ.get('AUTO_PROCESS_DEFAULT_USERNAME')
+        if not default_username:
+            self.logger.warning("AUTO_PROCESS_DEFAULT_USERNAME not configured for single_user mode")
+            return
+
+        user_id = self._username_to_id.get(default_username)
+        if user_id:
+            self._scan_directory_for_user(self.base_watch_directory, user_id)
+            self._scan_tag_subdirectories(self.base_watch_directory, user_id)
+        else:
+            self.logger.warning(f"Configured default username '{default_username}' is not valid")
+
+    def _scan_tag_subdirectories(self, directory, user_id):
+        """Scan subdirectories that match auto-process tag folders."""
+        if not directory.exists():
+            return
+
+        from src.app import app
+        from src.models import Tag
+
+        with app.app_context():
+            for item in directory.iterdir():
+                if not item.is_dir():
+                    continue
+
+                # Skip hidden dirs and user directories (e.g., user123)
+                if item.name.startswith('.') or self._extract_user_id_from_dirname(item.name) is not None:
+                    continue
+
+                # Look up matching auto-process tag
+                tag = Tag.query.filter_by(
+                    user_id=user_id,
+                    is_auto_process=True,
+                    auto_process_folder_name=item.name
+                ).first()
+
+                if tag:
+                    self._scan_directory_for_user(item, user_id, tag_id=tag.id)
+            
+    def _scan_directory_for_user(self, directory, user_id, tag_id=None):
+        """Scan a specific directory for files to process for a specific user."""
+        if not directory.exists():
+            return
+
+        for file_path in directory.iterdir():
+            if not file_path.is_file():
+                continue
+
+            # Skip hidden files, processing files, or non-supported files
+            if file_path.name.startswith('.') or file_path.suffix == '.processing':
+                continue
+
+            if file_path.suffix.lower() not in self.potential_audio_extensions:
+                continue
+
+            # Check if file is still being written (size stability check)
+            stability_time = int(os.environ.get('AUTO_PROCESS_STABILITY_TIME', '5'))
+            try:
+                if not self._is_file_stable(file_path, stability_time):
+                    continue
+            except FileNotFoundError:
+                # File might have been picked up by another worker after iterdir()
+                continue
+
+            self.logger.info(f"Found potential audio file for user {user_id}: {file_path}")
+
+            # --- Atomic Lock via Rename ---
+            processing_path = file_path.with_suffix(file_path.suffix + '.processing')
+
+            try:
+                file_path.rename(processing_path)
+                self.logger.info(f"Acquired lock for {file_path}, renamed to {processing_path}")
+            except FileNotFoundError:
+                self.logger.debug(f"Could not acquire lock for {file_path}, already processed by another worker.")
+                continue
+            except Exception as e:
+                self.logger.error(f"Error acquiring lock for {file_path}: {e}")
+                continue
+
+            # --- Process the locked file ---
+            try:
+                self._process_file(processing_path, user_id, tag_id=tag_id)
+            except Exception as e:
+                self.logger.error(f"Error processing file {processing_path}: {e}", exc_info=True)
+                # If processing fails, unlock the file by renaming it back
+                try:
+                    original_path = processing_path.with_suffix(processing_path.suffix.replace('.processing', ''))
+                    processing_path.rename(original_path)
+                    self.logger.info(f"Unlocked file {processing_path} back to {original_path} after processing error.")
+                except Exception as rename_err:
+                    self.logger.error(f"CRITICAL: Failed to unlock file {processing_path} after error: {rename_err}")
+                
+    def _extract_user_id_from_dirname(self, dirname):
+        """
+        Extract user ID from directory name.
+        
+        Expected formats: user123, 123
+        
+        Args:
+            dirname (str): Directory name
+            
+        Returns:
+            int or None: User ID if found, None otherwise
+        """
+        import re
+        
+        # Pattern: user123 or just 123
+        patterns = [
+            r'^user(\d+)$',  # user123
+            r'^(\d+)$'       # 123
+        ]
+        
+        for pattern in patterns:
+            match = re.match(pattern, dirname, re.IGNORECASE)
+            if match:
+                try:
+                    return int(match.group(1))
+                except ValueError:
+                    continue
+                    
+        return None
+        
+    def _is_file_stable(self, file_path, stability_time=5):
+        """
+        Check if a file is stable (not being written to).
+        
+        Args:
+            file_path (Path): Path to the file
+            stability_time (int): Time in seconds to wait for size stability
+            
+        Returns:
+            bool: True if file appears stable
+        """
+        try:
+            initial_size = file_path.stat().st_size
+            initial_mtime = file_path.stat().st_mtime
+            
+            # Wait a bit and check again
+            time.sleep(stability_time)
+            
+            current_size = file_path.stat().st_size
+            current_mtime = file_path.stat().st_mtime
+            
+            # File is stable if size and modification time haven't changed
+            return initial_size == current_size and initial_mtime == current_mtime
+            
+        except (OSError, FileNotFoundError):
+            return False
+            
+    def _process_file(self, processing_path, user_id, tag_id=None):
+        """
+        Process a single locked audio file for a specific user.
+
+        Args:
+            processing_path (Path): Path to the locked audio file (e.g., file.mp3.processing)
+            user_id (int): ID of the user to assign the recording to
+            tag_id (int, optional): Tag ID to apply to the recording
+        """
+        # Import Flask components inside function to avoid circular imports
+        from src.app import app, db, Recording, User, transcribe_audio_task
+        
+        with app.app_context():
+            try:
+                # Verify user exists
+                user = db.session.get(User, user_id)
+                if not user:
+                    self.logger.error(f"User ID {user_id} not found in database for file {processing_path}")
+                    # We must raise an exception to trigger the unlock mechanism
+                    raise ValueError(f"User ID {user_id} not found")
+
+                # Derive original filename by removing .processing suffix
+                original_filename = processing_path.name.replace('.processing', '')
+                safe_filename = secure_filename(original_filename)
+                timestamp = datetime.now().strftime('%Y%m%d%H%M%S')
+                new_filename = f"auto_{timestamp}_{safe_filename}"
+                
+                uploads_dir = Path(app.config['UPLOAD_FOLDER'])
+                uploads_dir.mkdir(parents=True, exist_ok=True)
+                destination_path = uploads_dir / new_filename
+                
+                # Copy locked file to uploads directory
+                import shutil
+                shutil.copy(str(processing_path), str(destination_path))
+                self.logger.info(f"Copied {processing_path} to {destination_path}")
+                
+                # Delete the locked file from watch directory after successful copy
+                try:
+                    processing_path.unlink()
+                    self.logger.info(f"Deleted locked file: {processing_path}")
+                except FileNotFoundError:
+                    # This should not happen if the lock is held, but good to log
+                    self.logger.warning(f"Locked file {processing_path} was already deleted.")
+                
+                # Compute file hash on the ORIGINAL file before any conversion/compression.
+                # Lossy re-encoding produces different bytes each run, so hashing after
+                # conversion would miss duplicates.
+                file_hash = None
+                try:
+                    from src.utils.file_hash import compute_file_sha256
+                    file_hash = compute_file_sha256(str(destination_path))
+                except Exception as e:
+                    self.logger.warning(f"Could not compute file hash: {e}")
+
+                # Probe once to get codec info, then pass through pipeline to avoid redundant calls
+                codec_info = None
+                try:
+                    codec_info = get_codec_info(str(destination_path), timeout=10)
+                    self.logger.info(f"Detected codec for {original_filename}: audio_codec={codec_info.get('audio_codec')}, has_video={codec_info.get('has_video', False)}")
+                except FFProbeError as e:
+                    self.logger.warning(f"Failed to probe {original_filename}: {e}. Will attempt conversion.")
+                
+                # Get connector specs for codec restrictions
+                connector_specs = None
+                try:
+                    from src.services.transcription import get_registry
+                    registry = get_registry()
+                    connector = registry.get_active_connector()
+                    if connector:
+                        connector_specs = connector.specifications
+                except Exception as e:
+                    self.logger.warning(f"Could not get connector specs: {e}")
+
+                # Check if this is a video file (for video retention logic)
+                has_video = codec_info.get('has_video', False) if codec_info else False
+
+                # Video passthrough or retention: skip conversion for videos
+                if (VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video:
+                    self.logger.info(f"Video {'passthrough' if VIDEO_PASSTHROUGH_ASR else 'retention'}: keeping original video, skipping conversion")
+                    final_path = destination_path
+                else:
+                    # Convert/compress file if necessary - convert_if_needed handles ALL conversion needs
+                    try:
+                        result = convert_if_needed(
+                            str(destination_path),
+                            original_filename=original_filename,
+                            codec_info=codec_info,
+                            needs_chunking=False,
+                            is_asr_endpoint=False,
+                            delete_original=True,  # Clean up original after conversion
+                            connector_specs=connector_specs  # Pass connector specs for codec restrictions
+                        )
+                        final_path = Path(result.output_path)
+
+                        # Log what happened
+                        if result.was_converted:
+                            self.logger.info(f"File converted: {result.original_codec} -> {result.final_codec}")
+                        if result.was_compressed:
+                            self.logger.info(f"File compressed: {result.size_reduction_percent:.1f}% size reduction")
+
+                    except FFmpegNotFoundError as e:
+                        self.logger.error(f"FFmpeg not found: {e}")
+                        raise
+                    except FFmpegError as e:
+                        self.logger.error(f"FFmpeg conversion failed: {e}")
+                        raise
+
+                # (file_hash already computed above, before conversion)
+
+                # Get file size and MIME type
+                file_size = final_path.stat().st_size
+                mime_type, _ = mimetypes.guess_type(str(final_path))
+
+                # Create database record
+                now = datetime.utcnow()
+
+                # Try to extract creation date from file metadata, fall back to current time
+                meeting_date = get_creation_date(str(final_path))
+                if meeting_date:
+                    self.logger.info(f"Using file metadata creation date: {meeting_date}")
+                else:
+                    meeting_date = now
+                    self.logger.debug("No metadata creation date found, using current time")
+
+                # Check for duplicate
+                if file_hash:
+                    existing = Recording.query.filter_by(user_id=user_id, file_hash=file_hash).first()
+                    if existing:
+                        self.logger.warning(
+                            f"Duplicate file detected for user {user_id}: "
+                            f"hash={file_hash[:12]}... matches recording {existing.id} "
+                            f"({existing.title}). Processing anyway."
+                        )
+
+                recording = Recording(
+                    audio_path=str(final_path),
+                    original_filename=original_filename,
+                    title=f"Auto-processed - {original_filename}",
+                    file_size=file_size,
+                    status='PENDING',
+                    meeting_date=meeting_date,
+                    user_id=user_id,
+                    mime_type=mime_type,
+                    is_inbox=True,  # Auto-processed files go to inbox
+                    processing_source='auto_process',  # Track that this was auto-processed
+                    file_hash=file_hash
+                )
+                
+                db.session.add(recording)
+                db.session.commit()
+
+                self.logger.info(f"Created recording record with ID: {recording.id} for user: {user.username}")
+
+                # Apply tag if specified
+                job_params = {}
+                if tag_id:
+                    from src.models import Tag, RecordingTag
+                    tag = db.session.get(Tag, tag_id)
+                    if tag:
+                        recording_tag = RecordingTag(
+                            recording_id=recording.id,
+                            tag_id=tag_id,
+                            order=0
+                        )
+                        db.session.add(recording_tag)
+                        db.session.commit()
+                        self.logger.info(f"Applied tag '{tag.name}' (id={tag_id}) to recording {recording.id}")
+
+                        # Pass tag settings to job params
+                        if tag.default_hotwords:
+                            job_params['hotwords'] = tag.default_hotwords
+                        if tag.default_initial_prompt:
+                            job_params['initial_prompt'] = tag.default_initial_prompt
+                        if tag.default_language:
+                            job_params['language'] = tag.default_language
+                        if tag.default_min_speakers:
+                            job_params['min_speakers'] = tag.default_min_speakers
+                        if tag.default_max_speakers:
+                            job_params['max_speakers'] = tag.default_max_speakers
+                        if tag.custom_prompt:
+                            job_params['custom_prompt'] = tag.custom_prompt
+                        job_params['tag_id'] = tag_id
+
+                # Queue for background processing
+                from src.services.job_queue import job_queue
+                job_queue.enqueue(
+                    user_id=user.id,
+                    recording_id=recording.id,
+                    job_type='transcribe',
+                    params=job_params,
+                    is_new_upload=True
+                )
+
+                self.logger.info(f"Queued background processing for recording ID: {recording.id}")
+                self.logger.info(f"Successfully processed and moved file from: {processing_path}")
+                    
+            except Exception as e:
+                self.logger.error(f"Error processing file {processing_path} for user {user_id}: {e}", exc_info=True)
+                # Re-raise the exception to be caught by the calling method, which will handle unlocking.
+                raise
+                
+
+
+
+# Global file monitor instance
+file_monitor = None
+
+def start_file_monitor():
+    """Start the file monitor with configuration from environment variables."""
+    global file_monitor
+    
+    if file_monitor and file_monitor.running:
+        return
+    
+    # Import Flask app inside function to avoid circular imports
+    from src.app import app
+        
+    # Get configuration from environment
+    watch_dir = os.environ.get('AUTO_PROCESS_WATCH_DIR', '/data/auto-process')
+    check_interval = int(os.environ.get('AUTO_PROCESS_CHECK_INTERVAL', '30'))
+    mode = os.environ.get('AUTO_PROCESS_MODE', 'admin_only')  # admin_only, user_directories, single_user
+    
+    # Validate mode
+    valid_modes = ['admin_only', 'user_directories', 'single_user']
+    if mode not in valid_modes:
+        app.logger.error(f"Invalid AUTO_PROCESS_MODE: {mode}. Must be one of: {valid_modes}")
+        return
+            
+    # Only start if auto-processing is enabled
+    if os.environ.get('ENABLE_AUTO_PROCESSING', 'false').lower() == 'true':
+        file_monitor = FileMonitor(
+            base_watch_directory=watch_dir,
+            check_interval=check_interval,
+            mode=mode
+        )
+        file_monitor.start()
+        app.logger.info(f"Automated file processing started in '{mode}' mode")
+
+        # Ensure all auto-process tag folders exist
+        _ensure_tag_folders_on_startup(app, watch_dir, mode)
+    else:
+        app.logger.info("Automated file processing is disabled")
+
+
+def _ensure_tag_folders_on_startup(app, watch_dir, mode):
+    """Ensure all auto-process tag folders exist on startup."""
+    with app.app_context():
+        try:
+            from src.database import db
+            from src.models import Tag
+            from src.models.user import User
+            tags = Tag.query.filter_by(is_auto_process=True).all()
+            if not tags:
+                return
+
+            for tag in tags:
+                user = db.session.get(User, tag.user_id)
+                if not user:
+                    continue
+
+                if mode == 'user_directories':
+                    base_dir = Path(watch_dir) / f'user{user.id}'
+                else:
+                    base_dir = Path(watch_dir)
+
+                if tag.auto_process_folder_name:
+                    folder_path = base_dir / tag.auto_process_folder_name
+                    try:
+                        folder_path.mkdir(parents=True, exist_ok=True)
+                    except OSError as e:
+                        app.logger.error(f"Could not create auto-process folder {folder_path}: {e}")
+
+            app.logger.info(f"Verified {len(tags)} auto-process tag folder(s)")
+        except Exception as e:
+            app.logger.warning(f"Error ensuring tag folders on startup: {e}")
+
+def stop_file_monitor():
+    """Stop the file monitor."""
+    global file_monitor
+    if file_monitor:
+        file_monitor.stop()
+        file_monitor = None
+
+def get_file_monitor_status():
+    """Get the current status of the file monitor."""
+    global file_monitor
+    if file_monitor and file_monitor.running:
+        return {
+            'running': True,
+            'mode': file_monitor.mode,
+            'watch_directory': str(file_monitor.base_watch_directory),
+            'check_interval': file_monitor.check_interval
+        }
+    else:
+        return {'running': False}
diff --git a/src/init_db.py b/src/init_db.py
new file mode 100644
index 00000000..563a43a0
--- /dev/null
+++ b/src/init_db.py
@@ -0,0 +1,822 @@
+"""
+Database initialization and migration logic.
+
+This module handles:
+- Database schema creation
+- Column migrations (adding missing columns to existing tables)
+- Default system settings initialization
+- Existing recordings migration for inquire mode
+"""
+
+import os
+import fcntl
+import tempfile
+from sqlalchemy import text, inspect
+
+from src.database import db
+from src.models import Recording, TranscriptChunk, SystemSetting, User
+from src.services.embeddings import process_recording_chunks
+from src.utils import add_column_if_not_exists, migrate_column_type, create_index_if_not_exists
+
+# Configuration
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+
+
+def initialize_database(app):
+    """
+    Initialize database schema and run migrations.
+
+    This function should be called within an app context.
+    """
+    db.create_all()
+
+    # Check and add new columns if they don't exist
+    engine = db.engine
+
+    # Enable WAL mode for SQLite (better concurrent write performance)
+    if engine.name == 'sqlite':
+        try:
+            with engine.connect() as conn:
+                conn.execute(text('PRAGMA journal_mode=WAL'))
+                conn.commit()
+                app.logger.info("SQLite WAL mode enabled for better concurrency")
+        except Exception as e:
+            app.logger.warning(f"Could not enable WAL mode: {e}")
+
+    try:
+        # Add is_inbox column with default value of 1 (True)
+        if add_column_if_not_exists(engine, 'recording', 'is_inbox', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added is_inbox column to recording table")
+        
+        # Add is_highlighted column with default value of 0 (False)
+        if add_column_if_not_exists(engine, 'recording', 'is_highlighted', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added is_highlighted column to recording table")
+
+        # Add language preference columns to User table
+        if add_column_if_not_exists(engine, 'user', 'transcription_language', 'VARCHAR(10)'):
+            app.logger.info("Added transcription_language column to user table")
+
+        # Add extract_events column to User table
+        if add_column_if_not_exists(engine, 'user', 'extract_events', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added extract_events column to user table")
+        if add_column_if_not_exists(engine, 'user', 'output_language', 'VARCHAR(50)'):
+            app.logger.info("Added output_language column to user table")
+        if add_column_if_not_exists(engine, 'user', 'summary_prompt', 'TEXT'):
+            app.logger.info("Added summary_prompt column to user table")
+        if add_column_if_not_exists(engine, 'user', 'name', 'VARCHAR(100)'):
+            app.logger.info("Added name column to user table")
+        if add_column_if_not_exists(engine, 'user', 'job_title', 'VARCHAR(100)'):
+            app.logger.info("Added job_title column to user table")
+        if add_column_if_not_exists(engine, 'user', 'company', 'VARCHAR(100)'):
+            app.logger.info("Added company column to user table")
+        if add_column_if_not_exists(engine, 'user', 'diarize', 'BOOLEAN'):
+            app.logger.info("Added diarize column to user table")
+        if add_column_if_not_exists(engine, 'user', 'ui_language', "VARCHAR(10) DEFAULT 'en'"):
+            app.logger.info("Added ui_language column to user table")
+        if add_column_if_not_exists(engine, 'user', 'sso_provider', 'VARCHAR(100)'):
+            app.logger.info("Added sso_provider column to user table")
+        if add_column_if_not_exists(engine, 'user', 'sso_subject', 'VARCHAR(255)'):
+            app.logger.info("Added sso_subject column to user table")
+        
+        # Make password column nullable for SSO users
+        try:
+            inspector = inspect(engine)
+            if 'user' in inspector.get_table_names():
+                if engine.name == 'sqlite':
+                    # SQLite doesn't support ALTER COLUMN, so we need to check and recreate
+                    with engine.connect() as conn:
+                        result = conn.execute(text("SELECT sql FROM sqlite_master WHERE type='table' AND name='user'"))
+                        schema = result.scalar()
+
+                        if schema and 'password VARCHAR(60) NOT NULL' in schema:
+                            app.logger.info("Migrating user table to make password nullable for SSO support...")
+
+                            conn.execute(text("""
+                                CREATE TABLE user_new (
+                                    id INTEGER NOT NULL,
+                                    username VARCHAR(20) NOT NULL,
+                                    email VARCHAR(120) NOT NULL,
+                                    password VARCHAR(60),
+                                    is_admin BOOLEAN,
+                                    can_share_publicly BOOLEAN,
+                                    transcription_language VARCHAR(10),
+                                    output_language VARCHAR(50),
+                                    ui_language VARCHAR(10),
+                                    summary_prompt TEXT,
+                                    extract_events BOOLEAN,
+                                    name VARCHAR(100),
+                                    job_title VARCHAR(100),
+                                    company VARCHAR(100),
+                                    diarize BOOLEAN,
+                                    sso_provider VARCHAR(100),
+                                    sso_subject VARCHAR(255),
+                                    PRIMARY KEY (id),
+                                    UNIQUE (username),
+                                    UNIQUE (email)
+                                )
+                            """))
+                            conn.execute(text("""
+                                INSERT INTO user_new
+                                SELECT id, username, email, password, is_admin, can_share_publicly,
+                                       transcription_language, output_language, ui_language,
+                                       summary_prompt, extract_events, name, job_title, company,
+                                       diarize, sso_provider, sso_subject
+                                FROM user
+                            """))
+                            conn.execute(text("DROP TABLE user"))
+                            conn.execute(text("ALTER TABLE user_new RENAME TO user"))
+                            conn.execute(text('CREATE UNIQUE INDEX IF NOT EXISTS ix_user_sso_subject ON "user" (sso_subject)'))
+                            conn.commit()
+                            app.logger.info("Successfully made password column nullable for SSO support")
+                        else:
+                            app.logger.info("Password column is already nullable, skipping migration")
+
+                elif engine.name == 'postgresql':
+                    # PostgreSQL supports ALTER COLUMN directly
+                    with engine.connect() as conn:
+                        result = conn.execute(text("""
+                            SELECT is_nullable FROM information_schema.columns
+                            WHERE table_name = 'user' AND column_name = 'password'
+                        """))
+                        row = result.fetchone()
+                        if row and row[0] == 'NO':
+                            conn.execute(text('ALTER TABLE "user" ALTER COLUMN password DROP NOT NULL'))
+                            conn.commit()
+                            app.logger.info("Made password column nullable for SSO support (PostgreSQL)")
+                        else:
+                            app.logger.info("Password column is already nullable, skipping migration")
+        except Exception as e:
+            app.logger.warning(f"Could not migrate password column to nullable (may cause issues with SSO): {e}")
+        
+        if add_column_if_not_exists(engine, 'recording', 'mime_type', 'VARCHAR(100)'):
+            app.logger.info("Added mime_type column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'completed_at', 'DATETIME'):
+            app.logger.info("Added completed_at column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'processing_time_seconds', 'INTEGER'):
+            app.logger.info("Added processing_time_seconds column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'transcription_duration_seconds', 'INTEGER'):
+            app.logger.info("Added transcription_duration_seconds column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'summarization_duration_seconds', 'INTEGER'):
+            app.logger.info("Added summarization_duration_seconds column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'processing_source', "VARCHAR(50) DEFAULT 'upload'"):
+            app.logger.info("Added processing_source column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'error_message', 'TEXT'):
+            app.logger.info("Added error_message column to recording table")
+            
+        # Add columns to recording_tags for order tracking
+        if add_column_if_not_exists(engine, 'recording_tags', 'added_at', 'DATETIME'):
+            app.logger.info("Added added_at column to recording_tags table")
+        if add_column_if_not_exists(engine, 'recording_tags', 'order', '"order" INTEGER DEFAULT 0'):
+            app.logger.info("Added order column to recording_tags table")
+
+        # Add auto-deletion and retention columns
+        if add_column_if_not_exists(engine, 'recording', 'audio_deleted_at', 'DATETIME'):
+            app.logger.info("Added audio_deleted_at column to recording table")
+        if add_column_if_not_exists(engine, 'recording', 'deletion_exempt', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added deletion_exempt column to recording table")
+        if add_column_if_not_exists(engine, 'tag', 'protect_from_deletion', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added protect_from_deletion column to tag table")
+
+        # Add speaker embeddings column for storing voice embeddings from diarization
+        if add_column_if_not_exists(engine, 'recording', 'speaker_embeddings', 'JSON'):
+            app.logger.info("Added speaker_embeddings column to recording table")
+
+        # Per-recording prompt-template variables (e.g. {"agenda": "...", "attendees": "..."})
+        if add_column_if_not_exists(engine, 'recording', 'prompt_variables', 'JSON'):
+            app.logger.info("Added prompt_variables column to recording table")
+
+        # Add speaker voice profile embedding fields
+        if add_column_if_not_exists(engine, 'speaker', 'average_embedding', 'BLOB'):
+            app.logger.info("Added average_embedding column to speaker table")
+        if add_column_if_not_exists(engine, 'speaker', 'embeddings_history', 'JSON'):
+            app.logger.info("Added embeddings_history column to speaker table")
+        if add_column_if_not_exists(engine, 'speaker', 'embedding_count', 'INTEGER DEFAULT 0'):
+            app.logger.info("Added embedding_count column to speaker table")
+        if add_column_if_not_exists(engine, 'speaker', 'confidence_score', 'REAL'):
+            app.logger.info("Added confidence_score column to speaker table")
+
+        # Add is_new_upload column to processing_job table for tracking upload vs reprocessing jobs
+        if add_column_if_not_exists(engine, 'processing_job', 'is_new_upload', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added is_new_upload column to processing_job table")
+
+        if add_column_if_not_exists(engine, 'tag', 'group_id', 'INTEGER'):
+            app.logger.info("Added group_id column to tag table")
+
+        if add_column_if_not_exists(engine, 'tag', 'retention_days', 'INTEGER'):
+            app.logger.info("Added retention_days column to tag table")
+
+        # Migrate existing protected tags to use retention_days = -1 for consistency
+        # This standardizes the protection mechanism: retention_days = -1 means protected/infinite retention
+        try:
+            with engine.connect() as conn:
+                # Find tags with protect_from_deletion=True but retention_days != -1
+                result = conn.execute(text("""
+                    SELECT COUNT(*) FROM tag
+                    WHERE protect_from_deletion = TRUE
+                    AND (retention_days IS NULL OR retention_days != -1)
+                """))
+                count = result.scalar()
+
+                if count and count > 0:
+                    # Migrate these tags to use retention_days = -1
+                    conn.execute(text("""
+                        UPDATE tag
+                        SET retention_days = -1
+                        WHERE protect_from_deletion = TRUE
+                        AND (retention_days IS NULL OR retention_days != -1)
+                    """))
+                    conn.commit()
+                    app.logger.info(f"Migrated {count} protected tags to use retention_days=-1 (standardized protection format)")
+        except Exception as e:
+            app.logger.warning(f"Could not migrate protected tags to retention_days=-1: {e}")
+
+        # Auto-process watch folder columns for tags
+        if add_column_if_not_exists(engine, 'tag', 'is_auto_process', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added is_auto_process column to tag table")
+        if add_column_if_not_exists(engine, 'tag', 'auto_process_folder_name', 'VARCHAR(100)'):
+            app.logger.info("Added auto_process_folder_name column to tag table")
+
+        if add_column_if_not_exists(engine, 'tag', 'auto_share_on_apply', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added auto_share_on_apply column to tag table")
+
+        if add_column_if_not_exists(engine, 'tag', 'share_with_group_lead', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added share_with_group_lead column to tag table")
+
+        if add_column_if_not_exists(engine, 'user', 'can_share_publicly', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added can_share_publicly column to user table")
+
+        # Token budget for rate limiting
+        if add_column_if_not_exists(engine, 'user', 'monthly_token_budget', 'INTEGER'):
+            app.logger.info("Added monthly_token_budget column to user table")
+
+        # Transcription budget for rate limiting (in seconds)
+        if add_column_if_not_exists(engine, 'user', 'monthly_transcription_budget', 'INTEGER'):
+            app.logger.info("Added monthly_transcription_budget column to user table")
+
+        # Naming templates feature
+        if add_column_if_not_exists(engine, 'user', 'default_naming_template_id', 'INTEGER'):
+            app.logger.info("Added default_naming_template_id column to user table")
+
+        # Email verification fields
+        email_verified_added = add_column_if_not_exists(engine, 'user', 'email_verified', 'BOOLEAN DEFAULT 0')
+        if email_verified_added:
+            app.logger.info("Added email_verified column to user table")
+            # Set all existing users to email_verified=True (grandfathered)
+            try:
+                with engine.connect() as conn:
+                    conn.execute(text('UPDATE "user" SET email_verified = TRUE WHERE email_verified = FALSE OR email_verified IS NULL'))
+                    conn.commit()
+                    app.logger.info("Set email_verified=True for all existing users (grandfathered)")
+            except Exception as e:
+                app.logger.warning(f"Could not update existing users email_verified status: {e}")
+
+        if add_column_if_not_exists(engine, 'user', 'email_verification_token', 'VARCHAR(200)'):
+            app.logger.info("Added email_verification_token column to user table")
+        if add_column_if_not_exists(engine, 'user', 'email_verification_sent_at', 'DATETIME'):
+            app.logger.info("Added email_verification_sent_at column to user table")
+        if add_column_if_not_exists(engine, 'user', 'password_reset_token', 'VARCHAR(200)'):
+            app.logger.info("Added password_reset_token column to user table")
+        if add_column_if_not_exists(engine, 'user', 'password_reset_sent_at', 'DATETIME'):
+            app.logger.info("Added password_reset_sent_at column to user table")
+
+        # Auto speaker labelling settings
+        if add_column_if_not_exists(engine, 'user', 'auto_speaker_labelling', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added auto_speaker_labelling column to user table")
+        if add_column_if_not_exists(engine, 'user', 'auto_speaker_labelling_threshold', "VARCHAR(10) DEFAULT 'medium'"):
+            app.logger.info("Added auto_speaker_labelling_threshold column to user table")
+
+        # Auto summarization setting (per-user, default enabled)
+        if add_column_if_not_exists(engine, 'user', 'auto_summarization', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added auto_summarization column to user table")
+
+        # Transcription hints (hotwords and initial prompt for improving ASR accuracy)
+        if add_column_if_not_exists(engine, 'user', 'transcription_hotwords', 'TEXT'):
+            app.logger.info("Added transcription_hotwords column to user table")
+        if add_column_if_not_exists(engine, 'user', 'transcription_initial_prompt', 'TEXT'):
+            app.logger.info("Added transcription_initial_prompt column to user table")
+
+        # UI/display preferences
+        if add_column_if_not_exists(engine, 'user', 'show_timestamps_simple_view', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added show_timestamps_simple_view column to user table")
+        if add_column_if_not_exists(engine, 'user', 'editor_autosave', 'BOOLEAN DEFAULT 0'):
+            app.logger.info("Added editor_autosave column to user table")
+        if add_column_if_not_exists(engine, 'tag', 'default_hotwords', 'TEXT'):
+            app.logger.info("Added default_hotwords column to tag table")
+        if add_column_if_not_exists(engine, 'tag', 'default_initial_prompt', 'TEXT'):
+            app.logger.info("Added default_initial_prompt column to tag table")
+        if add_column_if_not_exists(engine, 'folder', 'default_hotwords', 'TEXT'):
+            app.logger.info("Added default_hotwords column to folder table")
+        if add_column_if_not_exists(engine, 'folder', 'default_initial_prompt', 'TEXT'):
+            app.logger.info("Added default_initial_prompt column to folder table")
+
+        # Create indexes for token lookups (for faster token verification)
+        try:
+            if create_index_if_not_exists(engine, 'ix_user_email_verification_token', 'user', 'email_verification_token'):
+                app.logger.info("Created index ix_user_email_verification_token on user.email_verification_token")
+            if create_index_if_not_exists(engine, 'ix_user_password_reset_token', 'user', 'password_reset_token'):
+                app.logger.info("Created index ix_user_password_reset_token on user.password_reset_token")
+        except Exception as e:
+            app.logger.warning(f"Could not create token indexes: {e}")
+        if add_column_if_not_exists(engine, 'tag', 'naming_template_id', 'INTEGER'):
+            app.logger.info("Added naming_template_id column to tag table")
+
+        # Export template assignments for tags and folders
+        if add_column_if_not_exists(engine, 'tag', 'export_template_id', 'INTEGER'):
+            app.logger.info("Added export_template_id column to tag table")
+        if add_column_if_not_exists(engine, 'folder', 'export_template_id', 'INTEGER'):
+            app.logger.info("Added export_template_id column to folder table")
+
+        # Add source tracking columns to internal_share table
+        if add_column_if_not_exists(engine, 'internal_share', 'source_type', "VARCHAR(20) DEFAULT 'manual'"):
+            app.logger.info("Added source_type column to internal_share table")
+
+        if add_column_if_not_exists(engine, 'internal_share', 'source_tag_id', 'INTEGER'):
+            app.logger.info("Added source_tag_id column to internal_share table")
+
+            # Migrate existing shares: infer source based on group tag presence
+            try:
+                with engine.connect() as conn:
+                    # For each existing share, check if it was likely created by a group tag
+                    # by looking for group tags on the recording where the shared user is a group member
+                    result = conn.execute(text('''
+                        UPDATE internal_share
+                        SET source_type = 'group_tag',
+                            source_tag_id = (
+                                SELECT t.id FROM tag t
+                                INNER JOIN recording_tags rt ON rt.tag_id = t.id
+                                INNER JOIN group_membership gm ON gm.group_id = t.group_id
+                                WHERE rt.recording_id = internal_share.recording_id
+                                AND gm.user_id = internal_share.shared_with_user_id
+                                AND t.group_id IS NOT NULL
+                                AND (t.auto_share_on_apply = TRUE OR t.share_with_group_lead = TRUE)
+                                LIMIT 1
+                            )
+                        WHERE source_type = 'manual'
+                        AND EXISTS (
+                            SELECT 1 FROM tag t
+                            INNER JOIN recording_tags rt ON rt.tag_id = t.id
+                            INNER JOIN group_membership gm ON gm.group_id = t.group_id
+                            WHERE rt.recording_id = internal_share.recording_id
+                            AND gm.user_id = internal_share.shared_with_user_id
+                            AND t.group_id IS NOT NULL
+                            AND (t.auto_share_on_apply = TRUE OR t.share_with_group_lead = TRUE)
+                        )
+                    '''))
+                    conn.commit()
+                    app.logger.info("Inferred source tracking for existing shares based on group tag presence")
+            except Exception as e:
+                app.logger.warning(f"Could not infer source tracking for existing shares: {e}")
+
+            # Update existing records to have proper order values (approximate by tag_id)
+            try:
+                with engine.connect() as conn:
+                    # Get existing associations without order values and assign them
+                    existing_associations = conn.execute(text('''
+                        SELECT recording_id, tag_id, 
+                               ROW_NUMBER() OVER (PARTITION BY recording_id ORDER BY tag_id) as row_num
+                        FROM recording_tags 
+                        WHERE "order" = 0
+                    ''')).fetchall()
+                    
+                    for assoc in existing_associations:
+                        conn.execute(text('''
+                            UPDATE recording_tags 
+                            SET "order" = :order_num 
+                            WHERE recording_id = :rec_id AND tag_id = :tag_id
+                        '''), {"order_num": assoc.row_num, "rec_id": assoc.recording_id, "tag_id": assoc.tag_id})
+                    
+                    conn.commit()
+                    app.logger.info(f"Updated order values for {len(existing_associations)} existing tag associations")
+            except Exception as e:
+                app.logger.warning(f"Could not update existing tag order values: {e}")
+
+        # Add per-user status columns to shared_recording_state table
+        if add_column_if_not_exists(engine, 'shared_recording_state', 'is_inbox', 'BOOLEAN DEFAULT 1'):
+            app.logger.info("Added is_inbox column to shared_recording_state table")
+
+        # Handle is_starred -> is_highlighted migration
+        inspector = inspect(engine)
+        if 'shared_recording_state' in inspector.get_table_names():
+            columns = [col['name'] for col in inspector.get_columns('shared_recording_state')]
+            has_is_starred = 'is_starred' in columns
+            has_is_highlighted = 'is_highlighted' in columns
+
+            if has_is_starred and not has_is_highlighted:
+                # Rename is_starred to is_highlighted by copying data
+                try:
+                    # Add is_highlighted column using utility (handles PostgreSQL boolean defaults)
+                    add_column_if_not_exists(engine, 'shared_recording_state', 'is_highlighted', 'BOOLEAN DEFAULT 0')
+                    # Copy data from is_starred to is_highlighted
+                    with engine.connect() as conn:
+                        conn.execute(text('UPDATE shared_recording_state SET is_highlighted = is_starred'))
+                        conn.commit()
+                    app.logger.info("Migrated is_starred to is_highlighted in shared_recording_state table")
+                    # Note: We keep is_starred for now to avoid breaking existing code during transition
+                except Exception as e:
+                    app.logger.warning(f"Could not migrate is_starred to is_highlighted: {e}")
+            elif not has_is_highlighted:
+                # Neither column exists, add is_highlighted
+                if add_column_if_not_exists(engine, 'shared_recording_state', 'is_highlighted', 'BOOLEAN DEFAULT 0'):
+                    app.logger.info("Added is_highlighted column to shared_recording_state table")
+
+        # Migrate meeting_date from DATE to DATETIME format
+        # This migration handles both:
+        # 1. Converting existing DATE columns to DATETIME (for fresh pulls)
+        # 2. Restoring NULL dates from created_at (for failed migrations)
+        try:
+            inspector = inspect(engine)
+            columns_info = {col['name']: col for col in inspector.get_columns('recording')}
+
+            if 'meeting_date' in columns_info:
+                col_type = str(columns_info['meeting_date']['type']).upper()
+
+                # Check if column needs migration from DATE to DATETIME
+                needs_migration = False
+
+                # For SQLite: Both DATE and DATETIME are TEXT, check data format
+                if engine.name == 'sqlite':
+                    with engine.connect() as conn:
+                        # Check if we have date-only format (no time component)
+                        result = conn.execute(text("""
+                            SELECT meeting_date FROM recording
+                            WHERE meeting_date IS NOT NULL
+                            AND meeting_date NOT LIKE '%:%'
+                            LIMIT 1
+                        """))
+                        has_date_only = result.fetchone() is not None
+                        needs_migration = has_date_only
+
+                # For PostgreSQL/MySQL: Check actual column type
+                elif 'DATE' in col_type and 'DATETIME' not in col_type and 'TIMESTAMP' not in col_type:
+                    needs_migration = True
+
+                if needs_migration:
+                    app.logger.info(f"Migrating meeting_date from DATE to DATETIME format (engine: {engine.name})")
+
+                    with engine.connect() as conn:
+                        if engine.name == 'sqlite':
+                            # SQLite: Add time component to date-only values
+                            conn.execute(text("""
+                                UPDATE recording
+                                SET meeting_date = datetime(date(meeting_date) || ' 12:00:00')
+                                WHERE meeting_date IS NOT NULL
+                                AND meeting_date NOT LIKE '%:%'
+                            """))
+                            conn.commit()
+                            app.logger.info("Migrated SQLite meeting_date to include time")
+
+                        elif engine.name == 'postgresql':
+                            # PostgreSQL: Change column type
+                            conn.execute(text("""
+                                ALTER TABLE recording
+                                ALTER COLUMN meeting_date TYPE TIMESTAMP
+                                USING (meeting_date + TIME '12:00:00')
+                            """))
+                            conn.commit()
+                            app.logger.info("Migrated PostgreSQL meeting_date to TIMESTAMP")
+
+                        elif engine.name == 'mysql':
+                            # MySQL: Change column type
+                            conn.execute(text("""
+                                ALTER TABLE recording
+                                MODIFY COLUMN meeting_date DATETIME
+                            """))
+                            # Add time component to existing date values
+                            conn.execute(text("""
+                                UPDATE recording
+                                SET meeting_date = TIMESTAMP(meeting_date, '12:00:00')
+                                WHERE meeting_date IS NOT NULL
+                            """))
+                            conn.commit()
+                            app.logger.info("Migrated MySQL meeting_date to DATETIME")
+                else:
+                    app.logger.info("meeting_date already in DATETIME format, skipping migration")
+
+                # Safety net: Restore any NULL meeting_dates from created_at
+                with engine.connect() as conn:
+                    result = conn.execute(text("""
+                        SELECT COUNT(*) FROM recording
+                        WHERE meeting_date IS NULL AND created_at IS NOT NULL
+                    """))
+                    null_count = result.scalar()
+
+                    if null_count and null_count > 0:
+                        conn.execute(text("""
+                            UPDATE recording
+                            SET meeting_date = created_at
+                            WHERE meeting_date IS NULL AND created_at IS NOT NULL
+                        """))
+                        conn.commit()
+                        app.logger.info(f"Restored {null_count} NULL meeting dates from created_at")
+
+        except Exception as e:
+            app.logger.warning(f"Error during meeting_date migration: {e}")
+            app.logger.warning("New recordings will work correctly, but existing dates may need manual migration")
+
+        # Add index on TranscriptChunk.speaker_name for performance
+        # This improves speaker rename operations which update all chunks
+        try:
+            inspector = inspect(engine)
+            if 'transcript_chunk' in inspector.get_table_names():
+                existing_indexes = [idx['name'] for idx in inspector.get_indexes('transcript_chunk')]
+
+                # Create composite index on (user_id, speaker_name) if it doesn't exist
+                if 'idx_user_speaker_name' not in existing_indexes:
+                    with engine.connect() as conn:
+                        conn.execute(text(
+                            'CREATE INDEX IF NOT EXISTS idx_user_speaker_name ON transcript_chunk (user_id, speaker_name)'
+                        ))
+                        conn.commit()
+                        app.logger.info("Created index idx_user_speaker_name on transcript_chunk (user_id, speaker_name) for speaker rename performance")
+
+                # Create single-column index on speaker_name if it doesn't exist
+                if 'ix_transcript_chunk_speaker_name' not in existing_indexes:
+                    with engine.connect() as conn:
+                        conn.execute(text(
+                            'CREATE INDEX IF NOT EXISTS ix_transcript_chunk_speaker_name ON transcript_chunk (speaker_name)'
+                        ))
+                        conn.commit()
+                        app.logger.info("Created index ix_transcript_chunk_speaker_name on transcript_chunk (speaker_name)")
+        except Exception as e:
+            app.logger.warning(f"Could not create speaker_name indexes: {e}")
+
+        # Add unique index for SSO subject to prevent duplicate linking
+        try:
+            if create_index_if_not_exists(engine, 'ix_user_sso_subject', 'user', 'sso_subject', unique=True):
+                app.logger.info("Created unique index ix_user_sso_subject on user.sso_subject")
+        except Exception as e:
+            app.logger.warning(f"Could not create unique index on user.sso_subject: {e}")
+
+        # Add file_hash column for duplicate detection
+        if add_column_if_not_exists(engine, 'recording', 'file_hash', 'VARCHAR(64)'):
+            app.logger.info("Added file_hash column to recording table")
+        try:
+            if create_index_if_not_exists(engine, 'ix_recording_user_file_hash', 'recording', 'user_id, file_hash'):
+                app.logger.info("Created index ix_recording_user_file_hash on recording (user_id, file_hash)")
+        except Exception as e:
+            app.logger.warning(f"Could not create index on recording (user_id, file_hash): {e}")
+
+        # Add folder_id column to recording table for folders feature
+        if add_column_if_not_exists(engine, 'recording', 'folder_id', 'INTEGER'):
+            app.logger.info("Added folder_id column to recording table")
+
+        # Add default_transcription_model columns to tag and folder for per-tag/per-folder model selection (issue #266)
+        if add_column_if_not_exists(engine, 'tag', 'default_transcription_model', 'VARCHAR(120)'):
+            app.logger.info("Added default_transcription_model column to tag table")
+        if add_column_if_not_exists(engine, 'folder', 'default_transcription_model', 'VARCHAR(120)'):
+            app.logger.info("Added default_transcription_model column to folder table")
+        # Create index for folder_id
+        try:
+            if create_index_if_not_exists(engine, 'ix_recording_folder_id', 'recording', 'folder_id'):
+                app.logger.info("Created index ix_recording_folder_id on recording.folder_id")
+        except Exception as e:
+            app.logger.warning(f"Could not create index on recording.folder_id: {e}")
+
+        # Initialize default system settings
+        if not SystemSetting.query.filter_by(key='transcript_length_limit').first():
+            SystemSetting.set_setting(
+                key='transcript_length_limit',
+                value='30000',
+                description='Maximum number of characters to send from transcript to LLM for summarization and chat. Use -1 for no limit.',
+                setting_type='integer'
+            )
+            app.logger.info("Initialized default transcript_length_limit setting")
+            
+        if not SystemSetting.query.filter_by(key='max_file_size_mb').first():
+            SystemSetting.set_setting(
+                key='max_file_size_mb',
+                value='250',
+                description='Maximum file size allowed for audio uploads in megabytes (MB).',
+                setting_type='integer'
+            )
+            app.logger.info("Initialized default max_file_size_mb setting")
+        
+        if not SystemSetting.query.filter_by(key='asr_timeout_seconds').first():
+            SystemSetting.set_setting(
+                key='asr_timeout_seconds',
+                value='1800',
+                description='Maximum time in seconds to wait for ASR transcription to complete. Default is 1800 seconds (30 minutes).',
+                setting_type='integer'
+            )
+            app.logger.info("Initialized default asr_timeout_seconds setting")
+        
+        if not SystemSetting.query.filter_by(key='admin_default_summary_prompt').first():
+            default_prompt = """Generate a comprehensive summary that includes the following sections:
+- **Key Issues Discussed**: A bulleted list of the main topics
+- **Key Decisions Made**: A bulleted list of any decisions reached
+- **Action Items**: A bulleted list of tasks assigned, including who is responsible if mentioned"""
+            SystemSetting.set_setting(
+                key='admin_default_summary_prompt',
+                value=default_prompt,
+                description='Default summarization prompt used when users have not set their own prompt. This serves as the base prompt for all users.',
+                setting_type='string'
+            )
+            app.logger.info("Initialized admin_default_summary_prompt setting")
+        
+        if not SystemSetting.query.filter_by(key='recording_disclaimer').first():
+            SystemSetting.set_setting(
+                key='recording_disclaimer',
+                value='',
+                description='Legal disclaimer shown to users before recording starts. Supports Markdown formatting. Leave empty to disable.',
+                setting_type='string'
+            )
+            app.logger.info("Initialized recording_disclaimer setting")
+
+        if not SystemSetting.query.filter_by(key='upload_disclaimer').first():
+            SystemSetting.set_setting(
+                key='upload_disclaimer',
+                value='',
+                description='Legal disclaimer shown before file uploads. Supports Markdown. Leave empty to disable.',
+                setting_type='string'
+            )
+            app.logger.info("Initialized upload_disclaimer setting")
+
+        if not SystemSetting.query.filter_by(key='custom_banner').first():
+            SystemSetting.set_setting(
+                key='custom_banner',
+                value='',
+                description='Custom banner shown at the top of the page. Supports Markdown. Leave empty to disable.',
+                setting_type='string'
+            )
+            app.logger.info("Initialized custom_banner setting")
+
+        if not SystemSetting.query.filter_by(key='disable_auto_summarization').first():
+            SystemSetting.set_setting(
+                key='disable_auto_summarization',
+                value='false',
+                description='Disable automatic summarization after transcription completes. When enabled, recordings will only be transcribed and users must manually trigger summarization.',
+                setting_type='boolean'
+            )
+            app.logger.info("Initialized disable_auto_summarization setting")
+
+        if not SystemSetting.query.filter_by(key='admin_default_hotwords').first():
+            SystemSetting.set_setting(
+                key='admin_default_hotwords',
+                value='',
+                description='Global hotwords injected into all transcription requests. Comma-separated. Applied when users have not set their own hotwords.',
+                setting_type='string'
+            )
+            app.logger.info("Initialized admin_default_hotwords setting")
+
+        if not SystemSetting.query.filter_by(key='enable_folders').first():
+            SystemSetting.set_setting(
+                key='enable_folders',
+                value='false',
+                description='Enable the Folders feature, allowing users to organize recordings into folders with custom prompts and ASR settings.',
+                setting_type='boolean'
+            )
+            app.logger.info("Initialized enable_folders setting")
+
+        # Track the embedding identifier (provider + model) in system_setting
+        # so we can warn when either changes between restarts. Issue #262 —
+        # old vectors will not match a new model's output dimensionality or
+        # semantic space, and inquire mode will silently return wrong results
+        # until users reprocess.
+        try:
+            from src.services.embeddings import EMBEDDING_IDENTIFIER
+            current_identifier = EMBEDDING_IDENTIFIER
+
+            stored_identifier = SystemSetting.get_setting('embedding_identifier', None)
+            # Backwards-compat path: pre-v0.8.16-alpha instances stored only the
+            # bare model name under the legacy 'embedding_model_name' key. Any
+            # such value is by definition a local sentence-transformers model,
+            # so wrap it in the new 'local::<name>' format before comparing.
+            # This prevents a false-positive warning on first upgrade.
+            legacy_model_name = SystemSetting.get_setting('embedding_model_name', None)
+            migrated_from_legacy = False
+            if stored_identifier is None and legacy_model_name:
+                stored_identifier = f"local::{legacy_model_name}"
+                migrated_from_legacy = True
+
+            chunk_count = TranscriptChunk.query.filter(TranscriptChunk.embedding.isnot(None)).count()
+
+            if stored_identifier is None:
+                SystemSetting.set_setting(
+                    key='embedding_identifier',
+                    value=current_identifier,
+                    description='Identifier of the embedding provider and model that produced the stored chunk vectors. Used to detect dimensionality and semantic-space mismatches at startup.',
+                    setting_type='string',
+                )
+                if chunk_count:
+                    app.logger.info(f"Recorded embedding_identifier={current_identifier} (existing {chunk_count} chunks assumed to match)")
+            elif stored_identifier == current_identifier:
+                if migrated_from_legacy:
+                    # Same configuration, just promote the value into the new key
+                    # so subsequent restarts skip the legacy lookup.
+                    SystemSetting.set_setting(
+                        key='embedding_identifier',
+                        value=current_identifier,
+                        description='Identifier of the embedding provider and model that produced the stored chunk vectors. Used to detect dimensionality and semantic-space mismatches at startup.',
+                        setting_type='string',
+                    )
+                    app.logger.info(
+                        f"Migrated legacy embedding_model_name={legacy_model_name!r} to embedding_identifier={current_identifier!r}"
+                    )
+            else:
+                if chunk_count:
+                    app.logger.warning(
+                        f"Embedding identifier changed from {stored_identifier!r} to {current_identifier!r} "
+                        f"but {chunk_count} chunks were embedded with the previous configuration. "
+                        "Inquire mode will return wrong results until you reprocess affected recordings."
+                    )
+                SystemSetting.set_setting(
+                    key='embedding_identifier',
+                    value=current_identifier,
+                    description='Identifier of the embedding provider and model that produced the stored chunk vectors. Used to detect dimensionality and semantic-space mismatches at startup.',
+                    setting_type='string',
+                )
+                app.logger.info(f"Updated embedding_identifier in system_setting: {stored_identifier!r} -> {current_identifier!r}")
+        except Exception as e:
+            db.session.rollback()
+            app.logger.warning(f"embedding_identifier compatibility check skipped: {e}")
+
+        # One-shot migration: clean up legacy User.transcription_language values
+        # that were stored as display names ("Français", "English") before the
+        # account-settings input was a dropdown. Issue #256.
+        try:
+            from src.utils.language import normalize_language_code
+            from sqlalchemy import or_
+            # Touch only rows where the value isn't already a valid 2-letter code,
+            # to keep this idempotent across restarts.
+            stale_users = User.query.filter(User.transcription_language.isnot(None)).all()
+            cleaned = 0
+            for u in stale_users:
+                normalized = normalize_language_code(u.transcription_language)
+                if normalized != u.transcription_language:
+                    app.logger.info(
+                        f"Migrating user {u.id} transcription_language: {u.transcription_language!r} -> {normalized!r}"
+                    )
+                    u.transcription_language = normalized
+                    cleaned += 1
+            if cleaned:
+                db.session.commit()
+                app.logger.info(f"Normalized transcription_language for {cleaned} user(s)")
+        except Exception as e:
+            db.session.rollback()
+            app.logger.warning(f"transcription_language normalization migration skipped: {e}")
+
+        # Process existing recordings for inquire mode (chunk and embed them)
+        # Only run if inquire mode is enabled
+        if ENABLE_INQUIRE_MODE:
+            # Use a file lock to prevent multiple workers from running this simultaneously
+            lock_file_path = os.path.join(tempfile.gettempdir(), 'inquire_migration.lock')
+            
+            try:
+                with open(lock_file_path, 'w') as lock_file:
+                    # Try to acquire exclusive lock (non-blocking)
+                    try:
+                        fcntl.flock(lock_file.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB)
+                        app.logger.info("Acquired migration lock, checking for existing recordings that need chunking for inquire mode...")
+                        
+                        completed_recordings = Recording.query.filter_by(status='COMPLETED').all()
+                        recordings_needing_processing = []
+                        
+                        for recording in completed_recordings:
+                            if recording.transcription:  # Has transcription
+                                chunk_count = TranscriptChunk.query.filter_by(recording_id=recording.id).count()
+                                if chunk_count == 0:  # No chunks yet
+                                    recordings_needing_processing.append(recording)
+                        
+                        if recordings_needing_processing:
+                            app.logger.info(f"Found {len(recordings_needing_processing)} recordings that need chunking for inquire mode")
+                            app.logger.info("Processing first 10 recordings automatically. Use admin API or migration script for remaining recordings.")
+                            
+                            # Process first 10 recordings automatically to avoid long startup times
+                            batch_size = min(10, len(recordings_needing_processing))
+                            processed = 0
+                            
+                            for i in range(batch_size):
+                                recording = recordings_needing_processing[i]
+                                try:
+                                    success = process_recording_chunks(recording.id)
+                                    if success:
+                                        processed += 1
+                                        app.logger.info(f"Processed chunks for recording: {recording.title} ({recording.id})")
+                                except Exception as e:
+                                    app.logger.warning(f"Failed to process chunks for recording {recording.id}: {e}")
+                            
+                            remaining = len(recordings_needing_processing) - processed
+                            if remaining > 0:
+                                app.logger.info(f"Successfully processed {processed} recordings. {remaining} recordings remaining.")
+                                app.logger.info("Use the admin migration API or run 'python migrate_existing_recordings.py' to process remaining recordings.")
+                            else:
+                                app.logger.info(f"Successfully processed all {processed} recordings for inquire mode.")
+                        else:
+                            app.logger.info("All existing recordings are already processed for inquire mode.")
+                        
+                    except BlockingIOError:
+                        app.logger.info("Migration already running in another worker, skipping...")
+                    
+            except Exception as e:
+                app.logger.warning(f"Error during existing recordings migration: {e}")
+                app.logger.info("Existing recordings can be migrated later using the admin API or migration script.")
+            
+    except Exception as e:
+        app.logger.error(f"Error during database migration: {e}")
+
+
+if __name__ == '__main__':
+    # For standalone migration script
+    from src.app import app
+    with app.app_context():
+        initialize_database(app)
diff --git a/src/models/__init__.py b/src/models/__init__.py
new file mode 100644
index 00000000..2a82004f
--- /dev/null
+++ b/src/models/__init__.py
@@ -0,0 +1,69 @@
+"""
+Database models package for the Speakr application.
+
+This package contains all database models organized by domain:
+- User and authentication models
+- Recording and transcript models
+- Sharing models (public and internal)
+- Organization models (groups and tags)
+- Event, template, and search session models
+- System configuration models
+"""
+
+# Import database instance
+from src.database import db
+
+# Import all models
+from .user import User, Speaker
+from .api_token import APIToken
+from .speaker_snippet import SpeakerSnippet
+from .recording import Recording, TranscriptChunk
+from .sharing import Share, InternalShare, SharedRecordingState
+from .organization import Group, GroupMembership, Tag, RecordingTag, Folder
+from .events import Event
+from .templates import TranscriptTemplate
+from .naming_template import NamingTemplate
+from .export_template import ExportTemplate
+from .inquire import InquireSession
+from .system import SystemSetting
+from .audit import ShareAuditLog
+from .push_subscription import PushSubscription
+from .processing_job import ProcessingJob
+from .token_usage import TokenUsage
+from .transcription_usage import TranscriptionUsage
+
+# Export all models
+__all__ = [
+    # Database instance
+    'db',
+    # User models
+    'User',
+    'Speaker',
+    'APIToken',
+    'SpeakerSnippet',
+    # Recording models
+    'Recording',
+    'TranscriptChunk',
+    # Sharing models
+    'Share',
+    'InternalShare',
+    'SharedRecordingState',
+    'ShareAuditLog',
+    # Organization models
+    'Group',
+    'GroupMembership',
+    'Tag',
+    'RecordingTag',
+    'Folder',
+    # Other models
+    'Event',
+    'TranscriptTemplate',
+    'NamingTemplate',
+    'ExportTemplate',
+    'InquireSession',
+    'SystemSetting',
+    'PushSubscription',
+    'ProcessingJob',
+    'TokenUsage',
+    'TranscriptionUsage',
+]
diff --git a/src/models/api_token.py b/src/models/api_token.py
new file mode 100644
index 00000000..37a6a047
--- /dev/null
+++ b/src/models/api_token.py
@@ -0,0 +1,51 @@
+"""
+API Token database model.
+
+This module defines the APIToken model for managing user API tokens
+that allow authentication via Bearer tokens for automation tools.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class APIToken(db.Model):
+    """API Token model for token-based authentication."""
+
+    __tablename__ = 'api_token'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    token_hash = db.Column(db.String(64), unique=True, nullable=False, index=True)
+    name = db.Column(db.String(100), nullable=True)  # User-friendly label (e.g., "n8n", "CLI")
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False)
+    last_used_at = db.Column(db.DateTime, nullable=True)
+    expires_at = db.Column(db.DateTime, nullable=True)
+    revoked = db.Column(db.Boolean, default=False, nullable=False, index=True)
+
+    # Relationship to User
+    user = db.relationship('User', backref=db.backref('api_tokens', lazy=True, cascade='all, delete-orphan'))
+
+    def __repr__(self):
+        return f"APIToken(name='{self.name}', user_id={self.user_id}, revoked={self.revoked})"
+
+    def to_dict(self):
+        """Convert token to dictionary for API responses."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'last_used_at': self.last_used_at.isoformat() if self.last_used_at else None,
+            'expires_at': self.expires_at.isoformat() if self.expires_at else None,
+            'revoked': self.revoked
+        }
+
+    def is_expired(self):
+        """Check if token has expired."""
+        if not self.expires_at:
+            return False
+        return self.expires_at < datetime.utcnow()
+
+    def is_valid(self):
+        """Check if token is valid (not revoked and not expired)."""
+        return not self.revoked and not self.is_expired()
diff --git a/src/models/audit.py b/src/models/audit.py
new file mode 100644
index 00000000..283ab87f
--- /dev/null
+++ b/src/models/audit.py
@@ -0,0 +1,109 @@
+"""
+Audit logging models for tracking share operations.
+
+Provides comprehensive audit trail for security and compliance.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class ShareAuditLog(db.Model):
+    """Audit trail for share operations."""
+
+    __tablename__ = 'share_audit_log'
+
+    id = db.Column(db.Integer, primary_key=True)
+
+    # Action details
+    action = db.Column(db.String(20), nullable=False)  # 'created', 'modified', 'revoked', 'cascade_revoked'
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id', ondelete='CASCADE'), nullable=False)
+
+    # Actor (who performed the action)
+    actor_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    actor = db.relationship('User', foreign_keys=[actor_id], backref=db.backref('audit_actions_performed', cascade='all, delete-orphan'))
+
+    # Target (who was affected - optional for some actions)
+    target_user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=True)
+    target_user = db.relationship('User', foreign_keys=[target_user_id])
+
+    # Permission snapshot at time of action
+    permissions_granted = db.Column(db.JSON, nullable=True)  # What was granted/revoked
+    actor_permissions = db.Column(db.JSON, nullable=True)    # What actor had at time
+
+    # Metadata
+    timestamp = db.Column(db.DateTime, default=datetime.utcnow, nullable=False)
+    share_id = db.Column(db.Integer, nullable=True)  # Reference to share if applicable
+
+    # Context and notes
+    notes = db.Column(db.Text, nullable=True)  # System-generated notes (e.g., "Permission constrained", "Cascade revocation")
+    ip_address = db.Column(db.String(45), nullable=True)  # Actor's IP address
+
+    # Recording relationship
+    recording = db.relationship('Recording', backref=db.backref('share_audit_logs', cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert to dictionary for API responses."""
+        return {
+            'id': self.id,
+            'action': self.action,
+            'recording_id': self.recording_id,
+            'actor_id': self.actor_id,
+            'actor_username': self.actor.username if self.actor else None,
+            'target_user_id': self.target_user_id,
+            'target_username': self.target_user.username if self.target_user else None,
+            'permissions_granted': self.permissions_granted,
+            'actor_permissions': self.actor_permissions,
+            'timestamp': self.timestamp.isoformat() if self.timestamp else None,
+            'share_id': self.share_id,
+            'notes': self.notes,
+            'ip_address': self.ip_address
+        }
+
+    @staticmethod
+    def log_share_created(recording_id, actor_id, target_user_id, permissions, actor_permissions=None, notes=None, ip_address=None):
+        """Log share creation."""
+        log = ShareAuditLog(
+            action='created',
+            recording_id=recording_id,
+            actor_id=actor_id,
+            target_user_id=target_user_id,
+            permissions_granted=permissions,
+            actor_permissions=actor_permissions,
+            notes=notes,
+            ip_address=ip_address
+        )
+        db.session.add(log)
+        return log
+
+    @staticmethod
+    def log_share_modified(share_id, recording_id, actor_id, target_user_id, old_permissions, new_permissions, notes=None, ip_address=None):
+        """Log share modification."""
+        log = ShareAuditLog(
+            action='modified',
+            recording_id=recording_id,
+            actor_id=actor_id,
+            target_user_id=target_user_id,
+            permissions_granted={'old': old_permissions, 'new': new_permissions},
+            share_id=share_id,
+            notes=notes,
+            ip_address=ip_address
+        )
+        db.session.add(log)
+        return log
+
+    @staticmethod
+    def log_share_revoked(share_id, recording_id, actor_id, target_user_id, was_cascade=False, notes=None, ip_address=None):
+        """Log share revocation."""
+        action = 'cascade_revoked' if was_cascade else 'revoked'
+        log = ShareAuditLog(
+            action=action,
+            recording_id=recording_id,
+            actor_id=actor_id,
+            target_user_id=target_user_id,
+            share_id=share_id,
+            notes=notes,
+            ip_address=ip_address
+        )
+        db.session.add(log)
+        return log
diff --git a/src/models/events.py b/src/models/events.py
new file mode 100644
index 00000000..d967b687
--- /dev/null
+++ b/src/models/events.py
@@ -0,0 +1,43 @@
+"""
+Event model for calendar events extracted from transcripts.
+
+This module defines the Event model for storing calendar events
+that are extracted from transcriptions.
+"""
+
+import json
+from datetime import datetime
+from src.database import db
+
+
+class Event(db.Model):
+    """Calendar events extracted from transcripts."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id'), nullable=False)
+    title = db.Column(db.String(200), nullable=False)
+    description = db.Column(db.Text, nullable=True)
+    start_datetime = db.Column(db.DateTime, nullable=False)
+    end_datetime = db.Column(db.DateTime, nullable=True)
+    location = db.Column(db.String(500), nullable=True)
+    attendees = db.Column(db.Text, nullable=True)  # JSON list of attendees
+    reminder_minutes = db.Column(db.Integer, nullable=True, default=15)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Relationship
+    recording = db.relationship('Recording', backref=db.backref('events', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'recording_id': self.recording_id,
+            'title': self.title,
+            'description': self.description,
+            'start_datetime': self.start_datetime.isoformat() if self.start_datetime else None,
+            'end_datetime': self.end_datetime.isoformat() if self.end_datetime else None,
+            'location': self.location,
+            'attendees': json.loads(self.attendees) if self.attendees else [],
+            'reminder_minutes': self.reminder_minutes,
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
diff --git a/src/models/export_template.py b/src/models/export_template.py
new file mode 100644
index 00000000..dc132781
--- /dev/null
+++ b/src/models/export_template.py
@@ -0,0 +1,37 @@
+"""
+ExportTemplate model for user-defined export formatting.
+
+This module defines the ExportTemplate model for storing
+custom templates for markdown export formatting.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class ExportTemplate(db.Model):
+    """Stores user-defined templates for markdown export formatting."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    name = db.Column(db.String(100), nullable=False)
+    template = db.Column(db.Text, nullable=False)
+    description = db.Column(db.String(500), nullable=True)
+    is_default = db.Column(db.Boolean, default=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('export_templates', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'template': self.template,
+            'description': self.description,
+            'is_default': self.is_default,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
diff --git a/src/models/inquire.py b/src/models/inquire.py
new file mode 100644
index 00000000..eb841861
--- /dev/null
+++ b/src/models/inquire.py
@@ -0,0 +1,45 @@
+"""
+InquireSession model for semantic search sessions.
+
+This module defines the InquireSession model for tracking
+inquire mode sessions and their filtering criteria.
+"""
+
+import json
+from datetime import datetime
+from src.database import db
+
+
+class InquireSession(db.Model):
+    """Tracks inquire mode sessions and their filtering criteria."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    session_name = db.Column(db.String(200), nullable=True)  # Optional user-defined name
+
+    # Filter criteria (JSON stored as text)
+    filter_tags = db.Column(db.Text, nullable=True)  # JSON array of tag IDs
+    filter_speakers = db.Column(db.Text, nullable=True)  # JSON array of speaker names
+    filter_date_from = db.Column(db.Date, nullable=True)
+    filter_date_to = db.Column(db.Date, nullable=True)
+    filter_recording_ids = db.Column(db.Text, nullable=True)  # JSON array of specific recording IDs
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    last_used = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('inquire_sessions', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'session_name': self.session_name,
+            'filter_tags': json.loads(self.filter_tags) if self.filter_tags else [],
+            'filter_speakers': json.loads(self.filter_speakers) if self.filter_speakers else [],
+            'filter_date_from': self.filter_date_from.isoformat() if self.filter_date_from else None,
+            'filter_date_to': self.filter_date_to.isoformat() if self.filter_date_to else None,
+            'filter_recording_ids': json.loads(self.filter_recording_ids) if self.filter_recording_ids else [],
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'last_used': self.last_used.isoformat() if self.last_used else None
+        }
diff --git a/src/models/naming_template.py b/src/models/naming_template.py
new file mode 100644
index 00000000..f09dc890
--- /dev/null
+++ b/src/models/naming_template.py
@@ -0,0 +1,114 @@
+"""
+NamingTemplate model for user-defined recording title formatting.
+
+This module defines the NamingTemplate model for storing
+custom templates for generating recording titles from filenames,
+metadata, and AI-generated content.
+"""
+
+import json
+import re
+import os
+from datetime import datetime
+from src.database import db
+
+
+class NamingTemplate(db.Model):
+    """Stores user-defined templates for recording title generation."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    name = db.Column(db.String(100), nullable=False)
+    template = db.Column(db.Text, nullable=False)  # e.g., "{{phone}} - {{date}} {{ai_title}}"
+    description = db.Column(db.String(500), nullable=True)
+    regex_patterns = db.Column(db.Text, nullable=True)  # JSON: {"phone": "\\d{10}", "caller": "^([^-]+)"}
+    is_default = db.Column(db.Boolean, default=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('naming_templates', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'template': self.template,
+            'description': self.description,
+            'regex_patterns': json.loads(self.regex_patterns) if self.regex_patterns else {},
+            'is_default': self.is_default,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
+
+    def get_regex_patterns(self):
+        """Parse and return regex patterns as dictionary."""
+        if not self.regex_patterns:
+            return {}
+        try:
+            return json.loads(self.regex_patterns)
+        except json.JSONDecodeError:
+            return {}
+
+    def needs_ai_title(self):
+        """Check if template requires AI-generated title."""
+        return '{{ai_title}}' in self.template
+
+    def apply(self, original_filename, meeting_date=None, ai_title=None):
+        """
+        Apply this template to generate a recording title.
+
+        Args:
+            original_filename: The original filename of the recording
+            meeting_date: Optional datetime of the recording
+            ai_title: Optional AI-generated title
+
+        Returns:
+            Generated title string, or None if template produces empty result
+        """
+        # Start with template
+        result = self.template
+
+        # Get filename without extension for {{filename}}
+        filename_no_ext = os.path.splitext(original_filename)[0] if original_filename else ''
+
+        # Build built-in variables
+        variables = {
+            'ai_title': ai_title or '',
+            'filename': filename_no_ext,
+            'filename_full': original_filename or '',
+            'date': meeting_date.strftime('%Y-%m-%d') if meeting_date else '',
+            'datetime': meeting_date.strftime('%Y-%m-%d %H:%M') if meeting_date else '',
+            'time': meeting_date.strftime('%H:%M') if meeting_date else '',
+            'year': meeting_date.strftime('%Y') if meeting_date else '',
+            'month': meeting_date.strftime('%m') if meeting_date else '',
+            'day': meeting_date.strftime('%d') if meeting_date else '',
+        }
+
+        # Extract custom variables from filename using regex patterns
+        regex_patterns = self.get_regex_patterns()
+        for var_name, pattern in regex_patterns.items():
+            try:
+                match = re.search(pattern, filename_no_ext)
+                if match:
+                    # Use first capture group if exists, else full match
+                    variables[var_name] = match.group(1) if match.groups() else match.group(0)
+                else:
+                    variables[var_name] = ''
+            except re.error as e:
+                # Invalid regex - log and treat as empty
+                variables[var_name] = ''
+
+        # Replace all variables in template
+        for var_name, value in variables.items():
+            result = result.replace('{{' + var_name + '}}', value)
+
+        # Clean up result
+        result = result.strip()
+
+        # If result is empty or only whitespace, return None
+        if not result:
+            return None
+
+        return result
diff --git a/src/models/organization.py b/src/models/organization.py
new file mode 100644
index 00000000..25d6a6a9
--- /dev/null
+++ b/src/models/organization.py
@@ -0,0 +1,250 @@
+"""
+Organization models for groups, tags, and related structures.
+
+This module defines models for organizing users into groups and tagging recordings.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class Group(db.Model):
+    """Groups for organizing users and sharing recordings."""
+
+    __tablename__ = 'group'
+
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(100), nullable=False, unique=True)
+    description = db.Column(db.Text, nullable=True)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    memberships = db.relationship('GroupMembership', back_populates='group', cascade='all, delete-orphan')
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'description': self.description,
+            'member_count': len(self.memberships),
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
+
+
+class GroupMembership(db.Model):
+    """Tracks user membership in groups with roles."""
+
+    __tablename__ = 'group_membership'
+
+    id = db.Column(db.Integer, primary_key=True)
+    group_id = db.Column(db.Integer, db.ForeignKey('group.id', ondelete='CASCADE'), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id', ondelete='CASCADE'), nullable=False)
+    role = db.Column(db.String(20), default='member')  # 'admin' or 'member'
+    joined_at = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Relationships
+    group = db.relationship('Group', back_populates='memberships')
+    user = db.relationship('User', backref=db.backref('group_memberships', lazy=True, cascade='all, delete-orphan'))
+
+    # Unique constraint: user can only be in a group once
+    __table_args__ = (db.UniqueConstraint('group_id', 'user_id', name='unique_group_membership'),)
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'group_id': self.group_id,
+            'group_name': self.group.name if self.group else None,
+            'user_id': self.user_id,
+            'username': self.user.username if self.user else None,
+            'role': self.role,
+            'joined_at': self.joined_at.isoformat() if self.joined_at else None
+        }
+
+
+class RecordingTag(db.Model):
+    """Many-to-many relationship table for recordings and tags."""
+
+    __tablename__ = 'recording_tags'
+
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id'), primary_key=True)
+    tag_id = db.Column(db.Integer, db.ForeignKey('tag.id'), primary_key=True)
+    added_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=True)
+    order = db.Column(db.Integer, nullable=False, default=0)
+
+    # Relationships
+    recording = db.relationship('Recording', back_populates='tag_associations')
+    tag = db.relationship('Tag', back_populates='recording_associations')
+
+
+class Folder(db.Model):
+    """Folders for organizing recordings (one-to-many relationship)."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(50), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    group_id = db.Column(db.Integer, db.ForeignKey('group.id', ondelete='CASCADE'), nullable=True)  # Group-scoped folder
+    color = db.Column(db.String(7), default='#10B981')  # Hex color for UI (green to differentiate from tags)
+
+    # Custom settings for this folder
+    custom_prompt = db.Column(db.Text, nullable=True)  # Custom summarization prompt
+    default_language = db.Column(db.String(10), nullable=True)  # Default transcription language
+    default_min_speakers = db.Column(db.Integer, nullable=True)  # Default min speakers for ASR
+    default_max_speakers = db.Column(db.Integer, nullable=True)  # Default max speakers for ASR
+
+    # Transcription hints
+    default_hotwords = db.Column(db.Text, nullable=True)  # Comma-separated words to bias recognition
+    default_initial_prompt = db.Column(db.Text, nullable=True)  # Initial prompt to steer transcription
+    default_transcription_model = db.Column(db.String(120), nullable=True)  # Override TRANSCRIPTION_MODEL when set
+
+    # Retention and deletion settings
+    protect_from_deletion = db.Column(db.Boolean, default=False)  # Exempt recordings in folder from auto-deletion
+    retention_days = db.Column(db.Integer, nullable=True)  # Folder-specific retention override
+
+    # Group folder settings
+    auto_share_on_apply = db.Column(db.Boolean, default=True)  # Auto-share recording with group when moved to folder
+    share_with_group_lead = db.Column(db.Boolean, default=True)  # Share with group admins when moved to folder
+
+    # Naming template for recordings in this folder
+    naming_template_id = db.Column(db.Integer, db.ForeignKey('naming_template.id', ondelete='SET NULL'), nullable=True)
+
+    # Export template for recordings in this folder
+    export_template_id = db.Column(db.Integer, db.ForeignKey('export_template.id', ondelete='SET NULL'), nullable=True)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('folders', lazy=True, cascade='all, delete-orphan'))
+    group = db.relationship('Group', backref=db.backref('folders', lazy=True))
+    naming_template = db.relationship('NamingTemplate', foreign_keys=[naming_template_id])
+    export_template = db.relationship('ExportTemplate', foreign_keys=[export_template_id])
+    # One-to-many relationship with recordings
+    recordings = db.relationship('Recording', back_populates='folder', lazy=True)
+
+    # Unique constraint: folder name must be unique per user
+    __table_args__ = (db.UniqueConstraint('name', 'user_id', name='_user_folder_uc'),)
+
+    @property
+    def is_group_folder(self):
+        """Check if this is a group-scoped folder."""
+        return self.group_id is not None
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'color': self.color,
+            'group_id': self.group_id,
+            'is_group_folder': self.is_group_folder,
+            'group_name': self.group.name if self.group else None,
+            'custom_prompt': self.custom_prompt,
+            'default_language': self.default_language,
+            'default_min_speakers': self.default_min_speakers,
+            'default_max_speakers': self.default_max_speakers,
+            'default_hotwords': self.default_hotwords,
+            'default_initial_prompt': self.default_initial_prompt,
+            'default_transcription_model': self.default_transcription_model,
+            'protect_from_deletion': self.protect_from_deletion,
+            'retention_days': self.retention_days,
+            'auto_share_on_apply': self.auto_share_on_apply,
+            'share_with_group_lead': self.share_with_group_lead,
+            'naming_template_id': self.naming_template_id,
+            'naming_template_name': self.naming_template.name if self.naming_template else None,
+            'export_template_id': self.export_template_id,
+            'export_template_name': self.export_template.name if self.export_template else None,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'recording_count': len(self.recordings) if self.recordings else 0
+        }
+
+
+class Tag(db.Model):
+    """Tags for organizing and categorizing recordings."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(50), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    group_id = db.Column(db.Integer, db.ForeignKey('group.id', ondelete='CASCADE'), nullable=True)  # Group-scoped tag
+    color = db.Column(db.String(7), default='#3B82F6')  # Hex color for UI
+
+    # Custom settings for this tag
+    custom_prompt = db.Column(db.Text, nullable=True)  # Custom summarization prompt
+    default_language = db.Column(db.String(10), nullable=True)  # Default transcription language
+    default_min_speakers = db.Column(db.Integer, nullable=True)  # Default min speakers for ASR
+    default_max_speakers = db.Column(db.Integer, nullable=True)  # Default max speakers for ASR
+
+    # Transcription hints
+    default_hotwords = db.Column(db.Text, nullable=True)  # Comma-separated words to bias recognition
+    default_initial_prompt = db.Column(db.Text, nullable=True)  # Initial prompt to steer transcription
+    default_transcription_model = db.Column(db.String(120), nullable=True)  # Override TRANSCRIPTION_MODEL when set
+
+    # Retention and deletion settings
+    protect_from_deletion = db.Column(db.Boolean, default=False)  # Exempt tagged recordings from auto-deletion
+    retention_days = db.Column(db.Integer, nullable=True)  # Group-specific retention override (overrides global)
+
+    # Group tag settings
+    auto_share_on_apply = db.Column(db.Boolean, default=True)  # Auto-share recording with group when this tag is applied
+    share_with_group_lead = db.Column(db.Boolean, default=True)  # Share with group admins when this tag is applied
+
+    # Naming template for recordings with this tag
+    naming_template_id = db.Column(db.Integer, db.ForeignKey('naming_template.id', ondelete='SET NULL'), nullable=True)
+
+    # Export template for recordings with this tag
+    export_template_id = db.Column(db.Integer, db.ForeignKey('export_template.id', ondelete='SET NULL'), nullable=True)
+
+    # Auto-process watch folder settings
+    is_auto_process = db.Column(db.Boolean, default=False)
+    auto_process_folder_name = db.Column(db.String(100), nullable=True)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('tags', lazy=True, cascade='all, delete-orphan'))
+    group = db.relationship('Group', backref=db.backref('tags', lazy=True))
+    naming_template = db.relationship('NamingTemplate', foreign_keys=[naming_template_id])
+    export_template = db.relationship('ExportTemplate', foreign_keys=[export_template_id])
+    # Use association object for many-to-many with order tracking
+    recording_associations = db.relationship('RecordingTag', back_populates='tag', cascade='all, delete-orphan')
+
+    # Unique constraint: tag name must be unique per user (or per group if group_id is set)
+    __table_args__ = (db.UniqueConstraint('name', 'user_id', name='_user_tag_uc'),)
+
+    @property
+    def is_group_tag(self):
+        """Check if this is a group-scoped tag."""
+        return self.group_id is not None
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'color': self.color,
+            'group_id': self.group_id,
+            'is_group_tag': self.is_group_tag,
+            'group_name': self.group.name if self.group else None,
+            'custom_prompt': self.custom_prompt,
+            'default_language': self.default_language,
+            'default_min_speakers': self.default_min_speakers,
+            'default_max_speakers': self.default_max_speakers,
+            'default_hotwords': self.default_hotwords,
+            'default_initial_prompt': self.default_initial_prompt,
+            'default_transcription_model': self.default_transcription_model,
+            'protect_from_deletion': self.protect_from_deletion,
+            'retention_days': self.retention_days,
+            'auto_share_on_apply': self.auto_share_on_apply,
+            'share_with_group_lead': self.share_with_group_lead,
+            'naming_template_id': self.naming_template_id,
+            'naming_template_name': self.naming_template.name if self.naming_template else None,
+            'export_template_id': self.export_template_id,
+            'export_template_name': self.export_template.name if self.export_template else None,
+            'is_auto_process': self.is_auto_process or False,
+            'auto_process_folder_name': self.auto_process_folder_name,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'recording_count': len(self.recording_associations)
+        }
diff --git a/src/models/processing_job.py b/src/models/processing_job.py
new file mode 100644
index 00000000..313328c7
--- /dev/null
+++ b/src/models/processing_job.py
@@ -0,0 +1,63 @@
+"""
+ProcessingJob database model for persistent job queue.
+
+This model stores background processing jobs in the database to ensure
+they survive application restarts and support fair scheduling across users.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class ProcessingJob(db.Model):
+    """Database model for tracking background processing jobs."""
+
+    __tablename__ = 'processing_job'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False, index=True)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id', ondelete='CASCADE'), nullable=False, index=True)
+
+    # Job type: transcribe, summarize, reprocess_transcription, reprocess_summary
+    job_type = db.Column(db.String(50), nullable=False)
+
+    # Status: queued, processing, completed, failed
+    status = db.Column(db.String(20), default='queued', nullable=False, index=True)
+
+    # JSON blob for job-specific parameters (language, min_speakers, custom_prompt, etc.)
+    params = db.Column(db.Text, nullable=True)
+
+    # Error tracking
+    error_message = db.Column(db.Text, nullable=True)
+    retry_count = db.Column(db.Integer, default=0, nullable=False)
+
+    # Track if this is a new upload (vs reprocessing) - for cleanup on failure
+    is_new_upload = db.Column(db.Boolean, default=False, nullable=False)
+
+    # Timestamps
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False, index=True)
+    started_at = db.Column(db.DateTime, nullable=True)
+    completed_at = db.Column(db.DateTime, nullable=True)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('processing_jobs', lazy='dynamic', cascade='all, delete-orphan'))
+    recording = db.relationship('Recording', backref=db.backref('processing_jobs', lazy='dynamic', cascade='all, delete-orphan'))
+
+    def __repr__(self):
+        return f'<ProcessingJob {self.id} type={self.job_type} status={self.status}>'
+
+    def to_dict(self):
+        """Convert job to dictionary for API responses."""
+        return {
+            'id': self.id,
+            'user_id': self.user_id,
+            'recording_id': self.recording_id,
+            'job_type': self.job_type,
+            'status': self.status,
+            'retry_count': self.retry_count,
+            'is_new_upload': self.is_new_upload,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'started_at': self.started_at.isoformat() if self.started_at else None,
+            'completed_at': self.completed_at.isoformat() if self.completed_at else None,
+            'error_message': self.error_message
+        }
diff --git a/src/models/push_subscription.py b/src/models/push_subscription.py
new file mode 100644
index 00000000..222bddd9
--- /dev/null
+++ b/src/models/push_subscription.py
@@ -0,0 +1,40 @@
+"""
+Push Subscription Model
+Stores web push notification subscriptions for users
+"""
+from datetime import datetime
+from src.database import db
+
+
+class PushSubscription(db.Model):
+    """Web Push notification subscription"""
+    __tablename__ = 'push_subscriptions'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+
+    # Push subscription endpoint (unique per browser/device)
+    endpoint = db.Column(db.String(500), nullable=False, unique=True)
+
+    # Encryption keys for sending push messages
+    p256dh_key = db.Column(db.String(200), nullable=False)
+    auth_key = db.Column(db.String(100), nullable=False)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('push_subscriptions', lazy=True, cascade='all, delete-orphan'))
+
+    # Timestamps
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    def __repr__(self):
+        return f'<PushSubscription {self.id} user={self.user_id}>'
+
+    def to_dict(self):
+        """Convert to dictionary"""
+        return {
+            'id': self.id,
+            'user_id': self.user_id,
+            'endpoint': self.endpoint,
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
diff --git a/src/models/recording.py b/src/models/recording.py
new file mode 100644
index 00000000..6c4bd767
--- /dev/null
+++ b/src/models/recording.py
@@ -0,0 +1,343 @@
+"""
+Recording and TranscriptChunk database models.
+
+This module defines models for audio recordings and their chunked transcriptions.
+"""
+
+import logging
+import os
+from datetime import datetime
+from sqlalchemy import func
+from src.database import db
+from src.utils import local_datetime_filter, md_to_html
+
+logger = logging.getLogger(__name__)
+
+
+class Recording(db.Model):
+    """Main recording model storing audio files and their metadata."""
+
+    # Add user_id foreign key to associate recordings with users
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=True)
+    id = db.Column(db.Integer, primary_key=True)
+    # Title will now often be AI-generated, maybe start with filename?
+    title = db.Column(db.String(200), nullable=True)  # Allow Null initially
+    participants = db.Column(db.String(500))
+    notes = db.Column(db.Text)
+    transcription = db.Column(db.Text, nullable=True)
+    summary = db.Column(db.Text, nullable=True)
+    status = db.Column(db.String(50), default='PENDING')  # PENDING, PROCESSING, SUMMARIZING, COMPLETED, FAILED
+    audio_path = db.Column(db.String(500))
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    meeting_date = db.Column(db.DateTime, nullable=True)
+    file_size = db.Column(db.Integer)  # Store file size in bytes
+    original_filename = db.Column(db.String(500), nullable=True)  # Store the original uploaded filename
+    is_inbox = db.Column(db.Boolean, default=True)  # New recordings are marked as inbox by default
+    is_highlighted = db.Column(db.Boolean, default=False)  # Recordings can be highlighted by the user
+    mime_type = db.Column(db.String(100), nullable=True)
+    completed_at = db.Column(db.DateTime, nullable=True)
+    processing_time_seconds = db.Column(db.Integer, nullable=True)
+    transcription_duration_seconds = db.Column(db.Integer, nullable=True)  # Time taken for transcription
+    summarization_duration_seconds = db.Column(db.Integer, nullable=True)  # Time taken for summarization
+    processing_source = db.Column(db.String(50), default='upload')  # upload, auto_process, recording
+    error_message = db.Column(db.Text, nullable=True)  # Store detailed error messages
+    file_hash = db.Column(db.String(64), nullable=True)  # SHA-256 hash for duplicate detection
+
+    # Auto-deletion and archival fields
+    audio_deleted_at = db.Column(db.DateTime, nullable=True)  # When audio file was deleted (null = not deleted)
+    deletion_exempt = db.Column(db.Boolean, default=False)  # Manual exemption from auto-deletion
+
+    # Speaker embeddings from diarization (JSON dict mapping speaker IDs to 256-dimensional vectors)
+    speaker_embeddings = db.Column(db.JSON, nullable=True)
+
+    # Per-recording prompt-template variables (e.g. {"agenda": "...", "attendees": "..."}).
+    # Substituted into {{name}} placeholders in the resolved summary prompt at summarisation time.
+    prompt_variables = db.Column(db.JSON, nullable=True)
+
+    # Folder relationship (one-to-many: a recording belongs to at most one folder)
+    folder_id = db.Column(db.Integer, db.ForeignKey('folder.id', ondelete='SET NULL'), nullable=True, index=True)
+
+    # Relationships
+    folder = db.relationship('Folder', back_populates='recordings')
+    tag_associations = db.relationship('RecordingTag', back_populates='recording', cascade='all, delete-orphan', order_by='RecordingTag.order')
+
+    @property
+    def tags(self):
+        """Get tags ordered by the order they were added to this recording."""
+        return [assoc.tag for assoc in sorted(self.tag_associations, key=lambda x: x.order)]
+
+    def get_visible_tags(self, viewer_user):
+        """
+        Get tags that are visible to a specific user viewing this recording.
+
+        Visibility rules:
+        - Group tags: visible if viewer is a member of the tag's group
+        - Personal tags: visible only to the tag creator
+
+        Note: These rules apply to ALL users, including the recording owner.
+        Personal tags are private to their creator regardless of recording ownership.
+
+        Args:
+            viewer_user: User object viewing the recording (or None for backward compatibility)
+
+        Returns:
+            List of Tag objects visible to the viewer
+        """
+        # If no viewer specified, return all tags (backward compatibility)
+        if viewer_user is None:
+            return self.tags
+
+        if not self.tags:
+            return []
+
+        # Import here to avoid circular dependencies
+        from src.models.organization import GroupMembership
+
+        visible_tags = []
+        for tag in self.tags:
+            # Group tags: visible if viewer is a member of the group
+            if tag.group_id:
+                membership = GroupMembership.query.filter_by(
+                    group_id=tag.group_id,
+                    user_id=viewer_user.id
+                ).first()
+                if membership:
+                    visible_tags.append(tag)
+            # Personal tags: visible only to tag creator
+            else:
+                if tag.user_id == viewer_user.id:
+                    visible_tags.append(tag)
+
+        return visible_tags
+
+    def get_user_notes(self, user):
+        """
+        Get notes from user's perspective (owner or shared recipient).
+
+        - Recording owner sees Recording.notes
+        - Shared users see their personal_notes from SharedRecordingState
+
+        Args:
+            user: User object viewing the recording
+
+        Returns:
+            String notes content or None
+        """
+        if user is None:
+            return self.notes
+
+        if self.user_id == user.id:
+            return self.notes  # Owner sees Recording.notes
+        else:
+            # Shared user sees their personal notes
+            from src.models.sharing import SharedRecordingState
+            state = SharedRecordingState.query.filter_by(
+                recording_id=self.id,
+                user_id=user.id
+            ).first()
+            return state.personal_notes if state else None
+
+    def get_audio_duration(self):
+        """
+        Get the audio duration in seconds using ffprobe.
+
+        Returns:
+            Float duration in seconds, or None if unavailable
+        """
+        if self.audio_deleted_at is not None:
+            return None
+
+        if not self.audio_path or not os.path.exists(self.audio_path):
+            return None
+
+        try:
+            from src.utils.ffprobe import get_duration
+            # Allow longer timeout for packet scanning fallback on files without duration metadata
+            duration = get_duration(self.audio_path, timeout=30)
+            return duration
+        except Exception as e:
+            logger.warning(f"Failed to get duration for recording {self.id}: {e}")
+            return None
+
+    def get_duplicate_info(self):
+        """Check if other recordings share the same file_hash for this user.
+
+        Returns:
+            Dict with total copy count and list of copies, or None.
+        """
+        if not self.file_hash:
+            return None
+        dupes = Recording.query.filter(
+            Recording.user_id == self.user_id,
+            Recording.file_hash == self.file_hash,
+        ).with_entities(
+            Recording.id, Recording.title, Recording.created_at
+        ).order_by(Recording.created_at).all()
+        if len(dupes) > 1:
+            return {
+                'total_copies': len(dupes),
+                'copies': [
+                    {
+                        'id': d.id,
+                        'title': d.title or f'#{d.id}',
+                        'created_at': local_datetime_filter(d.created_at),
+                        'is_self': d.id == self.id
+                    }
+                    for d in dupes
+                ]
+            }
+        return None
+
+    def to_list_dict(self, viewer_user=None):
+        """
+        Lightweight dict for list views - excludes expensive HTML conversions.
+
+        Args:
+            viewer_user: User viewing the recording (for tag visibility filtering)
+        """
+        # Import here to avoid circular dependencies
+        from src.models.sharing import InternalShare, Share
+
+        # Count internal shares for this recording
+        shared_with_count = db.session.query(func.count(InternalShare.id)).filter(
+            InternalShare.recording_id == self.id
+        ).scalar() or 0
+
+        # Count public shares (link shares) for this recording
+        public_share_count = db.session.query(func.count(Share.id)).filter(
+            Share.recording_id == self.id
+        ).scalar() or 0
+
+        # Get visible tags for this viewer
+        visible_tags = self.get_visible_tags(viewer_user)
+
+        return {
+            'id': self.id,
+            'title': self.title,
+            'participants': self.participants,
+            'status': self.status,
+            'created_at': local_datetime_filter(self.created_at),
+            'completed_at': local_datetime_filter(self.completed_at),
+            'meeting_date': local_datetime_filter(self.meeting_date),
+            'file_size': self.file_size,
+            'original_filename': self.original_filename,
+            'is_inbox': self.is_inbox,
+            'is_highlighted': self.is_highlighted,
+            'audio_deleted_at': local_datetime_filter(self.audio_deleted_at),
+            'audio_available': self.audio_deleted_at is None,
+            'deletion_exempt': self.deletion_exempt,
+            'folder_id': self.folder_id,
+            'folder': self.folder.to_dict() if self.folder else None,
+            'tags': [tag.to_dict() for tag in visible_tags] if visible_tags else [],
+            'duplicate_info': self.get_duplicate_info(),
+            'shared_with_count': shared_with_count,
+            'public_share_count': public_share_count
+        }
+
+    def to_dict(self, include_html=True, viewer_user=None):
+        """
+        Full dict with optional HTML conversion for notes/summary.
+
+        Args:
+            include_html: Whether to include HTML-rendered markdown fields
+            viewer_user: User viewing the recording (for tag visibility filtering)
+        """
+        # Import here to avoid circular dependencies
+        from src.models.sharing import InternalShare, Share
+
+        # Count internal shares for this recording
+        shared_with_count = db.session.query(func.count(InternalShare.id)).filter(
+            InternalShare.recording_id == self.id
+        ).scalar() or 0
+
+        # Count public shares (link shares) for this recording
+        public_share_count = db.session.query(func.count(Share.id)).filter(
+            Share.recording_id == self.id
+        ).scalar() or 0
+
+        # Get visible tags for this viewer
+        visible_tags = self.get_visible_tags(viewer_user)
+
+        # Get user-specific notes
+        user_notes = self.get_user_notes(viewer_user)
+
+        data = {
+            'id': self.id,
+            'title': self.title,
+            'participants': self.participants,
+            'notes': user_notes,
+            'transcription': self.transcription,
+            'summary': self.summary,
+            'status': self.status,
+            'created_at': local_datetime_filter(self.created_at),
+            'completed_at': local_datetime_filter(self.completed_at),
+            'processing_time_seconds': self.processing_time_seconds,
+            'transcription_duration_seconds': self.transcription_duration_seconds,
+            'summarization_duration_seconds': self.summarization_duration_seconds,
+            'meeting_date': local_datetime_filter(self.meeting_date),
+            'file_size': self.file_size,
+            'original_filename': self.original_filename,
+            'user_id': self.user_id,
+            'is_inbox': self.is_inbox,
+            'is_highlighted': self.is_highlighted,
+            'mime_type': self.mime_type,
+            'audio_deleted_at': local_datetime_filter(self.audio_deleted_at),
+            'audio_available': self.audio_deleted_at is None,
+            'audio_duration': self.get_audio_duration(),
+            'deletion_exempt': self.deletion_exempt,
+            'folder_id': self.folder_id,
+            'folder': self.folder.to_dict() if self.folder else None,
+            'tags': [tag.to_dict() for tag in visible_tags] if visible_tags else [],
+            'events': [event.to_dict() for event in self.events] if self.events else [],
+            'prompt_variables': self.prompt_variables or {},
+            'duplicate_info': self.get_duplicate_info(),
+            'shared_with_count': shared_with_count,
+            'public_share_count': public_share_count
+        }
+
+        # Only compute expensive HTML conversions when explicitly requested
+        if include_html:
+            data['notes_html'] = md_to_html(user_notes) if user_notes else ""
+            data['summary_html'] = md_to_html(self.summary) if self.summary else ""
+        else:
+            data['notes_html'] = ""
+            data['summary_html'] = ""
+
+        return data
+
+
+class TranscriptChunk(db.Model):
+    """Stores chunked transcription segments for efficient retrieval and embedding."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id'), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    chunk_index = db.Column(db.Integer, nullable=False)  # Order within the recording
+    content = db.Column(db.Text, nullable=False)  # The actual text chunk
+    start_time = db.Column(db.Float, nullable=True)  # Start time in seconds (if available)
+    end_time = db.Column(db.Float, nullable=True)  # End time in seconds (if available)
+    speaker_name = db.Column(db.String(100), nullable=True, index=True)  # Speaker for this chunk (indexed for speaker rename operations)
+    embedding = db.Column(db.LargeBinary, nullable=True)  # Stored as binary vector
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Composite index for efficient speaker name lookups scoped to user
+    __table_args__ = (
+        db.Index('idx_user_speaker_name', 'user_id', 'speaker_name'),
+    )
+
+    # Relationships
+    recording = db.relationship('Recording', backref=db.backref('chunks', lazy=True, cascade='all, delete-orphan'))
+    user = db.relationship('User', backref=db.backref('transcript_chunks', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'recording_id': self.recording_id,
+            'chunk_index': self.chunk_index,
+            'content': self.content,
+            'start_time': self.start_time,
+            'end_time': self.end_time,
+            'speaker_name': self.speaker_name,
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
diff --git a/src/models/sharing.py b/src/models/sharing.py
new file mode 100644
index 00000000..6929f3f7
--- /dev/null
+++ b/src/models/sharing.py
@@ -0,0 +1,236 @@
+"""
+Sharing models for public and internal recording shares.
+
+This module defines models for sharing recordings both publicly (via links)
+and internally (between users).
+"""
+
+import os
+import secrets
+from datetime import datetime
+from src.database import db
+from src.utils import local_datetime_filter
+
+
+# Get sharing configuration from environment
+SHOW_USERNAMES_IN_UI = os.environ.get('SHOW_USERNAMES_IN_UI', 'false').lower() == 'true'
+
+
+class Share(db.Model):
+    """Public sharing via shareable links."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    public_id = db.Column(db.String(32), unique=True, nullable=False, default=lambda: secrets.token_urlsafe(16))
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id'), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    share_summary = db.Column(db.Boolean, default=True)
+    share_notes = db.Column(db.Boolean, default=True)
+
+    user = db.relationship('User', backref=db.backref('shares', lazy=True, cascade='all, delete-orphan'))
+    recording = db.relationship('Recording', backref=db.backref('shares', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'public_id': self.public_id,
+            'recording_id': self.recording_id,
+            'created_at': local_datetime_filter(self.created_at),
+            'share_summary': self.share_summary,
+            'share_notes': self.share_notes,
+            'recording_title': self.recording.title if self.recording else "N/A",
+            'audio_available': self.recording.audio_deleted_at is None if self.recording else True
+        }
+
+
+class InternalShare(db.Model):
+    """Tracks internal sharing of recordings between users (independent of teams)."""
+
+    __tablename__ = 'internal_share'
+
+    id = db.Column(db.Integer, primary_key=True)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id', ondelete='CASCADE'), nullable=False)
+    owner_id = db.Column(db.Integer, db.ForeignKey('user.id', ondelete='CASCADE'), nullable=False)  # User who shared
+    shared_with_user_id = db.Column(db.Integer, db.ForeignKey('user.id', ondelete='CASCADE'), nullable=False)  # User it was shared with
+
+    # Permissions
+    can_edit = db.Column(db.Boolean, default=False)  # Can edit notes/metadata
+    can_reshare = db.Column(db.Boolean, default=False)  # Can share with others
+
+    # Source tracking for share cleanup
+    source_type = db.Column(db.String(20), default='manual')  # 'manual' or 'group_tag'
+    source_tag_id = db.Column(db.Integer, db.ForeignKey('tag.id', ondelete='SET NULL'), nullable=True)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Relationship for source tag
+    source_tag = db.relationship('Tag', foreign_keys=[source_tag_id], backref=db.backref('created_shares', lazy=True))
+
+    # Relationships
+    recording = db.relationship('Recording', backref=db.backref('internal_shares', lazy=True, cascade='all, delete-orphan'))
+    owner = db.relationship('User', foreign_keys=[owner_id], backref=db.backref('shared_recordings', lazy=True, cascade='all, delete'))
+    shared_with = db.relationship('User', foreign_keys=[shared_with_user_id], backref=db.backref('received_shares', lazy=True, cascade='all, delete'))
+
+    # Unique constraint: can't share same recording with same user twice
+    __table_args__ = (db.UniqueConstraint('recording_id', 'shared_with_user_id', name='unique_recording_share'),)
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'recording_id': self.recording_id,
+            'owner_id': self.owner_id,
+            'owner_username': self.owner.username if SHOW_USERNAMES_IN_UI else None,
+            'user_id': self.shared_with_user_id,  # For frontend compatibility
+            'username': self.shared_with.username,  # Always include username
+            'can_edit': self.can_edit,
+            'can_reshare': self.can_reshare,
+            'source_type': self.source_type,
+            'source_tag_id': self.source_tag_id,
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
+
+    @staticmethod
+    def get_user_max_permissions(recording, user):
+        """
+        Get the maximum permissions a user can grant for a recording.
+
+        Args:
+            recording: Recording object
+            user: User object attempting to share
+
+        Returns:
+            Dict with 'can_edit' and 'can_reshare' boolean flags
+        """
+        # Owner has unlimited permissions
+        if recording.user_id == user.id:
+            return {'can_edit': True, 'can_reshare': True}
+
+        # Get user's share for this recording
+        user_share = InternalShare.query.filter_by(
+            recording_id=recording.id,
+            shared_with_user_id=user.id
+        ).first()
+
+        if not user_share:
+            # User has no access
+            return {'can_edit': False, 'can_reshare': False}
+
+        # User can only grant what they have
+        return {
+            'can_edit': user_share.can_edit,
+            'can_reshare': user_share.can_reshare
+        }
+
+    @staticmethod
+    def validate_reshare_permissions(recording, grantor_user, requested_permissions):
+        """
+        Validate that a user can grant the requested permissions.
+
+        Args:
+            recording: Recording object being shared
+            grantor_user: User attempting to share (current_user)
+            requested_permissions: Dict with 'can_edit' and 'can_reshare' flags
+
+        Returns:
+            Tuple of (is_valid: bool, error_message: str or None)
+        """
+        # Owner can grant anything
+        if recording.user_id == grantor_user.id:
+            return True, None
+
+        # Get grantor's permissions
+        max_permissions = InternalShare.get_user_max_permissions(recording, grantor_user)
+
+        # Validate edit permission
+        if requested_permissions.get('can_edit', False) and not max_permissions['can_edit']:
+            return False, "You cannot grant edit permission because you do not have edit access"
+
+        # Validate reshare permission
+        if requested_permissions.get('can_reshare', False) and not max_permissions['can_reshare']:
+            return False, "You cannot grant reshare permission because you do not have reshare access"
+
+        return True, None
+
+    @staticmethod
+    def find_downstream_shares(recording_id, user_id):
+        """
+        Find all shares created by a specific user for a recording.
+        Used for cascade revocation.
+
+        Args:
+            recording_id: ID of the recording
+            user_id: ID of the user whose downstream shares to find
+
+        Returns:
+            List of InternalShare objects
+        """
+        return InternalShare.query.filter_by(
+            recording_id=recording_id,
+            owner_id=user_id
+        ).all()
+
+    @staticmethod
+    def has_alternate_access_path(recording_id, user_id, excluding_grantor_id=None):
+        """
+        Check if a user has alternate access to a recording through other shares.
+        Used to prevent cascade revocation when user has multiple access paths (diamond pattern).
+
+        Args:
+            recording_id: ID of the recording
+            user_id: ID of the user to check
+            excluding_grantor_id: Exclude shares from this grantor (the one being revoked)
+
+        Returns:
+            Boolean - True if user has alternate access path
+        """
+        query = InternalShare.query.filter(
+            InternalShare.recording_id == recording_id,
+            InternalShare.shared_with_user_id == user_id
+        )
+
+        if excluding_grantor_id is not None:
+            query = query.filter(InternalShare.owner_id != excluding_grantor_id)
+
+        return query.count() > 0
+
+
+class SharedRecordingState(db.Model):
+    """Tracks per-user state for shared recordings (notes, highlights, etc)."""
+
+    __tablename__ = 'shared_recording_state'
+
+    id = db.Column(db.Integer, primary_key=True)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id', ondelete='CASCADE'), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id', ondelete='CASCADE'), nullable=False)
+
+    # User-specific state
+    personal_notes = db.Column(db.Text, nullable=True)  # Private notes only this user can see
+    is_inbox = db.Column(db.Boolean, default=True)  # User's personal inbox status
+    is_highlighted = db.Column(db.Boolean, default=False)  # User's personal highlight/favorite status
+    last_viewed = db.Column(db.DateTime, default=datetime.utcnow)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    recording = db.relationship('Recording', backref=db.backref('user_states', lazy=True, cascade='all, delete-orphan'))
+    user = db.relationship('User', backref=db.backref('recording_states', lazy=True, cascade='all, delete-orphan'))
+
+    # Unique constraint: one state per user per recording
+    __table_args__ = (db.UniqueConstraint('recording_id', 'user_id', name='unique_user_recording_state'),)
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'recording_id': self.recording_id,
+            'user_id': self.user_id,
+            'personal_notes': self.personal_notes,
+            'is_inbox': self.is_inbox,
+            'is_highlighted': self.is_highlighted,
+            'last_viewed': self.last_viewed.isoformat() if self.last_viewed else None,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
diff --git a/src/models/speaker_snippet.py b/src/models/speaker_snippet.py
new file mode 100644
index 00000000..53d77793
--- /dev/null
+++ b/src/models/speaker_snippet.py
@@ -0,0 +1,43 @@
+"""
+SpeakerSnippet database model.
+
+This module defines the SpeakerSnippet model for storing example quotes/snippets
+from recordings that feature specific speakers. These snippets provide context
+when viewing speaker profiles and help users verify speaker identifications.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class SpeakerSnippet(db.Model):
+    """Model for storing representative speech snippets from speakers."""
+
+    __tablename__ = 'speaker_snippet'
+
+    id = db.Column(db.Integer, primary_key=True)
+    speaker_id = db.Column(db.Integer, db.ForeignKey('speaker.id', ondelete='CASCADE'), nullable=False)
+    recording_id = db.Column(db.Integer, db.ForeignKey('recording.id', ondelete='CASCADE'), nullable=False)
+    segment_index = db.Column(db.Integer, nullable=False)  # Index in the transcript
+    text_snippet = db.Column(db.String(200), nullable=False)  # The actual quote
+    timestamp = db.Column(db.Float, nullable=True)  # Seconds into the recording
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+
+    # Relationships
+    speaker = db.relationship('Speaker', backref=db.backref('snippets', lazy=True, cascade='all, delete-orphan'))
+    recording = db.relationship('Recording', backref=db.backref('speaker_snippets', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'speaker_id': self.speaker_id,
+            'recording_id': self.recording_id,
+            'text': self.text_snippet,
+            'timestamp': self.timestamp,
+            'recording_title': self.recording.title if self.recording else 'Unknown',
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
+
+    def __repr__(self):
+        return f"SpeakerSnippet(speaker_id={self.speaker_id}, recording_id={self.recording_id}, text='{self.text_snippet[:30]}...')"
diff --git a/src/models/system.py b/src/models/system.py
new file mode 100644
index 00000000..a3aae988
--- /dev/null
+++ b/src/models/system.py
@@ -0,0 +1,77 @@
+"""
+SystemSetting model for application configuration.
+
+This module defines the SystemSetting model for storing
+dynamic system configuration in the database.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class SystemSetting(db.Model):
+    """Stores system-wide configuration settings."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    key = db.Column(db.String(100), unique=True, nullable=False)
+    value = db.Column(db.Text, nullable=True)
+    description = db.Column(db.Text, nullable=True)
+    setting_type = db.Column(db.String(50), nullable=False, default='string')  # string, integer, boolean, float
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'key': self.key,
+            'value': self.value,
+            'description': self.description,
+            'setting_type': self.setting_type,
+            'created_at': self.created_at,
+            'updated_at': self.updated_at
+        }
+
+    @staticmethod
+    def get_setting(key, default_value=None):
+        """Get a system setting value by key, with optional default."""
+        setting = SystemSetting.query.filter_by(key=key).first()
+        if setting:
+            # Convert value based on type
+            if setting.setting_type == 'integer':
+                try:
+                    return int(setting.value) if setting.value is not None else default_value
+                except (ValueError, TypeError):
+                    return default_value
+            elif setting.setting_type == 'boolean':
+                return setting.value.lower() in ('true', '1', 'yes') if setting.value else default_value
+            elif setting.setting_type == 'float':
+                try:
+                    return float(setting.value) if setting.value is not None else default_value
+                except (ValueError, TypeError):
+                    return default_value
+            else:  # string
+                return setting.value if setting.value is not None else default_value
+        return default_value
+
+    @staticmethod
+    def set_setting(key, value, description=None, setting_type='string'):
+        """Set a system setting value."""
+        setting = SystemSetting.query.filter_by(key=key).first()
+        if setting:
+            setting.value = str(value) if value is not None else None
+            setting.updated_at = datetime.utcnow()
+            if description:
+                setting.description = description
+            if setting_type:
+                setting.setting_type = setting_type
+        else:
+            setting = SystemSetting(
+                key=key,
+                value=str(value) if value is not None else None,
+                description=description,
+                setting_type=setting_type
+            )
+            db.session.add(setting)
+        db.session.commit()
+        return setting
diff --git a/src/models/templates.py b/src/models/templates.py
new file mode 100644
index 00000000..1d98da1b
--- /dev/null
+++ b/src/models/templates.py
@@ -0,0 +1,37 @@
+"""
+TranscriptTemplate model for user-defined transcript formatting.
+
+This module defines the TranscriptTemplate model for storing
+custom templates for transcript formatting.
+"""
+
+from datetime import datetime
+from src.database import db
+
+
+class TranscriptTemplate(db.Model):
+    """Stores user-defined templates for transcript formatting."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    name = db.Column(db.String(100), nullable=False)
+    template = db.Column(db.Text, nullable=False)
+    description = db.Column(db.String(500), nullable=True)
+    is_default = db.Column(db.Boolean, default=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('transcript_templates', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'template': self.template,
+            'description': self.description,
+            'is_default': self.is_default,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
diff --git a/src/models/token_usage.py b/src/models/token_usage.py
new file mode 100644
index 00000000..cd7461fd
--- /dev/null
+++ b/src/models/token_usage.py
@@ -0,0 +1,44 @@
+"""
+Token usage tracking model for monitoring LLM API consumption.
+"""
+
+from datetime import datetime, date
+from src.database import db
+
+
+class TokenUsage(db.Model):
+    """Daily token usage aggregates per user per operation type."""
+    __tablename__ = 'token_usage'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    date = db.Column(db.Date, nullable=False, default=date.today)
+    operation_type = db.Column(db.String(50), nullable=False)
+
+    # Token counts (from API response.usage)
+    prompt_tokens = db.Column(db.Integer, default=0)
+    completion_tokens = db.Column(db.Integer, default=0)
+    total_tokens = db.Column(db.Integer, default=0)
+
+    # Cost tracking (OpenRouter provides this)
+    cost = db.Column(db.Float, default=0.0)
+
+    # Request count for this day/operation
+    request_count = db.Column(db.Integer, default=0)
+
+    # Model info
+    model_name = db.Column(db.String(100), nullable=True)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('token_usage', lazy='dynamic', cascade='all, delete-orphan'))
+
+    __table_args__ = (
+        db.UniqueConstraint('user_id', 'date', 'operation_type', name='uq_user_date_op'),
+        db.Index('idx_token_user_date', 'user_id', 'date'),
+    )
+
+    def __repr__(self):
+        return f'<TokenUsage {self.user_id} {self.date} {self.operation_type}: {self.total_tokens}>'
diff --git a/src/models/transcription_usage.py b/src/models/transcription_usage.py
new file mode 100644
index 00000000..271e437d
--- /dev/null
+++ b/src/models/transcription_usage.py
@@ -0,0 +1,42 @@
+"""
+Transcription usage tracking model for monitoring audio transcription consumption.
+"""
+
+from datetime import datetime, date
+from src.database import db
+
+
+class TranscriptionUsage(db.Model):
+    """Daily transcription usage aggregates per user per connector type."""
+    __tablename__ = 'transcription_usage'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    date = db.Column(db.Date, nullable=False, default=date.today)
+    connector_type = db.Column(db.String(50), nullable=False)  # 'openai_whisper', 'openai_transcribe', 'asr_endpoint'
+
+    # Audio duration tracking (in seconds for precision)
+    audio_duration_seconds = db.Column(db.Integer, default=0)
+
+    # Cost tracking ($0 for self-hosted ASR)
+    estimated_cost = db.Column(db.Float, default=0.0)
+
+    # Request count for this day/connector
+    request_count = db.Column(db.Integer, default=0)
+
+    # Model info (e.g., 'whisper-1', 'gpt-4o-transcribe', 'asr-endpoint')
+    model_name = db.Column(db.String(100), nullable=True)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Relationships
+    user = db.relationship('User', backref=db.backref('transcription_usage', lazy='dynamic', cascade='all, delete-orphan'))
+
+    __table_args__ = (
+        db.UniqueConstraint('user_id', 'date', 'connector_type', name='uq_user_date_connector'),
+        db.Index('idx_transcription_user_date', 'user_id', 'date'),
+    )
+
+    def __repr__(self):
+        return f'<TranscriptionUsage {self.user_id} {self.date} {self.connector_type}: {self.audio_duration_seconds}s>'
diff --git a/src/models/user.py b/src/models/user.py
new file mode 100644
index 00000000..3e996faa
--- /dev/null
+++ b/src/models/user.py
@@ -0,0 +1,102 @@
+"""
+User and Speaker database models.
+
+This module defines the User model for authentication and user profiles,
+and the Speaker model for tracking speaker profiles used in diarization.
+"""
+
+from datetime import datetime
+from flask_login import UserMixin
+from src.database import db
+
+
+class User(db.Model, UserMixin):
+    """User model for authentication and profile management."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    username = db.Column(db.String(20), unique=True, nullable=False)
+    email = db.Column(db.String(120), unique=True, nullable=False)
+    password = db.Column(db.String(60), nullable=True)
+    sso_provider = db.Column(db.String(100), nullable=True)
+    sso_subject = db.Column(db.String(255), unique=True, nullable=True)
+    is_admin = db.Column(db.Boolean, default=False)
+    can_share_publicly = db.Column(db.Boolean, default=True)  # Permission to create public share links
+    recordings = db.relationship('Recording', backref='owner', lazy=True)
+    transcription_language = db.Column(db.String(10), nullable=True)  # For ISO 639-1 codes
+    output_language = db.Column(db.String(50), nullable=True)  # For full language names like "Spanish"
+    ui_language = db.Column(db.String(10), nullable=True, default='en')  # For UI language preference (en, es, fr, zh)
+    summary_prompt = db.Column(db.Text, nullable=True)
+    extract_events = db.Column(db.Boolean, default=False)  # Enable event extraction from transcripts
+    name = db.Column(db.String(100), nullable=True)
+    job_title = db.Column(db.String(100), nullable=True)
+    company = db.Column(db.String(100), nullable=True)
+    diarize = db.Column(db.Boolean, default=False)
+
+    # Default naming template for title generation
+    default_naming_template_id = db.Column(db.Integer, db.ForeignKey('naming_template.id', ondelete='SET NULL'), nullable=True)
+    default_naming_template = db.relationship('NamingTemplate', foreign_keys=[default_naming_template_id])
+
+    # Token budget (None = unlimited)
+    monthly_token_budget = db.Column(db.Integer, nullable=True)
+
+    # Transcription budget in seconds (None = unlimited)
+    monthly_transcription_budget = db.Column(db.Integer, nullable=True)
+
+    # Email verification fields
+    email_verified = db.Column(db.Boolean, default=False)
+    email_verification_token = db.Column(db.String(200), nullable=True, index=True)
+    email_verification_sent_at = db.Column(db.DateTime, nullable=True)
+
+    # Password reset fields
+    password_reset_token = db.Column(db.String(200), nullable=True, index=True)
+    password_reset_sent_at = db.Column(db.DateTime, nullable=True)
+
+    # Auto speaker labelling settings
+    auto_speaker_labelling = db.Column(db.Boolean, default=False)  # Enable auto-labelling when voice confidence exceeds threshold
+    auto_speaker_labelling_threshold = db.Column(db.String(10), nullable=True, default='medium')  # 'low', 'medium', 'high'
+
+    # Auto summarization setting (user can disable if admin hasn't globally disabled)
+    auto_summarization = db.Column(db.Boolean, default=True)
+
+    # Transcription hints (hotwords and initial prompt for improving ASR accuracy)
+    transcription_hotwords = db.Column(db.Text, nullable=True)
+    transcription_initial_prompt = db.Column(db.Text, nullable=True)
+
+    # UI/display preferences
+    show_timestamps_simple_view = db.Column(db.Boolean, default=False)
+    editor_autosave = db.Column(db.Boolean, default=False)
+
+    def __repr__(self):
+        return f"User('{self.username}', '{self.email}')"
+
+
+class Speaker(db.Model):
+    """Speaker model for tracking voice profiles used in diarization."""
+
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(100), nullable=False)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    last_used = db.Column(db.DateTime, default=datetime.utcnow)
+    use_count = db.Column(db.Integer, default=1)
+
+    # Voice embedding fields (256 dimensions from WhisperX)
+    average_embedding = db.Column(db.LargeBinary, nullable=True)  # Binary numpy array (256 × 4 bytes = 1024 bytes)
+    embeddings_history = db.Column(db.JSON, nullable=True)  # List of metadata: [{recording_id, timestamp, similarity}, ...]
+    embedding_count = db.Column(db.Integer, default=0)  # Number of embeddings collected
+    confidence_score = db.Column(db.Float, nullable=True)  # 0-1 score based on embedding consistency
+
+    # Relationship to user
+    user = db.relationship('User', backref=db.backref('speakers', lazy=True, cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        """Convert model to dictionary representation."""
+        return {
+            'id': self.id,
+            'name': self.name,
+            'created_at': self.created_at,
+            'last_used': self.last_used,
+            'use_count': self.use_count,
+            'embedding_count': self.embedding_count,
+            'confidence_score': self.confidence_score
+        }
diff --git a/src/services/__init__.py b/src/services/__init__.py
new file mode 100644
index 00000000..4aea0def
--- /dev/null
+++ b/src/services/__init__.py
@@ -0,0 +1,34 @@
+"""
+Service layer for business logic.
+"""
+
+from .embeddings import *
+from .llm import *
+from .document import *
+from .retention import *
+
+__all__ = [
+    # Embedding services
+    'get_embedding_model',
+    'chunk_transcription',
+    'generate_embeddings',
+    'serialize_embedding',
+    'deserialize_embedding',
+    'get_accessible_recording_ids',
+    'process_recording_chunks',
+    'basic_text_search_chunks',
+    'semantic_search_chunks',
+    # LLM services
+    'is_gpt5_model',
+    'is_using_openai_api',
+    'call_llm_completion',
+    'call_chat_completion',
+    'chat_client',
+    'format_api_error_message',
+    # Document services
+    'process_markdown_to_docx',
+    # Retention services
+    'is_recording_exempt_from_deletion',
+    'get_retention_days_for_recording',
+    'process_auto_deletion',
+]
diff --git a/src/services/calendar.py b/src/services/calendar.py
new file mode 100644
index 00000000..9266b436
--- /dev/null
+++ b/src/services/calendar.py
@@ -0,0 +1,102 @@
+"""
+Calendar/ICS file generation services.
+"""
+
+import json
+import uuid
+from datetime import datetime, timedelta
+
+
+def generate_ics_content(event):
+    """Generate ICS calendar file content for an event."""
+    import uuid
+    from datetime import datetime, timedelta
+
+    # Generate unique ID for the event
+    uid = f"{event.id}-{uuid.uuid4()}@speakr.app"
+
+    # Format dates in iCalendar format (YYYYMMDDTHHMMSS)
+    def format_ical_date(dt):
+        if dt:
+            return dt.strftime('%Y%m%dT%H%M%S')
+        return None
+
+    # Start building ICS content
+    lines = [
+        'BEGIN:VCALENDAR',
+        'VERSION:2.0',
+        'PRODID:-//Speakr//Event Export//EN',
+        'CALSCALE:GREGORIAN',
+        'METHOD:PUBLISH',
+        'BEGIN:VEVENT',
+        f'UID:{uid}',
+        f'DTSTAMP:{format_ical_date(datetime.utcnow())}',
+    ]
+
+    # Add event details
+    if event.start_datetime:
+        lines.append(f'DTSTART:{format_ical_date(event.start_datetime)}')
+
+    if event.end_datetime:
+        lines.append(f'DTEND:{format_ical_date(event.end_datetime)}')
+    elif event.start_datetime:
+        # If no end time, default to 1 hour after start
+        end_time = event.start_datetime + timedelta(hours=1)
+        lines.append(f'DTEND:{format_ical_date(end_time)}')
+
+    # Add title and description
+    lines.append(f'SUMMARY:{escape_ical_text(event.title)}')
+
+    if event.description:
+        lines.append(f'DESCRIPTION:{escape_ical_text(event.description)}')
+
+    # Add location if available
+    if event.location:
+        lines.append(f'LOCATION:{escape_ical_text(event.location)}')
+
+    # Add attendees if available
+    if event.attendees:
+        try:
+            attendees_list = json.loads(event.attendees)
+            for attendee in attendees_list:
+                if attendee:
+                    lines.append(f'ATTENDEE:CN={escape_ical_text(attendee)}:mailto:{attendee.replace(" ", ".").lower()}@example.com')
+        except:
+            pass
+
+    # Add reminder/alarm if specified
+    if event.reminder_minutes and event.reminder_minutes > 0:
+        lines.extend([
+            'BEGIN:VALARM',
+            'TRIGGER:-PT{}M'.format(event.reminder_minutes),
+            'ACTION:DISPLAY',
+            f'DESCRIPTION:Reminder: {escape_ical_text(event.title)}',
+            'END:VALARM'
+        ])
+
+    # Close event and calendar
+    lines.extend([
+        'STATUS:CONFIRMED',
+        'TRANSP:OPAQUE',
+        'END:VEVENT',
+        'END:VCALENDAR'
+    ])
+
+    return '\r\n'.join(lines)
+
+
+
+def escape_ical_text(text):
+    """Escape special characters for iCalendar format."""
+    if not text:
+        return ''
+    # Escape special characters
+    text = str(text)
+    text = text.replace('\\', '\\\\')
+    text = text.replace(',', '\\,')
+    text = text.replace(';', '\\;')
+    text = text.replace('\n', '\\n')
+    return text
+
+
+
diff --git a/src/services/document.py b/src/services/document.py
new file mode 100644
index 00000000..aae988a1
--- /dev/null
+++ b/src/services/document.py
@@ -0,0 +1,296 @@
+"""
+Document processing and conversion services.
+"""
+
+import re
+from docx import Document
+from docx.shared import Pt, RGBColor
+
+
+
+def process_markdown_to_docx(doc, content):
+    """Convert markdown content to properly formatted Word document elements.
+
+    Supports:
+    - Tables (markdown pipe tables)
+    - Headings (# ## ###)
+    - Bold text (**text**)
+    - Italic text (*text* or _text_)
+    - Bold italic (***text***)
+    - Inline code (`code`)
+    - Code blocks (```code```)
+    - Strikethrough (~~text~~)
+    - Links ([text](url))
+    - Bullet lists (- or *)
+    - Numbered lists (1. 2. 3.)
+    - Horizontal rules (--- or ***)
+    """
+    from docx.shared import RGBColor, Pt
+    from docx.enum.text import WD_PARAGRAPH_ALIGNMENT
+    from docx.oxml.ns import qn
+    import re
+
+    def ensure_unicode_font(run, text):
+        """Ensure the run uses a font that supports the characters in the text."""
+        # Check if text contains non-ASCII characters
+        try:
+            text.encode('ascii')
+            # Text is pure ASCII, no special font needed
+        except UnicodeEncodeError:
+            # Text contains non-ASCII characters, use a font with better Unicode support
+            # Use Arial for broad compatibility - it has good Unicode support on most systems
+            run.font.name = 'Arial'
+            # Set the East Asian font for CJK (Chinese, Japanese, Korean) text
+            # This ensures proper rendering in Word
+            r = run._element
+            r.rPr.rFonts.set(qn('w:eastAsia'), 'Arial')
+        return run
+
+    def add_formatted_run(paragraph, text):
+        """Add a run with inline formatting to a paragraph."""
+        if not text:
+            return
+
+        # Pattern for all inline formatting
+        # Order matters: check triple asterisk before double/single
+        patterns = [
+            (r'\*\*\*(.*?)\*\*\*', lambda p, t: (lambda r: (setattr(r, 'bold', True), setattr(r, 'italic', True), ensure_unicode_font(r, t)))(p.add_run(t))),  # Bold italic
+            (r'\*\*(.*?)\*\*', lambda p, t: (lambda r: (setattr(r, 'bold', True), ensure_unicode_font(r, t)))(p.add_run(t))),  # Bold
+            (r'(?<!\*)\*(?!\*)(.*?)\*(?!\*)', lambda p, t: (lambda r: (setattr(r, 'italic', True), ensure_unicode_font(r, t)))(p.add_run(t))),  # Italic with *
+            (r'\b_(.*?)_\b', lambda p, t: (lambda r: (setattr(r, 'italic', True), ensure_unicode_font(r, t)))(p.add_run(t))),  # Italic with _
+            (r'~~(.*?)~~', lambda p, t: (lambda r: (setattr(r, 'strike', True), ensure_unicode_font(r, t)))(p.add_run(t))),  # Strikethrough
+            (r'`([^`]+)`', lambda p, t: add_code_run(p, t)),  # Inline code
+            (r'\[([^\]]+)\]\(([^)]+)\)', lambda p, t, u: add_link_run(p, t, u)),  # Links
+        ]
+
+        def add_code_run(para, text):
+            """Add inline code with monospace font and background."""
+            run = para.add_run(text)
+            run.font.name = 'Courier New'
+            run.font.size = Pt(10)
+            run.font.color.rgb = RGBColor(220, 20, 60)  # Crimson color for code
+            # Check if we need Unicode support for code
+            try:
+                text.encode('ascii')
+            except UnicodeEncodeError:
+                # Use Consolas as fallback for better Unicode support in monospace
+                r = run._element
+                r.rPr.rFonts.set(qn('w:eastAsia'), 'Consolas')
+            return run
+
+        def add_link_run(para, text, url):
+            """Add a hyperlink-styled run (note: actual hyperlinks require more complex handling)."""
+            full_text = f"{text} ({url})"
+            run = para.add_run(full_text)
+            run.font.color.rgb = RGBColor(0, 0, 255)  # Blue color for links
+            run.font.underline = True
+            ensure_unicode_font(run, full_text)
+            return run
+
+        # Process the text with all patterns
+        remaining_text = text
+        while remaining_text:
+            earliest_match = None
+            earliest_pos = len(remaining_text)
+            matched_pattern = None
+
+            # Find the earliest matching pattern
+            for pattern, handler in patterns:
+                match = re.search(pattern, remaining_text)
+                if match and match.start() < earliest_pos:
+                    earliest_match = match
+                    earliest_pos = match.start()
+                    matched_pattern = handler
+
+            if earliest_match:
+                # Add text before the match
+                if earliest_pos > 0:
+                    run = paragraph.add_run(remaining_text[:earliest_pos])
+                    ensure_unicode_font(run, remaining_text[:earliest_pos])
+
+                # Apply formatting for the matched text
+                if '[' in earliest_match.group(0) and '](' in earliest_match.group(0):
+                    # Special handling for links (two groups)
+                    matched_pattern(paragraph, earliest_match.group(1), earliest_match.group(2))
+                else:
+                    matched_pattern(paragraph, earliest_match.group(1))
+
+                # Continue with remaining text
+                remaining_text = remaining_text[earliest_match.end():]
+            else:
+                # No more patterns, add the rest as plain text
+                run = paragraph.add_run(remaining_text)
+                ensure_unicode_font(run, remaining_text)
+                break
+
+    def parse_table(lines, start_idx):
+        """Parse a markdown table starting at the given index."""
+        if start_idx >= len(lines):
+            return None, start_idx
+
+        # Check if this looks like a table
+        if '|' not in lines[start_idx]:
+            return None, start_idx
+
+        table_data = []
+        idx = start_idx
+
+        while idx < len(lines) and '|' in lines[idx]:
+            # Skip separator lines
+            if re.match(r'^[\s\|\-:]+$', lines[idx]):
+                idx += 1
+                continue
+
+            # Parse cells
+            cells = [cell.strip() for cell in lines[idx].split('|')]
+            # Remove empty cells at start and end
+            if cells and not cells[0]:
+                cells = cells[1:]
+            if cells and not cells[-1]:
+                cells = cells[:-1]
+
+            if cells:
+                table_data.append(cells)
+            idx += 1
+
+        if table_data:
+            return table_data, idx
+        return None, start_idx
+
+    # Split content into lines
+    lines = content.split('\n')
+    i = 0
+    in_code_block = False
+    code_block_content = []
+
+    while i < len(lines):
+        line = lines[i]
+
+        # Handle code blocks
+        if line.strip().startswith('```'):
+            if not in_code_block:
+                in_code_block = True
+                code_block_content = []
+            else:
+                # End of code block - add it as preformatted text
+                in_code_block = False
+                if code_block_content:
+                    p = doc.add_paragraph()
+                    p.style = 'Normal'
+                    code_text = '\n'.join(code_block_content)
+                    run = p.add_run(code_text)
+                    run.font.name = 'Courier New'
+                    run.font.size = Pt(10)
+                    run.font.color.rgb = RGBColor(64, 64, 64)
+                    # Check if we need Unicode support for code blocks
+                    try:
+                        code_text.encode('ascii')
+                    except UnicodeEncodeError:
+                        r = run._element
+                        r.rPr.rFonts.set(qn('w:eastAsia'), 'Consolas')
+            i += 1
+            continue
+
+        if in_code_block:
+            code_block_content.append(line)
+            i += 1
+            continue
+
+        # Check for table
+        table_data, end_idx = parse_table(lines, i)
+        if table_data:
+            # Create Word table
+            table = doc.add_table(rows=len(table_data), cols=len(table_data[0]))
+            table.style = 'Table Grid'
+
+            # Populate table
+            for row_idx, row_data in enumerate(table_data):
+                for col_idx, cell_text in enumerate(row_data):
+                    if col_idx < len(table.rows[row_idx].cells):
+                        cell = table.rows[row_idx].cells[col_idx]
+                        # Clear existing paragraphs and add new one
+                        cell.text = ""
+                        p = cell.add_paragraph()
+                        add_formatted_run(p, cell_text)
+                        # Make header row bold
+                        if row_idx == 0:
+                            for run in p.runs:
+                                run.bold = True
+
+            doc.add_paragraph('')  # Space after table
+            i = end_idx
+            continue
+
+        line = line.rstrip()
+
+        # Skip empty lines
+        if not line:
+            doc.add_paragraph('')
+            i += 1
+            continue
+
+        # Horizontal rule
+        if re.match(r'^(\*{3,}|-{3,}|_{3,})$', line.strip()):
+            p = doc.add_paragraph('─' * 50)
+            p.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER
+            i += 1
+            continue
+
+        # Headings
+        if line.startswith('# '):
+            doc.add_heading(line[2:], 1)
+        elif line.startswith('## '):
+            doc.add_heading(line[3:], 2)
+        elif line.startswith('### '):
+            doc.add_heading(line[4:], 3)
+        elif line.startswith('#### '):
+            doc.add_heading(line[5:], 4)
+        # Bullet points
+        elif line.lstrip().startswith('- ') or line.lstrip().startswith('* '):
+            # Get the indentation level
+            indent = len(line) - len(line.lstrip())
+            bullet_text = line.lstrip()[2:]
+            p = doc.add_paragraph(style='List Bullet')
+            # Add indentation if nested
+            if indent > 0:
+                p.paragraph_format.left_indent = Pt(indent * 10)
+            add_formatted_run(p, bullet_text)
+        # Numbered lists
+        elif re.match(r'^\s*\d+\.', line):
+            match = re.match(r'^(\s*)(\d+)\.\s*(.*)', line)
+            if match:
+                indent = len(match.group(1))
+                list_text = match.group(3)
+                p = doc.add_paragraph(style='List Number')
+                if indent > 0:
+                    p.paragraph_format.left_indent = Pt(indent * 10)
+                add_formatted_run(p, list_text)
+        # Blockquote
+        elif line.startswith('> '):
+            p = doc.add_paragraph()
+            p.paragraph_format.left_indent = Pt(30)
+            add_formatted_run(p, line[2:])
+            # Add a gray color to indicate quote
+            for run in p.runs:
+                run.font.color.rgb = RGBColor(100, 100, 100)
+        else:
+            # Regular paragraph
+            p = doc.add_paragraph()
+            add_formatted_run(p, line)
+
+        i += 1
+
+# --- Database Models ---
+# --- Database Models ---
+# Models have been extracted to src/models/ and imported at the top of this file
+
+# --- Forms for Authentication ---
+# --- Custom Password Validator ---
+# password_check utility has been extracted to src/utils/security.py
+
+
+# --- Blueprint Registration ---
+# Import and register all blueprints for modular route organization
+
+
+
diff --git a/src/services/email.py b/src/services/email.py
new file mode 100644
index 00000000..a5f84d0d
--- /dev/null
+++ b/src/services/email.py
@@ -0,0 +1,443 @@
+"""
+Email service for verification and password reset.
+
+This module provides email functionality using Python's built-in smtplib.
+All email features are opt-in via environment variables.
+"""
+
+import os
+import smtplib
+import logging
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+from datetime import datetime, timedelta
+from typing import Optional
+
+from itsdangerous import URLSafeTimedSerializer, SignatureExpired, BadSignature
+from flask import current_app, url_for
+
+logger = logging.getLogger(__name__)
+
+# Token expiry times
+EMAIL_VERIFICATION_EXPIRY = 24 * 60 * 60  # 24 hours in seconds
+PASSWORD_RESET_EXPIRY = 1 * 60 * 60  # 1 hour in seconds
+
+
+def get_email_config():
+    """Get email configuration from environment variables."""
+    return {
+        'enabled': os.environ.get('ENABLE_EMAIL_VERIFICATION', 'false').lower() == 'true',
+        'required': os.environ.get('REQUIRE_EMAIL_VERIFICATION', 'false').lower() == 'true',
+        'smtp_host': os.environ.get('SMTP_HOST', ''),
+        'smtp_port': int(os.environ.get('SMTP_PORT', '587')),
+        'smtp_username': os.environ.get('SMTP_USERNAME', ''),
+        'smtp_password': os.environ.get('SMTP_PASSWORD', ''),
+        'smtp_use_tls': os.environ.get('SMTP_USE_TLS', 'true').lower() == 'true',
+        'smtp_use_ssl': os.environ.get('SMTP_USE_SSL', 'false').lower() == 'true',
+        'from_address': os.environ.get('SMTP_FROM_ADDRESS', 'noreply@yourdomain.com'),
+        'from_name': os.environ.get('SMTP_FROM_NAME', 'Speakr'),
+    }
+
+
+def is_email_verification_enabled() -> bool:
+    """Check if email verification is enabled."""
+    return get_email_config()['enabled']
+
+
+def is_email_verification_required() -> bool:
+    """Check if email verification is required for login."""
+    config = get_email_config()
+    return config['enabled'] and config['required']
+
+
+def is_smtp_configured() -> bool:
+    """Check if SMTP settings are properly configured."""
+    config = get_email_config()
+    return bool(config['smtp_host'] and config['smtp_username'] and config['smtp_password'])
+
+
+def get_serializer(salt: str) -> URLSafeTimedSerializer:
+    """Get a URL-safe timed serializer for token generation."""
+    secret_key = current_app.config.get('SECRET_KEY', 'default-dev-key')
+    return URLSafeTimedSerializer(secret_key, salt=salt)
+
+
+def generate_verification_token(user_id: int) -> str:
+    """Generate an email verification token."""
+    serializer = get_serializer('email-verification')
+    return serializer.dumps(user_id)
+
+
+def generate_password_reset_token(user_id: int) -> str:
+    """Generate a password reset token."""
+    serializer = get_serializer('password-reset')
+    return serializer.dumps(user_id)
+
+
+def verify_email_token(token: str) -> Optional[int]:
+    """
+    Verify an email verification token.
+
+    Returns the user_id if valid, None otherwise.
+    """
+    serializer = get_serializer('email-verification')
+    try:
+        user_id = serializer.loads(token, max_age=EMAIL_VERIFICATION_EXPIRY)
+        return user_id
+    except SignatureExpired:
+        logger.warning("Email verification token expired")
+        return None
+    except BadSignature:
+        logger.warning("Invalid email verification token")
+        return None
+
+
+def verify_reset_token(token: str) -> Optional[int]:
+    """
+    Verify a password reset token.
+
+    Returns the user_id if valid, None otherwise.
+    """
+    serializer = get_serializer('password-reset')
+    try:
+        user_id = serializer.loads(token, max_age=PASSWORD_RESET_EXPIRY)
+        return user_id
+    except SignatureExpired:
+        logger.warning("Password reset token expired")
+        return None
+    except BadSignature:
+        logger.warning("Invalid password reset token")
+        return None
+
+
+def _send_email(to_email: str, subject: str, html_body: str, text_body: str = None) -> bool:
+    """
+    Send an email using SMTP.
+
+    Returns True if successful, False otherwise.
+    """
+    config = get_email_config()
+
+    if not is_smtp_configured():
+        logger.error("SMTP is not configured. Cannot send email.")
+        return False
+
+    try:
+        msg = MIMEMultipart('alternative')
+        msg['Subject'] = subject
+        msg['From'] = f"{config['from_name']} <{config['from_address']}>"
+        msg['To'] = to_email
+
+        # Add plain text version
+        if text_body:
+            part1 = MIMEText(text_body, 'plain')
+            msg.attach(part1)
+
+        # Add HTML version
+        part2 = MIMEText(html_body, 'html')
+        msg.attach(part2)
+
+        # Connect to SMTP server
+        if config['smtp_use_ssl']:
+            server = smtplib.SMTP_SSL(config['smtp_host'], config['smtp_port'])
+        else:
+            server = smtplib.SMTP(config['smtp_host'], config['smtp_port'])
+            if config['smtp_use_tls']:
+                server.starttls()
+
+        server.login(config['smtp_username'], config['smtp_password'])
+        server.sendmail(config['from_address'], to_email, msg.as_string())
+        server.quit()
+
+        logger.info(f"Email sent successfully to {to_email}")
+        return True
+
+    except smtplib.SMTPAuthenticationError as e:
+        logger.error(f"SMTP authentication failed: {e}")
+        return False
+    except smtplib.SMTPException as e:
+        logger.error(f"SMTP error sending email: {e}")
+        return False
+    except Exception as e:
+        logger.error(f"Error sending email: {e}")
+        return False
+
+
+def _get_email_template(content_html: str, content_text: str, subject: str) -> tuple[str, str]:
+    """
+    Wrap content in the Speakr email template.
+
+    Returns (html_body, text_body)
+    """
+    # Get the base URL for the logo
+    try:
+        logo_url = url_for('static', filename='img/icon-192x192.png', _external=True)
+    except RuntimeError:
+        # Outside of request context, use a placeholder
+        logo_url = ""
+
+    html_body = f"""
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif; line-height: 1.6; color: #1f2937; margin: 0; padding: 0; background-color: #e8eaed;">
+    <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="background-color: #e8eaed;">
+        <tr>
+            <td style="padding: 40px 20px;">
+                <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="600" style="max-width: 600px; margin: 0 auto;">
+                    <!-- Header -->
+                    <tr>
+                        <td style="background-color: #2563eb; padding: 32px 40px; border-radius: 12px 12px 0 0;">
+                            <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+                                <tr>
+                                    <td>
+                                        <!-- Logo and Brand -->
+                                        <table role="presentation" cellspacing="0" cellpadding="0" border="0">
+                                            <tr>
+                                                <td style="vertical-align: middle; padding-right: 12px;">
+                                                    <img src="{logo_url}" alt="Speakr" width="44" height="44" style="display: block; border-radius: 8px;">
+                                                </td>
+                                                <td style="vertical-align: middle;">
+                                                    <h1 style="color: #ffffff; margin: 0; font-size: 28px; font-weight: 700; letter-spacing: -0.5px;">Speakr</h1>
+                                                </td>
+                                            </tr>
+                                        </table>
+                                    </td>
+                                </tr>
+                                <tr>
+                                    <td style="padding-top: 8px;">
+                                        <p style="color: rgba(255,255,255,0.85); margin: 0; font-size: 14px;">AI-Powered Audio Transcription</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+
+                    <!-- Content -->
+                    <tr>
+                        <td style="background-color: #ffffff; padding: 40px; border-left: 1px solid #e5e7eb; border-right: 1px solid #e5e7eb;">
+                            {content_html}
+                        </td>
+                    </tr>
+
+                    <!-- Footer -->
+                    <tr>
+                        <td style="background-color: #f8f9fa; padding: 24px 40px; border-radius: 0 0 12px 12px; border: 1px solid #e5e7eb; border-top: none;">
+                            <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+                                <tr>
+                                    <td style="text-align: center;">
+                                        <p style="color: #6b7280; font-size: 12px; margin: 0 0 8px 0;">
+                                            This email was sent by Speakr. If you have questions, please contact your administrator.
+                                        </p>
+                                        <p style="color: #9ca3af; font-size: 11px; margin: 0;">
+                                            &copy; {datetime.utcnow().year} Speakr &middot; AI-Powered Audio Transcription
+                                        </p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>
+"""
+
+    text_body = f"""
+{subject}
+{'=' * len(subject)}
+
+{content_text}
+
+---
+This email was sent by Speakr - AI-Powered Audio Transcription.
+If you have questions, please contact your administrator.
+"""
+
+    return html_body, text_body
+
+
+def send_verification_email(user) -> bool:
+    """
+    Send a verification email to a user.
+
+    Args:
+        user: User model instance
+
+    Returns True if email was sent successfully, False otherwise.
+    """
+    from src.database import db
+
+    if not is_email_verification_enabled():
+        logger.debug("Email verification is disabled")
+        return False
+
+    if not is_smtp_configured():
+        logger.warning("Cannot send verification email: SMTP not configured")
+        return False
+
+    # Generate token and store it
+    token = generate_verification_token(user.id)
+    user.email_verification_token = token
+    user.email_verification_sent_at = datetime.utcnow()
+    db.session.commit()
+
+    # Build verification URL
+    verify_url = url_for('auth.verify_email', token=token, _external=True)
+
+    subject = "Verify your email address - Speakr"
+
+    content_html = f"""
+<h2 style="color: #1f2937; margin: 0 0 24px 0; font-size: 24px; font-weight: 600;">Verify Your Email Address</h2>
+
+<p style="color: #374151; margin: 0 0 16px 0; font-size: 16px;">Hi {user.username},</p>
+
+<p style="color: #374151; margin: 0 0 24px 0; font-size: 16px;">
+    Welcome to Speakr! To complete your registration and start transcribing your audio recordings, please verify your email address.
+</p>
+
+<div style="text-align: center; margin: 32px 0;">
+    <a href="{verify_url}" style="display: inline-block; background-color: #2563eb; color: #ffffff; text-decoration: none; padding: 14px 32px; border-radius: 8px; font-weight: 600; font-size: 16px;">Verify Email Address</a>
+</div>
+
+<p style="color: #6b7280; font-size: 14px; margin: 24px 0 8px 0;">Or copy and paste this link into your browser:</p>
+<p style="word-break: break-all; color: #2563eb; font-size: 14px; margin: 0; padding: 12px; background-color: #f3f4f6; border-radius: 6px;">{verify_url}</p>
+
+<div style="margin-top: 32px; padding-top: 24px; border-top: 1px solid #e5e7eb;">
+    <p style="color: #9ca3af; font-size: 13px; margin: 0;">
+        <strong>This link will expire in 24 hours.</strong><br>
+        If you didn't create an account on Speakr, you can safely ignore this email.
+    </p>
+</div>
+"""
+
+    content_text = f"""Hi {user.username},
+
+Welcome to Speakr! To complete your registration and start transcribing your audio recordings, please verify your email address.
+
+Click here to verify: {verify_url}
+
+This link will expire in 24 hours.
+
+If you didn't create an account on Speakr, you can safely ignore this email."""
+
+    html_body, text_body = _get_email_template(content_html, content_text, subject)
+    return _send_email(user.email, subject, html_body, text_body)
+
+
+def send_password_reset_email(user) -> bool:
+    """
+    Send a password reset email to a user.
+
+    Args:
+        user: User model instance
+
+    Returns True if email was sent successfully, False otherwise.
+    """
+    from src.database import db
+
+    if not is_smtp_configured():
+        logger.warning("Cannot send password reset email: SMTP not configured")
+        return False
+
+    # Generate token and store it
+    token = generate_password_reset_token(user.id)
+    user.password_reset_token = token
+    user.password_reset_sent_at = datetime.utcnow()
+    db.session.commit()
+
+    # Build reset URL
+    reset_url = url_for('auth.reset_password', token=token, _external=True)
+
+    subject = "Reset your password - Speakr"
+
+    content_html = f"""
+<h2 style="color: #1f2937; margin: 0 0 24px 0; font-size: 24px; font-weight: 600;">Reset Your Password</h2>
+
+<p style="color: #374151; margin: 0 0 16px 0; font-size: 16px;">Hi {user.username},</p>
+
+<p style="color: #374151; margin: 0 0 24px 0; font-size: 16px;">
+    We received a request to reset your Speakr account password. Click the button below to create a new password.
+</p>
+
+<div style="text-align: center; margin: 32px 0;">
+    <a href="{reset_url}" style="display: inline-block; background-color: #2563eb; color: #ffffff; text-decoration: none; padding: 14px 32px; border-radius: 8px; font-weight: 600; font-size: 16px;">Reset Password</a>
+</div>
+
+<p style="color: #6b7280; font-size: 14px; margin: 24px 0 8px 0;">Or copy and paste this link into your browser:</p>
+<p style="word-break: break-all; color: #2563eb; font-size: 14px; margin: 0; padding: 12px; background-color: #f3f4f6; border-radius: 6px;">{reset_url}</p>
+
+<div style="margin-top: 32px; padding-top: 24px; border-top: 1px solid #e5e7eb;">
+    <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+        <tr>
+            <td style="width: 24px; vertical-align: top; padding-right: 12px;">
+                <span style="font-size: 18px;">⚠️</span>
+            </td>
+            <td>
+                <p style="color: #9ca3af; font-size: 13px; margin: 0;">
+                    <strong style="color: #6b7280;">This link will expire in 1 hour.</strong><br>
+                    If you didn't request a password reset, you can safely ignore this email. Your password will remain unchanged.
+                </p>
+            </td>
+        </tr>
+    </table>
+</div>
+"""
+
+    content_text = f"""Hi {user.username},
+
+We received a request to reset your Speakr account password. Click the link below to create a new password:
+
+{reset_url}
+
+This link will expire in 1 hour.
+
+If you didn't request a password reset, you can safely ignore this email. Your password will remain unchanged."""
+
+    html_body, text_body = _get_email_template(content_html, content_text, subject)
+    return _send_email(user.email, subject, html_body, text_body)
+
+
+def can_resend_verification(user) -> tuple[bool, Optional[int]]:
+    """
+    Check if a verification email can be resent.
+
+    Returns (can_resend, seconds_until_can_resend)
+    """
+    if not user.email_verification_sent_at:
+        return True, None
+
+    # Allow resend after 60 seconds
+    cooldown = timedelta(seconds=60)
+    time_since_last = datetime.utcnow() - user.email_verification_sent_at
+
+    if time_since_last >= cooldown:
+        return True, None
+
+    remaining = (cooldown - time_since_last).seconds
+    return False, remaining
+
+
+def can_resend_password_reset(user) -> tuple[bool, Optional[int]]:
+    """
+    Check if a password reset email can be resent.
+
+    Returns (can_resend, seconds_until_can_resend)
+    """
+    if not user.password_reset_sent_at:
+        return True, None
+
+    # Allow resend after 60 seconds
+    cooldown = timedelta(seconds=60)
+    time_since_last = datetime.utcnow() - user.password_reset_sent_at
+
+    if time_since_last >= cooldown:
+        return True, None
+
+    remaining = (cooldown - time_since_last).seconds
+    return False, remaining
diff --git a/src/services/embeddings.py b/src/services/embeddings.py
new file mode 100644
index 00000000..90f8b365
--- /dev/null
+++ b/src/services/embeddings.py
@@ -0,0 +1,680 @@
+"""
+Embedding generation and semantic search services.
+"""
+
+import os
+import time
+import random
+import numpy as np
+from flask import current_app
+from sqlalchemy.orm import joinedload
+
+try:
+    from sentence_transformers import SentenceTransformer
+    from sklearn.metrics.pairwise import cosine_similarity
+    LOCAL_EMBEDDINGS_AVAILABLE = True
+except ImportError:
+    LOCAL_EMBEDDINGS_AVAILABLE = False
+    SentenceTransformer = None  # type: ignore
+    cosine_similarity = None
+
+# sklearn's cosine_similarity may be available even when sentence-transformers
+# is not (e.g., the lite image with API-mode embeddings). Try to import it
+# independently so semantic search can still run on API-generated vectors.
+if cosine_similarity is None:
+    try:
+        from sklearn.metrics.pairwise import cosine_similarity  # type: ignore
+    except ImportError:
+        cosine_similarity = None
+
+from src.database import db
+from src.models import Recording, TranscriptChunk, InternalShare, RecordingTag
+
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+
+# Embedding model used to generate semantic-search vectors. By default Speakr
+# loads sentence-transformers locally; setting EMBEDDING_BASE_URL switches to
+# an OpenAI-compatible HTTP endpoint (vLLM, OpenRouter, OpenAI directly, etc.)
+# and the same EMBEDDING_MODEL value is sent as the model name in requests.
+# Changing the model or the endpoint after chunks are already embedded will
+# produce a dimensionality / semantic-space mismatch; see the startup warning
+# in src/init_db.py and the docs for guidance.
+EMBEDDING_MODEL = os.environ.get('EMBEDDING_MODEL', 'all-MiniLM-L6-v2').strip() or 'all-MiniLM-L6-v2'
+EMBEDDING_BASE_URL = os.environ.get('EMBEDDING_BASE_URL', '').strip()
+EMBEDDING_API_KEY = os.environ.get('EMBEDDING_API_KEY', '').strip()
+_dim_raw = os.environ.get('EMBEDDING_DIMENSIONS', '').strip()
+try:
+    EMBEDDING_DIMENSIONS = int(_dim_raw) if _dim_raw else None
+except (TypeError, ValueError):
+    EMBEDDING_DIMENSIONS = None
+
+# When EMBEDDING_BASE_URL is set, embeddings are produced via an OpenAI-
+# compatible /v1/embeddings call rather than locally.
+USE_API_EMBEDDINGS = bool(EMBEDDING_BASE_URL)
+
+# Identifier persisted to system_setting so the dimensionality compatibility
+# check covers both "model changed" and "provider changed" scenarios.
+EMBEDDING_IDENTIFIER = f"{EMBEDDING_BASE_URL or 'local'}::{EMBEDDING_MODEL}"
+
+# True when at least one embedding path can produce vectors. The legacy name
+# EMBEDDINGS_AVAILABLE is preserved for callers that import it elsewhere.
+EMBEDDINGS_AVAILABLE = LOCAL_EMBEDDINGS_AVAILABLE or (USE_API_EMBEDDINGS and cosine_similarity is not None)
+
+# Initialize embedding model (lazy loading)
+_embedding_model = None
+_embedding_api_client = None
+
+
+
+def get_embedding_model():
+    """Get or initialize the local sentence transformer model.
+
+    Returns None when running in API mode or when sentence-transformers is
+    not installed.
+    """
+    global _embedding_model
+
+    if USE_API_EMBEDDINGS or not LOCAL_EMBEDDINGS_AVAILABLE:
+        return None
+
+    if _embedding_model is None:
+        try:
+            _embedding_model = SentenceTransformer(EMBEDDING_MODEL)
+            current_app.logger.info(f"Embedding model loaded successfully: {EMBEDDING_MODEL}")
+        except Exception as e:
+            current_app.logger.error(f"Failed to load embedding model {EMBEDDING_MODEL!r}: {e}")
+            return None
+    return _embedding_model
+
+
+def get_embedding_api_client():
+    """Get or initialize the OpenAI-compatible embeddings API client.
+
+    Returns None when API mode is disabled or the openai package is missing.
+    """
+    global _embedding_api_client
+
+    if not USE_API_EMBEDDINGS:
+        return None
+
+    if _embedding_api_client is None:
+        try:
+            from openai import OpenAI
+            from src.services.llm import llm_timeout, LLM_MAX_RETRIES, http_client_no_proxy
+            _embedding_api_client = OpenAI(
+                api_key=EMBEDDING_API_KEY or "not-needed",
+                base_url=EMBEDDING_BASE_URL,
+                http_client=http_client_no_proxy,
+                timeout=llm_timeout,
+                max_retries=LLM_MAX_RETRIES,
+            )
+            current_app.logger.info(
+                f"Embedding API client initialized: base_url={EMBEDDING_BASE_URL}, model={EMBEDDING_MODEL}"
+            )
+        except Exception as e:
+            current_app.logger.error(f"Failed to initialize embedding API client: {e}")
+            return None
+    return _embedding_api_client
+
+
+_API_EMBED_MAX_ATTEMPTS = int(os.environ.get('EMBEDDING_API_MAX_RETRIES', '3'))
+_API_EMBED_BASE_BACKOFF_SECONDS = float(os.environ.get('EMBEDDING_API_BACKOFF_SECONDS', '1.5'))
+
+# Substrings of error messages that suggest the failure is transient and
+# worth retrying. Auth and model-not-found errors do not match and fail fast.
+_TRANSIENT_ERROR_HINTS = (
+    'timeout', 'timed out', 'connection', 'connect',
+    'rate limit', 'rate_limit', 'too many requests', '429',
+    '500', '502', '503', '504',
+    'temporarily unavailable', 'service unavailable',
+    'overloaded', 'try again',
+)
+
+
+def _is_transient_embedding_error(exc):
+    """Decide whether an embedding-API error is worth retrying."""
+    msg = str(exc).lower()
+    return any(hint in msg for hint in _TRANSIENT_ERROR_HINTS)
+
+
+def _api_embed(texts, user_id=None):
+    """Call the OpenAI-compatible embeddings endpoint and return numpy vectors.
+
+    Retries on transient errors (rate limits, timeouts, 5xx, connection
+    blips) with exponential backoff. Auth or model-not-found errors fail
+    fast since retrying will not help. On permanent failure, returns an
+    empty list so callers see a clear sentinel; ``process_recording_chunks``
+    treats a length mismatch between input and output as a failure and
+    rolls back, so the recording's existing chunks are preserved instead
+    of being silently deleted with nothing inserted in their place.
+
+    Retry parameters are tunable via ``EMBEDDING_API_MAX_RETRIES`` (default
+    3) and ``EMBEDDING_API_BACKOFF_SECONDS`` (default 1.5).
+
+    When ``user_id`` is provided and the response includes a ``usage``
+    block, record the call against the daily token-usage aggregate.
+    """
+    client = get_embedding_api_client()
+    if client is None or not texts:
+        return []
+
+    kwargs = {'input': texts, 'model': EMBEDDING_MODEL}
+    if EMBEDDING_DIMENSIONS is not None:
+        kwargs['dimensions'] = EMBEDDING_DIMENSIONS
+
+    last_exc = None
+    for attempt in range(1, _API_EMBED_MAX_ATTEMPTS + 1):
+        try:
+            response = client.embeddings.create(**kwargs)
+
+            if user_id is not None and getattr(response, 'usage', None) is not None:
+                try:
+                    usage = response.usage
+                    # Pydantic v2 stores non-schema fields under model_extra;
+                    # fall back to attribute access for SDKs that surface them
+                    # directly.
+                    extras = getattr(usage, 'model_extra', None) or {}
+                    prompt_tokens = getattr(usage, 'prompt_tokens', 0) or 0
+                    total_tokens = getattr(usage, 'total_tokens', prompt_tokens) or prompt_tokens
+                    cost = extras.get('cost') if 'cost' in extras else getattr(usage, 'cost', None)
+                    from src.services.token_tracking import token_tracker
+                    token_tracker.record_usage(
+                        user_id=user_id,
+                        operation_type='embedding',
+                        prompt_tokens=int(prompt_tokens),
+                        completion_tokens=0,
+                        total_tokens=int(total_tokens),
+                        model_name=EMBEDDING_MODEL,
+                        cost=float(cost) if cost is not None else None,
+                    )
+                except Exception as track_err:
+                    current_app.logger.warning(f"Failed to record embedding usage: {track_err}")
+
+            return [np.array(d.embedding, dtype=np.float32) for d in response.data]
+
+        except Exception as e:
+            last_exc = e
+            transient = _is_transient_embedding_error(e)
+            if not transient or attempt == _API_EMBED_MAX_ATTEMPTS:
+                current_app.logger.error(
+                    f"Embedding API call failed (attempt {attempt}/{_API_EMBED_MAX_ATTEMPTS}, "
+                    f"transient={transient}): {e}"
+                )
+                return []
+            # Exponential backoff with light jitter so concurrent retries
+            # do not all hit the provider at the same instant.
+            backoff = _API_EMBED_BASE_BACKOFF_SECONDS * (2 ** (attempt - 1))
+            backoff *= 0.85 + 0.3 * random.random()
+            current_app.logger.warning(
+                f"Embedding API transient error (attempt {attempt}/{_API_EMBED_MAX_ATTEMPTS}), "
+                f"retrying in {backoff:.1f}s: {e}"
+            )
+            time.sleep(backoff)
+
+    # Loop exhausted without returning a result.
+    current_app.logger.error(f"Embedding API call exhausted retries: {last_exc}")
+    return []
+
+
+
+def chunk_transcription(transcription, max_chunk_length=500, overlap=50):
+    """
+    Split transcription into overlapping chunks for better context retrieval.
+    
+    Args:
+        transcription (str): The full transcription text
+        max_chunk_length (int): Maximum characters per chunk
+        overlap (int): Character overlap between chunks
+    
+    Returns:
+        list: List of text chunks
+    """
+    if not transcription or len(transcription) <= max_chunk_length:
+        return [transcription] if transcription else []
+    
+    chunks = []
+    start = 0
+    
+    while start < len(transcription):
+        end = start + max_chunk_length
+        
+        # Try to break at sentence boundaries
+        if end < len(transcription):
+            # Look for sentence endings within the last 100 characters
+            sentence_end = -1
+            for i in range(max(0, end - 100), end):
+                if transcription[i] in '.!?':
+                    # Check if it's not an abbreviation
+                    if i + 1 < len(transcription) and transcription[i + 1].isspace():
+                        sentence_end = i + 1
+            
+            if sentence_end > start:
+                end = sentence_end
+        
+        chunk = transcription[start:end].strip()
+        if chunk:
+            chunks.append(chunk)
+        
+        # Move start position with overlap
+        start = max(start + 1, end - overlap)
+        
+        # Prevent infinite loop
+        if start >= len(transcription):
+            break
+    
+    return chunks
+
+
+
+def generate_embeddings(texts, user_id=None):
+    """
+    Generate embeddings for a list of texts.
+
+    Routes through the OpenAI-compatible API when EMBEDDING_BASE_URL is set;
+    otherwise uses the locally loaded sentence-transformers model.
+
+    Args:
+        texts (list): List of text strings
+        user_id (int, optional): User to attribute the API call to for token
+            and cost tracking. Local-mode calls do not consume billable usage
+            and ignore this argument.
+
+    Returns:
+        list: List of embedding vectors as numpy arrays, or empty list if no
+        embedding path is available.
+    """
+    if not texts:
+        return []
+
+    if USE_API_EMBEDDINGS:
+        return _api_embed(texts, user_id=user_id)
+
+    if not LOCAL_EMBEDDINGS_AVAILABLE:
+        current_app.logger.warning("Embeddings not available - skipping embedding generation")
+        return []
+
+    model = get_embedding_model()
+    if not model:
+        return []
+
+    try:
+        embeddings = model.encode(texts)
+        return [embedding.astype(np.float32) for embedding in embeddings]
+    except Exception as e:
+        current_app.logger.error(f"Error generating embeddings: {e}")
+        return []
+
+
+
+def serialize_embedding(embedding):
+    """Convert numpy array to binary for database storage."""
+    if embedding is None or not EMBEDDINGS_AVAILABLE:
+        return None
+    return embedding.tobytes()
+
+
+
+def deserialize_embedding(binary_data):
+    """Convert binary data back to numpy array."""
+    if binary_data is None or not EMBEDDINGS_AVAILABLE:
+        return None
+    return np.frombuffer(binary_data, dtype=np.float32)
+
+
+
+def get_accessible_recording_ids(user_id):
+    """
+    Get all recording IDs that a user has access to.
+
+    Includes:
+    - Recordings owned by the user
+    - Recordings shared with the user via InternalShare
+    - Recordings shared via group tags (if team membership exists)
+
+    Args:
+        user_id (int): User ID to check access for
+
+    Returns:
+        list: List of recording IDs the user can access
+    """
+    accessible_ids = set()
+
+    # 1. User's own recordings
+    own_recordings = db.session.query(Recording.id).filter_by(user_id=user_id).all()
+    accessible_ids.update([r.id for r in own_recordings])
+
+    # 2. Internally shared recordings
+    if ENABLE_INTERNAL_SHARING:
+        shared_recordings = db.session.query(InternalShare.recording_id).filter_by(
+            shared_with_user_id=user_id
+        ).all()
+        accessible_ids.update([r.recording_id for r in shared_recordings])
+
+    return list(accessible_ids)
+
+
+
+def process_recording_chunks(recording_id):
+    """
+    Process a recording by creating chunks and generating embeddings.
+
+    Returns True on full success, False on any failure including the case
+    where embedding generation returned fewer vectors than there were
+    chunks. On failure the transaction is rolled back so the recording's
+    existing chunks are preserved; this prevents the "old chunks deleted,
+    new chunks not inserted" silent-failure mode that occurs when the
+    embedding API blips mid-run.
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording or not recording.transcription:
+            return False
+
+        # Delete existing chunks for this recording. The deletion is staged
+        # in this transaction; if anything below fails we rollback and the
+        # old chunks survive. Only the final commit makes the swap
+        # permanent.
+        TranscriptChunk.query.filter_by(recording_id=recording_id).delete()
+
+        # Create chunks
+        chunks = chunk_transcription(recording.transcription)
+
+        if not chunks:
+            db.session.commit()
+            return True
+
+        # Generate embeddings (recording owner gets billed for API-mode usage)
+        embeddings = generate_embeddings(chunks, user_id=recording.user_id)
+
+        # Verify we got one embedding per chunk. _api_embed returns [] on
+        # exhausted retries, and a partial provider response could return
+        # fewer than expected. Either case is a failure: rolling back keeps
+        # the recording's old chunks intact so the admin retry pass (or a
+        # later Re-embed all) can try again.
+        if len(embeddings) != len(chunks):
+            db.session.rollback()
+            current_app.logger.error(
+                f"Embedding generation returned {len(embeddings)} vectors for "
+                f"{len(chunks)} chunks on recording {recording_id}; rolling "
+                f"back to preserve existing chunks."
+            )
+            return False
+
+        # Store chunks in database
+        for i, (chunk_text, embedding) in enumerate(zip(chunks, embeddings)):
+            chunk = TranscriptChunk(
+                recording_id=recording_id,
+                user_id=recording.user_id,
+                chunk_index=i,
+                content=chunk_text,
+                embedding=serialize_embedding(embedding) if embedding is not None else None
+            )
+            db.session.add(chunk)
+
+        db.session.commit()
+        current_app.logger.info(f"Created {len(chunks)} chunks for recording {recording_id}")
+        return True
+
+    except Exception as e:
+        current_app.logger.error(f"Error processing chunks for recording {recording_id}: {e}")
+        db.session.rollback()
+        return False
+
+
+
+def basic_text_search_chunks(user_id, query, filters=None, top_k=5):
+    """
+    Basic text search fallback when embeddings are not available.
+    Uses simple text matching instead of semantic search.
+    Searches across user's own recordings and recordings shared with them.
+    """
+    try:
+        # Get all accessible recording IDs (own + shared)
+        accessible_recording_ids = get_accessible_recording_ids(user_id)
+
+        if not accessible_recording_ids:
+            return []
+
+        # Build base query for chunks from accessible recordings with eager loading
+        chunks_query = TranscriptChunk.query.options(joinedload(TranscriptChunk.recording)).filter(
+            TranscriptChunk.recording_id.in_(accessible_recording_ids)
+        )
+        
+        # Apply filters if provided
+        if filters:
+            if filters.get('tag_ids'):
+                chunks_query = chunks_query.join(Recording).join(
+                    RecordingTag, Recording.id == RecordingTag.recording_id
+                ).filter(RecordingTag.tag_id.in_(filters['tag_ids']))
+            
+            if filters.get('speaker_names'):
+                # Filter by participants field in recordings instead of chunk speaker_name
+                if not any(hasattr(desc, 'name') and desc.name == 'recording' for desc in chunks_query.column_descriptions):
+                    chunks_query = chunks_query.join(Recording)
+                
+                # Build OR conditions for each speaker name in participants
+                speaker_conditions = []
+                for speaker_name in filters['speaker_names']:
+                    speaker_conditions.append(
+                        Recording.participants.ilike(f'%{speaker_name}%')
+                    )
+                
+                chunks_query = chunks_query.filter(db.or_(*speaker_conditions))
+                current_app.logger.info(f"Applied speaker filter for: {filters['speaker_names']}")
+            
+            if filters.get('recording_ids'):
+                chunks_query = chunks_query.filter(
+                    TranscriptChunk.recording_id.in_(filters['recording_ids'])
+                )
+            
+            if filters.get('date_from') or filters.get('date_to'):
+                chunks_query = chunks_query.join(Recording)
+                if filters.get('date_from'):
+                    chunks_query = chunks_query.filter(Recording.meeting_date >= filters['date_from'])
+                if filters.get('date_to'):
+                    chunks_query = chunks_query.filter(Recording.meeting_date <= filters['date_to'])
+        
+        # Text search - filter stop words and rank by match count
+        stop_words = {'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been',
+                       'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will',
+                       'would', 'could', 'should', 'may', 'might', 'shall', 'can',
+                       'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from',
+                       'up', 'about', 'into', 'through', 'during', 'before', 'after',
+                       'and', 'but', 'or', 'nor', 'not', 'so', 'yet', 'both',
+                       'it', 'its', 'this', 'that', 'these', 'those', 'what', 'which',
+                       'who', 'whom', 'how', 'when', 'where', 'why',
+                       'i', 'me', 'my', 'we', 'our', 'you', 'your', 'he', 'she',
+                       'his', 'her', 'they', 'them', 'their'}
+
+        query_words = [w for w in query.lower().split() if w not in stop_words and len(w) > 1]
+
+        if not query_words:
+            # If all words were stop words, fall back to using original query words
+            query_words = [w for w in query.lower().split() if len(w) > 1]
+
+        if query_words:
+            from sqlalchemy import or_, func, case, literal
+
+            # Filter: match ANY keyword (OR) to get candidates
+            text_conditions = []
+            for word in query_words:
+                text_conditions.append(TranscriptChunk.content.ilike(f'%{word}%'))
+            chunks_query = chunks_query.filter(or_(*text_conditions))
+
+            # Fetch more candidates than needed so we can rank them
+            chunks = chunks_query.limit(top_k * 5).all()
+
+            # Rank by how many query words each chunk matches
+            scored_chunks = []
+            for chunk in chunks:
+                content_lower = chunk.content.lower()
+                match_count = sum(1 for word in query_words if word in content_lower)
+                score = match_count / len(query_words)  # 0.0 to 1.0
+                scored_chunks.append((chunk, score))
+
+            # Sort by score descending, take top_k
+            scored_chunks.sort(key=lambda x: x[1], reverse=True)
+            return scored_chunks[:top_k]
+
+        # No usable query words
+        return []
+        
+    except Exception as e:
+        current_app.logger.error(f"Error in basic text search: {e}")
+        return []
+
+
+
+def semantic_search_chunks(user_id, query, filters=None, top_k=5):
+    """
+    Perform semantic search on transcript chunks with filtering.
+    Searches across user's own recordings and recordings shared with them.
+
+    Args:
+        user_id (int): User ID for permission filtering
+        query (str): Search query
+        filters (dict): Optional filters for tags, speakers, dates, recording_ids
+        top_k (int): Number of top chunks to return
+
+    Returns:
+        list: List of relevant chunks with similarity scores
+    """
+    try:
+        # If embeddings are not available, fall back to basic text search
+        if not EMBEDDINGS_AVAILABLE:
+            current_app.logger.info("Embeddings not available - using basic text search as fallback")
+            return basic_text_search_chunks(user_id, query, filters, top_k)
+
+        if cosine_similarity is None:
+            current_app.logger.info("scikit-learn not installed - using basic text search as fallback")
+            return basic_text_search_chunks(user_id, query, filters, top_k)
+
+        # Generate embedding for the query (via API or local model). Attribute
+        # the API call to the searching user so embedding cost tracking shows
+        # who issued the query.
+        if USE_API_EMBEDDINGS:
+            api_vectors = _api_embed([query], user_id=user_id)
+            if not api_vectors:
+                return basic_text_search_chunks(user_id, query, filters, top_k)
+            query_embedding = api_vectors[0]
+        else:
+            model = get_embedding_model()
+            if not model:
+                return basic_text_search_chunks(user_id, query, filters, top_k)
+            query_embedding = model.encode([query])[0]
+
+        # Get all accessible recording IDs (own + shared)
+        accessible_recording_ids = get_accessible_recording_ids(user_id)
+
+        if not accessible_recording_ids:
+            return []
+
+        # Build base query for chunks from accessible recordings with eager loading
+        chunks_query = TranscriptChunk.query.options(joinedload(TranscriptChunk.recording)).filter(
+            TranscriptChunk.recording_id.in_(accessible_recording_ids)
+        )
+        
+        # Apply filters if provided
+        if filters:
+            if filters.get('tag_ids'):
+                # Join with recordings that have specified tags
+                chunks_query = chunks_query.join(Recording).join(
+                    RecordingTag, Recording.id == RecordingTag.recording_id
+                ).filter(RecordingTag.tag_id.in_(filters['tag_ids']))
+            
+            if filters.get('speaker_names'):
+                # Filter by participants field in recordings instead of chunk speaker_name
+                if not any(hasattr(desc, 'name') and desc.name == 'recording' for desc in chunks_query.column_descriptions):
+                    chunks_query = chunks_query.join(Recording)
+                
+                # Build OR conditions for each speaker name in participants
+                speaker_conditions = []
+                for speaker_name in filters['speaker_names']:
+                    speaker_conditions.append(
+                        Recording.participants.ilike(f'%{speaker_name}%')
+                    )
+                
+                chunks_query = chunks_query.filter(db.or_(*speaker_conditions))
+                current_app.logger.info(f"Applied speaker filter for: {filters['speaker_names']}")
+            
+            if filters.get('recording_ids'):
+                chunks_query = chunks_query.filter(
+                    TranscriptChunk.recording_id.in_(filters['recording_ids'])
+                )
+            
+            if filters.get('date_from') or filters.get('date_to'):
+                chunks_query = chunks_query.join(Recording)
+                if filters.get('date_from'):
+                    chunks_query = chunks_query.filter(Recording.meeting_date >= filters['date_from'])
+                if filters.get('date_to'):
+                    chunks_query = chunks_query.filter(Recording.meeting_date <= filters['date_to'])
+        
+        # Get chunks that have embeddings
+        chunks = chunks_query.filter(TranscriptChunk.embedding.isnot(None)).all()
+        
+        if not chunks:
+            return []
+
+        # Calculate similarities. Previously this iterated chunk-by-chunk and
+        # called sklearn's cosine_similarity on a 1xN vs 1xN pair for every
+        # chunk, which on a library of ~17k chunks took 15-20 seconds per
+        # query because of Python-call overhead per chunk. Stacking all
+        # chunk vectors into one matrix and doing a single vectorised dot
+        # product brings that down by two to three orders of magnitude.
+        expected_dim = int(query_embedding.shape[0])
+        kept_chunks = []
+        kept_vectors = []
+        skipped_dim_mismatch = 0
+        for chunk in chunks:
+            if chunk.embedding is None:
+                continue
+            try:
+                v = deserialize_embedding(chunk.embedding)
+            except Exception as e:
+                current_app.logger.warning(f"Error deserialising chunk {chunk.id}: {e}")
+                continue
+            if v is None:
+                continue
+            if v.shape[0] != expected_dim:
+                # Stale vector from a previous embedding configuration.
+                # Skip silently in batch rather than warning per chunk so a
+                # large library cannot flood the log on every search.
+                skipped_dim_mismatch += 1
+                continue
+            kept_chunks.append(chunk)
+            kept_vectors.append(v)
+
+        if skipped_dim_mismatch:
+            current_app.logger.warning(
+                f"Skipped {skipped_dim_mismatch} chunks with mismatched "
+                f"embedding dimensions (expected {expected_dim}). Run "
+                f"Re-embed all to refresh them."
+            )
+
+        if not kept_vectors:
+            return []
+
+        # One sklearn call instead of len(chunks). Returns shape (1, N).
+        embeddings_matrix = np.vstack(kept_vectors)
+        similarities = cosine_similarity(
+            query_embedding.reshape(1, -1),
+            embeddings_matrix,
+        )[0]
+
+        # Top-k via argpartition is faster than a full sort for large N.
+        if top_k >= len(kept_chunks):
+            order = np.argsort(-similarities)
+        else:
+            top_idx = np.argpartition(-similarities, top_k)[:top_k]
+            order = top_idx[np.argsort(-similarities[top_idx])]
+
+        return [(kept_chunks[i], float(similarities[i])) for i in order]
+        
+    except Exception as e:
+        current_app.logger.error(f"Error in semantic search: {e}")
+        return []
+
+# --- Helper Functions for Document Processing ---
+
+
+
diff --git a/src/services/job_queue.py b/src/services/job_queue.py
new file mode 100644
index 00000000..ef14c74f
--- /dev/null
+++ b/src/services/job_queue.py
@@ -0,0 +1,636 @@
+"""
+Fair database-backed job queue for background processing tasks.
+
+This queue ensures:
+- Jobs persist across application restarts
+- Fair round-robin scheduling between users
+- Separate queues for transcription (slow) and summary (fast) jobs
+- Limited concurrency to prevent overwhelming external services
+- Automatic recovery of orphaned jobs
+"""
+
+import os
+import json
+import threading
+import time
+import logging
+from datetime import datetime
+from typing import Optional, Dict, Any, List
+from contextlib import contextmanager
+
+logger = logging.getLogger(__name__)
+
+# Configuration
+TRANSCRIPTION_WORKERS = int(os.environ.get('JOB_QUEUE_WORKERS', '2'))
+SUMMARY_WORKERS = int(os.environ.get('SUMMARY_QUEUE_WORKERS', '2'))
+MAX_RETRIES = int(os.environ.get('JOB_MAX_RETRIES', '3'))
+POLL_INTERVAL = 1.0  # seconds between checking for new jobs
+
+# Job type categories
+TRANSCRIPTION_JOBS = ['transcribe', 'reprocess_transcription']
+SUMMARY_JOBS = ['summarize', 'reprocess_summary']
+
+
+class FairJobQueue:
+    """
+    A database-backed job queue with fair scheduling across users.
+
+    Uses separate queues for transcription and summary jobs to prevent
+    slow transcription jobs from blocking fast summary jobs.
+    """
+
+    _instance = None
+    _lock = threading.Lock()
+
+    def __new__(cls):
+        """Singleton pattern to ensure only one queue exists."""
+        if cls._instance is None:
+            with cls._lock:
+                if cls._instance is None:
+                    cls._instance = super().__new__(cls)
+                    cls._instance._initialized = False
+        return cls._instance
+
+    def __init__(self):
+        """Initialize the job queue."""
+        if self._initialized:
+            return
+
+        self._transcription_workers = []
+        self._summary_workers = []
+        self._running = False
+        self._app = None
+        # Separate round-robin tracking for each queue
+        self._last_user_id_transcription = None
+        self._last_user_id_summary = None
+        # Lock for claiming jobs (SQLite doesn't support row-level locking)
+        self._claim_lock = threading.Lock()
+        self._initialized = True
+
+        logger.info(f"FairJobQueue initialized: {TRANSCRIPTION_WORKERS} transcription workers, {SUMMARY_WORKERS} summary workers")
+
+    def init_app(self, app):
+        """Initialize with Flask app for context management."""
+        self._app = app
+
+    @contextmanager
+    def _app_context(self):
+        """Get application context for database operations."""
+        if self._app:
+            with self._app.app_context():
+                yield
+        else:
+            yield
+
+    def start(self):
+        """Start the worker threads for both queues."""
+        if self._running:
+            return
+
+        self._running = True
+
+        # Start transcription workers
+        for i in range(TRANSCRIPTION_WORKERS):
+            worker = threading.Thread(
+                target=self._worker_loop,
+                args=(TRANSCRIPTION_JOBS, 'transcription'),
+                name=f"TranscriptionWorker-{i}",
+                daemon=True
+            )
+            worker.start()
+            self._transcription_workers.append(worker)
+
+        # Start summary workers
+        for i in range(SUMMARY_WORKERS):
+            worker = threading.Thread(
+                target=self._worker_loop,
+                args=(SUMMARY_JOBS, 'summary'),
+                name=f"SummaryWorker-{i}",
+                daemon=True
+            )
+            worker.start()
+            self._summary_workers.append(worker)
+
+        logger.info(f"Started {TRANSCRIPTION_WORKERS} transcription workers and {SUMMARY_WORKERS} summary workers")
+
+    def stop(self):
+        """Stop the worker threads gracefully."""
+        self._running = False
+        for worker in self._transcription_workers + self._summary_workers:
+            worker.join(timeout=5)
+        self._transcription_workers.clear()
+        self._summary_workers.clear()
+        logger.info("Job queue workers stopped")
+
+    def _worker_loop(self, job_types: List[str], queue_name: str):
+        """Main worker loop that processes jobs of specific types."""
+        while self._running:
+            try:
+                job = self._claim_next_job(job_types, queue_name)
+                if job:
+                    self._process_job(job)
+                else:
+                    # No jobs available, sleep briefly
+                    time.sleep(POLL_INTERVAL)
+            except Exception as e:
+                logger.error(f"{queue_name.capitalize()} worker error: {e}", exc_info=True)
+                time.sleep(POLL_INTERVAL)
+
+    def _claim_next_job(self, job_types: List[str], queue_name: str):
+        """
+        Claim the next job of specified types using fair round-robin scheduling.
+
+        Args:
+            job_types: List of job types this worker handles
+            queue_name: Name of the queue ('transcription' or 'summary')
+
+        Returns the claimed job or None if no jobs available.
+        """
+        # Use lock to prevent race conditions (SQLite doesn't support row-level locking)
+        with self._claim_lock:
+            with self._app_context():
+                from src.database import db
+                from src.models import ProcessingJob
+
+                try:
+                    # Get list of users with queued jobs of our types
+                    users_with_jobs = db.session.query(
+                        ProcessingJob.user_id
+                    ).filter(
+                        ProcessingJob.status == 'queued',
+                        ProcessingJob.job_type.in_(job_types)
+                    ).group_by(
+                        ProcessingJob.user_id
+                    ).order_by(
+                        db.func.min(ProcessingJob.created_at)
+                    ).all()
+
+                    if not users_with_jobs:
+                        return None
+
+                    user_ids = [u[0] for u in users_with_jobs]
+
+                    # Get last user ID for this queue type
+                    last_user_id = (self._last_user_id_transcription
+                                   if queue_name == 'transcription'
+                                   else self._last_user_id_summary)
+
+                    # Round-robin: pick next user after last processed
+                    next_user_id = None
+                    if last_user_id is not None and last_user_id in user_ids:
+                        idx = user_ids.index(last_user_id)
+                        next_user_id = user_ids[(idx + 1) % len(user_ids)]
+                    else:
+                        next_user_id = user_ids[0]
+
+                    # Get oldest queued job of our types for this user
+                    candidate_job = ProcessingJob.query.filter(
+                        ProcessingJob.user_id == next_user_id,
+                        ProcessingJob.status == 'queued',
+                        ProcessingJob.job_type.in_(job_types)
+                    ).order_by(
+                        ProcessingJob.created_at
+                    ).first()
+
+                    if candidate_job:
+                        # Atomically claim the job - only succeeds if status is still 'queued'
+                        # This prevents race conditions when multiple workers try to claim the same job
+                        from sqlalchemy import update
+                        claim_time = datetime.utcnow()
+                        result = db.session.execute(
+                            update(ProcessingJob)
+                            .where(
+                                ProcessingJob.id == candidate_job.id,
+                                ProcessingJob.status == 'queued'  # Critical: only claim if still queued
+                            )
+                            .values(status='processing', started_at=claim_time)
+                        )
+
+                        if result.rowcount == 0:
+                            # Job was already claimed by another worker - this is expected with multiple workers
+                            logger.debug(f"[{queue_name.upper()}] Job {candidate_job.id} already claimed by another worker")
+                            db.session.rollback()
+                            return None
+
+                        # Also update Recording.status to reflect active processing
+                        from src.models import Recording
+                        recording = db.session.get(Recording, candidate_job.recording_id)
+                        if recording and recording.status == 'QUEUED':
+                            recording.status = 'PROCESSING'
+
+                        db.session.commit()
+
+                        # Refresh the job object to get updated values
+                        db.session.refresh(candidate_job)
+
+                        # Update last user ID for this queue
+                        if queue_name == 'transcription':
+                            self._last_user_id_transcription = next_user_id
+                        else:
+                            self._last_user_id_summary = next_user_id
+
+                        wait_time = (claim_time - candidate_job.created_at).total_seconds()
+                        logger.info(f"[{queue_name.upper()}] Claimed job {candidate_job.id} (type={candidate_job.job_type}) for user {candidate_job.user_id}, recording {candidate_job.recording_id} (waited {wait_time:.1f}s)")
+                        return candidate_job
+
+                    return None
+
+                except Exception as e:
+                    logger.error(f"Error claiming {queue_name} job: {e}", exc_info=True)
+                    db.session.rollback()
+                    return None
+
+    def _is_permanent_error(self, error_str: str) -> bool:
+        """
+        Detect if an error is permanent and should not be retried.
+
+        Permanent errors include:
+        - 400: Bad request (invalid format, invalid parameters)
+        - 413: File too large (user needs to enable chunking or compress file)
+        - 401/403: Authentication/authorization errors (credentials issue)
+        - 402: Payment required (billing issue)
+        - 404: Resource not found (model doesn't exist)
+        - Invalid format errors (file needs to be converted)
+        """
+        error_lower = error_str.lower()
+
+        # HTTP status codes that indicate permanent errors
+        permanent_codes = ['400', '413', '401', '402', '403', '404']
+        for code in permanent_codes:
+            if f'error code: {code}' in error_lower or f'status {code}' in error_lower:
+                return True
+
+        # Specific error patterns that are permanent (simple substring matching)
+        permanent_patterns = [
+            'maximum content size limit',
+            'file too large',
+            'payload too large',
+            'invalid api key',
+            'incorrect api key',
+            'authentication failed',
+            'unauthorized',
+            'permission denied',
+            'access denied',
+            'billing',
+            'payment required',
+            'quota exceeded',
+            'insufficient funds',
+            'model not found',
+            'invalid model',
+            'unsupported format',
+            'invalid file format',
+            'invalid_request_error',
+            'bad request',
+            'unparseable',
+        ]
+
+        for pattern in permanent_patterns:
+            if pattern in error_lower:
+                return True
+
+        return False
+
+    def _process_job(self, job):
+        """Process a single job by dispatching to the appropriate task function."""
+        job_id = job.id
+        job_type = job.job_type
+        recording_id = job.recording_id
+        params_str = job.params
+        is_new_upload = job.is_new_upload
+
+        with self._app_context():
+            from src.database import db
+            from src.models import ProcessingJob, Recording
+            from flask import current_app
+
+            try:
+                # Parse job parameters
+                params = json.loads(params_str) if params_str else {}
+
+                # Re-fetch the job in this session context to ensure it's attached
+                job = db.session.get(ProcessingJob, job_id)
+                if not job:
+                    logger.error(f"Job {job_id} not found when trying to process")
+                    return
+
+                # Get recording
+                recording = db.session.get(Recording, recording_id)
+                if not recording:
+                    raise ValueError(f"Recording {recording_id} not found")
+
+                # Dispatch based on job type
+                if job_type == 'transcribe':
+                    self._run_transcription(job, recording, params)
+                elif job_type == 'summarize':
+                    self._run_summarization(job, recording, params)
+                elif job_type == 'reprocess_transcription':
+                    self._run_reprocess_transcription(job, recording, params)
+                elif job_type == 'reprocess_summary':
+                    self._run_reprocess_summary(job, recording, params)
+                else:
+                    raise ValueError(f"Unknown job type: {job_type}")
+
+                # Mark as completed - re-fetch to ensure we have latest state
+                job = db.session.get(ProcessingJob, job_id)
+                if job:
+                    job.status = 'completed'
+                    job.completed_at = datetime.utcnow()
+                    db.session.commit()
+                    logger.info(f"Job {job_id} completed successfully")
+
+            except Exception as e:
+                error_str = str(e)
+                logger.error(f"Job {job_id} failed: {e}", exc_info=True)
+
+                # Check if this is a permanent error that shouldn't be retried
+                is_permanent_error = self._is_permanent_error(error_str)
+
+                # Re-fetch job to update it
+                job = db.session.get(ProcessingJob, job_id)
+                if job:
+                    job.error_message = error_str
+                    job.retry_count += 1
+
+                    # Only retry if: not a permanent error AND under retry limit
+                    if not is_permanent_error and job.retry_count < MAX_RETRIES:
+                        # Re-queue for retry
+                        job.status = 'queued'
+                        job.started_at = None
+                        logger.info(f"Job {job_id} re-queued for retry ({job.retry_count}/{MAX_RETRIES})")
+                    else:
+                        job.status = 'failed'
+                        job.completed_at = datetime.utcnow()
+                        recording = db.session.get(Recording, recording_id)
+
+                        if is_permanent_error:
+                            logger.info(f"Job {job_id} failed with permanent error (no retry): {error_str[:100]}")
+
+                        # Always keep recordings with FAILED status so users can see the error
+                        # and reprocess later (e.g., when ASR server recovers)
+                        if recording:
+                            # Keep the recording with FAILED status so user can see the error and fix settings
+                            recording.status = 'FAILED'
+                            # Format the error for nice display
+                            from src.utils.error_formatting import format_error_for_storage
+                            recording.transcription = format_error_for_storage(error_str)
+
+                        if is_permanent_error:
+                            logger.error(f"Job {job_id} failed permanently (non-retryable error)")
+                        else:
+                            logger.error(f"Job {job_id} failed permanently after {MAX_RETRIES} retries")
+
+                    db.session.commit()
+
+    def _run_transcription(self, job, recording, params):
+        """Run transcription task. Status updates handled by task function."""
+        from src.tasks.processing import transcribe_audio_task
+        from flask import current_app
+
+        filepath = recording.audio_path
+        filename_for_asr = recording.original_filename or os.path.basename(filepath)
+
+        transcribe_audio_task(
+            current_app._get_current_object().app_context(),
+            recording.id,
+            filepath,
+            filename_for_asr,
+            datetime.utcnow(),
+            language=params.get('language'),
+            min_speakers=params.get('min_speakers'),
+            max_speakers=params.get('max_speakers'),
+            tag_id=params.get('tag_id'),
+            hotwords=params.get('hotwords'),
+            initial_prompt=params.get('initial_prompt'),
+            transcription_model=params.get('transcription_model'),
+        )
+
+    def _run_summarization(self, job, recording, params):
+        """Run summarization-only task. Status updates handled by task function."""
+        from src.tasks.processing import generate_summary_only_task
+        from flask import current_app
+
+        generate_summary_only_task(
+            current_app._get_current_object().app_context(),
+            recording.id,
+            custom_prompt_override=params.get('custom_prompt'),
+            custom_prompt_append=params.get('custom_prompt_append', False),
+            user_id=params.get('user_id')
+        )
+
+    def _run_reprocess_transcription(self, job, recording, params):
+        """Run transcription reprocessing task. Status updates handled by task function."""
+        from src.tasks.processing import transcribe_audio_task
+        from flask import current_app
+
+        filepath = recording.audio_path
+        filename_for_asr = recording.original_filename or os.path.basename(filepath)
+
+        transcribe_audio_task(
+            current_app._get_current_object().app_context(),
+            recording.id,
+            filepath,
+            filename_for_asr,
+            datetime.utcnow(),
+            language=params.get('language'),
+            min_speakers=params.get('min_speakers'),
+            max_speakers=params.get('max_speakers'),
+            tag_id=params.get('tag_id'),
+            hotwords=params.get('hotwords'),
+            initial_prompt=params.get('initial_prompt'),
+            transcription_model=params.get('transcription_model'),
+        )
+
+    def _run_reprocess_summary(self, job, recording, params):
+        """Run summary reprocessing task. Status updates handled by task function."""
+        from src.tasks.processing import generate_summary_only_task
+        from flask import current_app
+
+        generate_summary_only_task(
+            current_app._get_current_object().app_context(),
+            recording.id,
+            custom_prompt_override=params.get('custom_prompt'),
+            custom_prompt_append=params.get('custom_prompt_append', False),
+            user_id=params.get('user_id')
+        )
+
+    def enqueue(
+        self,
+        user_id: int,
+        recording_id: int,
+        job_type: str,
+        params: Dict[str, Any] = None,
+        is_new_upload: bool = False
+    ) -> int:
+        """
+        Add a job to the database queue.
+
+        Args:
+            user_id: ID of the user who owns this job
+            recording_id: ID of the recording to process
+            job_type: Type of job (transcribe, summarize, reprocess_transcription, reprocess_summary)
+            params: Optional parameters for the job
+            is_new_upload: True if this is a new file upload (for cleanup on failure)
+
+        Returns:
+            The created job ID
+        """
+        with self._app_context():
+            from src.database import db
+            from src.models import ProcessingJob, Recording
+
+            # Check for existing active job of the SAME TYPE for this recording
+            # Allow different job types to coexist (e.g., transcribe and summarize)
+            existing = ProcessingJob.query.filter(
+                ProcessingJob.recording_id == recording_id,
+                ProcessingJob.job_type == job_type,
+                ProcessingJob.status.in_(['queued', 'processing'])
+            ).first()
+
+            if existing:
+                logger.warning(f"Job of type {job_type} already exists for recording {recording_id}: {existing.id}")
+                return existing.id
+
+            # Create new job
+            job = ProcessingJob(
+                user_id=user_id,
+                recording_id=recording_id,
+                job_type=job_type,
+                params=json.dumps(params) if params else None,
+                is_new_upload=is_new_upload
+            )
+            db.session.add(job)
+
+            # Update recording status based on job type
+            recording = db.session.get(Recording, recording_id)
+            if recording:
+                if job_type in SUMMARY_JOBS:
+                    recording.status = 'SUMMARIZING'
+                else:
+                    recording.status = 'QUEUED'
+
+            db.session.commit()
+
+            # Auto-start workers if not running
+            if not self._running:
+                self.start()
+
+            queue_name = 'summary' if job_type in SUMMARY_JOBS else 'transcription'
+            logger.info(f"Enqueued {queue_name} job {job.id} (type={job_type}) for user {user_id}, recording {recording_id}")
+            return job.id
+
+    def recover_orphaned_jobs(self):
+        """
+        Recover jobs that were processing when the app crashed.
+        Call this on startup to reset orphaned jobs back to queued.
+        """
+        with self._app_context():
+            from src.database import db
+            from src.models import ProcessingJob
+
+            orphaned = ProcessingJob.query.filter(
+                ProcessingJob.status == 'processing'
+            ).all()
+
+            for job in orphaned:
+                job.status = 'queued'
+                job.started_at = None
+                queue_name = 'summary' if job.job_type in SUMMARY_JOBS else 'transcription'
+                logger.info(f"Recovered orphaned {queue_name} job {job.id} for recording {job.recording_id}")
+
+            if orphaned:
+                db.session.commit()
+                logger.info(f"Recovered {len(orphaned)} orphaned jobs")
+
+    def get_queue_status(self) -> Dict[str, Any]:
+        """Get the current queue status for both queues."""
+        with self._app_context():
+            from src.models import ProcessingJob
+
+            transcription_queued = ProcessingJob.query.filter(
+                ProcessingJob.status == 'queued',
+                ProcessingJob.job_type.in_(TRANSCRIPTION_JOBS)
+            ).count()
+            transcription_processing = ProcessingJob.query.filter(
+                ProcessingJob.status == 'processing',
+                ProcessingJob.job_type.in_(TRANSCRIPTION_JOBS)
+            ).count()
+
+            summary_queued = ProcessingJob.query.filter(
+                ProcessingJob.status == 'queued',
+                ProcessingJob.job_type.in_(SUMMARY_JOBS)
+            ).count()
+            summary_processing = ProcessingJob.query.filter(
+                ProcessingJob.status == 'processing',
+                ProcessingJob.job_type.in_(SUMMARY_JOBS)
+            ).count()
+
+            return {
+                "transcription_queue": {
+                    "queued": transcription_queued,
+                    "processing": transcription_processing,
+                    "workers": TRANSCRIPTION_WORKERS
+                },
+                "summary_queue": {
+                    "queued": summary_queued,
+                    "processing": summary_processing,
+                    "workers": SUMMARY_WORKERS
+                },
+                "is_running": self._running
+            }
+
+    def get_position_in_queue(self, recording_id: int) -> Optional[int]:
+        """Get the position of a recording's job in its respective queue (1-indexed)."""
+        with self._app_context():
+            from src.models import ProcessingJob
+
+            job = ProcessingJob.query.filter(
+                ProcessingJob.recording_id == recording_id,
+                ProcessingJob.status == 'queued'
+            ).first()
+
+            if not job:
+                return None
+
+            # Determine which queue this job is in
+            job_types = SUMMARY_JOBS if job.job_type in SUMMARY_JOBS else TRANSCRIPTION_JOBS
+
+            # Count jobs of the same type created before this one
+            position = ProcessingJob.query.filter(
+                ProcessingJob.status == 'queued',
+                ProcessingJob.job_type.in_(job_types),
+                ProcessingJob.created_at < job.created_at
+            ).count() + 1
+
+            return position
+
+    def get_job_for_recording(self, recording_id: int):
+        """Get the active job for a recording."""
+        with self._app_context():
+            from src.models import ProcessingJob
+
+            return ProcessingJob.query.filter(
+                ProcessingJob.recording_id == recording_id,
+                ProcessingJob.status.in_(['queued', 'processing'])
+            ).first()
+
+    def cleanup_old_jobs(self, max_age_hours: int = 24):
+        """Remove completed/failed jobs older than max_age_hours."""
+        with self._app_context():
+            from src.database import db
+            from src.models import ProcessingJob
+            from datetime import timedelta
+
+            cutoff = datetime.utcnow() - timedelta(hours=max_age_hours)
+
+            deleted = ProcessingJob.query.filter(
+                ProcessingJob.status.in_(['completed', 'failed']),
+                ProcessingJob.completed_at < cutoff
+            ).delete(synchronize_session=False)
+
+            if deleted:
+                db.session.commit()
+                logger.info(f"Cleaned up {deleted} old jobs")
+
+
+# Global job queue instance
+job_queue = FairJobQueue()
diff --git a/src/services/llm.py b/src/services/llm.py
new file mode 100644
index 00000000..581e2fcd
--- /dev/null
+++ b/src/services/llm.py
@@ -0,0 +1,566 @@
+"""
+LLM API integration services (OpenAI/OpenRouter).
+"""
+
+import os
+import re
+import json
+import time
+import logging
+import httpx
+from openai import OpenAI, APITimeoutError
+
+# Use standard logging instead of current_app.logger for context independence
+logger = logging.getLogger(__name__)
+
+
+class TokenBudgetExceeded(Exception):
+    """Raised when user exceeds their token budget."""
+    def __init__(self, message, usage_percentage=100):
+        self.message = message
+        self.usage_percentage = usage_percentage
+        super().__init__(message)
+
+from src.utils import safe_json_loads, extract_json_object
+
+# Configuration - use TEXT_MODEL_* variables for LLM
+TEXT_MODEL_API_KEY = os.environ.get("TEXT_MODEL_API_KEY")
+TEXT_MODEL_BASE_URL = os.environ.get("TEXT_MODEL_BASE_URL", "https://openrouter.ai/api/v1")
+if TEXT_MODEL_BASE_URL:
+    TEXT_MODEL_BASE_URL = TEXT_MODEL_BASE_URL.split('#')[0].strip()
+TEXT_MODEL_NAME = os.environ.get("TEXT_MODEL_NAME", "openai/gpt-3.5-turbo")
+
+# Chat model configuration (optional - falls back to TEXT_MODEL_* if not set)
+CHAT_MODEL_API_KEY = os.environ.get("CHAT_MODEL_API_KEY")
+CHAT_MODEL_BASE_URL = os.environ.get("CHAT_MODEL_BASE_URL")
+if CHAT_MODEL_BASE_URL:
+    CHAT_MODEL_BASE_URL = CHAT_MODEL_BASE_URL.split('#')[0].strip()
+CHAT_MODEL_NAME = os.environ.get("CHAT_MODEL_NAME")
+
+# Chat-specific GPT-5 settings (optional - falls back to main GPT5_* settings)
+CHAT_GPT5_REASONING_EFFORT = os.environ.get("CHAT_GPT5_REASONING_EFFORT")
+CHAT_GPT5_VERBOSITY = os.environ.get("CHAT_GPT5_VERBOSITY")
+
+# Streaming options - disable for LLM servers that don't support OpenAI's stream_options
+ENABLE_STREAM_OPTIONS = os.environ.get("ENABLE_STREAM_OPTIONS", "true").lower() == "true"
+
+# LLM timeout and retry configuration
+# Read timeout controls how long to wait for model inference (the bottleneck for local models)
+# Connect/write stay short so misconfigured URLs fail fast instead of hanging
+LLM_REQUEST_TIMEOUT = int(os.environ.get("LLM_REQUEST_TIMEOUT", "600"))
+LLM_MAX_RETRIES = int(os.environ.get("LLM_MAX_RETRIES", "2"))
+LLM_CONNECT_TIMEOUT = float(os.environ.get("LLM_CONNECT_TIMEOUT", "30"))
+LLM_WRITE_TIMEOUT = float(os.environ.get("LLM_WRITE_TIMEOUT", "30"))
+llm_timeout = httpx.Timeout(
+    connect=LLM_CONNECT_TIMEOUT,
+    read=float(LLM_REQUEST_TIMEOUT),
+    write=LLM_WRITE_TIMEOUT,
+    pool=30.0,
+)
+
+
+def get_chat_config():
+    """
+    Get chat model configuration, falling back to TEXT_MODEL if not set.
+
+    Returns a dict with api_key, base_url, model_name, and GPT-5 settings.
+    """
+    if CHAT_MODEL_API_KEY and CHAT_MODEL_NAME:
+        return {
+            'api_key': CHAT_MODEL_API_KEY,
+            'base_url': CHAT_MODEL_BASE_URL or TEXT_MODEL_BASE_URL,
+            'model_name': CHAT_MODEL_NAME,
+            'gpt5_reasoning_effort': CHAT_GPT5_REASONING_EFFORT or os.environ.get("GPT5_REASONING_EFFORT", "medium"),
+            'gpt5_verbosity': CHAT_GPT5_VERBOSITY or os.environ.get("GPT5_VERBOSITY", "medium")
+        }
+    return {
+        'api_key': TEXT_MODEL_API_KEY,
+        'base_url': TEXT_MODEL_BASE_URL,
+        'model_name': TEXT_MODEL_NAME,
+        'gpt5_reasoning_effort': os.environ.get("GPT5_REASONING_EFFORT", "medium"),
+        'gpt5_verbosity': os.environ.get("GPT5_VERBOSITY", "medium")
+    }
+
+
+# Set up HTTP client with custom headers for OpenRouter app identification
+app_headers = {
+    "HTTP-Referer": "https://github.com/murtaza-nasir/speakr",
+    "X-Title": "Speakr - AI Audio Transcription",
+    "User-Agent": "Speakr/1.0 (https://github.com/murtaza-nasir/speakr)"
+}
+
+http_client_no_proxy = httpx.Client(
+    verify=True,
+    headers=app_headers
+)
+
+# Create client with placeholder key if not provided (allows app to start)
+try:
+    api_key = TEXT_MODEL_API_KEY or "not-needed"
+    client = OpenAI(
+        api_key=api_key,
+        base_url=TEXT_MODEL_BASE_URL,
+        http_client=http_client_no_proxy,
+        timeout=llm_timeout,
+        max_retries=LLM_MAX_RETRIES,
+    )
+    # Always log the resolved timeout/retry values at startup so users can confirm
+    # their LLM_REQUEST_TIMEOUT / LLM_MAX_RETRIES env vars actually took effect.
+    logger.info(
+        f"LLM client configured: read_timeout={LLM_REQUEST_TIMEOUT}s, "
+        f"connect_timeout={LLM_CONNECT_TIMEOUT}s, write_timeout={LLM_WRITE_TIMEOUT}s, "
+        f"max_retries={LLM_MAX_RETRIES}"
+    )
+except Exception as client_init_e:
+    client = None
+
+# Create chat client (may be same as main client if no separate config)
+chat_client = None
+try:
+    chat_config = get_chat_config()
+    if chat_config['api_key']:
+        if CHAT_MODEL_API_KEY and CHAT_MODEL_API_KEY != TEXT_MODEL_API_KEY:
+            # Separate chat configuration - create dedicated client
+            chat_client = OpenAI(
+                api_key=chat_config['api_key'],
+                base_url=chat_config['base_url'],
+                http_client=http_client_no_proxy,
+                timeout=llm_timeout,
+                max_retries=LLM_MAX_RETRIES,
+            )
+            logger.info(f"Separate chat client initialized: {chat_config['base_url']} / {chat_config['model_name']}")
+        else:
+            # Use same client as main LLM
+            chat_client = client
+except Exception as chat_client_init_e:
+    logger.warning(f"Failed to initialize chat client, falling back to main client: {chat_client_init_e}")
+    chat_client = client
+
+
+def is_gpt5_model(model_name):
+    """
+    Check if the model is a GPT-5 series model that requires special API parameters.
+
+    Args:
+        model_name: The model name string
+
+    Returns:
+        Boolean indicating if this is a GPT-5 model
+    """
+    if not model_name:
+        return False
+    model_lower = model_name.lower()
+    return model_lower.startswith('gpt-5') or model_lower in ['gpt-5', 'gpt-5-mini', 'gpt-5-nano', 'gpt-5-chat-latest']
+
+
+
+def is_using_openai_api():
+    """
+    Check if we're using the official OpenAI API (not OpenRouter or other providers).
+
+    Returns:
+        Boolean indicating if this is the OpenAI API
+    """
+    return TEXT_MODEL_BASE_URL and 'api.openai.com' in TEXT_MODEL_BASE_URL
+
+
+
+def call_llm_completion(messages, temperature=0.7, response_format=None, stream=False, max_tokens=None,
+                        user_id=None, operation_type=None):
+    """
+    Centralized function for LLM API calls with proper error handling and logging.
+
+    Args:
+        messages: List of message dicts with 'role' and 'content'
+        temperature: Sampling temperature (0-1) - ignored for GPT-5 models
+        response_format: Optional response format dict (e.g., {"type": "json_object"})
+        stream: Whether to stream the response
+        max_tokens: Optional maximum tokens to generate
+        user_id: Optional user ID for token tracking and budget enforcement
+        operation_type: Optional operation type for token tracking (e.g., 'summarization', 'chat')
+
+    Returns:
+        OpenAI completion object or generator (if streaming)
+    """
+    if not client:
+        raise ValueError("LLM client not initialized")
+
+    if not TEXT_MODEL_API_KEY:
+        raise ValueError("TEXT_MODEL_API_KEY not configured")
+
+    # Check budget before making the call
+    if user_id and operation_type:
+        try:
+            from src.services.token_tracking import token_tracker
+            can_proceed, usage_pct, msg = token_tracker.check_budget(user_id)
+            if not can_proceed:
+                raise TokenBudgetExceeded(msg, usage_pct)
+            if usage_pct >= 80:
+                logger.warning(f"User {user_id} at {usage_pct:.1f}% of token budget")
+        except TokenBudgetExceeded:
+            raise
+        except Exception as e:
+            # Log but don't block on budget check errors
+            logger.warning(f"Budget check failed for user {user_id}: {e}")
+
+    try:
+        # Check if we're using GPT-5 with OpenAI API
+        using_gpt5 = is_gpt5_model(TEXT_MODEL_NAME) and is_using_openai_api()
+
+        completion_args = {
+            "model": TEXT_MODEL_NAME,
+            "messages": messages,
+            "stream": stream
+        }
+
+        # Add stream_options to get usage in final chunk for streaming
+        # Some LLM servers don't support this OpenAI-specific option
+        if stream and ENABLE_STREAM_OPTIONS:
+            completion_args["stream_options"] = {"include_usage": True}
+
+        if using_gpt5:
+            # GPT-5 models don't support temperature, top_p, or logprobs
+            # They use reasoning_effort and verbosity instead
+            logger.debug(f"Using GPT-5 model: {TEXT_MODEL_NAME} - applying GPT-5 specific parameters")
+
+            # Get GPT-5 specific parameters from environment variables
+            reasoning_effort = os.environ.get("GPT5_REASONING_EFFORT", "medium")  # minimal, low, medium, high
+            verbosity = os.environ.get("GPT5_VERBOSITY", "medium")  # low, medium, high
+
+            # Add GPT-5 specific parameters
+            completion_args["reasoning_effort"] = reasoning_effort
+            completion_args["verbosity"] = verbosity
+
+            # Use max_completion_tokens instead of max_tokens for GPT-5
+            if max_tokens:
+                completion_args["max_completion_tokens"] = max_tokens
+        else:
+            # Non-GPT-5 models use standard parameters
+            completion_args["temperature"] = temperature
+
+            if max_tokens:
+                completion_args["max_tokens"] = max_tokens
+
+        if response_format:
+            completion_args["response_format"] = response_format
+
+        # Make the resolved max_tokens visible in logs so users can confirm
+        # their SUMMARY_MAX_TOKENS / CHAT_MAX_TOKENS / etc. settings actually
+        # took effect for a given operation. The "key" used here is
+        # max_completion_tokens for GPT-5 and max_tokens otherwise.
+        budget_key = 'max_completion_tokens' if using_gpt5 else 'max_tokens'
+        logger.info(
+            f"LLM call: operation={operation_type or 'unspecified'}, model={TEXT_MODEL_NAME}, "
+            f"{budget_key}={completion_args.get(budget_key, 'provider default')}"
+        )
+
+        request_started_at = time.monotonic()
+        response = client.chat.completions.create(**completion_args)
+
+        # Track usage for non-streaming calls
+        if user_id and operation_type and not stream and response.usage:
+            try:
+                from src.services.token_tracking import token_tracker
+                token_tracker.record_usage(
+                    user_id=user_id,
+                    operation_type=operation_type,
+                    prompt_tokens=response.usage.prompt_tokens,
+                    completion_tokens=response.usage.completion_tokens,
+                    total_tokens=response.usage.total_tokens,
+                    model_name=TEXT_MODEL_NAME,
+                    cost=getattr(response.usage, 'cost', None)
+                )
+            except Exception as e:
+                logger.warning(f"Failed to record token usage: {e}")
+
+        # Debug log for empty responses
+        if not stream and response.choices:
+            content = response.choices[0].message.content
+            if not content:
+                logger.warning(f"LLM returned empty content. Model: {TEXT_MODEL_NAME}, finish_reason: {response.choices[0].finish_reason}")
+                # Log more details if available
+                if hasattr(response.choices[0].message, 'refusal'):
+                    logger.warning(f"Refusal: {response.choices[0].message.refusal}")
+                if hasattr(response.choices[0].message, 'tool_calls') and response.choices[0].message.tool_calls:
+                    logger.warning(f"Tool calls present: {response.choices[0].message.tool_calls}")
+
+        return response
+
+    except TokenBudgetExceeded:
+        raise
+    except APITimeoutError as e:
+        elapsed = time.monotonic() - request_started_at if 'request_started_at' in locals() else None
+        elapsed_str = f"{elapsed:.1f}s" if elapsed is not None else "unknown"
+        logger.error(
+            f"LLM request timed out after {elapsed_str} (configured read_timeout={LLM_REQUEST_TIMEOUT}s, "
+            f"max_retries={LLM_MAX_RETRIES}, model={TEXT_MODEL_NAME}). "
+            f"If the elapsed time is much shorter than the configured timeout, an upstream proxy or the "
+            f"provider is closing the connection early. For reasoning models that take longer to think, "
+            f"increase LLM_REQUEST_TIMEOUT."
+        )
+        raise
+    except Exception as e:
+        logger.error(f"LLM API call failed: {e}")
+        raise
+
+
+def call_chat_completion(messages, temperature=0.7, response_format=None, stream=False, max_tokens=None,
+                         user_id=None, operation_type=None):
+    """
+    Chat-specific LLM completion function. Uses dedicated chat model if configured,
+    otherwise falls back to standard TEXT_MODEL configuration.
+
+    Args:
+        messages: List of message dicts with 'role' and 'content'
+        temperature: Sampling temperature (0-1) - ignored for GPT-5 models
+        response_format: Optional response format dict (e.g., {"type": "json_object"})
+        stream: Whether to stream the response
+        max_tokens: Optional maximum tokens to generate
+        user_id: Optional user ID for token tracking and budget enforcement
+        operation_type: Optional operation type for token tracking (e.g., 'chat')
+
+    Returns:
+        OpenAI completion object or generator (if streaming)
+    """
+    effective_client = chat_client if chat_client else client
+    chat_config = get_chat_config()
+
+    if not effective_client:
+        raise ValueError("Chat LLM client not initialized")
+
+    if not chat_config['api_key']:
+        raise ValueError("Chat model API key not configured")
+
+    # Check budget before making the call
+    if user_id and operation_type:
+        try:
+            from src.services.token_tracking import token_tracker
+            can_proceed, usage_pct, msg = token_tracker.check_budget(user_id)
+            if not can_proceed:
+                raise TokenBudgetExceeded(msg, usage_pct)
+            if usage_pct >= 80:
+                logger.warning(f"User {user_id} at {usage_pct:.1f}% of token budget")
+        except TokenBudgetExceeded:
+            raise
+        except Exception as e:
+            # Log but don't block on budget check errors
+            logger.warning(f"Budget check failed for user {user_id}: {e}")
+
+    try:
+        model_name = chat_config['model_name']
+        base_url = chat_config['base_url'] or ''
+
+        # Check if we're using GPT-5 with OpenAI API
+        using_gpt5 = is_gpt5_model(model_name) and 'api.openai.com' in base_url
+
+        completion_args = {
+            "model": model_name,
+            "messages": messages,
+            "stream": stream
+        }
+
+        # Add stream_options to get usage in final chunk for streaming
+        # Some LLM servers don't support this OpenAI-specific option
+        if stream and ENABLE_STREAM_OPTIONS:
+            completion_args["stream_options"] = {"include_usage": True}
+
+        if using_gpt5:
+            logger.debug(f"Using GPT-5 chat model: {model_name}")
+            # Use chat-specific GPT-5 settings from config
+            completion_args["reasoning_effort"] = chat_config['gpt5_reasoning_effort']
+            completion_args["verbosity"] = chat_config['gpt5_verbosity']
+
+            if max_tokens:
+                completion_args["max_completion_tokens"] = max_tokens
+        else:
+            completion_args["temperature"] = temperature
+            if max_tokens:
+                completion_args["max_tokens"] = max_tokens
+
+        if response_format:
+            completion_args["response_format"] = response_format
+
+        # Visibility: surface the resolved budget per call so admins can
+        # confirm CHAT_MAX_TOKENS or per-call overrides took effect.
+        budget_key = 'max_completion_tokens' if using_gpt5 else 'max_tokens'
+        logger.info(
+            f"Chat LLM call: operation={operation_type or 'unspecified'}, model={model_name}, "
+            f"{budget_key}={completion_args.get(budget_key, 'provider default')}"
+        )
+
+        request_started_at = time.monotonic()
+        response = effective_client.chat.completions.create(**completion_args)
+
+        # Track usage for non-streaming calls
+        if user_id and operation_type and not stream and response.usage:
+            try:
+                from src.services.token_tracking import token_tracker
+                token_tracker.record_usage(
+                    user_id=user_id,
+                    operation_type=operation_type,
+                    prompt_tokens=response.usage.prompt_tokens,
+                    completion_tokens=response.usage.completion_tokens,
+                    total_tokens=response.usage.total_tokens,
+                    model_name=model_name,
+                    cost=getattr(response.usage, 'cost', None)
+                )
+            except Exception as e:
+                logger.warning(f"Failed to record token usage: {e}")
+
+        # Debug log for empty responses
+        if not stream and response.choices:
+            content = response.choices[0].message.content
+            if not content:
+                logger.warning(f"Chat LLM returned empty content. Model: {model_name}, finish_reason: {response.choices[0].finish_reason}")
+
+        return response
+
+    except TokenBudgetExceeded:
+        raise
+    except APITimeoutError as e:
+        elapsed = time.monotonic() - request_started_at if 'request_started_at' in locals() else None
+        elapsed_str = f"{elapsed:.1f}s" if elapsed is not None else "unknown"
+        logger.error(
+            f"Chat LLM request timed out after {elapsed_str} (configured read_timeout={LLM_REQUEST_TIMEOUT}s, "
+            f"max_retries={LLM_MAX_RETRIES}, model={model_name}). "
+            f"If the elapsed time is much shorter than the configured timeout, an upstream proxy or the "
+            f"provider is closing the connection early. For reasoning models that take longer to think, "
+            f"increase LLM_REQUEST_TIMEOUT."
+        )
+        raise
+    except Exception as e:
+        logger.error(f"Chat LLM API call failed: {e}")
+        raise
+
+
+def format_api_error_message(error_str):
+    """
+    Formats API error messages to be more user-friendly.
+    Specifically handles token limit errors with helpful suggestions.
+    """
+    error_lower = error_str.lower()
+    
+    # Check for token limit errors
+    if 'maximum context length' in error_lower and 'tokens' in error_lower:
+        return "[Summary generation failed: The transcription is too long for AI processing. Request your admin to try using a different LLM with a larger context size, or set a limit for the transcript_length_limit in the system settings.]"
+    
+    # Check for other common API errors
+    if 'rate limit' in error_lower:
+        return "[Summary generation failed: API rate limit exceeded. Please try again in a few minutes.]"
+    
+    if 'insufficient funds' in error_lower or 'quota exceeded' in error_lower:
+        return "[Summary generation failed: API quota exceeded. Please contact support.]"
+    
+    if 'timeout' in error_lower:
+        return "[Summary generation failed: Request timed out. Please try again.]"
+    
+    # For other errors, show a generic message
+    return f"[Summary generation failed: {error_str}]"
+
+
+def process_streaming_with_thinking(stream, user_id=None, operation_type=None, model_name=None, app=None):
+    """
+    Generator that processes a streaming response and separates thinking content.
+    Yields SSE-formatted data with 'delta' for regular content and 'thinking' for thinking content.
+
+    Args:
+        stream: The streaming response from the LLM API
+        user_id: Optional user ID for token tracking
+        operation_type: Optional operation type for token tracking
+        model_name: Optional model name for token tracking
+        app: Optional Flask app instance for database context in generators
+    """
+    content_buffer = ""
+    in_thinking = False
+    thinking_buffer = ""
+
+    for chunk in stream:
+        # Check for usage in final chunk (from stream_options={'include_usage': True})
+        if hasattr(chunk, 'usage') and chunk.usage and user_id and operation_type:
+            try:
+                from src.services.token_tracking import token_tracker
+                # Use app context if provided (needed for generators where context may be lost)
+                if app:
+                    with app.app_context():
+                        token_tracker.record_usage(
+                            user_id=user_id,
+                            operation_type=operation_type,
+                            prompt_tokens=chunk.usage.prompt_tokens,
+                            completion_tokens=chunk.usage.completion_tokens,
+                            total_tokens=chunk.usage.total_tokens,
+                            model_name=model_name or TEXT_MODEL_NAME,
+                            cost=getattr(chunk.usage, 'cost', None)
+                        )
+                else:
+                    token_tracker.record_usage(
+                        user_id=user_id,
+                        operation_type=operation_type,
+                        prompt_tokens=chunk.usage.prompt_tokens,
+                        completion_tokens=chunk.usage.completion_tokens,
+                        total_tokens=chunk.usage.total_tokens,
+                        model_name=model_name or TEXT_MODEL_NAME,
+                        cost=getattr(chunk.usage, 'cost', None)
+                    )
+            except Exception as e:
+                logger.warning(f"Failed to record streaming token usage: {e}")
+
+        # Process content delta
+        if chunk.choices and chunk.choices[0].delta.content:
+            content = chunk.choices[0].delta.content
+            content_buffer += content
+
+            # Process the buffer to detect and handle thinking tags
+            while True:
+                if not in_thinking:
+                    # Look for opening thinking tag
+                    think_start = re.search(r'<think(?:ing)?>', content_buffer, re.IGNORECASE)
+                    if think_start:
+                        # Send any content before the thinking tag
+                        before_thinking = content_buffer[:think_start.start()]
+                        if before_thinking:
+                            yield f"data: {json.dumps({'delta': before_thinking})}\n\n"
+
+                        # Start capturing thinking content
+                        in_thinking = True
+                        content_buffer = content_buffer[think_start.end():]
+                        thinking_buffer = ""
+                    else:
+                        # No thinking tag found, send accumulated content
+                        if content_buffer:
+                            yield f"data: {json.dumps({'delta': content_buffer})}\n\n"
+                        content_buffer = ""
+                        break
+                else:
+                    # We're inside a thinking tag, look for closing tag
+                    think_end = re.search(r'</think(?:ing)?>', content_buffer, re.IGNORECASE)
+                    if think_end:
+                        # Capture thinking content up to the closing tag
+                        thinking_buffer += content_buffer[:think_end.start()]
+
+                        # Send the thinking content as a special type
+                        if thinking_buffer.strip():
+                            yield f"data: {json.dumps({'thinking': thinking_buffer.strip()})}\n\n"
+
+                        # Continue processing after the closing tag
+                        in_thinking = False
+                        content_buffer = content_buffer[think_end.end():]
+                        thinking_buffer = ""
+                    else:
+                        # Still inside thinking tag, accumulate content
+                        thinking_buffer += content_buffer
+                        content_buffer = ""
+                        break
+
+    # Handle any remaining content
+    if in_thinking and thinking_buffer:
+        # Unclosed thinking tag - send as thinking content
+        yield f"data: {json.dumps({'thinking': thinking_buffer.strip()})}\n\n"
+    elif content_buffer:
+        # Regular content
+        yield f"data: {json.dumps({'delta': content_buffer})}\n\n"
+
+    # Signal the end of the stream
+    yield f"data: {json.dumps({'end_of_stream': True})}\n\n"
+
+
+
diff --git a/src/services/retention.py b/src/services/retention.py
new file mode 100644
index 00000000..35af4d71
--- /dev/null
+++ b/src/services/retention.py
@@ -0,0 +1,219 @@
+"""
+Recording retention and auto-deletion services.
+"""
+
+import os
+from datetime import datetime, timedelta
+from flask import current_app
+
+from src.database import db
+from src.models import Recording, RecordingTag, Tag
+
+ENABLE_AUTO_DELETION = os.environ.get('ENABLE_AUTO_DELETION', 'false').lower() == 'true'
+GLOBAL_RETENTION_DAYS = int(os.environ.get('GLOBAL_RETENTION_DAYS', '0'))
+DELETION_MODE = os.environ.get('DELETION_MODE', 'full_recording')
+
+
+
+def is_recording_exempt_from_deletion(recording):
+    """
+    Check if a recording is exempt from auto-deletion.
+
+    Args:
+        recording: Recording object to check
+
+    Returns:
+        Boolean indicating if the recording should be kept
+    """
+    # Manual exemption flag
+    if recording.deletion_exempt:
+        return True
+
+    # Check if any of the recording's tags protect it from deletion
+    # Protection can be indicated by either protect_from_deletion flag OR retention_days == -1
+    for tag_assoc in recording.tag_associations:
+        if tag_assoc.tag.protect_from_deletion:
+            return True
+        if tag_assoc.tag.retention_days == -1:
+            return True
+
+    return False
+
+
+
+def get_retention_days_for_recording(recording):
+    """
+    Get the effective retention period for a recording.
+    Multi-tier system: tag retention (shortest) → global retention
+
+    Tags with retention_days set override the global retention policy.
+    If multiple tags have retention_days, the SHORTEST period is used (most conservative).
+    Note: retention_days == -1 indicates infinite retention (protected), which is handled separately.
+
+    Args:
+        recording: Recording object
+
+    Returns:
+        Integer days for retention period, or None if no retention applies
+    """
+    # Collect all tag-level retention periods
+    # Skip -1 (infinite retention/protected) as that's handled in is_recording_exempt_from_deletion
+    tag_retention_periods = []
+    for tag_assoc in recording.tag_associations:
+        if tag_assoc.tag.retention_days and tag_assoc.tag.retention_days > 0:
+            tag_retention_periods.append(tag_assoc.tag.retention_days)
+
+    # If any tags have retention periods, use the shortest one (most conservative)
+    if tag_retention_periods:
+        return min(tag_retention_periods)
+
+    # Fall back to global retention
+    if GLOBAL_RETENTION_DAYS > 0:
+        return GLOBAL_RETENTION_DAYS
+
+    return None
+
+
+
+def process_auto_deletion():
+    """
+    Process auto-deletion of recordings based on retention policies.
+    This can be called by a scheduled job or admin endpoint.
+
+    Supports per-recording retention via tag-level retention_days overrides.
+    Tags with retention_days set take precedence over global retention.
+
+    Returns:
+        Dictionary with deletion statistics
+    """
+    if not ENABLE_AUTO_DELETION:
+        return {'error': 'Auto-deletion is not enabled'}
+
+    # Check if any retention policy exists (global or tag-level)
+    has_global_retention = GLOBAL_RETENTION_DAYS > 0
+    # We'll check for tag-level retention on a per-recording basis
+
+    if not has_global_retention:
+        # Still check recordings in case they have tag-level retention
+        current_app.logger.info("No global retention configured, checking for tag-level retention policies")
+
+    stats = {
+        'checked': 0,
+        'deleted_audio_only': 0,
+        'deleted_full': 0,
+        'exempted': 0,
+        'skipped_no_retention': 0,
+        'errors': 0
+    }
+
+    try:
+        # Get completed recordings to check
+        # In audio_only mode: Skip recordings where audio was already deleted
+        # In full_recording mode: Include all (to catch audio-only deletions for full cleanup)
+        if DELETION_MODE == 'audio_only':
+            all_recordings = Recording.query.filter(
+                Recording.status == 'COMPLETED',
+                Recording.audio_deleted_at.is_(None)  # Skip already-deleted audio
+            ).all()
+        else:  # full_recording mode
+            all_recordings = Recording.query.filter(
+                Recording.status == 'COMPLETED'
+            ).all()
+
+        stats['checked'] = len(all_recordings)
+        current_time = datetime.utcnow()
+
+        for recording in all_recordings:
+            try:
+                # Check if exempt from deletion entirely
+                if is_recording_exempt_from_deletion(recording):
+                    stats['exempted'] += 1
+                    continue
+
+                # Get the effective retention period for this specific recording
+                retention_days = get_retention_days_for_recording(recording)
+
+                if not retention_days:
+                    # No retention policy applies to this recording
+                    stats['skipped_no_retention'] += 1
+                    continue
+
+                # Calculate the cutoff date for this specific recording
+                cutoff_date = current_time - timedelta(days=retention_days)
+
+                # Check if recording is past its retention period
+                if recording.created_at >= cutoff_date:
+                    # Recording is still within retention period
+                    continue
+
+                # Recording is past retention period - process deletion
+
+                # Determine deletion mode
+                if DELETION_MODE == 'audio_only':
+                    # Delete only the audio file, keep transcription
+                    if recording.audio_path and os.path.exists(recording.audio_path):
+                        current_app.logger.info(f"Recording {recording.id} is past retention ({retention_days} days), deleting audio")
+                        os.remove(recording.audio_path)
+                        current_app.logger.info(f"Auto-deleted audio file: {recording.audio_path}")
+                        recording.audio_deleted_at = datetime.utcnow()
+                        db.session.commit()
+                        stats['deleted_audio_only'] += 1
+                    else:
+                        # Audio already deleted or doesn't exist - just mark timestamp
+                        if not recording.audio_deleted_at:
+                            recording.audio_deleted_at = datetime.utcnow()
+                            db.session.commit()
+                            current_app.logger.debug(f"Recording {recording.id} audio file not found, marked as deleted")
+
+                else:  # full_recording mode
+                    # Check if this is completing a previous audio_only deletion
+                    if recording.audio_deleted_at:
+                        current_app.logger.info(f"Recording {recording.id} has deleted audio (mode changed), completing full deletion")
+                    else:
+                        current_app.logger.info(f"Recording {recording.id} is past retention ({retention_days} days), deleting fully")
+
+                    # Delete audio file if it exists
+                    if recording.audio_path and os.path.exists(recording.audio_path):
+                        os.remove(recording.audio_path)
+
+                    # Delete associated processing jobs (required due to NOT NULL constraint)
+                    from src.models.processing_job import ProcessingJob
+                    ProcessingJob.query.filter_by(recording_id=recording.id).delete()
+
+                    # Delete the database record (cascades to chunks, shares, etc.)
+                    db.session.delete(recording)
+                    db.session.commit()
+                    stats['deleted_full'] += 1
+                    current_app.logger.info(f"Auto-deleted full recording ID: {recording.id}")
+
+            except Exception as e:
+                stats['errors'] += 1
+                current_app.logger.error(f"Error auto-deleting recording {recording.id}: {e}")
+                db.session.rollback()
+
+        # After processing recording deletions, clean up orphaned speaker profiles
+        try:
+            from src.services.speaker_cleanup import cleanup_orphaned_speakers
+            speaker_stats = cleanup_orphaned_speakers()
+            stats['speakers_deleted'] = speaker_stats['speakers_deleted']
+            stats['embeddings_cleaned'] = speaker_stats['embeddings_removed']
+            stats['speakers_evaluated'] = speaker_stats['speakers_evaluated']
+            current_app.logger.info(
+                f"Speaker cleanup completed: {speaker_stats['speakers_deleted']} speakers deleted, "
+                f"{speaker_stats['embeddings_removed']} embedding references removed"
+            )
+        except Exception as e:
+            current_app.logger.error(f"Error during speaker cleanup: {e}", exc_info=True)
+            stats['speaker_cleanup_error'] = str(e)
+
+        current_app.logger.info(f"Auto-deletion completed: {stats}")
+        return stats
+
+    except Exception as e:
+        current_app.logger.error(f"Error during auto-deletion process: {e}", exc_info=True)
+        return {'error': str(e)}
+
+# --- API client setup for OpenRouter ---
+# Use environment variables from .env
+
+
diff --git a/src/services/speaker.py b/src/services/speaker.py
new file mode 100644
index 00000000..d6559767
--- /dev/null
+++ b/src/services/speaker.py
@@ -0,0 +1,219 @@
+"""
+Speaker identification and management services.
+"""
+
+import os
+import re
+from datetime import datetime
+from flask import current_app
+from flask_login import current_user
+
+from src.database import db
+from src.models import Speaker, SystemSetting
+from src.services.llm import call_llm_completion
+from src.utils import safe_json_loads
+
+# NOTE: format_transcription_for_llm is referenced but not defined - needs to be implemented
+def format_transcription_for_llm(transcription):
+    """
+    Format transcription for LLM processing.
+
+    TODO: This function needs proper implementation.
+    If transcription is JSON, extract and format the text.
+    Otherwise return as-is.
+    """
+    if isinstance(transcription, str):
+        try:
+            import json
+            data = json.loads(transcription)
+            # If it's JSON diarized format, extract text
+            if isinstance(data, list):
+                return '\n'.join([f"[{seg.get('speaker', 'UNKNOWN')}] {seg.get('text', '')}"
+                                  for seg in data if 'text' in seg])
+        except:
+            pass
+    return str(transcription)
+
+# Import TEXT_MODEL_API_KEY from llm service
+from src.services.llm import TEXT_MODEL_API_KEY
+
+
+def update_speaker_usage(speaker_names):
+    """Helper function to update speaker usage statistics."""
+    if not speaker_names or not current_user.is_authenticated:
+        return
+    
+    try:
+        for name in speaker_names:
+            name = name.strip()
+            if not name:
+                continue
+                
+            speaker = Speaker.query.filter_by(user_id=current_user.id, name=name).first()
+            if speaker:
+                speaker.use_count += 1
+                speaker.last_used = datetime.utcnow()
+            else:
+                # Create new speaker
+                speaker = Speaker(
+                    name=name,
+                    user_id=current_user.id,
+                    use_count=1,
+                    created_at=datetime.utcnow(),
+                    last_used=datetime.utcnow()
+                )
+                db.session.add(speaker)
+        
+        db.session.commit()
+    except Exception as e:
+        current_app.logger.error(f"Error updating speaker usage: {e}")
+        db.session.rollback()
+
+
+
+def identify_speakers_from_text(transcription):
+    """
+    Uses an LLM to identify speakers from a transcription.
+    """
+    if not TEXT_MODEL_API_KEY:
+        raise ValueError("TEXT_MODEL_API_KEY not configured.")
+
+    # The transcription passed here could be JSON, so we format it.
+    formatted_transcription = format_transcription_for_llm(transcription)
+
+    # Extract existing speaker labels (e.g., SPEAKER_00, SPEAKER_01) in order of appearance
+    all_labels = re.findall(r'\[(SPEAKER_\d+)\]', formatted_transcription)
+    seen = set()
+    speaker_labels = [x for x in all_labels if not (x in seen or seen.add(x))]
+    
+    if not speaker_labels:
+        return {}
+
+    # Get configurable transcript length limit
+    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+    if transcript_limit == -1:
+        # No limit
+        transcript_text = formatted_transcription
+    else:
+        transcript_text = formatted_transcription[:transcript_limit]
+
+    prompt = f"""Analyze the following transcription and identify the names of the speakers. The speakers are labeled as {', '.join(speaker_labels)}. Based on the context of the conversation, determine the most likely name for each speaker label.
+
+Transcription:
+---
+{transcript_text}
+---
+
+Respond with a single JSON object where keys are the speaker labels (e.g., "SPEAKER_00") and values are the identified full names. If a name cannot be determined, use the value "Unknown".
+
+Example:
+{{
+  "SPEAKER_00": "John Doe",
+  "SPEAKER_01": "Jane Smith",
+  "SPEAKER_02": "Unknown"
+}}
+
+JSON Response:
+"""
+
+    try:
+        completion = call_llm_completion(
+            messages=[
+                {"role": "system", "content": "You are an expert in analyzing conversation transcripts to identify speakers. Your response must be a single, valid JSON object."},
+                {"role": "user", "content": prompt}
+            ],
+            temperature=0.2,
+            response_format={"type": "json_object"}
+        )
+        response_content = completion.choices[0].message.content
+        speaker_map = safe_json_loads(response_content, {})
+
+        # Post-process the map to replace "Unknown" with an empty string
+        for speaker_label, identified_name in speaker_map.items():
+            if identified_name.strip().lower() == "unknown":
+                speaker_map[speaker_label] = ""
+
+        return speaker_map
+    except Exception as e:
+        current_app.logger.error(f"Error calling LLM for speaker identification: {e}")
+        raise
+
+
+def identify_unidentified_speakers_from_text(transcription, unidentified_speakers):
+    """
+    Uses an LLM to identify only the unidentified speakers from a transcription.
+    """
+    if not TEXT_MODEL_API_KEY:
+        raise ValueError("TEXT_MODEL_API_KEY not configured.")
+
+    # The transcription passed here could be JSON, so we format it.
+    formatted_transcription = format_transcription_for_llm(transcription)
+
+    if not unidentified_speakers:
+        return {}
+
+    # Get configurable transcript length limit
+    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+    if transcript_limit == -1:
+        # No limit
+        transcript_text = formatted_transcription
+    else:
+        transcript_text = formatted_transcription[:transcript_limit]
+
+    prompt = f"""Analyze the following conversation transcript and identify the names of the UNIDENTIFIED speakers based on the context and content of their dialogue.
+
+The speakers that need to be identified are: {', '.join(unidentified_speakers)}
+
+Look for clues in the conversation such as:
+- Names mentioned by other speakers when addressing someone
+- Self-introductions or references to their own name
+- Context clues about roles, relationships, or positions
+- Any direct mentions of names in the dialogue
+
+Here is the complete conversation transcript:
+
+{transcript_text}
+
+Based on the conversation above, identify the most likely real names for the unidentified speakers. Pay close attention to how speakers address each other and any names that are mentioned in the dialogue.
+
+Respond with a single JSON object where keys are the speaker labels (e.g., "SPEAKER_01") and values are the identified full names. If a name cannot be determined from the conversation context, use an empty string "".
+
+Example format:
+{{
+  "SPEAKER_01": "Jane Smith",
+  "SPEAKER_03": "Bob Johnson",
+  "SPEAKER_05": ""
+}}
+
+JSON Response:
+"""
+
+    try:
+        current_app.logger.info(f"[Auto-Identify] Calling LLM to identify speakers: {unidentified_speakers}")
+        current_app.logger.info(f"[Auto-Identify] Transcript excerpt (first 500 chars): {transcript_text[:500]}")
+
+        completion = call_llm_completion(
+            messages=[
+                {"role": "system", "content": "You are an expert in analyzing conversation transcripts to identify speakers based on contextual clues in the dialogue. Analyze the conversation carefully to find names mentioned when speakers address each other or introduce themselves. Your response must be a single, valid JSON object containing only the requested speaker identifications."},
+                {"role": "user", "content": prompt}
+            ],
+            temperature=0.2,
+            response_format={"type": "json_object"}
+        )
+        response_content = completion.choices[0].message.content
+        current_app.logger.info(f"[Auto-Identify] LLM Raw Response: {response_content}")
+
+        speaker_map = safe_json_loads(response_content, {})
+        current_app.logger.info(f"[Auto-Identify] Parsed speaker_map: {speaker_map}")
+
+        # Post-process the map to replace "Unknown" with an empty string
+        for speaker_label, identified_name in speaker_map.items():
+            if identified_name and identified_name.strip().lower() in ["unknown", "n/a", "not available", "unclear"]:
+                speaker_map[speaker_label] = ""
+
+        current_app.logger.info(f"[Auto-Identify] Final speaker_map after post-processing: {speaker_map}")
+        return speaker_map
+    except Exception as e:
+        current_app.logger.error(f"Error calling LLM for speaker identification: {e}", exc_info=True)
+        raise
+
diff --git a/src/services/speaker_cleanup.py b/src/services/speaker_cleanup.py
new file mode 100644
index 00000000..80c147a9
--- /dev/null
+++ b/src/services/speaker_cleanup.py
@@ -0,0 +1,295 @@
+"""
+Speaker cleanup service for managing orphaned speaker voice profiles.
+
+This module provides automatic cleanup of speaker records when their associated
+recordings are deleted through auto-deletion or manual deletion processes.
+
+By default, speaker profiles (including voice embeddings) are preserved even
+when all their recordings are deleted, since embeddings are aggregated and
+represent hours of manual identification work. Set DELETE_ORPHANED_SPEAKERS=true
+to enable automatic cleanup of speakers with no remaining recordings.
+"""
+
+import os
+import logging
+import json
+from datetime import datetime
+from sqlalchemy import exists
+from src.database import db
+from src.models import Speaker, SpeakerSnippet, Recording
+
+logger = logging.getLogger(__name__)
+
+
+def cleanup_orphaned_speakers(dry_run=False):
+    """
+    Clean up speaker records that no longer have any associated recordings.
+
+    Only runs if DELETE_ORPHANED_SPEAKERS=true is set. By default, speaker
+    profiles are preserved because voice embeddings are aggregated values
+    that can't be reconstructed from recordings alone.
+
+    A speaker is considered orphaned when:
+    - It has no SpeakerSnippet records
+    - Its embeddings_history contains no valid recording references
+
+    Args:
+        dry_run (bool): If True, only report what would be deleted without actually deleting
+
+    Returns:
+        dict: Statistics about cleanup operation
+            {
+                'speakers_deleted': int,
+                'embeddings_removed': int,
+                'speakers_evaluated': int,
+                'orphaned_speakers': list of dict (if dry_run=True)
+            }
+    """
+    delete_orphans = os.environ.get('DELETE_ORPHANED_SPEAKERS', 'false').lower() in ('true', '1', 'yes')
+
+    if not delete_orphans:
+        logger.debug("Speaker cleanup skipped (DELETE_ORPHANED_SPEAKERS is not enabled)")
+        return {
+            'speakers_deleted': 0,
+            'embeddings_removed': 0,
+            'speakers_evaluated': 0,
+            'orphaned_speakers': []
+        }
+
+    logger.info("Starting speaker cleanup process (dry_run=%s)", dry_run)
+
+    stats = {
+        'speakers_deleted': 0,
+        'embeddings_removed': 0,
+        'speakers_evaluated': 0,
+        'orphaned_speakers': []
+    }
+
+    try:
+        # Clean embeddings_history references first
+        embeddings_cleaned = clean_embeddings_history_references(dry_run=dry_run)
+        stats['embeddings_removed'] = embeddings_cleaned
+
+        # Find and process orphaned speakers
+        orphaned_speaker_ids = get_orphaned_speakers()
+        stats['speakers_evaluated'] = Speaker.query.count()
+
+        if not orphaned_speaker_ids:
+            logger.info("No orphaned speakers found")
+            return stats
+
+        logger.info("Found %d orphaned speaker(s)", len(orphaned_speaker_ids))
+
+        if dry_run:
+            # Report what would be deleted
+            for speaker_id in orphaned_speaker_ids:
+                speaker = Speaker.query.get(speaker_id)
+                if speaker:
+                    stats['orphaned_speakers'].append({
+                        'id': speaker.id,
+                        'name': speaker.name,
+                        'user_id': speaker.user_id,
+                        'embedding_count': speaker.embedding_count
+                    })
+            logger.info("Dry run: Would delete %d speakers", len(orphaned_speaker_ids))
+        else:
+            # Actually delete orphaned speakers
+            for speaker_id in orphaned_speaker_ids:
+                speaker = Speaker.query.get(speaker_id)
+                if speaker:
+                    logger.debug(
+                        "Deleting orphaned speaker: id=%d, name='%s', user_id=%d, embedding_count=%d",
+                        speaker.id, speaker.name, speaker.user_id, speaker.embedding_count or 0
+                    )
+                    db.session.delete(speaker)
+                    stats['speakers_deleted'] += 1
+
+            # Commit all deletions
+            db.session.commit()
+            logger.info("Speaker cleanup completed: %d speakers deleted", stats['speakers_deleted'])
+
+            # Warning if large number deleted
+            if stats['speakers_deleted'] >= 50:
+                logger.warning(
+                    "Large number of speakers deleted (%d). Review cleanup logic if unexpected.",
+                    stats['speakers_deleted']
+                )
+
+        return stats
+
+    except Exception as e:
+        db.session.rollback()
+        logger.error("Error during speaker cleanup: %s", str(e), exc_info=True)
+        raise
+
+
+def clean_embeddings_history_references(dry_run=False):
+    """
+    Clean embeddings_history JSON fields to remove references to deleted recordings.
+
+    Scans all speakers' embeddings_history and removes entries where the
+    recording_id no longer exists in the database.
+
+    Args:
+        dry_run (bool): If True, only count what would be cleaned
+
+    Returns:
+        int: Number of embedding references removed
+    """
+    logger.debug("Cleaning embeddings_history references (dry_run=%s)", dry_run)
+
+    references_removed = 0
+
+    try:
+        # Get all speakers with embeddings_history
+        speakers = Speaker.query.filter(Speaker.embeddings_history.isnot(None)).all()
+
+        for speaker in speakers:
+            try:
+                # Parse embeddings_history JSON
+                if not speaker.embeddings_history:
+                    continue
+
+                history = speaker.embeddings_history if isinstance(speaker.embeddings_history, list) else json.loads(speaker.embeddings_history)
+
+                if not history or not isinstance(history, list):
+                    continue
+
+                # Filter out entries with deleted recording_ids
+                cleaned_history = []
+                for entry in history:
+                    if not isinstance(entry, dict) or 'recording_id' not in entry:
+                        continue
+
+                    recording_id = entry['recording_id']
+
+                    # Check if recording still exists
+                    recording_exists = db.session.query(
+                        exists().where(Recording.id == recording_id)
+                    ).scalar()
+
+                    if recording_exists:
+                        cleaned_history.append(entry)
+                    else:
+                        references_removed += 1
+                        logger.debug(
+                            "Removing deleted recording reference: speaker_id=%d, recording_id=%d",
+                            speaker.id, recording_id
+                        )
+
+                # Update speaker if history changed
+                if len(cleaned_history) < len(history):
+                    if not dry_run:
+                        speaker.embeddings_history = cleaned_history
+                        logger.debug(
+                            "Updated speaker %d embeddings_history: %d -> %d entries",
+                            speaker.id, len(history), len(cleaned_history)
+                        )
+
+            except (json.JSONDecodeError, TypeError, KeyError) as e:
+                logger.warning(
+                    "Error processing embeddings_history for speaker %d: %s",
+                    speaker.id, str(e)
+                )
+                continue
+
+        if not dry_run and references_removed > 0:
+            db.session.commit()
+            logger.debug("Cleaned %d embedding references", references_removed)
+
+        return references_removed
+
+    except Exception as e:
+        db.session.rollback()
+        logger.error("Error cleaning embeddings_history: %s", str(e), exc_info=True)
+        raise
+
+
+def get_orphaned_speakers(user_id=None):
+    """
+    Get list of speaker IDs that are orphaned (no associated recordings).
+
+    A speaker is orphaned when:
+    - It has no SpeakerSnippet records
+    - After cleaning embeddings_history, it has no valid recording references
+
+    Args:
+        user_id (int, optional): Filter to specific user's speakers
+
+    Returns:
+        list: List of speaker IDs that are orphaned
+    """
+    logger.debug("Finding orphaned speakers (user_id=%s)", user_id)
+
+    # Query for speakers with no snippets
+    query = Speaker.query.filter(
+        ~exists().where(SpeakerSnippet.speaker_id == Speaker.id)
+    )
+
+    if user_id is not None:
+        query = query.filter(Speaker.user_id == user_id)
+
+    speakers_without_snippets = query.all()
+
+    orphaned_ids = []
+
+    for speaker in speakers_without_snippets:
+        # Check if embeddings_history has any valid recording references
+        has_valid_recordings = False
+
+        if speaker.embeddings_history:
+            try:
+                history = speaker.embeddings_history if isinstance(speaker.embeddings_history, list) else json.loads(speaker.embeddings_history)
+
+                if history and isinstance(history, list):
+                    for entry in history:
+                        if isinstance(entry, dict) and 'recording_id' in entry:
+                            recording_id = entry['recording_id']
+
+                            # Check if this recording exists
+                            recording_exists = db.session.query(
+                                exists().where(Recording.id == recording_id)
+                            ).scalar()
+
+                            if recording_exists:
+                                has_valid_recordings = True
+                                break
+            except (json.JSONDecodeError, TypeError, KeyError):
+                pass
+
+        # If no snippets AND no valid recording references, it's orphaned
+        if not has_valid_recordings:
+            orphaned_ids.append(speaker.id)
+            logger.debug(
+                "Speaker %d ('%s') is orphaned: no snippets, no valid recordings",
+                speaker.id, speaker.name
+            )
+
+    return orphaned_ids
+
+
+def get_speaker_cleanup_statistics():
+    """
+    Get statistics about speaker data for monitoring.
+
+    Returns:
+        dict: Statistics about speakers
+            {
+                'total_speakers': int,
+                'speakers_with_snippets': int,
+                'speakers_with_embeddings': int,
+                'potential_orphans': int
+            }
+    """
+    stats = {
+        'total_speakers': Speaker.query.count(),
+        'speakers_with_snippets': db.session.query(Speaker.id).join(
+            SpeakerSnippet, Speaker.id == SpeakerSnippet.speaker_id
+        ).distinct().count(),
+        'speakers_with_embeddings': Speaker.query.filter(
+            Speaker.average_embedding.isnot(None)
+        ).count(),
+        'potential_orphans': len(get_orphaned_speakers())
+    }
+
+    return stats
diff --git a/src/services/speaker_embedding_matcher.py b/src/services/speaker_embedding_matcher.py
new file mode 100644
index 00000000..eab91bcb
--- /dev/null
+++ b/src/services/speaker_embedding_matcher.py
@@ -0,0 +1,453 @@
+"""
+Speaker Embedding Matcher Service.
+
+This service handles voice embedding comparison and matching for speaker identification.
+It provides functions to:
+- Serialize/deserialize speaker embeddings for database storage
+- Calculate cosine similarity between voice embeddings
+- Find matching speakers based on voice similarity
+- Update speaker profiles with new embeddings
+- Calculate confidence scores for speaker profiles
+
+Uses 256-dimensional embeddings from WhisperX diarization.
+"""
+
+import json
+import numpy as np
+from datetime import datetime
+try:
+    from sklearn.metrics.pairwise import cosine_similarity
+except ImportError:
+    cosine_similarity = None
+from src.database import db
+from src.models import Speaker
+
+
+def serialize_embedding(embedding_array):
+    """
+    Convert numpy array or list to binary for database storage.
+
+    Args:
+        embedding_array: numpy array or list of floats (256 dimensions)
+
+    Returns:
+        bytes: Binary representation (1,024 bytes for 256 × float32)
+    """
+    return np.array(embedding_array, dtype=np.float32).tobytes()
+
+
+def deserialize_embedding(binary_data):
+    """
+    Convert binary data back to numpy array.
+
+    Args:
+        binary_data: bytes from database (1,024 bytes)
+
+    Returns:
+        numpy.ndarray: 256-dimensional float32 array
+    """
+    return np.frombuffer(binary_data, dtype=np.float32)
+
+
+def calculate_similarity(embedding1, embedding2):
+    """
+    Compute cosine similarity between two 256-dimensional voice embeddings.
+
+    Args:
+        embedding1: numpy array, list, or binary data
+        embedding2: numpy array, list, or binary data
+
+    Returns:
+        float: Similarity score (0-1, where 1 is identical)
+    """
+    # Convert to numpy arrays if needed
+    e1 = np.array(embedding1, dtype=np.float32).reshape(1, -1)
+    e2 = np.array(embedding2, dtype=np.float32).reshape(1, -1)
+
+    # Cosine similarity returns values from -1 to 1
+    # For voice embeddings, we typically see 0.6-0.99 range
+    return float(cosine_similarity(e1, e2)[0][0])
+
+
+def find_matching_speakers(target_embedding, user_id, threshold=0.70):
+    """
+    Find speakers matching a target voice embedding for a specific user.
+
+    Args:
+        target_embedding: The voice embedding to match against (256-dim array/list)
+        user_id: User ID to search within
+        threshold: Minimum similarity score (0-1, default 0.70 = 70%)
+
+    Returns:
+        list: Sorted list of matching speakers with scores
+              [{'speaker_id': 5, 'name': 'John', 'similarity': 85.3, 'confidence': 0.92}, ...]
+    """
+    # Get all speakers with embeddings for this user
+    speakers = Speaker.query.filter_by(user_id=user_id).filter(
+        Speaker.average_embedding.isnot(None)
+    ).all()
+
+    if not speakers:
+        return []
+
+    matches = []
+    for speaker in speakers:
+        try:
+            # Deserialize and compare
+            speaker_emb = deserialize_embedding(speaker.average_embedding)
+            similarity = calculate_similarity(target_embedding, speaker_emb)
+
+            if similarity >= threshold:
+                matches.append({
+                    'speaker_id': speaker.id,
+                    'name': speaker.name,
+                    'similarity': round(similarity * 100, 1),  # Convert to percentage
+                    'confidence': speaker.confidence_score or 0.5,
+                    'embedding_count': speaker.embedding_count or 0
+                })
+        except Exception as e:
+            # Skip speakers with corrupted embeddings
+            continue
+
+    # Sort by similarity (highest first)
+    return sorted(matches, key=lambda x: x['similarity'], reverse=True)
+
+
+def update_speaker_embedding(speaker, new_embedding, recording_id):
+    """
+    Update a speaker's average embedding and history with a new sample.
+
+    Uses weighted moving average to update the profile:
+    - New embeddings get 30% weight
+    - Existing average gets 70% weight
+
+    Args:
+        speaker: Speaker model instance
+        new_embedding: New voice embedding (256-dim array/list)
+        recording_id: ID of the recording this embedding came from
+
+    Returns:
+        float: Similarity between new embedding and previous average (None if first)
+    """
+    new_emb_array = np.array(new_embedding, dtype=np.float32)
+    similarity_to_avg = None
+
+    if speaker.average_embedding is None:
+        # First embedding for this speaker
+        speaker.average_embedding = serialize_embedding(new_emb_array)
+        speaker.embedding_count = 1
+        speaker.embeddings_history = [{
+            'recording_id': recording_id,
+            'timestamp': datetime.utcnow().isoformat(),
+            'similarity': 100.0  # Perfect match to itself
+        }]
+    else:
+        # Update existing average
+        current_avg = deserialize_embedding(speaker.average_embedding)
+        similarity_to_avg = calculate_similarity(new_emb_array, current_avg)
+
+        # Weighted average: 30% new, 70% existing
+        # This prevents sudden shifts while still adapting to voice changes
+        weight = 0.3
+        updated_avg = (1 - weight) * current_avg + weight * new_emb_array
+
+        speaker.average_embedding = serialize_embedding(updated_avg)
+        speaker.embedding_count += 1
+
+        # Add to history (keep last 10 entries)
+        history = speaker.embeddings_history or []
+        history.append({
+            'recording_id': recording_id,
+            'timestamp': datetime.utcnow().isoformat(),
+            'similarity': round(similarity_to_avg * 100, 1)
+        })
+        speaker.embeddings_history = history[-10:]  # Keep most recent 10
+
+    # Recalculate confidence score
+    speaker.confidence_score = calculate_confidence(speaker)
+
+    # Commit changes
+    db.session.commit()
+
+    return similarity_to_avg
+
+
+def calculate_confidence(speaker):
+    """
+    Calculate confidence score based on embedding consistency.
+
+    Confidence is based on:
+    - Number of samples (more is better)
+    - Consistency of embeddings (high similarity scores = high confidence)
+
+    Args:
+        speaker: Speaker model instance with embeddings_history
+
+    Returns:
+        float: Confidence score (0-1)
+    """
+    if speaker.embedding_count is None or speaker.embedding_count < 1:
+        return 0.0
+
+    if speaker.embedding_count == 1:
+        return 0.5  # Medium confidence with single sample
+
+    # Get recent similarity scores from history
+    history = speaker.embeddings_history or []
+    if len(history) < 2:
+        return 0.5
+
+    # Use last 5 samples
+    recent_history = history[-5:]
+    similarities = [h.get('similarity', 0) / 100.0 for h in recent_history]
+
+    # Average similarity to the profile
+    avg_similarity = sum(similarities) / len(similarities)
+
+    # Penalize if we have very few samples
+    sample_factor = min(1.0, speaker.embedding_count / 5.0)
+
+    # Confidence = average similarity × sample factor
+    confidence = avg_similarity * sample_factor
+
+    return min(1.0, max(0.0, confidence))
+
+
+def get_speaker_voice_profile_summary(speaker):
+    """
+    Get a human-readable summary of a speaker's voice profile.
+
+    Args:
+        speaker: Speaker model instance
+
+    Returns:
+        dict: Profile summary with statistics and status
+    """
+    if not speaker.average_embedding:
+        return {
+            'has_profile': False,
+            'message': 'No voice profile yet'
+        }
+
+    return {
+        'has_profile': True,
+        'embedding_count': speaker.embedding_count or 0,
+        'confidence_score': speaker.confidence_score or 0.0,
+        'confidence_level': _get_confidence_level(speaker.confidence_score),
+        'last_updated': speaker.embeddings_history[-1]['timestamp'] if speaker.embeddings_history else None,
+        'recordings': len(speaker.embeddings_history or [])
+    }
+
+
+def _get_confidence_level(score):
+    """
+    Convert numeric confidence score to human-readable level.
+
+    Args:
+        score: float (0-1)
+
+    Returns:
+        str: 'low', 'medium', or 'high'
+    """
+    if score is None or score < 0.6:
+        return 'low'
+    elif score < 0.8:
+        return 'medium'
+    else:
+        return 'high'
+
+
+# Threshold mapping for auto-labelling
+AUTO_LABEL_THRESHOLDS = {
+    'low': 0.3,      # Aggressive, may have more false positives
+    'medium': 0.6,   # Default, balanced approach
+    'high': 0.8      # Only auto-label well-established speakers
+}
+
+# Base similarity threshold for finding matches (70%)
+BASE_SIMILARITY_THRESHOLD = 0.70
+
+# Ambiguity threshold: if top 2 matches are within 5% similarity, skip
+AMBIGUITY_MARGIN = 0.05
+
+
+def apply_auto_speaker_labels(recording, user):
+    """
+    Automatically label speakers in a recording based on voice profile matching.
+
+    This function matches speaker embeddings from the recording against the user's
+    saved speaker profiles and returns a mapping of generic labels to speaker names.
+
+    Args:
+        recording: Recording model instance with speaker_embeddings
+        user: User model instance with auto_speaker_labelling settings
+
+    Returns:
+        dict: Mapping of {SPEAKER_XX: speaker_name} for matched speakers,
+              or empty dict if auto-labelling is disabled or no matches found
+    """
+    # Check if user has auto-labelling enabled
+    if not user.auto_speaker_labelling:
+        return {}
+
+    # Check if recording has speaker embeddings
+    if not recording.speaker_embeddings:
+        return {}
+
+    # Get the user's threshold setting
+    threshold_setting = user.auto_speaker_labelling_threshold or 'medium'
+    confidence_threshold = AUTO_LABEL_THRESHOLDS.get(threshold_setting, AUTO_LABEL_THRESHOLDS['medium'])
+
+    speaker_map = {}
+    embeddings = recording.speaker_embeddings
+
+    for speaker_label, embedding_data in embeddings.items():
+        # embedding_data should be a list of floats (256 dimensions)
+        if not embedding_data or not isinstance(embedding_data, list):
+            continue
+
+        # Find matching speakers with base similarity threshold
+        matches = find_matching_speakers(
+            target_embedding=embedding_data,
+            user_id=user.id,
+            threshold=BASE_SIMILARITY_THRESHOLD
+        )
+
+        if not matches:
+            continue
+
+        # Check if the best match exceeds the user's confidence threshold
+        best_match = matches[0]
+        best_similarity = best_match['similarity'] / 100.0  # Convert from percentage
+
+        if best_similarity < confidence_threshold:
+            continue
+
+        # Check for ambiguity: if top 2 matches are within 5% similarity, skip
+        if len(matches) >= 2:
+            second_similarity = matches[1]['similarity'] / 100.0
+            if (best_similarity - second_similarity) <= AMBIGUITY_MARGIN:
+                # Ambiguous - top 2 matches too close
+                continue
+
+        # We have a clear winner - add to speaker map
+        speaker_map[speaker_label] = best_match['name']
+
+    return speaker_map
+
+
+def apply_speaker_names_to_transcription(recording, speaker_map):
+    """
+    Apply speaker name mappings to a recording's transcription.
+
+    This function updates the transcription JSON by replacing generic speaker
+    labels (SPEAKER_00, SPEAKER_01, etc.) with actual speaker names, and
+    updates the recording's participants list.
+
+    Args:
+        recording: Recording model instance with transcription
+        speaker_map: Dict mapping {SPEAKER_XX: speaker_name}
+
+    Returns:
+        bool: True if changes were made, False otherwise
+    """
+    import logging
+    logger = logging.getLogger(__name__)
+
+    if not speaker_map or not recording.transcription:
+        logger.warning(f"Auto-label: No speaker_map or transcription (map={bool(speaker_map)}, trans={bool(recording.transcription)})")
+        return False
+
+    try:
+        # Parse transcription as JSON array: [{speaker, sentence, start_time, end_time}, ...]
+        segments = json.loads(recording.transcription)
+    except (json.JSONDecodeError, TypeError) as e:
+        logger.warning(f"Auto-label: Failed to parse transcription as JSON: {e}")
+        return False
+
+    if not isinstance(segments, list) or not segments:
+        logger.warning(f"Auto-label: Transcription not in expected array format")
+        return False
+
+    # Track which speakers were renamed
+    renamed_speakers = set()
+
+    # Update speaker labels in segments
+    for segment in segments:
+        if 'speaker' in segment and segment['speaker'] in speaker_map:
+            segment['speaker'] = speaker_map[segment['speaker']]
+            renamed_speakers.add(segment['speaker'])
+
+    if not renamed_speakers:
+        logger.warning(f"Auto-label: No speakers matched in segments")
+        return False
+
+    logger.info(f"Auto-label: Applied names to {len(renamed_speakers)} speakers: {renamed_speakers}")
+
+    # Update participants field
+    all_speakers = set(s.get('speaker') for s in segments if 'speaker' in s)
+    if all_speakers:
+        recording.participants = ', '.join(sorted(all_speakers))
+
+    # Save updated transcription
+    recording.transcription = json.dumps(segments)
+    db.session.commit()
+
+    return True
+
+
+def update_speaker_profiles_from_recording(recording, speaker_map, user):
+    """
+    Update speaker voice profiles with new embeddings from a recording.
+
+    For each successfully matched speaker, this function updates their
+    average embedding and increments their usage count.
+
+    Args:
+        recording: Recording model instance with speaker_embeddings
+        speaker_map: Dict mapping {SPEAKER_XX: speaker_name} that was applied
+        user: User model instance
+
+    Returns:
+        int: Number of speaker profiles updated
+    """
+    if not speaker_map or not recording.speaker_embeddings:
+        return 0
+
+    updated_count = 0
+    embeddings = recording.speaker_embeddings
+
+    for speaker_label, speaker_name in speaker_map.items():
+        if speaker_label not in embeddings:
+            continue
+
+        embedding_data = embeddings[speaker_label]
+        if not embedding_data or not isinstance(embedding_data, list):
+            continue
+
+        # Find the speaker profile
+        speaker = Speaker.query.filter_by(
+            user_id=user.id,
+            name=speaker_name
+        ).first()
+
+        if not speaker:
+            continue
+
+        try:
+            # Update the speaker's embedding with the new sample
+            update_speaker_embedding(speaker, embedding_data, recording.id)
+
+            # Update usage tracking
+            speaker.use_count = (speaker.use_count or 0) + 1
+            speaker.last_used = datetime.utcnow()
+
+            updated_count += 1
+        except Exception:
+            # Skip if embedding update fails
+            continue
+
+    if updated_count > 0:
+        db.session.commit()
+
+    return updated_count
diff --git a/src/services/speaker_identification.py b/src/services/speaker_identification.py
new file mode 100644
index 00000000..64092c6c
--- /dev/null
+++ b/src/services/speaker_identification.py
@@ -0,0 +1,229 @@
+"""
+Shared speaker identification service.
+
+Provides LLM-based speaker identification from transcript context,
+used by both the web UI (recordings.py) and REST API (api_v1.py).
+"""
+
+import os
+import re
+import json
+from flask import current_app
+
+
+def identify_speakers_from_transcript(transcription_data, user_id):
+    """
+    Identify speakers in a transcription using an LLM.
+
+    Args:
+        transcription_data: List of transcript segments (already parsed JSON).
+        user_id: Current user's ID (for token tracking).
+
+    Returns:
+        dict mapping original speaker labels to identified names.
+        Values are empty string "" for unidentified speakers.
+
+    Raises:
+        ValueError: If LLM API key is not configured.
+        Exception: On LLM call failure.
+    """
+    from src.services.llm import call_llm_completion
+    from src.utils import safe_json_loads
+    from src.models import SystemSetting
+
+    # Extract unique speakers in order of appearance
+    seen_speakers = set()
+    unique_speakers = []
+    for segment in transcription_data:
+        speaker = segment.get('speaker')
+        if speaker and speaker not in seen_speakers:
+            seen_speakers.add(speaker)
+            unique_speakers.append(speaker)
+
+    if not unique_speakers:
+        return {}
+
+    # Normalize all labels to SPEAKER_XX format for the LLM
+    speaker_to_label = {}
+    for idx, speaker in enumerate(unique_speakers):
+        speaker_to_label[speaker] = f'SPEAKER_{str(idx).zfill(2)}'
+
+    # Create temporary transcript with normalized labels
+    formatted_lines = []
+    for segment in transcription_data:
+        original_speaker = segment.get('speaker')
+        label = speaker_to_label.get(original_speaker, 'Unknown Speaker')
+        sentence = segment.get('sentence', '')
+        formatted_lines.append(f"[{label}]: {sentence}")
+    formatted_transcription = "\n".join(formatted_lines)
+
+    speaker_labels = list(speaker_to_label.values())
+
+    current_app.logger.info(f"[Auto-Identify] Formatted transcript (first 500 chars): {formatted_transcription[:500]}")
+    current_app.logger.info(f"[Auto-Identify] Speaker labels: {speaker_labels}")
+
+    # Apply configurable transcript length limit
+    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+    if transcript_limit == -1:
+        transcript_text = formatted_transcription
+    else:
+        transcript_text = formatted_transcription[:transcript_limit]
+
+    prompt = f"""Analyze the following conversation transcript and identify the names of the speakers based on the context and content of their dialogue.
+
+The speakers that need to be identified are: {', '.join(speaker_labels)}
+
+Look for clues in the conversation such as:
+- Names mentioned by other speakers when addressing someone
+- Self-introductions or references to their own name
+- Context clues about roles, relationships, or positions
+- Any direct mentions of names in the dialogue
+
+Here is the complete conversation transcript:
+
+{transcript_text}
+
+Based on the conversation above, identify the most likely real names for the speakers. Pay close attention to how speakers address each other and any names that are mentioned in the dialogue.
+
+Respond with a single JSON object where keys are the speaker labels (e.g., "SPEAKER_01") and values are the identified full names. If a name cannot be determined from the conversation context, use an empty string "".
+
+Example format:
+{{
+  "SPEAKER_01": "Jane Smith",
+  "SPEAKER_03": "Bob Johnson",
+  "SPEAKER_05": ""
+}}
+
+JSON Response:
+"""
+
+    current_app.logger.info("[Auto-Identify] Calling LLM")
+
+    use_schema = os.environ.get('AUTO_IDENTIFY_RESPONSE_SCHEMA', '').strip() in ('1', 'true', 'yes')
+    system_msg = (
+        "You are an expert in analyzing conversation transcripts to identify speakers "
+        "based on contextual clues in the dialogue. Analyze the conversation carefully "
+        "to find names mentioned when speakers address each other or introduce themselves. "
+        "Your response must be a single, valid JSON object containing only the requested "
+        "speaker identifications."
+    )
+
+    response_content = None
+    if use_schema:
+        # Build JSON schema response format with constrained keys
+        schema_properties = {label: {"type": "string"} for label in speaker_labels}
+        schema_response_format = {
+            "type": "json_schema",
+            "json_schema": {
+                "name": "speaker_identification",
+                "strict": True,
+                "schema": {
+                    "type": "object",
+                    "properties": schema_properties,
+                    "required": speaker_labels,
+                    "additionalProperties": False
+                }
+            }
+        }
+        schema_prompt = prompt + f"\n\nIMPORTANT: Your JSON response must contain exactly these keys: {', '.join(speaker_labels)}"
+        try:
+            current_app.logger.info("[Auto-Identify] Trying json_schema response format")
+            completion = call_llm_completion(
+                messages=[
+                    {"role": "system", "content": system_msg},
+                    {"role": "user", "content": schema_prompt}
+                ],
+                temperature=0.2,
+                response_format=schema_response_format,
+                user_id=user_id,
+                operation_type='speaker_identification'
+            )
+            response_content = completion.choices[0].message.content
+            current_app.logger.info(f"[Auto-Identify] LLM Raw Response (schema mode): {response_content}")
+        except Exception as schema_err:
+            current_app.logger.warning(f"[Auto-Identify] json_schema mode failed, falling back to json_object: {schema_err}")
+            response_content = None
+
+    if response_content is None:
+        completion = call_llm_completion(
+            messages=[
+                {"role": "system", "content": system_msg},
+                {"role": "user", "content": prompt}
+            ],
+            temperature=0.2,
+            response_format={"type": "json_object"},
+            user_id=user_id,
+            operation_type='speaker_identification'
+        )
+        response_content = completion.choices[0].message.content
+        current_app.logger.info(f"[Auto-Identify] LLM Raw Response: {response_content}")
+
+    identified_map = safe_json_loads(response_content, {})
+    current_app.logger.info(f"[Auto-Identify] Parsed identified_map: {identified_map}")
+
+    # --- Sanitize identified_map ---
+    identified_map = _sanitize_identified_map(identified_map, speaker_labels)
+    current_app.logger.info(f"[Auto-Identify] Sanitized identified_map: {identified_map}")
+
+    # Map back to original speaker labels
+    final_speaker_map = {}
+    for original_speaker, temp_label in speaker_to_label.items():
+        if temp_label in identified_map:
+            final_speaker_map[original_speaker] = identified_map[temp_label]
+
+    current_app.logger.info(f"[Auto-Identify] Final speaker_map: {final_speaker_map}")
+    return final_speaker_map
+
+
+def _sanitize_identified_map(identified_map, speaker_labels):
+    """
+    Clean up LLM output: handle inverted maps, strip commentary,
+    clear placeholders, etc.
+    """
+    speaker_label_re = re.compile(r'^SPEAKER_\d{2}$')
+
+    # Detect inverted map ({name: "SPEAKER_XX"}) and flip it
+    if identified_map and all(
+        speaker_label_re.match(str(v)) for v in identified_map.values() if v
+    ) and not any(speaker_label_re.match(str(k)) for k in identified_map.keys()):
+        current_app.logger.warning("[Auto-Identify] Detected inverted map, flipping keys/values")
+        identified_map = {v: k for k, v in identified_map.items() if v}
+
+    sanitized = {}
+    for speaker_label, identified_name in identified_map.items():
+        # Skip entries whose key isn't a valid SPEAKER_XX label
+        if not speaker_label_re.match(str(speaker_label)):
+            continue
+        if not identified_name or not isinstance(identified_name, str):
+            sanitized[speaker_label] = ""
+            continue
+
+        name = identified_name.strip()
+
+        # Clear generic placeholders
+        if name.lower() in ["unknown", "n/a", "not available", "unclear", "unidentified", ""]:
+            sanitized[speaker_label] = ""
+            continue
+
+        # Clear label-to-label entries (e.g. "SPEAKER_01": "SPEAKER_02")
+        if speaker_label_re.match(name):
+            sanitized[speaker_label] = ""
+            continue
+
+        # Strip parenthetical content: "John (the host)" -> "John"
+        name = re.sub(r'\s*\([^)]*\)', '', name).strip()
+
+        # Take first name segment before comma, semicolon, or slash
+        name = re.split(r'[,;/]', name)[0].strip()
+
+        # Collapse whitespace
+        name = re.sub(r'\s+', ' ', name)
+
+        # Final check: if result still matches SPEAKER_XX, clear it
+        if speaker_label_re.match(name) or not name:
+            sanitized[speaker_label] = ""
+            continue
+
+        sanitized[speaker_label] = name
+
+    return sanitized
diff --git a/src/services/speaker_merge.py b/src/services/speaker_merge.py
new file mode 100644
index 00000000..c5300bc7
--- /dev/null
+++ b/src/services/speaker_merge.py
@@ -0,0 +1,226 @@
+"""
+Speaker Merge Service.
+
+This service handles merging multiple speaker profiles into one.
+Useful when users accidentally create duplicate speakers for the same person.
+
+When speakers are merged:
+- Voice embeddings are combined using weighted average
+- All snippets are transferred to the target speaker
+- Usage statistics are combined
+- Source speakers are deleted
+- Confidence score is recalculated
+"""
+
+import numpy as np
+from src.database import db
+from src.models import Speaker, SpeakerSnippet
+from src.services.speaker_embedding_matcher import (
+    serialize_embedding,
+    deserialize_embedding,
+    calculate_confidence
+)
+
+
+def merge_speakers(target_id, source_ids, user_id):
+    """
+    Merge multiple speaker profiles into one target speaker.
+
+    All embeddings, snippets, and usage data from source speakers are
+    combined into the target speaker. Source speakers are then deleted.
+
+    Args:
+        target_id: ID of the speaker to keep (receives all merged data)
+        source_ids: List of speaker IDs to merge into target
+        user_id: ID of the user (for security check)
+
+    Returns:
+        Speaker: The updated target speaker
+
+    Raises:
+        ValueError: If speakers don't exist or don't belong to user
+    """
+    # Validate target speaker
+    target = Speaker.query.filter_by(id=target_id, user_id=user_id).first()
+    if not target:
+        raise ValueError(f"Target speaker {target_id} not found or doesn't belong to user")
+
+    # Validate source speakers
+    sources = Speaker.query.filter(
+        Speaker.id.in_(source_ids),
+        Speaker.user_id == user_id
+    ).all()
+
+    if len(sources) == 0:
+        raise ValueError("No valid source speakers found")
+
+    if len(sources) != len(source_ids):
+        raise ValueError("Some source speakers don't exist or don't belong to user")
+
+    # Can't merge a speaker with itself
+    if target_id in source_ids:
+        raise ValueError("Cannot merge a speaker with itself")
+
+    # Combine embeddings
+    _combine_embeddings(target, sources)
+
+    # Transfer snippets
+    for source in sources:
+        SpeakerSnippet.query.filter_by(speaker_id=source.id).update(
+            {'speaker_id': target_id}
+        )
+
+    # Combine usage statistics
+    for source in sources:
+        target.use_count += source.use_count
+
+        # Update last_used to most recent
+        if source.last_used and (not target.last_used or source.last_used > target.last_used):
+            target.last_used = source.last_used
+
+        # Combine embedding histories
+        if source.embeddings_history:
+            target_history = target.embeddings_history or []
+            source_history = source.embeddings_history or []
+            combined_history = target_history + source_history
+
+            # Sort by timestamp (most recent last) and keep last 10
+            try:
+                combined_history.sort(key=lambda x: x.get('timestamp', ''))
+                target.embeddings_history = combined_history[-10:]
+            except:
+                # If sorting fails, just concatenate and truncate
+                target.embeddings_history = (target_history + source_history)[-10:]
+
+    # Recalculate confidence score
+    target.confidence_score = calculate_confidence(target)
+
+    # Delete source speakers
+    for source in sources:
+        db.session.delete(source)
+
+    # Commit all changes
+    db.session.commit()
+
+    return target
+
+
+def _combine_embeddings(target, sources):
+    """
+    Combine embeddings from multiple speakers using weighted average.
+
+    Weight is based on embedding_count (more samples = more weight).
+
+    Args:
+        target: Target Speaker instance
+        sources: List of source Speaker instances
+    """
+    all_embeddings = []
+    all_counts = []
+
+    # Add target's embedding if it exists
+    if target.average_embedding:
+        all_embeddings.append(deserialize_embedding(target.average_embedding))
+        all_counts.append(target.embedding_count or 1)
+
+    # Add all source embeddings
+    for source in sources:
+        if source.average_embedding:
+            all_embeddings.append(deserialize_embedding(source.average_embedding))
+            all_counts.append(source.embedding_count or 1)
+
+    if not all_embeddings:
+        # No embeddings to combine
+        return
+
+    # Calculate weighted average
+    total_count = sum(all_counts)
+    weights = [c / total_count for c in all_counts]
+
+    combined_emb = np.average(all_embeddings, axis=0, weights=weights)
+
+    # Update target
+    target.average_embedding = serialize_embedding(combined_emb)
+    target.embedding_count = total_count
+
+
+def preview_merge(target_id, source_ids, user_id):
+    """
+    Preview what a merge would look like without executing it.
+
+    Args:
+        target_id: ID of the target speaker
+        source_ids: List of source speaker IDs
+        user_id: ID of the user
+
+    Returns:
+        dict: Preview of the merge results
+              {
+                  'target_name': '...',
+                  'source_names': [...],
+                  'combined_use_count': 123,
+                  'combined_embedding_count': 45,
+                  'total_snippets': 67
+              }
+    """
+    # Validate speakers
+    target = Speaker.query.filter_by(id=target_id, user_id=user_id).first()
+    if not target:
+        raise ValueError("Target speaker not found")
+
+    sources = Speaker.query.filter(
+        Speaker.id.in_(source_ids),
+        Speaker.user_id == user_id
+    ).all()
+
+    if len(sources) == 0:
+        raise ValueError("No valid source speakers found")
+
+    # Calculate combined statistics
+    combined_use_count = target.use_count
+    combined_embedding_count = target.embedding_count or 0
+    total_snippets = SpeakerSnippet.query.filter_by(speaker_id=target_id).count()
+
+    source_names = []
+    for source in sources:
+        combined_use_count += source.use_count
+        combined_embedding_count += (source.embedding_count or 0)
+        total_snippets += SpeakerSnippet.query.filter_by(speaker_id=source.id).count()
+        source_names.append(source.name)
+
+    return {
+        'target_name': target.name,
+        'source_names': source_names,
+        'combined_use_count': combined_use_count,
+        'combined_embedding_count': combined_embedding_count,
+        'total_snippets': total_snippets,
+        'has_embeddings': target.average_embedding is not None or any(s.average_embedding for s in sources)
+    }
+
+
+def can_merge_speakers(speaker_ids, user_id):
+    """
+    Check if speakers can be merged (all belong to same user, no duplicates).
+
+    Args:
+        speaker_ids: List of speaker IDs
+        user_id: ID of the user
+
+    Returns:
+        tuple: (bool, str) - (can_merge, error_message)
+    """
+    if len(speaker_ids) < 2:
+        return False, "Need at least 2 speakers to merge"
+
+    if len(speaker_ids) != len(set(speaker_ids)):
+        return False, "Duplicate speaker IDs provided"
+
+    speakers = Speaker.query.filter(
+        Speaker.id.in_(speaker_ids),
+        Speaker.user_id == user_id
+    ).all()
+
+    if len(speakers) != len(speaker_ids):
+        return False, "Some speakers don't exist or don't belong to user"
+
+    return True, ""
diff --git a/src/services/speaker_snippets.py b/src/services/speaker_snippets.py
new file mode 100644
index 00000000..3263a54a
--- /dev/null
+++ b/src/services/speaker_snippets.py
@@ -0,0 +1,371 @@
+"""
+Speaker Snippets Service.
+
+This service handles the extraction and management of representative speech snippets
+from recordings. Snippets provide context when viewing speaker profiles and help
+users verify speaker identifications.
+
+Key functions:
+- Extract snippets when speakers are identified in recordings
+- Retrieve snippets for display in speaker profiles
+- Clean up old snippets to prevent database bloat
+"""
+
+import json
+from src.database import db
+from src.models import Speaker, SpeakerSnippet, Recording
+
+MAX_SNIPPETS_PER_SPEAKER = 7
+MAX_SNIPPETS_PER_RECORDING = 2
+
+
+def create_speaker_snippets(recording_id, speaker_map):
+    """
+    Extract and store representative snippets for each identified speaker.
+
+    This function is called after a user saves speaker identifications in a recording.
+    It extracts up to MAX_SNIPPETS_PER_RECORDING quotes per speaker from this recording,
+    and enforces a global cap of MAX_SNIPPETS_PER_SPEAKER by evicting the oldest.
+
+    Args:
+        recording_id: ID of the recording
+        speaker_map: Dict mapping SPEAKER_XX to speaker info
+                    {'SPEAKER_00': {'name': 'John Doe', 'isMe': False}, ...}
+
+    Returns:
+        int: Number of snippets created
+    """
+    recording = Recording.query.get(recording_id)
+    if not recording or not recording.transcription:
+        return 0
+
+    try:
+        transcript = json.loads(recording.transcription)
+    except (json.JSONDecodeError, TypeError):
+        return 0
+
+    # Build a reverse map: assigned name -> speaker_info
+    # After transcript is saved, segment['speaker'] contains the real name,
+    # not the original SPEAKER_XX label. We need to match by name too.
+    name_to_info = {}
+    for label, info in speaker_map.items():
+        name = info.get('name', '').strip()
+        if name and not name.startswith('SPEAKER_'):
+            name_to_info[name] = info
+
+    # Collect candidates per speaker: (speaker_obj, segment_idx, text, timestamp)
+    candidates = {}  # speaker_id -> list of (segment_idx, text, timestamp)
+
+    for segment_idx, segment in enumerate(transcript):
+        speaker_field = segment.get('speaker')
+
+        if not speaker_field:
+            continue
+
+        # Try matching by original label first, then by assigned name
+        if speaker_field in speaker_map:
+            speaker_info = speaker_map[speaker_field]
+            speaker_name = speaker_info.get('name')
+        elif speaker_field in name_to_info:
+            speaker_name = speaker_field
+        else:
+            continue
+
+        if not speaker_name or speaker_name.startswith('SPEAKER_'):
+            continue
+
+        # Find the speaker in database
+        speaker = Speaker.query.filter_by(
+            user_id=recording.user_id,
+            name=speaker_name
+        ).first()
+
+        if not speaker:
+            continue
+
+        text = segment.get('sentence', '').strip()
+        if len(text) < 10:
+            continue
+
+        if speaker.id not in candidates:
+            candidates[speaker.id] = []
+        candidates[speaker.id].append((segment_idx, text[:200], segment.get('start_time')))
+
+    # Delete existing snippets for this recording (re-save replaces them)
+    SpeakerSnippet.query.filter_by(recording_id=recording_id).delete()
+
+    snippets_created = 0
+
+    for speaker_id, segs in candidates.items():
+        # Pick up to MAX_SNIPPETS_PER_RECORDING spread across the transcript
+        if len(segs) <= MAX_SNIPPETS_PER_RECORDING:
+            chosen = segs
+        else:
+            # Evenly sample from the segments
+            step = len(segs) / MAX_SNIPPETS_PER_RECORDING
+            chosen = [segs[int(i * step)] for i in range(MAX_SNIPPETS_PER_RECORDING)]
+
+        for segment_idx, text_snippet, timestamp in chosen:
+            # Evict oldest if at global cap
+            global_count = SpeakerSnippet.query.filter_by(speaker_id=speaker_id).count()
+            if global_count >= MAX_SNIPPETS_PER_SPEAKER:
+                oldest = SpeakerSnippet.query.filter_by(speaker_id=speaker_id)\
+                    .order_by(SpeakerSnippet.created_at.asc()).first()
+                if oldest:
+                    db.session.delete(oldest)
+                    db.session.flush()
+
+            snippet = SpeakerSnippet(
+                speaker_id=speaker_id,
+                recording_id=recording_id,
+                segment_index=segment_idx,
+                text_snippet=text_snippet,
+                timestamp=timestamp,
+            )
+            db.session.add(snippet)
+            snippets_created += 1
+
+        # Flush after each speaker batch to keep counts accurate
+        db.session.flush()
+
+    if snippets_created > 0:
+        db.session.commit()
+
+    return snippets_created
+
+
+def _generate_dynamic_snippets(speaker_id, limit=3):
+    """
+    Dynamically generate audio snippets from a speaker's recent recordings.
+
+    This function finds short audio segments (3-4 seconds) from recent recordings
+    where the speaker appears. These can be played back to verify speaker identity.
+
+    Args:
+        speaker_id: ID of the speaker
+        limit: Maximum number of snippets to return (default 3)
+
+    Returns:
+        list: List of snippet dictionaries with audio segment information
+              [{'recording_id': 123, 'start_time': 45.2, 'duration': 3.5, ...}, ...]
+    """
+    # Get the speaker
+    speaker = Speaker.query.get(speaker_id)
+    if not speaker:
+        return []
+
+    # Find recordings that have this speaker's name in transcription
+    # We'll look at the last 10 recordings and extract snippets from them
+    recordings = Recording.query.filter_by(user_id=speaker.user_id)\
+        .filter(Recording.transcription.isnot(None))\
+        .filter(Recording.transcription != '')\
+        .filter(Recording.audio_deleted_at.is_(None))\
+        .order_by(Recording.created_at.desc())\
+        .limit(10).all()
+
+    snippets = []
+
+    for recording in recordings:
+        if len(snippets) >= limit:
+            break
+
+        try:
+            # Parse transcription JSON
+            transcript = json.loads(recording.transcription)
+
+            if not isinstance(transcript, list):
+                continue
+
+            # Find segments where this speaker appears
+            speaker_segments = []
+            for idx, segment in enumerate(transcript):
+                # Check if segment has speaker identification matching our speaker's name
+                speaker_label = segment.get('speaker')
+
+                # In identified transcripts, the speaker field contains the actual name
+                if speaker_label != speaker.name:
+                    continue
+
+                start_time = segment.get('start_time')
+                end_time = segment.get('end_time')
+
+                if start_time is None or end_time is None:
+                    continue
+
+                duration = end_time - start_time
+
+                # Skip very short segments (less than 2 seconds)
+                if duration < 2.0:
+                    continue
+
+                speaker_segments.append({
+                    'index': idx,
+                    'start_time': start_time,
+                    'end_time': end_time,
+                    'duration': duration,
+                    'text': segment.get('sentence', '').strip()[:100]  # Preview text
+                })
+
+            if not speaker_segments:
+                continue
+
+            # Take snippets from middle portions (skip first and last 10%)
+            total_segments = len(speaker_segments)
+            if total_segments > 4:
+                # Skip first and last 10%
+                start_idx = max(1, int(total_segments * 0.1))
+                end_idx = min(total_segments - 1, int(total_segments * 0.9))
+                middle_segments = speaker_segments[start_idx:end_idx]
+            else:
+                middle_segments = speaker_segments
+
+            # Take 1 snippet per recording from the middle
+            if middle_segments:
+                # Pick a segment from the middle
+                middle_idx = len(middle_segments) // 2
+                segment = middle_segments[middle_idx]
+
+                # Limit audio snippet to 3-4 seconds
+                snippet_duration = min(4.0, segment['duration'])
+
+                snippets.append({
+                    'id': None,  # Dynamic snippet, no database ID
+                    'speaker_id': speaker_id,
+                    'recording_id': recording.id,
+                    'start_time': segment['start_time'],
+                    'duration': snippet_duration,
+                    'text': segment['text'],  # Preview text for context
+                    'recording_title': recording.title or 'Untitled Recording',
+                    'created_at': recording.created_at.isoformat() if recording.created_at else None
+                })
+
+        except (json.JSONDecodeError, TypeError, KeyError) as e:
+            # Skip recordings with invalid transcription format
+            continue
+
+    return snippets
+
+
+def get_speaker_snippets(speaker_id, limit=3):
+    """
+    Get recent audio snippets for a speaker.
+
+    Returns short audio segments (3-4 seconds) from recent recordings where this
+    speaker appears. These audio snippets can be played to verify speaker identity.
+
+    Args:
+        speaker_id: ID of the speaker
+        limit: Maximum number of snippets to return (default 3)
+
+    Returns:
+        list: List of snippet dictionaries with audio segment information
+              [{'recording_id': 123, 'start_time': 45.2, 'duration': 3.5, ...}, ...]
+    """
+    # Always dynamically generate audio snippets from recent recordings
+    return _generate_dynamic_snippets(speaker_id, limit)
+
+
+def get_snippets_by_recording(recording_id, speaker_id):
+    """
+    Get all snippets for a specific speaker in a specific recording.
+
+    Args:
+        recording_id: ID of the recording
+        speaker_id: ID of the speaker
+
+    Returns:
+        list: List of snippet dictionaries
+    """
+    snippets = SpeakerSnippet.query.filter_by(
+        recording_id=recording_id,
+        speaker_id=speaker_id
+    ).order_by(SpeakerSnippet.segment_index).all()
+
+    return [snippet.to_dict() for snippet in snippets]
+
+
+def cleanup_old_snippets(speaker_id, keep=10):
+    """
+    Clean up old snippets for a speaker, keeping only the most recent ones.
+
+    Args:
+        speaker_id: ID of the speaker
+        keep: Number of snippets to keep (default 10)
+
+    Returns:
+        int: Number of snippets deleted
+    """
+    # Get all snippets for this speaker, ordered by creation date
+    all_snippets = SpeakerSnippet.query.filter_by(speaker_id=speaker_id)\
+        .order_by(SpeakerSnippet.created_at.desc()).all()
+
+    if len(all_snippets) <= keep:
+        return 0
+
+    # Delete old snippets beyond the keep limit
+    snippets_to_delete = all_snippets[keep:]
+    deleted_count = 0
+
+    for snippet in snippets_to_delete:
+        db.session.delete(snippet)
+        deleted_count += 1
+
+    if deleted_count > 0:
+        db.session.commit()
+
+    return deleted_count
+
+
+def delete_snippets_for_recording(recording_id):
+    """
+    Delete all snippets associated with a recording.
+
+    This is typically called when a recording is deleted or reprocessed.
+
+    Args:
+        recording_id: ID of the recording
+
+    Returns:
+        int: Number of snippets deleted
+    """
+    deleted_count = SpeakerSnippet.query.filter_by(recording_id=recording_id).delete()
+    db.session.commit()
+    return deleted_count
+
+
+def get_speaker_recordings_with_snippets(speaker_id):
+    """
+    Get a list of recordings that have snippets for this speaker.
+
+    Args:
+        speaker_id: ID of the speaker
+
+    Returns:
+        list: List of recording dictionaries with snippet counts
+              [{'id': 123, 'title': '...', 'snippet_count': 3, 'date': '...'}, ...]
+    """
+    # Get distinct recordings with snippet counts
+    from sqlalchemy import func
+
+    recordings_with_counts = db.session.query(
+        Recording.id,
+        Recording.title,
+        Recording.created_at,
+        func.count(SpeakerSnippet.id).label('snippet_count')
+    ).join(
+        SpeakerSnippet,
+        Recording.id == SpeakerSnippet.recording_id
+    ).filter(
+        SpeakerSnippet.speaker_id == speaker_id
+    ).group_by(
+        Recording.id
+    ).order_by(
+        Recording.created_at.desc()
+    ).all()
+
+    return [{
+        'id': r.id,
+        'title': r.title,
+        'snippet_count': r.snippet_count,
+        'created_at': r.created_at.isoformat() if r.created_at else None
+    } for r in recordings_with_counts]
diff --git a/src/services/token_tracking.py b/src/services/token_tracking.py
new file mode 100644
index 00000000..7bd39a67
--- /dev/null
+++ b/src/services/token_tracking.py
@@ -0,0 +1,349 @@
+"""
+Token usage tracking service for monitoring LLM API consumption and budget enforcement.
+"""
+
+import logging
+from datetime import date, datetime, timedelta
+from typing import Tuple, Optional, Dict, List
+
+from sqlalchemy import func, extract
+
+from src.database import db
+from src.models.token_usage import TokenUsage
+from src.models.user import User
+
+logger = logging.getLogger(__name__)
+
+
+class TokenTracker:
+    """Service for recording and checking token usage."""
+
+    OPERATION_TYPES = [
+        'summarization',
+        'chat',
+        'title_generation',
+        'event_extraction',
+        'query_routing',
+        'query_enrichment',
+        'embedding',
+    ]
+
+    # Token magnitudes and per-token costs differ by orders of magnitude
+    # between LLM completions and embedding calls, so dashboards must keep
+    # them in separate visualizations. Anything in EMBEDDING_OPERATIONS is
+    # bucketed apart from LLM usage.
+    EMBEDDING_OPERATIONS = frozenset({'embedding'})
+
+    @classmethod
+    def is_embedding_op(cls, operation_type):
+        return operation_type in cls.EMBEDDING_OPERATIONS
+
+    def record_usage(
+        self,
+        user_id: int,
+        operation_type: str,
+        prompt_tokens: int,
+        completion_tokens: int,
+        total_tokens: int,
+        model_name: str = None,
+        cost: float = None
+    ):
+        """
+        Record token usage - upserts into daily aggregate.
+
+        Args:
+            user_id: User ID who made the request
+            operation_type: Type of operation (summarization, chat, etc.)
+            prompt_tokens: Number of input tokens
+            completion_tokens: Number of output tokens
+            total_tokens: Total tokens (prompt + completion)
+            model_name: Name of the model used
+            cost: API cost if available (e.g., from OpenRouter)
+        """
+        try:
+            today = date.today()
+
+            # Find or create today's record for this user/operation
+            usage = TokenUsage.query.filter_by(
+                user_id=user_id,
+                date=today,
+                operation_type=operation_type
+            ).first()
+
+            if usage:
+                # Update existing record
+                usage.prompt_tokens += prompt_tokens
+                usage.completion_tokens += completion_tokens
+                usage.total_tokens += total_tokens
+                usage.request_count += 1
+                if cost:
+                    usage.cost += cost
+                if model_name:
+                    usage.model_name = model_name  # Update to latest model used
+            else:
+                # Create new record
+                usage = TokenUsage(
+                    user_id=user_id,
+                    date=today,
+                    operation_type=operation_type,
+                    prompt_tokens=prompt_tokens,
+                    completion_tokens=completion_tokens,
+                    total_tokens=total_tokens,
+                    request_count=1,
+                    model_name=model_name,
+                    cost=cost or 0.0
+                )
+                db.session.add(usage)
+
+            db.session.commit()
+            logger.debug(f"Recorded {total_tokens} tokens for user {user_id}, operation {operation_type}")
+            return usage
+
+        except Exception as e:
+            logger.error(f"Failed to record token usage: {e}")
+            db.session.rollback()
+            return None
+
+    def get_monthly_usage(self, user_id: int, year: int = None, month: int = None) -> int:
+        """Get total tokens used by a user in a given month."""
+        if year is None:
+            year = date.today().year
+        if month is None:
+            month = date.today().month
+
+        result = db.session.query(func.sum(TokenUsage.total_tokens)).filter(
+            TokenUsage.user_id == user_id,
+            extract('year', TokenUsage.date) == year,
+            extract('month', TokenUsage.date) == month
+        ).scalar()
+
+        return result or 0
+
+    def get_monthly_cost(self, user_id: int, year: int = None, month: int = None) -> float:
+        """Get total cost for a user in a given month."""
+        if year is None:
+            year = date.today().year
+        if month is None:
+            month = date.today().month
+
+        result = db.session.query(func.sum(TokenUsage.cost)).filter(
+            TokenUsage.user_id == user_id,
+            extract('year', TokenUsage.date) == year,
+            extract('month', TokenUsage.date) == month
+        ).scalar()
+
+        return result or 0.0
+
+    def check_budget(self, user_id: int) -> Tuple[bool, float, Optional[str]]:
+        """
+        Check if user is within budget.
+
+        Returns:
+            (can_proceed, usage_percentage, message)
+            - can_proceed: False if hard cap (100%) reached
+            - usage_percentage: 0-100+
+            - message: Warning/error message if applicable
+        """
+        try:
+            user = db.session.get(User, user_id)
+            if not user or not user.monthly_token_budget:
+                return (True, 0, None)  # No budget = unlimited
+
+            current_usage = self.get_monthly_usage(user_id)
+            budget = user.monthly_token_budget
+            percentage = (current_usage / budget) * 100
+
+            if percentage >= 100:
+                return (False, percentage,
+                        f"Monthly token budget exceeded ({percentage:.1f}%). Contact admin for more tokens.")
+            elif percentage >= 80:
+                return (True, percentage,
+                        f"Warning: {percentage:.1f}% of monthly token budget used.")
+            else:
+                return (True, percentage, None)
+
+        except Exception as e:
+            logger.error(f"Failed to check budget for user {user_id}: {e}")
+            # Fail open - allow the request if we can't check
+            return (True, 0, None)
+
+    def get_daily_stats(self, days: int = 30, user_id: int = None) -> List[Dict]:
+        """Get daily token usage for charts.
+
+        Each entry includes both a combined total and per-bucket totals
+        ('llm_tokens'/'llm_cost' vs 'embedding_tokens'/'embedding_cost') so
+        dashboards can render the two streams as independent series.
+        """
+        start_date = date.today() - timedelta(days=days - 1)
+
+        query = db.session.query(
+            TokenUsage.date,
+            TokenUsage.operation_type,
+            func.sum(TokenUsage.total_tokens).label('tokens'),
+            func.sum(TokenUsage.cost).label('cost')
+        ).filter(TokenUsage.date >= start_date)
+
+        if user_id:
+            query = query.filter(TokenUsage.user_id == user_id)
+
+        results = query.group_by(TokenUsage.date, TokenUsage.operation_type).all()
+
+        # Organize by date
+        stats = {}
+        for r in results:
+            date_str = r.date.isoformat()
+            if date_str not in stats:
+                stats[date_str] = {
+                    'date': date_str,
+                    'total': 0,
+                    'cost': 0.0,
+                    'llm_tokens': 0,
+                    'llm_cost': 0.0,
+                    'embedding_tokens': 0,
+                    'embedding_cost': 0.0,
+                    'by_operation': {},
+                }
+            tokens = r.tokens or 0
+            cost = r.cost or 0
+            stats[date_str]['total'] += tokens
+            stats[date_str]['cost'] += cost
+            if self.is_embedding_op(r.operation_type):
+                stats[date_str]['embedding_tokens'] += tokens
+                stats[date_str]['embedding_cost'] += cost
+            else:
+                stats[date_str]['llm_tokens'] += tokens
+                stats[date_str]['llm_cost'] += cost
+            stats[date_str]['by_operation'][r.operation_type] = tokens
+
+        # Fill in missing dates with zeros
+        all_dates = []
+        current = start_date
+        while current <= date.today():
+            date_str = current.isoformat()
+            if date_str not in stats:
+                stats[date_str] = {
+                    'date': date_str,
+                    'total': 0,
+                    'cost': 0.0,
+                    'llm_tokens': 0,
+                    'llm_cost': 0.0,
+                    'embedding_tokens': 0,
+                    'embedding_cost': 0.0,
+                    'by_operation': {},
+                }
+            all_dates.append(date_str)
+            current += timedelta(days=1)
+
+        return [stats[d] for d in sorted(all_dates)]
+
+    def get_monthly_stats(self, months: int = 12) -> List[Dict]:
+        """Get monthly token usage for charts.
+
+        Each month includes both combined totals and per-bucket totals
+        (LLM vs embedding) so the two streams can be visualised separately.
+        """
+        results = db.session.query(
+            extract('year', TokenUsage.date).label('year'),
+            extract('month', TokenUsage.date).label('month'),
+            TokenUsage.operation_type,
+            func.sum(TokenUsage.total_tokens).label('tokens'),
+            func.sum(TokenUsage.cost).label('cost')
+        ).group_by('year', 'month', TokenUsage.operation_type).order_by('year', 'month').all()
+
+        buckets = {}
+        for r in results:
+            key = (int(r.year), int(r.month))
+            if key not in buckets:
+                buckets[key] = {
+                    'year': key[0],
+                    'month': key[1],
+                    'tokens': 0,
+                    'cost': 0.0,
+                    'llm_tokens': 0,
+                    'llm_cost': 0.0,
+                    'embedding_tokens': 0,
+                    'embedding_cost': 0.0,
+                }
+            tokens = r.tokens or 0
+            cost = r.cost or 0
+            buckets[key]['tokens'] += tokens
+            buckets[key]['cost'] += cost
+            if self.is_embedding_op(r.operation_type):
+                buckets[key]['embedding_tokens'] += tokens
+                buckets[key]['embedding_cost'] += cost
+            else:
+                buckets[key]['llm_tokens'] += tokens
+                buckets[key]['llm_cost'] += cost
+
+        ordered = [buckets[k] for k in sorted(buckets.keys())]
+        return ordered[-months:] if len(ordered) > months else ordered
+
+    def get_user_stats(self) -> List[Dict]:
+        """Get per-user token usage breakdown for current month."""
+        today = date.today()
+
+        results = db.session.query(
+            User.id,
+            User.username,
+            User.monthly_token_budget,
+            func.sum(TokenUsage.total_tokens).label('usage'),
+            func.sum(TokenUsage.cost).label('cost')
+        ).outerjoin(
+            TokenUsage,
+            (User.id == TokenUsage.user_id) &
+            (extract('year', TokenUsage.date) == today.year) &
+            (extract('month', TokenUsage.date) == today.month)
+        ).group_by(User.id).all()
+
+        return [
+            {
+                'user_id': r.id,
+                'username': r.username,
+                'monthly_budget': r.monthly_token_budget,
+                'current_usage': r.usage or 0,
+                'cost': r.cost or 0,
+                'percentage': ((r.usage or 0) / r.monthly_token_budget * 100)
+                              if r.monthly_token_budget else 0
+            }
+            for r in results
+        ]
+
+    def get_today_usage(self, user_id: int = None) -> Dict:
+        """Get today's token usage, split into LLM and embedding buckets."""
+        today = date.today()
+
+        query = db.session.query(
+            TokenUsage.operation_type,
+            func.sum(TokenUsage.total_tokens).label('tokens'),
+            func.sum(TokenUsage.cost).label('cost')
+        ).filter(TokenUsage.date == today)
+
+        if user_id:
+            query = query.filter(TokenUsage.user_id == user_id)
+
+        rows = query.group_by(TokenUsage.operation_type).all()
+
+        out = {
+            'tokens': 0,
+            'cost': 0.0,
+            'llm_tokens': 0,
+            'llm_cost': 0.0,
+            'embedding_tokens': 0,
+            'embedding_cost': 0.0,
+        }
+        for r in rows:
+            tokens = r.tokens or 0
+            cost = r.cost or 0
+            out['tokens'] += tokens
+            out['cost'] += cost
+            if self.is_embedding_op(r.operation_type):
+                out['embedding_tokens'] += tokens
+                out['embedding_cost'] += cost
+            else:
+                out['llm_tokens'] += tokens
+                out['llm_cost'] += cost
+        return out
+
+
+# Singleton instance
+token_tracker = TokenTracker()
diff --git a/src/services/transcription/__init__.py b/src/services/transcription/__init__.py
new file mode 100644
index 00000000..4b409f4d
--- /dev/null
+++ b/src/services/transcription/__init__.py
@@ -0,0 +1,98 @@
+"""
+Transcription service package.
+
+Provides a connector-based architecture for speech-to-text transcription
+with support for multiple providers:
+
+- OpenAI Whisper (whisper-1)
+- OpenAI GPT-4o Transcribe (gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-transcribe-diarize)
+- Custom ASR endpoints (whisper-asr-webservice, WhisperX, etc.)
+
+Usage:
+    from src.services.transcription import (
+        transcribe,
+        get_connector,
+        supports_diarization,
+        TranscriptionRequest,
+        TranscriptionResponse,
+    )
+
+    # Simple transcription using active connector
+    with open('audio.mp3', 'rb') as f:
+        request = TranscriptionRequest(
+            audio_file=f,
+            filename='audio.mp3',
+            diarize=True
+        )
+        response = transcribe(request)
+        print(response.text)
+        if response.segments:
+            for seg in response.segments:
+                print(f"[{seg.speaker}]: {seg.text}")
+"""
+
+from .base import (
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    BaseTranscriptionConnector,
+    ConnectorSpecifications,
+    DEFAULT_SPECIFICATIONS,
+)
+
+from .exceptions import (
+    TranscriptionError,
+    ConfigurationError,
+    ProviderError,
+    AudioFormatError,
+    ChunkingError,
+)
+
+from .registry import (
+    ConnectorRegistry,
+    get_registry,
+    connector_registry,
+    transcribe,
+    get_connector,
+    supports_diarization,
+)
+
+from .connectors import (
+    OpenAIWhisperConnector,
+    OpenAITranscribeConnector,
+    ASREndpointConnector,
+)
+
+__all__ = [
+    # Base types
+    'TranscriptionCapability',
+    'TranscriptionRequest',
+    'TranscriptionResponse',
+    'TranscriptionSegment',
+    'BaseTranscriptionConnector',
+    'ConnectorSpecifications',
+    'DEFAULT_SPECIFICATIONS',
+
+    # Exceptions
+    'TranscriptionError',
+    'ConfigurationError',
+    'ProviderError',
+    'AudioFormatError',
+    'ChunkingError',
+
+    # Registry
+    'ConnectorRegistry',
+    'get_registry',
+    'connector_registry',
+
+    # Convenience functions
+    'transcribe',
+    'get_connector',
+    'supports_diarization',
+
+    # Connectors
+    'OpenAIWhisperConnector',
+    'OpenAITranscribeConnector',
+    'ASREndpointConnector',
+]
diff --git a/src/services/transcription/base.py b/src/services/transcription/base.py
new file mode 100644
index 00000000..d94091a3
--- /dev/null
+++ b/src/services/transcription/base.py
@@ -0,0 +1,281 @@
+"""
+Base classes and data types for transcription connectors.
+"""
+
+import json
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from enum import Enum, auto
+from typing import Optional, List, Dict, Any, BinaryIO, Set, Type, FrozenSet
+
+
+class TranscriptionCapability(Enum):
+    """Capabilities that connectors can declare support for."""
+    DIARIZATION = auto()           # Speaker diarization
+    CHUNKING = auto()              # Automatic file chunking for large files
+    TIMESTAMPS = auto()            # Word/segment timestamps
+    LANGUAGE_DETECTION = auto()    # Auto language detection
+    KNOWN_SPEAKERS = auto()        # Support for known speaker references (future)
+    SPEAKER_EMBEDDINGS = auto()    # Return speaker embeddings
+    SPEAKER_COUNT_CONTROL = auto() # Support for min/max speaker count parameters
+    HOTWORDS = auto()              # Hotword/keyword biasing (or prompt-based equivalent)
+    INITIAL_PROMPT = auto()        # Free-text initial prompt / context hint
+    STREAMING = auto()             # Real-time streaming transcription
+
+
+@dataclass
+class ConnectorSpecifications:
+    """
+    Provider-specific constraints and requirements.
+
+    Each connector declares its constraints so the application can automatically
+    handle chunking, format conversion, and other preprocessing as needed.
+    """
+    # Size constraints
+    max_file_size_bytes: Optional[int] = None  # None = unlimited
+
+    # Duration constraints
+    max_duration_seconds: Optional[int] = None  # None = unlimited
+    min_duration_for_chunking: Optional[int] = None  # Provider's internal chunking threshold
+
+    # Chunking behavior
+    handles_chunking_internally: bool = False  # Provider handles large files
+    requires_chunking_param: bool = False  # Must send chunking_strategy param
+    recommended_chunk_seconds: int = 600  # 10 minutes default
+
+    # Audio format support - connector-specific codec restrictions
+    # None = use system defaults from get_supported_codecs()
+    # Set = only allow these codecs (overrides defaults)
+    supported_codecs: Optional[FrozenSet[str]] = None
+    # Codecs this connector doesn't support (removed from defaults)
+    # Merged with AUDIO_UNSUPPORTED_CODECS env var
+    unsupported_codecs: Optional[FrozenSet[str]] = None
+
+
+# Default specifications for connectors that don't define their own
+DEFAULT_SPECIFICATIONS = ConnectorSpecifications()
+
+
+@dataclass
+class TranscriptionRequest:
+    """Standardized transcription request."""
+    audio_file: BinaryIO
+    filename: str
+    mime_type: Optional[str] = None
+    language: Optional[str] = None
+
+    # Diarization options
+    diarize: bool = False
+    min_speakers: Optional[int] = None
+    max_speakers: Optional[int] = None
+    known_speaker_names: Optional[List[str]] = None
+    # known_speaker_references: Dict mapping speaker label to either BinaryIO or data URL string
+    known_speaker_references: Optional[Dict[str, Any]] = None
+
+    # Advanced options
+    prompt: Optional[str] = None
+    hotwords: Optional[str] = None  # Comma-separated words to bias recognition
+    temperature: Optional[float] = None
+
+    # Per-request model override. When set, the connector uses this model name
+    # instead of its configured default. Only honoured if the connector supports
+    # multiple models (asr_endpoint, openai_*, mistral). Issue #266.
+    model: Optional[str] = None
+
+    # Provider-specific options (passthrough)
+    extra_options: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class TranscriptionSegment:
+    """Single segment of transcription with optional metadata."""
+    text: str
+    speaker: Optional[str] = None
+    start_time: Optional[float] = None
+    end_time: Optional[float] = None
+    confidence: Optional[float] = None
+    words: Optional[List[Dict[str, Any]]] = None
+
+
+@dataclass
+class TranscriptionResponse:
+    """Standardized transcription response."""
+    # Core content
+    text: str                                    # Plain text transcription
+    segments: Optional[List[TranscriptionSegment]] = None  # Detailed segments
+
+    # Metadata
+    language: Optional[str] = None               # Detected language
+    duration: Optional[float] = None             # Audio duration in seconds
+
+    # Speaker information
+    speakers: Optional[List[str]] = None         # List of speakers found
+    speaker_embeddings: Optional[Dict[str, List[float]]] = None
+
+    # Provider info
+    provider: str = ""
+    model: str = ""
+
+    # Raw response for debugging
+    raw_response: Optional[Dict[str, Any]] = None
+
+    def to_storage_format(self) -> str:
+        """
+        Convert to the JSON format used for storage in database.
+
+        Returns a JSON string in the format expected by the existing codebase:
+        [
+            {
+                "speaker": "SPEAKER_00",
+                "sentence": "Text here",
+                "start_time": 0.0,
+                "end_time": 5.5
+            },
+            ...
+        ]
+        """
+        if self.segments:
+            return json.dumps([
+                {
+                    'speaker': seg.speaker or 'Unknown Speaker',
+                    'sentence': seg.text,
+                    'start_time': seg.start_time,
+                    'end_time': seg.end_time
+                }
+                for seg in self.segments
+            ])
+        # If no segments, return plain text (for non-diarized transcriptions)
+        return self.text
+
+    def has_diarization(self) -> bool:
+        """Check if this response contains diarization data."""
+        if not self.segments:
+            return False
+        return any(seg.speaker for seg in self.segments)
+
+
+class BaseTranscriptionConnector(ABC):
+    """Abstract base class for transcription connectors."""
+
+    # Class-level capability declarations - subclasses should override
+    CAPABILITIES: Set[TranscriptionCapability] = set()
+    PROVIDER_NAME: str = "unknown"
+
+    # Provider-specific constraints - subclasses should override
+    SPECIFICATIONS: ConnectorSpecifications = DEFAULT_SPECIFICATIONS
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize connector with configuration.
+
+        Args:
+            config: Provider-specific configuration dict
+        """
+        self.config = config
+        self._validate_config()
+
+    @abstractmethod
+    def _validate_config(self) -> None:
+        """
+        Validate required configuration is present.
+
+        Raises:
+            ConfigurationError: If required config is missing or invalid
+        """
+        pass
+
+    @abstractmethod
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Perform transcription.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            Standardized transcription response
+
+        Raises:
+            TranscriptionError: On transcription failure
+            ConfigurationError: On configuration issues
+        """
+        pass
+
+    def supports(self, capability: TranscriptionCapability) -> bool:
+        """Check if connector supports a capability."""
+        return capability in self.CAPABILITIES
+
+    def _effective_model(self, request: 'TranscriptionRequest') -> str:
+        """Resolve which model to use for a given request.
+
+        Honours the per-request override (issue #266) if present, otherwise
+        falls back to the connector's configured default model.
+        """
+        override = (request.model or '').strip() if request and request.model else ''
+        return override or getattr(self, 'model', '') or ''
+
+    def get_capabilities(self) -> Set[TranscriptionCapability]:
+        """Get all supported capabilities."""
+        return self.CAPABILITIES.copy()
+
+    @property
+    def supports_diarization(self) -> bool:
+        """Check if connector supports speaker diarization."""
+        return TranscriptionCapability.DIARIZATION in self.CAPABILITIES
+
+    @property
+    def supports_chunking(self) -> bool:
+        """Check if connector supports automatic file chunking."""
+        return TranscriptionCapability.CHUNKING in self.CAPABILITIES
+
+    @property
+    def supports_speaker_count_control(self) -> bool:
+        """Check if connector supports min/max speaker count parameters."""
+        return TranscriptionCapability.SPEAKER_COUNT_CONTROL in self.CAPABILITIES
+
+    @property
+    def supports_hotwords(self) -> bool:
+        """Check if connector accepts hotword/keyword biasing input."""
+        return TranscriptionCapability.HOTWORDS in self.CAPABILITIES
+
+    @property
+    def supports_initial_prompt(self) -> bool:
+        """Check if connector accepts an initial prompt / context hint."""
+        return TranscriptionCapability.INITIAL_PROMPT in self.CAPABILITIES
+
+    @property
+    def specifications(self) -> ConnectorSpecifications:
+        """Get connector specifications."""
+        return self.SPECIFICATIONS
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """
+        Return JSON schema for this connector's configuration.
+        Useful for admin UI and validation.
+
+        Returns:
+            JSON schema dict describing required and optional config
+        """
+        return {}
+
+    def list_models(self) -> List[Dict[str, Any]]:
+        """Discover models the upstream provider exposes.
+
+        Connectors that talk to an OpenAI-compatible /v1/models endpoint
+        should override this. Each item is a dict with at minimum 'id' and
+        an optional 'label' or 'owned_by'. The default raises
+        NotImplementedError so callers can detect unsupported providers.
+        """
+        raise NotImplementedError(
+            f"{type(self).__name__} does not implement list_models()"
+        )
+
+    def health_check(self) -> bool:
+        """
+        Check if the connector is properly configured and reachable.
+
+        Returns:
+            True if the connector is healthy, False otherwise
+        """
+        return True
diff --git a/src/services/transcription/connectors/__init__.py b/src/services/transcription/connectors/__init__.py
new file mode 100644
index 00000000..b04d7714
--- /dev/null
+++ b/src/services/transcription/connectors/__init__.py
@@ -0,0 +1,19 @@
+"""
+Transcription connector implementations.
+"""
+
+from .openai_whisper import OpenAIWhisperConnector
+from .openai_transcribe import OpenAITranscribeConnector
+from .asr_endpoint import ASREndpointConnector
+from .azure_openai_transcribe import AzureOpenAITranscribeConnector
+from .mistral import MistralTranscriptionConnector
+from .vibevoice import VibeVoiceTranscriptionConnector
+
+__all__ = [
+    'OpenAIWhisperConnector',
+    'OpenAITranscribeConnector',
+    'ASREndpointConnector',
+    'AzureOpenAITranscribeConnector',
+    'MistralTranscriptionConnector',
+    'VibeVoiceTranscriptionConnector',
+]
diff --git a/src/services/transcription/connectors/asr_endpoint.py b/src/services/transcription/connectors/asr_endpoint.py
new file mode 100644
index 00000000..a5afef34
--- /dev/null
+++ b/src/services/transcription/connectors/asr_endpoint.py
@@ -0,0 +1,390 @@
+"""
+ASR Endpoint connector for custom self-hosted ASR services.
+
+Supports whisper-asr-webservice, WhisperX, and other compatible ASR services
+that expose a /asr endpoint.
+"""
+
+import logging
+import os
+import httpx
+from typing import Dict, Any, Set, Optional
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError, ProviderError
+from src.config.app_config import ASR_ENABLE_CHUNKING, ASR_MAX_DURATION_SECONDS
+
+logger = logging.getLogger(__name__)
+
+
+class ASREndpointConnector(BaseTranscriptionConnector):
+    """Connector for custom ASR webservice (whisper-asr-webservice, WhisperX, etc.)."""
+
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.DIARIZATION,
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        TranscriptionCapability.SPEAKER_COUNT_CONTROL,  # Supports min/max speakers
+        TranscriptionCapability.HOTWORDS,
+        TranscriptionCapability.INITIAL_PROMPT,
+    }
+    PROVIDER_NAME = "asr_endpoint"
+
+    # SPECIFICATIONS is set dynamically in __init__ based on ASR_ENABLE_CHUNKING config
+    # Default values here for class-level reference (overridden per-instance)
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=None,
+        max_duration_seconds=None,
+        handles_chunking_internally=True,
+    )
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the ASR Endpoint connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - base_url: ASR service base URL (required)
+                - timeout: Request timeout in seconds (default: 1800)
+                - return_speaker_embeddings: Whether to request embeddings (default: False)
+                - diarize: Whether to enable diarization by default (default: True)
+        """
+        super().__init__(config)
+
+        self.base_url = config['base_url'].rstrip('/')
+        self._config_timeout = config.get('timeout', 1800)  # 30 minutes default
+        self.return_embeddings = config.get('return_speaker_embeddings', False)
+        self.default_diarize = config.get('diarize', True)
+
+        # Configure chunking behavior based on environment variables
+        # ASR_ENABLE_CHUNKING=true enables app-level chunking for self-hosted ASR services
+        # that may crash on long files due to GPU memory exhaustion
+        if ASR_ENABLE_CHUNKING:
+            # Calculate recommended chunk size (80% of max for safety margin)
+            recommended_chunk = int(ASR_MAX_DURATION_SECONDS * 0.8)
+            self.SPECIFICATIONS = ConnectorSpecifications(
+                max_file_size_bytes=None,  # No file size limit
+                max_duration_seconds=ASR_MAX_DURATION_SECONDS,
+                handles_chunking_internally=False,  # App handles chunking
+                recommended_chunk_seconds=recommended_chunk,
+            )
+            logger.info(
+                f"ASR chunking enabled: max_duration={ASR_MAX_DURATION_SECONDS}s, "
+                f"recommended_chunk={recommended_chunk}s"
+            )
+        else:
+            # Default behavior: ASR service handles everything internally
+            self.SPECIFICATIONS = ConnectorSpecifications(
+                max_file_size_bytes=None,
+                max_duration_seconds=None,
+                handles_chunking_internally=True,
+            )
+
+        # Add speaker embeddings capability if enabled
+        if self.return_embeddings:
+            self.CAPABILITIES = self.CAPABILITIES | {TranscriptionCapability.SPEAKER_EMBEDDINGS}
+
+    @property
+    def timeout(self):
+        """Get ASR timeout, reading fresh from env/DB each time to respect runtime changes."""
+        # Environment variables take priority
+        env_timeout = os.environ.get('ASR_TIMEOUT') or os.environ.get('asr_timeout_seconds')
+        if env_timeout:
+            try:
+                return int(env_timeout)
+            except (ValueError, TypeError):
+                pass
+
+        # Try database setting (Admin UI)
+        try:
+            from src.models import SystemSetting
+            db_timeout = SystemSetting.get_setting('asr_timeout_seconds', None)
+            if db_timeout is not None:
+                return int(db_timeout)
+        except Exception:
+            pass
+
+        # Fall back to config value from initialization
+        return self._config_timeout
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('base_url'):
+            raise ConfigurationError("base_url is required for ASR endpoint connector")
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using ASR webservice.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse with segments and speaker information
+        """
+        try:
+            url = f"{self.base_url}/asr"
+
+            params = {
+                'encode': True,
+                'task': 'transcribe',
+                'output': 'json'
+            }
+
+            if request.language:
+                params['language'] = request.language
+                logger.info(f"Using transcription language: {request.language}")
+
+            # Determine if we should diarize
+            should_diarize = request.diarize if request.diarize is not None else self.default_diarize
+
+            # Send both parameter names for compatibility:
+            # - 'diarize' is used by whisper-asr-webservice
+            # - 'enable_diarization' is used by WhisperX
+            params['diarize'] = should_diarize
+            params['enable_diarization'] = should_diarize
+
+            if should_diarize and self.return_embeddings:
+                params['return_speaker_embeddings'] = True
+
+            if request.min_speakers:
+                params['min_speakers'] = request.min_speakers
+            if request.max_speakers:
+                params['max_speakers'] = request.max_speakers
+
+            if request.prompt:
+                params['initial_prompt'] = request.prompt
+            if request.hotwords:
+                params['hotwords'] = request.hotwords
+
+            # Per-request model override (issue #266). The whisperx-asr-service
+            # fork accepts a `model` query parameter (e.g. large-v3,
+            # distil-medium.en) and switches the loaded Whisper model
+            # on demand. The upstream onerahmet/whisper-asr-webservice
+            # ignores unknown params, so this is safe in both cases.
+            if request.model:
+                params['model'] = request.model
+                logger.info(f"Using per-request model override: {request.model}")
+
+            content_type = request.mime_type or 'application/octet-stream'
+            files = {
+                'audio_file': (request.filename, request.audio_file, content_type)
+            }
+
+            # Configure timeout: generous values for large file uploads
+            # Write timeout needs to be high too - large files take time to upload
+            timeout = httpx.Timeout(
+                None,
+                connect=60.0,
+                read=float(self.timeout),
+                write=float(self.timeout),
+                pool=None
+            )
+
+            logger.info(f"Sending ASR request to {url} with params: {params} (timeout: {self.timeout}s)")
+
+            with httpx.Client() as client:
+                response = client.post(url, params=params, files=files, timeout=timeout)
+                logger.info(f"ASR request completed with status: {response.status_code}")
+                response.raise_for_status()
+
+                # Parse the JSON response
+                response_text = response.text
+                try:
+                    data = response.json()
+                except Exception as json_err:
+                    if response_text.strip().startswith('<'):
+                        logger.error(f"ASR returned HTML error page (status {response.status_code})")
+                        raise ProviderError(
+                            f"ASR service returned HTML error page",
+                            provider=self.PROVIDER_NAME,
+                            status_code=response.status_code
+                        )
+                    else:
+                        raise ProviderError(
+                            f"ASR service returned invalid response: {json_err}",
+                            provider=self.PROVIDER_NAME,
+                            status_code=response.status_code
+                        )
+
+            return self._parse_response(data)
+
+        except httpx.HTTPStatusError as e:
+            # Capture the upstream response body so the actual error message
+            # (e.g. faster-whisper's "Invalid model size 'whisper-tiny'") is
+            # preserved instead of being collapsed to just a status code.
+            try:
+                body = e.response.text
+            except Exception:
+                body = ''
+            body_excerpt = body.strip()
+            if len(body_excerpt) > 800:
+                body_excerpt = body_excerpt[:800] + '...'
+            logger.error(
+                f"ASR request failed with status {e.response.status_code}: {body_excerpt}"
+            )
+            detail = (
+                f"ASR request failed with status {e.response.status_code}: {body_excerpt}"
+                if body_excerpt
+                else f"ASR request failed with status {e.response.status_code}"
+            )
+            raise ProviderError(
+                detail,
+                provider=self.PROVIDER_NAME,
+                status_code=e.response.status_code
+            ) from e
+
+        except httpx.TimeoutException as e:
+            logger.error(f"ASR request timed out after {self.timeout}s")
+            raise TranscriptionError(f"ASR request timed out after {self.timeout}s") from e
+
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"ASR transcription failed: {error_msg}")
+            raise TranscriptionError(f"ASR transcription failed: {error_msg}") from e
+
+    def _parse_response(self, data: Dict[str, Any]) -> TranscriptionResponse:
+        """
+        Parse ASR webservice response into standardized format.
+
+        The ASR response contains:
+        - text: Full transcription text
+        - language: Detected language
+        - segments: Array of segments with speaker, text, start, end
+        - speaker_embeddings: Optional speaker embeddings (WhisperX only)
+        """
+        segments = []
+        speakers = set()
+        full_text_parts = []
+        last_speaker = None
+
+        logger.info(f"ASR response keys: {list(data.keys())}")
+
+        if 'segments' in data and isinstance(data['segments'], list):
+            logger.info(f"Number of segments: {len(data['segments'])}")
+
+            for seg in data['segments']:
+                speaker = seg.get('speaker')
+
+                # Handle missing speakers by carrying forward from previous segment
+                if speaker is None:
+                    if last_speaker is not None:
+                        speaker = last_speaker
+                    else:
+                        speaker = 'UNKNOWN_SPEAKER'
+                else:
+                    last_speaker = speaker
+
+                text = seg.get('text', '').strip()
+                speakers.add(speaker)
+                full_text_parts.append(f"[{speaker}]: {text}")
+
+                segments.append(TranscriptionSegment(
+                    text=text,
+                    speaker=speaker,
+                    start_time=seg.get('start'),
+                    end_time=seg.get('end')
+                ))
+
+        # Get the full text
+        if 'text' in data and isinstance(data['text'], str):
+            full_text = data['text']
+        elif full_text_parts:
+            full_text = '\n'.join(full_text_parts)
+        else:
+            full_text = ''
+
+        # Extract speaker embeddings if present
+        speaker_embeddings = data.get('speaker_embeddings')
+        if speaker_embeddings:
+            logger.info(f"Received speaker embeddings for speakers: {list(speaker_embeddings.keys())}")
+
+        logger.info(f"Parsed {len(segments)} segments with {len(speakers)} unique speakers: {sorted(speakers)}")
+
+        return TranscriptionResponse(
+            text=full_text,
+            segments=segments,
+            speakers=sorted(list(speakers)),
+            speaker_embeddings=speaker_embeddings,
+            language=data.get('language'),
+            provider=self.PROVIDER_NAME,
+            model="asr-endpoint",
+            raw_response=data
+        )
+
+    def list_models(self):
+        """Probe the ASR service's /v1/models endpoint and return the list.
+
+        The whisperx-asr-service fork (and any OpenAI-compatible variant)
+        exposes /v1/models. The upstream onerahmet/whisper-asr-webservice does
+        not, in which case we return an empty list.
+        """
+        try:
+            with httpx.Client(timeout=10.0) as client:
+                resp = client.get(f"{self.base_url}/v1/models")
+                if resp.status_code != 200:
+                    return []
+                data = resp.json().get('data', [])
+                return [
+                    {
+                        'id': m.get('id'),
+                        'label': m.get('id'),
+                        'owned_by': m.get('owned_by', 'unknown'),
+                    }
+                    for m in data if m.get('id')
+                ]
+        except Exception as e:
+            logger.warning(f"asr_endpoint /v1/models probe failed: {e}")
+            return []
+
+    def health_check(self) -> bool:
+        """Check if ASR endpoint is reachable."""
+        try:
+            with httpx.Client(timeout=10.0) as client:
+                # Try common health check endpoints
+                for endpoint in ['/health', '/']:
+                    try:
+                        response = client.get(f"{self.base_url}{endpoint}")
+                        if response.status_code < 500:
+                            return True
+                    except Exception:
+                        continue
+                return False
+        except Exception:
+            return False
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["base_url"],
+            "properties": {
+                "base_url": {
+                    "type": "string",
+                    "description": "ASR service base URL (e.g., http://whisper-asr:9000)"
+                },
+                "timeout": {
+                    "type": "integer",
+                    "default": 1800,
+                    "description": "Request timeout in seconds"
+                },
+                "diarize": {
+                    "type": "boolean",
+                    "default": True,
+                    "description": "Enable speaker diarization by default"
+                },
+                "return_speaker_embeddings": {
+                    "type": "boolean",
+                    "default": False,
+                    "description": "Request speaker embeddings (WhisperX only)"
+                }
+            }
+        }
diff --git a/src/services/transcription/connectors/azure_openai_transcribe.py b/src/services/transcription/connectors/azure_openai_transcribe.py
new file mode 100644
index 00000000..6096eebb
--- /dev/null
+++ b/src/services/transcription/connectors/azure_openai_transcribe.py
@@ -0,0 +1,381 @@
+"""
+Azure OpenAI Transcribe connector.
+
+Supports Azure OpenAI audio transcription models:
+- whisper-1: Basic transcription (no diarization)
+- gpt-4o-transcribe: High quality transcription
+- gpt-4o-mini-transcribe: Cost-effective transcription
+- gpt-4o-transcribe-diarize: Speaker diarization with labels A, B, C, D
+
+Azure OpenAI uses a different API format than standard OpenAI:
+- Endpoint: https://{resource}.openai.azure.com/openai/deployments/{deployment}/audio/transcriptions
+- Requires api-version query parameter
+- Uses api-key header for authentication
+"""
+
+import logging
+import httpx
+from typing import Dict, Any, Set, Optional
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError
+
+logger = logging.getLogger(__name__)
+
+
+class AzureOpenAITranscribeConnector(BaseTranscriptionConnector):
+    """Connector for Azure OpenAI audio transcription models."""
+
+    # Base capabilities - diarization added dynamically based on model
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        TranscriptionCapability.HOTWORDS,
+        TranscriptionCapability.INITIAL_PROMPT,
+    }
+    PROVIDER_NAME = "azure_openai_transcribe"
+
+    # Default specifications (will be overridden per-model in __init__)
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=25 * 1024 * 1024,  # 25MB
+        max_duration_seconds=1400,  # Default to most restrictive (diarize model)
+        min_duration_for_chunking=30,
+        handles_chunking_internally=False,
+        requires_chunking_param=True,
+        recommended_chunk_seconds=1200,
+        unsupported_codecs=frozenset({'opus'}),
+    )
+
+    # Models and their capabilities
+    MODELS = {
+        'whisper-1': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,
+            'recommended_chunk_seconds': 1200,
+            'description': 'OpenAI Whisper model on Azure'
+        },
+        'gpt-4o-transcribe': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,
+            'recommended_chunk_seconds': 1200,
+            'description': 'High quality transcription'
+        },
+        'gpt-4o-mini-transcribe': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,
+            'recommended_chunk_seconds': 1200,
+            'description': 'Cost-effective transcription'
+        },
+        'gpt-4o-mini-transcribe-2025-12-15': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,
+            'recommended_chunk_seconds': 1200,
+            'description': 'Cost-effective transcription (dated version)'
+        },
+        'gpt-4o-transcribe-diarize': {
+            'supports_diarization': True,
+            'max_duration_seconds': 1400,
+            'recommended_chunk_seconds': 1200,
+            'description': 'Speaker diarization with labels A, B, C, D'
+        }
+    }
+
+    # Default API version - can be overridden in config
+    DEFAULT_API_VERSION = "2025-04-01-preview"
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the Azure OpenAI Transcribe connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - api_key: Azure OpenAI API key (required)
+                - endpoint: Azure OpenAI endpoint URL (required)
+                    e.g., https://your-resource.openai.azure.com
+                - deployment_name: The deployment name for the model (required)
+                - api_version: API version (default: 2025-04-01-preview)
+                - model: Model name for validation (optional, defaults to deployment_name)
+        """
+        # Store model/deployment before calling super().__init__
+        self.deployment_name = config.get('deployment_name', '')
+        self.model = config.get('model', self.deployment_name)
+        self.api_version = config.get('api_version', self.DEFAULT_API_VERSION)
+
+        # Set model-specific specifications
+        model_info = self.MODELS.get(self.model, {})
+        if model_info:
+            self.SPECIFICATIONS = ConnectorSpecifications(
+                max_file_size_bytes=25 * 1024 * 1024,
+                max_duration_seconds=model_info.get('max_duration_seconds', 1400),
+                min_duration_for_chunking=30,
+                handles_chunking_internally=False,
+                requires_chunking_param=True,
+                recommended_chunk_seconds=model_info.get('recommended_chunk_seconds', 1200),
+                unsupported_codecs=frozenset({'opus'}),
+            )
+
+        super().__init__(config)
+
+        # Parse endpoint URL
+        self.endpoint = config['endpoint'].rstrip('/')
+
+        # Set up HTTP client
+        self.http_client = httpx.Client(
+            timeout=httpx.Timeout(
+                connect=60.0,
+                read=1800.0,  # 30 minutes for long transcriptions
+                write=1800.0,
+                pool=None
+            ),
+            headers={
+                "api-key": config['api_key'],
+                "User-Agent": "Speakr/1.0 (https://github.com/murtaza-nasir/speakr)"
+            }
+        )
+
+        # Dynamically update capabilities based on model
+        if self._model_supports_diarization():
+            self.CAPABILITIES = self.CAPABILITIES | {
+                TranscriptionCapability.DIARIZATION,
+                TranscriptionCapability.KNOWN_SPEAKERS
+            }
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('api_key'):
+            raise ConfigurationError("api_key is required for Azure OpenAI Transcribe connector")
+        if not self.config.get('endpoint'):
+            raise ConfigurationError("endpoint is required for Azure OpenAI Transcribe connector")
+        if not self.config.get('deployment_name'):
+            raise ConfigurationError("deployment_name is required for Azure OpenAI Transcribe connector")
+
+    def _model_supports_diarization(self) -> bool:
+        """Check if the current model supports diarization."""
+        model_info = self.MODELS.get(self.model, {})
+        return model_info.get('supports_diarization', False)
+
+    def _build_url(self) -> str:
+        """Build the Azure OpenAI transcription API URL."""
+        return f"{self.endpoint}/openai/deployments/{self.deployment_name}/audio/transcriptions?api-version={self.api_version}"
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using Azure OpenAI API.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse, with segments if using diarization model
+        """
+        try:
+            url = self._build_url()
+
+            # Per-request model override (issue #266). Note: Azure routes by
+            # deployment_name (URL path), not model — overriding this only
+            # affects response_format selection (text vs diarized) and the
+            # logged model id. To run a different model the deployment itself
+            # has to point at it.
+            effective_model = self._effective_model(request) or self.model
+
+            # Build form data
+            data = {}
+
+            if request.language:
+                data["language"] = request.language
+                logger.info(f"Using transcription language: {request.language}")
+
+            # Handle diarization model specifics
+            is_diarize_model = 'diarize' in effective_model.lower()
+
+            if is_diarize_model:
+                # Required: chunking_strategy for audio > 30 seconds
+                data["chunking_strategy"] = "auto"
+
+                if request.diarize:
+                    data["response_format"] = "diarized_json"
+                    logger.info("Using diarized_json response format for speaker diarization")
+
+                    # Known speaker support
+                    if request.known_speaker_names and request.known_speaker_references:
+                        for i, name in enumerate(request.known_speaker_names):
+                            if name in request.known_speaker_references:
+                                data[f"known_speaker_names[{i}]"] = name
+                                data[f"known_speaker_references[{i}]"] = request.known_speaker_references[name]
+                        logger.info(f"Using known speaker references for {len(request.known_speaker_names)} speakers")
+            else:
+                # Non-diarization models - request verbose_json for timestamps
+                data["response_format"] = "verbose_json"
+                # Combine initial prompt and hotwords into a single prompt
+                prompt_parts = []
+                if request.prompt:
+                    prompt_parts.append(request.prompt)
+                if request.hotwords:
+                    prompt_parts.append(request.hotwords)
+                if prompt_parts:
+                    data["prompt"] = ". ".join(prompt_parts)
+
+            # Prepare file for upload
+            content_type = request.mime_type or 'application/octet-stream'
+            files = {
+                "file": (request.filename, request.audio_file, content_type)
+            }
+
+            logger.info(f"Sending request to Azure OpenAI: {url}")
+            logger.info(f"Model: {effective_model}, Deployment: {self.deployment_name}")
+
+            response = self.http_client.post(url, data=data, files=files)
+
+            if response.status_code != 200:
+                error_detail = response.text
+                try:
+                    error_json = response.json()
+                    if 'error' in error_json:
+                        error_detail = error_json['error'].get('message', error_detail)
+                except:
+                    pass
+                logger.error(f"Azure OpenAI transcription failed: {response.status_code} - {error_detail}")
+                raise TranscriptionError(f"Azure OpenAI transcription failed: {response.status_code} - {error_detail}")
+
+            result = response.json()
+
+            # Parse response based on format
+            if is_diarize_model and request.diarize:
+                return self._parse_diarized_response(result, effective_model)
+            else:
+                return self._parse_response(result, effective_model)
+
+        except TranscriptionError:
+            raise
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"Azure OpenAI transcription failed: {error_msg}")
+            raise TranscriptionError(f"Azure OpenAI transcription failed: {error_msg}") from e
+
+    def _parse_response(self, response: Dict, model_used: Optional[str] = None) -> TranscriptionResponse:
+        """Parse a standard (non-diarized) response."""
+        text = response.get('text', '')
+
+        # Check for segments (verbose_json format)
+        segments = []
+        if 'segments' in response:
+            for seg in response['segments']:
+                segments.append(TranscriptionSegment(
+                    text=seg.get('text', ''),
+                    start_time=seg.get('start'),
+                    end_time=seg.get('end')
+                ))
+
+        return TranscriptionResponse(
+            text=text,
+            segments=segments if segments else None,
+            language=response.get('language'),
+            provider=self.PROVIDER_NAME,
+            model=model_used or self.model,
+            raw_response=response
+        )
+
+    def _parse_diarized_response(self, response: Dict, model_used: Optional[str] = None) -> TranscriptionResponse:
+        """
+        Parse diarized JSON response into standardized format.
+
+        The diarized_json response contains segments with:
+        - speaker: "A", "B", "C", "D" etc.
+        - text: The transcribed text
+        - start: Segment start time
+        - end: Segment end time
+        """
+        segments = []
+        speakers = set()
+        full_text_parts = []
+
+        raw_segments = response.get('segments', [])
+
+        if not raw_segments:
+            # Fallback to text-only response
+            logger.warning("No segments found in diarized response, falling back to text")
+            return self._parse_response(response)
+
+        for seg in raw_segments:
+            speaker = seg.get('speaker', 'Unknown')
+            text = seg.get('text', '')
+            start = seg.get('start')
+            end = seg.get('end')
+
+            # Skip empty segments
+            if not text or not text.strip():
+                continue
+
+            speakers.add(speaker)
+            full_text_parts.append(f"[{speaker}]: {text}")
+
+            segments.append(TranscriptionSegment(
+                text=text,
+                speaker=speaker,
+                start_time=start,
+                end_time=end
+            ))
+
+        # Build full text with speaker labels
+        full_text = '\n'.join(full_text_parts)
+
+        logger.info(f"Parsed {len(segments)} segments with {len(speakers)} unique speakers: {sorted(speakers)}")
+
+        return TranscriptionResponse(
+            text=full_text,
+            segments=segments,
+            speakers=sorted(list(speakers)),
+            language=response.get('language'),
+            provider=self.PROVIDER_NAME,
+            model=model_used or self.model,
+            raw_response=response
+        )
+
+        # NB: _parse_diarized_response falls back to _parse_response above
+
+    def health_check(self) -> bool:
+        """Check if the connector is properly configured."""
+        return bool(
+            self.config.get('api_key') and
+            self.config.get('endpoint') and
+            self.config.get('deployment_name')
+        )
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["api_key", "endpoint", "deployment_name"],
+            "properties": {
+                "api_key": {
+                    "type": "string",
+                    "description": "Azure OpenAI API key"
+                },
+                "endpoint": {
+                    "type": "string",
+                    "description": "Azure OpenAI endpoint URL (e.g., https://your-resource.openai.azure.com)"
+                },
+                "deployment_name": {
+                    "type": "string",
+                    "description": "The deployment name for your transcription model"
+                },
+                "api_version": {
+                    "type": "string",
+                    "default": cls.DEFAULT_API_VERSION,
+                    "description": "Azure OpenAI API version"
+                },
+                "model": {
+                    "type": "string",
+                    "enum": list(cls.MODELS.keys()),
+                    "description": "Model type (for capability detection, defaults to deployment_name)"
+                }
+            }
+        }
diff --git a/src/services/transcription/connectors/mistral.py b/src/services/transcription/connectors/mistral.py
new file mode 100644
index 00000000..6ab22ef1
--- /dev/null
+++ b/src/services/transcription/connectors/mistral.py
@@ -0,0 +1,279 @@
+"""
+Mistral Voxtral API connector for audio transcription.
+
+Supports Mistral's Voxtral models which provide high-quality transcription
+with diarization, context biasing (hotwords), and language detection.
+Particularly strong for French and multilingual audio.
+"""
+
+import logging
+import os
+import re
+import httpx
+from typing import Dict, Any, Set, List, Optional
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError, ProviderError
+
+logger = logging.getLogger(__name__)
+
+
+class MistralTranscriptionConnector(BaseTranscriptionConnector):
+    """Connector for Mistral Voxtral transcription API."""
+
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.DIARIZATION,
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        # Hotwords are sent as Voxtral's `context_bias` array. Initial prompt
+        # is not accepted -- the connector logs a warning and ignores it.
+        TranscriptionCapability.HOTWORDS,
+    }
+    PROVIDER_NAME = "mistral"
+
+    # Default class-level spec assumes no chunking — Voxtral handles up to 3
+    # hours natively. Instances can override this in __init__ when
+    # MISTRAL_ENABLE_CHUNKING=true (issue #267).
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=None,
+        max_duration_seconds=None,
+        handles_chunking_internally=True,
+        recommended_chunk_seconds=0,
+    )
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the Mistral Voxtral connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - api_key: Mistral API key (required)
+                - base_url: API base URL (default: https://api.mistral.ai)
+                - model: Model name (default: voxtral-mini-latest)
+        """
+        super().__init__(config)
+
+        self.api_key = config['api_key']
+        self.base_url = (config.get('base_url') or 'https://api.mistral.ai').rstrip('/')
+        self.model = config.get('model', 'voxtral-mini-latest')
+
+        self.client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                'Authorization': f'Bearer {self.api_key}',
+                'User-Agent': 'Speakr/1.0 (https://github.com/murtaza-nasir/speakr)',
+            },
+            timeout=httpx.Timeout(60.0, read=1800.0, write=300.0),
+            verify=True,
+        )
+
+        # Optional app-side chunking for very long recordings. Voxtral times
+        # out near its 3-hour limit on cloud inference; chunking lets users
+        # process longer meetings reliably. Diarization is per-chunk (Mistral
+        # doesn't return voice embeddings), so speakers will be remapped at
+        # chunk boundaries.
+        if os.environ.get('MISTRAL_ENABLE_CHUNKING', 'false').lower() == 'true':
+            try:
+                max_seconds = int(os.environ.get('MISTRAL_MAX_DURATION_SECONDS', '7200'))
+            except (ValueError, TypeError):
+                max_seconds = 7200
+            recommended_chunk = int(max_seconds * 0.8)
+            self.SPECIFICATIONS = ConnectorSpecifications(
+                max_file_size_bytes=None,
+                max_duration_seconds=max_seconds,
+                handles_chunking_internally=False,
+                recommended_chunk_seconds=recommended_chunk,
+            )
+            logger.info(
+                f"Mistral chunking enabled: max_duration={max_seconds}s, "
+                f"recommended_chunk={recommended_chunk}s"
+            )
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('api_key'):
+            raise ConfigurationError("api_key is required for Mistral connector")
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using Mistral Voxtral API.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse with text, segments, and optional diarization
+        """
+        try:
+            effective_model = self._effective_model(request) or self.model
+            # Build multipart form data using tuples for proper array encoding
+            file_tuple = ('file', (request.filename or 'audio.wav', request.audio_file, request.mime_type or 'application/octet-stream'))
+
+            fields: List[tuple] = [
+                ('model', effective_model),
+            ]
+
+            # Language param
+            if request.language:
+                fields.append(('language', request.language))
+                logger.info(f"Using transcription language: {request.language}")
+
+            # Diarization
+            if request.diarize:
+                fields.append(('diarize', 'true'))
+                logger.info("Diarization enabled for Mistral request")
+
+            # Context bias (hotwords) - Mistral accepts an array of strings
+            # Each item must match ^[^,\s]+$ (no commas or whitespace per item)
+            # So we split on both commas and whitespace to produce individual tokens
+            if request.hotwords:
+                context_bias = [w for w in re.split(r'[,\s]+', request.hotwords) if w]
+                for term in context_bias:
+                    fields.append(('context_bias', term))
+                if context_bias:
+                    logger.info(f"Using context bias with {len(context_bias)} terms")
+
+            # Timestamp granularities - always request segment-level timestamps
+            fields.append(('timestamp_granularities', 'segment'))
+
+            # Log prompt warning if provided (Mistral doesn't support prompt/initial_prompt)
+            if request.prompt:
+                logger.warning("Mistral Voxtral does not support initial_prompt parameter, ignoring")
+
+            logger.info(f"Sending request to Mistral API with model: {effective_model}")
+            response = self.client.post(
+                '/v1/audio/transcriptions',
+                files=[file_tuple] + [(name, (None, value)) for name, value in fields],
+            )
+
+            if response.status_code != 200:
+                error_detail = response.text
+                try:
+                    error_json = response.json()
+                    error_detail = error_json.get('message', error_json.get('detail', response.text))
+                except Exception:
+                    pass
+                raise ProviderError(
+                    f"Mistral API error: {error_detail}",
+                    provider=self.PROVIDER_NAME,
+                    status_code=response.status_code,
+                )
+
+            result = response.json()
+            logger.info(f"Mistral API response keys: {list(result.keys())}")
+            if result.get('segments'):
+                logger.info(f"First segment sample: {result['segments'][0] if result['segments'] else 'none'}")
+                logger.info(f"Total segments: {len(result['segments'])}")
+            else:
+                logger.warning(f"No segments in Mistral response. Full response (truncated): {str(result)[:500]}")
+
+            # Parse segments if available
+            segments = self._parse_segments(result.get('segments', []))
+
+            # Determine detected language
+            detected_language = result.get('language', request.language)
+
+            # Build speaker list from segments
+            speakers = list({s.speaker for s in segments if s.speaker})
+
+            return TranscriptionResponse(
+                text=result.get('text', ''),
+                segments=segments,
+                language=detected_language,
+                speakers=speakers if speakers else None,
+                provider=self.PROVIDER_NAME,
+                model=effective_model,
+                raw_response=result,
+            )
+
+        except ProviderError:
+            raise
+        except httpx.TimeoutException as e:
+            logger.error(f"Mistral API request timed out: {e}")
+            raise TranscriptionError(f"Mistral API request timed out: {e}") from e
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"Mistral transcription failed: {error_msg}")
+            raise TranscriptionError(f"Mistral transcription failed: {error_msg}") from e
+
+    def _parse_segments(self, raw_segments: List[Dict[str, Any]]) -> List[TranscriptionSegment]:
+        """
+        Convert Mistral segment format to TranscriptionSegment objects.
+
+        Args:
+            raw_segments: List of segment dicts from Mistral API
+
+        Returns:
+            List of TranscriptionSegment objects
+        """
+        segments = []
+        for seg in raw_segments:
+            segment = TranscriptionSegment(
+                text=seg.get('text', ''),
+                speaker=seg.get('speaker_id', seg.get('speaker', None)),
+                start_time=seg.get('start', None),
+                end_time=seg.get('end', None),
+                confidence=seg.get('score', None),
+            )
+            segments.append(segment)
+        return segments
+
+    def list_models(self):
+        """Return Voxtral models from Mistral's /v1/models endpoint.
+
+        Filters to ids containing 'voxtral' so the dropdown only offers
+        audio-capable models.
+        """
+        try:
+            resp = self.client.get('/v1/models')
+            if resp.status_code != 200:
+                return []
+            data = resp.json().get('data', [])
+            audio = []
+            for m in data:
+                mid = m.get('id', '')
+                if mid and 'voxtral' in mid.lower():
+                    audio.append({
+                        'id': mid,
+                        'label': mid,
+                        'owned_by': m.get('owned_by', 'mistralai'),
+                    })
+            return audio
+        except Exception as e:
+            logger.warning(f"mistral /v1/models probe failed: {e}")
+            return []
+
+    def health_check(self) -> bool:
+        """Check if the connector is properly configured."""
+        return bool(self.config.get('api_key'))
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["api_key"],
+            "properties": {
+                "api_key": {
+                    "type": "string",
+                    "description": "Mistral API key"
+                },
+                "base_url": {
+                    "type": "string",
+                    "default": "https://api.mistral.ai",
+                    "description": "API base URL"
+                },
+                "model": {
+                    "type": "string",
+                    "default": "voxtral-mini-latest",
+                    "description": "Voxtral model to use"
+                }
+            }
+        }
diff --git a/src/services/transcription/connectors/openai_transcribe.py b/src/services/transcription/connectors/openai_transcribe.py
new file mode 100644
index 00000000..0b373ffa
--- /dev/null
+++ b/src/services/transcription/connectors/openai_transcribe.py
@@ -0,0 +1,372 @@
+"""
+OpenAI GPT-4o Transcribe connector.
+
+Supports the newer GPT-4o based transcription models:
+- gpt-4o-transcribe: High quality transcription
+- gpt-4o-mini-transcribe: Cost-effective transcription
+- gpt-4o-transcribe-diarize: Speaker diarization with labels A, B, C, D
+"""
+
+import logging
+import httpx
+from openai import OpenAI
+from typing import Dict, Any, Set, Optional
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError
+
+logger = logging.getLogger(__name__)
+
+
+class OpenAITranscribeConnector(BaseTranscriptionConnector):
+    """Connector for GPT-4o Transcribe models with optional diarization support."""
+
+    # Base capabilities - diarization added dynamically based on model
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        # Hotwords + initial_prompt are concatenated into OpenAI's free-text
+        # `prompt` parameter for non-diarize models. The diarize model
+        # (gpt-4o-transcribe-diarize) silently ignores both -- handled with
+        # a UI help note rather than a per-model capability split.
+        TranscriptionCapability.HOTWORDS,
+        TranscriptionCapability.INITIAL_PROMPT,
+    }
+    PROVIDER_NAME = "openai_transcribe"
+
+    # GPT-4o Transcribe models have specific constraints
+    # - 25MB file size limit (all models)
+    # - Duration limits vary by model:
+    #   - gpt-4o-transcribe / gpt-4o-mini-transcribe: 1500 seconds (25 min)
+    #   - gpt-4o-transcribe-diarize: 1400 seconds (~23 min)
+    # - chunking_strategy="auto" handles files internally up to the duration limit
+    # Supported formats: mp3, mp4, mpeg, mpga, m4a, wav, webm, flac, ogg, oga
+    # NOT supported: opus (used by WhatsApp voice notes, Discord)
+
+    # Default specifications (will be overridden per-model in __init__)
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=25 * 1024 * 1024,  # 25MB
+        max_duration_seconds=1400,  # Default to most restrictive (diarize model)
+        min_duration_for_chunking=30,  # >30s needs chunking_strategy param
+        handles_chunking_internally=False,  # App must chunk files > max_duration_seconds
+        requires_chunking_param=True,  # Must send chunking_strategy for >30s
+        recommended_chunk_seconds=1200,  # 20 minutes - safe margin
+        unsupported_codecs=frozenset({'opus'}),  # OpenAI API doesn't support opus
+    )
+
+    # Models and their capabilities with duration limits
+    MODELS = {
+        'gpt-4o-transcribe': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,  # 25 minutes
+            'recommended_chunk_seconds': 1200,  # 20 minutes
+            'description': 'High quality transcription'
+        },
+        'gpt-4o-mini-transcribe': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,  # 25 minutes
+            'recommended_chunk_seconds': 1200,  # 20 minutes
+            'description': 'Cost-effective transcription'
+        },
+        'gpt-4o-mini-transcribe-2025-12-15': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,  # 25 minutes
+            'recommended_chunk_seconds': 1200,  # 20 minutes
+            'description': 'Cost-effective transcription (dated version)'
+        },
+        'gpt-4o-transcribe-diarize': {
+            'supports_diarization': True,
+            'max_duration_seconds': 1400,  # ~23 minutes (more restrictive)
+            'recommended_chunk_seconds': 1200,  # 20 minutes
+            'description': 'Speaker diarization with labels A, B, C, D'
+        },
+        'whisper-1': {
+            'supports_diarization': False,
+            'max_duration_seconds': 1500,  # 25 minutes (same 25MB API limit)
+            'recommended_chunk_seconds': 1200,  # 20 minutes
+            'description': 'Legacy Whisper API (no diarization)'
+        }
+    }
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the GPT-4o Transcribe connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - api_key: OpenAI API key (required)
+                - base_url: API base URL (default: https://api.openai.com/v1)
+                - model: Model name (required, one of MODELS)
+                - http_client: Optional httpx.Client instance
+        """
+        # Store model before calling super().__init__ since _validate_config needs it
+        self.model = config.get('model', 'gpt-4o-transcribe')
+
+        # Set model-specific specifications (override class defaults)
+        # Use SPECIFICATIONS (uppercase) to shadow the class attribute
+        model_info = self.MODELS.get(self.model, {})
+        self.SPECIFICATIONS = ConnectorSpecifications(
+            max_file_size_bytes=25 * 1024 * 1024,  # 25MB (same for all)
+            max_duration_seconds=model_info.get('max_duration_seconds', 1400),
+            min_duration_for_chunking=30,
+            handles_chunking_internally=False,
+            requires_chunking_param=True,
+            recommended_chunk_seconds=model_info.get('recommended_chunk_seconds', 1200),
+            unsupported_codecs=frozenset({'opus'}),
+        )
+
+        super().__init__(config)
+
+        # Set up HTTP client with custom headers
+        http_client = config.get('http_client')
+        if not http_client:
+            app_headers = {
+                "HTTP-Referer": "https://github.com/murtaza-nasir/speakr",
+                "X-Title": "Speakr - AI Audio Transcription",
+                "User-Agent": "Speakr/1.0 (https://github.com/murtaza-nasir/speakr)"
+            }
+            http_client = httpx.Client(verify=True, headers=app_headers)
+
+        self.client = OpenAI(
+            api_key=config['api_key'],
+            base_url=config.get('base_url', 'https://api.openai.com/v1'),
+            http_client=http_client
+        )
+
+        # Dynamically update capabilities based on model
+        if self._model_supports_diarization():
+            self.CAPABILITIES = self.CAPABILITIES | {
+                TranscriptionCapability.DIARIZATION,
+                TranscriptionCapability.KNOWN_SPEAKERS
+            }
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('api_key'):
+            raise ConfigurationError("api_key is required for OpenAI Transcribe connector")
+
+        model = self.config.get('model', 'gpt-4o-transcribe')
+        if model not in self.MODELS:
+            raise ConfigurationError(
+                f"Unknown model: {model}. Valid models: {list(self.MODELS.keys())}"
+            )
+
+    def _model_supports_diarization(self) -> bool:
+        """Check if the current model supports diarization."""
+        model_info = self.MODELS.get(self.model, {})
+        return model_info.get('supports_diarization', False)
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using GPT-4o Transcribe API.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse, with segments if using diarization model
+        """
+        try:
+            effective_model = self._effective_model(request) or self.model
+            # Validate the per-request override against this connector's known
+            # model whitelist; fall back silently if the override is unknown.
+            if effective_model not in self.MODELS:
+                logger.warning(
+                    f"Per-request model override {effective_model!r} is not in this connector's MODELS map; "
+                    f"falling back to configured default {self.model!r}"
+                )
+                effective_model = self.model
+            params = {
+                "model": effective_model,
+                "file": request.audio_file,
+            }
+
+            if request.language:
+                params["language"] = request.language
+                logger.info(f"Using transcription language: {request.language}")
+
+            # Handle diarization model specifics
+            if effective_model == 'gpt-4o-transcribe-diarize':
+                # Required: chunking_strategy for audio > 30 seconds
+                params["chunking_strategy"] = "auto"
+
+                if request.diarize:
+                    params["response_format"] = "diarized_json"
+                    logger.info("Using diarized_json response format for speaker diarization")
+
+                    # Known speaker support for maintaining speaker identity across chunks
+                    # known_speaker_names is a list of speaker labels (e.g., ["A", "B"])
+                    # known_speaker_references is a dict mapping label to data URL
+                    if request.known_speaker_names and request.known_speaker_references:
+                        # OpenAI expects lists for both parameters
+                        speaker_names = []
+                        speaker_refs = []
+
+                        for name in request.known_speaker_names:
+                            if name in request.known_speaker_references:
+                                speaker_names.append(name)
+                                speaker_refs.append(request.known_speaker_references[name])
+
+                        if speaker_names:
+                            # Use extra_body to pass the known speaker parameters
+                            params["extra_body"] = {
+                                "known_speaker_names": speaker_names,
+                                "known_speaker_references": speaker_refs
+                            }
+                            logger.info(f"Using known speaker references for {len(speaker_names)} speakers: {speaker_names}")
+            else:
+                # Non-diarization models - combine initial prompt and hotwords
+                prompt_parts = []
+                if request.prompt:
+                    prompt_parts.append(request.prompt)
+                if request.hotwords:
+                    prompt_parts.append(request.hotwords)
+                if prompt_parts:
+                    params["prompt"] = ". ".join(prompt_parts)
+
+            logger.info(f"Sending request to GPT-4o Transcribe API with model: {effective_model}")
+            response = self.client.audio.transcriptions.create(**params)
+
+            # Parse response based on format
+            if effective_model == 'gpt-4o-transcribe-diarize' and request.diarize:
+                return self._parse_diarized_response(response, effective_model)
+            else:
+                return self._parse_text_response(response, effective_model)
+
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"GPT-4o transcription failed: {error_msg}")
+            raise TranscriptionError(f"GPT-4o transcription failed: {error_msg}") from e
+
+    def _parse_text_response(self, response, model_used: Optional[str] = None) -> TranscriptionResponse:
+        """Parse a plain text response."""
+        text = response.text if hasattr(response, 'text') else str(response)
+        return TranscriptionResponse(
+            text=text,
+            provider=self.PROVIDER_NAME,
+            model=model_used or self.model
+        )
+
+    def _parse_diarized_response(self, response, model_used: Optional[str] = None) -> TranscriptionResponse:
+        """
+        Parse diarized JSON response into standardized format.
+
+        The diarized_json response contains segments with:
+        - speaker: "A", "B", "C", "D" etc.
+        - text: The transcribed text
+        - start: Segment start time
+        - end: Segment end time
+        """
+        segments = []
+        speakers = set()
+        full_text_parts = []
+
+        # Handle response object - could be dict or object with attributes
+        if hasattr(response, 'segments'):
+            raw_segments = response.segments
+        elif isinstance(response, dict) and 'segments' in response:
+            raw_segments = response['segments']
+        else:
+            # Fallback to text-only response
+            logger.warning("No segments found in diarized response, falling back to text")
+            return self._parse_text_response(response)
+
+        for seg in raw_segments:
+            # Handle both dict and object segments
+            if isinstance(seg, dict):
+                speaker = seg.get('speaker', 'Unknown')
+                text = seg.get('text', '')
+                start = seg.get('start')
+                end = seg.get('end')
+            else:
+                speaker = getattr(seg, 'speaker', 'Unknown')
+                text = getattr(seg, 'text', '')
+                start = getattr(seg, 'start', None)
+                end = getattr(seg, 'end', None)
+
+            # Skip empty segments
+            if not text or not text.strip():
+                continue
+
+            speakers.add(speaker)
+            full_text_parts.append(f"[{speaker}]: {text}")
+
+            segments.append(TranscriptionSegment(
+                text=text,
+                speaker=speaker,
+                start_time=start,
+                end_time=end
+            ))
+
+        # Always use our formatted text with speaker labels for diarized responses
+        # OpenAI's response.text is plain text WITHOUT speaker labels
+        full_text = '\n'.join(full_text_parts)
+
+        logger.info(f"Parsed {len(segments)} segments with {len(speakers)} unique speakers: {sorted(speakers)}")
+
+        return TranscriptionResponse(
+            text=full_text,
+            segments=segments,
+            speakers=sorted(list(speakers)),
+            provider=self.PROVIDER_NAME,
+            model=model_used or self.model,
+            raw_response=response if isinstance(response, dict) else None
+        )
+
+    def list_models(self):
+        """Return audio-transcription-relevant models from /v1/models.
+
+        Filters to ids containing 'transcribe' or 'whisper' so the dropdown
+        only offers models that can actually run audio transcription.
+        """
+        try:
+            resp = self.client.models.list()
+            audio = []
+            for m in resp.data:
+                mid = getattr(m, 'id', '')
+                if mid and ('transcribe' in mid.lower() or 'whisper' in mid.lower()):
+                    audio.append({
+                        'id': mid,
+                        'label': mid,
+                        'owned_by': getattr(m, 'owned_by', 'openai'),
+                    })
+            return audio
+        except Exception as e:
+            logger.warning(f"openai_transcribe /v1/models probe failed: {e}")
+            return []
+
+    def health_check(self) -> bool:
+        """Check if the connector is properly configured."""
+        return bool(self.config.get('api_key'))
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["api_key"],
+            "properties": {
+                "api_key": {
+                    "type": "string",
+                    "description": "OpenAI API key"
+                },
+                "base_url": {
+                    "type": "string",
+                    "default": "https://api.openai.com/v1",
+                    "description": "API base URL"
+                },
+                "model": {
+                    "type": "string",
+                    "enum": list(cls.MODELS.keys()),
+                    "default": "gpt-4o-transcribe",
+                    "description": "GPT-4o transcription model to use"
+                }
+            }
+        }
diff --git a/src/services/transcription/connectors/openai_whisper.py b/src/services/transcription/connectors/openai_whisper.py
new file mode 100644
index 00000000..1a0021b4
--- /dev/null
+++ b/src/services/transcription/connectors/openai_whisper.py
@@ -0,0 +1,177 @@
+"""
+OpenAI Whisper API connector (whisper-1 model).
+
+This is the legacy Whisper API connector that supports the whisper-1 model.
+It returns plain text transcriptions without speaker diarization.
+"""
+
+import logging
+import os
+import httpx
+from openai import OpenAI
+from typing import Dict, Any, Set
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError
+
+logger = logging.getLogger(__name__)
+
+
+class OpenAIWhisperConnector(BaseTranscriptionConnector):
+    """Connector for OpenAI Whisper API (whisper-1 model)."""
+
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.CHUNKING,
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        TranscriptionCapability.HOTWORDS,
+        TranscriptionCapability.INITIAL_PROMPT,
+    }
+    PROVIDER_NAME = "openai_whisper"
+
+    # OpenAI Whisper has a 25MB file limit and doesn't handle chunking internally
+    # Supported formats: mp3, mp4, mpeg, mpga, m4a, wav, webm, flac, ogg, oga
+    # NOT supported: opus (used by WhatsApp voice notes, Discord)
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=25 * 1024 * 1024,  # 25MB
+        handles_chunking_internally=False,
+        recommended_chunk_seconds=600,  # 10 minutes
+        unsupported_codecs=frozenset({'opus'}),  # OpenAI API doesn't support opus
+    )
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the Whisper connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - api_key: OpenAI API key (required)
+                - base_url: API base URL (optional)
+                - model: Model name (default: whisper-1)
+                - http_client: Optional httpx.Client instance
+        """
+        super().__init__(config)
+
+        # Set up HTTP client with custom headers
+        http_client = config.get('http_client')
+        if not http_client:
+            app_headers = {
+                "HTTP-Referer": "https://github.com/murtaza-nasir/speakr",
+                "X-Title": "Speakr - AI Audio Transcription",
+                "User-Agent": "Speakr/1.0 (https://github.com/murtaza-nasir/speakr)"
+            }
+            http_client = httpx.Client(verify=True, headers=app_headers)
+
+        self.client = OpenAI(
+            api_key=config['api_key'],
+            base_url=config.get('base_url') or None,
+            http_client=http_client
+        )
+        self.model = config.get('model', 'whisper-1')
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('api_key'):
+            raise ConfigurationError("api_key is required for OpenAI Whisper connector")
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using OpenAI Whisper API.
+
+        Args:
+            request: Standardized transcription request
+
+        Returns:
+            TranscriptionResponse with plain text (no diarization)
+        """
+        try:
+            effective_model = self._effective_model(request)
+            params = {
+                "model": effective_model,
+                "file": request.audio_file,
+            }
+
+            if request.language:
+                params["language"] = request.language
+                logger.info(f"Using transcription language: {request.language}")
+
+            # Combine initial prompt and hotwords into a single prompt
+            # OpenAI Whisper uses prompt for both steering and vocabulary hints
+            prompt_parts = []
+            if request.prompt:
+                prompt_parts.append(request.prompt)
+            if request.hotwords:
+                prompt_parts.append(request.hotwords)
+            if prompt_parts:
+                params["prompt"] = ". ".join(prompt_parts)
+
+            if request.temperature is not None:
+                params["temperature"] = request.temperature
+
+            logger.info(f"Sending request to Whisper API with model: {effective_model}")
+            transcript = self.client.audio.transcriptions.create(**params)
+
+            return TranscriptionResponse(
+                text=transcript.text,
+                provider=self.PROVIDER_NAME,
+                model=effective_model
+            )
+
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"Whisper transcription failed: {error_msg}")
+            raise TranscriptionError(f"Whisper transcription failed: {error_msg}") from e
+
+    def list_models(self):
+        """Return audio-relevant models from OpenAI's /v1/models.
+
+        Filters the full catalog to entries whose id contains 'whisper'.
+        """
+        try:
+            resp = self.client.models.list()
+            audio = []
+            for m in resp.data:
+                mid = getattr(m, 'id', '')
+                if mid and 'whisper' in mid.lower():
+                    audio.append({
+                        'id': mid,
+                        'label': mid,
+                        'owned_by': getattr(m, 'owned_by', 'openai'),
+                    })
+            return audio
+        except Exception as e:
+            logger.warning(f"openai_whisper /v1/models probe failed: {e}")
+            return []
+
+    def health_check(self) -> bool:
+        """Check if the connector is properly configured."""
+        return bool(self.config.get('api_key'))
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["api_key"],
+            "properties": {
+                "api_key": {
+                    "type": "string",
+                    "description": "OpenAI API key"
+                },
+                "base_url": {
+                    "type": "string",
+                    "description": "API base URL (optional, for OpenAI-compatible endpoints)"
+                },
+                "model": {
+                    "type": "string",
+                    "default": "whisper-1",
+                    "description": "Whisper model to use"
+                }
+            }
+        }
diff --git a/src/services/transcription/connectors/vibevoice.py b/src/services/transcription/connectors/vibevoice.py
new file mode 100644
index 00000000..9350b4c3
--- /dev/null
+++ b/src/services/transcription/connectors/vibevoice.py
@@ -0,0 +1,376 @@
+"""
+VibeVoice ASR connector for audio transcription.
+
+Supports Microsoft's VibeVoice model served via vLLM, which provides
+structured transcription with speaker diarization, timestamps, and
+automatic language detection for 50+ languages. Handles up to 60 minutes
+per request via the OpenAI-compatible chat completions API.
+"""
+
+import base64
+import json
+import logging
+import mimetypes
+import re
+import httpx
+from typing import Dict, Any, Set, List, Optional
+
+from ..base import (
+    BaseTranscriptionConnector,
+    TranscriptionCapability,
+    TranscriptionRequest,
+    TranscriptionResponse,
+    TranscriptionSegment,
+    ConnectorSpecifications,
+)
+from ..exceptions import TranscriptionError, ConfigurationError, ProviderError
+
+logger = logging.getLogger(__name__)
+
+
+class VibeVoiceTranscriptionConnector(BaseTranscriptionConnector):
+    """Connector for VibeVoice ASR via vLLM's OpenAI-compatible API."""
+
+    CAPABILITIES: Set[TranscriptionCapability] = {
+        TranscriptionCapability.DIARIZATION,
+        TranscriptionCapability.TIMESTAMPS,
+        TranscriptionCapability.LANGUAGE_DETECTION,
+        # Hotwords are embedded as "extra info" in the multimodal text prompt.
+        # Initial prompt is not accepted -- VibeVoice builds its own text prompt.
+        TranscriptionCapability.HOTWORDS,
+    }
+    PROVIDER_NAME = "vibevoice"
+
+    # VibeVoice handles up to ~60 minutes per request; use app-level chunking beyond that
+    SPECIFICATIONS = ConnectorSpecifications(
+        max_file_size_bytes=None,
+        max_duration_seconds=3500,  # ~58 min safety margin under the 60 min cap
+        handles_chunking_internally=False,
+        recommended_chunk_seconds=3000,  # ~50 min chunks to stay well under limit
+    )
+
+    def __init__(self, config: Dict[str, Any]):
+        """
+        Initialize the VibeVoice connector.
+
+        Args:
+            config: Configuration dict with keys:
+                - base_url: vLLM server URL (required, e.g. http://localhost:8000)
+                - model: Model name (default: microsoft/VibeVoice-ASR)
+                - api_key: API key if the vLLM server requires auth (optional)
+        """
+        super().__init__(config)
+
+        self.base_url = config['base_url'].rstrip('/')
+        self.model = config.get('model', 'microsoft/VibeVoice-ASR')
+        self.api_key = config.get('api_key', '')
+
+        headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'Speakr/1.0 (https://github.com/murtaza-nasir/speakr)',
+        }
+        if self.api_key:
+            headers['Authorization'] = f'Bearer {self.api_key}'
+
+        self.client = httpx.Client(
+            base_url=self.base_url,
+            headers=headers,
+            timeout=httpx.Timeout(60.0, read=3600.0, write=300.0),
+            verify=True,
+        )
+
+    def _validate_config(self) -> None:
+        """Validate required configuration."""
+        if not self.config.get('base_url'):
+            raise ConfigurationError("base_url is required for VibeVoice connector")
+
+    def _get_audio_duration(self, audio_bytes: bytes, filename: str = None) -> Optional[float]:
+        """Get audio duration in seconds using ffprobe."""
+        try:
+            import subprocess, tempfile, os
+            suffix = ''
+            if filename:
+                _, suffix = os.path.splitext(filename)
+            with tempfile.NamedTemporaryFile(suffix=suffix or '.wav', delete=False) as tmp:
+                tmp.write(audio_bytes)
+                tmp_path = tmp.name
+            try:
+                result = subprocess.run(
+                    ['ffprobe', '-v', 'quiet', '-show_entries', 'format=duration',
+                     '-of', 'default=noprint_wrappers=1:nokey=1', tmp_path],
+                    capture_output=True, text=True, timeout=10
+                )
+                if result.returncode == 0 and result.stdout.strip():
+                    return float(result.stdout.strip())
+            finally:
+                os.unlink(tmp_path)
+        except Exception as e:
+            logger.debug(f"Could not determine audio duration: {e}")
+        return None
+
+    def transcribe(self, request: TranscriptionRequest) -> TranscriptionResponse:
+        """
+        Transcribe audio using VibeVoice via vLLM chat completions API.
+
+        Audio is sent as a base64 data URL in a multimodal chat message.
+        The model returns a JSON array of segments with speaker, timestamps, and text.
+        """
+        try:
+            effective_model = self._effective_model(request) or self.model
+            # Read and base64-encode the audio
+            audio_bytes = request.audio_file.read()
+            audio_b64 = base64.b64encode(audio_bytes).decode('utf-8')
+
+            # Determine MIME type
+            mime = request.mime_type
+            if not mime and request.filename:
+                mime, _ = mimetypes.guess_type(request.filename)
+            if not mime:
+                mime = 'audio/wav'
+
+            # Get audio duration for the prompt
+            duration = self._get_audio_duration(audio_bytes, request.filename)
+
+            # Build the transcription prompt (per VibeVoice docs)
+            if request.hotwords and duration:
+                text_prompt = (
+                    f"This is a {duration:.2f} seconds audio, "
+                    f"with extra info: {request.hotwords}\n\n"
+                    f"Please transcribe it with these keys: Start time, End time, Speaker ID, Content"
+                )
+            elif duration:
+                text_prompt = (
+                    f"This is a {duration:.2f} seconds audio, "
+                    f"please transcribe it with these keys: Start time, End time, Speaker ID, Content"
+                )
+            elif request.hotwords:
+                text_prompt = (
+                    f"Extra info: {request.hotwords}\n\n"
+                    f"Please transcribe it with these keys: Start time, End time, Speaker ID, Content"
+                )
+            else:
+                text_prompt = "Please transcribe it with these keys: Start time, End time, Speaker ID, Content"
+
+            # Build the data URL (VibeVoice docs format)
+            data_url = f"data:{mime};base64,{audio_b64}"
+
+            # Build the chat completion request per VibeVoice docs
+            payload = {
+                "model": effective_model,
+                "messages": [
+                    {
+                        "role": "system",
+                        "content": "You are a helpful assistant that transcribes audio input into text output in JSON format."
+                    },
+                    {
+                        "role": "user",
+                        "content": [
+                            {"type": "audio_url", "audio_url": {"url": data_url}},
+                            {"type": "text", "text": text_prompt},
+                        ],
+                    }
+                ],
+                "max_tokens": 32768,
+                "temperature": 0.0,
+                "top_p": 1.0,
+            }
+
+            logger.info(f"Sending request to VibeVoice at {self.base_url} (duration={duration}s, model={effective_model})")
+            response = self.client.post('/v1/chat/completions', json=payload)
+
+            if response.status_code != 200:
+                error_detail = response.text
+                try:
+                    error_json = response.json()
+                    error_detail = error_json.get('error', {}).get('message', response.text)
+                except Exception:
+                    pass
+                raise ProviderError(
+                    f"VibeVoice API error: {error_detail}",
+                    provider=self.PROVIDER_NAME,
+                    status_code=response.status_code,
+                )
+
+            result = response.json()
+
+            # Extract the content from the chat completion response
+            content = result.get('choices', [{}])[0].get('message', {}).get('content', '')
+            if not content:
+                raise TranscriptionError("VibeVoice returned empty content")
+
+            # Parse the JSON array of segments from the response
+            raw_segments = self._parse_json_segments(content)
+
+            segments = self._parse_segments(raw_segments)
+
+            # Build full text from segments
+            full_text = ' '.join(seg.text for seg in segments if seg.text)
+
+            # Extract unique speakers
+            speakers = list({s.speaker for s in segments if s.speaker})
+
+            logger.info(f"VibeVoice transcription complete: {len(segments)} segments, {len(speakers)} speakers")
+
+            return TranscriptionResponse(
+                text=full_text,
+                segments=segments,
+                speakers=speakers if speakers else None,
+                provider=self.PROVIDER_NAME,
+                model=effective_model,
+                raw_response=result,
+            )
+
+        except (ProviderError, TranscriptionError):
+            raise
+        except httpx.TimeoutException as e:
+            logger.error(f"VibeVoice API request timed out: {e}")
+            raise TranscriptionError(f"VibeVoice API request timed out: {e}") from e
+        except Exception as e:
+            error_msg = str(e)
+            logger.error(f"VibeVoice transcription failed: {error_msg}")
+            raise TranscriptionError(f"VibeVoice transcription failed: {error_msg}") from e
+
+    def _parse_json_segments(self, content: str) -> List[Dict[str, Any]]:
+        """
+        Parse the JSON array from VibeVoice, with fallback for truncated/malformed output.
+
+        VibeVoice can sometimes produce degenerate JSON towards the end of longer
+        transcriptions. When strict parsing fails, we recover by finding the last
+        complete segment object and truncating there.
+        """
+        # Dump raw response to temp file for debugging
+        try:
+            import tempfile, os
+            debug_path = os.path.join(tempfile.gettempdir(), 'vibevoice_last_response.json')
+            with open(debug_path, 'w', encoding='utf-8') as f:
+                f.write(content)
+            logger.debug(f"VibeVoice raw response saved to {debug_path}")
+        except Exception:
+            pass
+
+        # Try strict parse first
+        try:
+            result = json.loads(content)
+            if isinstance(result, list):
+                return result
+        except json.JSONDecodeError:
+            pass
+
+        # Try lenient parse (allows control characters)
+        try:
+            result = json.loads(content, strict=False)
+            if isinstance(result, list):
+                return result
+        except json.JSONDecodeError:
+            pass
+
+        # Fallback: find all },{ boundaries and try progressively shorter
+        # truncations until we get valid JSON. The corruption can start mid-segment
+        # so we may need to cut more than just the last one.
+        boundaries = [m.start() for m in re.finditer(r'\}\s*,\s*\{', content)]
+
+        for cut_pos in reversed(boundaries):
+            truncated = content[:cut_pos + 1] + ']'
+            try:
+                result = json.loads(truncated, strict=False)
+                if isinstance(result, list) and len(result) > 0:
+                    logger.warning(
+                        f"VibeVoice JSON was truncated: recovered {len(result)} segments "
+                        f"from {len(content)} chars (cut at position {cut_pos})"
+                    )
+                    return result
+            except json.JSONDecodeError:
+                continue
+
+        logger.error(f"Failed to parse VibeVoice response as JSON: {content[:500]}")
+        raise TranscriptionError("VibeVoice returned unparseable JSON response")
+
+    def _parse_segments(self, raw_segments: List[Dict[str, Any]]) -> List[TranscriptionSegment]:
+        """
+        Convert VibeVoice segment format to TranscriptionSegment objects.
+
+        VibeVoice returns speaker IDs as integers (0, 1, 2...) or sometimes
+        omits the Speaker key entirely for non-speech segments like [Silence],
+        [Human Sounds]. For those, we assign the previous speaker's ID so they
+        flow naturally. If there's no previous speaker yet, we drop the segment.
+        """
+        segments = []
+        last_speaker = None
+        for seg in raw_segments:
+            raw_speaker = seg.get('Speaker')
+            if raw_speaker is not None:
+                # Convert integer speaker IDs to SPEAKER_XX format
+                if isinstance(raw_speaker, int):
+                    speaker = f"SPEAKER_{raw_speaker:02d}"
+                else:
+                    speaker = str(raw_speaker)
+                last_speaker = speaker
+            else:
+                # Non-speech segment — inherit previous speaker or skip
+                if last_speaker is None:
+                    continue
+                speaker = last_speaker
+
+            segment = TranscriptionSegment(
+                text=seg.get('Content', ''),
+                speaker=speaker,
+                start_time=seg.get('Start', None),
+                end_time=seg.get('End', None),
+            )
+            segments.append(segment)
+        return segments
+
+    def list_models(self):
+        """Return models from the vLLM /v1/models endpoint.
+
+        vLLM exposes this in OpenAI-compatible form. Whatever model the
+        VibeVoice server has loaded shows up here.
+        """
+        try:
+            resp = self.client.get('/v1/models')
+            if resp.status_code != 200:
+                return []
+            data = resp.json().get('data', [])
+            return [
+                {
+                    'id': m.get('id'),
+                    'label': m.get('id'),
+                    'owned_by': m.get('owned_by', 'vllm'),
+                }
+                for m in data if m.get('id')
+            ]
+        except Exception as e:
+            logger.warning(f"vibevoice /v1/models probe failed: {e}")
+            return []
+
+    def health_check(self) -> bool:
+        """Check if the vLLM server is reachable."""
+        try:
+            response = self.client.get('/v1/models')
+            return response.status_code == 200
+        except Exception:
+            return False
+
+    @classmethod
+    def get_config_schema(cls) -> Dict[str, Any]:
+        """Return JSON schema for configuration."""
+        return {
+            "type": "object",
+            "required": ["base_url"],
+            "properties": {
+                "base_url": {
+                    "type": "string",
+                    "description": "vLLM server URL (e.g. http://localhost:8000)"
+                },
+                "model": {
+                    "type": "string",
+                    "default": "microsoft/VibeVoice-ASR",
+                    "description": "VibeVoice model name"
+                },
+                "api_key": {
+                    "type": "string",
+                    "default": "",
+                    "description": "API key for vLLM server (if required)"
+                }
+            }
+        }
diff --git a/src/services/transcription/exceptions.py b/src/services/transcription/exceptions.py
new file mode 100644
index 00000000..d9de52d6
--- /dev/null
+++ b/src/services/transcription/exceptions.py
@@ -0,0 +1,32 @@
+"""
+Custom exceptions for transcription services.
+"""
+
+
+class TranscriptionError(Exception):
+    """Base exception for transcription errors."""
+    pass
+
+
+class ConfigurationError(TranscriptionError):
+    """Configuration-related errors (missing or invalid config)."""
+    pass
+
+
+class ProviderError(TranscriptionError):
+    """Provider/API errors."""
+
+    def __init__(self, message: str, provider: str = None, status_code: int = None):
+        super().__init__(message)
+        self.provider = provider
+        self.status_code = status_code
+
+
+class AudioFormatError(TranscriptionError):
+    """Unsupported audio format errors."""
+    pass
+
+
+class ChunkingError(TranscriptionError):
+    """Errors during file chunking."""
+    pass
diff --git a/src/services/transcription/registry.py b/src/services/transcription/registry.py
new file mode 100644
index 00000000..899a31bc
--- /dev/null
+++ b/src/services/transcription/registry.py
@@ -0,0 +1,379 @@
+"""
+Connector registry for managing transcription connectors.
+
+Provides factory pattern for creating and managing transcription connectors,
+with auto-detection from environment variables for backwards compatibility.
+"""
+
+import os
+import logging
+from typing import Dict, Any, Optional, Type, List
+
+from .base import BaseTranscriptionConnector, TranscriptionCapability, TranscriptionRequest, TranscriptionResponse
+from .exceptions import ConfigurationError
+
+logger = logging.getLogger(__name__)
+
+
+class ConnectorRegistry:
+    """
+    Registry for managing transcription connectors.
+
+    Singleton pattern - use get_registry() to get the shared instance.
+    """
+
+    _instance = None
+    _connectors: Dict[str, Type[BaseTranscriptionConnector]] = {}
+    _active_connector: Optional[BaseTranscriptionConnector] = None
+    _connector_name: str = ""
+    _initialized: bool = False
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+        return cls._instance
+
+    def __init__(self):
+        if self._initialized:
+            return
+        self._register_builtin_connectors()
+        self._initialized = True
+
+    def _register_builtin_connectors(self):
+        """Register all built-in connectors."""
+        from .connectors.openai_whisper import OpenAIWhisperConnector
+        from .connectors.openai_transcribe import OpenAITranscribeConnector
+        from .connectors.asr_endpoint import ASREndpointConnector
+        from .connectors.azure_openai_transcribe import AzureOpenAITranscribeConnector
+        from .connectors.mistral import MistralTranscriptionConnector
+        from .connectors.vibevoice import VibeVoiceTranscriptionConnector
+
+        self.register('openai_whisper', OpenAIWhisperConnector)
+        self.register('openai_transcribe', OpenAITranscribeConnector)
+        self.register('asr_endpoint', ASREndpointConnector)
+        self.register('azure_openai_transcribe', AzureOpenAITranscribeConnector)
+        self.register('mistral', MistralTranscriptionConnector)
+        self.register('vibevoice', VibeVoiceTranscriptionConnector)
+
+    def register(self, name: str, connector_class: Type[BaseTranscriptionConnector]):
+        """
+        Register a connector class.
+
+        Args:
+            name: Unique name for the connector
+            connector_class: The connector class to register
+        """
+        self._connectors[name] = connector_class
+        logger.debug(f"Registered transcription connector: {name}")
+
+    def get_connector_class(self, name: str) -> Type[BaseTranscriptionConnector]:
+        """
+        Get a connector class by name.
+
+        Args:
+            name: The connector name
+
+        Returns:
+            The connector class
+
+        Raises:
+            ConfigurationError: If connector not found
+        """
+        if name not in self._connectors:
+            raise ConfigurationError(
+                f"Unknown connector: {name}. Available: {list(self._connectors.keys())}"
+            )
+        return self._connectors[name]
+
+    def create_connector(self, name: str, config: Dict[str, Any]) -> BaseTranscriptionConnector:
+        """
+        Create a connector instance.
+
+        Args:
+            name: The connector name
+            config: Configuration dict for the connector
+
+        Returns:
+            Configured connector instance
+        """
+        connector_class = self.get_connector_class(name)
+        return connector_class(config)
+
+    def list_connectors(self) -> List[Dict[str, Any]]:
+        """
+        List all registered connectors with their capabilities.
+
+        Returns:
+            List of connector info dicts
+        """
+        result = []
+        for name, cls in self._connectors.items():
+            result.append({
+                'name': name,
+                'provider_name': cls.PROVIDER_NAME,
+                'capabilities': [c.name for c in cls.CAPABILITIES],
+                'config_schema': cls.get_config_schema()
+            })
+        return result
+
+    def initialize_from_env(self) -> BaseTranscriptionConnector:
+        """
+        Initialize the active connector from environment variables.
+
+        Auto-detection priority:
+        1. TRANSCRIPTION_CONNECTOR - explicit connector name
+        2. ASR_BASE_URL is set - use ASR endpoint (smarter detection)
+           - USE_ASR_ENDPOINT=true also works (backwards compat, with deprecation warning)
+        3. TRANSCRIPTION_MODEL contains 'gpt-4o' - use OpenAI Transcribe
+        4. TRANSCRIPTION_MODEL is set - use OpenAI Whisper with that model
+        5. Default to OpenAI Whisper (whisper-1)
+
+        Returns:
+            The initialized connector
+        """
+        connector_name = os.environ.get('TRANSCRIPTION_CONNECTOR', '').lower().strip()
+
+        if not connector_name:
+            # Auto-detect based on existing config for backwards compatibility
+            asr_base_url = os.environ.get('ASR_BASE_URL', '').strip()
+            use_asr_flag = os.environ.get('USE_ASR_ENDPOINT', 'false').lower() == 'true'
+            transcription_model = os.environ.get('TRANSCRIPTION_MODEL', '').lower()
+            whisper_model = os.environ.get('WHISPER_MODEL', '').lower()
+
+            # Deprecation warning for legacy USE_ASR_ENDPOINT flag
+            if use_asr_flag:
+                logger.warning(
+                    "USE_ASR_ENDPOINT=true is deprecated. "
+                    "Set ASR_BASE_URL instead for auto-detection, or use TRANSCRIPTION_CONNECTOR=asr_endpoint"
+                )
+
+            # Priority 2: ASR endpoint - check ASR_BASE_URL or legacy flag
+            if asr_base_url or use_asr_flag:
+                connector_name = 'asr_endpoint'
+                if asr_base_url:
+                    logger.info("Auto-detected ASR endpoint from ASR_BASE_URL")
+            # Priority 2.5: Azure OpenAI - check for Azure endpoint URL
+            elif self._is_azure_endpoint():
+                connector_name = 'azure_openai_transcribe'
+                logger.info("Auto-detected Azure OpenAI from TRANSCRIPTION_BASE_URL")
+            # Priority 3: Model-based detection
+            elif transcription_model and 'gpt-4o' in transcription_model:
+                connector_name = 'openai_transcribe'
+                logger.info(f"Auto-detected OpenAI Transcribe from TRANSCRIPTION_MODEL={transcription_model}")
+            # Priority 4 & 5: OpenAI Whisper (with custom or default model)
+            else:
+                connector_name = 'openai_whisper'
+                model = transcription_model or whisper_model or 'whisper-1'
+                logger.info(f"Using OpenAI Whisper connector with model: {model}")
+
+        config = self._build_config_from_env(connector_name)
+
+        try:
+            self._active_connector = self.create_connector(connector_name, config)
+            self._connector_name = connector_name
+
+            logger.info(f"Initialized transcription connector: {connector_name}")
+            logger.info(f"Capabilities: {[c.name for c in self._active_connector.get_capabilities()]}")
+
+            return self._active_connector
+
+        except Exception as e:
+            logger.error(f"Failed to initialize connector '{connector_name}': {e}")
+            raise ConfigurationError(f"Failed to initialize connector '{connector_name}': {e}") from e
+
+    def _get_asr_timeout(self) -> int:
+        """
+        Get ASR timeout with fallback chain: ENV -> Admin UI -> default.
+
+        Priority:
+        1. ASR_TIMEOUT environment variable
+        2. asr_timeout_seconds environment variable (legacy)
+        3. SystemSetting from Admin UI (database)
+        4. Default: 1800 seconds (30 minutes)
+        """
+        # Check environment variables first
+        env_timeout = os.environ.get('ASR_TIMEOUT') or os.environ.get('asr_timeout_seconds')
+        if env_timeout:
+            return int(env_timeout)
+
+        # Fall back to Admin UI setting (SystemSetting in database)
+        try:
+            from src.models import SystemSetting
+            db_timeout = SystemSetting.get_setting('asr_timeout_seconds', None)
+            if db_timeout is not None:
+                return int(db_timeout)
+        except Exception as e:
+            # May fail if no app context or during initialization
+            logger.debug(f"Could not read ASR timeout from database: {e}")
+
+        # Default: 30 minutes
+        return 1800
+
+    def _is_azure_endpoint(self) -> bool:
+        """Check if the TRANSCRIPTION_BASE_URL points to an Azure OpenAI endpoint."""
+        base_url = os.environ.get('TRANSCRIPTION_BASE_URL', '').lower()
+        return '.openai.azure.com' in base_url or '.cognitiveservices.azure.com' in base_url
+
+    def _build_config_from_env(self, connector_name: str) -> Dict[str, Any]:
+        """
+        Build connector config from environment variables.
+
+        Args:
+            connector_name: The connector to build config for
+
+        Returns:
+            Configuration dict
+        """
+        if connector_name == 'asr_endpoint':
+            base_url = os.environ.get('ASR_BASE_URL', '')
+            if base_url:
+                base_url = base_url.split('#')[0].strip()
+
+            return {
+                'base_url': base_url,
+                'timeout': self._get_asr_timeout(),
+                'diarize': os.environ.get('ASR_DIARIZE', 'true').lower() == 'true',
+                'return_speaker_embeddings': os.environ.get('ASR_RETURN_SPEAKER_EMBEDDINGS', 'false').lower() == 'true'
+            }
+
+        elif connector_name == 'openai_transcribe':
+            base_url = os.environ.get('TRANSCRIPTION_BASE_URL', 'https://api.openai.com/v1')
+            if base_url:
+                base_url = base_url.split('#')[0].strip()
+
+            return {
+                'api_key': os.environ.get('TRANSCRIPTION_API_KEY', ''),
+                'base_url': base_url,
+                'model': os.environ.get('TRANSCRIPTION_MODEL', 'gpt-4o-transcribe')
+            }
+
+        elif connector_name == 'azure_openai_transcribe':
+            # Azure OpenAI requires endpoint and deployment_name
+            # TRANSCRIPTION_BASE_URL should be the Azure endpoint (e.g., https://your-resource.openai.azure.com)
+            endpoint = os.environ.get('TRANSCRIPTION_BASE_URL', '')
+            if endpoint:
+                endpoint = endpoint.split('#')[0].strip()
+                # Remove any trailing /openai or /v1 paths - we build the full URL ourselves
+                endpoint = endpoint.rstrip('/')
+                for suffix in ['/openai/v1', '/openai', '/v1']:
+                    if endpoint.lower().endswith(suffix):
+                        endpoint = endpoint[:-len(suffix)]
+
+            return {
+                'api_key': os.environ.get('TRANSCRIPTION_API_KEY', ''),
+                'endpoint': endpoint,
+                'deployment_name': os.environ.get('AZURE_DEPLOYMENT_NAME', os.environ.get('TRANSCRIPTION_MODEL', 'gpt-4o-transcribe')),
+                'api_version': os.environ.get('AZURE_API_VERSION', '2025-04-01-preview'),
+                'model': os.environ.get('TRANSCRIPTION_MODEL', '')  # For capability detection
+            }
+
+        elif connector_name == 'mistral':
+            base_url = os.environ.get('TRANSCRIPTION_BASE_URL', '')
+            if base_url:
+                base_url = base_url.split('#')[0].strip()
+
+            return {
+                'api_key': os.environ.get('TRANSCRIPTION_API_KEY', ''),
+                'base_url': base_url or 'https://api.mistral.ai',
+                'model': os.environ.get('TRANSCRIPTION_MODEL', 'voxtral-mini-latest'),
+            }
+
+        elif connector_name == 'vibevoice':
+            base_url = os.environ.get('TRANSCRIPTION_BASE_URL', '')
+            if base_url:
+                base_url = base_url.split('#')[0].strip()
+
+            return {
+                'base_url': base_url,
+                'model': os.environ.get('TRANSCRIPTION_MODEL', 'microsoft/VibeVoice-ASR'),
+                'api_key': os.environ.get('TRANSCRIPTION_API_KEY', ''),
+            }
+
+        else:  # openai_whisper (default)
+            base_url = os.environ.get('TRANSCRIPTION_BASE_URL', '')
+            if base_url:
+                base_url = base_url.split('#')[0].strip()
+
+            # Support both TRANSCRIPTION_MODEL and legacy WHISPER_MODEL
+            # TRANSCRIPTION_MODEL takes priority for custom Whisper variants
+            model = os.environ.get('TRANSCRIPTION_MODEL', '') or os.environ.get('WHISPER_MODEL', 'whisper-1')
+
+            return {
+                'api_key': os.environ.get('TRANSCRIPTION_API_KEY', ''),
+                'base_url': base_url or None,
+                'model': model
+            }
+
+    def get_active_connector(self) -> BaseTranscriptionConnector:
+        """
+        Get the currently active connector.
+
+        Initializes from environment if not already initialized.
+
+        Returns:
+            The active connector
+        """
+        if not self._active_connector:
+            self.initialize_from_env()
+        return self._active_connector
+
+    def get_active_connector_name(self) -> str:
+        """Get the name of the currently active connector."""
+        if not self._active_connector:
+            self.initialize_from_env()
+        return self._connector_name
+
+    def reinitialize(self) -> BaseTranscriptionConnector:
+        """
+        Force re-initialization of the connector.
+
+        Useful when environment variables have changed.
+
+        Returns:
+            The newly initialized connector
+        """
+        self._active_connector = None
+        self._connector_name = ""
+        return self.initialize_from_env()
+
+
+# Global registry instance
+_registry: Optional[ConnectorRegistry] = None
+
+
+def get_registry() -> ConnectorRegistry:
+    """Get the global connector registry."""
+    global _registry
+    if _registry is None:
+        _registry = ConnectorRegistry()
+    return _registry
+
+
+# Convenience aliases
+connector_registry = get_registry()
+
+
+def transcribe(request: TranscriptionRequest) -> TranscriptionResponse:
+    """
+    Transcribe audio using the active connector.
+
+    This is a convenience function that uses the global registry.
+
+    Args:
+        request: The transcription request
+
+    Returns:
+        Transcription response
+    """
+    connector = get_registry().get_active_connector()
+    return connector.transcribe(request)
+
+
+def get_connector() -> BaseTranscriptionConnector:
+    """Get the active transcription connector."""
+    return get_registry().get_active_connector()
+
+
+def supports_diarization() -> bool:
+    """Check if the active connector supports diarization."""
+    return get_registry().get_active_connector().supports_diarization
diff --git a/src/services/transcription_tracking.py b/src/services/transcription_tracking.py
new file mode 100644
index 00000000..ca63f138
--- /dev/null
+++ b/src/services/transcription_tracking.py
@@ -0,0 +1,312 @@
+"""
+Transcription usage tracking service for monitoring audio transcription consumption and budget enforcement.
+"""
+
+import logging
+from datetime import date, datetime, timedelta
+from typing import Tuple, Optional, Dict, List
+
+from sqlalchemy import func, extract
+
+from src.database import db
+from src.models.transcription_usage import TranscriptionUsage
+from src.models.user import User
+
+logger = logging.getLogger(__name__)
+
+
+# Pricing configuration per connector/model (dollars per minute)
+TRANSCRIPTION_PRICING = {
+    'openai_whisper': {
+        'whisper-1': 0.006,  # $0.006/min
+        'default': 0.006,
+    },
+    'openai_transcribe': {
+        'gpt-4o-transcribe': 0.006,      # $0.006/min
+        'gpt-4o-mini-transcribe': 0.003,  # $0.003/min
+        'gpt-4o-mini-transcribe-2025-12-15': 0.003,
+        'gpt-4o-transcribe-diarize': 0.006,
+        'default': 0.006,
+    },
+    'asr_endpoint': {
+        'default': 0.0,  # Self-hosted = free
+    },
+}
+
+
+def get_transcription_cost_per_minute(connector_type: str, model_name: str = None) -> float:
+    """
+    Get the cost per minute for a given connector and model.
+
+    Args:
+        connector_type: The connector provider name
+        model_name: The specific model (optional)
+
+    Returns:
+        Cost per minute in dollars
+    """
+    connector_pricing = TRANSCRIPTION_PRICING.get(connector_type, {})
+
+    if model_name and model_name in connector_pricing:
+        return connector_pricing[model_name]
+
+    # Fall back to 'default' pricing for the connector
+    return connector_pricing.get('default', 0.0)
+
+
+class TranscriptionTracker:
+    """Service for recording and checking transcription usage."""
+
+    CONNECTOR_TYPES = [
+        'openai_whisper',
+        'openai_transcribe',
+        'asr_endpoint',
+    ]
+
+    def record_usage(
+        self,
+        user_id: int,
+        connector_type: str,
+        audio_duration_seconds: int,
+        model_name: str = None,
+        estimated_cost: float = None
+    ):
+        """
+        Record transcription usage - upserts into daily aggregate.
+
+        Args:
+            user_id: User ID who made the request
+            connector_type: Type of connector (openai_whisper, openai_transcribe, asr_endpoint)
+            audio_duration_seconds: Duration of audio transcribed in seconds
+            model_name: Name of the model used
+            estimated_cost: Pre-calculated cost (if None, calculated from pricing config)
+        """
+        try:
+            today = date.today()
+
+            # Calculate cost if not provided
+            if estimated_cost is None:
+                cost_per_minute = get_transcription_cost_per_minute(connector_type, model_name)
+                estimated_cost = (audio_duration_seconds / 60.0) * cost_per_minute
+
+            # Find or create today's record for this user/connector
+            usage = TranscriptionUsage.query.filter_by(
+                user_id=user_id,
+                date=today,
+                connector_type=connector_type
+            ).first()
+
+            if usage:
+                # Update existing record
+                usage.audio_duration_seconds += audio_duration_seconds
+                usage.estimated_cost += estimated_cost
+                usage.request_count += 1
+                if model_name:
+                    usage.model_name = model_name  # Update to latest model used
+            else:
+                # Create new record
+                usage = TranscriptionUsage(
+                    user_id=user_id,
+                    date=today,
+                    connector_type=connector_type,
+                    audio_duration_seconds=audio_duration_seconds,
+                    request_count=1,
+                    model_name=model_name,
+                    estimated_cost=estimated_cost or 0.0
+                )
+                db.session.add(usage)
+
+            db.session.commit()
+            logger.debug(f"Recorded {audio_duration_seconds}s transcription for user {user_id}, connector {connector_type}")
+            return usage
+
+        except Exception as e:
+            logger.error(f"Failed to record transcription usage: {e}")
+            db.session.rollback()
+            return None
+
+    def get_monthly_usage(self, user_id: int, year: int = None, month: int = None) -> int:
+        """Get total seconds transcribed by a user in a given month."""
+        if year is None:
+            year = date.today().year
+        if month is None:
+            month = date.today().month
+
+        result = db.session.query(func.sum(TranscriptionUsage.audio_duration_seconds)).filter(
+            TranscriptionUsage.user_id == user_id,
+            extract('year', TranscriptionUsage.date) == year,
+            extract('month', TranscriptionUsage.date) == month
+        ).scalar()
+
+        return result or 0
+
+    def get_monthly_cost(self, user_id: int, year: int = None, month: int = None) -> float:
+        """Get total estimated cost for a user in a given month."""
+        if year is None:
+            year = date.today().year
+        if month is None:
+            month = date.today().month
+
+        result = db.session.query(func.sum(TranscriptionUsage.estimated_cost)).filter(
+            TranscriptionUsage.user_id == user_id,
+            extract('year', TranscriptionUsage.date) == year,
+            extract('month', TranscriptionUsage.date) == month
+        ).scalar()
+
+        return result or 0.0
+
+    def check_budget(self, user_id: int) -> Tuple[bool, float, Optional[str]]:
+        """
+        Check if user is within transcription budget.
+
+        Returns:
+            (can_proceed, usage_percentage, message)
+            - can_proceed: False if hard cap (100%) reached
+            - usage_percentage: 0-100+
+            - message: Warning/error message if applicable
+        """
+        try:
+            user = db.session.get(User, user_id)
+            if not user or not user.monthly_transcription_budget:
+                return (True, 0, None)  # No budget = unlimited
+
+            current_usage = self.get_monthly_usage(user_id)
+            budget = user.monthly_transcription_budget
+            percentage = (current_usage / budget) * 100
+
+            if percentage >= 100:
+                minutes_used = current_usage // 60
+                minutes_budget = budget // 60
+                return (False, percentage,
+                        f"Monthly transcription budget exceeded ({minutes_used}/{minutes_budget} minutes). Contact admin for more time.")
+            elif percentage >= 80:
+                return (True, percentage,
+                        f"Warning: {percentage:.1f}% of monthly transcription budget used.")
+            else:
+                return (True, percentage, None)
+
+        except Exception as e:
+            logger.error(f"Failed to check transcription budget for user {user_id}: {e}")
+            # Fail open - allow the request if we can't check
+            return (True, 0, None)
+
+    def get_daily_stats(self, days: int = 30, user_id: int = None) -> List[Dict]:
+        """Get daily transcription usage for charts."""
+        start_date = date.today() - timedelta(days=days - 1)
+
+        query = db.session.query(
+            TranscriptionUsage.date,
+            TranscriptionUsage.connector_type,
+            func.sum(TranscriptionUsage.audio_duration_seconds).label('seconds'),
+            func.sum(TranscriptionUsage.estimated_cost).label('cost')
+        ).filter(TranscriptionUsage.date >= start_date)
+
+        if user_id:
+            query = query.filter(TranscriptionUsage.user_id == user_id)
+
+        results = query.group_by(TranscriptionUsage.date, TranscriptionUsage.connector_type).all()
+
+        # Organize by date
+        stats = {}
+        for r in results:
+            date_str = r.date.isoformat()
+            if date_str not in stats:
+                stats[date_str] = {'date': date_str, 'total_seconds': 0, 'total_minutes': 0, 'cost': 0.0, 'by_connector': {}}
+            stats[date_str]['total_seconds'] += r.seconds or 0
+            stats[date_str]['total_minutes'] = stats[date_str]['total_seconds'] // 60
+            stats[date_str]['cost'] += r.cost or 0
+            stats[date_str]['by_connector'][r.connector_type] = {
+                'seconds': r.seconds or 0,
+                'minutes': (r.seconds or 0) // 60
+            }
+
+        # Fill in missing dates with zeros
+        all_dates = []
+        current = start_date
+        while current <= date.today():
+            date_str = current.isoformat()
+            if date_str not in stats:
+                stats[date_str] = {'date': date_str, 'total_seconds': 0, 'total_minutes': 0, 'cost': 0.0, 'by_connector': {}}
+            all_dates.append(date_str)
+            current += timedelta(days=1)
+
+        return [stats[d] for d in sorted(all_dates)]
+
+    def get_monthly_stats(self, months: int = 12) -> List[Dict]:
+        """Get monthly transcription usage for charts."""
+        results = db.session.query(
+            extract('year', TranscriptionUsage.date).label('year'),
+            extract('month', TranscriptionUsage.date).label('month'),
+            func.sum(TranscriptionUsage.audio_duration_seconds).label('seconds'),
+            func.sum(TranscriptionUsage.estimated_cost).label('cost')
+        ).group_by('year', 'month').order_by('year', 'month').all()
+
+        # Get last N months
+        monthly_data = [
+            {
+                'year': int(r.year),
+                'month': int(r.month),
+                'seconds': r.seconds or 0,
+                'minutes': (r.seconds or 0) // 60,
+                'cost': r.cost or 0
+            }
+            for r in results
+        ]
+
+        return monthly_data[-months:] if len(monthly_data) > months else monthly_data
+
+    def get_user_stats(self) -> List[Dict]:
+        """Get per-user transcription usage breakdown for current month."""
+        today = date.today()
+
+        results = db.session.query(
+            User.id,
+            User.username,
+            User.monthly_transcription_budget,
+            func.sum(TranscriptionUsage.audio_duration_seconds).label('usage'),
+            func.sum(TranscriptionUsage.estimated_cost).label('cost')
+        ).outerjoin(
+            TranscriptionUsage,
+            (User.id == TranscriptionUsage.user_id) &
+            (extract('year', TranscriptionUsage.date) == today.year) &
+            (extract('month', TranscriptionUsage.date) == today.month)
+        ).group_by(User.id).all()
+
+        return [
+            {
+                'user_id': r.id,
+                'username': r.username,
+                'monthly_budget_seconds': r.monthly_transcription_budget,
+                'monthly_budget_minutes': (r.monthly_transcription_budget // 60) if r.monthly_transcription_budget else None,
+                'current_usage_seconds': r.usage or 0,
+                'current_usage_minutes': (r.usage or 0) // 60,
+                'cost': r.cost or 0,
+                'percentage': ((r.usage or 0) / r.monthly_transcription_budget * 100)
+                              if r.monthly_transcription_budget else 0
+            }
+            for r in results
+        ]
+
+    def get_today_usage(self, user_id: int = None) -> Dict:
+        """Get today's transcription usage."""
+        today = date.today()
+
+        query = db.session.query(
+            func.sum(TranscriptionUsage.audio_duration_seconds).label('seconds'),
+            func.sum(TranscriptionUsage.estimated_cost).label('cost')
+        ).filter(TranscriptionUsage.date == today)
+
+        if user_id:
+            query = query.filter(TranscriptionUsage.user_id == user_id)
+
+        result = query.first()
+
+        return {
+            'seconds': result.seconds or 0,
+            'minutes': (result.seconds or 0) // 60,
+            'cost': result.cost or 0
+        }
+
+
+# Singleton instance
+transcription_tracker = TranscriptionTracker()
diff --git a/src/tasks/__init__.py b/src/tasks/__init__.py
new file mode 100644
index 00000000..408c7735
--- /dev/null
+++ b/src/tasks/__init__.py
@@ -0,0 +1,30 @@
+"""
+Background task functions for asynchronous processing.
+
+Note: Legacy functions (transcribe_audio_asr, transcribe_single_file, transcribe_with_chunking)
+were removed. All transcription now uses the connector architecture via transcribe_audio_task.
+"""
+
+from .processing import (
+    generate_title_task,
+    generate_summary_only_task,
+    extract_events_from_transcript,
+    extract_audio_from_video,
+    compress_lossless_audio,
+    transcribe_audio_task,
+    transcribe_with_connector,
+    transcribe_chunks_with_connector,
+    transcribe_incognito,
+)
+
+__all__ = [
+    'generate_title_task',
+    'generate_summary_only_task',
+    'extract_events_from_transcript',
+    'extract_audio_from_video',
+    'compress_lossless_audio',
+    'transcribe_audio_task',
+    'transcribe_with_connector',
+    'transcribe_chunks_with_connector',
+    'transcribe_incognito',
+]
diff --git a/src/tasks/processing.py b/src/tasks/processing.py
new file mode 100644
index 00000000..5d4947c6
--- /dev/null
+++ b/src/tasks/processing.py
@@ -0,0 +1,2331 @@
+"""
+Background task functions for audio processing, transcription, and summarization.
+
+These functions handle asynchronous processing tasks:
+- Audio transcription (Whisper API and custom ASR endpoints)
+- Title and summary generation
+- Event extraction from transcripts
+- Audio/video format conversion
+"""
+
+import os
+import re
+import json
+import time
+import mimetypes
+import tempfile
+import subprocess
+import httpx
+from datetime import datetime
+from flask import current_app
+from openai import OpenAI
+
+from src.database import db
+from src.models import Recording, Tag, Event, TranscriptChunk, SystemSetting, GroupMembership, RecordingTag, InternalShare, SharedRecordingState, User, NamingTemplate
+from src.services.embeddings import process_recording_chunks
+from src.services.llm import is_using_openai_api, call_llm_completion, format_api_error_message, TEXT_MODEL_NAME, client, http_client_no_proxy
+from src.utils import extract_json_object, safe_json_loads
+from src.utils.ffprobe import get_codec_info, is_video_file, is_lossless_audio, FFProbeError
+from src.utils.ffmpeg_utils import convert_to_mp3, extract_audio_from_video as ffmpeg_extract_audio, compress_audio, FFmpegError, FFmpegNotFoundError
+from src.utils.audio_conversion import convert_if_needed, ConversionResult
+from src.utils.error_formatting import format_error_for_storage
+from src.config.app_config import AUDIO_COMPRESS_UPLOADS, AUDIO_CODEC, AUDIO_BITRATE, VIDEO_PASSTHROUGH_ASR
+from src.audio_chunking import AudioChunkingService, ChunkProcessingError, ChunkingNotSupportedError
+from src.config.app_config import (
+    ASR_DIARIZE, ASR_BASE_URL, ASR_RETURN_SPEAKER_EMBEDDINGS,
+    transcription_api_key, transcription_base_url, chunking_service, ENABLE_CHUNKING
+)
+from src.file_exporter import export_recording, ENABLE_AUTO_EXPORT
+from src.services.transcription_tracking import transcription_tracker
+
+# Configuration for internal sharing
+ENABLE_INTERNAL_SHARING = os.environ.get('ENABLE_INTERNAL_SHARING', 'false').lower() == 'true'
+
+# Video retention - when enabled, video files keep their video stream for playback
+VIDEO_RETENTION = os.environ.get('VIDEO_RETENTION', 'false').lower() == 'true'
+
+
+def apply_team_tag_auto_shares(recording_id):
+    """
+    Apply auto-shares for all group tags on a recording after processing completes.
+
+    This function should be called after a recording status changes to COMPLETED.
+    It creates InternalShare records for team members based on group tag settings.
+
+    Args:
+        recording_id: ID of the recording to apply auto-shares for
+    """
+    if not ENABLE_INTERNAL_SHARING:
+        return
+
+    recording = db.session.get(Recording, recording_id)
+    if not recording:
+        return
+
+    # Get all group tags on this recording with auto-share enabled
+    group_tags = db.session.query(Tag).join(
+        RecordingTag, RecordingTag.tag_id == Tag.id
+    ).filter(
+        RecordingTag.recording_id == recording_id,
+        Tag.group_id.isnot(None),
+        db.or_(Tag.auto_share_on_apply == True, Tag.share_with_group_lead == True)
+    ).all()
+
+    if not group_tags:
+        return
+
+    shares_created = 0
+
+    for tag in group_tags:
+        # Determine who to share with
+        if tag.auto_share_on_apply:
+            group_members = GroupMembership.query.filter_by(group_id=tag.group_id).all()
+        elif tag.share_with_group_lead:
+            group_members = GroupMembership.query.filter_by(group_id=tag.group_id, role='admin').all()
+        else:
+            continue
+
+        for membership in group_members:
+            # Skip the recording owner
+            if membership.user_id == recording.user_id:
+                continue
+
+            # Check if already shared
+            existing_share = InternalShare.query.filter_by(
+                recording_id=recording_id,
+                shared_with_user_id=membership.user_id
+            ).first()
+
+            if not existing_share:
+                # Create internal share with correct permissions
+                # Group admins get edit permission, regular members get read-only
+                share = InternalShare(
+                    recording_id=recording_id,
+                    owner_id=recording.user_id,
+                    shared_with_user_id=membership.user_id,
+                    can_edit=(membership.role == 'admin'),
+                    can_reshare=False,
+                    source_type='group_tag',
+                    source_tag_id=tag.id
+                )
+                db.session.add(share)
+
+                # Create SharedRecordingState with default values for the recipient
+                state = SharedRecordingState(
+                    recording_id=recording_id,
+                    user_id=membership.user_id,
+                    is_inbox=True,  # New shares appear in inbox by default
+                    is_highlighted=False  # Not favorited by default
+                )
+                db.session.add(state)
+
+                shares_created += 1
+                current_app.logger.info(f"Auto-shared recording {recording_id} with user {membership.user_id} (role={membership.role}) via group tag '{tag.name}'")
+
+    if shares_created > 0:
+        db.session.commit()
+        current_app.logger.info(f"Created {shares_created} auto-shares for recording {recording_id} after processing completed")
+
+
+def format_transcription_for_llm(transcription_text):
+    """
+    Formats transcription for LLM. If it's our simplified JSON, convert it to plain text.
+    Otherwise, return as is.
+    """
+    try:
+        transcription_data = json.loads(transcription_text)
+        if isinstance(transcription_data, list):
+            # It's our simplified JSON format
+            formatted_lines = []
+            for segment in transcription_data:
+                speaker = segment.get('speaker', 'Unknown Speaker')
+                sentence = segment.get('sentence', '')
+                formatted_lines.append(f"[{speaker}]: {sentence}")
+            return "\n".join(formatted_lines)
+    except (json.JSONDecodeError, TypeError):
+        # Not a JSON, or not the format we expect, so return as is.
+        pass
+    return transcription_text
+
+
+def clean_llm_response(text):
+    """
+    Clean LLM responses by removing thinking tags and excessive whitespace.
+    This handles responses from reasoning models that include <think> tags.
+    """
+    if not text:
+        return ""
+
+    # Remove thinking tags and their content
+    # Handle both <think> and <thinking> tags with various closing formats
+    cleaned = re.sub(r'<think(?:ing)?>.*?</think(?:ing)?>', '', text, flags=re.DOTALL | re.IGNORECASE)
+
+    # Also handle unclosed thinking tags (in case the model doesn't close them)
+    cleaned = re.sub(r'<think(?:ing)?>.*$', '', cleaned, flags=re.DOTALL | re.IGNORECASE)
+
+    # Remove any remaining XML-like tags that might be related to thinking
+    # but preserve markdown formatting
+    cleaned = re.sub(r'<(?!/?(?:code|pre|blockquote|p|br|hr|ul|ol|li|h[1-6]|em|strong|b|i|a|img)(?:\s|>|/))[^>]+>', '', cleaned)
+
+    # Clean up excessive whitespace while preserving intentional formatting
+    # Handle lines individually to preserve Markdown hard line breaks (two spaces at end)
+    lines = cleaned.split('\n')
+    cleaned_lines = []
+    
+    for line in lines:
+        # If a line consists only of whitespace (e.g., after tag removal),
+        # make it completely empty. This is necessary for the \n{3,} regex to work later.
+        if not line.strip():
+            cleaned_lines.append("")
+        else:
+            # Preserve lines containing text exactly as they are
+            # This keeps trailing spaces needed for Markdown hard line breaks intact
+            cleaned_lines.append(line)
+
+    # Join lines and collapse 3+ consecutive newlines into exactly 2 (one blank line)
+    cleaned = '\n'.join(cleaned_lines)
+    cleaned = re.sub(r'\n{3,}', '\n\n', cleaned)
+
+    # Final strip to remove leading/trailing whitespace
+    return cleaned.strip()
+
+# Configuration from environment
+# Note: Legacy ASR paths (USE_ASR_ENDPOINT, transcribe_audio_asr, etc.) were removed.
+# All transcription now uses the connector architecture via transcribe_with_connector().
+ENABLE_INQUIRE_MODE = os.environ.get('ENABLE_INQUIRE_MODE', 'false').lower() == 'true'
+
+# chunking_service, ENABLE_CHUNKING, transcription_api_key, and transcription_base_url
+# are imported from src.config.app_config
+
+# Note: OpenAI clients are created inside each transcription function as needed,
+# not at module level (matching original pre-refactor behavior)
+
+
+def generate_title_task(app_context, recording_id, will_auto_summarize=False):
+    """Generates only a title for a recording based on transcription.
+
+    Args:
+        app_context: Flask app context
+        recording_id: ID of the recording
+        will_auto_summarize: If True, don't set status to COMPLETED (summary task will do it)
+    """
+    with app_context:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            current_app.logger.error(f"Error: Recording {recording_id} not found for title generation.")
+            return
+
+        # Skip title generation if user provided a non-placeholder title
+        placeholder_patterns = [
+            f"Recording - {recording.original_filename}",
+            f"Auto-processed - {recording.original_filename}",
+        ]
+        if recording.title and recording.title not in placeholder_patterns:
+            current_app.logger.info(f"Recording {recording_id} has user-provided title '{recording.title}', skipping AI title generation")
+            if not will_auto_summarize:
+                recording.status = 'COMPLETED'
+                recording.completed_at = datetime.utcnow()
+            db.session.commit()
+            return
+
+        # Resolve naming template: first tag with template → user default → None
+        naming_template = None
+        for tag in recording.tags:
+            if tag.naming_template_id:
+                naming_template = tag.naming_template
+                current_app.logger.info(f"Using naming template '{naming_template.name}' from tag '{tag.name}' for recording {recording_id}")
+                break
+
+        if not naming_template and recording.owner and recording.owner.default_naming_template_id:
+            naming_template = recording.owner.default_naming_template
+            if naming_template:
+                current_app.logger.info(f"Using user's default naming template '{naming_template.name}' for recording {recording_id}")
+
+        # Check if we need to generate AI title
+        needs_ai_title = naming_template is None or naming_template.needs_ai_title()
+
+        # Early exit conditions
+        if not needs_ai_title:
+            # Template doesn't need AI - we can skip LLM call entirely
+            current_app.logger.info(f"Naming template doesn't require AI title for recording {recording_id}, skipping LLM call")
+            ai_title = None
+        elif client is None:
+            current_app.logger.warning(f"Skipping AI title generation for {recording_id}: OpenRouter client not configured.")
+            ai_title = None
+        elif not recording.transcription or len(recording.transcription.strip()) < 10:
+            current_app.logger.warning(f"Transcription for recording {recording_id} is too short or empty. Skipping AI title generation.")
+            ai_title = None
+        else:
+            # Generate AI title via LLM
+            ai_title = _generate_ai_title(recording)
+
+        # Apply naming template if we have one
+        final_title = None
+        if naming_template:
+            final_title = naming_template.apply(
+                original_filename=recording.original_filename,
+                meeting_date=recording.meeting_date,
+                ai_title=ai_title
+            )
+            if final_title:
+                current_app.logger.info(f"Applied naming template for recording {recording_id}: '{final_title}'")
+
+        # Fallback chain: template result → AI title → filename
+        if not final_title:
+            if ai_title:
+                final_title = ai_title
+            elif recording.original_filename:
+                # Use filename without extension as last resort
+                import os
+                final_title = os.path.splitext(recording.original_filename)[0]
+                current_app.logger.info(f"Using filename as title for recording {recording_id}: '{final_title}'")
+
+        if final_title:
+            recording.title = final_title
+            current_app.logger.info(f"Title set for recording {recording_id}: {final_title}")
+        else:
+            current_app.logger.warning(f"Could not generate title for recording {recording_id}")
+
+        # Only set status to COMPLETED if auto-summarization won't happen next
+        # If auto-summarization is enabled, the summary task will set COMPLETED
+        if not will_auto_summarize:
+            recording.status = 'COMPLETED'
+            recording.completed_at = datetime.utcnow()
+            db.session.commit()
+            current_app.logger.info(f"Title generation complete, status set to COMPLETED for recording {recording_id}")
+
+            # Process chunks for semantic search after completion (if inquire mode is enabled)
+            if ENABLE_INQUIRE_MODE:
+                try:
+                    process_recording_chunks(recording_id)
+                except Exception as e:
+                    current_app.logger.error(f"Error processing chunks for completed recording {recording_id}: {e}")
+        else:
+            # Just commit the title without changing status
+            db.session.commit()
+            current_app.logger.info(f"Title generation complete, leaving status unchanged (auto-summarization will follow) for recording {recording_id}")
+
+
+def _generate_ai_title(recording):
+    """Generate an AI title for a recording using LLM.
+
+    Args:
+        recording: Recording model instance
+
+    Returns:
+        Generated title string, or None if generation fails
+    """
+    # Get configurable transcript length limit and format transcription for LLM.
+    # Format first, then truncate — slicing the raw JSON can cut a unicode escape
+    # mid-sequence, which makes json.loads() fail and leaves the literal `\uXXXX`
+    # escapes in the prompt (issue #260).
+    transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+    formatted_transcription = format_transcription_for_llm(recording.transcription)
+    if transcript_limit == -1:
+        transcript_text = formatted_transcription
+    else:
+        transcript_text = formatted_transcription[:transcript_limit]
+
+    # Get user language preference
+    user_output_language = None
+    if recording.owner:
+        user_output_language = recording.owner.output_language
+
+    language_directive = f"Please provide the title in {user_output_language}." if user_output_language else ""
+
+    prompt_text = f"""Create a short title for this conversation:
+
+{transcript_text}
+
+Requirements:
+- Maximum 8 words
+- No phrases like "Discussion about" or "Meeting on"
+- Just the main topic
+
+{language_directive}
+
+Title:"""
+
+    system_message_content = "You are an AI assistant that generates concise titles for audio transcriptions. Respond only with the title."
+    if user_output_language:
+        system_message_content += f" Ensure your response is in {user_output_language}."
+
+    try:
+        completion = call_llm_completion(
+            messages=[
+                {"role": "system", "content": system_message_content},
+                {"role": "user", "content": prompt_text}
+            ],
+            temperature=0.7,
+            # TITLE_MAX_TOKENS lets reasoning-model users (e.g. Kimi K2) raise
+            # the budget so the model has room for hidden thinking tokens
+            # before producing the title itself.
+            max_tokens=int(os.environ.get("TITLE_MAX_TOKENS", "5000")),
+            user_id=recording.user_id,
+            operation_type='title_generation'
+        )
+
+        raw_response = completion.choices[0].message.content
+        reasoning = getattr(completion.choices[0].message, 'reasoning', None)
+
+        # Use reasoning content if main content is empty (fallback for reasoning models)
+        if not raw_response and reasoning:
+            current_app.logger.info(f"Title generation for recording {recording.id}: Using reasoning field as fallback")
+            # Try to extract a title from the reasoning field
+            lines = reasoning.strip().split('\n')
+            # Look for the last line that might be the title
+            for line in reversed(lines):
+                line = line.strip()
+                if line and not line.startswith('I') and len(line.split()) <= 8:
+                    raw_response = line
+                    break
+
+        title = clean_llm_response(raw_response) if raw_response else None
+
+        if title:
+            current_app.logger.info(f"AI title generated for recording {recording.id}: {title}")
+        else:
+            current_app.logger.warning(f"Empty AI title generated for recording {recording.id}")
+
+        return title
+
+    except Exception as e:
+        current_app.logger.error(f"Error generating AI title for recording {recording.id}: {str(e)}")
+        current_app.logger.error(f"Exception details:", exc_info=True)
+        return None
+
+
+def generate_summary_only_task(app_context, recording_id, custom_prompt_override=None, custom_prompt_append=False, user_id=None):
+    """Generates only a summary for a recording (no title, no JSON response).
+
+    Args:
+        app_context: Flask app context
+        recording_id: ID of the recording
+        custom_prompt_override: Optional user-supplied summarization instructions.
+            By default this REPLACES the resolved default prompt (tag/folder/user/admin).
+            When ``custom_prompt_append`` is True, it is appended to the resolved
+            default as additional context instead.
+        custom_prompt_append: When True, append ``custom_prompt_override`` to the
+            resolved default prompt rather than replacing it.
+        user_id: Optional user ID to filter tag visibility (defaults to recording owner)
+    """
+    with app_context:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            current_app.logger.error(f"Error: Recording {recording_id} not found for summary generation.")
+            return
+
+        if client is None:
+            current_app.logger.warning(f"Skipping summary generation for {recording_id}: OpenRouter client not configured.")
+            recording.summary = "[Summary skipped: OpenRouter client not configured]"
+            db.session.commit()
+            return
+
+        recording.status = 'SUMMARIZING'
+        summarization_start_time = time.time()
+        db.session.commit()
+
+        current_app.logger.info(f"Requesting summary from OpenRouter for recording {recording_id} using model {TEXT_MODEL_NAME}...")
+
+        if not recording.transcription or len(recording.transcription.strip()) < 10:
+            current_app.logger.warning(f"Transcription for recording {recording_id} is too short or empty. Skipping summarization.")
+            recording.summary = "[Summary skipped due to short transcription]"
+            recording.status = 'COMPLETED'
+            db.session.commit()
+            return
+
+        # Get user preferences and tag custom prompts
+        user_summary_prompt = None
+        user_output_language = None
+        tag_custom_prompt = None
+
+        # Determine which user's perspective to use for tag visibility
+        # If user_id is provided (e.g., from reprocess), use that user
+        # Otherwise default to the recording owner
+        viewer_user = None
+        if user_id:
+            viewer_user = db.session.get(User, user_id)
+            if viewer_user:
+                current_app.logger.info(f"Using user {viewer_user.username} (ID: {user_id}) for tag visibility filtering")
+            else:
+                current_app.logger.warning(f"User ID {user_id} not found, falling back to recording owner")
+                viewer_user = recording.owner
+        else:
+            viewer_user = recording.owner
+            if viewer_user:
+                current_app.logger.info(f"Using recording owner {viewer_user.username} for tag visibility filtering")
+
+        # Collect custom prompts from tags visible to the viewer user
+        tag_custom_prompts = []
+        if viewer_user:
+            visible_tags = recording.get_visible_tags(viewer_user)
+            if visible_tags:
+                current_app.logger.info(f"Found {len(visible_tags)} visible tags for user {viewer_user.username} on recording {recording_id}")
+                # Tags are ordered by the order they were added to this recording
+                for tag in visible_tags:
+                    if tag.custom_prompt and tag.custom_prompt.strip():
+                        tag_custom_prompts.append({
+                            'name': tag.name,
+                            'prompt': tag.custom_prompt.strip()
+                        })
+                        current_app.logger.info(f"Found custom prompt from tag '{tag.name}' for recording {recording_id}")
+        else:
+            current_app.logger.warning(f"No viewer user available for tag filtering on recording {recording_id}")
+
+        # Create merged prompt if we have multiple tag prompts
+        if tag_custom_prompts:
+            if len(tag_custom_prompts) == 1:
+                tag_custom_prompt = tag_custom_prompts[0]['prompt']
+                current_app.logger.info(f"Using single custom prompt from tag '{tag_custom_prompts[0]['name']}' for recording {recording_id}")
+            else:
+                # Merge multiple prompts seamlessly as unified instructions
+                merged_parts = []
+                for tag_prompt in tag_custom_prompts:
+                    merged_parts.append(tag_prompt['prompt'])
+                tag_custom_prompt = "\n\n".join(merged_parts)
+                tag_names = [tp['name'] for tp in tag_custom_prompts]
+                current_app.logger.info(f"Combined custom prompts from {len(tag_custom_prompts)} tags in order added ({', '.join(tag_names)}) for recording {recording_id}")
+        else:
+            tag_custom_prompt = None
+
+        # Get folder custom prompt (if recording has a folder)
+        # Folder prompt has lower priority than tag prompts (tags override folders)
+        folder_custom_prompt = None
+        if recording.folder and recording.folder.custom_prompt and recording.folder.custom_prompt.strip():
+            folder_custom_prompt = recording.folder.custom_prompt.strip()
+            current_app.logger.info(f"Found custom prompt from folder '{recording.folder.name}' for recording {recording_id}")
+
+        if recording.owner:
+            user_summary_prompt = recording.owner.summary_prompt
+            user_output_language = recording.owner.output_language
+
+        # Format transcription for LLM (convert JSON to clean text format like clipboard copy)
+        formatted_transcription = format_transcription_for_llm(recording.transcription)
+
+        # Get configurable transcript length limit
+        transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+        if transcript_limit == -1:
+            transcript_text = formatted_transcription
+        else:
+            transcript_text = formatted_transcription[:transcript_limit]
+
+        language_directive = f"IMPORTANT: You MUST provide the summary in {user_output_language}. The entire response must be in {user_output_language}." if user_output_language else ""
+
+        # Determine which summarization instructions to use.
+        # Priority order: custom_prompt_override > tag custom prompt > folder custom prompt > user summary prompt > admin default prompt > hardcoded fallback.
+        # When custom_prompt_append is True the override is appended to the resolved default rather than replacing it.
+        summarization_instructions = ""
+        if custom_prompt_override and not custom_prompt_append:
+            current_app.logger.info(f"Using custom prompt override for recording {recording_id} (length: {len(custom_prompt_override)})")
+            summarization_instructions = custom_prompt_override
+        elif tag_custom_prompt:
+            current_app.logger.info(f"Using tag custom prompt for recording {recording_id}")
+            summarization_instructions = tag_custom_prompt
+        elif folder_custom_prompt:
+            current_app.logger.info(f"Using folder custom prompt for recording {recording_id}")
+            summarization_instructions = folder_custom_prompt
+        elif user_summary_prompt:
+            current_app.logger.info(f"Using user custom prompt for recording {recording_id}")
+            summarization_instructions = user_summary_prompt
+        else:
+            # Get admin default prompt from system settings
+            admin_default_prompt = SystemSetting.get_setting('admin_default_summary_prompt', None)
+            if admin_default_prompt:
+                current_app.logger.info(f"Using admin default prompt for recording {recording_id}")
+                summarization_instructions = admin_default_prompt
+            else:
+                # Fallback to hardcoded default if admin hasn't set one
+                summarization_instructions = """Generate a comprehensive summary that includes the following sections:
+- **Key Issues Discussed**: A bulleted list of the main topics
+- **Key Decisions Made**: A bulleted list of any decisions reached
+- **Action Items**: A bulleted list of tasks assigned, including who is responsible if mentioned"""
+                current_app.logger.info(f"Using hardcoded default prompt for recording {recording_id}")
+
+        # Append the user's per-run additions on top of the resolved default
+        # (issue / discussion #253). This is how a user supplies a meeting agenda
+        # or one-off context without rewriting their saved summary prompt.
+        # The append must happen BEFORE variable substitution so the appended
+        # text's own placeholders get substituted along with the resolved
+        # prompt's placeholders.
+        if custom_prompt_override and custom_prompt_append:
+            current_app.logger.info(
+                f"Appending custom prompt to resolved default for recording {recording_id} "
+                f"(append length: {len(custom_prompt_override)})"
+            )
+            summarization_instructions = (
+                f"{summarization_instructions}\n\n"
+                f"Additional context for this recording:\n{custom_prompt_override}"
+            )
+
+        # Substitute {{variable}} placeholders in the final composed prompt
+        # with the values the user supplied at upload time (or via a later
+        # edit). Running this AFTER the append step lets the appended text
+        # use the same variables as the resolved prompt.
+        from src.utils.prompt_variables import (
+            extract_template_variables,
+            substitute_template_variables,
+        )
+        prompt_variables = recording.prompt_variables or {}
+        used_variables = extract_template_variables(summarization_instructions)
+        if used_variables:
+            missing = [v for v in used_variables if not prompt_variables.get(v)]
+            if missing:
+                current_app.logger.warning(
+                    f"Recording {recording_id} prompt references {len(used_variables)} "
+                    f"variable(s); {len(missing)} have no value: {missing}. "
+                    f"Empty strings will be substituted."
+                )
+            summarization_instructions = substitute_template_variables(
+                summarization_instructions, prompt_variables
+            )
+
+        # Build context information
+        current_date = datetime.now().strftime("%B %d, %Y")
+        context_parts = []
+        context_parts.append(f"Current date: {current_date}")
+
+        # Add recording metadata to context
+        if recording.meeting_date:
+            context_parts.append(f"Recording date: {recording.meeting_date.strftime('%B %d, %Y')}")
+        if recording.title:
+            context_parts.append(f"Recording title: {recording.title}")
+
+        # Add folder information if recording is in a folder
+        if recording.folder:
+            context_parts.append(f"Folder: {recording.folder.name}")
+
+        # Add selected tags information (only visible tags)
+        if viewer_user:
+            visible_tags = recording.get_visible_tags(viewer_user)
+            if visible_tags:
+                tag_names = [tag.name for tag in visible_tags]
+                context_parts.append(f"Tags applied to this transcript by the user: {', '.join(tag_names)}")
+
+        # Add user profile information if available
+        if recording.owner:
+            user_context_parts = []
+            if recording.owner.name:
+                user_context_parts.append(f"Name: {recording.owner.name}")
+            if recording.owner.job_title:
+                user_context_parts.append(f"Job title: {recording.owner.job_title}")
+            if recording.owner.company:
+                user_context_parts.append(f"Company: {recording.owner.company}")
+
+            if user_context_parts:
+                context_parts.append(f"Information about the user: {', '.join(user_context_parts)}")
+
+        context_section = "Context:\n" + "\n".join(f"- {part}" for part in context_parts)
+
+        # Build SYSTEM message: Initial instructions + Context + Language
+        system_message_content = "You are an AI assistant that generates comprehensive summaries for meeting transcripts. Respond only with the summary in Markdown format. Do NOT use markdown code blocks (```markdown). Provide raw markdown content directly."
+        system_message_content += f"\n\n{context_section}"
+        if user_output_language:
+            system_message_content += f"\n\nLanguage Requirement: You MUST generate the entire summary in {user_output_language}. This is mandatory."
+
+        # Build USER message: Transcription + Summarization Instructions + Language Directive
+        prompt_text = f"""Transcription:
+\"\"\"
+{transcript_text}
+\"\"\"
+
+Summarization Instructions:
+{summarization_instructions}
+
+{language_directive}"""
+
+        # Debug logging: Log the complete prompt being sent to the LLM
+        current_app.logger.info(f"Sending summarization prompt to LLM (length: {len(prompt_text)} chars). Set LOG_LEVEL=DEBUG to see full prompt details.")
+        current_app.logger.debug(f"=== SUMMARIZATION DEBUG for recording {recording_id} ===")
+        current_app.logger.debug(f"System message: {system_message_content}")
+        current_app.logger.debug(f"User prompt (length: {len(prompt_text)} chars):\n{prompt_text}")
+        current_app.logger.debug(f"=== END SUMMARIZATION DEBUG for recording {recording_id} ===")
+
+        try:
+            completion = call_llm_completion(
+                messages=[
+                    {"role": "system", "content": system_message_content},
+                    {"role": "user", "content": prompt_text}
+                ],
+                temperature=0.5,
+                max_tokens=int(os.environ.get("SUMMARY_MAX_TOKENS", "3000")),
+                user_id=recording.user_id,
+                operation_type='summarization'
+            )
+
+            raw_response = completion.choices[0].message.content
+            current_app.logger.info(f"Raw LLM response for recording {recording_id}: '{raw_response}'")
+
+            summary = clean_llm_response(raw_response) if raw_response else ""
+            current_app.logger.info(f"Processed summary length for recording {recording_id}: {len(summary)} characters")
+
+            if summary:
+                recording.summary = summary
+                db.session.commit()
+                current_app.logger.info(f"Summary generated successfully for recording {recording_id}")
+
+                # Extract events if enabled for this user BEFORE marking as completed
+                if recording.owner and recording.owner.extract_events:
+                    extract_events_from_transcript(recording_id, formatted_transcription, summary)
+
+                # Mark as completed AFTER event extraction
+                recording.status = 'COMPLETED'
+                recording.completed_at = datetime.utcnow()
+                # Calculate and save summarization duration
+                summarization_end_time = time.time()
+                recording.summarization_duration_seconds = int(summarization_end_time - summarization_start_time)
+                db.session.commit()
+                current_app.logger.info(f"Summarization completed for recording {recording_id} in {recording.summarization_duration_seconds}s.")
+
+                # Apply auto-shares for group tags after processing completes
+                apply_team_tag_auto_shares(recording_id)
+
+                # Export to file if auto-export is enabled
+                if ENABLE_AUTO_EXPORT:
+                    export_recording(recording_id)
+            else:
+                current_app.logger.warning(f"Empty summary generated for recording {recording_id}")
+                recording.summary = "[Summary not generated]"
+                recording.status = 'COMPLETED'
+                # Calculate and save summarization duration even for empty summary
+                summarization_end_time = time.time()
+                recording.summarization_duration_seconds = int(summarization_end_time - summarization_start_time)
+                db.session.commit()
+
+                # Apply auto-shares for group tags after processing completes
+                apply_team_tag_auto_shares(recording_id)
+
+                # Export to file if auto-export is enabled (even with empty summary, transcription may be useful)
+                if ENABLE_AUTO_EXPORT:
+                    export_recording(recording_id)
+
+        except Exception as e:
+            error_msg = format_api_error_message(str(e))
+            current_app.logger.error(f"Error generating summary for recording {recording_id}: {str(e)}")
+            recording.summary = error_msg
+            recording.status = 'FAILED'
+            db.session.commit()
+
+
+def extract_events_from_transcript(recording_id, transcript_text, summary_text):
+    """Extract calendar events from transcript using LLM.
+
+    Args:
+        recording_id: ID of the recording
+        transcript_text: The formatted transcript text
+        summary_text: The generated summary text
+    """
+    try:
+        recording = db.session.get(Recording, recording_id)
+        if not recording or not recording.owner or not recording.owner.extract_events:
+            return  # Event extraction not enabled for this user
+
+        current_app.logger.info(f"Extracting events for recording {recording_id}")
+
+        # Delete existing events for this recording before extracting new ones
+        existing_events = Event.query.filter_by(recording_id=recording_id).all()
+        if existing_events:
+            current_app.logger.info(f"Clearing {len(existing_events)} existing events for recording {recording_id}")
+            for event in existing_events:
+                db.session.delete(event)
+            db.session.commit()
+
+        # Get user language preference
+        user_output_language = None
+        if recording.owner:
+            user_output_language = recording.owner.output_language
+
+        # Build comprehensive context information
+        current_date = datetime.now()
+        context_parts = []
+
+        # CRITICAL: Determine the reference date for relative date calculations
+        reference_date = None
+        reference_date_source = ""
+
+        if recording.meeting_date:
+            # Prefer meeting date if available
+            reference_date = recording.meeting_date
+            reference_date_source = "Meeting Date"
+            context_parts.append(f"**MEETING DATE (use this for relative date calculations): {recording.meeting_date.strftime('%A, %B %d, %Y')}**")
+        elif recording.created_at:
+            # Fall back to upload date
+            reference_date = recording.created_at.date()
+            reference_date_source = "Upload Date (no meeting date available)"
+            context_parts.append(f"**REFERENCE DATE (use this for relative date calculations): {recording.created_at.strftime('%A, %B %d, %Y')}**")
+
+        context_parts.append(f"Today's actual date: {current_date.strftime('%A, %B %d, %Y')}")
+        context_parts.append(f"Current time: {current_date.strftime('%I:%M %p')}")
+
+        # Add additional recording context
+        if recording.created_at:
+            context_parts.append(f"Recording uploaded on: {recording.created_at.strftime('%B %d, %Y at %I:%M %p')}")
+        if recording.meeting_date and reference_date_source == "Meeting Date":
+            # Calculate days between meeting and today for context
+            # Ensure both sides are date objects (meeting_date might be datetime or date)
+            meeting_date_obj = recording.meeting_date.date() if isinstance(recording.meeting_date, datetime) else recording.meeting_date
+            days_since = (current_date.date() - meeting_date_obj).days
+            if days_since == 0:
+                context_parts.append("This meeting happened today")
+            elif days_since == 1:
+                context_parts.append("This meeting happened yesterday")
+            else:
+                context_parts.append(f"This meeting happened {days_since} days ago")
+
+        # Add user context for better understanding
+        if recording.owner:
+            user_context = []
+            if recording.owner.name:
+                user_context.append(f"User's name: {recording.owner.name}")
+            if recording.owner.job_title:
+                user_context.append(f"Job title: {recording.owner.job_title}")
+            if recording.owner.company:
+                user_context.append(f"Company: {recording.owner.company}")
+            if user_context:
+                context_parts.append("User information: " + ", ".join(user_context))
+
+        # Add participants if available
+        if recording.participants:
+            context_parts.append(f"Participants in the meeting: {recording.participants}")
+
+        context_section = "\n".join(context_parts)
+
+        # Add language directive if user has a language preference
+        language_directive = ""
+        if user_output_language:
+            language_directive = f"\n\nLANGUAGE REQUIREMENT:\n**CRITICAL**: You MUST generate ALL event titles and descriptions in {user_output_language}. This is mandatory. The entire event content (title, description, location) must be in {user_output_language}."
+
+        # Prepare the prompt for event extraction
+        event_prompt = f"""You are analyzing a meeting transcript to extract calendar events. Use the context below to correctly interpret relative dates and times.
+
+IMPORTANT CONTEXT:
+{context_section}{language_directive}
+
+INSTRUCTIONS:
+1. **CRITICAL**: Use the MEETING DATE shown above as your reference point for ALL relative date calculations
+2. When people say "next Wednesday" or "tomorrow" or "next week", calculate from the MEETING DATE, not today's date
+3. Example: If the meeting date is September 13, 2025 and someone says "next Wednesday", that means September 17, 2025
+4. If no specific time is mentioned for an event, use 09:00:00 (9 AM) as the default start time
+5. Pay attention to time zones if mentioned
+6. Extract ONLY events that are explicitly discussed as future appointments, meetings, or deadlines
+7. Do NOT create events for past occurrences or general discussions
+
+STRICT QUALIFYING CRITERIA - Events MUST have:
+- Explicit action words indicating a scheduled event (meeting, appointment, call, deadline, interview, presentation, review, etc.)
+- A specific or calculable date/time
+- A reasonable duration (typically under 8 hours, unless explicitly specified for a multi-day event, trip, conference)
+- Clear purpose or agenda
+
+DO NOT EXTRACT (explicit exclusions):
+- Long-term plans or durations (study periods, job contracts, project timelines spanning weeks/months/years)
+- General statements about future intentions without specific scheduling ("I'm going to study here for a year", "I'll be working on this project")
+- Implied or inferred locations - only use locations explicitly stated in the conversation
+- Vague commitments without concrete times ("we should meet sometime", "let's catch up soon")
+- Personal life events not discussed as scheduled appointments
+- Events where you need to guess or infer critical details
+
+For each event found, extract:
+- Title: A clear, concise title for the event
+- Description: Brief description including context from the meeting
+- Start date/time: The calculated actual date/time (in ISO format YYYY-MM-DDTHH:MM:SS, use 09:00:00 if no time specified)
+- End date/time: When the event ends (if mentioned, in ISO format, default to 1 hour after start if not specified)
+- Location: Where the event will take place (if mentioned)
+- Attendees: List of people who should attend (if mentioned)
+- Reminder minutes: How how long before to remind (default 1 day)
+
+Transcript Summary:
+{summary_text}
+
+Transcript excerpt (for additional context):
+{transcript_text[:8000]}
+
+RESPONSE FORMAT:
+Respond with a JSON object containing an "events" array. If no events are found, return a JSON object with an empty events array.
+
+Example response:
+{{
+  "events": [
+    {{
+      "title": "Project Review Meeting",
+      "description": "Quarterly review to discuss project progress and next steps as discussed in the meeting",
+      "start_datetime": "2025-07-22T14:00:00",
+      "end_datetime": "2025-07-22T15:30:00",
+      "location": "Conference Room A",
+      "attendees": ["John Smith", "Jane Doe", "Bob Johnson"],
+      "reminder_minutes": 15
+    }}
+  ]
+}}
+
+NEGATIVE EXAMPLES - Do NOT extract events like these:
+
+❌ "I'm going to study here for one year" → NOT an event (long-term plan, no specific appointment)
+❌ "I'll be working on this project until March" → NOT an event (duration/timeline, not a meeting)
+❌ "We should get coffee sometime" → NOT an event (vague, no specific time)
+❌ "The semester starts in September" → NOT an event (general information, not a scheduled appointment)
+❌ "I moved here from California" → NOT an event (past occurrence)
+
+✅ "Let's meet next Tuesday at 2pm to review the proposal" → IS an event (specific time, action word, clear purpose)
+✅ "The deadline for submissions is Friday at 5pm" → IS an event (specific deadline)
+✅ "I have a doctor's appointment tomorrow at 10am" → IS an event (specific appointment)
+
+CRITICAL RULES:
+1. **BASE ALL DATE CALCULATIONS ON THE MEETING DATE PROVIDED IN THE CONTEXT ABOVE**
+2. Only extract events that are FUTURE relative to the MEETING DATE (not today's date)
+3. Convert all relative dates using the MEETING DATE as the reference point
+4. Example: If the meeting date is September 13, 2025 (Friday) and someone says:
+   - "next Wednesday" = September 17, 2025
+   - "tomorrow" = September 14, 2025
+   - "next week" = week of September 15-19, 2025
+5. IMPORTANT: If no time is mentioned, always use 09:00:00 (9 AM) as the start time, NOT midnight
+6. Include context from the discussion in the description
+7. Do NOT invent or assume events not explicitly discussed
+8. If unsure about a date/time, do not include that event"""
+
+        # Build system message with language requirement if applicable
+        system_message_content = """You are an expert at extracting calendar events from meeting transcripts. You excel at:
+1. Understanding relative date references ("next Tuesday", "tomorrow", "in two weeks") and converting them to absolute dates
+2. Identifying genuine future appointments, meetings, and deadlines from conversations
+3. Distinguishing between actual planned events vs. general discussions
+4. Extracting participant names and meeting details accurately
+
+You must respond with valid JSON format only."""
+
+        if user_output_language:
+            system_message_content += f"\n\nLanguage Requirement: You MUST generate ALL event titles, descriptions, and locations in {user_output_language}. This is mandatory."
+
+        completion = call_llm_completion(
+            messages=[
+                {"role": "system", "content": system_message_content},
+                {"role": "user", "content": event_prompt}
+            ],
+            temperature=0.2,
+            response_format={"type": "json_object"},
+            # EVENT_MAX_TOKENS gives reasoning-model users a knob to raise
+            # the budget when hidden thinking tokens crowd out the JSON output.
+            max_tokens=int(os.environ.get("EVENT_MAX_TOKENS", "3000")),
+            user_id=recording.user_id,
+            operation_type='event_extraction'
+        )
+
+        response_content = completion.choices[0].message.content
+        events_data = safe_json_loads(response_content, {})
+
+        # Handle both {"events": [...]} and direct array format
+        if isinstance(events_data, dict) and 'events' in events_data:
+            events_list = events_data['events']
+        elif isinstance(events_data, list):
+            events_list = events_data
+        else:
+            events_list = []
+
+        current_app.logger.info(f"Found {len(events_list)} events for recording {recording_id}")
+
+        # Save events to database
+        for event_data in events_list:
+            try:
+                # Parse dates
+                start_dt = None
+                end_dt = None
+
+                if 'start_datetime' in event_data:
+                    try:
+                        # Try ISO format first
+                        start_dt = datetime.fromisoformat(event_data['start_datetime'].replace('Z', '+00:00'))
+                    except:
+                        # Try other common formats
+                        from dateutil import parser
+                        try:
+                            start_dt = parser.parse(event_data['start_datetime'])
+                        except:
+                            current_app.logger.warning(f"Could not parse start_datetime: {event_data['start_datetime']}")
+                            continue  # Skip this event if we can't parse the date
+
+                if 'end_datetime' in event_data and event_data['end_datetime']:
+                    try:
+                        end_dt = datetime.fromisoformat(event_data['end_datetime'].replace('Z', '+00:00'))
+                    except:
+                        from dateutil import parser
+                        try:
+                            end_dt = parser.parse(event_data['end_datetime'])
+                        except:
+                            pass  # End time is optional
+
+                # Create event record
+                event = Event(
+                    recording_id=recording_id,
+                    title=event_data.get('title', 'Untitled Event')[:200],
+                    description=event_data.get('description', ''),
+                    start_datetime=start_dt,
+                    end_datetime=end_dt,
+                    location=event_data.get('location', '')[:500] if event_data.get('location') else None,
+                    attendees=json.dumps(event_data.get('attendees', [])) if event_data.get('attendees') else None,
+                    reminder_minutes=event_data.get('reminder_minutes', 15)
+                )
+
+                db.session.add(event)
+                current_app.logger.info(f"Added event '{event.title}' for recording {recording_id}")
+
+            except Exception as e:
+                current_app.logger.error(f"Error saving event for recording {recording_id}: {str(e)}")
+                continue
+
+        db.session.commit()
+
+        # Refresh the recording to ensure events relationship is loaded
+        recording = db.session.get(Recording, recording_id)
+        if recording:
+            db.session.refresh(recording)
+
+    except Exception as e:
+        current_app.logger.error(f"Error extracting events for recording {recording_id}: {str(e)}")
+        db.session.rollback()
+
+
+def extract_audio_from_video(video_filepath, output_format='mp3', cleanup_original=True):
+    """Extract audio from video containers using FFmpeg.
+
+    Behavior depends on AUDIO_COMPRESS_UPLOADS setting AND codec support:
+    - If compression enabled: Re-encodes to specified format (mp3/flac/opus)
+    - If compression disabled AND codec is supported: Copies stream (fast, preserves quality)
+    - If compression disabled AND codec is NOT supported: Re-encodes to ensure compatibility
+
+    Args:
+        video_filepath: Path to input video file
+        output_format: Audio format ('mp3', 'wav', 'flac', 'copy'), default 'mp3'
+        cleanup_original: If True, deletes original video after extraction
+
+    Returns:
+        tuple: (audio_filepath, mime_type)
+
+    Raises:
+        FFmpegError: If audio extraction fails
+        FFmpegNotFoundError: If FFmpeg is not installed
+    """
+    from src.utils.audio_conversion import get_supported_codecs
+
+    try:
+        # Check if we can copy the stream (only if codec is supported)
+        can_copy_stream = False
+        if not AUDIO_COMPRESS_UPLOADS:
+            # Probe the video to check audio codec
+            try:
+                codec_info = get_codec_info(video_filepath, timeout=10)
+                audio_codec = codec_info.get('audio_codec')
+                supported_codecs = get_supported_codecs(needs_chunking=False)
+
+                if audio_codec and audio_codec in supported_codecs:
+                    can_copy_stream = True
+                    current_app.logger.info(f"Audio codec '{audio_codec}' is supported, can copy stream")
+                else:
+                    current_app.logger.info(f"Audio codec '{audio_codec}' not in supported codecs {supported_codecs}, will re-encode")
+            except FFProbeError as e:
+                current_app.logger.warning(f"Failed to probe video codec: {e}. Will re-encode to be safe.")
+
+        if AUDIO_COMPRESS_UPLOADS:
+            # Re-encode to configured codec
+            current_app.logger.info(f"Extracting and compressing audio from video: {video_filepath} (codec: {AUDIO_CODEC})")
+            audio_filepath, mime_type = ffmpeg_extract_audio(
+                video_filepath,
+                output_format=AUDIO_CODEC,
+                bitrate=AUDIO_BITRATE,
+                cleanup_original=cleanup_original,
+                copy_stream=False
+            )
+        elif can_copy_stream:
+            # Copy audio stream without re-encoding (fast, preserves quality)
+            current_app.logger.info(f"Extracting audio from video (stream copy, no re-encoding): {video_filepath}")
+            audio_filepath, mime_type = ffmpeg_extract_audio(
+                video_filepath,
+                output_format='copy',
+                cleanup_original=cleanup_original,
+                copy_stream=True
+            )
+        else:
+            # Codec not supported - must re-encode for compatibility
+            current_app.logger.info(f"Extracting and converting audio from video: {video_filepath} (codec: {AUDIO_CODEC})")
+            audio_filepath, mime_type = ffmpeg_extract_audio(
+                video_filepath,
+                output_format=AUDIO_CODEC,
+                bitrate=AUDIO_BITRATE,
+                cleanup_original=cleanup_original,
+                copy_stream=False
+            )
+
+        current_app.logger.info(f"Successfully extracted audio to {audio_filepath}")
+        return audio_filepath, mime_type
+
+    except FFmpegNotFoundError as e:
+        current_app.logger.error(str(e))
+        raise Exception("Audio conversion tool (FFmpeg) not found on server.")
+    except FFmpegError as e:
+        current_app.logger.error(f"FFmpeg audio extraction failed for {video_filepath}: {str(e)}")
+        raise Exception(f"Audio extraction failed: {str(e)}")
+    except Exception as e:
+        current_app.logger.error(f"Error extracting audio from {video_filepath}: {str(e)}")
+        raise
+
+
+def compress_lossless_audio(filepath, codec='mp3', bitrate='128k', codec_info=None):
+    """Compress lossless audio files to save storage.
+
+    Only compresses lossless formats - already-compressed formats are skipped
+    to avoid quality degradation from re-encoding.
+
+    Args:
+        filepath: Path to the audio file
+        codec: Target codec - 'mp3', 'flac', or 'opus'
+        bitrate: Bitrate for lossy codecs (ignored for FLAC)
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        tuple: (new_filepath, new_mime_type) or (original_filepath, None) if skipped
+    """
+    # Use codec detection to check if file is lossless
+    try:
+        if not is_lossless_audio(filepath, timeout=10, codec_info=codec_info):
+            current_app.logger.debug(f"Skipping compression for {filepath} - not a lossless format")
+            return filepath, None
+
+        # Get current codec info (use provided or fetch)
+        if codec_info is None:
+            codec_info_result = get_codec_info(filepath, timeout=10)
+        else:
+            codec_info_result = codec_info
+        current_codec = codec_info_result.get('audio_codec')
+
+        # Skip if target is same as source (e.g., FLAC to FLAC when source is already FLAC)
+        if current_codec == codec:
+            current_app.logger.debug(f"Skipping compression for {filepath} - already in target codec")
+            return filepath, None
+
+    except FFProbeError as e:
+        current_app.logger.warning(f"Failed to probe {filepath} for compression: {e}. Skipping compression.")
+        return filepath, None
+
+    # Determine output extension and MIME type
+    codec_info = {
+        'mp3': {'ext': '.mp3', 'mime': 'audio/mpeg'},
+        'flac': {'ext': '.flac', 'mime': 'audio/flac'},
+        'opus': {'ext': '.opus', 'mime': 'audio/opus'}
+    }
+
+    if codec not in codec_info:
+        current_app.logger.warning(f"Unknown codec '{codec}', defaulting to mp3")
+        codec = 'mp3'
+
+    output_ext = codec_info[codec]['ext']
+    output_mime = codec_info[codec]['mime']
+
+    base_filepath = os.path.splitext(filepath)[0]
+    temp_filepath = f"{base_filepath}_compressed_temp{output_ext}"
+    final_filepath = f"{base_filepath}{output_ext}"
+
+    try:
+        # Get original file size for logging
+        original_size = os.path.getsize(filepath)
+
+        current_app.logger.info(f"Compressing {filepath} to {codec.upper()}...")
+
+        # Use centralized compression utility
+        final_filepath, output_mime, _ = compress_audio(
+            filepath, 
+            codec=codec, 
+            bitrate=bitrate,
+            delete_original=True,
+            codec_info=None
+        )
+
+        return final_filepath, output_mime
+
+    except FFmpegNotFoundError as e:
+        current_app.logger.error(str(e))
+        raise Exception("Audio conversion tool (FFmpeg) not found on server.")
+    except FFmpegError as e:
+        current_app.logger.error(f"FFmpeg compression failed for {filepath}: {str(e)}")
+        raise Exception(f"Audio compression failed: {str(e)}")
+    except Exception as e:
+        current_app.logger.error(f"Error compressing audio {filepath}: {str(e)}")
+        raise
+
+
+def merge_diarized_chunks(chunk_results):
+    """
+    Merge diarized transcription chunks while remapping speaker labels to be unique.
+
+    Since ASR services can't maintain speaker identity across chunks, each chunk's
+    speakers are remapped to unique IDs:
+    - Chunk 1: SPEAKER_00, SPEAKER_01 → SPEAKER_00, SPEAKER_01
+    - Chunk 2: SPEAKER_00, SPEAKER_01 → SPEAKER_02, SPEAKER_03
+    - etc.
+
+    This function:
+    1. Remaps speaker labels to be unique across all chunks
+    2. Updates both segments and transcription text with new labels
+    3. Adjusts timestamps based on chunk start_time
+
+    Args:
+        chunk_results: List of chunk results with 'transcription', 'segments', 'start_time'
+
+    Returns:
+        Tuple of (merged_text, merged_segments, all_speakers)
+    """
+    from src.services.transcription import TranscriptionSegment
+    import re
+
+    if not chunk_results:
+        return "", [], []
+
+    # Sort chunks by start time to ensure correct order
+    sorted_chunks = sorted(chunk_results, key=lambda x: x.get('start_time', 0))
+
+    merged_parts = []
+    merged_segments = []
+    all_speakers = set()
+    next_speaker_number = 0  # Track the next available speaker number
+
+    for chunk_idx, chunk in enumerate(sorted_chunks):
+        chunk_segments = chunk.get('segments') or []
+
+        # Build speaker remapping for this chunk
+        # Maps original speaker label -> new unique speaker label
+        chunk_speakers = set()
+        for seg in chunk_segments:
+            if hasattr(seg, 'speaker'):
+                speaker = seg.speaker
+            else:
+                speaker = seg.get('speaker', 'Unknown')
+            if speaker:
+                chunk_speakers.add(speaker)
+
+        # Also check chunk metadata for speakers
+        if chunk.get('speakers'):
+            for s in chunk['speakers']:
+                chunk_speakers.add(s)
+
+        # Create remapping: sort speakers to ensure deterministic ordering
+        speaker_remap = {}
+        for original_speaker in sorted(chunk_speakers):
+            if original_speaker and original_speaker != 'Unknown':
+                # Extract number from speaker label (e.g., SPEAKER_00 -> 0)
+                # For first chunk, keep original numbering; for subsequent chunks, remap
+                if chunk_idx == 0:
+                    # First chunk: keep original labels but track highest number
+                    speaker_remap[original_speaker] = original_speaker
+                    match = re.search(r'(\d+)$', original_speaker)
+                    if match:
+                        num = int(match.group(1))
+                        next_speaker_number = max(next_speaker_number, num + 1)
+                else:
+                    # Subsequent chunks: remap to new unique numbers
+                    new_speaker = f"SPEAKER_{next_speaker_number:02d}"
+                    speaker_remap[original_speaker] = new_speaker
+                    next_speaker_number += 1
+
+        # Update transcription text with remapped speakers
+        chunk_text = chunk.get('transcription', '').strip()
+        if chunk_text and chunk_idx > 0:
+            # Replace speaker labels in text (e.g., [SPEAKER_00]: -> [SPEAKER_02]:)
+            for original, remapped in speaker_remap.items():
+                if original != remapped:
+                    # Handle various formats: [SPEAKER_00]:, SPEAKER_00:, (SPEAKER_00)
+                    chunk_text = re.sub(
+                        rf'\[{re.escape(original)}\]',
+                        f'[{remapped}]',
+                        chunk_text
+                    )
+                    chunk_text = re.sub(
+                        rf'(?<!\[){re.escape(original)}(?![\d])',
+                        remapped,
+                        chunk_text
+                    )
+
+        if chunk_text:
+            merged_parts.append(chunk_text)
+
+        # Merge segments with adjusted timestamps and remapped speakers
+        chunk_start_offset = chunk.get('start_time', 0)
+
+        for seg in chunk_segments:
+            # Handle both TranscriptionSegment objects and dicts
+            if hasattr(seg, 'speaker'):
+                speaker = seg.speaker
+                text = seg.text
+                start_time = seg.start_time
+                end_time = seg.end_time
+            else:
+                speaker = seg.get('speaker', 'Unknown')
+                text = seg.get('text', '')
+                start_time = seg.get('start_time') or seg.get('start')
+                end_time = seg.get('end_time') or seg.get('end')
+
+            # Skip empty segments
+            if not text or not text.strip():
+                continue
+
+            # Remap speaker label
+            remapped_speaker = speaker_remap.get(speaker, speaker)
+            all_speakers.add(remapped_speaker)
+
+            # Adjust timestamps by chunk offset
+            adjusted_start = (start_time or 0) + chunk_start_offset
+            adjusted_end = (end_time or 0) + chunk_start_offset
+
+            merged_segments.append(TranscriptionSegment(
+                text=text,
+                speaker=remapped_speaker,
+                start_time=adjusted_start,
+                end_time=adjusted_end
+            ))
+
+    merged_text = '\n'.join(merged_parts)
+    return merged_text, merged_segments, sorted(list(all_speakers))
+
+
+def transcribe_chunks_with_connector(connector, filepath, filename, mime_type, language, diarize=False, hotwords=None, initial_prompt=None, transcription_model=None):
+    """
+    Transcribe a large audio file using chunking with the connector architecture.
+
+    This is used when the connector doesn't handle chunking internally (e.g., OpenAI Whisper)
+    and the file exceeds the configured chunk limit.
+
+    For diarization-enabled connectors (gpt-4o-transcribe-diarize), this function:
+    1. Processes the first chunk with diarization enabled
+    2. Extracts speaker audio samples from the diarized response
+    3. Passes those samples as known_speaker_references to subsequent chunks
+    This maintains consistent speaker labels (A, B, C, D) across all chunks.
+
+    Args:
+        connector: The transcription connector to use
+        filepath: Path to the audio file
+        filename: Original filename for logging
+        mime_type: MIME type of the audio file
+        language: Optional language code
+        diarize: Whether diarization was requested (for connectors that support it)
+        hotwords: Optional comma-separated hotwords to bias recognition
+        initial_prompt: Optional initial prompt to steer transcription
+
+    Returns:
+        Merged transcription text (with speaker labels if diarization enabled)
+    """
+    import tempfile
+    from src.services.transcription import TranscriptionRequest
+    from src.audio_chunking import extract_speaker_samples, samples_to_data_urls
+
+    # Get connector specs for proper chunking (respects hard limits like max_duration_seconds)
+    connector_specs = connector.specifications
+
+    # Check if connector supports diarization (property, not method - no parentheses)
+    supports_diarization = connector.supports_diarization
+    use_diarization = diarize and supports_diarization
+
+    if use_diarization:
+        current_app.logger.info("Diarization enabled - will use known_speaker_references for consistent speaker labels across chunks")
+    elif diarize and not supports_diarization:
+        current_app.logger.warning("Diarization requested but connector doesn't support it - transcribing without diarization")
+
+    with tempfile.TemporaryDirectory() as temp_dir:
+        try:
+            # Create chunks (passes connector_specs for duration-based chunking if needed)
+            current_app.logger.info(f"Creating chunks for large file: {filepath}")
+            chunks = chunking_service.create_chunks(filepath, temp_dir, connector_specs)
+
+            if not chunks:
+                raise ChunkProcessingError("No chunks were created from the audio file")
+
+            current_app.logger.info(f"Created {len(chunks)} chunks, processing each with connector...")
+
+            # Process each chunk
+            chunk_results = []
+            known_speaker_names = None
+            known_speaker_refs = None  # Dict of speaker label -> data URL
+
+            for i, chunk in enumerate(chunks):
+                max_retries = 3
+                retry_count = 0
+                success = False
+
+                while retry_count < max_retries and not success:
+                    try:
+                        retry_suffix = f" (retry {retry_count + 1}/{max_retries})" if retry_count > 0 else ""
+                        current_app.logger.info(f"Processing chunk {i+1}/{len(chunks)}: {chunk['filename']} ({chunk['size_mb']:.1f}MB){retry_suffix}")
+
+                        # Transcribe chunk using connector
+                        with open(chunk['path'], 'rb') as chunk_file:
+                            # For diarization: first chunk gets diarize=True, subsequent chunks
+                            # get diarize=True + known_speaker_references
+                            if use_diarization:
+                                request = TranscriptionRequest(
+                                    audio_file=chunk_file,
+                                    filename=chunk['filename'],
+                                    mime_type='audio/mpeg',  # Chunks are always MP3
+                                    language=language,
+                                    diarize=True,
+                                    known_speaker_names=known_speaker_names,
+                                    known_speaker_references=known_speaker_refs,
+                                    prompt=initial_prompt,
+                                    hotwords=hotwords,
+                                    model=transcription_model,
+                                )
+                            else:
+                                request = TranscriptionRequest(
+                                    audio_file=chunk_file,
+                                    filename=chunk['filename'],
+                                    mime_type='audio/mpeg',
+                                    language=language,
+                                    diarize=False,
+                                    prompt=initial_prompt,
+                                    hotwords=hotwords,
+                                    model=transcription_model,
+                                )
+
+                            response = connector.transcribe(request)
+
+                        # For the first diarized chunk, extract speaker samples for subsequent chunks
+                        if use_diarization and i == 0 and response.segments:
+                            current_app.logger.info(f"First chunk diarized with {len(response.speakers or [])} speakers, extracting samples...")
+
+                            # Extract speaker samples from the first chunk
+                            speaker_samples = extract_speaker_samples(
+                                audio_path=chunk['path'],
+                                segments=[{
+                                    'speaker': seg.speaker,
+                                    'start_time': seg.start_time,
+                                    'end_time': seg.end_time
+                                } for seg in response.segments],
+                                output_dir=temp_dir,
+                                min_duration=2.0,
+                                max_duration=10.0,
+                                max_speakers=4
+                            )
+
+                            if speaker_samples:
+                                # Convert to data URLs for the API
+                                known_speaker_refs = samples_to_data_urls(speaker_samples)
+                                known_speaker_names = list(known_speaker_refs.keys())
+                                current_app.logger.info(f"Extracted speaker references for {len(known_speaker_names)} speakers: {known_speaker_names}")
+                            else:
+                                current_app.logger.warning("Could not extract speaker samples from first chunk")
+
+                        # Store chunk result
+                        chunk_result = {
+                            'index': chunk['index'],
+                            'start_time': chunk['start_time'],
+                            'end_time': chunk['end_time'],
+                            'duration': chunk['duration'],
+                            'size_mb': chunk['size_mb'],
+                            'transcription': response.text,
+                            'filename': chunk['filename'],
+                            'segments': response.segments if use_diarization else None,
+                            'speakers': response.speakers if use_diarization else None
+                        }
+                        chunk_results.append(chunk_result)
+                        current_app.logger.info(f"Chunk {i+1} transcribed successfully: {len(response.text)} characters")
+                        success = True
+
+                    except Exception as chunk_error:
+                        retry_count += 1
+                        error_msg = str(chunk_error)
+
+                        if retry_count < max_retries:
+                            wait_time = 15 if "timeout" not in error_msg.lower() else 30
+                            current_app.logger.warning(f"Chunk {i+1} failed (attempt {retry_count}/{max_retries}): {chunk_error}. Retrying in {wait_time}s...")
+                            time.sleep(wait_time)
+                        else:
+                            current_app.logger.error(f"Chunk {i+1} failed after {max_retries} attempts: {chunk_error}")
+                            chunk_result = {
+                                'index': chunk['index'],
+                                'start_time': chunk['start_time'],
+                                'end_time': chunk['end_time'],
+                                'transcription': f"[Chunk {i+1} transcription failed: {str(chunk_error)}]",
+                                'filename': chunk['filename']
+                            }
+                            chunk_results.append(chunk_result)
+
+                # Small delay between chunks
+                if i < len(chunks) - 1:
+                    time.sleep(2)
+
+            # Merge transcriptions
+            current_app.logger.info(f"Merging {len(chunk_results)} chunk transcriptions...")
+
+            if use_diarization:
+                # For diarized chunks, merge text AND segments with adjusted timestamps
+                merged_text, merged_segments, all_speakers = merge_diarized_chunks(chunk_results)
+
+                if not merged_text.strip():
+                    raise ChunkProcessingError("Merged transcription is empty")
+
+                # Log statistics
+                chunking_service.log_processing_statistics(chunk_results)
+
+                current_app.logger.info(f"Merged diarization: {len(merged_segments)} segments, {len(all_speakers)} speakers: {all_speakers}")
+
+                # Return a TranscriptionResponse so segments are preserved
+                from src.services.transcription import TranscriptionResponse
+                return TranscriptionResponse(
+                    text=merged_text,
+                    segments=merged_segments,
+                    speakers=all_speakers,
+                    provider=connector.PROVIDER_NAME,
+                    model=getattr(connector, 'model', 'unknown')
+                )
+            else:
+                merged_transcription = chunking_service.merge_transcriptions(chunk_results)
+
+                if not merged_transcription.strip():
+                    raise ChunkProcessingError("Merged transcription is empty")
+
+                # Log statistics
+                chunking_service.log_processing_statistics(chunk_results)
+
+                return merged_transcription
+
+        except Exception as e:
+            current_app.logger.error(f"Chunking transcription failed for {filepath}: {e}")
+            if 'chunks' in locals():
+                chunking_service.cleanup_chunks(chunks)
+            raise ChunkProcessingError(f"Chunked transcription failed: {str(e)}")
+
+
+def transcribe_with_connector(app_context, recording_id, filepath, original_filename, start_time, mime_type=None, language=None, diarize=None, min_speakers=None, max_speakers=None, tag_id=None, hotwords=None, initial_prompt=None, transcription_model=None):
+    """
+    Transcribe audio using the new connector-based architecture.
+
+    This function uses the transcription connector system which supports:
+    - OpenAI Whisper (whisper-1)
+    - OpenAI GPT-4o Transcribe (gpt-4o-transcribe, gpt-4o-mini-transcribe)
+    - OpenAI GPT-4o Transcribe Diarize (gpt-4o-transcribe-diarize) - with speaker labels
+    - Custom ASR endpoints (whisper-asr-webservice, WhisperX, etc.)
+
+    Args:
+        app_context: Flask app context
+        recording_id: ID of the recording to process
+        filepath: Path to the audio file
+        original_filename: Original filename for logging
+        start_time: Processing start time
+        mime_type: MIME type of the audio file
+        language: Optional language code override
+        diarize: Whether to enable diarization (None = use connector default)
+        min_speakers: Optional minimum speakers
+        max_speakers: Optional maximum speakers
+        tag_id: Optional tag ID to apply custom prompt from
+        hotwords: Optional comma-separated hotwords to bias recognition
+        initial_prompt: Optional initial prompt to steer transcription
+    """
+    from src.services.transcription import (
+        get_connector, TranscriptionRequest, TranscriptionCapability
+    )
+    from src.utils.language import normalize_language_code
+
+    # Defensive normalization at the connector boundary — guards legacy DB
+    # values like "français" that pre-date the dropdown migration (issue #256).
+    language = normalize_language_code(language)
+
+    with app_context:
+        recording = db.session.get(Recording, recording_id)
+        if not recording:
+            current_app.logger.error(f"Error: Recording {recording_id} not found for transcription.")
+            return
+
+        try:
+            current_app.logger.info(f"Starting connector-based transcription for recording {recording_id}...")
+            recording.status = 'PROCESSING'
+            transcription_start_time = time.time()
+            db.session.commit()
+
+            # Get the active transcription connector
+            connector = get_connector()
+            connector_name = connector.PROVIDER_NAME
+            current_app.logger.info(f"Using transcription connector: {connector_name}")
+
+            # Fall back to admin default hotwords if none provided
+            if not hotwords:
+                admin_hotwords = SystemSetting.get_setting('admin_default_hotwords', '')
+                if admin_hotwords:
+                    hotwords = admin_hotwords
+                    current_app.logger.debug(f"Using admin default hotwords: {hotwords}")
+
+            # Check transcription budget before processing
+            can_proceed, usage_pct, budget_msg = transcription_tracker.check_budget(recording.user_id)
+            if not can_proceed:
+                current_app.logger.warning(f"User {recording.user_id} exceeded transcription budget: {budget_msg}")
+                recording.status = 'FAILED'
+                recording.error_msg = budget_msg
+                db.session.commit()
+                return
+            elif budget_msg:
+                # Log warning but continue
+                current_app.logger.warning(budget_msg)
+
+            # Handle video extraction (keep existing logic)
+            actual_filepath = filepath
+            actual_content_type = mime_type or mimetypes.guess_type(original_filename)[0] or 'application/octet-stream'
+            actual_filename = original_filename
+            audio_filepath = None  # Track temp audio extracted from video (for cleanup)
+
+            # Use codec detection to check if file is a video
+            try:
+                is_video = is_video_file(filepath, timeout=10)
+                if is_video:
+                    current_app.logger.info(f"Video detected for {original_filename}")
+            except FFProbeError as e:
+                current_app.logger.warning(f"Failed to probe {original_filename}: {e}. Falling back to MIME type detection.")
+                video_mime_types = [
+                    'video/mp4', 'video/quicktime', 'video/x-msvideo', 'video/webm',
+                    'video/avi', 'video/x-ms-wmv', 'video/3gpp'
+                ]
+                is_video = (
+                    actual_content_type.startswith('video/') or
+                    actual_content_type in video_mime_types
+                )
+
+            if is_video:
+                if VIDEO_PASSTHROUGH_ASR:
+                    # Video passthrough: send original video directly to ASR without audio extraction
+                    current_app.logger.info(f"Video passthrough: sending original video to ASR (no audio extraction)")
+                    actual_filepath = filepath  # Send video as-is to connector
+                    if VIDEO_RETENTION:
+                        # Also keep the video for playback
+                        recording.audio_path = filepath
+                        recording.mime_type = mimetypes.guess_type(filepath)[0] or 'video/mp4'
+                        db.session.commit()
+                elif VIDEO_RETENTION:
+                    # Video retention: keep original video, extract audio to temp for transcription only
+                    current_app.logger.info(f"Video container detected, retaining video and extracting audio to temp...")
+                    try:
+                        audio_filepath, audio_mime_type = extract_audio_from_video(filepath, cleanup_original=False)
+                        # Use extracted audio for transcription processing
+                        actual_filepath = audio_filepath
+                        actual_content_type = audio_mime_type
+                        actual_filename = os.path.basename(audio_filepath)
+
+                        # Keep original video file as the stored media
+                        recording.audio_path = filepath
+                        recording.mime_type = mimetypes.guess_type(filepath)[0] or 'video/mp4'
+                        db.session.commit()
+                        current_app.logger.info(f"Video retained at: {filepath}, temp audio extracted: {audio_filepath}")
+                    except Exception as e:
+                        current_app.logger.error(f"Failed to extract audio from video: {str(e)}")
+                        recording.status = 'FAILED'
+                        recording.error_msg = f"Audio extraction failed: {str(e)}"
+                        db.session.commit()
+                        raise
+                else:
+                    # Default: extract audio, delete original video
+                    current_app.logger.info(f"Video container detected, extracting audio...")
+                    try:
+                        audio_filepath, audio_mime_type = extract_audio_from_video(filepath)
+                        actual_filepath = audio_filepath
+                        actual_content_type = audio_mime_type
+                        actual_filename = os.path.basename(audio_filepath)
+
+                        recording.audio_path = audio_filepath
+                        recording.mime_type = audio_mime_type
+                        db.session.commit()
+                        current_app.logger.info(f"Audio extracted: {audio_filepath}")
+                    except Exception as e:
+                        current_app.logger.error(f"Failed to extract audio from video: {str(e)}")
+                        recording.status = 'FAILED'
+                        recording.error_msg = f"Audio extraction failed: {str(e)}"
+                        db.session.commit()
+                        raise  # Re-raise so job queue marks the job as failed
+
+            # Validate and convert audio format if needed using unified conversion utility
+            # This respects:
+            # - connector_specs.unsupported_codecs (e.g., opus for OpenAI)
+            # - AUDIO_UNSUPPORTED_CODECS environment variable (user-specified exclusions)
+            # - AUDIO_COMPRESS_UPLOADS setting (lossless compression)
+            connector_specs = connector.specifications
+            converted_filepath = None  # Track converted file for cleanup and retry
+            video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR
+
+            if video_passthrough_active:
+                # Skip conversion and chunking — ASR backend handles the raw video
+                current_app.logger.info(f"Video passthrough: skipping codec conversion and chunking")
+            else:
+                try:
+                    # Check if chunking will be needed (affects which codecs are supported)
+                    needs_chunking_check = (
+                        chunking_service and
+                        chunking_service.needs_chunking(actual_filepath, False, connector_specs)
+                    )
+
+                    conversion_result = convert_if_needed(
+                        filepath=actual_filepath,
+                        original_filename=actual_filename,
+                        needs_chunking=needs_chunking_check,
+                        is_asr_endpoint=False,  # Using connector architecture
+                        delete_original=False,  # Keep original, we may need it for retry
+                        connector_specs=connector_specs
+                    )
+
+                    if conversion_result.was_converted:
+                        current_app.logger.info(
+                            f"Audio converted: {conversion_result.original_codec} → {conversion_result.final_codec}, "
+                            f"size: {conversion_result.original_size_mb:.1f}MB → {conversion_result.final_size_mb:.1f}MB"
+                        )
+                        converted_filepath = conversion_result.output_path
+                        actual_filepath = converted_filepath
+                        actual_content_type = conversion_result.mime_type
+                        actual_filename = os.path.basename(converted_filepath)
+                except (FFmpegError, FFmpegNotFoundError) as conv_error:
+                    current_app.logger.error(f"Audio conversion failed: {conv_error}")
+                    raise  # Let the job fail - can't process this file
+                except Exception as e:
+                    current_app.logger.warning(f"Could not validate/convert audio: {e}, proceeding with original file")
+
+            # Determine if we should diarize
+            if diarize is None:
+                # Use connector's configured default (respects ASR_DIARIZE env var)
+                should_diarize = getattr(connector, 'default_diarize', connector.supports_diarization)
+            else:
+                should_diarize = diarize and connector.supports_diarization
+
+            if should_diarize and not connector.supports_diarization:
+                current_app.logger.warning(f"Diarization requested but connector '{connector_name}' doesn't support it")
+                should_diarize = False
+
+            # Check if chunking is needed for large files
+            # The chunking service respects this priority:
+            # 1. Connector handles internally (e.g., ASR endpoint) → no app-level chunking
+            # 2. User's ENABLE_CHUNKING=false → no chunking
+            # 3. User's CHUNK_LIMIT setting → use their settings
+            # 4. Connector defaults (max_file_size, recommended_chunk_seconds)
+            # 5. App default (20MB)
+            if video_passthrough_active:
+                should_chunk = False
+                current_app.logger.info(f"Video passthrough: chunking skipped (ASR backend handles internally)")
+            else:
+                current_app.logger.info(f"Chunking service available: {chunking_service is not None}")
+                current_app.logger.info(f"Connector specs: max_duration={connector_specs.max_duration_seconds}s, "
+                                       f"handles_internally={connector_specs.handles_chunking_internally}, "
+                                       f"recommended_chunk={connector_specs.recommended_chunk_seconds}s")
+
+                if chunking_service:
+                    should_chunk = chunking_service.needs_chunking(actual_filepath, False, connector_specs)
+                    current_app.logger.info(f"Chunking decision: should_chunk={should_chunk}")
+                else:
+                    should_chunk = False
+                    current_app.logger.warning("Chunking service is disabled (ENABLE_CHUNKING=false or service not initialized)")
+
+            # Retry loop for handling format/codec errors with MP3 conversion
+            max_attempts = 2
+            last_error = None
+
+            for attempt in range(max_attempts):
+                try:
+                    if should_chunk:
+                        # Use chunking for large files
+                        file_size_mb = os.path.getsize(actual_filepath) / (1024 * 1024)
+                        current_app.logger.info(f"File {actual_filepath} is large ({file_size_mb:.1f}MB), using chunking for transcription")
+                        chunk_result = transcribe_chunks_with_connector(
+                            connector, actual_filepath, actual_filename, actual_content_type, language,
+                            diarize=should_diarize,  # Pass diarization setting for speaker reference tracking
+                            hotwords=hotwords,
+                            initial_prompt=initial_prompt,
+                            transcription_model=transcription_model,
+                        )
+
+                        # Handle result based on type (TranscriptionResponse for diarized, string for plain)
+                        if hasattr(chunk_result, 'segments') and chunk_result.segments and chunk_result.has_diarization():
+                            # Diarized response - store with segments for click-to-seek and speaker identification
+                            recording.transcription = chunk_result.to_storage_format()
+                            current_app.logger.info(f"Chunked diarized transcription completed: {len(chunk_result.text)} characters, {len(chunk_result.segments)} segments")
+                        else:
+                            # Plain text response
+                            transcription_text = chunk_result.text if hasattr(chunk_result, 'text') else chunk_result
+                            recording.transcription = transcription_text
+                            current_app.logger.info(f"Chunked transcription completed: {len(transcription_text)} characters")
+                    else:
+                        # Build the transcription request for single file
+                        with open(actual_filepath, 'rb') as audio_file:
+                            request = TranscriptionRequest(
+                                audio_file=audio_file,
+                                filename=actual_filename,
+                                mime_type=actual_content_type,
+                                language=language,
+                                diarize=should_diarize,
+                                min_speakers=min_speakers,
+                                max_speakers=max_speakers,
+                                prompt=initial_prompt,
+                                hotwords=hotwords,
+                                model=transcription_model,
+                            )
+
+                            current_app.logger.info(f"Transcribing with connector: diarize={should_diarize}, language={language}")
+                            response = connector.transcribe(request)
+
+                        # Store the result
+                        if response.segments and response.has_diarization():
+                            # Store as JSON with segments (diarized format)
+                            recording.transcription = response.to_storage_format()
+                            current_app.logger.info(f"Transcription completed with {len(response.segments)} segments and {len(response.speakers or [])} speakers")
+                        else:
+                            # Store as plain text (ensure it's a string)
+                            transcription_text = response.text if isinstance(response.text, str) else ''
+                            recording.transcription = transcription_text
+                            current_app.logger.info(f"Transcription completed: {len(transcription_text)} characters")
+
+                        # Store speaker embeddings if available
+                        if response.speaker_embeddings:
+                            recording.speaker_embeddings = response.speaker_embeddings
+                            current_app.logger.info(f"Stored speaker embeddings for speakers: {list(response.speaker_embeddings.keys())}")
+
+                    # If we reach here, transcription succeeded
+                    break
+
+                except Exception as e:
+                    last_error = e
+                    error_msg = str(e).lower()
+
+                    # Check if this is a format/codec error that might be fixed by MP3 conversion
+                    # Use specific phrases to avoid false positives (e.g. "unparseable JSON" matching "invalid")
+                    is_format_error = any(phrase in error_msg for phrase in [
+                        'corrupted file', 'unsupported audio', 'unsupported format',
+                        'invalid audio', 'invalid file format', 'invalid codec',
+                        'could not find codec', 'audio codec', 'audio format',
+                        'failed to decode audio', 'not a valid audio file',
+                    ])
+
+                    # Only retry with MP3 conversion on first attempt for format errors
+                    if attempt == 0 and is_format_error and not converted_filepath:
+                        current_app.logger.warning(f"Transcription failed with possible format error: {e}")
+                        current_app.logger.info(f"Attempting MP3 conversion and retry...")
+
+                        # Check if file is already MP3
+                        try:
+                            codec_info = get_codec_info(actual_filepath, timeout=10)
+                            audio_codec = codec_info.get('audio_codec', '').lower()
+                            needs_conversion = audio_codec != 'mp3'
+                        except FFProbeError:
+                            needs_conversion = not actual_filename.lower().endswith('.mp3')
+
+                        if needs_conversion:
+                            try:
+                                converted_filepath = convert_to_mp3(actual_filepath)
+                                current_app.logger.info(f"Successfully converted to MP3: {converted_filepath}")
+                                actual_filepath = converted_filepath
+                                actual_content_type = 'audio/mpeg'
+                                actual_filename = os.path.basename(converted_filepath)
+                                # Recalculate if chunking is needed after conversion
+                                should_chunk = (
+                                    chunking_service and
+                                    chunking_service.needs_chunking(actual_filepath, False, connector_specs)
+                                )
+                                continue  # Retry with converted file
+                            except (FFmpegError, FFmpegNotFoundError) as conv_error:
+                                current_app.logger.error(f"Failed to convert to MP3: {conv_error}")
+                                # Fall through to raise original error
+                        else:
+                            current_app.logger.warning(f"File is already MP3 but still getting format error")
+
+                    # Not a format error or already retried - propagate the error
+                    raise
+
+            # Clean up converted file if we created one and transcription succeeded
+            if converted_filepath and os.path.exists(converted_filepath):
+                try:
+                    os.remove(converted_filepath)
+                    current_app.logger.debug(f"Cleaned up converted file: {converted_filepath}")
+                except OSError:
+                    pass  # Best effort cleanup
+
+            # Clean up temp audio extracted from video when video retention is enabled
+            if is_video and VIDEO_RETENTION and audio_filepath and audio_filepath != filepath:
+                try:
+                    if os.path.exists(audio_filepath):
+                        os.remove(audio_filepath)
+                        current_app.logger.info(f"Cleaned up temp audio from video retention: {audio_filepath}")
+                except OSError:
+                    pass  # Best effort cleanup
+
+            # Calculate and save transcription duration
+            transcription_end_time = time.time()
+            recording.transcription_duration_seconds = int(transcription_end_time - transcription_start_time)
+            db.session.commit()
+            current_app.logger.info(f"Transcription completed in {recording.transcription_duration_seconds}s")
+
+            # Record transcription usage for billing/budgeting
+            try:
+                # Get actual audio duration (not processing time)
+                audio_duration = None
+                if chunking_service:
+                    audio_duration = chunking_service.get_audio_duration(recording.audio_path)
+
+                if audio_duration and audio_duration > 0:
+                    # Get model name from connector if available
+                    model_name = getattr(connector, 'model', None) or connector_name
+                    transcription_tracker.record_usage(
+                        user_id=recording.user_id,
+                        connector_type=connector_name,
+                        audio_duration_seconds=int(audio_duration),
+                        model_name=model_name
+                    )
+                    current_app.logger.info(f"Recorded transcription usage: {int(audio_duration)}s for user {recording.user_id}")
+                else:
+                    current_app.logger.warning(f"Could not determine audio duration for usage tracking")
+            except Exception as usage_err:
+                # Don't fail transcription if usage tracking fails
+                current_app.logger.warning(f"Failed to record transcription usage: {usage_err}")
+
+            # Apply auto speaker labelling if enabled and embeddings available
+            if recording.speaker_embeddings:
+                try:
+                    from src.services.speaker_embedding_matcher import (
+                        apply_auto_speaker_labels,
+                        apply_speaker_names_to_transcription,
+                        update_speaker_profiles_from_recording
+                    )
+
+                    user = User.query.get(recording.user_id)
+                    if user and user.auto_speaker_labelling:
+                        current_app.logger.info(f"Applying auto speaker labelling for recording {recording.id}")
+                        speaker_map = apply_auto_speaker_labels(recording, user)
+
+                        if speaker_map:
+                            current_app.logger.info(f"Auto-matched speakers: {speaker_map}")
+                            # Apply names to transcription
+                            if apply_speaker_names_to_transcription(recording, speaker_map):
+                                current_app.logger.info(f"Applied speaker names to transcription")
+                                # Update speaker profiles with new embeddings
+                                updated_count = update_speaker_profiles_from_recording(recording, speaker_map, user)
+                                if updated_count > 0:
+                                    current_app.logger.info(f"Updated {updated_count} speaker profiles with new embeddings")
+                            else:
+                                current_app.logger.warning(f"Failed to apply speaker names to transcription for recording {recording.id}")
+                        else:
+                            current_app.logger.info(f"No speakers matched for auto-labelling")
+                except Exception as auto_label_err:
+                    # Don't fail transcription if auto-labelling fails
+                    current_app.logger.warning(f"Failed to apply auto speaker labelling: {auto_label_err}")
+
+            # Check if auto-summarization is disabled (admin setting or user preference)
+            admin_setting = SystemSetting.get_setting('disable_auto_summarization', False)
+            admin_disabled = admin_setting if isinstance(admin_setting, bool) else str(admin_setting).lower() == 'true'
+            user = User.query.get(recording.user_id)
+            user_disabled = user and user.auto_summarization is False
+            will_auto_summarize = not admin_disabled and not user_disabled
+
+            # Generate title immediately
+            generate_title_task(app_context, recording_id, will_auto_summarize=will_auto_summarize)
+
+            if not will_auto_summarize:
+                reason = "admin setting" if admin_disabled else "user preference"
+                current_app.logger.info(f"Auto-summarization disabled ({reason}), skipping summary for recording {recording_id}")
+                recording = db.session.get(Recording, recording_id)
+                if recording:
+                    recording.status = 'COMPLETED'
+                    recording.completed_at = datetime.utcnow()
+                    db.session.commit()
+
+                    # Apply auto-shares for group tags after processing completes
+                    apply_team_tag_auto_shares(recording_id)
+
+                    # Export transcription-only if auto-export is enabled
+                    if ENABLE_AUTO_EXPORT:
+                        export_recording(recording_id)
+            else:
+                # Auto-generate summary for all recordings
+                current_app.logger.info(f"Auto-generating summary for recording {recording_id}")
+                generate_summary_only_task(app_context, recording_id)
+
+        except Exception as e:
+            db.session.rollback()
+            error_msg = str(e)
+            error_type = type(e).__name__
+            current_app.logger.error(f"Connector transcription FAILED for recording {recording_id}: [{error_type}] {error_msg}", exc_info=True)
+
+            # Handle timeout errors specifically - log the configured timeout for debugging
+            if "timed out" in error_msg.lower() or "timeout" in error_msg.lower() or "Timeout" in error_type:
+                try:
+                    from src.services.transcription import get_registry
+                    registry = get_registry()
+                    # Get timeout from connector config if available
+                    connector_timeout = getattr(registry.get_active_connector(), 'timeout', None)
+                    if connector_timeout:
+                        current_app.logger.error(f"Timeout details - configured connector timeout: {connector_timeout}s")
+                    else:
+                        # Fall back to database/env setting
+                        asr_timeout = SystemSetting.get_setting('asr_timeout_seconds', 1800)
+                        current_app.logger.error(f"Timeout details - configured timeout: {asr_timeout}s")
+                except Exception:
+                    pass  # Don't fail the error handling if we can't get timeout info
+
+            # Don't set recording.status = 'FAILED' here - let the job queue handle it
+            # The job queue will decide whether to retry or permanently fail,
+            # and only set FAILED status when all retries are exhausted
+
+            # Re-raise so job queue marks the job as failed (and potentially retries)
+            raise
+
+
+def transcribe_audio_task(app_context, recording_id, filepath, filename_for_asr, start_time, language=None, min_speakers=None, max_speakers=None, tag_id=None, hotwords=None, initial_prompt=None, transcription_model=None):
+    """Runs the transcription and summarization in a background thread.
+
+    Uses the connector-based architecture which supports:
+    - OpenAI Whisper (whisper-1)
+    - OpenAI GPT-4o Transcribe (gpt-4o-transcribe, gpt-4o-mini-transcribe)
+    - OpenAI GPT-4o Transcribe Diarize (gpt-4o-transcribe-diarize)
+    - Custom ASR endpoints (whisper-asr-webservice, WhisperX, etc.)
+
+    Args:
+        app_context: Flask app context
+        recording_id: ID of the recording to process
+        filepath: Path to the audio file
+        filename_for_asr: Filename to use for ASR
+        start_time: Processing start time
+        language: Optional language code override (from upload form)
+        min_speakers: Optional minimum speakers override (from upload form)
+        max_speakers: Optional maximum speakers override (from upload form)
+        tag_id: Optional tag ID to apply custom prompt from
+        hotwords: Optional comma-separated hotwords to bias recognition
+        initial_prompt: Optional initial prompt to steer transcription
+    """
+    with app_context:
+        recording = db.session.get(Recording, recording_id)
+        # Determine diarization setting based on connector capabilities
+        # The connector will handle this, but we pass the user's preference
+        diarize_setting = None  # Let connector decide based on its capabilities
+
+        # Use language from upload form if provided, otherwise use user's default
+        # language='' (empty string) means auto-detect, language=None means use default
+        if language is not None:
+            # Explicit language selection (including empty string for auto-detect)
+            user_transcription_language = language if language else None  # '' becomes None for connector
+        else:
+            # No language specified - use user's default
+            user_transcription_language = recording.owner.transcription_language if recording and recording.owner else None
+
+        mime_type = recording.mime_type if recording else None
+
+    transcribe_with_connector(
+        app_context, recording_id, filepath, filename_for_asr, start_time,
+        mime_type=mime_type,
+        language=user_transcription_language,
+        diarize=diarize_setting,
+        min_speakers=min_speakers,
+        max_speakers=max_speakers,
+        tag_id=tag_id,
+        hotwords=hotwords,
+        initial_prompt=initial_prompt,
+        transcription_model=transcription_model,
+    )
+
+    # After transcription completes, calculate processing time
+    with app_context:
+        recording = db.session.get(Recording, recording_id)
+        if recording and recording.status in ['COMPLETED', 'FAILED']:
+            end_time = datetime.utcnow()
+            recording.processing_time_seconds = (end_time - start_time).total_seconds()
+            db.session.commit()
+
+
+def transcribe_incognito(filepath, original_filename, language=None, min_speakers=None, max_speakers=None, user=None):
+    """
+    Perform transcription without any database operations.
+    Used for Incognito Mode where no data is persisted.
+
+    Args:
+        filepath: Path to the audio file
+        original_filename: Original filename for logging/processing
+        language: Optional language code for transcription
+        min_speakers: Optional minimum speakers for diarization
+        max_speakers: Optional maximum speakers for diarization
+        user: Optional user object for language/diarization preferences
+
+    Returns:
+        dict with transcription, title, processing_time, etc.
+    """
+    import time
+    import mimetypes
+    from src.services.transcription import get_registry, TranscriptionRequest
+
+    start_time = time.time()
+    result = {
+        'transcription': None,
+        'title': 'Incognito Recording',
+        'processing_time_seconds': 0,
+        'audio_duration_seconds': None,
+        'error': None
+    }
+
+    try:
+        # Get the active connector
+        registry = get_registry()
+        connector = registry.get_active_connector()
+
+        if not connector:
+            raise Exception("No transcription connector available")
+
+        connector_specs = connector.specifications
+        connector_name = type(connector).__name__
+        current_app.logger.info(f"[Incognito] Using transcription connector: {connector_name}")
+
+        # Determine mime type
+        mime_type = mimetypes.guess_type(original_filename)[0] or 'audio/mpeg'
+
+        # Handle video extraction if needed
+        actual_filepath = filepath
+        actual_filename = original_filename
+        actual_content_type = mime_type
+
+        # Check if file is video and needs audio extraction
+        is_video = False
+        try:
+            is_video = is_video_file(filepath, timeout=10)
+        except FFProbeError as e:
+            current_app.logger.warning(f"[Incognito] Failed to probe file: {e}")
+            # Check by extension
+            video_extensions = ['.mp4', '.mov', '.avi', '.mkv', '.webm', '.wmv', '.flv', '.m4v']
+            is_video = any(original_filename.lower().endswith(ext) for ext in video_extensions)
+
+        video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR
+
+        if is_video:
+            if VIDEO_PASSTHROUGH_ASR:
+                current_app.logger.info(f"[Incognito] Video passthrough: sending original video to ASR (no audio extraction)")
+            else:
+                current_app.logger.info(f"[Incognito] Video detected, extracting audio...")
+                try:
+                    audio_filepath, audio_mime_type = extract_audio_from_video(filepath, cleanup_original=False)
+                    actual_filepath = audio_filepath
+                    actual_content_type = audio_mime_type
+                    actual_filename = os.path.basename(audio_filepath)
+                except Exception as e:
+                    current_app.logger.error(f"[Incognito] Failed to extract audio from video: {e}")
+                    raise
+
+        # Convert audio format if needed
+        if video_passthrough_active:
+            current_app.logger.info(f"[Incognito] Video passthrough: skipping codec conversion")
+        else:
+            try:
+                needs_chunking_check = (
+                    chunking_service and
+                    chunking_service.needs_chunking(actual_filepath, False, connector_specs)
+                )
+
+                conversion_result = convert_if_needed(
+                    filepath=actual_filepath,
+                    original_filename=actual_filename,
+                    needs_chunking=needs_chunking_check,
+                    is_asr_endpoint=False,
+                    delete_original=False,
+                    connector_specs=connector_specs
+                )
+
+                if conversion_result.was_converted:
+                    current_app.logger.info(f"[Incognito] Audio converted: {conversion_result.original_codec} -> {conversion_result.final_codec}")
+                actual_filepath = conversion_result.output_path
+                actual_content_type = conversion_result.mime_type
+                actual_filename = os.path.basename(conversion_result.output_path)
+            except Exception as e:
+                current_app.logger.warning(f"[Incognito] Audio conversion check failed: {e}, proceeding with original")
+
+        # Get audio duration if chunking service is available
+        if chunking_service:
+            try:
+                result['audio_duration_seconds'] = int(chunking_service.get_audio_duration(actual_filepath))
+            except Exception as e:
+                current_app.logger.warning(f"[Incognito] Could not get audio duration: {e}")
+
+        # Determine diarization settings (respects ASR_DIARIZE env var)
+        should_diarize = getattr(connector, 'default_diarize', connector.supports_diarization)
+
+        # Use user's language preference if not explicitly provided
+        if language is None and user:
+            language = user.transcription_language
+
+        # Normalize at the boundary — legacy values like "français" must
+        # become "fr" before the connector receives them (issue #256).
+        from src.utils.language import normalize_language_code
+        language = normalize_language_code(language)
+
+        # Check if chunking is needed
+        if video_passthrough_active:
+            should_chunk = False
+            current_app.logger.info(f"[Incognito] Video passthrough: chunking skipped (ASR backend handles internally)")
+        else:
+            should_chunk = (chunking_service and
+                           chunking_service.needs_chunking(actual_filepath, False, connector_specs))
+
+        current_app.logger.info(f"[Incognito] Starting transcription: diarize={should_diarize}, language={language}, chunking={should_chunk}")
+
+        if should_chunk:
+            # Use chunking for large files
+            chunk_result = transcribe_chunks_with_connector(
+                connector, actual_filepath, actual_filename, actual_content_type, language,
+                diarize=should_diarize
+            )
+
+            if hasattr(chunk_result, 'segments') and chunk_result.segments and chunk_result.has_diarization():
+                result['transcription'] = chunk_result.to_storage_format()
+            else:
+                result['transcription'] = chunk_result.text if hasattr(chunk_result, 'text') else chunk_result
+        else:
+            # Single file transcription
+            with open(actual_filepath, 'rb') as audio_file:
+                request = TranscriptionRequest(
+                    audio_file=audio_file,
+                    filename=actual_filename,
+                    mime_type=actual_content_type,
+                    language=language,
+                    diarize=should_diarize,
+                    min_speakers=min_speakers,
+                    max_speakers=max_speakers
+                )
+
+                response = connector.transcribe(request)
+
+            if response.segments and response.has_diarization():
+                result['transcription'] = response.to_storage_format()
+            else:
+                result['transcription'] = response.text
+
+        result['processing_time_seconds'] = int(time.time() - start_time)
+        current_app.logger.info(f"[Incognito] Transcription completed in {result['processing_time_seconds']}s")
+
+        # Generate a title if we have transcription
+        if result['transcription'] and len(result['transcription']) > 10:
+            result['title'] = _generate_incognito_title(result['transcription'], user)
+
+        return result
+
+    except Exception as e:
+        current_app.logger.error(f"[Incognito] Transcription failed: {str(e)}", exc_info=True)
+        result['error'] = str(e)
+        result['processing_time_seconds'] = int(time.time() - start_time)
+        return result
+
+
+def _generate_incognito_title(transcription_text, user=None):
+    """Generate a title for incognito recording without database storage."""
+    if not client:
+        return "Incognito Recording"
+
+    try:
+        # Get formatted text for LLM
+        formatted_text = format_transcription_for_llm(transcription_text)
+        # Limit text for title generation
+        limited_text = formatted_text[:5000]
+
+        # Get user language preference
+        user_output_language = user.output_language if user else None
+        language_directive = f"Please provide the title in {user_output_language}." if user_output_language else ""
+
+        prompt_text = f"""Create a short title for this conversation:
+
+{limited_text}
+
+Requirements:
+- Maximum 8 words
+- No phrases like "Discussion about" or "Meeting on"
+- Just the main topic
+
+{language_directive}
+
+Title:"""
+
+        system_message_content = "You are an AI assistant that generates concise titles for audio transcriptions. Respond only with the title."
+        if user_output_language:
+            system_message_content += f" Ensure your response is in {user_output_language}."
+
+        # Use call_llm_completion without user_id tracking for incognito
+        completion = client.chat.completions.create(
+            model=TEXT_MODEL_NAME,
+            messages=[
+                {"role": "system", "content": system_message_content},
+                {"role": "user", "content": prompt_text}
+            ],
+            temperature=0.7,
+            # Match the main title-generation path so reasoning-model users
+            # have a single knob (TITLE_MAX_TOKENS) that covers both flows.
+            max_tokens=int(os.environ.get("TITLE_MAX_TOKENS", "5000"))
+        )
+
+        raw_response = completion.choices[0].message.content
+        title = clean_llm_response(raw_response) if raw_response else None
+
+        if title and len(title.strip()) > 0:
+            return title.strip()
+
+    except Exception as e:
+        current_app.logger.warning(f"[Incognito] Title generation failed: {e}")
+
+    return "Incognito Recording"
+
+
+def generate_incognito_summary(transcription_text, user=None):
+    """Generate a summary for incognito recording without database storage."""
+    if not client:
+        return None
+
+    try:
+        # Get formatted text for LLM
+        formatted_text = format_transcription_for_llm(transcription_text)
+
+        # Get configurable transcript length limit
+        transcript_limit = SystemSetting.get_setting('transcript_length_limit', 30000)
+        if transcript_limit == -1:
+            transcript_text = formatted_text
+        else:
+            transcript_text = formatted_text[:transcript_limit]
+
+        # Get user preferences
+        user_output_language = user.output_language if user else None
+        user_summary_prompt = user.summary_prompt if user else None
+
+        language_directive = f"IMPORTANT: You MUST provide the summary in {user_output_language}." if user_output_language else ""
+
+        # Determine summarization instructions
+        if user_summary_prompt:
+            summarization_instructions = user_summary_prompt
+        else:
+            admin_default_prompt = SystemSetting.get_setting('admin_default_summary_prompt', None)
+            if admin_default_prompt:
+                summarization_instructions = admin_default_prompt
+            else:
+                summarization_instructions = """Generate a comprehensive summary that includes the following sections:
+- **Key Issues Discussed**: A bulleted list of the main topics
+- **Key Decisions Made**: A bulleted list of any decisions reached
+- **Action Items**: A bulleted list of tasks assigned, including who is responsible if mentioned"""
+
+        # Build messages
+        system_message_content = "You are an AI assistant that generates comprehensive summaries for meeting transcripts. Respond only with the summary in Markdown format."
+        if user_output_language:
+            system_message_content += f" You MUST generate the entire summary in {user_output_language}."
+
+        prompt_text = f"""Transcription:
+\"\"\"
+{transcript_text}
+\"\"\"
+
+Summarization Instructions:
+{summarization_instructions}
+
+{language_directive}"""
+
+        current_app.logger.info(f"[Incognito] Generating summary...")
+
+        # Use client directly without user tracking for incognito
+        completion = client.chat.completions.create(
+            model=TEXT_MODEL_NAME,
+            messages=[
+                {"role": "system", "content": system_message_content},
+                {"role": "user", "content": prompt_text}
+            ],
+            temperature=0.5,
+            max_tokens=int(os.environ.get("SUMMARY_MAX_TOKENS", "3000"))
+        )
+
+        raw_response = completion.choices[0].message.content
+        summary = clean_llm_response(raw_response) if raw_response else None
+
+        if summary:
+            current_app.logger.info(f"[Incognito] Summary generated: {len(summary)} characters")
+            return summary
+
+    except Exception as e:
+        current_app.logger.warning(f"[Incognito] Summary generation failed: {e}")
+
+    return None
diff --git a/src/utils/__init__.py b/src/utils/__init__.py
new file mode 100644
index 00000000..5d909f1a
--- /dev/null
+++ b/src/utils/__init__.py
@@ -0,0 +1,80 @@
+"""
+Utility functions package for the Speakr application.
+
+This package contains various utility modules for:
+- JSON parsing and handling
+- Markdown to HTML conversion
+- Datetime formatting and timezone handling
+- Security utilities
+"""
+
+from .json_parser import (
+    auto_close_json,
+    safe_json_loads,
+    preprocess_json_escapes,
+    extract_json_object
+)
+
+from .markdown import (
+    md_to_html,
+    sanitize_html
+)
+
+from .datetime import (
+    local_datetime_filter
+)
+
+from .security import (
+    password_check,
+    is_safe_url
+)
+
+from .database import (
+    add_column_if_not_exists,
+    migrate_column_type,
+    create_index_if_not_exists
+)
+
+from .token_auth import (
+    extract_token_from_request,
+    hash_token,
+    load_user_from_token,
+    is_token_authenticated
+)
+
+from .error_formatting import (
+    is_transcription_error,
+    format_error_for_user,
+    format_error_for_storage,
+    parse_stored_error
+)
+
+__all__ = [
+    # JSON parsing
+    'auto_close_json',
+    'safe_json_loads',
+    'preprocess_json_escapes',
+    'extract_json_object',
+    # Markdown/HTML
+    'md_to_html',
+    'sanitize_html',
+    # Datetime
+    'local_datetime_filter',
+    # Security
+    'password_check',
+    'is_safe_url',
+    # Database
+    'add_column_if_not_exists',
+    'migrate_column_type',
+    'create_index_if_not_exists',
+    # Token authentication
+    'extract_token_from_request',
+    'hash_token',
+    'load_user_from_token',
+    'is_token_authenticated',
+    # Error formatting
+    'is_transcription_error',
+    'format_error_for_user',
+    'format_error_for_storage',
+    'parse_stored_error',
+]
diff --git a/src/utils/audio_conversion.py b/src/utils/audio_conversion.py
new file mode 100644
index 00000000..b13a9d9d
--- /dev/null
+++ b/src/utils/audio_conversion.py
@@ -0,0 +1,405 @@
+"""
+Audio conversion utility for handling codec detection and file conversion.
+
+This module provides a single, unified interface for handling ALL audio/video
+conversion needs:
+- Video to audio extraction
+- Unsupported codec conversion
+- Lossless audio compression
+
+Callers should ONLY use convert_if_needed() - it handles everything.
+"""
+
+import os
+import logging
+from pathlib import Path
+from typing import Optional, Tuple, Set, Dict, Any
+
+from src.utils.ffprobe import get_codec_info, is_lossless_audio, FFProbeError
+from src.utils.ffmpeg_utils import compress_audio, extract_audio_from_video, FFmpegError, FFmpegNotFoundError
+from src.config.app_config import AUDIO_COMPRESS_UPLOADS, AUDIO_CODEC, AUDIO_BITRATE, AUDIO_UNSUPPORTED_CODECS
+
+logger = logging.getLogger(__name__)
+
+
+class ConversionResult:
+    """Result of a conversion operation."""
+
+    def __init__(
+        self,
+        output_path: str,
+        mime_type: str,
+        was_converted: bool,
+        was_compressed: bool,
+        original_size: int,
+        final_size: int,
+        original_codec: Optional[str] = None,
+        final_codec: Optional[str] = None
+    ):
+        self.output_path = output_path
+        self.mime_type = mime_type
+        self.was_converted = was_converted
+        self.was_compressed = was_compressed
+        self.original_size = original_size
+        self.final_size = final_size
+        self.original_codec = original_codec
+        self.final_codec = final_codec
+
+    @property
+    def size_reduction_percent(self) -> float:
+        """Calculate size reduction percentage."""
+        if self.original_size == 0:
+            return 0.0
+        return ((self.original_size - self.final_size) / self.original_size) * 100
+
+    @property
+    def original_size_mb(self) -> float:
+        """Original size in megabytes."""
+        return self.original_size / (1024 * 1024)
+
+    @property
+    def final_size_mb(self) -> float:
+        """Final size in megabytes."""
+        return self.final_size / (1024 * 1024)
+
+
+def get_supported_codecs(needs_chunking: bool = False, connector_specs: Optional[Any] = None) -> Set[str]:
+    """
+    Get the set of supported audio codecs.
+
+    Args:
+        needs_chunking: If True, return only codecs that work well with chunking
+        connector_specs: Optional ConnectorSpecifications with provider-specific codec restrictions
+
+    Returns:
+        Set of supported codec names (minus any excluded via env var or connector specs)
+    """
+    # If connector defines explicit supported codecs, use those
+    if connector_specs and connector_specs.supported_codecs:
+        base_codecs = set(connector_specs.supported_codecs)
+    elif needs_chunking:
+        # For chunking: only support codecs that work well with chunking
+        base_codecs = {'pcm_s16le', 'pcm_s24le', 'pcm_f32le', 'mp3', 'flac'}
+    else:
+        # For direct transcription: support common formats
+        # Note: WebM containers are handled separately (by extension check in convert_if_needed)
+        # because MediaRecorder WebM files often lack seek cues, but the opus/vorbis codecs
+        # themselves are fine in proper containers (.opus, .ogg)
+        base_codecs = {'pcm_s16le', 'pcm_s24le', 'pcm_f32le', 'mp3', 'flac', 'aac', 'opus', 'vorbis'}
+
+    # Remove connector-specific unsupported codecs
+    if connector_specs and connector_specs.unsupported_codecs:
+        excluded = base_codecs & set(connector_specs.unsupported_codecs)
+        if excluded:
+            logger.info(f"Excluding codecs from supported list (via connector specs): {excluded}")
+        base_codecs = base_codecs - set(connector_specs.unsupported_codecs)
+
+    # Remove any global user-specified unsupported codecs (env var still applies)
+    if AUDIO_UNSUPPORTED_CODECS:
+        excluded = base_codecs & AUDIO_UNSUPPORTED_CODECS
+        if excluded:
+            logger.info(f"Excluding codecs from supported list (via AUDIO_UNSUPPORTED_CODECS): {excluded}")
+        return base_codecs - AUDIO_UNSUPPORTED_CODECS
+
+    return base_codecs
+
+
+def convert_if_needed(
+    filepath: str,
+    original_filename: Optional[str] = None,
+    codec_info: Optional[Dict[str, Any]] = None,
+    needs_chunking: bool = False,
+    is_asr_endpoint: bool = False,
+    delete_original: bool = True,
+    connector_specs: Optional[Any] = None
+) -> ConversionResult:
+    """
+    Handle ALL audio conversion needs in one place.
+
+    This is the ONLY function callers should use. It handles:
+    1. Video to audio extraction (if has_video)
+    2. Unsupported codec conversion (if codec not supported)
+    3. Lossless audio compression (if AUDIO_COMPRESS_UPLOADS enabled)
+
+    The function makes intelligent decisions about what processing is needed
+    and performs it in the optimal order.
+
+    Args:
+        filepath: Path to the audio/video file
+        original_filename: Original filename for logging (defaults to basename)
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+        needs_chunking: Whether chunking will be used (affects supported codecs)
+        is_asr_endpoint: Whether using ASR endpoint (affects AAC handling)
+        delete_original: Whether to delete original file after successful conversion
+        connector_specs: Optional ConnectorSpecifications with provider-specific codec restrictions
+
+    Returns:
+        ConversionResult with output path, mime type, and conversion stats
+
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not available
+        FFmpegError: If conversion fails
+    """
+    if original_filename is None:
+        original_filename = os.path.basename(filepath)
+
+    # Get original file size
+    original_size = os.path.getsize(filepath)
+
+    # Probe if codec info not provided
+    if codec_info is None:
+        try:
+            codec_info = get_codec_info(filepath, timeout=10)
+            logger.info(
+                f"Detected codec for {original_filename}: "
+                f"audio_codec={codec_info.get('audio_codec')}, "
+                f"has_video={codec_info.get('has_video', False)}"
+            )
+        except FFProbeError as e:
+            logger.warning(f"Failed to probe {filepath}: {e}. Will attempt conversion.")
+            codec_info = None
+
+    original_codec = codec_info.get('audio_codec') if codec_info else None
+    audio_codec = original_codec
+    has_video = codec_info.get('has_video', False) if codec_info else False
+
+    # Get supported codecs based on processing mode and connector specs
+    supported_codecs = get_supported_codecs(needs_chunking, connector_specs)
+
+    # Handle video files - extract audio
+    if has_video:
+        # Determine target codec for video extraction - fall back to mp3 if AUDIO_CODEC is unsupported
+        video_target_codec = AUDIO_CODEC
+        if connector_specs and connector_specs.unsupported_codecs:
+            if AUDIO_CODEC in connector_specs.unsupported_codecs:
+                video_target_codec = 'mp3'
+                logger.warning(
+                    f"AUDIO_CODEC '{AUDIO_CODEC}' is not supported by connector, "
+                    f"falling back to mp3 for video extraction from {original_filename}"
+                )
+
+        # Check if we can remux (copy) instead of transcode
+        can_remux = False
+        if audio_codec and audio_codec in supported_codecs:
+            try:
+                # Remux if audio is lossy, or if lossless but compression is disabled
+                is_lossless = is_lossless_audio(filepath, codec_info=codec_info)
+                can_remux = not is_lossless or not AUDIO_COMPRESS_UPLOADS
+            except Exception as e:
+                logger.warning(f"Could not determine if audio is lossless: {e}. Will transcode.")
+
+        try:
+            if can_remux:
+                logger.info(f"Extracting audio from video (remux, no transcoding): {original_filename}")
+                output_filepath, mime_type = extract_audio_from_video(
+                    filepath,
+                    output_format='copy',
+                    cleanup_original=delete_original,
+                    copy_stream=True
+                )
+                final_codec = audio_codec
+            else:
+                logger.info(f"Extracting and converting audio from video to {video_target_codec.upper()}: {original_filename}")
+                output_filepath, mime_type = extract_audio_from_video(
+                    filepath,
+                    output_format=video_target_codec,
+                    bitrate=AUDIO_BITRATE,
+                    cleanup_original=delete_original,
+                    copy_stream=False
+                )
+                final_codec = video_target_codec
+
+            final_size = os.path.getsize(output_filepath)
+            reduction = ((original_size - final_size) / original_size * 100) if original_size > 0 else 0
+
+            logger.info(
+                f"Successfully extracted audio from {original_filename}: "
+                f"{original_size/1024/1024:.1f}MB -> {final_size/1024/1024:.1f}MB "
+                f"({reduction:.1f}% reduction)"
+            )
+
+            return ConversionResult(
+                output_path=output_filepath,
+                mime_type=mime_type,
+                was_converted=not can_remux,
+                was_compressed=False,
+                original_size=original_size,
+                final_size=final_size,
+                original_codec=original_codec,
+                final_codec=final_codec
+            )
+        except FFmpegNotFoundError:
+            logger.error("FFmpeg not found")
+            raise
+        except FFmpegError as e:
+            logger.error(f"Failed to extract audio from video {filepath}: {e}")
+            raise
+    
+    # Handle audio files - check if conversion needed
+    needs_conversion = False
+    file_ext = os.path.splitext(filepath)[1].lower()
+
+    # Note: Connector-specific codec restrictions are handled via connector_specs.unsupported_codecs
+    # which is already applied in get_supported_codecs() above
+
+    if audio_codec is None:
+        needs_conversion = True
+        logger.info(f"Unknown codec for {original_filename}, will attempt conversion")
+    elif file_ext == '.webm':
+        # WebM containers from MediaRecorder often lack seek cues, making browser
+        # audio players unable to seek. Force conversion to a seekable format.
+        needs_conversion = True
+        logger.info(f"Converting {original_filename} - WebM container lacks seek support")
+    elif is_asr_endpoint and audio_codec == 'aac':
+        needs_conversion = True
+        logger.info(f"Converting AAC-encoded file for ASR endpoint compatibility")
+    elif audio_codec not in supported_codecs:
+        needs_conversion = True
+        logger.info(f"Converting {original_filename} (codec: {audio_codec}) - unsupported for processing")
+    
+    if needs_conversion:
+        # Determine target codec
+        # If chunking is needed, always convert to MP3 (chunking requires MP3 anyway)
+        # This avoids double conversion: original → configured codec → mp3
+        if needs_chunking:
+            target_codec = 'mp3'
+            logger.info(f"Using MP3 for {original_filename} since chunking is needed")
+        else:
+            # Fall back to mp3 if AUDIO_CODEC is unsupported by connector
+            target_codec = AUDIO_CODEC
+            if connector_specs and connector_specs.unsupported_codecs:
+                if AUDIO_CODEC in connector_specs.unsupported_codecs:
+                    target_codec = 'mp3'
+                    logger.warning(
+                        f"AUDIO_CODEC '{AUDIO_CODEC}' is not supported by connector, "
+                        f"falling back to mp3 for {original_filename}"
+                    )
+
+        logger.info(f"Converting {original_filename} to {target_codec.upper()}")
+
+        try:
+            output_filepath, mime_type, _ = compress_audio(
+                filepath,
+                codec=target_codec,
+                bitrate=AUDIO_BITRATE,
+                delete_original=delete_original,
+                codec_info=codec_info
+            )
+            
+            final_size = os.path.getsize(output_filepath)
+            reduction = ((original_size - final_size) / original_size * 100) if original_size > 0 else 0
+            
+            logger.info(
+                f"Successfully converted {original_filename}: "
+                f"{original_size/1024/1024:.1f}MB -> {final_size/1024/1024:.1f}MB "
+                f"({reduction:.1f}% reduction)"
+            )
+            
+            return ConversionResult(
+                output_path=output_filepath,
+                mime_type=mime_type,
+                was_converted=True,
+                was_compressed=False,
+                original_size=original_size,
+                final_size=final_size,
+                original_codec=original_codec,
+                final_codec=target_codec
+            )
+        except FFmpegNotFoundError:
+            logger.error("FFmpeg not found")
+            raise
+        except FFmpegError as e:
+            logger.error(f"FFmpeg conversion failed for {filepath}: {e}")
+            raise
+    
+    # Audio file with supported codec - check if we should compress lossless
+    logger.info(f"Codec {audio_codec} is supported, no conversion needed")
+
+    if AUDIO_COMPRESS_UPLOADS:
+        # Determine target codec for compression - fall back to mp3 if AUDIO_CODEC is unsupported
+        compress_target_codec = AUDIO_CODEC
+        if connector_specs and connector_specs.unsupported_codecs:
+            if AUDIO_CODEC in connector_specs.unsupported_codecs:
+                compress_target_codec = 'mp3'
+                logger.warning(
+                    f"AUDIO_CODEC '{AUDIO_CODEC}' is not supported by connector, "
+                    f"falling back to mp3 for lossless compression of {original_filename}"
+                )
+
+        try:
+            # Check if file is lossless
+            if is_lossless_audio(filepath, codec_info=codec_info):
+                # Skip if already in target codec (e.g., FLAC to FLAC)
+                if audio_codec == compress_target_codec:
+                    logger.info(f"File already in target codec {compress_target_codec}, no compression needed")
+                    return ConversionResult(
+                        output_path=filepath,
+                        mime_type=_guess_mime_type(filepath),
+                        was_converted=False,
+                        was_compressed=False,
+                        original_size=original_size,
+                        final_size=original_size,
+                        original_codec=original_codec,
+                        final_codec=audio_codec
+                    )
+
+                logger.info(f"Compressing lossless audio ({audio_codec}) to {compress_target_codec.upper()}")
+
+                # Perform compression
+                compressed_path, mime_type, _ = compress_audio(
+                    filepath,
+                    codec=compress_target_codec,
+                    bitrate=AUDIO_BITRATE,
+                    delete_original=delete_original,
+                    codec_info=codec_info
+                )
+
+                final_size = os.path.getsize(compressed_path)
+                reduction = ((original_size - final_size) / original_size * 100) if original_size > 0 else 0
+
+                logger.info(
+                    f"Successfully compressed {original_filename}: "
+                    f"{original_size/1024/1024:.1f}MB -> {final_size/1024/1024:.1f}MB "
+                    f"({reduction:.1f}% reduction)"
+                )
+
+                return ConversionResult(
+                    output_path=compressed_path,
+                    mime_type=mime_type,
+                    was_converted=False,
+                    was_compressed=True,
+                    original_size=original_size,
+                    final_size=final_size,
+                    original_codec=original_codec,
+                    final_codec=compress_target_codec
+                )
+        except Exception as e:
+            logger.warning(f"Failed to compress lossless audio: {e}. Continuing with original.")
+            # Fall through to return original file
+
+    # No processing needed - return original file
+    return ConversionResult(
+        output_path=filepath,
+        mime_type=_guess_mime_type(filepath),
+        was_converted=False,
+        was_compressed=False,
+        original_size=original_size,
+        final_size=original_size,
+        original_codec=original_codec,
+        final_codec=audio_codec
+    )
+
+
+def _guess_mime_type(filepath: str) -> str:
+    """
+    Guess MIME type from file extension.
+
+    Args:
+        filepath: Path to the file
+
+    Returns:
+        MIME type string
+    """
+    import mimetypes
+    mime_type, _ = mimetypes.guess_type(filepath)
+    return mime_type or 'application/octet-stream'
diff --git a/src/utils/database.py b/src/utils/database.py
new file mode 100644
index 00000000..a0ac0a31
--- /dev/null
+++ b/src/utils/database.py
@@ -0,0 +1,227 @@
+"""
+Database schema migration utilities.
+
+IMPORTANT: All migrations must be compatible with both SQLite and PostgreSQL.
+- Boolean defaults: SQLite uses 0/1, PostgreSQL requires FALSE/TRUE
+- Type differences: SQLite DATETIME -> PostgreSQL TIMESTAMP, BLOB -> BYTEA
+- Reserved keywords: "user", "order" etc. must be quoted
+- The add_column_if_not_exists() function handles these automatically
+- Use create_index_if_not_exists() for index creation with proper quoting
+"""
+
+import re
+from sqlalchemy import inspect, text
+
+
+def add_column_if_not_exists(engine, table_name, column_name, column_type):
+    """
+    Add a column to a table if it doesn't already exist.
+
+    Args:
+        engine: SQLAlchemy engine
+        table_name: Name of the table
+        column_name: Name of the column to add
+        column_type: SQL type definition for the column
+
+    Returns:
+        bool: True if column was added, False if it already existed
+    """
+    inspector = inspect(engine)
+    columns = [col['name'] for col in inspector.get_columns(table_name)]
+
+    if column_name not in columns:
+        if engine.name == 'postgresql':
+            # PostgreSQL requires TRUE/FALSE for boolean defaults, not 0/1
+            if 'BOOLEAN' in column_type.upper():
+                column_type = column_type.replace('DEFAULT 0', 'DEFAULT FALSE')
+                column_type = column_type.replace('DEFAULT 1', 'DEFAULT TRUE')
+
+            # PostgreSQL uses TIMESTAMP, not DATETIME
+            column_type = re.sub(r'\bDATETIME\b', 'TIMESTAMP', column_type, flags=re.IGNORECASE)
+
+            # PostgreSQL uses BYTEA, not BLOB
+            column_type = re.sub(r'\bBLOB\b', 'BYTEA', column_type, flags=re.IGNORECASE)
+
+            # PostgreSQL interprets double-quoted strings as identifiers, not literals
+            # Convert DEFAULT "value" to DEFAULT 'value'
+            column_type = re.sub(r'''DEFAULT\s+"([^"]*)"''', r"DEFAULT '\1'", column_type, flags=re.IGNORECASE)
+
+        with engine.connect() as conn:
+            # Quote identifiers to handle reserved keywords (e.g., "user" in PostgreSQL)
+            # MySQL uses backticks, PostgreSQL/SQLite use double quotes
+            # Handle special case where column_type includes the column name
+            if column_name in column_type:
+                if engine.name == 'mysql':
+                    conn.execute(text(f'ALTER TABLE `{table_name}` ADD COLUMN {column_type}'))
+                else:
+                    conn.execute(text(f'ALTER TABLE "{table_name}" ADD COLUMN {column_type}'))
+            else:
+                if engine.name == 'mysql':
+                    conn.execute(text(f'ALTER TABLE `{table_name}` ADD COLUMN `{column_name}` {column_type}'))
+                else:
+                    conn.execute(text(f'ALTER TABLE "{table_name}" ADD COLUMN "{column_name}" {column_type}'))
+            conn.commit()
+        return True
+    return False
+
+
+def create_index_if_not_exists(engine, index_name, table_name, columns, unique=False):
+    """
+    Create an index on a table if it doesn't already exist.
+
+    Handles cross-database compatibility by properly quoting table names,
+    especially important for reserved keywords like 'user', 'order', etc.
+
+    Args:
+        engine: SQLAlchemy engine
+        index_name: Name of the index to create
+        table_name: Name of the table
+        columns: Column(s) to index (string, can be comma-separated for composite)
+        unique: Whether to create a unique index (default False)
+
+    Returns:
+        bool: True if index was created, False if it already existed or table doesn't exist
+    """
+    inspector = inspect(engine)
+
+    # Check if table exists
+    if table_name not in inspector.get_table_names():
+        return False
+
+    # Check if index already exists
+    existing_indexes = [idx['name'] for idx in inspector.get_indexes(table_name)]
+    if index_name in existing_indexes:
+        return False
+
+    unique_clause = 'UNIQUE ' if unique else ''
+
+    with engine.connect() as conn:
+        # Quote table name to handle reserved keywords (e.g., "user" in PostgreSQL)
+        # MySQL uses backticks, PostgreSQL/SQLite use double quotes
+        if engine.name == 'mysql':
+            quoted_table = f'`{table_name}`'
+        else:
+            quoted_table = f'"{table_name}"'
+
+        # Note: IF NOT EXISTS may not be supported on all databases, but we already
+        # checked for existence above, so it's just a safety net
+        try:
+            conn.execute(text(
+                f'CREATE {unique_clause}INDEX IF NOT EXISTS {index_name} ON {quoted_table} ({columns})'
+            ))
+        except Exception:
+            # Some databases don't support IF NOT EXISTS, try without
+            conn.execute(text(
+                f'CREATE {unique_clause}INDEX {index_name} ON {quoted_table} ({columns})'
+            ))
+        conn.commit()
+    return True
+
+
+def migrate_column_type(engine, table_name, column_name, new_type, transform_sql=None):
+    """
+    Migrate a column to a new type if it exists.
+
+    For SQLite, this uses a temporary column approach since SQLite doesn't support ALTER COLUMN.
+
+    Args:
+        engine: SQLAlchemy engine
+        table_name: Name of the table
+        column_name: Name of the column to modify
+        new_type: New SQL type for the column
+        transform_sql: Optional SQL expression to transform existing data (e.g., "datetime(meeting_date || ' 12:00:00')")
+                       If None, data is copied as-is
+
+    Returns:
+        bool: True if column was migrated, False if it didn't exist or migration wasn't needed
+    """
+    inspector = inspect(engine)
+
+    # Check if table exists
+    if table_name not in inspector.get_table_names():
+        return False
+
+    columns = {col['name']: col for col in inspector.get_columns(table_name)}
+
+    if column_name not in columns:
+        return False
+
+    engine_name = engine.name
+
+    with engine.connect() as conn:
+        if engine_name == 'sqlite':
+            # SQLite approach: use temporary column
+            temp_col = f"{column_name}_new"
+
+            # Check if temp column already exists (migration interrupted?)
+            if temp_col in columns:
+                try:
+                    # Try to drop it and start over
+                    conn.execute(text(f'ALTER TABLE "{table_name}" DROP COLUMN "{temp_col}"'))
+                    conn.commit()
+                except Exception:
+                    # If we can't drop it, the migration may have partially completed
+                    # Check if old column still exists
+                    if column_name not in columns:
+                        # Old column is gone, temp exists - just rename temp to complete migration
+                        try:
+                            conn.execute(text(f'ALTER TABLE "{table_name}" RENAME COLUMN "{temp_col}" TO "{column_name}"'))
+                            conn.commit()
+                            return True
+                        except Exception as e:
+                            # Can't complete, leave as-is
+                            return False
+                    # Both columns exist - abort to avoid data issues
+                    return False
+
+            # Add temporary column with new type
+            conn.execute(text(f'ALTER TABLE "{table_name}" ADD COLUMN "{temp_col}" {new_type}'))
+
+            # Copy data with optional transformation
+            if transform_sql:
+                conn.execute(text(f'UPDATE "{table_name}" SET "{temp_col}" = {transform_sql} WHERE "{column_name}" IS NOT NULL'))
+            else:
+                conn.execute(text(f'UPDATE "{table_name}" SET "{temp_col}" = "{column_name}"'))
+
+            # Drop old column (SQLite 3.35.0+ only)
+            try:
+                conn.execute(text(f'ALTER TABLE "{table_name}" DROP COLUMN "{column_name}"'))
+                # Drop succeeded, now rename temp to original name
+                conn.execute(text(f'ALTER TABLE "{table_name}" RENAME COLUMN "{temp_col}" TO "{column_name}"'))
+                conn.commit()
+            except Exception:
+                # Older SQLite - can't drop columns
+                # Rename temp column to original name (this will fail if original still exists)
+                try:
+                    conn.execute(text(f'ALTER TABLE "{table_name}" RENAME COLUMN "{temp_col}" TO "{column_name}"'))
+                    conn.commit()
+                except Exception:
+                    # Can't rename because old column exists - this is OK for SQLite
+                    # Just keep the new column and let the app use the old one
+                    # The data in the old column is still valid
+                    conn.rollback()
+                    # Actually, let's just commit the temp column addition
+                    # The model will use column_name which still exists with old data
+                    # This is safe - new records will use the new model definition
+                    return False
+
+        elif engine_name == 'postgresql':
+            # PostgreSQL can alter column type directly
+            if transform_sql:
+                conn.execute(text(f'ALTER TABLE "{table_name}" ALTER COLUMN "{column_name}" TYPE {new_type} USING {transform_sql}'))
+            else:
+                conn.execute(text(f'ALTER TABLE "{table_name}" ALTER COLUMN "{column_name}" TYPE {new_type}'))
+            conn.commit()
+
+        elif engine_name == 'mysql':
+            # MySQL can modify column type
+            conn.execute(text(f'ALTER TABLE `{table_name}` MODIFY COLUMN `{column_name}` {new_type}'))
+
+            # Apply transformation if provided
+            if transform_sql:
+                conn.execute(text(f'UPDATE `{table_name}` SET `{column_name}` = {transform_sql} WHERE `{column_name}` IS NOT NULL'))
+            conn.commit()
+
+        return True
+
+    return False
diff --git a/src/utils/datetime.py b/src/utils/datetime.py
new file mode 100644
index 00000000..28e21bc5
--- /dev/null
+++ b/src/utils/datetime.py
@@ -0,0 +1,46 @@
+"""
+Datetime utilities for timezone handling and formatting.
+
+This module provides functions for converting and formatting datetimes
+with timezone awareness.
+"""
+
+import os
+import logging
+import pytz
+from babel.dates import format_datetime
+
+# Module-level logger
+logger = logging.getLogger(__name__)
+
+
+def local_datetime_filter(dt):
+    """
+    Format a UTC datetime object to the user's local timezone.
+
+    Args:
+        dt: datetime object to format (assumed UTC if naive)
+
+    Returns:
+        str: Formatted datetime string in user's timezone
+    """
+    if dt is None:
+        return ""
+
+    # Get timezone from .env, default to UTC
+    user_tz_name = os.environ.get('TIMEZONE', 'UTC')
+    try:
+        user_tz = pytz.timezone(user_tz_name)
+    except pytz.UnknownTimeZoneError:
+        user_tz = pytz.utc
+        logger.warning(f"Invalid TIMEZONE '{user_tz_name}' in .env. Defaulting to UTC.")
+
+    # If the datetime object is naive, assume it's UTC
+    if dt.tzinfo is None:
+        dt = pytz.utc.localize(dt)
+
+    # Convert to the user's timezone
+    local_dt = dt.astimezone(user_tz)
+
+    # Format it nicely
+    return format_datetime(local_dt, format='medium', locale='en_US')
diff --git a/src/utils/error_formatting.py b/src/utils/error_formatting.py
new file mode 100644
index 00000000..591f8ce3
--- /dev/null
+++ b/src/utils/error_formatting.py
@@ -0,0 +1,367 @@
+"""
+User-friendly error formatting utility.
+
+Transforms technical error messages into user-friendly explanations with
+actionable guidance. Works for both known error patterns and unknown errors.
+"""
+
+import re
+import json
+from typing import Dict, Optional, Tuple
+
+
+# Known error patterns with user-friendly messages
+ERROR_PATTERNS = [
+    # File size errors
+    {
+        'patterns': [
+            r'maximum content size limit.*exceeded',
+            r'file.*too large',
+            r'413.*exceeded',
+            r'payload too large',
+        ],
+        'title': 'File Too Large',
+        'message': 'The audio file exceeds the maximum size allowed by the transcription service.',
+        'guidance': 'Try enabling audio chunking in your settings, or compress the audio file before uploading.',
+        'icon': 'fa-file-audio',
+        'type': 'size_limit'
+    },
+    # Timeout errors
+    {
+        'patterns': [
+            r'timed?\s*out',
+            r'timeout',
+            r'deadline exceeded',
+            r'request took too long',
+        ],
+        'title': 'Processing Timeout',
+        'message': 'The transcription took too long to complete.',
+        'guidance': 'This can happen with very long recordings. Try splitting the audio into smaller parts, or increase the timeout setting if available.',
+        'icon': 'fa-clock',
+        'type': 'timeout'
+    },
+    # Authentication errors
+    {
+        'patterns': [
+            r'401.*unauthorized',
+            r'invalid.*api.*key',
+            r'authentication.*failed',
+            r'api key.*invalid',
+            r'incorrect api key',
+        ],
+        'title': 'Authentication Error',
+        'message': 'The transcription service rejected the API credentials.',
+        'guidance': 'Please check that your API key is correct and has not expired. Contact your administrator if the problem persists.',
+        'icon': 'fa-key',
+        'type': 'auth'
+    },
+    # Rate limit errors
+    {
+        'patterns': [
+            r'rate.*limit',
+            r'too many requests',
+            r'429',
+            r'quota.*exceeded',
+        ],
+        'title': 'Rate Limit Exceeded',
+        'message': 'Too many requests were sent to the transcription service.',
+        'guidance': 'Please wait a few minutes before trying again. The system will automatically retry failed jobs.',
+        'icon': 'fa-hourglass-half',
+        'type': 'rate_limit'
+    },
+    # Connection errors
+    {
+        'patterns': [
+            r'connection.*refused',
+            r'connection.*reset',
+            r'could not connect',
+            r'network.*unreachable',
+            r'name.*resolution.*failed',
+            r'dns.*failed',
+        ],
+        'title': 'Connection Error',
+        'message': 'Could not connect to the transcription service.',
+        'guidance': 'Please check your internet connection and ensure the transcription service is available. If using a self-hosted service, verify it is running.',
+        'icon': 'fa-wifi',
+        'type': 'connection'
+    },
+    # Service unavailable
+    {
+        'patterns': [
+            r'503.*service unavailable',
+            r'502.*bad gateway',
+            r'500.*internal server error',
+            r'service.*unavailable',
+            r'server.*error',
+        ],
+        'title': 'Service Unavailable',
+        'message': 'The transcription service is temporarily unavailable.',
+        'guidance': 'This is usually temporary. Please try again in a few minutes.',
+        'icon': 'fa-server',
+        'type': 'service_error'
+    },
+    # Invalid audio format
+    {
+        'patterns': [
+            r'invalid.*file.*format',
+            r'unsupported.*format',
+            r'could not.*decode',
+            r'audio.*corrupt',
+            r'not.*valid.*audio',
+        ],
+        'title': 'Invalid Audio Format',
+        'message': 'The audio file format is not supported or the file may be corrupted.',
+        'guidance': 'Try converting the audio to MP3 or WAV format before uploading. If the file plays correctly on your device, try re-exporting it.',
+        'icon': 'fa-file-audio',
+        'type': 'format'
+    },
+    # Insufficient funds/billing
+    {
+        'patterns': [
+            r'insufficient.*funds',
+            r'billing.*issue',
+            r'payment.*required',
+            r'account.*suspended',
+        ],
+        'title': 'Billing Issue',
+        'message': 'There is a billing issue with the transcription service account.',
+        'guidance': 'Please check your account status and payment information with the transcription service provider.',
+        'icon': 'fa-credit-card',
+        'type': 'billing'
+    },
+    # Model not found
+    {
+        'patterns': [
+            r'model.*not.*found',
+            r'invalid.*model',
+            r'model.*does not exist',
+        ],
+        'title': 'Model Not Available',
+        'message': 'The requested transcription model is not available.',
+        'guidance': 'Please check the model name in your settings. The model may have been deprecated or renamed.',
+        'icon': 'fa-microchip',
+        'type': 'model'
+    },
+    # Audio extraction failed
+    {
+        'patterns': [
+            r'audio.*extraction.*failed',
+            r'could not.*extract.*audio',
+            r'ffmpeg.*failed',
+            r'no audio.*stream',
+        ],
+        'title': 'Audio Extraction Failed',
+        'message': 'Could not extract audio from the uploaded file.',
+        'guidance': 'The file may be corrupted or in an unsupported format. Try converting it to a standard audio format (MP3, WAV) before uploading.',
+        'icon': 'fa-file-video',
+        'type': 'extraction'
+    },
+]
+
+
+def extract_error_details(error_text: str) -> Dict:
+    """
+    Extract structured error details from raw error text.
+    Attempts to parse JSON error responses from APIs.
+    """
+    details = {
+        'raw': error_text,
+        'code': None,
+        'message': None,
+        'type': None,
+    }
+
+    # Try to extract error code
+    code_match = re.search(r'(?:error\s*code|status)[:\s]*(\d{3})', error_text, re.IGNORECASE)
+    if code_match:
+        details['code'] = code_match.group(1)
+
+    # Try to parse JSON error structure
+    json_match = re.search(r'\{[^{}]*["\']error["\'][^{}]*\}', error_text)
+    if json_match:
+        try:
+            # Clean up the JSON-like string
+            json_str = json_match.group(0).replace("'", '"')
+            error_obj = json.loads(json_str)
+            if 'error' in error_obj:
+                err = error_obj['error']
+                if isinstance(err, dict):
+                    details['message'] = err.get('message')
+                    details['type'] = err.get('type')
+                    details['code'] = details['code'] or err.get('code')
+        except (json.JSONDecodeError, KeyError):
+            pass
+
+    # Try to extract message from common patterns
+    if not details['message']:
+        msg_match = re.search(r"['\"]message['\"]\s*:\s*['\"]([^'\"]+)['\"]", error_text)
+        if msg_match:
+            details['message'] = msg_match.group(1)
+
+    return details
+
+
+def format_error_for_user(error_text: str) -> Dict:
+    """
+    Transform a technical error message into a user-friendly format.
+
+    Returns:
+        Dict with keys:
+        - title: Short, user-friendly title
+        - message: Plain language explanation
+        - guidance: Actionable suggestion
+        - icon: FontAwesome icon class
+        - type: Error category
+        - technical: Original error (for advanced users/debugging)
+        - is_known: Whether this matched a known pattern
+    """
+    if not error_text:
+        return {
+            'title': 'Unknown Error',
+            'message': 'An unexpected error occurred.',
+            'guidance': 'Please try again. If the problem persists, contact support.',
+            'icon': 'fa-exclamation-triangle',
+            'type': 'unknown',
+            'technical': '',
+            'is_known': False
+        }
+
+    error_lower = error_text.lower()
+
+    # Check against known patterns
+    for pattern_info in ERROR_PATTERNS:
+        for pattern in pattern_info['patterns']:
+            if re.search(pattern, error_lower):
+                return {
+                    'title': pattern_info['title'],
+                    'message': pattern_info['message'],
+                    'guidance': pattern_info['guidance'],
+                    'icon': pattern_info['icon'],
+                    'type': pattern_info['type'],
+                    'technical': error_text,
+                    'is_known': True
+                }
+
+    # Unknown error - try to make it more readable
+    details = extract_error_details(error_text)
+
+    # Clean up the error message for display
+    clean_message = details['message'] or error_text
+
+    # Remove common prefixes
+    for prefix in ['Transcription failed:', 'Processing failed:', 'Error:', 'Exception:']:
+        if clean_message.startswith(prefix):
+            clean_message = clean_message[len(prefix):].strip()
+
+    # Truncate very long messages
+    if len(clean_message) > 200:
+        clean_message = clean_message[:200] + '...'
+
+    # Generate a reasonable title based on error code
+    title = 'Processing Error'
+    if details['code']:
+        code = details['code']
+        if code.startswith('4'):
+            title = 'Request Error'
+        elif code.startswith('5'):
+            title = 'Server Error'
+
+    return {
+        'title': title,
+        'message': clean_message,
+        'guidance': 'If this error persists, try reprocessing the recording or contact support for assistance.',
+        'icon': 'fa-exclamation-circle',
+        'type': 'unknown',
+        'technical': error_text,
+        'is_known': False
+    }
+
+
+def format_error_for_storage(error_text: str) -> str:
+    """
+    Format an error message for storage in the database.
+    Returns a JSON string that can be parsed by the frontend for nice display.
+
+    The format is: ERROR_JSON:{"title": "...", "message": "...", ...}
+
+    This allows the frontend to detect formatted errors and display them nicely,
+    while still being human-readable if viewed raw.
+    """
+    formatted = format_error_for_user(error_text)
+
+    # Create a compact JSON representation
+    error_data = {
+        't': formatted['title'],
+        'm': formatted['message'],
+        'g': formatted['guidance'],
+        'i': formatted['icon'],
+        'y': formatted['type'],
+        'k': formatted['is_known'],
+    }
+
+    # Always include the raw technical detail when present, so the UI's
+    # "Technical details" panel has something to show even for unknown errors
+    # where the user-facing message is the same as the raw text.
+    if formatted['technical']:
+        error_data['d'] = formatted['technical'][:500]  # Limit technical detail length
+
+    try:
+        json_str = json.dumps(error_data, ensure_ascii=False)
+        return f"ERROR_JSON:{json_str}"
+    except (TypeError, ValueError):
+        # Fallback to plain text if JSON encoding fails
+        return f"{formatted['title']}: {formatted['message']}"
+
+
+def parse_stored_error(stored_text: str) -> Optional[Dict]:
+    """
+    Parse a stored error message. Returns the formatted error dict if it's
+    a JSON-formatted error, or None if it's plain text.
+    """
+    if not stored_text or not stored_text.startswith('ERROR_JSON:'):
+        return None
+
+    try:
+        json_str = stored_text[11:]  # Remove 'ERROR_JSON:' prefix
+        data = json.loads(json_str)
+        return {
+            'title': data.get('t', 'Error'),
+            'message': data.get('m', 'An error occurred'),
+            'guidance': data.get('g', ''),
+            'icon': data.get('i', 'fa-exclamation-circle'),
+            'type': data.get('y', 'unknown'),
+            'is_known': data.get('k', False),
+            'technical': data.get('d', ''),
+        }
+    except (json.JSONDecodeError, KeyError, TypeError):
+        return None
+
+
+def is_transcription_error(transcription_text: str) -> bool:
+    """
+    Check if the transcription text is actually an error message.
+
+    Returns True if the text is an error message (not valid transcription content).
+    This should be used to prevent operations like summarization or chat on failed recordings.
+    """
+    if not transcription_text:
+        return False
+
+    # Check for JSON-formatted error
+    if transcription_text.startswith('ERROR_JSON:'):
+        return True
+
+    # Check for legacy error prefixes
+    error_prefixes = [
+        'Transcription failed:',
+        'Processing failed:',
+        'ASR processing failed:',
+        'Audio extraction failed:',
+        'Upload/Processing failed:',
+    ]
+
+    for prefix in error_prefixes:
+        if transcription_text.startswith(prefix):
+            return True
+
+    return False
diff --git a/src/utils/ffmpeg_utils.py b/src/utils/ffmpeg_utils.py
new file mode 100644
index 00000000..50725280
--- /dev/null
+++ b/src/utils/ffmpeg_utils.py
@@ -0,0 +1,448 @@
+"""Centralized FFmpeg utilities for consistent audio/video processing."""
+
+import os
+import subprocess
+import tempfile
+from contextlib import contextmanager
+from typing import Optional, Tuple
+from flask import current_app
+
+
+# Configuration constants
+DEFAULT_MP3_BITRATE = os.getenv('AUDIO_BITRATE', '128k')
+DEFAULT_SAMPLE_RATE = os.getenv('AUDIO_SAMPLE_RATE', '44100')
+DEFAULT_CHANNELS = int(os.getenv('AUDIO_CHANNELS', '1'))  # Mono for speech
+DEFAULT_COMPRESSION_LEVEL = int(os.getenv('AUDIO_COMPRESSION_LEVEL', '2'))
+
+
+class FFmpegError(Exception):
+    """Custom exception for FFmpeg-related errors."""
+    pass
+
+
+class FFmpegNotFoundError(FFmpegError):
+    """Raised when FFmpeg executable is not found."""
+    pass
+
+
+def convert_to_mp3(
+    input_path: str,
+    output_path: Optional[str] = None,
+    bitrate: str = DEFAULT_MP3_BITRATE,
+    sample_rate: str = DEFAULT_SAMPLE_RATE,
+    channels: int = DEFAULT_CHANNELS,
+    compression_level: int = DEFAULT_COMPRESSION_LEVEL
+) -> str:
+    """
+    Convert audio/video file to MP3 format using FFmpeg.
+    
+    Args:
+        input_path: Path to input audio/video file
+        output_path: Path for output MP3 file (auto-generated if None)
+        bitrate: MP3 bitrate (e.g., '128k', '192k')
+        sample_rate: Sample rate in Hz (e.g., '44100', '48000')
+        channels: Number of audio channels (1=mono, 2=stereo)
+        compression_level: MP3 compression level (0-9, higher=better compression)
+    
+    Returns:
+        Path to the created MP3 file
+        
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not installed
+        FFmpegError: If conversion fails
+    """
+    if output_path is None:
+        base = os.path.splitext(input_path)[0]
+        output_path = f"{base}.mp3"
+    
+    cmd = [
+        'ffmpeg',
+        '-i', input_path,
+        '-y',  # Overwrite output
+        '-acodec', 'libmp3lame',
+        '-b:a', bitrate,
+        '-ar', sample_rate,
+        '-ac', str(channels),
+        '-compression_level', str(compression_level),
+        output_path
+    ]
+    
+    _run_ffmpeg_command(cmd, f"MP3 conversion of {os.path.basename(input_path)}")
+    return output_path
+
+
+def extract_audio_from_video(
+    video_path: str,
+    output_format: str = 'mp3',
+    bitrate: str = DEFAULT_MP3_BITRATE,
+    cleanup_original: bool = True,
+    copy_stream: bool = False
+) -> Tuple[str, str]:
+    """
+    Extract audio track from video file.
+    
+    Args:
+        video_path: Path to video file
+        output_format: Audio format ('mp3', 'wav', 'flac', 'copy')
+        bitrate: Audio bitrate for lossy formats (ignored if copy_stream=True)
+        cleanup_original: Whether to delete the original video file
+        copy_stream: If True, copy audio stream without re-encoding (fast, preserves quality)
+                    If False, re-encode to specified format
+    
+    Returns:
+        Tuple of (audio_filepath, mime_type)
+        
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not installed
+        FFmpegError: If extraction fails
+    """
+    base_path = os.path.splitext(video_path)[0]
+    
+    try:
+        if copy_stream or output_format == 'copy':
+            # Copy audio stream without re-encoding - need to detect the format first
+            from src.utils.ffprobe import get_codec_info
+            
+            try:
+                codec_info = get_codec_info(video_path, timeout=10)
+                audio_codec = codec_info.get('audio_codec', 'unknown')
+                
+                # Map codec to extension and MIME type
+                codec_map = {
+                    'aac': {'ext': 'm4a', 'mime': 'audio/mp4'},
+                    'mp3': {'ext': 'mp3', 'mime': 'audio/mpeg'},
+                    'opus': {'ext': 'opus', 'mime': 'audio/opus'},
+                    'vorbis': {'ext': 'ogg', 'mime': 'audio/ogg'},
+                    'flac': {'ext': 'flac', 'mime': 'audio/flac'},
+                }
+                
+                if audio_codec in codec_map:
+                    output_ext = codec_map[audio_codec]['ext']
+                    mime_type = codec_map[audio_codec]['mime']
+                else:
+                    # Default to m4a for unknown codecs
+                    current_app.logger.warning(f"Unknown audio codec '{audio_codec}', defaulting to m4a container")
+                    output_ext = 'm4a'
+                    mime_type = 'audio/mp4'
+                
+                temp_audio_path = f"{base_path}_audio_temp.{output_ext}"
+                final_audio_path = f"{base_path}_audio.{output_ext}"
+                
+                cmd = [
+                    'ffmpeg',
+                    '-i', video_path,
+                    '-y',
+                    '-vn',  # No video
+                    '-acodec', 'copy',  # Copy audio stream without re-encoding
+                    temp_audio_path
+                ]
+                
+                current_app.logger.info(f"Copying audio stream (codec: {audio_codec}) without re-encoding")
+                
+            except Exception as probe_error:
+                current_app.logger.warning(f"Failed to detect audio codec: {probe_error}. Falling back to MP3 encoding.")
+                # Fallback to MP3 encoding if we can't detect the codec
+                output_ext = 'mp3'
+                mime_type = 'audio/mpeg'
+                temp_audio_path = f"{base_path}_audio_temp.{output_ext}"
+                final_audio_path = f"{base_path}_audio.{output_ext}"
+                
+                cmd = [
+                    'ffmpeg',
+                    '-i', video_path,
+                    '-y',
+                    '-vn',
+                    '-acodec', 'libmp3lame',
+                    '-b:a', bitrate,
+                    '-ar', DEFAULT_SAMPLE_RATE,
+                    '-ac', str(DEFAULT_CHANNELS),
+                    '-compression_level', str(DEFAULT_COMPRESSION_LEVEL),
+                    temp_audio_path
+                ]
+        
+        elif output_format == 'mp3':
+            temp_audio_path = f"{base_path}_audio_temp.mp3"
+            final_audio_path = f"{base_path}_audio.mp3"
+            cmd = [
+                'ffmpeg',
+                '-i', video_path,
+                '-y',
+                '-vn',  # No video
+                '-acodec', 'libmp3lame',
+                '-b:a', bitrate,
+                '-ar', DEFAULT_SAMPLE_RATE,
+                '-ac', str(DEFAULT_CHANNELS),
+                '-compression_level', str(DEFAULT_COMPRESSION_LEVEL),
+                temp_audio_path
+            ]
+            mime_type = 'audio/mpeg'
+        elif output_format == 'wav':
+            temp_audio_path = f"{base_path}_audio_temp.wav"
+            final_audio_path = f"{base_path}_audio.wav"
+            cmd = [
+                'ffmpeg',
+                '-i', video_path,
+                '-y',
+                '-vn',
+                '-acodec', 'pcm_s16le',
+                '-ar', DEFAULT_SAMPLE_RATE,
+                temp_audio_path
+            ]
+            mime_type = 'audio/wav'
+        elif output_format == 'flac':
+            temp_audio_path = f"{base_path}_audio_temp.flac"
+            final_audio_path = f"{base_path}_audio.flac"
+            cmd = [
+                'ffmpeg',
+                '-i', video_path,
+                '-y',
+                '-vn',
+                '-acodec', 'flac',
+                '-compression_level', '12',
+                temp_audio_path
+            ]
+            mime_type = 'audio/flac'
+        elif output_format == 'opus':
+            temp_audio_path = f"{base_path}_audio_temp.opus"
+            final_audio_path = f"{base_path}_audio.opus"
+            cmd = [
+                'ffmpeg',
+                '-i', video_path,
+                '-y',
+                '-vn',
+                '-acodec', 'libopus',
+                '-b:a', bitrate,
+                temp_audio_path
+            ]
+            mime_type = 'audio/opus'
+        else:
+            raise ValueError(f"Unsupported output format: {output_format}")
+        
+        _run_ffmpeg_command(cmd, f"Audio extraction from {os.path.basename(video_path)}")
+        
+        # Optionally preserve temp file for debugging
+        if os.getenv('PRESERVE_TEMP_AUDIO', 'false').lower() == 'true':
+            import shutil
+            debug_path = temp_audio_path.replace('_temp', '_debug')
+            shutil.copy2(temp_audio_path, debug_path)
+            current_app.logger.info(f"Debug: Preserved temp audio file as {debug_path}")
+        
+        # Rename temp file to final filename
+        os.rename(temp_audio_path, final_audio_path)
+        
+        if cleanup_original:
+            try:
+                os.remove(video_path)
+                current_app.logger.info(f"Cleaned up original video: {os.path.basename(video_path)}")
+            except Exception as e:
+                current_app.logger.warning(f"Failed to cleanup video {video_path}: {e}")
+        
+        return final_audio_path, mime_type
+        
+    except Exception as e:
+        # Clean up temp file on error
+        if os.path.exists(temp_audio_path):
+            try:
+                os.remove(temp_audio_path)
+            except:
+                pass
+        raise
+
+
+def compress_audio(
+    input_path: str,
+    codec: str = 'mp3',
+    bitrate: str = DEFAULT_MP3_BITRATE,
+    delete_original: bool = True,
+    codec_info: Optional[dict] = None
+) -> Tuple[str, str, Optional[dict]]:
+    """
+    Compress audio file to specified codec.
+    
+    Args:
+        input_path: Path to input audio file
+        codec: Target codec ('mp3', 'flac', 'opus')
+        bitrate: Bitrate for lossy codecs (ignored for FLAC)
+        delete_original: Whether to delete the original file after compression
+        codec_info: Optional pre-fetched codec info (returned as-is, not updated)
+    
+    Returns:
+        Tuple of (output_path, mime_type, codec_info)
+        Note: codec_info is returned unchanged (None after compression)
+        
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not installed
+        FFmpegError: If compression fails
+    """
+    codec_config = {
+        'mp3': {
+            'ext': '.mp3',
+            'mime': 'audio/mpeg',
+            'cmd_args': [
+                '-acodec', 'libmp3lame',
+                '-b:a', bitrate,
+                '-ar', DEFAULT_SAMPLE_RATE,
+                '-ac', str(DEFAULT_CHANNELS)
+            ]
+        },
+        'flac': {
+            'ext': '.flac',
+            'mime': 'audio/flac',
+            'cmd_args': ['-acodec', 'flac', '-compression_level', '12']
+        },
+        'opus': {
+            'ext': '.opus',
+            'mime': 'audio/opus',
+            'cmd_args': ['-acodec', 'libopus', '-b:a', bitrate]
+        }
+    }
+    
+    if codec not in codec_config:
+        raise ValueError(f"Unsupported codec: {codec}. Supported: {list(codec_config.keys())}")
+    
+    config = codec_config[codec]
+    base_path = os.path.splitext(input_path)[0]
+    temp_output_path = f"{base_path}_compressed_temp{config['ext']}"
+    final_output_path = f"{base_path}{config['ext']}"
+    
+    try:
+        # Get original file size for logging
+        original_size = os.path.getsize(input_path)
+        
+        cmd = ['ffmpeg', '-i', input_path, '-y'] + config['cmd_args'] + [temp_output_path]
+        
+        _run_ffmpeg_command(cmd, f"Compression of {os.path.basename(input_path)} to {codec}")
+        
+        # Get compressed file size
+        compressed_size = os.path.getsize(temp_output_path)
+        ratio = (1 - compressed_size / original_size) * 100 if original_size > 0 else 0
+        
+        current_app.logger.info(
+            f"Compressed {os.path.basename(input_path)}: "
+            f"{original_size / 1024 / 1024:.1f}MB -> "
+            f"{compressed_size / 1024 / 1024:.1f}MB ({ratio:.1f}% reduction)"
+        )
+        
+        # Remove original and rename temp to final
+        if delete_original:
+            os.remove(input_path)
+            current_app.logger.debug(f"Deleted original file: {input_path}")
+        os.rename(temp_output_path, final_output_path)
+        
+        # Return codec_info as None since file was converted (codec changed)
+        return final_output_path, config['mime'], None
+        
+    except Exception as e:
+        # Clean up temp file if it exists
+        if os.path.exists(temp_output_path):
+            try:
+                os.remove(temp_output_path)
+            except:
+                pass
+        # Re-raise with codec_info preservation
+        raise
+
+
+def extract_audio_segment(
+    input_path: str,
+    output_path: str,
+    start_time: float,
+    duration: float
+) -> None:
+    """
+    Extract a segment from an audio file.
+    
+    Args:
+        input_path: Path to input audio file
+        output_path: Path for output segment
+        start_time: Start time in seconds
+        duration: Duration in seconds
+        
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not installed
+        FFmpegError: If extraction fails
+    """
+    cmd = [
+        'ffmpeg',
+        '-i', input_path,
+        '-ss', str(start_time),
+        '-t', str(duration),
+        '-vn',           # Drop video streams (audio segment only)
+        '-c:a', 'copy',  # Copy audio codec (no re-encoding)
+        '-y',
+        output_path
+    ]
+    
+    _run_ffmpeg_command(cmd, f"Segment extraction from {os.path.basename(input_path)}")
+
+
+@contextmanager
+def temp_audio_conversion(input_path: str, target_format: str = 'mp3'):
+    """
+    Context manager for temporary audio conversion.
+    Automatically cleans up temp file on exit.
+    
+    Example:
+        with temp_audio_conversion(input_path, 'mp3') as mp3_path:
+            # Use mp3_path
+            process_audio(mp3_path)
+        # mp3_path is automatically deleted
+        
+    Args:
+        input_path: Path to input audio file
+        target_format: Target format ('mp3', 'wav', etc.)
+        
+    Yields:
+        Path to temporary converted file
+    """
+    temp_path = None
+    try:
+        with tempfile.NamedTemporaryFile(suffix=f'.{target_format}', delete=False) as temp_file:
+            temp_path = temp_file.name
+        
+        if target_format == 'mp3':
+            convert_to_mp3(input_path, temp_path)
+        else:
+            raise ValueError(f"Unsupported target format: {target_format}")
+        
+        yield temp_path
+        
+    finally:
+        if temp_path and os.path.exists(temp_path):
+            try:
+                os.unlink(temp_path)
+            except Exception as e:
+                current_app.logger.warning(f"Failed to cleanup temp file {temp_path}: {e}")
+
+
+def _run_ffmpeg_command(cmd: list, operation_description: str) -> None:
+    """
+    Execute FFmpeg command with consistent error handling.
+    
+    Args:
+        cmd: FFmpeg command as list of strings
+        operation_description: Human-readable description for error messages
+        
+    Raises:
+        FFmpegNotFoundError: If FFmpeg is not installed
+        FFmpegError: If FFmpeg command fails
+    """
+    try:
+        current_app.logger.debug(f"Running FFmpeg command: {' '.join(cmd)}")
+        result = subprocess.run(
+            cmd,
+            check=True,
+            capture_output=True,
+            text=True
+        )
+        current_app.logger.debug(f"FFmpeg {operation_description} completed successfully")
+        
+    except FileNotFoundError:
+        error_msg = "FFmpeg not found. Please ensure FFmpeg is installed and in the system's PATH."
+        current_app.logger.error(error_msg)
+        raise FFmpegNotFoundError(error_msg)
+        
+    except subprocess.CalledProcessError as e:
+        error_msg = f"{operation_description} failed: {e.stderr}"
+        current_app.logger.error(f"FFmpeg error: {error_msg}")
+        raise FFmpegError(error_msg)
\ No newline at end of file
diff --git a/src/utils/ffprobe.py b/src/utils/ffprobe.py
new file mode 100644
index 00000000..08add8b8
--- /dev/null
+++ b/src/utils/ffprobe.py
@@ -0,0 +1,499 @@
+"""
+FFprobe utility for detecting audio/video codecs and format information.
+
+This module provides functions to inspect media files using ffprobe and return
+structured information about their codecs, streams, and formats.
+"""
+
+import json
+import logging
+import subprocess
+from datetime import datetime
+from typing import Optional, Dict, Any, Tuple
+
+logger = logging.getLogger(__name__)
+
+
+class FFProbeError(Exception):
+    """Raised when ffprobe fails to analyze a file."""
+    pass
+
+
+def probe(filename: str, cmd: str = 'ffprobe', timeout: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Run ffprobe on the specified file and return a JSON representation of the output.
+
+    Args:
+        filename: Path to the media file to probe
+        cmd: Command to use (default: 'ffprobe')
+        timeout: Optional timeout in seconds
+
+    Returns:
+        Dictionary containing streams and format information
+
+    Raises:
+        FFProbeError: if ffprobe returns a non-zero exit code
+    """
+    args = [cmd, '-show_format', '-show_streams', '-of', 'json', filename]
+    p = None
+
+    try:
+        p = subprocess.Popen(args, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        communicate_kwargs = {}
+        if timeout is not None:
+            communicate_kwargs['timeout'] = timeout
+        out, err = p.communicate(**communicate_kwargs)
+        
+        if p.returncode != 0:
+            error_msg = err.decode('utf-8', errors='ignore')
+            raise FFProbeError(f'ffprobe failed: {error_msg}')
+        
+        return json.loads(out.decode('utf-8'))
+    except subprocess.TimeoutExpired:
+        if p:
+            p.kill()
+        raise FFProbeError(f'ffprobe timed out after {timeout} seconds')
+    except FileNotFoundError:
+        raise FFProbeError('ffprobe command not found. Please ensure ffmpeg is installed.')
+    except json.JSONDecodeError as e:
+        raise FFProbeError(f'Failed to parse ffprobe output: {e}')
+
+
+def get_codec_info(filename: str, timeout: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Get codec information for a media file.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+
+    Returns:
+        Dictionary with keys:
+        - audio_codec: Audio codec name (e.g., 'pcm_s16le', 'aac', 'mp3')
+        - video_codec: Video codec name if present, or None
+        - has_video: Boolean indicating if file contains video stream
+        - has_audio: Boolean indicating if file contains audio stream
+        - format_name: Container format name (e.g., 'wav', 'mov,mp4,m4a')
+        - duration: Duration in seconds (float)
+        - sample_rate: Audio sample rate if available
+        - channels: Number of audio channels if available
+        - bit_rate: Bit rate if available
+
+    Raises:
+        FFProbeError: if ffprobe fails to analyze the file
+    """
+    try:
+        probe_data = probe(filename, timeout=timeout)
+    except FFProbeError:
+        raise
+
+    result = {
+        'audio_codec': None,
+        'video_codec': None,
+        'has_video': False,
+        'has_audio': False,
+        'format_name': None,
+        'duration': None,
+        'sample_rate': None,
+        'channels': None,
+        'bit_rate': None
+    }
+
+    # Extract format information
+    if 'format' in probe_data:
+        fmt = probe_data['format']
+        result['format_name'] = fmt.get('format_name')
+        
+        if 'duration' in fmt:
+            try:
+                result['duration'] = float(fmt['duration'])
+            except (ValueError, TypeError):
+                pass
+        
+        if 'bit_rate' in fmt:
+            try:
+                result['bit_rate'] = int(fmt['bit_rate'])
+            except (ValueError, TypeError):
+                pass
+
+    # Extract stream information
+    if 'streams' in probe_data:
+        for stream in probe_data['streams']:
+            codec_type = stream.get('codec_type')
+            codec_name = stream.get('codec_name')
+            
+            if codec_type == 'audio':
+                result['has_audio'] = True
+                if result['audio_codec'] is None:  # Use first audio stream
+                    result['audio_codec'] = codec_name
+                    result['sample_rate'] = stream.get('sample_rate')
+                    result['channels'] = stream.get('channels')
+            
+            elif codec_type == 'video':
+                result['has_video'] = True
+                if result['video_codec'] is None:  # Use first video stream
+                    result['video_codec'] = codec_name
+
+    return result
+
+
+def is_video_file(filename: str, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> bool:
+    """
+    Check if a file contains video streams.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        True if file contains video streams, False otherwise
+    """
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+        return codec_info['has_video']
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        return False
+
+
+def is_audio_file(filename: str, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> bool:
+    """
+    Check if a file contains audio streams.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        True if file contains audio streams, False otherwise
+    """
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+        return codec_info['has_audio']
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        return False
+
+
+def get_audio_codec(filename: str, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> Optional[str]:
+    """
+    Get the audio codec name for a file.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        Audio codec name (e.g., 'pcm_s16le', 'aac', 'mp3', 'opus'), or None if no audio
+    """
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+        return codec_info['audio_codec']
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        return None
+
+
+def needs_audio_conversion(filename: str, supported_codecs: list, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> Tuple[bool, Optional[str]]:
+    """
+    Check if a file needs audio conversion based on its codec.
+
+    Args:
+        filename: Path to the media file
+        supported_codecs: List of supported audio codec names
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        Tuple of (needs_conversion: bool, current_codec: str or None)
+    """
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+        
+        # If it has video, it likely needs conversion
+        if codec_info['has_video']:
+            return True, codec_info.get('audio_codec')
+        
+        # If no audio at all, cannot convert
+        if not codec_info['has_audio']:
+            logger.warning(f"File {filename} has no audio streams")
+            return False, None
+        
+        audio_codec = codec_info['audio_codec']
+        
+        # Check if codec is in supported list
+        if audio_codec in supported_codecs:
+            return False, audio_codec
+        
+        return True, audio_codec
+        
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        # Default to attempting conversion on error
+        return True, None
+
+
+def is_lossless_audio(filename: str, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> bool:
+    """
+    Check if a file uses a lossless audio codec.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        True if file uses lossless audio codec, False otherwise
+    """
+    lossless_codecs = {
+        'pcm_s16le', 'pcm_s24le', 'pcm_s32le',
+        'pcm_f32le', 'pcm_f64le',
+        'pcm_u8', 'pcm_u16le', 'pcm_u24le', 'pcm_u32le',
+        'flac', 'alac', 'ape', 'wavpack', 'tta',
+        'mlp', 'truehd'
+    }
+    
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+        audio_codec = codec_info['audio_codec']
+        return audio_codec in lossless_codecs if audio_codec else False
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        return False
+
+
+def get_duration(filename: str, timeout: Optional[int] = None, codec_info: Optional[Dict[str, Any]] = None) -> Optional[float]:
+    """
+    Get the duration of a media file in seconds.
+
+    Uses multiple methods to determine duration:
+    1. Format-level duration (fastest, works for most files)
+    2. Packet timestamps fallback (for files without duration metadata like some WebM)
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        codec_info: Optional pre-fetched codec info to avoid redundant probe calls
+
+    Returns:
+        Duration in seconds, or None if unable to determine
+    """
+    try:
+        if codec_info is None:
+            codec_info = get_codec_info(filename, timeout=timeout)
+
+        # Try format-level duration first
+        if codec_info['duration'] is not None:
+            return codec_info['duration']
+
+        # Fallback: scan packets to find the last timestamp
+        # This works for WebM and other files without duration metadata
+        return _get_duration_from_packets(filename, timeout=timeout)
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename}: {e}")
+        return None
+
+
+def _get_duration_from_packets(filename: str, timeout: Optional[int] = None) -> Optional[float]:
+    """
+    Get duration by scanning packet timestamps (fallback for files without duration metadata).
+
+    This is slower than format-level duration but works for WebM and similar files
+    that don't store duration in the container metadata.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+
+    Returns:
+        Duration in seconds, or None if unable to determine
+    """
+    try:
+        args = [
+            'ffprobe', '-v', 'error',
+            '-show_entries', 'packet=pts_time',
+            '-select_streams', 'a:0',  # First audio stream
+            '-of', 'csv=p=0',
+            filename
+        ]
+
+        p = subprocess.Popen(args, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        communicate_kwargs = {}
+        if timeout is not None:
+            communicate_kwargs['timeout'] = timeout
+        out, err = p.communicate(**communicate_kwargs)
+
+        if p.returncode != 0:
+            logger.debug(f"Packet scan failed for {filename}")
+            return None
+
+        # Parse the output to find the last timestamp
+        lines = out.decode('utf-8').strip().split('\n')
+        last_valid_time = None
+        for line in reversed(lines):
+            line = line.strip()
+            if line and line != 'N/A':
+                try:
+                    last_valid_time = float(line)
+                    break
+                except ValueError:
+                    continue
+
+        if last_valid_time is not None:
+            logger.debug(f"Got duration from packets for {filename}: {last_valid_time}")
+            return last_valid_time
+
+        return None
+    except subprocess.TimeoutExpired:
+        logger.warning(f"Packet scan timed out for {filename}")
+        return None
+    except Exception as e:
+        logger.warning(f"Error scanning packets for {filename}: {e}")
+        return None
+
+
+def get_creation_date(filename: str, timeout: Optional[int] = None, use_file_mtime: bool = True) -> Optional[datetime]:
+    """
+    Extract the creation/recording date from a media file's metadata.
+
+    Checks various metadata tags commonly used by recorders and devices:
+    - creation_time (MP4, M4A, MOV)
+    - date (various formats)
+    - encoded_date (some encoders)
+
+    Falls back to file modification time if no metadata found and use_file_mtime is True.
+
+    Args:
+        filename: Path to the media file
+        timeout: Optional timeout in seconds
+        use_file_mtime: If True, fall back to file modification time when no metadata found
+
+    Returns:
+        datetime object if creation date found, None otherwise
+    """
+    import os
+
+    try:
+        probe_data = probe(filename, timeout=timeout)
+    except FFProbeError as e:
+        logger.warning(f"Failed to probe {filename} for creation date: {e}")
+        # Even if probe fails, we can still try file mtime
+        if use_file_mtime:
+            return _get_file_mtime(filename)
+        return None
+
+    # Tags to check for creation date (in order of preference)
+    date_tags = ['creation_time', 'date', 'encoded_date', 'date_recorded', 'recording_time']
+
+    # Check format-level tags first
+    if 'format' in probe_data and 'tags' in probe_data['format']:
+        tags = probe_data['format']['tags']
+        for tag in date_tags:
+            # Check both lowercase and original case
+            value = tags.get(tag) or tags.get(tag.upper())
+            if value:
+                parsed = _parse_date_string(value)
+                if parsed:
+                    logger.debug(f"Found creation date from format tag '{tag}': {parsed}")
+                    return parsed
+
+    # Check stream-level tags
+    if 'streams' in probe_data:
+        for stream in probe_data['streams']:
+            if 'tags' in stream:
+                tags = stream['tags']
+                for tag in date_tags:
+                    value = tags.get(tag) or tags.get(tag.upper())
+                    if value:
+                        parsed = _parse_date_string(value)
+                        if parsed:
+                            logger.debug(f"Found creation date from stream tag '{tag}': {parsed}")
+                            return parsed
+
+    # Fall back to file modification time
+    if use_file_mtime:
+        mtime = _get_file_mtime(filename)
+        if mtime:
+            logger.debug(f"Using file modification time as creation date: {mtime}")
+            return mtime
+
+    logger.debug(f"No creation date found for {filename}")
+    return None
+
+
+def _get_file_mtime(filename: str) -> Optional[datetime]:
+    """
+    Get the file's modification time as a datetime.
+
+    Args:
+        filename: Path to the file
+
+    Returns:
+        datetime object or None if unable to get mtime
+    """
+    import os
+
+    try:
+        stat_info = os.stat(filename)
+        return datetime.fromtimestamp(stat_info.st_mtime)
+    except (OSError, ValueError) as e:
+        logger.warning(f"Failed to get file mtime for {filename}: {e}")
+        return None
+
+
+def _parse_date_string(date_str: str) -> Optional[datetime]:
+    """
+    Parse various date string formats commonly found in media metadata.
+
+    Args:
+        date_str: Date string to parse
+
+    Returns:
+        datetime object if parsing successful, None otherwise
+    """
+    if not date_str:
+        return None
+
+    # Common formats in media files
+    formats = [
+        '%Y-%m-%dT%H:%M:%S.%fZ',      # ISO 8601 with microseconds and Z
+        '%Y-%m-%dT%H:%M:%SZ',          # ISO 8601 with Z
+        '%Y-%m-%dT%H:%M:%S.%f%z',      # ISO 8601 with microseconds and timezone
+        '%Y-%m-%dT%H:%M:%S%z',         # ISO 8601 with timezone
+        '%Y-%m-%dT%H:%M:%S.%f',        # ISO 8601 with microseconds
+        '%Y-%m-%dT%H:%M:%S',           # ISO 8601 basic
+        '%Y-%m-%d %H:%M:%S',           # Common datetime
+        '%Y/%m/%d %H:%M:%S',           # Alternate datetime
+        '%Y-%m-%d',                     # Date only
+        '%Y/%m/%d',                     # Alternate date only
+        '%d-%m-%Y %H:%M:%S',           # European format
+        '%d/%m/%Y %H:%M:%S',           # European format alternate
+    ]
+
+    # Clean up the string
+    date_str = date_str.strip()
+
+    for fmt in formats:
+        try:
+            return datetime.strptime(date_str, fmt)
+        except ValueError:
+            continue
+
+    # Try fromisoformat as a fallback (handles many ISO variants)
+    try:
+        # Replace Z with +00:00 for fromisoformat compatibility
+        clean_str = date_str.replace('Z', '+00:00')
+        return datetime.fromisoformat(clean_str)
+    except ValueError:
+        pass
+
+    logger.debug(f"Could not parse date string: {date_str}")
+    return None
\ No newline at end of file
diff --git a/src/utils/file_hash.py b/src/utils/file_hash.py
new file mode 100644
index 00000000..7dab3860
--- /dev/null
+++ b/src/utils/file_hash.py
@@ -0,0 +1,24 @@
+"""File hashing utility for duplicate detection."""
+
+import hashlib
+
+
+def compute_file_sha256(filepath, chunk_size=8192):
+    """
+    Compute SHA-256 hash of a file, reading in chunks to handle large files.
+
+    Args:
+        filepath: Path to the file to hash
+        chunk_size: Size of chunks to read at a time (default 8KB)
+
+    Returns:
+        64-character hex digest string
+    """
+    sha256 = hashlib.sha256()
+    with open(filepath, 'rb') as f:
+        while True:
+            chunk = f.read(chunk_size)
+            if not chunk:
+                break
+            sha256.update(chunk)
+    return sha256.hexdigest()
diff --git a/src/utils/json_parser.py b/src/utils/json_parser.py
new file mode 100644
index 00000000..116ac25d
--- /dev/null
+++ b/src/utils/json_parser.py
@@ -0,0 +1,260 @@
+"""
+JSON parsing utilities for handling LLM responses and malformed JSON.
+
+This module provides robust JSON parsing functions that can handle common
+issues with LLM-generated JSON, including:
+- Incomplete/unterminated JSON structures
+- Escape sequence problems
+- JSON embedded in markdown code blocks
+- Nested quotes and special characters
+"""
+
+import json
+import re
+import ast
+import logging
+
+# Module-level logger
+logger = logging.getLogger(__name__)
+
+
+def auto_close_json(json_string):
+    """
+    Attempts to close an incomplete JSON string by appending necessary brackets and braces.
+    This is a simplified parser and may not handle all edge cases, but is
+    designed to fix unterminated strings from API responses.
+    """
+    if not isinstance(json_string, str):
+        return json_string
+
+    stack = []
+    in_string = False
+    escape_next = False
+
+    for char in json_string:
+        if escape_next:
+            escape_next = False
+            continue
+
+        if char == '\\':
+            escape_next = True
+            continue
+
+        if char == '"':
+            # We don't handle escaped quotes inside strings perfectly,
+            # but this is a simple heuristic.
+            if not escape_next:
+                in_string = not in_string
+
+        if not in_string:
+            if char == '{':
+                stack.append('}')
+            elif char == '[':
+                stack.append(']')
+            elif char == '}':
+                if stack and stack[-1] == '}':
+                    stack.pop()
+            elif char == ']':
+                if stack and stack[-1] == ']':
+                    stack.pop()
+
+    # If we are inside a string at the end, close it.
+    if in_string:
+        json_string += '"'
+
+    # Close any remaining open structures
+    while stack:
+        json_string += stack.pop()
+
+    return json_string
+
+
+def preprocess_json_escapes(json_string):
+    """
+    Preprocess JSON string to fix common escape issues from LLM responses.
+    Uses a more sophisticated approach to handle nested quotes properly.
+    """
+    if not json_string:
+        return json_string
+
+    result = []
+    i = 0
+    in_string = False
+    escape_next = False
+    expecting_value = False  # Track if we're expecting a value (after :)
+
+    while i < len(json_string):
+        char = json_string[i]
+
+        if escape_next:
+            # This character is escaped, add it as-is
+            result.append(char)
+            escape_next = False
+        elif char == '\\':
+            # This is an escape character
+            result.append(char)
+            escape_next = True
+        elif char == ':' and not in_string:
+            # We found a colon, next string will be a value
+            result.append(char)
+            expecting_value = True
+        elif char == ',' and not in_string:
+            # We found a comma, reset expecting_value
+            result.append(char)
+            expecting_value = False
+        elif char == '"':
+            if not in_string:
+                # Starting a string
+                in_string = True
+                result.append(char)
+            else:
+                # We're in a string, check if this quote should be escaped
+                # Look ahead to see if this is the end of the string value
+                j = i + 1
+                while j < len(json_string) and json_string[j].isspace():
+                    j += 1
+
+                # For keys (not expecting_value), only end on colon
+                # For values (expecting_value), end on comma, closing brace, or closing bracket
+                if expecting_value:
+                    end_chars = ',}]'
+                else:
+                    end_chars = ':'
+
+                if j < len(json_string) and json_string[j] in end_chars:
+                    # This is the end of the string
+                    in_string = False
+                    result.append(char)
+                    if not expecting_value:
+                        # We just finished a key, next will be expecting value
+                        expecting_value = True
+                else:
+                    # This is an inner quote that should be escaped
+                    result.append('\\"')
+        elif char == '\n' and in_string:
+            # Literal newlines inside JSON strings must be escaped
+            result.append('\\n')
+        elif char == '\r' and in_string:
+            # Literal carriage returns inside JSON strings must be escaped
+            result.append('\\r')
+        elif char == '\t' and in_string:
+            # Literal tabs inside JSON strings must be escaped
+            result.append('\\t')
+        else:
+            result.append(char)
+
+        i += 1
+
+    return ''.join(result)
+
+
+def extract_json_object(text):
+    """
+    Extract the first complete JSON object or array from text using brace counting.
+    This is more robust than regex as it properly handles nested structures and
+    doesn't over-match when there's text after the JSON.
+    """
+    # Find the first { or [ that starts a JSON structure
+    start = None
+    close_char = None
+    for i, ch in enumerate(text):
+        if ch == '{':
+            start = i
+            close_char = '}'
+            break
+        elif ch == '[':
+            start = i
+            close_char = ']'
+            break
+
+    if start is None:
+        return text
+
+    # Walk through counting braces/brackets, respecting strings
+    depth = 0
+    in_string = False
+    escape_next = False
+
+    for i in range(start, len(text)):
+        ch = text[i]
+
+        if escape_next:
+            escape_next = False
+            continue
+
+        if ch == '\\' and in_string:
+            escape_next = True
+            continue
+
+        if ch == '"':
+            in_string = not in_string
+            continue
+
+        if not in_string:
+            if ch in ('{', '['):
+                depth += 1
+            elif ch in ('}', ']'):
+                depth -= 1
+                if depth == 0:
+                    return text[start:i + 1]
+
+    # If we never balanced, return from start to end (best effort)
+    return text[start:]
+
+
+def safe_json_loads(json_string, fallback_value=None):
+    """
+    Safely parse JSON with preprocessing to handle common LLM JSON formatting issues.
+
+    Args:
+        json_string (str): The JSON string to parse
+        fallback_value: Value to return if parsing fails (default: None)
+
+    Returns:
+        Parsed JSON object or fallback_value if parsing fails
+    """
+    if not json_string or not isinstance(json_string, str):
+        logger.warning(f"Invalid JSON input: {type(json_string)} - {json_string}")
+        return fallback_value
+
+    # Step 1: Clean the input string
+    cleaned_json = json_string.strip()
+
+    # Step 2: Extract JSON from markdown code blocks if present
+    json_match = re.search(r'```(?:json)?\s*(.*?)\s*```', cleaned_json, re.DOTALL)
+    if json_match:
+        cleaned_json = json_match.group(1).strip()
+
+    # Step 3: Try multiple parsing strategies
+    parsing_strategies = [
+        # Strategy 1: Direct parsing (for well-formed JSON)
+        lambda x: json.loads(x),
+
+        # Strategy 2: Fix common escape issues
+        lambda x: json.loads(preprocess_json_escapes(x)),
+
+        # Strategy 3: Use ast.literal_eval as fallback for simple cases
+        lambda x: ast.literal_eval(x) if x.startswith(('{', '[')) else None,
+
+        # Strategy 4: Extract JSON object/array using regex
+        lambda x: json.loads(extract_json_object(x)),
+
+        # Strategy 5: Auto-close incomplete JSON and parse
+        lambda x: json.loads(auto_close_json(x)),
+    ]
+
+    for i, strategy in enumerate(parsing_strategies):
+        try:
+            result = strategy(cleaned_json)
+            if result is not None:
+                if i > 0:  # Log if we had to use a fallback strategy
+                    logger.info(f"JSON parsed successfully using strategy {i+1}")
+                return result
+        except (json.JSONDecodeError, ValueError, SyntaxError) as e:
+            if i == 0:  # Only log the first failure to avoid spam
+                logger.debug(f"JSON parsing strategy {i+1} failed: {e}")
+            continue
+
+    # All strategies failed
+    logger.error(f"All JSON parsing strategies failed for: {cleaned_json[:200]}...")
+    return fallback_value
diff --git a/src/utils/language.py b/src/utils/language.py
new file mode 100644
index 00000000..30de9c76
--- /dev/null
+++ b/src/utils/language.py
@@ -0,0 +1,114 @@
+"""Language code normalization for ASR requests.
+
+Older user records were saved when the transcription-language input was a
+free-text field, so values like "français", "English", or "fr-FR" are present
+in the wild. WhisperX and other ASR backends expect ISO 639-1 codes (`fr`,
+`en`, ...) and reject anything else with a hard 500. This helper coerces
+arbitrary input to a clean ISO code or returns None to mean "auto-detect".
+
+Whitelist below matches the languages WhisperX accepts and the dropdown
+offered in account settings.
+"""
+
+# ISO 639-1 codes accepted by WhisperX. Source: faster-whisper tokenizer.
+# Keep this in sync with the dropdown in templates/account.html.
+SUPPORTED_CODES = frozenset({
+    "af", "am", "ar", "as", "az", "ba", "be", "bg", "bn", "bo", "br", "bs",
+    "ca", "cs", "cy", "da", "de", "el", "en", "es", "et", "eu", "fa", "fi",
+    "fo", "fr", "gl", "gu", "ha", "haw", "he", "hi", "hr", "ht", "hu", "hy",
+    "id", "is", "it", "ja", "jw", "ka", "kk", "km", "kn", "ko", "la", "lb",
+    "ln", "lo", "lt", "lv", "mg", "mi", "mk", "ml", "mn", "mr", "ms", "mt",
+    "my", "ne", "nl", "nn", "no", "oc", "pa", "pl", "ps", "pt", "ro", "ru",
+    "sa", "sd", "si", "sk", "sl", "sn", "so", "sq", "sr", "su", "sv", "sw",
+    "ta", "te", "tg", "th", "tk", "tl", "tr", "tt", "uk", "ur", "uz", "vi",
+    "yi", "yo", "zh", "yue",
+})
+
+# Display names → ISO code. Lowercased keys; we lowercase input before lookup.
+# Covers: English names, native names, common alternates.
+_NAME_TO_CODE = {
+    # English names
+    "english": "en", "spanish": "es", "french": "fr", "german": "de",
+    "italian": "it", "portuguese": "pt", "dutch": "nl", "russian": "ru",
+    "chinese": "zh", "japanese": "ja", "korean": "ko", "arabic": "ar",
+    "hindi": "hi", "polish": "pl", "ukrainian": "uk", "vietnamese": "vi",
+    "thai": "th", "turkish": "tr", "indonesian": "id", "swedish": "sv",
+    "norwegian": "no", "danish": "da", "finnish": "fi", "czech": "cs",
+    "greek": "el", "hebrew": "he", "hungarian": "hu", "romanian": "ro",
+    "bulgarian": "bg", "croatian": "hr", "serbian": "sr", "slovak": "sk",
+    "slovenian": "sl", "estonian": "et", "latvian": "lv", "lithuanian": "lt",
+    "persian": "fa", "farsi": "fa", "urdu": "ur", "bengali": "bn",
+    "tamil": "ta", "telugu": "te", "marathi": "mr", "gujarati": "gu",
+    "kannada": "kn", "malayalam": "ml", "punjabi": "pa", "burmese": "my",
+    "khmer": "km", "lao": "lo", "mongolian": "mn", "nepali": "ne",
+    "malay": "ms", "filipino": "tl", "tagalog": "tl", "swahili": "sw",
+    "afrikaans": "af", "albanian": "sq", "armenian": "hy", "azerbaijani": "az",
+    "basque": "eu", "belarusian": "be", "bosnian": "bs", "catalan": "ca",
+    "welsh": "cy", "galician": "gl", "georgian": "ka", "icelandic": "is",
+    "kazakh": "kk", "macedonian": "mk", "maltese": "mt", "yiddish": "yi",
+    "yoruba": "yo", "cantonese": "yue",
+    # Native names (selected — only those known to be misstored)
+    "français": "fr", "francais": "fr",
+    "deutsch": "de",
+    "español": "es", "espanol": "es",
+    "italiano": "it",
+    "português": "pt", "portugues": "pt",
+    "русский": "ru",
+    "中文": "zh", "汉语": "zh", "中國話": "zh", "普通话": "zh",
+    "日本語": "ja",
+    "한국어": "ko",
+    "العربية": "ar",
+    "हिन्दी": "hi",
+    "polski": "pl",
+    "українська": "uk",
+    "tiếng việt": "vi",
+    "ไทย": "th",
+    "türkçe": "tr",
+    "bahasa indonesia": "id",
+    "svenska": "sv",
+    "norsk": "no",
+    "dansk": "da",
+    "suomi": "fi",
+    "čeština": "cs", "cestina": "cs",
+    "ελληνικά": "el",
+    "עברית": "he",
+    "magyar": "hu",
+    "română": "ro", "romana": "ro",
+}
+
+
+def normalize_language_code(value):
+    """Coerce a user-supplied language string to an ISO 639-1 code or None.
+
+    Empty / None / 'auto' / 'auto-detect' → None (signals auto-detect).
+    Already-valid 2-letter codes pass through (lowercased).
+    Locale codes like 'en-US' are stripped to 'en'.
+    Display names like 'English', 'Français' map via _NAME_TO_CODE.
+    Anything else returns None — better to auto-detect than crash the ASR call.
+    """
+    if value is None:
+        return None
+    s = str(value).strip().lower()
+    if not s or s in ("auto", "auto-detect", "auto detect"):
+        return None
+
+    # Locale codes like 'en-US', 'fr_FR' → take the language portion.
+    for sep in ("-", "_"):
+        if sep in s:
+            head = s.split(sep, 1)[0]
+            if head in SUPPORTED_CODES:
+                return head
+            # Fall through; might still match by display name below.
+
+    # Already a valid 2-letter (or 3-letter for 'haw'/'yue') code.
+    if s in SUPPORTED_CODES:
+        return s
+
+    # Display name lookup.
+    if s in _NAME_TO_CODE:
+        code = _NAME_TO_CODE[s]
+        return code if code in SUPPORTED_CODES else None
+
+    # Last resort: first 2 chars happen to be a valid code (e.g. 'english' → 'en').
+    # Skip — too aggressive and would map garbage to wrong languages.
+    return None
diff --git a/src/utils/localization.py b/src/utils/localization.py
new file mode 100644
index 00000000..a1a440e8
--- /dev/null
+++ b/src/utils/localization.py
@@ -0,0 +1,214 @@
+"""
+Server-side localization utilities for export templates.
+
+This module provides utilities to load localized labels from
+static/locales/*.json files for use in export templates.
+"""
+
+import json
+import os
+import logging
+from pathlib import Path
+from typing import Dict, Optional
+from datetime import datetime
+
+logger = logging.getLogger(__name__)
+
+# Cache for loaded locales
+_locale_cache: Dict[str, dict] = {}
+
+
+def get_locales_dir() -> Path:
+    """Get the path to the locales directory."""
+    # Navigate from src/utils to static/locales
+    base_dir = Path(__file__).parent.parent.parent
+    return base_dir / 'static' / 'locales'
+
+
+def load_locale(language: str) -> dict:
+    """
+    Load locale data for a given language.
+
+    Args:
+        language: Language code (e.g., 'en', 'de', 'fr')
+
+    Returns:
+        Dictionary containing all locale strings
+    """
+    # Check cache first
+    if language in _locale_cache:
+        return _locale_cache[language]
+
+    locales_dir = get_locales_dir()
+    locale_file = locales_dir / f'{language}.json'
+
+    # Fallback to English if requested language doesn't exist
+    if not locale_file.exists():
+        logger.warning(f"Locale file not found for '{language}', falling back to English")
+        locale_file = locales_dir / 'en.json'
+        language = 'en'
+
+    try:
+        with open(locale_file, 'r', encoding='utf-8') as f:
+            locale_data = json.load(f)
+            _locale_cache[language] = locale_data
+            return locale_data
+    except (json.JSONDecodeError, IOError) as e:
+        logger.error(f"Error loading locale file '{locale_file}': {e}")
+        # Return empty dict on error
+        return {}
+
+
+def get_export_labels(language: str) -> dict:
+    """
+    Get localized export labels for a given language.
+
+    Args:
+        language: Language code (e.g., 'en', 'de', 'fr')
+
+    Returns:
+        Dictionary containing export-specific labels
+    """
+    locale_data = load_locale(language)
+
+    # Get exportLabels section, or fall back to defaults
+    export_labels = locale_data.get('exportLabels', {})
+
+    # Default English labels as fallback
+    defaults = {
+        'metadata': 'Metadata',
+        'notes': 'Notes',
+        'summary': 'Summary',
+        'transcription': 'Transcription',
+        'date': 'Date',
+        'created': 'Created',
+        'originalFile': 'Original File',
+        'fileSize': 'File Size',
+        'participants': 'Participants',
+        'tags': 'Tags',
+        'transcriptionTime': 'Transcription Time',
+        'summarizationTime': 'Summarization Time',
+        'footer': 'Generated with [Speakr](https://github.com/learnedmachine/speakr)'
+    }
+
+    # Merge defaults with loaded labels
+    result = defaults.copy()
+    result.update(export_labels)
+
+    return result
+
+
+def format_date_localized(dt: datetime, language: str) -> str:
+    """
+    Format a datetime in a localized format.
+
+    Args:
+        dt: The datetime to format
+        language: Language code for localization
+
+    Returns:
+        Localized date string
+    """
+    if dt is None:
+        return ''
+
+    # Define locale-specific date formats
+    date_formats = {
+        'en': '%B %d, %Y',           # January 15, 2026
+        'de': '%d. %B %Y',            # 15. Januar 2026
+        'fr': '%d %B %Y',             # 15 janvier 2026
+        'es': '%d de %B de %Y',       # 15 de enero de 2026
+        'zh': '%Y年%m月%d日',          # 2026年01月15日
+        'ru': '%d %B %Y г.',          # 15 января 2026 г.
+    }
+
+    # Month names for different languages
+    month_names = {
+        'de': {
+            'January': 'Januar', 'February': 'Februar', 'March': 'März',
+            'April': 'April', 'May': 'Mai', 'June': 'Juni',
+            'July': 'Juli', 'August': 'August', 'September': 'September',
+            'October': 'Oktober', 'November': 'November', 'December': 'Dezember'
+        },
+        'fr': {
+            'January': 'janvier', 'February': 'février', 'March': 'mars',
+            'April': 'avril', 'May': 'mai', 'June': 'juin',
+            'July': 'juillet', 'August': 'août', 'September': 'septembre',
+            'October': 'octobre', 'November': 'novembre', 'December': 'décembre'
+        },
+        'es': {
+            'January': 'enero', 'February': 'febrero', 'March': 'marzo',
+            'April': 'abril', 'May': 'mayo', 'June': 'junio',
+            'July': 'julio', 'August': 'agosto', 'September': 'septiembre',
+            'October': 'octubre', 'November': 'noviembre', 'December': 'diciembre'
+        },
+        'ru': {
+            'January': 'января', 'February': 'февраля', 'March': 'марта',
+            'April': 'апреля', 'May': 'мая', 'June': 'июня',
+            'July': 'июля', 'August': 'августа', 'September': 'сентября',
+            'October': 'октября', 'November': 'ноября', 'December': 'декабря'
+        }
+    }
+
+    # Get format for language, default to English
+    date_format = date_formats.get(language, date_formats['en'])
+
+    # Format the date
+    formatted = dt.strftime(date_format)
+
+    # Replace English month names with localized versions
+    if language in month_names:
+        for eng, local in month_names[language].items():
+            formatted = formatted.replace(eng, local)
+
+    return formatted
+
+
+def format_datetime_localized(dt: datetime, language: str) -> str:
+    """
+    Format a datetime with time in a localized format.
+
+    Args:
+        dt: The datetime to format
+        language: Language code for localization
+
+    Returns:
+        Localized datetime string
+    """
+    if dt is None:
+        return ''
+
+    date_part = format_date_localized(dt, language)
+
+    # Time format varies by language
+    time_formats = {
+        'en': '%I:%M %p',       # 02:30 PM
+        'de': '%H:%M Uhr',      # 14:30 Uhr
+        'fr': '%H:%M',          # 14:30
+        'es': '%H:%M',          # 14:30
+        'zh': '%H:%M',          # 14:30
+        'ru': '%H:%M',          # 14:30
+    }
+
+    time_format = time_formats.get(language, time_formats['en'])
+    time_part = dt.strftime(time_format)
+
+    # Combine with appropriate connector
+    connectors = {
+        'en': ' at ',
+        'de': ' um ',
+        'fr': ' à ',
+        'es': ' a las ',
+        'zh': ' ',
+        'ru': ' в ',
+    }
+
+    connector = connectors.get(language, ' at ')
+
+    return f"{date_part}{connector}{time_part}"
+
+
+def clear_locale_cache():
+    """Clear the locale cache (useful for testing or hot-reloading)."""
+    global _locale_cache
+    _locale_cache = {}
diff --git a/src/utils/markdown.py b/src/utils/markdown.py
new file mode 100644
index 00000000..8b55635e
--- /dev/null
+++ b/src/utils/markdown.py
@@ -0,0 +1,132 @@
+"""
+Markdown and HTML utilities for converting and sanitizing text content.
+
+This module provides functions for converting markdown to HTML and
+sanitizing HTML to prevent XSS and other security issues.
+"""
+
+import re
+import markdown
+import bleach
+
+# --- Initialize Markdown Once (Performance Optimization) ---
+# Create a single reusable Markdown instance to avoid reinitializing extensions on every call
+_markdown_instance = markdown.Markdown(extensions=[
+    'fenced_code',      # Fenced code blocks
+    'tables',           # Table support
+    'attr_list',        # Attribute lists
+    'def_list',         # Definition lists
+    'footnotes',        # Footnotes
+    'abbr',             # Abbreviations
+    'codehilite',       # Syntax highlighting for code blocks
+    'smarty'            # Smart quotes, dashes, etc.
+])
+
+
+def sanitize_html(text):
+    """
+    Sanitize HTML content to prevent XSS and other security issues.
+
+    Args:
+        text (str): HTML text to sanitize
+
+    Returns:
+        str: Sanitized HTML text
+    """
+    if not text:
+        return ""
+
+    # Remove any template-like syntax that could be exploited
+    # Remove {{ }} style template syntax
+    text = re.sub(r'\{\{.*?\}\}', '', text, flags=re.DOTALL)
+    text = re.sub(r'\{%.*?%\}', '', text, flags=re.DOTALL)
+
+    # Remove other template-like syntax
+    text = re.sub(r'<%.*?%>', '', text, flags=re.DOTALL)
+    text = re.sub(r'<\?.*?\?>', '', text, flags=re.DOTALL)
+
+    # Define allowed tags and attributes for safe HTML
+    allowed_tags = [
+        'p', 'br', 'strong', 'b', 'em', 'i', 'u', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+        'ul', 'ol', 'li', 'blockquote', 'code', 'pre', 'a', 'img', 'table', 'thead',
+        'tbody', 'tr', 'th', 'td', 'dl', 'dt', 'dd', 'div', 'span', 'hr', 'sup', 'sub'
+    ]
+
+    allowed_attributes = {
+        'a': ['href', 'title'],
+        'img': ['src', 'alt', 'title', 'width', 'height'],
+        'code': ['class'],  # For syntax highlighting
+        'pre': ['class'],   # For syntax highlighting
+        'div': ['class'],   # For code blocks
+        'span': ['class'],  # For syntax highlighting
+        'th': ['align'],
+        'td': ['align'],
+        'table': ['class']
+    }
+
+    # Sanitize the HTML to remove dangerous content
+    sanitized_html = bleach.clean(
+        text,
+        tags=allowed_tags,
+        attributes=allowed_attributes,
+        protocols=['http', 'https', 'mailto'],
+        strip=True  # Strip disallowed tags instead of escaping them
+    )
+
+    return sanitized_html
+
+
+def md_to_html(text):
+    """
+    Convert markdown text to sanitized HTML.
+
+    Args:
+        text (str): Markdown text to convert
+
+    Returns:
+        str: Sanitized HTML output
+    """
+    if not text:
+        return ""
+
+    # Fix list spacing
+    def fix_list_spacing(text):
+        lines = text.split('\n')
+        result = []
+        in_list = False
+
+        for line in lines:
+            stripped = line.strip()
+
+            # Check if this line is a list item (starts with -, *, +, or number.)
+            is_list_item = (
+                stripped.startswith(('- ', '* ', '+ ')) or
+                (stripped and stripped[0].isdigit() and '. ' in stripped[:10])
+            )
+
+            # If we're starting a new list or continuing a list, ensure proper spacing
+            if is_list_item:
+                if not in_list and result and result[-1].strip():
+                    # Starting a new list - add blank line before
+                    result.append('')
+                in_list = True
+            elif in_list and stripped and not is_list_item:
+                # Ending a list - add blank line after the list
+                if result and result[-1].strip():
+                    result.append('')
+                in_list = False
+
+            result.append(line)
+
+        return '\n'.join(result)
+
+    # Fix list spacing
+    processed_text = fix_list_spacing(text)
+
+    # Convert markdown to HTML using the pre-configured singleton instance
+    # Reset the instance to clear any state from previous conversions
+    _markdown_instance.reset()
+    html = _markdown_instance.convert(processed_text)
+
+    # Apply sanitization to the generated HTML
+    return sanitize_html(html)
diff --git a/src/utils/prompt_variables.py b/src/utils/prompt_variables.py
new file mode 100644
index 00000000..6850f7c7
--- /dev/null
+++ b/src/utils/prompt_variables.py
@@ -0,0 +1,130 @@
+"""
+Templated prompt variables.
+
+Authors of custom summarisation prompts (on tags, folders, users, or admin
+defaults) can embed `{{variable_name}}` placeholders. At upload time the user
+fills in values for whichever variables appear in the resolved prompt; the
+values are stored on the recording and substituted into the prompt at
+summarisation time.
+
+Variable naming follows simple identifier rules so the regex never
+accidentally matches natural prose: must start with a letter or underscore,
+followed by letters, digits, or underscores. Whitespace inside the braces is
+allowed (`{{ name }}`).
+"""
+
+import re
+
+# Match `{{ name }}` with optional whitespace, capture the bare identifier.
+_VARIABLE_PATTERN = re.compile(r"\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}")
+
+
+def extract_template_variables(text):
+    """
+    Return a list of unique variable names that appear in `text`, in the
+    order of their first occurrence. An empty or non-string input returns [].
+    """
+    if not text or not isinstance(text, str):
+        return []
+    seen = []
+    for match in _VARIABLE_PATTERN.finditer(text):
+        name = match.group(1)
+        if name not in seen:
+            seen.append(name)
+    return seen
+
+
+def substitute_template_variables(text, values):
+    """
+    Replace every `{{name}}` placeholder in `text` with `values.get(name, '')`.
+    Whitespace inside the braces is tolerated. Returns the substituted string.
+    A missing or non-string `text` is returned unchanged. A non-dict `values`
+    is treated as empty.
+    """
+    if not text or not isinstance(text, str):
+        return text
+    if not isinstance(values, dict):
+        values = {}
+
+    def _replace(match):
+        name = match.group(1)
+        replacement = values.get(name, '')
+        if replacement is None:
+            return ''
+        return str(replacement)
+
+    return _VARIABLE_PATTERN.sub(_replace, text)
+
+
+def infer_label(variable_name):
+    """
+    Derive a human-readable label from a variable name. `meeting_date` becomes
+    "Meeting date"; `agenda` becomes "Agenda". Used by the upload form so the
+    user does not have to declare labels separately.
+    """
+    if not variable_name:
+        return ''
+    cleaned = variable_name.replace('_', ' ').strip()
+    if not cleaned:
+        return ''
+    return cleaned[0].upper() + cleaned[1:]
+
+
+# Hard limits enforced on user-supplied variable maps so a malicious or buggy
+# client cannot blow up storage or downstream LLM calls.
+MAX_VARIABLES = 50
+MAX_VALUE_CHARS = 8000
+MAX_TOTAL_CHARS = 32000
+
+# Keys must match the same identifier shape as the regex above so we never
+# store names that the substitution pass cannot match anyway.
+_KEY_PATTERN = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
+
+
+def sanitize_variable_values(raw):
+    """
+    Coerce a user-supplied variable map into a safe canonical form.
+
+    - Returns a plain ``{str: str}`` dict, or ``None`` if the input is empty
+      or unusable.
+    - Drops keys that are not valid identifiers (the substitution regex would
+      not match them anyway).
+    - Drops empty / whitespace-only values so the column stays ``None`` when
+      nothing was supplied.
+    - Caps the number of entries, each value's length, and the total size to
+      prevent abuse of an unbounded JSON column.
+    - Strips control characters except ``\\n``, ``\\r``, and ``\\t``.
+
+    The function is deliberately defensive: bad input becomes empty rather
+    than raising, so callers can use it as the only validation step.
+    """
+    if not isinstance(raw, dict):
+        return None
+
+    cleaned = {}
+    total = 0
+    for key, value in raw.items():
+        if len(cleaned) >= MAX_VARIABLES:
+            break
+        if not isinstance(key, str) or not _KEY_PATTERN.match(key):
+            continue
+        if value is None:
+            continue
+        text = str(value)
+        # Strip C0 control characters except common whitespace; this stops
+        # null bytes and other oddities from landing in the prompt.
+        text = ''.join(
+            ch for ch in text
+            if ch in ('\n', '\r', '\t') or ord(ch) >= 0x20
+        )
+        text = text.strip()
+        if not text:
+            continue
+        if len(text) > MAX_VALUE_CHARS:
+            text = text[:MAX_VALUE_CHARS]
+        if total + len(text) > MAX_TOTAL_CHARS:
+            break
+        cleaned[key] = text
+        total += len(text)
+
+    return cleaned or None
diff --git a/src/utils/security.py b/src/utils/security.py
new file mode 100644
index 00000000..573b05e7
--- /dev/null
+++ b/src/utils/security.py
@@ -0,0 +1,67 @@
+"""
+Security utilities for password validation and other security functions.
+
+This module provides security-related utility functions for the application.
+"""
+
+import re
+from wtforms.validators import ValidationError
+from urllib.parse import urlparse
+
+
+def password_check(form, field):
+    """
+    Custom WTForms validator for password strength.
+
+    Validates that passwords meet security requirements:
+    - At least 8 characters long
+    - Contains at least one uppercase letter
+    - Contains at least one lowercase letter
+    - Contains at least one number
+    - Contains at least one special character
+
+    Args:
+        form: WTForms form object
+        field: WTForms field object containing the password
+
+    Raises:
+        ValidationError: If password doesn't meet requirements
+    """
+    password = field.data
+    if len(password) < 8:
+        raise ValidationError('Password must be at least 8 characters long.')
+    if not re.search(r'[A-Z]', password):
+        raise ValidationError('Password must contain at least one uppercase letter.')
+    if not re.search(r'[a-z]', password):
+        raise ValidationError('Password must contain at least one lowercase letter.')
+    if not re.search(r'[0-9]', password):
+        raise ValidationError('Password must contain at least one number.')
+    if not re.search(r'[!@#$%^&*(),.?":{}|<>]', password):
+        raise ValidationError('Password must contain at least one special character.')
+
+
+# --- URL Security ---
+
+def is_safe_url(target):
+    """Return True only for local relative paths.
+
+    Rejects scheme-relative URLs (``//evil.com``), backslash-prefixed URLs
+    (``\\evil.com``), absolute URLs, and anything with a scheme or netloc.
+    The validator runs against the raw value so the same string can be passed
+    to ``redirect()`` without the parser-mismatch open-redirect class.
+    """
+    if not target or not isinstance(target, str):
+        return False
+    if not target.startswith('/'):
+        return False
+    if target.startswith('//') or target.startswith('/\\'):
+        return False
+    if '\\' in target:
+        return False
+    if any(ord(ch) < 0x20 for ch in target):
+        return False
+    parsed = urlparse(target)
+    if parsed.scheme or parsed.netloc:
+        return False
+    return True
+
diff --git a/src/utils/token_auth.py b/src/utils/token_auth.py
new file mode 100644
index 00000000..9fd0086f
--- /dev/null
+++ b/src/utils/token_auth.py
@@ -0,0 +1,108 @@
+"""
+Token authentication utilities.
+
+This module provides token-based authentication for API access,
+allowing users to authenticate with Bearer tokens instead of session cookies.
+"""
+
+import hashlib
+from datetime import datetime
+from flask import request
+from src.models import APIToken, User
+
+
+def extract_token_from_request():
+    """
+    Extract API token from various possible locations in the request.
+
+    Checks in order:
+    1. Authorization header with Bearer scheme
+    2. X-API-Token header
+    3. API-Token header
+    4. 'token' query parameter
+
+    Returns:
+        str: The extracted token, or None if not found
+    """
+    # Check Authorization header (Bearer token)
+    auth_header = request.headers.get('Authorization', '')
+    if auth_header.startswith('Bearer '):
+        return auth_header[7:]  # Remove 'Bearer ' prefix
+
+    # Check X-API-Token header
+    token = request.headers.get('X-API-Token')
+    if token:
+        return token
+
+    # Check API-Token header
+    token = request.headers.get('API-Token')
+    if token:
+        return token
+
+    # Check query parameter
+    token = request.args.get('token')
+    if token:
+        return token
+
+    return None
+
+
+def hash_token(token):
+    """
+    Hash a token using SHA-256.
+
+    Args:
+        token (str): The plaintext token to hash
+
+    Returns:
+        str: The hexadecimal hash of the token
+    """
+    return hashlib.sha256(token.encode()).hexdigest()
+
+
+def load_user_from_token():
+    """
+    Load a user from an API token in the request.
+
+    This function is used by Flask-Login's request_loader to authenticate
+    users via API tokens instead of sessions.
+
+    Returns:
+        User: The authenticated user, or None if authentication fails
+    """
+    # Extract token from request
+    token = extract_token_from_request()
+    if not token:
+        return None
+
+    # Hash the token to look up in database
+    token_hash = hash_token(token)
+
+    # Find the token in the database
+    api_token = APIToken.query.filter_by(token_hash=token_hash).first()
+
+    # Validate token
+    if not api_token:
+        return None
+
+    if not api_token.is_valid():
+        return None
+
+    # Update last used timestamp
+    api_token.last_used_at = datetime.utcnow()
+    from src.database import db
+    db.session.commit()
+
+    # Return the associated user
+    return api_token.user
+
+
+def is_token_authenticated():
+    """
+    Check if the current request is authenticated via API token.
+
+    Returns:
+        bool: True if a valid token was provided, False otherwise
+    """
+    token = extract_token_from_request()
+    return token is not None
diff --git a/src/utils/vapid_keys.py b/src/utils/vapid_keys.py
new file mode 100644
index 00000000..e910084b
--- /dev/null
+++ b/src/utils/vapid_keys.py
@@ -0,0 +1,101 @@
+"""
+VAPID Key Management
+Auto-generates and stores VAPID keys for push notifications
+"""
+import os
+import json
+from pathlib import Path
+
+
+def generate_vapid_keys():
+    """Generate new VAPID keys using pywebpush"""
+    try:
+        from pywebpush import webpush
+
+        # Generate keys
+        vapid_claims = webpush.WebPusher().vapid_claims
+
+        # For newer versions of pywebpush, use this approach:
+        from py_vapid import Vapid
+        vapid = Vapid()
+        vapid.generate_keys()
+
+        return {
+            'public_key': vapid.public_key.export_public(encoding='uncompressed'),
+            'private_key': vapid.private_key.export_private(encoding='pem')
+        }
+    except ImportError:
+        print("[VAPID] pywebpush not installed. Push notifications will be disabled.")
+        print("[VAPID] Install with: pip install pywebpush")
+        return None
+    except Exception as e:
+        print(f"[VAPID] Failed to generate keys: {e}")
+        return None
+
+
+def get_vapid_keys_file():
+    """Get path to VAPID keys storage file"""
+    # Store in /config directory (persistent in Docker)
+    config_dir = Path(os.getenv('CONFIG_DIR', '/config'))
+    config_dir.mkdir(parents=True, exist_ok=True)
+    return config_dir / 'vapid_keys.json'
+
+
+def load_vapid_keys():
+    """Load existing VAPID keys or generate new ones"""
+    keys_file = get_vapid_keys_file()
+
+    # Try to load existing keys
+    if keys_file.exists():
+        try:
+            with open(keys_file, 'r') as f:
+                keys = json.load(f)
+                print(f"[VAPID] Loaded existing keys from {keys_file}")
+                return keys
+        except Exception as e:
+            print(f"[VAPID] Failed to load existing keys: {e}")
+            # Continue to generate new keys
+
+    # Generate new keys
+    print("[VAPID] Generating new VAPID keys...")
+    keys = generate_vapid_keys()
+
+    if keys:
+        # Save keys to file
+        try:
+            with open(keys_file, 'w') as f:
+                json.dump(keys, f, indent=2)
+
+            # Set restrictive permissions (owner read/write only)
+            os.chmod(keys_file, 0o600)
+
+            print(f"[VAPID] Saved new keys to {keys_file}")
+            print(f"[VAPID] Public key: {keys['public_key'][:50]}...")
+            return keys
+        except Exception as e:
+            print(f"[VAPID] Failed to save keys: {e}")
+            return keys
+    else:
+        print("[VAPID] Push notifications disabled - pywebpush not available")
+        return None
+
+
+def get_public_key():
+    """Get the public VAPID key for client use"""
+    keys = load_vapid_keys()
+    return keys['public_key'] if keys else None
+
+
+def get_private_key():
+    """Get the private VAPID key for server use"""
+    keys = load_vapid_keys()
+    return keys['private_key'] if keys else None
+
+
+# Initialize on module import
+VAPID_KEYS = load_vapid_keys()
+VAPID_ENABLED = VAPID_KEYS is not None
+
+# Make keys available as module-level variables
+VAPID_PUBLIC_KEY = VAPID_KEYS['public_key'] if VAPID_KEYS else None
+VAPID_PRIVATE_KEY = VAPID_KEYS['private_key'] if VAPID_KEYS else None
diff --git a/static/css/loading.css b/static/css/loading.css
new file mode 100644
index 00000000..c7ff82b5
--- /dev/null
+++ b/static/css/loading.css
@@ -0,0 +1,83 @@
+/* Critical loading styles - inline these in the HTML head for instant loading */
+.app-loading-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: var(--bg-primary, #1a1b26);
+    z-index: 9999;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: opacity 0.3s ease-out;
+}
+
+.app-loading-overlay.fade-out {
+    opacity: 0;
+    pointer-events: none;
+}
+
+.app-loading-content {
+    text-align: center;
+}
+
+.app-loading-spinner {
+    width: 50px;
+    height: 50px;
+    margin: 0 auto 20px;
+    border: 3px solid rgba(255, 255, 255, 0.1);
+    border-top-color: var(--text-accent, #7aa2f7);
+    border-radius: 50%;
+    animation: spin 1s linear infinite;
+}
+
+.app-loading-text {
+    color: var(--text-muted, #a0a0b0);
+    font-size: 14px;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+    letter-spacing: 0.5px;
+}
+
+.app-loading-logo {
+    width: 60px;
+    height: 60px;
+    margin: 0 auto 20px;
+    opacity: 0.8;
+}
+
+@keyframes spin {
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+/* Hide body content until ready */
+body.app-loading {
+    overflow: hidden;
+}
+
+body.app-loading > *:not(.app-loading-overlay) {
+    opacity: 0;
+}
+
+/* Dark mode default colors */
+@media (prefers-color-scheme: dark) {
+    .app-loading-overlay {
+        background: #1a1b26;
+    }
+}
+
+/* Light mode if explicitly set */
+body.light .app-loading-overlay {
+    background: #ffffff;
+}
+
+body.light .app-loading-spinner {
+    border-color: rgba(0, 0, 0, 0.1);
+    border-top-color: #3b82f6;
+}
+
+body.light .app-loading-text {
+    color: #6b7280;
+}
\ No newline at end of file
diff --git a/static/css/styles.css b/static/css/styles.css
new file mode 100644
index 00000000..ce891b44
--- /dev/null
+++ b/static/css/styles.css
@@ -0,0 +1,4345 @@
+body.unloaded {
+    opacity: 0;
+    transition: opacity 0.5s ease-in-out;
+}
+
+[v-cloak] {
+    display: none;
+}
+
+/* Color Scheme CSS Variables */
+:root {
+    /* Default Light Theme (Blue) - More muted with better contrast */
+    --bg-primary: #e8eaed; /* muted gray */
+    --bg-secondary: #f8f9fa; /* off-white */
+    --bg-tertiary: #f0f2f4; /* light gray */
+    --bg-accent: #c3d9f7; /* muted blue */
+    --bg-accent-hover: #aec9f2; /* deeper muted blue */
+    --bg-button: #2563eb; /* blue-600 */
+    --bg-button-hover: #1d4ed8; /* blue-700 */
+    --bg-danger: #dc2626; /* red-600 */
+    --bg-danger-hover: #b91c1c; /* red-700 */
+    --bg-danger-light: #fce4e4; /* muted red */
+    --bg-info-light: #c3d9f7; /* muted blue */
+    --bg-warn-light: #d4e8f5; /* soft blue */
+    --bg-success-light: #c6f0dc; /* muted green */
+    --bg-pending-light: #eeeeec; /* stone */
+    --bg-input: #fafbfc; /* slightly gray white */
+    --bg-audio-player: var(--bg-tertiary);
+
+    --text-primary: #1f2937; /* gray-800 */
+    --text-secondary: #374151; /* gray-700 */
+    --text-muted: #6b7280; /* gray-500 */
+    --text-light: #9ca3af; /* gray-400 */
+    --text-accent: #1d4ed8; /* blue-700 */
+    --text-button: #ffffff; /* white */
+    --text-danger: #b91c1c; /* red-700 */
+    --text-danger-strong: #991b1b; /* red-800 */
+    --text-info-strong: #1e40af; /* blue-800 */
+    --text-warn-strong: #0369a1; /* sky-700 - friendly blue tone */
+    --text-success-strong: #065f46; /* green-800 */
+    --text-pending-strong: #44403c; /* stone-700 */
+
+    --border-primary: #e5e7eb; /* gray-200 */
+    --border-secondary: #d1d5db; /* gray-300 */
+    --border-accent: #93c5fd; /* blue-300 */
+    --border-danger: #f87171; /* red-400 */
+    --border-focus: #3b82f6; /* blue-500 */
+    --ring-focus: #bfdbfe; /* blue-200 */
+    
+    --scrollbar-track: #f1f1f1;
+    --scrollbar-thumb: #c5c5c5;
+    --scrollbar-thumb-hover: #a8a8a8;
+    
+    /* Toast notification colors */
+    --bg-success: #10b981;
+    --border-success: #059669;
+}
+
+/* Light Theme Variants */
+.theme-light-emerald {
+    --bg-primary: #e6f0e9; /* muted green-gray */
+    --bg-secondary: #f4f9f5; /* soft off-white green */
+    --bg-tertiary: #ebf4ed; /* light muted green */
+    --bg-accent: #d0e8d7; /* muted pastel green */
+    --bg-accent-hover: #c1e0ca; /* deeper muted green */
+    --bg-button: #059669; /* keep button visible */
+    --bg-button-hover: #047857; /* keep button visible */
+    --bg-input: #f9fcfa; /* slightly green white */
+    --text-accent: #047857; /* keep accent text visible */
+    --border-primary: #d4e5d8; /* muted green border */
+    --border-secondary: #c2dcc9; /* soft green border */
+    --border-accent: #a8d0b3; /* medium green border */
+    --border-focus: #10b981; /* keep focus visible */
+    --ring-focus: #d0e8d7; /* muted green ring */
+    --bg-audio-player: var(--bg-tertiary);
+}
+
+.theme-light-purple {
+    --bg-primary: #ebe9f0; /* muted purple-gray */
+    --bg-secondary: #f7f6f9; /* soft off-white purple */
+    --bg-tertiary: #f0eef4; /* light muted purple */
+    --bg-accent: #dcd7e8; /* muted pastel purple */
+    --bg-accent-hover: #d0c9df; /* deeper muted purple */
+    --bg-button: #7c3aed; /* keep button visible */
+    --bg-button-hover: #6d28d9; /* keep button visible */
+    --bg-input: #faf9fc; /* slightly purple white */
+    --text-accent: #6d28d9; /* keep accent text visible */
+    --border-primary: #dbd6e6; /* muted purple border */
+    --border-secondary: #cfc8dd; /* soft purple border */
+    --border-accent: #bab0d2; /* medium purple border */
+    --border-focus: #8b5cf6; /* keep focus visible */
+    --ring-focus: #dcd7e8; /* muted purple ring */
+    --bg-audio-player: var(--bg-tertiary);
+}
+
+.theme-light-rose {
+    --bg-primary: #f0e9ed; /* muted rose-gray */
+    --bg-secondary: #f9f6f7; /* soft off-white rose */
+    --bg-tertiary: #f4eef1; /* light muted rose */
+    --bg-accent: #e6d7df; /* muted pastel rose */
+    --bg-accent-hover: #dfc9d4; /* deeper muted rose */
+    --bg-button: #e11d48; /* keep button visible */
+    --bg-button-hover: #be185d; /* keep button visible */
+    --bg-input: #fcf9fa; /* slightly rose white */
+    --text-accent: #be185d; /* keep accent text visible */
+    --border-primary: #e5d6de; /* muted rose border */
+    --border-secondary: #dbc8d2; /* soft rose border */
+    --border-accent: #d0b0bf; /* medium rose border */
+    --border-focus: #ec4899; /* keep focus visible */
+    --ring-focus: #e6d7df; /* muted rose ring */
+    --bg-audio-player: var(--bg-tertiary);
+}
+
+.theme-light-amber {
+    --bg-primary: #efebe6; /* muted amber-gray */
+    --bg-secondary: #f9f7f4; /* soft off-white amber */
+    --bg-tertiary: #f3efe9; /* light muted amber */
+    --bg-accent: #e5ddd1; /* muted pastel amber */
+    --bg-accent-hover: #ddd2c2; /* deeper muted amber */
+    --bg-button: #d97706; /* keep button visible */
+    --bg-button-hover: #b45309; /* keep button visible */
+    --bg-input: #fbfaf8; /* slightly amber white */
+    --text-accent: #b45309; /* keep accent text visible */
+    --border-primary: #e2dace; /* muted amber border */
+    --border-secondary: #d9cdb9; /* soft amber border */
+    --border-accent: #cdbca1; /* medium amber border */
+    --border-focus: #f59e0b; /* keep focus visible */
+    --ring-focus: #e5ddd1; /* muted amber ring */
+    --bg-audio-player: var(--bg-tertiary);
+}
+
+.theme-light-teal {
+    --bg-primary: #e7f0ef; /* muted teal-gray */
+    --bg-secondary: #f5f9f8; /* soft off-white teal */
+    --bg-tertiary: #ecf4f3; /* light muted teal */
+    --bg-accent: #d2e5e2; /* muted pastel teal */
+    --bg-accent-hover: #c3ddd9; /* deeper muted teal */
+    --bg-button: #0d9488; /* keep button visible */
+    --bg-button-hover: #0f766e; /* keep button visible */
+    --bg-input: #f9fcfb; /* slightly teal white */
+    --text-accent: #0f766e; /* keep accent text visible */
+    --border-primary: #c8dfdc; /* muted teal border */
+    --border-secondary: #b5d3ce; /* soft teal border */
+    --border-accent: #9cc5be; /* medium teal border */
+    --border-focus: #14b8a6; /* keep focus visible */
+    --ring-focus: #d2e5e2; /* muted teal ring */
+    --bg-audio-player: var(--bg-tertiary);
+}
+
+/* Dark Theme Base */
+.dark {
+    --bg-primary: #111827; /* gray-900 */
+    --bg-secondary: #1f2937; /* gray-800 */
+    --bg-tertiary: #374151; /* gray-700 */
+    --bg-accent: #1e3a8a; /* blue-900 */
+    --bg-accent-hover: #1e40af; /* blue-800 */
+    --bg-button: #2563eb; /* blue-600 */
+    --bg-button-hover: #3b82f6; /* blue-500 */
+    --bg-danger: #dc2626; /* red-600 */
+    --bg-danger-hover: #ef4444; /* red-500 */
+    --bg-danger-light: #7f1d1d; /* red-900 */
+    --bg-info-light: #1e3a8a; /* blue-900 */
+    --bg-warn-light: #164e63; /* cyan-800 - soft, friendly dark blue */
+    --bg-success-light: #064e3b; /* green-900 */
+    --bg-pending-light: #292524; /* stone-800 */
+    --bg-input: #374151; /* gray-700 */
+    --bg-audio-player: var(--bg-secondary);
+
+    --text-primary: #f3f4f6; /* gray-100 */
+    --text-secondary: #d1d5db; /* gray-300 */
+    --text-muted: #cbd5e1; /* slate-300 - improved contrast */
+    --text-light: #94a3b8; /* slate-400 - better visibility */
+    --text-accent: #60a5fa; /* blue-400 */
+    --text-button: #ffffff; /* white */
+    --text-danger: #f87171; /* red-400 */
+    --text-danger-strong: #fca5a5; /* red-300 */
+    --text-info-strong: #93c5fd; /* blue-300 */
+    --text-warn-strong: #67e8f9; /* cyan-300 - soft, friendly cyan text */
+    --text-success-strong: #6ee7b7; /* green-300 */
+    --text-pending-strong: #d6d3d1; /* stone-300 */
+
+    --border-primary: #475569; /* slate-600 - more visible */
+    --border-secondary: #64748b; /* slate-500 - better contrast */
+    --border-accent: #1d4ed8; /* blue-700 */
+    --border-danger: #ef4444; /* red-500 */
+    --border-focus: #3b82f6; /* blue-500 */
+    --ring-focus: #1e40af; /* blue-800 */
+    
+    --scrollbar-track: #2d3748; /* gray-800 */
+    --scrollbar-thumb: #4a5568; /* gray-600 */
+    --scrollbar-thumb-hover: #718096; /* gray-500 */
+}
+
+/* Dark Theme Variants */
+.dark.theme-dark-emerald {
+    --bg-primary: #1a2420; /* lighter dark with emerald tint */
+    --bg-secondary: #243028; /* medium dark with emerald hint */
+    --bg-tertiary: #2e3c30; /* lighter dark with emerald hint */
+    --bg-accent: #384838; /* visible emerald accent */
+    --bg-accent-hover: #425440; /* lighter emerald accent */
+    --bg-button: #059669; /* keep button visible */
+    --bg-button-hover: #10b981; /* keep button visible */
+    --bg-input: #2e3c30; /* darker emerald input background */
+    --text-accent: #7dd3ae; /* muted pastel emerald text */
+    --border-primary: #3a4540; /* visible emerald border */
+    --border-secondary: #485548; /* lighter emerald border */
+    --border-accent: #556550; /* medium emerald border */
+    --border-focus: #10b981; /* keep focus visible */
+    --ring-focus: #384838; /* visible ring */
+    --bg-audio-player: var(--bg-tertiary);
+    --scrollbar-thumb: #485548; /* emerald tinted scrollbar */
+    --scrollbar-thumb-hover: #556655; /* brighter emerald on hover */
+}
+
+.dark.theme-dark-purple {
+    --bg-primary: #1e1a24; /* lighter dark with purple tint */
+    --bg-secondary: #2a2430; /* medium dark with purple hint */
+    --bg-tertiary: #36303c; /* lighter dark with purple hint */
+    --bg-accent: #423c48; /* visible purple accent */
+    --bg-accent-hover: #4e4854; /* lighter purple accent */
+    --bg-button: #7c3aed; /* keep button visible */
+    --bg-button-hover: #8b5cf6; /* keep button visible */
+    --bg-input: #36303c; /* darker purple input background */
+    --text-accent: #b8a5d4; /* muted pastel purple text */
+    --border-primary: #484050; /* visible purple border */
+    --border-secondary: #555058; /* lighter purple border */
+    --border-accent: #626060; /* medium purple border */
+    --border-focus: #8b5cf6; /* keep focus visible */
+    --ring-focus: #423c48; /* visible ring */
+    --bg-audio-player: var(--bg-tertiary);
+    --scrollbar-thumb: #555058; /* purple tinted scrollbar */
+    --scrollbar-thumb-hover: #666068; /* brighter purple on hover */
+}
+
+.dark.theme-dark-rose {
+    --bg-primary: #241a20; /* lighter dark with rose tint */
+    --bg-secondary: #302428; /* medium dark with rose hint */
+    --bg-tertiary: #3c3030; /* lighter dark with rose hint */
+    --bg-accent: #483c40; /* visible rose accent */
+    --bg-accent-hover: #54484c; /* lighter rose accent */
+    --bg-button: #e11d48; /* keep button visible */
+    --bg-button-hover: #f43f5e; /* keep button visible */
+    --bg-input: #3c3030; /* darker rose input background */
+    --text-accent: #d4a5b4; /* muted pastel rose text */
+    --border-primary: #504048; /* visible rose border */
+    --border-secondary: #585050; /* lighter rose border */
+    --border-accent: #606058; /* medium rose border */
+    --border-focus: #f43f5e; /* keep focus visible */
+    --ring-focus: #483c40; /* visible ring */
+    --bg-audio-player: var(--bg-tertiary);
+    --scrollbar-thumb: #554850; /* rose tinted scrollbar */
+    --scrollbar-thumb-hover: #665860; /* brighter rose on hover */
+}
+
+.dark.theme-dark-amber {
+    --bg-primary: #24201a; /* lighter dark with amber tint */
+    --bg-secondary: #302824; /* medium dark with amber hint */
+    --bg-tertiary: #3c342e; /* lighter dark with amber hint */
+    --bg-accent: #484038; /* visible amber accent */
+    --bg-accent-hover: #544c42; /* lighter amber accent */
+    --bg-button: #d97706; /* keep button visible */
+    --bg-button-hover: #f59e0b; /* keep button visible */
+    --bg-input: #3c342e; /* darker amber input background */
+    --text-accent: #d4c5a5; /* muted pastel amber text */
+    --border-primary: #504840; /* visible amber border */
+    --border-secondary: #585548; /* lighter amber border */
+    --border-accent: #606250; /* medium amber border */
+    --border-focus: #f59e0b; /* keep focus visible */
+    --ring-focus: #484038; /* visible ring */
+    --bg-audio-player: var(--bg-tertiary);
+    --scrollbar-thumb: #585548; /* amber tinted scrollbar */
+    --scrollbar-thumb-hover: #686658; /* brighter amber on hover */
+}
+
+.dark.theme-dark-teal {
+    --bg-primary: #1a2424; /* lighter dark with teal tint */
+    --bg-secondary: #243030; /* medium dark with teal hint */
+    --bg-tertiary: #2e3c3c; /* lighter dark with teal hint */
+    --bg-accent: #384848; /* visible teal accent */
+    --bg-accent-hover: #425454; /* lighter teal accent */
+    --bg-button: #0d9488; /* keep button visible */
+    --bg-button-hover: #14b8a6; /* keep button visible */
+    --bg-input: #2e3c3c; /* darker teal input background */
+    --text-accent: #a5d4d0; /* muted pastel teal text */
+    --border-primary: #404848; /* visible teal border */
+    --border-secondary: #485555; /* lighter teal border */
+    --border-accent: #506262; /* medium teal border */
+    --border-focus: #14b8a6; /* keep focus visible */
+    --ring-focus: #384848; /* visible ring */
+    --bg-audio-player: var(--bg-tertiary);
+    --scrollbar-thumb: #485555; /* teal tinted scrollbar */
+    --scrollbar-thumb-hover: #586666; /* brighter teal on hover */
+}
+
+/* Modern UI styles */
+.height-100 { height: 100%; }
+.drag-area { transition: background-color 0.3s ease, border-color 0.3s ease; }
+/* Global Scrollbar Styles */
+::-webkit-scrollbar {
+    width: 10px;
+    height: 10px;
+}
+::-webkit-scrollbar-track {
+    background: transparent;
+    border-radius: 10px;
+}
+::-webkit-scrollbar-thumb {
+    background: var(--scrollbar-thumb);
+    border-radius: 10px;
+    border: 2px solid transparent;
+    background-clip: padding-box;
+}
+::-webkit-scrollbar-thumb:hover {
+    background: var(--scrollbar-thumb-hover);
+    border: 2px solid transparent;
+    background-clip: padding-box;
+}
+/* Fix scrollbar corner for rounded containers */
+::-webkit-scrollbar-corner {
+    background: transparent;
+}
+html { /* Apply base colors to html for smoother transitions */
+    background-color: var(--bg-primary); 
+    color: var(--text-primary); 
+    transition: background-color 0.3s, color 0.3s; 
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+}
+html { 
+    height: 100%; 
+    margin: 0;
+}
+body {
+    height: 100%;
+    margin: 0;
+    overflow-y: auto; /* Allow scrolling on the body */
+}
+
+/* Mobile fly-in menu specific styles */
+@media (max-width: 1023px) { /* Corresponds to Tailwind's lg breakpoint */
+    .sidebar-container.fixed {
+        height: 100vh; /* Full viewport height */
+        overflow-y: auto; /* Allow scrolling within the fly-in menu */
+        z-index: 9999 !important; /* Ensure it's above everything else */
+    }
+    /* .main-content-area styling for mobile is handled by v-if in html now */
+    /*
+    .main-content-area {
+        transition: filter 0.3s ease-in-out;
+    }
+    body.mobile-menu-open .main-content-area {
+        filter: blur(4px); 
+    }
+    */
+    body.mobile-menu-open {
+        overflow: hidden; /* Prevent body scroll when mobile menu is open */
+    }
+    
+    /* Fix for mobile sidebar visibility */
+    .sidebar-container {
+        z-index: 50 !important; /* Ensure proper z-index */
+    }
+    
+    /* Ensure the mobile sidebar shows above the overlay */
+    .fixed.inset-y-0.left-0.z-40 { /* This targets the overlay, not the sidebar */
+        z-index: 50 !important;
+    }
+
+    /* Custom easing for mobile sidebar slide animation */
+    /* This targets the main sidebar div when it's in mobile fly-in mode */
+    /* and has the transition-transform class applied by Vue/Tailwind. */
+    div.fixed.z-50.transition-transform {
+        transition-timing-function: cubic-bezier(0.68, -0.55, 0.265, 1.55);
+    }
+}
+
+/* Mobile viewport height fix */
+@media (max-width: 767px) { /* Target mobile devices specifically */
+    .main {
+        min-height: 4000px !important; /* Fixed viewport height for mobile */
+    }
+}
+#app { 
+    min-height: 100%; /* Full viewport height */
+    display: flex; 
+    flex-direction: column;
+}
+main { 
+    flex: 1; 
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    overflow-y: auto; /* Allow scrolling on main */
+}
+
+/* Sidebar styles with flexible height */
+.sidebar-container {
+    height: 100%; /* Use relative height */
+    display: flex;
+    flex-direction: column;
+    overflow-y: auto; /* Allow sidebar to scroll */
+}
+
+/* Grid container with flex layout and flexible height */
+.grid-container {
+    height: 100%; /* Use relative height */
+    display: flex;
+    flex-direction: column;
+    overflow-y: auto; /* Allow scrolling */
+}
+
+.sidebar-header {
+    flex-shrink: 0; /* Prevent header from shrinking */
+}
+
+.sidebar-content {
+    flex-grow: 1;
+    overflow-y: auto; /* Enable scrolling for content */
+    padding-right: 6px; /* Space for scrollbar */
+    min-height: 0; /* Added for robust flex scrolling */
+}
+.progress-popup { position: fixed; bottom: 1rem; left: 1rem; z-index: 100; transition: all 0.3s ease-in-out; min-width: 300px; max-width: 400px; border-radius: 12px; overflow: hidden; }
+.progress-popup.minimized { transform: translateY(calc(100% - 45px)); }
+.progress-list-item { display: grid; grid-template-columns: auto 1fr auto; gap: 0.5rem; align-items: center; }
+.progress-list-item .truncate { 
+    overflow: hidden; 
+    text-overflow: ellipsis; 
+    white-space: nowrap; 
+    min-width: 0; 
+}
+.summary-box,
+.notes-box {
+    flex: 1;
+    width: 100%;
+    min-height: 0;
+    min-width: 0;
+    max-height: 100%;
+    overflow-y: auto;
+    overflow-x: hidden;
+    background-color: var(--bg-tertiary);
+    padding: 1rem;
+    border-radius: 0.75rem;
+    border: 1px solid var(--border-primary);
+    scrollbar-gutter: stable;
+    color: var(--text-secondary);
+    box-shadow: 0 1px 2px rgba(0,0,0,0.03);
+    word-wrap: break-word;
+    overflow-wrap: break-word;
+}
+
+.transcription-box {
+    background-color: var(--bg-tertiary);
+    padding: 1rem; /* p-4 */
+    border-radius: 0.75rem; /* rounded-xl */
+    border: 1px solid var(--border-primary);
+    min-height: 0; /* Allow proper flex shrinking for scrolling */
+    overflow-y: auto; /* Enable vertical scrolling */
+    white-space: normal; /* Allow markdown HTML to control spacing */
+    font-family: inherit; /* Use body font */
+    font-size: 0.875rem; /* text-sm */
+    line-height: 1.5; /* Consistent line height */
+    box-shadow: 0 1px 2px rgba(0,0,0,0.03); /* Subtle shadow */
+    flex: 1; /* Take up available space */
+    color: var(--text-secondary);
+}
+
+/* Standardize border radius for all content boxes */
+.transcription-box, 
+.summary-box, 
+.chat-container,
+textarea,
+div[v-if="!editingParticipants"],
+div[v-if="!editingNotes"] {
+    border-radius: 0.75rem !important; /* rounded-xl */
+}
+
+/* Content boxes with flex layout */
+.content-column {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0; /* Allow content to size based on parent container */
+    flex: 1 1 auto; /* Grow and shrink as needed */
+    overflow: hidden;
+}
+
+/* Left column content (participants, transcription, tabs) */
+.left-content {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0; /* Allow flex to work properly */
+    overflow: hidden; /* Prevent this container from scrolling */
+}
+
+/* Right column content (audio player, chat) */
+.right-content {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    gap: 1rem;
+    overflow-y: auto; /* Enable scrolling for content that exceeds container */
+    min-height: 0; /* Allows flex to work properly */
+}
+
+/* Participants section - small fixed height */
+.participants-section {
+    flex-shrink: 0;
+    margin-bottom: 1rem; /* Add space below participants box */
+}
+
+/* Transcription section - takes up significant space */
+.transcription-section {
+    /* flex: 2; */ /* Removed: Let JavaScript control flex values */
+    min-height: 0; /* Critical for flex shrinking */
+    overflow: hidden; /* Contain overflow to enable proper flex behavior */
+    display: flex;
+    flex-direction: column;
+}
+
+/* Tab content section - takes up remaining space and aligns with chat box */
+.tab-section {
+    min-height: 0; /* Critical for flex items */
+    overflow: hidden; /* Prevent internal overflow from affecting layout */
+    display: flex;
+    flex-direction: column;
+}
+
+/* Audio player section - small fixed height */
+.audio-section {
+    flex-shrink: 0;
+}
+
+/* Chat section - takes up remaining space */
+.chat-section {
+    flex: 1;
+    min-height: 0; /* Allows flex to work properly */
+    overflow-y: auto; /* Changed from hidden to auto to enable scrolling */
+    display: flex;
+    flex-direction: column;
+}
+
+.tab-content-box {
+    flex: 1;
+    overflow-y: auto;
+    min-height: 0; /* Allows flex to work properly */
+    height: 100%; /* Fill available height */
+    display: flex;
+    flex-direction: column;
+}
+
+.chat-content-box {
+    flex: 1;
+    overflow-y: auto;
+    min-height: 0; /* Allows flex to work properly */
+}
+.metadata-panel {
+    background-color: var(--bg-tertiary);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.75rem; /* rounded-xl to match others */
+    padding: 1rem; /* p-4 to be consistent */
+    /* margin-top removed to align with other boxes */
+    font-size: 0.875rem; /* text-sm */
+    color: var(--text-secondary);
+    flex: 1; /* Take up available space */
+    height: 100%; /* Fill the container height */
+    overflow-y: auto; /* Enable scrolling when content overflows */
+}
+.metadata-panel dt {
+    font-weight: 500;
+    color: var(--text-primary);
+    margin-bottom: 0.1rem;
+}
+.metadata-panel dd {
+    margin-left: 0;
+    margin-bottom: 0.5rem;
+    word-break: break-all; /* Wrap long filenames */
+}
+ .status-badge {
+     display: inline-block;
+     padding: 0.12rem 0.5rem; /* Even smaller padding */
+     font-size: 0.6rem; /* Smaller text */
+     font-weight: 500; /* font-medium */
+     border-radius: 9999px; /* rounded-full */
+     box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+     letter-spacing: 0.025em;
+     vertical-align: middle; /* Align with text */
+     margin-left: 0.5rem; /* Less space */
+     opacity: 0.85; /* Slightly more subtle */
+     transition: opacity 0.2s ease;
+ }
+ .status-badge:hover {
+     opacity: 1;
+ }
+ .status-processing { color: #1d4ed8; background-color: #dbeafe; } /* text-blue-800 bg-blue-100 */
+ .status-summarizing { color: #92400e; background-color: #fef3c7; } /* text-amber-800 bg-amber-100 */
+ .status-completed { color: #065f46; background-color: #d1fae5; } /* text-green-800 bg-green-100 */
+ .status-failed { color: #991b1b; background-color: #fee2e2; } /* text-red-800 bg-red-100 */
+ .status-pending { color: #57534e; background-color: #f5f5f4; } /* text-stone-700 bg-stone-100 */
+ .status-highlighted { color: #d97706; background-color: #fef3c7; border: 1px solid #f59e0b; } /* text-amber-700 bg-amber-100 border-amber-500 */
+ .status-inbox { color: #1d4ed8; background-color: #dbeafe; border: 1px solid #3b82f6; } /* text-blue-700 bg-blue-100 border-blue-500 */
+ 
+ /* Clickable badge styles */
+ .clickable-badge {
+     cursor: pointer;
+     transition: all 0.2s ease;
+ }
+ 
+ .clickable-badge:hover {
+     transform: translateY(-1px);
+     box-shadow: 0 2px 4px rgba(0,0,0,0.15);
+     opacity: 0.8;
+ }
+ 
+ /* Transcription box with flex layout */
+ .transcription-box {
+     flex: 1;
+     overflow-y: auto;
+     position: relative;
+     min-height: 0; /* Allows flex to work properly */
+ }
+ 
+ /* Modern copy button styles */
+ .copy-btn {
+    background-color: var(--bg-tertiary);
+    border: 1px solid var(--border-primary);
+    color: var(--text-secondary);
+    border-radius: 0.5rem;
+    padding: 0.35rem 0.75rem;
+    font-size: 0.75rem;
+    cursor: pointer;
+    transition: all 0.2s cubic-bezier(0.25, 0.1, 0.25, 1);
+    box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+ }
+
+ /* Desktop only: match height of toggle buttons when icon-only */
+ @media (min-width: 1024px) {
+    #leftMainColumn .view-mode-toggle {
+        height: 1.75rem;
+    }
+    #leftMainColumn .toggle-button {
+        height: 1.75rem;
+        padding-top: 0;
+        padding-bottom: 0;
+        line-height: 1;
+    }
+    #leftMainColumn .copy-btn {
+        height: 1.75rem;
+        padding-top: 0;
+        padding-bottom: 0;
+        line-height: 1;
+    }
+ }
+ 
+ .copy-btn:hover {
+     background-color: var(--bg-accent-hover);
+     transform: translateY(-1px);
+     box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+ }
+
+ .dark .copy-btn {
+    background-color: var(--bg-secondary);
+    border-color: var(--border-secondary);
+    color: var(--text-primary);
+}
+
+.dark .copy-btn:hover {
+    background-color: var(--bg-tertiary);
+}
+ 
+ /* Hover edit button styles */
+.content-box {
+    position: relative;
+    width: 100%;
+    height: 100%;
+    min-height: 0;
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+}
+ 
+ .hover-edit-btn {
+     position: absolute;
+     top: 10px;
+     right: 10px;
+     background-color: rgba(255, 255, 255, 0.9);
+     border: 1px solid #e5e7eb;
+     border-radius: 0.5rem;
+     padding: 0.35rem 0.75rem;
+     font-size: 0.75rem;
+     cursor: pointer;
+     z-index: 10;
+     transition: all 0.2s ease;
+     box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+     opacity: 0;
+ }
+ 
+ .content-box:hover .hover-edit-btn {
+     opacity: 1;
+ }
+ 
+ .hover-edit-btn:hover {
+     background-color: #f3f4f6;
+     transform: translateY(-1px);
+     box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+ }
+ 
+ .dark .hover-edit-btn {
+     background-color: rgba(55, 65, 81, 0.9);
+     border-color: #4b5563;
+ }
+ 
+ .dark .hover-edit-btn:hover {
+     background-color: #4b5563;
+ }
+ 
+ /* Modern chat section styles */
+ .chat-container {
+     border: 1px solid #e5e7eb;
+     border-radius: 0.75rem;
+     display: flex;
+     flex-direction: column;
+     height: 100%;
+     min-height: 300px; /* Minimum height for chat container */
+     box-shadow: 0 1px 3px rgba(0,0,0,0.05);
+     overflow: hidden;
+ }
+ 
+ .chat-messages {
+     flex-grow: 1;
+     overflow-y: auto;
+     padding: 1.25rem;
+ }
+ 
+ .chat-input-container {
+     border-top: 1px solid #e5e7eb;
+     padding: 0.75rem;
+     display: flex;
+     background-color: var(--bg-tertiary);
+ }
+ 
+ .message {
+     margin-bottom: 1.25rem;
+     max-width: 80%;
+     box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+     line-height: 1.5;
+ }
+ 
+ .user-message {
+     background-color: var(--accent-primary);
+     color: var(--text-accent-contrast);
+     border-radius: 1.25rem 1.25rem 0.25rem 1.25rem;
+     padding: 0.875rem 1rem;
+     margin-left: auto;
+     border: 1px solid var(--border-accent);
+ }
+ 
+ .ai-message {
+     background-color: var(--bg-tertiary);
+     color: var(--text-primary);
+     border-radius: 1.25rem 1.25rem 1.25rem 0.25rem;
+     padding: 0.875rem 1rem;
+     border: 1px solid var(--border-secondary);
+     overflow-x: auto; /* Enable horizontal scrolling for wide content like tables */
+ }
+
+ 
+ .copyable {
+     position: relative;
+ }
+ 
+ /* Markdown styling */
+ .ai-message h1, .ai-message h2, .ai-message h3,
+ .summary-box h1, .summary-box h2, .summary-box h3,
+ .notes-box h1, .notes-box h2, .notes-box h3 {
+     font-weight: 600;
+     margin-top: 1rem;
+     margin-bottom: 0.5rem;
+ }
+ 
+ .ai-message h1, .summary-box h1, .notes-box h1 { font-size: 1.25rem; }
+ .ai-message h2, .summary-box h2, .notes-box h2 { font-size: 1.15rem; }
+ .ai-message h3, .summary-box h3, .notes-box h3 { font-size: 1.05rem; }
+
+ .ai-message p, .summary-box p, .notes-box p {
+     margin-bottom: 0.75rem;
+ }
+
+ .ai-message ul, .ai-message ol,
+ .summary-box ul, .summary-box ol,
+ .notes-box ul, .notes-box ol {
+     margin-left: 1.5rem;
+     margin-right: 0.5rem;
+     margin-bottom: 0.75rem;
+     padding-right: 0.5rem;
+     list-style-position: outside;
+     display: block;
+     width: auto;
+     max-width: calc(100% - 2rem);
+     box-sizing: border-box;
+     overflow-wrap: break-word;
+     word-break: break-word;
+ }
+ 
+ .ai-message ul, .summary-box ul, .notes-box ul { list-style-type: disc; }
+ .ai-message ol, .summary-box ol, .notes-box ol { list-style-type: decimal; }
+
+ .ai-message li, .summary-box li, .notes-box li {
+    display: list-item;
+    margin-bottom: 0.25rem;
+    width: auto;
+    max-width: 100%;
+    box-sizing: border-box;
+    overflow-wrap: anywhere;
+    word-wrap: break-word;
+    hyphens: auto;
+ }
+ 
+ .ai-message code, .summary-box code, .notes-box code {
+     background-color: var(--bg-tertiary);
+    color: var(--text-primary);
+     padding: 0.125rem 0.25rem;
+     border-radius: 0.25rem;
+     font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+     font-size: 0.875rem;
+     word-wrap: break-word;
+     overflow-wrap: break-word;
+ }
+ 
+ .ai-message pre, .summary-box pre, .notes-box pre {
+     background-color: var(--bg-tertiary);
+     color: var(--text-primary);
+     padding: 0.75rem;
+     border-radius: 0.5rem;
+     overflow-x: auto;
+     white-space: pre-wrap;
+     word-wrap: break-word;
+     overflow-wrap: break-word;
+     margin-bottom: 0.75rem;
+ }
+ 
+ .ai-message pre code, .summary-box pre code, .notes-box pre code {
+     background-color: transparent;
+     padding: 0;
+     border-radius: 0;
+     color: inherit;
+     white-space: pre-wrap;
+     word-wrap: break-word;
+     overflow-wrap: break-word;
+ }
+ 
+ /* Wrap tables in scrollable container */
+ .summary-box > table, .notes-box > table {
+     display: block;
+     width: 100%;
+     overflow-x: auto;
+ }
+
+ .ai-message table, .summary-box table, .notes-box table {
+     border-collapse: collapse;
+     width: 100%;
+     margin-bottom: 0.75rem;
+ }
+ 
+ .ai-message th, .ai-message td,
+ .summary-box th, .summary-box td,
+ .notes-box th, .notes-box td {
+     border: 1px solid var(--border-secondary); /* Use theme variable */
+     padding: 0.5rem;
+     text-align: left;
+ }
+ 
+ .ai-message th, .summary-box th, .notes-box th {
+     background-color: var(--bg-tertiary); /* Use theme variable */
+     font-weight: 600;
+ }
+ 
+ .ai-message blockquote, .summary-box blockquote, .notes-box blockquote {
+     border-left: 4px solid var(--border-secondary); /* Use theme variable */
+     padding-left: 1rem;
+     margin-left: 0;
+     margin-bottom: 0.75rem;
+     color: var(--text-muted); /* Use theme variable */
+ }
+ 
+ /* Main content container - ensure it fills available space and allows scrolling */
+.flex-grow.flex.flex-col.md\:flex-row.gap-6.overflow-hidden {
+    max-height: none !important; /* Override the inline style */
+    height: 100%;
+    flex: 1;
+    overflow-y: auto; /* Allow scrolling */
+}
+
+/* Ensure the main content container can grow properly and scroll - works for both col-span-3 and col-span-4 */
+.lg\:col-span-3.bg-\[var\(--bg-secondary\)\].p-6.rounded-lg.shadow-md.flex.flex-col.max-h-85vh,
+.lg\:col-span-4.bg-\[var\(--bg-secondary\)\].p-6.rounded-lg.shadow-md.flex.flex-col.max-h-85vh {
+    /* max-height: none !important; /* Let Tailwind class 'max-h-85vh' apply */
+    height: 100%; /* Occupy the height of its grid cell */
+    flex: 1; /* For its own children, as it's a flex container */
+    overflow-y: auto; /* Allow its own content to scroll if it exceeds its height (max 85vh) */
+}
+
+/* Ensure the main content area maintains its internal layout regardless of sidebar state */
+.main-content-area {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0;
+}
+
+/* Ensure the main content columns container maintains consistent behavior */
+#mainContentColumns {
+    display: flex;
+    flex-direction: row;
+    flex: 1;
+    min-height: 0;
+    overflow: hidden;
+    width: 100%; /* Ensure full width usage */
+}
+
+/* Ensure left and right columns maintain their proportional widths */
+#leftMainColumn {
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    overflow: hidden;
+    flex-shrink: 0; /* Prevent shrinking */
+    border-right: 1px solid var(--border-primary);
+    /* Width is controlled by inline style */
+}
+
+#rightMainColumn {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    /* Width will be calculated as remaining space */
+}
+
+/* Ensure the main column resizer remains functional */
+#mainColumnResizer {
+    flex-shrink: 0;
+}
+
+/* Form styling for edit modal */
+.form-group {
+    position: relative;
+    transition: all 0.3s ease;
+}
+
+.form-group:hover {
+    transform: translateY(-1px);
+}
+
+.form-group input:focus,
+.form-group textarea:focus {
+    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.2);
+}
+
+/* Dark mode adjustments for form elements */
+.dark .form-group input:focus,
+.dark .form-group textarea:focus {
+    box-shadow: 0 0 0 3px rgba(30, 64, 175, 0.3);
+}
+
+/* Elegant divider styling */
+.relative.py-3 {
+    margin: 0.5rem 0;
+}
+
+/* Toast notification styles */
+.toast {
+    padding: 12px 18px;
+    border-radius: 8px;
+    background-color: #4CAF50;
+    color: white;
+    font-size: 14px;
+    box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+    opacity: 0;
+    transform: translateY(20px);
+    transition: all 0.3s cubic-bezier(0.25, 0.1, 0.25, 1);
+    display: flex;
+    align-items: center;
+    min-width: 200px;
+}
+ 
+ .toast.show {
+     opacity: 1;
+     transform: translateY(0);
+ }
+ 
+ .toast i {
+     margin-right: 8px;
+ }
+ 
+ /* Copy button animation */
+ @keyframes copy-success {
+     0% { transform: scale(1); }
+     50% { transform: scale(1.2); }
+     100% { transform: scale(1); }
+ }
+ 
+ .copy-success {
+     animation: copy-success 0.3s ease;
+     color: #4CAF50 !important;
+ }
+
+/* Fix for sidebar height and scrolling */
+/* Remove fixed height constraint from the grid container to allow natural height */
+.grid.grid-cols-1.lg\:grid-cols-4.gap-6.flex-grow {
+    display: grid;
+    min-height: 0; /* Allow the grid to shrink if needed */
+    overflow: visible; /* Allow overflow to be visible and scroll with the main window */
+    align-items: start; /* Align grid items to start to prevent stretching */
+}
+
+/* Set a fixed height for the sidebar only */
+.lg\:col-span-1.bg-\[var\(--bg-secondary\)\].p-4.rounded-lg.shadow-md.sidebar-container.max-h-85vh {
+    display: flex;
+    flex-direction: column;
+    overflow: hidden; /* Hide overflow at container level */
+    height: calc(100vh - 10rem); 
+    position: sticky;
+    top: 1rem; /* Stick to the top with some padding */
+}
+
+/* Make sure the sidebar content scrolls internally */
+.sidebar-content {
+    flex: 1;
+    overflow-y: auto; /* Enable scrolling for content */
+    min-height: 0; /* Allow content to shrink */
+}
+
+/* Ensure the main content area uses the window scroll and has consistent height */
+.lg\:col-span-3.bg-\[var\(--bg-secondary\)\].p-6.rounded-lg.shadow-md.flex.flex-col.max-h-85vh {
+    max-height: calc(100vh - 10rem) !important; /* Match sidebar height */
+    height: calc(100vh - 10rem); /* Fixed height to match sidebar */
+    overflow-y: auto; /* Enable internal scrolling */
+}
+
+/* Allow the main container to use window scrolling */
+main { 
+    overflow-y: visible; /* Use window scrolling instead of internal scrolling */
+}
+
+/* Ensure body scrolls when content exceeds viewport */
+body {
+    overflow-y: auto; /* Allow scrolling on the body */
+}
+
+/* Fix recording list item layout to prevent title wrapping */
+.sidebar-content li {
+    display: flex;
+    align-items: center;
+    min-height: 3rem; /* Consistent minimum height for all items */
+    max-height: 3rem; /* Prevent items from growing taller */
+}
+
+/* Ensure recording title container doesn't grow beyond available space */
+.sidebar-content li .flex.items-center.overflow-hidden {
+    min-width: 0; /* Allow flex item to shrink below content size */
+    flex: 1; /* Take up available space */
+}
+
+/* Ensure truncate works properly on recording titles */
+.sidebar-content li .truncate {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    min-width: 0; /* Allow text to shrink */
+}
+
+/* Blinking animation for recording indicator */
+@keyframes blink-animation {
+    0% { opacity: 1; }
+    50% { opacity: 0.3; }
+    100% { opacity: 1; }
+}
+.blink {
+    animation: blink-animation 1.5s infinite;
+}
+
+/* Speaker tag styling in the modal */
+.speaker-tag {
+    font-weight: 600; /* Make speaker tags bold */
+    color: var(--text-accent);
+    padding: 2px 4px;
+    border-radius: 4px;
+    transition: all 0.2s ease-in-out;
+}
+
+.speaker-highlight {
+    padding: 3px 6px;
+    border-radius: 6px;
+    transition: all 0.3s ease;
+    position: relative;
+}
+
+/* Speaker-specific highlight styles that match speaker colors - reduced glow */
+.speaker-highlight.speaker-color-1 {
+    background-color: #E3F2FD;
+    color: #0D47A1;
+    box-shadow: 0 0 8px rgba(227, 242, 253, 0.6), 0 0 12px rgba(13, 71, 161, 0.2);
+}
+
+.speaker-highlight.speaker-color-2 {
+    background-color: #F3E5F5;
+    color: #6A1B9A;
+    box-shadow: 0 0 8px rgba(243, 229, 245, 0.6), 0 0 12px rgba(106, 27, 154, 0.2);
+}
+
+.speaker-highlight.speaker-color-3 {
+    background-color: #E8F5E8;
+    color: #1B5E20;
+    box-shadow: 0 0 8px rgba(232, 245, 232, 0.6), 0 0 12px rgba(27, 94, 32, 0.2);
+}
+
+.speaker-highlight.speaker-color-4 {
+    background-color: #FFF3E0;
+    color: #E65100;
+    box-shadow: 0 0 8px rgba(255, 243, 224, 0.6), 0 0 12px rgba(230, 81, 0, 0.2);
+}
+
+.speaker-highlight.speaker-color-5 {
+    background-color: #FCE4EC;
+    color: #AD1457;
+    box-shadow: 0 0 8px rgba(252, 228, 236, 0.6), 0 0 12px rgba(173, 20, 87, 0.2);
+}
+
+.speaker-highlight.speaker-color-6 {
+    background-color: #E0F7FA;
+    color: #006064;
+    box-shadow: 0 0 8px rgba(224, 247, 250, 0.6), 0 0 12px rgba(0, 96, 100, 0.2);
+}
+
+.speaker-highlight.speaker-color-7 {
+    background-color: #FFF9C4;
+    color: #F57F17;
+    box-shadow: 0 0 8px rgba(255, 249, 196, 0.6), 0 0 12px rgba(245, 127, 23, 0.2);
+}
+
+.speaker-highlight.speaker-color-8 {
+    background-color: #EFEBE9;
+    color: #5D4037;
+    box-shadow: 0 0 8px rgba(239, 235, 233, 0.6), 0 0 12px rgba(93, 64, 55, 0.2);
+}
+
+.speaker-highlight.speaker-color-9 {
+    background-color: #E8EAF6;
+    color: #283593;
+    box-shadow: 0 0 8px rgba(232, 234, 246, 0.6), 0 0 12px rgba(40, 53, 147, 0.2);
+}
+
+.speaker-highlight.speaker-color-10 {
+    background-color: #F1F8E9;
+    color: #558B2F;
+    box-shadow: 0 0 8px rgba(241, 248, 233, 0.6), 0 0 12px rgba(85, 139, 47, 0.2);
+}
+
+.speaker-highlight.speaker-color-11 {
+    background-color: #FFEBEE;
+    color: #C62828;
+    box-shadow: 0 0 8px rgba(255, 235, 238, 0.6), 0 0 12px rgba(198, 40, 40, 0.2);
+}
+
+.speaker-highlight.speaker-color-12 {
+    background-color: #ECEFF1;
+    color: #37474F;
+    box-shadow: 0 0 8px rgba(236, 239, 241, 0.6), 0 0 12px rgba(55, 71, 79, 0.2);
+}
+
+.speaker-highlight.speaker-color-13 {
+    background-color: #FFF8E1;
+    color: #FF8F00;
+    box-shadow: 0 0 8px rgba(255, 248, 225, 0.6), 0 0 12px rgba(255, 143, 0, 0.2);
+}
+
+.speaker-highlight.speaker-color-14 {
+    background-color: #EDE7F6;
+    color: #4527A0;
+    box-shadow: 0 0 8px rgba(237, 231, 246, 0.6), 0 0 12px rgba(69, 39, 160, 0.2);
+}
+
+.speaker-highlight.speaker-color-15 {
+    background-color: #E0F2F1;
+    color: #00695C;
+    box-shadow: 0 0 8px rgba(224, 242, 241, 0.6), 0 0 12px rgba(0, 105, 92, 0.2);
+}
+
+.speaker-highlight.speaker-color-16 {
+    background-color: #FBE9E7;
+    color: #BF360C;
+    box-shadow: 0 0 8px rgba(251, 233, 231, 0.6), 0 0 12px rgba(191, 54, 12, 0.2);
+}
+
+/* Dark mode speaker-specific highlights - reduced glow */
+.dark .speaker-highlight.speaker-color-1 {
+    background-color: #1E3A5F;
+    color: #A5C9EA;
+    box-shadow: 0 0 8px rgba(30, 58, 95, 0.6), 0 0 12px rgba(165, 201, 234, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-2 {
+    background-color: #4A2C5A;
+    color: #D4A5D4;
+    box-shadow: 0 0 8px rgba(74, 44, 90, 0.6), 0 0 12px rgba(212, 165, 212, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-3 {
+    background-color: #1F4A3C;
+    color: #A8D5A8;
+    box-shadow: 0 0 8px rgba(31, 74, 60, 0.6), 0 0 12px rgba(168, 213, 168, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-4 {
+    background-color: #5A3A1F;
+    color: #E6B366;
+    box-shadow: 0 0 8px rgba(90, 58, 31, 0.6), 0 0 12px rgba(230, 179, 102, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-5 {
+    background-color: #5A2C3E;
+    color: #E6A5C4;
+    box-shadow: 0 0 8px rgba(90, 44, 62, 0.6), 0 0 12px rgba(230, 165, 196, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-6 {
+    background-color: #1F4A47;
+    color: #A5D5D0;
+    box-shadow: 0 0 8px rgba(31, 74, 71, 0.6), 0 0 12px rgba(165, 213, 208, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-7 {
+    background-color: #4A4A1F;
+    color: #E6E266;
+    box-shadow: 0 0 8px rgba(74, 74, 31, 0.6), 0 0 12px rgba(230, 226, 102, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-8 {
+    background-color: #3E2723;
+    color: #D7CCC8;
+    box-shadow: 0 0 8px rgba(62, 39, 35, 0.6), 0 0 12px rgba(215, 204, 200, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-9 {
+    background-color: #1A237E;
+    color: #9FA8DA;
+    box-shadow: 0 0 8px rgba(26, 35, 126, 0.6), 0 0 12px rgba(159, 168, 218, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-10 {
+    background-color: #33691E;
+    color: #C5E1A5;
+    box-shadow: 0 0 8px rgba(51, 105, 30, 0.6), 0 0 12px rgba(197, 225, 165, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-11 {
+    background-color: #5A1F1F;
+    color: #EF9A9A;
+    box-shadow: 0 0 8px rgba(90, 31, 31, 0.6), 0 0 12px rgba(239, 154, 154, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-12 {
+    background-color: #263238;
+    color: #B0BEC5;
+    box-shadow: 0 0 8px rgba(38, 50, 56, 0.6), 0 0 12px rgba(176, 190, 197, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-13 {
+    background-color: #4A3F1F;
+    color: #FFE082;
+    box-shadow: 0 0 8px rgba(74, 63, 31, 0.6), 0 0 12px rgba(255, 224, 130, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-14 {
+    background-color: #311B92;
+    color: #B39DDB;
+    box-shadow: 0 0 8px rgba(49, 27, 146, 0.6), 0 0 12px rgba(179, 157, 219, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-15 {
+    background-color: #004D40;
+    color: #80CBC4;
+    box-shadow: 0 0 8px rgba(0, 77, 64, 0.6), 0 0 12px rgba(128, 203, 196, 0.2);
+}
+
+.dark .speaker-highlight.speaker-color-16 {
+    background-color: #4E2C1F;
+    color: #FFAB91;
+    box-shadow: 0 0 8px rgba(78, 44, 31, 0.6), 0 0 12px rgba(255, 171, 145, 0.2);
+}
+
+/* Speaker Legend and Bubble Styles */
+.speaker-legend {
+    position: sticky;
+    top: 0;
+    z-index: 10;
+    margin-bottom: 0.5rem;
+    background-color: var(--bg-secondary);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.375rem;
+    box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+    overflow: hidden;
+    transition: all 0.3s ease;
+}
+
+.dark .speaker-legend {
+    border: 1px solid var(--border-secondary);
+    box-shadow: 0 2px 4px rgba(0,0,0,0.2);
+}
+
+.speaker-legend-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.5rem 0.75rem;
+    background-color: var(--bg-tertiary);
+    border-bottom: 1px solid var(--border-primary);
+    cursor: pointer;
+    transition: background-color 0.2s ease;
+}
+
+.dark .speaker-legend-header {
+    background-color: var(--bg-tertiary);
+    border-bottom: 1px solid var(--border-secondary);
+}
+
+.speaker-legend-header:hover {
+    background-color: var(--bg-accent);
+}
+
+.speaker-legend-title {
+    font-size: 0.75rem;
+    font-weight: 600;
+    color: var(--text-secondary);
+    display: flex;
+    align-items: center;
+    gap: 0.375rem;
+}
+
+.speaker-legend-toggle {
+    color: var(--text-muted);
+    font-size: 0.75rem;
+    transition: transform 0.3s ease, color 0.2s ease;
+}
+
+.speaker-legend.expanded .speaker-legend-toggle {
+    transform: rotate(180deg);
+    color: var(--text-accent);
+}
+
+.speaker-legend-content {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.375rem;
+    padding: 0;
+    max-height: 0;
+    overflow: hidden;
+    transition: max-height 0.3s ease, padding 0.3s ease;
+}
+
+.speaker-legend.expanded .speaker-legend-content {
+    max-height: 200px; /* Reasonable max height for scrolling */
+    overflow-y: auto;
+    padding: 0.5rem 0.75rem;
+}
+
+.speaker-legend-item {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.25rem;
+    padding: 0.25rem 0.5rem;
+    border-radius: 0.375rem;
+    font-size: 0.6875rem;
+    font-weight: 500;
+    transition: all 0.2s ease;
+    white-space: nowrap;
+    flex-shrink: 0;
+    width: auto;
+    max-width: fit-content;
+    border: 1px solid rgba(255,255,255,0.2);
+    box-shadow: 0 1px 2px rgba(0,0,0,0.1);
+}
+
+.speaker-legend-item:hover {
+    transform: translateY(-1px);
+    box-shadow: 0 2px 4px rgba(0,0,0,0.15);
+}
+
+.speaker-name {
+    font-weight: 500;
+}
+
+/* Compact legend when collapsed - show as many speakers as fit */
+.speaker-legend:not(.expanded) .speaker-legend-content {
+    display: flex;
+    flex-direction: row;
+    flex-wrap: wrap;
+    overflow: hidden;
+    max-height: 3rem; /* Allow up to 2 rows of speakers */
+    padding: 0.25rem 0.75rem;
+}
+
+.speaker-legend:not(.expanded) .speaker-legend-item {
+    flex-shrink: 1;
+    min-width: fit-content;
+}
+
+.speaker-count-indicator {
+    font-size: 0.75rem;
+    color: var(--text-muted);
+    font-weight: 400;
+    margin-left: 0.25rem;
+}
+
+/* Floating Processing Indicator */
+.processing-indicator-floating {
+    position: sticky;
+    top: 0;
+    z-index: 15;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    background: var(--bg-secondary);
+    border: 1px solid var(--border-accent);
+    border-radius: 0.5rem;
+    padding: 0.625rem 0.875rem;
+    margin-bottom: 0.75rem;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    animation: slideDown 0.3s ease-out;
+}
+
+.dark .processing-indicator-floating {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+}
+
+@keyframes slideDown {
+    from {
+        opacity: 0;
+        transform: translateY(-10px);
+    }
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+.processing-indicator-floating.minimized {
+    position: sticky;
+    top: 0;
+    right: 0;
+    width: auto;
+    padding: 0;
+    background: transparent;
+    border: none;
+    box-shadow: none;
+    justify-content: flex-end;
+    margin-bottom: 0.5rem;
+}
+
+.processing-indicator-content {
+    display: flex;
+    align-items: center;
+    gap: 0.625rem;
+}
+
+.processing-indicator-content i {
+    font-size: 1rem;
+}
+
+.processing-indicator-minimize {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.5rem;
+    height: 1.5rem;
+    border: none;
+    background: transparent;
+    color: var(--text-muted);
+    cursor: pointer;
+    border-radius: 0.25rem;
+    transition: all 0.2s ease;
+}
+
+.processing-indicator-minimize:hover {
+    background: var(--bg-tertiary);
+    color: var(--text-primary);
+}
+
+.processing-indicator-expand {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 2rem;
+    height: 2rem;
+    border: 1px solid var(--border-accent);
+    background: var(--bg-secondary);
+    color: var(--text-accent);
+    cursor: pointer;
+    border-radius: 50%;
+    box-shadow: 0 2px 6px rgba(0, 0, 0, 0.15);
+    transition: all 0.2s ease;
+}
+
+.dark .processing-indicator-expand {
+    box-shadow: 0 2px 6px rgba(0, 0, 0, 0.3);
+}
+
+.processing-indicator-expand:hover {
+    background: var(--bg-tertiary);
+    transform: scale(1.1);
+}
+
+/* Enhanced transcription display with speaker bubbles */
+.transcription-with-speakers {
+    line-height: 1.6;
+    font-family: inherit;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+}
+
+.speaker-bubble {
+    display: inline-block;
+    margin: 0.125rem 0.25rem 0.125rem 0;
+    padding: 0.5rem 0.75rem;
+    border-radius: 0.75rem;
+    max-width: fit-content;
+    transition: background-color 0.3s ease, box-shadow 0.3s ease;
+    min-width: fit-content;
+    width: auto;
+    word-wrap: break-word;
+    position: relative;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.08);
+    transition: all 0.2s ease;
+    border: 1px solid rgba(255,255,255,0.3);
+    vertical-align: top;
+}
+
+.speaker-bubble:hover {
+    transform: translateY(-1px);
+    box-shadow: 0 2px 4px rgba(0,0,0,0.12);
+}
+
+.speaker-bubble.speaker-me {
+    border-bottom-right-radius: 0.25rem;
+}
+
+.speaker-bubble:not(.speaker-me) {
+    border-bottom-left-radius: 0.25rem;
+}
+
+.speaker-bubble-content {
+    margin: 0;
+    color: inherit;
+    font-size: 0.875rem;
+    line-height: 1.4;
+    white-space: pre-wrap;
+}
+
+/* Bubble row container for horizontal grouping */
+.bubble-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: flex-start;
+    margin-bottom: 0.5rem;
+    gap: 0.25rem;
+    width: 100%;
+}
+
+.bubble-row.speaker-me {
+    justify-content: flex-end;
+}
+
+.bubble-row:not(.speaker-me) {
+    justify-content: flex-start;
+}
+
+/* Individual bubbles within rows should size to content and allow wrapping */
+.bubble-row .speaker-bubble {
+    flex: 0 0 auto;
+    max-width: calc(100% - 0.5rem);
+    width: auto;
+    min-width: fit-content;
+    margin: 0;
+}
+
+/* Ensure bubbles can wrap to fill available space on mobile - preserve desktop styling */
+@media (max-width: 1023px) {
+    /* Target all bubble rows on mobile - preserve desktop gap and margin */
+    .bubble-row,
+    .mobile-content-box .bubble-row,
+    .transcription-with-speakers .bubble-row {
+        display: flex !important;
+        flex-direction: row !important;
+        flex-wrap: wrap !important;
+        width: 100% !important;
+        gap: 0.25rem !important;
+        margin-bottom: 0.5rem !important;
+        align-items: flex-start !important;
+    }
+    
+    /* Target all speaker bubbles on mobile - preserve desktop spacing and styling */
+    .speaker-bubble,
+    .mobile-content-box .speaker-bubble,
+    .bubble-row .speaker-bubble {
+        display: inline-block !important;
+        flex: 0 0 auto !important;
+        max-width: calc(70% - 0.25rem) !important;
+        width: auto !important;
+        min-width: fit-content !important;
+        margin: 0.125rem 0.25rem 0.125rem 0 !important; /* Preserve desktop margin */
+        flex-shrink: 1 !important;
+        vertical-align: top !important;
+        padding: 0.5rem 0.75rem !important; /* Preserve desktop padding */
+        border-radius: 0.75rem !important; /* Preserve desktop border-radius */
+        box-shadow: 0 1px 2px rgba(0,0,0,0.08) !important; /* Preserve desktop shadow */
+        transition: all 0.2s ease !important; /* Preserve desktop transition */
+        border: 1px solid rgba(255,255,255,0.3) !important; /* Preserve desktop border */
+    }
+    
+    /* Preserve desktop hover effects */
+    .speaker-bubble:hover,
+    .mobile-content-box .speaker-bubble:hover,
+    .bubble-row .speaker-bubble:hover {
+        transform: translateY(-1px) !important;
+        box-shadow: 0 2px 4px rgba(0,0,0,0.12) !important;
+    }
+    
+    /* Preserve desktop bubble content styling */
+    .speaker-bubble .speaker-bubble-content,
+    .mobile-content-box .speaker-bubble .speaker-bubble-content {
+        margin: 0 !important;
+        color: inherit !important;
+        font-size: 0.875rem !important;
+        line-height: 1.4 !important;
+        white-space: pre-wrap !important;
+    }
+    
+    /* Force horizontal layout for speaker rows */
+    .bubble-row.speaker-me,
+    .bubble-row:not(.speaker-me) {
+        display: flex !important;
+        flex-direction: row !important;
+        flex-wrap: wrap !important;
+    }
+    
+    /* Override any conflicting styles */
+    .transcription-with-speakers {
+        display: block !important;
+    }
+}
+
+/* Simple view with speaker tablets */
+.transcription-simple-view {
+    line-height: 1.6;
+    font-family: inherit;
+}
+
+.speaker-segment {
+    margin-bottom: 1rem;
+    transition: background-color 0.3s ease, box-shadow 0.3s ease;
+}
+
+/* Two-part pill that combines a timestamp and a speaker label into a single
+   visual unit. Only rendered when `show_timestamps_simple_view` is on.
+   The `.speaker-color-N` class lives on this wrapper so both halves inherit
+   the same base colour; the time half is slightly darkened with a uniform
+   black overlay so it reads as a different shade in both light and dark
+   themes without needing separate per-mode rules. */
+.speaker-tablet-group {
+    display: inline-flex;
+    align-items: stretch;
+    margin: 0 0.5rem 0.5rem 0;
+    border-radius: 0.375rem;
+    overflow: hidden;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.1);
+    font-size: 0.75rem;
+    font-weight: 600;
+    line-height: 1.4;
+    white-space: nowrap;
+}
+
+.speaker-tablet-group .speaker-tablet-time {
+    padding: 0.25rem 0.55rem;
+    font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+    font-weight: 500;
+    font-size: 0.7rem;
+    letter-spacing: 0.02em;
+    user-select: none;
+    /* Tint the half by overlaying a uniform translucent black layer. The
+       inherited speaker-color background shows through and the result reads
+       as a darker shade of the same colour in both themes. */
+    background-image: linear-gradient(rgba(0, 0, 0, 0.18), rgba(0, 0, 0, 0.18));
+    display: inline-flex;
+    align-items: center;
+}
+
+.speaker-tablet-group .speaker-tablet-name {
+    padding: 0.25rem 0.55rem;
+    display: inline-flex;
+    align-items: center;
+}
+
+/* Inline timestamp for the no-dialogue branch (single-speaker transcripts).
+   Sits at the start of each sentence in compact mono. */
+.speaker-segment-timestamp--inline {
+    font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+    font-size: 0.7rem;
+    color: var(--text-muted);
+    letter-spacing: 0.02em;
+    user-select: none;
+    margin-right: 0.5rem;
+}
+
+/* Brief highlight shown on the ASR editor row that was the target of a
+   double-click-to-edit jump from the simple view.
+   The editor's table sets `td { padding: 0; }` so the inputs fill each
+   cell. Form controls (inputs, textareas) paint their own widget surface
+   over any td-level background, which is why earlier attempts at
+   td-background or td::before only painted the action column (the only
+   cell without an input filler). The reliable fix is to colour the
+   inputs/textareas themselves and the action cell's td. */
+
+.asr-editor-row--highlighted input,
+.asr-editor-row--highlighted textarea {
+    background-color: var(--bg-accent) !important;
+    -webkit-appearance: none !important;
+    appearance: none !important;
+    transition: background-color 0.6s ease-out;
+}
+
+/* Action cell has no input filler, so paint the td directly. */
+.asr-editor-row--highlighted > td:last-child {
+    background-color: var(--bg-accent) !important;
+    transition: background-color 0.6s ease-out;
+}
+
+/* Left accent bar on the first cell as an additional visual cue. */
+.asr-editor-row--highlighted > td:first-child {
+    box-shadow: inset 4px 0 0 var(--border-accent) !important;
+}
+
+/* Active segment highlighting - for currently playing transcript */
+.speaker-segment.active-playing-segment,
+.transcript-segment.active-playing-segment {
+    background-color: var(--bg-accent) !important;
+    box-shadow: 0 0 0 2px var(--border-accent) !important;
+    animation: pulse-highlight 0.5s ease-in-out;
+    padding: 0.75rem !important;
+    margin: 0.25rem 0 !important;
+    border-radius: 0.5rem !important;
+}
+
+.speaker-bubble.active-playing-segment {
+    background-color: var(--bg-accent) !important;
+    box-shadow: 0 0 0 2px var(--border-accent) !important;
+    animation: pulse-highlight 0.5s ease-in-out;
+    transform: scale(1.02);
+}
+
+@keyframes pulse-highlight {
+    0% {
+        box-shadow: 0 0 0 0 var(--border-accent);
+    }
+    50% {
+        box-shadow: 0 0 0 4px var(--border-accent);
+    }
+    100% {
+        box-shadow: 0 0 0 2px var(--border-accent);
+    }
+}
+
+/* Follow Player Mode Checkbox Styling */
+.follow-player-control {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+    padding: 0.25rem 0.5rem;
+    border-radius: 0.375rem;
+    transition: all 0.2s ease;
+    cursor: pointer;
+    user-select: none;
+}
+
+.follow-player-control:hover {
+    background-color: var(--bg-accent-hover);
+}
+
+.follow-player-control input[type="checkbox"] {
+    appearance: none;
+    -webkit-appearance: none;
+    width: 14px;
+    height: 14px;
+    border: 1.5px solid var(--border-secondary);
+    border-radius: 0.25rem;
+    background-color: var(--bg-input);
+    cursor: pointer;
+    position: relative;
+    transition: all 0.2s ease;
+    flex-shrink: 0;
+}
+
+.follow-player-control input[type="checkbox"]:hover {
+    border-color: var(--border-accent);
+}
+
+.follow-player-control input[type="checkbox"]:checked {
+    background-color: var(--bg-button);
+    border-color: var(--bg-button);
+    animation: checkboxPop 0.2s ease-out;
+}
+
+.follow-player-control input[type="checkbox"]:checked::after {
+    content: '';
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    width: 3.5px;
+    height: 7px;
+    border: solid var(--text-button);
+    border-width: 0 2px 2px 0;
+    transform: translate(-50%, -60%) rotate(45deg);
+    animation: checkmarkDraw 0.2s ease-out;
+}
+
+@keyframes checkboxPop {
+    0% {
+        transform: scale(0.8);
+    }
+    50% {
+        transform: scale(1.1);
+    }
+    100% {
+        transform: scale(1);
+    }
+}
+
+@keyframes checkmarkDraw {
+    0% {
+        width: 0;
+        height: 0;
+        opacity: 0;
+    }
+    100% {
+        width: 3.5px;
+        height: 7px;
+        opacity: 1;
+    }
+}
+
+/* Selection checkbox - used for bulk selection in sidebar */
+.selection-checkbox {
+    appearance: none;
+    -webkit-appearance: none;
+    width: 18px;
+    height: 18px;
+    border: 2px solid var(--border-secondary);
+    border-radius: 0.25rem;
+    background-color: var(--bg-input);
+    cursor: pointer;
+    position: relative;
+    transition: all 0.2s ease;
+    flex-shrink: 0;
+}
+
+.selection-checkbox:hover {
+    border-color: var(--border-accent);
+}
+
+.selection-checkbox:checked {
+    background-color: var(--bg-button);
+    border-color: var(--bg-button);
+    animation: checkboxPop 0.2s ease-out;
+}
+
+.selection-checkbox:checked::after {
+    content: '';
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    width: 4px;
+    height: 9px;
+    border: solid var(--text-button);
+    border-width: 0 2.5px 2.5px 0;
+    transform: translate(-50%, -60%) rotate(45deg);
+    animation: checkmarkDraw 0.2s ease-out;
+}
+
+/* Vue transition for slide-up (bulk action bar) */
+.slide-up-enter-active,
+.slide-up-leave-active {
+    transition: transform 0.3s ease;
+}
+.slide-up-enter-from,
+.slide-up-leave-to {
+    transform: translateY(100%);
+}
+
+/* Vue transition for slide-right (vertical bulk action bar) */
+.slide-right-enter-active,
+.slide-right-leave-active {
+    transition: transform 0.3s ease, opacity 0.3s ease;
+}
+.slide-right-enter-from,
+.slide-right-leave-to {
+    transform: translateX(-100%) translateY(-50%);
+    opacity: 0;
+}
+
+.follow-player-control .follow-icon {
+    font-size: 11px;
+    flex-shrink: 0;
+    opacity: 0.85;
+}
+
+.follow-player-control:hover .follow-icon {
+    opacity: 1;
+}
+
+.speaker-tablet {
+    display: inline-block;
+    padding: 0.25rem 0.5rem;
+    border-radius: 0.375rem;
+    font-size: 0.75rem;
+    font-weight: 600;
+    margin-bottom: 0.5rem;
+    margin-right: 0.5rem;
+    border: none;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.1);
+}
+
+.speaker-text {
+    color: var(--text-secondary);
+    font-size: 0.875rem;
+    line-height: 1.5;
+    margin-left: 0;
+}
+
+/* View mode toggle - compact tablet style */
+.view-mode-toggle {
+    display: inline-flex;
+    align-items: stretch;
+    background-color: var(--bg-tertiary);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.5rem;
+    padding: 0;
+    gap: 0;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+}
+
+.toggle-button {
+    padding: 0.35rem 0.75rem;
+    border: none;
+    border-radius: 0.5rem;
+    background-color: transparent;
+    color: var(--text-secondary);
+    font-size: 0.75rem;
+    font-weight: 500;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    white-space: nowrap;
+    min-width: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    height: 100%;
+}
+
+.toggle-button.active {
+    background-color: var(--bg-accent);
+    color: var(--text-accent);
+}
+
+.toggle-button:hover:not(.active) {
+    background-color: var(--bg-secondary);
+    color: var(--text-secondary);
+}
+
+.toggle-button i {
+    font-size: 0.75rem;
+    margin-right: 0;
+}
+.toggle-button span + i,
+.toggle-button i + span {
+    margin-left: 0.25rem;
+}
+
+.dark .view-mode-toggle {
+    background-color: var(--bg-secondary);
+    border-color: var(--border-secondary);
+}
+
+/* Speaker colors - enhanced palette with 16 colors for better variation */
+.speaker-color-1 { background-color: #E3F2FD; color: #0D47A1; } /* Blue */
+.speaker-color-2 { background-color: #F3E5F5; color: #6A1B9A; } /* Purple */
+.speaker-color-3 { background-color: #E8F5E9; color: #1B5E20; } /* Green */
+.speaker-color-4 { background-color: #FFF3E0; color: #E65100; } /* Orange */
+.speaker-color-5 { background-color: #FCE4EC; color: #AD1457; } /* Pink */
+.speaker-color-6 { background-color: #E0F7FA; color: #006064; } /* Cyan */
+.speaker-color-7 { background-color: #FFF9C4; color: #F57F17; } /* Yellow */
+.speaker-color-8 { background-color: #EFEBE9; color: #5D4037; } /* Brown */
+.speaker-color-9 { background-color: #E8EAF6; color: #283593; } /* Indigo */
+.speaker-color-10 { background-color: #F1F8E9; color: #558B2F; } /* Lime */
+.speaker-color-11 { background-color: #FFEBEE; color: #C62828; } /* Red */
+.speaker-color-12 { background-color: #ECEFF1; color: #37474F; } /* Blue Grey */
+.speaker-color-13 { background-color: #FFF8E1; color: #FF8F00; } /* Amber */
+.speaker-color-14 { background-color: #EDE7F6; color: #4527A0; } /* Deep Purple */
+.speaker-color-15 { background-color: #E0F2F1; color: #00695C; } /* Teal */
+.speaker-color-16 { background-color: #FBE9E7; color: #BF360C; } /* Deep Orange */
+
+/* Dark mode speaker colors - tasteful muted pastels with 16 colors */
+.dark .speaker-color-1 { background-color: #1E3A5F; color: #A5C9EA; } /* Blue */
+.dark .speaker-color-2 { background-color: #4A2C5A; color: #D4A5D4; } /* Purple */
+.dark .speaker-color-3 { background-color: #1F4A3C; color: #A8D5A8; } /* Green */
+.dark .speaker-color-4 { background-color: #5A3A1F; color: #E6B366; } /* Orange */
+.dark .speaker-color-5 { background-color: #5A2C3E; color: #E6A5C4; } /* Pink */
+.dark .speaker-color-6 { background-color: #1F4A47; color: #A5D5D0; } /* Cyan */
+.dark .speaker-color-7 { background-color: #4A4A1F; color: #E6E266; } /* Yellow */
+.dark .speaker-color-8 { background-color: #3E2723; color: #D7CCC8; } /* Brown */
+.dark .speaker-color-9 { background-color: #1A237E; color: #9FA8DA; } /* Indigo */
+.dark .speaker-color-10 { background-color: #33691E; color: #C5E1A5; } /* Lime */
+.dark .speaker-color-11 { background-color: #5A1F1F; color: #EF9A9A; } /* Red */
+.dark .speaker-color-12 { background-color: #263238; color: #B0BEC5; } /* Blue Grey */
+.dark .speaker-color-13 { background-color: #4A3F1F; color: #FFE082; } /* Amber */
+.dark .speaker-color-14 { background-color: #311B92; color: #B39DDB; } /* Deep Purple */
+.dark .speaker-color-15 { background-color: #004D40; color: #80CBC4; } /* Teal */
+.dark .speaker-color-16 { background-color: #4E2C1F; color: #FFAB91; } /* Deep Orange */
+
+/* Meeting/Created time styling improvements */
+.recording-metadata {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 1rem;
+    margin-top: 0.5rem;
+    font-size: 0.875rem;
+}
+
+.metadata-item {
+    display: flex;
+    align-items: center;
+    gap: 0.375rem;
+    color: var(--text-muted);
+    transition: color 0.2s ease;
+    white-space: nowrap;
+}
+
+.metadata-item:hover {
+    color: var(--text-secondary);
+}
+
+.metadata-icon {
+    color: var(--text-accent);
+    opacity: 0.75;
+    font-size: 0.75rem;
+    width: 12px;
+    text-align: center;
+    flex-shrink: 0;
+}
+
+.metadata-label {
+    font-weight: 500;
+    color: var(--text-secondary);
+    font-size: 0.8125rem;
+}
+
+.metadata-value {
+    color: var(--text-muted);
+    font-size: 0.8125rem;
+}
+
+.metadata-value.editable {
+    cursor: pointer;
+    padding: 0.125rem 0.25rem;
+    border-radius: 0.25rem;
+    transition: all 0.2s ease;
+}
+
+.metadata-value.editable:hover {
+    background-color: var(--bg-tertiary);
+    color: var(--text-accent);
+}
+
+.metadata-edit-input {
+    padding: 0.125rem 0.5rem;
+    background: transparent;
+    border: none;
+    border-bottom: 1px solid var(--border-secondary);
+    color: var(--text-primary);
+    font-size: inherit;
+    width: 140px;
+}
+
+.metadata-edit-input:focus {
+    outline: none;
+    border-bottom-color: var(--border-focus);
+}
+
+.metadata-edit-button {
+    margin-left: 0.25rem;
+    padding: 0.125rem;
+    background: none;
+    border: none;
+    color: var(--text-accent);
+    cursor: pointer;
+    font-size: 0.75rem;
+    opacity: 0.7;
+    transition: opacity 0.2s ease;
+}
+
+.metadata-edit-button:hover {
+    opacity: 1;
+}
+
+.modal-content {
+  max-height: calc(100vh - 200px);
+  overflow-y: auto;
+}
+
+/* Mobile Tabbed Layout */
+@media (max-width: 1023px) {
+    /* Desktop layout's main content is hidden via v-if="!isMobileScreen" in HTML */
+    /* .desktop-layout {
+        display: none !important;
+    } */
+    
+    /* Show mobile layout only on mobile */
+    .mobile-layout {
+        display: flex !important;
+        flex-direction: column;
+        height: calc(100vh - 120px); /* Account for header and footer */
+        overflow: hidden;
+    }
+    
+    /* Mobile audio player section */
+    .mobile-audio-section {
+        flex-shrink: 0;
+        padding: 1rem;
+        background-color: var(--bg-secondary);
+        border-bottom: 1px solid var(--border-primary);
+    }
+    
+    /* Mobile tab navigation */
+    .mobile-tab-nav {
+        flex-shrink: 0;
+        background-color: var(--bg-secondary);
+        border-bottom: 1px solid var(--border-primary);
+        padding: 0 1rem;
+    }
+    
+    .mobile-tab-nav .tab-list {
+        display: flex;
+        overflow-x: auto;
+        -webkit-overflow-scrolling: touch;
+        scrollbar-width: none;
+        -ms-overflow-style: none;
+    }
+    
+    .mobile-tab-nav .tab-list::-webkit-scrollbar {
+        display: none;
+    }
+    
+    .mobile-tab-button {
+        flex-shrink: 0;
+        padding: 0.75rem 1rem;
+        font-size: 0.875rem;
+        font-weight: 500;
+        border-bottom: 2px solid transparent;
+        color: var(--text-muted);
+        background: none;
+        border: none;
+        cursor: pointer;
+        transition: all 0.2s ease;
+        white-space: nowrap;
+    }
+    
+    .mobile-tab-button.active {
+        color: var(--text-accent);
+        border-bottom-color: var(--border-focus);
+    }
+    
+    .mobile-tab-button:hover {
+        color: var(--text-secondary);
+    }
+    
+    /* Mobile tab content area */
+    .mobile-tab-content {
+        flex: 1;
+        overflow: hidden;
+        background-color: var(--bg-secondary);
+    }
+    
+    .mobile-tab-panel {
+        height: 100%;
+        overflow-y: auto;
+        padding: 1rem;
+        display: none;
+    }
+    
+    .mobile-tab-panel.active {
+        display: block;
+    }
+    
+/* Mobile tab content styling */
+.mobile-content-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 1rem;
+    padding-bottom: 0.5rem;
+    border-bottom: 1px solid var(--border-primary);
+}
+
+/* Mobile fullscreen button for editors */
+.mobile-fullscreen-btn {
+    padding: 0.375rem;
+    background: none;
+    border: 1px solid var(--border-secondary);
+    border-radius: 0.375rem;
+    color: var(--text-muted);
+    cursor: pointer;
+    transition: all 0.2s ease;
+    font-size: 0.75rem;
+}
+
+.mobile-fullscreen-btn:hover {
+    background-color: var(--bg-tertiary);
+    color: var(--text-accent);
+}
+    
+    .mobile-content-header {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        margin-bottom: 1rem;
+        padding-bottom: 0.5rem;
+        border-bottom: 1px solid var(--border-primary);
+    }
+    
+    .mobile-content-title {
+        font-weight: 600;
+        color: var(--text-secondary);
+        flex: 1;
+    }
+    
+    .mobile-content-actions {
+        display: flex;
+        gap: 0.5rem;
+    }
+    
+    .mobile-action-btn {
+        padding: 0.5rem;
+        background: none;
+        border: 1px solid var(--border-secondary);
+        border-radius: 0.375rem;
+        color: var(--text-muted);
+        cursor: pointer;
+        transition: all 0.2s ease;
+        font-size: 0.875rem;
+    }
+    
+    .mobile-action-btn:hover {
+        background-color: var(--bg-tertiary);
+        color: var(--text-accent);
+    }
+    
+    .mobile-content-box {
+        flex: 1;
+        background-color: var(--bg-tertiary);
+        border: 1px solid var(--border-primary);
+        border-radius: 0.75rem;
+        padding: 1rem;
+        overflow-y: auto;
+        overflow-x: hidden;
+        font-size: 0.875rem;
+        line-height: 1.5;
+        /* Fix scrollbar clipping rounded corners */
+        scrollbar-gutter: stable;
+        color: var(--text-secondary);
+        min-height: 0;
+    }
+
+    /* Remove inner box styling for summary and notes on mobile */
+    .mobile-content-box .summary-box,
+    .mobile-content-box .notes-box {
+        background-color: transparent;
+        border: none;
+        padding: 0;
+        border-radius: 0;
+        height: auto;
+    }
+
+    /* Remove padding from mobile-content-box when it contains markdown editor */
+    .mobile-content-box:has(.markdown-editor-container) {
+        padding: 0;
+        overflow: hidden; /* Ensure rounded corners are respected */
+    }
+
+    /* Make editor fill the rounded container properly */
+    .mobile-content-box .markdown-editor-container {
+        height: 100%;
+    }
+
+    .mobile-content-box .markdown-editor-container .EasyMDEContainer {
+        border: none !important;
+        border-radius: 0.75rem;
+        height: 100%;
+    }
+
+    .mobile-content-box .markdown-editor-container .EasyMDEContainer .editor-toolbar {
+        border: none !important;
+        border-radius: 0.75rem 0.75rem 0 0;
+        border-bottom: 1px solid var(--border-primary) !important;
+    }
+
+    .mobile-content-box .markdown-editor-container .EasyMDEContainer .CodeMirror {
+        border: none !important;
+        border-radius: 0 0 0.75rem 0.75rem;
+    }
+
+    .mobile-content-box .markdown-editor-container .EasyMDEContainer .CodeMirror-scroll {
+        border-radius: 0 0 0.75rem 0.75rem;
+    }
+    
+    /* Mobile chat layout */
+    .mobile-chat-content {
+        height: 100%;
+        display: flex;
+        flex-direction: column;
+    }
+    
+    .mobile-chat-messages {
+        flex: 1;
+        overflow-y: auto;
+        padding: 1rem;
+        background-color: var(--bg-secondary); /* Changed from --bg-tertiary */
+        border: 1px solid var(--border-primary);
+        border-radius: 0.75rem 0.75rem 0 0;
+        margin-bottom: 0;
+    }
+    
+    .mobile-chat-input {
+        background-color: var(--bg-tertiary);
+        border: 1px solid var(--border-primary);
+        border-top: none;
+        border-radius: 0 0 0.75rem 0.75rem;
+        padding: 0.75rem;
+        display: flex;
+        gap: 0.5rem;
+    }
+    
+    .mobile-chat-input textarea { /* Changed from input to textarea */
+        flex: 1;
+        padding: 0.5rem;
+        border: 1px solid var(--border-secondary);
+        border-radius: 0.375rem;
+        background-color: var(--bg-input);
+        color: var(--text-primary);
+        font-size: 0.875rem;
+        line-height: 1.5; /* Added for consistent line height */
+        resize: none; /* Prevent manual resizing */
+        min-height: calc(1.5em + 1rem); /* Approx 1 line with padding */
+        max-height: calc(1.5em * 4 + 1rem); /* Approx 4 lines with padding */
+        overflow-y: auto; /* Allow scrolling after max-height */
+    }
+
+/* Desktop chat input textarea styling */
+.chat-input-container textarea {
+    min-height: calc(1.5em * 3 + 1rem); /* Approx 3 lines with padding */
+    max-height: calc(1.5em * 6 + 1rem); /* Approx 6 lines with padding */
+    overflow-y: auto; /* Allow scrolling after max-height */
+    line-height: 1.5; /* Consistent line height */
+    font-family: inherit; /* Use the same font as the rest of the app */
+}
+    
+    .mobile-chat-input button {
+        padding: 0.5rem 1rem;
+        background-color: var(--bg-button);
+        color: var(--text-button);
+        border: none;
+        border-radius: 0.375rem;
+        cursor: pointer;
+        font-size: 0.875rem;
+    }
+    
+    .mobile-chat-input button:disabled {
+        background-color: var(--bg-tertiary);
+        color: var(--text-muted);
+        cursor: not-allowed;
+    }
+}
+
+/* Hide mobile layout on desktop */
+@media (min-width: 1024px) {
+    .mobile-layout {
+        display: none !important;
+    }
+    
+    .desktop-layout {
+        display: block !important;
+    }
+}
+
+/* Responsive adjustments for mobile */
+@media (max-width: 1023px) {
+    /* Ensure modals are not too wide on small screens */
+    .fixed.inset-0 .w-full.max-w-md,
+    .fixed.inset-0 .w-full.max-w-lg,
+    .fixed.inset-0 .w-full.max-w-4xl {
+        max-width: 95vw !important;
+        max-height: 90vh;
+    }
+
+    /* Ensure the main content area is visible when the mobile menu is closed */
+    .main-content-area {
+        display: block !important;
+    }
+
+}
+
+/* Responsive title that shrinks font size instead of wrapping */
+.responsive-title {
+    font-size: clamp(1.125rem, 3.5vw, 1.5rem); /* More aggressive responsive scaling */
+    line-height: 1.2;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    max-width: 100%;
+    min-width: 0;
+}
+
+/* Ensure the title container doesn't grow beyond available space */
+.responsive-title-container {
+    min-width: 0;
+    flex: 1;
+    max-width: calc(100% - 200px); /* Reserve space for buttons */
+}
+
+/* Responsive button container */
+.responsive-button-container {
+    display: flex;
+    gap: 0.375rem;
+    flex-shrink: 0;
+    flex-wrap: wrap;
+    align-items: center;
+}
+
+/* Responsive button styling */
+.responsive-button-container button {
+    padding: 0.375rem 0.5rem;
+    font-size: 0.875rem;
+    min-width: 2rem;
+    height: 2rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.2s ease;
+}
+
+/* On very narrow screens, make buttons smaller */
+@media (max-width: 640px) {
+    .responsive-title {
+        font-size: clamp(1rem, 4vw, 1.25rem);
+    }
+    
+    .responsive-title-container {
+        max-width: calc(100% - 150px); /* Less space reserved for buttons */
+    }
+    
+    .responsive-button-container {
+        gap: 0.25rem;
+    }
+    
+    .responsive-button-container button {
+        padding: 0.25rem 0.375rem;
+        font-size: 0.75rem;
+        min-width: 1.75rem;
+        height: 1.75rem;
+    }
+    
+    /* Hide button text on very small screens, show only icons */
+    .responsive-button-container button span {
+        display: none;
+    }
+    
+    .responsive-button-container button i {
+        margin: 0;
+    }
+}
+
+/* Header layout improvements for better responsiveness */
+.recording-header {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+    margin-bottom: 1rem;
+    padding-bottom: 1rem;
+    border-bottom: 1px solid var(--border-primary);
+}
+
+.recording-title-row {
+    display: flex;
+    align-items: flex-start;
+    justify-content: space-between;
+    gap: 1rem;
+    min-height: 2.5rem;
+}
+
+.recording-metadata-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 1rem;
+    font-size: 0.875rem;
+}
+
+/* Ensure metadata items stay on same line when possible */
+@media (min-width: 768px) {
+    .recording-metadata-row {
+        flex-wrap: nowrap;
+        gap: 1.5rem;
+    }
+}
+
+/* Toast notifications */
+#toastContainer {
+    position: fixed;
+    bottom: 20px;
+    right: 20px;
+    z-index: 9999;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-end;
+    gap: 12px;
+}
+
+.toast {
+    background: var(--bg-success);
+    color: var(--text-success-strong);
+    padding: 12px 16px;
+    border-radius: 8px;
+    margin-bottom: 8px;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+    border: 1px solid var(--border-success);
+    transform: translateX(100%);
+    opacity: 0;
+    transition: all 0.3s ease-in-out;
+    pointer-events: auto;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    max-width: 300px;
+}
+
+.toast.show {
+    transform: translateX(0);
+    opacity: 1;
+}
+
+.toast i {
+    flex-shrink: 0;
+}
+
+/* Toast message stacking with fly-in animation */
+.toast-message {
+    transition: transform 0.3s ease-in-out, opacity 0.3s ease-in-out;
+    pointer-events: auto;
+    transform: translateX(400px);
+    margin-bottom: 0.5rem;
+    display: block !important;
+    max-width: 450px;
+    word-wrap: break-word;
+    /* All other styles handled by Tailwind classes */
+}
+
+.toast-message.toast-show {
+    transform: translateX(0);
+}
+
+#toastContainer {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-end;
+    max-width: 450px;
+}
+
+/* Discrete horizontal resize divider */
+#mainColumnResizer {
+    width: 12px !important;
+    background-color: transparent !important;
+    cursor: ew-resize !important;
+    margin: 0 -6px !important;
+    position: relative;
+    z-index: 10;
+}
+
+#mainColumnResizer:hover::before {
+    content: '';
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    transform: translate(-50%, -50%);
+    width: 4px;
+    height: 60px;
+    background-color: var(--border-accent);
+    border-radius: 2px;
+    transition: background-color 0.15s ease;
+}
+
+/* Ensure consistent layout behavior when sidebar is collapsed */
+.sidebar-container.lg\:col-span-1 {
+    transition: all 0.3s ease;
+}
+
+/* Smooth transition for main content area when sidebar toggles */
+.main-content-area {
+    transition: all 0.3s ease;
+}
+
+/* Preserve column widths during sidebar transitions */
+.content-column {
+    transition: none !important; /* Disable transitions on content columns to prevent layout shifts */
+}
+
+/* Ensure the grid container adapts smoothly */
+.grid.grid-cols-1.lg\:grid-cols-4.gap-6.flex-grow {
+    transition: all 0.3s ease;
+}
+
+/* Force consistent internal layout regardless of parent grid span */
+.main-content-area #mainContentColumns {
+    width: 100% !important;
+    max-width: none !important;
+    min-width: 0 !important;
+}
+
+/* Ensure left column maintains its set width - respect inline styles */
+.main-content-area #leftMainColumn {
+    flex-shrink: 0 !important;
+    min-width: 0 !important;
+    /* Don't override width - let inline style control it */
+}
+
+/* Ensure right column fills remaining space */
+.main-content-area #rightMainColumn {
+    flex: 1 !important;
+    min-width: 0 !important;
+    width: auto !important;
+}
+
+/* Specific rule to ensure inline width styles are respected */
+#leftMainColumn[style*="width"] {
+    flex-basis: auto !important;
+    flex-grow: 0 !important;
+    flex-shrink: 0 !important;
+}
+
+/* Prevent layout shifts when grid span changes */
+.main-content-area .recording-header,
+.main-content-area .participants-section,
+.main-content-area .transcription-section,
+.main-content-area .tab-section,
+.main-content-area .audio-section,
+.main-content-area .chat-section {
+    width: 100% !important;
+    max-width: none !important;
+}
+
+/* Discrete vertical resize divider */
+.resize-handle {
+    height: 12px !important;
+    background-color: transparent !important;
+    cursor: ns-resize !important;
+    margin: 2px 0 !important;
+    display: flex !important;
+    align-items: center !important;
+    justify-content: center !important;
+    padding: 0 !important;
+    border-radius: 0 !important;
+}
+
+.resize-handle .w-10 {
+    width: 60px !important;
+    height: 4px !important;
+    background-color: var(--text-light) !important;
+    border-radius: 2px !important;
+    transition: background-color 0.15s ease !important;
+}
+
+.resize-handle:hover .w-10 {
+    background-color: var(--border-accent) !important;
+}
+
+/* Color Scheme Modal Styles */
+.color-scheme-modal {
+    position: fixed;
+    inset: 0;
+    background-color: rgba(0, 0, 0, 0.7);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    z-index: 9999;
+    padding: 1rem;
+    backdrop-filter: blur(4px);
+    transition: all 0.3s ease-in-out;
+}
+
+.color-scheme-modal-content {
+    background-color: var(--bg-secondary);
+    border-radius: 1rem;
+    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+    width: 100%;
+    max-width: 42rem;
+    max-height: 90vh;
+    overflow: hidden;
+    transform: scale(1);
+    transition: all 0.3s ease-in-out;
+}
+
+.color-scheme-header {
+    background: linear-gradient(135deg, var(--bg-accent), var(--bg-secondary));
+    padding: 1.5rem;
+    border-bottom: 1px solid var(--border-primary);
+}
+
+.color-scheme-title {
+    font-size: 1.5rem;
+    font-weight: 700;
+    color: var(--text-primary);
+    margin: 0;
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+}
+
+.color-scheme-subtitle {
+    color: var(--text-muted);
+    font-size: 0.875rem;
+    margin-top: 0.5rem;
+    margin-bottom: 0;
+}
+
+.color-scheme-body {
+    padding: 1.5rem;
+    max-height: calc(90vh - 200px);
+    overflow-y: auto;
+}
+
+.color-scheme-section {
+    margin-bottom: 2rem;
+}
+
+.color-scheme-section:last-child {
+    margin-bottom: 0;
+}
+
+.color-scheme-section-title {
+    font-size: 1.125rem;
+    font-weight: 600;
+    color: var(--text-primary);
+    margin-bottom: 1rem;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+
+.color-scheme-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+    gap: 1rem;
+}
+
+.color-scheme-option {
+    border: 2px solid var(--border-primary);
+    border-radius: 0.75rem;
+    padding: 1rem;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    background-color: var(--bg-tertiary);
+    position: relative;
+    overflow: hidden;
+}
+
+.color-scheme-option:hover {
+    border-color: var(--border-accent);
+    transform: translateY(-2px);
+    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.1);
+}
+
+.color-scheme-option.active {
+    border-color: var(--border-focus);
+    background-color: var(--bg-accent);
+    box-shadow: 0 0 0 3px var(--ring-focus);
+}
+
+.color-scheme-preview {
+    height: 60px;
+    border-radius: 0.5rem;
+    margin-bottom: 0.75rem;
+    display: flex;
+    overflow: hidden;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.color-scheme-preview-segment {
+    flex: 1;
+    transition: all 0.2s ease;
+}
+
+.color-scheme-option:hover .color-scheme-preview-segment {
+    transform: scale(1.02);
+}
+
+.color-scheme-name {
+    font-weight: 600;
+    color: var(--text-primary);
+    margin-bottom: 0.25rem;
+    font-size: 0.875rem;
+}
+
+.color-scheme-description {
+    color: var(--text-muted);
+    font-size: 0.75rem;
+    line-height: 1.4;
+}
+
+.color-scheme-check {
+    position: absolute;
+    top: 0.75rem;
+    right: 0.75rem;
+    width: 1.25rem;
+    height: 1.25rem;
+    border-radius: 50%;
+    background-color: var(--bg-button);
+    color: var(--text-button);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 0.75rem;
+    opacity: 0;
+    transform: scale(0.8);
+    transition: all 0.2s ease;
+}
+
+.color-scheme-option.active .color-scheme-check {
+    opacity: 1;
+    transform: scale(1);
+}
+
+.color-scheme-footer {
+    background-color: var(--bg-tertiary);
+    padding: 1rem 1.5rem;
+    border-top: 1px solid var(--border-primary);
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+}
+
+.color-scheme-close-btn {
+    padding: 0.5rem 1rem;
+    background-color: var(--bg-secondary);
+    color: var(--text-secondary);
+    border: 1px solid var(--border-secondary);
+    border-radius: 0.5rem;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    font-size: 0.875rem;
+    font-weight: 500;
+}
+
+.color-scheme-close-btn:hover {
+    background-color: var(--bg-tertiary);
+    color: var(--text-primary);
+}
+
+.color-scheme-reset-btn {
+    padding: 0.5rem 1rem;
+    background-color: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border-secondary);
+    border-radius: 0.5rem;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    font-size: 0.875rem;
+    font-weight: 500;
+}
+
+.color-scheme-reset-btn:hover {
+    background-color: var(--bg-danger-light);
+    color: var(--text-danger);
+    border-color: var(--border-danger);
+}
+
+/* Color scheme preview colors */
+.preview-blue-primary { background-color: #2563eb; }
+.preview-blue-secondary { background-color: #dbeafe; }
+.preview-blue-tertiary { background-color: #93c5fd; }
+
+.preview-emerald-primary { background-color: #059669; }
+.preview-emerald-secondary { background-color: #d1fae5; }
+.preview-emerald-tertiary { background-color: #6ee7b7; }
+
+.preview-purple-primary { background-color: #7c3aed; }
+.preview-purple-secondary { background-color: #e9d5ff; }
+.preview-purple-tertiary { background-color: #c4b5fd; }
+
+.preview-rose-primary { background-color: #e11d48; }
+.preview-rose-secondary { background-color: #fce7f3; }
+.preview-rose-tertiary { background-color: #f9a8d4; }
+
+.preview-amber-primary { background-color: #d97706; }
+.preview-amber-secondary { background-color: #fef3c7; }
+.preview-amber-tertiary { background-color: #fcd34d; }
+
+.preview-teal-primary { background-color: #0d9488; }
+.preview-teal-secondary { background-color: #ccfbf1; }
+.preview-teal-tertiary { background-color: #5eead4; }
+
+/* Dark theme preview colors */
+.preview-dark-blue-primary { background-color: #1e3a8a; }
+.preview-dark-blue-secondary { background-color: #1e40af; }
+.preview-dark-blue-tertiary { background-color: #60a5fa; }
+
+.preview-dark-emerald-primary { background-color: #064e3b; }
+.preview-dark-emerald-secondary { background-color: #065f46; }
+.preview-dark-emerald-tertiary { background-color: #6ee7b7; }
+
+.preview-dark-purple-primary { background-color: #581c87; }
+.preview-dark-purple-secondary { background-color: #6b21a8; }
+.preview-dark-purple-tertiary { background-color: #c4b5fd; }
+
+.preview-dark-rose-primary { background-color: #881337; }
+.preview-dark-rose-secondary { background-color: #9f1239; }
+.preview-dark-rose-tertiary { background-color: #fda4af; }
+
+.preview-dark-amber-primary { background-color: #78350f; }
+.preview-dark-amber-secondary { background-color: #92400e; }
+.preview-dark-amber-tertiary { background-color: #fcd34d; }
+
+.preview-dark-teal-primary { background-color: #134e4a; }
+.preview-dark-teal-secondary { background-color: #115e59; }
+.preview-dark-teal-tertiary { background-color: #5eead4; }
+
+/* Line clamp utility for text truncation */
+.line-clamp-2 {
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+}
+
+/* Responsive adjustments for color scheme modal */
+@media (max-width: 768px) {
+    .color-scheme-modal {
+        padding: 0.5rem;
+    }
+    
+    .color-scheme-modal-content {
+        max-width: 95vw;
+        max-height: 95vh;
+    }
+    
+    .color-scheme-grid {
+        grid-template-columns: 1fr;
+        gap: 0.75rem;
+    }
+    
+    .color-scheme-header {
+        padding: 1rem;
+    }
+    
+    .color-scheme-body {
+        padding: 1rem;
+    }
+    
+    .color-scheme-footer {
+        padding: 1rem;
+        flex-direction: column;
+        gap: 0.75rem;
+    }
+}
+
+/* Enhanced Audio Player Styling for Better Dark Mode Visibility */
+.audio-player-container {
+    background: var(--bg-audio-player);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.75rem;
+    padding: 1rem;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    transition: all 0.3s ease;
+}
+
+.dark .audio-player-container {
+    border: 1px solid var(--border-secondary);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+}
+
+/* Audio player controls styling */
+.audio-player-container audio {
+    width: 100%;
+    height: 40px;
+    background-color: var(--bg-tertiary);
+    border-radius: 0.5rem;
+    border: 1px solid var(--border-primary);
+    outline: none;
+}
+
+.dark .audio-player-container audio {
+    background-color: var(--bg-secondary);
+    border: 1px solid var(--border-secondary);
+}
+
+/* Audio player controls for WebKit browsers */
+.audio-player-container audio::-webkit-media-controls-panel {
+    background-color: var(--bg-tertiary);
+    border-radius: 0.5rem;
+}
+
+.dark .audio-player-container audio::-webkit-media-controls-panel {
+    background-color: var(--bg-secondary);
+}
+
+.audio-player-container audio::-webkit-media-controls-enclosure {
+    border: none;
+    background: none;
+}
+
+.audio-player-container audio::-webkit-media-controls-play-button,
+.audio-player-container audio::-webkit-media-controls-pause-button {
+    background-color: var(--bg-button);
+    border-radius: 50%;
+    margin: 0 0.25rem;
+}
+
+.dark .audio-player-container audio::-webkit-media-controls-play-button,
+.dark .audio-player-container audio::-webkit-media-controls-pause-button {
+}
+
+.audio-player-container audio::-webkit-media-controls-timeline {
+    background-color: var(--border-primary);
+    border-radius: 0.25rem;
+    margin: 0 0.5rem;
+}
+
+.dark .audio-player-container audio::-webkit-media-controls-timeline {
+    background-color: var(--border-secondary);
+}
+
+.audio-player-container audio::-webkit-media-controls-current-time-display,
+.audio-player-container audio::-webkit-media-controls-time-remaining-display {
+    color: var(--text-secondary);
+    font-size: 0.75rem;
+}
+
+.dark .audio-player-container audio::-webkit-media-controls-current-time-display,
+.dark .audio-player-container audio::-webkit-media-controls-time-remaining-display {
+    color: var(--text-primary);
+}
+
+/* Audio player volume controls */
+.audio-player-container audio::-webkit-media-controls-volume-slider {
+    background-color: var(--border-primary);
+    border-radius: 0.25rem;
+}
+
+.dark .audio-player-container audio::-webkit-media-controls-volume-slider {
+    background-color: var(--border-secondary);
+}
+
+.audio-player-container audio::-webkit-media-controls-mute-button {
+    background-color: transparent;
+}
+
+/* Dark mode: use browser's native dark theme for audio controls */
+.dark audio {
+    color-scheme: dark;
+}
+
+/* Custom volume slider styling - accent colored */
+.volume-slider {
+    -webkit-appearance: none;
+    appearance: none;
+    background: transparent;
+    cursor: pointer;
+    height: 6px;
+}
+
+.volume-slider::-webkit-slider-runnable-track {
+    background: var(--border-accent);
+    opacity: 0.5;
+    height: 6px;
+    border-radius: 3px;
+}
+
+.dark .volume-slider::-webkit-slider-runnable-track {
+    background: var(--border-accent);
+    opacity: 0.6;
+}
+
+.volume-slider::-webkit-slider-thumb {
+    -webkit-appearance: none;
+    appearance: none;
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    background: var(--text-accent);
+    margin-top: -3px;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+    cursor: pointer;
+    transition: transform 0.15s ease;
+}
+
+.volume-slider::-moz-range-track {
+    background: var(--border-accent);
+    opacity: 0.5;
+    height: 6px;
+    border-radius: 3px;
+}
+
+.dark .volume-slider::-moz-range-track {
+    background: var(--border-accent);
+    opacity: 0.6;
+}
+
+.volume-slider::-moz-range-thumb {
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    background: var(--text-accent);
+    border: none;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+    cursor: pointer;
+    transition: transform 0.15s ease;
+}
+
+.volume-slider:hover::-webkit-slider-thumb {
+    transform: scale(1.2);
+    box-shadow: 0 2px 5px rgba(0, 0, 0, 0.4);
+}
+
+.volume-slider:hover::-moz-range-thumb {
+    transform: scale(1.2);
+    box-shadow: 0 2px 5px rgba(0, 0, 0, 0.4);
+}
+
+/* Vertical volume slider (popup) */
+.volume-slider-vertical {
+    -webkit-appearance: none;
+    appearance: none;
+    background: transparent;
+    cursor: pointer;
+    writing-mode: vertical-lr;
+    direction: rtl;
+    width: 20px;
+}
+
+.volume-slider-vertical::-webkit-slider-runnable-track {
+    background: var(--border-accent);
+    opacity: 0.5;
+    width: 6px;
+    border-radius: 3px;
+}
+
+.dark .volume-slider-vertical::-webkit-slider-runnable-track {
+    background: var(--border-accent);
+    opacity: 0.6;
+}
+
+.volume-slider-vertical::-webkit-slider-thumb {
+    -webkit-appearance: none;
+    appearance: none;
+    width: 14px;
+    height: 14px;
+    border-radius: 50%;
+    background: var(--text-accent);
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+    cursor: pointer;
+}
+
+.volume-slider-vertical::-moz-range-track {
+    background: var(--border-accent);
+    opacity: 0.5;
+    width: 6px;
+    border-radius: 3px;
+}
+
+.dark .volume-slider-vertical::-moz-range-track {
+    background: var(--border-accent);
+    opacity: 0.6;
+}
+
+.volume-slider-vertical::-moz-range-thumb {
+    width: 14px;
+    height: 14px;
+    border-radius: 50%;
+    background: var(--text-accent);
+    border: none;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+    cursor: pointer;
+}
+
+/* Player play button - accent colored with proper contrast */
+.player-play-button {
+    background-color: var(--text-accent);
+    color: white;
+}
+
+.player-play-button:hover {
+    filter: brightness(1.1);
+}
+
+.dark .player-play-button {
+    background-color: var(--text-accent);
+    color: var(--bg-primary);
+}
+
+.dark .player-play-button:hover {
+    filter: brightness(1.15);
+}
+
+/* Playback Speed Control Dropdown */
+.speed-dropdown {
+    animation: speedDropdownFade 0.12s ease-out;
+    width: 52px;
+}
+
+@keyframes speedDropdownFade {
+    from {
+        opacity: 0;
+        transform: scale(0.95);
+    }
+    to {
+        opacity: 1;
+        transform: scale(1);
+    }
+}
+
+/* Custom audio player wrapper for better control */
+.custom-audio-wrapper {
+    position: relative;
+    background: var(--bg-audio-player);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.75rem;
+    padding: 1rem;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.dark .custom-audio-wrapper {
+    border: 1px solid var(--border-secondary);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+    background: var(--bg-audio-player);
+}
+
+/* Audio player title/metadata styling */
+.audio-player-title {
+    color: var(--text-secondary);
+    font-size: 0.875rem;
+    font-weight: 500;
+    margin-bottom: 0.5rem;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+
+.dark .audio-player-title {
+    color: var(--text-primary);
+}
+
+.audio-player-icon {
+    color: var(--text-accent);
+    font-size: 1rem;
+}
+
+/* Audio player duration/time display */
+.audio-player-time {
+    color: var(--text-muted);
+    font-size: 0.75rem;
+    margin-top: 0.5rem;
+    text-align: center;
+}
+
+.dark .audio-player-time {
+    color: var(--text-secondary);
+}
+
+/* ASR Editor Table Styles */
+.asr-editor-table {
+    width: 100%;
+    border-collapse: collapse; /* Changed to collapse */
+}
+
+.asr-editor-table th {
+    padding: 0.75rem 1rem;
+    text-align: left;
+    font-size: 0.75rem;
+    font-weight: 600;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    border-bottom: 2px solid var(--border-primary);
+}
+
+.asr-editor-table td {
+    padding: 0; /* No padding - let inputs fill the cell */
+    vertical-align: middle;
+    border: 1px solid var(--border-secondary);
+}
+
+/* More visible borders in dark mode */
+.dark .asr-editor-table,
+.dark .asr-editor-table th,
+.dark .asr-editor-table td {
+    border-color: rgba(148, 163, 184, 0.3); /* slate-400 with opacity for visibility */
+}
+
+/* ASR Editor inputs - blend into table cells */
+.asr-editor-table input,
+.asr-editor-table textarea {
+    border-radius: 0 !important; /* Override global rounded corners */
+    margin: 0;
+    display: block;
+    min-height: 100%;
+}
+
+.asr-editor-table textarea {
+    vertical-align: top;
+    min-height: 2.5rem; /* Minimum height for single line */
+    line-height: 1.5;
+}
+
+/* Sticky header for ASR editor table */
+.asr-editor-table thead {
+    position: sticky;
+    top: 0;
+    z-index: 10;
+}
+
+.asr-editor-table thead th {
+    background-color: var(--bg-tertiary);
+    border-collapse: collapse;
+}
+
+/* Custom Number Input with Subtle Spinners */
+.custom-number-input {
+    position: relative;
+}
+
+.custom-number-input input[type="number"] {
+    -moz-appearance: textfield;
+    padding-right: 1.75rem; /* Space for spinners */
+}
+
+.custom-number-input input[type="number"]::-webkit-inner-spin-button,
+.custom-number-input input[type="number"]::-webkit-outer-spin-button {
+    -webkit-appearance: none;
+    margin: 0;
+}
+
+.number-spinners {
+    position: absolute;
+    right: 0;
+    top: 0;
+    bottom: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    width: 1.75rem;
+    opacity: 0;
+    transition: opacity 0.2s ease;
+}
+
+.custom-number-input:hover .number-spinners {
+    opacity: 1;
+}
+
+.number-spinners button {
+    height: 50%;
+    width: 100%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--text-muted);
+    background-color: transparent;
+    border: none;
+    cursor: pointer;
+    padding: 0;
+}
+
+.number-spinners button:hover {
+    color: var(--text-primary);
+}
+
+.number-spinners button svg {
+    width: 0.75rem;
+    height: 0.75rem;
+}
+
+/* Speaker Combobox Styles */
+.speaker-combobox {
+    position: relative;
+}
+
+.speaker-combobox-input {
+    width: 100%;
+    padding-right: 2rem; /* Space for dropdown arrow */
+}
+
+.speaker-combobox-arrow {
+    position: absolute;
+    right: 0;
+    top: 0;
+    bottom: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 2rem;
+    color: var(--text-muted);
+    pointer-events: none;
+}
+
+.speaker-combobox-suggestions {
+    position: absolute;
+    z-index: 10;
+    width: 100%;
+    margin-top: 0.25rem;
+    background-color: var(--bg-secondary);
+    border: 1px solid var(--border-primary);
+    border-radius: 0.5rem;
+    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+    max-height: 12rem;
+    overflow-y: auto;
+}
+
+.speaker-suggestion-item {
+    padding: 0.5rem 0.75rem;
+    cursor: pointer;
+    font-size: 0.875rem;
+}
+
+.speaker-suggestion-item:hover {
+    background-color: var(--bg-accent);
+}
+
+/* Markdown Editor Styles */
+.markdown-editor-container {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-height: 0;
+}
+
+.markdown-editor-container .EasyMDEContainer {
+    background: var(--bg-input);
+    border: none;
+    border-radius: 0.75rem;
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+}
+
+.markdown-editor-container .EasyMDEContainer .CodeMirror {
+    background: var(--bg-input);
+    color: var(--text-primary);
+    border: none;
+    border-radius: 0 0 0.75rem 0.75rem;
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+    font-size: 0.875rem;
+    line-height: 1.5;
+    flex: 1;
+    min-height: 0;
+    overflow: hidden !important;
+}
+
+/* Fix double scrolling by ensuring only the wrapper scrolls */
+.markdown-editor-container .EasyMDEContainer .CodeMirror-scroll {
+    overflow: auto !important;
+    height: 100% !important;
+}
+
+.markdown-editor-container .EasyMDEContainer .CodeMirror-sizer {
+    min-height: 100% !important;
+}
+
+.markdown-editor-container .EasyMDEContainer .CodeMirror-focused {
+    outline: none;
+    box-shadow: 0 0 0 2px var(--ring-focus);
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-toolbar {
+    background: var(--bg-tertiary);
+    border-bottom: 1px solid var(--border-secondary);
+    border-radius: 0.75rem 0.75rem 0 0;
+    padding: 0.5rem;
+    flex-shrink: 0;
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-toolbar button {
+    background: transparent;
+    border: 1px solid transparent;
+    color: var(--text-secondary);
+    border-radius: 0.25rem;
+    padding: 0.25rem;
+    margin: 0 0.125rem;
+    transition: all 0.2s ease;
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-toolbar button:hover {
+    background: var(--bg-accent);
+    color: var(--text-accent);
+    border-color: var(--border-accent);
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-toolbar button.active {
+    background: var(--bg-accent);
+    color: var(--text-accent);
+    border-color: var(--border-accent);
+}
+
+/* EasyMDE Fullscreen Mode Fixes */
+.EasyMDEContainer .editor-fullscreen {
+    z-index: 9999 !important;
+    /* Add top padding to ensure toolbar is visible below the app header */
+    padding-top: 0 !important; /* Reset padding - we'll handle this in the CodeMirror element */
+}
+
+/* Force hide speaker legend during any fullscreen mode - comprehensive approach */
+.editor-fullscreen .speaker-legend,
+.CodeMirror-fullscreen .speaker-legend,
+body:has(.editor-fullscreen) .speaker-legend,
+body:has(.CodeMirror-fullscreen) .speaker-legend {
+    display: none !important;
+}
+
+/* Alternative: Lower z-index approach for speaker legend during fullscreen */
+.editor-fullscreen ~ .speaker-legend,
+.CodeMirror-fullscreen ~ .speaker-legend,
+.editor-fullscreen + .speaker-legend,
+.CodeMirror-fullscreen + .speaker-legend {
+    z-index: -1 !important;
+}
+
+/* Target the specific fullscreen container that EasyMDE creates */
+.CodeMirror-fullscreen-wrapper {
+    z-index: 9999 !important;
+}
+
+/* Ensure fullscreen editor is above everything */
+.CodeMirror-fullscreen {
+    z-index: 99998 !important; /* Just below the toolbar */
+    /* Add top padding to ensure content starts below the toolbar */
+    padding-top: 20px !important; /* Increased padding to match toolbar height */
+    margin-top: 0 !important; /* Remove any margin */
+    box-sizing: border-box !important; /* Ensure padding is included in height */
+}
+
+/* Ensure the editor toolbar is visible in fullscreen mode */
+.editor-toolbar.fullscreen {
+    position: fixed !important;
+    top: 0 !important; /* Position at the very top of the screen */
+    z-index: 99999 !important; /* Extremely high z-index to be above everything */
+    background-color: var(--bg-tertiary) !important;
+    border-bottom: 1px solid var(--border-secondary) !important;
+    width: 100% !important; /* Full width */
+    padding: 5px !important; /* Reduced padding */
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1) !important; /* Add shadow for better visibility */
+    height: 60px !important; /* Further increased height to ensure buttons are fully visible */
+    display: flex !important;
+    align-items: center !important;
+    justify-content: flex-start !important;
+    box-sizing: border-box !important; /* Ensure padding is included in height */
+}
+
+/* Ensure the editor preview is properly positioned in fullscreen mode */
+.editor-preview-side.editor-preview-active-side {
+    top: 60px !important; /* Match the padding-top of the editor */
+    padding-top: 0 !important; /* Remove default padding */
+    background-color: var(--bg-input) !important; /* Match editor background */
+    margin-top: 0 !important; /* Remove any margin */
+    z-index: 99997 !important; /* Below the editor but above other elements */
+}
+
+/* Ensure the editor preview in split-screen mode is properly positioned */
+.CodeMirror-sided.CodeMirror-fullscreen {
+    padding-top: 20px !important; /* Match the padding of regular fullscreen mode */
+    width: 50% !important; /* Ensure editor takes exactly half the width */
+    background-color: var(--bg-input) !important; /* Match editor background */
+    margin-top: 0 !important; /* Remove any margin */
+    box-sizing: border-box !important; /* Ensure padding is included in height */
+}
+
+/* Fix the split-screen preview to match the editor */
+.editor-preview-active-side.editor-preview-side {
+    top: 60px !important; /* Match the editor padding */
+    padding-top: 0 !important; /* Remove default padding */
+    margin-top: 0 !important; /* Remove any margin */
+    height: calc(100% - 60px) !important; /* Adjust height to account for top position */
+    border-top: none !important; /* Remove top border */
+    background-color: var(--bg-input) !important; /* Match editor background */
+    z-index: 99997 !important; /* Below the editor but above other elements */
+    box-sizing: border-box !important; /* Ensure padding is included in height */
+}
+
+/* Hide speaker legend when any fullscreen editor is active */
+body.CodeMirror-fullscreen .speaker-legend,
+.CodeMirror-fullscreen .speaker-legend {
+    display: none !important;
+}
+
+/* Ensure the save/cancel buttons are visible in fullscreen mode */
+.markdown-editor-container .flex.justify-end.gap-2.mt-2 {
+    position: fixed !important;
+    bottom: 20px !important;
+    right: 20px !important;
+    z-index: 100000 !important; /* Above everything else */
+    background-color: var(--bg-secondary) !important;
+    padding: 10px !important;
+    border-radius: 8px !important;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15) !important;
+    border: 1px solid var(--border-primary) !important;
+}
+
+/* Additional fixes for fullscreen mode */
+body.fullscreen-mode {
+    overflow: hidden !important; /* Prevent scrolling when in fullscreen mode */
+}
+
+/* Ensure the editor container is properly positioned in fullscreen mode */
+.CodeMirror-fullscreen-wrapper {
+    z-index: 99998 !important; /* Below the toolbar but above other elements */
+}
+
+/* Ensure the editor is properly positioned in fullscreen mode */
+.CodeMirror-fullscreen .CodeMirror-scroll {
+    padding-top: 0 !important; /* Remove default padding */
+    margin-top: 0 !important; /* Remove any margin */
+}
+
+/* Additional fixes for toolbar buttons to ensure they're fully visible */
+.editor-toolbar.fullscreen button {
+    display: inline-flex !important;
+    align-items: center !important;
+    justify-content: center !important;
+    height: 40px !important; /* Increased height for better visibility */
+    width: 40px !important; /* Increased width for better visibility */
+    margin: 0 3px !important; /* Increased margin for better spacing */
+    padding: 0 !important;
+    font-size: 18px !important; /* Increased font size for better visibility */
+    line-height: 1 !important;
+    background-color: var(--bg-secondary) !important; /* Add background color for better visibility */
+    border: 1px solid var(--border-secondary) !important; /* Add border for better visibility */
+    border-radius: 4px !important; /* Add border radius for better visibility */
+}
+
+/* Add hover state for toolbar buttons */
+.editor-toolbar.fullscreen button:hover {
+    background-color: var(--bg-accent) !important;
+    color: var(--text-accent) !important;
+    transform: translateY(-1px) !important;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1) !important;
+}
+
+/* Add active state for toolbar buttons */
+.editor-toolbar.fullscreen button.active {
+    background-color: var(--bg-accent) !important;
+    color: var(--text-accent) !important;
+    border-color: var(--border-accent) !important;
+}
+
+/* Ensure the editor toolbar wrapper is properly positioned */
+.editor-toolbar-wrapper {
+    position: fixed !important;
+    top: 0 !important;
+    left: 0 !important;
+    right: 0 !important;
+    z-index: 99999 !important;
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-preview {
+    background: var(--bg-input);
+    color: var(--text-primary);
+    padding: 1rem;
+    border-radius: 0 0 0.5rem 0.5rem;
+}
+
+.markdown-editor-container .EasyMDEContainer .editor-preview-side {
+    background: var(--bg-input);
+    color: var(--text-primary);
+    border-left: 1px solid var(--border-secondary);
+    padding-top: 0 !important; /* Remove default padding */
+    box-sizing: border-box !important; /* Ensure padding is included in height */
+}
+
+/* Dark mode adjustments for markdown editor */
+.dark .markdown-editor-container .EasyMDEContainer .CodeMirror {
+    background: var(--bg-input);
+    color: var(--text-primary);
+}
+
+/* Fix cursor/caret color in dark mode for ALL CodeMirror instances */
+.dark .CodeMirror-cursor {
+    border-left: 2px solid var(--text-primary) !important;
+}
+
+/* Also fix the caret in the actual textarea (when CodeMirror is not active) */
+.dark textarea,
+.dark input[type="text"],
+.dark input[type="search"] {
+    caret-color: var(--text-primary);
+}
+
+/* Ensure cursor is visible in all markdown editors */
+.markdown-editor-container .CodeMirror-cursor,
+.recording-notes-editor .CodeMirror-cursor {
+    border-left: 2px solid var(--text-primary) !important;
+}
+
+.dark .markdown-editor-container .EasyMDEContainer .editor-toolbar {
+    background: var(--bg-tertiary);
+    border-bottom-color: var(--border-secondary);
+}
+
+.dark .markdown-editor-container .EasyMDEContainer .editor-toolbar button {
+    color: var(--text-secondary);
+}
+
+.dark .markdown-editor-container .EasyMDEContainer .editor-toolbar button:hover,
+.dark .markdown-editor-container .EasyMDEContainer .editor-toolbar button.active {
+    background: var(--bg-accent);
+    color: var(--text-accent);
+    border-color: var(--border-accent);
+}
+
+/* Markdown preview styling in notes */
+.notes-preview h1, .notes-preview h2, .notes-preview h3,
+.notes-preview h4, .notes-preview h5, .notes-preview h6 {
+    font-weight: 600;
+    margin-top: 1rem;
+    margin-bottom: 0.5rem;
+    color: var(--text-primary);
+}
+
+.notes-preview h1 { font-size: 1.5rem; }
+.notes-preview h2 { font-size: 1.25rem; }
+.notes-preview h3 { font-size: 1.125rem; }
+
+.notes-preview p {
+    margin-bottom: 0.75rem;
+    line-height: 1.6;
+}
+
+.notes-preview ul, .notes-preview ol {
+    margin-left: 1.5rem;
+    margin-bottom: 0.75rem;
+}
+
+.notes-preview li {
+    margin-bottom: 0.25rem;
+}
+
+.notes-preview code {
+    background-color: var(--bg-tertiary);
+    padding: 0.125rem 0.25rem;
+    border-radius: 0.25rem;
+    font-family: ui-monospace, SFMono-Regular, "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
+    font-size: 0.875rem;
+}
+
+.notes-preview pre {
+    background-color: var(--bg-tertiary);
+    padding: 0.75rem;
+    border-radius: 0.5rem;
+    overflow-x: auto;
+    margin-bottom: 0.75rem;
+}
+
+.notes-preview pre code {
+    background-color: transparent;
+    padding: 0;
+}
+
+.notes-preview blockquote {
+    border-left: 4px solid var(--border-accent);
+    padding-left: 1rem;
+    margin-left: 0;
+    margin-bottom: 0.75rem;
+    color: var(--text-muted);
+    font-style: italic;
+}
+
+.notes-preview table {
+    border-collapse: collapse;
+    width: 100%;
+    margin-bottom: 0.75rem;
+}
+
+.notes-preview th, .notes-preview td {
+    border: 1px solid var(--border-secondary);
+    padding: 0.5rem;
+    text-align: left;
+}
+
+.notes-preview th {
+    background-color: var(--bg-tertiary);
+    font-weight: 600;
+}
+
+/* Recording notes editor styles */
+.recording-notes-editor .EasyMDEContainer {
+    height: 100%;
+    display: flex;
+    flex-direction: column;
+    border: 1px solid var(--border-secondary);
+    border-radius: 0.5rem;
+    overflow: hidden;
+}
+
+.summary-editor-container {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-height: 0;
+}
+
+.recording-notes-editor .CodeMirror,
+.recording-notes-editor .editor-preview,
+.recording-notes-editor .editor-preview-side {
+    flex-grow: 1;
+    background: var(--bg-input);
+    color: var(--text-primary);
+}
+
+.recording-notes-editor .editor-toolbar {
+    background: var(--bg-tertiary);
+    border-bottom: 1px solid var(--border-secondary);
+}
+
+.recording-notes-editor .editor-toolbar button {
+    color: var(--text-secondary);
+    border: none;
+}
+
+.recording-notes-editor .editor-toolbar button:hover,
+.recording-notes-editor .editor-toolbar button.active {
+    background: var(--bg-accent);
+    color: var(--text-accent);
+    border: none;
+}
+
+.recording-notes-editor .CodeMirror-cursor {
+    border-left: 1px solid var(--text-primary);
+}
+
+/* Recording notes editor base */
+.recording-notes-editor {
+    display: flex !important;
+    flex-direction: column !important;
+    min-height: 150px !important;
+    overflow: hidden !important;
+}
+
+/* During active recording: fill available space */
+.recording-notes-editor.recording-active {
+    flex: 1 !important;
+    min-height: 0 !important;
+    max-height: none !important;
+}
+
+/* Notes editor inside accordion — fill expanded section */
+.recording-notes-editor.accordion-expanded {
+    flex: 1 !important;
+    min-height: 0 !important;
+    max-height: none !important;
+}
+
+.recording-notes-editor .EasyMDEContainer {
+    height: 100% !important; /* Fill parent container */
+    display: flex !important;
+    flex-direction: column !important;
+    overflow: hidden !important;
+}
+
+.recording-notes-editor .EasyMDEContainer .CodeMirror {
+    flex: 1 !important; /* Take all available space */
+    height: auto !important; /* Let flex control height */
+    min-height: 0 !important; /* Allow flex shrinking */
+    overflow: hidden !important; /* Prevent CodeMirror from growing */
+}
+
+.recording-notes-editor .EasyMDEContainer .CodeMirror-scroll {
+    height: 100% !important; /* Fill CodeMirror container */
+    overflow-y: auto !important; /* Enable internal scrolling */
+    min-height: 0 !important; /* Allow flex shrinking */
+}
+
+.recording-notes-editor .EasyMDEContainer .CodeMirror-sizer {
+    min-height: auto !important; /* Don't force content to fill editor */
+}
+
+/* Recording notes textarea fallback - constrained height with internal scrolling */
+.recording-notes-editor textarea {
+    background-color: var(--bg-input) !important;
+    color: var(--text-primary) !important;
+    border-color: var(--border-secondary) !important;
+    flex: 1 !important; /* Fill editor container */
+    height: auto !important; /* Let flex control height */
+    min-height: 0 !important; /* Allow flex shrinking within capped parent */
+    overflow-y: auto !important; /* Enable internal scrolling */
+    resize: none !important; /* Prevent manual resizing */
+}
+
+.recording-notes-editor textarea:focus {
+    background-color: var(--bg-input) !important;
+    border-color: var(--border-focus) !important;
+    box-shadow: 0 0 0 2px var(--ring-focus) !important;
+}
+
+/* Ensure all textareas in recording view use theme colors and constrained height */
+.recording-notes-editor textarea,
+textarea[ref="recordingNotesEditor"] {
+    background-color: var(--bg-input) !important;
+    color: var(--text-primary) !important;
+    border: 1px solid var(--border-secondary) !important;
+    flex: 1 !important; /* Fill editor container */
+    height: auto !important; /* Let flex control height */
+    min-height: 0 !important; /* Allow flex shrinking within capped parent */
+    overflow-y: auto !important; /* Enable internal scrolling */
+    resize: none !important; /* Prevent manual resizing */
+}
+
+/* Dark mode specific adjustments for recording notes */
+.dark .recording-notes-editor textarea,
+.dark textarea[ref="recordingNotesEditor"] {
+    background-color: var(--bg-input) !important;
+    color: var(--text-primary) !important;
+    border-color: var(--border-secondary) !important;
+}
+
+/* Focus states for recording notes textarea */
+.recording-notes-editor textarea:focus,
+textarea[ref="recordingNotesEditor"]:focus {
+    outline: none !important;
+    border-color: var(--border-focus) !important;
+    box-shadow: 0 0 0 2px var(--ring-focus) !important;
+}
+
+.mobile-view {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: hidden;
+}
+
+.mobile-header {
+    flex-shrink: 0;
+}
+
+.mobile-audio-player {
+    flex-shrink: 0;
+}
+
+.mobile-tabs {
+    flex-shrink: 0;
+    overflow-x: auto;
+}
+
+.mobile-content {
+    flex-grow: 1;
+    overflow-y: auto;
+}
+
+/* --- New Sidebar & Main Content Layout --- */
+
+/* Sidebar Container */
+.sidebar {
+    position: fixed; /* Changed to fixed to overlay correctly */
+    top: 69px; /* Height of the header */
+    left: 0;
+    bottom: 0;
+    width: 320px; /* w-80 */
+    background-color: var(--bg-secondary);
+    border-right: 1px solid var(--border-primary);
+    z-index: 50; /* Higher z-index to be above backdrop */
+    transform: translateX(0);
+    transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    display: flex;
+    flex-direction: column;
+}
+
+.sidebar.collapsed {
+    transform: translateX(-100%);
+}
+
+/* Wrapper to prevent sidebar's own content from squishing */
+.sidebar-content-wrapper {
+    width: 320px; /* Fixed width */
+    height: 100%;
+    overflow-y: auto;
+    display: flex;
+    flex-direction: column;
+}
+
+/* Main Content Area */
+.main-content {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    transition: padding-left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    padding-left: 320px; /* Default space for the sidebar */
+}
+
+.main-content.sidebar-open {
+    padding-left: 320px;
+}
+
+/* When sidebar is collapsed, main content takes full width */
+.main-content:not(.sidebar-open) {
+    padding-left: 0;
+}
+
+/* --- Responsive Styles --- */
+@media (max-width: 1023px) {
+    /* On mobile, main content always takes full width */
+    .main-content {
+        padding-left: 0 !important;
+    }
+
+    /* Sidebar is an overlay on mobile */
+    .sidebar {
+        top: 0; /* Cover full height on mobile */
+        z-index: 60; /* Higher z-index for mobile overlay */
+    }
+    
+    /* Make buttons smaller in mobile view */
+    .mobile-action-btn,
+    .p-2.rounded-lg {
+        padding: 0.375rem !important;
+        min-width: 1.5rem !important;
+        height: 1.5rem !important;
+        font-size: 0.75rem !important;
+    }
+    
+    /* Ensure icons are properly sized */
+    .mobile-action-btn i,
+    .p-2.rounded-lg i {
+        font-size: 0.875rem !important;
+    }
+}
+
+/* --- Tab Navigation Responsive Styles --- */
+@media (max-width: 640px) {
+    /* Mobile tab navigation */
+    nav.tab-nav {
+        display: flex !important;
+        flex-direction: column !important;
+        gap: 0 !important;
+        border-bottom: none !important;
+        margin-bottom: 0 !important;
+        space: 0 !important;
+    }
+    
+    nav.tab-nav a,
+    nav.tab-nav button {
+        width: 100% !important;
+        text-align: left !important;
+        border-bottom: 1px solid var(--border-primary) !important;
+        border-left: 3px solid transparent !important;
+        border-right: none !important;
+        border-top: none !important;
+        padding: 0.75rem 1rem !important;
+        margin-bottom: 0 !important;
+        margin-left: 0 !important;
+        margin-right: 0 !important;
+        display: flex !important;
+        align-items: center !important;
+        white-space: nowrap !important;
+    }
+    
+    nav.tab-nav a.border-\\[var\\(--border-accent\\)\\],
+    nav.tab-nav button:has(.border-\\[var\\(--border-focus\\)\\]) {
+        border-left: 3px solid var(--border-accent) !important;
+        background-color: var(--bg-tertiary) !important;
+    }
+    
+    /* Fix spacing between elements */
+    .tab-nav > * + * {
+        margin-left: 0 !important;
+    }
+}
+
+/* Custom Checkbox Styling for Speaker Modal */
+input[type="checkbox"].speaker-checkbox {
+    -webkit-appearance: none;
+    -moz-appearance: none;
+    appearance: none;
+    width: 1.125rem;
+    height: 1.125rem;
+    border: 2px solid var(--border-secondary);
+    border-radius: 0.25rem;
+    background-color: var(--bg-input);
+    cursor: pointer;
+    position: relative;
+    transition: all 0.15s ease;
+    flex-shrink: 0;
+}
+
+input[type="checkbox"].speaker-checkbox:hover {
+    border-color: var(--text-accent);
+    background-color: var(--bg-secondary);
+}
+
+input[type="checkbox"].speaker-checkbox:focus {
+    outline: none;
+    border-color: var(--text-accent);
+    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+}
+
+input[type="checkbox"].speaker-checkbox:checked {
+    background-color: var(--text-accent);
+    border-color: var(--text-accent);
+}
+
+input[type="checkbox"].speaker-checkbox:checked::after {
+    content: '';
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    width: 0.25rem;
+    height: 0.5rem;
+    border: solid white;
+    border-width: 0 2px 2px 0;
+    transform: translate(-50%, -60%) rotate(45deg);
+}
+
+input[type="checkbox"].speaker-checkbox:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+/* Dark mode adjustments */
+:root[data-theme="dark"] input[type="checkbox"].speaker-checkbox {
+    border-color: rgba(255, 255, 255, 0.2);
+    background-color: rgba(255, 255, 255, 0.05);
+}
+
+:root[data-theme="dark"] input[type="checkbox"].speaker-checkbox:hover {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
+:root[data-theme="dark"] input[type="checkbox"].speaker-checkbox:checked {
+    background-color: var(--text-accent);
+    border-color: var(--text-accent);
+}
+
+/* Custom Select Dropdown Styling */
+select {
+    appearance: none;
+    -webkit-appearance: none;
+    -moz-appearance: none;
+    background-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 16 16'%3E%3Cpath fill='%236b7280' d='M4.5 5.5L8 9l3.5-3.5L10.75 4.75 8 7.5 5.25 4.75z'/%3E%3C/svg%3E");
+    background-repeat: no-repeat;
+    background-position: right 0.5rem center;
+    background-size: 1em 1em;
+    padding-right: 2rem;
+    cursor: pointer;
+    transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, background-color 0.15s ease-in-out;
+}
+
+/* Dark mode select styling */
+.dark select {
+    background-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 16 16'%3E%3Cpath fill='%23cbd5e1' d='M4.5 5.5L8 9l3.5-3.5L10.75 4.75 8 7.5 5.25 4.75z'/%3E%3C/svg%3E");
+    background-color: var(--bg-input);
+    border-color: var(--border-secondary);
+}
+
+/* Hover and focus states for select */
+select:hover {
+    border-color: var(--border-accent);
+}
+
+select:focus {
+    outline: none;
+    border-color: var(--border-focus);
+    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+}
+
+.dark select:focus {
+    box-shadow: 0 0 0 3px rgba(96, 165, 250, 0.1);
+}
+
+/* Disabled select styling */
+select:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+    background-color: var(--bg-tertiary);
+}
+
+/* Input and textarea improvements for dark mode */
+.dark input[type="text"],
+.dark input[type="email"],
+.dark input[type="password"],
+.dark input[type="date"],
+.dark input[type="number"],
+.dark textarea {
+    background-color: var(--bg-input);
+    border-color: var(--border-secondary);
+    color: var(--text-primary);
+}
+
+.dark input[type="text"]:focus,
+.dark input[type="email"]:focus,
+.dark input[type="password"]:focus,
+.dark input[type="date"]:focus,
+.dark input[type="number"]:focus,
+.dark textarea:focus {
+    border-color: var(--border-focus);
+    box-shadow: 0 0 0 3px rgba(96, 165, 250, 0.1);
+}
+
+/* Placeholder text improvements */
+.dark input::placeholder,
+.dark textarea::placeholder {
+    color: var(--text-light);
+    opacity: 0.7;
+}
+
+/* Description text improvements */
+.dark .text-xs.text-gray-500,
+.dark .text-xs.text-gray-400,
+.dark .text-sm.text-gray-500,
+.dark .text-sm.text-gray-400 {
+    color: var(--text-muted) !important;
+}
+
+/* Label text improvements */
+.dark label {
+    color: var(--text-secondary);
+}
+
+/* ===== Video Fullscreen Overlay ===== */
+.video-fullscreen-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: 9999;
+    background: #000;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: none;
+}
+.video-fullscreen-overlay:has(.video-fullscreen-controls.visible) {
+    cursor: default;
+}
+.video-fullscreen-video {
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+    cursor: inherit;
+}
+.video-fullscreen-subtitle {
+    position: absolute;
+    bottom: 80px;
+    left: 50%;
+    transform: translateX(-50%);
+    max-width: 80%;
+    max-height: 30vh;
+    overflow-y: auto;
+    text-align: center;
+    padding: 8px 16px;
+    background: rgba(0, 0, 0, 0.75);
+    border-radius: 8px;
+    color: #fff;
+    font-size: 1.25rem;
+    line-height: 1.6;
+    pointer-events: auto;
+    transition: bottom 0.3s ease;
+    overscroll-behavior: contain;
+}
+.video-fullscreen-subtitle.subtitle-shifted {
+    bottom: 100px;
+}
+.video-fullscreen-subtitle-speaker {
+    font-weight: 600;
+    margin-right: 6px;
+}
+.video-fullscreen-controls {
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    background: linear-gradient(transparent, rgba(0, 0, 0, 0.8));
+    padding-top: 40px;
+    opacity: 0;
+    transform: translateY(10px);
+    transition: opacity 0.3s, transform 0.3s;
+    pointer-events: none;
+}
+.video-fullscreen-controls.visible {
+    opacity: 1;
+    transform: translateY(0);
+    pointer-events: auto;
+}
+
+/* Fullscreen volume slider - white themed */
+.fullscreen-volume-slider {
+    -webkit-appearance: none;
+    appearance: none;
+    height: 4px;
+    background: rgba(255, 255, 255, 0.3);
+    border-radius: 2px;
+    outline: none;
+    cursor: pointer;
+}
+.fullscreen-volume-slider::-webkit-slider-thumb {
+    -webkit-appearance: none;
+    appearance: none;
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    background: #fff;
+    cursor: pointer;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.4);
+}
+.fullscreen-volume-slider::-moz-range-thumb {
+    width: 12px;
+    height: 12px;
+    border-radius: 50%;
+    background: #fff;
+    cursor: pointer;
+    border: none;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.4);
+}
+.fullscreen-volume-slider::-moz-range-track {
+    height: 4px;
+    background: rgba(255, 255, 255, 0.3);
+    border-radius: 2px;
+}
diff --git a/static/img/dark-mode.png b/static/img/dark-mode.png
new file mode 100644
index 00000000..423c600a
Binary files /dev/null and b/static/img/dark-mode.png differ
diff --git a/static/img/edit_transcription.png b/static/img/edit_transcription.png
new file mode 100644
index 00000000..0c289362
Binary files /dev/null and b/static/img/edit_transcription.png differ
diff --git a/static/img/favicon.ico b/static/img/favicon.ico
new file mode 100644
index 00000000..edf51c57
Binary files /dev/null and b/static/img/favicon.ico differ
diff --git a/static/img/icon-16x16.png b/static/img/icon-16x16.png
new file mode 100644
index 00000000..316c938a
Binary files /dev/null and b/static/img/icon-16x16.png differ
diff --git a/static/img/icon-180x180.png b/static/img/icon-180x180.png
new file mode 100644
index 00000000..9db18443
Binary files /dev/null and b/static/img/icon-180x180.png differ
diff --git a/static/img/icon-192x192.png b/static/img/icon-192x192.png
new file mode 100644
index 00000000..9069af8f
Binary files /dev/null and b/static/img/icon-192x192.png differ
diff --git a/static/img/icon-32x32.png b/static/img/icon-32x32.png
new file mode 100644
index 00000000..bacff1fe
Binary files /dev/null and b/static/img/icon-32x32.png differ
diff --git a/static/img/icon-512x512.png b/static/img/icon-512x512.png
new file mode 100644
index 00000000..7def29e9
Binary files /dev/null and b/static/img/icon-512x512.png differ
diff --git a/static/img/icon-maskable-512x512.png b/static/img/icon-maskable-512x512.png
new file mode 100644
index 00000000..d867c12b
Binary files /dev/null and b/static/img/icon-maskable-512x512.png differ
diff --git a/static/img/intuitive-speaker-identification.png b/static/img/intuitive-speaker-identification.png
new file mode 100644
index 00000000..b73df086
Binary files /dev/null and b/static/img/intuitive-speaker-identification.png differ
diff --git a/static/img/light-mode.png b/static/img/light-mode.png
new file mode 100644
index 00000000..2e4eea99
Binary files /dev/null and b/static/img/light-mode.png differ
diff --git a/static/img/main.png b/static/img/main.png
new file mode 100644
index 00000000..5e43eb00
Binary files /dev/null and b/static/img/main.png differ
diff --git a/static/img/main2.png b/static/img/main2.png
new file mode 100644
index 00000000..5b863a2a
Binary files /dev/null and b/static/img/main2.png differ
diff --git a/static/img/manual-auto-speaker-identification.png b/static/img/manual-auto-speaker-identification.png
new file mode 100644
index 00000000..82fff9d5
Binary files /dev/null and b/static/img/manual-auto-speaker-identification.png differ
diff --git a/static/img/multilingual-support.png b/static/img/multilingual-support.png
new file mode 100644
index 00000000..c89443d1
Binary files /dev/null and b/static/img/multilingual-support.png differ
diff --git a/static/img/rec1.png b/static/img/rec1.png
new file mode 100644
index 00000000..5631e63d
Binary files /dev/null and b/static/img/rec1.png differ
diff --git a/static/img/rec2.png b/static/img/rec2.png
new file mode 100644
index 00000000..ec77bc33
Binary files /dev/null and b/static/img/rec2.png differ
diff --git a/static/img/rec3.png b/static/img/rec3.png
new file mode 100644
index 00000000..621ad55a
Binary files /dev/null and b/static/img/rec3.png differ
diff --git a/static/img/screenshots/main-view.png b/static/img/screenshots/main-view.png
new file mode 100644
index 00000000..791418df
Binary files /dev/null and b/static/img/screenshots/main-view.png differ
diff --git a/static/img/screenshots/mobile-view.png b/static/img/screenshots/mobile-view.png
new file mode 100644
index 00000000..48a6438c
Binary files /dev/null and b/static/img/screenshots/mobile-view.png differ
diff --git a/static/img/screenshots/recording-interface.png b/static/img/screenshots/recording-interface.png
new file mode 100644
index 00000000..09bd9116
Binary files /dev/null and b/static/img/screenshots/recording-interface.png differ
diff --git a/static/img/screenshots/transcript-view.png b/static/img/screenshots/transcript-view.png
new file mode 100644
index 00000000..7454f3e2
Binary files /dev/null and b/static/img/screenshots/transcript-view.png differ
diff --git a/static/img/simple-transcription-view.png b/static/img/simple-transcription-view.png
new file mode 100644
index 00000000..7e9acde7
Binary files /dev/null and b/static/img/simple-transcription-view.png differ
diff --git a/static/img/speaker-suggestions.png b/static/img/speaker-suggestions.png
new file mode 100644
index 00000000..7f50c3a1
Binary files /dev/null and b/static/img/speaker-suggestions.png differ
diff --git a/static/img/tags.png b/static/img/tags.png
new file mode 100644
index 00000000..a8fedcf7
Binary files /dev/null and b/static/img/tags.png differ
diff --git a/static/img/transcription-bubble-view.png b/static/img/transcription-bubble-view.png
new file mode 100644
index 00000000..7d5efad3
Binary files /dev/null and b/static/img/transcription-bubble-view.png differ
diff --git a/static/img/transcription-chat-bubble-view.png b/static/img/transcription-chat-bubble-view.png
new file mode 100644
index 00000000..16dbb6cf
Binary files /dev/null and b/static/img/transcription-chat-bubble-view.png differ
diff --git a/static/js/app.modular.js b/static/js/app.modular.js
new file mode 100644
index 00000000..5e1344be
--- /dev/null
+++ b/static/js/app.modular.js
@@ -0,0 +1,2756 @@
+const { createApp, ref, reactive, computed, onMounted, watch, nextTick } = Vue;
+
+// Import composables
+import { useRecordings } from './modules/composables/recordings.js';
+import { useUpload } from './modules/composables/upload.js';
+import { useAudio } from './modules/composables/audio.js';
+import { useUI } from './modules/composables/ui.js';
+import { useModals } from './modules/composables/modals.js';
+import { useSharing } from './modules/composables/sharing.js';
+import { useReprocess } from './modules/composables/reprocess.js';
+import { useTranscription } from './modules/composables/transcription.js';
+import { useSpeakers } from './modules/composables/speakers.js';
+import { useChat } from './modules/composables/chat.js';
+import { useTags } from './modules/composables/tags.js';
+import { usePWA } from './modules/composables/pwa.js';
+import { useVirtualScroll, getVirtualItemKey } from './modules/composables/virtualScroll.js';
+import { useBulkSelection } from './modules/composables/bulk-selection.js';
+import { useBulkOperations } from './modules/composables/bulk-operations.js';
+import { useFolders } from './modules/composables/folders.js';
+
+// Import utilities
+import { showToast } from './modules/utils/toast.js';
+import { getContrastTextColor } from './modules/utils/colors.js';
+import { buildVariableList } from './modules/utils/prompt-variables.js';
+
+// Number of speaker colors available in CSS (must match styles.css)
+const SPEAKER_COLOR_COUNT = 16;
+
+// Parse transcription text to detect if it's an error message
+const parseTranscriptionError = (text) => {
+    if (!text) return null;
+
+    // Check for JSON-formatted error from backend
+    if (text.startsWith('ERROR_JSON:')) {
+        try {
+            const jsonStr = text.substring(11);
+            const data = JSON.parse(jsonStr);
+            const _t = (key, fb) => (window.i18n && window.i18n.t) ? window.i18n.t(key) : fb;
+            return {
+                title: data.t || _t('errors.fallbackTitle', 'Error'),
+                message: data.m || _t('errors.fallbackMessage', 'An error occurred'),
+                guidance: data.g || '',
+                icon: data.i || 'fa-exclamation-circle',
+                type: data.y || 'unknown',
+                isKnown: data.k || false,
+                technical: data.d || ''
+            };
+        } catch (e) {
+            console.error('Failed to parse error JSON:', e);
+        }
+    }
+
+    // Check for legacy error format
+    const errorPrefixes = [
+        'Transcription failed:',
+        'Processing failed:',
+        'ASR processing failed:',
+        'Audio extraction failed:'
+    ];
+
+    for (const prefix of errorPrefixes) {
+        if (text.startsWith(prefix)) {
+            return parseUnformattedError(text);
+        }
+    }
+
+    return null;
+};
+
+// Parse unformatted error messages and make them user-friendly
+const parseUnformattedError = (text) => {
+    const _t = (key, fb) => (window.i18n && window.i18n.t) ? window.i18n.t(key) : fb;
+    const lowerText = text.toLowerCase();
+
+    // Known error patterns
+    const patterns = [
+        {
+            patterns: ['maximum content size limit', 'file too large', '413', 'payload too large', 'exceeded'],
+            title: _t('errors.fileTooLargeTitle', 'File Too Large'),
+            message: _t('errors.fileTooLargeMessage', 'The audio file exceeds the maximum size allowed by the transcription service.'),
+            guidance: _t('errors.fileTooLargeGuidance', 'Try enabling audio chunking in your settings, or compress the audio file before uploading.'),
+            icon: 'fa-file-audio',
+            type: 'size_limit'
+        },
+        {
+            patterns: ['timed out', 'timeout', 'deadline exceeded'],
+            title: _t('errors.processingTimeout', 'Processing Timeout'),
+            message: _t('errors.processingTimeoutMessage', 'The transcription took too long to complete.'),
+            guidance: _t('errors.processingTimeoutGuidance', 'This can happen with very long recordings. Try splitting the audio into smaller parts.'),
+            icon: 'fa-clock',
+            type: 'timeout'
+        },
+        {
+            patterns: ['401', 'unauthorized', 'invalid api key', 'authentication failed', 'incorrect api key'],
+            title: _t('errors.authenticationError', 'Authentication Error'),
+            message: _t('errors.authenticationErrorMessage', 'The transcription service rejected the API credentials.'),
+            guidance: _t('errors.authenticationErrorGuidance', 'Please check that the API key is correct and has not expired.'),
+            icon: 'fa-key',
+            type: 'auth'
+        },
+        {
+            patterns: ['rate limit', 'too many requests', '429', 'quota exceeded'],
+            title: _t('errors.rateLimitExceeded', 'Rate Limit Exceeded'),
+            message: _t('errors.rateLimitExceededMessage', 'Too many requests were sent to the transcription service.'),
+            guidance: _t('errors.rateLimitExceededGuidance', 'Please wait a few minutes and try reprocessing.'),
+            icon: 'fa-hourglass-half',
+            type: 'rate_limit'
+        },
+        {
+            patterns: ['connection refused', 'connection reset', 'could not connect', 'network unreachable'],
+            title: _t('errors.connectionError', 'Connection Error'),
+            message: _t('errors.connectionErrorMessage', 'Could not connect to the transcription service.'),
+            guidance: _t('errors.connectionErrorGuidance', 'Check your internet connection and ensure the service is available.'),
+            icon: 'fa-wifi',
+            type: 'connection'
+        },
+        {
+            patterns: ['503', '502', '500', 'service unavailable', 'server error', 'internal server error'],
+            title: _t('errors.serviceUnavailable', 'Service Unavailable'),
+            message: _t('errors.serviceUnavailableMessage', 'The transcription service is temporarily unavailable.'),
+            guidance: _t('errors.serviceUnavailableGuidance', 'This is usually temporary. Please try again in a few minutes.'),
+            icon: 'fa-server',
+            type: 'service_error'
+        },
+        {
+            patterns: ['invalid file format', 'unsupported format', 'could not decode', 'corrupt', 'not valid audio'],
+            title: _t('errors.invalidAudioFormat', 'Invalid Audio Format'),
+            message: _t('errors.invalidAudioFormatMessage', 'The audio file format is not supported or the file may be corrupted.'),
+            guidance: _t('errors.invalidAudioFormatGuidance', 'Try converting the audio to MP3 or WAV format before uploading.'),
+            icon: 'fa-file-audio',
+            type: 'format'
+        },
+        {
+            patterns: ['audio extraction failed', 'ffmpeg failed', 'no audio stream'],
+            title: _t('errors.audioExtractionFailed', 'Audio Extraction Failed'),
+            message: _t('errors.audioExtractionFailedMessage', 'Could not extract audio from the uploaded file.'),
+            guidance: _t('errors.audioExtractionFailedGuidance', 'Try converting the file to a standard audio format (MP3, WAV) before uploading.'),
+            icon: 'fa-file-video',
+            type: 'extraction'
+        }
+    ];
+
+    // Check patterns
+    for (const pattern of patterns) {
+        for (const p of pattern.patterns) {
+            if (lowerText.includes(p)) {
+                return {
+                    title: pattern.title,
+                    message: pattern.message,
+                    guidance: pattern.guidance,
+                    icon: pattern.icon,
+                    type: pattern.type,
+                    isKnown: true,
+                    technical: text
+                };
+            }
+        }
+    }
+
+    // Unknown error - clean it up
+    let cleanMessage = text;
+    for (const prefix of ['Transcription failed:', 'Processing failed:', 'Error:', 'ASR processing failed:']) {
+        if (cleanMessage.startsWith(prefix)) {
+            cleanMessage = cleanMessage.substring(prefix.length).trim();
+        }
+    }
+
+    // Truncate if too long
+    if (cleanMessage.length > 200) {
+        cleanMessage = cleanMessage.substring(0, 200) + '...';
+    }
+
+    return {
+        title: _t('errors.processingError', 'Processing Error'),
+        message: cleanMessage,
+        guidance: _t('errors.processingErrorGuidance', 'If this error persists, try reprocessing the recording.'),
+        icon: 'fa-exclamation-circle',
+        type: 'unknown',
+        isKnown: false,
+        technical: text
+    };
+};
+
+// Wait for the DOM to be fully loaded before mounting the Vue app
+document.addEventListener('DOMContentLoaded', async () => {
+    // Initialize i18n before creating Vue app (if not already initialized)
+    try {
+        if (window.i18n && !window.i18n.currentLocale) {
+            const appElement = document.getElementById('app');
+            const userLang = appElement?.dataset.userLanguage || localStorage.getItem('preferredLanguage') || 'en';
+
+            // Add timeout to prevent indefinite waiting
+            await Promise.race([
+                window.i18n.init(userLang),
+                new Promise((resolve) => setTimeout(resolve, 3000))
+            ]);
+
+            console.log('i18n initialized with language:', userLang);
+        } else if (window.i18n && window.i18n.currentLocale) {
+            console.log('i18n already initialized with language:', window.i18n.currentLocale);
+        }
+    } catch (error) {
+        console.error('Error initializing i18n:', error);
+        // Continue anyway with fallback translations
+    }
+
+    // CSRF Token Integration with Vue.js
+    const csrfToken = ref(document.querySelector('meta[name="csrf-token"]')?.getAttribute('content'));
+
+    // Register Service Worker (non-blocking)
+    if ('serviceWorker' in navigator) {
+        // Delay registration to not block page load
+        setTimeout(() => {
+            navigator.serviceWorker.register('/static/sw.js')
+                .then(registration => {
+                    console.log('ServiceWorker registration successful with scope:', registration.scope);
+                })
+                .catch(error => {
+                    console.warn('ServiceWorker registration failed (non-critical):', error);
+                });
+        }, 1000);
+    }
+
+    // Create a safe t function that's always available
+    const safeT = (key, params = {}) => {
+        if (!window.i18n || !window.i18n.t) {
+            return key;
+        }
+        return window.i18n.t(key, params);
+    };
+
+    const app = createApp({
+        setup() {
+            // =========================================================================
+            // STATE DECLARATIONS - All reactive state stays here for proper reactivity
+            // =========================================================================
+
+            // --- Core State ---
+            const currentView = ref('upload');
+            const dragover = ref(false);
+            const recordings = ref([]);
+            const selectedRecording = ref(null);
+            const selectedTab = ref('summary');
+            const searchQuery = ref('');
+            const isLoadingRecordings = ref(true);
+            const globalError = ref(null);
+
+            // Advanced filter state
+            const showAdvancedFilters = ref(false);
+            const filterTags = ref([]);
+            const filterSpeakers = ref([]);
+            const filterTagSearch = ref('');
+            const filterSpeakerSearch = ref('');
+            const filterDateRange = ref({ start: '', end: '' });
+            const filterDatePreset = ref('');
+            const filterTextQuery = ref('');
+            const filterStarred = ref(false);
+            const filterInbox = ref(false);
+            const showArchivedRecordings = ref(false);
+            const showSharedWithMe = ref(false);
+
+            // --- Pagination State ---
+            const currentPage = ref(1);
+            const perPage = ref(25);
+            const totalRecordings = ref(0);
+            const totalPages = ref(0);
+            const hasNextPage = ref(false);
+            const hasPrevPage = ref(false);
+            const isLoadingMore = ref(false);
+            const searchDebounceTimer = ref(null);
+
+            // --- Enhanced Search & Organization State ---
+            // Restore the sort choice from a previous session so users do not
+            // have to switch to Meeting date every time they open the app
+            // (discussion #263). Validate against the known set so a stale or
+            // tampered localStorage value cannot put us in an unknown state.
+            const _savedSortBy = localStorage.getItem('recordingsSortBy');
+            const sortBy = ref((_savedSortBy === 'meeting_date' || _savedSortBy === 'created_at')
+                ? _savedSortBy
+                : 'created_at');
+            const selectedTagFilter = ref(null);
+
+            // --- UI State ---
+            const browser = ref('unknown');
+            const isSidebarCollapsed = ref(false);
+            const searchTipsExpanded = ref(false);
+            const isUserMenuOpen = ref(false);
+            const tokenBudget = ref({
+                has_budget: false,
+                budget: null,
+                usage: 0,
+                percentage: 0
+            });
+            const isDarkMode = ref(false);
+            const currentColorScheme = ref('blue');
+            const showColorSchemeModal = ref(false);
+            const windowWidth = ref(window.innerWidth);
+            const mobileTab = ref('transcript');
+            const isMetadataExpanded = ref(false);
+            const expandedSection = ref('settings');  // 'notes' or 'settings' for recording view accordion
+            const showSortOptions = ref(false);
+
+            // --- i18n State ---
+            const currentLanguage = ref('en');
+            const currentLanguageName = ref('English');
+            const availableLanguages = ref([]);
+            const showLanguageMenu = ref(false);
+
+            // --- Upload State ---
+            const uploadQueue = ref([]);
+            const allJobs = ref([]); // Backend job queue (queued, processing, completed, failed)
+            const currentlyProcessingFile = ref(null);
+            const processingProgress = ref(0);
+            const processingMessage = ref('');
+            const isProcessingActive = ref(false);
+            const pollInterval = ref(null);
+            const progressPopupMinimized = ref(false);
+            const progressPopupClosed = ref(false);
+            const maxFileSizeMB = ref(250);
+            const chunkingEnabled = ref(true);
+            const chunkingMode = ref('size');
+            const chunkingLimit = ref(20);
+            const chunkingLimitDisplay = ref('20MB');
+            const maxConcurrentUploads = ref(3);
+            const recordingDisclaimer = ref('');
+            const showRecordingDisclaimerModal = ref(false);
+            const pendingRecordingMode = ref(null);
+            const uploadDisclaimer = ref('');
+            const showUploadDisclaimerModal = ref(false);
+            const customBanner = ref('');
+            const showBanner = ref(true);
+
+            // --- Audio Recording State ---
+            const isRecording = ref(false);
+            const mediaRecorder = ref(null);
+            const audioChunks = ref([]);
+            const audioBlobURL = ref(null);
+            const recordingTime = ref(0);
+            const recordingInterval = ref(null);
+            const canRecordAudio = ref(navigator.mediaDevices && navigator.mediaDevices.getUserMedia);
+            const canRecordSystemAudio = computed(() => navigator.mediaDevices && navigator.mediaDevices.getDisplayMedia);
+            const systemAudioSupported = ref(false);
+            const systemAudioError = ref('');
+            const recordingNotes = ref('');
+            const showSystemAudioHelp = ref(false);
+            const showSystemAudioHelpModal = ref(false);
+            const showRecoveryModal = ref(false);
+            const recoverableRecording = ref(null);
+            const asrLanguage = ref('');
+            const asrMinSpeakers = ref('');
+            const asrMaxSpeakers = ref('');
+            const audioContext = ref(null);
+            const analyser = ref(null);
+            const micAnalyser = ref(null);
+            const systemAnalyser = ref(null);
+            const visualizer = ref(null);
+            const micVisualizer = ref(null);
+            const systemVisualizer = ref(null);
+            const animationFrameId = ref(null);
+            const recordingMode = ref('microphone');
+            const activeStreams = ref([]);
+
+            // --- Wake Lock and Background Recording ---
+            const wakeLock = ref(null);
+            const recordingNotification = ref(null);
+            const isPageVisible = ref(true);
+
+            // --- PWA Features ---
+            const deferredInstallPrompt = ref(null);
+            const showInstallButton = ref(false);
+            const isPWAInstalled = ref(false);
+            const notificationPermission = ref('default');
+            const pushSubscription = ref(null);
+            const appBadgeCount = ref(0);
+            const currentMediaMetadata = ref(null);
+            const isMediaSessionActive = ref(false);
+
+            // --- Incognito Mode State ---
+            const enableIncognitoMode = ref(false);  // Server config
+            const incognitoMode = ref(false);
+            const incognitoRecording = ref(null);
+            const incognitoProcessing = ref(false);
+
+            // --- Bulk Selection State ---
+            const selectionMode = ref(false);
+            const selectedRecordingIds = ref(new Set());
+            const bulkActionInProgress = ref(false);
+
+            // --- Recording Size Monitoring ---
+            const estimatedFileSize = ref(0);
+            const fileSizeWarningShown = ref(false);
+            const recordingQuality = ref('optimized');
+            const actualBitrate = ref(0);
+            const maxRecordingMB = ref(200);
+            const sizeCheckInterval = ref(null);
+
+            // Advanced Options for ASR
+            const showAdvancedOptions = ref(false);
+            const userTranscriptionLanguage = ref('');  // User's default from account settings
+            // Personal and site-default summary prompts. Used by the upload
+            // form to surface `{{variable}}` placeholders that would otherwise
+            // substitute to empty strings.
+            const userSummaryPrompt = ref('');
+            const adminDefaultSummaryPrompt = ref('');
+            const uploadLanguage = ref('');
+            const uploadMinSpeakers = ref('');
+            const uploadMaxSpeakers = ref('');
+            const uploadHotwords = ref('');
+            const uploadInitialPrompt = ref('');
+            const uploadTranscriptionModel = ref('');
+            const uploadPromptVariables = reactive({});  // {variableName: value}
+            const showPromptVariablesPanel = ref(true);  // expander state
+            const transcriptionModelOptions = ref([]);
+
+            // Tag Selection
+            const availableTags = ref([]);
+            const selectedTagIds = ref([]);
+            const uploadTagSearchFilter = ref('');
+
+            // Folder Selection
+            const availableFolders = ref([]);
+            const selectedFolderId = ref(null);
+            const foldersEnabled = ref(false);
+            const filterFolder = ref('');
+
+            // --- Modal State ---
+            const showEditModal = ref(false);
+            const showDeleteModal = ref(false);
+            const showEditTagsModal = ref(false);
+            const selectedNewTagId = ref('');
+            const tagSearchFilter = ref('');
+            const showReprocessModal = ref(false);
+            const showResetModal = ref(false);
+            const showSpeakerModal = ref(false);
+            const speakerModalTab = ref('speakers');  // 'speakers' or 'transcript' for mobile view
+            const showShareModal = ref(false);
+            const showSharesListModal = ref(false);
+            const showTextEditorModal = ref(false);
+            const showAsrEditorModal = ref(false);
+            const showCustomizeSummaryModal = ref(false);
+            const customizeSummaryPrompt = ref('');
+            const customizeSummaryMode = ref('append');  // 'append' | 'replace'
+            const editingRecording = ref(null);
+            const editingTranscriptionContent = ref('');
+            const editingSegments = ref([]);
+            const availableSpeakers = ref([]);
+            const showEditSpeakersModal = ref(false);
+            const editingSpeakersList = ref([]);
+            const databaseSpeakers = ref([]);
+            const editingSpeakerSuggestions = ref({});
+            const showEditParticipantsModal = ref(false);
+            const editingParticipantsList = ref([]);
+            const editingParticipantSuggestions = ref({});
+            const allParticipants = ref([]);
+            const recordingToShare = ref(null);
+            const shareOptions = reactive({
+                share_summary: true,
+                share_notes: true,
+            });
+            const generatedShareLink = ref('');
+            const existingShareDetected = ref(false);
+            const recordingPublicShares = ref([]); // All public shares for current recording
+            const isLoadingPublicShares = ref(false);
+            const userShares = ref([]);
+            const isLoadingShares = ref(false);
+            const copiedShareId = ref(null);
+            const shareToDelete = ref(null);
+            const showShareDeleteModal = ref(false);
+            const recordingToDelete = ref(null);
+            const recordingToReset = ref(null);
+            const reprocessType = ref(null);
+            const reprocessRecording = ref(null);
+            // Working copy of prompt-template variable values for the reprocess
+            // summary modal. Hydrated from `selectedRecording.prompt_variables`
+            // when the modal opens; the user can edit them and the values are
+            // persisted on the recording when reprocess is submitted.
+            const reprocessPromptVariables = reactive({});
+            const isAutoIdentifying = ref(false);
+            const asrReprocessOptions = reactive({
+                language: '',
+                min_speakers: null,
+                max_speakers: null
+            });
+            const summaryReprocessPromptSource = ref('default');
+            const summaryReprocessSelectedTagId = ref('');
+            const summaryReprocessCustomPrompt = ref('');
+            const summaryReprocessPromptMode = ref('append');  // 'append' | 'replace'
+            const speakerMap = ref({});
+            const speakerColorMap = ref({}); // Stable mapping of speaker ID → color class
+            const modalSpeakers = ref([]);
+            const speakerDisplayMap = ref({});
+            const regenerateSummaryAfterSpeakerUpdate = ref(true);
+            const speakerSuggestions = ref({});
+            const loadingSuggestions = ref({});
+            const activeSpeakerInput = ref(null);
+            const voiceSuggestions = ref({});
+            const loadingVoiceSuggestions = ref(false);
+
+            // --- DateTime Picker State ---
+            const showDateTimePicker = ref(false);
+            const pickerMonth = ref(new Date().getMonth());
+            const pickerYear = ref(new Date().getFullYear());
+            const pickerHour = ref(12);
+            const pickerMinute = ref(0);
+            const pickerAmPm = ref('PM');
+            const pickerSelectedDate = ref(null);
+            const dateTimePickerTarget = ref(null);
+            const dateTimePickerCallback = ref(null);
+
+            // --- Transcript Editing State ---
+            const editingSegmentIndex = ref(null);
+            const editingSpeakerIndex = ref(null);
+            const showEditTextModal = ref(false);
+            const editedText = ref('');
+            const showAddSpeakerModal = ref(false);
+            const newSpeakerName = ref('');
+            const newSpeakerIsMe = ref(false);
+            const newSpeakerSuggestions = ref([]);
+            const loadingNewSpeakerSuggestions = ref(false);
+            const showNewSpeakerSuggestions = ref(false);
+            const editedTranscriptData = ref(null);
+
+            // --- Inline Editing State ---
+            const editingTitle = ref(false);
+            const originalTitle = ref('');
+            const regeneratingTitle = ref(false);
+            const editingParticipants = ref(false);
+            const editingMeetingDate = ref(false);
+            const editingSummary = ref(false);
+            const editingNotes = ref(false);
+            const tempNotesContent = ref('');
+            const tempSummaryContent = ref('');
+            const autoSaveTimer = ref(null);
+            const autoSaveDelay = 2000;
+
+            // --- Markdown Editor State ---
+            const notesMarkdownEditor = ref(null);
+            const markdownEditorInstance = ref(null);
+            const summaryMarkdownEditor = ref(null);
+            const summaryMarkdownEditorInstance = ref(null);
+            const recordingNotesEditor = ref(null);
+            const recordingMarkdownEditorInstance = ref(null);
+
+            // --- Transcription State ---
+            const transcriptionViewMode = ref('simple');
+            const legendExpanded = ref(false);
+            const highlightedSpeaker = ref(null);
+            const showDownloadMenu = ref(false);
+            const currentPlayingSegmentIndex = ref(null);
+            const followPlayerMode = ref(false);
+            const processingIndicatorMinimized = ref(false);
+
+            // --- Chat State ---
+            const showChat = ref(false);
+            const isChatMaximized = ref(false);
+            const chatMessages = ref([]);
+            const chatInput = ref('');
+            const isChatLoading = ref(false);
+            const chatMessagesRef = ref(null);
+            const chatInputRef = ref(null);
+
+            // --- Audio Player State (Main Player) ---
+            const playerVolume = ref(1.0);
+            const audioIsPlaying = ref(false);
+            const audioCurrentTime = ref(0);
+            const audioDuration = ref(0);
+            const audioIsMuted = ref(false);
+            const audioIsLoading = ref(false);
+            const asrEditorAudio = ref(null);
+            const playbackRate = ref(1.0);
+            const showSpeedMenu = ref(false);
+            const playbackSpeeds = [0.5, 0.75, 1.0, 1.25, 1.5, 1.75, 2.0, 2.5, 3.0];
+            const speedMenuPosition = ref({});
+            const showVolumeSlider = ref(false);
+            const showModalVolumeSlider = ref(false);
+            const showDuplicatesModal = ref(false);
+            const videoCollapsed = ref(false);
+            const videoFullscreen = ref(false);
+            const fullscreenControlsVisible = ref(true);
+            const fullscreenControlsTimer = ref(null);
+            const duplicatesModalData = ref(null);
+
+            // --- Modal Audio Player State (Independent from main) ---
+            const modalAudioCurrentTime = ref(0);
+            const modalAudioDuration = ref(0);
+            const modalAudioIsPlaying = ref(false);
+            const modalPlaybackRate = ref(1.0);
+
+            // --- Column Resizing State ---
+            const leftColumnWidth = ref(60);
+            const rightColumnWidth = ref(40);
+            const isResizing = ref(false);
+
+            // --- Dropdown Positioning ---
+            const dropdownPositions = ref({});
+            // Single-ref dropdown tracking for ASR editor (performance optimization)
+            const openAsrDropdownIndex = ref(null);
+
+            // --- App Configuration ---
+            const useAsrEndpoint = ref(false);
+            const connectorSupportsDiarization = ref(false);  // Connector capability for diarization UI
+            const connectorSupportsSpeakerCount = ref(false);  // Connector capability for min/max speakers
+            const connectorSupportsHotwords = ref(false);     // Connector accepts hotword/keyword biasing
+            const connectorSupportsInitialPrompt = ref(false); // Connector accepts initial prompt / context hint
+            const showTimestampsSimpleView = ref(false);     // User pref: display timestamps in simple view
+            const editorAutosave = ref(false);                // User pref: autosave transcript editor
+            const currentUserName = ref('');
+            const canDeleteRecordings = ref(true);
+            const enableInternalSharing = ref(false);
+            const enableArchiveToggle = ref(false);
+            const showUsernamesInUI = ref(false);
+
+            // --- Internal Sharing State ---
+            const showUnifiedShareModal = ref(false);
+            const internalShareUserSearch = ref('');
+            const internalShareSearchResults = ref([]);
+            const internalShareRecording = ref(null);
+            const internalSharePermissions = ref({ can_edit: false, can_reshare: false });
+            const internalShareMaxPermissions = ref({ can_edit: true, can_reshare: true });  // Permission ceiling for current user
+            const recordingInternalShares = ref([]);
+            const isLoadingInternalShares = ref(false);
+            const isSearchingUsers = ref(false);
+            const allUsers = ref([]);
+            const isLoadingAllUsers = ref(false);
+
+            // --- Reprocessing Polls ---
+            const reprocessingPolls = ref(new Map());
+
+            // --- Speaker Groups State ---
+            const currentSpeakerGroupIndex = ref(0);
+            const speakerGroups = ref([]);
+
+            // --- Virtual Scroll Container Refs ---
+            const speakerModalTranscriptRef = ref(null);
+            const mainTranscriptRef = ref(null);
+            const asrEditorRef = ref(null);
+            const asrEditorSaveFlash = ref(false);  // Brief "Saved" indicator after Save (without close)
+            const asrEditorHighlightIndex = ref(null);  // Segment index briefly highlighted after double-click open
+
+            // --- Computed properties needed by composables ---
+            const isMobileScreen = computed(() => windowWidth.value < 1024);
+
+            // Aggregate `{{name}}` variables across the currently selected
+            // tags / folder / user / admin prompt chain. The pure helpers
+            // live in modules/utils/prompt-variables.js so they can be unit
+            // tested with Vitest.
+            const selectedPromptVariables = computed(() => {
+                const tagsWithPrompts = (Array.isArray(selectedTagIds.value) && Array.isArray(availableTags.value))
+                    ? selectedTagIds.value.map(id => availableTags.value.find(t => t.id === id)).filter(Boolean)
+                    : [];
+                const folder = (selectedFolderId.value && Array.isArray(availableFolders.value))
+                    ? (availableFolders.value.find(f => f.id === selectedFolderId.value) || null)
+                    : null;
+                return buildVariableList({
+                    tagsWithPrompts,
+                    folder,
+                    userPrompt: userSummaryPrompt.value,
+                    adminPrompt: adminDefaultSummaryPrompt.value,
+                });
+            });
+
+            // Same shape as selectedPromptVariables but for a recording that
+            // already has its tags/folder assigned. Used by the reprocess
+            // summary modal to render input fields pre-populated from the
+            // recording's stored values.
+            const reprocessAvailableVariables = computed(() => {
+                if (!selectedRecording.value) return [];
+                const recording = selectedRecording.value;
+                // Surface the variables that match the prompt source the user
+                // is about to run. Otherwise the panel keeps showing the
+                // recording's *original* tag's variables even after the user
+                // picks a different tag, which is confusing when the chosen
+                // tag has no placeholders.
+                const source = summaryReprocessPromptSource.value;
+                if (source === 'tag') {
+                    const tagId = summaryReprocessSelectedTagId.value;
+                    if (!tagId) return [];
+                    const tag = (availableTags.value || []).find(t => t.id == tagId);
+                    if (!tag || !tag.custom_prompt) return [];
+                    return buildVariableList({
+                        tagsWithPrompts: [tag],
+                        folder: null,
+                        userPrompt: '',
+                        adminPrompt: '',
+                    });
+                }
+                if (source === 'custom') {
+                    const text = summaryReprocessCustomPrompt.value || '';
+                    if (!text.trim()) return [];
+                    return buildVariableList({
+                        tagsWithPrompts: [{ name: 'Custom prompt', custom_prompt: text }],
+                        folder: null,
+                        userPrompt: '',
+                        adminPrompt: '',
+                    });
+                }
+                // source === 'default' — fall through to the standard priority
+                // chain that the backend will resolve at task time.
+                return buildVariableList({
+                    tagsWithPrompts: Array.isArray(recording.tags) ? recording.tags : [],
+                    folder: recording.folder || null,
+                    userPrompt: userSummaryPrompt.value,
+                    adminPrompt: adminDefaultSummaryPrompt.value,
+                });
+            });
+            const isMobileDevice = computed(() => {
+                return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent) ||
+                       ('ontouchstart' in window) ||
+                       (navigator.maxTouchPoints > 0);
+            });
+
+            const colorSchemes = {
+                light: [
+                    { id: 'blue', name: 'Ocean Blue', description: 'Classic blue theme with professional appeal', class: '' },
+                    { id: 'emerald', name: 'Forest Emerald', description: 'Fresh green theme for a natural feel', class: 'theme-light-emerald' },
+                    { id: 'purple', name: 'Royal Purple', description: 'Elegant purple theme with sophistication', class: 'theme-light-purple' },
+                    { id: 'rose', name: 'Sunset Rose', description: 'Warm pink theme with gentle energy', class: 'theme-light-rose' },
+                    { id: 'amber', name: 'Golden Amber', description: 'Warm yellow theme for brightness', class: 'theme-light-amber' },
+                    { id: 'teal', name: 'Ocean Teal', description: 'Cool teal theme for tranquility', class: 'theme-light-teal' }
+                ],
+                dark: [
+                    { id: 'blue', name: 'Midnight Blue', description: 'Deep blue theme for focused work', class: '' },
+                    { id: 'emerald', name: 'Dark Forest', description: 'Rich green theme for comfortable viewing', class: 'theme-dark-emerald' },
+                    { id: 'purple', name: 'Deep Purple', description: 'Mysterious purple theme for creativity', class: 'theme-dark-purple' },
+                    { id: 'rose', name: 'Dark Rose', description: 'Muted pink theme with subtle warmth', class: 'theme-dark-rose' },
+                    { id: 'amber', name: 'Dark Amber', description: 'Warm brown theme for cozy sessions', class: 'theme-dark-amber' },
+                    { id: 'teal', name: 'Deep Teal', description: 'Dark teal theme for calm focus', class: 'theme-dark-teal' }
+                ]
+            };
+
+            // Compact mm:ss / h:mm:ss formatter for transcript timestamps. Returns
+            // "Start" for the recording's first segment (any value below half a
+            // second) so the leading pill reads as a label rather than a bare
+            // 00:00. Returns an empty string when the input is missing so
+            // templates can render "" without a guard. Declared before `state`
+            // because state references it.
+            const formatTimestamp = (seconds) => {
+                if (seconds == null || isNaN(seconds)) return '';
+                if (seconds < 0.5) return 'Start';
+                const total = Math.floor(seconds);
+                const h = Math.floor(total / 3600);
+                const m = Math.floor((total % 3600) / 60);
+                const s = total % 60;
+                const pad = (n) => n < 10 ? '0' + n : '' + n;
+                return h > 0 ? `${h}:${pad(m)}:${pad(s)}` : `${pad(m)}:${pad(s)}`;
+            };
+
+            // =========================================================================
+            // COLLECT ALL STATE INTO SINGLE OBJECT FOR COMPOSABLES
+            // =========================================================================
+            const state = {
+                // Core
+                currentView, dragover, recordings, selectedRecording, selectedTab, searchQuery,
+                isLoadingRecordings, globalError, csrfToken,
+
+                // Filters
+                showAdvancedFilters, filterTags, filterSpeakers, filterTagSearch, filterSpeakerSearch,
+                filterDateRange, filterDatePreset, filterTextQuery, filterStarred, filterInbox,
+                showArchivedRecordings, showSharedWithMe, sortBy, selectedTagFilter,
+
+                // Pagination
+                currentPage, perPage, totalRecordings, totalPages, hasNextPage, hasPrevPage,
+                isLoadingMore, searchDebounceTimer,
+
+                // UI
+                browser, isSidebarCollapsed, searchTipsExpanded, isUserMenuOpen, tokenBudget, isDarkMode,
+                currentColorScheme, showColorSchemeModal, windowWidth, mobileTab, isMetadataExpanded, expandedSection,
+                showSortOptions, currentLanguage, currentLanguageName, availableLanguages, showLanguageMenu,
+                colorSchemes, isMobileScreen, isMobileDevice,
+
+                // Upload
+                uploadQueue, allJobs, currentlyProcessingFile, processingProgress, processingMessage,
+                isProcessingActive, pollInterval, progressPopupMinimized, progressPopupClosed,
+                maxFileSizeMB, chunkingEnabled, chunkingMode, chunkingLimit, chunkingLimitDisplay,
+                maxConcurrentUploads, recordingDisclaimer, showRecordingDisclaimerModal, pendingRecordingMode,
+                uploadDisclaimer, showUploadDisclaimerModal,
+                customBanner, showBanner,
+                showAdvancedOptions, userTranscriptionLanguage, uploadLanguage, uploadMinSpeakers, uploadMaxSpeakers, uploadHotwords, uploadInitialPrompt, uploadTranscriptionModel, uploadPromptVariables, showPromptVariablesPanel, selectedPromptVariables, reprocessAvailableVariables, transcriptionModelOptions,
+                availableTags, selectedTagIds, uploadTagSearchFilter,
+                availableFolders, selectedFolderId, foldersEnabled, filterFolder,
+
+                // Audio Recording
+                isRecording, mediaRecorder, audioChunks, audioBlobURL, recordingTime, recordingInterval,
+                canRecordAudio, canRecordSystemAudio, systemAudioSupported, systemAudioError,
+                recordingNotes, showSystemAudioHelp, showSystemAudioHelpModal, asrLanguage, asrMinSpeakers, asrMaxSpeakers,
+                audioContext, analyser, micAnalyser, systemAnalyser, visualizer, micVisualizer,
+                systemVisualizer, animationFrameId, recordingMode, activeStreams,
+                wakeLock, recordingNotification, isPageVisible,
+                estimatedFileSize, fileSizeWarningShown, recordingQuality, actualBitrate,
+                maxRecordingMB, sizeCheckInterval,
+
+                // PWA Features
+                deferredInstallPrompt, showInstallButton, isPWAInstalled,
+                notificationPermission, pushSubscription, appBadgeCount,
+                currentMediaMetadata, isMediaSessionActive,
+
+                // Incognito Mode
+                enableIncognitoMode, incognitoMode, incognitoRecording, incognitoProcessing,
+
+                // Bulk Selection
+                selectionMode, selectedRecordingIds, bulkActionInProgress,
+
+                // Modals
+                showEditModal, showDeleteModal, showEditTagsModal, selectedNewTagId, tagSearchFilter,
+                showReprocessModal, showResetModal, showSpeakerModal, speakerModalTab, showShareModal, showSharesListModal,
+                showTextEditorModal, showAsrEditorModal, showCustomizeSummaryModal, customizeSummaryPrompt, customizeSummaryMode, editingRecording, editingTranscriptionContent,
+                editingSegments, availableSpeakers, showEditSpeakersModal, editingSpeakersList,
+                databaseSpeakers, editingSpeakerSuggestions,
+                showEditParticipantsModal, editingParticipantsList, editingParticipantSuggestions, allParticipants,
+                recordingToShare, shareOptions,
+                generatedShareLink, existingShareDetected, recordingPublicShares, isLoadingPublicShares,
+                userShares, isLoadingShares, copiedShareId,
+                shareToDelete, showShareDeleteModal, recordingToDelete, recordingToReset,
+                reprocessType, reprocessRecording, reprocessPromptVariables, isAutoIdentifying, asrReprocessOptions,
+                summaryReprocessPromptSource, summaryReprocessSelectedTagId, summaryReprocessCustomPrompt, summaryReprocessPromptMode,
+                speakerMap, speakerColorMap, modalSpeakers, speakerDisplayMap, regenerateSummaryAfterSpeakerUpdate, speakerSuggestions,
+                loadingSuggestions, activeSpeakerInput, voiceSuggestions, loadingVoiceSuggestions,
+
+                // DateTime Picker
+                showDateTimePicker, pickerMonth, pickerYear, pickerHour, pickerMinute,
+                pickerAmPm, pickerSelectedDate, dateTimePickerTarget, dateTimePickerCallback,
+
+                // Transcript Editing
+                editingSegmentIndex, editingSpeakerIndex, showEditTextModal, editedText,
+                showAddSpeakerModal, newSpeakerName, newSpeakerIsMe, newSpeakerSuggestions,
+                loadingNewSpeakerSuggestions, showNewSpeakerSuggestions, editedTranscriptData,
+
+                // Inline Editing
+                editingTitle, originalTitle, regeneratingTitle,
+                editingParticipants, editingMeetingDate, editingSummary, editingNotes,
+                tempNotesContent, tempSummaryContent, autoSaveTimer, autoSaveDelay,
+
+                // Markdown
+                notesMarkdownEditor, markdownEditorInstance, summaryMarkdownEditor,
+                summaryMarkdownEditorInstance, recordingNotesEditor, recordingMarkdownEditorInstance,
+
+                // Transcription
+                transcriptionViewMode, legendExpanded, highlightedSpeaker, showDownloadMenu,
+                currentPlayingSegmentIndex, followPlayerMode, processingIndicatorMinimized,
+
+                // Chat
+                showChat, isChatMaximized, chatMessages, chatInput, isChatLoading, chatMessagesRef, chatInputRef,
+
+                // Audio Player
+                playerVolume, audioIsPlaying, audioCurrentTime, audioDuration, audioIsMuted, audioIsLoading, asrEditorAudio,
+                modalAudioCurrentTime, modalAudioDuration, modalAudioIsPlaying, modalPlaybackRate,
+                playbackRate, showSpeedMenu, playbackSpeeds, speedMenuPosition, showVolumeSlider, showModalVolumeSlider,
+                videoFullscreen, fullscreenControlsVisible, fullscreenControlsTimer, videoCollapsed,
+
+                // Column Resizing
+                leftColumnWidth, rightColumnWidth, isResizing,
+
+                // Dropdown Positioning
+                dropdownPositions,
+                openAsrDropdownIndex,
+
+                // App Config
+                useAsrEndpoint, connectorSupportsDiarization, connectorSupportsSpeakerCount, connectorSupportsHotwords, connectorSupportsInitialPrompt, showTimestampsSimpleView, editorAutosave, formatTimestamp, currentUserName, canDeleteRecordings, enableInternalSharing, enableArchiveToggle, showUsernamesInUI,
+
+                // Internal Sharing
+                showUnifiedShareModal, internalShareUserSearch, internalShareSearchResults,
+                internalShareRecording, internalSharePermissions, internalShareMaxPermissions, recordingInternalShares,
+                isLoadingInternalShares, isSearchingUsers, allUsers, isLoadingAllUsers,
+
+                // Reprocessing
+                reprocessingPolls,
+
+                // Speaker Groups
+                currentSpeakerGroupIndex, speakerGroups,
+
+                // Virtual Scroll
+                speakerModalTranscriptRef, mainTranscriptRef, asrEditorRef, asrEditorSaveFlash, asrEditorHighlightIndex
+            };
+
+            // =========================================================================
+            // TRANSLATION FUNCTION
+            // =========================================================================
+            const t = safeT;
+            const tc = (key, count, params = {}) => {
+                if (!window.i18n || !window.i18n.tc) {
+                    return key;
+                }
+                return window.i18n.tc(key, count, params);
+            };
+
+            // =========================================================================
+            // UTILITY FUNCTIONS
+            // =========================================================================
+            // showToast is now imported from modules/utils/toast.js
+
+            const setGlobalError = (message, duration = 5000) => {
+                // Use toast system for all errors instead of the old global error banner
+                showToast(message, 'fa-exclamation-circle', duration, 'error');
+            };
+
+            const loadTokenBudget = async () => {
+                try {
+                    const response = await fetch('/api/user/token-budget');
+                    if (response.ok) {
+                        tokenBudget.value = await response.json();
+                    }
+                } catch (error) {
+                    console.error('Error loading token budget:', error);
+                }
+            };
+
+            // Helper function to calculate global segment index in bubble view
+            const getBubbleGlobalIndex = (rowIndex, bubbleIndex) => {
+                if (!processedTranscription.value.bubbleRows) return 0;
+
+                let globalIndex = 0;
+                for (let i = 0; i < rowIndex; i++) {
+                    globalIndex += processedTranscription.value.bubbleRows[i].bubbles.length;
+                }
+                globalIndex += bubbleIndex;
+                return globalIndex;
+            };
+
+            // Modal audio handlers (independent from main player)
+            const handleModalAudioTimeUpdate = (event) => {
+                modalAudioCurrentTime.value = event.target.currentTime;
+            };
+            const handleModalAudioLoadedMetadata = (event) => {
+                const duration = event.target.duration;
+                if (duration && isFinite(duration) && duration > 0) {
+                    modalAudioDuration.value = duration;
+                }
+            };
+            const handleModalAudioPlayPause = (event) => {
+                modalAudioIsPlaying.value = !event.target.paused;
+            };
+            const modalAudioProgressPercent = computed(() => {
+                if (!modalAudioDuration.value) return 0;
+                return (modalAudioCurrentTime.value / modalAudioDuration.value) * 100;
+            });
+            const resetModalAudioState = () => {
+                modalAudioCurrentTime.value = 0;
+                modalAudioDuration.value = 0;
+                modalAudioIsPlaying.value = false;
+            };
+
+            const formatFileSize = (bytes) => {
+                if (!bytes) return '0 B';
+                const k = 1024;
+                const sizes = ['B', 'KB', 'MB', 'GB'];
+                const i = Math.floor(Math.log(bytes) / Math.log(k));
+                return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+            };
+
+            const formatDisplayDate = (dateString) => {
+                if (!dateString) return '';
+                try {
+                    let date = new Date(dateString);
+                    if (isNaN(date.getTime())) {
+                        if (/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+                            const [year, month, day] = dateString.split('-').map(Number);
+                            date = new Date(year, month - 1, day);
+                        } else {
+                            return dateString;
+                        }
+                    }
+                    if (isNaN(date.getTime())) {
+                        return dateString;
+                    }
+                    return date.toLocaleDateString(undefined, {
+                        year: 'numeric', month: 'short', day: 'numeric',
+                        hour: '2-digit', minute: '2-digit'
+                    });
+                } catch (e) {
+                    return dateString;
+                }
+            };
+
+            const formatShortDate = (dateString) => {
+                if (!dateString) return '';
+                try {
+                    let date = new Date(dateString);
+                    if (isNaN(date.getTime())) {
+                        if (/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+                            const [year, month, day] = dateString.split('-').map(Number);
+                            date = new Date(year, month - 1, day);
+                        }
+                    }
+                    if (isNaN(date.getTime())) {
+                        return dateString;
+                    }
+                    const now = new Date();
+                    const isCurrentYear = date.getFullYear() === now.getFullYear();
+                    if (isCurrentYear) {
+                        return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric' });
+                    }
+                    return date.toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });
+                } catch (e) {
+                    return dateString;
+                }
+            };
+
+            const formatStatus = (status) => {
+                const statusMap = {
+                    'PENDING': t('status.pending'),
+                    'PROCESSING': t('status.processing'),
+                    'SUMMARIZING': t('status.summarizing'),
+                    'COMPLETED': t('status.completed'),
+                    'FAILED': t('status.failed')
+                };
+                return statusMap[status] || status;
+            };
+
+            const getStatusClass = (status) => {
+                switch(status) {
+                    case 'COMPLETED': return 'status-completed';
+                    case 'PROCESSING': return 'status-processing';
+                    case 'SUMMARIZING': return 'status-summarizing';
+                    case 'PENDING': return 'status-pending';
+                    case 'FAILED': return 'status-failed';
+                    default: return '';
+                }
+            };
+
+            const formatTime = (seconds) => {
+                const mins = Math.floor(seconds / 60);
+                const secs = Math.floor(seconds % 60);
+                return `${mins}:${secs.toString().padStart(2, '0')}`;
+            };
+
+            const formatDuration = (totalSeconds) => {
+                if (!totalSeconds && totalSeconds !== 0) return '';
+                totalSeconds = Math.round(totalSeconds);
+                if (totalSeconds < 1) {
+                    return '< 1s';
+                }
+                const hours = Math.floor(totalSeconds / 3600);
+                const minutes = Math.floor((totalSeconds % 3600) / 60);
+                const seconds = totalSeconds % 60;
+                if (totalSeconds < 60) {
+                    return `${seconds}s`;
+                }
+                let parts = [];
+                if (hours > 0) {
+                    parts.push(`${hours}h`);
+                }
+                if (minutes > 0) {
+                    parts.push(`${minutes}m`);
+                }
+                if (hours === 0 && seconds > 0) {
+                    parts.push(`${seconds}s`);
+                }
+                return parts.join(' ');
+            };
+
+            const formatEventDateTime = (dateString, timeOnly = false) => {
+                if (!dateString) return '';
+                const date = new Date(dateString);
+                if (timeOnly) {
+                    return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+                }
+                return date.toLocaleString([], {
+                    weekday: 'short', month: 'short', day: 'numeric',
+                    hour: '2-digit', minute: '2-digit'
+                });
+            };
+
+            // Date helper functions
+            const getDateForSorting = (recording) => {
+                const dateStr = sortBy.value === 'meeting_date'
+                    ? (recording.meeting_date || recording.created_at)
+                    : recording.created_at;
+                return dateStr ? new Date(dateStr) : null;
+            };
+
+            const isToday = (date) => {
+                const today = new Date();
+                return date.getDate() === today.getDate() &&
+                       date.getMonth() === today.getMonth() &&
+                       date.getFullYear() === today.getFullYear();
+            };
+
+            const isYesterday = (date) => {
+                const yesterday = new Date();
+                yesterday.setDate(yesterday.getDate() - 1);
+                return date.getDate() === yesterday.getDate() &&
+                       date.getMonth() === yesterday.getMonth() &&
+                       date.getFullYear() === yesterday.getFullYear();
+            };
+
+            const isThisWeek = (date) => {
+                const now = new Date();
+                const startOfWeek = new Date(now);
+                startOfWeek.setDate(now.getDate() - now.getDay());
+                startOfWeek.setHours(0, 0, 0, 0);
+                const endOfWeek = new Date(startOfWeek);
+                endOfWeek.setDate(startOfWeek.getDate() + 7);
+                return date >= startOfWeek && date < endOfWeek && !isToday(date) && !isYesterday(date);
+            };
+
+            const isLastWeek = (date) => {
+                const now = new Date();
+                const startOfLastWeek = new Date(now);
+                startOfLastWeek.setDate(now.getDate() - now.getDay() - 7);
+                startOfLastWeek.setHours(0, 0, 0, 0);
+                const endOfLastWeek = new Date(startOfLastWeek);
+                endOfLastWeek.setDate(startOfLastWeek.getDate() + 7);
+                return date >= startOfLastWeek && date < endOfLastWeek;
+            };
+
+            const isThisMonth = (date) => {
+                const now = new Date();
+                return date.getMonth() === now.getMonth() &&
+                       date.getFullYear() === now.getFullYear() &&
+                       !isToday(date) && !isYesterday(date) && !isThisWeek(date) && !isLastWeek(date);
+            };
+
+            const isLastMonth = (date) => {
+                const now = new Date();
+                const lastMonth = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+                return date.getMonth() === lastMonth.getMonth() &&
+                       date.getFullYear() === lastMonth.getFullYear();
+            };
+
+            const isSameDay = (date1, date2) => {
+                return date1.getDate() === date2.getDate() &&
+                       date1.getMonth() === date2.getMonth() &&
+                       date1.getFullYear() === date2.getFullYear();
+            };
+
+            // Bundle utilities for composables
+            const utils = {
+                t, tc, setGlobalError, showToast, formatFileSize, formatDisplayDate, formatShortDate,
+                formatStatus, getStatusClass, formatTime, formatDuration, formatEventDateTime,
+                getDateForSorting, isToday, isYesterday, isThisWeek, isLastWeek, isThisMonth, isLastMonth, isSameDay,
+                nextTick,
+                onChatComplete: loadTokenBudget  // Refresh token budget after chat
+            };
+
+            // =========================================================================
+            // COMPUTED PROPERTIES (define before composables that need them)
+            // =========================================================================
+
+            const processedTranscription = computed(() => {
+                if (!selectedRecording.value?.transcription) {
+                    return { hasDialogue: false, content: '', speakers: [], simpleSegments: [], bubbleRows: [], isError: false };
+                }
+
+                const transcription = selectedRecording.value.transcription;
+
+                // Check for error message format
+                const errorInfo = parseTranscriptionError(transcription);
+                if (errorInfo) {
+                    return {
+                        hasDialogue: false,
+                        isJson: false,
+                        isError: true,
+                        error: errorInfo,
+                        content: '',
+                        speakers: [],
+                        simpleSegments: [],
+                        bubbleRows: []
+                    };
+                }
+
+                let transcriptionData;
+
+                try {
+                    transcriptionData = JSON.parse(transcription);
+                } catch (e) {
+                    transcriptionData = null;
+                }
+
+                // Handle new simplified JSON format (array of segments)
+                if (transcriptionData && Array.isArray(transcriptionData)) {
+                    const wasDiarized = transcriptionData.some(segment => segment.speaker);
+
+                    if (!wasDiarized) {
+                        const segments = transcriptionData.map(segment => ({
+                            sentence: segment.sentence,
+                            startTime: segment.start_time,
+                        }));
+                        return {
+                            hasDialogue: false,
+                            isJson: true,
+                            content: segments.map(s => s.sentence).join('\n'),
+                            simpleSegments: segments,
+                            speakers: [],
+                            bubbleRows: []
+                        };
+                    }
+
+                    // Extract unique speakers in order of first appearance
+                    const speakers = [...new Set(transcriptionData.map(segment => segment.speaker).filter(Boolean))];
+
+                    // Build stable color map: assign colors 1, 2, 3... based on order of first appearance
+                    // This map is stored and reused - colors never change once assigned
+                    const speakerColors = {};
+                    speakers.forEach((speaker, index) => {
+                        // Use existing color if already mapped, otherwise assign next color
+                        if (speakerColorMap.value[speaker]) {
+                            speakerColors[speaker] = speakerColorMap.value[speaker];
+                        } else {
+                            const colorIndex = Object.keys(speakerColorMap.value).length;
+                            speakerColors[speaker] = `speaker-color-${(colorIndex % SPEAKER_COLOR_COUNT) + 1}`;
+                            speakerColorMap.value[speaker] = speakerColors[speaker];
+                        }
+                    });
+
+                    const simpleSegments = transcriptionData.map(segment => ({
+                        speakerId: segment.speaker,
+                        speaker: speakerMap.value[segment.speaker]?.name || segment.speaker,
+                        sentence: segment.sentence,
+                        // Use nullish coalescing so a real 0 (recording's first segment)
+                        // is preserved rather than falling through to segment.startTime.
+                        startTime: segment.start_time ?? segment.startTime,
+                        endTime: segment.end_time ?? segment.endTime,
+                        color: speakerColors[segment.speaker] || 'speaker-color-1'
+                    }));
+
+                    const processedSimpleSegments = [];
+                    let lastSpeakerId = null;
+                    simpleSegments.forEach(segment => {
+                        processedSimpleSegments.push({
+                            ...segment,
+                            showSpeaker: segment.speakerId !== lastSpeakerId
+                        });
+                        lastSpeakerId = segment.speakerId;
+                    });
+
+                    const bubbleRows = [];
+                    let lastBubbleSpeakerId = null;
+                    simpleSegments.forEach(segment => {
+                        if (bubbleRows.length === 0 || segment.speakerId !== lastBubbleSpeakerId) {
+                            bubbleRows.push({
+                                speaker: segment.speaker,
+                                color: segment.color,
+                                isMe: segment.speaker && (typeof segment.speaker === 'string') && segment.speaker.toLowerCase().includes('me'),
+                                bubbles: []
+                            });
+                            lastBubbleSpeakerId = segment.speakerId;
+                        }
+                        bubbleRows[bubbleRows.length - 1].bubbles.push({
+                            sentence: segment.sentence,
+                            startTime: segment.startTime || segment.start_time,
+                            color: segment.color
+                        });
+                    });
+
+                    return {
+                        hasDialogue: true,
+                        isJson: true,
+                        segments: simpleSegments,
+                        simpleSegments: processedSimpleSegments,
+                        bubbleRows: bubbleRows,
+                        speakers: speakers.map(speaker => ({
+                            name: speakerMap.value[speaker]?.name || speaker,
+                            color: speakerColors[speaker]
+                        }))
+                    };
+
+                } else {
+                    // Fallback for plain text transcription
+                    const speakerRegex = /\[([^\]]+)\]:\s*/g;
+                    const hasDialogue = speakerRegex.test(transcription);
+
+                    if (!hasDialogue) {
+                        return {
+                            hasDialogue: false,
+                            isJson: false,
+                            content: transcription,
+                            speakers: [],
+                            simpleSegments: [],
+                            bubbleRows: []
+                        };
+                    }
+
+                    speakerRegex.lastIndex = 0;
+                    const speakers = new Set();
+                    let match;
+                    while ((match = speakerRegex.exec(transcription)) !== null) {
+                        speakers.add(match[1]);
+                    }
+
+                    const speakerList = Array.from(speakers);
+                    const speakerColors = {};
+                    speakerList.forEach((speaker) => {
+                        // Use existing color if already mapped, otherwise assign next color
+                        if (speakerColorMap.value[speaker]) {
+                            speakerColors[speaker] = speakerColorMap.value[speaker];
+                        } else {
+                            const colorIndex = Object.keys(speakerColorMap.value).length;
+                            speakerColors[speaker] = `speaker-color-${(colorIndex % SPEAKER_COLOR_COUNT) + 1}`;
+                            speakerColorMap.value[speaker] = speakerColors[speaker];
+                        }
+                    });
+
+                    const segments = [];
+                    const lines = transcription.split('\n');
+                    let currentSpeakerId = null;
+                    let currentText = '';
+
+                    for (const line of lines) {
+                        const speakerMatch = line.match(/^\[([^\]]+)\]:\s*(.*)$/);
+                        if (speakerMatch) {
+                            if (currentSpeakerId && currentText.trim()) {
+                                segments.push({
+                                    speakerId: currentSpeakerId,
+                                    speaker: speakerMap.value[currentSpeakerId]?.name || currentSpeakerId,
+                                    sentence: currentText.trim(),
+                                    color: speakerColors[currentSpeakerId] || 'speaker-color-1'
+                                });
+                            }
+                            currentSpeakerId = speakerMatch[1];
+                            currentText = speakerMatch[2];
+                        } else if (currentSpeakerId && line.trim()) {
+                            currentText += ' ' + line.trim();
+                        } else if (!currentSpeakerId && line.trim()) {
+                            segments.push({
+                                speakerId: null,
+                                speaker: null,
+                                sentence: line.trim(),
+                                color: 'speaker-color-1'
+                            });
+                        }
+                    }
+
+                    if (currentSpeakerId && currentText.trim()) {
+                        segments.push({
+                            speakerId: currentSpeakerId,
+                            speaker: speakerMap.value[currentSpeakerId]?.name || currentSpeakerId,
+                            sentence: currentText.trim(),
+                            color: speakerColors[currentSpeakerId] || 'speaker-color-1'
+                        });
+                    }
+
+                    const simpleSegments = [];
+                    let lastSpeakerId = null;
+                    segments.forEach(segment => {
+                        simpleSegments.push({
+                            ...segment,
+                            showSpeaker: segment.speakerId !== lastSpeakerId,
+                            sentence: segment.sentence || segment.text
+                        });
+                        lastSpeakerId = segment.speakerId;
+                    });
+
+                    const bubbleRows = [];
+                    let currentRow = null;
+                    segments.forEach(segment => {
+                        if (!currentRow || currentRow.speakerId !== segment.speakerId) {
+                            if (currentRow) bubbleRows.push(currentRow);
+                            currentRow = {
+                                speakerId: segment.speakerId,
+                                speaker: segment.speaker,
+                                color: segment.color,
+                                bubbles: [],
+                                isMe: segment.speaker && segment.speaker.toLowerCase().includes('me')
+                            };
+                        }
+                        currentRow.bubbles.push({
+                            sentence: segment.sentence,
+                            color: segment.color
+                        });
+                    });
+                    if (currentRow) bubbleRows.push(currentRow);
+
+                    return {
+                        hasDialogue: true,
+                        isJson: false,
+                        segments: segments,
+                        simpleSegments: simpleSegments,
+                        bubbleRows: bubbleRows,
+                        speakers: speakerList.map(speaker => ({
+                            name: speakerMap.value[speaker]?.name || speaker,
+                            color: speakerColors[speaker] || 'speaker-color-1'
+                        }))
+                    };
+                }
+            });
+
+            // Subtitle computed for fullscreen video overlay
+            const currentSubtitle = computed(() => {
+                const idx = currentPlayingSegmentIndex.value;
+                if (idx === null) return null;
+                const t = processedTranscription.value;
+                if (!t?.simpleSegments?.[idx]) return null;
+                const seg = t.simpleSegments[idx];
+                return {
+                    text: seg.sentence,
+                    speaker: t.hasDialogue ? seg.speaker : null,
+                    color: seg.color
+                };
+            });
+
+            // =========================================================================
+            // INITIALIZE COMPOSABLES (after processedTranscription is defined)
+            // =========================================================================
+            // Create reprocess composable first so it can be passed to recordings
+            const reprocessComposable = useReprocess(state, utils);
+            const recordingsComposable = useRecordings(state, utils, reprocessComposable);
+            const uploadComposable = useUpload(state, utils);
+
+            // Upload disclaimer handlers
+            const acceptUploadDisclaimer = () => {
+                showUploadDisclaimerModal.value = false;
+                // Temporarily clear disclaimer to prevent re-trigger, then call startUpload
+                const saved = uploadDisclaimer.value;
+                uploadDisclaimer.value = '';
+                uploadComposable.startUpload();
+                uploadDisclaimer.value = saved;
+            };
+
+            const cancelUploadDisclaimer = () => {
+                showUploadDisclaimerModal.value = false;
+            };
+
+            // Add startUpload to utils for audio composable to use
+            utils.startUploadQueue = uploadComposable.startUpload;
+
+            const audioComposable = useAudio(state, utils);
+            const uiComposable = useUI(state, utils, processedTranscription);
+            const modalsComposable = useModals(state, utils);
+            const sharingComposable = useSharing(state, utils);
+            const transcriptionComposable = useTranscription(state, utils);
+            const chatComposable = useChat(state, utils);
+            const pwaComposable = usePWA(state, utils);
+            const tagsComposable = useTags({
+                recordings,
+                availableTags,
+                selectedRecording,
+                showEditTagsModal,
+                editingRecording,
+                tagSearchFilter,
+                showToast,
+                setGlobalError
+            });
+
+            // Folders composable
+            const foldersComposable = useFolders({
+                recordings,
+                availableFolders,
+                selectedRecording,
+                showToast,
+                setGlobalError
+            });
+
+            // Bulk selection composable
+            const bulkSelectionComposable = useBulkSelection({
+                selectionMode,
+                selectedRecordingIds,
+                recordings,
+                selectedRecording,
+                currentView
+            });
+
+            // Bulk operations composable (needs selection composable methods)
+            const bulkOperationsComposable = useBulkOperations({
+                selectedRecordingIds,
+                selectedRecordings: bulkSelectionComposable.selectedRecordings,
+                recordings,
+                selectedRecording,
+                bulkActionInProgress,
+                availableTags,
+                availableFolders,
+                showToast,
+                setGlobalError,
+                exitSelectionMode: bulkSelectionComposable.exitSelectionMode,
+                startReprocessingPoll: reprocessComposable.startReprocessingPoll
+            });
+
+            // =========================================================================
+            // VIRTUAL SCROLL SETUP (for performance with long transcriptions)
+            // Must be before speakers composable since it uses scrollToSegmentIndex
+            // =========================================================================
+            // Create a computed ref for the segments array
+            const transcriptSegments = computed(() => processedTranscription.value.simpleSegments || []);
+
+            // Virtual scroll for speaker modal transcript (main performance bottleneck)
+            const speakerModalVirtualScroll = useVirtualScroll({
+                items: transcriptSegments,
+                itemHeight: 52,  // Approximate height of each segment row
+                containerRef: speakerModalTranscriptRef,
+                overscan: 8
+            });
+
+            // Virtual scroll for main transcription panel
+            const mainTranscriptVirtualScroll = useVirtualScroll({
+                items: transcriptSegments,
+                itemHeight: 48,
+                containerRef: mainTranscriptRef,
+                overscan: 5
+            });
+
+            // Virtual scroll for ASR editor modal (uses editingSegments)
+            const asrEditorVirtualScroll = useVirtualScroll({
+                items: editingSegments,
+                itemHeight: 44,  // Table row height
+                containerRef: asrEditorRef,
+                overscan: 10
+            });
+
+            // Helper to scroll to a segment by index (for speaker navigation)
+            const scrollToSegmentIndex = (index) => {
+                if (showSpeakerModal.value) {
+                    speakerModalVirtualScroll.scrollToIndex(index, 'smooth');
+                } else {
+                    mainTranscriptVirtualScroll.scrollToIndex(index, 'smooth');
+                }
+            };
+
+            // Add scrollToSegmentIndex to utils for composables that need it
+            utils.scrollToSegmentIndex = scrollToSegmentIndex;
+            utils.resetModalAudioState = resetModalAudioState;
+            utils.resetAsrEditorScroll = () => asrEditorVirtualScroll.reset();
+            // Scroll to the target row but offset upward so the row lands
+            // comfortably below the sticky table header (~2 rows of clearance)
+            // instead of being clipped at the top.
+            utils.scrollAsrEditorToIndex = (index) => asrEditorVirtualScroll.scrollToIndex(Math.max(0, index - 2), 'auto');
+            utils.setAsrEditorScrollTop = (scrollTop) => {
+                if (asrEditorRef.value) {
+                    asrEditorRef.value.scrollTop = scrollTop;
+                }
+            };
+            utils.resetSpeakerModalScroll = () => speakerModalVirtualScroll.reset();
+            utils.getSpeakerModalVisibleRange = () => speakerModalVirtualScroll.visibleRange.value;
+
+            // Speakers composable needs processedTranscription and scrollToSegmentIndex
+            const speakersComposable = useSpeakers(state, utils, processedTranscription);
+
+            const groupedRecordings = computed(() => {
+                const groups = {};
+                const groupDates = {}; // Track the most recent date in each group
+
+                recordings.value.forEach(recording => {
+                    const date = getDateForSorting(recording);
+                    if (!date) return;
+
+                    let group;
+                    const now = new Date();
+
+                    // Check for future dates first
+                    if (date > now && !isToday(date)) {
+                        group = t('sidebar.upcoming');
+                    } else if (isToday(date)) {
+                        group = t('sidebar.today');
+                    } else if (isYesterday(date)) {
+                        group = t('sidebar.yesterday');
+                    } else if (isThisWeek(date)) {
+                        group = t('sidebar.thisWeek');
+                    } else if (isLastWeek(date)) {
+                        group = t('sidebar.lastWeek');
+                    } else if (isThisMonth(date)) {
+                        group = t('sidebar.thisMonth');
+                    } else if (isLastMonth(date)) {
+                        group = t('sidebar.lastMonth');
+                    } else {
+                        group = t('sidebar.older');
+                    }
+
+                    if (!groups[group]) {
+                        groups[group] = [];
+                        groupDates[group] = date;
+                    }
+                    groups[group].push(recording);
+
+                    // Track the most recent (largest) date in each group
+                    if (date > groupDates[group]) {
+                        groupDates[group] = date;
+                    }
+                });
+
+                // Sort groups by their most recent date (descending - newest first)
+                return Object.entries(groups)
+                    .sort(([a], [b]) => groupDates[b] - groupDates[a])
+                    .map(([title, items]) => ({ title, items }));
+            });
+
+            const filteredAvailableTags = computed(() => {
+                return availableTags.value.filter(tag =>
+                    !selectedTagIds.value.includes(tag.id) &&
+                    (!tagSearchFilter.value || tag.name.toLowerCase().includes(tagSearchFilter.value.toLowerCase()))
+                );
+            });
+
+            // Filtered tags for sidebar filter (searches by name)
+            const filteredTagsForFilter = computed(() => {
+                if (!filterTagSearch.value) return availableTags.value;
+                const search = filterTagSearch.value.toLowerCase();
+                return availableTags.value.filter(tag =>
+                    tag.name.toLowerCase().includes(search)
+                );
+            });
+
+            // Filtered speakers for sidebar filter (searches by name)
+            const filteredSpeakersForFilter = computed(() => {
+                if (!filterSpeakerSearch.value) return availableSpeakers.value;
+                const search = filterSpeakerSearch.value.toLowerCase();
+                return availableSpeakers.value.filter(speaker =>
+                    speaker.name.toLowerCase().includes(search)
+                );
+            });
+
+            const selectedTags = computed(() => {
+                return selectedTagIds.value.map(id =>
+                    availableTags.value.find(t => t.id === id)
+                ).filter(Boolean);
+            });
+
+            const toasts = ref([]);
+
+            // Date preset options for filters
+            const datePresetOptions = computed(() => {
+                return [
+                    { value: 'today', label: t('sidebar.today') },
+                    { value: 'yesterday', label: t('sidebar.yesterday') },
+                    { value: 'thisweek', label: t('sidebar.thisWeek') },
+                    { value: 'lastweek', label: t('sidebar.lastWeek') },
+                    { value: 'thismonth', label: t('sidebar.thisMonth') },
+                    { value: 'lastmonth', label: t('sidebar.lastMonth') }
+                ];
+            });
+
+            // Language options for ASR
+            const languageOptions = computed(() => {
+                return [
+                    { value: '', label: t('form.autoDetect') },
+                    { value: 'en', label: t('languages.en') },
+                    { value: 'es', label: t('languages.es') },
+                    { value: 'fr', label: t('languages.fr') },
+                    { value: 'de', label: t('languages.de') },
+                    { value: 'it', label: t('languages.it') },
+                    { value: 'pt', label: t('languages.pt') },
+                    { value: 'nl', label: t('languages.nl') },
+                    { value: 'ru', label: t('languages.ru') },
+                    { value: 'zh', label: t('languages.zh') },
+                    { value: 'ja', label: t('languages.ja') },
+                    { value: 'ko', label: t('languages.ko') }
+                ];
+            });
+
+            // Recording metadata for sidebar
+            const activeRecordingMetadata = computed(() => {
+                if (!selectedRecording.value) return [];
+
+                const recording = selectedRecording.value;
+                const metadata = [];
+
+                if (recording.created_at) {
+                    // Format duration in human-readable format (e.g., "2m 30s")
+                    const formatProcessingDuration = (seconds) => {
+                        if (!seconds && seconds !== 0) return null;
+                        if (seconds < 60) return `${seconds}s`;
+                        const mins = Math.floor(seconds / 60);
+                        const secs = seconds % 60;
+                        return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+                    };
+
+                    // Build tooltip with processing breakdown
+                    let tooltipParts = [`Processed: ${formatDisplayDate(recording.completed_at || recording.created_at)}`];
+
+                    if (recording.transcription_duration_seconds) {
+                        tooltipParts.push(`Transcription: ${formatProcessingDuration(recording.transcription_duration_seconds)}`);
+                    }
+                    if (recording.summarization_duration_seconds) {
+                        tooltipParts.push(`Summarization: ${formatProcessingDuration(recording.summarization_duration_seconds)}`);
+                    }
+
+                    const tooltipText = tooltipParts.length > 1 ? tooltipParts.join('\n') : null;
+
+                    metadata.push({
+                        icon: 'fas fa-history',
+                        text: formatDisplayDate(recording.created_at),
+                        fullText: tooltipText
+                    });
+                }
+
+                if (recording.file_size) {
+                    metadata.push({
+                        icon: 'fas fa-file-audio',
+                        text: formatFileSize(recording.file_size)
+                    });
+                }
+
+                if (recording.duration) {
+                    metadata.push({
+                        icon: 'fas fa-clock',
+                        text: formatDuration(recording.duration)
+                    });
+                }
+
+                if (recording.original_filename) {
+                    const maxLength = 30;
+                    const truncated = recording.original_filename.length > maxLength
+                        ? recording.original_filename.substring(0, maxLength) + '...'
+                        : recording.original_filename;
+                    metadata.push({
+                        icon: 'fas fa-file',
+                        text: truncated,
+                        fullText: recording.original_filename
+                    });
+                }
+
+                return metadata;
+            });
+
+            // Upload queue computed properties
+            const totalInQueue = computed(() => uploadQueue.value.length);
+            const completedInQueue = computed(() => uploadQueue.value.filter(item => item.status === 'completed' || item.status === 'failed').length);
+            // Filter out upload completions that already have a backend job (to avoid duplicates)
+            const finishedFilesInQueue = computed(() => {
+                const backendRecordingIds = new Set(allJobs.value.map(j => j.recording_id));
+                return uploadQueue.value.filter(item =>
+                    ['completed', 'failed'].includes(item.status) &&
+                    !backendRecordingIds.has(item.recordingId)
+                );
+            });
+            const waitingFilesInQueue = computed(() => uploadQueue.value.filter(item => item.status === 'ready'));
+            const pendingQueueFiles = computed(() => uploadQueue.value.filter(item => item.status === 'queued'));
+
+            // Backend processing queue - recordings being processed on the server
+            const backendProcessingRecordings = computed(() => {
+                return recordings.value.filter(r => ['PENDING', 'PROCESSING', 'SUMMARIZING', 'QUEUED'].includes(r.status));
+            });
+
+            // Job queue polling state
+            let jobQueuePollInterval = null;
+            let lastJobQueueFetch = 0; // Timestamp of last fetch
+            const JOB_QUEUE_POLL_INTERVAL = 5000;  // Poll every 5 seconds when active
+            const JOB_QUEUE_FETCH_DEBOUNCE = 2000; // Minimum 2 seconds between fetches
+
+            // Computed properties for different job states
+            const activeJobs = computed(() => allJobs.value.filter(j => ['queued', 'processing'].includes(j.job_status)));
+            const completedJobs = computed(() => allJobs.value.filter(j => j.job_status === 'completed'));
+            const failedJobs = computed(() => allJobs.value.filter(j => j.job_status === 'failed'));
+
+            // Job queue details map (for backward compatibility with progress popup)
+            const jobQueueDetails = computed(() => {
+                const detailsMap = {};
+                for (const job of allJobs.value) {
+                    // Use recording_id as key, store the most relevant job (prefer active over completed)
+                    if (!detailsMap[job.recording_id] || ['queued', 'processing'].includes(job.job_status)) {
+                        detailsMap[job.recording_id] = job;
+                    }
+                }
+                return detailsMap;
+            });
+
+            // Fetch job queue status from backend (with debounce protection)
+            const fetchJobQueueStatus = async (force = false) => {
+                const now = Date.now();
+                // Debounce: skip if fetched recently (unless forced)
+                if (!force && (now - lastJobQueueFetch) < JOB_QUEUE_FETCH_DEBOUNCE) {
+                    return;
+                }
+                lastJobQueueFetch = now;
+
+                try {
+                    const response = await fetch('/api/recordings/job-queue-status');
+                    if (response.ok) {
+                        const data = await response.json();
+                        allJobs.value = data.jobs || [];
+                    } else if (response.status === 429) {
+                        console.warn('Job queue polling rate limited');
+                    }
+                } catch (error) {
+                    console.error('Error fetching job queue status:', error);
+                }
+            };
+
+            // Start polling job queue status
+            const startJobQueuePolling = () => {
+                if (jobQueuePollInterval) return;
+                fetchJobQueueStatus(true); // Fetch immediately (forced)
+                jobQueuePollInterval = setInterval(() => fetchJobQueueStatus(true), JOB_QUEUE_POLL_INTERVAL);
+            };
+
+            const stopJobQueuePolling = () => {
+                if (jobQueuePollInterval) {
+                    clearInterval(jobQueuePollInterval);
+                    jobQueuePollInterval = null;
+                }
+            };
+
+            // Check if we have active items that need polling
+            const hasActiveProcessing = computed(() => {
+                const completedStatuses = ['completed', 'failed', 'COMPLETED', 'FAILED'];
+                const hasActiveUploads = uploadQueue.value.some(item =>
+                    !completedStatuses.includes(item.status)
+                );
+                const hasActiveJobs = activeJobs.value.length > 0;
+                const hasProcessingRecordings = backendProcessingRecordings.value.length > 0;
+                return hasActiveUploads || hasActiveJobs || hasProcessingRecordings;
+            });
+
+            // Start/stop polling based on whether we have active items
+            watch(hasActiveProcessing, (hasActive) => {
+                if (hasActive) {
+                    startJobQueuePolling();
+                } else {
+                    // Stop polling after a delay (to catch final status updates)
+                    setTimeout(() => {
+                        if (!hasActiveProcessing.value) {
+                            stopJobQueuePolling();
+                        }
+                    }, 10000);
+                }
+            }, { immediate: true });
+
+            // When popup opens, do a one-time fetch to populate it
+            watch(() => progressPopupClosed.value, (closed) => {
+                if (!closed) {
+                    // Popup just opened - fetch current status
+                    fetchJobQueueStatus();
+                }
+            });
+
+            // Track completed recording IDs to detect new completions
+            const completedRecordingIds = new Set();
+
+            // Watch allJobs for completed/failed transitions - update local recordings state
+            watch(allJobs, async (jobs) => {
+                for (const job of jobs) {
+                    if (job.job_status === 'completed' && !completedRecordingIds.has(job.recording_id)) {
+                        completedRecordingIds.add(job.recording_id);
+                        try {
+                            const fullResponse = await fetch(`/api/recordings/${job.recording_id}`);
+                            if (fullResponse.ok) {
+                                const data = await fullResponse.json();
+                                const idx = recordings.value.findIndex(r => r.id === job.recording_id);
+                                if (idx !== -1) {
+                                    recordings.value[idx] = data;
+                                }
+                                if (selectedRecording.value?.id === job.recording_id) {
+                                    selectedRecording.value = data;
+                                }
+                                // Update display name on upload queue item
+                                const queueItem = uploadQueue.value.find(u => u.recordingId === job.recording_id);
+                                if (queueItem) {
+                                    queueItem.displayName = data.title || data.original_filename || queueItem.file?.name;
+                                    queueItem.status = 'completed';
+                                }
+                                // Refresh token budget
+                                if (typeof loadTokenBudget === 'function') loadTokenBudget();
+                            }
+                        } catch (err) {
+                            console.error(`Error fetching completed recording ${job.recording_id}:`, err);
+                        }
+                    } else if (job.job_status === 'failed' && !completedRecordingIds.has(`fail_${job.recording_id}`)) {
+                        completedRecordingIds.add(`fail_${job.recording_id}`);
+                        try {
+                            const failedResponse = await fetch(`/api/recordings/${job.recording_id}`);
+                            if (failedResponse.ok) {
+                                const failedData = await failedResponse.json();
+                                const idx = recordings.value.findIndex(r => r.id === job.recording_id);
+                                if (idx !== -1) {
+                                    recordings.value[idx] = failedData;
+                                }
+                                if (selectedRecording.value?.id === job.recording_id) {
+                                    selectedRecording.value = failedData;
+                                }
+                                const queueItem = uploadQueue.value.find(u => u.recordingId === job.recording_id);
+                                if (queueItem) {
+                                    queueItem.status = 'failed';
+                                    queueItem.error = failedData.error_message || safeT('errors.processingFailedOnServer');
+                                }
+                            }
+                        } catch (err) {
+                            console.error(`Error fetching failed recording ${job.recording_id}:`, err);
+                        }
+                    }
+                }
+            }, { deep: true });
+
+            // Get job details for a recording
+            const getJobDetails = (recordingId) => {
+                return jobQueueDetails.value[recordingId] || null;
+            };
+
+            // Retry a failed job
+            const retryJob = async (jobId) => {
+                try {
+                    const response = await fetch(`/api/recordings/jobs/${jobId}/retry`, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                    if (response.ok) {
+                        fetchJobQueueStatus();
+                        showToast(safeT('messages.jobQueuedForRetry'), 'success');
+                    } else {
+                        const data = await response.json();
+                        showToast(data.error || safeT('messages.failedToRetryJob'), 'error');
+                    }
+                } catch (error) {
+                    console.error('Error retrying job:', error);
+                    showToast(safeT('messages.failedToRetryJob'), 'error');
+                }
+            };
+
+            // Delete/clear a job
+            const deleteJob = async (jobId) => {
+                try {
+                    const response = await fetch(`/api/recordings/jobs/${jobId}`, {
+                        method: 'DELETE'
+                    });
+                    if (response.ok) {
+                        fetchJobQueueStatus();
+                    } else {
+                        const data = await response.json();
+                        showToast(data.error || safeT('messages.failedToDeleteJob'), 'error');
+                    }
+                } catch (error) {
+                    console.error('Error deleting job:', error);
+                }
+            };
+
+            // Clear all completed jobs
+            const clearCompletedJobs = async () => {
+                try {
+                    const response = await fetch('/api/recordings/jobs/clear-completed', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                    if (response.ok) {
+                        // Clear upload queue completed/failed items
+                        uploadQueue.value = uploadQueue.value.filter(item =>
+                            !['completed', 'failed', 'COMPLETED', 'FAILED'].includes(item.status)
+                        );
+                        // Force fetch to update the job list (bypass debounce)
+                        await fetchJobQueueStatus(true);
+                    }
+                } catch (error) {
+                    console.error('Error clearing completed jobs:', error);
+                }
+            };
+
+            // Combined clear function for backward compatibility
+            const clearAllCompleted = () => {
+                clearCompletedJobs();
+            };
+
+            // ============================================
+            // UNIFIED PROGRESS TRACKING SYSTEM
+            // Merges upload queue, backend recordings, and job queue into single list
+            // Each recording appears ONCE with its current status
+            // ============================================
+            const unifiedProgressItems = computed(() => {
+                const items = new Map(); // Key by recordingId or clientId
+
+                // 1. First, add all backend jobs (these have the most accurate status)
+                for (const job of allJobs.value) {
+                    const key = `rec_${job.recording_id}`;
+                    const existing = items.get(key);
+
+                    // Determine unified status from job
+                    let unifiedStatus = 'queued';
+                    if (job.job_status === 'processing') {
+                        unifiedStatus = job.queue_type === 'summary' ? 'summarizing' : 'transcribing';
+                    } else if (job.job_status === 'completed') {
+                        unifiedStatus = 'completed';
+                    } else if (job.job_status === 'failed') {
+                        unifiedStatus = 'failed';
+                    }
+
+                    // Prefer active jobs over completed/failed
+                    if (!existing || ['queued', 'transcribing', 'summarizing'].includes(unifiedStatus)) {
+                        items.set(key, {
+                            id: key,
+                            recordingId: job.recording_id,
+                            jobId: job.id,
+                            clientId: null,
+                            title: job.recording_title || 'Untitled',
+                            status: unifiedStatus,
+                            progress: unifiedStatus === 'transcribing' ? 50 : (unifiedStatus === 'summarizing' ? 80 : null),
+                            progressMessage: unifiedStatus === 'queued' ? `#${job.position || '?'} in queue` :
+                                             unifiedStatus === 'transcribing' ? 'Transcribing audio...' :
+                                             unifiedStatus === 'summarizing' ? 'Generating summary...' :
+                                             unifiedStatus === 'completed' ? 'Done' : 'Failed',
+                            queuePosition: job.position,
+                            errorMessage: job.error_message,
+                            friendlyError: job.error_message ? parseUnformattedError(job.error_message) : null,
+                            completedAt: job.completed_at,
+                            source: 'job'
+                        });
+                    }
+                }
+
+                // 2. Add upload queue items (client-side tracking)
+                for (const upload of uploadQueue.value) {
+                    // If we have a recordingId and it's already tracked from jobs, merge upload info
+                    if (upload.recordingId) {
+                        const key = `rec_${upload.recordingId}`;
+                        const existing = items.get(key);
+
+                        if (existing) {
+                            existing.clientId = upload.clientId;
+                            existing.file = upload.file;
+                            existing.duplicateWarning = upload.duplicateWarning || null;
+                            // If still uploading, override job status with upload status
+                            if (upload.status === 'uploading') {
+                                existing.status = 'uploading';
+                                existing.progress = upload.progress || 0;
+                                existing.progressMessage = 'Uploading...';
+                                existing.title = upload.displayName || upload.file?.name || existing.title;
+                            }
+                            continue;
+                        }
+                    }
+
+                    // Determine unified status from upload status (per-item progress)
+                    let unifiedStatus = 'ready';
+                    let progressVal = upload.progress || 0;
+                    let progressMsg = 'Waiting to upload...';
+
+                    if (upload.status === 'uploading') {
+                        unifiedStatus = 'uploading';
+                        progressMsg = 'Uploading...';
+                    } else if (upload.status === 'pending') {
+                        unifiedStatus = 'queued';
+                        progressVal = 100;
+                        progressMsg = 'Uploaded, waiting for processing...';
+                    } else if (upload.status === 'completed' || upload.status === 'COMPLETED') {
+                        unifiedStatus = 'completed';
+                        progressMsg = 'Done';
+                    } else if (upload.status === 'failed' || upload.status === 'FAILED') {
+                        unifiedStatus = 'upload_failed';
+                        progressMsg = upload.error || 'Upload failed';
+                    } else if (upload.status === 'ready') {
+                        unifiedStatus = 'ready';
+                        progressMsg = 'Waiting to upload...';
+                    } else if (upload.status === 'queued') {
+                        unifiedStatus = 'ready';
+                        progressMsg = 'Waiting to upload...';
+                    }
+
+                    const key = upload.recordingId ? `rec_${upload.recordingId}` : `client_${upload.clientId}`;
+
+                    // Skip if we already have an entry with the same recordingId (from jobs)
+                    if (upload.recordingId && items.has(key)) {
+                        continue;
+                    }
+
+                    items.set(key, {
+                        id: key,
+                        recordingId: upload.recordingId,
+                        jobId: null,
+                        clientId: upload.clientId,
+                        title: upload.displayName || upload.file?.name || 'Unknown file',
+                        status: unifiedStatus,
+                        progress: progressVal,
+                        progressMessage: progressMsg,
+                        queuePosition: null,
+                        errorMessage: upload.status === 'failed' ? upload.error : null,
+                        duplicateWarning: upload.duplicateWarning || null,
+                        file: upload.file,
+                        source: 'upload'
+                    });
+                }
+
+                // Convert to array and sort: active first, then by status priority
+                const statusOrder = {
+                    'uploading': 1,
+                    'transcribing': 2,
+                    'summarizing': 3,
+                    'queued': 4,
+                    'ready': 5,
+                    'completed': 6,
+                    'failed': 7,
+                    'upload_failed': 8
+                };
+
+                return Array.from(items.values()).sort((a, b) => {
+                    return (statusOrder[a.status] || 99) - (statusOrder[b.status] || 99);
+                });
+            });
+
+            // Filtered views of unified items
+            const activeProgressItems = computed(() =>
+                unifiedProgressItems.value.filter(item =>
+                    ['uploading', 'transcribing', 'summarizing', 'queued', 'ready'].includes(item.status)
+                )
+            );
+
+            const completedProgressItems = computed(() =>
+                unifiedProgressItems.value.filter(item => item.status === 'completed')
+            );
+
+            const failedProgressItems = computed(() =>
+                unifiedProgressItems.value.filter(item =>
+                    ['failed', 'upload_failed'].includes(item.status)
+                )
+            );
+
+            // Helper to get status display info
+            const getStatusDisplay = (status) => {
+                const displays = {
+                    'ready': { label: 'Waiting', color: 'gray', icon: 'fa-clock' },
+                    'uploading': { label: 'Uploading', color: 'blue', icon: 'fa-cloud-upload-alt', animate: true },
+                    'queued': { label: 'Queued', color: 'yellow', icon: 'fa-clock' },
+                    'transcribing': { label: 'Transcribing', color: 'purple', icon: 'fa-microphone-alt', animate: true },
+                    'summarizing': { label: 'Summarizing', color: 'green', icon: 'fa-file-alt', animate: true },
+                    'completed': { label: 'Done', color: 'green', icon: 'fa-check-circle' },
+                    'failed': { label: 'Failed', color: 'red', icon: 'fa-exclamation-circle' },
+                    'upload_failed': { label: 'Upload Failed', color: 'red', icon: 'fa-exclamation-circle' }
+                };
+                return displays[status] || displays['ready'];
+            };
+
+            // Cancel/remove an item from the queue
+            const removeProgressItem = async (item) => {
+                if (item.jobId && ['failed', 'completed'].includes(item.status)) {
+                    // Delete backend job
+                    await deleteJob(item.jobId);
+                } else if (item.clientId && !item.jobId) {
+                    // Remove from upload queue
+                    uploadQueue.value = uploadQueue.value.filter(u => u.clientId !== item.clientId);
+                }
+            };
+
+            // Retry a failed item
+            const retryProgressItem = async (item) => {
+                if (item.jobId) {
+                    await retryJob(item.jobId);
+                }
+            };
+
+            // Track recently completed for backward compat (now using allJobs)
+            const recentlyCompletedBackend = computed(() => {
+                return completedJobs.value.map(j => ({
+                    id: j.recording_id,
+                    title: j.recording_title || 'Untitled',
+                    status: 'completed',
+                    completedAt: j.completed_at
+                }));
+            });
+
+            // Combined processing queue count
+            const totalProcessingCount = computed(() => {
+                return activeProgressItems.value.length;
+            });
+
+            // Should show the processing popup
+            const showProcessingPopup = computed(() => {
+                return unifiedProgressItems.value.length > 0;
+            });
+
+            // All completed items count
+            const allCompletedCount = computed(() => {
+                return completedProgressItems.value.length + failedProgressItems.value.length;
+            });
+
+            // Speaker computed properties
+            const hasSpeakerNames = computed(() => {
+                // Check if any speaker has a non-empty name
+                return Object.values(speakerMap.value).some(speakerData =>
+                    speakerData && speakerData.name && speakerData.name.trim() !== ''
+                );
+            });
+
+            // Tags with custom prompts for reprocess modal
+            const tagsWithCustomPrompts = computed(() => {
+                return availableTags.value.filter(tag => tag.custom_prompt && tag.custom_prompt.trim() !== '');
+            });
+
+            // Recording disclaimer parsed as markdown
+            const recordingDisclaimerHtml = computed(() => {
+                if (!recordingDisclaimer.value || recordingDisclaimer.value.trim() === '') {
+                    return '';
+                }
+                return marked.parse(recordingDisclaimer.value);
+            });
+
+            // Upload disclaimer parsed as markdown
+            const uploadDisclaimerHtml = computed(() => {
+                if (!uploadDisclaimer.value || uploadDisclaimer.value.trim() === '') {
+                    return '';
+                }
+                return marked.parse(uploadDisclaimer.value);
+            });
+
+            // Custom banner parsed as markdown
+            const customBannerHtml = computed(() => {
+                if (!customBanner.value || customBanner.value.trim() === '') {
+                    return '';
+                }
+                return marked.parse(customBanner.value);
+            });
+
+            // Get tag prompt preview
+            const getTagPromptPreview = (tagId) => {
+                const tag = availableTags.value.find(t => t.id == tagId);
+                if (tag && tag.custom_prompt) {
+                    // Return first 100 characters of the custom prompt
+                    return tag.custom_prompt.length > 100
+                        ? tag.custom_prompt.substring(0, 100) + '...'
+                        : tag.custom_prompt;
+                }
+                return '';
+            };
+
+            // Duplicates modal
+            const openDuplicatesModal = (duplicateInfo) => {
+                duplicatesModalData.value = duplicateInfo;
+                showDuplicatesModal.value = true;
+            };
+
+            const navigateToDuplicate = (id) => {
+                showDuplicatesModal.value = false;
+                const rec = recordings.value.find(r => r.id === id);
+                // selectRecording always re-fetches full data from the API
+                recordingsComposable.selectRecording(rec || { id });
+            };
+
+            // =========================================================================
+            // WATCHERS
+            // =========================================================================
+            // Watch for search query changes
+            watch(searchQuery, (newQuery) => {
+                recordingsComposable.debouncedSearch(newQuery);
+            });
+
+            // Auto-apply filters when they change
+            watch(filterTags, () => {
+                recordingsComposable.applyAdvancedFilters();
+            }, { deep: true });
+
+            watch(filterSpeakers, () => {
+                recordingsComposable.applyAdvancedFilters();
+            }, { deep: true });
+
+            watch(filterDatePreset, () => {
+                recordingsComposable.applyAdvancedFilters();
+            });
+
+            watch(filterDateRange, () => {
+                recordingsComposable.applyAdvancedFilters();
+            }, { deep: true });
+
+            watch(filterTextQuery, (newValue) => {
+                clearTimeout(searchDebounceTimer.value);
+                searchDebounceTimer.value = setTimeout(() => {
+                    recordingsComposable.applyAdvancedFilters();
+                }, 300);
+            });
+
+            watch(filterStarred, () => {
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            watch(filterInbox, () => {
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            watch(filterFolder, (newValue) => {
+                // Persist folder selection to localStorage
+                if (newValue) {
+                    localStorage.setItem('selectedFolder', newValue);
+                } else {
+                    localStorage.removeItem('selectedFolder');
+                }
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            watch(sortBy, (newValue) => {
+                localStorage.setItem('recordingsSortBy', newValue);
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            watch(showArchivedRecordings, (newValue, oldValue) => {
+                // Prevent unnecessary reloads when being set by the other watcher
+                if (newValue === oldValue) return;
+
+                // Reload recordings when switching between archived/normal view
+                if (showArchivedRecordings.value) {
+                    showSharedWithMe.value = false;  // Can't show both at once
+                }
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            watch(showSharedWithMe, (newValue, oldValue) => {
+                // Prevent unnecessary reloads when being set by the other watcher
+                if (newValue === oldValue) return;
+
+                // Reload recordings when switching to/from shared view
+                if (showSharedWithMe.value) {
+                    showArchivedRecordings.value = false;  // Can't show both at once
+                }
+                recordingsComposable.loadRecordings(1, false, searchQuery.value);
+            });
+
+            // Watch for view changes to initialize recording notes editor
+            watch(currentView, async (newView, oldView) => {
+                if (newView === 'recording') {
+                    // Initialize recording notes editor when entering recording view
+                    await nextTick();
+                    uiComposable.initializeRecordingNotesEditor();
+                } else if (oldView === 'recording') {
+                    // Destroy editor when leaving recording view
+                    uiComposable.destroyRecordingNotesEditor();
+                }
+
+                // Clear incognito data when navigating away from detail view
+                // This ensures incognito data doesn't linger when user goes to upload/recording view
+                if (oldView === 'detail' && newView !== 'detail') {
+                    if (uploadComposable.hasIncognitoRecording()) {
+                        console.log('[Incognito] Clearing data on view change from detail');
+                        sessionStorage.removeItem('speakr_incognito_recording');
+                        incognitoRecording.value = null;
+                    }
+                }
+            });
+
+            // Re-initialize recording notes editor when recording stops (DOM switches from recording template to accordion template)
+            watch(isRecording, async (newVal, oldVal) => {
+                if (oldVal === true && newVal === false && currentView.value === 'recording') {
+                    uiComposable.destroyRecordingNotesEditor();
+                    expandedSection.value = recordingNotes.value ? 'notes' : 'settings';
+                    await nextTick();
+                    uiComposable.initializeRecordingNotesEditor();
+                }
+            });
+
+            // Refresh CodeMirror when notes section becomes visible in accordion
+            watch(expandedSection, async (newSection) => {
+                if (newSection === 'notes' && recordingMarkdownEditorInstance.value) {
+                    await nextTick();
+                    recordingMarkdownEditorInstance.value.codemirror.refresh();
+                }
+            });
+
+            // Watch for mobile tab changes to reinitialize editors if still in edit mode
+            watch(mobileTab, async (newTab) => {
+                // Wait for DOM to update
+                await nextTick();
+
+                // If switching to summary tab and still in edit mode, reinitialize editor
+                if (newTab === 'summary' && editingSummary.value) {
+                    uiComposable.initializeSummaryMarkdownEditor();
+                }
+
+                // If switching to notes tab and still in edit mode, reinitialize editor
+                if (newTab === 'notes' && editingNotes.value) {
+                    uiComposable.initializeMarkdownEditor();
+                }
+            });
+
+            // Watch for desktop tab changes to reinitialize editors if still in edit mode
+            watch(selectedTab, async (newTab) => {
+                // Wait for DOM to update
+                await nextTick();
+
+                // If switching to summary tab and still in edit mode, reinitialize editor
+                if (newTab === 'summary' && editingSummary.value) {
+                    uiComposable.initializeSummaryMarkdownEditor();
+                }
+
+                // If switching to notes tab and still in edit mode, reinitialize editor
+                if (newTab === 'notes' && editingNotes.value) {
+                    uiComposable.initializeMarkdownEditor();
+                }
+            });
+
+            // Watch for selectedRecording changes to reset chat
+            watch(selectedRecording, (newRecording, oldRecording) => {
+                // Only clear if we're actually switching to a different recording
+                if (oldRecording && newRecording && oldRecording.id !== newRecording.id) {
+                    chatMessages.value = [];
+                    chatInput.value = '';
+                }
+            });
+
+            // =========================================================================
+            // LIFECYCLE
+            // =========================================================================
+            onMounted(async () => {
+                // Get config from data attributes
+                const appElement = document.getElementById('app');
+                if (appElement) {
+                    useAsrEndpoint.value = appElement.dataset.useAsrEndpoint === 'True';
+                    connectorSupportsDiarization.value = appElement.dataset.connectorSupportsDiarization === 'True';
+                    connectorSupportsSpeakerCount.value = appElement.dataset.connectorSupportsSpeakerCount === 'True';
+                    connectorSupportsHotwords.value = appElement.dataset.connectorSupportsHotwords === 'True';
+                    connectorSupportsInitialPrompt.value = appElement.dataset.connectorSupportsInitialPrompt === 'True';
+                    showTimestampsSimpleView.value = appElement.dataset.showTimestampsSimpleView === 'True';
+                    editorAutosave.value = appElement.dataset.editorAutosave === 'True';
+                    currentUserName.value = appElement.dataset.currentUserName || '';
+                }
+
+                // Initialize UI
+                uiComposable.initializeDarkMode();
+                uiComposable.initializeColorScheme();
+                uiComposable.initializeSidebar();
+
+                // Check for recoverable recording from IndexedDB
+                try {
+                    const recoverable = await audioComposable.checkForRecoverableRecording();
+                    if (recoverable && recoverable.chunks && recoverable.chunks.length > 0) {
+                        recoverableRecording.value = recoverable;
+                        showRecoveryModal.value = true;
+                        console.log('[App] Found recoverable recording, showing recovery dialog');
+                    }
+                } catch (error) {
+                    console.error('[App] Failed to check for recoverable recording:', error);
+                }
+
+                // Load initial data
+                await Promise.all([
+                    recordingsComposable.loadRecordings(),
+                    recordingsComposable.loadTags(),
+                    recordingsComposable.loadFolders(),
+                    recordingsComposable.loadSpeakers(),
+                    loadTokenBudget()
+                ]);
+
+                // Clean up orphaned incognito data if we're not viewing incognito recording
+                // This can happen if user navigated away without the cleanup triggering
+                if (uploadComposable.hasIncognitoRecording() && selectedRecording.value?.id !== 'incognito') {
+                    console.log('[App] Cleaning up orphaned incognito data from sessionStorage');
+                    sessionStorage.removeItem('speakr_incognito_recording');
+                    incognitoRecording.value = null;
+                }
+
+                // Load config
+                try {
+                    const response = await fetch('/api/config');
+                    if (response.ok) {
+                        const config = await response.json();
+                        maxFileSizeMB.value = config.max_file_size_mb || 250;
+                        chunkingEnabled.value = config.chunking_enabled !== false;
+                        chunkingMode.value = config.chunking_mode || 'size';
+                        chunkingLimit.value = config.chunking_limit || 20;
+                        recordingDisclaimer.value = config.recording_disclaimer || '';
+                        uploadDisclaimer.value = config.upload_disclaimer || '';
+                        customBanner.value = config.custom_banner || '';
+                        canDeleteRecordings.value = config.can_delete_recordings !== false;
+                        enableInternalSharing.value = config.enable_internal_sharing === true;
+                        enableArchiveToggle.value = config.enable_archive_toggle === true;
+                        showUsernamesInUI.value = config.show_usernames_in_ui === true;
+                        enableIncognitoMode.value = config.enable_incognito_mode === true;
+                        foldersEnabled.value = config.enable_folders === true;
+                        maxConcurrentUploads.value = config.max_concurrent_uploads || 3;
+
+                        // Per-upload transcription model dropdown options
+                        // (issue #266). Only set when admin configured at least
+                        // one model in TRANSCRIPTION_MODELS_AVAILABLE.
+                        transcriptionModelOptions.value = Array.isArray(config.transcription_model_options)
+                            ? config.transcription_model_options
+                            : [];
+
+                        // Set user's default transcription language for upload and reprocess forms
+                        if (config.user_transcription_language) {
+                            userTranscriptionLanguage.value = config.user_transcription_language;
+                            uploadLanguage.value = config.user_transcription_language;
+                        }
+
+                        // Capture the user's personal summary prompt and the
+                        // site-wide admin default so the upload form can scan
+                        // them for `{{variable}}` placeholders when no tag /
+                        // folder prompt is active.
+                        userSummaryPrompt.value = config.user_summary_prompt || '';
+                        adminDefaultSummaryPrompt.value = config.admin_default_summary_prompt || '';
+
+                        // Restore saved folder selection from localStorage
+                        if (foldersEnabled.value) {
+                            const savedFolder = localStorage.getItem('selectedFolder');
+                            if (savedFolder) {
+                                filterFolder.value = savedFolder;
+                            }
+                        }
+
+                        // Set default incognito mode state if feature enabled and default is true
+                        if (config.enable_incognito_mode && config.incognito_mode_default) {
+                            incognitoMode.value = true;
+                        }
+                    }
+                } catch (error) {
+                    console.error('Failed to load config:', error);
+                }
+
+                // Initialize UI settings from localStorage
+                uiComposable.initializeUI();
+
+                // Load incognito recording from sessionStorage if exists (only if feature is enabled)
+                if (enableIncognitoMode.value) {
+                    uploadComposable.loadIncognitoRecording();
+                }
+
+                // Initialize audio capabilities
+                await audioComposable.initializeAudio();
+
+                // Initialize PWA features
+                pwaComposable.initPWA();
+
+                // Show app - hide loader and show main content
+                const loader = document.getElementById('loader');
+                const appEl = document.getElementById('app');
+                if (loader) {
+                    loader.style.opacity = '0';
+                    setTimeout(() => {
+                        loader.style.display = 'none';
+                    }, 500);
+                }
+                if (appEl) {
+                    appEl.style.opacity = '1';
+                    appEl.classList.remove('opacity-0');
+                }
+
+                // Also hide AppLoader overlay if it exists
+                if (window.AppLoader) {
+                    window.AppLoader.hide();
+                }
+
+                // Window resize handler
+                window.addEventListener('resize', () => {
+                    windowWidth.value = window.innerWidth;
+                });
+
+                // Visibility change handler for wake lock
+                document.addEventListener('visibilitychange', audioComposable.handleVisibilityChange);
+
+                // Prevent data loss on tab close/refresh during recording or incognito mode
+                window.addEventListener('beforeunload', (e) => {
+                    // Check for unsaved recording
+                    if (audioComposable.hasUnsavedRecording()) {
+                        e.preventDefault();
+                        e.returnValue = ''; // Chrome requires this
+                        return 'You have an unsaved recording. Are you sure you want to leave?';
+                    }
+                    // Check for incognito recording that would be lost
+                    // Only warn if we're currently viewing the incognito recording
+                    // (if user navigated away, they've implicitly abandoned it or already been warned)
+                    if (uploadComposable.hasIncognitoRecording() && selectedRecording.value?.id === 'incognito') {
+                        e.preventDefault();
+                        e.returnValue = ''; // Chrome requires this
+                        return 'You have an incognito recording that will be lost. Are you sure you want to leave?';
+                    }
+                });
+
+                // Initialize bulk selection keyboard listeners
+                bulkSelectionComposable.initSelectionKeyboardListeners();
+            });
+
+            // =========================================================================
+            // RECORDING RECOVERY FUNCTIONS
+            // =========================================================================
+
+            const recoverRecording = async () => {
+                try {
+                    showRecoveryModal.value = false;
+
+                    const recovered = await audioComposable.recoverRecordingFromDB();
+                    if (recovered) {
+                        currentView.value = 'recording';
+                        showToast(safeT('messages.recordingRecovered'), 'success');
+                    } else {
+                        showToast(safeT('messages.failedToRecoverRecording'), 'error');
+                    }
+
+                    recoverableRecording.value = null;
+                } catch (error) {
+                    console.error('[App] Failed to recover recording:', error);
+                    showToast(safeT('messages.errorRecoveringRecording'), 'error');
+                }
+            };
+
+            const cancelRecovery = async () => {
+                try {
+                    showRecoveryModal.value = false;
+
+                    // Clear the recording from IndexedDB
+                    await audioComposable.clearRecordingSession();
+
+                    showToast(safeT('messages.recordingDiscarded'), 'info');
+                    recoverableRecording.value = null;
+                } catch (error) {
+                    console.error('[App] Failed to discard recording:', error);
+                }
+            };
+
+            const formatRecordingMode = (mode) => {
+                const modes = {
+                    'microphone': t('recording.modeMicrophone'),
+                    'system': t('recording.modeSystem'),
+                    'both': t('recording.modeBoth')
+                };
+                return modes[mode] || mode;
+            };
+
+            // =========================================================================
+            // WATCHERS
+            // =========================================================================
+
+            // Update badge count when recordings change
+            watch(recordings, (newRecordings) => {
+                if (newRecordings && Array.isArray(newRecordings)) {
+                    pwaComposable.updateBadgeCount(newRecordings);
+                }
+            });
+
+            // =========================================================================
+            // RETURN ALL STATE AND METHODS
+            // =========================================================================
+            return {
+                // Translation
+                t, tc,
+
+                // State
+                ...state,
+
+                // Computed
+                isMobileScreen,
+                isMobileDevice,
+                processedTranscription,
+                groupedRecordings,
+                filteredAvailableTags,
+                filteredTagsForFilter,
+                filteredSpeakersForFilter,
+                selectedTags,
+                colorSchemes,
+                dropdownPositions,
+                toasts,
+                datePresetOptions,
+                languageOptions,
+                activeRecordingMetadata,
+                totalInQueue,
+                completedInQueue,
+                finishedFilesInQueue,
+                waitingFilesInQueue,
+                pendingQueueFiles,
+                backendProcessingRecordings,
+                totalProcessingCount,
+                showProcessingPopup,
+                jobQueueDetails,
+                getJobDetails,
+                allJobs,
+                activeJobs,
+                completedJobs,
+                failedJobs,
+                retryJob,
+                deleteJob,
+                clearCompletedJobs,
+                recentlyCompletedBackend,
+                clearAllCompleted,
+                allCompletedCount,
+                // Unified progress tracking
+                unifiedProgressItems,
+                activeProgressItems,
+                completedProgressItems,
+                failedProgressItems,
+                getStatusDisplay,
+                removeProgressItem,
+                retryProgressItem,
+                hasSpeakerNames,
+                showDuplicatesModal,
+                videoCollapsed,
+                videoFullscreen,
+                fullscreenControlsVisible,
+                currentSubtitle,
+                duplicatesModalData,
+                openDuplicatesModal,
+                navigateToDuplicate,
+                tagsWithCustomPrompts,
+                recordingDisclaimerHtml,
+                uploadDisclaimerHtml,
+                customBannerHtml,
+                acceptUploadDisclaimer,
+                cancelUploadDisclaimer,
+                getTagPromptPreview,
+
+                // Utilities
+                formatFileSize,
+                formatDisplayDate,
+                formatShortDate,
+                formatStatus,
+                getStatusClass,
+                formatTime,
+                formatDuration,
+                formatEventDateTime,
+                formatDateTime: formatEventDateTime, // Alias for recovery modal
+                setGlobalError,
+                showToast,
+                loadTokenBudget,
+                getContrastTextColor,
+                getBubbleGlobalIndex,
+                formatRecordingMode,
+
+                // Modal audio (independent from main player)
+                modalAudioCurrentTime,
+                modalAudioDuration,
+                modalAudioIsPlaying,
+                modalAudioProgressPercent,
+                handleModalAudioTimeUpdate,
+                handleModalAudioLoadedMetadata,
+                handleModalAudioPlayPause,
+                resetModalAudioState,
+
+                // Virtual scroll
+                speakerModalTranscriptRef,
+                mainTranscriptRef,
+                asrEditorRef,
+                asrEditorSaveFlash,
+                speakerModalVisibleSegments: speakerModalVirtualScroll.visibleItems,
+                speakerModalSpacerBefore: speakerModalVirtualScroll.spacerBefore,
+                speakerModalSpacerAfter: speakerModalVirtualScroll.spacerAfter,
+                onSpeakerModalScroll: speakerModalVirtualScroll.onScroll,
+                mainTranscriptVisibleSegments: mainTranscriptVirtualScroll.visibleItems,
+                mainTranscriptSpacerBefore: mainTranscriptVirtualScroll.spacerBefore,
+                mainTranscriptSpacerAfter: mainTranscriptVirtualScroll.spacerAfter,
+                onMainTranscriptScroll: mainTranscriptVirtualScroll.onScroll,
+                asrEditorVisibleSegments: asrEditorVirtualScroll.visibleItems,
+                asrEditorSpacerBefore: asrEditorVirtualScroll.spacerBefore,
+                asrEditorSpacerAfter: asrEditorVirtualScroll.spacerAfter,
+                onAsrEditorScroll: asrEditorVirtualScroll.onScroll,
+                scrollToSegmentIndex,
+                getVirtualItemKey,
+
+                // Recording recovery
+                showRecoveryModal,
+                recoverableRecording,
+                recoverRecording,
+                cancelRecovery,
+
+                // Composable methods
+                ...recordingsComposable,
+                ...uploadComposable,
+                ...audioComposable,
+                ...uiComposable,
+                ...modalsComposable,
+                ...sharingComposable,
+                ...reprocessComposable,
+                ...transcriptionComposable,
+                ...speakersComposable,
+                ...chatComposable,
+                ...tagsComposable,
+                ...foldersComposable,
+                ...pwaComposable,
+                ...bulkSelectionComposable,
+                ...bulkOperationsComposable
+            };
+        },
+        delimiters: ['${', '}']
+    });
+
+    app.config.globalProperties.t = safeT;
+    app.config.globalProperties.tc = (key, count, params = {}) => {
+        if (!window.i18n || !window.i18n.tc) {
+            return key;
+        }
+        return window.i18n.tc(key, count, params);
+    };
+
+    app.provide('t', safeT);
+    app.provide('tc', (key, count, params = {}) => {
+        if (!window.i18n || !window.i18n.tc) {
+            return key;
+        }
+        return window.i18n.tc(key, count, params);
+    });
+
+    app.mount('#app');
+});
diff --git a/static/js/composables/index.js b/static/js/composables/index.js
new file mode 100644
index 00000000..d18b2769
--- /dev/null
+++ b/static/js/composables/index.js
@@ -0,0 +1,17 @@
+/**
+ * Composables index - export all composables for easy importing
+ *
+ * Usage (with ES modules/build system):
+ * import { useRecordings, useUpload, useUI } from './composables';
+ */
+
+export { usePagination } from './usePagination.js';
+export { useUI } from './useUI.js';
+export { useFilters } from './useFilters.js';
+export { usePlayer } from './usePlayer.js';
+export { useSharing } from './useSharing.js';
+export { useTranscript } from './useTranscript.js';
+export { useChat } from './useChat.js';
+export { useAudioRecorder } from './useAudioRecorder.js';
+export { useUpload } from './useUpload.js';
+export { useRecordings } from './useRecordings.js';
diff --git a/static/js/composables/useAudioRecorder.js b/static/js/composables/useAudioRecorder.js
new file mode 100644
index 00000000..fa35d700
--- /dev/null
+++ b/static/js/composables/useAudioRecorder.js
@@ -0,0 +1,217 @@
+/**
+ * Audio Recorder composable
+ * Handles audio recording from microphone and/or system audio
+ */
+
+import { ref, computed } from 'vue';
+
+export function useAudioRecorder() {
+    // State
+    const isRecording = ref(false);
+    const isPaused = ref(false);
+    const audioChunks = ref([]);
+    const audioBlobURL = ref(null);
+    const recordingMode = ref('microphone');
+    const mediaRecorder = ref(null);
+    const audioContext = ref(null);
+    const activeStreams = ref([]);
+    const recordingDuration = ref(0);
+    const recordingSize = ref(0);
+    const actualBitrate = ref(128000);
+    const recordingTimer = ref(null);
+    const recordingNotes = ref('');
+    const showRecordingDisclaimerModal = ref(false);
+    const pendingRecordingMode = ref(null);
+    const recordingDisclaimer = ref('');
+
+    // Computed
+    const canRecordAudio = computed(() => navigator.mediaDevices && navigator.mediaDevices.getUserMedia);
+    const canRecordSystemAudio = computed(() => navigator.mediaDevices && navigator.mediaDevices.getDisplayMedia);
+
+    const recordingTimeFormatted = computed(() => {
+        const hours = Math.floor(recordingDuration.value / 3600);
+        const mins = Math.floor((recordingDuration.value % 3600) / 60);
+        const secs = recordingDuration.value % 60;
+        if (hours > 0) {
+            return hours + ':' + String(mins).padStart(2, '0') + ':' + String(secs).padStart(2, '0');
+        }
+        return mins + ':' + String(secs).padStart(2, '0');
+    });
+
+    // Methods
+    const startRecording = async (mode = 'microphone') => {
+        if (recordingDisclaimer.value && recordingDisclaimer.value.trim()) {
+            pendingRecordingMode.value = mode;
+            showRecordingDisclaimerModal.value = true;
+            return;
+        }
+        await startRecordingActual(mode);
+    };
+
+    const acceptDisclaimer = async () => {
+        showRecordingDisclaimerModal.value = false;
+        if (pendingRecordingMode.value) {
+            await startRecordingActual(pendingRecordingMode.value);
+            pendingRecordingMode.value = null;
+        }
+    };
+
+    const cancelDisclaimer = () => {
+        showRecordingDisclaimerModal.value = false;
+        pendingRecordingMode.value = null;
+    };
+
+    const startRecordingActual = async (mode = 'microphone') => {
+        recordingMode.value = mode;
+        audioChunks.value = [];
+        audioBlobURL.value = null;
+        recordingNotes.value = '';
+        activeStreams.value = [];
+        recordingDuration.value = 0;
+        recordingSize.value = 0;
+
+        try {
+            let combinedStream = null;
+            let micStream = null;
+            let systemStream = null;
+
+            if (mode === 'microphone' || mode === 'both') {
+                if (!canRecordAudio.value) throw new Error('Microphone not supported');
+                micStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+                activeStreams.value.push(micStream);
+            }
+
+            if (mode === 'system' || mode === 'both') {
+                if (!canRecordSystemAudio.value) throw new Error('System audio not supported');
+                try {
+                    systemStream = await navigator.mediaDevices.getDisplayMedia({ audio: true, video: true });
+                    if (systemStream.getAudioTracks().length === 0) {
+                        systemStream.getVideoTracks().forEach(track => track.stop());
+                        throw new Error('System audio permission not granted');
+                    }
+                    activeStreams.value.push(systemStream);
+                } catch (err) {
+                    if (mode === 'system') throw err;
+                    systemStream = null;
+                }
+            }
+
+            // Combine streams
+            if (micStream && systemStream) {
+                audioContext.value = new (window.AudioContext || window.webkitAudioContext)();
+                const micSource = audioContext.value.createMediaStreamSource(micStream);
+                const systemSource = audioContext.value.createMediaStreamSource(systemStream);
+                const destination = audioContext.value.createMediaStreamDestination();
+                micSource.connect(destination);
+                systemSource.connect(destination);
+                combinedStream = new MediaStream([destination.stream.getAudioTracks()[0]]);
+            } else if (systemStream) {
+                combinedStream = new MediaStream(systemStream.getAudioTracks());
+            } else if (micStream) {
+                combinedStream = micStream;
+            }
+
+            if (!combinedStream) throw new Error('No audio streams available');
+
+            // Create MediaRecorder
+            const options = { mimeType: 'audio/webm;codecs=opus', audioBitsPerSecond: 32000 };
+            if (MediaRecorder.isTypeSupported(options.mimeType)) {
+                mediaRecorder.value = new MediaRecorder(combinedStream, options);
+                actualBitrate.value = 32000;
+            } else {
+                mediaRecorder.value = new MediaRecorder(combinedStream);
+                actualBitrate.value = 128000;
+            }
+
+            mediaRecorder.value.ondataavailable = (event) => {
+                if (event.data && event.data.size > 0) {
+                    audioChunks.value.push(event.data);
+                    recordingSize.value += event.data.size;
+                }
+            };
+
+            mediaRecorder.value.onstop = () => {
+                const audioBlob = new Blob(audioChunks.value, { type: mediaRecorder.value.mimeType });
+                audioBlobURL.value = URL.createObjectURL(audioBlob);
+            };
+
+            mediaRecorder.value.start(1000);
+            isRecording.value = true;
+
+            recordingTimer.value = setInterval(() => {
+                recordingDuration.value++;
+            }, 1000);
+
+        } catch (error) {
+            stopAllStreams();
+            throw error;
+        }
+    };
+
+    const stopRecording = () => {
+        if (mediaRecorder.value && isRecording.value) {
+            mediaRecorder.value.stop();
+            isRecording.value = false;
+            isPaused.value = false;
+
+            if (recordingTimer.value) {
+                clearInterval(recordingTimer.value);
+                recordingTimer.value = null;
+            }
+            stopAllStreams();
+        }
+    };
+
+    const pauseRecording = () => {
+        if (mediaRecorder.value && isRecording.value && !isPaused.value) {
+            mediaRecorder.value.pause();
+            isPaused.value = true;
+            if (recordingTimer.value) {
+                clearInterval(recordingTimer.value);
+                recordingTimer.value = null;
+            }
+        }
+    };
+
+    const resumeRecording = () => {
+        if (mediaRecorder.value && isRecording.value && isPaused.value) {
+            mediaRecorder.value.resume();
+            isPaused.value = false;
+            recordingTimer.value = setInterval(() => {
+                recordingDuration.value++;
+            }, 1000);
+        }
+    };
+
+    const stopAllStreams = () => {
+        activeStreams.value.forEach(stream => {
+            stream.getTracks().forEach(track => track.stop());
+        });
+        activeStreams.value = [];
+
+        if (audioContext.value) {
+            audioContext.value.close().catch(e => console.error("Error closing AudioContext:", e));
+            audioContext.value = null;
+        }
+    };
+
+    const resetRecording = () => {
+        stopRecording();
+        audioChunks.value = [];
+        audioBlobURL.value = null;
+        recordingDuration.value = 0;
+        recordingSize.value = 0;
+        recordingNotes.value = '';
+    };
+
+    const getRecordingBlob = () => {
+        if (audioChunks.value.length === 0) return null;
+        return new Blob(audioChunks.value, { type: 'audio/webm' });
+    };
+
+    return {
+        isRecording, isPaused, audioBlobURL, recordingMode, recordingDuration, recordingSize, recordingNotes,
+        showRecordingDisclaimerModal, recordingDisclaimer, canRecordAudio, canRecordSystemAudio, recordingTimeFormatted,
+        startRecording, stopRecording, pauseRecording, resumeRecording, resetRecording, acceptDisclaimer, cancelDisclaimer, getRecordingBlob
+    };
+}
diff --git a/static/js/composables/useChat.js b/static/js/composables/useChat.js
new file mode 100644
index 00000000..fcfe3aa6
--- /dev/null
+++ b/static/js/composables/useChat.js
@@ -0,0 +1,234 @@
+/**
+ * Chat composable
+ * Handles chat/inquire functionality with streaming responses
+ */
+
+import { ref, reactive, nextTick } from 'vue';
+
+export function useChat() {
+    // State
+    const chatMessages = ref([]);
+    const chatInput = ref('');
+    const isChatLoading = ref(false);
+    const chatMessagesRef = ref(null);
+    const isChatExpanded = ref(false);
+
+    // Methods
+    const isChatScrolledToBottom = () => {
+        if (!chatMessagesRef.value) return true;
+        const { scrollTop, scrollHeight, clientHeight } = chatMessagesRef.value;
+        const scrollableHeight = scrollHeight - clientHeight;
+        if (scrollableHeight <= 0) return true;
+        const scrollPercentage = scrollTop / scrollableHeight;
+        return scrollPercentage >= 0.95; // Within bottom 5%
+    };
+
+    const scrollChatToBottom = () => {
+        if (chatMessagesRef.value) {
+            requestAnimationFrame(() => {
+                if (chatMessagesRef.value) {
+                    chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
+                }
+            });
+        }
+    };
+
+    const sendMessage = async (recordingId) => {
+        if (!chatInput.value.trim() || isChatLoading.value) {
+            return;
+        }
+
+        const message = chatInput.value.trim();
+
+        if (!Array.isArray(chatMessages.value)) {
+            chatMessages.value = [];
+        }
+
+        chatMessages.value.push({ role: 'user', content: message });
+        chatInput.value = '';
+        isChatLoading.value = true;
+
+        await nextTick();
+        scrollChatToBottom();
+
+        let assistantMessage = null;
+
+        try {
+            const messageHistory = chatMessages.value
+                .slice(0, -1)
+                .map(msg => ({ role: msg.role, content: msg.content }));
+
+            const response = await fetch('/chat', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    recording_id: recordingId,
+                    message: message,
+                    message_history: messageHistory
+                })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to get chat response');
+            }
+
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+
+            const processStream = async () => {
+                let isFirstChunk = true;
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) break;
+
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split('\n');
+                    buffer = lines.pop();
+
+                    for (const line of lines) {
+                        if (line.startsWith('data: ')) {
+                            const jsonStr = line.substring(6);
+                            if (jsonStr) {
+                                try {
+                                    const data = JSON.parse(jsonStr);
+
+                                    if (data.thinking) {
+                                        const shouldScroll = isChatScrolledToBottom();
+
+                                        if (isFirstChunk) {
+                                            isChatLoading.value = false;
+                                            assistantMessage = reactive({
+                                                role: 'assistant',
+                                                content: '',
+                                                html: '',
+                                                thinking: data.thinking,
+                                                thinkingExpanded: false
+                                            });
+                                            chatMessages.value.push(assistantMessage);
+                                            isFirstChunk = false;
+                                        } else if (assistantMessage) {
+                                            if (assistantMessage.thinking) {
+                                                assistantMessage.thinking += '\n\n' + data.thinking;
+                                            } else {
+                                                assistantMessage.thinking = data.thinking;
+                                            }
+                                        }
+
+                                        if (shouldScroll) {
+                                            await nextTick();
+                                            scrollChatToBottom();
+                                        }
+                                    }
+
+                                    if (data.delta) {
+                                        const shouldScroll = isChatScrolledToBottom();
+
+                                        if (isFirstChunk) {
+                                            isChatLoading.value = false;
+                                            assistantMessage = reactive({
+                                                role: 'assistant',
+                                                content: '',
+                                                html: '',
+                                                thinking: '',
+                                                thinkingExpanded: false
+                                            });
+                                            chatMessages.value.push(assistantMessage);
+                                            isFirstChunk = false;
+                                        }
+
+                                        assistantMessage.content += data.delta;
+                                        if (window.marked) {
+                                            assistantMessage.html = window.marked.parse(assistantMessage.content);
+                                        } else {
+                                            assistantMessage.html = assistantMessage.content;
+                                        }
+
+                                        if (shouldScroll) {
+                                            await nextTick();
+                                            scrollChatToBottom();
+                                        }
+                                    }
+
+                                    if (data.end_of_stream) {
+                                        return;
+                                    }
+
+                                    if (data.error) {
+                                        throw new Error(data.error);
+                                    }
+                                } catch (e) {
+                                    console.error('Error parsing stream data:', e);
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            await processStream();
+
+        } catch (error) {
+            console.error('Chat Error:', error);
+            if (assistantMessage) {
+                assistantMessage.content = `Error: ${error.message}`;
+                assistantMessage.html = `<span class="text-red-500">Error: ${error.message}</span>`;
+            } else {
+                chatMessages.value.push({
+                    role: 'assistant',
+                    content: `Error: ${error.message}`,
+                    html: `<span class="text-red-500">Error: ${error.message}</span>`
+                });
+            }
+        } finally {
+            isChatLoading.value = false;
+            await nextTick();
+            if (isChatScrolledToBottom()) {
+                scrollChatToBottom();
+            }
+        }
+    };
+
+    const clearChat = () => {
+        chatMessages.value = [];
+        chatInput.value = '';
+        isChatLoading.value = false;
+    };
+
+    const toggleThinking = (message) => {
+        if (message.thinking) {
+            message.thinkingExpanded = !message.thinkingExpanded;
+        }
+    };
+
+    const setChatRef = (el) => {
+        chatMessagesRef.value = el;
+    };
+
+    const handleChatInput = (event) => {
+        if (event.key === 'Enter' && !event.shiftKey) {
+            event.preventDefault();
+            // Trigger send message (caller should provide recordingId)
+            return true;
+        }
+        return false;
+    };
+
+    return {
+        // State
+        chatMessages,
+        chatInput,
+        isChatLoading,
+        chatMessagesRef,
+        isChatExpanded,
+
+        // Methods
+        sendMessage,
+        clearChat,
+        toggleThinking,
+        setChatRef,
+        scrollChatToBottom,
+        handleChatInput
+    };
+}
diff --git a/static/js/composables/useFilters.js b/static/js/composables/useFilters.js
new file mode 100644
index 00000000..35fedc05
--- /dev/null
+++ b/static/js/composables/useFilters.js
@@ -0,0 +1,128 @@
+/**
+ * Filters composable
+ * Handles search, filtering, and sorting functionality
+ */
+
+import { ref, computed } from 'vue';
+import { parseDateRange } from '../utils/dateUtils.js';
+
+export function useFilters() {
+    // State
+    const searchQuery = ref('');
+    const showAdvancedFilters = ref(false);
+    const filterTags = ref([]);
+    const filterFolder = ref('');  // '' = all, 'none' = no folder, or folder id
+    const filterDateRange = ref({ start: '', end: '' });
+    const filterDatePreset = ref('');
+    const filterTextQuery = ref('');
+    const showArchivedRecordings = ref(false);
+    const showSharedWithMe = ref(false);
+    const sortBy = ref('created_at');
+    const selectedTagFilter = ref(null);
+    const searchDebounceTimer = ref(null);
+
+    // Methods
+    const toggleAdvancedFilters = () => {
+        showAdvancedFilters.value = !showAdvancedFilters.value;
+    };
+
+    const setDatePreset = (preset) => {
+        filterDatePreset.value = preset;
+        const range = parseDateRange(preset);
+        filterDateRange.value = {
+            start: range.start ? range.start.toISOString().split('T')[0] : '',
+            end: range.end ? range.end.toISOString().split('T')[0] : ''
+        };
+    };
+
+    const clearDateFilter = () => {
+        filterDatePreset.value = '';
+        filterDateRange.value = { start: '', end: '' };
+    };
+
+    const toggleTagFilter = (tagId) => {
+        const index = filterTags.value.indexOf(tagId);
+        if (index > -1) {
+            filterTags.value.splice(index, 1);
+        } else {
+            filterTags.value.push(tagId);
+        }
+    };
+
+    const clearTagFilters = () => {
+        filterTags.value = [];
+        selectedTagFilter.value = null;
+    };
+
+    const clearFolderFilter = () => {
+        filterFolder.value = '';
+    };
+
+    const clearAllFilters = () => {
+        filterTags.value = [];
+        filterFolder.value = '';
+        filterDateRange.value = { start: '', end: '' };
+        filterDatePreset.value = '';
+        filterTextQuery.value = '';
+        selectedTagFilter.value = null;
+        searchQuery.value = '';
+    };
+
+    const toggleArchivedView = () => {
+        showArchivedRecordings.value = !showArchivedRecordings.value;
+        if (showArchivedRecordings.value) {
+            showSharedWithMe.value = false;
+        }
+    };
+
+    const toggleSharedView = () => {
+        showSharedWithMe.value = !showSharedWithMe.value;
+        if (showSharedWithMe.value) {
+            showArchivedRecordings.value = false;
+        }
+    };
+
+    const setSortBy = (field) => {
+        sortBy.value = field;
+    };
+
+    const hasActiveFilters = computed(() => {
+        return filterTags.value.length > 0 ||
+               filterFolder.value ||
+               filterDateRange.value.start ||
+               filterDateRange.value.end ||
+               filterTextQuery.value ||
+               searchQuery.value;
+    });
+
+    return {
+        // State
+        searchQuery,
+        showAdvancedFilters,
+        filterTags,
+        filterFolder,
+        filterDateRange,
+        filterDatePreset,
+        filterTextQuery,
+        showArchivedRecordings,
+        showSharedWithMe,
+        sortBy,
+        selectedTagFilter,
+        searchDebounceTimer,
+
+        // Computed
+        hasActiveFilters,
+
+        // Methods
+        toggleAdvancedFilters,
+        setDatePreset,
+        clearDateFilter,
+        toggleTagFilter,
+        clearTagFilters,
+        clearFolderFilter,
+        clearAllFilters,
+        toggleArchivedView,
+        toggleSharedView,
+        setSortBy
+    };
+}
diff --git a/static/js/composables/usePagination.js b/static/js/composables/usePagination.js
new file mode 100644
index 00000000..f23e7c67
--- /dev/null
+++ b/static/js/composables/usePagination.js
@@ -0,0 +1,95 @@
+/**
+ * Pagination composable
+ * Handles pagination state and navigation
+ */
+
+import { ref, computed } from 'vue';
+
+export function usePagination() {
+    // State
+    const currentPage = ref(1);
+    const perPage = ref(25);
+    const totalRecordings = ref(0);
+    const totalPages = ref(0);
+    const hasNextPage = ref(false);
+    const hasPrevPage = ref(false);
+    const isLoadingMore = ref(false);
+
+    // Computed
+    const paginationInfo = computed(() => {
+        const start = (currentPage.value - 1) * perPage.value + 1;
+        const end = Math.min(currentPage.value * perPage.value, totalRecordings.value);
+        return {
+            start,
+            end,
+            total: totalRecordings.value,
+            currentPage: currentPage.value,
+            totalPages: totalPages.value
+        };
+    });
+
+    // Methods
+    const updatePagination = (pagination) => {
+        if (!pagination) {
+            // Reset pagination for non-paginated views
+            currentPage.value = 1;
+            totalPages.value = 1;
+            hasNextPage.value = false;
+            hasPrevPage.value = false;
+            return;
+        }
+
+        currentPage.value = pagination.page;
+        totalRecordings.value = pagination.total;
+        totalPages.value = pagination.total_pages;
+        hasNextPage.value = pagination.has_next;
+        hasPrevPage.value = pagination.has_prev;
+    };
+
+    const goToPage = (page) => {
+        if (page < 1 || page > totalPages.value) return;
+        currentPage.value = page;
+    };
+
+    const nextPage = () => {
+        if (hasNextPage.value) {
+            currentPage.value++;
+        }
+    };
+
+    const prevPage = () => {
+        if (hasPrevPage.value) {
+            currentPage.value--;
+        }
+    };
+
+    const reset = () => {
+        currentPage.value = 1;
+        totalRecordings.value = 0;
+        totalPages.value = 0;
+        hasNextPage.value = false;
+        hasPrevPage.value = false;
+        isLoadingMore.value = false;
+    };
+
+    return {
+        // State
+        currentPage,
+        perPage,
+        totalRecordings,
+        totalPages,
+        hasNextPage,
+        hasPrevPage,
+        isLoadingMore,
+
+        // Computed
+        paginationInfo,
+
+        // Methods
+        updatePagination,
+        goToPage,
+        nextPage,
+        prevPage,
+        reset
+    };
+}
diff --git a/static/js/composables/usePlayer.js b/static/js/composables/usePlayer.js
new file mode 100644
index 00000000..caef9720
--- /dev/null
+++ b/static/js/composables/usePlayer.js
@@ -0,0 +1,147 @@
+/**
+ * Audio Player composable
+ * Handles audio playback functionality
+ */
+
+import { ref, computed, watch } from 'vue';
+
+export function usePlayer() {
+    // State
+    const isPlaying = ref(false);
+    const currentTime = ref(0);
+    const duration = ref(0);
+    const playbackRate = ref(1.0);
+    const audioElement = ref(null);
+
+    // Computed
+    const progress = computed(() => {
+        if (!duration.value) return 0;
+        return (currentTime.value / duration.value) * 100;
+    });
+
+    const formattedCurrentTime = computed(() => {
+        return formatTime(currentTime.value);
+    });
+
+    const formattedDuration = computed(() => {
+        return formatTime(duration.value);
+    });
+
+    // Methods
+    const formatTime = (seconds) => {
+        if (!seconds || isNaN(seconds)) return '0:00';
+        const mins = Math.floor(seconds / 60);
+        const secs = Math.floor(seconds % 60);
+        return `${mins}:${secs.toString().padStart(2, '0')}`;
+    };
+
+    const initPlayer = (audio) => {
+        audioElement.value = audio;
+
+        if (!audio) return;
+
+        audio.addEventListener('loadedmetadata', () => {
+            duration.value = audio.duration;
+        });
+
+        audio.addEventListener('timeupdate', () => {
+            currentTime.value = audio.currentTime;
+        });
+
+        audio.addEventListener('play', () => {
+            isPlaying.value = true;
+        });
+
+        audio.addEventListener('pause', () => {
+            isPlaying.value = false;
+        });
+
+        audio.addEventListener('ended', () => {
+            isPlaying.value = false;
+            currentTime.value = 0;
+        });
+    };
+
+    const play = () => {
+        if (audioElement.value) {
+            audioElement.value.play();
+        }
+    };
+
+    const pause = () => {
+        if (audioElement.value) {
+            audioElement.value.pause();
+        }
+    };
+
+    const togglePlayPause = () => {
+        if (isPlaying.value) {
+            pause();
+        } else {
+            play();
+        }
+    };
+
+    const seek = (time) => {
+        if (audioElement.value) {
+            audioElement.value.currentTime = time;
+            currentTime.value = time;
+        }
+    };
+
+    const seekPercent = (percent) => {
+        if (audioElement.value && duration.value) {
+            const time = (percent / 100) * duration.value;
+            seek(time);
+        }
+    };
+
+    const skip = (seconds) => {
+        if (audioElement.value) {
+            const newTime = Math.max(0, Math.min(duration.value, currentTime.value + seconds));
+            seek(newTime);
+        }
+    };
+
+    const setPlaybackRate = (rate) => {
+        playbackRate.value = rate;
+        if (audioElement.value) {
+            audioElement.value.playbackRate = rate;
+        }
+    };
+
+    const reset = () => {
+        if (audioElement.value) {
+            audioElement.value.pause();
+            audioElement.value.currentTime = 0;
+        }
+        isPlaying.value = false;
+        currentTime.value = 0;
+        duration.value = 0;
+    };
+
+    return {
+        // State
+        isPlaying,
+        currentTime,
+        duration,
+        playbackRate,
+        audioElement,
+
+        // Computed
+        progress,
+        formattedCurrentTime,
+        formattedDuration,
+
+        // Methods
+        initPlayer,
+        play,
+        pause,
+        togglePlayPause,
+        seek,
+        seekPercent,
+        skip,
+        setPlaybackRate,
+        reset
+    };
+}
diff --git a/static/js/composables/useRecordings.js b/static/js/composables/useRecordings.js
new file mode 100644
index 00000000..67fc6321
--- /dev/null
+++ b/static/js/composables/useRecordings.js
@@ -0,0 +1,327 @@
+/**
+ * Recordings composable
+ * Handles recordings list, selection, and CRUD operations
+ */
+
+import { ref, computed } from 'vue';
+import { apiRequest } from '../utils/apiClient.js';
+
+export function useRecordings() {
+    // State
+    const recordings = ref([]);
+    const selectedRecording = ref(null);
+    const isLoadingRecordings = ref(true);
+    const globalError = ref(null);
+    const currentView = ref('upload');
+    const availableTags = ref([]);
+    const selectedTagIds = ref([]);
+    const showTagModal = ref(false);
+    const showDeleteModal = ref(false);
+    const recordingToDelete = ref(null);
+
+    // Computed
+    const completedRecordings = computed(() => {
+        return recordings.value.filter(r => r.status === 'COMPLETED');
+    });
+
+    const processingRecordings = computed(() => {
+        return recordings.value.filter(r => ['PENDING', 'PROCESSING', 'SUMMARIZING'].includes(r.status));
+    });
+
+    const hasRecordings = computed(() => recordings.value.length > 0);
+
+    // Methods
+    const loadRecordings = async (page = 1, filters = {}) => {
+        globalError.value = null;
+        isLoadingRecordings.value = true;
+
+        try {
+            let endpoint = '/api/recordings';
+            if (filters.archived) {
+                endpoint = '/api/recordings/archived';
+            } else if (filters.sharedWithMe) {
+                endpoint = '/api/recordings/shared-with-me';
+            }
+
+            const params = new URLSearchParams({
+                page: page.toString(),
+                per_page: '25'
+            });
+
+            if (filters.query) {
+                params.set('q', filters.query.trim());
+            }
+
+            const response = await fetch(`${endpoint}?${params}`);
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to load recordings');
+            }
+
+            const recordingsList = filters.archived || filters.sharedWithMe ? data : data.recordings;
+
+            if (!Array.isArray(recordingsList)) {
+                throw new Error('Invalid response format');
+            }
+
+            recordings.value = recordingsList;
+
+            // Restore last selected recording
+            const lastRecordingId = localStorage.getItem('lastSelectedRecordingId');
+            if (lastRecordingId && recordingsList.length > 0) {
+                const recordingToSelect = recordingsList.find(r => r.id == lastRecordingId);
+                if (recordingToSelect) {
+                    selectRecording(recordingToSelect);
+                }
+            }
+
+            return filters.archived || filters.sharedWithMe ? null : data.pagination;
+
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingRecordings.value = false;
+        }
+    };
+
+    const selectRecording = async (recording) => {
+        if (!recording) return;
+
+        selectedRecording.value = recording;
+        currentView.value = 'recording';
+        localStorage.setItem('lastSelectedRecordingId', recording.id);
+
+        // Load full recording details if needed
+        if (!recording.transcription && recording.status === 'COMPLETED') {
+            try {
+                const data = await apiRequest(`/api/recordings/${recording.id}`);
+                Object.assign(selectedRecording.value, data);
+            } catch (error) {
+                console.error('Error loading recording details:', error);
+            }
+        }
+    };
+
+    const deselectRecording = () => {
+        selectedRecording.value = null;
+        currentView.value = 'upload';
+        localStorage.removeItem('lastSelectedRecordingId');
+    };
+
+    const deleteRecording = async (recordingId) => {
+        try {
+            await apiRequest(`/api/recordings/${recordingId}`, {
+                method: 'DELETE'
+            });
+
+            recordings.value = recordings.value.filter(r => r.id !== recordingId);
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                deselectRecording();
+            }
+
+            return true;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const archiveRecording = async (recordingId) => {
+        try {
+            await apiRequest(`/api/recordings/${recordingId}/archive`, {
+                method: 'POST'
+            });
+
+            recordings.value = recordings.value.filter(r => r.id !== recordingId);
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                deselectRecording();
+            }
+
+            return true;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const unarchiveRecording = async (recordingId) => {
+        try {
+            await apiRequest(`/api/recordings/${recordingId}/unarchive`, {
+                method: 'POST'
+            });
+
+            recordings.value = recordings.value.filter(r => r.id !== recordingId);
+
+            return true;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const updateRecording = async (recordingId, updates) => {
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}`, {
+                method: 'PUT',
+                body: JSON.stringify(updates)
+            });
+
+            const index = recordings.value.findIndex(r => r.id === recordingId);
+            if (index > -1) {
+                Object.assign(recordings.value[index], data.recording || data);
+            }
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                Object.assign(selectedRecording.value, data.recording || data);
+            }
+
+            return data.recording || data;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const regenerateSummary = async (recordingId, customPrompt = null) => {
+        try {
+            const body = customPrompt ? { custom_prompt: customPrompt } : {};
+            const data = await apiRequest(`/api/recordings/${recordingId}/regenerate-summary`, {
+                method: 'POST',
+                body: JSON.stringify(body)
+            });
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                selectedRecording.value.status = 'SUMMARIZING';
+            }
+
+            return data;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const loadTags = async () => {
+        try {
+            const data = await apiRequest('/api/tags');
+            availableTags.value = data;
+        } catch (error) {
+            console.error('Error loading tags:', error);
+        }
+    };
+
+    const addTagToRecording = async (recordingId, tagId) => {
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}/tags`, {
+                method: 'POST',
+                body: JSON.stringify({ tag_id: tagId })
+            });
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                selectedRecording.value.tags = data.tags || [];
+            }
+
+            return data;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const removeTagFromRecording = async (recordingId, tagId) => {
+        try {
+            await apiRequest(`/api/recordings/${recordingId}/tags/${tagId}`, {
+                method: 'DELETE'
+            });
+
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                selectedRecording.value.tags = selectedRecording.value.tags.filter(t => t.id !== tagId);
+            }
+
+            return true;
+        } catch (error) {
+            globalError.value = error.message;
+            throw error;
+        }
+    };
+
+    const toggleHighlight = async (recordingId) => {
+        const recording = recordings.value.find(r => r.id === recordingId);
+        if (!recording) return;
+
+        const newValue = !recording.is_highlighted;
+
+        try {
+            await updateRecording(recordingId, { is_highlighted: newValue });
+        } catch (error) {
+            throw error;
+        }
+    };
+
+    const setGlobalError = (message) => {
+        globalError.value = message;
+    };
+
+    const clearGlobalError = () => {
+        globalError.value = null;
+    };
+
+    const confirmDelete = (recording) => {
+        recordingToDelete.value = recording;
+        showDeleteModal.value = true;
+    };
+
+    const cancelDelete = () => {
+        recordingToDelete.value = null;
+        showDeleteModal.value = false;
+    };
+
+    const executeDelete = async () => {
+        if (recordingToDelete.value) {
+            await deleteRecording(recordingToDelete.value.id);
+            cancelDelete();
+        }
+    };
+
+    return {
+        // State
+        recordings,
+        selectedRecording,
+        isLoadingRecordings,
+        globalError,
+        currentView,
+        availableTags,
+        selectedTagIds,
+        showTagModal,
+        showDeleteModal,
+        recordingToDelete,
+
+        // Computed
+        completedRecordings,
+        processingRecordings,
+        hasRecordings,
+
+        // Methods
+        loadRecordings,
+        selectRecording,
+        deselectRecording,
+        deleteRecording,
+        archiveRecording,
+        unarchiveRecording,
+        updateRecording,
+        regenerateSummary,
+        loadTags,
+        addTagToRecording,
+        removeTagFromRecording,
+        toggleHighlight,
+        setGlobalError,
+        clearGlobalError,
+        confirmDelete,
+        cancelDelete,
+        executeDelete
+    };
+}
diff --git a/static/js/composables/useSharing.js b/static/js/composables/useSharing.js
new file mode 100644
index 00000000..60706c4a
--- /dev/null
+++ b/static/js/composables/useSharing.js
@@ -0,0 +1,195 @@
+/**
+ * Sharing composable
+ * Handles public and internal sharing functionality
+ */
+
+import { ref } from 'vue';
+import { apiRequest } from '../utils/apiClient.js';
+
+export function useSharing() {
+    // State
+    const showShareModal = ref(false);
+    const showInternalShareModal = ref(false);
+    const shareUrl = ref('');
+    const shareSettings = ref({
+        shareSummary: true,
+        shareNotes: true
+    });
+    const internalShareSettings = ref({
+        userId: null,
+        canEdit: false,
+        canReshare: false
+    });
+    const isLoadingShare = ref(false);
+    const shareError = ref(null);
+
+    // Methods
+    const openShareModal = async (recording) => {
+        showShareModal.value = true;
+        shareError.value = null;
+        isLoadingShare.value = true;
+
+        try {
+            const data = await apiRequest(`/api/recording/${recording.id}/share`);
+
+            if (data.exists) {
+                shareUrl.value = data.share_url;
+                shareSettings.value = {
+                    shareSummary: data.share.share_summary,
+                    shareNotes: data.share.share_notes
+                };
+            } else {
+                shareUrl.value = '';
+            }
+        } catch (error) {
+            shareError.value = error.message;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const createShare = async (recordingId) => {
+        isLoadingShare.value = true;
+        shareError.value = null;
+
+        try {
+            const data = await apiRequest(`/api/recording/${recordingId}/share`, {
+                method: 'POST',
+                body: JSON.stringify(shareSettings.value)
+            });
+
+            shareUrl.value = data.share_url;
+            return data;
+        } catch (error) {
+            shareError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const updateShare = async (shareId) => {
+        isLoadingShare.value = true;
+        shareError.value = null;
+
+        try {
+            const data = await apiRequest(`/api/share/${shareId}`, {
+                method: 'PUT',
+                body: JSON.stringify(shareSettings.value)
+            });
+
+            return data;
+        } catch (error) {
+            shareError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const deleteShare = async (shareId) => {
+        isLoadingShare.value = true;
+        shareError.value = null;
+
+        try {
+            await apiRequest(`/api/share/${shareId}`, {
+                method: 'DELETE'
+            });
+
+            shareUrl.value = '';
+        } catch (error) {
+            shareError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const copyShareUrl = async () => {
+        try {
+            await navigator.clipboard.writeText(shareUrl.value);
+            return true;
+        } catch (error) {
+            console.error('Failed to copy:', error);
+            return false;
+        }
+    };
+
+    const openInternalShareModal = (recording) => {
+        showInternalShareModal.value = true;
+        shareError.value = null;
+        internalShareSettings.value = {
+            userId: null,
+            canEdit: false,
+            canReshare: false
+        };
+    };
+
+    const shareInternally = async (recordingId) => {
+        isLoadingShare.value = true;
+        shareError.value = null;
+
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}/share-internal`, {
+                method: 'POST',
+                body: JSON.stringify({
+                    user_id: internalShareSettings.value.userId,
+                    can_edit: internalShareSettings.value.canEdit,
+                    can_reshare: internalShareSettings.value.canReshare
+                })
+            });
+
+            return data;
+        } catch (error) {
+            shareError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const revokeInternalShare = async (shareId) => {
+        isLoadingShare.value = true;
+        shareError.value = null;
+
+        try {
+            await apiRequest(`/api/internal-shares/${shareId}`, {
+                method: 'DELETE'
+            });
+        } catch (error) {
+            shareError.value = error.message;
+            throw error;
+        } finally {
+            isLoadingShare.value = false;
+        }
+    };
+
+    const closeShareModal = () => {
+        showShareModal.value = false;
+        showInternalShareModal.value = false;
+        shareUrl.value = '';
+        shareError.value = null;
+    };
+
+    return {
+        // State
+        showShareModal,
+        showInternalShareModal,
+        shareUrl,
+        shareSettings,
+        internalShareSettings,
+        isLoadingShare,
+        shareError,
+
+        // Methods
+        openShareModal,
+        createShare,
+        updateShare,
+        deleteShare,
+        copyShareUrl,
+        openInternalShareModal,
+        shareInternally,
+        revokeInternalShare,
+        closeShareModal
+    };
+}
diff --git a/static/js/composables/useTranscript.js b/static/js/composables/useTranscript.js
new file mode 100644
index 00000000..0c2032e9
--- /dev/null
+++ b/static/js/composables/useTranscript.js
@@ -0,0 +1,209 @@
+/**
+ * Transcript composable
+ * Handles transcript viewing and editing functionality
+ */
+
+import { ref, computed } from 'vue';
+import { apiRequest } from '../utils/apiClient.js';
+
+export function useTranscript() {
+    // State
+    const selectedTab = ref('summary');
+    const isEditingTranscript = ref(false);
+    const editedTranscription = ref('');
+    const isEditingSummary = ref(false);
+    const editedSummary = ref('');
+    const isEditingNotes = ref(false);
+    const editedNotes = ref('');
+    const isInlineEditingTitle = ref(false);
+    const editedTitle = ref('');
+    const isSavingChanges = ref(false);
+    const transcriptSearchQuery = ref('');
+    const highlightedText = ref('');
+
+    // Methods
+    const setTab = (tab) => {
+        selectedTab.value = tab;
+    };
+
+    const startEditingTranscript = (recording) => {
+        isEditingTranscript.value = true;
+        editedTranscription.value = recording.transcription || '';
+    };
+
+    const cancelEditingTranscript = () => {
+        isEditingTranscript.value = false;
+        editedTranscription.value = '';
+    };
+
+    const saveTranscript = async (recordingId) => {
+        isSavingChanges.value = true;
+
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}/transcript`, {
+                method: 'PUT',
+                body: JSON.stringify({
+                    transcription: editedTranscription.value
+                })
+            });
+
+            isEditingTranscript.value = false;
+            return data.recording;
+        } catch (error) {
+            throw error;
+        } finally {
+            isSavingChanges.value = false;
+        }
+    };
+
+    const startEditingSummary = (recording) => {
+        isEditingSummary.value = true;
+        editedSummary.value = recording.summary || '';
+    };
+
+    const cancelEditingSummary = () => {
+        isEditingSummary.value = false;
+        editedSummary.value = '';
+    };
+
+    const saveSummary = async (recordingId) => {
+        isSavingChanges.value = true;
+
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}/summary`, {
+                method: 'PUT',
+                body: JSON.stringify({
+                    summary: editedSummary.value
+                })
+            });
+
+            isEditingSummary.value = false;
+            return data.recording;
+        } catch (error) {
+            throw error;
+        } finally {
+            isSavingChanges.value = false;
+        }
+    };
+
+    const startEditingNotes = (recording) => {
+        isEditingNotes.value = true;
+        editedNotes.value = recording.notes || '';
+    };
+
+    const cancelEditingNotes = () => {
+        isEditingNotes.value = false;
+        editedNotes.value = '';
+    };
+
+    const saveNotes = async (recordingId) => {
+        isSavingChanges.value = true;
+
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}/notes`, {
+                method: 'PUT',
+                body: JSON.stringify({
+                    notes: editedNotes.value
+                })
+            });
+
+            isEditingNotes.value = false;
+            return data.recording;
+        } catch (error) {
+            throw error;
+        } finally {
+            isSavingChanges.value = false;
+        }
+    };
+
+    const startEditingTitle = (recording) => {
+        isInlineEditingTitle.value = true;
+        editedTitle.value = recording.title || '';
+    };
+
+    const cancelEditingTitle = () => {
+        isInlineEditingTitle.value = false;
+        editedTitle.value = '';
+    };
+
+    const saveTitle = async (recordingId) => {
+        isSavingChanges.value = true;
+
+        try {
+            const data = await apiRequest(`/api/recordings/${recordingId}`, {
+                method: 'PUT',
+                body: JSON.stringify({
+                    title: editedTitle.value
+                })
+            });
+
+            isInlineEditingTitle.value = false;
+            return data.recording;
+        } catch (error) {
+            throw error;
+        } finally {
+            isSavingChanges.value = false;
+        }
+    };
+
+    const searchInTranscript = (text, query) => {
+        if (!query) {
+            highlightedText.value = text;
+            return text;
+        }
+
+        const regex = new RegExp(`(${query})`, 'gi');
+        highlightedText.value = text.replace(regex, '<mark>$1</mark>');
+        return highlightedText.value;
+    };
+
+    const exportTranscript = async (recordingId, format) => {
+        try {
+            const response = await fetch(`/api/recordings/${recordingId}/export/${format}`);
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = `transcript.${format}`;
+            document.body.appendChild(a);
+            a.click();
+            document.body.removeChild(a);
+            window.URL.revokeObjectURL(url);
+        } catch (error) {
+            throw error;
+        }
+    };
+
+    return {
+        // State
+        selectedTab,
+        isEditingTranscript,
+        editedTranscription,
+        isEditingSummary,
+        editedSummary,
+        isEditingNotes,
+        editedNotes,
+        isInlineEditingTitle,
+        editedTitle,
+        isSavingChanges,
+        transcriptSearchQuery,
+        highlightedText,
+
+        // Methods
+        setTab,
+        startEditingTranscript,
+        cancelEditingTranscript,
+        saveTranscript,
+        startEditingSummary,
+        cancelEditingSummary,
+        saveSummary,
+        startEditingNotes,
+        cancelEditingNotes,
+        saveNotes,
+        startEditingTitle,
+        cancelEditingTitle,
+        saveTitle,
+        searchInTranscript,
+        exportTranscript
+    };
+}
diff --git a/static/js/composables/useUI.js b/static/js/composables/useUI.js
new file mode 100644
index 00000000..f5d9dce2
--- /dev/null
+++ b/static/js/composables/useUI.js
@@ -0,0 +1,147 @@
+/**
+ * UI State composable
+ * Handles all UI-related state (theme, sidebar, modals, etc.)
+ */
+
+import { ref, computed, watch, onMounted } from 'vue';
+
+export function useUI() {
+    // State
+    const browser = ref('unknown');
+    const isSidebarCollapsed = ref(false);
+    const searchTipsExpanded = ref(false);
+    const isUserMenuOpen = ref(false);
+    const isDarkMode = ref(false);
+    const currentColorScheme = ref('blue');
+    const showColorSchemeModal = ref(false);
+    const windowWidth = ref(window.innerWidth);
+    const mobileTab = ref('transcript');
+    const isMetadataExpanded = ref(false);
+    const currentLanguage = ref('en');
+    const currentLanguageName = ref('English');
+    const availableLanguages = ref([]);
+    const showLanguageMenu = ref(false);
+
+    // Computed
+    const isMobile = computed(() => windowWidth.value < 768);
+    const isTablet = computed(() => windowWidth.value >= 768 && windowWidth.value < 1024);
+    const isDesktop = computed(() => windowWidth.value >= 1024);
+
+    const colorSchemes = [
+        { name: 'blue', label: 'Blue', primary: '#3b82f6', hover: '#2563eb' },
+        { name: 'purple', label: 'Purple', primary: '#8b5cf6', hover: '#7c3aed' },
+        { name: 'green', label: 'Green', primary: '#10b981', hover: '#059669' },
+        { name: 'orange', label: 'Orange', primary: '#f59e0b', hover: '#d97706' },
+        { name: 'pink', label: 'Pink', primary: '#ec4899', hover: '#db2777' },
+        { name: 'red', label: 'Red', primary: '#ef4444', hover: '#dc2626' }
+    ];
+
+    // Methods
+    const detectBrowser = () => {
+        const userAgent = navigator.userAgent.toLowerCase();
+        if (userAgent.indexOf('firefox') > -1) browser.value = 'firefox';
+        else if (userAgent.indexOf('chrome') > -1 && userAgent.indexOf('edge') === -1) browser.value = 'chrome';
+        else if (userAgent.indexOf('safari') > -1 && userAgent.indexOf('chrome') === -1) browser.value = 'safari';
+        else if (userAgent.indexOf('edge') > -1) browser.value = 'edge';
+        else browser.value = 'unknown';
+    };
+
+    const toggleSidebar = () => {
+        isSidebarCollapsed.value = !isSidebarCollapsed.value;
+        localStorage.setItem('sidebarCollapsed', isSidebarCollapsed.value.toString());
+    };
+
+    const toggleDarkMode = () => {
+        isDarkMode.value = !isDarkMode.value;
+        document.documentElement.classList.toggle('dark', isDarkMode.value);
+        localStorage.setItem('darkMode', isDarkMode.value ? 'enabled' : 'disabled');
+    };
+
+    const setColorScheme = (scheme) => {
+        currentColorScheme.value = scheme;
+        document.documentElement.setAttribute('data-color-scheme', scheme);
+        localStorage.setItem('colorScheme', scheme);
+    };
+
+    const loadUIPreferences = () => {
+        // Load dark mode
+        const savedDarkMode = localStorage.getItem('darkMode');
+        if (savedDarkMode === 'enabled') {
+            isDarkMode.value = true;
+            document.documentElement.classList.add('dark');
+        }
+
+        // Load color scheme
+        const savedScheme = localStorage.getItem('colorScheme');
+        if (savedScheme && colorSchemes.find(s => s.name === savedScheme)) {
+            setColorScheme(savedScheme);
+        }
+
+        // Load sidebar state
+        const savedSidebar = localStorage.getItem('sidebarCollapsed');
+        if (savedSidebar === 'true') {
+            isSidebarCollapsed.value = true;
+        }
+    };
+
+    const handleResize = () => {
+        windowWidth.value = window.innerWidth;
+    };
+
+    const toggleUserMenu = () => {
+        isUserMenuOpen.value = !isUserMenuOpen.value;
+    };
+
+    const closeUserMenu = () => {
+        isUserMenuOpen.value = false;
+    };
+
+    const setMobileTab = (tab) => {
+        mobileTab.value = tab;
+    };
+
+    const toggleMetadata = () => {
+        isMetadataExpanded.value = !isMetadataExpanded.value;
+    };
+
+    // Initialize
+    onMounted(() => {
+        detectBrowser();
+        loadUIPreferences();
+        window.addEventListener('resize', handleResize);
+    });
+
+    return {
+        // State
+        browser,
+        isSidebarCollapsed,
+        searchTipsExpanded,
+        isUserMenuOpen,
+        isDarkMode,
+        currentColorScheme,
+        showColorSchemeModal,
+        windowWidth,
+        mobileTab,
+        isMetadataExpanded,
+        currentLanguage,
+        currentLanguageName,
+        availableLanguages,
+        showLanguageMenu,
+
+        // Computed
+        isMobile,
+        isTablet,
+        isDesktop,
+        colorSchemes,
+
+        // Methods
+        toggleSidebar,
+        toggleDarkMode,
+        setColorScheme,
+        loadUIPreferences,
+        toggleUserMenu,
+        closeUserMenu,
+        setMobileTab,
+        toggleMetadata
+    };
+}
diff --git a/static/js/composables/useUpload.js b/static/js/composables/useUpload.js
new file mode 100644
index 00000000..48db06d9
--- /dev/null
+++ b/static/js/composables/useUpload.js
@@ -0,0 +1,280 @@
+/**
+ * Upload composable
+ * Handles file upload queue and processing
+ */
+
+import { ref, computed, nextTick } from 'vue';
+import { uploadFile } from '../utils/apiClient.js';
+
+export function useUpload() {
+    // State
+    const uploadQueue = ref([]);
+    const currentlyProcessingFile = ref(null);
+    const processingProgress = ref(0);
+    const processingMessage = ref('');
+    const isProcessingActive = ref(false);
+    const pollInterval = ref(null);
+    const progressPopupMinimized = ref(false);
+    const progressPopupClosed = ref(false);
+    const maxFileSizeMB = ref(250);
+    const chunkingEnabled = ref(true);
+    const dragover = ref(false);
+
+    // Computed
+    const hasQueuedFiles = computed(() => {
+        return uploadQueue.value.some(item => item.status === 'queued');
+    });
+
+    const processingCount = computed(() => {
+        return uploadQueue.value.filter(item => item.status === 'processing' || item.status === 'queued').length;
+    });
+
+    const completedCount = computed(() => {
+        return uploadQueue.value.filter(item => item.status === 'completed').length;
+    });
+
+    const errorCount = computed(() => {
+        return uploadQueue.value.filter(item => item.status === 'error').length;
+    });
+
+    // Methods
+    const addFilesToQueue = (files) => {
+        const maxFileSize = maxFileSizeMB.value * 1024 * 1024;
+
+        for (const file of files) {
+            if (file.size > maxFileSize) {
+                uploadQueue.value.push({
+                    file,
+                    status: 'error',
+                    error: `File exceeds maximum size of ${maxFileSizeMB.value}MB`,
+                    clientId: Date.now() + Math.random()
+                });
+                continue;
+            }
+
+            const isAudio = file.type.startsWith('audio/') ||
+                           file.type.startsWith('video/') ||
+                           /\.(mp3|wav|ogg|m4a|flac|webm|weba|mp4|mov|avi|mkv)$/i.test(file.name);
+
+            if (!isAudio) {
+                uploadQueue.value.push({
+                    file,
+                    status: 'error',
+                    error: 'File type not supported',
+                    clientId: Date.now() + Math.random()
+                });
+                continue;
+            }
+
+            uploadQueue.value.push({
+                file,
+                status: 'queued',
+                recordingId: null,
+                clientId: Date.now() + Math.random(),
+                error: null
+            });
+        }
+
+        if (!isProcessingActive.value && hasQueuedFiles.value) {
+            startProcessingQueue();
+        }
+    };
+
+    const startProcessingQueue = async () => {
+        if (isProcessingActive.value) return;
+
+        const nextItem = uploadQueue.value.find(item => item.status === 'queued');
+        if (!nextItem) {
+            isProcessingActive.value = false;
+            return;
+        }
+
+        isProcessingActive.value = true;
+        currentlyProcessingFile.value = nextItem;
+        nextItem.status = 'uploading';
+        processingProgress.value = 0;
+        processingMessage.value = 'Uploading...';
+
+        try {
+            const data = await uploadFile('/api/recordings/upload', nextItem.file, (progress) => {
+                processingProgress.value = progress;
+                processingMessage.value = `Uploading... ${Math.round(progress)}%`;
+            });
+
+            nextItem.recordingId = data.recording_id;
+            nextItem.status = 'processing';
+            processingMessage.value = 'Processing...';
+
+            // Start polling for status
+            pollProcessingStatus(nextItem);
+
+        } catch (error) {
+            nextItem.status = 'error';
+            nextItem.error = error.message;
+            currentlyProcessingFile.value = null;
+            isProcessingActive.value = false;
+
+            // Continue with next file
+            if (hasQueuedFiles.value) {
+                await nextTick();
+                startProcessingQueue();
+            }
+        }
+    };
+
+    const pollProcessingStatus = (queueItem) => {
+        if (pollInterval.value) {
+            clearInterval(pollInterval.value);
+        }
+
+        pollInterval.value = setInterval(async () => {
+            try {
+                const response = await fetch(`/api/recordings/${queueItem.recordingId}/status`);
+                const data = await response.json();
+
+                if (data.status === 'COMPLETED') {
+                    clearInterval(pollInterval.value);
+                    pollInterval.value = null;
+
+                    queueItem.status = 'completed';
+                    currentlyProcessingFile.value = null;
+                    isProcessingActive.value = false;
+                    processingProgress.value = 100;
+                    processingMessage.value = 'Complete!';
+
+                    // Continue with next file
+                    if (hasQueuedFiles.value) {
+                        await nextTick();
+                        startProcessingQueue();
+                    }
+
+                } else if (data.status === 'ERROR') {
+                    clearInterval(pollInterval.value);
+                    pollInterval.value = null;
+
+                    queueItem.status = 'error';
+                    queueItem.error = data.error_message || 'Processing failed';
+                    currentlyProcessingFile.value = null;
+                    isProcessingActive.value = false;
+
+                    // Continue with next file
+                    if (hasQueuedFiles.value) {
+                        await nextTick();
+                        startProcessingQueue();
+                    }
+
+                } else {
+                    // Still processing
+                    if (data.status === 'SUMMARIZING') {
+                        processingMessage.value = 'Generating summary...';
+                        processingProgress.value = 80;
+                    } else {
+                        processingMessage.value = 'Transcribing...';
+                        processingProgress.value = 50;
+                    }
+                }
+
+            } catch (error) {
+                console.error('Error polling status:', error);
+            }
+        }, 3000);
+    };
+
+    const removeFromQueue = (clientId) => {
+        const index = uploadQueue.value.findIndex(item => item.clientId === clientId);
+        if (index > -1) {
+            uploadQueue.value.splice(index, 1);
+        }
+    };
+
+    const clearCompletedFromQueue = () => {
+        uploadQueue.value = uploadQueue.value.filter(item =>
+            item.status !== 'completed' && item.status !== 'error'
+        );
+    };
+
+    const handleDragEnter = (event) => {
+        event.preventDefault();
+        dragover.value = true;
+    };
+
+    const handleDragLeave = (event) => {
+        event.preventDefault();
+        dragover.value = false;
+    };
+
+    const handleDrop = (event) => {
+        event.preventDefault();
+        dragover.value = false;
+
+        const files = Array.from(event.dataTransfer.files);
+        if (files.length > 0) {
+            addFilesToQueue(files);
+        }
+    };
+
+    const handleFileSelect = (event) => {
+        const files = Array.from(event.target.files);
+        if (files.length > 0) {
+            addFilesToQueue(files);
+        }
+        event.target.value = '';
+    };
+
+    const minimizeProgressPopup = () => {
+        progressPopupMinimized.value = true;
+    };
+
+    const maximizeProgressPopup = () => {
+        progressPopupMinimized.value = false;
+    };
+
+    const closeProgressPopup = () => {
+        progressPopupClosed.value = true;
+    };
+
+    const loadConfig = async () => {
+        try {
+            const response = await fetch('/api/config');
+            const data = await response.json();
+            maxFileSizeMB.value = data.max_file_size_mb || 250;
+            chunkingEnabled.value = data.chunking_enabled !== false;
+        } catch (error) {
+            console.error('Error loading config:', error);
+        }
+    };
+
+    return {
+        // State
+        uploadQueue,
+        currentlyProcessingFile,
+        processingProgress,
+        processingMessage,
+        isProcessingActive,
+        progressPopupMinimized,
+        progressPopupClosed,
+        maxFileSizeMB,
+        chunkingEnabled,
+        dragover,
+
+        // Computed
+        hasQueuedFiles,
+        processingCount,
+        completedCount,
+        errorCount,
+
+        // Methods
+        addFilesToQueue,
+        startProcessingQueue,
+        removeFromQueue,
+        clearCompletedFromQueue,
+        handleDragEnter,
+        handleDragLeave,
+        handleDrop,
+        handleFileSelect,
+        minimizeProgressPopup,
+        maximizeProgressPopup,
+        closeProgressPopup,
+        loadConfig
+    };
+}
diff --git a/static/js/config/push-config.js b/static/js/config/push-config.js
new file mode 100644
index 00000000..0d5932a3
--- /dev/null
+++ b/static/js/config/push-config.js
@@ -0,0 +1,78 @@
+/**
+ * Push Notification Configuration
+ *
+ * AUTO-CONFIGURATION:
+ * ------------------
+ * Push notifications are now auto-configured!
+ *
+ * On first server startup:
+ * 1. VAPID keys are automatically generated (requires pywebpush)
+ * 2. Keys are saved to /config/vapid_keys.json (persists across restarts)
+ * 3. Public key is served via /api/push/config
+ * 4. Client fetches config dynamically
+ *
+ * No manual configuration needed - just make sure:
+ * - pywebpush is installed: pip install pywebpush
+ * - /config directory is mounted as Docker volume (for persistence)
+ */
+
+// Cached config fetched from server
+let cachedConfig = null;
+
+/**
+ * Fetch push notification config from server
+ */
+export async function getPushConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+
+    try {
+        const response = await fetch('/api/push/config');
+        if (!response.ok) {
+            console.warn('[Push Config] Failed to fetch config:', response.status);
+            return { enabled: false, public_key: null };
+        }
+
+        cachedConfig = await response.json();
+        console.log('[Push Config] Loaded from server:', cachedConfig.enabled ? 'enabled' : 'disabled');
+        return cachedConfig;
+    } catch (error) {
+        console.error('[Push Config] Error fetching config:', error);
+        return { enabled: false, public_key: null };
+    }
+}
+
+/**
+ * Check if push notifications are enabled
+ */
+export async function isPushEnabled() {
+    const config = await getPushConfig();
+    return config.enabled && !!config.public_key;
+}
+
+/**
+ * Get VAPID public key from server
+ */
+export async function getPublicKey() {
+    const config = await getPushConfig();
+    return config.public_key;
+}
+
+/**
+ * Convert a base64 string to Uint8Array (required for push subscription)
+ */
+export function urlBase64ToUint8Array(base64String) {
+    const padding = '='.repeat((4 - base64String.length % 4) % 4);
+    const base64 = (base64String + padding)
+        .replace(/-/g, '+')
+        .replace(/_/g, '/');
+
+    const rawData = window.atob(base64);
+    const outputArray = new Uint8Array(rawData.length);
+
+    for (let i = 0; i < rawData.length; ++i) {
+        outputArray[i] = rawData.charCodeAt(i);
+    }
+    return outputArray;
+}
diff --git a/static/js/csrf-refresh.js b/static/js/csrf-refresh.js
new file mode 100644
index 00000000..a8ce1e55
--- /dev/null
+++ b/static/js/csrf-refresh.js
@@ -0,0 +1,184 @@
+// CSRF Token Management with Auto-Refresh
+class CSRFManager {
+    constructor() {
+        this.token = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+        this.refreshPromise = null;
+        this.setupFetchInterceptor();
+    }
+
+    async refreshToken() {
+        // Prevent multiple simultaneous refresh requests
+        if (this.refreshPromise) {
+            return this.refreshPromise;
+        }
+
+        this.refreshPromise = this.performTokenRefresh();
+        try {
+            const newToken = await this.refreshPromise;
+            return newToken;
+        } finally {
+            this.refreshPromise = null;
+        }
+    }
+
+    async performTokenRefresh() {
+        try {
+            console.log('Refreshing CSRF token...');
+            
+            // Use the original fetch to avoid recursion
+            const originalFetch = window.originalFetch || fetch;
+            const response = await originalFetch('/api/csrf-token', {
+                method: 'GET',
+                credentials: 'same-origin',
+                headers: {
+                    'Accept': 'application/json'
+                }
+            });
+
+            if (!response.ok) {
+                throw new Error(`Failed to refresh CSRF token: ${response.status} ${response.statusText}`);
+            }
+
+            const contentType = response.headers.get('content-type');
+            if (!contentType || !contentType.includes('application/json')) {
+                const text = await response.text();
+                throw new Error(`Expected JSON response but got ${contentType}. Response: ${text.substring(0, 200)}`);
+            }
+
+            const data = await response.json();
+            if (data.csrf_token) {
+                this.token = data.csrf_token;
+                // Update the meta tag for any other code that might read it
+                const metaTag = document.querySelector('meta[name="csrf-token"]');
+                if (metaTag) {
+                    metaTag.setAttribute('content', this.token);
+                }
+                
+                // Update Vue.js reactive token if available
+                if (window.app && window.app.csrfToken !== undefined) {
+                    window.app.csrfToken = this.token;
+                }
+                
+                console.log('CSRF token refreshed successfully');
+                return this.token;
+            } else {
+                throw new Error('No CSRF token in response');
+            }
+        } catch (error) {
+            console.error('Failed to refresh CSRF token:', error);
+            throw error;
+        }
+    }
+
+    setupFetchInterceptor() {
+        // Store original fetch if not already stored
+        if (!window.originalFetch) {
+            window.originalFetch = window.fetch;
+        }
+        
+        const originalFetch = window.originalFetch;
+        const self = this;
+        
+        window.fetch = async function(url, options = {}) {
+            // Skip CSRF token for the token refresh endpoint to avoid recursion
+            if (url.includes('/api/csrf-token')) {
+                return originalFetch(url, options);
+            }
+
+            // Add CSRF token to headers for API requests
+            const newOptions = { ...options };
+            if (url.startsWith('/api/') || url.startsWith('/upload') || url.startsWith('/save') || 
+                url.startsWith('/recording/') || url.startsWith('/chat') || url.startsWith('/speakers')) {
+                
+                newOptions.headers = {
+                    'X-CSRFToken': self.token,
+                    ...newOptions.headers
+                };
+            }
+
+            // Make the request
+            let response = await originalFetch(url, newOptions);
+
+            // Check for CSRF token expiration
+            if ((response.status === 400 || response.status === 403) && 
+                (url.startsWith('/api/') || url.startsWith('/upload') || url.startsWith('/save') || 
+                 url.startsWith('/recording/') || url.startsWith('/chat') || url.startsWith('/speakers'))) {
+                
+                try {
+                    // Try to parse as JSON first
+                    const responseClone = response.clone();
+                    let isCSRFError = false;
+                    
+                    try {
+                        const errorData = await responseClone.json();
+                        const errorMessage = errorData.error || '';
+                        isCSRFError = errorMessage.toLowerCase().includes('csrf') || 
+                                     errorMessage.toLowerCase().includes('token');
+                    } catch (jsonError) {
+                        // If JSON parsing fails, check if it's an HTML error page
+                        const textResponse = await response.clone().text();
+                        isCSRFError = textResponse.toLowerCase().includes('csrf') || 
+                                     textResponse.toLowerCase().includes('token') ||
+                                     textResponse.includes('<!doctype') || // HTML error page
+                                     textResponse.includes('<html');
+                    }
+                    
+                    if (isCSRFError) {
+                        console.log('CSRF token expired, attempting refresh and retry...');
+                        
+                        try {
+                            // Refresh the token
+                            await self.refreshToken();
+                            
+                            // Retry the original request with the new token
+                            newOptions.headers['X-CSRFToken'] = self.token;
+                            response = await originalFetch(url, newOptions);
+                            
+                            if (response.ok) {
+                                console.log('Request succeeded after CSRF token refresh');
+                            } else {
+                                console.warn('Request still failed after CSRF token refresh:', response.status);
+                            }
+                        } catch (refreshError) {
+                            console.error('Failed to refresh CSRF token during retry:', refreshError);
+                            // Return the original failed response
+                        }
+                    }
+                } catch (parseError) {
+                    console.warn('Could not parse error response for CSRF check:', parseError);
+                }
+            }
+
+            return response;
+        };
+    }
+
+    // Method to manually get current token
+    getToken() {
+        return this.token;
+    }
+
+    // Method to manually refresh token (for periodic refresh)
+    async manualRefresh() {
+        try {
+            await this.refreshToken();
+            return true;
+        } catch (error) {
+            console.error('Manual CSRF token refresh failed:', error);
+            return false;
+        }
+    }
+}
+
+// Initialize CSRF manager when DOM is loaded
+document.addEventListener('DOMContentLoaded', () => {
+    window.csrfManager = new CSRFManager();
+    
+    // Set up periodic token refresh every 45 minutes (before 1-hour expiration)
+    setInterval(() => {
+        if (window.csrfManager) {
+            console.log('Performing periodic CSRF token refresh...');
+            window.csrfManager.manualRefresh();
+        }
+    }, 45 * 60 * 1000); // 45 minutes
+});
diff --git a/static/js/i18n.js b/static/js/i18n.js
new file mode 100644
index 00000000..78acb7bd
--- /dev/null
+++ b/static/js/i18n.js
@@ -0,0 +1,298 @@
+/**
+ * Lightweight i18n (internationalization) system for Speakr
+ * Handles loading and managing translations with template variable support
+ */
+
+class I18n {
+    constructor() {
+        this.translations = {};
+        this.currentLocale = 'en';
+        this.fallbackLocale = 'en';
+        this.loadedLocales = new Set();
+    }
+
+    /**
+     * Initialize i18n with default locale
+     * @param {string} locale - Initial locale code (e.g., 'en', 'es', 'fr', 'zh')
+     */
+    async init(locale = 'en') {
+        // Get saved locale from localStorage or use browser language
+        const savedLocale = localStorage.getItem('preferredLanguage');
+        const browserLocale = navigator.language.split('-')[0];
+        
+        this.currentLocale = savedLocale || locale || browserLocale || 'en';
+        
+        // Load the initial locale
+        await this.loadLocale(this.currentLocale);
+        
+        // Load fallback locale if different
+        if (this.currentLocale !== this.fallbackLocale) {
+            await this.loadLocale(this.fallbackLocale);
+        }
+    }
+
+    /**
+     * Load translations for a specific locale
+     * @param {string} locale - Locale code to load
+     */
+    async loadLocale(locale) {
+        if (this.loadedLocales.has(locale)) {
+            return; // Already loaded
+        }
+
+        try {
+            const response = await fetch(`/static/locales/${locale}.json`);
+            if (!response.ok) {
+                throw new Error(`Failed to load locale: ${locale}`);
+            }
+            
+            const translations = await response.json();
+            this.translations[locale] = translations;
+            this.loadedLocales.add(locale);
+            
+            console.log(`Loaded locale: ${locale}`);
+        } catch (error) {
+            console.error(`Error loading locale ${locale}:`, error);
+            
+            // If failed to load requested locale and it's not the fallback, try fallback
+            if (locale !== this.fallbackLocale) {
+                console.log(`Failed to load ${locale}, will use ${this.fallbackLocale} as fallback`);
+                // Don't change currentLocale - keep user's preference
+                // Just ensure fallback translations are available
+                await this.loadLocale(this.fallbackLocale);
+            }
+        }
+    }
+
+    /**
+     * Change the current locale
+     * @param {string} locale - New locale code
+     */
+    async setLocale(locale) {
+        await this.loadLocale(locale);
+        this.currentLocale = locale;
+        localStorage.setItem('preferredLanguage', locale);
+        
+        // Dispatch custom event for locale change
+        window.dispatchEvent(new CustomEvent('localeChanged', { detail: { locale } }));
+    }
+
+    /**
+     * Get the current locale
+     * @returns {string} Current locale code
+     */
+    getLocale() {
+        return this.currentLocale;
+    }
+
+    /**
+     * Get available locales
+     * @returns {Array} List of available locale codes
+     */
+    getAvailableLocales() {
+        return [
+            { code: 'en', name: 'English', nativeName: 'English' },
+            { code: 'es', name: 'Spanish', nativeName: 'Español' },
+            { code: 'fr', name: 'French', nativeName: 'Français' },
+            { code: 'zh', name: 'Chinese', nativeName: '中文' },
+            { code: 'ru', name: 'Russian', nativeName: 'Русский' },
+            { code: 'pt-BR', name: 'Portuguese (Brazil)', nativeName: 'Português (Brasil)' },
+        ];
+    }
+
+    /**
+     * Translate a key with optional parameters
+     * @param {string} key - Translation key (e.g., 'common.save' or 'nav.upload')
+     * @param {Object} params - Optional parameters for template replacement
+     * @param {string} locale - Optional specific locale (defaults to current)
+     * @returns {string} Translated text
+     */
+    t(key, params = {}, locale = null) {
+        const targetLocale = locale || this.currentLocale;
+        
+        // Get translation from current locale or fallback
+        let translation = this.getNestedTranslation(targetLocale, key);
+        
+        if (!translation && targetLocale !== this.fallbackLocale) {
+            translation = this.getNestedTranslation(this.fallbackLocale, key);
+        }
+        
+        if (!translation) {
+            console.warn(`Translation not found for key: ${key}`);
+            return key; // Return the key itself as fallback
+        }
+        
+        // Replace template variables
+        return this.interpolate(translation, params);
+    }
+
+    /**
+     * Get nested translation value from object
+     * @param {string} locale - Locale to search in
+     * @param {string} key - Dot-separated key path
+     * @returns {string|null} Translation value or null
+     */
+    getNestedTranslation(locale, key) {
+        if (!this.translations[locale]) {
+            return null;
+        }
+        
+        const keys = key.split('.');
+        let value = this.translations[locale];
+        
+        for (const k of keys) {
+            if (value && typeof value === 'object' && k in value) {
+                value = value[k];
+            } else {
+                return null;
+            }
+        }
+        
+        return typeof value === 'string' ? value : null;
+    }
+
+    /**
+     * Replace template variables in translation string
+     * @param {string} text - Text with placeholders like {{variable}}
+     * @param {Object} params - Parameters to replace
+     * @returns {string} Interpolated text
+     */
+    interpolate(text, params) {
+        return text.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+            return params.hasOwnProperty(key) ? params[key] : match;
+        });
+    }
+
+    /**
+     * Handle pluralization
+     * @param {string} key - Base translation key
+     * @param {number} count - Count for pluralization
+     * @param {Object} params - Additional parameters
+     * @returns {string} Translated text with proper pluralization
+     */
+    tc(key, count, params = {}) {
+        const pluralKey = count === 1 ? key : `${key}Plural`;
+        return this.t(pluralKey, { ...params, count });
+    }
+
+    /**
+     * Format date according to locale
+     * @param {Date|string} date - Date to format
+     * @param {Object} options - Intl.DateTimeFormat options
+     * @returns {string} Formatted date string
+     */
+    formatDate(date, options = {}) {
+        const d = date instanceof Date ? date : new Date(date);
+        return new Intl.DateTimeFormat(this.currentLocale, options).format(d);
+    }
+
+    /**
+     * Format number according to locale
+     * @param {number} number - Number to format
+     * @param {Object} options - Intl.NumberFormat options
+     * @returns {string} Formatted number string
+     */
+    formatNumber(number, options = {}) {
+        return new Intl.NumberFormat(this.currentLocale, options).format(number);
+    }
+
+    /**
+     * Format file size with appropriate unit
+     * @param {number} bytes - Size in bytes
+     * @returns {string} Formatted file size
+     */
+    formatFileSize(bytes) {
+        const units = ['bytes', 'kilobytes', 'megabytes', 'gigabytes'];
+        const unitValues = [1, 1024, 1048576, 1073741824];
+        
+        let unitIndex = 0;
+        for (let i = unitValues.length - 1; i >= 0; i--) {
+            if (bytes >= unitValues[i]) {
+                unitIndex = i;
+                break;
+            }
+        }
+        
+        const value = Math.round(bytes / unitValues[unitIndex] * 10) / 10;
+        return this.t(`fileSize.${units[unitIndex]}`, { count: value });
+    }
+
+    /**
+     * Format duration with appropriate unit
+     * @param {number} seconds - Duration in seconds
+     * @returns {string} Formatted duration
+     */
+    formatDuration(seconds) {
+        if (seconds < 60) {
+            return this.tc('duration.seconds', Math.round(seconds), { count: Math.round(seconds) });
+        } else if (seconds < 3600) {
+            const minutes = Math.round(seconds / 60);
+            return this.tc('duration.minutes', minutes, { count: minutes });
+        } else {
+            const hours = Math.round(seconds / 3600 * 10) / 10;
+            return this.tc('duration.hours', hours, { count: hours });
+        }
+    }
+
+    /**
+     * Format relative time (e.g., "2 hours ago")
+     * @param {Date|string} date - Date to format
+     * @returns {string} Formatted relative time
+     */
+    formatRelativeTime(date) {
+        const d = date instanceof Date ? date : new Date(date);
+        const now = new Date();
+        const diffSeconds = Math.floor((now - d) / 1000);
+        
+        if (diffSeconds < 60) {
+            return this.t('time.justNow');
+        } else if (diffSeconds < 3600) {
+            const minutes = Math.floor(diffSeconds / 60);
+            return minutes === 1 
+                ? this.t('time.minuteAgo')
+                : this.t('time.minutesAgo', { count: minutes });
+        } else if (diffSeconds < 86400) {
+            const hours = Math.floor(diffSeconds / 3600);
+            return hours === 1
+                ? this.t('time.hourAgo')
+                : this.t('time.hoursAgo', { count: hours });
+        } else if (diffSeconds < 604800) {
+            const days = Math.floor(diffSeconds / 86400);
+            return days === 1
+                ? this.t('time.dayAgo')
+                : this.t('time.daysAgo', { count: days });
+        } else if (diffSeconds < 2592000) {
+            const weeks = Math.floor(diffSeconds / 604800);
+            return weeks === 1
+                ? this.t('time.weekAgo')
+                : this.t('time.weeksAgo', { count: weeks });
+        } else if (diffSeconds < 31536000) {
+            const months = Math.floor(diffSeconds / 2592000);
+            return months === 1
+                ? this.t('time.monthAgo')
+                : this.t('time.monthsAgo', { count: months });
+        } else {
+            const years = Math.floor(diffSeconds / 31536000);
+            return years === 1
+                ? this.t('time.yearAgo')
+                : this.t('time.yearsAgo', { count: years });
+        }
+    }
+}
+
+// Create global i18n instance
+const i18n = new I18n();
+
+// Create a fallback t function immediately
+if (typeof window !== 'undefined') {
+    // Ensure window.i18n exists with at least a basic t function
+    window.i18n = i18n;
+    
+    // Add a fallback t function if the class method isn't ready
+    if (!window.i18n.t) {
+        window.i18n.t = function(key, params) {
+            console.warn('i18n.t called before initialization, returning key:', key);
+            return key;
+        };
+    }
+}
\ No newline at end of file
diff --git a/static/js/loading.js b/static/js/loading.js
new file mode 100644
index 00000000..630a59ad
--- /dev/null
+++ b/static/js/loading.js
@@ -0,0 +1,201 @@
+/**
+ * App loading overlay management
+ * Prevents FOUC (Flash of Unstyled Content) during page initialization
+ */
+
+window.AppLoader = {
+    initialized: false,
+    readyChecks: [],
+    initTime: Date.now(),
+
+    /**
+     * Initialize the loading system
+     */
+    init() {
+        if (this.initialized) return;
+        this.initialized = true;
+        this.initTime = Date.now();
+
+        // Add loading class to body
+        document.body.classList.add('app-loading');
+
+        // Create loading overlay if it doesn't exist
+        if (!document.querySelector('.app-loading-overlay')) {
+            this.createOverlay();
+        }
+
+        // Set up ready checks
+        this.setupReadyChecks();
+    },
+
+    /**
+     * Create the loading overlay element
+     */
+    createOverlay() {
+        const overlay = document.createElement('div');
+        overlay.className = 'app-loading-overlay';
+        overlay.innerHTML = `
+            <div class="app-loading-content">
+                <div class="app-loading-spinner"></div>
+                <div class="app-loading-text">Loading...</div>
+            </div>
+        `;
+        document.body.appendChild(overlay);
+    },
+
+    /**
+     * Add a ready check condition
+     */
+    addReadyCheck(checkFn) {
+        this.readyChecks.push(checkFn);
+    },
+
+    /**
+     * Setup default ready checks
+     */
+    setupReadyChecks() {
+        // Check if DOM is ready
+        this.addReadyCheck(() => {
+            return document.readyState === 'complete' || document.readyState === 'interactive';
+        });
+
+        // Check if styles are loaded (optional - don't block on this)
+        this.addReadyCheck(() => {
+            try {
+                const styles = document.querySelector('link[href*="styles.css"]');
+                // If stylesheet isn't found or loaded, continue anyway after 2 seconds
+                return !styles || styles.sheet || (Date.now() - this.initTime) > 2000;
+            } catch (e) {
+                console.warn('Error checking stylesheet:', e);
+                return true; // Don't block on stylesheet errors
+            }
+        });
+
+        // Check if theme is initialized (optional - don't block on this)
+        this.addReadyCheck(() => {
+            try {
+                const computed = window.getComputedStyle(document.documentElement);
+                const bgPrimary = computed.getPropertyValue('--bg-primary').trim();
+                // Accept if property exists or if 2 seconds have passed
+                return bgPrimary !== '' || (Date.now() - this.initTime) > 2000;
+            } catch (e) {
+                console.warn('Error checking CSS variables:', e);
+                return true; // Don't block on CSS variable errors
+            }
+        });
+    },
+
+    /**
+     * Check if all conditions are met
+     */
+    isReady() {
+        if (this.readyChecks.length === 0) return true;
+        return this.readyChecks.every(check => {
+            try {
+                return check();
+            } catch (e) {
+                return false;
+            }
+        });
+    },
+
+    /**
+     * Hide the loading overlay
+     */
+    hide() {
+        try {
+            // Remove app-loading class immediately to show content
+            document.body.classList.remove('app-loading');
+
+            // Find all loading overlays (might be multiple)
+            const overlays = document.querySelectorAll('.app-loading-overlay');
+
+            if (overlays.length > 0) {
+                overlays.forEach(overlay => {
+                    // Force display none immediately in Firefox
+                    overlay.style.display = 'none';
+
+                    // Then do graceful removal
+                    overlay.classList.add('fade-out');
+                    setTimeout(() => {
+                        try {
+                            overlay.remove();
+                        } catch (e) {
+                            console.warn('Could not remove overlay:', e);
+                        }
+                    }, 100);
+                });
+            }
+
+            console.log('Loader hidden successfully');
+        } catch (error) {
+            console.error('Error hiding loader:', error);
+            // Force hide everything as last resort
+            document.body.classList.remove('app-loading');
+            const overlays = document.querySelectorAll('.app-loading-overlay');
+            overlays.forEach(o => {
+                o.style.display = 'none';
+                try { o.remove(); } catch (e) {}
+            });
+        }
+    },
+
+    /**
+     * Wait for app to be ready then hide overlay
+     */
+    async waitForReady(timeout = 5000) {
+        const startTime = Date.now();
+        let hideExecuted = false;
+
+        const safeHide = () => {
+            if (!hideExecuted) {
+                hideExecuted = true;
+                try {
+                    this.hide();
+                } catch (error) {
+                    console.error('Error hiding loader:', error);
+                    // Force hide even if error occurs
+                    const overlay = document.querySelector('.app-loading-overlay');
+                    if (overlay) overlay.remove();
+                    document.body.classList.remove('app-loading');
+                }
+            }
+        };
+
+        const checkReady = () => {
+            try {
+                const elapsed = Date.now() - startTime;
+                if (this.isReady()) {
+                    console.log('App ready, hiding loader');
+                    safeHide();
+                } else if (elapsed > timeout) {
+                    console.warn('Loader timeout reached, forcing hide');
+                    safeHide();
+                } else {
+                    requestAnimationFrame(checkReady);
+                }
+            } catch (error) {
+                console.error('Error in checkReady:', error);
+                safeHide();
+            }
+        };
+
+        // Hard timeout as absolute failsafe - hide after 10 seconds no matter what
+        setTimeout(() => {
+            if (!hideExecuted) {
+                console.warn('Hard timeout reached (10s), forcing loader hide');
+                safeHide();
+            }
+        }, 10000);
+
+        // Start checking after a minimum display time
+        setTimeout(checkReady, 300);
+    }
+};
+
+// Auto-initialize on script load
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', () => AppLoader.init());
+} else {
+    AppLoader.init();
+}
\ No newline at end of file
diff --git a/static/js/modules/composables/audio.js b/static/js/modules/composables/audio.js
new file mode 100644
index 00000000..0ac77abc
--- /dev/null
+++ b/static/js/modules/composables/audio.js
@@ -0,0 +1,893 @@
+/**
+ * Audio recording composable
+ * Handles microphone/system audio recording with visualizers and wake lock
+ */
+
+import * as RecordingDB from '../db/recording-persistence.js';
+import * as IncognitoStorage from '../db/incognito-storage.js';
+
+export function useAudio(state, utils) {
+    const {
+        isRecording, mediaRecorder, audioContext, analyser, micAnalyser, systemAnalyser,
+        audioChunks, recordingTime, recordingInterval, recordingMode, audioBlobURL,
+        estimatedFileSize, actualBitrate, recordingNotes, recordingQuality,
+        maxRecordingMB, fileSizeWarningShown, sizeCheckInterval, recordingDisclaimer,
+        showRecordingDisclaimerModal, pendingRecordingMode, currentView, isDarkMode, wakeLock, animationFrameId,
+        activeStreams, visualizer, micVisualizer, systemVisualizer, canRecordAudio,
+        canRecordSystemAudio, systemAudioSupported, systemAudioError, globalError,
+        selectedTagIds, selectedFolderId, asrLanguage, asrMinSpeakers, asrMaxSpeakers, uploadQueue,
+        progressPopupMinimized, progressPopupClosed,
+        // Incognito mode
+        enableIncognitoMode, incognitoMode, incognitoRecording, incognitoProcessing,
+        processingMessage, processingProgress, selectedRecording
+    } = state;
+
+    const { showToast, setGlobalError, formatFileSize, startUploadQueue } = utils;
+
+    // Local state for pending streams and chunk tracking
+    let pendingDisplayStream = null;
+    let currentChunkIndex = 0;
+
+    // iOS detection
+    const isiOS = () => {
+        return /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream;
+    };
+
+    // Silent audio for iOS wake lock alternative
+    let silentAudio = null;
+
+    // Create silent audio using data URL (1 second of silence)
+    const createSilentAudio = () => {
+        if (!silentAudio) {
+            // Base64 encoded 1-second silent MP3
+            const silentMp3 = 'data:audio/mp3;base64,SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4Ljc2LjEwMAAAAAAAAAAAAAAA//tQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWGluZwAAAA8AAAACAAADhAC7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7v////////////////////////////////////////////////////////////AAAAAExhdmM1OC4xMwAAAAAAAAAAAAAAACQCgAAAAAAAAAOEfxVqYQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA//sQZAAP8AAAaQAAAAgAAA0gAAABAAABpAAAACAAADSAAAAETEFNRTMuMTAwVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV//sQZDwP8AAAaQAAAAgAAA0gAAABAAABpAAAACAAADSAAAAEVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVU=';
+            silentAudio = new Audio(silentMp3);
+            silentAudio.loop = true;
+            silentAudio.volume = 0.01; // Very low volume, almost silent
+        }
+        return silentAudio;
+    };
+
+    // Start iOS wake lock (play silent audio)
+    const startiOSWakeLock = async () => {
+        try {
+            const audio = createSilentAudio();
+            await audio.play();
+            console.log('[iOS Wake Lock] Silent audio playing to prevent sleep');
+            return true;
+        } catch (error) {
+            console.warn('[iOS Wake Lock] Failed to start silent audio:', error);
+            showToast('iOS wake lock may not work - keep screen active', 'warning');
+            return false;
+        }
+    };
+
+    // Stop iOS wake lock (stop silent audio)
+    const stopiOSWakeLock = () => {
+        if (silentAudio) {
+            silentAudio.pause();
+            silentAudio.currentTime = 0;
+            console.log('[iOS Wake Lock] Silent audio stopped');
+        }
+    };
+
+    // Acquire wake lock to prevent screen from sleeping during recording
+    const acquireWakeLock = async () => {
+        // iOS doesn't support Wake Lock API - use silent audio instead
+        if (isiOS()) {
+            return await startiOSWakeLock();
+        }
+
+        // Android/Desktop: use native Wake Lock API
+        try {
+            if ('wakeLock' in navigator) {
+                wakeLock.value = await navigator.wakeLock.request('screen');
+                console.log('[WakeLock] Acquired - screen will stay awake during recording');
+
+                // Listen for wake lock release
+                wakeLock.value.addEventListener('release', () => {
+                    console.log('[WakeLock] Released');
+                });
+
+                return true;
+            } else {
+                console.warn('[WakeLock] Wake Lock API not supported');
+                showToast('Screen may sleep during recording', 'info');
+                return false;
+            }
+        } catch (err) {
+            console.warn('[WakeLock] Could not acquire:', err.message);
+            if (err.name === 'NotAllowedError') {
+                showToast('Screen lock permission denied', 'warning');
+            } else if (err.name === 'NotSupportedError') {
+                showToast('Wake lock not supported on this device', 'info');
+            }
+            return false;
+        }
+    };
+
+    // Release wake lock
+    const releaseWakeLock = async () => {
+        // iOS: stop silent audio
+        if (isiOS()) {
+            stopiOSWakeLock();
+            return;
+        }
+
+        // Android/Desktop: release native wake lock
+        if (wakeLock.value) {
+            try {
+                await wakeLock.value.release();
+                wakeLock.value = null;
+                console.log('[WakeLock] Released');
+            } catch (err) {
+                console.warn('[WakeLock] Could not release:', err.message);
+            }
+        }
+    };
+
+    // Show recording notification
+    const showRecordingNotification = async () => {
+        if ('Notification' in window && Notification.permission === 'granted') {
+            // Notifications handled by service worker
+        }
+    };
+
+    // Note: System audio capability detection is now handled by computed property
+    // canRecordSystemAudio = computed(() => navigator.mediaDevices && navigator.mediaDevices.getDisplayMedia)
+
+    // Hide recording notification
+    const hideRecordingNotification = async () => {
+        // Notifications cleared when recording stops
+    };
+
+    // Handle visibility change (for wake lock re-acquisition)
+    const handleVisibilityChange = async () => {
+        if (document.visibilityState === 'visible' && isRecording.value) {
+            console.log('[Visibility] Page visible, re-acquiring wake lock');
+            const acquired = await acquireWakeLock();
+            if (acquired) {
+                showToast('Recording resumed - screen will stay awake', 'success');
+            }
+        } else if (document.visibilityState === 'hidden' && isRecording.value) {
+            console.log('[Visibility] Page hidden, wake lock may be released by browser');
+        }
+    };
+
+    // Start recording
+    // IMPORTANT: For Firefox, getDisplayMedia MUST be the first async call from user gesture
+    const startRecording = async (mode = 'microphone') => {
+        const needsDisplayMedia = mode === 'system' || mode === 'both';
+
+        // For system audio modes, get display media FIRST before any other operations
+        // This is required for Firefox's "transient activation" security model
+        if (needsDisplayMedia) {
+            try {
+                const displayStream = await navigator.mediaDevices.getDisplayMedia({
+                    video: true,
+                    audio: true
+                });
+
+                // Check if we got an audio track
+                const audioTrack = displayStream.getAudioTracks()[0];
+                if (!audioTrack) {
+                    displayStream.getTracks().forEach(track => track.stop());
+                    showToast('No audio track - check "Share audio" option', 'error');
+                    return;
+                }
+
+                // Store stream for use after disclaimer (if any)
+                pendingDisplayStream = displayStream;
+            } catch (error) {
+                console.error('[Recording] Failed to get display media:', error);
+                if (error.name === 'NotAllowedError') {
+                    showToast('Screen sharing was cancelled', 'error');
+                } else {
+                    showToast(`Failed to capture: ${error.message}`, 'error');
+                }
+                return;
+            }
+        }
+
+        // Now check for disclaimer (after we've secured the display stream)
+        if (recordingDisclaimer.value && recordingDisclaimer.value.trim() !== '') {
+            showRecordingDisclaimerModal.value = true;
+            pendingRecordingMode.value = mode;
+            return;
+        }
+
+        await startRecordingInternal(mode);
+    };
+
+    // Accept recording disclaimer and start recording
+    const acceptRecordingDisclaimer = async () => {
+        showRecordingDisclaimerModal.value = false;
+        await startRecordingInternal(pendingRecordingMode.value || 'microphone');
+    };
+
+    // Cancel recording disclaimer
+    const cancelRecordingDisclaimer = () => {
+        showRecordingDisclaimerModal.value = false;
+        // Clean up pending display stream if user cancels
+        if (pendingDisplayStream) {
+            pendingDisplayStream.getTracks().forEach(track => track.stop());
+            pendingDisplayStream = null;
+        }
+        pendingRecordingMode.value = null;
+    };
+
+    // Internal start recording function
+    const startRecordingInternal = async (mode) => {
+        try {
+            recordingMode.value = mode;
+            audioChunks.value = [];
+            recordingTime.value = 0;
+            estimatedFileSize.value = 0;
+            fileSizeWarningShown.value = false;
+
+            // Initialize IndexedDB session
+            currentChunkIndex = 0;
+
+            let stream;
+            let combinedStream;
+
+            if (mode === 'microphone') {
+                if (!canRecordAudio.value) {
+                    throw new Error('Microphone recording is not available. Make sure you are using HTTPS.');
+                }
+                stream = await navigator.mediaDevices.getUserMedia({
+                    audio: {
+                        echoCancellation: true,
+                        noiseSuppression: true,
+                        sampleRate: 48000
+                    }
+                });
+                activeStreams.value = [stream];
+
+                audioContext.value = new (window.AudioContext || window.webkitAudioContext)();
+                const source = audioContext.value.createMediaStreamSource(stream);
+                analyser.value = audioContext.value.createAnalyser();
+                analyser.value.fftSize = 256;
+                source.connect(analyser.value);
+
+            } else if (mode === 'system') {
+                if (!canRecordSystemAudio.value) {
+                    throw new Error('System audio recording is not available. Make sure you are using HTTPS.');
+                }
+                // Use pre-obtained display stream (required for Firefox user gesture)
+                // or get it now for browsers that don't require immediate call
+                const isFirefox = navigator.userAgent.toLowerCase().indexOf('firefox') > -1;
+
+                if (pendingDisplayStream) {
+                    stream = pendingDisplayStream;
+                    pendingDisplayStream = null;
+                } else {
+                    const displayMediaConstraints = {
+                        video: true,
+                        audio: isFirefox ? true : {
+                            echoCancellation: false,
+                            noiseSuppression: false,
+                            autoGainControl: false
+                        }
+                    };
+                    stream = await navigator.mediaDevices.getDisplayMedia(displayMediaConstraints);
+                }
+
+                const audioTrack = stream.getAudioTracks()[0];
+                if (!audioTrack) {
+                    stream.getTracks().forEach(track => track.stop());
+                    const browserName = isFirefox ? 'Firefox' : 'your browser';
+                    throw new Error(
+                        `No system audio track available. In ${browserName}, please:\n` +
+                        `1. Share a BROWSER TAB that is actively playing audio\n` +
+                        `2. Make sure "Share tab audio" checkbox is checked\n` +
+                        `3. The audio must be playing when you start sharing`
+                    );
+                }
+
+                // Stop video track
+                stream.getVideoTracks().forEach(track => track.stop());
+                stream = new MediaStream([audioTrack]);
+                activeStreams.value = [stream];
+
+                audioContext.value = new (window.AudioContext || window.webkitAudioContext)();
+                const source = audioContext.value.createMediaStreamSource(stream);
+                analyser.value = audioContext.value.createAnalyser();
+                analyser.value.fftSize = 256;
+                source.connect(analyser.value);
+
+            } else if (mode === 'both') {
+                if (!canRecordAudio.value || !canRecordSystemAudio.value) {
+                    throw new Error('Recording is not available. Make sure you are using HTTPS.');
+                }
+                const micStream = await navigator.mediaDevices.getUserMedia({
+                    audio: {
+                        echoCancellation: true,
+                        noiseSuppression: true,
+                        sampleRate: 48000
+                    }
+                });
+
+                // Use pre-obtained display stream or get it now
+                const isFirefox = navigator.userAgent.toLowerCase().indexOf('firefox') > -1;
+                let displayStream;
+
+                if (pendingDisplayStream) {
+                    displayStream = pendingDisplayStream;
+                    pendingDisplayStream = null;
+                } else {
+                    displayStream = await navigator.mediaDevices.getDisplayMedia({
+                        video: true,
+                        audio: isFirefox ? true : {
+                            echoCancellation: false,
+                            noiseSuppression: false,
+                            autoGainControl: false
+                        }
+                    });
+                }
+
+                const systemAudioTrack = displayStream.getAudioTracks()[0];
+                if (!systemAudioTrack) {
+                    micStream.getTracks().forEach(track => track.stop());
+                    displayStream.getTracks().forEach(track => track.stop());
+                    const browserName = isFirefox ? 'Firefox' : 'your browser';
+                    throw new Error(
+                        `No system audio track available. In ${browserName}, please:\n` +
+                        `1. Share a BROWSER TAB that is actively playing audio\n` +
+                        `2. Make sure "Share tab audio" checkbox is checked\n` +
+                        `3. The audio must be playing when you start sharing`
+                    );
+                }
+
+                // Stop video tracks
+                displayStream.getVideoTracks().forEach(track => track.stop());
+
+                // Create audio context and combine streams
+                audioContext.value = new (window.AudioContext || window.webkitAudioContext)();
+                const destination = audioContext.value.createMediaStreamDestination();
+
+                const micSource = audioContext.value.createMediaStreamSource(micStream);
+                const systemSource = audioContext.value.createMediaStreamSource(new MediaStream([systemAudioTrack]));
+
+                // Create analysers for each source
+                micAnalyser.value = audioContext.value.createAnalyser();
+                micAnalyser.value.fftSize = 256;
+                systemAnalyser.value = audioContext.value.createAnalyser();
+                systemAnalyser.value.fftSize = 256;
+
+                micSource.connect(micAnalyser.value);
+                micSource.connect(destination);
+                systemSource.connect(systemAnalyser.value);
+                systemSource.connect(destination);
+
+                combinedStream = destination.stream;
+                activeStreams.value = [micStream, displayStream];
+                stream = combinedStream;
+            }
+
+            // Determine best mime type
+            const mimeType = MediaRecorder.isTypeSupported('audio/webm;codecs=opus')
+                ? 'audio/webm;codecs=opus'
+                : 'audio/webm';
+
+            const recorder = new MediaRecorder(stream, { mimeType });
+
+            // Start IndexedDB recording session - convert Vue reactive objects to plain objects
+            try {
+                await RecordingDB.startRecordingSession({
+                    mode,
+                    notes: recordingNotes.value || '',
+                    tags: selectedTagIds.value ? [...selectedTagIds.value] : [], // Convert reactive array to plain array
+                    asrOptions: {
+                        language: asrLanguage.value || '',
+                        min_speakers: asrMinSpeakers.value || '',
+                        max_speakers: asrMaxSpeakers.value || ''
+                    },
+                    mimeType
+                });
+            } catch (dbError) {
+                console.warn('[Recording] IndexedDB persistence failed, continuing without persistence:', dbError);
+            }
+
+            recorder.ondataavailable = async (event) => {
+                if (event.data.size > 0) {
+                    audioChunks.value.push(event.data);
+
+                    // Save chunk to IndexedDB for crash recovery
+                    try {
+                        await RecordingDB.saveChunk(event.data, currentChunkIndex);
+                        await RecordingDB.updateRecordingMetadata({
+                            duration: recordingTime.value,
+                            notes: recordingNotes.value || ''
+                        });
+                        currentChunkIndex++;
+                    } catch (dbError) {
+                        // Don't spam console - recording continues in memory regardless
+                    }
+                }
+            };
+
+            recorder.onstop = () => {
+                const blob = new Blob(audioChunks.value, { type: mimeType });
+                audioBlobURL.value = URL.createObjectURL(blob);
+                stopSizeMonitoring();
+            };
+
+            mediaRecorder.value = recorder;
+            recorder.start(5000); // 5-second chunks for less overhead while still enabling crash recovery
+            isRecording.value = true;
+            // Switch to recording view immediately so pending wake-lock/notification awaits don't block Safari rendering
+            currentView.value = 'recording';
+
+            // Start timer
+            recordingInterval.value = setInterval(() => {
+                recordingTime.value++;
+            }, 1000);
+
+            // Start size monitoring
+            startSizeMonitoring();
+
+            // Acquire wake lock
+            await acquireWakeLock();
+
+            // Show notification
+            await showRecordingNotification();
+
+            // Start visualizers
+            drawVisualizers();
+
+            // Notify service worker
+            if ('serviceWorker' in navigator && navigator.serviceWorker.controller) {
+                navigator.serviceWorker.controller.postMessage({
+                    type: 'RECORDING_STATE',
+                    isRecording: true
+                });
+            }
+
+        } catch (error) {
+            console.error('Recording error:', error);
+            setGlobalError(`Failed to start recording: ${error.message}`);
+
+            // Clean up any started streams
+            if (activeStreams.value.length > 0) {
+                activeStreams.value.forEach(stream => {
+                    stream.getTracks().forEach(track => track.stop());
+                });
+                activeStreams.value = [];
+            }
+        }
+    };
+
+    // Stop recording
+    const stopRecording = async () => {
+        if (mediaRecorder.value && isRecording.value) {
+            mediaRecorder.value.stop();
+            isRecording.value = false;
+
+            // Clear the recording timer
+            if (recordingInterval.value) {
+                clearInterval(recordingInterval.value);
+                recordingInterval.value = null;
+            }
+
+            stopSizeMonitoring();
+            cancelAnimationFrame(animationFrameId.value);
+            animationFrameId.value = null;
+
+            // Stop all active media streams (mic, screen share, etc.)
+            if (activeStreams.value.length > 0) {
+                activeStreams.value.forEach(stream => {
+                    stream.getTracks().forEach(track => track.stop());
+                });
+                activeStreams.value = [];
+            }
+
+            // Release wake lock
+            await releaseWakeLock();
+
+            // Hide recording notification
+            await hideRecordingNotification();
+
+            // Notify service worker
+            if ('serviceWorker' in navigator && navigator.serviceWorker.controller) {
+                navigator.serviceWorker.controller.postMessage({
+                    type: 'RECORDING_STATE',
+                    isRecording: false,
+                    duration: recordingTime.value
+                });
+            }
+        }
+    };
+
+    // Upload recorded audio
+    const uploadRecordedAudio = async () => {
+        if (!audioBlobURL.value) {
+            setGlobalError("No recorded audio to upload.");
+            return;
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const recordedFile = new File(audioChunks.value, `recording-${timestamp}.webm`, { type: 'audio/webm' });
+
+        // Get selected tags as objects and create a DEEP copy to prevent reactivity issues
+        const selectedTagsTemp = selectedTagIds.value.map(tagId => {
+            const tag = state.availableTags.value.find(t => t.id == tagId);
+            return tag || null;
+        }).filter(Boolean);
+
+        // Deep clone to completely break reactivity chain - JSON parse/stringify removes all proxies
+        const selectedTags = JSON.parse(JSON.stringify(selectedTagsTemp));
+
+        // Add to upload queue
+        uploadQueue.value.push({
+            file: recordedFile,
+            notes: recordingNotes.value,
+            tags: selectedTags, // Completely non-reactive deep copy
+            folder_id: selectedFolderId.value,
+            preserveOptions: true, // Prevents startUpload from overwriting recording's options
+            asrOptions: {
+                language: asrLanguage.value,
+                min_speakers: asrMinSpeakers.value,
+                max_speakers: asrMaxSpeakers.value
+            },
+            status: 'queued',
+            recordingId: null,
+            clientId: `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,
+            error: null,
+            willAutoSummarize: false // Server will tell us via SUMMARIZING status
+        });
+
+        // Clear IndexedDB session after successful queue
+        try {
+            await RecordingDB.clearRecordingSession();
+        } catch (dbError) {
+            console.warn('[Recording] Failed to clear IndexedDB session:', dbError);
+        }
+
+        discardRecording();
+
+        // Return to upload view (main UI)
+        currentView.value = 'upload';
+
+        // Start upload immediately
+        progressPopupMinimized.value = false;
+        progressPopupClosed.value = false;
+
+        if (startUploadQueue) {
+            startUploadQueue();
+        }
+    };
+
+    // Upload recorded audio in incognito mode
+    const uploadRecordedAudioIncognito = async () => {
+        if (!audioBlobURL.value) {
+            setGlobalError("No recorded audio to upload.");
+            return;
+        }
+
+        // Check if incognito state is available
+        if (!incognitoProcessing || !incognitoRecording) {
+            console.warn('[Incognito] Incognito state not available, falling back to normal upload');
+            uploadRecordedAudio();
+            return;
+        }
+
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const recordedFile = new File(audioChunks.value, `recording-${timestamp}.webm`, { type: 'audio/webm' });
+
+        incognitoProcessing.value = true;
+        processingMessage.value = 'Processing recording in incognito mode...';
+        processingProgress.value = 10;
+        progressPopupMinimized.value = false;
+        progressPopupClosed.value = false;
+
+        try {
+            const formData = new FormData();
+            formData.append('file', recordedFile);
+
+            // Add ASR options
+            if (asrLanguage.value) {
+                formData.append('language', asrLanguage.value);
+            }
+            if (asrMinSpeakers.value && asrMinSpeakers.value !== '') {
+                formData.append('min_speakers', asrMinSpeakers.value.toString());
+            }
+            if (asrMaxSpeakers.value && asrMaxSpeakers.value !== '') {
+                formData.append('max_speakers', asrMaxSpeakers.value.toString());
+            }
+
+            // Request auto-summarization
+            formData.append('auto_summarize', 'true');
+
+            processingMessage.value = 'Uploading recording for incognito processing...';
+            processingProgress.value = 20;
+
+            console.log('[Incognito] Uploading recorded audio');
+
+            const response = await fetch('/api/recordings/incognito', {
+                method: 'POST',
+                body: formData
+            });
+
+            processingProgress.value = 50;
+
+            // Parse response
+            const contentType = response.headers.get('content-type') || '';
+            if (!contentType.includes('application/json')) {
+                const text = await response.text();
+                const titleMatch = text.match(/<title>([^<]+)<\/title>/i);
+                throw new Error(titleMatch?.[1] || `Server error (${response.status})`);
+            }
+
+            const data = await response.json();
+
+            if (!response.ok || data.error) {
+                throw new Error(data.error || `Processing failed with status ${response.status}`);
+            }
+
+            processingProgress.value = 80;
+            processingMessage.value = 'Processing complete!';
+
+            // Store result in sessionStorage
+            const incognitoData = {
+                id: 'incognito',
+                incognito: true,
+                title: data.title || 'Incognito Recording',
+                transcription: data.transcription,
+                summary: data.summary,
+                summary_html: data.summary_html,
+                created_at: data.created_at,
+                original_filename: data.original_filename,
+                file_size: data.file_size,
+                audio_duration_seconds: data.audio_duration_seconds,
+                processing_time_seconds: data.processing_time_seconds,
+                status: 'COMPLETED'
+            };
+
+            IncognitoStorage.saveIncognitoRecording(incognitoData);
+            incognitoRecording.value = incognitoData;
+
+            // Clear IndexedDB session
+            try {
+                await RecordingDB.clearRecordingSession();
+            } catch (dbError) {
+                console.warn('[Recording] Failed to clear IndexedDB session:', dbError);
+            }
+
+            // Clear recording state (must await so currentView='upload' completes
+            // before we override it with 'detail', otherwise the deferred
+            // currentView='upload' fires after 'detail' and the view watcher
+            // clears incognito data thinking we navigated away)
+            await discardRecording();
+
+            processingProgress.value = 100;
+            processingMessage.value = 'Incognito recording ready!';
+
+            // Auto-select the incognito recording and switch to detail view
+            selectedRecording.value = incognitoData;
+            currentView.value = 'detail';
+
+            // Reset incognito mode toggle
+            incognitoMode.value = false;
+
+            // Show toast
+            showToast('Incognito recording processed - data will be lost when tab closes', 'fa-user-secret');
+
+            console.log('[Incognito] Recording processing complete');
+
+        } catch (error) {
+            console.error('[Incognito] Recording processing failed:', error);
+            setGlobalError(`Incognito processing failed: ${error.message}`);
+        } finally {
+            incognitoProcessing.value = false;
+        }
+    };
+
+    // Discard recording
+    const discardRecording = async () => {
+        if (audioBlobURL.value) {
+            URL.revokeObjectURL(audioBlobURL.value);
+        }
+        audioBlobURL.value = null;
+        audioChunks.value = [];
+        isRecording.value = false;
+        recordingTime.value = 0;
+        if (recordingInterval.value) clearInterval(recordingInterval.value);
+        recordingNotes.value = '';
+        selectedTagIds.value = [];
+        asrLanguage.value = '';
+        asrMinSpeakers.value = '';
+        asrMaxSpeakers.value = '';
+
+        // Clear IndexedDB session
+        try {
+            await RecordingDB.clearRecordingSession();
+        } catch (dbError) {
+            console.warn('[Recording] Failed to clear IndexedDB session:', dbError);
+        }
+
+        await releaseWakeLock();
+        await hideRecordingNotification();
+
+        // Return to upload view
+        currentView.value = 'upload';
+    };
+
+    // Draw single visualizer
+    const drawSingleVisualizer = (analyserNode, canvasElement) => {
+        if (!analyserNode || !canvasElement) return;
+
+        const bufferLength = analyserNode.frequencyBinCount;
+        const dataArray = new Uint8Array(bufferLength);
+        analyserNode.getByteFrequencyData(dataArray);
+
+        const canvasCtx = canvasElement.getContext('2d');
+        const WIDTH = canvasElement.width;
+        const HEIGHT = canvasElement.height;
+
+        canvasCtx.clearRect(0, 0, WIDTH, HEIGHT);
+
+        const barWidth = (WIDTH / bufferLength) * 1.5;
+        let barHeight;
+        let x = 0;
+
+        const buttonColor = getComputedStyle(document.documentElement).getPropertyValue('--bg-button').trim();
+        const buttonHoverColor = getComputedStyle(document.documentElement).getPropertyValue('--bg-button-hover').trim();
+
+        const gradient = canvasCtx.createLinearGradient(0, 0, 0, HEIGHT);
+        if (isDarkMode.value) {
+            gradient.addColorStop(0, buttonColor);
+            gradient.addColorStop(0.6, buttonHoverColor);
+            gradient.addColorStop(1, 'rgba(0, 0, 0, 0.2)');
+        } else {
+            gradient.addColorStop(0, buttonColor);
+            gradient.addColorStop(0.5, buttonHoverColor);
+            gradient.addColorStop(1, 'rgba(0, 0, 0, 0.1)');
+        }
+
+        for (let i = 0; i < bufferLength; i++) {
+            barHeight = dataArray[i] / 2.5;
+            canvasCtx.fillStyle = gradient;
+            canvasCtx.fillRect(x, HEIGHT - barHeight, barWidth, barHeight);
+            x += barWidth + 2;
+        }
+    };
+
+    // Draw visualizers
+    const drawVisualizers = () => {
+        if (!isRecording.value) {
+            if (animationFrameId.value) {
+                cancelAnimationFrame(animationFrameId.value);
+                animationFrameId.value = null;
+            }
+            return;
+        }
+
+        animationFrameId.value = requestAnimationFrame(drawVisualizers);
+
+        if (recordingMode.value === 'both') {
+            drawSingleVisualizer(micAnalyser.value, micVisualizer.value);
+            drawSingleVisualizer(systemAnalyser.value, systemVisualizer.value);
+        } else {
+            drawSingleVisualizer(analyser.value, visualizer.value);
+        }
+    };
+
+    // Update file size estimate
+    const updateFileSizeEstimate = () => {
+        if (!isRecording.value || !audioChunks.value.length) return;
+
+        const totalSize = audioChunks.value.reduce((sum, chunk) => sum + chunk.size, 0);
+        estimatedFileSize.value = totalSize;
+
+        if (recordingTime.value > 0) {
+            actualBitrate.value = (totalSize * 8) / recordingTime.value;
+        }
+
+        // Check for size warning
+        const sizeMB = totalSize / (1024 * 1024);
+        const warningThresholdMB = maxRecordingMB.value * 0.8;
+
+        if (sizeMB > warningThresholdMB && !fileSizeWarningShown.value) {
+            fileSizeWarningShown.value = true;
+            showToast(
+                `Recording size is ${formatFileSize(totalSize)}. Consider stopping soon.`,
+                'fa-exclamation-triangle',
+                5000
+            );
+        }
+
+        // Auto-stop if max size reached
+        if (sizeMB > maxRecordingMB.value) {
+            stopRecording();
+            showToast(
+                `Recording automatically stopped at ${formatFileSize(totalSize)}`,
+                'fa-stop-circle',
+                7000
+            );
+        }
+    };
+
+    // Start size monitoring
+    const startSizeMonitoring = () => {
+        if (sizeCheckInterval.value) {
+            clearInterval(sizeCheckInterval.value);
+        }
+        sizeCheckInterval.value = setInterval(updateFileSizeEstimate, 2000);
+    };
+
+    // Stop size monitoring
+    const stopSizeMonitoring = () => {
+        if (sizeCheckInterval.value) {
+            clearInterval(sizeCheckInterval.value);
+            sizeCheckInterval.value = null;
+        }
+    };
+
+    // Check if there's an unsaved recording
+    const hasUnsavedRecording = () => {
+        return isRecording.value || audioBlobURL.value;
+    };
+
+    // Recover recording from IndexedDB
+    const recoverRecordingFromDB = async () => {
+        try {
+            const recovered = await RecordingDB.recoverRecording();
+            if (!recovered) {
+                return null;
+            }
+
+            // Restore chunks
+            audioChunks.value = recovered.chunks;
+
+            // Create blob URL
+            const blob = new Blob(recovered.chunks, { type: recovered.metadata.mimeType });
+            audioBlobURL.value = URL.createObjectURL(blob);
+
+            // Restore metadata
+            recordingMode.value = recovered.metadata.mode;
+            recordingNotes.value = recovered.metadata.notes;
+            selectedTagIds.value = recovered.metadata.tags;
+            recordingTime.value = recovered.metadata.duration;
+
+            if (recovered.metadata.asrOptions) {
+                asrLanguage.value = recovered.metadata.asrOptions.language || '';
+                asrMinSpeakers.value = recovered.metadata.asrOptions.min_speakers || '';
+                asrMaxSpeakers.value = recovered.metadata.asrOptions.max_speakers || '';
+            }
+
+            console.log('[Recording] Successfully recovered recording from IndexedDB');
+            return recovered.metadata;
+        } catch (error) {
+            console.error('[Recording] Failed to recover recording:', error);
+            return null;
+        }
+    };
+
+    // No initialization needed - system audio detection is handled by computed property
+    const initializeAudio = async () => {
+        // Placeholder for future initialization if needed
+    };
+
+    return {
+        startRecording,
+        stopRecording,
+        discardRecording,
+        uploadRecordedAudio,
+        uploadRecordedAudioIncognito,
+        acceptRecordingDisclaimer,
+        cancelRecordingDisclaimer,
+        updateFileSizeEstimate,
+        startSizeMonitoring,
+        stopSizeMonitoring,
+        drawVisualizers,
+        drawSingleVisualizer,
+        handleVisibilityChange,
+        hasUnsavedRecording,
+        acquireWakeLock,
+        releaseWakeLock,
+        initializeAudio,
+        recoverRecordingFromDB,
+        checkForRecoverableRecording: RecordingDB.checkForRecoverableRecording,
+        clearRecordingSession: RecordingDB.clearRecordingSession
+    };
+}
diff --git a/static/js/modules/composables/audioPlayer.js b/static/js/modules/composables/audioPlayer.js
new file mode 100644
index 00000000..6a949d76
--- /dev/null
+++ b/static/js/modules/composables/audioPlayer.js
@@ -0,0 +1,338 @@
+/**
+ * Audio Player Composable
+ *
+ * Centralized audio playback functionality for consistent behavior across the app.
+ * This module handles:
+ * - Playback state (playing, paused, loading)
+ * - Time tracking (current time, duration)
+ * - Volume/mute control
+ * - Seeking with progress bar support
+ * - Server-side duration support (for formats like WebM that don't report duration)
+ *
+ * Usage:
+ *   const player = useAudioPlayer(ref, computed);
+ *   // In template: @loadedmetadata="player.handleLoadedMetadata"
+ *   // When recording changes: player.setServerDuration(recording.audio_duration)
+ */
+
+export function useAudioPlayer(ref, computed) {
+    // --- State ---
+    const isPlaying = ref(false);
+    const currentTime = ref(0);
+    const duration = ref(0);
+    const isMuted = ref(false);
+    const isLoading = ref(false);
+    const volume = ref(1.0);
+
+    // Progress bar drag state
+    const isDragging = ref(false);
+    const dragPreviewPercent = ref(0);
+
+    // Track if we have a reliable server-side duration
+    let hasServerDuration = false;
+
+    // --- Computed ---
+    const progressPercent = computed(() => {
+        // Use preview position while dragging for smooth UI
+        if (isDragging.value) {
+            return dragPreviewPercent.value;
+        }
+        if (!duration.value) return 0;
+        return (currentTime.value / duration.value) * 100;
+    });
+
+    // Preview time display while dragging
+    const displayCurrentTime = computed(() => {
+        if (isDragging.value && duration.value) {
+            return (dragPreviewPercent.value / 100) * duration.value;
+        }
+        return currentTime.value;
+    });
+
+    // --- Duration Management ---
+
+    /**
+     * Set duration from server-side ffprobe value.
+     * This is more reliable than browser metadata for some formats (WebM, etc.)
+     */
+    const setServerDuration = (serverDuration) => {
+        if (serverDuration && isFinite(serverDuration) && serverDuration > 0) {
+            duration.value = serverDuration;
+            hasServerDuration = true;
+        } else {
+            hasServerDuration = false;
+        }
+    };
+
+    /**
+     * Try to set duration from browser, only if we don't have a server-side value.
+     * Browser duration can be Infinity for some WebM files.
+     */
+    const trySetBrowserDuration = (browserDuration) => {
+        if (hasServerDuration) {
+            // Don't overwrite reliable server-side duration
+            return;
+        }
+        if (browserDuration && isFinite(browserDuration) && browserDuration > 0) {
+            duration.value = browserDuration;
+        }
+    };
+
+    // --- Event Handlers ---
+
+    const handlePlayPause = (event) => {
+        isPlaying.value = !event.target.paused;
+    };
+
+    const handleLoadedMetadata = (event) => {
+        trySetBrowserDuration(event.target.duration);
+        isLoading.value = false;
+    };
+
+    const handleDurationChange = (event) => {
+        // WebM and some formats may initially report Infinity duration
+        // This handler catches when the actual duration becomes available
+        trySetBrowserDuration(event.target.duration);
+    };
+
+    const handleTimeUpdate = (event) => {
+        currentTime.value = event.target.currentTime;
+
+        // Fallback: if duration wasn't set yet, try to get it now
+        if (!duration.value || duration.value === 0) {
+            trySetBrowserDuration(event.target.duration);
+        }
+    };
+
+    const handleEnded = () => {
+        isPlaying.value = false;
+        currentTime.value = 0;
+    };
+
+    const handleWaiting = () => {
+        isLoading.value = true;
+    };
+
+    const handleCanPlay = (event) => {
+        isLoading.value = false;
+
+        // Fallback: try to get duration if not set yet
+        if (!duration.value || duration.value === 0) {
+            trySetBrowserDuration(event.target.duration);
+        }
+    };
+
+    const handleVolumeChange = (event) => {
+        volume.value = event.target.volume;
+        isMuted.value = event.target.muted;
+    };
+
+    // --- Actions ---
+
+    /**
+     * Get the audio element. Override this for custom element selection.
+     */
+    let getAudioElement = () => {
+        return document.querySelector('audio[ref="audioPlayerElement"]') ||
+               document.querySelector('video[ref="audioPlayerElement"]') ||
+               document.querySelector('audio') ||
+               document.querySelector('video');
+    };
+
+    /**
+     * Set custom audio element getter.
+     */
+    const setAudioElementGetter = (getter) => {
+        getAudioElement = getter;
+    };
+
+    const play = () => {
+        const audio = getAudioElement();
+        if (audio) {
+            audio.play().catch(err => console.warn('Play failed:', err));
+        }
+    };
+
+    const pause = () => {
+        const audio = getAudioElement();
+        if (audio) {
+            audio.pause();
+        }
+    };
+
+    const togglePlayback = () => {
+        const audio = getAudioElement();
+        if (!audio) return;
+
+        if (audio.paused) {
+            audio.play().catch(err => console.warn('Play failed:', err));
+        } else {
+            audio.pause();
+        }
+    };
+
+    const seekTo = (time) => {
+        const audio = getAudioElement();
+        if (!audio || !isFinite(time)) return;
+
+        const maxTime = isFinite(audio.duration) ? audio.duration : time;
+        audio.currentTime = Math.max(0, Math.min(time, maxTime));
+    };
+
+    const seekByPercent = (percent) => {
+        const audio = getAudioElement();
+        if (!audio || !duration.value || !isFinite(duration.value)) return;
+
+        const time = (percent / 100) * duration.value;
+        audio.currentTime = time;
+    };
+
+    const setVolume = (value) => {
+        const audio = getAudioElement();
+        if (audio) {
+            audio.volume = Math.max(0, Math.min(1, value));
+            volume.value = audio.volume;
+        }
+    };
+
+    const toggleMute = () => {
+        const audio = getAudioElement();
+        if (!audio) return;
+
+        if (audio.muted || audio.volume === 0) {
+            audio.muted = false;
+            if (audio.volume === 0) {
+                audio.volume = 0.5;
+            }
+            isMuted.value = false;
+        } else {
+            audio.muted = true;
+            isMuted.value = true;
+        }
+    };
+
+    // --- Progress Bar Drag Support ---
+
+    const startProgressDrag = (event) => {
+        const bar = event.currentTarget.querySelector('.h-2') || event.currentTarget;
+        const rect = bar.getBoundingClientRect();
+        const isTouch = event.type === 'touchstart';
+
+        const getPercent = (evt) => {
+            const clientX = isTouch ? evt.touches[0].clientX : evt.clientX;
+            return Math.max(0, Math.min(100, ((clientX - rect.left) / rect.width) * 100));
+        };
+
+        // Start dragging - show preview
+        isDragging.value = true;
+        dragPreviewPercent.value = getPercent(event);
+
+        const onMove = (evt) => {
+            evt.preventDefault();
+            const clientX = isTouch ? evt.touches[0].clientX : evt.clientX;
+            dragPreviewPercent.value = Math.max(0, Math.min(100, ((clientX - rect.left) / rect.width) * 100));
+        };
+
+        const onUp = () => {
+            document.removeEventListener(isTouch ? 'touchmove' : 'mousemove', onMove);
+            document.removeEventListener(isTouch ? 'touchend' : 'mouseup', onUp);
+            // Seek to final position on release
+            seekByPercent(dragPreviewPercent.value);
+            isDragging.value = false;
+        };
+
+        document.addEventListener(isTouch ? 'touchmove' : 'mousemove', onMove, { passive: false });
+        document.addEventListener(isTouch ? 'touchend' : 'mouseup', onUp);
+    };
+
+    // --- Utility ---
+
+    const formatTime = (seconds) => {
+        if (!seconds || isNaN(seconds)) return '0:00';
+        const hours = Math.floor(seconds / 3600);
+        const mins = Math.floor((seconds % 3600) / 60);
+        const secs = Math.floor(seconds % 60);
+        if (hours > 0) {
+            return `${hours}:${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+        }
+        return `${mins}:${secs.toString().padStart(2, '0')}`;
+    };
+
+    /**
+     * Reset all player state (call when changing recordings)
+     */
+    const reset = () => {
+        isPlaying.value = false;
+        currentTime.value = 0;
+        duration.value = 0;
+        isMuted.value = false;
+        isLoading.value = false;
+        hasServerDuration = false;
+    };
+
+    /**
+     * Initialize with a recording object.
+     * Automatically uses server-side duration if available.
+     */
+    const initWithRecording = (recording) => {
+        reset();
+        if (recording && recording.audio_duration) {
+            setServerDuration(recording.audio_duration);
+        }
+    };
+
+    return {
+        // State
+        isPlaying,
+        currentTime,
+        duration,
+        isMuted,
+        isLoading,
+        volume,
+        isDragging,
+        dragPreviewPercent,
+
+        // Computed
+        progressPercent,
+        displayCurrentTime,
+
+        // Duration management
+        setServerDuration,
+        trySetBrowserDuration,
+
+        // Event handlers (wire these to <audio> element)
+        handlePlayPause,
+        handleLoadedMetadata,
+        handleDurationChange,
+        handleTimeUpdate,
+        handleEnded,
+        handleWaiting,
+        handleCanPlay,
+        handleVolumeChange,
+
+        // Actions
+        play,
+        pause,
+        togglePlayback,
+        seekTo,
+        seekByPercent,
+        setVolume,
+        toggleMute,
+        startProgressDrag,
+        setAudioElementGetter,
+
+        // Utility
+        formatTime,
+        reset,
+        initWithRecording
+    };
+}
+
+/**
+ * Create a standalone audio player instance.
+ * Use this for pages that don't have Vue's ref/computed (like share.html).
+ */
+export function createStandalonePlayer(Vue) {
+    const { ref, computed } = Vue;
+    return useAudioPlayer(ref, computed);
+}
diff --git a/static/js/modules/composables/bulk-operations.js b/static/js/modules/composables/bulk-operations.js
new file mode 100644
index 00000000..3d3d8c6c
--- /dev/null
+++ b/static/js/modules/composables/bulk-operations.js
@@ -0,0 +1,475 @@
+/**
+ * Bulk Operations Composable
+ * Handles bulk API operations for multiple recordings
+ */
+
+const { ref, computed } = Vue;
+
+export function useBulkOperations({
+    selectedRecordingIds,
+    selectedRecordings,
+    recordings,
+    selectedRecording,
+    bulkActionInProgress,
+    availableTags,
+    availableFolders,
+    showToast,
+    setGlobalError,
+    startReprocessingPoll
+}) {
+    // Modal state
+    const showBulkDeleteModal = ref(false);
+    const showBulkTagModal = ref(false);
+    const showBulkReprocessModal = ref(false);
+    const showBulkFolderModal = ref(false);
+    const bulkTagAction = ref('add'); // 'add' or 'remove'
+    const bulkTagSelectedId = ref('');
+    const bulkReprocessType = ref('summary'); // 'transcription' or 'summary'
+
+    // Get CSRF token
+    const getCsrfToken = () => {
+        return document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+    };
+
+    // Helper to get selected IDs as array
+    const getSelectedIds = () => {
+        return Array.from(selectedRecordingIds.value);
+    };
+
+    // =========================================
+    // Bulk Delete
+    // =========================================
+
+    const openBulkDeleteModal = () => {
+        showBulkDeleteModal.value = true;
+    };
+
+    const closeBulkDeleteModal = () => {
+        showBulkDeleteModal.value = false;
+    };
+
+    const executeBulkDelete = async () => {
+        const ids = getSelectedIds();
+        if (ids.length === 0) return;
+
+        bulkActionInProgress.value = true;
+        closeBulkDeleteModal();
+
+        try {
+            const response = await fetch('/api/recordings/bulk', {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({ recording_ids: ids })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to delete recordings');
+            }
+
+            // Remove deleted recordings from local state
+            const deletedIds = new Set(data.deleted_ids || ids);
+            recordings.value = recordings.value.filter(r => !deletedIds.has(r.id));
+
+            // Clear selected recording if it was deleted
+            if (selectedRecording.value && deletedIds.has(selectedRecording.value.id)) {
+                selectedRecording.value = null;
+            }
+
+            // Remove deleted IDs from selection
+            deletedIds.forEach(id => selectedRecordingIds.value.delete(id));
+
+            const count = deletedIds.size;
+            showToast(`${count} recording${count !== 1 ? 's' : ''} deleted`, 'fa-trash', 3000, 'success');
+        } catch (error) {
+            console.error('Bulk delete error:', error);
+            setGlobalError(`Failed to delete recordings: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    // =========================================
+    // Bulk Tag Operations
+    // =========================================
+
+    const openBulkTagModal = (action = 'add') => {
+        bulkTagAction.value = action;
+        bulkTagSelectedId.value = '';
+        showBulkTagModal.value = true;
+    };
+
+    const closeBulkTagModal = () => {
+        showBulkTagModal.value = false;
+        bulkTagSelectedId.value = '';
+    };
+
+    const executeBulkTag = async () => {
+        const ids = getSelectedIds();
+        const tagId = bulkTagSelectedId.value;
+        const action = bulkTagAction.value;
+
+        // Validate before making API call
+        if (ids.length === 0) {
+            console.warn('No recordings selected for bulk tag operation');
+            return;
+        }
+        if (!tagId && tagId !== 0) {
+            console.warn('No tag selected for bulk tag operation');
+            return;
+        }
+
+        bulkActionInProgress.value = true;
+        closeBulkTagModal();
+
+        try {
+            const response = await fetch('/api/recordings/bulk-tags', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({
+                    recording_ids: ids,
+                    tag_id: parseInt(tagId),
+                    action: action
+                })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || `Failed to ${action} tag`);
+            }
+
+            // Update local state
+            const tag = availableTags.value.find(t => t.id == tagId);
+            if (tag) {
+                const affectedIds = new Set(data.affected_ids || ids);
+                recordings.value.forEach(recording => {
+                    if (affectedIds.has(recording.id)) {
+                        if (!recording.tags) recording.tags = [];
+
+                        if (action === 'add') {
+                            // Add tag if not already present
+                            if (!recording.tags.find(t => t.id === tag.id)) {
+                                recording.tags.push(tag);
+                            }
+                        } else {
+                            // Remove tag
+                            recording.tags = recording.tags.filter(t => t.id !== tag.id);
+                        }
+                    }
+                });
+
+                // Update selected recording if affected
+                if (selectedRecording.value && affectedIds.has(selectedRecording.value.id)) {
+                    if (!selectedRecording.value.tags) selectedRecording.value.tags = [];
+
+                    if (action === 'add') {
+                        if (!selectedRecording.value.tags.find(t => t.id === tag.id)) {
+                            selectedRecording.value.tags.push(tag);
+                        }
+                    } else {
+                        selectedRecording.value.tags = selectedRecording.value.tags.filter(t => t.id !== tag.id);
+                    }
+                }
+            }
+
+            const count = data.affected_ids?.length || ids.length;
+            const actionText = action === 'add' ? 'added to' : 'removed from';
+            showToast(`Tag ${actionText} ${count} recording${count !== 1 ? 's' : ''}`, 'fa-tags', 3000, 'success');
+        } catch (error) {
+            console.error('Bulk tag error:', error);
+            setGlobalError(`Failed to ${action} tag: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    // =========================================
+    // Bulk Reprocess
+    // =========================================
+
+    const openBulkReprocessModal = () => {
+        bulkReprocessType.value = 'summary';
+        showBulkReprocessModal.value = true;
+    };
+
+    const closeBulkReprocessModal = () => {
+        showBulkReprocessModal.value = false;
+    };
+
+    const executeBulkReprocess = async () => {
+        const ids = getSelectedIds();
+        if (ids.length === 0) return;
+
+        bulkActionInProgress.value = true;
+        closeBulkReprocessModal();
+
+        try {
+            const response = await fetch('/api/recordings/bulk-reprocess', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({
+                    recording_ids: ids,
+                    type: bulkReprocessType.value
+                })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to queue reprocessing');
+            }
+
+            // Update status for queued recordings
+            const queuedIds = new Set(data.queued_ids || ids);
+            const newStatus = bulkReprocessType.value === 'transcription' ? 'PROCESSING' : 'SUMMARIZING';
+
+            recordings.value.forEach(recording => {
+                if (queuedIds.has(recording.id)) {
+                    recording.status = newStatus;
+                    // Start polling for each
+                    if (startReprocessingPoll) {
+                        startReprocessingPoll(recording.id);
+                    }
+                }
+            });
+
+            if (selectedRecording.value && queuedIds.has(selectedRecording.value.id)) {
+                selectedRecording.value.status = newStatus;
+            }
+
+            const count = queuedIds.size;
+            const typeText = bulkReprocessType.value === 'transcription' ? 'Transcription' : 'Summary';
+            showToast(`${typeText} reprocessing queued for ${count} recording${count !== 1 ? 's' : ''}`, 'fa-sync-alt', 3000, 'success');
+        } catch (error) {
+            console.error('Bulk reprocess error:', error);
+            setGlobalError(`Failed to queue reprocessing: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    // =========================================
+    // Bulk Toggle (Inbox/Highlight)
+    // =========================================
+
+    const bulkToggleInbox = async (value = null) => {
+        const ids = getSelectedIds();
+        if (ids.length === 0) return;
+
+        // If no value specified, toggle based on majority
+        if (value === null) {
+            const inboxCount = selectedRecordings.value.filter(r => r.is_inbox).length;
+            value = inboxCount < ids.length / 2;
+        }
+
+        bulkActionInProgress.value = true;
+
+        try {
+            const response = await fetch('/api/recordings/bulk-toggle', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({
+                    recording_ids: ids,
+                    field: 'inbox',
+                    value: value
+                })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to update inbox status');
+            }
+
+            // Update local state
+            const affectedIds = new Set(data.affected_ids || ids);
+            recordings.value.forEach(recording => {
+                if (affectedIds.has(recording.id)) {
+                    recording.is_inbox = value;
+                }
+            });
+
+            if (selectedRecording.value && affectedIds.has(selectedRecording.value.id)) {
+                selectedRecording.value.is_inbox = value;
+            }
+
+            const count = affectedIds.size;
+            const actionText = value ? 'added to' : 'removed from';
+            showToast(`${count} recording${count !== 1 ? 's' : ''} ${actionText} inbox`, 'fa-inbox', 3000, 'success');
+        } catch (error) {
+            console.error('Bulk toggle inbox error:', error);
+            setGlobalError(`Failed to update inbox status: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    const bulkToggleHighlight = async (value = null) => {
+        const ids = getSelectedIds();
+        if (ids.length === 0) return;
+
+        // If no value specified, toggle based on majority
+        if (value === null) {
+            const highlightCount = selectedRecordings.value.filter(r => r.is_highlighted).length;
+            value = highlightCount < ids.length / 2;
+        }
+
+        bulkActionInProgress.value = true;
+
+        try {
+            const response = await fetch('/api/recordings/bulk-toggle', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({
+                    recording_ids: ids,
+                    field: 'highlight',
+                    value: value
+                })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to update highlight status');
+            }
+
+            // Update local state
+            const affectedIds = new Set(data.affected_ids || ids);
+            recordings.value.forEach(recording => {
+                if (affectedIds.has(recording.id)) {
+                    recording.is_highlighted = value;
+                }
+            });
+
+            if (selectedRecording.value && affectedIds.has(selectedRecording.value.id)) {
+                selectedRecording.value.is_highlighted = value;
+            }
+
+            const count = affectedIds.size;
+            const actionText = value ? 'highlighted' : 'unhighlighted';
+            showToast(`${count} recording${count !== 1 ? 's' : ''} ${actionText}`, 'fa-star', 3000, 'success');
+        } catch (error) {
+            console.error('Bulk toggle highlight error:', error);
+            setGlobalError(`Failed to update highlight status: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    // =========================================
+    // Bulk Folder Assignment
+    // =========================================
+
+    const bulkAssignFolder = async (folderId) => {
+        const ids = getSelectedIds();
+        if (ids.length === 0) return;
+
+        bulkActionInProgress.value = true;
+        showBulkFolderModal.value = false;
+
+        try {
+            const response = await fetch('/api/recordings/bulk/folder', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': getCsrfToken()
+                },
+                body: JSON.stringify({
+                    recording_ids: ids,
+                    folder_id: folderId
+                })
+            });
+
+            const data = await response.json();
+
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to update folders');
+            }
+
+            // Update local state
+            const folder = folderId ? availableFolders.value.find(f => f.id === folderId) : null;
+            recordings.value.forEach(recording => {
+                if (ids.includes(recording.id)) {
+                    recording.folder_id = folderId;
+                    recording.folder = folder;
+                }
+            });
+
+            // Update selected recording if affected
+            if (selectedRecording.value && ids.includes(selectedRecording.value.id)) {
+                selectedRecording.value.folder_id = folderId;
+                selectedRecording.value.folder = folder;
+            }
+
+            // Update folder recording counts
+            if (availableFolders.value) {
+                availableFolders.value.forEach(f => {
+                    const count = recordings.value.filter(r => r.folder_id === f.id).length;
+                    f.recording_count = count;
+                });
+            }
+
+            const count = data.updated_count || ids.length;
+            if (folderId) {
+                showToast(`${count} recording${count !== 1 ? 's' : ''} moved to "${folder?.name || 'folder'}"`, 'fa-folder', 3000, 'success');
+            } else {
+                showToast(`${count} recording${count !== 1 ? 's' : ''} removed from folder`, 'fa-folder-minus', 3000, 'success');
+            }
+        } catch (error) {
+            console.error('Bulk folder assignment error:', error);
+            setGlobalError(`Failed to update folders: ${error.message}`);
+        } finally {
+            bulkActionInProgress.value = false;
+        }
+    };
+
+    return {
+        // Modal state
+        showBulkDeleteModal,
+        showBulkTagModal,
+        showBulkReprocessModal,
+        showBulkFolderModal,
+        bulkTagAction,
+        bulkTagSelectedId,
+        bulkReprocessType,
+
+        // Bulk Delete
+        openBulkDeleteModal,
+        closeBulkDeleteModal,
+        executeBulkDelete,
+
+        // Bulk Tag
+        openBulkTagModal,
+        closeBulkTagModal,
+        executeBulkTag,
+
+        // Bulk Reprocess
+        openBulkReprocessModal,
+        closeBulkReprocessModal,
+        executeBulkReprocess,
+
+        // Bulk Toggle
+        bulkToggleInbox,
+        bulkToggleHighlight,
+
+        // Bulk Folder
+        bulkAssignFolder
+    };
+}
diff --git a/static/js/modules/composables/bulk-selection.js b/static/js/modules/composables/bulk-selection.js
new file mode 100644
index 00000000..1da48c55
--- /dev/null
+++ b/static/js/modules/composables/bulk-selection.js
@@ -0,0 +1,111 @@
+/**
+ * Bulk Selection Composable
+ * Handles multi-select functionality for recordings
+ */
+
+const { computed } = Vue;
+
+export function useBulkSelection({
+    selectionMode,
+    selectedRecordingIds,
+    recordings,
+    selectedRecording,
+    currentView
+}) {
+    // Computed
+    const selectedCount = computed(() => selectedRecordingIds.value.size);
+
+    const selectedRecordings = computed(() => {
+        return recordings.value.filter(r => selectedRecordingIds.value.has(r.id));
+    });
+
+    const allVisibleSelected = computed(() => {
+        if (recordings.value.length === 0) return false;
+        return recordings.value.every(r => selectedRecordingIds.value.has(r.id));
+    });
+
+    const isSelected = (id) => {
+        return selectedRecordingIds.value.has(id);
+    };
+
+    // Methods
+    const enterSelectionMode = () => {
+        selectionMode.value = true;
+        selectedRecordingIds.value = new Set();
+    };
+
+    const exitSelectionMode = () => {
+        selectionMode.value = false;
+        selectedRecordingIds.value = new Set();
+    };
+
+    const toggleSelection = (id) => {
+        const newSet = new Set(selectedRecordingIds.value);
+        if (newSet.has(id)) {
+            newSet.delete(id);
+        } else {
+            newSet.add(id);
+        }
+        selectedRecordingIds.value = newSet;
+    };
+
+    const selectAll = () => {
+        const newSet = new Set();
+        recordings.value.forEach(r => newSet.add(r.id));
+        selectedRecordingIds.value = newSet;
+    };
+
+    const clearSelection = () => {
+        selectedRecordingIds.value = new Set();
+    };
+
+    // Keyboard handler for selection mode
+    const handleSelectionKeyboard = (event) => {
+        if (!selectionMode.value) return;
+
+        // Escape to exit selection mode
+        if (event.key === 'Escape') {
+            exitSelectionMode();
+            event.preventDefault();
+        }
+
+        // Ctrl/Cmd + A to select all
+        if ((event.ctrlKey || event.metaKey) && event.key === 'a') {
+            // Only if not in an input field
+            if (document.activeElement.tagName !== 'INPUT' &&
+                document.activeElement.tagName !== 'TEXTAREA' &&
+                !document.activeElement.isContentEditable) {
+                event.preventDefault();
+                selectAll();
+            }
+        }
+    };
+
+    // Initialize keyboard listener
+    const initSelectionKeyboardListeners = () => {
+        document.addEventListener('keydown', handleSelectionKeyboard);
+    };
+
+    const cleanupSelectionKeyboardListeners = () => {
+        document.removeEventListener('keydown', handleSelectionKeyboard);
+    };
+
+    return {
+        // Computed
+        selectedCount,
+        selectedRecordings,
+        allVisibleSelected,
+
+        // Methods
+        isSelected,
+        enterSelectionMode,
+        exitSelectionMode,
+        toggleSelection,
+        selectAll,
+        clearSelection,
+
+        // Keyboard
+        initSelectionKeyboardListeners,
+        cleanupSelectionKeyboardListeners
+    };
+}
diff --git a/static/js/modules/composables/chat.js b/static/js/modules/composables/chat.js
new file mode 100644
index 00000000..f202e8f6
--- /dev/null
+++ b/static/js/modules/composables/chat.js
@@ -0,0 +1,380 @@
+/**
+ * Chat composable
+ * Handles AI chat functionality with streaming responses
+ */
+
+export function useChat(state, utils) {
+    const {
+        showChat, isChatMaximized, chatMessages, chatInput,
+        isChatLoading, chatMessagesRef, chatInputRef, selectedRecording, csrfToken
+    } = state;
+
+    const { showToast, setGlobalError, onChatComplete, t } = utils;
+
+    // Helper function to check if chat is scrolled to bottom (within bottom 5%)
+    const isChatScrolledToBottom = () => {
+        if (!chatMessagesRef.value) return true;
+        const { scrollTop, scrollHeight, clientHeight } = chatMessagesRef.value;
+        const scrollableHeight = scrollHeight - clientHeight;
+        if (scrollableHeight <= 0) return true;
+        const scrollPercentage = scrollTop / scrollableHeight;
+        return scrollPercentage >= 0.95;
+    };
+
+    // Helper function to scroll chat to bottom
+    const scrollChatToBottom = () => {
+        if (chatMessagesRef.value) {
+            requestAnimationFrame(() => {
+                if (chatMessagesRef.value) {
+                    chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
+                }
+            });
+        }
+    };
+
+    const focusChatInput = () => {
+        Vue.nextTick(() => {
+            if (chatInputRef.value) {
+                chatInputRef.value.focus();
+            }
+        });
+    };
+
+    const toggleChatMaximize = () => {
+        if (isChatMaximized.value) {
+            isChatMaximized.value = false;
+        } else {
+            isChatMaximized.value = true;
+            if (!showChat.value) {
+                showChat.value = true;
+            }
+        }
+    };
+
+    const sendChatMessage = async () => {
+        if (!chatInput.value.trim() || isChatLoading.value || !selectedRecording.value || selectedRecording.value.status !== 'COMPLETED') {
+            return;
+        }
+
+        const message = chatInput.value.trim();
+
+        if (!Array.isArray(chatMessages.value)) {
+            chatMessages.value = [];
+        }
+
+        chatMessages.value.push({ role: 'user', content: message });
+        chatInput.value = '';
+        isChatLoading.value = true;
+        focusChatInput();
+
+        await Vue.nextTick();
+        scrollChatToBottom();
+
+        let assistantMessage = null;
+
+        try {
+            const messageHistory = chatMessages.value
+                .slice(0, -1)
+                .map(msg => ({ role: msg.role, content: msg.content }));
+
+            // Check if this is an incognito recording
+            const isIncognito = selectedRecording.value.incognito === true;
+            let response;
+
+            if (isIncognito) {
+                // Use incognito chat endpoint - pass transcription directly
+                response = await fetch('/api/recordings/incognito/chat', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        transcription: selectedRecording.value.transcription,
+                        participants: selectedRecording.value.participants || '',
+                        notes: selectedRecording.value.notes || '',
+                        message: message,
+                        message_history: messageHistory
+                    })
+                });
+            } else {
+                // Use regular chat endpoint
+                response = await fetch('/chat', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        recording_id: selectedRecording.value.id,
+                        message: message,
+                        message_history: messageHistory
+                    })
+                });
+            }
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to get chat response');
+            }
+
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+
+            const processStream = async () => {
+                let isFirstChunk = true;
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) break;
+
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split('\n');
+                    buffer = lines.pop();
+
+                    for (const line of lines) {
+                        if (line.startsWith('data: ')) {
+                            const jsonStr = line.substring(6);
+                            // Handle [DONE] marker from incognito endpoint
+                            if (jsonStr === '[DONE]') {
+                                return;
+                            }
+                            if (jsonStr) {
+                                try {
+                                    const data = JSON.parse(jsonStr);
+                                    if (data.thinking) {
+                                        const shouldScroll = isChatScrolledToBottom();
+
+                                        if (isFirstChunk) {
+                                            isChatLoading.value = false;
+                                            assistantMessage = Vue.reactive({
+                                                role: 'assistant',
+                                                content: '',
+                                                html: '',
+                                                thinking: data.thinking,
+                                                thinkingExpanded: false
+                                            });
+                                            chatMessages.value.push(assistantMessage);
+                                            isFirstChunk = false;
+                                        } else if (assistantMessage) {
+                                            if (assistantMessage.thinking) {
+                                                assistantMessage.thinking += '\n\n' + data.thinking;
+                                            } else {
+                                                assistantMessage.thinking = data.thinking;
+                                            }
+                                        }
+
+                                        if (shouldScroll) {
+                                            await Vue.nextTick();
+                                            scrollChatToBottom();
+                                        }
+                                    }
+                                    // Handle both 'delta' (regular) and 'content' (incognito) formats
+                                    const textContent = data.delta || data.content;
+                                    if (textContent) {
+                                        const shouldScroll = isChatScrolledToBottom();
+
+                                        if (isFirstChunk) {
+                                            isChatLoading.value = false;
+                                            assistantMessage = Vue.reactive({
+                                                role: 'assistant',
+                                                content: '',
+                                                html: '',
+                                                thinking: '',
+                                                thinkingExpanded: false
+                                            });
+                                            chatMessages.value.push(assistantMessage);
+                                            isFirstChunk = false;
+                                        }
+
+                                        assistantMessage.content += textContent;
+                                        assistantMessage.html = marked.parse(assistantMessage.content);
+
+                                        if (shouldScroll) {
+                                            await Vue.nextTick();
+                                            scrollChatToBottom();
+                                        }
+                                    }
+                                    if (data.end_of_stream) {
+                                        return;
+                                    }
+                                    if (data.error) {
+                                        if (data.budget_exceeded) {
+                                            throw new Error(t('adminDashboard.tokenBudgetExceeded'));
+                                        }
+                                        throw new Error(data.error);
+                                    }
+                                } catch (e) {
+                                    console.error('Error parsing stream data:', e);
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            await processStream();
+
+        } catch (error) {
+            console.error('Chat Error:', error);
+            if (assistantMessage) {
+                assistantMessage.content = `Error: ${error.message}`;
+                assistantMessage.html = `<span class="text-red-500">Error: ${error.message}</span>`;
+            } else {
+                chatMessages.value.push({
+                    role: 'assistant',
+                    content: `Error: ${error.message}`,
+                    html: `<span class="text-red-500">Error: ${error.message}</span>`
+                });
+            }
+        } finally {
+            isChatLoading.value = false;
+            await Vue.nextTick();
+            if (isChatScrolledToBottom()) {
+                scrollChatToBottom();
+            }
+            focusChatInput();
+            // Refresh token budget after chat completion
+            if (onChatComplete) {
+                onChatComplete();
+            }
+        }
+    };
+
+    const handleChatKeydown = (event) => {
+        if (event.key === 'Enter') {
+            if (event.ctrlKey || event.shiftKey) {
+                return;
+            } else {
+                event.preventDefault();
+                sendChatMessage();
+            }
+        }
+    };
+
+    const clearChat = () => {
+        if (chatMessages.value.length > 0) {
+            chatMessages.value = [];
+            showToast(t('chat.cleared'), 'fa-broom');
+        }
+    };
+
+    const downloadChat = async () => {
+        if (!selectedRecording.value || chatMessages.value.length === 0) {
+            showToast(t('chat.noMessagesToDownload'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            const csrfTokenValue = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/download/chat`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfTokenValue
+                },
+                body: JSON.stringify({
+                    messages: chatMessages.value
+                })
+            });
+
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('chat.downloadFailed'), 'fa-exclamation-circle');
+                return;
+            }
+
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.style.display = 'none';
+            a.href = url;
+
+            const contentDisposition = response.headers.get('Content-Disposition');
+            let filename = 'chat.docx';
+            if (contentDisposition) {
+                const utf8Match = /filename\*=utf-8''(.+)/.exec(contentDisposition);
+                if (utf8Match) {
+                    filename = decodeURIComponent(utf8Match[1]);
+                } else {
+                    const regularMatch = /filename="(.+)"/.exec(contentDisposition);
+                    if (regularMatch) {
+                        filename = regularMatch[1];
+                    }
+                }
+            }
+            a.download = filename;
+
+            document.body.appendChild(a);
+            a.click();
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+
+            showToast(t('chat.downloadSuccess'));
+        } catch (error) {
+            console.error('Download failed:', error);
+            showToast(t('chat.downloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    const copyMessage = (text, event) => {
+        const button = event.currentTarget;
+
+        if (navigator.clipboard && window.isSecureContext) {
+            navigator.clipboard.writeText(text)
+                .then(() => {
+                    showToast(t('messages.copiedSuccessfully'));
+                    animateCopyButton(button);
+                })
+                .catch(err => {
+                    console.error('Copy failed:', err);
+                    showToast(t('messages.copyFailed') + ': ' + err.message, 'fa-exclamation-circle');
+                    fallbackCopyTextToClipboard(text, button);
+                });
+        } else {
+            fallbackCopyTextToClipboard(text, button);
+        }
+    };
+
+    const animateCopyButton = (button) => {
+        button.classList.add('copy-success');
+        const originalContent = button.innerHTML;
+        button.innerHTML = '<i class="fas fa-check"></i>';
+        setTimeout(() => {
+            button.classList.remove('copy-success');
+            button.innerHTML = originalContent;
+        }, 1500);
+    };
+
+    const fallbackCopyTextToClipboard = (text, button = null) => {
+        try {
+            const textArea = document.createElement("textarea");
+            textArea.value = text;
+            textArea.style.position = "fixed";
+            textArea.style.left = "-999999px";
+            textArea.style.top = "-999999px";
+            document.body.appendChild(textArea);
+            textArea.focus();
+            textArea.select();
+            const successful = document.execCommand('copy');
+            document.body.removeChild(textArea);
+
+            if (successful) {
+                showToast(t('messages.copiedSuccessfully'));
+                if (button) animateCopyButton(button);
+            } else {
+                showToast(t('messages.copyNotSupported'), 'fa-exclamation-circle');
+            }
+        } catch (err) {
+            console.error('Fallback copy failed:', err);
+            showToast(t('messages.copyFailed') + ': ' + err.message, 'fa-exclamation-circle');
+        }
+    };
+
+    return {
+        isChatScrolledToBottom,
+        scrollChatToBottom,
+        toggleChatMaximize,
+        sendChatMessage,
+        handleChatKeydown,
+        clearChat,
+        downloadChat,
+        copyMessage,
+        animateCopyButton,
+        fallbackCopyTextToClipboard
+    };
+}
diff --git a/static/js/modules/composables/folders.js b/static/js/modules/composables/folders.js
new file mode 100644
index 00000000..152e3843
--- /dev/null
+++ b/static/js/modules/composables/folders.js
@@ -0,0 +1,173 @@
+/**
+ * Folders Management Composable
+ * Handles folder operations for recordings
+ */
+
+const { computed, ref } = Vue;
+
+export function useFolders({
+    recordings,
+    availableFolders,
+    selectedRecording,
+    showToast,
+    setGlobalError
+}) {
+    // Computed / Helpers
+    const getRecordingFolder = (recording) => {
+        if (!recording || !recording.folder_id) return null;
+        // Try to get from recording.folder first, then lookup
+        if (recording.folder) return recording.folder;
+        return availableFolders.value?.find(f => f.id === recording.folder_id) || null;
+    };
+
+    const getFolderById = (folderId) => {
+        if (!folderId || !availableFolders.value) return null;
+        // Use == for loose equality to handle string/number type mismatch (e.g., from localStorage)
+        return availableFolders.value.find(f => f.id == folderId) || null;
+    };
+
+    const getFolderColor = (folderId) => {
+        const folder = getFolderById(folderId);
+        return folder?.color || '#10B981';
+    };
+
+    const getFolderName = (folderId) => {
+        const folder = getFolderById(folderId);
+        return folder?.name || 'Folder';
+    };
+
+    const getAvailableFoldersForRecording = () => {
+        if (!availableFolders.value) return [];
+        return availableFolders.value;
+    };
+
+    // Methods
+    const assignFolderToRecording = async (recordingId, folderId) => {
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch(`/api/recordings/${recordingId}/folder`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ folder_id: folderId || null })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to update folder');
+            }
+
+            const updatedRecording = await response.json();
+
+            // Update local recording data
+            const recordingInList = recordings.value.find(r => r.id === recordingId);
+            if (recordingInList) {
+                recordingInList.folder_id = updatedRecording.folder_id;
+                recordingInList.folder = updatedRecording.folder;
+            }
+
+            // Update selectedRecording if it matches
+            if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                selectedRecording.value.folder_id = updatedRecording.folder_id;
+                selectedRecording.value.folder = updatedRecording.folder;
+            }
+
+            // Update folder recording counts
+            if (availableFolders.value) {
+                availableFolders.value.forEach(f => {
+                    const count = recordings.value.filter(r => r.folder_id === f.id).length;
+                    f.recording_count = count;
+                });
+            }
+
+            if (folderId) {
+                const folder = availableFolders.value?.find(f => f.id === folderId);
+                showToast(`Moved to folder "${folder?.name || 'Unknown'}"`, 'fa-folder', 2000, 'success');
+            } else {
+                showToast('Removed from folder', 'fa-folder-minus', 2000, 'success');
+            }
+
+            return updatedRecording;
+
+        } catch (error) {
+            console.error('Error updating folder:', error);
+            setGlobalError(`Failed to update folder: ${error.message}`);
+            return null;
+        }
+    };
+
+    const removeRecordingFromFolder = async (recordingId) => {
+        return assignFolderToRecording(recordingId, null);
+    };
+
+    const bulkAssignFolder = async (recordingIds, folderId) => {
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch('/api/recordings/bulk/folder', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    recording_ids: recordingIds,
+                    folder_id: folderId || null
+                })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to update folders');
+            }
+
+            const result = await response.json();
+
+            // Update local recording data
+            recordingIds.forEach(id => {
+                const recording = recordings.value.find(r => r.id === id);
+                if (recording) {
+                    recording.folder_id = folderId || null;
+                    recording.folder = folderId ? availableFolders.value?.find(f => f.id === folderId) : null;
+                }
+            });
+
+            // Update folder recording counts
+            if (availableFolders.value) {
+                availableFolders.value.forEach(f => {
+                    const count = recordings.value.filter(r => r.folder_id === f.id).length;
+                    f.recording_count = count;
+                });
+            }
+
+            if (folderId) {
+                const folder = availableFolders.value?.find(f => f.id === folderId);
+                showToast(`${result.updated_count} recording(s) moved to "${folder?.name || 'Unknown'}"`, 'fa-folder', 2000, 'success');
+            } else {
+                showToast(`${result.updated_count} recording(s) removed from folder`, 'fa-folder-minus', 2000, 'success');
+            }
+
+            return result;
+
+        } catch (error) {
+            console.error('Error bulk updating folders:', error);
+            setGlobalError(`Failed to update folders: ${error.message}`);
+            return null;
+        }
+    };
+
+    return {
+        // Methods
+        getRecordingFolder,
+        getFolderById,
+        getFolderColor,
+        getFolderName,
+        getAvailableFoldersForRecording,
+        assignFolderToRecording,
+        removeRecordingFromFolder,
+        bulkAssignFolder
+    };
+}
diff --git a/static/js/modules/composables/index.js b/static/js/modules/composables/index.js
new file mode 100644
index 00000000..cb94750c
--- /dev/null
+++ b/static/js/modules/composables/index.js
@@ -0,0 +1,33 @@
+/**
+ * Composables module exports
+ *
+ * Each composable encapsulates related functionality:
+ * - recordings: Loading, selecting, filtering recordings
+ * - upload: File upload queue management
+ * - audio: Microphone/system audio recording
+ * - ui: Dark mode, color schemes, sidebar
+ * - transcription: Transcription editing (ASR editor, text editor)
+ * - speakers: Speaker identification and management
+ * - reprocess: Reprocessing transcription/summary
+ * - sharing: Public/internal sharing
+ * - modals: Modal dialog management
+ * - chat: AI chat functionality
+ * - pwa: PWA features (install prompt, notifications, badging, media session)
+ * - tokens: API token management
+ */
+
+export { useRecordings } from './recordings.js';
+export { useUpload } from './upload.js';
+export { useAudio } from './audio.js';
+export { useUI } from './ui.js';
+export { useModals } from './modals.js';
+export { useSharing } from './sharing.js';
+export { useReprocess } from './reprocess.js';
+export { useTranscription } from './transcription.js';
+export { useSpeakers } from './speakers.js';
+export { useChat } from './chat.js';
+export { usePWA } from './pwa.js';
+export { useTokens } from './tokens.js';
+export { useBulkSelection } from './bulk-selection.js';
+export { useBulkOperations } from './bulk-operations.js';
+export { useFolders } from './folders.js';
diff --git a/static/js/modules/composables/modals.js b/static/js/modules/composables/modals.js
new file mode 100644
index 00000000..5dae37d5
--- /dev/null
+++ b/static/js/modules/composables/modals.js
@@ -0,0 +1,659 @@
+/**
+ * Modal management composable
+ * Handles opening, closing, and saving modal dialogs
+ */
+
+export function useModals(state, utils) {
+    const {
+        showEditModal, showDeleteModal, showEditTagsModal,
+        showReprocessModal, showResetModal, showShareModal,
+        showSharesListModal, showTextEditorModal, showAsrEditorModal,
+        showEditSpeakersModal, showAddSpeakerModal, showEditTextModal,
+        showShareDeleteModal, showUnifiedShareModal, showColorSchemeModal,
+        showSystemAudioHelpModal, editingRecording, recordingToDelete, recordingToReset,
+        selectedRecording, recordings, selectedNewTagId, tagSearchFilter,
+        availableTags, currentView, totalRecordings, toasts, uploadQueue, allJobs,
+        // DateTime picker state
+        showDateTimePicker, pickerMonth, pickerYear, pickerHour, pickerMinute,
+        pickerAmPm, pickerSelectedDate, dateTimePickerTarget, dateTimePickerCallback
+    } = state;
+
+    const { showToast, setGlobalError } = utils;
+    const { computed } = Vue;
+
+    // =========================================
+    // Edit Recording Modal
+    // =========================================
+
+    const openEditModal = (recording) => {
+        editingRecording.value = { ...recording };
+        showEditModal.value = true;
+    };
+
+    const cancelEdit = () => {
+        showEditModal.value = false;
+        editingRecording.value = null;
+    };
+
+    const saveEdit = async () => {
+        if (!editingRecording.value) return;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/api/recordings/${editingRecording.value.id}`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    title: editingRecording.value.title,
+                    participants: editingRecording.value.participants,
+                    meeting_date: editingRecording.value.meeting_date,
+                    notes: editingRecording.value.notes
+                })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to save changes');
+
+            // Update local data
+            const index = recordings.value.findIndex(r => r.id === editingRecording.value.id);
+            if (index !== -1) {
+                recordings.value[index] = { ...recordings.value[index], ...editingRecording.value };
+            }
+            if (selectedRecording.value && selectedRecording.value.id === editingRecording.value.id) {
+                selectedRecording.value = { ...selectedRecording.value, ...editingRecording.value };
+            }
+
+            showToast('Recording updated!', 'fa-check-circle');
+            showEditModal.value = false;
+            editingRecording.value = null;
+        } catch (error) {
+            setGlobalError(`Failed to save changes: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Delete Recording Modal
+    // =========================================
+
+    const confirmDelete = (recording) => {
+        recordingToDelete.value = recording;
+        showDeleteModal.value = true;
+    };
+
+    const cancelDelete = () => {
+        showDeleteModal.value = false;
+        recordingToDelete.value = null;
+    };
+
+    const deleteRecording = async () => {
+        if (!recordingToDelete.value) return;
+        const deletedId = recordingToDelete.value.id;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${deletedId}`, {
+                method: 'DELETE',
+                headers: { 'X-CSRFToken': csrfToken }
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to delete recording');
+
+            // Remove from recordings list
+            recordings.value = recordings.value.filter(r => r.id !== deletedId);
+            totalRecordings.value--;
+
+            // Remove from upload queue if present (frontend tracking)
+            if (uploadQueue?.value) {
+                uploadQueue.value = uploadQueue.value.filter(item => item.recordingId !== deletedId);
+            }
+
+            // Remove from backend job queue if present (backend processing tracking)
+            // This is critical - without this, deleted recordings remain in processing queue
+            if (allJobs?.value) {
+                allJobs.value = allJobs.value.filter(job => job.recording_id !== deletedId);
+            }
+
+            // Clear selected recording if it's the one being deleted
+            if (selectedRecording.value?.id === deletedId) {
+                selectedRecording.value = null;
+                currentView.value = 'upload';
+            }
+
+            showToast('Recording deleted.', 'fa-trash');
+            showDeleteModal.value = false;
+            recordingToDelete.value = null;
+        } catch (error) {
+            setGlobalError(`Failed to delete recording: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Archive Recording
+    // =========================================
+
+    const archiveRecording = async (recording) => {
+        if (!recording) return;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/api/recordings/${recording.id}/archive`, {
+                method: 'POST',
+                headers: { 'X-CSRFToken': csrfToken }
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to archive recording');
+
+            recording.is_archived = true;
+            recording.audio_deleted_at = data.audio_deleted_at;
+
+            // Update in recordings list
+            const index = recordings.value.findIndex(r => r.id === recording.id);
+            if (index !== -1) {
+                recordings.value[index].is_archived = true;
+                recordings.value[index].audio_deleted_at = data.audio_deleted_at;
+            }
+
+            showToast('Recording archived (audio deleted)', 'fa-archive');
+        } catch (error) {
+            setGlobalError(`Failed to archive recording: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Edit Tags Modal
+    // =========================================
+
+    const openEditTagsModal = () => {
+        selectedNewTagId.value = '';
+        tagSearchFilter.value = '';
+        showEditTagsModal.value = true;
+    };
+
+    const closeEditTagsModal = () => {
+        showEditTagsModal.value = false;
+    };
+
+    const addTagToRecording = async (tagId) => {
+        if (!selectedRecording.value || !tagId) return;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/api/recordings/${selectedRecording.value.id}/tags`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ tag_id: tagId })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to add tag');
+
+            // Find the tag object
+            const tag = availableTags.value.find(t => t.id === tagId);
+            if (tag) {
+                if (!selectedRecording.value.tags) {
+                    selectedRecording.value.tags = [];
+                }
+                selectedRecording.value.tags.push(tag);
+            }
+
+            // Update in recordings list
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1 && tag) {
+                if (!recordings.value[index].tags) {
+                    recordings.value[index].tags = [];
+                }
+                recordings.value[index].tags.push(tag);
+            }
+
+            selectedNewTagId.value = '';
+            showToast('Tag added!', 'fa-tag');
+        } catch (error) {
+            setGlobalError(`Failed to add tag: ${error.message}`);
+        }
+    };
+
+    const removeTagFromRecording = async (tagId) => {
+        if (!selectedRecording.value || !tagId) return;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/api/recordings/${selectedRecording.value.id}/tags/${tagId}`, {
+                method: 'DELETE',
+                headers: { 'X-CSRFToken': csrfToken }
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to remove tag');
+
+            // Remove from selected recording
+            if (selectedRecording.value.tags) {
+                selectedRecording.value.tags = selectedRecording.value.tags.filter(t => t.id !== tagId);
+            }
+
+            // Update in recordings list
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1 && recordings.value[index].tags) {
+                recordings.value[index].tags = recordings.value[index].tags.filter(t => t.id !== tagId);
+            }
+
+            showToast('Tag removed!', 'fa-tag');
+        } catch (error) {
+            setGlobalError(`Failed to remove tag: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Reset Modal
+    // =========================================
+
+    const openResetModal = (recording) => {
+        recordingToReset.value = recording;
+        showResetModal.value = true;
+    };
+
+    const cancelReset = () => {
+        showResetModal.value = false;
+        recordingToReset.value = null;
+    };
+
+    const resetRecording = async () => {
+        if (!recordingToReset.value) return;
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${recordingToReset.value.id}/reset_status`, {
+                method: 'POST',
+                headers: { 'X-CSRFToken': csrfToken }
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to reset recording');
+
+            // Update recording status
+            const index = recordings.value.findIndex(r => r.id === recordingToReset.value.id);
+            if (index !== -1) {
+                recordings.value[index].status = 'PENDING';
+                recordings.value[index].transcription = '';
+                recordings.value[index].summary = '';
+            }
+
+            if (selectedRecording.value?.id === recordingToReset.value.id) {
+                selectedRecording.value.status = 'PENDING';
+                selectedRecording.value.transcription = '';
+                selectedRecording.value.summary = '';
+            }
+
+            showToast('Recording reset for reprocessing.', 'fa-redo');
+            showResetModal.value = false;
+            recordingToReset.value = null;
+        } catch (error) {
+            setGlobalError(`Failed to reset recording: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // System Audio Help Modal
+    // =========================================
+
+    const openSystemAudioHelpModal = () => {
+        showSystemAudioHelpModal.value = true;
+    };
+
+    const closeSystemAudioHelpModal = () => {
+        showSystemAudioHelpModal.value = false;
+    };
+
+    // =========================================
+    // Toast Management
+    // =========================================
+
+    const dismissToast = (id) => {
+        toasts.value = toasts.value.filter(t => t.id !== id);
+    };
+
+    // Aliases for template compatibility
+    const editRecording = openEditModal;
+    const editRecordingTags = openEditTagsModal;
+
+    // =========================================
+    // DateTime Picker
+    // =========================================
+
+    const monthNames = ['January', 'February', 'March', 'April', 'May', 'June',
+                        'July', 'August', 'September', 'October', 'November', 'December'];
+    const dayNames = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'];
+
+    // Generate available years (10 years before and after current year)
+    const availableYears = computed(() => {
+        const currentYear = new Date().getFullYear();
+        const years = [];
+        for (let y = currentYear - 10; y <= currentYear + 10; y++) {
+            years.push(y);
+        }
+        return years;
+    });
+
+    // Generate hours for 12-hour format
+    const hours12 = computed(() => {
+        const hours = [];
+        for (let h = 1; h <= 12; h++) {
+            hours.push({ value: h, label: h.toString() });
+        }
+        return hours;
+    });
+
+    // Generate minutes
+    const minutes = computed(() => {
+        const mins = [];
+        for (let m = 0; m < 60; m++) {
+            mins.push(m);
+        }
+        return mins;
+    });
+
+    // Generate calendar days for current month view
+    const calendarDays = computed(() => {
+        const days = [];
+        const year = pickerYear.value;
+        const month = pickerMonth.value;
+
+        // First day of the month
+        const firstDay = new Date(year, month, 1);
+        const startingDay = firstDay.getDay();
+
+        // Last day of the month
+        const lastDay = new Date(year, month + 1, 0);
+        const totalDays = lastDay.getDate();
+
+        // Previous month days to fill the grid
+        const prevMonthLastDay = new Date(year, month, 0).getDate();
+        for (let i = startingDay - 1; i >= 0; i--) {
+            days.push({
+                day: prevMonthLastDay - i,
+                date: new Date(year, month - 1, prevMonthLastDay - i),
+                inMonth: false,
+                isToday: false,
+                isSelected: false
+            });
+        }
+
+        // Current month days
+        const today = new Date();
+        for (let d = 1; d <= totalDays; d++) {
+            const date = new Date(year, month, d);
+            const isToday = date.toDateString() === today.toDateString();
+            const isSelected = pickerSelectedDate.value &&
+                              date.toDateString() === pickerSelectedDate.value.toDateString();
+            days.push({
+                day: d,
+                date: date,
+                inMonth: true,
+                isToday: isToday,
+                isSelected: isSelected
+            });
+        }
+
+        // Next month days to fill the grid (6 rows * 7 days = 42 total)
+        const remainingDays = 42 - days.length;
+        for (let d = 1; d <= remainingDays; d++) {
+            days.push({
+                day: d,
+                date: new Date(year, month + 1, d),
+                inMonth: false,
+                isToday: false,
+                isSelected: false
+            });
+        }
+
+        return days;
+    });
+
+    const openDateTimePicker = (target, currentValue, callback) => {
+        dateTimePickerTarget.value = target;
+        dateTimePickerCallback.value = callback;
+
+        // Parse current value if exists
+        if (currentValue) {
+            const date = new Date(currentValue);
+            if (!isNaN(date.getTime())) {
+                pickerSelectedDate.value = date;
+                pickerMonth.value = date.getMonth();
+                pickerYear.value = date.getFullYear();
+
+                let hours = date.getHours();
+                const ampm = hours >= 12 ? 'PM' : 'AM';
+                hours = hours % 12;
+                hours = hours === 0 ? 12 : hours;
+
+                pickerHour.value = hours;
+                pickerMinute.value = date.getMinutes();
+                pickerAmPm.value = ampm;
+            } else {
+                setPickerToNow();
+            }
+        } else {
+            setPickerToNow();
+        }
+
+        showDateTimePicker.value = true;
+    };
+
+    const setPickerToNow = () => {
+        const now = new Date();
+        pickerSelectedDate.value = now;
+        pickerMonth.value = now.getMonth();
+        pickerYear.value = now.getFullYear();
+
+        let hours = now.getHours();
+        const ampm = hours >= 12 ? 'PM' : 'AM';
+        hours = hours % 12;
+        hours = hours === 0 ? 12 : hours;
+
+        pickerHour.value = hours;
+        pickerMinute.value = now.getMinutes();
+        pickerAmPm.value = ampm;
+    };
+
+    const closeDateTimePicker = () => {
+        showDateTimePicker.value = false;
+        dateTimePickerTarget.value = null;
+        dateTimePickerCallback.value = null;
+    };
+
+    const prevMonth = () => {
+        if (pickerMonth.value === 0) {
+            pickerMonth.value = 11;
+            pickerYear.value--;
+        } else {
+            pickerMonth.value--;
+        }
+    };
+
+    const nextMonth = () => {
+        if (pickerMonth.value === 11) {
+            pickerMonth.value = 0;
+            pickerYear.value++;
+        } else {
+            pickerMonth.value++;
+        }
+    };
+
+    const updatePickerView = () => {
+        // Called when month/year dropdowns change
+        // The computed calendarDays will automatically update
+    };
+
+    const selectDate = (date) => {
+        pickerSelectedDate.value = date;
+    };
+
+    const setToNow = () => {
+        setPickerToNow();
+    };
+
+    const setToToday = () => {
+        const today = new Date();
+        pickerSelectedDate.value = today;
+        pickerMonth.value = today.getMonth();
+        pickerYear.value = today.getFullYear();
+        // Keep the current time
+    };
+
+    const clearDateTime = () => {
+        pickerSelectedDate.value = null;
+        const now = new Date();
+        pickerMonth.value = now.getMonth();
+        pickerYear.value = now.getFullYear();
+        pickerHour.value = 12;
+        pickerMinute.value = 0;
+        pickerAmPm.value = 'PM';
+    };
+
+    const formatPickerPreview = () => {
+        if (!pickerSelectedDate.value) return '';
+
+        const date = pickerSelectedDate.value;
+        const monthName = monthNames[date.getMonth()];
+        const day = date.getDate();
+        const year = date.getFullYear();
+
+        const hour = pickerHour.value;
+        const minute = pickerMinute.value.toString().padStart(2, '0');
+        const ampm = pickerAmPm.value;
+
+        return `${monthName} ${day}, ${year} at ${hour}:${minute} ${ampm}`;
+    };
+
+    const applyDateTime = () => {
+        if (!pickerSelectedDate.value) {
+            // If no date selected, just close
+            closeDateTimePicker();
+            return;
+        }
+
+        // Build the full datetime
+        const date = new Date(pickerSelectedDate.value);
+        let hours = pickerHour.value;
+
+        // Convert 12-hour to 24-hour
+        if (pickerAmPm.value === 'AM') {
+            hours = hours === 12 ? 0 : hours;
+        } else {
+            hours = hours === 12 ? 12 : hours + 12;
+        }
+
+        date.setHours(hours);
+        date.setMinutes(pickerMinute.value);
+        date.setSeconds(0);
+        date.setMilliseconds(0);
+
+        // Format as ISO string for storage (YYYY-MM-DDTHH:mm:ss)
+        const isoString = date.toISOString().slice(0, 19);
+
+        // Call the callback with the result
+        if (dateTimePickerCallback.value) {
+            dateTimePickerCallback.value(isoString, date);
+        }
+
+        closeDateTimePicker();
+    };
+
+    // Helper to open datetime picker for meeting date
+    const openMeetingDatePicker = () => {
+        if (!selectedRecording.value) return;
+
+        openDateTimePicker(
+            'meeting_date',
+            selectedRecording.value.meeting_date,
+            (isoString) => {
+                selectedRecording.value.meeting_date = isoString;
+                // Auto-save the change
+                saveInlineMeetingDate();
+            }
+        );
+    };
+
+    // Save meeting date inline (similar to other inline edits)
+    const saveInlineMeetingDate = async () => {
+        if (!selectedRecording.value) return;
+
+        const fullPayload = {
+            id: selectedRecording.value.id,
+            title: selectedRecording.value.title,
+            participants: selectedRecording.value.participants,
+            notes: selectedRecording.value.notes,
+            summary: selectedRecording.value.summary,
+            meeting_date: selectedRecording.value.meeting_date
+        };
+
+        try {
+            const csrfTokenValue = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch('/save', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfTokenValue
+                },
+                body: JSON.stringify(fullPayload)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to save meeting date');
+
+            showToast('Meeting date updated!', 'fa-calendar-check');
+        } catch (error) {
+            showToast(`Failed to save: ${error.message}`, 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    return {
+        // Edit modal
+        openEditModal,
+        editRecording,
+        cancelEdit,
+        saveEdit,
+
+        // Delete modal
+        confirmDelete,
+        cancelDelete,
+        deleteRecording,
+
+        // Archive
+        archiveRecording,
+
+        // Tags modal
+        openEditTagsModal,
+        editRecordingTags,
+        closeEditTagsModal,
+        addTagToRecording,
+        removeTagFromRecording,
+
+        // Reset modal
+        openResetModal,
+        cancelReset,
+        resetRecording,
+
+        // System audio help
+        openSystemAudioHelpModal,
+        closeSystemAudioHelpModal,
+
+        // Toast
+        dismissToast,
+
+        // DateTime picker
+        monthNames,
+        dayNames,
+        availableYears,
+        hours12,
+        minutes,
+        calendarDays,
+        openDateTimePicker,
+        closeDateTimePicker,
+        prevMonth,
+        nextMonth,
+        updatePickerView,
+        selectDate,
+        setToNow,
+        setToToday,
+        clearDateTime,
+        formatPickerPreview,
+        applyDateTime,
+        openMeetingDatePicker
+    };
+}
diff --git a/static/js/modules/composables/pwa.js b/static/js/modules/composables/pwa.js
new file mode 100644
index 00000000..4688a9aa
--- /dev/null
+++ b/static/js/modules/composables/pwa.js
@@ -0,0 +1,518 @@
+/**
+ * PWA Features Composable
+ * Handles install prompt, push notifications, badging, and other PWA APIs
+ */
+
+import { isPushEnabled, getPublicKey, urlBase64ToUint8Array } from '../../config/push-config.js';
+
+export function usePWA(state, utils) {
+    const {
+        deferredInstallPrompt,
+        showInstallButton,
+        isPWAInstalled,
+        notificationPermission,
+        pushSubscription,
+        appBadgeCount
+    } = state;
+
+    const { showToast } = utils;
+
+    // --- Install Prompt ---
+
+    /**
+     * Handle beforeinstallprompt event
+     * This event is fired when the browser detects the app can be installed
+     */
+    const handleBeforeInstallPrompt = (e) => {
+        console.log('[PWA] beforeinstallprompt event fired');
+        // Prevent the mini-infobar from appearing on mobile
+        e.preventDefault();
+        // Stash the event so it can be triggered later
+        deferredInstallPrompt.value = e;
+        // Show our custom install button
+        showInstallButton.value = true;
+    };
+
+    /**
+     * Prompt user to install the PWA
+     */
+    const promptInstall = async () => {
+        if (!deferredInstallPrompt.value) {
+            console.log('[PWA] No deferred install prompt available');
+            return;
+        }
+
+        // Show the install prompt
+        deferredInstallPrompt.value.prompt();
+
+        // Wait for the user's response
+        const { outcome } = await deferredInstallPrompt.value.userChoice;
+        console.log(`[PWA] User response to install prompt: ${outcome}`);
+
+        if (outcome === 'accepted') {
+            showToast('Installing Speakr...', 'success');
+        }
+
+        // Clear the deferred prompt since it can only be used once
+        deferredInstallPrompt.value = null;
+        showInstallButton.value = false;
+    };
+
+    /**
+     * Check if app is already installed
+     */
+    const checkIfInstalled = () => {
+        // Check if running in standalone mode (installed PWA)
+        if (window.matchMedia('(display-mode: standalone)').matches ||
+            window.navigator.standalone === true) {
+            isPWAInstalled.value = true;
+            showInstallButton.value = false;
+            console.log('[PWA] App is installed and running in standalone mode');
+        }
+    };
+
+    /**
+     * Handle appinstalled event
+     */
+    const handleAppInstalled = () => {
+        console.log('[PWA] App was installed');
+        isPWAInstalled.value = true;
+        showInstallButton.value = false;
+        showToast('Speakr installed successfully!', 'success');
+    };
+
+    // --- Push Notifications ---
+
+    /**
+     * Request notification permission
+     */
+    const requestNotificationPermission = async () => {
+        if (!('Notification' in window)) {
+            console.warn('[PWA] This browser does not support notifications');
+            return false;
+        }
+
+        try {
+            const permission = await Notification.requestPermission();
+            notificationPermission.value = permission;
+            console.log(`[PWA] Notification permission: ${permission}`);
+
+            if (permission === 'granted') {
+                showToast('Notifications enabled', 'success');
+                return true;
+            } else if (permission === 'denied') {
+                showToast('Notification permission denied', 'error');
+                return false;
+            }
+        } catch (error) {
+            console.error('[PWA] Error requesting notification permission:', error);
+            return false;
+        }
+    };
+
+    /**
+     * Subscribe to push notifications
+     */
+    const subscribeToPushNotifications = async () => {
+        if (!('serviceWorker' in navigator) || !('PushManager' in window)) {
+            console.warn('[PWA] Push notifications not supported');
+            showToast('Push notifications not supported in this browser', 'warning');
+            return null;
+        }
+
+        // Check if push is enabled on server
+        const enabled = await isPushEnabled();
+        if (!enabled) {
+            console.warn('[PWA] Push notifications not configured on server');
+            showToast('Push notifications not available. Install pywebpush on server.', 'warning');
+            return null;
+        }
+
+        // Get public key from server
+        const publicKey = await getPublicKey();
+        if (!publicKey) {
+            console.error('[PWA] Failed to get VAPID public key from server');
+            showToast('Failed to configure push notifications', 'error');
+            return null;
+        }
+
+        try {
+            const registration = await navigator.serviceWorker.ready;
+
+            // Check if already subscribed
+            let subscription = await registration.pushManager.getSubscription();
+
+            if (!subscription) {
+                // Subscribe to push notifications
+                console.log('[PWA] Creating new push subscription...');
+
+                const applicationServerKey = urlBase64ToUint8Array(publicKey);
+
+                subscription = await registration.pushManager.subscribe({
+                    userVisibleOnly: true,
+                    applicationServerKey: applicationServerKey
+                });
+
+                // Send subscription to server
+                const success = await sendSubscriptionToServer(subscription);
+
+                if (success) {
+                    pushSubscription.value = subscription;
+                    showToast('Push notifications enabled', 'success');
+                    console.log('[PWA] Push subscription successful:', subscription);
+                } else {
+                    console.warn('[PWA] Failed to save subscription on server');
+                    showToast('Failed to enable push notifications', 'error');
+                    return null;
+                }
+            } else {
+                pushSubscription.value = subscription;
+                console.log('[PWA] Already subscribed to push notifications');
+            }
+
+            return subscription;
+        } catch (error) {
+            console.error('[PWA] Failed to subscribe to push notifications:', error);
+
+            if (error.name === 'NotAllowedError') {
+                showToast('Push notification permission denied', 'error');
+            } else {
+                showToast('Failed to enable push notifications', 'error');
+            }
+
+            return null;
+        }
+    };
+
+    /**
+     * Send subscription to server for storage
+     */
+    const sendSubscriptionToServer = async (subscription) => {
+        try {
+            const response = await fetch('/api/push/subscribe', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(subscription),
+                credentials: 'same-origin'
+            });
+
+            if (!response.ok) {
+                console.error('[PWA] Server rejected push subscription:', response.status);
+                return false;
+            }
+
+            const data = await response.json();
+            console.log('[PWA] Subscription saved on server:', data);
+            return true;
+        } catch (error) {
+            console.error('[PWA] Failed to send subscription to server:', error);
+            return false;
+        }
+    };
+
+    /**
+     * Unsubscribe from push notifications
+     */
+    const unsubscribeFromPushNotifications = async () => {
+        if (!pushSubscription.value) {
+            console.log('[PWA] No active push subscription to unsubscribe');
+            return true;
+        }
+
+        try {
+            // Unsubscribe on client
+            await pushSubscription.value.unsubscribe();
+
+            // Remove from server
+            await fetch('/api/push/unsubscribe', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(pushSubscription.value),
+                credentials: 'same-origin'
+            });
+
+            pushSubscription.value = null;
+            showToast('Push notifications disabled', 'info');
+            console.log('[PWA] Unsubscribed from push notifications');
+            return true;
+        } catch (error) {
+            console.error('[PWA] Failed to unsubscribe from push notifications:', error);
+            showToast('Failed to disable push notifications', 'error');
+            return false;
+        }
+    };
+
+    /**
+     * Show a local notification
+     */
+    const showNotification = async (title, options = {}) => {
+        if (!('Notification' in window)) {
+            console.warn('[PWA] Notifications not supported');
+            return;
+        }
+
+        if (Notification.permission !== 'granted') {
+            const granted = await requestNotificationPermission();
+            if (!granted) return;
+        }
+
+        try {
+            const registration = await navigator.serviceWorker.ready;
+
+            const defaultOptions = {
+                icon: '/static/img/icon-192x192.png',
+                badge: '/static/img/icon-192x192.png',
+                vibrate: [200, 100, 200],
+                tag: 'speakr-notification',
+                renotify: true,
+                ...options
+            };
+
+            await registration.showNotification(title, defaultOptions);
+        } catch (error) {
+            console.error('[PWA] Error showing notification:', error);
+        }
+    };
+
+    // --- Badging API ---
+
+    /**
+     * Set app badge count
+     */
+    const setAppBadge = async (count) => {
+        if (!('setAppBadge' in navigator)) {
+            console.log('[PWA] Badging API not supported');
+            return;
+        }
+
+        try {
+            if (count > 0) {
+                await navigator.setAppBadge(count);
+                appBadgeCount.value = count;
+                console.log(`[PWA] App badge set to ${count}`);
+            } else {
+                await navigator.clearAppBadge();
+                appBadgeCount.value = 0;
+                console.log('[PWA] App badge cleared');
+            }
+        } catch (error) {
+            console.error('[PWA] Error setting app badge:', error);
+        }
+    };
+
+    /**
+     * Clear app badge
+     */
+    const clearAppBadge = async () => {
+        await setAppBadge(0);
+    };
+
+    /**
+     * Update badge with unread count
+     */
+    const updateBadgeCount = async (audioFiles) => {
+        if (!audioFiles || !Array.isArray(audioFiles)) return;
+
+        // Count unread recordings (those still in inbox)
+        const unreadCount = audioFiles.filter(file => file.in_inbox).length;
+        await setAppBadge(unreadCount);
+    };
+
+    // --- Media Session API ---
+
+    /**
+     * Set up Media Session for audio playback control
+     * @param {Object} metadata - Track metadata { title, artist, album, artwork }
+     * @param {Object} handlers - Action handlers { play, pause, seekbackward, seekforward, previoustrack, nexttrack }
+     */
+    const setupMediaSession = (metadata, handlers = {}) => {
+        if (!('mediaSession' in navigator)) {
+            console.log('[PWA] Media Session API not supported');
+            return false;
+        }
+
+        try {
+            // Set metadata
+            if (metadata) {
+                navigator.mediaSession.metadata = new MediaMetadata({
+                    title: metadata.title || 'Untitled Recording',
+                    artist: metadata.artist || 'Speakr',
+                    album: metadata.album || 'Recordings',
+                    artwork: metadata.artwork || [
+                        { src: '/static/img/icon-192x192.png', sizes: '192x192', type: 'image/png' },
+                        { src: '/static/img/icon-512x512.png', sizes: '512x512', type: 'image/png' }
+                    ]
+                });
+                currentMediaMetadata.value = metadata;
+            }
+
+            // Set action handlers
+            const actions = ['play', 'pause', 'seekbackward', 'seekforward', 'previoustrack', 'nexttrack', 'stop'];
+
+            actions.forEach(action => {
+                if (handlers[action]) {
+                    try {
+                        navigator.mediaSession.setActionHandler(action, handlers[action]);
+                    } catch (error) {
+                        console.warn(`[PWA] The ${action} action is not supported`);
+                    }
+                }
+            });
+
+            // Set position state if provided
+            if (handlers.setPositionState) {
+                try {
+                    navigator.mediaSession.setPositionState(handlers.setPositionState);
+                } catch (error) {
+                    console.warn('[PWA] setPositionState not supported:', error);
+                }
+            }
+
+            isMediaSessionActive.value = true;
+            console.log('[PWA] Media Session configured successfully');
+            return true;
+        } catch (error) {
+            console.error('[PWA] Error setting up Media Session:', error);
+            return false;
+        }
+    };
+
+    /**
+     * Update Media Session position state
+     * @param {Object} state - { duration, playbackRate, position }
+     */
+    const updateMediaSessionPosition = (state) => {
+        if (!('mediaSession' in navigator) || !isMediaSessionActive.value) return;
+
+        try {
+            navigator.mediaSession.setPositionState({
+                duration: state.duration || 0,
+                playbackRate: state.playbackRate || 1.0,
+                position: state.position || 0
+            });
+        } catch (error) {
+            console.warn('[PWA] Error updating position state:', error);
+        }
+    };
+
+    /**
+     * Update Media Session playback state
+     * @param {string} state - 'playing' | 'paused' | 'none'
+     */
+    const updateMediaSessionPlaybackState = (state) => {
+        if (!('mediaSession' in navigator) || !isMediaSessionActive.value) return;
+
+        try {
+            navigator.mediaSession.playbackState = state;
+        } catch (error) {
+            console.warn('[PWA] Error updating playback state:', error);
+        }
+    };
+
+    /**
+     * Clear Media Session
+     */
+    const clearMediaSession = () => {
+        if (!('mediaSession' in navigator)) return;
+
+        try {
+            navigator.mediaSession.metadata = null;
+            const actions = ['play', 'pause', 'seekbackward', 'seekforward', 'previoustrack', 'nexttrack', 'stop'];
+            actions.forEach(action => {
+                try {
+                    navigator.mediaSession.setActionHandler(action, null);
+                } catch (e) { /* ignore */ }
+            });
+            isMediaSessionActive.value = false;
+            currentMediaMetadata.value = null;
+            console.log('[PWA] Media Session cleared');
+        } catch (error) {
+            console.error('[PWA] Error clearing Media Session:', error);
+        }
+    };
+
+    // --- Background Sync ---
+
+    /**
+     * Register background sync for upload retry
+     */
+    const registerBackgroundSync = async (tag = 'sync-uploads') => {
+        if (!('serviceWorker' in navigator) || !('sync' in ServiceWorkerRegistration.prototype)) {
+            console.log('[PWA] Background sync not supported');
+            return false;
+        }
+
+        try {
+            const registration = await navigator.serviceWorker.ready;
+            await registration.sync.register(tag);
+            console.log(`[PWA] Background sync registered: ${tag}`);
+            return true;
+        } catch (error) {
+            console.error('[PWA] Failed to register background sync:', error);
+            return false;
+        }
+    };
+
+    /**
+     * Initialize PWA features
+     */
+    const initPWA = () => {
+        // Check if already installed
+        checkIfInstalled();
+
+        // Listen for beforeinstallprompt event
+        window.addEventListener('beforeinstallprompt', handleBeforeInstallPrompt);
+
+        // Listen for appinstalled event
+        window.addEventListener('appinstalled', handleAppInstalled);
+
+        // Check notification permission status
+        if ('Notification' in window) {
+            notificationPermission.value = Notification.permission;
+        }
+
+        console.log('[PWA] PWA features initialized');
+    };
+
+    /**
+     * Cleanup PWA event listeners
+     */
+    const cleanupPWA = () => {
+        window.removeEventListener('beforeinstallprompt', handleBeforeInstallPrompt);
+        window.removeEventListener('appinstalled', handleAppInstalled);
+    };
+
+    return {
+        // Install prompt
+        promptInstall,
+        checkIfInstalled,
+
+        // Notifications
+        requestNotificationPermission,
+        subscribeToPushNotifications,
+        unsubscribeFromPushNotifications,
+        showNotification,
+
+        // Badging
+        setAppBadge,
+        clearAppBadge,
+        updateBadgeCount,
+
+        // Media Session
+        setupMediaSession,
+        updateMediaSessionPosition,
+        updateMediaSessionPlaybackState,
+        clearMediaSession,
+
+        // Background sync
+        registerBackgroundSync,
+
+        // Initialization
+        initPWA,
+        cleanupPWA
+    };
+}
diff --git a/static/js/modules/composables/recordings.js b/static/js/modules/composables/recordings.js
new file mode 100644
index 00000000..7e6e910d
--- /dev/null
+++ b/static/js/modules/composables/recordings.js
@@ -0,0 +1,482 @@
+/**
+ * Recording management composable
+ * Handles loading, selecting, filtering, and managing recordings
+ */
+
+import * as IncognitoStorage from '../db/incognito-storage.js';
+
+export function useRecordings(state, utils, reprocessComposable) {
+    const {
+        recordings, selectedRecording, isLoadingRecordings, isLoadingMore,
+        currentPage, perPage, totalRecordings, totalPages, hasNextPage, hasPrevPage,
+        showSharedWithMe, showArchivedRecordings, searchQuery, searchDebounceTimer,
+        filterTags, filterSpeakers, filterDatePreset, filterDateRange, filterTextQuery,
+        filterStarred, filterInbox, filterFolder, sortBy,
+        availableTags, availableSpeakers, availableFolders, selectedTagIds, uploadLanguage, uploadMinSpeakers, uploadMaxSpeakers, uploadHotwords, uploadInitialPrompt,
+        useAsrEndpoint, connectorSupportsDiarization, globalError, uploadQueue, isProcessingActive, currentView,
+        isMobileScreen, isSidebarCollapsed, isRecording, audioBlobURL,
+        speakerColorMap,
+        // Incognito mode
+        incognitoRecording
+    } = state;
+
+    const { setGlobalError, showToast } = utils;
+
+    // Load recordings from API
+    const loadRecordings = async (page = 1, append = false, searchQueryParam = '') => {
+        globalError.value = null;
+        if (!append) {
+            isLoadingRecordings.value = true;
+        } else {
+            isLoadingMore.value = true;
+        }
+
+        try {
+            const endpoint = '/api/recordings';
+
+            const params = new URLSearchParams({
+                page: page.toString(),
+                per_page: perPage.value.toString()
+            });
+
+            if (searchQueryParam.trim()) {
+                params.set('q', searchQueryParam.trim());
+            }
+
+            // Add sort parameter
+            if (sortBy.value) {
+                params.set('sort_by', sortBy.value);
+            }
+
+            // Add archived/shared/starred/inbox filters as query params (ANDed with other filters)
+            if (showArchivedRecordings.value) {
+                params.set('archived', 'true');
+            }
+            if (showSharedWithMe.value) {
+                params.set('shared', 'true');
+            }
+            if (filterStarred.value) {
+                params.set('starred', 'true');
+            }
+            if (filterInbox.value) {
+                params.set('inbox', 'true');
+            }
+
+            // Add folder filter
+            if (filterFolder && filterFolder.value) {
+                params.set('folder', filterFolder.value);
+            }
+
+            const response = await fetch(`${endpoint}?${params}`);
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to load recordings');
+
+            const recordingsList = data.recordings;
+            const pagination = data.pagination;
+
+            if (!Array.isArray(recordingsList)) {
+                console.error('Unexpected response format:', data);
+                throw new Error('Invalid response format from server');
+            }
+
+            if (pagination) {
+                currentPage.value = pagination.page;
+                totalRecordings.value = pagination.total;
+                totalPages.value = pagination.total_pages;
+                hasNextPage.value = pagination.has_next;
+                hasPrevPage.value = pagination.has_prev;
+            } else {
+                currentPage.value = 1;
+                totalRecordings.value = recordingsList.length;
+                totalPages.value = 1;
+                hasNextPage.value = false;
+                hasPrevPage.value = false;
+            }
+
+            if (append) {
+                recordings.value = [...recordings.value, ...recordingsList];
+            } else {
+                recordings.value = recordingsList;
+                const lastRecordingId = localStorage.getItem('lastSelectedRecordingId');
+                if (lastRecordingId && recordingsList.length > 0) {
+                    const recordingToSelect = recordingsList.find(r => r.id == lastRecordingId);
+                    if (recordingToSelect) {
+                        selectRecording(recordingToSelect);
+                    }
+                }
+            }
+
+            // NOTE: Removed auto-queueing of incomplete recordings.
+            // Backend processing recordings are now shown via backendProcessingRecordings
+            // computed property, which filters recordings by status (PENDING, PROCESSING, etc.)
+            // The job queue system (ProcessingJob) handles background processing.
+
+        } catch (error) {
+            console.error('Load Recordings Error:', error);
+            setGlobalError(`Failed to load recordings: ${error.message}`);
+            if (!append) {
+                recordings.value = [];
+            }
+        } finally {
+            isLoadingRecordings.value = false;
+            isLoadingMore.value = false;
+        }
+    };
+
+    const loadMoreRecordings = async () => {
+        if (!hasNextPage.value || isLoadingMore.value) return;
+        await loadRecordings(currentPage.value + 1, true, searchQuery.value);
+    };
+
+    const performSearch = async (query = '') => {
+        currentPage.value = 1;
+        await loadRecordings(1, false, query);
+    };
+
+    const debouncedSearch = (query) => {
+        if (searchDebounceTimer.value) {
+            clearTimeout(searchDebounceTimer.value);
+        }
+        searchDebounceTimer.value = setTimeout(() => {
+            performSearch(query);
+        }, 300);
+    };
+
+    const loadTags = async () => {
+        try {
+            const response = await fetch('/api/tags');
+            if (response.ok) {
+                availableTags.value = await response.json();
+            } else {
+                availableTags.value = [];
+            }
+        } catch (error) {
+            console.warn('Error loading tags:', error);
+            availableTags.value = [];
+        }
+    };
+
+    const loadFolders = async () => {
+        try {
+            const response = await fetch('/api/folders');
+            if (response.ok) {
+                availableFolders.value = await response.json();
+            } else {
+                availableFolders.value = [];
+            }
+        } catch (error) {
+            console.warn('Error loading folders:', error);
+            availableFolders.value = [];
+        }
+    };
+
+    const loadSpeakers = async () => {
+        try {
+            const response = await fetch('/speakers');
+            if (response.ok) {
+                availableSpeakers.value = await response.json();
+            } else {
+                availableSpeakers.value = [];
+            }
+        } catch (error) {
+            console.warn('Error loading speakers:', error);
+            availableSpeakers.value = [];
+        }
+    };
+
+    const selectRecording = async (recording) => {
+        if (hasUnsavedRecording()) {
+            if (!confirm('You have an unsaved recording. Are you sure you want to leave?')) {
+                return;
+            }
+        }
+
+        // Check if switching away from incognito recording to a regular recording
+        if (incognitoRecording && incognitoRecording.value &&
+            selectedRecording.value?.id === 'incognito' &&
+            recording?.id !== 'incognito') {
+            if (!confirm('Switching to another recording will discard your incognito recording. Continue?')) {
+                return;
+            }
+            // Clear incognito recording immediately - this is the "incognito" promise
+            IncognitoStorage.clearIncognitoRecording();
+            incognitoRecording.value = null;
+        }
+
+        // Also clear any orphaned incognito data when selecting a non-incognito recording
+        // This handles edge cases like page refresh where the above check doesn't trigger
+        if (recording?.id !== 'incognito' && IncognitoStorage.hasIncognitoRecording()) {
+            console.log('[Incognito] Clearing orphaned incognito data');
+            IncognitoStorage.clearIncognitoRecording();
+            if (incognitoRecording) {
+                incognitoRecording.value = null;
+            }
+        }
+
+        // Reset modal audio state when switching recordings
+        if (utils.resetModalAudioState) {
+            utils.resetModalAudioState();
+        }
+
+        // Clear speaker color map when switching recordings - new colors will be assigned on first render
+        if (speakerColorMap) {
+            speakerColorMap.value = {};
+        }
+
+        selectedRecording.value = recording;
+
+        if (recording && recording.id) {
+            localStorage.setItem('lastSelectedRecordingId', recording.id);
+
+            try {
+                const response = await fetch(`/api/recordings/${recording.id}`);
+                if (response.ok) {
+                    const fullRecording = await response.json();
+                    selectedRecording.value = fullRecording;
+
+                    const index = recordings.value.findIndex(r => r.id === recording.id);
+                    if (index !== -1) {
+                        recordings.value[index] = fullRecording;
+                    }
+
+                    // Auto-start polling if recording is still processing or summarizing
+                    if (['PROCESSING', 'SUMMARIZING'].includes(fullRecording.status)) {
+                        console.log(`[AUTO-POLL] Recording ${fullRecording.id} is in ${fullRecording.status} state, starting auto-polling`);
+                        if (reprocessComposable && reprocessComposable.startReprocessingPoll) {
+                            reprocessComposable.startReprocessingPoll(fullRecording.id);
+                        } else {
+                            console.warn('[AUTO-POLL] reprocessComposable.startReprocessingPoll not available');
+                        }
+                    }
+                }
+            } catch (error) {
+                console.error('Error loading full recording:', error);
+            }
+        }
+
+        if (isMobileScreen.value) {
+            isSidebarCollapsed.value = true;
+        }
+
+        currentView.value = 'detail';
+
+        if (isRecording.value) {
+            // Don't interrupt recording
+        }
+        if (audioBlobURL.value) {
+            // Don't discard recorded audio
+        }
+    };
+
+    const hasUnsavedRecording = () => {
+        return isRecording.value || audioBlobURL.value;
+    };
+
+    const toggleInbox = async (recording) => {
+        if (!recording || !recording.id) return;
+
+        try {
+            const response = await fetch(`/recording/${recording.id}/toggle_inbox`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' }
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to toggle inbox status');
+
+            // Update the recording in the UI
+            recording.is_inbox = data.is_inbox;
+
+            // Update in the recordings list
+            const index = recordings.value.findIndex(r => r.id === recording.id);
+            if (index !== -1) {
+                recordings.value[index].is_inbox = data.is_inbox;
+            }
+
+            showToast(`Recording ${data.is_inbox ? 'moved to inbox' : 'marked as read'}`);
+        } catch (error) {
+            console.error('Toggle Inbox Error:', error);
+            setGlobalError(`Failed to toggle inbox status: ${error.message}`);
+        }
+    };
+
+    const toggleHighlight = async (recording) => {
+        if (!recording || !recording.id) return;
+
+        try {
+            const response = await fetch(`/recording/${recording.id}/toggle_highlight`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' }
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to toggle highlighted status');
+
+            // Update the recording in the UI
+            recording.is_highlighted = data.is_highlighted;
+
+            // Update in the recordings list
+            const index = recordings.value.findIndex(r => r.id === recording.id);
+            if (index !== -1) {
+                recordings.value[index].is_highlighted = data.is_highlighted;
+            }
+
+            showToast(`Recording ${data.is_highlighted ? 'highlighted' : 'unhighlighted'}`);
+        } catch (error) {
+            console.error('Toggle Highlight Error:', error);
+            setGlobalError(`Failed to toggle highlighted status: ${error.message}`);
+        }
+    };
+
+    const getRecordingTags = (recording) => {
+        if (!recording || !recording.tags) return [];
+        return recording.tags || [];
+    };
+
+    const getAvailableTagsForRecording = (recording) => {
+        if (!recording || !availableTags.value) return [];
+        const recordingTagIds = getRecordingTags(recording).map(tag => tag.id);
+        return availableTags.value.filter(tag => !recordingTagIds.includes(tag.id));
+    };
+
+    const filterByTag = (tag) => {
+        filterTags.value = [tag.id];
+        applyAdvancedFilters();
+    };
+
+    const buildSearchQuery = () => {
+        let query = [];
+
+        if (filterTextQuery.value.trim()) {
+            query.push(filterTextQuery.value.trim());
+        }
+
+        if (filterTags.value.length > 0) {
+            const tagNames = filterTags.value.map(tagId => {
+                const tag = availableTags.value.find(t => t.id === tagId);
+                return tag ? `tag:${tag.name.replace(/\s+/g, '_')}` : '';
+            }).filter(Boolean);
+            query.push(...tagNames);
+        }
+
+        if (filterSpeakers.value.length > 0) {
+            const speakerNames = filterSpeakers.value.map(name =>
+                `speaker:${name.replace(/\s+/g, '_')}`
+            );
+            query.push(...speakerNames);
+        }
+
+        if (filterDatePreset.value) {
+            query.push(`date:${filterDatePreset.value}`);
+        } else if (filterDateRange.value.start || filterDateRange.value.end) {
+            if (filterDateRange.value.start) {
+                query.push(`date_from:${filterDateRange.value.start}`);
+            }
+            if (filterDateRange.value.end) {
+                query.push(`date_to:${filterDateRange.value.end}`);
+            }
+        }
+
+        return query.join(' ');
+    };
+
+    const applyAdvancedFilters = () => {
+        searchQuery.value = buildSearchQuery();
+    };
+
+    const clearAllFilters = () => {
+        filterTags.value = [];
+        filterSpeakers.value = [];
+        filterDateRange.value = { start: '', end: '' };
+        filterDatePreset.value = '';
+        filterTextQuery.value = '';
+        filterStarred.value = false;
+        filterInbox.value = false;
+        // Note: filterFolder is NOT cleared here - it's a navigation element, not a filter
+        searchQuery.value = '';
+    };
+
+    const clearTagFilter = () => {
+        searchQuery.value = '';
+        clearAllFilters();
+    };
+
+    const addTagToSelection = (tagId) => {
+        if (!selectedTagIds.value.includes(tagId)) {
+            selectedTagIds.value.push(tagId);
+            applyTagDefaults();
+        }
+    };
+
+    const removeTagFromSelection = (tagId) => {
+        const index = selectedTagIds.value.indexOf(tagId);
+        if (index > -1) {
+            selectedTagIds.value.splice(index, 1);
+            applyTagDefaults();
+        }
+    };
+
+    const applyTagDefaults = () => {
+        const selectedTags = selectedTagIds.value.map(tagId =>
+            availableTags.value.find(tag => tag.id == tagId)
+        ).filter(Boolean);
+
+        const firstTag = selectedTags[0];
+        if (firstTag && connectorSupportsDiarization.value) {
+            if (firstTag.default_language) {
+                uploadLanguage.value = firstTag.default_language;
+            }
+            if (firstTag.default_min_speakers) {
+                uploadMinSpeakers.value = firstTag.default_min_speakers;
+            }
+            if (firstTag.default_max_speakers) {
+                uploadMaxSpeakers.value = firstTag.default_max_speakers;
+            }
+        }
+        if (firstTag) {
+            if (firstTag.default_hotwords) {
+                uploadHotwords.value = firstTag.default_hotwords;
+            }
+            if (firstTag.default_initial_prompt) {
+                uploadInitialPrompt.value = firstTag.default_initial_prompt;
+            }
+        }
+    };
+
+    const pollInboxRecordings = async () => {
+        try {
+            const response = await fetch('/api/recordings/inbox-count');
+            if (response.ok) {
+                const data = await response.json();
+                // Update inbox count in UI if needed
+            }
+        } catch (error) {
+            // Silent fail for polling
+        }
+    };
+
+    return {
+        loadRecordings,
+        loadMoreRecordings,
+        performSearch,
+        debouncedSearch,
+        loadTags,
+        loadFolders,
+        loadSpeakers,
+        selectRecording,
+        hasUnsavedRecording,
+        toggleInbox,
+        toggleHighlight,
+        getRecordingTags,
+        getAvailableTagsForRecording,
+        filterByTag,
+        buildSearchQuery,
+        applyAdvancedFilters,
+        clearAllFilters,
+        clearTagFilter,
+        addTagToSelection,
+        removeTagFromSelection,
+        applyTagDefaults,
+        pollInboxRecordings
+    };
+}
diff --git a/static/js/modules/composables/reprocess.js b/static/js/modules/composables/reprocess.js
new file mode 100644
index 00000000..d6912d77
--- /dev/null
+++ b/static/js/modules/composables/reprocess.js
@@ -0,0 +1,530 @@
+/**
+ * Reprocessing composable
+ * Handles reprocessing transcription and summary
+ */
+
+import * as IncognitoStorage from '../db/incognito-storage.js';
+
+export function useReprocess(state, utils) {
+    const { nextTick } = Vue;
+
+    const {
+        showReprocessModal, showResetModal, reprocessType,
+        reprocessRecording, recordingToReset, selectedRecording,
+        recordings, asrReprocessOptions, summaryReprocessPromptSource,
+        summaryReprocessSelectedTagId, summaryReprocessCustomPrompt,
+        summaryReprocessPromptMode, reprocessPromptVariables,
+        availableTags, processingProgress, processingMessage,
+        currentlyProcessingFile, uploadQueue, userTranscriptionLanguage,
+        showCustomizeSummaryModal, customizeSummaryPrompt, customizeSummaryMode
+    } = state;
+
+    const { showToast, setGlobalError, onChatComplete } = utils;
+
+    // Store for active polling intervals
+    const reprocessingPolls = new Map();
+
+    // =========================================
+    // Reprocess Modal
+    // =========================================
+
+    const openReprocessModal = (type, recording = null) => {
+        reprocessType.value = type;
+        reprocessRecording.value = recording || selectedRecording.value;
+        showReprocessModal.value = true;
+
+        // Reset options
+        if (type === 'transcription') {
+            asrReprocessOptions.language = userTranscriptionLanguage?.value || '';
+            asrReprocessOptions.min_speakers = '';
+            asrReprocessOptions.max_speakers = '';
+            asrReprocessOptions.hotwords = '';
+            asrReprocessOptions.initial_prompt = '';
+            asrReprocessOptions.transcription_model = '';
+        } else {
+            summaryReprocessPromptSource.value = 'default';
+            summaryReprocessSelectedTagId.value = '';
+            summaryReprocessCustomPrompt.value = '';
+
+            // Hydrate the reprocess prompt-variables form from the recording's
+            // saved values so the user starts with what they had at upload.
+            // Drop any existing keys first to keep the reactive object tidy.
+            for (const k of Object.keys(reprocessPromptVariables)) {
+                delete reprocessPromptVariables[k];
+            }
+            const stored = (reprocessRecording.value && reprocessRecording.value.prompt_variables) || {};
+            for (const [k, v] of Object.entries(stored)) {
+                reprocessPromptVariables[k] = v == null ? '' : String(v);
+            }
+        }
+    };
+
+    const closeReprocessModal = () => {
+        showReprocessModal.value = false;
+        reprocessRecording.value = null;
+        reprocessType.value = null;
+    };
+
+    const confirmReprocess = openReprocessModal;
+    const cancelReprocess = closeReprocessModal;
+
+    // =========================================
+    // Reset Status
+    // =========================================
+
+    const confirmReset = (recording) => {
+        recordingToReset.value = recording;
+        showResetModal.value = true;
+    };
+
+    const cancelReset = () => {
+        showResetModal.value = false;
+        recordingToReset.value = null;
+    };
+
+    const executeReset = async () => {
+        if (!recordingToReset.value) return;
+
+        const recordingId = recordingToReset.value.id;
+
+        // Close the modal first
+        cancelReset();
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${recordingId}/reset_status`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                }
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to reset recording status');
+
+            // Update recording status in list
+            const index = recordings.value.findIndex(r => r.id === recordingId);
+            if (index !== -1) {
+                recordings.value[index].status = 'FAILED';
+            }
+
+            if (selectedRecording.value?.id === recordingId) {
+                selectedRecording.value.status = 'FAILED';
+            }
+
+            showToast('Recording status reset to FAILED', 'fa-undo');
+        } catch (error) {
+            setGlobalError(`Failed to reset status: ${error.message}`);
+        }
+    };
+
+    const executeReprocess = async () => {
+        if (!reprocessRecording.value || !reprocessType.value) return;
+
+        const recordingId = reprocessRecording.value.id;
+        const type = reprocessType.value;
+
+        closeReprocessModal();
+
+        if (type === 'transcription') {
+            await reprocessTranscription(
+                recordingId,
+                asrReprocessOptions.language,
+                asrReprocessOptions.min_speakers,
+                asrReprocessOptions.max_speakers,
+                asrReprocessOptions.hotwords,
+                asrReprocessOptions.initial_prompt,
+                asrReprocessOptions.transcription_model
+            );
+        } else {
+            await reprocessSummary(
+                recordingId,
+                summaryReprocessPromptSource.value,
+                summaryReprocessSelectedTagId.value,
+                summaryReprocessCustomPrompt.value,
+                summaryReprocessPromptMode.value,
+                { ...reprocessPromptVariables }
+            );
+        }
+    };
+
+    // =========================================
+    // Transcription Reprocessing
+    // =========================================
+
+    const reprocessTranscription = async (recordingId, language, minSpeakers, maxSpeakers, hotwords, initialPrompt, transcriptionModel) => {
+        if (!recordingId) {
+            setGlobalError('No recording ID provided for reprocessing.');
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const requestBody = {
+                language: language || ''  // Always send language - empty string means auto-detect
+            };
+            if (minSpeakers && minSpeakers !== '') requestBody.min_speakers = parseInt(minSpeakers);
+            if (maxSpeakers && maxSpeakers !== '') requestBody.max_speakers = parseInt(maxSpeakers);
+            if (hotwords && hotwords.trim()) requestBody.hotwords = hotwords.trim();
+            if (initialPrompt && initialPrompt.trim()) requestBody.initial_prompt = initialPrompt.trim();
+            if (transcriptionModel && transcriptionModel.trim()) requestBody.transcription_model = transcriptionModel.trim();
+
+            const response = await fetch(`/recording/${recordingId}/reprocess_transcription`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify(requestBody)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to start transcription reprocessing');
+
+            // Update recording status in list
+            const index = recordings.value.findIndex(r => r.id === recordingId);
+            if (index !== -1) {
+                recordings.value[index].status = 'PROCESSING';
+            }
+
+            if (selectedRecording.value?.id === recordingId) {
+                selectedRecording.value.status = 'PROCESSING';
+            }
+
+            showToast('Transcription reprocessing started', 'fa-sync-alt');
+
+            // Start polling for progress
+            startReprocessingPoll(recordingId);
+        } catch (error) {
+            setGlobalError(`Failed to start transcription reprocessing: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Summary Reprocessing
+    // =========================================
+
+    const reprocessSummary = async (recordingId, promptSource, selectedTagId, customPrompt, promptMode, promptVariables) => {
+        if (!recordingId) {
+            setGlobalError('No recording ID provided for reprocessing.');
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const requestBody = { reprocess_summary: true };
+            const mode = promptMode === 'append' ? 'append' : 'replace';
+
+            if (promptSource === 'tag' && selectedTagId) {
+                const selectedTag = availableTags.value.find(t => t.id == selectedTagId);
+                if (selectedTag && selectedTag.custom_prompt) {
+                    requestBody.custom_prompt = selectedTag.custom_prompt;
+                    // A tag selection always fully replaces the resolved
+                    // default; Append/Replace is offered only for custom
+                    // prompts, so force replace here even if the ref still
+                    // holds an older mode value.
+                    requestBody.prompt_mode = 'replace';
+                }
+            } else if (promptSource === 'custom' && customPrompt) {
+                requestBody.custom_prompt = customPrompt;
+                requestBody.prompt_mode = mode;
+            }
+
+            // Carry the user-edited prompt-variable values so the recording's
+            // stored map gets updated before the summary task runs.
+            if (promptVariables && typeof promptVariables === 'object') {
+                const cleaned = {};
+                for (const [key, value] of Object.entries(promptVariables)) {
+                    if (value !== undefined && value !== null && String(value).trim() !== '') {
+                        cleaned[key] = String(value);
+                    }
+                }
+                requestBody.prompt_variables = cleaned;
+            }
+
+            const response = await fetch(`/recording/${recordingId}/reprocess_summary`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify(requestBody)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to start summary reprocessing');
+
+            // Update recording status in list
+            const index = recordings.value.findIndex(r => r.id === recordingId);
+            if (index !== -1) {
+                recordings.value[index].status = 'SUMMARIZING';
+            }
+
+            if (selectedRecording.value?.id === recordingId) {
+                selectedRecording.value.status = 'SUMMARIZING';
+            }
+
+            showToast('Summary reprocessing started', 'fa-sync-alt');
+
+            // Start polling for progress
+            startReprocessingPoll(recordingId);
+        } catch (error) {
+            setGlobalError(`Failed to start summary reprocessing: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Generate Summary
+    // =========================================
+
+    // Open the "customise summarisation prompt" modal pre-populated with the
+    // user's saved summary prompt (or the admin default if the user hasn't
+    // set one). The user can then add or replace before generating.
+    const openCustomizeSummaryModal = () => {
+        if (!selectedRecording.value) return;
+        // Default mode: append. Most users want to add agenda/context to
+        // their saved prompt rather than replace it.
+        customizeSummaryMode.value = 'append';
+        // Start with an empty textarea so the user types just the additional
+        // context. They can switch to replace mode and write a full prompt.
+        customizeSummaryPrompt.value = '';
+        showCustomizeSummaryModal.value = true;
+    };
+
+    const closeCustomizeSummaryModal = () => {
+        showCustomizeSummaryModal.value = false;
+    };
+
+    const submitCustomizeSummaryModal = async () => {
+        const prompt = (customizeSummaryPrompt.value || '').trim();
+        const mode = customizeSummaryMode.value === 'replace' ? 'replace' : 'append';
+        showCustomizeSummaryModal.value = false;
+        await generateSummary({ customPrompt: prompt, promptMode: mode });
+    };
+
+    const generateSummary = async (options = {}) => {
+        if (!selectedRecording.value) return;
+        const customPrompt = (options.customPrompt || '').trim();
+        const promptMode = options.promptMode === 'append' ? 'append' : 'replace';
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            // Check if this is an incognito recording
+            if (selectedRecording.value.incognito === true) {
+                // Use incognito summary endpoint - generate synchronously
+                const response = await fetch('/api/recordings/incognito/summary', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify({
+                        transcription: selectedRecording.value.transcription
+                    })
+                });
+
+                const data = await response.json();
+                if (!response.ok) throw new Error(data.error || 'Failed to generate summary');
+
+                // Update the incognito recording with the new summary
+                selectedRecording.value.summary = data.summary;
+                selectedRecording.value.summary_html = data.summary_html;
+
+                // Update sessionStorage
+                IncognitoStorage.updateIncognitoRecording({
+                    summary: data.summary,
+                    summary_html: data.summary_html
+                });
+
+                showToast('Summary generated', 'fa-file-alt');
+                return;
+            }
+
+            // Regular recording - use existing flow. Forward an optional
+            // user-supplied custom prompt + mode (issue / discussion #253).
+            const body = {};
+            if (customPrompt) {
+                body.custom_prompt = customPrompt;
+                body.prompt_mode = promptMode;
+            }
+            const response = await fetch(`/recording/${selectedRecording.value.id}/generate_summary`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify(body),
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to start summary generation');
+
+            selectedRecording.value.status = 'SUMMARIZING';
+
+            const recordingInList = recordings.value.find(r => r.id === selectedRecording.value.id);
+            if (recordingInList) {
+                recordingInList.status = 'SUMMARIZING';
+            }
+
+            showToast('Summary generation started', 'fa-file-alt');
+
+            // Start polling for progress
+            startReprocessingPoll(selectedRecording.value.id);
+        } catch (error) {
+            setGlobalError(`Failed to generate summary: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Progress Polling
+    // =========================================
+
+    const startReprocessingPoll = (recordingId) => {
+        // Stop existing poll if any
+        stopReprocessingPoll(recordingId);
+
+        // Track if we've already fetched full data for SUMMARIZING status
+        let hasFetchedForSummarizing = false;
+
+        const pollInterval = setInterval(async () => {
+            try {
+                // Use lightweight status-only endpoint
+                const response = await fetch(`/recording/${recordingId}/status`);
+                if (!response.ok) throw new Error('Status check failed');
+
+                const statusData = await response.json();
+
+                // Update status in recordings list
+                const index = recordings.value.findIndex(r => r.id === recordingId);
+
+                if (index !== -1) {
+                    // Create new object to ensure Vue reactivity
+                    recordings.value[index] = {
+                        ...recordings.value[index],
+                        status: statusData.status
+                    };
+                }
+
+                // Update selectedRecording with new object reference for reactivity
+                if (selectedRecording.value?.id === recordingId) {
+                    selectedRecording.value = {
+                        ...selectedRecording.value,
+                        status: statusData.status
+                    };
+                }
+
+                // Check if summarization has started (fetch transcript) or processing is complete
+                if (statusData.status === 'SUMMARIZING' || statusData.status === 'COMPLETED') {
+                    // Only fetch once when status first becomes SUMMARIZING
+                    const shouldFetch = (statusData.status === 'SUMMARIZING' && !hasFetchedForSummarizing) ||
+                                      statusData.status === 'COMPLETED';
+
+                    if (shouldFetch) {
+                        // Mark that we've fetched for SUMMARIZING
+                        if (statusData.status === 'SUMMARIZING') {
+                            hasFetchedForSummarizing = true;
+                        }
+
+                        // Only stop polling if COMPLETED, keep polling during SUMMARIZING
+                        if (statusData.status === 'COMPLETED') {
+                            stopReprocessingPoll(recordingId);
+                        }
+
+                        // Fetch the full recording with updated data
+                        const fullResponse = await fetch(`/api/recordings/${recordingId}`);
+
+                        if (fullResponse.ok) {
+                            const fullData = await fullResponse.json();
+
+                            // Update in recordings list first
+                            const currentIndex = recordings.value.findIndex(r => r.id === recordingId);
+                            if (currentIndex !== -1) {
+                                recordings.value[currentIndex] = fullData;
+                            }
+
+                            // Always update selectedRecording if it's the current recording
+                            if (selectedRecording.value?.id === recordingId) {
+                                selectedRecording.value = fullData;
+                                await nextTick();
+                            }
+                        }
+
+                        if (statusData.status === 'COMPLETED') {
+                            showToast('Processing completed!', 'fa-check-circle');
+                            // Refresh token budget after LLM operations complete
+                            if (onChatComplete) onChatComplete();
+                        }
+                    }
+                } else if (statusData.status === 'FAILED') {
+                    stopReprocessingPoll(recordingId);
+
+                    // Fetch full recording data to get error details for display
+                    try {
+                        const failedResponse = await fetch(`/api/recordings/${recordingId}`);
+                        if (failedResponse.ok) {
+                            const failedData = await failedResponse.json();
+
+                            // Update in recordings list
+                            const currentIndex = recordings.value.findIndex(r => r.id === recordingId);
+                            if (currentIndex !== -1) {
+                                recordings.value[currentIndex] = failedData;
+                            }
+
+                            // Update selectedRecording to show error in transcription panel
+                            if (selectedRecording.value?.id === recordingId) {
+                                selectedRecording.value = failedData;
+                                await nextTick();
+                            }
+                        }
+                    } catch (err) {
+                        console.error('Failed to fetch error details:', err);
+                    }
+
+                    showToast('Processing failed', 'fa-exclamation-circle');
+                }
+            } catch (error) {
+                console.error('Polling error:', error);
+                stopReprocessingPoll(recordingId);
+            }
+        }, 3000);
+
+        reprocessingPolls.set(recordingId, pollInterval);
+    };
+
+    const stopReprocessingPoll = (recordingId) => {
+        if (reprocessingPolls.has(recordingId)) {
+            clearInterval(reprocessingPolls.get(recordingId));
+            reprocessingPolls.delete(recordingId);
+        }
+    };
+
+    return {
+        // Reprocess modal
+        openReprocessModal,
+        closeReprocessModal,
+        confirmReprocess,
+        cancelReprocess,
+        executeReprocess,
+
+        // Reset status
+        confirmReset,
+        cancelReset,
+        executeReset,
+
+        // Transcription
+        reprocessTranscription,
+
+        // Summary
+        reprocessSummary,
+        generateSummary,
+        openCustomizeSummaryModal,
+        closeCustomizeSummaryModal,
+        submitCustomizeSummaryModal,
+
+        // Polling
+        startReprocessingPoll,
+        stopReprocessingPoll
+    };
+}
diff --git a/static/js/modules/composables/sharing.js b/static/js/modules/composables/sharing.js
new file mode 100644
index 00000000..6b60e989
--- /dev/null
+++ b/static/js/modules/composables/sharing.js
@@ -0,0 +1,659 @@
+/**
+ * Sharing composable
+ * Handles public and internal sharing of recordings
+ */
+
+export function useSharing(state, utils) {
+    const {
+        showShareModal, showSharesListModal, showShareDeleteModal,
+        showUnifiedShareModal, recordingToShare, shareOptions,
+        generatedShareLink, existingShareDetected, recordingPublicShares, isLoadingPublicShares,
+        userShares, isLoadingShares, copiedShareId, shareToDelete, selectedRecording, recordings,
+        internalShareUserSearch, internalShareSearchResults,
+        internalShareRecording, internalSharePermissions, internalShareMaxPermissions,
+        recordingInternalShares, isLoadingInternalShares,
+        isSearchingUsers, allUsers, isLoadingAllUsers,
+        enableInternalSharing, showUsernamesInUI
+    } = state;
+
+    const { showToast, setGlobalError } = utils;
+
+    let userSearchTimeout = null;
+
+    // Helper function to format share dates
+    const formatShareDate = (dateString) => {
+        if (!dateString) return 'Unknown date';
+
+        try {
+            const date = new Date(dateString);
+            const now = new Date();
+            const diffMs = now - date;
+            const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+
+            // If today
+            if (diffDays === 0) {
+                return 'Today at ' + date.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
+            }
+            // If yesterday
+            else if (diffDays === 1) {
+                return 'Yesterday at ' + date.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
+            }
+            // If within last week
+            else if (diffDays < 7) {
+                return date.toLocaleDateString('en-US', { weekday: 'long', hour: 'numeric', minute: '2-digit', hour12: true });
+            }
+            // Otherwise show full date
+            else {
+                return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric', hour: 'numeric', minute: '2-digit', hour12: true });
+            }
+        } catch (e) {
+            console.error('Error formatting date:', e);
+            return dateString;
+        }
+    };
+
+    // Helper function to get color class for username (like speaker colors)
+    const getUserColorClass = (username) => {
+        if (!username) return 'speaker-color-1';
+
+        // Simple hash function to generate consistent color from username
+        let hash = 0;
+        for (let i = 0; i < username.length; i++) {
+            hash = ((hash << 5) - hash) + username.charCodeAt(i);
+            hash = hash & hash; // Convert to 32bit integer
+        }
+
+        // Map to color classes 1-16
+        const colorNum = (Math.abs(hash) % 16) + 1;
+        return `speaker-color-${colorNum}`;
+    };
+
+    // =========================================
+    // Public Sharing
+    // =========================================
+
+    const openShareModal = async (recording) => {
+        recordingToShare.value = recording;
+        shareOptions.share_summary = true;
+        shareOptions.share_notes = true;
+        generatedShareLink.value = '';
+        existingShareDetected.value = false;
+        recordingPublicShares.value = [];
+        showShareModal.value = true;
+
+        // Load all public shares for this recording
+        isLoadingPublicShares.value = true;
+        try {
+            const response = await fetch(`/api/shares`);
+            if (response.ok) {
+                const allShares = await response.json();
+                // Filter to only shares for this recording and add share_url
+                recordingPublicShares.value = allShares
+                    .filter(share => share.recording_id === recording.id)
+                    .map(share => ({
+                        ...share,
+                        share_url: `${window.location.origin}/share/${share.public_id}`
+                    }));
+            }
+        } catch (error) {
+            console.error('Error loading public shares:', error);
+            recordingPublicShares.value = [];
+        } finally {
+            isLoadingPublicShares.value = false;
+        }
+    };
+
+    const closeShareModal = () => {
+        showShareModal.value = false;
+        recordingToShare.value = null;
+        existingShareDetected.value = false;
+        recordingPublicShares.value = [];
+    };
+
+    const createShare = async (forceNew = false) => {
+        const recording = recordingToShare.value || internalShareRecording.value;
+        if (!recording) return;
+
+        try {
+            const response = await fetch(`/api/recording/${recording.id}/share`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    ...shareOptions,
+                    force_new: forceNew
+                })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to create share link');
+
+            generatedShareLink.value = data.share_url;
+            existingShareDetected.value = data.existing && !forceNew;
+
+            // Add to the shares list (works for both share modal and unified modal)
+            if (!data.existing) {
+                recordingPublicShares.value.push({
+                    ...data.share,
+                    share_url: `${window.location.origin}/share/${data.share.public_id}`
+                });
+                // Update the recording's share count in the UI
+                await refreshRecordingShareCounts();
+            } else if (data.existing && !recordingPublicShares.value.find(s => s.id === data.share.id)) {
+                // If existing but not in list, add it
+                recordingPublicShares.value.push({
+                    ...data.share,
+                    share_url: `${window.location.origin}/share/${data.share.public_id}`
+                });
+            }
+
+            if (data.existing && !forceNew) {
+                showToast('Using existing share link', 'fa-link');
+            } else {
+                showToast('Share link created successfully!', 'fa-check-circle');
+            }
+        } catch (error) {
+            setGlobalError(`Failed to create share link: ${error.message}`);
+        }
+    };
+
+    const confirmDeletePublicShare = (share) => {
+        shareToDelete.value = share;
+        showShareDeleteModal.value = true;
+    };
+
+    const deletePublicShare = async () => {
+        if (!shareToDelete.value) return;
+        const shareId = shareToDelete.value.id;
+
+        try {
+            const response = await fetch(`/api/share/${shareId}`, { method: 'DELETE' });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to delete share');
+
+            // Remove from the shares list (both modals use different arrays)
+            recordingPublicShares.value = recordingPublicShares.value.filter(s => s.id !== shareId);
+            userShares.value = userShares.value.filter(s => s.id !== shareId);
+
+            // Update the recording's share count in the UI
+            await refreshRecordingShareCounts();
+
+            showToast('Share link deleted successfully.', 'fa-check-circle');
+            showShareDeleteModal.value = false;
+            shareToDelete.value = null;
+        } catch (error) {
+            setGlobalError(`Failed to delete share: ${error.message}`);
+        }
+    };
+
+    const copyPublicShareLink = (shareUrl) => {
+        navigator.clipboard.writeText(shareUrl).then(() => {
+            showToast('Share link copied to clipboard!', 'fa-check-circle');
+        }).catch(() => {
+            setGlobalError('Failed to copy link to clipboard');
+        });
+    };
+
+    const copyPublicShareLinkWithFeedback = (shareUrl, shareId) => {
+        navigator.clipboard.writeText(shareUrl).then(() => {
+            copiedShareId.value = shareId;
+            showToast('Share link copied to clipboard!', 'fa-check-circle');
+
+            // Reset after delay
+            setTimeout(() => {
+                copiedShareId.value = null;
+            }, 1500);
+        }).catch(() => {
+            setGlobalError('Failed to copy link to clipboard');
+        });
+    };
+
+    const refreshRecordingShareCounts = async () => {
+        // Refresh the current recording if one is selected
+        const recording = recordingToShare.value || internalShareRecording.value || selectedRecording.value;
+        if (!recording) return;
+
+        try {
+            const response = await fetch(`/api/recordings/${recording.id}`);
+            if (response.ok) {
+                const updatedRecording = await response.json();
+
+                // Update in recordings list
+                const index = recordings.value.findIndex(r => r.id === recording.id);
+                if (index !== -1) {
+                    // Preserve reactivity by updating specific fields
+                    recordings.value[index].public_share_count = updatedRecording.public_share_count || 0;
+                    recordings.value[index].shared_with_count = updatedRecording.shared_with_count || 0;
+                }
+
+                // Update selected recording if it's the same one
+                if (selectedRecording.value && selectedRecording.value.id === recording.id) {
+                    selectedRecording.value.public_share_count = updatedRecording.public_share_count || 0;
+                    selectedRecording.value.shared_with_count = updatedRecording.shared_with_count || 0;
+                }
+
+                // Update internal share recording if it's the same one
+                if (internalShareRecording.value && internalShareRecording.value.id === recording.id) {
+                    internalShareRecording.value.public_share_count = updatedRecording.public_share_count || 0;
+                    internalShareRecording.value.shared_with_count = updatedRecording.shared_with_count || 0;
+                }
+
+                // Update recording to share if it's the same one
+                if (recordingToShare.value && recordingToShare.value.id === recording.id) {
+                    recordingToShare.value.public_share_count = updatedRecording.public_share_count || 0;
+                    recordingToShare.value.shared_with_count = updatedRecording.shared_with_count || 0;
+                }
+            }
+        } catch (error) {
+            console.error('Failed to refresh recording share counts:', error);
+        }
+    };
+
+    const copyShareLink = () => {
+        if (!generatedShareLink.value) return;
+        navigator.clipboard.writeText(generatedShareLink.value).then(() => {
+            showToast('Share link copied to clipboard!');
+        });
+    };
+
+    const copyIndividualShareLink = (shareId) => {
+        const input = document.getElementById(`share-link-${shareId}`);
+        if (!input) return;
+
+        const button = input.nextElementSibling;
+        if (!button) return;
+
+        navigator.clipboard.writeText(input.value).then(() => {
+            copiedShareId.value = shareId;
+            showToast('Share link copied to clipboard!', 'fa-check');
+
+            // Apply success state
+            button.style.transition = 'background-color 0.2s ease';
+            button.style.backgroundColor = 'var(--bg-success, #10b981)';
+
+            // Revert after delay
+            setTimeout(() => {
+                button.style.backgroundColor = '';
+                copiedShareId.value = null;
+                setTimeout(() => {
+                    button.style.transition = '';
+                }, 200);
+            }, 1500);
+        }).catch(err => {
+            console.error('Failed to copy share link:', err);
+        });
+    };
+
+    // =========================================
+    // Shares List
+    // =========================================
+
+    const openSharesList = async () => {
+        isLoadingShares.value = true;
+        showSharesListModal.value = true;
+        try {
+            const response = await fetch('/api/shares');
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to load shared items');
+            userShares.value = data;
+        } catch (error) {
+            setGlobalError(`Failed to load shared items: ${error.message}`);
+        } finally {
+            isLoadingShares.value = false;
+        }
+    };
+
+    const closeSharesList = () => {
+        showSharesListModal.value = false;
+        userShares.value = [];
+    };
+
+    const updateShare = async (share) => {
+        try {
+            const response = await fetch(`/api/share/${share.id}`, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    share_summary: share.share_summary,
+                    share_notes: share.share_notes
+                })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update share');
+            showToast('Share permissions updated.', 'fa-check-circle');
+        } catch (error) {
+            setGlobalError(`Failed to update share: ${error.message}`);
+        }
+    };
+
+    const confirmDeleteShare = (share) => {
+        shareToDelete.value = share;
+        showShareDeleteModal.value = true;
+    };
+
+    const cancelDeleteShare = () => {
+        shareToDelete.value = null;
+        showShareDeleteModal.value = false;
+    };
+
+    // =========================================
+    // Internal Sharing
+    // =========================================
+
+    const loadAllUsers = async () => {
+        if (!showUsernamesInUI.value) return;
+
+        isLoadingAllUsers.value = true;
+        try {
+            const response = await fetch('/api/users/search?q=');
+            if (!response.ok) {
+                if (response.status === 403) {
+                    throw new Error('Internal sharing is not enabled');
+                }
+                throw new Error('Failed to load users');
+            }
+            const data = await response.json();
+            allUsers.value = data;
+        } catch (error) {
+            setGlobalError(`Failed to load users: ${error.message}`);
+            allUsers.value = [];
+        } finally {
+            isLoadingAllUsers.value = false;
+        }
+    };
+
+    const searchInternalShareUsers = async () => {
+        const query = internalShareUserSearch.value.trim();
+
+        // If SHOW_USERNAMES_IN_UI is enabled, filter allUsers locally
+        if (showUsernamesInUI.value) {
+            // Get list of user IDs that already have access
+            const sharedUserIds = new Set(recordingInternalShares.value.map(share => share.user_id));
+
+            // Filter out already-shared users
+            const availableUsers = allUsers.value.filter(user => !sharedUserIds.has(user.id));
+
+            if (query.length === 0) {
+                internalShareSearchResults.value = availableUsers;
+            } else {
+                internalShareSearchResults.value = availableUsers.filter(user =>
+                    user.username.toLowerCase().includes(query.toLowerCase()) ||
+                    (user.email && user.email.toLowerCase().includes(query.toLowerCase()))
+                );
+            }
+            return;
+        }
+
+        // Otherwise, use server-side search
+        if (query.length < 2) {
+            internalShareSearchResults.value = [];
+            return;
+        }
+
+        clearTimeout(userSearchTimeout);
+        userSearchTimeout = setTimeout(async () => {
+            isSearchingUsers.value = true;
+            try {
+                const response = await fetch(`/api/users/search?q=${encodeURIComponent(query)}`);
+                if (!response.ok) {
+                    if (response.status === 403) {
+                        throw new Error('Internal sharing is not enabled');
+                    }
+                    throw new Error('Failed to search users');
+                }
+                const data = await response.json();
+                internalShareSearchResults.value = data;
+            } catch (error) {
+                setGlobalError(`Failed to search users: ${error.message}`);
+                internalShareSearchResults.value = [];
+            } finally {
+                isSearchingUsers.value = false;
+            }
+        }, 300);
+    };
+
+    const openUnifiedShareModal = async (recording) => {
+        internalShareRecording.value = recording;
+        internalShareUserSearch.value = '';
+        internalShareSearchResults.value = [];
+        internalSharePermissions.value = { can_edit: false, can_reshare: false };
+        recordingPublicShares.value = [];
+        shareOptions.share_summary = true;
+        shareOptions.share_notes = true;
+
+        // PERMISSION CEILING: Calculate maximum permissions current user can grant
+        // If viewing a shared recording (not owner), constrain to their permissions
+        if (recording.is_shared && recording.share_info) {
+            internalShareMaxPermissions.value = {
+                can_edit: recording.share_info.can_edit || false,
+                can_reshare: recording.share_info.can_reshare || false
+            };
+        } else {
+            // Owner has unlimited permissions
+            internalShareMaxPermissions.value = {
+                can_edit: true,
+                can_reshare: true
+            };
+        }
+
+        showUnifiedShareModal.value = true;
+
+        // Load all public shares for this recording
+        isLoadingPublicShares.value = true;
+        try {
+            const response = await fetch(`/api/shares`);
+            if (response.ok) {
+                const allShares = await response.json();
+                // Filter to only shares for this recording and add share_url
+                recordingPublicShares.value = allShares
+                    .filter(share => share.recording_id === recording.id)
+                    .map(share => ({
+                        ...share,
+                        share_url: `${window.location.origin}/share/${share.public_id}`
+                    }));
+            }
+        } catch (error) {
+            console.error('Error loading public shares:', error);
+            recordingPublicShares.value = [];
+        } finally {
+            isLoadingPublicShares.value = false;
+        }
+
+        // Load existing internal shares
+        isLoadingInternalShares.value = true;
+        try {
+            const response = await fetch(`/api/recordings/${recording.id}/shares-internal`);
+            if (!response.ok) {
+                if (response.status === 403) {
+                    throw new Error('Internal sharing is not enabled');
+                }
+                throw new Error('Failed to load shares');
+            }
+            const data = await response.json();
+            recordingInternalShares.value = data.shares || [];
+        } catch (error) {
+            setGlobalError(`Failed to load shares: ${error.message}`);
+            recordingInternalShares.value = [];
+        } finally {
+            isLoadingInternalShares.value = false;
+        }
+
+        // If SHOW_USERNAMES_IN_UI is enabled, load all users
+        if (showUsernamesInUI.value) {
+            await loadAllUsers();
+            internalShareSearchResults.value = allUsers.value;
+        }
+    };
+
+    const closeUnifiedShareModal = () => {
+        showUnifiedShareModal.value = false;
+        internalShareRecording.value = null;
+        internalShareUserSearch.value = '';
+        internalShareSearchResults.value = [];
+        recordingInternalShares.value = [];
+        recordingPublicShares.value = [];
+        allUsers.value = [];
+    };
+
+    // Legacy function names for backward compatibility
+    const openInternalShareModal = openUnifiedShareModal;
+    const openManageInternalSharesModal = openUnifiedShareModal;
+    const closeInternalShareModal = closeUnifiedShareModal;
+    const closeManageInternalSharesModal = closeUnifiedShareModal;
+
+    const reloadInternalShares = async () => {
+        if (!internalShareRecording.value) return;
+
+        isLoadingInternalShares.value = true;
+        try {
+            const response = await fetch(`/api/recordings/${internalShareRecording.value.id}/shares-internal`);
+            if (!response.ok) {
+                throw new Error('Failed to load shares');
+            }
+            const data = await response.json();
+            recordingInternalShares.value = data.shares || [];
+        } catch (error) {
+            setGlobalError(`Failed to reload shares: ${error.message}`);
+        } finally {
+            isLoadingInternalShares.value = false;
+        }
+    };
+
+    const shareWithUsername = async () => {
+        if (!internalShareRecording.value) return;
+
+        const username = internalShareUserSearch.value.trim();
+        if (!username) {
+            setGlobalError('Please enter a username');
+            return;
+        }
+
+        isSearchingUsers.value = true;
+        try {
+            // Search for the exact username
+            const searchResponse = await fetch(`/api/users/search?q=${encodeURIComponent(username)}`);
+            if (!searchResponse.ok) {
+                if (searchResponse.status === 403) {
+                    throw new Error('Internal sharing is not enabled');
+                }
+                throw new Error('Failed to find user');
+            }
+
+            const users = await searchResponse.json();
+
+            if (users.length === 0) {
+                setGlobalError(`User "${username}" not found`);
+                return;
+            }
+
+            // Use the first matching user (should be exact match from backend)
+            const user = users[0];
+            await createInternalShare(user.id, user.username);
+
+            // Clear input on success
+            internalShareUserSearch.value = '';
+        } catch (error) {
+            setGlobalError(error.message || 'Failed to share with user');
+        } finally {
+            isSearchingUsers.value = false;
+        }
+    };
+
+    const createInternalShare = async (userId, username) => {
+        if (!internalShareRecording.value) return;
+
+        try {
+            const response = await fetch(`/api/recordings/${internalShareRecording.value.id}/share-internal`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    user_id: userId,
+                    can_edit: internalSharePermissions.value.can_edit,
+                    can_reshare: internalSharePermissions.value.can_reshare
+                })
+            });
+
+            const data = await response.json();
+            if (!response.ok) {
+                throw new Error(data.error || 'Failed to share recording');
+            }
+
+            const displayName = showUsernamesInUI.value ? username : `User #${userId}`;
+            showToast(`Recording shared with ${displayName}`, 'fa-share-alt');
+
+            // Reset permissions for next share
+            internalSharePermissions.value = { can_edit: false, can_reshare: false };
+
+            // Reload shares to show the new share in the list
+            await reloadInternalShares();
+
+            // Update the recording's share count in the UI
+            await refreshRecordingShareCounts();
+        } catch (error) {
+            setGlobalError(`Failed to share recording: ${error.message}`);
+        }
+    };
+
+    const revokeInternalShare = async (shareId, username) => {
+        if (!internalShareRecording.value) return;
+
+        try {
+            const response = await fetch(`/api/internal-shares/${shareId}`, {
+                method: 'DELETE'
+            });
+
+            if (!response.ok) {
+                const data = await response.json();
+                throw new Error(data.error || 'Failed to revoke share');
+            }
+
+            recordingInternalShares.value = recordingInternalShares.value.filter(s => s.id !== shareId);
+            const displayName = showUsernamesInUI.value ? username : 'User';
+            showToast(`Access revoked for ${displayName}`, 'fa-user-times');
+
+            // Update the recording's share count in the UI
+            await refreshRecordingShareCounts();
+        } catch (error) {
+            setGlobalError(`Failed to revoke share: ${error.message}`);
+        }
+    };
+
+    return {
+        // Utilities
+        formatShareDate,
+        getUserColorClass,
+
+        // Public sharing
+        openShareModal,
+        closeShareModal,
+        createShare,
+        copyShareLink,
+        copyPublicShareLink,
+        copyPublicShareLinkWithFeedback,
+        copyIndividualShareLink,
+        confirmDeletePublicShare,
+        deletePublicShare,
+        refreshRecordingShareCounts,
+
+        // Shares list
+        openSharesList,
+        closeSharesList,
+        updateShare,
+        confirmDeleteShare,
+        cancelDeleteShare,
+        deleteShare: deletePublicShare, // Alias for template compatibility
+        copiedShareId,
+
+        // Internal sharing
+        loadAllUsers,
+        searchInternalShareUsers,
+        openUnifiedShareModal,
+        closeUnifiedShareModal,
+        openInternalShareModal,
+        closeInternalShareModal,
+        openManageInternalSharesModal,
+        closeManageInternalSharesModal,
+        reloadInternalShares,
+        shareWithUsername,
+        createInternalShare,
+        revokeInternalShare
+    };
+}
diff --git a/static/js/modules/composables/speakers.js b/static/js/modules/composables/speakers.js
new file mode 100644
index 00000000..9ab2f0ed
--- /dev/null
+++ b/static/js/modules/composables/speakers.js
@@ -0,0 +1,1251 @@
+/**
+ * Speaker management composable
+ * Handles speaker identification, naming, and navigation
+ */
+
+export function useSpeakers(state, utils, processedTranscription) {
+    const { nextTick } = Vue;
+    const {
+        showSpeakerModal, speakerModalTab, showAddSpeakerModal, showEditSpeakersModal,
+        showEditTextModal, selectedRecording, recordings,
+        speakerMap, speakerColorMap, modalSpeakers, speakerDisplayMap, speakerSuggestions, loadingSuggestions,
+        activeSpeakerInput, regenerateSummaryAfterSpeakerUpdate,
+        editingSpeakersList, databaseSpeakers, editingSpeakerSuggestions,
+        editSpeakerDropdownPositions, newSpeakerName, newSpeakerIsMe,
+        newSpeakerSuggestions, loadingNewSpeakerSuggestions, showNewSpeakerSuggestions,
+        editingSegmentIndex, editingSpeakerIndex, editedText, editedTranscriptData, highlightedSpeaker,
+        isAutoIdentifying, availableSpeakers, editingSegments,
+        currentSpeakerGroupIndex, speakerGroups, currentUserName,
+        voiceSuggestions, loadingVoiceSuggestions
+    } = state;
+
+    const { showToast, setGlobalError, onChatComplete } = utils;
+
+    // i18n helper — falls back to the provided fallback string if i18n is not loaded
+    const t = (key, params, fallback) => window.i18n ? window.i18n.t(key, params) : (fallback || key);
+    const tc = (key, count, params) => window.i18n ? window.i18n.tc(key, count, params) : (params && params.count != null ? `${params.count}` : key);
+
+    // Current speaker highlight state
+    let currentSpeakerId = null;
+
+    // Number of speaker colors available in CSS (must match styles.css and app.modular.js)
+    const SPEAKER_COLOR_COUNT = 16;
+
+    // Get speaker color from the shared color map
+    // If speaker not in map, assign next available color
+    const getSpeakerColor = (speakerId) => {
+        if (speakerColorMap.value[speakerId]) {
+            return speakerColorMap.value[speakerId];
+        }
+        // Assign next color to new speaker
+        const colorIndex = Object.keys(speakerColorMap.value).length;
+        const color = `speaker-color-${(colorIndex % SPEAKER_COLOR_COUNT) + 1}`;
+        speakerColorMap.value[speakerId] = color;
+        return color;
+    };
+
+    // Helper to pause outer audio player when opening modals with their own player
+    const pauseOuterAudioPlayer = () => {
+        // Find the audio player in the right panel (not in a modal)
+        const outerAudio = document.querySelector('#rightMainColumn audio') || document.querySelector('#rightMainColumn video') ||
+                          document.querySelector('.detail-view audio:not(.fixed audio)') || document.querySelector('.detail-view video:not(.fixed video)');
+        if (outerAudio && !outerAudio.paused) {
+            outerAudio.pause();
+        }
+    };
+
+    // =========================================
+    // Speaker Identification Modal
+    // =========================================
+
+    const openSpeakerModal = () => {
+        if (!selectedRecording.value) return;
+
+        // Pause outer audio player to avoid conflicts with modal's player
+        pauseOuterAudioPlayer();
+
+        // Clear any existing speaker map data first
+        speakerMap.value = {};
+        speakerDisplayMap.value = {};
+
+        // Get the same speaker order used in processedTranscription
+        const transcription = selectedRecording.value?.transcription;
+        let speakers = [];
+
+        if (transcription) {
+            try {
+                const transcriptionData = JSON.parse(transcription);
+                if (transcriptionData && Array.isArray(transcriptionData)) {
+                    // Use the exact same logic as processedTranscription to get speakers
+                    speakers = [...new Set(transcriptionData.map(segment => segment.speaker).filter(Boolean))];
+                }
+            } catch (e) {
+                // Fall back to getIdentifiedSpeakers if JSON parsing fails
+                speakers = getIdentifiedSpeakers();
+            }
+        }
+
+        // Initialize speaker map FIRST with colors from shared color map
+        // Clear existing map and rebuild it
+        speakerMap.value = {};
+        speakerDisplayMap.value = {};
+        speakers.forEach(speaker => {
+            speakerMap.value[speaker] = {
+                name: '',
+                isMe: false,
+                color: getSpeakerColor(speaker)
+            };
+            speakerDisplayMap.value[speaker] = speaker;
+        });
+
+        // Set modalSpeakers AFTER speakerMap is populated (triggers render)
+        modalSpeakers.value = speakers;
+
+        highlightedSpeaker.value = null;
+        speakerSuggestions.value = {};
+        loadingSuggestions.value = {};
+        activeSpeakerInput.value = null;
+        isAutoIdentifying.value = false;
+        regenerateSummaryAfterSpeakerUpdate.value = true;
+        voiceSuggestions.value = {};
+        speakerModalTab.value = 'speakers';  // Reset to speakers tab on mobile
+
+        showSpeakerModal.value = true;
+
+        // Reset virtual scroll state for fresh modal render
+        if (utils.resetSpeakerModalScroll) {
+            utils.resetSpeakerModalScroll();
+        }
+
+        // Load voice-based suggestions if embeddings are available
+        loadVoiceSuggestions();
+    };
+
+    const getIdentifiedSpeakers = () => {
+        // Ensure we have a valid recording and transcription
+        if (!selectedRecording.value?.transcription) {
+            return [];
+        }
+
+        const transcription = selectedRecording.value.transcription;
+        let transcriptionData;
+
+        try {
+            transcriptionData = JSON.parse(transcription);
+        } catch (e) {
+            transcriptionData = null;
+        }
+
+        // Handle new simplified JSON format (array of segments)
+        if (transcriptionData && Array.isArray(transcriptionData)) {
+            // JSON format - extract speakers in order of appearance
+            const speakersInOrder = [];
+            const seenSpeakers = new Set();
+            transcriptionData.forEach(segment => {
+                if (segment.speaker && !seenSpeakers.has(segment.speaker)) {
+                    seenSpeakers.add(segment.speaker);
+                    speakersInOrder.push(segment.speaker);
+                }
+            });
+            return speakersInOrder;
+        } else if (typeof transcription === 'string') {
+            // Plain text format - find speakers in order of appearance
+            const speakerRegex = /\[([^\]]+)\]:/g;
+            const speakersInOrder = [];
+            const seenSpeakers = new Set();
+            let match;
+            while ((match = speakerRegex.exec(transcription)) !== null) {
+                const speaker = match[1].trim();
+                if (speaker && !seenSpeakers.has(speaker)) {
+                    seenSpeakers.add(speaker);
+                    speakersInOrder.push(speaker);
+                }
+            }
+            return speakersInOrder;
+        }
+        return [];
+    };
+
+    const closeSpeakerModal = () => {
+        // Pause any playing modal audio before closing
+        const modalAudio = document.querySelector('.fixed.z-50 audio') || document.querySelector('.fixed.z-50 video');
+        if (modalAudio) {
+            modalAudio.pause();
+        }
+        // Reset modal audio state (keep main player independent)
+        if (utils.resetModalAudioState) {
+            utils.resetModalAudioState();
+        }
+
+        showSpeakerModal.value = false;
+        showAutoIdDropdown.value = false;
+        highlightedSpeaker.value = null;
+        // Clear the speaker map to prevent stale data from persisting
+        speakerMap.value = {};
+        speakerSuggestions.value = {};
+        loadingSuggestions.value = {};
+        clearSpeakerHighlight();
+    };
+
+    const saveTranscriptImmediately = async (transcriptData) => {
+        if (!selectedRecording.value) return;
+
+        try {
+            // Save transcript without closing modal
+            const filteredSpeakerMap = Object.entries(speakerMap.value).reduce((acc, [speakerId, speakerData]) => {
+                if (speakerData.name && speakerData.name.trim() !== '') {
+                    acc[speakerId] = speakerData;
+                }
+                return acc;
+            }, {});
+
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/update_transcript`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    transcript_data: transcriptData,
+                    speaker_map: filteredSpeakerMap,
+                    regenerate_summary: false // Don't regenerate on immediate saves
+                })
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update transcript');
+
+            // Update recordings list and selected recording without closing modal
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1) {
+                recordings.value[index] = data.recording;
+            }
+            selectedRecording.value = data.recording;
+            editedTranscriptData.value = null;
+
+            showToast(t('help.saved'), 'fa-check-circle', 2000, 'success');
+        } catch (error) {
+            console.error('Save Transcript Error:', error);
+            showToast(`Error: ${error.message}`, 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    const saveTranscriptEdits = async () => {
+        if (!selectedRecording.value || !editedTranscriptData.value) {
+            return saveSpeakerNames(); // Fall back to regular speaker name save
+        }
+
+        try {
+            // Save both speaker names and transcript edits
+            const filteredSpeakerMap = Object.entries(speakerMap.value).reduce((acc, [speakerId, speakerData]) => {
+                if (speakerData.name && speakerData.name.trim() !== '') {
+                    acc[speakerId] = speakerData;
+                }
+                return acc;
+            }, {});
+
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/update_transcript`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    transcript_data: editedTranscriptData.value,
+                    speaker_map: filteredSpeakerMap,
+                    regenerate_summary: regenerateSummaryAfterSpeakerUpdate.value
+                })
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update transcript');
+
+            closeSpeakerModal();
+
+            // If summary regeneration was requested, update status immediately
+            if (regenerateSummaryAfterSpeakerUpdate.value && data.summary_queued) {
+                // Update recording status to SUMMARIZING immediately for UI feedback
+                const summarizingRecording = { ...data.recording, status: 'SUMMARIZING' };
+
+                const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+                if (index !== -1) {
+                    recordings.value[index] = summarizingRecording;
+                }
+                selectedRecording.value = summarizingRecording;
+                editedTranscriptData.value = null;
+
+                showToast(t('help.transcriptUpdated'), 'fa-check-circle');
+                showToast(t('help.summaryRegenerationStarted'), 'fa-sync-alt');
+
+                // Poll for summary completion
+                pollForSummaryCompletion(selectedRecording.value.id);
+            } else {
+                const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+                if (index !== -1) {
+                    recordings.value[index] = data.recording;
+                }
+                selectedRecording.value = data.recording;
+                editedTranscriptData.value = null;
+
+                showToast(t('help.transcriptUpdated'), 'fa-check-circle');
+            }
+        } catch (error) {
+            console.error('Save Transcript Error:', error);
+            showToast(`Error: ${error.message}`, 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    const saveSpeakerNames = async () => {
+        if (!selectedRecording.value) return;
+
+        // If there are transcript edits, save those instead
+        if (editedTranscriptData.value) {
+            return saveTranscriptEdits();
+        }
+
+        // Create a filtered speaker map that excludes entries with blank names
+        const filteredSpeakerMap = Object.entries(speakerMap.value).reduce((acc, [speakerId, speakerData]) => {
+            if (speakerData.name && speakerData.name.trim() !== '') {
+                acc[speakerId] = speakerData;
+            }
+            return acc;
+        }, {});
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/update_speakers`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    speaker_map: filteredSpeakerMap,
+                    regenerate_summary: regenerateSummaryAfterSpeakerUpdate.value
+                })
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update speaker names');
+
+            closeSpeakerModal();
+
+            // If summary regeneration was requested, update status immediately
+            if (regenerateSummaryAfterSpeakerUpdate.value && data.summary_queued) {
+                // Update recording status to SUMMARIZING immediately for UI feedback
+                const summarizingRecording = { ...data.recording, status: 'SUMMARIZING' };
+
+                const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+                if (index !== -1) {
+                    recordings.value[index] = summarizingRecording;
+                }
+                selectedRecording.value = summarizingRecording;
+
+                showToast(t('help.speakerNamesUpdated'), 'fa-check-circle');
+                showToast(t('help.summaryRegenerationStarted'), 'fa-sync-alt');
+
+                // Poll for summary completion
+                pollForSummaryCompletion(selectedRecording.value.id);
+            } else {
+                // The backend returns the fully updated recording object
+                const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+                if (index !== -1) {
+                    recordings.value[index] = data.recording;
+                }
+                selectedRecording.value = data.recording;
+
+                showToast(t('help.speakerNamesUpdated'), 'fa-check-circle');
+            }
+        } catch (error) {
+            setGlobalError(`Failed to save speaker names: ${error.message}`);
+        }
+    };
+
+    // Poll for summary completion after regeneration
+    const pollForSummaryCompletion = async (recordingId) => {
+        const maxAttempts = 40; // Poll for up to 2 minutes (40 * 3 seconds)
+        let attempts = 0;
+
+        const pollInterval = setInterval(async () => {
+            attempts++;
+
+            try {
+                // Use lightweight status-only endpoint for polling
+                const response = await fetch(`/recording/${recordingId}/status`);
+                if (!response.ok) {
+                    clearInterval(pollInterval);
+                    return;
+                }
+
+                const statusData = await response.json();
+
+                // Update status in recordings list
+                const index = recordings.value.findIndex(r => r.id === recordingId);
+                if (index !== -1) {
+                    // Create new object to ensure Vue reactivity
+                    recordings.value[index] = {
+                        ...recordings.value[index],
+                        status: statusData.status
+                    };
+                }
+
+                // Update selectedRecording with new object reference for reactivity
+                if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                    selectedRecording.value = {
+                        ...selectedRecording.value,
+                        status: statusData.status
+                    };
+                }
+
+                // Check if summarization is complete
+                if (statusData.status === 'COMPLETED') {
+                    clearInterval(pollInterval);
+
+                    // Now fetch the full recording with the new summary
+                    const fullResponse = await fetch(`/api/recordings/${recordingId}`);
+                    if (fullResponse.ok) {
+                        const fullData = await fullResponse.json();
+
+                        // Update in recordings list first
+                        const currentIndex = recordings.value.findIndex(r => r.id === recordingId);
+                        if (currentIndex !== -1) {
+                            recordings.value[currentIndex] = fullData;
+                        }
+
+                        // Always update selectedRecording if it's the current recording
+                        if (selectedRecording.value && selectedRecording.value.id === recordingId) {
+                            selectedRecording.value = fullData;
+                            // Force Vue to detect the change
+                            await nextTick();
+                        }
+                    }
+
+                    showToast(t('help.summaryUpdated'), 'fa-check-circle');
+                    // Refresh token budget after LLM operation
+                    if (onChatComplete) onChatComplete();
+                } else if (statusData.status === 'FAILED' || statusData.status === 'ERROR') {
+                    // Stop polling if it failed
+                    clearInterval(pollInterval);
+                    showToast(t('help.summaryGenerationFailed'), 'fa-exclamation-circle', 3000, 'error');
+                } else if (attempts >= maxAttempts) {
+                    // Stop polling after max attempts
+                    clearInterval(pollInterval);
+                    showToast(t('help.summaryGenerationTimedOut'), 'fa-clock', 3000, 'warning');
+                }
+            } catch (error) {
+                console.error('Error polling for summary:', error);
+                clearInterval(pollInterval);
+            }
+        }, 3000); // Poll every 3 seconds
+    };
+
+    // =========================================
+    // Speaker Suggestions
+    // =========================================
+
+    const loadVoiceSuggestions = async () => {
+        if (!selectedRecording.value?.id) return;
+
+        loadingVoiceSuggestions.value = true;
+        voiceSuggestions.value = {};
+
+        try {
+            const response = await fetch(`/speakers/suggestions/${selectedRecording.value.id}`);
+            if (!response.ok) throw new Error('Failed to load voice suggestions');
+
+            const data = await response.json();
+
+            if (data.success && data.suggestions) {
+                // Only keep suggestions that have matches
+                voiceSuggestions.value = Object.fromEntries(
+                    Object.entries(data.suggestions).filter(([_, matches]) => matches && matches.length > 0)
+                );
+            }
+        } catch (error) {
+            console.error('Error loading voice suggestions:', error);
+            voiceSuggestions.value = {};
+        } finally {
+            loadingVoiceSuggestions.value = false;
+        }
+    };
+
+    const applyVoiceSuggestion = (speakerId, suggestion) => {
+        if (speakerMap.value[speakerId]) {
+            speakerMap.value[speakerId].name = suggestion.name;
+            // Don't delete the suggestion - let it reappear if user clears the field
+        }
+    };
+
+    // Handle "This is Me" checkbox changes
+    const handleIsMeChange = (speakerId) => {
+        if (!speakerMap.value[speakerId]) return;
+
+        if (speakerMap.value[speakerId].isMe) {
+            // Checkbox is now checked - set the name to current user's name
+            speakerMap.value[speakerId].name = currentUserName.value || 'Me';
+        } else {
+            // Checkbox is now unchecked - clear the name
+            speakerMap.value[speakerId].name = '';
+        }
+    };
+
+    // Determine if voice suggestion pill should be shown inside the input field
+    const shouldShowVoiceSuggestionPill = (speakerId) => {
+        // Don't show if no suggestions available
+        if (!voiceSuggestions.value[speakerId] || voiceSuggestions.value[speakerId].length === 0) {
+            return false;
+        }
+
+        // Don't show if "This is Me" is checked
+        if (speakerMap.value[speakerId]?.isMe) {
+            return false;
+        }
+
+        // Only show when the input field is empty
+        const typedName = speakerMap.value[speakerId]?.name?.trim();
+        if (typedName && typedName.length > 0) {
+            return false;
+        }
+
+        return true;
+    };
+
+    const searchSpeakers = async (query, speakerId) => {
+        if (!query || query.length < 2) {
+            speakerSuggestions.value[speakerId] = [];
+            return;
+        }
+
+        loadingSuggestions.value[speakerId] = true;
+
+        try {
+            const response = await fetch(`/speakers/search?q=${encodeURIComponent(query)}`);
+            if (!response.ok) throw new Error('Failed to search speakers');
+
+            const speakers = await response.json();
+            speakerSuggestions.value[speakerId] = speakers;
+        } catch (error) {
+            console.error('Error searching speakers:', error);
+            speakerSuggestions.value[speakerId] = [];
+        } finally {
+            loadingSuggestions.value[speakerId] = false;
+        }
+    };
+
+    const selectSpeakerSuggestion = (speakerId, suggestion) => {
+        if (speakerMap.value[speakerId]) {
+            speakerMap.value[speakerId].name = suggestion.name;
+            speakerSuggestions.value[speakerId] = [];
+            activeSpeakerInput.value = null;
+        }
+    };
+
+    const closeSpeakerSuggestionsOnClick = (event) => {
+        // Check if the click was on an input field or dropdown
+        const clickedInput = event.target.closest('input[type="text"]');
+        const clickedDropdown = event.target.closest('.absolute.z-10');
+
+        // If not clicking on input or dropdown, close all suggestions
+        if (!clickedInput && !clickedDropdown) {
+            Object.keys(speakerSuggestions.value).forEach(speakerId => {
+                speakerSuggestions.value[speakerId] = [];
+            });
+        }
+    };
+
+    // =========================================
+    // Speaker Navigation (Index-Based for Virtual Scroll)
+    // =========================================
+
+    /**
+     * Find speaker groups by analyzing segment data (not DOM).
+     * Returns groups with startIndex instead of startElement for virtual scroll compatibility.
+     */
+    const findSpeakerGroups = (speakerId) => {
+        if (!speakerId) return [];
+
+        // Get segments from processedTranscription
+        const segments = processedTranscription.value?.simpleSegments || [];
+        if (segments.length === 0) return [];
+
+        const groups = [];
+        let currentGroup = null;
+        let lastSpeakerId = null;
+
+        segments.forEach((segment, index) => {
+            const segmentSpeakerId = segment.speakerId;
+
+            if (segmentSpeakerId === speakerId) {
+                // If this is a new group (not consecutive with previous)
+                if (lastSpeakerId !== speakerId) {
+                    currentGroup = {
+                        startIndex: index,
+                        indices: [index]
+                    };
+                    groups.push(currentGroup);
+                } else if (currentGroup) {
+                    // Add to existing group
+                    currentGroup.indices.push(index);
+                }
+            }
+            lastSpeakerId = segmentSpeakerId;
+        });
+
+        return groups;
+    };
+
+    const highlightSpeakerInTranscript = (speakerId) => {
+        highlightedSpeaker.value = speakerId;
+
+        if (speakerId) {
+            // Find all speaker groups for navigation (index-based, no DOM queries)
+            speakerGroups.value = findSpeakerGroups(speakerId);
+
+            if (speakerGroups.value.length > 0) {
+                // Get the current visible range from the virtual scroll
+                const visibleRange = utils.getSpeakerModalVisibleRange ? utils.getSpeakerModalVisibleRange() : null;
+
+                if (visibleRange) {
+                    const { start: visibleStart, end: visibleEnd } = visibleRange;
+                    const visibleCenter = Math.floor((visibleStart + visibleEnd) / 2);
+
+                    // Check if any group is already visible
+                    const visibleGroupIndex = speakerGroups.value.findIndex(group =>
+                        group.startIndex >= visibleStart && group.startIndex < visibleEnd
+                    );
+
+                    if (visibleGroupIndex !== -1) {
+                        // A group is already visible, just set it as current (no scroll needed)
+                        currentSpeakerGroupIndex.value = visibleGroupIndex;
+                    } else {
+                        // No group visible - find the nearest group to the visible center
+                        let nearestIndex = 0;
+                        let nearestDistance = Infinity;
+
+                        speakerGroups.value.forEach((group, index) => {
+                            const distance = Math.abs(group.startIndex - visibleCenter);
+                            if (distance < nearestDistance) {
+                                nearestDistance = distance;
+                                nearestIndex = index;
+                            }
+                        });
+
+                        currentSpeakerGroupIndex.value = nearestIndex;
+
+                        // Scroll to the nearest group
+                        const nearestGroup = speakerGroups.value[nearestIndex];
+                        if (nearestGroup && typeof nearestGroup.startIndex === 'number' && utils.scrollToSegmentIndex) {
+                            utils.scrollToSegmentIndex(nearestGroup.startIndex);
+                        }
+                    }
+                } else {
+                    // Fallback: no visible range available, scroll to first group
+                    currentSpeakerGroupIndex.value = 0;
+                    const firstGroup = speakerGroups.value[0];
+                    if (firstGroup && typeof firstGroup.startIndex === 'number' && utils.scrollToSegmentIndex) {
+                        utils.scrollToSegmentIndex(firstGroup.startIndex);
+                    }
+                }
+            } else {
+                currentSpeakerGroupIndex.value = -1;
+            }
+        } else {
+            speakerGroups.value = [];
+            currentSpeakerGroupIndex.value = -1;
+        }
+    };
+
+    /**
+     * Select a speaker for navigation from the dropdown.
+     * Uses index-based navigation compatible with virtual scrolling.
+     */
+    const selectSpeakerForNavigation = (speakerId) => {
+        if (!speakerId) {
+            highlightedSpeaker.value = null;
+            speakerGroups.value = [];
+            currentSpeakerGroupIndex.value = -1;
+            return;
+        }
+
+        highlightedSpeaker.value = speakerId;
+
+        // Find groups immediately (no DOM dependency)
+        speakerGroups.value = findSpeakerGroups(speakerId);
+        currentSpeakerGroupIndex.value = 0;
+
+        // Scroll to first occurrence
+        if (speakerGroups.value.length > 0) {
+            const firstGroup = speakerGroups.value[0];
+            if (firstGroup && typeof firstGroup.startIndex === 'number') {
+                if (utils.scrollToSegmentIndex) {
+                    utils.scrollToSegmentIndex(firstGroup.startIndex);
+                }
+            }
+        }
+    };
+
+    const navigateToNextSpeakerGroup = () => {
+        if (speakerGroups.value.length === 0) return;
+
+        // Update the index
+        currentSpeakerGroupIndex.value = (currentSpeakerGroupIndex.value + 1) % speakerGroups.value.length;
+        const group = speakerGroups.value[currentSpeakerGroupIndex.value];
+        if (group && typeof group.startIndex === 'number') {
+            if (utils.scrollToSegmentIndex) {
+                utils.scrollToSegmentIndex(group.startIndex);
+            }
+        }
+    };
+
+    const navigateToPrevSpeakerGroup = () => {
+        if (speakerGroups.value.length === 0) return;
+
+        // Update the index
+        currentSpeakerGroupIndex.value = currentSpeakerGroupIndex.value <= 0
+            ? speakerGroups.value.length - 1
+            : currentSpeakerGroupIndex.value - 1;
+        const group = speakerGroups.value[currentSpeakerGroupIndex.value];
+        if (group && typeof group.startIndex === 'number') {
+            if (utils.scrollToSegmentIndex) {
+                utils.scrollToSegmentIndex(group.startIndex);
+            }
+        }
+    };
+
+    const focusSpeaker = (speakerId) => {
+        // Set this as the active speaker input
+        activeSpeakerInput.value = speakerId;
+        // Only highlight if not already highlighted (to preserve navigation state)
+        if (highlightedSpeaker.value !== speakerId) {
+            highlightSpeakerInTranscript(speakerId);
+        }
+    };
+
+    const blurSpeaker = () => {
+        // Clear the active speaker input after a delay to allow clicking on suggestions
+        setTimeout(() => {
+            activeSpeakerInput.value = null;
+            speakerSuggestions.value = {};
+        }, 200);
+        clearSpeakerHighlight();
+    };
+
+    const clearSpeakerHighlight = () => {
+        highlightedSpeaker.value = null;
+    };
+
+    // =========================================
+    // Auto-Identify Speakers
+    // =========================================
+
+    // Split button dropdown visibility + click-outside handling
+    const showAutoIdDropdown = Vue.ref(false);
+    const autoIdSplitBtn = Vue.ref(null);
+
+    const onAutoIdClickOutside = (e) => {
+        if (autoIdSplitBtn.value && !autoIdSplitBtn.value.contains(e.target)) {
+            showAutoIdDropdown.value = false;
+        }
+    };
+    Vue.watch(showAutoIdDropdown, (open) => {
+        if (open) {
+            document.addEventListener('click', onAutoIdClickOutside, true);
+        } else {
+            document.removeEventListener('click', onAutoIdClickOutside, true);
+        }
+    });
+
+    /**
+     * Auto-identify speakers via LLM.
+     * @param {boolean} identifyAll - When false (default), only fill speakers with empty names.
+     *                                When true, overwrite all speaker names.
+     */
+    const autoIdentifySpeakers = async (identifyAll = false) => {
+        showAutoIdDropdown.value = false;
+
+        if (!selectedRecording.value) {
+            showToast(t('help.noRecordingSelected'), 'fa-exclamation-circle');
+            return;
+        }
+
+        isAutoIdentifying.value = true;
+        showToast(t('help.startingAutoIdentification'), 'fa-magic');
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/auto_identify_speakers`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    current_speaker_map: speakerMap.value
+                })
+            });
+
+            const data = await response.json();
+            if (!response.ok) {
+                throw new Error(data.error || 'Unknown error occurred during auto-identification.');
+            }
+
+            // Check if there's a message (e.g., all speakers already identified)
+            if (data.message) {
+                showToast(data.message, 'fa-info-circle');
+                return;
+            }
+
+            // Update speakerMap with the identified names
+            let identifiedCount = 0;
+            for (const speakerId in data.speaker_map) {
+                const identifiedName = data.speaker_map[speakerId];
+                if (speakerMap.value[speakerId] && identifiedName && identifiedName.trim() !== '') {
+                    // Skip speakers that already have a name unless identifyAll is true
+                    if (!identifyAll && speakerMap.value[speakerId].name && speakerMap.value[speakerId].name.trim() !== '') {
+                        continue;
+                    }
+                    speakerMap.value[speakerId].name = identifiedName;
+                    identifiedCount++;
+                }
+            }
+
+            if (identifiedCount > 0) {
+                showToast(tc('help.speakersIdentified', identifiedCount, { count: identifiedCount }), 'fa-check-circle');
+            } else {
+                showToast(t('help.noSpeakersIdentified'), 'fa-info-circle');
+            }
+
+            // Refresh token budget after LLM operation
+            if (onChatComplete) onChatComplete();
+
+        } catch (error) {
+            console.error('Auto Identify Speakers Error:', error);
+            showToast(`Error: ${error.message}`, 'fa-exclamation-circle', 5000, 'error');
+        } finally {
+            isAutoIdentifying.value = false;
+        }
+    };
+
+    // =========================================
+    // Apply Suggested Names
+    // =========================================
+
+    /** True when any unnamed, non-isMe speaker has voice or autocomplete suggestions */
+    const hasAnySuggestions = Vue.computed(() => {
+        for (const speakerId of modalSpeakers.value) {
+            const data = speakerMap.value[speakerId];
+            if (!data || data.isMe) continue;
+            if (data.name && data.name.trim() !== '') continue;
+            // Check voice suggestions
+            if (voiceSuggestions.value[speakerId] && voiceSuggestions.value[speakerId].length > 0) {
+                return true;
+            }
+            // Check autocomplete suggestions
+            if (speakerSuggestions.value[speakerId] && speakerSuggestions.value[speakerId].length > 0) {
+                return true;
+            }
+        }
+        return false;
+    });
+
+    /** Bulk-apply voice suggestions (priority) then autocomplete suggestions to empty names only */
+    const applySuggestedNames = () => {
+        let appliedCount = 0;
+        for (const speakerId of modalSpeakers.value) {
+            const data = speakerMap.value[speakerId];
+            if (!data || data.isMe) continue;
+            if (data.name && data.name.trim() !== '') continue;
+
+            // Priority 1: voice suggestions
+            const voice = voiceSuggestions.value[speakerId];
+            if (voice && voice.length > 0) {
+                data.name = voice[0].name;
+                appliedCount++;
+                continue;
+            }
+
+            // Priority 2: autocomplete suggestions
+            const auto = speakerSuggestions.value[speakerId];
+            if (auto && auto.length > 0) {
+                data.name = auto[0].name;
+                appliedCount++;
+            }
+        }
+
+        if (appliedCount > 0) {
+            showToast(tc('help.appliedSuggestedNames', appliedCount, { count: appliedCount }), 'fa-check-circle');
+        } else {
+            showToast(t('help.noSuggestionsToApply'), 'fa-info-circle');
+        }
+    };
+
+    // =========================================
+    // Add Speaker Modal
+    // =========================================
+
+    const searchNewSpeaker = async () => {
+        const query = newSpeakerName.value;
+        if (!query || query.length < 2) {
+            newSpeakerSuggestions.value = [];
+            return;
+        }
+
+        loadingNewSpeakerSuggestions.value = true;
+        try {
+            const response = await fetch(`/speakers/search?q=${encodeURIComponent(query)}`);
+            if (!response.ok) throw new Error('Failed to search speakers');
+
+            const speakers = await response.json();
+            newSpeakerSuggestions.value = speakers;
+        } catch (error) {
+            console.error('Error searching speakers:', error);
+            newSpeakerSuggestions.value = [];
+        } finally {
+            loadingNewSpeakerSuggestions.value = false;
+        }
+    };
+
+    const selectNewSpeakerSuggestion = (suggestion) => {
+        newSpeakerName.value = suggestion.name;
+        newSpeakerSuggestions.value = [];
+        showNewSpeakerSuggestions.value = false;
+    };
+
+    const hideNewSpeakerSuggestionsDelayed = () => {
+        setTimeout(() => {
+            showNewSpeakerSuggestions.value = false;
+            newSpeakerSuggestions.value = [];
+        }, 200);
+    };
+
+    const openAddSpeakerModal = () => {
+        newSpeakerName.value = '';
+        newSpeakerIsMe.value = false;
+        newSpeakerSuggestions.value = [];
+        loadingNewSpeakerSuggestions.value = false;
+        showNewSpeakerSuggestions.value = false;
+        showAddSpeakerModal.value = true;
+    };
+
+    const closeAddSpeakerModal = () => {
+        showAddSpeakerModal.value = false;
+        newSpeakerName.value = '';
+        newSpeakerIsMe.value = false;
+        newSpeakerSuggestions.value = [];
+        loadingNewSpeakerSuggestions.value = false;
+        showNewSpeakerSuggestions.value = false;
+    };
+
+    const addNewSpeaker = () => {
+        const name = newSpeakerIsMe.value ? (currentUserName.value || 'Me') : newSpeakerName.value.trim();
+
+        if (!newSpeakerIsMe.value && !name) {
+            showToast(t('help.pleaseEnterSpeakerName'), 'fa-exclamation-circle');
+            return;
+        }
+
+        // Generate new speaker ID
+        const existingSpeakerNumbers = modalSpeakers.value
+            .map(s => {
+                const match = s.match(/^SPEAKER_(\d+)$/);
+                return match ? parseInt(match[1]) : -1;
+            })
+            .filter(n => n >= 0);
+
+        const nextNumber = existingSpeakerNumbers.length > 0
+            ? Math.max(...existingSpeakerNumbers) + 1
+            : modalSpeakers.value.length;
+
+        const newSpeakerId = `SPEAKER_${String(nextNumber).padStart(2, '0')}`;
+
+        // Add to speakerMap FIRST (before modalSpeakers) to avoid render race condition
+        speakerMap.value[newSpeakerId] = {
+            name: name,
+            isMe: newSpeakerIsMe.value,
+            color: getSpeakerColor(newSpeakerId)
+        };
+
+        // Add to speakerDisplayMap
+        speakerDisplayMap.value[newSpeakerId] = newSpeakerId;
+
+        // Add to modalSpeakers LAST (triggers re-render, but speakerMap is already populated)
+        modalSpeakers.value.push(newSpeakerId);
+
+        closeAddSpeakerModal();
+        showToast(t('help.speakerAdded'), 'fa-check-circle');
+    };
+
+    // =========================================
+    // Edit Speakers Modal
+    // =========================================
+
+    const openEditSpeakersModal = async () => {
+        // Close any open suggestions
+        editingSegments.value.forEach(seg => seg.showSuggestions = false);
+        // Copy current speakers to editing list with original and current properties
+        editingSpeakersList.value = availableSpeakers.value.map(s => ({
+            original: s,
+            current: s
+        }));
+        // Fetch speakers from database for autocomplete
+        try {
+            const response = await fetch('/speakers');
+            const speakers = await response.json();
+            // Keep full objects with id and name for autocomplete dropdown
+            databaseSpeakers.value = speakers;
+        } catch (e) {
+            console.error('Failed to fetch speakers:', e);
+            databaseSpeakers.value = [];
+        }
+        editingSpeakerSuggestions.value = {};
+        showEditSpeakersModal.value = true;
+    };
+
+    const closeEditSpeakersModal = () => {
+        showEditSpeakersModal.value = false;
+        editingSpeakersList.value = [];
+    };
+
+    const addEditingSpeaker = () => {
+        editingSpeakersList.value.push({ original: '', current: '' });
+    };
+
+    const removeEditingSpeaker = (index) => {
+        editingSpeakersList.value.splice(index, 1);
+    };
+
+    const filterEditingSpeakerSuggestions = (index) => {
+        const query = editingSpeakersList.value[index]?.current?.toLowerCase().trim() || '';
+        if (query === '') {
+            // Show all speakers when field is empty/focused
+            editingSpeakerSuggestions.value[index] = [...databaseSpeakers.value];
+        } else {
+            editingSpeakerSuggestions.value[index] = databaseSpeakers.value.filter(
+                s => s.name.toLowerCase().includes(query)
+            );
+        }
+    };
+
+    const selectEditingSpeakerSuggestion = (index, name) => {
+        editingSpeakersList.value[index].current = name;
+        editingSpeakerSuggestions.value[index] = [];
+    };
+
+    const closeEditingSpeakerSuggestions = (index) => {
+        editingSpeakerSuggestions.value[index] = [];
+    };
+
+    const onEditSpeakerBlur = (index) => {
+        // Delay closing to allow clicking on suggestions
+        setTimeout(() => {
+            closeEditingSpeakerSuggestions(index);
+        }, 200);
+    };
+
+    const getEditSpeakerDropdownPosition = (index) => {
+        // Find the input element for this index and calculate position
+        const inputs = document.querySelectorAll('[class*="edit-speakers-modal"] input[placeholder="New name..."], .max-w-md input[placeholder="New name..."]');
+        if (inputs[index]) {
+            const rect = inputs[index].getBoundingClientRect();
+            return {
+                top: rect.bottom + 2 + 'px',
+                left: rect.left + 'px',
+                width: rect.width + 'px'
+            };
+        }
+        return { top: '0px', left: '0px', width: '200px' };
+    };
+
+    const saveEditingSpeakers = async () => {
+        const map = {};
+        editingSpeakersList.value.forEach(item => {
+            if (item.original && item.current) {
+                map[item.original] = item.current;
+            }
+        });
+
+        // Update ASR editor state if it's open
+        if (editingSegments.value.length > 0) {
+            // Build new list of available speakers
+            const newSpeakers = new Set();
+
+            // Apply renames to all segments
+            editingSegments.value.forEach(segment => {
+                if (map[segment.speaker]) {
+                    segment.speaker = map[segment.speaker];
+                }
+                newSpeakers.add(segment.speaker);
+            });
+
+            // Add any newly added speakers from the modal
+            editingSpeakersList.value.forEach(item => {
+                if (!item.original && item.current) {
+                    // This is a new speaker (no original)
+                    newSpeakers.add(item.current);
+                }
+            });
+
+            // Update available speakers list
+            availableSpeakers.value = [...newSpeakers].sort();
+
+            // Update filtered speakers for all segments
+            editingSegments.value.forEach(segment => {
+                segment.filteredSpeakers = [...availableSpeakers.value];
+            });
+
+            closeEditSpeakersModal();
+            showToast(t('help.speakersUpdatedSaveToApply'), 'fa-check-circle');
+        } else {
+            // Regular flow for non-ASR editor context
+            speakerMap.value = map;
+            closeEditSpeakersModal();
+            await saveSpeakerNames();
+        }
+    };
+
+    // =========================================
+    // Edit Text Modal
+    // =========================================
+
+    const openEditTextModal = (segmentIndex) => {
+        if (!selectedRecording.value?.transcription) return;
+
+        try {
+            const transcriptionData = JSON.parse(selectedRecording.value.transcription);
+            if (transcriptionData && Array.isArray(transcriptionData) && transcriptionData[segmentIndex]) {
+                editingSegmentIndex.value = segmentIndex;
+                editedText.value = transcriptionData[segmentIndex].sentence || '';
+                showEditTextModal.value = true;
+            }
+        } catch (e) {
+            console.error('Error opening text editor:', e);
+            showToast(t('help.errorOpeningTextEditor'), 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    const closeEditTextModal = () => {
+        showEditTextModal.value = false;
+        editingSegmentIndex.value = null;
+        editedText.value = '';
+    };
+
+    const saveEditedText = async () => {
+        if (editingSegmentIndex.value === null || !selectedRecording.value?.transcription) return;
+
+        try {
+            const transcriptionData = JSON.parse(selectedRecording.value.transcription);
+            if (transcriptionData && Array.isArray(transcriptionData) && transcriptionData[editingSegmentIndex.value]) {
+                transcriptionData[editingSegmentIndex.value].sentence = editedText.value;
+                editedTranscriptData.value = transcriptionData;
+
+                // Update the recording's transcription temporarily for UI update
+                selectedRecording.value.transcription = JSON.stringify(transcriptionData);
+
+                closeEditTextModal();
+
+                // Immediately persist the change
+                showToast(t('help.savingProgress'), 'fa-spinner fa-spin');
+                await saveTranscriptImmediately(transcriptionData);
+            }
+        } catch (e) {
+            console.error('Error saving text:', e);
+            showToast(t('help.errorSavingText'), 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    // =========================================
+    // Change Speaker in Segment
+    // =========================================
+
+    const openSpeakerChangeDropdown = (segmentIndex) => {
+        editingSpeakerIndex.value = editingSpeakerIndex.value === segmentIndex ? null : segmentIndex;
+    };
+
+    const changeSpeaker = async (segmentIndex, newSpeakerId) => {
+        if (!selectedRecording.value?.transcription) return;
+
+        try {
+            const transcriptionData = JSON.parse(selectedRecording.value.transcription);
+            if (transcriptionData && Array.isArray(transcriptionData) && transcriptionData[segmentIndex]) {
+                transcriptionData[segmentIndex].speaker = newSpeakerId;
+                editedTranscriptData.value = transcriptionData;
+
+                // Update the recording's transcription temporarily for UI update
+                selectedRecording.value.transcription = JSON.stringify(transcriptionData);
+
+                editingSpeakerIndex.value = null;
+
+                // Immediately persist the change
+                showToast(t('help.savingProgress'), 'fa-spinner fa-spin');
+                await saveTranscriptImmediately(transcriptionData);
+            }
+        } catch (e) {
+            console.error('Error changing speaker:', e);
+            showToast(t('help.errorChangingSpeaker'), 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    return {
+        // Speaker modal
+        openSpeakerModal,
+        closeSpeakerModal,
+        saveSpeakerNames,
+
+        // Suggestions
+        loadVoiceSuggestions,
+        applyVoiceSuggestion,
+        handleIsMeChange,
+        shouldShowVoiceSuggestionPill,
+        searchSpeakers,
+        selectSpeakerSuggestion,
+        closeSpeakerSuggestionsOnClick,
+
+        // Navigation
+        findSpeakerGroups,
+        highlightSpeakerInTranscript,
+        selectSpeakerForNavigation,
+        navigateToNextSpeakerGroup,
+        navigateToPrevSpeakerGroup,
+        focusSpeaker,
+        blurSpeaker,
+        clearSpeakerHighlight,
+
+        // Auto-identify
+        autoIdentifySpeakers,
+        showAutoIdDropdown,
+        autoIdSplitBtn,
+        hasAnySuggestions,
+        applySuggestedNames,
+
+        // Add speaker
+        openAddSpeakerModal,
+        closeAddSpeakerModal,
+        addNewSpeaker,
+        searchNewSpeaker,
+        selectNewSpeakerSuggestion,
+        hideNewSpeakerSuggestionsDelayed,
+
+        // Edit speakers modal
+        openEditSpeakersModal,
+        closeEditSpeakersModal,
+        addEditingSpeaker,
+        removeEditingSpeaker,
+        filterEditingSpeakerSuggestions,
+        selectEditingSpeakerSuggestion,
+        closeEditingSpeakerSuggestions,
+        onEditSpeakerBlur,
+        getEditSpeakerDropdownPosition,
+        saveEditingSpeakers,
+
+        // Edit text
+        openEditTextModal,
+        closeEditTextModal,
+        saveEditedText,
+
+        // Change speaker
+        openSpeakerChangeDropdown,
+        changeSpeaker
+    };
+}
diff --git a/static/js/modules/composables/tags.js b/static/js/modules/composables/tags.js
new file mode 100644
index 00000000..6e4a7b1d
--- /dev/null
+++ b/static/js/modules/composables/tags.js
@@ -0,0 +1,297 @@
+/**
+ * Tags Management Composable
+ * Handles tag operations for recordings
+ */
+
+const { computed, ref } = Vue;
+
+export function useTags({
+    recordings,
+    availableTags,
+    selectedRecording,
+    showEditTagsModal,
+    editingRecording,
+    tagSearchFilter,
+    showToast,
+    setGlobalError
+}) {
+    // State (using passed refs from parent)
+
+    // --- Tag Drag-and-Drop State for Edit Modal ---
+    const modalDraggedTagIndex = ref(null);
+    const modalDragOverTagIndex = ref(null);
+
+    // Computed
+    const getRecordingTags = (recording) => {
+        if (!recording || !recording.tags) return [];
+        return recording.tags;
+    };
+
+    const getAvailableTagsForRecording = (recording) => {
+        if (!recording || !availableTags.value) return [];
+        const recordingTagIds = getRecordingTags(recording).map(tag => tag.id);
+        return availableTags.value.filter(tag => !recordingTagIds.includes(tag.id));
+    };
+
+    const filteredAvailableTagsForModal = computed(() => {
+        if (!editingRecording.value) return [];
+        const availableTagsForRec = getAvailableTagsForRecording(editingRecording.value);
+        if (!tagSearchFilter.value) return availableTagsForRec;
+
+        const filter = tagSearchFilter.value.toLowerCase();
+        return availableTagsForRec.filter(tag =>
+            tag.name.toLowerCase().includes(filter)
+        );
+    });
+
+    // Methods
+    const editRecordingTags = (recording) => {
+        editingRecording.value = recording;
+        tagSearchFilter.value = '';
+        showEditTagsModal.value = true;
+    };
+
+    const closeEditTagsModal = () => {
+        showEditTagsModal.value = false;
+        editingRecording.value = null;
+        tagSearchFilter.value = '';
+    };
+
+    const addTagToRecording = async (tagId) => {
+        if (!tagId || !editingRecording.value) return;
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch(`/api/recordings/${editingRecording.value.id}/tags`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ tag_id: tagId })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to add tag');
+            }
+
+            // Update local recording data
+            const tagToAdd = availableTags.value.find(tag => tag.id == tagId);
+            if (tagToAdd) {
+                // Check if tag already exists to prevent duplicates
+                const tagExists = editingRecording.value.tags?.some(t => t.id === tagToAdd.id);
+                if (!tagExists) {
+                    if (!editingRecording.value.tags) {
+                        editingRecording.value.tags = [];
+                    }
+                    editingRecording.value.tags.push(tagToAdd);
+                }
+
+                // Also update in recordings list (only if different object)
+                const recordingInList = recordings.value.find(r => r.id === editingRecording.value.id);
+                if (recordingInList && recordingInList !== editingRecording.value) {
+                    const tagExistsInList = recordingInList.tags?.some(t => t.id === tagToAdd.id);
+                    if (!tagExistsInList) {
+                        if (!recordingInList.tags) {
+                            recordingInList.tags = [];
+                        }
+                        recordingInList.tags.push(tagToAdd);
+                    }
+                }
+
+                // Update selectedRecording if it matches (only if different object)
+                if (selectedRecording.value &&
+                    selectedRecording.value.id === editingRecording.value.id &&
+                    selectedRecording.value !== editingRecording.value) {
+                    const tagExistsInSelected = selectedRecording.value.tags?.some(t => t.id === tagToAdd.id);
+                    if (!tagExistsInSelected) {
+                        if (!selectedRecording.value.tags) {
+                            selectedRecording.value.tags = [];
+                        }
+                        selectedRecording.value.tags.push(tagToAdd);
+                    }
+                }
+            }
+
+            showToast('Tag added successfully', 'fa-check-circle', 2000, 'success');
+
+        } catch (error) {
+            console.error('Error adding tag to recording:', error);
+            setGlobalError(`Failed to add tag: ${error.message}`);
+        }
+    };
+
+    const removeTagFromRecording = async (tagId) => {
+        if (!editingRecording.value) return;
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch(`/api/recordings/${editingRecording.value.id}/tags/${tagId}`, {
+                method: 'DELETE',
+                headers: {
+                    'X-CSRFToken': csrfToken
+                }
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to remove tag');
+            }
+
+            // Update local recording data
+            editingRecording.value.tags = editingRecording.value.tags.filter(tag => tag.id !== tagId);
+
+            // Also update in recordings list
+            const recordingInList = recordings.value.find(r => r.id === editingRecording.value.id);
+            if (recordingInList && recordingInList !== editingRecording.value && recordingInList.tags) {
+                recordingInList.tags = recordingInList.tags.filter(tag => tag.id !== tagId);
+            }
+
+            // Update selectedRecording if it matches
+            if (selectedRecording.value && selectedRecording.value.id === editingRecording.value.id && selectedRecording.value.tags) {
+                selectedRecording.value.tags = selectedRecording.value.tags.filter(tag => tag.id !== tagId);
+            }
+
+            showToast('Tag removed successfully', 'fa-check-circle', 2000, 'success');
+
+        } catch (error) {
+            console.error('Error removing tag from recording:', error);
+            setGlobalError(`Failed to remove tag: ${error.message}`);
+        }
+    };
+
+    // --- Modal Tag Reordering ---
+
+    const reorderModalTags = async (fromIndex, toIndex) => {
+        if (!editingRecording.value || !editingRecording.value.tags) return;
+
+        // Reorder locally first for immediate visual feedback
+        const tags = [...editingRecording.value.tags];
+        const [removed] = tags.splice(fromIndex, 1);
+        tags.splice(toIndex, 0, removed);
+        editingRecording.value.tags = tags;
+
+        // Update in recordings list
+        const recordingInList = recordings.value.find(r => r.id === editingRecording.value.id);
+        if (recordingInList && recordingInList !== editingRecording.value) {
+            recordingInList.tags = [...tags];
+        }
+
+        // Update selectedRecording if it matches
+        if (selectedRecording.value && selectedRecording.value.id === editingRecording.value.id) {
+            selectedRecording.value.tags = [...tags];
+        }
+
+        // Persist to backend
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const tagIds = tags.map(t => t.id);
+
+            const response = await fetch(`/api/recordings/${editingRecording.value.id}/tags/reorder`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ tag_ids: tagIds })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to reorder tags');
+            }
+
+            showToast('Tags reordered', 'fa-arrows-alt', 1500, 'success');
+
+        } catch (error) {
+            console.error('Error reordering tags:', error);
+            setGlobalError(`Failed to save tag order: ${error.message}`);
+        }
+    };
+
+    // === MOUSE DRAG HANDLERS (Modal) ===
+    const handleModalTagDragStart = (index, event) => {
+        modalDraggedTagIndex.value = index;
+        event.dataTransfer.effectAllowed = 'move';
+        event.dataTransfer.setData('text/plain', index.toString());
+    };
+
+    const handleModalTagDragOver = (index, event) => {
+        event.preventDefault();
+        event.dataTransfer.dropEffect = 'move';
+        modalDragOverTagIndex.value = index;
+    };
+
+    const handleModalTagDrop = (targetIndex, event) => {
+        event.preventDefault();
+        if (modalDraggedTagIndex.value !== null && modalDraggedTagIndex.value !== targetIndex) {
+            reorderModalTags(modalDraggedTagIndex.value, targetIndex);
+        }
+        modalDraggedTagIndex.value = null;
+        modalDragOverTagIndex.value = null;
+    };
+
+    const handleModalTagDragEnd = () => {
+        modalDraggedTagIndex.value = null;
+        modalDragOverTagIndex.value = null;
+    };
+
+    // === TOUCH HANDLERS (Modal - Mobile) ===
+    let modalTouchStartIndex = null;
+
+    const handleModalTagTouchStart = (index, event) => {
+        modalTouchStartIndex = index;
+        modalDraggedTagIndex.value = index;
+    };
+
+    const handleModalTagTouchMove = (event) => {
+        if (modalTouchStartIndex === null) return;
+        event.preventDefault();
+
+        const touch = event.touches[0];
+        const elementBelow = document.elementFromPoint(touch.clientX, touch.clientY);
+        const tagElement = elementBelow?.closest('[data-modal-tag-index]');
+
+        if (tagElement) {
+            const targetIndex = parseInt(tagElement.dataset.modalTagIndex);
+            modalDragOverTagIndex.value = targetIndex;
+        }
+    };
+
+    const handleModalTagTouchEnd = () => {
+        if (modalTouchStartIndex !== null && modalDragOverTagIndex.value !== null &&
+            modalTouchStartIndex !== modalDragOverTagIndex.value) {
+            reorderModalTags(modalTouchStartIndex, modalDragOverTagIndex.value);
+        }
+        modalTouchStartIndex = null;
+        modalDraggedTagIndex.value = null;
+        modalDragOverTagIndex.value = null;
+    };
+
+    return {
+        // Computed
+        filteredAvailableTagsForModal,
+
+        // Methods
+        getRecordingTags,
+        getAvailableTagsForRecording,
+        editRecordingTags,
+        closeEditTagsModal,
+        addTagToRecording,
+        removeTagFromRecording,
+
+        // Modal Tag Drag-and-Drop
+        modalDraggedTagIndex,
+        modalDragOverTagIndex,
+        handleModalTagDragStart,
+        handleModalTagDragOver,
+        handleModalTagDrop,
+        handleModalTagDragEnd,
+        handleModalTagTouchStart,
+        handleModalTagTouchMove,
+        handleModalTagTouchEnd
+    };
+}
diff --git a/static/js/modules/composables/tokens.js b/static/js/modules/composables/tokens.js
new file mode 100644
index 00000000..c1d4323c
--- /dev/null
+++ b/static/js/modules/composables/tokens.js
@@ -0,0 +1,286 @@
+/**
+ * API Tokens Management Composable
+ * Handles API token operations for user authentication
+ */
+
+const { ref, computed } = Vue;
+
+export function useTokens({ showToast, setGlobalError }) {
+    // State
+    const tokens = ref([]);
+    const isLoadingTokens = ref(false);
+    const showCreateTokenModal = ref(false);
+    const showTokenSecretModal = ref(false);
+    const newTokenSecret = ref('');
+    const newTokenData = ref(null);
+    const tokenForm = ref({
+        name: '',
+        expires_in_days: 0  // 0 = no expiration
+    });
+
+    // Computed
+    const hasTokens = computed(() => tokens.value.length > 0);
+
+    const activeTokens = computed(() => {
+        return tokens.value.filter(token => !token.revoked && !isTokenExpired(token));
+    });
+
+    const expiredOrRevokedTokens = computed(() => {
+        return tokens.value.filter(token => token.revoked || isTokenExpired(token));
+    });
+
+    // Helper methods
+    const isTokenExpired = (token) => {
+        if (!token.expires_at) return false;
+        const expiryDate = new Date(token.expires_at);
+        return expiryDate < new Date();
+    };
+
+    const formatTokenDate = (dateString) => {
+        if (!dateString) return 'Never';
+        const date = new Date(dateString);
+        return date.toLocaleDateString() + ' ' + date.toLocaleTimeString();
+    };
+
+    const getTokenStatus = (token) => {
+        if (token.revoked) return 'revoked';
+        if (isTokenExpired(token)) return 'expired';
+        return 'active';
+    };
+
+    const getTokenStatusClass = (token) => {
+        const status = getTokenStatus(token);
+        const baseClasses = 'px-2 py-1 text-xs font-semibold rounded';
+
+        switch (status) {
+            case 'active':
+                return `${baseClasses} bg-green-100 text-green-800`;
+            case 'expired':
+                return `${baseClasses} bg-yellow-100 text-yellow-800`;
+            case 'revoked':
+                return `${baseClasses} bg-red-100 text-red-800`;
+            default:
+                return `${baseClasses} bg-gray-100 text-gray-800`;
+        }
+    };
+
+    // API methods
+    const loadTokens = async () => {
+        isLoadingTokens.value = true;
+        try {
+            const response = await fetch('/api/tokens', {
+                method: 'GET',
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+
+            if (!response.ok) {
+                throw new Error('Failed to load tokens');
+            }
+
+            const data = await response.json();
+            tokens.value = data.tokens || [];
+        } catch (error) {
+            console.error('Error loading tokens:', error);
+            setGlobalError('Failed to load API tokens: ' + error.message);
+        } finally {
+            isLoadingTokens.value = false;
+        }
+    };
+
+    const createToken = async () => {
+        if (!tokenForm.value.name || tokenForm.value.name.trim() === '') {
+            showToast('Please enter a token name', 'error');
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch('/api/tokens', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({
+                    name: tokenForm.value.name,
+                    expires_in_days: parseInt(tokenForm.value.expires_in_days) || 0
+                })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to create token');
+            }
+
+            const data = await response.json();
+
+            // Store the plaintext token to show to user (only shown once)
+            newTokenSecret.value = data.token;
+            newTokenData.value = {
+                id: data.id,
+                name: data.name,
+                created_at: data.created_at,
+                expires_at: data.expires_at
+            };
+
+            // Add to tokens list (without the plaintext token)
+            tokens.value.unshift({
+                id: data.id,
+                name: data.name,
+                created_at: data.created_at,
+                last_used_at: data.last_used_at,
+                expires_at: data.expires_at,
+                revoked: data.revoked
+            });
+
+            // Reset form
+            tokenForm.value = {
+                name: '',
+                expires_in_days: 0
+            };
+
+            // Close create modal and show secret modal
+            showCreateTokenModal.value = false;
+            showTokenSecretModal.value = true;
+
+            showToast('API token created successfully', 'success');
+        } catch (error) {
+            console.error('Error creating token:', error);
+            showToast('Failed to create token: ' + error.message, 'error');
+        }
+    };
+
+    const revokeToken = async (tokenId, tokenName) => {
+        if (!confirm(`Are you sure you want to revoke the token "${tokenName}"? This action cannot be undone and any applications using this token will lose access.`)) {
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch(`/api/tokens/${tokenId}`, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                }
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to revoke token');
+            }
+
+            // Remove from local list
+            tokens.value = tokens.value.filter(t => t.id !== tokenId);
+
+            showToast('Token revoked successfully', 'success');
+        } catch (error) {
+            console.error('Error revoking token:', error);
+            showToast('Failed to revoke token: ' + error.message, 'error');
+        }
+    };
+
+    const updateTokenName = async (tokenId, newName) => {
+        if (!newName || newName.trim() === '') {
+            showToast('Token name cannot be empty', 'error');
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+            const response = await fetch(`/api/tokens/${tokenId}`, {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ name: newName })
+            });
+
+            if (!response.ok) {
+                const errorData = await response.json();
+                throw new Error(errorData.error || 'Failed to update token');
+            }
+
+            const data = await response.json();
+
+            // Update local token
+            const token = tokens.value.find(t => t.id === tokenId);
+            if (token) {
+                token.name = data.name;
+            }
+
+            showToast('Token name updated', 'success');
+        } catch (error) {
+            console.error('Error updating token:', error);
+            showToast('Failed to update token: ' + error.message, 'error');
+        }
+    };
+
+    const copyTokenToClipboard = async (token) => {
+        try {
+            await navigator.clipboard.writeText(token);
+            showToast('Token copied to clipboard', 'success');
+        } catch (error) {
+            console.error('Error copying token:', error);
+            showToast('Failed to copy token to clipboard', 'error');
+        }
+    };
+
+    const openCreateTokenModal = () => {
+        tokenForm.value = {
+            name: '',
+            expires_in_days: 0
+        };
+        showCreateTokenModal.value = true;
+    };
+
+    const closeCreateTokenModal = () => {
+        showCreateTokenModal.value = false;
+        tokenForm.value = {
+            name: '',
+            expires_in_days: 0
+        };
+    };
+
+    const closeTokenSecretModal = () => {
+        showTokenSecretModal.value = false;
+        newTokenSecret.value = '';
+        newTokenData.value = null;
+    };
+
+    return {
+        // State
+        tokens,
+        isLoadingTokens,
+        showCreateTokenModal,
+        showTokenSecretModal,
+        newTokenSecret,
+        newTokenData,
+        tokenForm,
+
+        // Computed
+        hasTokens,
+        activeTokens,
+        expiredOrRevokedTokens,
+
+        // Methods
+        isTokenExpired,
+        formatTokenDate,
+        getTokenStatus,
+        getTokenStatusClass,
+        loadTokens,
+        createToken,
+        revokeToken,
+        updateTokenName,
+        copyTokenToClipboard,
+        openCreateTokenModal,
+        closeCreateTokenModal,
+        closeTokenSecretModal
+    };
+}
diff --git a/static/js/modules/composables/transcription.js b/static/js/modules/composables/transcription.js
new file mode 100644
index 00000000..e69ff415
--- /dev/null
+++ b/static/js/modules/composables/transcription.js
@@ -0,0 +1,624 @@
+/**
+ * Transcription editing composable
+ * Handles ASR editor, text editor, and segment management
+ */
+
+// Module-scoped scroll-position memory for the ASR editor. Keyed by recording
+// id so users editing a long transcript can close and reopen the modal within
+// the same session and land back where they left off. Cleared implicitly when
+// the page reloads.
+const _asrEditorScrollMemory = new Map();
+
+// Pending segment index to scroll to when the editor next opens. Used by the
+// double-click-on-simple-view-segment path. null means "restore last scroll".
+let _asrEditorPendingScrollIndex = null;
+
+export function useTranscription(state, utils) {
+    const {
+        showTextEditorModal, showAsrEditorModal, selectedRecording,
+        editingTranscriptionContent, editingSegments, availableSpeakers,
+        recordings, dropdownPositions, openAsrDropdownIndex,
+        asrEditorRef, asrEditorSaveFlash, asrEditorHighlightIndex, editorAutosave
+    } = state;
+
+    const { showToast, setGlobalError, nextTick } = utils;
+
+    // =========================================
+    // Text Editor Modal
+    // =========================================
+
+    const openTranscriptionEditor = () => {
+        if (!selectedRecording.value || !selectedRecording.value.transcription) {
+            return;
+        }
+
+        // Check if transcription is JSON (ASR format)
+        try {
+            const parsed = JSON.parse(selectedRecording.value.transcription);
+            if (Array.isArray(parsed)) {
+                openAsrEditorModal();
+            } else {
+                openTextEditorModal();
+            }
+        } catch (e) {
+            // Not JSON, use text editor
+            openTextEditorModal();
+        }
+    };
+
+    const openTextEditorModal = () => {
+        if (!selectedRecording.value) return;
+        editingTranscriptionContent.value = selectedRecording.value.transcription || '';
+        showTextEditorModal.value = true;
+    };
+
+    const closeTextEditorModal = () => {
+        showTextEditorModal.value = false;
+        editingTranscriptionContent.value = '';
+    };
+
+    const saveTranscription = async () => {
+        if (!selectedRecording.value) return;
+        await saveTranscriptionContent(editingTranscriptionContent.value);
+        closeTextEditorModal();
+    };
+
+    // =========================================
+    // ASR Editor Modal
+    // =========================================
+
+    // Helper to pause outer audio player when opening modals with their own player
+    const pauseOuterAudioPlayer = () => {
+        const outerAudio = document.querySelector('#rightMainColumn audio') || document.querySelector('#rightMainColumn video') ||
+                          document.querySelector('.detail-view audio:not(.fixed audio)') || document.querySelector('.detail-view video:not(.fixed video)');
+        if (outerAudio && !outerAudio.paused) {
+            outerAudio.pause();
+        }
+    };
+
+    const openAsrEditorModal = async () => {
+        if (!selectedRecording.value) return;
+
+        // Pause outer audio player to avoid conflicts with modal's player
+        pauseOuterAudioPlayer();
+
+        try {
+            const segments = JSON.parse(selectedRecording.value.transcription);
+
+            // Populate available speakers from THIS recording only
+            const speakersInTranscript = [...new Set(segments.map(s => s.speaker))].sort();
+            availableSpeakers.value = speakersInTranscript;
+
+            editingSegments.value = segments.map((s, i) => ({
+                ...s,
+                id: i,
+                showSuggestions: false,
+                filteredSpeakers: [...speakersInTranscript]
+            }));
+
+            showAsrEditorModal.value = true;
+
+            // Reset autosave state for the new editing session.
+            _resetAutosave();
+            _primeAutosaveAfterOpen();
+
+            // Reset virtual scroll state for fresh modal render. After it
+            // initialises, either scroll to a specific segment (when the
+            // modal was opened from a double-click on a simple-view row) or
+            // restore the last scroll position for this recording.
+            if (utils.resetAsrEditorScroll) {
+                utils.resetAsrEditorScroll();
+            }
+            const recordingId = selectedRecording.value.id;
+            const targetIndex = _asrEditorPendingScrollIndex;
+            _asrEditorPendingScrollIndex = null;
+            await nextTick();
+            // requestAnimationFrame defers past the virtualScroll's own
+            // post-mount initialisation tick.
+            requestAnimationFrame(() => {
+                if (targetIndex != null) {
+                    if (utils.scrollAsrEditorToIndex) {
+                        utils.scrollAsrEditorToIndex(targetIndex);
+                    }
+                } else {
+                    const saved = _asrEditorScrollMemory.get(recordingId);
+                    if (saved != null && utils.setAsrEditorScrollTop) {
+                        utils.setAsrEditorScrollTop(saved);
+                    }
+                }
+            });
+        } catch (e) {
+            console.error("Could not parse transcription as JSON for ASR editor:", e);
+            setGlobalError("This transcription is not in the correct format for the ASR editor.");
+        }
+    };
+
+    // Open the editor and scroll to a specific segment index. Used by the
+    // double-click-on-simple-view-row affordance. Also briefly highlights
+    // the target row so the user can see where they landed.
+    const openAsrEditorAtSegment = (segmentIndex) => {
+        _asrEditorPendingScrollIndex = segmentIndex;
+        if (asrEditorHighlightIndex) {
+            asrEditorHighlightIndex.value = segmentIndex;
+            // Hold the highlight for ~3s so the user has time to register
+            // the target row before it fades. The CSS handles the visual
+            // transition when the class is removed.
+            setTimeout(() => {
+                if (asrEditorHighlightIndex.value === segmentIndex) {
+                    asrEditorHighlightIndex.value = null;
+                }
+            }, 3000);
+        }
+        return openAsrEditorModal();
+    };
+
+    const closeAsrEditorModal = () => {
+        // Cancel any pending autosave so we don't issue a write after close.
+        _resetAutosave();
+        // Clear any pending row highlight.
+        if (asrEditorHighlightIndex) asrEditorHighlightIndex.value = null;
+
+        // Save scroll position so reopening the same recording within this
+        // session lands the user back where they were.
+        if (selectedRecording.value && asrEditorRef && asrEditorRef.value) {
+            _asrEditorScrollMemory.set(
+                selectedRecording.value.id,
+                asrEditorRef.value.scrollTop
+            );
+        }
+
+        // Pause any playing modal audio before closing
+        const modalAudio = document.querySelector('.fixed.z-50 audio') || document.querySelector('.fixed.z-50 video');
+        if (modalAudio) {
+            modalAudio.pause();
+        }
+        // Reset modal audio state (keep main player independent)
+        if (utils.resetModalAudioState) {
+            utils.resetModalAudioState();
+        }
+
+        showAsrEditorModal.value = false;
+        editingSegments.value = [];
+    };
+
+    const saveAsrTranscription = async (keepOpen = false) => {
+        if (!selectedRecording.value) return;
+
+        // Cancel any pending autosave so it doesn't fire a redundant write
+        // on top of this manual save (which would surface as two "Saved"
+        // toasts a couple of seconds apart).
+        if (_autosaveTimer) {
+            clearTimeout(_autosaveTimer);
+            _autosaveTimer = null;
+        }
+
+        // Remove extra UI fields and save the rest
+        const contentToSave = JSON.stringify(editingSegments.value.map(({ id, showSuggestions, filteredSpeakers, ...rest }) => rest));
+
+        await saveTranscriptionContent(contentToSave);
+
+        if (keepOpen) {
+            // Briefly flash a "Saved" indicator so the user knows the write
+            // succeeded without the modal closing.
+            if (asrEditorSaveFlash) {
+                asrEditorSaveFlash.value = true;
+                setTimeout(() => { asrEditorSaveFlash.value = false; }, 1800);
+            }
+        } else {
+            closeAsrEditorModal();
+        }
+    };
+
+    // Ctrl+S / Cmd+S handler -- saves without closing while the editor modal
+    // is open. preventDefault stops the browser's "save page" dialog.
+    const handleAsrEditorKeydown = (event) => {
+        if (!showAsrEditorModal.value) return;
+        const isSaveShortcut = (event.ctrlKey || event.metaKey) && (event.key === 's' || event.key === 'S');
+        if (isSaveShortcut) {
+            event.preventDefault();
+            saveAsrTranscription(true);
+        }
+    };
+    if (typeof window !== 'undefined') {
+        window.addEventListener('keydown', handleAsrEditorKeydown);
+    }
+
+    // Autosave -- when the user has opted in via the Preferences tab, debounce
+    // a save 2s after the last edit. The debounce prevents thrashing the API
+    // on every keystroke. The "primed" flag suppresses the initial firing
+    // when segments are first hydrated on modal open.
+    let _autosaveTimer = null;
+    let _autosavePrimed = false;
+
+    const _resetAutosave = () => {
+        if (_autosaveTimer) {
+            clearTimeout(_autosaveTimer);
+            _autosaveTimer = null;
+        }
+        _autosavePrimed = false;
+    };
+
+    const _primeAutosaveAfterOpen = () => {
+        // Defer priming until after the modal hydration tick so we don't
+        // mistake the initial editingSegments assignment for a user edit.
+        setTimeout(() => { _autosavePrimed = true; }, 500);
+    };
+
+    if (typeof Vue !== 'undefined' && Vue.watch) {
+        Vue.watch(
+            editingSegments,
+            () => {
+                if (!showAsrEditorModal.value) return;
+                if (!editorAutosave || !editorAutosave.value) return;
+                if (!_autosavePrimed) return;
+                if (_autosaveTimer) clearTimeout(_autosaveTimer);
+                _autosaveTimer = setTimeout(() => {
+                    _autosaveTimer = null;
+                    saveAsrTranscription(true);
+                }, 2000);
+            },
+            { deep: true }
+        );
+    }
+
+    // =========================================
+    // Segment Management
+    // =========================================
+
+    const adjustTime = (index, field, amount) => {
+        if (editingSegments.value[index]) {
+            editingSegments.value[index][field] = Math.max(0,
+                editingSegments.value[index][field] + amount
+            );
+        }
+    };
+
+    const filterSpeakerSuggestions = (index) => {
+        const segment = editingSegments.value[index];
+        if (segment) {
+            const query = segment.speaker?.toLowerCase() || '';
+            if (query === '') {
+                segment.filteredSpeakers = [...availableSpeakers.value];
+            } else {
+                segment.filteredSpeakers = availableSpeakers.value.filter(
+                    speaker => speaker.toLowerCase().includes(query)
+                );
+            }
+        }
+    };
+
+    // O(1) dropdown management using single ref instead of O(n) forEach
+    const openSpeakerSuggestions = (index) => {
+        if (editingSegments.value[index]) {
+            // Simply set the open index - O(1) instead of O(n) forEach
+            openAsrDropdownIndex.value = index;
+            filterSpeakerSuggestions(index);
+            updateDropdownPosition(index);
+        }
+    };
+
+    const closeSpeakerSuggestions = (index) => {
+        // Only close if this index is currently open
+        if (openAsrDropdownIndex.value === index) {
+            openAsrDropdownIndex.value = null;
+        }
+    };
+
+    const closeAllSpeakerSuggestions = () => {
+        // O(1) instead of O(n) - just set to null
+        openAsrDropdownIndex.value = null;
+    };
+
+    // Helper to check if a dropdown is open (for template v-if)
+    const isDropdownOpen = (index) => {
+        return openAsrDropdownIndex.value === index;
+    };
+
+    const getDropdownPosition = (index) => {
+        const pos = dropdownPositions.value[index];
+        if (pos) {
+            const style = {
+                left: pos.left + 'px',
+                width: pos.width + 'px'
+            };
+
+            // When opening upward, anchor from bottom so dropdown grows upward
+            if (pos.openUpward) {
+                style.bottom = pos.bottom + 'px';
+                style.top = 'auto';
+            } else {
+                style.top = pos.top + 'px';
+                style.bottom = 'auto';
+            }
+
+            // Apply calculated max height
+            if (pos.maxHeight) {
+                style.maxHeight = pos.maxHeight + 'px';
+            }
+            return style;
+        }
+        return { top: '0px', left: '0px' };
+    };
+
+    const updateDropdownPosition = (index) => {
+        nextTick(() => {
+            // Find row by data attribute to work correctly with virtual scrolling
+            const row = document.querySelector(`.asr-editor-table tbody tr[data-segment-index="${index}"]`);
+            if (row) {
+                const cell = row.querySelector('td:first-child');
+                if (cell) {
+                    const rect = cell.getBoundingClientRect();
+                    const viewportHeight = window.innerHeight;
+
+                    // Calculate available space above and below
+                    const spaceBelow = viewportHeight - rect.bottom - 10;
+                    const spaceAbove = rect.top - 10;
+
+                    // Determine max height based on available space (cap at 192px which is max-h-48)
+                    const maxDropdownHeight = 192;
+
+                    let top, bottom, openUpward, maxHeight;
+
+                    if (spaceBelow >= maxDropdownHeight || spaceBelow >= spaceAbove) {
+                        // Open downward
+                        top = rect.bottom + 2;
+                        bottom = null;
+                        openUpward = false;
+                        maxHeight = Math.min(spaceBelow, maxDropdownHeight);
+                    } else {
+                        // Open upward - anchor from bottom so dropdown grows upward
+                        openUpward = true;
+                        maxHeight = Math.min(spaceAbove, maxDropdownHeight);
+                        // Bottom is distance from viewport bottom to the top of the cell
+                        bottom = viewportHeight - rect.top + 2;
+                        top = null;
+                    }
+
+                    dropdownPositions.value[index] = {
+                        top: top,
+                        bottom: bottom,
+                        left: rect.left,
+                        width: rect.width,
+                        openUpward: openUpward,
+                        maxHeight: maxHeight
+                    };
+                }
+            }
+        });
+    };
+
+    const selectSpeaker = (index, speaker) => {
+        if (editingSegments.value[index]) {
+            editingSegments.value[index].speaker = speaker;
+            closeSpeakerSuggestions(index);
+        }
+    };
+
+    const addSegment = () => {
+        const lastSegment = editingSegments.value[editingSegments.value.length - 1];
+        const newStart = lastSegment ? lastSegment.end_time : 0;
+
+        editingSegments.value.push({
+            speaker: availableSpeakers.value[0] || 'Speaker 1',
+            start_time: newStart,
+            end_time: newStart + 5,
+            sentence: '',
+            id: editingSegments.value.length,
+            showSuggestions: false,
+            filteredSpeakers: [...availableSpeakers.value]
+        });
+    };
+
+    const removeSegment = (index) => {
+        editingSegments.value.splice(index, 1);
+        // Re-index segments
+        editingSegments.value.forEach((seg, i) => {
+            seg.id = i;
+        });
+    };
+
+    const addSegmentBelow = (index) => {
+        const currentSegment = editingSegments.value[index];
+        const nextSegment = editingSegments.value[index + 1];
+
+        const newStart = currentSegment.end_time;
+        const newEnd = nextSegment ? nextSegment.start_time : newStart + 5;
+
+        editingSegments.value.splice(index + 1, 0, {
+            speaker: currentSegment.speaker,
+            start_time: newStart,
+            end_time: newEnd,
+            sentence: '',
+            id: index + 1,
+            showSuggestions: false,
+            filteredSpeakers: [...availableSpeakers.value]
+        });
+
+        // Re-index segments
+        editingSegments.value.forEach((seg, i) => {
+            seg.id = i;
+        });
+    };
+
+    const seekToSegmentTime = (time) => {
+        // Find audio elements and use the one in a visible modal (z-50)
+        const mediaElements = document.querySelectorAll('.fixed.z-50 audio, .fixed.z-50 video');
+        const audioElement = mediaElements.length > 0 ? mediaElements[mediaElements.length - 1] : null;
+        if (audioElement) {
+            audioElement.currentTime = time;
+            audioElement.play();
+        }
+    };
+
+    const autoResizeTextarea = (event) => {
+        const textarea = event.target;
+        textarea.style.height = 'auto';
+        textarea.style.height = textarea.scrollHeight + 'px';
+    };
+
+    // =========================================
+    // Save Transcription Content
+    // =========================================
+
+    const saveTranscriptionContent = async (content) => {
+        if (!selectedRecording.value) return;
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/update_transcription`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ transcription: content })
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update transcription');
+
+            // Update recording
+            selectedRecording.value.transcription = content;
+
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1) {
+                recordings.value[index].transcription = content;
+            }
+
+            showToast('Transcription updated successfully!', 'fa-check-circle');
+        } catch (error) {
+            setGlobalError(`Failed to save transcription: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Save Summary
+    // =========================================
+
+    const saveSummary = async (summary) => {
+        if (!selectedRecording.value) return;
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const payload = {
+                id: selectedRecording.value.id,
+                title: selectedRecording.value.title,
+                participants: selectedRecording.value.participants,
+                notes: selectedRecording.value.notes,
+                summary: summary,
+                meeting_date: selectedRecording.value.meeting_date
+            };
+            const response = await fetch('/save', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify(payload)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update summary');
+
+            // Update recording
+            selectedRecording.value.summary = summary;
+
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1) {
+                recordings.value[index].summary = summary;
+            }
+
+            showToast('Summary saved!', 'fa-check-circle');
+        } catch (error) {
+            setGlobalError(`Failed to save summary: ${error.message}`);
+        }
+    };
+
+    // =========================================
+    // Save Notes
+    // =========================================
+
+    const saveNotes = async (notes) => {
+        if (!selectedRecording.value) return;
+
+        // Handle incognito recordings - save to sessionStorage only
+        if (selectedRecording.value.incognito) {
+            selectedRecording.value.notes = notes;
+            // Update sessionStorage
+            try {
+                const stored = sessionStorage.getItem('speakr_incognito_recording');
+                if (stored) {
+                    const data = JSON.parse(stored);
+                    data.notes = notes;
+                    sessionStorage.setItem('speakr_incognito_recording', JSON.stringify(data));
+                }
+            } catch (e) {
+                console.error('[Incognito] Failed to save notes to sessionStorage:', e);
+            }
+            showToast('Notes saved (in browser only)', 'fa-check-circle');
+            return;
+        }
+
+        try {
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/api/recordings/${selectedRecording.value.id}`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ notes })
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to update notes');
+
+            // Update recording
+            selectedRecording.value.notes = notes;
+
+            const index = recordings.value.findIndex(r => r.id === selectedRecording.value.id);
+            if (index !== -1) {
+                recordings.value[index].notes = notes;
+            }
+
+            showToast('Notes saved!', 'fa-check-circle');
+        } catch (error) {
+            setGlobalError(`Failed to save notes: ${error.message}`);
+        }
+    };
+
+    return {
+        // Text editor
+        openTranscriptionEditor,
+        openTextEditorModal,
+        closeTextEditorModal,
+        saveTranscription,
+
+        // ASR editor
+        openAsrEditorModal,
+        openAsrEditorAtSegment,
+        closeAsrEditorModal,
+        saveAsrTranscription,
+
+        // Segment management
+        adjustTime,
+        filterSpeakerSuggestions,
+        openSpeakerSuggestions,
+        closeSpeakerSuggestions,
+        closeAllSpeakerSuggestions,
+        isDropdownOpen,
+        getDropdownPosition,
+        updateDropdownPosition,
+        selectSpeaker,
+        addSegment,
+        removeSegment,
+        addSegmentBelow,
+        seekToSegmentTime,
+        autoResizeTextarea,
+
+        // Save
+        saveTranscriptionContent,
+        saveSummary,
+        saveNotes
+    };
+}
diff --git a/static/js/modules/composables/ui.js b/static/js/modules/composables/ui.js
new file mode 100644
index 00000000..dd43795b
--- /dev/null
+++ b/static/js/modules/composables/ui.js
@@ -0,0 +1,2091 @@
+/**
+ * UI management composable
+ * Handles dark mode, color schemes, sidebar, and other UI state
+ */
+
+export function useUI(state, utils, processedTranscription) {
+    const {
+        isDarkMode, currentColorScheme, colorSchemes, isSidebarCollapsed,
+        showColorSchemeModal, isUserMenuOpen, currentView, selectedRecording,
+        windowWidth, isMobileScreen, showAdvancedFilters, showSortOptions,
+        searchTipsExpanded, isMetadataExpanded, editingParticipants, editingMeetingDate,
+        editingSummary, tempSummaryContent, summaryMarkdownEditorInstance,
+        leftColumnWidth, rightColumnWidth, isResizing, playerVolume,
+        audioIsPlaying, audioCurrentTime, audioDuration, audioIsMuted, audioIsLoading,
+        editingNotes, tempNotesContent, transcriptionViewMode,
+        notesMarkdownEditor, markdownEditorInstance, autoSaveTimer, csrfToken,
+        summaryMarkdownEditor, recordingNotesEditor, recordingMarkdownEditorInstance,
+        recordingNotes, showDownloadMenu, currentPlayingSegmentIndex, followPlayerMode,
+        playbackRate, showSpeedMenu, playbackSpeeds, modalPlaybackRate, speedMenuPosition,
+        videoFullscreen, fullscreenControlsVisible, fullscreenControlsTimer, videoCollapsed,
+        regeneratingTitle
+    } = state;
+
+    const autoSaveDelay = 2000; // 2 seconds
+
+    const { showToast, nextTick, t } = utils;
+    const { ref, computed, watch } = Vue;
+
+    // isMobile computed
+    const isMobile = computed(() => windowWidth.value < 768);
+
+    // Toggle dark mode
+    const toggleDarkMode = () => {
+        isDarkMode.value = !isDarkMode.value;
+        localStorage.setItem('darkMode', isDarkMode.value);
+
+        if (isDarkMode.value) {
+            document.documentElement.classList.add('dark');
+        } else {
+            document.documentElement.classList.remove('dark');
+        }
+
+        // Re-apply current color scheme for new mode
+        applyColorScheme(currentColorScheme.value);
+    };
+
+    // Initialize dark mode from storage
+    const initializeDarkMode = () => {
+        const savedMode = localStorage.getItem('darkMode');
+        if (savedMode !== null) {
+            isDarkMode.value = savedMode === 'true';
+        } else {
+            // Check system preference
+            isDarkMode.value = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        }
+
+        if (isDarkMode.value) {
+            document.documentElement.classList.add('dark');
+        } else {
+            document.documentElement.classList.remove('dark');
+        }
+    };
+
+    // Apply a color scheme
+    const applyColorScheme = (schemeId, mode = null) => {
+        const targetMode = mode || (isDarkMode.value ? 'dark' : 'light');
+        const scheme = colorSchemes[targetMode].find(s => s.id === schemeId);
+
+        if (!scheme) {
+            console.warn(`Color scheme '${schemeId}' not found for mode '${targetMode}'`);
+            return;
+        }
+
+        // Remove all theme classes
+        const allThemeClasses = [
+            ...colorSchemes.light.map(s => s.class),
+            ...colorSchemes.dark.map(s => s.class)
+        ].filter(c => c !== '');
+
+        document.documentElement.classList.remove(...allThemeClasses);
+
+        // Add new theme class if not default
+        if (scheme.class) {
+            document.documentElement.classList.add(scheme.class);
+        }
+
+        currentColorScheme.value = schemeId;
+        localStorage.setItem('colorScheme', schemeId);
+    };
+
+    // Initialize color scheme from storage
+    const initializeColorScheme = () => {
+        const savedScheme = localStorage.getItem('colorScheme');
+        if (savedScheme) {
+            applyColorScheme(savedScheme);
+        } else {
+            // Apply default scheme
+            applyColorScheme('blue');
+        }
+    };
+
+    // Open color scheme modal
+    const openColorSchemeModal = () => {
+        showColorSchemeModal.value = true;
+        isUserMenuOpen.value = false;
+    };
+
+    // Close color scheme modal
+    const closeColorSchemeModal = () => {
+        showColorSchemeModal.value = false;
+    };
+
+    // Select a color scheme
+    const selectColorScheme = (schemeId) => {
+        applyColorScheme(schemeId);
+        showToast(t('messages.colorSchemeApplied'), 'fa-palette');
+    };
+
+    // Reset to default color scheme
+    const resetColorScheme = () => {
+        applyColorScheme('blue');
+        showToast(t('messages.colorSchemeReset'), 'fa-undo');
+    };
+
+    // Toggle sidebar
+    const toggleSidebar = () => {
+        isSidebarCollapsed.value = !isSidebarCollapsed.value;
+        localStorage.setItem('sidebarCollapsed', isSidebarCollapsed.value);
+    };
+
+    // Initialize sidebar state
+    const initializeSidebar = () => {
+        const saved = localStorage.getItem('sidebarCollapsed');
+        if (saved !== null) {
+            isSidebarCollapsed.value = saved === 'true';
+        }
+    };
+
+    // Switch to upload view
+    const switchToUploadView = () => {
+        currentView.value = 'upload';
+        if (isMobileScreen.value) {
+            isSidebarCollapsed.value = true;
+        }
+    };
+
+    // Switch to detail view
+    const switchToDetailView = () => {
+        currentView.value = 'detail';
+    };
+
+    // Switch to recording view
+    const switchToRecordingView = () => {
+        currentView.value = 'recording';
+        if (isMobileScreen.value) {
+            isSidebarCollapsed.value = true;
+        }
+    };
+
+    // Set global error
+    const setGlobalError = (message, duration = 7000) => {
+        if (state.globalError) {
+            state.globalError.value = message;
+            if (duration > 0) {
+                setTimeout(() => {
+                    if (state.globalError.value === message) {
+                        state.globalError.value = null;
+                    }
+                }, duration);
+            }
+        }
+    };
+
+    // Format file size
+    const formatFileSize = (bytes) => {
+        if (!bytes) return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+    };
+
+    // Format display date
+    const formatDisplayDate = (dateString) => {
+        if (!dateString) return '';
+        const date = new Date(dateString);
+        return date.toLocaleDateString(undefined, {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit'
+        });
+    };
+
+    // Format short date
+    const formatShortDate = (dateString) => {
+        if (!dateString) return '';
+        const date = new Date(dateString);
+        const now = new Date();
+        const diff = now - date;
+        const oneDay = 24 * 60 * 60 * 1000;
+
+        if (diff < oneDay) {
+            return date.toLocaleTimeString(undefined, {
+                hour: '2-digit',
+                minute: '2-digit'
+            });
+        } else if (diff < 7 * oneDay) {
+            return date.toLocaleDateString(undefined, {
+                weekday: 'short'
+            });
+        } else {
+            return date.toLocaleDateString(undefined, {
+                month: 'short',
+                day: 'numeric'
+            });
+        }
+    };
+
+    // Format status
+    const formatStatus = (status) => {
+        if (!status || status === 'COMPLETED') return '';
+        const statusMap = {
+            'PENDING': t('status.queued'),
+            'QUEUED': t('status.queued'),
+            'PROCESSING': t('status.processing'),
+            'TRANSCRIBING': t('status.transcribing'),
+            'SUMMARIZING': t('status.summarizing'),
+            'FAILED': t('status.failed'),
+            'UPLOADING': t('status.uploading')
+        };
+        return statusMap[status] || status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
+    };
+
+    // Get status class
+    const getStatusClass = (status) => {
+        switch(status) {
+            case 'PENDING': return 'status-pending';
+            case 'QUEUED': return 'status-pending';
+            case 'PROCESSING': return 'status-processing';
+            case 'SUMMARIZING': return 'status-summarizing';
+            case 'COMPLETED': return '';
+            case 'FAILED': return 'status-failed';
+            default: return 'status-pending';
+        }
+    };
+
+    // Format time (seconds to HH:MM:SS)
+    const formatTime = (seconds) => {
+        if (!seconds && seconds !== 0) return '00:00';
+        const h = Math.floor(seconds / 3600);
+        const m = Math.floor((seconds % 3600) / 60);
+        const s = Math.floor(seconds % 60);
+
+        if (h > 0) {
+            return `${h}:${m.toString().padStart(2, '0')}:${s.toString().padStart(2, '0')}`;
+        }
+        return `${m}:${s.toString().padStart(2, '0')}`;
+    };
+
+    // Format duration in seconds to human readable
+    const formatDuration = (seconds) => {
+        if (!seconds && seconds !== 0) return '';
+
+        const h = Math.floor(seconds / 3600);
+        const m = Math.floor((seconds % 3600) / 60);
+        const s = Math.floor(seconds % 60);
+
+        const parts = [];
+        if (h > 0) parts.push(`${h}h`);
+        if (m > 0) parts.push(`${m}m`);
+        if (s > 0 || parts.length === 0) parts.push(`${s}s`);
+
+        return parts.join(' ');
+    };
+
+    // Format processing duration
+    const formatProcessingDuration = (seconds) => {
+        if (!seconds) return '';
+        if (seconds < 60) {
+            return `${Math.round(seconds)}s`;
+        } else if (seconds < 3600) {
+            const m = Math.floor(seconds / 60);
+            const s = Math.round(seconds % 60);
+            return `${m}m ${s}s`;
+        } else {
+            const h = Math.floor(seconds / 3600);
+            const m = Math.round((seconds % 3600) / 60);
+            return `${h}h ${m}m`;
+        }
+    };
+
+    // --- Inline Editing ---
+    const saveInlineEdit = async (field) => {
+        if (!selectedRecording.value) return;
+
+        const fullPayload = {
+            id: selectedRecording.value.id,
+            title: selectedRecording.value.title,
+            participants: selectedRecording.value.participants,
+            notes: selectedRecording.value.notes,
+            summary: selectedRecording.value.summary,
+            meeting_date: selectedRecording.value.meeting_date
+        };
+
+        try {
+            const csrfTokenValue = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch('/save', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfTokenValue
+                },
+                body: JSON.stringify(fullPayload)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to save metadata');
+
+            // Update the recording with returned HTML
+            if (data.recording) {
+                if (field === 'notes' && data.recording.notes_html) {
+                    selectedRecording.value.notes_html = data.recording.notes_html;
+                } else if (field === 'summary' && data.recording.summary_html) {
+                    selectedRecording.value.summary_html = data.recording.summary_html;
+                }
+            }
+        } catch (error) {
+            showToast(t('messages.failedToSave', { error: error.message }), 'fa-exclamation-circle', 3000, 'error');
+        }
+    };
+
+    const toggleEditParticipants = () => {
+        editingParticipants.value = !editingParticipants.value;
+        if (!editingParticipants.value) {
+            saveInlineEdit('participants');
+        }
+    };
+
+    const toggleEditMeetingDate = () => {
+        editingMeetingDate.value = !editingMeetingDate.value;
+        if (!editingMeetingDate.value) {
+            saveInlineEdit('meeting_date');
+        }
+    };
+
+    const toggleEditTitle = () => {
+        if (!selectedRecording.value) return;
+
+        // Check if user has permission to edit
+        if (selectedRecording.value.can_edit === false) {
+            showToast(t('messages.noPermissionToEdit'), 'fa-exclamation-circle', 3000, 'error');
+            return;
+        }
+
+        if (!state.editingTitle.value) {
+            // Start editing
+            state.originalTitle.value = selectedRecording.value.title || '';
+            state.editingTitle.value = true;
+            nextTick(() => {
+                // Focus the input field
+                const titleInput = document.querySelector('input[ref="titleInput"]');
+                if (titleInput) {
+                    titleInput.focus();
+                    titleInput.select();
+                }
+            });
+        }
+    };
+
+    const saveTitle = async () => {
+        if (!selectedRecording.value) return;
+
+        state.editingTitle.value = false;
+
+        // Only save if title changed
+        if (selectedRecording.value.title !== state.originalTitle.value) {
+            await saveInlineEdit('title');
+        }
+    };
+
+    const cancelEditTitle = () => {
+        if (!selectedRecording.value) return;
+
+        // Restore original title
+        selectedRecording.value.title = state.originalTitle.value;
+        state.editingTitle.value = false;
+    };
+
+    const regenerateTitle = async () => {
+        if (!selectedRecording.value || regeneratingTitle.value) return;
+
+        regeneratingTitle.value = true;
+        try {
+            const csrfTokenValue = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+            const response = await fetch(`/recording/${selectedRecording.value.id}/regenerate_title`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfTokenValue
+                }
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to regenerate title');
+
+            selectedRecording.value.title = data.title;
+            showToast('Title regenerated', 'fa-check-circle', 3000, 'success');
+        } catch (error) {
+            showToast(error.message, 'fa-exclamation-circle', 3000, 'error');
+        } finally {
+            regeneratingTitle.value = false;
+        }
+    };
+
+    const toggleEditSummary = () => {
+        editingSummary.value = !editingSummary.value;
+        if (editingSummary.value) {
+            tempSummaryContent.value = selectedRecording.value?.summary || '';
+            nextTick(() => {
+                initializeSummaryMarkdownEditor();
+            });
+        }
+    };
+
+    const cancelEditSummary = () => {
+        if (summaryMarkdownEditorInstance.value) {
+            summaryMarkdownEditorInstance.value.toTextArea();
+            summaryMarkdownEditorInstance.value = null;
+        }
+        editingSummary.value = false;
+        // Restore original content
+        if (selectedRecording.value) {
+            selectedRecording.value.summary = tempSummaryContent.value;
+        }
+    };
+
+    const saveEditSummary = async () => {
+        if (summaryMarkdownEditorInstance.value) {
+            selectedRecording.value.summary = summaryMarkdownEditorInstance.value.value();
+            summaryMarkdownEditorInstance.value.toTextArea();
+            summaryMarkdownEditorInstance.value = null;
+        }
+        editingSummary.value = false;
+        await saveInlineEdit('summary');
+    };
+
+    const initializeSummaryMarkdownEditor = () => {
+        if (!summaryMarkdownEditor.value) return;
+
+        try {
+            summaryMarkdownEditorInstance.value = new EasyMDE({
+                element: summaryMarkdownEditor.value,
+                spellChecker: false,
+                autofocus: true,
+                placeholder: t('form.enterSummaryMarkdown'),
+                initialValue: selectedRecording.value?.summary || '',
+                status: false,
+                toolbar: [
+                    "bold", "italic", "heading", "|",
+                    "quote", "unordered-list", "ordered-list", "|",
+                    "link", "image", "|",
+                    "preview", "side-by-side", "fullscreen"
+                ],
+                previewClass: ["editor-preview", "notes-preview"],
+                theme: isDarkMode.value ? "dark" : "light"
+            });
+
+            // Add auto-save functionality
+            summaryMarkdownEditorInstance.value.codemirror.on('change', () => {
+                if (autoSaveTimer.value) {
+                    clearTimeout(autoSaveTimer.value);
+                }
+                autoSaveTimer.value = setTimeout(() => {
+                    autoSaveSummary();
+                }, autoSaveDelay);
+            });
+        } catch (error) {
+            console.error('Failed to initialize summary markdown editor:', error);
+            editingSummary.value = true;
+        }
+    };
+
+    const autoSaveSummary = async () => {
+        if (summaryMarkdownEditorInstance.value && editingSummary.value) {
+            // Just save the content to the model, don't exit edit mode
+            selectedRecording.value.summary = summaryMarkdownEditorInstance.value.value();
+            // Silently save to backend without changing UI state
+            try {
+                const payload = {
+                    id: selectedRecording.value.id,
+                    title: selectedRecording.value.title,
+                    participants: selectedRecording.value.participants,
+                    notes: selectedRecording.value.notes,
+                    summary: selectedRecording.value.summary,
+                    meeting_date: selectedRecording.value.meeting_date
+                };
+                const response = await fetch('/save', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken.value
+                    },
+                    body: JSON.stringify(payload)
+                });
+                const data = await response.json();
+                if (response.ok && data.recording) {
+                    // Update the HTML rendered versions if they exist
+                    if (data.recording.summary_html) {
+                        selectedRecording.value.summary_html = data.recording.summary_html;
+                    }
+                } else {
+                    console.error('Failed to auto-save summary');
+                }
+            } catch (error) {
+                console.error('Error auto-saving summary:', error);
+            }
+        }
+    };
+
+    const toggleTranscriptionViewMode = () => {
+        transcriptionViewMode.value = transcriptionViewMode.value === 'simple' ? 'bubble' : 'simple';
+        localStorage.setItem('transcriptionViewMode', transcriptionViewMode.value);
+    };
+
+    const toggleEditNotes = () => {
+        editingNotes.value = !editingNotes.value;
+        if (editingNotes.value) {
+            tempNotesContent.value = selectedRecording.value?.notes || '';
+            // Initialize markdown editor when entering edit mode
+            nextTick(() => {
+                initializeMarkdownEditor();
+            });
+        }
+    };
+
+    const cancelEditNotes = () => {
+        if (markdownEditorInstance.value) {
+            markdownEditorInstance.value.toTextArea();
+            markdownEditorInstance.value = null;
+        }
+        editingNotes.value = false;
+        // Restore original content
+        if (selectedRecording.value) {
+            selectedRecording.value.notes = tempNotesContent.value;
+        }
+    };
+
+    const saveEditNotes = async () => {
+        if (markdownEditorInstance.value) {
+            // Get the markdown content from the editor
+            selectedRecording.value.notes = markdownEditorInstance.value.value();
+            markdownEditorInstance.value.toTextArea();
+            markdownEditorInstance.value = null;
+        }
+        editingNotes.value = false;
+        await saveInlineEdit('notes');
+    };
+
+    const initializeMarkdownEditor = () => {
+        if (!notesMarkdownEditor.value) return;
+
+        try {
+            markdownEditorInstance.value = new EasyMDE({
+                element: notesMarkdownEditor.value,
+                spellChecker: false,
+                autofocus: true,
+                placeholder: t('form.enterNotesMarkdown'),
+                initialValue: selectedRecording.value?.notes || '',
+                status: false,
+                toolbar: [
+                    "bold", "italic", "heading", "|",
+                    "quote", "unordered-list", "ordered-list", "|",
+                    "link", "image", "|",
+                    "preview", "side-by-side", "fullscreen"
+                ],
+                previewClass: ["editor-preview", "notes-preview"],
+                theme: isDarkMode.value ? "dark" : "light"
+            });
+
+            // Add auto-save functionality
+            markdownEditorInstance.value.codemirror.on('change', () => {
+                if (autoSaveTimer.value) {
+                    clearTimeout(autoSaveTimer.value);
+                }
+                autoSaveTimer.value = setTimeout(() => {
+                    autoSaveNotes();
+                }, autoSaveDelay);
+            });
+        } catch (error) {
+            console.error('Failed to initialize markdown editor:', error);
+            // Fallback to regular textarea editing
+            editingNotes.value = true;
+        }
+    };
+
+    const autoSaveNotes = async () => {
+        if (markdownEditorInstance.value && editingNotes.value) {
+            // Just save the content to the model, don't exit edit mode
+            selectedRecording.value.notes = markdownEditorInstance.value.value();
+            // Silently save to backend without changing UI state
+            try {
+                const payload = {
+                    id: selectedRecording.value.id,
+                    title: selectedRecording.value.title,
+                    participants: selectedRecording.value.participants,
+                    notes: selectedRecording.value.notes,
+                    summary: selectedRecording.value.summary,
+                    meeting_date: selectedRecording.value.meeting_date
+                };
+                const response = await fetch('/save', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken.value
+                    },
+                    body: JSON.stringify(payload)
+                });
+                const data = await response.json();
+                if (response.ok && data.recording) {
+                    // Update the HTML rendered versions if they exist
+                    if (data.recording.notes_html) {
+                        selectedRecording.value.notes_html = data.recording.notes_html;
+                    }
+                } else {
+                    console.error('Failed to auto-save notes');
+                }
+            } catch (error) {
+                console.error('Error auto-saving notes:', error);
+            }
+        }
+    };
+
+    const clickToEditNotes = () => {
+        // Allow clicking on empty notes area to start editing
+        if (!editingNotes.value && (!selectedRecording.value?.notes || selectedRecording.value.notes.trim() === '')) {
+            toggleEditNotes();
+        }
+    };
+
+    const clickToEditSummary = () => {
+        // Allow clicking on empty summary area to start editing
+        if (!editingSummary.value && (!selectedRecording.value?.summary || selectedRecording.value.summary.trim() === '')) {
+            toggleEditSummary();
+        }
+    };
+
+    const downloadNotes = async () => {
+        if (!selectedRecording.value || !selectedRecording.value.notes) {
+            showToast(t('messages.noNotesAvailableDownload'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            const response = await fetch(`/recording/${selectedRecording.value.id}/download/notes`);
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('messages.notesDownloadFailed'), 'fa-exclamation-circle');
+                return;
+            }
+
+            // Create blob and download
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = `${selectedRecording.value.title || 'notes'}.md`;
+            document.body.appendChild(a);
+            a.click();
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+
+            showToast(t('messages.notesDownloadSuccess'));
+        } catch (error) {
+            showToast(t('messages.notesDownloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    const downloadEventICS = async (event) => {
+        if (!event || !event.id) {
+            showToast(t('messages.invalidEventData'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            const response = await fetch(`/api/event/${event.id}/ics`);
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('messages.eventDownloadFailed'), 'fa-exclamation-circle');
+                return;
+            }
+
+            // Create blob and download
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.style.display = 'none';
+            a.href = url;
+            a.download = `${event.title || 'event'}.ics`;
+            document.body.appendChild(a);
+            a.click();
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+
+            showToast(t('messages.eventDownloadSuccess', { title: event.title }), 'fa-calendar-check', 3000);
+        } catch (error) {
+            console.error('Download failed:', error);
+            showToast(t('messages.eventDownloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    const downloadICS = async () => {
+        if (!selectedRecording.value || !selectedRecording.value.events || selectedRecording.value.events.length === 0) {
+            showToast(t('messages.noEventsToExport'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            const response = await fetch(`/api/recording/${selectedRecording.value.id}/events/ics`);
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('messages.eventsExportFailed'), 'fa-exclamation-circle');
+                return;
+            }
+
+            // Create blob and download
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.style.display = 'none';
+            a.href = url;
+            a.download = `events-${selectedRecording.value.title || selectedRecording.value.id}.ics`;
+            document.body.appendChild(a);
+            a.click();
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+
+            showToast(t('messages.eventsExportSuccess', { count: selectedRecording.value.events.length }), 'fa-calendar-check');
+        } catch (error) {
+            console.error('Download all events ICS error:', error);
+            showToast(t('messages.eventsExportFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    const deleteEvent = async (event) => {
+        if (!event || !event.id) {
+            showToast(t('messages.invalidEventData'), 'fa-exclamation-circle');
+            return;
+        }
+
+        // Confirm deletion
+        if (!confirm(t('events.confirmDelete', { title: event.title }) || `Delete event "${event.title}"?`)) {
+            return;
+        }
+
+        try {
+            const response = await fetch(`/api/event/${event.id}`, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': document.querySelector('meta[name="csrf-token"]')?.content || ''
+                }
+            });
+
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('events.deleteFailed') || 'Failed to delete event', 'fa-exclamation-circle');
+                return;
+            }
+
+            // Remove event from local state
+            if (selectedRecording.value && selectedRecording.value.events) {
+                selectedRecording.value.events = selectedRecording.value.events.filter(e => e.id !== event.id);
+            }
+
+            showToast(t('events.deleted') || 'Event deleted', 'fa-check-circle');
+        } catch (error) {
+            console.error('Delete event failed:', error);
+            showToast(t('events.deleteFailed') || 'Failed to delete event', 'fa-exclamation-circle');
+        }
+    };
+
+    const formatEventDateTime = (dateTimeStr) => {
+        if (!dateTimeStr) return '';
+        try {
+            const date = new Date(dateTimeStr);
+            const options = {
+                weekday: 'short',
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+                hour: '2-digit',
+                minute: '2-digit'
+            };
+            return date.toLocaleString(undefined, options);
+        } catch (e) {
+            return dateTimeStr;
+        }
+    };
+
+    // --- Column Resizing ---
+    const startColumnResize = (event) => {
+        isResizing.value = true;
+        const startX = event.clientX;
+        const startLeftWidth = leftColumnWidth.value;
+
+        const handleMouseMove = (e) => {
+            if (!isResizing.value) return;
+
+            const container = document.getElementById('mainContentColumns');
+            if (!container) return;
+
+            const containerRect = container.getBoundingClientRect();
+            const deltaX = e.clientX - startX;
+            const containerWidth = containerRect.width;
+            const deltaPercent = (deltaX / containerWidth) * 100;
+
+            let newLeftWidth = startLeftWidth + deltaPercent;
+            newLeftWidth = Math.max(20, Math.min(80, newLeftWidth));
+
+            leftColumnWidth.value = newLeftWidth;
+            rightColumnWidth.value = 100 - newLeftWidth;
+        };
+
+        const handleMouseUp = () => {
+            isResizing.value = false;
+            document.removeEventListener('mousemove', handleMouseMove);
+            document.removeEventListener('mouseup', handleMouseUp);
+
+            localStorage.setItem('transcriptColumnWidth', leftColumnWidth.value);
+            localStorage.setItem('summaryColumnWidth', rightColumnWidth.value);
+        };
+
+        document.addEventListener('mousemove', handleMouseMove);
+        document.addEventListener('mouseup', handleMouseUp);
+        event.preventDefault();
+    };
+
+    // --- Audio Player ---
+    const seekAudio = (time, context = 'main') => {
+        let audioPlayer = null;
+        if (context === 'modal') {
+            audioPlayer = document.querySelector('audio.speaker-modal-transcript') || document.querySelector('video.speaker-modal-transcript');
+        } else {
+            audioPlayer = document.querySelector('.main-content-area audio') || document.querySelector('.main-content-area video');
+        }
+
+        if (!audioPlayer) {
+            audioPlayer = document.querySelector('audio') || document.querySelector('video');
+        }
+
+        if (audioPlayer && isFinite(time)) {
+            const wasPlaying = !audioPlayer.paused;
+            try {
+                audioPlayer.currentTime = time;
+                if (wasPlaying) {
+                    audioPlayer.play().catch(e => console.warn('Play after seek failed:', e));
+                }
+            } catch (e) {
+                console.warn('Seek failed:', e);
+            }
+        }
+    };
+
+    const seekAudioFromEvent = (event) => {
+        const segmentElement = event.target.closest('[data-start-time]');
+        if (!segmentElement) return;
+
+        const time = parseFloat(segmentElement.dataset.startTime);
+        if (isNaN(time)) return;
+
+        const isInSpeakerModal = event.target.closest('.speaker-modal-transcript') !== null;
+        const context = isInSpeakerModal ? 'modal' : 'main';
+
+        seekAudio(time, context);
+    };
+
+    const onPlayerVolumeChange = (event) => {
+        const newVolume = event.target.volume;
+        playerVolume.value = newVolume;
+        localStorage.setItem('playerVolume', newVolume);
+    };
+
+    // --- Custom Audio Player Controls ---
+    const getAudioElement = () => {
+        // First check fullscreen overlay (teleported to body)
+        const fullscreenMedia = document.querySelector('.video-fullscreen-overlay video');
+        if (fullscreenMedia) return fullscreenMedia;
+        // Then check for audio/video in visible modals (z-50 class) - these take priority
+        const modalMedia = document.querySelector('.fixed.z-50 audio') || document.querySelector('.fixed.z-50 video');
+        if (modalMedia) {
+            return modalMedia;
+        }
+        // Fall back to main player in right column (desktop) or detail view (mobile)
+        return document.querySelector('#rightMainColumn audio') ||
+               document.querySelector('#rightMainColumn video') ||
+               document.querySelector('.detail-view audio') ||
+               document.querySelector('.detail-view video') ||
+               document.querySelector('audio') ||
+               document.querySelector('video');
+    };
+
+    const toggleAudioPlayback = () => {
+        const audio = getAudioElement();
+        if (!audio) return;
+
+        if (audio.paused) {
+            audio.play();
+        } else {
+            audio.pause();
+        }
+    };
+
+    const toggleAudioMute = () => {
+        const audio = getAudioElement();
+        if (!audio) return;
+
+        audio.muted = !audio.muted;
+        audioIsMuted.value = audio.muted;
+    };
+
+    const setAudioVolume = (volume) => {
+        const audio = getAudioElement();
+        if (!audio) return;
+
+        audio.volume = Math.max(0, Math.min(1, volume));
+        playerVolume.value = audio.volume;
+        localStorage.setItem('playerVolume', audio.volume);
+
+        if (audio.volume === 0) {
+            audio.muted = true;
+            audioIsMuted.value = true;
+        } else if (audio.muted) {
+            audio.muted = false;
+            audioIsMuted.value = false;
+        }
+    };
+
+    const seekAudioTo = (time) => {
+        const audio = getAudioElement();
+        if (!audio || !isFinite(time)) return;
+
+        // Use our tracked duration (server-side) as fallback if browser duration is broken
+        const maxTime = audioDuration.value || (isFinite(audio.duration) ? audio.duration : time);
+        try {
+            audio.currentTime = Math.max(0, Math.min(time, maxTime));
+        } catch (e) {
+            console.warn('Seek failed:', e);
+        }
+    };
+
+    const seekAudioByPercent = (percent) => {
+        const audio = getAudioElement();
+        // Use our tracked duration (server-side) which works for WebM files without duration metadata
+        const dur = audioDuration.value || audio?.duration;
+        if (!audio || !dur || !isFinite(dur)) return;
+
+        const time = (percent / 100) * dur;
+        try {
+            audio.currentTime = time;
+        } catch (e) {
+            console.warn('Seek by percent failed:', e);
+        }
+    };
+
+    // Progress bar drag state
+    const isDraggingProgress = ref(false);
+    const dragPreviewPercent = ref(0);
+
+    // Handle progress bar drag - supports both mouse and touch, only seeks on release
+    const startProgressDrag = (event) => {
+        const bar = event.currentTarget.querySelector('.progress-track') || event.currentTarget.querySelector('.h-2') || event.currentTarget;
+        const rect = bar.getBoundingClientRect();
+        const isTouch = event.type === 'touchstart';
+
+        const getPercent = (evt) => {
+            const clientX = isTouch ? evt.touches[0].clientX : evt.clientX;
+            return Math.max(0, Math.min(100, ((clientX - rect.left) / rect.width) * 100));
+        };
+
+        const getPercentFromEnd = (evt) => {
+            const clientX = isTouch ? evt.changedTouches[0].clientX : evt.clientX;
+            return Math.max(0, Math.min(100, ((clientX - rect.left) / rect.width) * 100));
+        };
+
+        // Start dragging - show preview
+        isDraggingProgress.value = true;
+        dragPreviewPercent.value = getPercent(event);
+
+        const onMove = (evt) => {
+            evt.preventDefault();
+            const clientX = isTouch ? evt.touches[0].clientX : evt.clientX;
+            dragPreviewPercent.value = Math.max(0, Math.min(100, ((clientX - rect.left) / rect.width) * 100));
+        };
+
+        const onUp = (evt) => {
+            document.removeEventListener(isTouch ? 'touchmove' : 'mousemove', onMove);
+            document.removeEventListener(isTouch ? 'touchend' : 'mouseup', onUp);
+            // Seek to final position on release
+            seekAudioByPercent(dragPreviewPercent.value);
+            isDraggingProgress.value = false;
+        };
+
+        document.addEventListener(isTouch ? 'touchmove' : 'mousemove', onMove, { passive: false });
+        document.addEventListener(isTouch ? 'touchend' : 'mouseup', onUp);
+    };
+
+    const handleAudioPlayPause = (event) => {
+        audioIsPlaying.value = !event.target.paused;
+    };
+
+    const handleAudioLoadedMetadata = (event) => {
+        const duration = event.target.duration;
+        // Only set browser duration if we don't already have a server-side duration
+        // Server-side duration (from ffprobe) is more reliable for formats like WebM
+        if (!audioDuration.value || audioDuration.value === 0) {
+            if (duration && isFinite(duration) && duration > 0) {
+                audioDuration.value = duration;
+            }
+        }
+        audioIsLoading.value = false;
+
+        // Apply saved playback rate when audio loads
+        if (playbackRate.value !== 1) {
+            event.target.playbackRate = playbackRate.value;
+        }
+    };
+
+    const handleAudioEnded = () => {
+        audioIsPlaying.value = false;
+        audioCurrentTime.value = 0;
+    };
+
+    const handleCustomAudioTimeUpdate = (event) => {
+        audioCurrentTime.value = event.target.currentTime;
+
+        // Fallback: if duration wasn't set yet, try to get it now
+        if (!audioDuration.value || audioDuration.value === 0) {
+            const duration = event.target.duration;
+            if (duration && isFinite(duration) && duration > 0) {
+                audioDuration.value = duration;
+            }
+        }
+
+        // Also call the existing handler for segment tracking
+        handleAudioTimeUpdate(event);
+    };
+
+    const handleAudioWaiting = () => {
+        audioIsLoading.value = true;
+    };
+
+    const handleAudioCanPlay = (event) => {
+        audioIsLoading.value = false;
+
+        // Fallback: try to get duration if not set yet
+        if (!audioDuration.value || audioDuration.value === 0) {
+            const duration = event.target.duration;
+            if (duration && isFinite(duration) && duration > 0) {
+                audioDuration.value = duration;
+            }
+        }
+    };
+
+    const handleAudioDurationChange = (event) => {
+        // WebM and some other formats may initially report Infinity duration
+        // This handler catches when the actual duration becomes available
+        // Only set if we don't already have a server-side duration
+        if (!audioDuration.value || audioDuration.value === 0) {
+            const duration = event.target.duration;
+            if (duration && isFinite(duration) && duration > 0) {
+                audioDuration.value = duration;
+            }
+        }
+    };
+
+    const formatAudioTime = (seconds) => {
+        if (!seconds || isNaN(seconds)) return '0:00';
+        const mins = Math.floor(seconds / 60);
+        const secs = Math.floor(seconds % 60);
+        return `${mins}:${secs.toString().padStart(2, '0')}`;
+    };
+
+    // --- Playback Speed Control ---
+    const formatPlaybackRate = (rate) => {
+        if (rate === 1) return '1x';
+        if (rate === Math.floor(rate)) return `${rate}x`;
+        return `${rate}x`;
+    };
+
+    const setPlaybackRate = (rate) => {
+        playbackRate.value = rate;
+        localStorage.setItem('playbackRate', rate);
+
+        // Apply to all audio and video elements
+        document.querySelectorAll('audio, video').forEach(el => {
+            el.playbackRate = rate;
+        });
+    };
+
+    const cyclePlaybackRate = () => {
+        const currentIndex = playbackSpeeds.indexOf(playbackRate.value);
+        const nextIndex = (currentIndex + 1) % playbackSpeeds.length;
+        setPlaybackRate(playbackSpeeds[nextIndex]);
+    };
+
+    const cycleModalPlaybackRate = () => {
+        const currentIndex = playbackSpeeds.indexOf(modalPlaybackRate.value);
+        const nextIndex = (currentIndex + 1) % playbackSpeeds.length;
+        modalPlaybackRate.value = playbackSpeeds[nextIndex];
+
+        // Apply to modal audio elements
+        const modalAudio = document.querySelector('.speaker-modal-transcript')?.closest('.fixed')?.querySelector('audio') ||
+                          document.querySelector('.speaker-modal-transcript')?.closest('.fixed')?.querySelector('video') ||
+                          document.querySelector('[ref="speakerModalAudioRef"]') ||
+                          document.querySelector('[ref="asrEditorAudioRef"]');
+        if (modalAudio) {
+            modalAudio.playbackRate = modalPlaybackRate.value;
+        }
+    };
+
+    const initializePlaybackRate = () => {
+        const savedRate = localStorage.getItem('playbackRate');
+        if (savedRate) {
+            const rate = parseFloat(savedRate);
+            if (playbackSpeeds.includes(rate)) {
+                playbackRate.value = rate;
+            }
+        }
+    };
+
+    const updateSpeedMenuPosition = (buttonEl) => {
+        if (!buttonEl) return;
+        const rect = buttonEl.getBoundingClientRect();
+        const menuWidth = 52;
+        const menuMaxHeight = 160;
+        const gap = 4;
+        const safeZone = 60; // Account for header/navbar
+
+        // Check available space above and below
+        const spaceAbove = rect.top - safeZone;
+        const spaceBelow = window.innerHeight - rect.bottom - 8;
+
+        // Decide direction: prefer above, but use below if not enough space
+        const showBelow = spaceAbove < menuMaxHeight && spaceBelow > spaceAbove;
+
+        const right = window.innerWidth - rect.right;
+
+        if (showBelow) {
+            // Position below the button
+            speedMenuPosition.value = {
+                right: `${Math.max(8, right)}px`,
+                top: `${rect.bottom + gap}px`,
+                bottom: 'auto',
+                maxHeight: `${Math.min(menuMaxHeight, spaceBelow)}px`
+            };
+        } else {
+            // Position above the button
+            speedMenuPosition.value = {
+                right: `${Math.max(8, right)}px`,
+                bottom: `${window.innerHeight - rect.top + gap}px`,
+                top: 'auto',
+                maxHeight: `${Math.min(menuMaxHeight, spaceAbove)}px`
+            };
+        }
+    };
+
+    const audioProgressPercent = computed(() => {
+        // Use preview position while dragging for smooth UI
+        if (isDraggingProgress.value) {
+            return dragPreviewPercent.value;
+        }
+        if (!audioDuration.value) return 0;
+        return (audioCurrentTime.value / audioDuration.value) * 100;
+    });
+
+    // Preview time display while dragging
+    const displayCurrentTime = computed(() => {
+        if (isDraggingProgress.value && audioDuration.value) {
+            return (dragPreviewPercent.value / 100) * audioDuration.value;
+        }
+        return audioCurrentTime.value;
+    });
+
+    // Reset audio player state (called when recording changes)
+    const resetAudioPlayerState = () => {
+        audioIsPlaying.value = false;
+        audioCurrentTime.value = 0;
+        audioDuration.value = 0;
+        audioIsMuted.value = false;
+        audioIsLoading.value = false;
+    };
+
+    // --- Active Segment Tracking ---
+
+    // Binary search to find the segment containing the current time
+    // Returns the index of the last segment where startTime <= currentTime
+    // O(log n) instead of O(n) - critical for long transcriptions (4500+ segments)
+    const binarySearchSegment = (segments, currentTime) => {
+        if (segments.length === 0) return null;
+
+        let low = 0;
+        let high = segments.length - 1;
+        let result = null;
+
+        while (low <= high) {
+            const mid = Math.floor((low + high) / 2);
+            const startTime = segments[mid].startTime || segments[mid].start_time;
+
+            if (startTime === undefined) {
+                // Skip segments without timing info
+                high = mid - 1;
+                continue;
+            }
+
+            if (startTime <= currentTime) {
+                result = mid;  // This segment is a candidate
+                low = mid + 1;  // Look for later segments that might also match
+            } else {
+                high = mid - 1;  // Current time is before this segment
+            }
+        }
+
+        return result;
+    };
+
+    const handleAudioTimeUpdate = (event) => {
+        const transcription = processedTranscription.value;
+
+        if (!transcription || !transcription.isJson) {
+            return;
+        }
+
+        const audioElement = event.target;
+        const currentTime = audioElement.currentTime;
+
+        // Find the segment that contains the current time
+        const segments = transcription.simpleSegments || [];
+
+        if (segments.length === 0) {
+            return;
+        }
+
+        // Find the active segment index using binary search - O(log n)
+        const activeIndex = binarySearchSegment(segments, currentTime);
+
+        // Only update if changed
+        if (activeIndex !== currentPlayingSegmentIndex.value) {
+            currentPlayingSegmentIndex.value = activeIndex;
+
+            // Scroll to active segment if follow mode is enabled
+            if (followPlayerMode.value && activeIndex !== null) {
+                scrollToActiveSegment(activeIndex);
+            }
+        }
+    };
+
+    const scrollToActiveSegment = (segmentIndex) => {
+        // Find the active segment element
+        const segments = document.querySelectorAll('.transcript-segment[data-segment-index], .speaker-segment[data-segment-index], .speaker-bubble[data-segment-index]');
+        if (segments[segmentIndex]) {
+            segments[segmentIndex].scrollIntoView({
+                behavior: 'smooth',
+                block: 'center'
+            });
+        }
+    };
+
+    const toggleFollowPlayerMode = () => {
+        followPlayerMode.value = !followPlayerMode.value;
+        localStorage.setItem('followPlayerMode', followPlayerMode.value);
+
+        if (followPlayerMode.value) {
+            showToast(t('messages.followPlayerEnabled'), 'fa-link');
+            // Scroll to current position if we have an active segment
+            if (currentPlayingSegmentIndex.value !== null) {
+                scrollToActiveSegment(currentPlayingSegmentIndex.value);
+            }
+        } else {
+            showToast(t('messages.followPlayerDisabled'), 'fa-unlink');
+        }
+    };
+
+    // --- Video Fullscreen ---
+    const handleFullscreenKeydown = (e) => {
+        if (e.key === 'Escape' || e.key === 'f') {
+            exitVideoFullscreen();
+        } else if (e.key === ' ' || e.key === 'k') {
+            e.preventDefault();
+            toggleAudioPlayback();
+        } else if (e.key === 'ArrowLeft') {
+            e.preventDefault();
+            seekAudioTo(audioCurrentTime.value - 10);
+        } else if (e.key === 'ArrowRight') {
+            e.preventDefault();
+            seekAudioTo(audioCurrentTime.value + 10);
+        } else if (e.key === 'ArrowUp') {
+            e.preventDefault();
+            const audio = getAudioElement();
+            if (audio) setAudioVolume(Math.min(1, audio.volume + 0.1));
+        } else if (e.key === 'ArrowDown') {
+            e.preventDefault();
+            const audio = getAudioElement();
+            if (audio) setAudioVolume(Math.max(0, audio.volume - 0.1));
+        }
+    };
+
+    const resetFullscreenControlsTimer = () => {
+        fullscreenControlsVisible.value = true;
+        if (fullscreenControlsTimer.value) {
+            clearTimeout(fullscreenControlsTimer.value);
+        }
+        fullscreenControlsTimer.value = setTimeout(() => {
+            if (audioIsPlaying.value) {
+                fullscreenControlsVisible.value = false;
+            }
+        }, 3000);
+    };
+
+    const handleFullscreenMouseMove = () => {
+        resetFullscreenControlsTimer();
+    };
+
+    const enterVideoFullscreen = () => {
+        videoFullscreen.value = true;
+        videoCollapsed.value = false;
+        fullscreenControlsVisible.value = true;
+        resetFullscreenControlsTimer();
+        document.addEventListener('keydown', handleFullscreenKeydown);
+        document.body.style.overflow = 'hidden';
+    };
+
+    const exitVideoFullscreen = () => {
+        videoFullscreen.value = false;
+        fullscreenControlsVisible.value = true;
+        if (fullscreenControlsTimer.value) {
+            clearTimeout(fullscreenControlsTimer.value);
+            fullscreenControlsTimer.value = null;
+        }
+        document.removeEventListener('keydown', handleFullscreenKeydown);
+        document.body.style.overflow = '';
+    };
+
+    // --- Copy Functions ---
+    const animateCopyButton = (button) => {
+        if (!button) return;
+        const icon = button.querySelector('i');
+        if (icon) {
+            const originalClass = icon.className;
+            icon.className = 'fas fa-check';
+            setTimeout(() => {
+                icon.className = originalClass;
+            }, 2000);
+        }
+    };
+
+    const fallbackCopyTextToClipboard = (text) => {
+        const textArea = document.createElement('textarea');
+        textArea.value = text;
+        textArea.style.position = 'fixed';
+        textArea.style.left = '-999999px';
+        document.body.appendChild(textArea);
+        textArea.select();
+        try {
+            document.execCommand('copy');
+            showToast(t('messages.copiedSuccessfully'));
+        } catch (err) {
+            showToast(t('messages.copyFailed'), 'fa-exclamation-circle');
+        }
+        document.body.removeChild(textArea);
+    };
+
+    const copyTranscription = (event) => {
+        if (!selectedRecording.value || !selectedRecording.value.transcription) {
+            showToast(t('messages.noTranscriptionToCopy'), 'fa-exclamation-circle');
+            return;
+        }
+
+        const button = event?.currentTarget;
+        let textToCopy = '';
+
+        try {
+            const transcriptionData = JSON.parse(selectedRecording.value.transcription);
+            if (Array.isArray(transcriptionData)) {
+                const wasDiarized = transcriptionData.some(segment => segment.speaker);
+                if (wasDiarized) {
+                    textToCopy = transcriptionData.map(segment => {
+                        return `[${segment.speaker}]: ${segment.text || segment.sentence}`;
+                    }).join('\n');
+                } else {
+                    textToCopy = transcriptionData.map(segment => segment.text || segment.sentence).join('\n');
+                }
+            } else {
+                textToCopy = selectedRecording.value.transcription;
+            }
+        } catch (e) {
+            textToCopy = selectedRecording.value.transcription;
+        }
+
+        animateCopyButton(button);
+
+        if (navigator.clipboard && window.isSecureContext) {
+            navigator.clipboard.writeText(textToCopy)
+                .then(() => showToast(t('messages.transcriptionCopied')))
+                .catch(() => fallbackCopyTextToClipboard(textToCopy));
+        } else {
+            fallbackCopyTextToClipboard(textToCopy);
+        }
+    };
+
+    const copySummary = (event) => {
+        if (!selectedRecording.value || !selectedRecording.value.summary) {
+            showToast(t('messages.noSummaryToCopy'), 'fa-exclamation-circle');
+            return;
+        }
+        const button = event?.currentTarget;
+        animateCopyButton(button);
+
+        if (navigator.clipboard && window.isSecureContext) {
+            navigator.clipboard.writeText(selectedRecording.value.summary)
+                .then(() => showToast(t('messages.summaryCopied')))
+                .catch(() => fallbackCopyTextToClipboard(selectedRecording.value.summary));
+        } else {
+            fallbackCopyTextToClipboard(selectedRecording.value.summary);
+        }
+    };
+
+    const copyNotes = (event) => {
+        if (!selectedRecording.value || !selectedRecording.value.notes) {
+            showToast(t('messages.noNotesToCopy'), 'fa-exclamation-circle');
+            return;
+        }
+        const button = event?.currentTarget;
+        animateCopyButton(button);
+
+        if (navigator.clipboard && window.isSecureContext) {
+            navigator.clipboard.writeText(selectedRecording.value.notes)
+                .then(() => showToast(t('messages.notesCopied')))
+                .catch(() => fallbackCopyTextToClipboard(selectedRecording.value.notes));
+        } else {
+            fallbackCopyTextToClipboard(selectedRecording.value.notes);
+        }
+    };
+
+    // --- Download Functions ---
+    const downloadSummary = async () => {
+        if (!selectedRecording.value || !selectedRecording.value.summary) {
+            showToast(t('messages.noSummaryToDownload'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            const response = await fetch(`/recording/${selectedRecording.value.id}/download/summary`);
+            if (!response.ok) {
+                const error = await response.json();
+                showToast(error.error || t('messages.summaryDownloadFailed'), 'fa-exclamation-circle');
+                return;
+            }
+
+            const blob = await response.blob();
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.style.display = 'none';
+            a.href = url;
+
+            const contentDisposition = response.headers.get('Content-Disposition');
+            let filename = 'summary.docx';
+            if (contentDisposition) {
+                const utf8Match = /filename\*=utf-8''(.+)/.exec(contentDisposition);
+                if (utf8Match) {
+                    filename = decodeURIComponent(utf8Match[1]);
+                } else {
+                    const regularMatch = /filename="(.+)"/.exec(contentDisposition);
+                    if (regularMatch) {
+                        filename = regularMatch[1];
+                    }
+                }
+            }
+            a.download = filename;
+
+            document.body.appendChild(a);
+            a.click();
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+
+            showToast(t('messages.summaryDownloadSuccess'));
+        } catch (error) {
+            showToast(t('messages.summaryDownloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    const downloadTranscript = async () => {
+        if (!selectedRecording.value || !selectedRecording.value.transcription) {
+            showToast(t('messages.noTranscriptionToDownload'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            // First, fetch available templates
+            const templatesResponse = await fetch('/api/transcript-templates');
+            let templates = [];
+            if (templatesResponse.ok) {
+                templates = await templatesResponse.json();
+            }
+
+            // If there are templates, show a selection dialog
+            let templateId = null;
+            if (templates.length > 0) {
+                // Create a simple modal for template selection
+                const modal = document.createElement('div');
+                modal.className = 'fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50';
+                modal.innerHTML = `
+                    <div class="bg-[var(--bg-secondary)] rounded-lg p-6 max-w-md w-full mx-4">
+                        <h3 class="text-lg font-semibold mb-4">${t('transcriptTemplates.selectTemplate')}</h3>
+                        <div class="space-y-2 max-h-60 overflow-y-auto">
+                            ${templates.map(tmpl => `
+                                <button class="template-option w-full text-left p-3 rounded border border-[var(--border-primary)] hover:bg-[var(--bg-tertiary)] ${tmpl.is_default ? 'ring-2 ring-[var(--ring-focus)]' : ''}" data-template-id="${tmpl.id}">
+                                    <div class="font-medium">${tmpl.name}</div>
+                                    ${tmpl.description ? `<div class="text-sm text-[var(--text-muted)]">${tmpl.description}</div>` : ''}
+                                    ${tmpl.is_default ? `<div class="text-xs text-[var(--text-accent)] mt-1"><i class="fas fa-star mr-1"></i>${t('transcriptTemplates.default')}</div>` : ''}
+                                </button>
+                            `).join('')}
+                        </div>
+                        <div class="mt-4 flex gap-2">
+                            <button class="cancel-btn px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded hover:bg-[var(--bg-accent-light)]">${t('transcriptTemplates.cancel')}</button>
+                            <button class="download-without-template-btn px-4 py-2 bg-[var(--bg-accent)] text-white rounded hover:bg-[var(--bg-accent-hover)]">${t('transcriptTemplates.downloadWithoutTemplate')}</button>
+                        </div>
+                    </div>
+                `;
+                document.body.appendChild(modal);
+
+                // Wait for user selection
+                await new Promise((resolve) => {
+                    modal.querySelectorAll('.template-option').forEach(btn => {
+                        btn.addEventListener('click', () => {
+                            templateId = btn.dataset.templateId;
+                            modal.remove();
+                            resolve();
+                        });
+                    });
+
+                    modal.querySelector('.cancel-btn').addEventListener('click', () => {
+                        templateId = 'cancelled';
+                        modal.remove();
+                        resolve();
+                    });
+
+                    modal.querySelector('.download-without-template-btn').addEventListener('click', () => {
+                        templateId = 'none';
+                        modal.remove();
+                        resolve();
+                    });
+
+                    modal.addEventListener('click', (e) => {
+                        if (e.target === modal) {
+                            templateId = 'cancelled';
+                            modal.remove();
+                            resolve();
+                        }
+                    });
+                });
+
+                if (templateId === null || templateId === undefined || templateId === 'cancelled') {
+                    return;
+                }
+            }
+
+            // If templateId is 'none', download raw transcript without any template
+            if (templateId === 'none') {
+                let rawText = '';
+                try {
+                    const transcriptionData = JSON.parse(selectedRecording.value.transcription);
+                    if (Array.isArray(transcriptionData)) {
+                        rawText = transcriptionData.map(segment => {
+                            const speaker = segment.speaker || 'Unknown';
+                            const text = segment.sentence || '';
+                            return `${speaker}: ${text}`;
+                        }).join('\n');
+                    } else {
+                        rawText = selectedRecording.value.transcription;
+                    }
+                } catch (e) {
+                    rawText = selectedRecording.value.transcription;
+                }
+
+                const blob = new Blob([rawText], { type: 'text/plain;charset=utf-8' });
+                const downloadUrl = URL.createObjectURL(blob);
+                const a = document.createElement('a');
+                a.href = downloadUrl;
+                a.download = `${selectedRecording.value.title || 'transcript'}_raw.txt`;
+                document.body.appendChild(a);
+                a.click();
+                document.body.removeChild(a);
+                URL.revokeObjectURL(downloadUrl);
+
+                showToast(t('messages.transcriptDownloadSuccess'));
+                return;
+            }
+
+            // Download the transcript with the selected template
+            const url = templateId
+                ? `/recording/${selectedRecording.value.id}/download/transcript?template_id=${templateId}`
+                : `/recording/${selectedRecording.value.id}/download/transcript`;
+
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(t('messages.transcriptDownloadFailed'));
+            }
+
+            const blob = await response.blob();
+            const contentDisposition = response.headers.get('content-disposition');
+            let filename = 'transcript.txt';
+            if (contentDisposition) {
+                const matches = contentDisposition.match(/filename="([^"]+)"/);
+                if (matches && matches[1]) {
+                    filename = matches[1];
+                }
+            }
+
+            const downloadUrl = URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = downloadUrl;
+            a.download = filename;
+            document.body.appendChild(a);
+            a.click();
+            document.body.removeChild(a);
+            URL.revokeObjectURL(downloadUrl);
+
+            showToast(t('messages.transcriptDownloadSuccess'));
+        } catch (error) {
+            console.error('Error downloading transcript:', error);
+            showToast(t('messages.transcriptDownloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    // Download with default template (no modal)
+    const downloadWithDefaultTemplate = async () => {
+        if (!selectedRecording.value || !selectedRecording.value.transcription) {
+            showToast(t('messages.noTranscriptionToDownload'), 'fa-exclamation-circle');
+            return;
+        }
+
+        try {
+            // Download using the default template (server will use user's default)
+            const response = await fetch(`/recording/${selectedRecording.value.id}/download/transcript`);
+            if (!response.ok) {
+                throw new Error(t('messages.transcriptDownloadFailed'));
+            }
+
+            const blob = await response.blob();
+            const contentDisposition = response.headers.get('content-disposition');
+            let filename = 'transcript.txt';
+            if (contentDisposition) {
+                const matches = contentDisposition.match(/filename="([^"]+)"/);
+                if (matches && matches[1]) {
+                    filename = matches[1];
+                }
+            }
+
+            const downloadUrl = URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = downloadUrl;
+            a.download = filename;
+            document.body.appendChild(a);
+            a.click();
+            document.body.removeChild(a);
+            URL.revokeObjectURL(downloadUrl);
+
+            showToast(t('messages.transcriptDownloadSuccess'));
+        } catch (error) {
+            console.error('Error downloading transcript:', error);
+            showToast(t('messages.transcriptDownloadFailed'), 'fa-exclamation-circle');
+        }
+    };
+
+    // Show template selector modal (reuses the modal from downloadTranscript)
+    const showTemplateSelector = async () => {
+        // This calls the full downloadTranscript which shows the modal
+        await downloadTranscript();
+    };
+
+    // Initialize UI settings from localStorage
+    const initializeUI = () => {
+        // Load saved column widths
+        const savedLeftWidth = localStorage.getItem('transcriptColumnWidth');
+        const savedRightWidth = localStorage.getItem('summaryColumnWidth');
+        if (savedLeftWidth && savedRightWidth) {
+            leftColumnWidth.value = parseFloat(savedLeftWidth);
+            rightColumnWidth.value = parseFloat(savedRightWidth);
+        }
+
+        // Load saved transcription view mode
+        const savedViewMode = localStorage.getItem('transcriptionViewMode');
+        if (savedViewMode) {
+            transcriptionViewMode.value = savedViewMode;
+        }
+
+        // Load saved player volume
+        const savedVolume = localStorage.getItem('playerVolume');
+        if (savedVolume) {
+            playerVolume.value = parseFloat(savedVolume);
+        }
+
+        // Load saved follow player mode
+        const savedFollowMode = localStorage.getItem('followPlayerMode');
+        if (savedFollowMode !== null) {
+            followPlayerMode.value = savedFollowMode === 'true';
+        }
+
+        // Load saved playback rate
+        initializePlaybackRate();
+
+        // Watch for recording changes to reset active segment and audio player state
+        watch(selectedRecording, (newRecording) => {
+            if (videoFullscreen.value) exitVideoFullscreen();
+            currentPlayingSegmentIndex.value = null;
+            resetAudioPlayerState();
+            // Use server-side duration if available (more reliable than browser metadata)
+            if (newRecording && newRecording.audio_duration) {
+                audioDuration.value = newRecording.audio_duration;
+            }
+        });
+
+        // Set up global click handler to close dropdowns when clicking outside
+        setupGlobalClickHandler();
+    };
+
+    /**
+     * Set up a global click handler to close all dropdowns when clicking outside
+     * This provides elegant UX by closing menus when users click elsewhere
+     */
+    const setupGlobalClickHandler = () => {
+        document.addEventListener('click', (event) => {
+            const target = event.target;
+
+            // Close user menu if clicking outside of it
+            if (isUserMenuOpen.value) {
+                const userMenuButton = target.closest('[data-user-menu-toggle]');
+                const userMenuDropdown = target.closest('[data-user-menu-dropdown]');
+
+                if (!userMenuButton && !userMenuDropdown) {
+                    isUserMenuOpen.value = false;
+                }
+            }
+
+            // Close sort options if clicking outside
+            if (showSortOptions.value) {
+                const sortButton = target.closest('[data-sort-toggle]');
+                const sortDropdown = target.closest('[data-sort-dropdown]');
+
+                if (!sortButton && !sortDropdown) {
+                    showSortOptions.value = false;
+                }
+            }
+
+            // Close download menu if clicking outside
+            if (showDownloadMenu.value) {
+                const downloadButton = target.closest('[data-download-toggle]');
+                const downloadDropdown = target.closest('[data-download-dropdown]');
+
+                if (!downloadButton && !downloadDropdown) {
+                    showDownloadMenu.value = false;
+                }
+            }
+
+            // Close language menu if clicking outside
+            if (state.showLanguageMenu && state.showLanguageMenu.value) {
+                const languageButton = target.closest('[data-language-toggle]');
+                const languageDropdown = target.closest('[data-language-dropdown]');
+
+                if (!languageButton && !languageDropdown) {
+                    state.showLanguageMenu.value = false;
+                }
+            }
+
+            // Close speed menu if clicking outside
+            if (showSpeedMenu.value) {
+                const speedButton = target.closest('[data-speed-toggle]');
+                const speedDropdown = target.closest('[data-speed-dropdown]');
+
+                if (!speedButton && !speedDropdown) {
+                    showSpeedMenu.value = false;
+                }
+            }
+        });
+    };
+
+    // Initialize recording notes markdown editor
+    const initializeRecordingNotesEditor = () => {
+        if (!recordingNotesEditor.value) return;
+
+        // Destroy existing instance if any
+        if (recordingMarkdownEditorInstance.value) {
+            recordingMarkdownEditorInstance.value.toTextArea();
+            recordingMarkdownEditorInstance.value = null;
+        }
+
+        try {
+            recordingMarkdownEditorInstance.value = new EasyMDE({
+                element: recordingNotesEditor.value,
+                spellChecker: false,
+                autofocus: false,
+                placeholder: t('form.enterNotesMarkdown'),
+                initialValue: recordingNotes.value || '',
+                status: false,
+                toolbar: [
+                    "bold", "italic", "heading", "|",
+                    "quote", "unordered-list", "ordered-list", "|",
+                    "link", "|",
+                    "preview", "side-by-side", "fullscreen"
+                ],
+                previewClass: ["editor-preview", "notes-preview"],
+                theme: isDarkMode.value ? "dark" : "light"
+            });
+
+            // Sync changes back to recordingNotes
+            recordingMarkdownEditorInstance.value.codemirror.on('change', () => {
+                recordingNotes.value = recordingMarkdownEditorInstance.value.value();
+            });
+        } catch (error) {
+            console.error('Failed to initialize recording notes markdown editor:', error);
+        }
+    };
+
+    // Destroy recording notes markdown editor
+    const destroyRecordingNotesEditor = () => {
+        if (recordingMarkdownEditorInstance.value) {
+            // Save current value before destroying
+            recordingNotes.value = recordingMarkdownEditorInstance.value.value();
+            recordingMarkdownEditorInstance.value.toTextArea();
+            recordingMarkdownEditorInstance.value = null;
+        }
+    };
+
+    // =========================================
+    // Participants Modal
+    // =========================================
+
+    const openParticipantsModal = async () => {
+        if (!selectedRecording.value) return;
+
+        // Parse current participants into array
+        const participants = selectedRecording.value.participants
+            ? selectedRecording.value.participants.split(',').map(p => p.trim()).filter(Boolean)
+            : [];
+
+        state.editingParticipantsList.value = participants.map(name => ({ name }));
+
+        // Fetch speakers from database for autocomplete
+        try {
+            const response = await fetch('/speakers');
+            if (response.ok) {
+                const speakers = await response.json();
+                state.allParticipants.value = speakers.map(s => s.name).sort();
+            }
+        } catch (e) {
+            console.error('Failed to fetch speakers:', e);
+            state.allParticipants.value = [];
+        }
+
+        state.editingParticipantSuggestions.value = {};
+        state.showEditParticipantsModal.value = true;
+    };
+
+    const closeEditParticipantsModal = () => {
+        state.showEditParticipantsModal.value = false;
+        state.editingParticipantsList.value = [];
+    };
+
+    const addParticipant = () => {
+        state.editingParticipantsList.value.push({ name: '' });
+    };
+
+    const removeParticipant = (index) => {
+        state.editingParticipantsList.value.splice(index, 1);
+        delete state.editingParticipantSuggestions.value[index];
+    };
+
+    const filterParticipantSuggestions = (index) => {
+        // Close all other dropdowns first
+        closeAllParticipantSuggestions();
+
+        const query = state.editingParticipantsList.value[index]?.name?.toLowerCase().trim() || '';
+        if (query === '') {
+            // Show all participants when field is empty/focused
+            state.editingParticipantSuggestions.value[index] = [...state.allParticipants.value];
+        } else {
+            state.editingParticipantSuggestions.value[index] = state.allParticipants.value.filter(
+                p => p.toLowerCase().includes(query)
+            );
+        }
+    };
+
+    const selectParticipantSuggestion = (index, name) => {
+        state.editingParticipantsList.value[index].name = name;
+        state.editingParticipantSuggestions.value[index] = [];
+    };
+
+    const closeParticipantSuggestions = (index) => {
+        state.editingParticipantSuggestions.value[index] = [];
+    };
+
+    const closeParticipantSuggestionsDelayed = (index) => {
+        setTimeout(() => closeParticipantSuggestions(index), 200);
+    };
+
+    const closeAllParticipantSuggestions = () => {
+        state.editingParticipantSuggestions.value = {};
+    };
+
+    const getParticipantDropdownPosition = (index) => {
+        // Find the input element for this index and calculate position
+        const inputs = document.querySelectorAll('.max-w-md input[placeholder="' + t('form.participantNamePlaceholder') + '"]');
+        if (inputs[index]) {
+            const rect = inputs[index].getBoundingClientRect();
+            return {
+                top: rect.bottom + 2 + 'px',
+                left: rect.left + 'px',
+                width: rect.width + 'px'
+            };
+        }
+        return { top: '0px', left: '0px', width: '200px' };
+    };
+
+    const saveParticipants = async () => {
+        if (!selectedRecording.value) return;
+
+        // Join participant names with comma
+        const participantsString = state.editingParticipantsList.value
+            .map(p => p.name.trim())
+            .filter(Boolean)
+            .join(', ');
+
+        // Update the recording
+        selectedRecording.value.participants = participantsString;
+
+        // Use the same save endpoint as inline editing
+        const fullPayload = {
+            id: selectedRecording.value.id,
+            title: selectedRecording.value.title,
+            participants: selectedRecording.value.participants,
+            notes: selectedRecording.value.notes,
+            summary: selectedRecording.value.summary,
+            meeting_date: selectedRecording.value.meeting_date
+        };
+
+        try {
+            const response = await fetch('/save', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken.value
+                },
+                body: JSON.stringify(fullPayload)
+            });
+
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || t('messages.failedToSaveParticipants'));
+
+            showToast(t('common.changesSaved'), 'fa-check-circle');
+            closeEditParticipantsModal();
+        } catch (error) {
+            console.error('Save error:', error);
+            utils.setGlobalError(t('messages.saveParticipantsFailed', { error: error.message }));
+        }
+    };
+
+    return {
+        // Initialization
+        initializeUI,
+        toggleDarkMode,
+        initializeDarkMode,
+        applyColorScheme,
+        initializeColorScheme,
+        openColorSchemeModal,
+        closeColorSchemeModal,
+        selectColorScheme,
+        resetColorScheme,
+        toggleSidebar,
+        initializeSidebar,
+        switchToUploadView,
+        switchToDetailView,
+        switchToRecordingView,
+        setGlobalError,
+        formatFileSize,
+        formatDisplayDate,
+        formatShortDate,
+        formatStatus,
+        getStatusClass,
+        formatTime,
+        formatDuration,
+        formatProcessingDuration,
+        // Inline editing
+        toggleEditTitle,
+        saveTitle,
+        cancelEditTitle,
+        regenerateTitle,
+        toggleEditParticipants,
+        toggleEditMeetingDate,
+        toggleEditSummary,
+        cancelEditSummary,
+        saveEditSummary,
+        initializeSummaryMarkdownEditor,
+        autoSaveSummary,
+        toggleEditNotes,
+        cancelEditNotes,
+        saveEditNotes,
+        initializeMarkdownEditor,
+        autoSaveNotes,
+        clickToEditNotes,
+        clickToEditSummary,
+        // Recording notes editor
+        initializeRecordingNotesEditor,
+        destroyRecordingNotesEditor,
+        downloadNotes,
+        downloadEventICS,
+        downloadICS,
+        deleteEvent,
+        formatEventDateTime,
+        // View mode
+        toggleTranscriptionViewMode,
+        // Column resizing
+        startColumnResize,
+        // Audio player
+        seekAudio,
+        seekAudioFromEvent,
+        onPlayerVolumeChange,
+        handleAudioTimeUpdate,
+        toggleFollowPlayerMode,
+        scrollToActiveSegment,
+        // Custom audio player
+        toggleAudioPlayback,
+        toggleAudioMute,
+        setAudioVolume,
+        seekAudioTo,
+        seekAudioByPercent,
+        startProgressDrag,
+        handleAudioPlayPause,
+        handleAudioLoadedMetadata,
+        handleAudioEnded,
+        handleCustomAudioTimeUpdate,
+        handleAudioWaiting,
+        handleAudioCanPlay,
+        handleAudioDurationChange,
+        formatAudioTime,
+        audioProgressPercent,
+        displayCurrentTime,
+        isDraggingProgress,
+        audioIsPlaying,
+        audioCurrentTime,
+        audioDuration,
+        audioIsMuted,
+        audioIsLoading,
+        resetAudioPlayerState,
+        // Playback speed
+        formatPlaybackRate,
+        setPlaybackRate,
+        cyclePlaybackRate,
+        cycleModalPlaybackRate,
+        updateSpeedMenuPosition,
+        // Video fullscreen
+        enterVideoFullscreen,
+        exitVideoFullscreen,
+        handleFullscreenMouseMove,
+        resetFullscreenControlsTimer,
+        // Copy functions
+        copyTranscription,
+        copySummary,
+        copyNotes,
+        // Download functions
+        downloadSummary,
+        downloadTranscript,
+        downloadWithDefaultTemplate,
+        showTemplateSelector,
+        // Participants modal
+        openParticipantsModal,
+        closeEditParticipantsModal,
+        addParticipant,
+        removeParticipant,
+        filterParticipantSuggestions,
+        selectParticipantSuggestion,
+        closeParticipantSuggestions,
+        closeParticipantSuggestionsDelayed,
+        closeAllParticipantSuggestions,
+        getParticipantDropdownPosition,
+        saveParticipants,
+        // Computed
+        isMobile
+    };
+}
diff --git a/static/js/modules/composables/upload.js b/static/js/modules/composables/upload.js
new file mode 100644
index 00000000..77f54564
--- /dev/null
+++ b/static/js/modules/composables/upload.js
@@ -0,0 +1,837 @@
+/**
+ * Upload management composable
+ * Handles file uploads, queue processing, and progress tracking
+ */
+
+import * as FailedUploads from '../db/failed-uploads.js';
+import * as IncognitoStorage from '../db/incognito-storage.js';
+
+// Parse error message and return friendly error info
+function getFriendlyError(errorMessage, t) {
+    const _t = t || ((key) => key);
+    if (!errorMessage) return { title: _t('errors.processingError'), message: _t('errors.processingErrorMessage') };
+    const lowerText = errorMessage.toLowerCase();
+    const patterns = [
+        { patterns: ['maximum content size limit', 'file too large', '413', 'payload too large', 'exceeded'], title: _t('errors.fileTooLargeTitle'), guidance: _t('errors.enableChunkingGuidance') },
+        { patterns: ['timed out', 'timeout', 'deadline exceeded'], title: _t('errors.processingTimeout'), guidance: _t('errors.splitAudioGuidance') },
+        { patterns: ['401', 'unauthorized', 'invalid api key', 'authentication failed', 'incorrect api key'], title: _t('errors.authenticationError'), guidance: _t('errors.checkApiKeyGuidance') },
+        { patterns: ['rate limit', 'too many requests', '429', 'quota exceeded'], title: _t('errors.rateLimitExceeded'), guidance: _t('errors.waitAndRetryGuidance') },
+        { patterns: ['connection refused', 'connection reset', 'could not connect', 'network unreachable'], title: _t('errors.connectionError'), guidance: _t('errors.checkNetworkGuidance') },
+        { patterns: ['503', '502', '500', 'service unavailable', 'server error', 'internal server error'], title: _t('errors.serviceUnavailable'), guidance: _t('errors.tryAgainLaterGuidance') },
+        { patterns: ['invalid file format', 'unsupported format', 'could not decode', 'corrupt'], title: _t('errors.invalidAudioFormat'), guidance: _t('errors.convertFormatGuidance') },
+        { patterns: ['audio extraction failed', 'ffmpeg failed', 'no audio stream'], title: _t('errors.audioExtractionFailed'), guidance: _t('errors.convertStandardGuidance') },
+    ];
+    for (const pattern of patterns) {
+        for (const p of pattern.patterns) {
+            if (lowerText.includes(p)) return { title: pattern.title, guidance: pattern.guidance };
+        }
+    }
+    return { title: _t('errors.processingError'), guidance: _t('errors.processingErrorFallbackGuidance') };
+}
+
+export function useUpload(state, utils) {
+    const {
+        uploadQueue, currentlyProcessingFile, processingProgress, processingMessage,
+        isProcessingActive, pollInterval, progressPopupMinimized, progressPopupClosed,
+        maxFileSizeMB, chunkingEnabled, chunkingMode, chunkingLimit, maxConcurrentUploads,
+        recordings, selectedRecording, totalRecordings, globalError,
+        selectedTagIds, uploadLanguage, uploadMinSpeakers, uploadMaxSpeakers, uploadHotwords, uploadInitialPrompt, uploadTranscriptionModel, uploadPromptVariables, transcriptionModelOptions,
+        useAsrEndpoint, connectorSupportsDiarization, asrLanguage, asrMinSpeakers, asrMaxSpeakers,
+        dragover, availableTags, uploadTagSearchFilter,
+        // Folder state
+        availableFolders, selectedFolderId,
+        // Incognito mode state
+        incognitoMode, incognitoRecording, incognitoProcessing,
+        // View state
+        currentView,
+        // Upload disclaimer state
+        uploadDisclaimer, showUploadDisclaimerModal
+    } = state;
+
+    const { computed, nextTick, ref } = Vue;
+
+    const { setGlobalError, showToast, formatFileSize, onChatComplete, t } = utils;
+
+    // Compute selected tags from IDs
+    const selectedTags = computed(() => {
+        return selectedTagIds.value.map(id =>
+            availableTags.value.find(t => t.id === id)
+        ).filter(Boolean);
+    });
+
+    // --- Tag Drag-and-Drop State ---
+    const draggedTagIndex = ref(null);
+    const dragOverTagIndex = ref(null);
+
+    // Reorder selectedTagIds array
+    const reorderSelectedTags = (fromIndex, toIndex) => {
+        const tagIds = [...selectedTagIds.value];
+        const [removed] = tagIds.splice(fromIndex, 1);
+        tagIds.splice(toIndex, 0, removed);
+        selectedTagIds.value = tagIds;
+        applyTagDefaults(); // Re-apply defaults since first tag may have changed
+    };
+
+    // === MOUSE DRAG HANDLERS ===
+    const handleTagDragStart = (index, event) => {
+        draggedTagIndex.value = index;
+        event.dataTransfer.effectAllowed = 'move';
+        event.dataTransfer.setData('text/plain', index.toString());
+    };
+
+    const handleTagDragOver = (index, event) => {
+        event.preventDefault();
+        event.dataTransfer.dropEffect = 'move';
+        dragOverTagIndex.value = index;
+    };
+
+    const handleTagDrop = (targetIndex, event) => {
+        event.preventDefault();
+        if (draggedTagIndex.value !== null && draggedTagIndex.value !== targetIndex) {
+            reorderSelectedTags(draggedTagIndex.value, targetIndex);
+        }
+        draggedTagIndex.value = null;
+        dragOverTagIndex.value = null;
+    };
+
+    const handleTagDragEnd = () => {
+        draggedTagIndex.value = null;
+        dragOverTagIndex.value = null;
+    };
+
+    // === TOUCH HANDLERS (Mobile) ===
+    let touchStartIndex = null;
+
+    const handleTagTouchStart = (index, event) => {
+        touchStartIndex = index;
+        draggedTagIndex.value = index;
+    };
+
+    const handleTagTouchMove = (event) => {
+        if (touchStartIndex === null) return;
+        event.preventDefault();
+
+        const touch = event.touches[0];
+        const elementBelow = document.elementFromPoint(touch.clientX, touch.clientY);
+        const tagElement = elementBelow?.closest('[data-tag-index]');
+
+        if (tagElement) {
+            const targetIndex = parseInt(tagElement.dataset.tagIndex);
+            dragOverTagIndex.value = targetIndex;
+        }
+    };
+
+    const handleTagTouchEnd = () => {
+        if (touchStartIndex !== null && dragOverTagIndex.value !== null &&
+            touchStartIndex !== dragOverTagIndex.value) {
+            reorderSelectedTags(touchStartIndex, dragOverTagIndex.value);
+        }
+        touchStartIndex = null;
+        draggedTagIndex.value = null;
+        dragOverTagIndex.value = null;
+    };
+
+    // Handle drag events
+    const handleDragOver = (e) => {
+        e.preventDefault();
+        dragover.value = true;
+    };
+
+    const handleDragLeave = (e) => {
+        if (e.relatedTarget && e.currentTarget.contains(e.relatedTarget)) {
+            return;
+        }
+        dragover.value = false;
+    };
+
+    const handleDrop = (e) => {
+        e.preventDefault();
+        dragover.value = false;
+        addFilesToQueue(e.dataTransfer.files);
+    };
+
+    const handleFileSelect = (e) => {
+        addFilesToQueue(e.target.files);
+        e.target.value = null;
+    };
+
+    // Add files to the upload queue
+    const addFilesToQueue = (files) => {
+        let filesAdded = 0;
+        for (const file of files) {
+            const fileObject = file.file ? file.file : file;
+            const notes = file.notes || null;
+            const tags = file.tags || selectedTags.value || [];
+            const asrOptions = file.asrOptions || {
+                language: asrLanguage.value,
+                min_speakers: asrMinSpeakers.value,
+                max_speakers: asrMaxSpeakers.value
+            };
+
+            // Check if it's an audio file or video container with audio
+            const isAudioFile = fileObject && (
+                fileObject.type.startsWith('audio/') ||
+                fileObject.type === 'video/mp4' ||
+                fileObject.type === 'video/quicktime' ||
+                fileObject.type === 'video/x-msvideo' ||
+                fileObject.type === 'video/webm' ||
+                fileObject.name.toLowerCase().endsWith('.amr') ||
+                fileObject.name.toLowerCase().endsWith('.3gp') ||
+                fileObject.name.toLowerCase().endsWith('.3gpp') ||
+                fileObject.name.toLowerCase().endsWith('.mp4') ||
+                fileObject.name.toLowerCase().endsWith('.mov') ||
+                fileObject.name.toLowerCase().endsWith('.avi') ||
+                fileObject.name.toLowerCase().endsWith('.mkv') ||
+                fileObject.name.toLowerCase().endsWith('.webm') ||
+                fileObject.name.toLowerCase().endsWith('.weba')
+            );
+
+            if (isAudioFile) {
+                // Only check general file size limit
+                if (fileObject.size > maxFileSizeMB.value * 1024 * 1024) {
+                    setGlobalError(t('upload.fileExceedsMaxSize', { name: fileObject.name, size: maxFileSizeMB.value }));
+                    continue;
+                }
+
+                const clientId = `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+
+                uploadQueue.value.push({
+                    file: fileObject,
+                    notes: notes,
+                    tags: tags,
+                    asrOptions: asrOptions,
+                    status: 'queued',
+                    recordingId: null,
+                    clientId: clientId,
+                    error: null,
+                    willAutoSummarize: false // Server will tell us via SUMMARIZING status
+                });
+                filesAdded++;
+            } else if (fileObject) {
+                setGlobalError(t('upload.invalidFileType', { name: fileObject.name }));
+            }
+        }
+        if (filesAdded > 0) {
+            console.log(`Added ${filesAdded} file(s) to the queue.`);
+        }
+    };
+
+    // Remove a file from the queue before processing starts
+    const removeFromQueue = (clientId) => {
+        const index = uploadQueue.value.findIndex(item => item.clientId === clientId);
+        if (index !== -1 && (uploadQueue.value[index].status === 'queued' || uploadQueue.value[index].status === 'ready')) {
+            uploadQueue.value.splice(index, 1);
+            console.log(`Removed file from queue: ${clientId}`);
+        }
+    };
+
+    // Cancel a waiting file from the upload progress queue
+    const cancelWaitingFile = (clientId) => {
+        const index = uploadQueue.value.findIndex(item => item.clientId === clientId);
+        if (index !== -1 && uploadQueue.value[index].status === 'ready') {
+            uploadQueue.value.splice(index, 1);
+            console.log(`Cancelled waiting file: ${clientId}`);
+            showToast(t('upload.fileRemovedFromQueue'), 'fa-trash');
+        }
+    };
+
+    // Clear completed uploads from queue
+    const clearCompletedUploads = () => {
+        uploadQueue.value = uploadQueue.value.filter(item => !['completed', 'failed'].includes(item.status));
+    };
+
+    // Start processing all queued files
+    const startUpload = () => {
+        const pendingFiles = uploadQueue.value.filter(item => item.status === 'queued');
+        if (pendingFiles.length === 0) {
+            return;
+        }
+        // Show upload disclaimer if configured
+        if (uploadDisclaimer.value && uploadDisclaimer.value.trim() !== '') {
+            showUploadDisclaimerModal.value = true;
+            return;
+        }
+        // Update all queued files with current tags and ASR options
+        // AND change their status to 'ready' so they move to upload progress immediately
+        for (const item of uploadQueue.value) {
+            if (item.status === 'queued') {
+                if (!item.preserveOptions) {
+                    // For file uploads: use current UI selection (user may have changed tags after dropping)
+                    item.tags = [...selectedTags.value];
+                    item.asrOptions = {
+                        language: asrLanguage.value,
+                        min_speakers: asrMinSpeakers.value,
+                        max_speakers: asrMaxSpeakers.value,
+                        hotwords: uploadHotwords.value,
+                        initial_prompt: uploadInitialPrompt.value,
+                        transcription_model: uploadTranscriptionModel.value,
+                        prompt_variables: { ...uploadPromptVariables },
+                    };
+                    item.folder_id = selectedFolderId.value;
+                }
+                // Change status to 'ready' to remove from upload view but keep in queue
+                item.status = 'ready';
+            }
+        }
+        progressPopupMinimized.value = false;
+        progressPopupClosed.value = false;
+        startProcessingQueue();
+    };
+
+    // --- Parallel Upload System ---
+    // Concurrency limiter: configurable via MAX_CONCURRENT_UPLOADS env var (default 3)
+    let activeUploadCount = 0;
+    const pendingUploadQueue = []; // Functions waiting for a slot
+
+    const acquireUploadSlot = () => {
+        return new Promise(resolve => {
+            if (activeUploadCount < (maxConcurrentUploads?.value || 3)) {
+                activeUploadCount++;
+                resolve();
+            } else {
+                pendingUploadQueue.push(resolve);
+            }
+        });
+    };
+
+    const releaseUploadSlot = () => {
+        activeUploadCount--;
+        if (pendingUploadQueue.length > 0) {
+            activeUploadCount++;
+            const next = pendingUploadQueue.shift();
+            next();
+        }
+        // When all uploads are done, clear processing active flag
+        const stillUploading = uploadQueue.value.some(item =>
+            ['uploading', 'ready'].includes(item.status)
+        );
+        if (!stillUploading) {
+            isProcessingActive.value = false;
+        }
+    };
+
+    const resetCurrentFileProcessingState = () => {
+        if (pollInterval.value) clearInterval(pollInterval.value);
+        pollInterval.value = null;
+        currentlyProcessingFile.value = null;
+        processingProgress.value = 0;
+        processingMessage.value = '';
+    };
+
+    /**
+     * Upload a single file to the server.
+     * Acquires a concurrency slot, uploads, then releases.
+     * Status updates are per-item (no global processingProgress).
+     */
+    const uploadSingleFile = async (fileItem) => {
+        await acquireUploadSlot();
+
+        fileItem.status = 'uploading';
+        fileItem.progress = 5;
+
+        try {
+            const formData = new FormData();
+            formData.append('file', fileItem.file);
+
+            // Send file's lastModified timestamp for meeting_date
+            if (fileItem.file.lastModified) {
+                const lastModified = fileItem.file.lastModified;
+                formData.append('file_last_modified', lastModified.toString());
+            }
+
+            if (fileItem.notes) {
+                formData.append('notes', fileItem.notes);
+            }
+
+            // Add tags if selected
+            const tagsToUse = fileItem.tags || selectedTags.value || [];
+            tagsToUse.forEach((tag, index) => {
+                const tagId = tag.id || tag;
+                formData.append(`tag_ids[${index}]`, tagId);
+            });
+
+            // Add folder if selected
+            const folderToUse = fileItem.folder_id || selectedFolderId.value;
+            if (folderToUse) {
+                formData.append('folder_id', folderToUse);
+            }
+
+            // Add ASR options
+            const asrOpts = fileItem.asrOptions || {};
+            const language = asrOpts.language || uploadLanguage.value;
+            if (language) {
+                formData.append('language', language);
+            }
+
+            if (connectorSupportsDiarization.value) {
+                const minSpeakers = asrOpts.min_speakers || uploadMinSpeakers.value;
+                const maxSpeakers = asrOpts.max_speakers || uploadMaxSpeakers.value;
+
+                if (minSpeakers && minSpeakers !== '') {
+                    formData.append('min_speakers', minSpeakers.toString());
+                }
+                if (maxSpeakers && maxSpeakers !== '') {
+                    formData.append('max_speakers', maxSpeakers.toString());
+                }
+            }
+
+            // Add hotwords and initial prompt
+            const hotwords = asrOpts.hotwords || uploadHotwords.value;
+            const initialPrompt = asrOpts.initial_prompt || uploadInitialPrompt.value;
+            if (hotwords && hotwords.trim()) {
+                formData.append('hotwords', hotwords.trim());
+            }
+            if (initialPrompt && initialPrompt.trim()) {
+                formData.append('initial_prompt', initialPrompt.trim());
+            }
+
+            // Per-upload model override (issue #266)
+            const transcriptionModel = asrOpts.transcription_model || uploadTranscriptionModel.value;
+            if (transcriptionModel && transcriptionModel.trim()) {
+                formData.append('transcription_model', transcriptionModel.trim());
+            }
+
+            // Per-recording prompt template variables (issue #253). Carry the
+            // values either from a queued item's saved options or from the
+            // current upload-form state. The server sanitises before storing.
+            const promptVariables = asrOpts.prompt_variables || uploadPromptVariables;
+            if (promptVariables && typeof promptVariables === 'object') {
+                const cleaned = {};
+                for (const [key, value] of Object.entries(promptVariables)) {
+                    if (value !== undefined && value !== null && String(value).trim() !== '') {
+                        cleaned[key] = String(value);
+                    }
+                }
+                if (Object.keys(cleaned).length > 0) {
+                    formData.append('prompt_variables', JSON.stringify(cleaned));
+                }
+            }
+
+            // Use XMLHttpRequest for per-file upload progress
+            const data = await new Promise((resolve, reject) => {
+                const xhr = new XMLHttpRequest();
+
+                xhr.upload.onprogress = (e) => {
+                    if (e.lengthComputable) {
+                        // Map upload progress to 5-90% range
+                        fileItem.progress = Math.round(5 + (e.loaded / e.total) * 85);
+                    }
+                };
+
+                xhr.onload = () => {
+                    const contentType = xhr.getResponseHeader('content-type') || '';
+                    if (!contentType.includes('application/json')) {
+                        const titleMatch = xhr.responseText.match(/<title>([^<]+)<\/title>/i);
+                        const h1Match = xhr.responseText.match(/<h1>([^<]+)<\/h1>/i);
+                        reject(new Error(titleMatch?.[1] || h1Match?.[1] ||
+                            `Server error (${xhr.status}): Response was not JSON`));
+                        return;
+                    }
+
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(xhr.responseText);
+                    } catch {
+                        reject(new Error(`Invalid JSON response (${xhr.status})`));
+                        return;
+                    }
+
+                    if (xhr.status === 202 && parsed.id) {
+                        resolve(parsed);
+                    } else if (!String(xhr.status).startsWith('2')) {
+                        let errorMsg = parsed.error || `Upload failed with status ${xhr.status}`;
+                        if (xhr.status === 413) errorMsg = parsed.error || `File too large. Max: ${parsed.max_size_mb?.toFixed(0) || maxFileSizeMB.value} MB.`;
+                        reject(new Error(errorMsg));
+                    } else {
+                        reject(new Error('Unexpected success response from server after upload.'));
+                    }
+                };
+
+                xhr.onerror = () => reject(new Error('Network error during upload'));
+                xhr.ontimeout = () => reject(new Error('Upload timed out'));
+
+                // Store abort controller on item for cancellation
+                fileItem._xhr = xhr;
+
+                xhr.open('POST', '/upload');
+                // Include CSRF token (required for POST requests)
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                if (csrfToken) {
+                    xhr.setRequestHeader('X-CSRFToken', csrfToken);
+                }
+                xhr.send(formData);
+            });
+
+            // Upload succeeded - recording is now on the server
+            console.log(`File ${fileItem.file.name} uploaded. Recording ID: ${data.id}. Server will process via job queue.`);
+            fileItem.status = 'pending';
+            fileItem.recordingId = data.id;
+            fileItem.progress = 100;
+
+            // Add to recordings list
+            recordings.value.unshift(data);
+            totalRecordings.value++;
+
+            // Handle duplicate warning
+            if (data.duplicate_warning) {
+                const warning = data.duplicate_warning;
+                const existingDate = warning.existing_created_at
+                    ? new Date(warning.existing_created_at).toLocaleDateString()
+                    : '';
+                const existingName = warning.existing_title || 'Unknown';
+                showToast(
+                    `⚠️ ${existingName} (${existingDate})`,
+                    'fa-copy'
+                );
+                fileItem.duplicateWarning = warning;
+            }
+
+        } catch (error) {
+            console.error(`Upload Error for ${fileItem.file.name} (Client ID: ${fileItem.clientId}):`, error);
+            fileItem.status = 'failed';
+            fileItem.error = error.message;
+            fileItem.progress = 0;
+
+            // Show friendly error message
+            const friendlyErr = getFriendlyError(error.message, t);
+            setGlobalError(`${friendlyErr.title}: ${friendlyErr.guidance}`);
+
+            // Store failed upload in IndexedDB for background sync retry
+            try {
+                await FailedUploads.storeFailedUpload({
+                    file: fileItem.file,
+                    fileName: fileItem.file.name,
+                    fileSize: fileItem.file.size,
+                    clientId: fileItem.clientId,
+                    notes: fileItem.notes,
+                    tags: fileItem.tags,
+                    asrOptions: fileItem.asrOptions,
+                    error: error.message
+                });
+
+                if ('serviceWorker' in navigator && 'sync' in ServiceWorkerRegistration.prototype) {
+                    const registration = await navigator.serviceWorker.ready;
+                    await registration.sync.register('sync-uploads');
+                    console.log('[Upload] Registered background sync for failed upload');
+                }
+            } catch (syncError) {
+                console.warn('[Upload] Failed to register background sync:', syncError);
+            }
+        } finally {
+            fileItem._xhr = null;
+            releaseUploadSlot();
+        }
+    };
+
+    /**
+     * Start uploading all ready files in parallel (with concurrency limit).
+     * Processing status is tracked via allJobs polling in app.modular.js.
+     */
+    const startProcessingQueue = async () => {
+        const readyItems = uploadQueue.value.filter(item => item.status === 'ready');
+        if (readyItems.length === 0) {
+            console.log("No files ready to upload.");
+            return;
+        }
+
+        isProcessingActive.value = true;
+        console.log(`Starting parallel upload of ${readyItems.length} file(s) (max ${maxConcurrentUploads?.value || 3} concurrent)...`);
+
+        // Fire off all uploads concurrently (semaphore handles limiting)
+        const uploadPromises = readyItems.map(item => uploadSingleFile(item));
+        // Don't await - let them run in background. isProcessingActive is cleared by releaseUploadSlot.
+        Promise.allSettled(uploadPromises).then(() => {
+            console.log('All uploads settled.');
+        });
+    };
+
+    // Keep backward-compat aliases
+    const startStatusPolling = (fileItem, recordingId) => {
+        // No longer needed - allJobs polling handles status tracking
+        fileItem.recordingId = recordingId;
+    };
+
+    const pollProcessingStatus = () => {
+        // No-op: status tracking is now handled by allJobs polling in app.modular.js
+    };
+
+    // Tag selection helpers
+    const addTagToSelection = (tagId) => {
+        if (!selectedTagIds.value.includes(tagId)) {
+            selectedTagIds.value.push(tagId);
+            applyTagDefaults();
+        }
+    };
+
+    const removeTagFromSelection = (tagId) => {
+        const index = selectedTagIds.value.indexOf(tagId);
+        if (index > -1) {
+            selectedTagIds.value.splice(index, 1);
+            applyTagDefaults();
+        }
+    };
+
+    const applyTagDefaults = () => {
+        const selectedTagsObjects = selectedTagIds.value.map(tagId =>
+            availableTags.value.find(tag => tag.id == tagId)
+        ).filter(Boolean);
+
+        const firstTag = selectedTagsObjects[0];
+        if (firstTag && connectorSupportsDiarization.value) {
+            if (firstTag.default_language) {
+                uploadLanguage.value = firstTag.default_language;
+            }
+            if (firstTag.default_min_speakers) {
+                uploadMinSpeakers.value = firstTag.default_min_speakers;
+            }
+            if (firstTag.default_max_speakers) {
+                uploadMaxSpeakers.value = firstTag.default_max_speakers;
+            }
+        }
+        // Apply hotwords/initial_prompt from first tag (works for all connectors)
+        if (firstTag) {
+            if (firstTag.default_hotwords) {
+                uploadHotwords.value = firstTag.default_hotwords;
+            }
+            if (firstTag.default_initial_prompt) {
+                uploadInitialPrompt.value = firstTag.default_initial_prompt;
+            }
+        }
+    };
+
+    // Computed property for filtered available tags in upload view
+    const filteredAvailableTagsForUpload = computed(() => {
+        const availableForSelection = availableTags.value.filter(tag => !selectedTagIds.value.includes(tag.id));
+        if (!uploadTagSearchFilter.value) return availableForSelection;
+
+        const filter = uploadTagSearchFilter.value.toLowerCase();
+        return availableForSelection.filter(tag =>
+            tag.name.toLowerCase().includes(filter)
+        );
+    });
+
+    // === INCOGNITO MODE FUNCTIONS ===
+
+    /**
+     * Upload and process a file in incognito mode.
+     * The file is processed synchronously and no data is saved to the database.
+     * Results are stored only in sessionStorage.
+     */
+    const startIncognitoUpload = async () => {
+        const pendingFiles = uploadQueue.value.filter(item => item.status === 'queued');
+        if (pendingFiles.length === 0) {
+            return;
+        }
+
+        // Only process the first file for incognito mode
+        const fileItem = pendingFiles[0];
+
+        // Check if incognito mode state is available
+        if (!incognitoMode || !incognitoProcessing || !incognitoRecording) {
+            console.warn('[Incognito] Incognito state not available, falling back to normal upload');
+            startUpload();
+            return;
+        }
+
+        incognitoProcessing.value = true;
+        processingMessage.value = t('incognito.processingInProgress');
+        processingProgress.value = 10;
+        progressPopupMinimized.value = false;
+        progressPopupClosed.value = false;
+
+        try {
+            const formData = new FormData();
+            formData.append('file', fileItem.file);
+
+            // Add ASR options
+            const asrOpts = fileItem.asrOptions || {};
+            const language = asrOpts.language || uploadLanguage.value;
+            const minSpeakers = asrOpts.min_speakers || uploadMinSpeakers.value;
+            const maxSpeakers = asrOpts.max_speakers || uploadMaxSpeakers.value;
+
+            if (language) {
+                formData.append('language', language);
+            }
+            if (minSpeakers && minSpeakers !== '') {
+                formData.append('min_speakers', minSpeakers.toString());
+            }
+            if (maxSpeakers && maxSpeakers !== '') {
+                formData.append('max_speakers', maxSpeakers.toString());
+            }
+
+            const hotwords = asrOpts.hotwords || uploadHotwords.value;
+            const initialPrompt = asrOpts.initial_prompt || uploadInitialPrompt.value;
+            if (hotwords && hotwords.trim()) {
+                formData.append('hotwords', hotwords.trim());
+            }
+            if (initialPrompt && initialPrompt.trim()) {
+                formData.append('initial_prompt', initialPrompt.trim());
+            }
+            const incogModel = asrOpts.transcription_model || uploadTranscriptionModel.value;
+            if (incogModel && incogModel.trim()) {
+                formData.append('transcription_model', incogModel.trim());
+            }
+
+            // Request auto-summarization
+            formData.append('auto_summarize', 'true');
+
+            processingMessage.value = t('incognito.uploadingFile');
+            processingProgress.value = 20;
+
+            console.log('[Incognito] Uploading file:', fileItem.file.name);
+
+            const response = await fetch('/api/recordings/incognito', {
+                method: 'POST',
+                body: formData
+            });
+
+            processingProgress.value = 50;
+
+            // Parse response
+            const contentType = response.headers.get('content-type') || '';
+            if (!contentType.includes('application/json')) {
+                const text = await response.text();
+                const titleMatch = text.match(/<title>([^<]+)<\/title>/i);
+                throw new Error(titleMatch?.[1] || `Server error (${response.status})`);
+            }
+
+            const data = await response.json();
+
+            if (!response.ok || data.error) {
+                throw new Error(data.error || `Processing failed with status ${response.status}`);
+            }
+
+            processingProgress.value = 80;
+            processingMessage.value = t('incognito.processingComplete');
+
+            // Store result in sessionStorage
+            const incognitoData = {
+                id: 'incognito',
+                incognito: true,
+                title: data.title || t('incognito.recordingTitle'),
+                transcription: data.transcription,
+                summary: data.summary,
+                summary_html: data.summary_html,
+                created_at: data.created_at,
+                original_filename: data.original_filename,
+                file_size: data.file_size,
+                audio_duration_seconds: data.audio_duration_seconds,
+                processing_time_seconds: data.processing_time_seconds,
+                status: 'COMPLETED'
+            };
+
+            IncognitoStorage.saveIncognitoRecording(incognitoData);
+            incognitoRecording.value = incognitoData;
+
+            // Remove the processed file from queue
+            const index = uploadQueue.value.findIndex(item => item.clientId === fileItem.clientId);
+            if (index !== -1) {
+                uploadQueue.value.splice(index, 1);
+            }
+
+            processingProgress.value = 100;
+            processingMessage.value = t('incognito.recordingReady');
+
+            // Auto-select the incognito recording and switch to detail view
+            selectedRecording.value = incognitoData;
+            currentView.value = 'detail';
+
+            // Show toast
+            showToast(t('incognito.recordingProcessed'), 'fa-user-secret');
+
+            console.log('[Incognito] Processing complete');
+
+        } catch (error) {
+            console.error('[Incognito] Processing failed:', error);
+            const friendlyErr = getFriendlyError(error.message, t);
+            setGlobalError(`${friendlyErr.title}: ${friendlyErr.guidance}`);
+            fileItem.status = 'failed';
+            fileItem.error = error.message;
+        } finally {
+            incognitoProcessing.value = false;
+            processingProgress.value = 0;
+            processingMessage.value = '';
+        }
+    };
+
+    /**
+     * Clear the incognito recording with confirmation
+     */
+    const clearIncognitoRecordingWithConfirm = () => {
+        if (incognitoRecording && incognitoRecording.value) {
+            if (confirm(t('incognito.discardConfirm'))) {
+                IncognitoStorage.clearIncognitoRecording();
+                incognitoRecording.value = null;
+                // If the incognito recording was selected, clear selection
+                if (selectedRecording.value?.id === 'incognito') {
+                    selectedRecording.value = null;
+                }
+                showToast(t('incognito.recordingDiscarded'), 'fa-trash');
+            }
+        }
+    };
+
+    /**
+     * Select the incognito recording for viewing
+     */
+    const selectIncognitoRecording = () => {
+        if (incognitoRecording && incognitoRecording.value) {
+            selectedRecording.value = incognitoRecording.value;
+            currentView.value = 'detail';
+        }
+    };
+
+    /**
+     * Load incognito recording from sessionStorage on app init
+     */
+    const loadIncognitoRecording = () => {
+        const stored = IncognitoStorage.getIncognitoRecording();
+        if (stored && incognitoRecording) {
+            incognitoRecording.value = stored;
+            console.log('[Incognito] Loaded recording from sessionStorage');
+        }
+    };
+
+    /**
+     * Check if there's an incognito recording (for navigation guards)
+     */
+    const hasIncognitoRecording = () => {
+        return IncognitoStorage.hasIncognitoRecording();
+    };
+
+    return {
+        handleDragOver,
+        handleDragLeave,
+        handleDrop,
+        handleFileSelect,
+        addFilesToQueue,
+        removeFromQueue,
+        cancelWaitingFile,
+        clearCompletedUploads,
+        startUpload,
+        startProcessingQueue,
+        resetCurrentFileProcessingState,
+        startStatusPolling,
+        pollProcessingStatus,
+        addTagToSelection,
+        removeTagFromSelection,
+        applyTagDefaults,
+        filteredAvailableTagsForUpload,
+        // Tag drag-and-drop
+        draggedTagIndex,
+        dragOverTagIndex,
+        handleTagDragStart,
+        handleTagDragOver,
+        handleTagDrop,
+        handleTagDragEnd,
+        handleTagTouchStart,
+        handleTagTouchMove,
+        handleTagTouchEnd,
+        // Incognito mode
+        startIncognitoUpload,
+        clearIncognitoRecordingWithConfirm,
+        selectIncognitoRecording,
+        loadIncognitoRecording,
+        hasIncognitoRecording
+    };
+}
diff --git a/static/js/modules/composables/virtualScroll.js b/static/js/modules/composables/virtualScroll.js
new file mode 100644
index 00000000..620feed2
--- /dev/null
+++ b/static/js/modules/composables/virtualScroll.js
@@ -0,0 +1,204 @@
+/**
+ * Virtual Scrolling Composable
+ *
+ * Renders only visible items plus a buffer for smooth scrolling.
+ * Critical for handling long transcriptions (4500+ segments) without UI lag.
+ *
+ * Usage:
+ *   const { visibleItems, spacerBefore, spacerAfter, onScroll, scrollToIndex } = useVirtualScroll({
+ *       items: segmentsRef,
+ *       itemHeight: 48,
+ *       containerRef: scrollContainerRef,
+ *       overscan: 5
+ *   });
+ */
+
+export function useVirtualScroll(options) {
+    const { ref, computed, watch, onMounted, onUnmounted } = Vue;
+
+    const {
+        items,              // Ref to the full array of items
+        itemHeight = 48,    // Height of each item in pixels (fixed height mode)
+        containerRef,       // Ref to the scrollable container element
+        overscan = 5,       // Number of items to render outside viewport
+        keyField = null     // Optional field to use for unique keys
+    } = options;
+
+    // Internal state
+    const scrollTop = ref(0);
+    const containerHeight = ref(0);
+    const isInitialized = ref(false);
+
+    // Calculate visible range based on scroll position
+    const visibleRange = computed(() => {
+        if (!isInitialized.value || !items.value) {
+            return { start: 0, end: Math.min(20, items.value?.length || 0) };
+        }
+
+        const totalItems = items.value.length;
+        if (totalItems === 0) {
+            return { start: 0, end: 0 };
+        }
+
+        // Calculate first visible item
+        const firstVisible = Math.floor(scrollTop.value / itemHeight);
+
+        // Calculate number of items that fit in viewport
+        const visibleCount = Math.ceil(containerHeight.value / itemHeight);
+
+        // Add overscan for smooth scrolling
+        const start = Math.max(0, firstVisible - overscan);
+        const end = Math.min(totalItems, firstVisible + visibleCount + overscan);
+
+        return { start, end };
+    });
+
+    // Slice of items to actually render
+    const visibleItems = computed(() => {
+        if (!items.value || items.value.length === 0) {
+            return [];
+        }
+
+        const { start, end } = visibleRange.value;
+
+        // Map items with their original indices for proper data binding
+        return items.value.slice(start, end).map((item, localIndex) => ({
+            ...item,
+            _virtualIndex: start + localIndex,
+            _originalIndex: start + localIndex
+        }));
+    });
+
+    // Spacer height before visible items (for scroll position)
+    const spacerBefore = computed(() => {
+        return visibleRange.value.start * itemHeight;
+    });
+
+    // Spacer height after visible items
+    const spacerAfter = computed(() => {
+        if (!items.value) return 0;
+        const remainingItems = items.value.length - visibleRange.value.end;
+        return Math.max(0, remainingItems * itemHeight);
+    });
+
+    // Total height of all items (for scroll container)
+    const totalHeight = computed(() => {
+        if (!items.value) return 0;
+        return items.value.length * itemHeight;
+    });
+
+    // Handle scroll events
+    const onScroll = (event) => {
+        scrollTop.value = event.target.scrollTop;
+    };
+
+    // Initialize container height observer
+    let resizeObserver = null;
+
+    const initializeContainer = () => {
+        if (!containerRef.value) return;
+
+        // Get initial height
+        containerHeight.value = containerRef.value.clientHeight;
+        isInitialized.value = true;
+
+        // Watch for container size changes
+        resizeObserver = new ResizeObserver((entries) => {
+            for (const entry of entries) {
+                containerHeight.value = entry.contentRect.height;
+            }
+        });
+        resizeObserver.observe(containerRef.value);
+    };
+
+    // Scroll to a specific index
+    const scrollToIndex = (index, behavior = 'smooth') => {
+        if (!containerRef.value || !items.value) return;
+
+        const targetIndex = Math.max(0, Math.min(index, items.value.length - 1));
+        const targetScrollTop = targetIndex * itemHeight;
+
+        containerRef.value.scrollTo({
+            top: targetScrollTop,
+            behavior
+        });
+    };
+
+    // Scroll to make an index visible (centered if possible)
+    const scrollToIndexIfNeeded = (index) => {
+        if (!containerRef.value || !items.value) return;
+
+        const { start, end } = visibleRange.value;
+
+        // Check if index is already visible (with some margin)
+        if (index >= start + overscan && index < end - overscan) {
+            return; // Already visible
+        }
+
+        // Center the index in the viewport
+        const targetIndex = Math.max(0, index - Math.floor(containerHeight.value / itemHeight / 2));
+        scrollToIndex(targetIndex, 'smooth');
+    };
+
+    // Reset scroll state (call when modal opens or items change completely)
+    const reset = () => {
+        scrollTop.value = 0;
+        isInitialized.value = false;
+        // Re-initialize after a tick to allow DOM to render
+        Vue.nextTick(() => {
+            if (containerRef.value) {
+                containerRef.value.scrollTop = 0;
+                initializeContainer();
+            }
+        });
+    };
+
+    // Watch for containerRef changes and initialize
+    watch(containerRef, (newRef) => {
+        if (newRef) {
+            initializeContainer();
+        }
+    }, { immediate: true });
+
+    // Cleanup on unmount
+    onUnmounted(() => {
+        if (resizeObserver) {
+            resizeObserver.disconnect();
+        }
+    });
+
+    return {
+        // Data
+        visibleItems,
+        visibleRange,
+
+        // Spacer heights for virtual scroll container
+        spacerBefore,
+        spacerAfter,
+        totalHeight,
+
+        // Event handlers
+        onScroll,
+
+        // Navigation
+        scrollToIndex,
+        scrollToIndexIfNeeded,
+
+        // Control
+        reset,
+
+        // State (for debugging/testing)
+        scrollTop,
+        containerHeight,
+        isInitialized
+    };
+}
+
+/**
+ * Helper to generate a unique key for virtual scroll items
+ */
+export function getVirtualItemKey(item, prefix = 'vs') {
+    const index = item._originalIndex ?? item._virtualIndex ?? 0;
+    const time = item.startTime ?? item.start_time ?? '';
+    return `${prefix}-${index}-${time}`;
+}
diff --git a/static/js/modules/computed/index.js b/static/js/modules/computed/index.js
new file mode 100644
index 00000000..f9464da2
--- /dev/null
+++ b/static/js/modules/computed/index.js
@@ -0,0 +1,26 @@
+/**
+ * Computed properties module exports
+ *
+ * Note: These computed properties are defined inline in the main app.js
+ * due to their tight coupling with reactive state. This module serves as
+ * a placeholder for future extraction if needed.
+ */
+
+// Computed properties that could be extracted:
+// - filteredRecordings
+// - groupedRecordings
+// - highlightedTranscript
+// - activeRecordingMetadata
+// - identifiedSpeakers
+// - processedTranscription
+// - totalInQueue
+// - completedInQueue
+// - finishedFilesInQueue
+// - isMobileScreen
+// - datePresetOptions
+// - languageOptions
+// - tagsWithCustomPrompts
+// - filteredAvailableTagsForModal
+// - isMobileDevice
+
+export default {};
diff --git a/static/js/modules/db/failed-uploads.js b/static/js/modules/db/failed-uploads.js
new file mode 100644
index 00000000..9d4cf581
--- /dev/null
+++ b/static/js/modules/db/failed-uploads.js
@@ -0,0 +1,268 @@
+/**
+ * IndexedDB Failed Uploads Storage
+ * Handles storing and retrying failed uploads with background sync
+ */
+
+const DB_NAME = 'SpeakrFailedUploads';
+const DB_VERSION = 1;
+const STORE_NAME = 'failedUploads';
+
+let dbInstance = null;
+
+/**
+ * Initialize IndexedDB
+ */
+export const initDB = () => {
+    return new Promise((resolve, reject) => {
+        if (dbInstance) {
+            resolve(dbInstance);
+            return;
+        }
+
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+
+        request.onerror = () => {
+            console.error('[FailedUploadsDB] Failed to open database:', request.error);
+            reject(request.error);
+        };
+
+        request.onsuccess = () => {
+            dbInstance = request.result;
+            console.log('[FailedUploadsDB] Database opened successfully');
+            resolve(dbInstance);
+        };
+
+        request.onupgradeneeded = (event) => {
+            const db = event.target.result;
+
+            // Create object store for failed uploads
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                const objectStore = db.createObjectStore(STORE_NAME, { keyPath: 'id', autoIncrement: true });
+                objectStore.createIndex('timestamp', 'timestamp', { unique: false });
+                objectStore.createIndex('clientId', 'clientId', { unique: false });
+                console.log('[FailedUploadsDB] Object store created');
+            }
+        };
+    });
+};
+
+/**
+ * Store a failed upload for later retry
+ */
+export const storeFailedUpload = async (uploadData) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const failedUpload = {
+            timestamp: Date.now(),
+            clientId: uploadData.clientId || `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,
+            fileName: uploadData.file?.name || uploadData.fileName || 'unknown',
+            fileSize: uploadData.file?.size || uploadData.fileSize || 0,
+            notes: uploadData.notes || '',
+            tags: uploadData.tags || [],
+            asrOptions: uploadData.asrOptions || {},
+            retryCount: uploadData.retryCount || 0,
+            lastError: uploadData.error || '',
+            fileData: uploadData.fileData || null, // ArrayBuffer of file
+            mimeType: uploadData.file?.type || uploadData.mimeType || 'audio/webm'
+        };
+
+        // Convert File to ArrayBuffer if needed
+        if (uploadData.file && !failedUpload.fileData) {
+            failedUpload.fileData = await uploadData.file.arrayBuffer();
+        }
+
+        const request = objectStore.add(failedUpload);
+
+        return new Promise((resolve, reject) => {
+            request.onsuccess = () => {
+                console.log('[FailedUploadsDB] Upload stored for retry:', failedUpload.fileName);
+                resolve(request.result); // Returns the ID
+            };
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to store upload:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error storing failed upload:', error);
+        throw error;
+    }
+};
+
+/**
+ * Get all failed uploads waiting to retry
+ */
+export const getFailedUploads = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readonly');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.getAll();
+
+            request.onsuccess = () => {
+                console.log(`[FailedUploadsDB] Retrieved ${request.result.length} failed uploads`);
+                resolve(request.result);
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to retrieve uploads:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error getting failed uploads:', error);
+        return [];
+    }
+};
+
+/**
+ * Get a specific failed upload by ID
+ */
+export const getFailedUpload = async (id) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readonly');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.get(id);
+
+            request.onsuccess = () => {
+                resolve(request.result);
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to get upload:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error getting failed upload:', error);
+        return null;
+    }
+};
+
+/**
+ * Update retry count for a failed upload
+ */
+export const updateRetryCount = async (id, retryCount, error = null) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const upload = await getFailedUpload(id);
+        if (!upload) {
+            console.warn('[FailedUploadsDB] Upload not found for retry count update');
+            return;
+        }
+
+        upload.retryCount = retryCount;
+        upload.lastRetry = Date.now();
+        if (error) {
+            upload.lastError = error;
+        }
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.put(upload);
+
+            request.onsuccess = () => {
+                console.log(`[FailedUploadsDB] Updated retry count for upload ${id}: ${retryCount}`);
+                resolve();
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to update retry count:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error updating retry count:', error);
+    }
+};
+
+/**
+ * Delete a failed upload (after successful retry)
+ */
+export const deleteFailedUpload = async (id) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.delete(id);
+
+            request.onsuccess = () => {
+                console.log('[FailedUploadsDB] Deleted successful upload:', id);
+                resolve();
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to delete upload:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error deleting failed upload:', error);
+    }
+};
+
+/**
+ * Clear all failed uploads
+ */
+export const clearAllFailedUploads = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.clear();
+
+            request.onsuccess = () => {
+                console.log('[FailedUploadsDB] Cleared all failed uploads');
+                resolve();
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to clear uploads:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error clearing failed uploads:', error);
+    }
+};
+
+/**
+ * Get count of failed uploads
+ */
+export const getFailedUploadCount = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readonly');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        return new Promise((resolve, reject) => {
+            const request = objectStore.count();
+
+            request.onsuccess = () => {
+                resolve(request.result);
+            };
+
+            request.onerror = () => {
+                console.error('[FailedUploadsDB] Failed to count uploads:', request.error);
+                reject(request.error);
+            };
+        });
+    } catch (error) {
+        console.error('[FailedUploadsDB] Error counting failed uploads:', error);
+        return 0;
+    }
+};
diff --git a/static/js/modules/db/incognito-storage.js b/static/js/modules/db/incognito-storage.js
new file mode 100644
index 00000000..4f44f6f4
--- /dev/null
+++ b/static/js/modules/db/incognito-storage.js
@@ -0,0 +1,76 @@
+/**
+ * Incognito Mode storage utilities
+ * Uses sessionStorage for temporary storage that auto-clears when tab closes
+ */
+
+const INCOGNITO_KEY = 'speakr_incognito_recording';
+
+/**
+ * Save incognito recording data to sessionStorage
+ * @param {Object} data - Recording data including transcription, summary, title
+ */
+export function saveIncognitoRecording(data) {
+    try {
+        sessionStorage.setItem(INCOGNITO_KEY, JSON.stringify(data));
+        console.log('[Incognito] Recording saved to sessionStorage');
+    } catch (e) {
+        console.error('[Incognito] Failed to save recording:', e);
+    }
+}
+
+/**
+ * Get incognito recording data from sessionStorage
+ * @returns {Object|null} Recording data or null if not found
+ */
+export function getIncognitoRecording() {
+    try {
+        const data = sessionStorage.getItem(INCOGNITO_KEY);
+        return data ? JSON.parse(data) : null;
+    } catch (e) {
+        console.error('[Incognito] Failed to retrieve recording:', e);
+        return null;
+    }
+}
+
+/**
+ * Clear incognito recording from sessionStorage
+ */
+export function clearIncognitoRecording() {
+    try {
+        sessionStorage.removeItem(INCOGNITO_KEY);
+        console.log('[Incognito] Recording cleared from sessionStorage');
+    } catch (e) {
+        console.error('[Incognito] Failed to clear recording:', e);
+    }
+}
+
+/**
+ * Check if an incognito recording exists
+ * @returns {boolean}
+ */
+export function hasIncognitoRecording() {
+    try {
+        return sessionStorage.getItem(INCOGNITO_KEY) !== null;
+    } catch (e) {
+        return false;
+    }
+}
+
+/**
+ * Update specific fields of the incognito recording
+ * @param {Object} updates - Fields to update
+ */
+export function updateIncognitoRecording(updates) {
+    try {
+        const existing = getIncognitoRecording();
+        if (existing) {
+            const updated = { ...existing, ...updates };
+            saveIncognitoRecording(updated);
+            return updated;
+        }
+        return null;
+    } catch (e) {
+        console.error('[Incognito] Failed to update recording:', e);
+        return null;
+    }
+}
diff --git a/static/js/modules/db/recording-persistence.js b/static/js/modules/db/recording-persistence.js
new file mode 100644
index 00000000..ccfc1199
--- /dev/null
+++ b/static/js/modules/db/recording-persistence.js
@@ -0,0 +1,267 @@
+/**
+ * IndexedDB Recording Persistence
+ * Handles saving recording chunks to IndexedDB for crash recovery
+ */
+
+const DB_NAME = 'SpeakrRecordings';
+const DB_VERSION = 1;
+const STORE_NAME = 'activeRecording';
+
+let dbInstance = null;
+
+/**
+ * Helper to promisify IDBRequest
+ */
+const promisifyRequest = (request) => {
+    return new Promise((resolve, reject) => {
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error);
+    });
+};
+
+/**
+ * Initialize IndexedDB
+ */
+export const initDB = () => {
+    return new Promise((resolve, reject) => {
+        if (dbInstance) {
+            resolve(dbInstance);
+            return;
+        }
+
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+
+        request.onerror = () => {
+            console.error('[RecordingDB] Failed to open database:', request.error);
+            reject(request.error);
+        };
+
+        request.onsuccess = () => {
+            dbInstance = request.result;
+            console.log('[RecordingDB] Database opened successfully');
+            resolve(dbInstance);
+        };
+
+        request.onupgradeneeded = (event) => {
+            const db = event.target.result;
+
+            // Create object store for active recording
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                const objectStore = db.createObjectStore(STORE_NAME, { keyPath: 'id' });
+                objectStore.createIndex('timestamp', 'timestamp', { unique: false });
+                console.log('[RecordingDB] Object store created');
+            }
+        };
+    });
+};
+
+/**
+ * Save recording metadata and initialize session
+ */
+export const startRecordingSession = async (recordingData) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const session = {
+            id: 'current',
+            timestamp: Date.now(),
+            startTime: new Date().toISOString(),
+            mode: recordingData.mode,
+            notes: recordingData.notes || '',
+            tags: recordingData.tags || [],
+            asrOptions: recordingData.asrOptions || {},
+            chunks: [],
+            mimeType: recordingData.mimeType || 'audio/webm',
+            duration: 0
+        };
+
+        await promisifyRequest(objectStore.put(session));
+        console.log('[RecordingDB] Recording session started:', session.id);
+        return session;
+    } catch (error) {
+        console.error('[RecordingDB] Failed to start session:', error);
+        throw error;
+    }
+};
+
+/**
+ * Save a recording chunk to IndexedDB
+ */
+export const saveChunk = async (chunkBlob, chunkIndex) => {
+    try {
+        // Do async prep work BEFORE creating transaction to avoid auto-close
+        const db = await initDB();
+        const arrayBuffer = await chunkBlob.arrayBuffer();
+
+        // Now create transaction and do all DB operations quickly
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        // Get current session
+        const session = await promisifyRequest(objectStore.get('current'));
+
+        if (!session) {
+            console.warn('[RecordingDB] No active session found');
+            return;
+        }
+
+        // Add chunk to session
+        session.chunks.push({
+            index: chunkIndex,
+            data: arrayBuffer,
+            size: chunkBlob.size,
+            timestamp: Date.now()
+        });
+
+        // Update session - must happen before transaction auto-closes
+        await promisifyRequest(objectStore.put(session));
+        // Chunk saved silently to avoid spam (happens every 5 seconds)
+    } catch (error) {
+        console.error('[RecordingDB] Failed to save chunk:', error);
+        // Don't throw - recording should continue even if persistence fails
+    }
+};
+
+/**
+ * Update recording metadata (notes, duration, etc.)
+ */
+export const updateRecordingMetadata = async (updates) => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const session = await promisifyRequest(objectStore.get('current'));
+
+        if (!session) {
+            console.warn('[RecordingDB] No active session to update');
+            return;
+        }
+
+        // Merge updates
+        Object.assign(session, updates);
+        await promisifyRequest(objectStore.put(session));
+        // Metadata updated silently to avoid spam (happens every 5 seconds)
+    } catch (error) {
+        console.error('[RecordingDB] Failed to update metadata:', error);
+    }
+};
+
+/**
+ * Check if there's a recoverable recording
+ */
+export const checkForRecoverableRecording = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readonly');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const session = await promisifyRequest(objectStore.get('current'));
+
+        if (!session || !session.chunks || session.chunks.length === 0) {
+            return null;
+        }
+
+        // Calculate total size
+        const totalSize = session.chunks.reduce((sum, chunk) => sum + chunk.size, 0);
+
+        // Calculate approximate duration (1 second chunks)
+        const duration = session.chunks.length;
+
+        console.log('[RecordingDB] Found recoverable recording:', {
+            chunks: session.chunks.length,
+            size: totalSize,
+            duration: duration,
+            startTime: session.startTime
+        });
+
+        return {
+            ...session,
+            totalSize,
+            duration: duration
+        };
+    } catch (error) {
+        console.error('[RecordingDB] Failed to check for recoverable recording:', error);
+        return null;
+    }
+};
+
+/**
+ * Recover recording from IndexedDB
+ */
+export const recoverRecording = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readonly');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        const session = await promisifyRequest(objectStore.get('current'));
+
+        if (!session || !session.chunks || session.chunks.length === 0) {
+            console.warn('[RecordingDB] No recording to recover');
+            return null;
+        }
+
+        // Convert chunks back to Blobs
+        const chunks = session.chunks.map(chunk => {
+            return new Blob([chunk.data], { type: session.mimeType });
+        });
+
+        console.log(`[RecordingDB] Recovered ${chunks.length} chunks`);
+
+        return {
+            chunks,
+            metadata: {
+                mode: session.mode,
+                notes: session.notes,
+                tags: session.tags,
+                asrOptions: session.asrOptions,
+                mimeType: session.mimeType,
+                duration: session.chunks.length,
+                startTime: session.startTime
+            }
+        };
+    } catch (error) {
+        console.error('[RecordingDB] Failed to recover recording:', error);
+        return null;
+    }
+};
+
+/**
+ * Clear recording session (after successful upload or discard)
+ */
+export const clearRecordingSession = async () => {
+    try {
+        const db = await initDB();
+        const transaction = db.transaction([STORE_NAME], 'readwrite');
+        const objectStore = transaction.objectStore(STORE_NAME);
+
+        await promisifyRequest(objectStore.delete('current'));
+        console.log('[RecordingDB] Recording session cleared');
+    } catch (error) {
+        console.error('[RecordingDB] Failed to clear session:', error);
+    }
+};
+
+/**
+ * Get database size information
+ */
+export const getDatabaseSize = async () => {
+    try {
+        if (!navigator.storage || !navigator.storage.estimate) {
+            return null;
+        }
+
+        const estimate = await navigator.storage.estimate();
+        return {
+            usage: estimate.usage,
+            quota: estimate.quota,
+            percentage: ((estimate.usage / estimate.quota) * 100).toFixed(2)
+        };
+    } catch (error) {
+        console.error('[RecordingDB] Failed to get database size:', error);
+        return null;
+    }
+};
diff --git a/static/js/modules/utils/api.js b/static/js/modules/utils/api.js
new file mode 100644
index 00000000..1976f1ad
--- /dev/null
+++ b/static/js/modules/utils/api.js
@@ -0,0 +1,61 @@
+/**
+ * API utility functions with CSRF token handling
+ */
+
+export const createApiClient = (csrfToken) => {
+    const getHeaders = (contentType = 'application/json') => {
+        const headers = {
+            'X-CSRFToken': csrfToken.value
+        };
+        if (contentType) {
+            headers['Content-Type'] = contentType;
+        }
+        return headers;
+    };
+
+    return {
+        get: async (url) => {
+            const response = await fetch(url, {
+                headers: getHeaders()
+            });
+            return response;
+        },
+
+        post: async (url, data = {}) => {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: getHeaders(),
+                body: JSON.stringify(data)
+            });
+            return response;
+        },
+
+        postFormData: async (url, formData) => {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'X-CSRFToken': csrfToken.value
+                },
+                body: formData
+            });
+            return response;
+        },
+
+        delete: async (url) => {
+            const response = await fetch(url, {
+                method: 'DELETE',
+                headers: getHeaders()
+            });
+            return response;
+        },
+
+        put: async (url, data = {}) => {
+            const response = await fetch(url, {
+                method: 'PUT',
+                headers: getHeaders(),
+                body: JSON.stringify(data)
+            });
+            return response;
+        }
+    };
+};
diff --git a/static/js/modules/utils/colors.js b/static/js/modules/utils/colors.js
new file mode 100644
index 00000000..14ac47f4
--- /dev/null
+++ b/static/js/modules/utils/colors.js
@@ -0,0 +1,50 @@
+/**
+ * Color utility functions
+ */
+
+/**
+ * Calculate the relative luminance of a color
+ * Based on WCAG contrast ratio formula
+ * @param {string} hexColor - Hex color code (e.g., "#RRGGBB" or "#RGB")
+ * @returns {number} Luminance value between 0 and 1
+ */
+function calculateLuminance(hexColor) {
+    // Remove # if present
+    const hex = hexColor.replace('#', '');
+
+    // Convert 3-digit hex to 6-digit
+    const fullHex = hex.length === 3
+        ? hex.split('').map(char => char + char).join('')
+        : hex;
+
+    // Parse RGB values
+    const r = parseInt(fullHex.substr(0, 2), 16) / 255;
+    const g = parseInt(fullHex.substr(2, 2), 16) / 255;
+    const b = parseInt(fullHex.substr(4, 2), 16) / 255;
+
+    // Calculate relative luminance using simplified formula
+    // (More accurate would use gamma correction, but this is sufficient)
+    return 0.299 * r + 0.587 * g + 0.114 * b;
+}
+
+/**
+ * Get the appropriate text color (black or white) for a given background color
+ * Ensures readable contrast based on background luminance
+ * @param {string} bgColor - Background color in hex format
+ * @returns {string} Either 'white' or 'black'
+ */
+export function getContrastTextColor(bgColor) {
+    if (!bgColor) {
+        return 'white'; // Default to white for undefined colors
+    }
+
+    try {
+        const luminance = calculateLuminance(bgColor);
+        // Threshold of 0.65: only very light backgrounds get black text
+        // This ensures medium/dark colors like greens, blues still get white text
+        return luminance > 0.65 ? 'black' : 'white';
+    } catch (e) {
+        console.warn('Failed to calculate contrast color for:', bgColor, e);
+        return 'white'; // Fallback to white
+    }
+}
diff --git a/static/js/modules/utils/dates.js b/static/js/modules/utils/dates.js
new file mode 100644
index 00000000..768e93da
--- /dev/null
+++ b/static/js/modules/utils/dates.js
@@ -0,0 +1,67 @@
+/**
+ * Date comparison utility functions
+ */
+
+export const isSameDay = (date1, date2) => {
+    return date1.getFullYear() === date2.getFullYear() &&
+           date1.getMonth() === date2.getMonth() &&
+           date1.getDate() === date2.getDate();
+};
+
+export const isToday = (date) => {
+    const today = new Date();
+    return isSameDay(date, today);
+};
+
+export const isYesterday = (date) => {
+    const yesterday = new Date();
+    yesterday.setDate(yesterday.getDate() - 1);
+    return isSameDay(date, yesterday);
+};
+
+export const isThisWeek = (date) => {
+    const now = new Date();
+    const startOfWeek = new Date(now);
+    const day = now.getDay();
+    const diff = now.getDate() - day + (day === 0 ? -6 : 1); // Monday as start of week
+    startOfWeek.setDate(diff);
+    startOfWeek.setHours(0, 0, 0, 0);
+
+    const endOfWeek = new Date(startOfWeek);
+    endOfWeek.setDate(startOfWeek.getDate() + 6);
+    endOfWeek.setHours(23, 59, 59, 999);
+
+    return date >= startOfWeek && date <= endOfWeek;
+};
+
+export const isLastWeek = (date) => {
+    const now = new Date();
+    const startOfLastWeek = new Date(now);
+    const day = now.getDay();
+    const diff = now.getDate() - day + (day === 0 ? -6 : 1) - 7; // Previous Monday
+    startOfLastWeek.setDate(diff);
+    startOfLastWeek.setHours(0, 0, 0, 0);
+
+    const endOfLastWeek = new Date(startOfLastWeek);
+    endOfLastWeek.setDate(startOfLastWeek.getDate() + 6);
+    endOfLastWeek.setHours(23, 59, 59, 999);
+
+    return date >= startOfLastWeek && date <= endOfLastWeek;
+};
+
+export const isThisMonth = (date) => {
+    const now = new Date();
+    return date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth();
+};
+
+export const isLastMonth = (date) => {
+    const now = new Date();
+    const lastMonth = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+    return date.getFullYear() === lastMonth.getFullYear() && date.getMonth() === lastMonth.getMonth();
+};
+
+export const getDateForSorting = (recording, sortBy) => {
+    const dateStr = sortBy === 'meeting_date' ? recording.meeting_date : recording.created_at;
+    if (!dateStr) return null;
+    return new Date(dateStr);
+};
diff --git a/static/js/modules/utils/errorDisplay.js b/static/js/modules/utils/errorDisplay.js
new file mode 100644
index 00000000..6671c2d6
--- /dev/null
+++ b/static/js/modules/utils/errorDisplay.js
@@ -0,0 +1,271 @@
+/**
+ * Error Display Utility
+ *
+ * Parses and displays user-friendly error messages from the backend.
+ * Handles both JSON-formatted errors (ERROR_JSON:...) and plain text errors.
+ */
+
+/**
+ * Parse a stored error message from the backend.
+ * @param {string} text - The stored transcription/error text
+ * @returns {Object|null} - Parsed error object or null if not an error
+ */
+export function parseStoredError(text) {
+    if (!text) return null;
+
+    // Check for JSON-formatted error
+    if (text.startsWith('ERROR_JSON:')) {
+        try {
+            const jsonStr = text.substring(11); // Remove 'ERROR_JSON:' prefix
+            const data = JSON.parse(jsonStr);
+            return {
+                title: data.t || 'Error',
+                message: data.m || 'An error occurred',
+                guidance: data.g || '',
+                icon: data.i || 'fa-exclamation-circle',
+                type: data.y || 'unknown',
+                isKnown: data.k || false,
+                technical: data.d || '',
+                isFormattedError: true
+            };
+        } catch (e) {
+            console.error('Failed to parse error JSON:', e);
+        }
+    }
+
+    // Check for legacy error format (starts with common error prefixes)
+    const errorPrefixes = [
+        'Transcription failed:',
+        'Processing failed:',
+        'ASR processing failed:',
+        'Audio extraction failed:',
+        'Error:'
+    ];
+
+    for (const prefix of errorPrefixes) {
+        if (text.startsWith(prefix)) {
+            // Parse the error using pattern matching
+            return parseUnformattedError(text);
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Parse an unformatted error message and try to make it user-friendly.
+ * @param {string} text - The raw error text
+ * @returns {Object} - Parsed error object
+ */
+function parseUnformattedError(text) {
+    const lowerText = text.toLowerCase();
+
+    // Known error patterns
+    const patterns = [
+        {
+            patterns: ['maximum content size limit', 'file too large', '413', 'payload too large', 'exceeded'],
+            title: 'File Too Large',
+            message: 'The audio file exceeds the maximum size allowed by the transcription service.',
+            guidance: 'Try enabling audio chunking in your settings, or compress the audio file before uploading.',
+            icon: 'fa-file-audio',
+            type: 'size_limit'
+        },
+        {
+            patterns: ['timed out', 'timeout', 'deadline exceeded'],
+            title: 'Processing Timeout',
+            message: 'The transcription took too long to complete.',
+            guidance: 'This can happen with very long recordings. Try splitting the audio into smaller parts.',
+            icon: 'fa-clock',
+            type: 'timeout'
+        },
+        {
+            patterns: ['401', 'unauthorized', 'invalid api key', 'authentication failed', 'incorrect api key'],
+            title: 'Authentication Error',
+            message: 'The transcription service rejected the API credentials.',
+            guidance: 'Please check that the API key is correct and has not expired.',
+            icon: 'fa-key',
+            type: 'auth'
+        },
+        {
+            patterns: ['rate limit', 'too many requests', '429', 'quota exceeded'],
+            title: 'Rate Limit Exceeded',
+            message: 'Too many requests were sent to the transcription service.',
+            guidance: 'Please wait a few minutes and try reprocessing.',
+            icon: 'fa-hourglass-half',
+            type: 'rate_limit'
+        },
+        {
+            patterns: ['connection refused', 'connection reset', 'could not connect', 'network unreachable'],
+            title: 'Connection Error',
+            message: 'Could not connect to the transcription service.',
+            guidance: 'Check your internet connection and ensure the service is available.',
+            icon: 'fa-wifi',
+            type: 'connection'
+        },
+        {
+            patterns: ['503', '502', '500', 'service unavailable', 'server error', 'internal server error'],
+            title: 'Service Unavailable',
+            message: 'The transcription service is temporarily unavailable.',
+            guidance: 'This is usually temporary. Please try again in a few minutes.',
+            icon: 'fa-server',
+            type: 'service_error'
+        },
+        {
+            patterns: ['invalid file format', 'unsupported format', 'could not decode', 'corrupt', 'not valid audio'],
+            title: 'Invalid Audio Format',
+            message: 'The audio file format is not supported or the file may be corrupted.',
+            guidance: 'Try converting the audio to MP3 or WAV format before uploading.',
+            icon: 'fa-file-audio',
+            type: 'format'
+        },
+        {
+            patterns: ['audio extraction failed', 'ffmpeg failed', 'no audio stream'],
+            title: 'Audio Extraction Failed',
+            message: 'Could not extract audio from the uploaded file.',
+            guidance: 'Try converting the file to a standard audio format (MP3, WAV) before uploading.',
+            icon: 'fa-file-video',
+            type: 'extraction'
+        }
+    ];
+
+    // Check patterns
+    for (const pattern of patterns) {
+        for (const p of pattern.patterns) {
+            if (lowerText.includes(p)) {
+                return {
+                    title: pattern.title,
+                    message: pattern.message,
+                    guidance: pattern.guidance,
+                    icon: pattern.icon,
+                    type: pattern.type,
+                    isKnown: true,
+                    technical: text,
+                    isFormattedError: true
+                };
+            }
+        }
+    }
+
+    // Unknown error - clean it up as best we can
+    let cleanMessage = text;
+    for (const prefix of ['Transcription failed:', 'Processing failed:', 'Error:', 'ASR processing failed:']) {
+        if (cleanMessage.startsWith(prefix)) {
+            cleanMessage = cleanMessage.substring(prefix.length).trim();
+        }
+    }
+
+    // Truncate if too long
+    if (cleanMessage.length > 200) {
+        cleanMessage = cleanMessage.substring(0, 200) + '...';
+    }
+
+    return {
+        title: 'Processing Error',
+        message: cleanMessage,
+        guidance: 'If this error persists, try reprocessing the recording.',
+        icon: 'fa-exclamation-circle',
+        type: 'unknown',
+        isKnown: false,
+        technical: text,
+        isFormattedError: true
+    };
+}
+
+/**
+ * Check if a transcription text is actually an error message.
+ * @param {string} text - The transcription text
+ * @returns {boolean}
+ */
+export function isErrorMessage(text) {
+    if (!text) return false;
+
+    if (text.startsWith('ERROR_JSON:')) return true;
+
+    const errorPrefixes = [
+        'Transcription failed:',
+        'Processing failed:',
+        'ASR processing failed:',
+        'Audio extraction failed:'
+    ];
+
+    return errorPrefixes.some(prefix => text.startsWith(prefix));
+}
+
+/**
+ * Generate HTML for displaying an error nicely.
+ * @param {Object} error - Parsed error object from parseStoredError
+ * @param {boolean} showTechnical - Whether to show technical details
+ * @returns {string} - HTML string
+ */
+export function generateErrorHTML(error, showTechnical = false) {
+    if (!error) return '';
+
+    const typeColors = {
+        size_limit: 'amber',
+        timeout: 'orange',
+        auth: 'red',
+        rate_limit: 'yellow',
+        connection: 'blue',
+        service_error: 'purple',
+        format: 'pink',
+        extraction: 'indigo',
+        billing: 'red',
+        model: 'gray',
+        unknown: 'gray'
+    };
+
+    const color = typeColors[error.type] || 'gray';
+
+    let html = `
+        <div class="error-display bg-${color}-500/10 border border-${color}-500/30 rounded-lg p-4">
+            <div class="flex items-start gap-3">
+                <div class="flex-shrink-0 w-10 h-10 rounded-full bg-${color}-500/20 flex items-center justify-center">
+                    <i class="fas ${error.icon} text-${color}-500"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <h3 class="text-lg font-semibold text-${color}-600 dark:text-${color}-400 mb-1">
+                        ${escapeHtml(error.title)}
+                    </h3>
+                    <p class="text-[var(--text-primary)] mb-2">
+                        ${escapeHtml(error.message)}
+                    </p>
+                    ${error.guidance ? `
+                        <div class="flex items-start gap-2 text-sm text-[var(--text-secondary)] bg-[var(--bg-tertiary)]/50 rounded p-2">
+                            <i class="fas fa-lightbulb text-yellow-500 mt-0.5"></i>
+                            <span>${escapeHtml(error.guidance)}</span>
+                        </div>
+                    ` : ''}
+                </div>
+            </div>
+            ${showTechnical && error.technical ? `
+                <details class="mt-3 text-xs">
+                    <summary class="cursor-pointer text-[var(--text-muted)] hover:text-[var(--text-secondary)]">
+                        Technical details
+                    </summary>
+                    <pre class="mt-2 p-2 bg-[var(--bg-tertiary)] rounded overflow-x-auto text-[var(--text-muted)]">${escapeHtml(error.technical)}</pre>
+                </details>
+            ` : ''}
+        </div>
+    `;
+
+    return html;
+}
+
+/**
+ * Escape HTML special characters.
+ * @param {string} text
+ * @returns {string}
+ */
+function escapeHtml(text) {
+    if (!text) return '';
+    const div = document.createElement('div');
+    div.textContent = text;
+    return div.innerHTML;
+}
+
+// Export for use in Vue components
+export default {
+    parseStoredError,
+    isErrorMessage,
+    generateErrorHTML
+};
diff --git a/static/js/modules/utils/formatters.js b/static/js/modules/utils/formatters.js
new file mode 100644
index 00000000..e5e6a859
--- /dev/null
+++ b/static/js/modules/utils/formatters.js
@@ -0,0 +1,139 @@
+/**
+ * Formatting utility functions
+ */
+
+export const formatFileSize = (bytes) => {
+    if (bytes == null || bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+    if (bytes < 0) bytes = 0;
+    const i = bytes === 0 ? 0 : Math.max(0, Math.floor(Math.log(bytes) / Math.log(k)));
+    const size = i === 0 ? bytes : parseFloat((bytes / Math.pow(k, i)).toFixed(2));
+    return size + ' ' + sizes[i];
+};
+
+export const formatDisplayDate = (dateString) => {
+    if (!dateString) return '';
+    try {
+        let date = new Date(dateString);
+
+        if (isNaN(date.getTime())) {
+            if (/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+                date = new Date(dateString + 'T00:00:00');
+            } else {
+                return dateString;
+            }
+        }
+
+        if (isNaN(date.getTime())) {
+            return dateString;
+        }
+
+        return date.toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' });
+    } catch (e) {
+        console.error("Error formatting date:", e);
+        return dateString;
+    }
+};
+
+export const formatShortDate = (dateString) => {
+    if (!dateString) return '';
+    try {
+        let date = new Date(dateString);
+
+        if (isNaN(date.getTime())) {
+            if (/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+                date = new Date(dateString + 'T00:00:00');
+            } else {
+                return dateString;
+            }
+        }
+
+        if (isNaN(date.getTime())) {
+            return dateString;
+        }
+
+        const now = new Date();
+        const isCurrentYear = date.getFullYear() === now.getFullYear();
+
+        if (isCurrentYear) {
+            return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric' });
+        } else {
+            return date.toLocaleDateString(undefined, { year: '2-digit', month: 'short', day: 'numeric' });
+        }
+    } catch (e) {
+        console.error("Error formatting short date:", e);
+        return dateString;
+    }
+};
+
+export const formatStatus = (status, t) => {
+    if (!status || status === 'COMPLETED') return '';
+    const statusMap = {
+        'PENDING': t('status.queued'),
+        'QUEUED': t('status.queued'),
+        'PROCESSING': t('status.processing'),
+        'TRANSCRIBING': t('status.transcribing'),
+        'SUMMARIZING': t('status.summarizing'),
+        'FAILED': t('status.failed'),
+        'UPLOADING': t('status.uploading')
+    };
+    return statusMap[status] || status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
+};
+
+export const getStatusClass = (status) => {
+    switch(status) {
+        case 'PENDING': return 'status-pending';
+        case 'QUEUED': return 'status-pending';
+        case 'PROCESSING': return 'status-processing';
+        case 'SUMMARIZING': return 'status-summarizing';
+        case 'COMPLETED': return '';
+        case 'FAILED': return 'status-failed';
+        default: return 'status-pending';
+    }
+};
+
+export const formatTime = (seconds) => {
+    const minutes = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return `${minutes.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+};
+
+export const formatDuration = (totalSeconds) => {
+    if (totalSeconds == null || totalSeconds < 0) return 'N/A';
+
+    if (totalSeconds < 1) {
+        return `${totalSeconds.toFixed(2)} seconds`;
+    }
+
+    totalSeconds = Math.round(totalSeconds);
+
+    if (totalSeconds < 60) {
+        return `${totalSeconds} sec`;
+    }
+
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+
+    let parts = [];
+    if (hours > 0) {
+        parts.push(`${hours} hr`);
+    }
+    if (minutes > 0) {
+        parts.push(`${minutes} min`);
+    }
+    if (hours === 0 && seconds > 0) {
+        parts.push(`${seconds} sec`);
+    }
+
+    return parts.join(' ');
+};
+
+export const formatProcessingDuration = (seconds) => {
+    if (!seconds && seconds !== 0) return null;
+    if (seconds < 60) return `${seconds}s`;
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+};
diff --git a/static/js/modules/utils/index.js b/static/js/modules/utils/index.js
new file mode 100644
index 00000000..ae213188
--- /dev/null
+++ b/static/js/modules/utils/index.js
@@ -0,0 +1,9 @@
+/**
+ * Utils module exports
+ */
+
+export * from './formatters.js';
+export * from './dates.js';
+export { createApiClient } from './api.js';
+export { showToast } from './toast.js';
+export { getContrastTextColor } from './colors.js';
diff --git a/static/js/modules/utils/prompt-variables.js b/static/js/modules/utils/prompt-variables.js
new file mode 100644
index 00000000..fef0365a
--- /dev/null
+++ b/static/js/modules/utils/prompt-variables.js
@@ -0,0 +1,86 @@
+/**
+ * Prompt-template variable helpers.
+ *
+ * Mirrors the server-side logic in `src/utils/prompt_variables.py` so the
+ * upload form and reprocess modal surface exactly the variables that the
+ * summary task would substitute at run time.
+ *
+ * Identifier rule: ASCII letter or underscore, then letters/digits/underscores.
+ * The frontend never substitutes — it only enumerates names so the user can
+ * fill values. The backend does the actual substitution.
+ */
+
+export const PROMPT_VAR_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+
+export const extractVariableNames = (text) => {
+    if (!text || typeof text !== 'string') return [];
+    const names = [];
+    for (const match of text.matchAll(PROMPT_VAR_RE)) {
+        if (!names.includes(match[1])) names.push(match[1]);
+    }
+    return names;
+};
+
+export const inferVarLabel = (name) => {
+    if (!name) return '';
+    const cleaned = name.replace(/_/g, ' ').trim();
+    if (!cleaned) return '';
+    return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+};
+
+/**
+ * Build the variable list for a given priority chain. Returns an array of
+ * `{ name, label, sources: [{ type, name }] }` in the order names are first
+ * seen.
+ *
+ * Priority chain (matches `generate_summary_only_task`):
+ *   tags (any tag with a prompt wins as a layer) → folder → user default → admin default
+ * Only the first non-empty layer is scanned. Lower layers are skipped because
+ * their prompt would not run at summarisation time.
+ *
+ * `tagsWithPrompts` is `[{ name, custom_prompt }, ...]`. `folder` is
+ * `{ name, custom_prompt }` or null. `userPrompt` and `adminPrompt` are
+ * raw strings or null/empty.
+ */
+export const buildVariableList = ({ tagsWithPrompts, folder, userPrompt, adminPrompt }) => {
+    const acc = new Map();
+    const addVars = (text, sourceLabel, sourceType) => {
+        for (const name of extractVariableNames(text)) {
+            if (!acc.has(name)) {
+                acc.set(name, { name, label: inferVarLabel(name), sources: [] });
+            }
+            const entry = acc.get(name);
+            if (!entry.sources.find(s => s.name === sourceLabel && s.type === sourceType)) {
+                entry.sources.push({ type: sourceType, name: sourceLabel });
+            }
+        }
+    };
+
+    let anyTagHasPrompt = false;
+    if (Array.isArray(tagsWithPrompts)) {
+        for (const tag of tagsWithPrompts) {
+            if (tag && tag.custom_prompt) {
+                addVars(tag.custom_prompt, tag.name, 'tag');
+                anyTagHasPrompt = true;
+            }
+        }
+    }
+
+    let folderHasPrompt = false;
+    if (!anyTagHasPrompt && folder && folder.custom_prompt) {
+        addVars(folder.custom_prompt, folder.name, 'folder');
+        folderHasPrompt = true;
+    }
+
+    let userPromptHasContent = false;
+    if (!anyTagHasPrompt && !folderHasPrompt && userPrompt) {
+        addVars(userPrompt, 'Your default prompt', 'user');
+        userPromptHasContent = true;
+    }
+
+    if (!anyTagHasPrompt && !folderHasPrompt && !userPromptHasContent && adminPrompt) {
+        addVars(adminPrompt, 'Site default prompt', 'admin');
+    }
+
+    return Array.from(acc.values());
+};
diff --git a/static/js/modules/utils/prompt-variables.test.js b/static/js/modules/utils/prompt-variables.test.js
new file mode 100644
index 00000000..daaaa10b
--- /dev/null
+++ b/static/js/modules/utils/prompt-variables.test.js
@@ -0,0 +1,240 @@
+import { describe, it, expect } from 'vitest';
+import {
+    PROMPT_VAR_RE,
+    extractVariableNames,
+    inferVarLabel,
+    buildVariableList,
+} from './prompt-variables.js';
+
+describe('extractVariableNames', () => {
+    it('returns an empty array for empty / non-string inputs', () => {
+        expect(extractVariableNames('')).toEqual([]);
+        expect(extractVariableNames(null)).toEqual([]);
+        expect(extractVariableNames(undefined)).toEqual([]);
+        expect(extractVariableNames(42)).toEqual([]);
+        expect(extractVariableNames({})).toEqual([]);
+    });
+
+    it('extracts a single variable', () => {
+        expect(extractVariableNames('Agenda: {{agenda}}')).toEqual(['agenda']);
+    });
+
+    it('extracts multiple variables in source order', () => {
+        expect(extractVariableNames('{{a}} then {{b}} then {{c}}')).toEqual(['a', 'b', 'c']);
+    });
+
+    it('deduplicates repeated variables, keeping first-seen order', () => {
+        expect(extractVariableNames('{{a}} {{b}} {{a}} {{c}} {{b}}')).toEqual(['a', 'b', 'c']);
+    });
+
+    it('tolerates whitespace inside the braces', () => {
+        expect(extractVariableNames('{{ agenda }} {{  location  }}')).toEqual(['agenda', 'location']);
+    });
+
+    it('accepts identifier-shaped names with digits and underscores', () => {
+        expect(extractVariableNames('{{user_1}} {{_private}} {{a1b2}}')).toEqual(['user_1', '_private', 'a1b2']);
+    });
+
+    it('rejects identifiers that start with a digit', () => {
+        expect(extractVariableNames('{{1bad}} {{2nd}}')).toEqual([]);
+    });
+
+    it('rejects identifiers with hyphens or other punctuation', () => {
+        expect(extractVariableNames('{{has-hyphen}} {{has.dot}} {{has space}}')).toEqual([]);
+    });
+
+    it('rejects unicode identifiers (ASCII-only by design)', () => {
+        // Documented limitation in src/utils/prompt_variables.py
+        expect(extractVariableNames('{{café}} {{日本}}')).toEqual([]);
+    });
+
+    it('does not match single braces', () => {
+        expect(extractVariableNames('{not_a_var} {also not}')).toEqual([]);
+    });
+
+    it('does not match unbalanced braces', () => {
+        expect(extractVariableNames('{{unclosed}')).toEqual([]);
+        expect(extractVariableNames('unclosed}}')).toEqual([]);
+    });
+
+    it('treats SSTI probe identifiers as plain names (no eval, no attribute access)', () => {
+        // The frontend never substitutes — it just enumerates names. The
+        // backend single-pass re.sub guarantees the same on the server.
+        expect(extractVariableNames('{{__class__}} {{config}} {{__import__}}')).toEqual([
+            '__class__', 'config', '__import__',
+        ]);
+    });
+});
+
+describe('inferVarLabel', () => {
+    it('returns empty for empty input', () => {
+        expect(inferVarLabel('')).toBe('');
+        expect(inferVarLabel(null)).toBe('');
+        expect(inferVarLabel(undefined)).toBe('');
+    });
+
+    it('capitalises and replaces underscores with spaces', () => {
+        expect(inferVarLabel('agenda')).toBe('Agenda');
+        expect(inferVarLabel('meeting_location')).toBe('Meeting location');
+        expect(inferVarLabel('quarterly_review_notes')).toBe('Quarterly review notes');
+    });
+
+    it('handles single underscore and trims', () => {
+        expect(inferVarLabel('_')).toBe('');
+        expect(inferVarLabel('_private')).toBe('Private');
+    });
+
+    it('does not break on already-capitalised input', () => {
+        expect(inferVarLabel('Agenda')).toBe('Agenda');
+    });
+});
+
+describe('PROMPT_VAR_RE', () => {
+    it('is global so matchAll yields every occurrence', () => {
+        expect(PROMPT_VAR_RE.global).toBe(true);
+    });
+
+    it('is the same shape as the server-side pattern', () => {
+        // Sanity check: server-side regex is r"\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}".
+        // Identical class semantics; if these diverge, the upload form will
+        // surface a different set of variables than the server substitutes.
+        expect(PROMPT_VAR_RE.source).toBe('\\{\\{\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*\\}\\}');
+    });
+});
+
+describe('buildVariableList — priority chain', () => {
+    const input = (over = {}) => ({
+        tagsWithPrompts: [],
+        folder: null,
+        userPrompt: '',
+        adminPrompt: '',
+        ...over,
+    });
+
+    it('returns empty when no source has any prompt', () => {
+        expect(buildVariableList(input())).toEqual([]);
+    });
+
+    it('returns empty when sources have prompts but no variables', () => {
+        expect(buildVariableList(input({
+            tagsWithPrompts: [{ name: 'Plain', custom_prompt: 'Just summarise.' }],
+        }))).toEqual([]);
+    });
+
+    it('uses tags when at least one tag has a prompt with variables', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [{ name: 'Meeting', custom_prompt: 'Agenda: {{agenda}}' }],
+            folder: { name: 'Projects', custom_prompt: '{{project}}' },
+            userPrompt: 'User: {{quarter}}',
+            adminPrompt: 'Admin: {{org}}',
+        }));
+        expect(result.map(v => v.name)).toEqual(['agenda']);
+        expect(result[0].sources).toEqual([{ type: 'tag', name: 'Meeting' }]);
+    });
+
+    it('aggregates variables across multiple tags with prompts', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [
+                { name: 'TagA', custom_prompt: '{{agenda}}' },
+                { name: 'TagB', custom_prompt: '{{location}}' },
+                { name: 'TagC', custom_prompt: 'No vars here' },
+            ],
+        }));
+        expect(result.map(v => v.name)).toEqual(['agenda', 'location']);
+    });
+
+    it('records multiple sources for the same variable name when both tags use it', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [
+                { name: 'TagA', custom_prompt: '{{agenda}}' },
+                { name: 'TagB', custom_prompt: 'Also {{agenda}}' },
+            ],
+        }));
+        expect(result).toHaveLength(1);
+        expect(result[0].sources).toEqual([
+            { type: 'tag', name: 'TagA' },
+            { type: 'tag', name: 'TagB' },
+        ]);
+    });
+
+    it('skips tags with no custom_prompt', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [
+                { name: 'TagA', custom_prompt: null },
+                { name: 'TagB', custom_prompt: '' },
+                { name: 'TagC', custom_prompt: '{{agenda}}' },
+            ],
+        }));
+        expect(result.map(v => v.name)).toEqual(['agenda']);
+        expect(result[0].sources).toEqual([{ type: 'tag', name: 'TagC' }]);
+    });
+
+    it('falls through to folder when no tag has a prompt', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [{ name: 'Plain', custom_prompt: null }],
+            folder: { name: 'Projects', custom_prompt: '{{project}}' },
+            userPrompt: 'User: {{quarter}}',
+        }));
+        expect(result.map(v => v.name)).toEqual(['project']);
+        expect(result[0].sources).toEqual([{ type: 'folder', name: 'Projects' }]);
+    });
+
+    it('skips folder layer when any tag had a prompt, even if folder has variables', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [{ name: 'TagA', custom_prompt: '{{agenda}}' }],
+            folder: { name: 'F', custom_prompt: '{{project}}' },
+        }));
+        expect(result.map(v => v.name)).toEqual(['agenda']);
+    });
+
+    it('falls through to user prompt when no tags and no folder prompt', () => {
+        const result = buildVariableList(input({
+            folder: null,
+            userPrompt: 'User: {{quarter}} {{agenda}}',
+            adminPrompt: 'Admin: {{org}}',
+        }));
+        expect(result.map(v => v.name)).toEqual(['quarter', 'agenda']);
+        expect(result[0].sources).toEqual([{ type: 'user', name: 'Your default prompt' }]);
+    });
+
+    it('falls through to admin prompt only when nothing above has content', () => {
+        const result = buildVariableList(input({
+            adminPrompt: 'Org: {{org}}',
+        }));
+        expect(result.map(v => v.name)).toEqual(['org']);
+        expect(result[0].sources).toEqual([{ type: 'admin', name: 'Site default prompt' }]);
+    });
+
+    it('skips admin when user prompt has any content (even if it has no variables)', () => {
+        const result = buildVariableList(input({
+            userPrompt: 'Plain user prompt with no variables',
+            adminPrompt: '{{org}}',
+        }));
+        // User prompt wins as a layer; admin layer is not scanned.
+        expect(result).toEqual([]);
+    });
+
+    it('skips folder when folder has no custom_prompt, falls through to user', () => {
+        const result = buildVariableList(input({
+            folder: { name: 'Empty', custom_prompt: null },
+            userPrompt: '{{quarter}}',
+        }));
+        expect(result.map(v => v.name)).toEqual(['quarter']);
+    });
+
+    it('handles non-array tagsWithPrompts gracefully', () => {
+        expect(buildVariableList(input({ tagsWithPrompts: null, userPrompt: '{{q}}' }))
+            .map(v => v.name)).toEqual(['q']);
+        expect(buildVariableList(input({ tagsWithPrompts: undefined, userPrompt: '{{q}}' }))
+            .map(v => v.name)).toEqual(['q']);
+    });
+
+    it('produces label and sources fields for each entry', () => {
+        const result = buildVariableList(input({
+            tagsWithPrompts: [{ name: 'M', custom_prompt: '{{meeting_location}}' }],
+        }));
+        expect(result).toEqual([
+            { name: 'meeting_location', label: 'Meeting location', sources: [{ type: 'tag', name: 'M' }] },
+        ]);
+    });
+});
diff --git a/static/js/modules/utils/toast.js b/static/js/modules/utils/toast.js
new file mode 100644
index 00000000..9c4ab606
--- /dev/null
+++ b/static/js/modules/utils/toast.js
@@ -0,0 +1,91 @@
+/**
+ * Toast notification utility
+ */
+
+export const showToast = (message, iconClass = 'fa-info-circle', duration = 3000, type = 'info') => {
+    const container = document.getElementById('toastContainer');
+    if (!container) {
+        console.warn('Toast container not found');
+        return;
+    }
+
+    // Determine colors and styles based on type
+    let bgColor, textColor, iconColor, borderColor;
+
+    switch (type) {
+        case 'success':
+            bgColor = '#10b981'; // green-500
+            textColor = '#ffffff';
+            iconColor = '#ffffff';
+            borderColor = '#059669'; // green-600
+            break;
+        case 'error':
+            bgColor = '#ef4444'; // red-500
+            textColor = '#ffffff';
+            iconColor = '#ffffff';
+            borderColor = '#dc2626'; // red-600
+            break;
+        case 'warning':
+            bgColor = '#f59e0b'; // amber-500
+            textColor = '#ffffff';
+            iconColor = '#ffffff';
+            borderColor = '#d97706'; // amber-600
+            break;
+        case 'info':
+        default:
+            bgColor = '#3b82f6'; // blue-500
+            textColor = '#ffffff';
+            iconColor = '#ffffff';
+            borderColor = '#2563eb'; // blue-600
+            break;
+    }
+
+    const toast = document.createElement('div');
+    toast.className = 'toast-message px-4 py-3 rounded-lg shadow-lg flex items-center gap-3 opacity-0 min-w-[300px]';
+    toast.style.backgroundColor = bgColor;
+    toast.style.color = textColor;
+    toast.style.border = `1px solid ${borderColor}`;
+
+    // Handle icon class - support both old format (just icon name) and new format (full class)
+    let fullIconClass = iconClass;
+    if (!iconClass.includes(' ')) {
+        // Old format: just the icon name like 'fa-check-circle'
+        fullIconClass = `fas ${iconClass}`;
+    }
+
+    toast.innerHTML = `
+        <i class="${fullIconClass}" style="color: ${iconColor}"></i>
+        <span class="flex-1">${message}</span>
+    `;
+
+    // Make toast clickable to dismiss
+    toast.style.cursor = 'pointer';
+
+    container.appendChild(toast);
+
+    // Trigger fly-in animation
+    requestAnimationFrame(() => {
+        toast.classList.remove('opacity-0');
+        toast.classList.add('opacity-100', 'toast-show');
+    });
+
+    // Function to dismiss the toast
+    const dismissToast = () => {
+        toast.classList.remove('opacity-100', 'toast-show');
+        toast.classList.add('opacity-0');
+        setTimeout(() => {
+            if (toast.parentNode) {
+                toast.parentNode.removeChild(toast);
+            }
+        }, 300);
+    };
+
+    // Add click handler to dismiss toast
+    toast.addEventListener('click', () => {
+        clearTimeout(timeoutId);
+        dismissToast();
+    });
+
+    // Auto-dismiss after duration
+    const timeoutId = setTimeout(dismissToast, duration);
+};
diff --git a/static/js/shared-components.js b/static/js/shared-components.js
new file mode 100644
index 00000000..6ad28da7
--- /dev/null
+++ b/static/js/shared-components.js
@@ -0,0 +1,262 @@
+// Shared UI Components and Functionality
+// This file contains reusable Vue composition functions and utilities
+// that can be used across multiple pages (index, inquire, admin, etc.)
+
+// Dark Mode Composition
+function useDarkMode() {
+    const isDarkMode = Vue.ref(false);
+    
+    const toggleDarkMode = () => {
+        isDarkMode.value = !isDarkMode.value;
+        if (isDarkMode.value) {
+            document.documentElement.classList.add('dark');
+            localStorage.setItem('darkMode', 'true');
+        } else {
+            document.documentElement.classList.remove('dark');
+            localStorage.setItem('darkMode', 'false');
+        }
+    };
+    
+    const initializeDarkMode = () => {
+        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        const savedMode = localStorage.getItem('darkMode');
+        if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+            isDarkMode.value = true;
+            document.documentElement.classList.add('dark');
+        } else {
+            isDarkMode.value = false;
+            document.documentElement.classList.remove('dark');
+        }
+    };
+    
+    return {
+        isDarkMode,
+        toggleDarkMode,
+        initializeDarkMode
+    };
+}
+
+// Color Scheme Composition
+function useColorScheme() {
+    const showColorSchemeModal = Vue.ref(false);
+    const currentColorScheme = Vue.ref('blue');
+    const isDarkMode = Vue.ref(false);
+    
+    const colorSchemes = {
+        light: [
+            { id: 'blue', name: 'Ocean Blue', description: 'Classic blue theme with professional appeal', accent: '#3b82f6', hover: '#2563eb' },
+            { id: 'emerald', name: 'Forest Emerald', description: 'Fresh green theme for a natural feel', accent: '#10b981', hover: '#059669' },
+            { id: 'purple', name: 'Royal Purple', description: 'Elegant purple theme with sophistication', accent: '#8b5cf6', hover: '#7c3aed' },
+            { id: 'rose', name: 'Sunset Rose', description: 'Warm pink theme with gentle energy', accent: '#f43f5e', hover: '#e11d48' },
+            { id: 'amber', name: 'Golden Amber', description: 'Warm yellow theme for brightness', accent: '#f59e0b', hover: '#d97706' },
+            { id: 'teal', name: 'Ocean Teal', description: 'Cool teal theme for tranquility', accent: '#06b6d4', hover: '#0891b2' }
+        ],
+        dark: [
+            { id: 'blue', name: 'Midnight Blue', description: 'Deep blue for focused night work', accent: '#60a5fa', hover: '#3b82f6' },
+            { id: 'emerald', name: 'Emerald Night', description: 'Rich green for comfortable viewing', accent: '#34d399', hover: '#10b981' },
+            { id: 'purple', name: 'Deep Purple', description: 'Luxurious purple for creative sessions', accent: '#a78bfa', hover: '#8b5cf6' },
+            { id: 'rose', name: 'Crimson', description: 'Bold red-pink for energetic work', accent: '#fb7185', hover: '#f43f5e' },
+            { id: 'amber', name: 'Golden Hour', description: 'Warm amber for reduced eye strain', accent: '#fbbf24', hover: '#f59e0b' },
+            { id: 'teal', name: 'Electric Cyan', description: 'Vibrant cyan for modern aesthetics', accent: '#22d3ee', hover: '#06b6d4' }
+        ]
+    };
+    
+    const applyColorScheme = (schemeId) => {
+        const schemes = isDarkMode.value ? colorSchemes.dark : colorSchemes.light;
+        const scheme = schemes.find(s => s.id === schemeId);
+        if (scheme) {
+            // Remove all theme classes
+            const allThemeClasses = [
+                ...colorSchemes.light.map(s => `theme-light-${s.id}`),
+                ...colorSchemes.dark.map(s => `theme-dark-${s.id}`)
+            ].filter(c => !c.includes('blue')); // blue is the default, no class needed
+            
+            document.documentElement.classList.remove(...allThemeClasses);
+            
+            // Apply new theme class if not blue (default)
+            if (schemeId !== 'blue') {
+                const themeClass = `theme-${isDarkMode.value ? 'dark' : 'light'}-${schemeId}`;
+                document.documentElement.classList.add(themeClass);
+            }
+            
+            // Don't set CSS variables - let the theme classes handle all colors
+            localStorage.setItem('colorScheme', schemeId);
+            currentColorScheme.value = schemeId;
+        }
+    };
+    
+    const initializeColorScheme = (darkMode) => {
+        isDarkMode.value = darkMode;
+        const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+        currentColorScheme.value = savedScheme;
+        applyColorScheme(savedScheme);
+    };
+    
+    // Watch for dark mode changes and reapply color scheme
+    Vue.watch(() => isDarkMode.value, (newValue) => {
+        applyColorScheme(currentColorScheme.value);
+    });
+    
+    const openColorSchemeModal = () => {
+        showColorSchemeModal.value = true;
+    };
+    
+    const closeColorSchemeModal = () => {
+        showColorSchemeModal.value = false;
+    };
+    
+    const selectColorScheme = (schemeId) => {
+        applyColorScheme(schemeId);
+        const scheme = colorSchemes[isDarkMode.value ? 'dark' : 'light'].find(s => s.id === schemeId);
+        if (window.showToast && scheme) {
+            window.showToast(`Applied ${scheme.name} theme`, 'fa-palette');
+        }
+    };
+    
+    const resetColorScheme = () => {
+        applyColorScheme('blue');
+        if (window.showToast) {
+            const defaultScheme = colorSchemes[isDarkMode.value ? 'dark' : 'light'].find(s => s.id === 'blue');
+            window.showToast(`Reset to default ${defaultScheme?.name || 'Ocean Blue'} theme`, 'fa-undo');
+        }
+    };
+    
+    return {
+        showColorSchemeModal,
+        currentColorScheme,
+        colorSchemes,
+        openColorSchemeModal,
+        closeColorSchemeModal,
+        selectColorScheme,
+        resetColorScheme,
+        applyColorScheme,
+        initializeColorScheme
+    };
+}
+
+// Shared Transcripts Modal Composition
+function useSharesModal() {
+    const showSharesListModal = Vue.ref(false);
+    const userShares = Vue.ref([]);
+    const isLoadingShares = Vue.ref(false);
+    
+    const openSharesList = async () => {
+        isLoadingShares.value = true;
+        showSharesListModal.value = true;
+        try {
+            const response = await fetch('/api/shares');
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Failed to load shared items');
+            userShares.value = data;
+        } catch (error) {
+            if (window.setGlobalError) {
+                window.setGlobalError(`Failed to load shared items: ${error.message}`);
+            } else {
+                console.error('Failed to load shared items:', error);
+            }
+        } finally {
+            isLoadingShares.value = false;
+        }
+    };
+    
+    const closeSharesList = () => {
+        showSharesListModal.value = false;
+    };
+    
+    const copyShareLink = async (shareId) => {
+        const url = `${window.location.origin}/share/${shareId}`;
+        try {
+            await navigator.clipboard.writeText(url);
+            if (window.showToast) {
+                window.showToast('Share link copied to clipboard', 'fa-link');
+            }
+        } catch (err) {
+            if (window.setGlobalError) {
+                window.setGlobalError('Failed to copy link to clipboard');
+            }
+        }
+    };
+    
+    const deleteShare = async (shareId) => {
+        if (!confirm('Are you sure you want to delete this share?')) return;
+        
+        try {
+            const response = await fetch(`/api/shares/${shareId}`, {
+                method: 'DELETE',
+                headers: {
+                    'X-CSRFToken': document.querySelector('meta[name="csrf-token"]')?.getAttribute('content')
+                }
+            });
+            
+            if (!response.ok) {
+                const data = await response.json();
+                throw new Error(data.error || 'Failed to delete share');
+            }
+            
+            userShares.value = userShares.value.filter(share => share.id !== shareId);
+            if (window.showToast) {
+                window.showToast('Share deleted successfully', 'fa-trash');
+            }
+        } catch (error) {
+            if (window.setGlobalError) {
+                window.setGlobalError(`Failed to delete share: ${error.message}`);
+            }
+        }
+    };
+    
+    return {
+        showSharesListModal,
+        userShares,
+        isLoadingShares,
+        openSharesList,
+        closeSharesList,
+        copyShareLink,
+        deleteShare
+    };
+}
+
+// User Menu Composition  
+function useUserMenu() {
+    const isUserMenuOpen = Vue.ref(false);
+    
+    const toggleUserMenu = () => {
+        isUserMenuOpen.value = !isUserMenuOpen.value;
+    };
+    
+    const closeUserMenu = () => {
+        isUserMenuOpen.value = false;
+    };
+    
+    // Close menu when clicking outside
+    Vue.onMounted(() => {
+        const handleClickOutside = (e) => {
+            const userMenuButton = e.target.closest('button[class*="flex items-center gap"]');
+            const userMenuDropdown = e.target.closest('div[class*="absolute right-0"]');
+            const isUserMenuButtonClick = userMenuButton && userMenuButton.querySelector('i.fa-user-circle');
+            
+            if (!isUserMenuButtonClick && !userMenuDropdown) {
+                isUserMenuOpen.value = false;
+            }
+        };
+        
+        document.addEventListener('click', handleClickOutside);
+        
+        Vue.onUnmounted(() => {
+            document.removeEventListener('click', handleClickOutside);
+        });
+    });
+    
+    return {
+        isUserMenuOpen,
+        toggleUserMenu,
+        closeUserMenu
+    };
+}
+
+// Export for use in Vue components
+window.SharedComponents = {
+    useDarkMode,
+    useColorScheme,
+    useSharesModal,
+    useUserMenu
+};
\ No newline at end of file
diff --git a/static/js/utils/apiClient.js b/static/js/utils/apiClient.js
new file mode 100644
index 00000000..56b09c1f
--- /dev/null
+++ b/static/js/utils/apiClient.js
@@ -0,0 +1,119 @@
+/**
+ * API client utilities for making HTTP requests
+ */
+
+class APIError extends Error {
+    constructor(message, status, data) {
+        super(message);
+        this.name = 'APIError';
+        this.status = status;
+        this.data = data;
+    }
+}
+
+/**
+ * Safely parse JSON response, handling HTML error pages gracefully
+ */
+async function safeJsonParse(response) {
+    const contentType = response.headers.get('content-type') || '';
+
+    // If response is not JSON, extract useful error from HTML
+    if (!contentType.includes('application/json')) {
+        const text = await response.text();
+        // Try to extract error message from HTML title or h1
+        const titleMatch = text.match(/<title>([^<]+)<\/title>/i);
+        const h1Match = text.match(/<h1>([^<]+)<\/h1>/i);
+        const errorMsg = titleMatch?.[1] || h1Match?.[1] ||
+            `Server returned non-JSON response (status ${response.status})`;
+        throw new APIError(errorMsg, response.status, { htmlResponse: true });
+    }
+
+    return response.json();
+}
+
+export async function apiRequest(url, options = {}) {
+    const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+
+    const defaultOptions = {
+        headers: {
+            'Content-Type': 'application/json',
+            ...(csrfToken && { 'X-CSRFToken': csrfToken })
+        }
+    };
+
+    const mergedOptions = {
+        ...defaultOptions,
+        ...options,
+        headers: {
+            ...defaultOptions.headers,
+            ...options.headers
+        }
+    };
+
+    try {
+        const response = await fetch(url, mergedOptions);
+        const data = await safeJsonParse(response);
+
+        if (!response.ok) {
+            throw new APIError(
+                data.error || 'Request failed',
+                response.status,
+                data
+            );
+        }
+
+        return data;
+    } catch (error) {
+        if (error instanceof APIError) {
+            throw error;
+        }
+        throw new APIError(error.message, 0, null);
+    }
+}
+
+export async function uploadFile(url, file, onProgress = null) {
+    const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+    const formData = new FormData();
+    formData.append('audio_file', file);
+
+    return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+
+        if (onProgress) {
+            xhr.upload.addEventListener('progress', (e) => {
+                if (e.lengthComputable) {
+                    const percentComplete = (e.loaded / e.total) * 100;
+                    onProgress(percentComplete);
+                }
+            });
+        }
+
+        xhr.addEventListener('load', () => {
+            if (xhr.status >= 200 && xhr.status < 300) {
+                try {
+                    const data = JSON.parse(xhr.responseText);
+                    resolve(data);
+                } catch (e) {
+                    reject(new Error('Invalid response format'));
+                }
+            } else {
+                try {
+                    const error = JSON.parse(xhr.responseText);
+                    reject(new APIError(error.error || 'Upload failed', xhr.status, error));
+                } catch (e) {
+                    reject(new APIError('Upload failed', xhr.status, null));
+                }
+            }
+        });
+
+        xhr.addEventListener('error', () => {
+            reject(new Error('Network error'));
+        });
+
+        xhr.open('POST', url);
+        if (csrfToken) {
+            xhr.setRequestHeader('X-CSRFToken', csrfToken);
+        }
+        xhr.send(formData);
+    });
+}
diff --git a/static/js/utils/audioUtils.js b/static/js/utils/audioUtils.js
new file mode 100644
index 00000000..ce613c2f
--- /dev/null
+++ b/static/js/utils/audioUtils.js
@@ -0,0 +1,61 @@
+/**
+ * Audio processing and visualization utilities
+ */
+
+export function formatFileSize(bytes) {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
+}
+
+export function createAudioVisualizer(canvas, stream, color = '#3b82f6') {
+    if (!canvas || !stream) return null;
+
+    const audioContext = new (window.AudioContext || window.webkitAudioContext)();
+    const analyser = audioContext.createAnalyser();
+    const microphone = audioContext.createMediaStreamSource(stream);
+
+    analyser.fftSize = 256;
+    const bufferLength = analyser.frequencyBinCount;
+    const dataArray = new Uint8Array(bufferLength);
+
+    microphone.connect(analyser);
+
+    const canvasCtx = canvas.getContext('2d');
+    const WIDTH = canvas.width;
+    const HEIGHT = canvas.height;
+
+    function draw() {
+        requestAnimationFrame(draw);
+        analyser.getByteFrequencyData(dataArray);
+
+        canvasCtx.fillStyle = 'rgb(17, 24, 39)';
+        canvasCtx.fillRect(0, 0, WIDTH, HEIGHT);
+
+        const barWidth = (WIDTH / bufferLength) * 2.5;
+        let barHeight;
+        let x = 0;
+
+        for (let i = 0; i < bufferLength; i++) {
+            barHeight = (dataArray[i] / 255) * HEIGHT;
+            canvasCtx.fillStyle = color;
+            canvasCtx.fillRect(x, HEIGHT - barHeight, barWidth, barHeight);
+            x += barWidth + 1;
+        }
+    }
+
+    draw();
+
+    return { audioContext, analyser, stop: () => audioContext.close() };
+}
+
+export function detectBrowser() {
+    const userAgent = navigator.userAgent.toLowerCase();
+    if (userAgent.indexOf('firefox') > -1) return 'firefox';
+    if (userAgent.indexOf('chrome') > -1 && userAgent.indexOf('edge') === -1) return 'chrome';
+    if (userAgent.indexOf('safari') > -1 && userAgent.indexOf('chrome') === -1) return 'safari';
+    if (userAgent.indexOf('edge') > -1) return 'edge';
+    return 'unknown';
+}
diff --git a/static/js/utils/dateUtils.js b/static/js/utils/dateUtils.js
new file mode 100644
index 00000000..ec8cd8c2
--- /dev/null
+++ b/static/js/utils/dateUtils.js
@@ -0,0 +1,83 @@
+/**
+ * Date utility functions for formatting and parsing dates
+ */
+
+export function formatDateTime(dateString) {
+    if (!dateString) return '';
+    const date = new Date(dateString);
+    const now = new Date();
+    const diffMs = now - date;
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+
+    if (diffDays === 0) {
+        return 'Today at ' + date.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
+    } else if (diffDays === 1) {
+        return 'Yesterday at ' + date.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
+    } else if (diffDays < 7) {
+        const dayName = date.toLocaleDateString('en-US', { weekday: 'long' });
+        return dayName + ' at ' + date.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
+    } else {
+        return date.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+    }
+}
+
+export function formatTimeAgo(dateString) {
+    if (!dateString) return '';
+    const date = new Date(dateString);
+    const now = new Date();
+    const diffMs = now - date;
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMs / 3600000);
+    const diffDays = Math.floor(diffMs / 86400000);
+
+    if (diffMins < 1) return 'Just now';
+    if (diffMins < 60) return `${diffMins} minute${diffMins > 1 ? 's' : ''} ago`;
+    if (diffHours < 24) return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    if (diffDays < 30) return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+
+    const diffMonths = Math.floor(diffDays / 30);
+    if (diffMonths < 12) return `${diffMonths} month${diffMonths > 1 ? 's' : ''} ago`;
+
+    const diffYears = Math.floor(diffDays / 365);
+    return `${diffYears} year${diffYears > 1 ? 's' : ''} ago`;
+}
+
+export function formatDuration(seconds) {
+    if (!seconds || seconds < 0) return '0:00';
+    const hrs = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    const secs = Math.floor(seconds % 60);
+
+    if (hrs > 0) {
+        return `${hrs}:${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+    }
+    return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+
+export function parseDateRange(preset) {
+    const now = new Date();
+    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+
+    switch (preset) {
+        case 'today':
+            return { start: today, end: new Date() };
+        case 'yesterday':
+            const yesterday = new Date(today);
+            yesterday.setDate(yesterday.getDate() - 1);
+            return { start: yesterday, end: today };
+        case 'week':
+            const weekStart = new Date(today);
+            weekStart.setDate(weekStart.getDate() - 7);
+            return { start: weekStart, end: new Date() };
+        case 'month':
+            const monthStart = new Date(today);
+            monthStart.setMonth(monthStart.getMonth() - 1);
+            return { start: monthStart, end: new Date() };
+        case 'year':
+            const yearStart = new Date(today);
+            yearStart.setFullYear(yearStart.getFullYear() - 1);
+            return { start: yearStart, end: new Date() };
+        default:
+            return { start: null, end: null };
+    }
+}
diff --git a/static/locales/de.json b/static/locales/de.json
new file mode 100644
index 00000000..ab7a1d4d
--- /dev/null
+++ b/static/locales/de.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "KI-Zusammenfassung",
+    "aiSummarizationDesc": "OpenRouter- und Ollama-Integration mit benutzerdefinierten Prompts",
+    "asrEnabled": "ASR Aktiviert",
+    "asrEndpoint": "ASR-Endpunkt",
+    "audioTranscription": "Audio-Transkription",
+    "audioTranscriptionDesc": "Whisper API und benutzerdefinierte ASR-Unterstützung mit hoher Genauigkeit",
+    "backend": "Backend",
+    "database": "Datenbank",
+    "deployment": "Bereitstellung",
+    "dockerDescription": "Offizielle Docker Images",
+    "dockerHub": "Docker Hub",
+    "documentation": "Dokumentation",
+    "documentationDescription": "Setup-Anleitungen und Benutzerhandbuch",
+    "endpoint": "Endpunkt",
+    "frontend": "Frontend",
+    "githubDescription": "Quellcode, Issues und Releases",
+    "githubRepository": "GitHub Repository",
+    "inquireMode": "Anfrage-Modus",
+    "inquireModeDesc": "Semantische Suche in all Ihren Aufnahmen",
+    "interactiveChat": "Interaktiver Chat",
+    "interactiveChatDesc": "Chatten Sie mit Ihren Transkriptionen mittels KI",
+    "keyFeatures": "Hauptfunktionen",
+    "largeLanguageModel": "Großes Sprachmodell",
+    "model": "Modell",
+    "projectDescription": "Verwandeln Sie Ihre Audioaufnahmen in organisierte, durchsuchbare Notizen mit KI-gestützten Funktionen für Transkription, Zusammenfassung und interaktiven Chat.",
+    "projectLinks": "Projekt-Links",
+    "sharingExport": "Teilen & Exportieren",
+    "sharingExportDesc": "Teilen Sie Aufnahmen und exportieren Sie in verschiedene Formate",
+    "speakerDiarization": "Sprecher-Diarisierung",
+    "speakerDiarizationDesc": "Automatische Identifikation und Kennzeichnung verschiedener Sprecher",
+    "speechRecognition": "Spracherkennung",
+    "systemConfiguration": "Systemkonfiguration",
+    "tagline": "KI-gestützte Audio-Transkription und Notizen-App",
+    "technologyStack": "Technologie-Stack",
+    "title": "Über",
+    "version": "Version",
+    "whisperApi": "Whisper API"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "OpenRouter- und Ollama-Integration mit benutzerdefinierten Prompts",
+    "asrEnabled": "ASR Aktiviert",
+    "asrEndpoint": "ASR-Endpunkt",
+    "audioTranscriptionDesc": "Whisper-API und benutzerdefinierte ASR-Unterstützung mit hoher Genauigkeit",
+    "backend": "Backend",
+    "database": "Datenbank",
+    "deployment": "Bereitstellung",
+    "dockerDescription": "Offizielle Docker-Images",
+    "documentationDescription": "Setup-Anleitungen und Benutzerhandbuch",
+    "endpoint": "Endpunkt",
+    "frontend": "Frontend",
+    "githubDescription": "Quellcode, Issues und Releases",
+    "inquireModeDesc": "Semantische Suche in all Ihren Aufnahmen",
+    "interactiveChatDesc": "Chatten Sie mit Ihren Transkriptionen mithilfe von KI",
+    "model": "Modell",
+    "no": "Nein",
+    "sharingExportDesc": "Aufnahmen teilen und in verschiedene Formate exportieren",
+    "speakerDiarizationDesc": "Verschiedene Sprecher automatisch identifizieren und beschriften",
+    "whisperApi": "Whisper-API",
+    "yes": "Ja"
+  },
+  "account": {
+    "accountActions": "Kontoaktionen",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "Passwort ändern",
+    "chooseLanguageForInterface": "Wählen Sie die Sprache für die Anwendungsoberfläche",
+    "companyOrganization": "Unternehmen / Organisation",
+    "completedRecordings": "Abgeschlossen",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "E-Mail",
+    "failedRecordings": "Fehlgeschlagen",
+    "fullName": "Vollständiger Name",
+    "goToRecordings": "Zu den Aufnahmen gehen",
+    "interfaceLanguage": "Interface-Sprache",
+    "jobTitle": "Berufsbezeichnung",
+    "languageForSummaries": "Sprache für Titel, Zusammenfassungen und Chat. Leer lassen für Standard (Standardverhalten Ihrer gewählten Modelle).",
+    "languagePreferences": "Spracheinstellungen",
+    "leaveBlankForAutoDetect": "Leer lassen für automatische Erkennung durch den Transkriptionsdienst",
+    "manageSpeakers": "Sprecher verwalten",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "Persönliche Informationen",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "Bevorzugte Sprache für Chatbot und Zusammenfassungen",
+    "processingRecordings": "In Bearbeitung",
+    "saveAllPreferences": "Alle Einstellungen speichern",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "Kontostatistiken",
+    "title": "Kontoinformationen",
+    "totalRecordings": "Gesamte Aufnahmen",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "Transkriptionssprache",
+    "userDetails": "Benutzerdetails",
+    "username": "Benutzername"
+  },
+  "accountTabs": {
+    "about": "Über",
+    "apiTokens": "API-Token",
+    "customPrompts": "Benutzerdefinierte Prompts",
+    "folderManagement": "Ordnerverwaltung",
+    "namingTemplates": "Benennung",
+    "promptOptions": "Prompt-Optionen",
+    "sharedTranscripts": "Geteilte Transkripte",
+    "speakersManagement": "Sprecher-Verwaltung",
+    "tagManagement": "Tag-Verwaltung",
+    "templates": "Vorlagen",
+    "transcriptTemplates": "Transkript-Vorlagen",
+    "preferences": "Einstellungen"
+  },
+  "admin": {
+    "title": "Administration",
+    "userMenu": "Benutzermenü"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "Über den Nachfrage-Modus",
+    "actions": "AKTIONEN",
+    "addNewUser": "Neuen Benutzer Hinzufügen",
+    "addUser": "Benutzer hinzufügen",
+    "additionalContext": "Zusätzlicher Kontext",
+    "admin": "ADMIN",
+    "adminDefaultPrompt": "Admin Standard-Prompt",
+    "adminDefaultPromptDesc": "Der oben konfigurierte Prompt (auf dieser Seite angezeigt)",
+    "adminUser": "Administrator-Benutzer",
+    "allRecordingsProcessed": "Alle Aufnahmen sind verarbeitet!",
+    "allowed": "Allowed",
+    "available": "Verfügbar",
+    "blocked": "blockiert",
+    "budgetWarnings": "Budget-Warnungen",
+    "characters": "Zeichen",
+    "chunkSize": "Chunk-Größe",
+    "complete": "abgeschlossen",
+    "completedRecordings": "Abgeschlossen",
+    "confirmPasswordLabel": "Passwort Bestätigen",
+    "contextNotes": {
+      "jsonConversion": "JSON-Transkripte werden vor dem Senden in ein sauberes Textformat konvertiert",
+      "modelConfig": "Das verwendete Modell wird über die Umgebungsvariable TEXT_MODEL_NAME konfiguriert",
+      "tagPrompts": "Wenn mehrere Tag-Prompts existieren, werden sie in der Reihenfolge zusammengeführt, in der die Tags hinzugefügt wurden",
+      "transcriptLimit": "Transkripte sind auf eine konfigurierbare Zeichenanzahl begrenzt (Standard: 30.000)"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "Aktuelle Nutzung",
+    "currentUsageMinutes": "Aktuelle Nutzung",
+    "defaultPromptInfo": "Dieser Standard-Prompt wird für alle Benutzer verwendet, die keinen eigenen benutzerdefinierten Prompt in ihren Kontoeinstellungen festgelegt haben.",
+    "defaultPrompts": "Standard-Prompts",
+    "defaultSummarizationPrompt": "Standard-Zusammenfassungsprompt",
+    "description": "Description",
+    "editUser": "Benutzer Bearbeiten",
+    "email": "E-MAIL",
+    "emailLabel": "E-Mail",
+    "embeddingModel": "Einbettungsmodell",
+    "embeddingsStatus": "Einbettungsstatus",
+    "errors": {
+      "failedToLoadPrompt": "Fehler beim Laden des Standard-Prompts",
+      "failedToSavePrompt": "Fehler beim Speichern des Standard-Prompts. Bitte versuchen Sie es erneut.",
+      "invalidFileSize": "Bitte geben Sie eine gültige Größe zwischen 1 und 10000 MB ein",
+      "invalidInteger": "Bitte geben Sie eine gültige Ganzzahl ein",
+      "invalidNumber": "Bitte geben Sie eine gültige Zahl ein",
+      "maxTimeout": "Timeout kann 10 Stunden (36000 Sekunden) nicht überschreiten",
+      "minCharacters": "Bitte geben Sie eine gültige Anzahl von mindestens 1000 Zeichen ein",
+      "minTimeout": "Timeout muss mindestens 60 Sekunden betragen"
+    },
+    "failedRecordings": "Fehlgeschlagen",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "Der Nachfrage-Modus ermöglicht es Benutzern, mit natürlichen Sprachfragen über mehrere Transkriptionen zu suchen. Es funktioniert, indem Transkriptionen in Chunks aufgeteilt und durchsuchbare Einbettungen mit KI-Modellen erstellt werden.",
+    "languagePreferenceNote": "Hinweis: Wenn der Benutzer eine Ausgabesprachpräferenz festgelegt hat, wird \" Stellen Sie sicher, dass Ihre Antwort in {Sprache} ist.\" hinzugefügt.",
+    "lastUpdated": "Zuletzt aktualisiert",
+    "maxFileSizeHelp": "Maximale Dateigröße in Megabyte (1-10000 MB)",
+    "megabytes": "MB",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "Minuten",
+    "monthlyCost": "Monatliche Kosten",
+    "monthlyTokenBudget": "Monatliches Token-Budget",
+    "monthlyTranscriptionBudget": "Monatliches Transkriptionsbudget (Minuten)",
+    "needProcessing": "Benötigt Verarbeitung",
+    "never": "Nie",
+    "newPasswordLabel": "Neues Passwort (leer lassen, um das aktuelle zu behalten)",
+    "no": "Nein",
+    "noData": "Keine Daten",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "Keine Beschreibung verfügbar",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "Keine Begrenzung",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "Keine Transkriptionsnutzungsdaten verfügbar",
+    "none": "Keine",
+    "notSet": "Nicht festgelegt",
+    "overlap": "Überlappung",
+    "passwordLabel": "Passwort",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "Ausstehend",
+    "percentUsed": "verwendet",
+    "placeholdersNote": "Platzhalter werden beim Verarbeiten einer Aufnahme durch tatsächliche Werte ersetzt.",
+    "processAllRecordings": "Alle Aufnahmen Verarbeiten",
+    "processNext10": "Nächste 10 Verarbeiten",
+    "processedForInquire": "Für Nachfrage Verarbeitet",
+    "processing": "Verarbeitung läuft...",
+    "processingActions": "Verarbeitungsaktionen",
+    "processingProgress": "Verarbeitungsfortschritt",
+    "processingRecordings": "In Bearbeitung",
+    "promptDescription": "Dieser Prompt wird verwendet, um Zusammenfassungen für alle Aufnahmen zu generieren, wenn Benutzer keinen eigenen Prompt festgelegt haben.",
+    "promptHierarchy": "Prompt-Hierarchie",
+    "promptPriorityDescription": "Das System verwendet die folgende Prioritätsreihenfolge bei der Auswahl des zu verwendenden Prompts:",
+    "promptResetMessage": "Prompt auf Systemstandard zurückgesetzt. Klicken Sie auf \"Änderungen speichern\", um anzuwenden.",
+    "promptSavedSuccessfully": "Standard-Prompt erfolgreich gespeichert!",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "Verteilung des Aufnahmestatus",
+    "recordings": "AUFNAHMEN",
+    "recordingsNeedProcessing": "Es gibt {{count}} Aufnahmen, die für den Nachfrage-Modus verarbeitet werden müssen.",
+    "refreshStatus": "Status Aktualisieren",
+    "resetToDefault": "Auf Standard zurücksetzen",
+    "saving": "Speichern...",
+    "searchUsers": "Benutzer suchen...",
+    "seconds": "Sekunden",
+    "settings": {
+      "asrTimeoutDesc": "Maximale Zeit in Sekunden, um auf den Abschluss der ASR-Transkription zu warten. Standard ist 1800 Sekunden (30 Minuten).",
+      "defaultSummaryPromptDesc": "Standard-Zusammenfassungsprompt, der verwendet wird, wenn Benutzer keinen eigenen Prompt festgelegt haben. Dies dient als Basis-Prompt für alle Benutzer.",
+      "maxFileSizeDesc": "Maximale Dateigröße für Audio-Uploads in Megabyte (MB).",
+      "recordingDisclaimerDesc": "Rechtlicher Hinweis, der Benutzern vor Beginn der Aufnahme angezeigt wird. Unterstützt Markdown-Formatierung. Leer lassen zum Deaktivieren.",
+      "uploadDisclaimerDesc": "Rechtlicher Hinweis, der vor dem Hochladen von Dateien angezeigt wird. Unterstützt Markdown. Leer lassen zum Deaktivieren.",
+      "customBannerDesc": "Benutzerdefiniertes Banner oben auf der Seite. Unterstützt Markdown. Leer lassen zum Deaktivieren.",
+      "transcriptLengthLimitDesc": "Maximale Anzahl von Zeichen, die vom Transkript an das LLM für Zusammenfassung und Chat gesendet werden. Verwenden Sie -1 für kein Limit."
+    },
+    "storageUsed": "GENUTZTER SPEICHER",
+    "summarizationInstructions": "Zusammenfassungsanweisungen",
+    "systemFallback": "System-Fallback",
+    "systemFallbackDesc": "Ein hartcodierter Standard, wenn keiner der oben genannten festgelegt ist",
+    "systemPrompt": "System-Prompt",
+    "systemSettings": "Systemeinstellungen",
+    "systemStatistics": "Systemstatistiken",
+    "tagCustomPrompt": "Tag Benutzerdefinierter Prompt",
+    "tagCustomPromptDesc": "Wenn eine Aufnahme Tags mit benutzerdefinierten Prompts hat",
+    "textSearchOnly": "Nur Textsuche",
+    "thisMonth": "Dieser Monat",
+    "timeoutRecommendation": "Empfohlen: 30-120 Minuten für lange Audiodateien",
+    "title": "Administrator-Dashboard",
+    "todaysMinutes": "Heutige Minuten",
+    "tokenBudgetExceeded": "Monatliches Token-Budget überschritten. Bitte kontaktieren Sie Ihren Administrator.",
+    "tokenBudgetHelp": "Legen Sie ein monatliches Token-Limit für KI-Funktionen fest. Leer lassen für unbegrenzt.",
+    "tokenBudgetPlaceholder": "Leer lassen für unbegrenzt",
+    "tokenUsage": "Token-Nutzung",
+    "tokens": "Token",
+    "topUsers": "Top-Benutzer",
+    "topUsersByStorage": "Top-Benutzer nach Speicher",
+    "total": "Gesamt",
+    "totalChunks": "Gesamte Chunks",
+    "totalQueries": "Gesamte Abfragen",
+    "totalRecordings": "Gesamte Aufnahmen",
+    "totalStorage": "Gesamter Speicher",
+    "totalUsers": "Gesamte Benutzer",
+    "transcriptionBudgetHelp": "Begrenzen Sie die Transkriptionsminuten pro Monat. Leer lassen für unbegrenzt.",
+    "transcriptionBudgetPlaceholder": "Leer lassen für unbegrenzt",
+    "transcriptionUsage": "Transkriptionsnutzung",
+    "updateUser": "Benutzer Aktualisieren",
+    "userCustomPrompt": "Benutzerdefinierter Prompt",
+    "userCustomPromptDesc": "Wenn der Benutzer seinen eigenen Prompt in den Kontoeinstellungen festgelegt hat",
+    "userManagement": "Benutzerverwaltung",
+    "userMessageTemplate": "Benutzernachricht-Vorlage",
+    "userTranscriptionUsage": "Benutzer-Transkriptionsnutzung (Dieser Monat)",
+    "username": "BENUTZERNAME",
+    "usernameLabel": "Benutzername",
+    "vectorDimensions": "Vektordimensionen",
+    "vectorStore": "Vektorspeicher",
+    "vectorStoreManagement": "Vektorspeicher-Verwaltung",
+    "vectorStoreUpToDate": "Der Vektorspeicher ist auf dem neuesten Stand.",
+    "viewFullPromptStructure": "Vollständige LLM-Prompt-Struktur anzeigen",
+    "warning": "Warnung",
+    "yes": "Ja"
+  },
+  "apiTokens": {
+    "activeTokens": "Aktive Token",
+    "createFirstToken": "Erstellen Sie Ihr erstes API-Token, um programmgesteuerten Zugriff zu ermöglichen",
+    "createToken": "Token erstellen",
+    "created": "Erstellt",
+    "description": "Erstellen und verwalten Sie API-Token für den programmgesteuerten Zugriff auf Ihr Konto",
+    "expires": "Läuft ab",
+    "lastUsed": "Zuletzt verwendet",
+    "neverUsed": "Nie verwendet",
+    "noExpiration": "Kein Ablaufdatum",
+    "noTokens": "Keine API-Token",
+    "securityNotice": "Sicherheitshinweis",
+    "securityWarning": "Behandeln Sie API-Token wie Passwörter. Sie bieten vollen Zugriff auf Ihr Konto. Teilen Sie Token niemals in öffentlich zugänglichen Bereichen wie GitHub, clientseitigem Code oder Logs",
+    "title": "API-Token",
+    "usageExamples": "Verwendungsbeispiele"
+  },
+  "buttons": {
+    "addSegment": "Segment Hinzufügen",
+    "addSpeaker": "Sprecher hinzufügen",
+    "cancel": "Cancel",
+    "clearAllFilters": "Alle Filter löschen",
+    "clearCompleted": "Abgeschlossene Uploads löschen",
+    "clearSearchText": "Suchtext löschen",
+    "close": "Close",
+    "copy": "Kopieren",
+    "copyMessage": "Nachricht kopieren",
+    "copyNotes": "Notizen kopieren",
+    "copySummary": "Zusammenfassung kopieren",
+    "copyToClipboard": "In Zwischenablage kopieren",
+    "createTag": "Create Tag",
+    "deleteAll": "Delete All",
+    "deleteSpeaker": "Sprecher löschen",
+    "deleteTag": "Tag löschen",
+    "deleteUser": "Benutzer löschen",
+    "downloadAsWord": "Als Word herunterladen",
+    "downloadAudio": "Audio herunterladen",
+    "downloadChat": "Chat als Word-Dokument herunterladen",
+    "downloadNotes": "Notizen als Word-Dokument herunterladen",
+    "downloadSummary": "Zusammenfassung als Word-Dokument herunterladen",
+    "editNotes": "Notizen bearbeiten",
+    "editSetting": "Einstellung bearbeiten",
+    "editSpeakers": "Sprecher bearbeiten...",
+    "editSummary": "Zusammenfassung bearbeiten",
+    "editTag": "Tag bearbeiten",
+    "editTags": "Tags bearbeiten",
+    "editTranscription": "Transkription bearbeiten",
+    "editUser": "Benutzer bearbeiten",
+    "exportCalendar": "In Kalender exportieren",
+    "help": "Hilfe",
+    "identifySpeakers": "Sprecher identifizieren",
+    "next": "Weiter",
+    "previous": "Zurück",
+    "refresh": "Refresh",
+    "reprocessSummary": "Zusammenfassung neu verarbeiten",
+    "reprocessTranscription": "Transkription neu verarbeiten",
+    "reprocessWithAsr": "Mit ASR neu verarbeiten",
+    "resetStuckProcessing": "Blockierte Verarbeitung zurücksetzen",
+    "saveChanges": "Änderungen speichern",
+    "saveCustomPrompt": "Save Custom Prompt",
+    "saveNames": "Namen speichern",
+    "saveSettings": "Einstellungen Speichern",
+    "shareRecording": "Aufnahme teilen",
+    "toggleTheme": "Design umschalten",
+    "updateTag": "Update Tag"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Neues Passwort Bestätigen",
+    "currentPassword": "Aktuelles Passwort",
+    "newPassword": "Neues Passwort",
+    "passwordRequirement": "Das Passwort muss mindestens 8 Zeichen lang sein",
+    "title": "Passwort Ändern"
+  },
+  "chat": {
+    "availableAfterTranscription": "Chat wird verfügbar sein, sobald die Transkription abgeschlossen ist",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "Mit Transkription chatten",
+    "clearChat": "Chat löschen",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "Nachricht konnte nicht gesendet werden",
+    "noMessages": "Noch keine Nachrichten",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "Eine Frage zu dieser Aufnahme stellen...",
+    "placeholderWithHint": "Eine Frage zu dieser Aufnahme stellen... (Enter zum Senden, Strg+Enter für neue Zeile)",
+    "send": "Senden",
+    "suggestedQuestions": "Vorgeschlagene Fragen",
+    "thinking": "Denke nach...",
+    "title": "Chat",
+    "whatAreActionItems": "Was sind die Aktionspunkte?",
+    "whatAreKeyPoints": "Was sind die wichtigsten Punkte?",
+    "whatWasDiscussed": "Was wurde besprochen?",
+    "whoSaidWhat": "Wer hat was gesagt?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Wählen Sie eine Aufnahme aus der Seitenleiste, um ihre Transkription und Zusammenfassung zu sehen",
+    "darkThemes": "Dunkle Themen",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "Helle Themen",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "Auf Standard zurücksetzen",
+    "selectRecording": "Eine Aufnahme auswählen",
+    "subtitle": "Passen Sie Ihre Benutzeroberfläche mit schönen Farbthemen an",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Ozeanblau",
+          "description": "Klassisches Blau-Thema mit professioneller Anmutung"
+        },
+        "emerald": {
+          "name": "Waldsmaragd",
+          "description": "Frisches grünes Thema für natürliches Gefühl"
+        },
+        "purple": {
+          "name": "Königslila",
+          "description": "Elegantes Lila-Thema mit Raffinesse"
+        },
+        "rose": {
+          "name": "Sonnenuntergang-Rose",
+          "description": "Warmes Rosa-Thema mit sanfter Energie"
+        },
+        "amber": {
+          "name": "Goldenes Bernstein",
+          "description": "Warmes Gelb-Thema für Helligkeit"
+        },
+        "teal": {
+          "name": "Ozean-Türkis",
+          "description": "Kühles Türkis-Thema für Ruhe"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Mitternachtsblau",
+          "description": "Tiefes Blau-Thema für konzentriertes Arbeiten"
+        },
+        "emerald": {
+          "name": "Dunkler Wald",
+          "description": "Sattes grünes Thema für angenehmes Betrachten"
+        },
+        "purple": {
+          "name": "Tiefes Lila",
+          "description": "Mysteriöses Lila-Thema für Kreativität"
+        },
+        "rose": {
+          "name": "Dunkle Rose",
+          "description": "Gedämpftes Rosa-Thema mit subtiler Wärme"
+        },
+        "amber": {
+          "name": "Dunkles Bernstein",
+          "description": "Warmes Braun-Thema für gemütliche Sitzungen"
+        },
+        "teal": {
+          "name": "Tiefes Türkis",
+          "description": "Dunkles Türkis-Thema für ruhigen Fokus"
+        }
+      }
+    },
+    "title": "Farbschema wählen"
+  },
+  "common": {
+    "back": "Zurück",
+    "cancel": "Abbrechen",
+    "changesSaved": "Änderungen gespeichert",
+    "close": "Schließen",
+    "confirm": "Bestätigen",
+    "delete": "Löschen",
+    "deselectAll": "Alle abwählen",
+    "download": "Herunterladen",
+    "edit": "Bearbeiten",
+    "error": "Fehler",
+    "failed": "Fehlgeschlagen",
+    "filter": "Filter",
+    "info": "Info",
+    "loading": "Lädt...",
+    "new": "Neu",
+    "next": "Weiter",
+    "no": "Nein",
+    "noResults": "Keine Ergebnisse gefunden",
+    "ok": "OK",
+    "or": "Oder",
+    "previous": "Vorherige",
+    "processing": "Verarbeite...",
+    "refresh": "Aktualisieren",
+    "retry": "Wiederholen",
+    "save": "Speichern",
+    "search": "Suchen",
+    "selectAll": "Alle auswählen",
+    "sort": "Sortieren",
+    "success": "Erfolgreich",
+    "untitled": "Unbenannt",
+    "upload": "Hochladen",
+    "warning": "Warnung",
+    "yes": "Ja"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Aktueller Standard-Prompt (Wird verwendet, wenn Sie das obige Feld leer lassen)",
+    "promptDescription": "Dieser Prompt wird verwendet, um Zusammenfassungen Ihrer Transkriptionen zu generieren. Er überschreibt den Standardprompt des Administrators.",
+    "promptPlaceholder": "Beschreiben Sie, wie Ihre Zusammenfassungen strukturiert sein sollen. Leer lassen, um den Standard-Prompt des Administrators zu verwenden.",
+    "summaryGeneration": "Zusammenfassungsgenerierungs-Prompt",
+    "tip1": "Seien Sie spezifisch bezüglich der Abschnitte, die Sie in Ihrer Zusammenfassung wünschen",
+    "tip2": "Verwenden Sie klare Formatierungsanweisungen (z.B. \"Verwenden Sie Aufzählungszeichen\", \"Erstellen Sie nummerierte Listen\")",
+    "tip3": "Geben Sie an, wenn Sie möchten, dass bestimmte Informationen priorisiert werden",
+    "tip4": "Das System wird automatisch den Transkriptionsinhalt an die KI weiterleiten",
+    "tip5": "Ihre Ausgabesprachen-Präferenz (falls gesetzt) wird automatisch angewendet",
+    "tipsTitle": "Tipps für das Schreiben Effektiver Prompts",
+    "yourCustomPrompt": "Ihr Benutzerdefinierter Zusammenfassungs-Prompt"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "Sind Sie sicher, dass Sie alle gespeicherten Sprecher löschen möchten? Diese Aktion kann nicht rückgängig gemacht werden.",
+    "title": "Alle Sprecher Löschen"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Abbrechen",
+      "confirm": "Löschen",
+      "message": "Sind Sie sicher, dass Sie diese Aufnahme löschen möchten? Diese Aktion kann nicht rückgängig gemacht werden.",
+      "title": "Aufnahme löschen"
+    },
+    "deleteShare": {
+      "message": "Sind Sie sicher, dass Sie diese Freigabe löschen möchten? Dadurch wird der Zugriff auf den öffentlichen Link widerrufen.",
+      "title": "Freigabe löschen"
+    },
+    "reprocessTranscription": {
+      "cancel": "Abbrechen",
+      "confirm": "Neu verarbeiten",
+      "message": "Sind Sie sicher, dass Sie diese Transkription neu verarbeiten möchten? Die aktuelle Transkription wird ersetzt.",
+      "title": "Transkription neu verarbeiten"
+    },
+    "unsavedChanges": {
+      "cancel": "Abbrechen",
+      "discard": "Verwerfen",
+      "message": "Sie haben ungespeicherte Änderungen. Möchten Sie diese vor dem Verlassen speichern?",
+      "save": "Speichern",
+      "title": "Ungespeicherte Änderungen"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} Stunde",
+    "hoursPlural": "{{count}} Stunden",
+    "minutes": "{{count}} Minute",
+    "minutesPlural": "{{count}} Minuten",
+    "seconds": "{{count}} Sekunde",
+    "secondsPlural": "{{count}} Sekunden"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "ASR-Standard-Einstellungen",
+    "asrSettingsDescription": "Diese Einstellungen werden standardmäßig angewendet, wenn dieser Tag mit ASR-Transkription verwendet wird",
+    "color": "Farbe",
+    "colorDescription": "Wählen Sie eine Farbe zur einfachen Identifikation",
+    "createTitle": "Tag Erstellen",
+    "customPrompt": "Benutzerdefinierter Zusammenfassungs-Prompt",
+    "customPromptPlaceholder": "Optional: Benutzerdefinierter Prompt für die Generierung von Zusammenfassungen für Aufnahmen mit diesem Tag",
+    "defaultLanguage": "Standard-Sprache",
+    "defaultPromptPlaceholder": "Leer lassen, um Ihren Standard-Zusammenfassungs-Prompt zu verwenden",
+    "exportTemplate": "Exportvorlage",
+    "exportTemplateHint": "Wählen Sie eine Exportvorlage für den Export von Aufnahmen mit diesem Tag",
+    "leaveBlankPrompt": "Leer lassen, um Ihren Standard-Zusammenfassungs-Prompt zu verwenden",
+    "maxSpeakers": "Maximale Sprecheranzahl",
+    "minSpeakers": "Minimale Sprecheranzahl",
+    "namingTemplate": "Benennungsvorlage",
+    "namingTemplateHint": "Wählen Sie eine Benennungsvorlage, um Titel für Aufnahmen mit diesem Tag automatisch zu formatieren",
+    "noExportTemplate": "Keine Vorlage (Benutzerstandard verwenden)",
+    "noNamingTemplate": "Keine Vorlage (Standard oder KI-Titel verwenden)",
+    "tagName": "Tag-Name *",
+    "tagNamePlaceholder": "z.B. Meetings, Interviews",
+    "title": "Tag Bearbeiten",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "Dieses Tag ist als Watch-Folder konfiguriert und der Prompt enthält Platzhalter-Variablen. Über das Auto-Process-Verzeichnis verarbeitete Aufnahmen haben keine Oberfläche, in der Benutzer diese Werte eingeben könnten, daher werden die Platzhalter beim ersten Zusammenfassungslauf durch leere Zeichenketten ersetzt. Entferne die Platzhalter oder fülle die Werte nach dem Hochladen über die erneute Verarbeitung aus."
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "音频录制失败。请检查您的麦克风。",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "文件太大",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "发生错误",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "Fehler beim Laden der Freigaben",
+    "networkError": "网络错误。请检查您的连接。",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "未找到",
+    "permissionDenied": "权限被拒绝",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "存储配额已超出",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "服务器错误。请稍后重试。",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "摘要生成失败。请重试。",
+    "transcriptionFailed": "转录失败。请重试。",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "未授权",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "不支持的文件格式",
+    "uploadFailed": "上传失败。请重试。",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "验证错误",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "Wenn aktiviert, identifiziert die KI Meetings, Termine und Fristen in Ihren Aufnahmen und erstellt herunterladbare Kalenderereignisse.",
+    "enableLabel": "Automatische Ereignisextraktion aus Transkripten aktivieren",
+    "info": "Extrahierte Ereignisse erscheinen im 'Ereignisse'-Tab bei Aufnahmen, in denen Kalenderelemente erkannt werden.",
+    "title": "Ereignisextraktion"
+  },
+  "events": {
+    "add": "Hinzufügen",
+    "addToCalendar": "Zum Kalender Hinzufügen",
+    "attendees": "Teilnehmer",
+    "confirmDelete": "Ereignis \"{title}\" löschen?",
+    "delete": "Löschen",
+    "deleteFailed": "Ereignis konnte nicht gelöscht werden",
+    "deleted": "Ereignis gelöscht",
+    "end": "Ende",
+    "location": "Ort",
+    "noEvents": "Keine Ereignisse in dieser Aufnahme erkannt",
+    "start": "Beginn",
+    "title": "Ereignisse"
+  },
+  "exportLabels": {
+    "created": "Erstellt",
+    "date": "Datum",
+    "fileSize": "Dateigröße",
+    "footer": "Erstellt mit [Speakr](https://github.com/learnedmachine/speakr)",
+    "metadata": "Metadaten",
+    "notes": "Notizen",
+    "originalFile": "Originaldatei",
+    "participants": "Teilnehmer",
+    "summarizationTime": "Zusammenfassungszeit",
+    "summary": "Zusammenfassung",
+    "tags": "Tags",
+    "transcription": "Transkription",
+    "transcriptionTime": "Transkriptionszeit"
+  },
+  "exportTemplates": {
+    "availableLabels": "Lokalisierte Bezeichnungen (automatisch übersetzt)",
+    "availableTemplates": "Verfügbare Vorlagen",
+    "availableVars": "Verfügbare Variablen",
+    "cancel": "Abbrechen",
+    "conditionals": "Bedingungen",
+    "conditionalsHint": "Verwenden Sie {{#if variable}}...{{/if}}, um Inhalte bedingt einzuschließen",
+    "contentSections": "Inhaltsbereiche",
+    "createDefaults": "Standardvorlage erstellen",
+    "createNew": "Vorlage erstellen",
+    "default": "Standard",
+    "delete": "Löschen",
+    "description": "Passen Sie an, wie Aufnahmen in Markdown-Dateien exportiert werden.",
+    "recordingData": "Aufnahmedaten",
+    "save": "Speichern",
+    "selectOrCreate": "Wählen Sie eine Vorlage zum Bearbeiten oder erstellen Sie eine neue",
+    "setDefault": "Als Standardvorlage festlegen",
+    "tabTitle": "Export",
+    "template": "Vorlage",
+    "templateDescription": "Beschreibung",
+    "templateName": "Vorlagenname",
+    "title": "Export-Vorlagen",
+    "viewGuide": "Vorlagen-Leitfaden anzeigen"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "Alle Ordner",
+    "asrDefaults": "ASR-Standardwerte",
+    "autoShareOnApply": "Automatisch mit Gruppenmitgliedern teilen",
+    "autoShareOnApplyHelp": "Aufnahmen automatisch mit allen Gruppenmitgliedern teilen, wenn sie diesem Ordner hinzugefügt werden",
+    "confirmDelete": "Möchten Sie diesen Ordner wirklich löschen? Aufnahmen werden aus dem Ordner entfernt, aber nicht gelöscht.",
+    "createFolder": "Ordner erstellen",
+    "customPrompt": "Benutzerdefinierter Prompt",
+    "defaultLanguage": "Standardsprache",
+    "deleteFolder": "Ordner löschen",
+    "description": "Organisieren Sie Ihre Aufnahmen in Ordnern. Im Gegensatz zu Tags kann eine Aufnahme nur einem Ordner zugeordnet werden. Ordner-Prompts werden vor Benutzer-Prompts, aber nach Tag-Prompts angewendet.",
+    "editFolder": "Ordner bearbeiten",
+    "filterByFolder": "Nach Ordner filtern",
+    "folderColor": "Ordnerfarbe",
+    "folderName": "Ordnername",
+    "groupSettings": "Gruppeneinstellungen",
+    "maxSpeakers": "Max. Sprecher",
+    "minSpeakers": "Min. Sprecher",
+    "moveToFolder": "In Ordner verschieben",
+    "namingTemplate": "Benennungsvorlage",
+    "noFolder": "Kein Ordner",
+    "noFolders": "Noch keine Ordner erstellt",
+    "noFoldersDescription": "Erstellen Sie Ihren ersten Ordner, um Ihre Aufnahmen zu organisieren",
+    "protectFromDeletion": "Vor Löschung schützen",
+    "protectFromDeletionHelp": "Aufnahmen in diesem Ordner vor automatischer Löschung schützen",
+    "recordings": "Aufnahmen",
+    "removeFromFolder": "Aus Ordner entfernen",
+    "retentionDays": "Aufbewahrungstage",
+    "retentionDaysHelp": "Aufnahmen in diesem Ordner werden nach dieser Anzahl von Tagen gelöscht. Leer lassen für globale Aufbewahrungsregel.",
+    "retentionSettings": "Aufbewahrungseinstellungen",
+    "selectNamingTemplate": "Benennungsvorlage auswählen...",
+    "shareWithGroupLead": "Mit Gruppenadministratoren teilen",
+    "shareWithGroupLeadHelp": "Aufnahmen mit Gruppenadministratoren teilen, wenn sie diesem Ordner hinzugefügt werden",
+    "title": "Ordnerverwaltung"
+  },
+  "form": {
+    "auto": "Auto",
+    "autoDetect": "Automatisch erkennen",
+    "dateFrom": "Von",
+    "dateTo": "Bis",
+    "enterNotesMarkdown": "Notizen im Markdown-Format eingeben...",
+    "enterSummaryMarkdown": "Zusammenfassung im Markdown-Format eingeben...",
+    "folder": "Folder",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "Sprache",
+    "maxSpeakers": "Max. Sprecher",
+    "meetingDate": "Meeting-Datum",
+    "minSpeakers": "Min. Sprecher",
+    "minutes": "Minuten",
+    "notes": "Notizen",
+    "notesPlaceholder": "Geben Sie Ihre Notizen im Markdown-Format ein...",
+    "optional": "Optional",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "Teilnehmer",
+    "placeholderAuto": "Auto",
+    "placeholderCharacterLimit": "Zeichenlimit eingeben (z.B. 30000)",
+    "placeholderMinutes": "Minuten",
+    "placeholderOptional": "Optional",
+    "placeholderSeconds": "Sekunden",
+    "placeholderSizeMB": "Größe in MB eingeben",
+    "searchSpeakers": "Sprecher suchen...",
+    "searchTags": "Tags suchen...",
+    "seconds": "Sekunden",
+    "shareNotes": "Notizen teilen",
+    "shareSummary": "Zusammenfassung teilen",
+    "shareableLink": "Teilbarer Link",
+    "summaryPromptPlaceholder": "Standard-Zusammenfassungsprompt eingeben...",
+    "title": "Titel",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "Ihr vollständiger Name",
+    "transcriptionModel": "Transkriptionsmodell",
+    "useResolvedDefault": "(Tag-/Ordner-/globalen Standard verwenden)",
+    "defaultTranscriptionModel": "Standard-Transkriptionsmodell",
+    "defaultTranscriptionModelHelp": "Überschreibt das Transkriptionsmodell für Aufnahmen mit diesem Tag oder Ordner."
+  },
+  "groups": {
+    "addMembers": "Mitglieder hinzufügen...",
+    "autoShare": "Automatisch teilen",
+    "autoShareNote": "Hinweis: Wenn beide aktiviert sind, haben alle Team-Mitglieder Zugriff. Wenn nur \"Team-Administratoren\" aktiviert ist, haben nur Teamleiter Zugriff.",
+    "autoShareTeam": "Aufnahmen automatisch mit allen Team-Mitgliedern teilen, wenn dieser Tag angewendet wird",
+    "autoSharesWithTeam": "Teilt automatisch mit allen Team-Mitgliedern",
+    "confirmDelete": "Sind Sie sicher, dass Sie dieses Team löschen möchten? Diese Aktion kann nicht rückgängig gemacht werden.",
+    "createTeam": "Team erstellen",
+    "createTeamTag": "Neuen Team-Tag erstellen",
+    "dayRetention": "Tage Aufbewahrung",
+    "deleteTeam": "Team löschen",
+    "deletionExempt": "Von Löschung ausgenommen",
+    "deletionExemptHelp": "Aufnahmen mit diesem Tag werden von der automatischen Löschung ausgenommen, auch wenn sie die Aufbewahrungsdauer überschreiten.",
+    "editTeam": "Team bearbeiten",
+    "editTeamTag": "Team-Tag bearbeiten",
+    "globalRetention": "Globale Aufbewahrung",
+    "members": "Mitglieder",
+    "noMembers": "Keine Mitglieder in diesem Team",
+    "noTeamTags": "Noch keine Team-Tags erstellt",
+    "noTeams": "Noch keine Teams erstellt",
+    "retentionHelp": "Aufnahmen mit diesem Tag werden nach dieser Anzahl von Tagen gelöscht. Leer lassen für globale Aufbewahrung ({{days}} Tage).",
+    "retentionPeriod": "Aufbewahrungsdauer (Tage)",
+    "retentionPlaceholder": "Leer lassen für globale Aufbewahrung",
+    "searchUsers": "Benutzer suchen...",
+    "selectTeamLead": "Teamleiter auswählen...",
+    "shareWithAdmins": "Aufnahmen mit Team-Administratoren teilen, wenn dieser Tag angewendet wird",
+    "sharesWithAdminsOnly": "Teilt nur mit Team-Administratoren",
+    "syncComplete": "Team-Freigaben erfolgreich synchronisiert",
+    "syncTeamShares": "Team-Freigaben synchronisieren",
+    "syncTeamSharesDescription": "Dadurch werden alle Aufnahmen mit Team-Tags rückwirkend mit den entsprechenden Team-Mitgliedern gemäß den Freigabeeinstellungen des Tags geteilt.",
+    "teamLead": "Teamleiter",
+    "teamName": "Team-Name",
+    "teamNamePlaceholder": "Team-Name eingeben",
+    "teamTags": "Team-Tags",
+    "title": "Gruppenverwaltung",
+    "updateTeam": "Team aktualisieren"
+  },
+  "help": {
+    "actions": "Aktionen",
+    "activeFilters": "Aktive Filter",
+    "addSegmentBelow": "Segment darunter hinzufügen",
+    "advancedAsrOptions": "Erweiterte ASR-Optionen",
+    "allRecordingsLoaded": "Alle Aufnahmen geladen",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "{{count}} vorgeschlagener Name angewendet",
+    "appliedSuggestedNamesPlural": "{{count}} vorgeschlagene Namen angewendet",
+    "applySuggested": "Vorschläge anwenden",
+    "applySuggestedMobile": "Vorschlag",
+    "approachingLimit": "Nähert sich {{limit}}MB-Limit",
+    "askAboutTranscription": "Fragen zu dieser Transkription stellen",
+    "audioDeletedDescription": "Die Audiodatei für diese Aufnahme wurde gelöscht, aber die Transkription ist weiterhin verfügbar.",
+    "audioDeletedMessage": "Audiodatei wurde archiviert und ist nicht mehr zur Wiedergabe verfügbar.",
+    "audioDeletedTitle": "Audiodatei gelöscht",
+    "audioPlayer": "Audio-Player",
+    "autoIdentify": "Automatisch identifizieren",
+    "autoIdentifyMobile": "Auto",
+    "bothAudioDesc": "Nimmt Ihre Stimme + Meeting-Teilnehmer auf (empfohlen für Online-Meetings)",
+    "clearFilters": "Filter löschen",
+    "clickToAddNotes": "Klicken um Notizen hinzuzufügen...",
+    "colorRepeats": "Farbe wiederholt sich ab Sprecher {{number}}",
+    "completedFiles": "Abgeschlossene Dateien",
+    "confirmReprocessingTitle": "Neu-Verarbeitung bestätigen",
+    "copyMessage": "Nachricht kopieren",
+    "createFolders": "Create folders",
+    "createPublicLink": "Einen öffentlichen Link erstellen, um diese Aufnahme zu teilen. Teilen ist nur bei sicheren (HTTPS) Verbindungen verfügbar.",
+    "createTags": "Tags erstellen",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "Segment löschen",
+    "discard": "Verwerfen",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "Ende",
+    "enterNameFor": "Namen eingeben für",
+    "enterSpeakerName": "Sprechername eingeben...",
+    "entireScreen": "Gesamter Bildschirm",
+    "errorChangingSpeaker": "Fehler beim Wechseln des Sprechers",
+    "errorOpeningTextEditor": "Fehler beim Öffnen des Texteditors",
+    "errorSavingText": "Fehler beim Speichern des Textes",
+    "estimatedSize": "Geschätzte Größe",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "Generiere Zusammenfassung...",
+    "groups": "Gruppen",
+    "howToRecordSystemAudio": "Wie man System-Audio aufnimmt",
+    "identifyAllSpeakers": "Alle Sprecher identifizieren",
+    "identifying": "Identifiziere...",
+    "importantNote": "Wichtiger Hinweis",
+    "internalSharingDesc": "Mit bestimmten Benutzern in Ihrer Organisation teilen",
+    "lines": "{{count}} Zeilen",
+    "loadingMore": "Lade weitere Aufnahmen...",
+    "loadingRecordings": "Lade Aufnahmen...",
+    "me": "Ich",
+    "microphoneDesc": "Nimmt nur Ihre Stimme auf",
+    "modelReasoning": "Modell-Begründung",
+    "moreSpeakersThanColors": "Mehr Sprecher als verfügbare Farben",
+    "navigate": "Navigiere",
+    "noDateSet": "Kein Datum gesetzt",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "Keine Teilnehmer",
+    "noRecordingSelected": "Keine Aufnahme ausgewählt.",
+    "noSpeakersIdentified": "Es konnten keine Sprecher aus dem Kontext identifiziert werden.",
+    "noSuggestionsToApply": "Keine Vorschläge zum Anwenden",
+    "noTagsCreated": "Noch keine Tags erstellt.",
+    "of": "von",
+    "playFromHere": "Von hier abspielen",
+    "pleaseEnterSpeakerName": "Bitte geben Sie einen Sprechernamen ein",
+    "processingTime": "Verarbeitungszeit",
+    "processingTimeDescription": "Dies kann einige Minuten dauern. Sie können die App während der Verarbeitung weiter verwenden.",
+    "processingTranscription": "Verarbeite Transkription...",
+    "publicLinkDesc": "Jeder mit diesem Link kann auf die Aufnahme zugreifen",
+    "recordSystemSteps1": "Klicken Sie auf \"System-Audio aufnehmen\" oder \"Beides aufnehmen\".",
+    "recordSystemSteps2": "Im Popup wählen Sie",
+    "recordSystemSteps3": "Stellen Sie sicher, dass Sie das Kästchen ankreuzen, das sagt",
+    "recordingFinished": "Aufnahme beendet",
+    "recordingInProgress": "Aufnahme läuft...",
+    "regenerateSummaryAfterNames": "Zusammenfassung nach Namens-Update neu generieren",
+    "saved": "Gespeichert!",
+    "savingProgress": "Wird gespeichert...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "Satz",
+    "shareSystemAudio": "System-Audio teilen",
+    "shareTabAudio": "Tab-Audio teilen",
+    "sharedOn": "Geteilt am",
+    "sharingWindowNoAudio": "Das Teilen eines \"Fensters\" nimmt kein Audio auf.",
+    "speakerAdded": "Sprecher erfolgreich hinzugefügt",
+    "speakerCount": "Sprecher",
+    "speakerName": "Sprechername",
+    "speakerNamesUpdated": "Sprechernamen erfolgreich aktualisiert!",
+    "speakers": "Sprecher",
+    "speakersIdentified": "{{count}} Sprecher erfolgreich identifiziert!",
+    "speakersIdentifiedPlural": "{{count}} Sprecher erfolgreich identifiziert!",
+    "speakersUpdatedSaveToApply": "Sprecher aktualisiert! Speichern Sie die Transkription, um die Änderungen zu übernehmen.",
+    "specificBrowserTab": "spezifischen Browser-Tab",
+    "startTime": "Start",
+    "startingAutoIdentification": "Automatische Sprecheridentifikation wird gestartet...",
+    "summaryGenerationFailed": "Zusammenfassungsgenerierung fehlgeschlagen",
+    "summaryGenerationTimedOut": "Zeitüberschreitung bei der Zusammenfassungsgenerierung",
+    "summaryRegenerationStarted": "Neugenerierung der Zusammenfassung gestartet",
+    "summaryUpdated": "Zusammenfassung aktualisiert!",
+    "systemAudioDesc": "Nimmt Meeting-Teilnehmer und Systemklänge auf",
+    "tagManagement": "Tag-Verwaltung",
+    "thisActionCannotBeUndone": "Diese Aktion kann nicht rückgängig gemacht werden.",
+    "toCaptureAudioFromMeetings": "Um Audio von Besprechungen oder anderen Apps aufzunehmen, müssen Sie Ihren Bildschirm oder einen Browser-Tab freigeben.",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "Transkription erfolgreich aktualisiert!",
+    "troubleshooting": "Fehlerbehebung",
+    "tryAdjustingSearch": "Versuchen Sie Ihre Suche anzupassen oder",
+    "unsupportedBrowser": "Nicht unterstützter Browser",
+    "untitled": "Unbenannte Aufnahme",
+    "uploadRecordingNotes": "Aufnahme und Notizen hochladen",
+    "whatWillHappen": "Was wird passieren?",
+    "whyNotWorking": "Warum funktioniert es nicht?",
+    "youHaveXSpeakers": "Sie haben {{count}} Sprecher, aber nur 16 eindeutige Farben sind verfügbar. Die Farben wiederholen sich nach dem 16. Sprecher."
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "Aktive Filter:",
+    "askQuestions": "Fragen Sie zu Ihren Transkriptionen",
+    "clearAll": "Alle löschen",
+    "dateRange": "Datumsbereich",
+    "dateRangeActive": "Datumsbereich aktiv",
+    "exampleQuestion1": "\"Welche Aktionspunkte wurden besprochen?\"",
+    "exampleQuestion2": "\"Wann haben wir beschlossen, den Zeitplan zu ändern?\"",
+    "exampleQuestion3": "\"Welche Bedenken wurden bezüglich des Budgets geäußert?\"",
+    "exampleQuestion4": "\"Wer war für die Marketing-Aufgaben verantwortlich?\"",
+    "exampleQuestions": "Beispielfragen:",
+    "filters": "Filter",
+    "filtersActive": "Filter aktiv",
+    "from": "Von",
+    "noSpeakerData": "Keine Sprecherdaten verfügbar",
+    "placeholder": "Stellen Sie Fragen zu Ihren gefilterten Transkriptionen...",
+    "selectFilters": "Wählen Sie Filter auf der linken Seite aus, um Ihre Transkriptionen einzugrenzen, und stellen Sie dann Fragen, um Einblicke aus Ihren Aufnahmen zu erhalten.",
+    "sendHint": "Enter zum Senden • Strg+Enter für neue Zeile",
+    "speakerRequirement": "Sprecheridentifikation erfordert Aufnahmen mit mehreren Sprechern",
+    "speakers": "Sprecher",
+    "speakersCount": "Sprecher",
+    "tags": "Tags",
+    "tagsCount": "Tags",
+    "title": "Nachfragen",
+    "to": "Bis"
+  },
+  "languages": {
+    "ar": "Arabisch",
+    "de": "Deutsch",
+    "en": "Englisch",
+    "es": "Spanisch",
+    "fr": "Französisch",
+    "hi": "Hindi",
+    "it": "Italienisch",
+    "ja": "Japanisch",
+    "ko": "Koreanisch",
+    "nl": "Niederländisch",
+    "pt": "Portugiesisch",
+    "pt-BR": "Portugiesisch (Brasilien)",
+    "ru": "Russisch",
+    "zh": "Chinesisch",
+    "pl": "Polnisch",
+    "uk": "Ukrainisch",
+    "vi": "Vietnamesisch",
+    "th": "Thailändisch",
+    "tr": "Türkisch",
+    "id": "Indonesisch",
+    "sv": "Schwedisch",
+    "autoDetect": "Automatisch erkennen",
+    "defaultModelDecides": "Standard (Modell entscheidet)"
+  },
+  "manageSpeakersModal": {
+    "created": "Erstellt",
+    "description": "Verwalten Sie Ihre gespeicherten Sprecher. Diese werden automatisch gespeichert, wenn Sie Sprechernamen in Ihren Aufnahmen verwenden.",
+    "failedToLoad": "Fehler beim Laden der Sprecher",
+    "lastUsed": "Zuletzt verwendet",
+    "loadingSpeakers": "Sprecher werden geladen...",
+    "noSpeakersYet": "Noch keine Sprecher gespeichert",
+    "speakersSaved": "{{count}} Sprecher gespeichert",
+    "speakersWillAppear": "Sprecher erscheinen hier, wenn Sie Sprechernamen in Ihren Aufnahmen verwenden",
+    "times": "mal",
+    "title": "Sprecher Verwalten",
+    "used": "Verwendet"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "In Zwischenablage kopiert",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "Download gestartet",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "Notizen erfolgreich aktualisiert",
+    "passwordChanged": "Passwort erfolgreich geändert",
+    "profileUpdated": "Profil erfolgreich aktualisiert",
+    "recordingDeleted": "Aufnahme erfolgreich gelöscht",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "Aufnahme erfolgreich gespeichert",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "Einstellungen erfolgreich gespeichert",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "Zusammenfassung erfolgreich generiert",
+    "tagAdded": "Tag erfolgreich hinzugefügt",
+    "tagRemoved": "Tag erfolgreich entfernt",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "Transkription erfolgreich aktualisiert"
+  },
+  "metadata": {
+    "cancelEdit": "Abbrechen",
+    "createdAt": "Erstellt",
+    "duration": "Dauer",
+    "editMetadata": "Metadaten bearbeiten",
+    "fileName": "Dateiname",
+    "fileSize": "Dateigröße",
+    "language": "Sprache",
+    "meetingDate": "Meeting-Datum",
+    "processingTime": "Verarbeitungszeit",
+    "saveMetadata": "Speichern",
+    "status": "Status",
+    "title": "Metadaten",
+    "updatedAt": "Aktualisiert",
+    "wordCount": "Wortanzahl"
+  },
+  "modal": {
+    "addSpeaker": "Neuen Sprecher Hinzufügen",
+    "colorScheme": "Farbschema",
+    "deleteRecording": "Aufnahme löschen",
+    "editAsrTranscription": "ASR-Transkription bearbeiten",
+    "editParticipants": "Teilnehmer Bearbeiten",
+    "editRecording": "Aufnahme bearbeiten",
+    "editSpeakers": "Sprecher Bearbeiten",
+    "editTags": "Aufnahme-Tags bearbeiten",
+    "editTranscription": "Transkription bearbeiten",
+    "identifySpeakers": "Sprecher identifizieren",
+    "recordingNotice": "Aufnahme-Hinweis",
+    "reprocessSummary": "Zusammenfassung neu verarbeiten",
+    "reprocessTranscription": "Transkription neu verarbeiten",
+    "resetStatus": "Aufnahme-Status zurücksetzen?",
+    "shareRecording": "Aufnahme teilen",
+    "sharedTranscripts": "Meine geteilten Transkripte",
+    "systemAudioHelp": "System-Audio Hilfe",
+    "uploadFiles": "Dateien hochladen",
+    "uploadNotice": "Upload-Hinweis"
+  },
+  "namingTemplates": {
+    "addPattern": "Muster hinzufügen",
+    "availableTemplates": "Verfügbare Vorlagen",
+    "availableVars": "Verfügbare Variablen",
+    "cancel": "Abbrechen",
+    "createDefaults": "Standardvorlagen erstellen",
+    "createNew": "Vorlage erstellen",
+    "customVarsHint": "Definieren Sie unten Regex-Muster, um benutzerdefinierte Variablen aus Dateinamen zu extrahieren.",
+    "delete": "Löschen",
+    "description": "Definieren Sie, wie Aufnahmetitel aus Dateinamen und Transkriptionsinhalt generiert werden.",
+    "descriptionLabel": "Beschreibung",
+    "noDefault": "Kein Standard (nur KI-Titel)",
+    "regexHint": "Daten aus Dateinamen extrahieren. Verwenden Sie Erfassungsgruppen () zur Angabe der Übereinstimmung.",
+    "regexPatterns": "Regex-Muster (Optional)",
+    "result": "Ergebnis:",
+    "save": "Speichern",
+    "selectOrCreate": "Wählen Sie eine Vorlage zum Bearbeiten oder erstellen Sie eine neue",
+    "tabTitle": "Benennung",
+    "template": "Vorlage",
+    "templateName": "Vorlagenname",
+    "test": "Testen",
+    "testTemplate": "Vorlage testen",
+    "title": "Benennungsvorlagen",
+    "userDefault": "Standardvorlage",
+    "userDefaultHint": "Wird angewendet, wenn kein Tag eine Benennungsvorlage hat."
+  },
+  "nav": {
+    "account": "Konto",
+    "accountSettings": "Kontoeinstellungen",
+    "admin": "Administration",
+    "adminDashboard": "Admin-Dashboard",
+    "darkMode": "Dunkler Modus",
+    "groupManagement": "Gruppenverwaltung",
+    "home": "Startseite",
+    "language": "Sprache",
+    "lightMode": "Heller Modus",
+    "newRecording": "Neue Aufnahme",
+    "recording": "Aufnahme",
+    "settings": "Einstellungen",
+    "signOut": "Abmelden",
+    "teamManagement": "Gruppenverwaltung",
+    "upload": "Hochladen",
+    "userProfile": "Benutzerprofil"
+  },
+  "notes": {
+    "cancelEdit": "Bearbeitung abbrechen",
+    "characterCount": "{{count}} Zeichen",
+    "characterCountPlural": "{{count}} Zeichen",
+    "editNotes": "Notizen bearbeiten",
+    "lastUpdated": "Zuletzt aktualisiert",
+    "placeholder": "Ihre Notizen hier hinzufügen...",
+    "saveNotes": "Notizen speichern",
+    "title": "Notizen"
+  },
+  "pwa": {
+    "installApp": "App installieren",
+    "installed": "Erfolgreich installiert",
+    "installing": "Installiere...",
+    "notificationPermissionDenied": "Benachrichtigungsberechtigung verweigert",
+    "notificationsEnabled": "Benachrichtigungen aktiviert",
+    "offline": "Sie sind offline",
+    "screenAwake": "Bildschirm bleibt während der Aufnahme wach",
+    "screenAwakeFailed": "Bildschirm konnte nicht wach gehalten werden",
+    "updateAvailable": "Update verfügbar"
+  },
+  "recording": {
+    "acceptDisclaimer": "Ich akzeptiere",
+    "cancelRecording": "Abbrechen",
+    "discardRecovery": "Verwerfen",
+    "disclaimer": "Aufnahme-Hinweis",
+    "duration": "Dauer",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "Mikrofon",
+    "microphoneAndSystem": "Mikrofon + System",
+    "microphonePermissionDenied": "Mikrofon-Berechtigung verweigert",
+    "modeBoth": "Mikrofon + System",
+    "modeMicrophone": "Mikrofon",
+    "modeSystem": "System-Audio",
+    "notes": "Notizen",
+    "notesPlaceholder": "Notizen zu dieser Aufnahme hinzufügen...",
+    "pauseRecording": "Pause",
+    "recordingFailed": "Aufnahme fehlgeschlagen",
+    "recordingInProgress": "Aufnahme läuft...",
+    "recordingMode": "Aufnahmemodus",
+    "recordingSize": "Geschätzte Größe",
+    "recordingStopped": "Aufnahme gestoppt",
+    "recordingTime": "Aufnahmezeit",
+    "recoveryDescription": "Wir haben eine unvollständige Aufnahme aus einer früheren Sitzung gefunden. Möchten Sie diese wiederherstellen?",
+    "recoveryFound": "Nicht gespeicherte Aufnahme gefunden",
+    "recoveryTitle": "Aufnahme wiederherstellen",
+    "restoreRecording": "Wiederherstellen",
+    "resumeRecording": "Fortsetzen",
+    "saveRecording": "Aufnahme speichern",
+    "size": "Größe",
+    "startRecording": "Aufnahme starten",
+    "startedAt": "Gestartet am",
+    "stopRecording": "Aufnahme stoppen",
+    "systemAudio": "System-Audio",
+    "systemAudioNotSupported": "System-Audio-Aufnahme wird in diesem Browser nicht unterstützt",
+    "title": "Audio-Aufnahme"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "Das Audio wird von Grund auf neu transkribiert. Dies wird auch den Titel und die Zusammenfassung basierend auf der neuen Transkription neu generieren.",
+    "audioReTranscribedWithAsr": "Das Audio wird mit dem ASR-Endpoint neu transkribiert. Dies umfasst Diarisierung und wird Titel und Zusammenfassung neu generieren.",
+    "manualEditsOverwritten": "Alle manuellen Bearbeitungen der Transkription, des Titels oder der Zusammenfassung werden überschrieben.",
+    "manualEditsOverwrittenSummary": "Alle manuellen Bearbeitungen der Zusammenfassung werden überschrieben.",
+    "newTitleAndSummary": "Eine neue Zusammenfassung wird basierend auf der vorhandenen Transkription generiert."
+  },
+  "settings": {
+    "apiKeys": "API-Schlüssel",
+    "appearance": "Erscheinungsbild",
+    "changePassword": "Passwort ändern",
+    "dataExport": "Datenexport",
+    "deleteAccount": "Konto löschen",
+    "integrations": "Integrationen",
+    "language": "Sprache",
+    "notifications": "Benachrichtigungen",
+    "preferences": "Einstellungen",
+    "privacy": "Datenschutz",
+    "profile": "Profil",
+    "security": "Sicherheit",
+    "theme": "Design",
+    "title": "Einstellungen",
+    "twoFactorAuth": "Zwei-Faktor-Authentifizierung"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "Sie haben noch keine Transkripte geteilt.",
+    "shareNotes": "Notizen Teilen",
+    "shareSummary": "Zusammenfassung Teilen",
+    "sharedOn": "Geteilt am"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "Sie haben noch keine Transkripte geteilt."
+  },
+  "sharing": {
+    "canEdit": "Kann bearbeiten",
+    "canReshare": "Kann weitergeben",
+    "internalSharing": "Interne Freigabe",
+    "notSharedYet": "Noch nicht geteilt",
+    "publicBadge": "Öffentlich",
+    "publicLink": "Öffentlicher Link",
+    "publicLinks": "öffentliche(r) Link(s)",
+    "publicLinksGenerated": "öffentliche(r) Link(s) generiert",
+    "searchUsers": "Benutzer suchen...",
+    "sharedBadge": "Geteilt",
+    "sharedBy": "Geteilt von",
+    "sharedWith": "Geteilt mit",
+    "teamBadge": "Group",
+    "teamRecording": "Team-Aufnahme",
+    "unknown": "Unbekannt",
+    "users": "Benutzer"
+  },
+  "sidebar": {
+    "advancedSearch": "Erweiterte Suche",
+    "archived": "Archiviert",
+    "archivedRecordings": "Archivierte Aufnahmen",
+    "dateRange": "Datumsbereich",
+    "filters": "Filter",
+    "highlighted": "Hervorgehoben",
+    "inbox": "Posteingang",
+    "lastMonth": "Letzten Monat",
+    "lastWeek": "Letzte Woche",
+    "loadMore": "Mehr laden",
+    "markAsRead": "Als gelesen markieren",
+    "moveToInbox": "In Posteingang verschieben",
+    "noRecordings": "Keine Aufnahmen gefunden",
+    "older": "Älter",
+    "removeFromHighlighted": "Von Favoriten entfernen",
+    "searchRecordings": "Aufnahmen suchen...",
+    "sharedWithMe": "Mit mir geteilt",
+    "sortBy": "Sortieren nach",
+    "sortByDate": "Erstellungsdatum",
+    "sortByMeetingDate": "Meeting-Datum",
+    "starred": "Starred",
+    "tags": "Tags",
+    "thisMonth": "Diesen Monat",
+    "thisWeek": "Diese Woche",
+    "today": "Heute",
+    "totalRecordings": "{{count}} Aufnahme",
+    "totalRecordingsPlural": "{{count}} Aufnahmen",
+    "upcoming": "Bevorstehend",
+    "yesterday": "Gestern"
+  },
+  "speakers": {
+    "filterBySpeaker": "Nach Sprecher filtern",
+    "noMatchingSpeakers": "Keine passenden Sprecher",
+    "searchSpeakers": "Suchen..."
+  },
+  "speakersManagement": {
+    "added": "Hinzugefügt",
+    "confidence": "Zuverlässigkeit",
+    "confidenceHigh": "hoch",
+    "confidenceLow": "niedrig",
+    "confidenceMedium": "mittel",
+    "created": "Erstellt",
+    "description": "Verwalten Sie Ihre gespeicherten Sprecher. Diese werden automatisch gespeichert, wenn Sie Sprechernamen in Ihren Aufnahmen verwenden.",
+    "failedToLoad": "Fehler beim Laden der Sprecher",
+    "failedToLoadSnippets": "Fehler beim Laden der Ausschnitte",
+    "keepThisSpeaker": "Diesen Sprecher behalten (andere werden damit zusammengeführt):",
+    "last": "Zuletzt",
+    "lastUsed": "Zuletzt verwendet",
+    "loadingSpeakers": "Sprecher werden geladen...",
+    "match": "Übereinstimmung",
+    "mergeDescription": "Kombinieren Sie mehrere Sprecherprofile zu einem. Alle Einbettungen, Ausschnitte und Nutzungsdaten werden zusammengeführt.",
+    "mergeFailed": "Fehler beim Zusammenführen der Sprecher",
+    "mergeNSpeakers": "{{count}} Sprecher Zusammenführen",
+    "mergeSpeakers": "Sprecher Zusammenführen",
+    "mergeSuccess": "Sprecher erfolgreich zusammengeführt",
+    "noSnippetsAvailable": "Keine Ausschnitte verfügbar",
+    "noSpeakersYet": "Noch keine Sprecher gespeichert",
+    "sample": "Probe",
+    "samples": "Proben",
+    "selectToMerge": "Wählen Sie 2+ zum Zusammenführen",
+    "speakersToMerge": "Zusammenzuführende Sprecher:",
+    "speakersWillAppear": "Sprecher erscheinen hier, wenn Sie Sprechernamen in Ihren Aufnahmen verwenden",
+    "targetWillReceive": "Der ausgewählte Sprecher erhält alle Stimmdaten und Ausschnitte der anderen.",
+    "time": "Mal",
+    "times": "Mal",
+    "totalSpeakers": "Sprecher gespeichert",
+    "used": "Verwendet",
+    "usedTimes": "Verwendet",
+    "viewSnippets": "Ausschnitte Anzeigen",
+    "voiceMatchSuggestions": "Stimmübereinstimmungs-Vorschläge",
+    "voiceProfile": "Stimmprofil"
+  },
+  "status": {
+    "completed": "Abgeschlossen",
+    "failed": "Fehlgeschlagen",
+    "processing": "Verarbeitung",
+    "queued": "In Warteschlange",
+    "stuck": "Blockierte Verarbeitung zurücksetzen",
+    "summarizing": "Zusammenfassung",
+    "transcribing": "Transkribierung",
+    "uploading": "Upload"
+  },
+  "summary": {
+    "actionItems": "Aktionspunkte",
+    "cancelEdit": "Bearbeitung abbrechen",
+    "decisions": "Entscheidungen",
+    "editSummary": "Zusammenfassung bearbeiten",
+    "generateSummary": "Zusammenfassung generieren",
+    "keyPoints": "Wichtige Punkte",
+    "noSummary": "Keine Zusammenfassung verfügbar",
+    "participants": "Teilnehmer",
+    "regenerateSummary": "Zusammenfassung neu generieren",
+    "saveSummary": "Zusammenfassung speichern",
+    "summaryFailed": "Generierung der Zusammenfassung fehlgeschlagen",
+    "summaryInProgress": "Zusammenfassung wird generiert...",
+    "title": "Zusammenfassung"
+  },
+  "tagManagement": {
+    "asrDefaults": "ASR-Standards",
+    "createTag": "Tag Erstellen",
+    "customPrompt": "Benutzerdefinierter Prompt",
+    "description": "Organisieren Sie Ihre Aufnahmen mit benutzerdefinierten Tags. Jeder Tag kann seinen eigenen Zusammenfassungs-Prompt und Standard-ASR-Einstellungen haben.",
+    "maxSpeakers": "Max",
+    "minSpeakers": "Min",
+    "noTags": "Sie haben noch keine Tags erstellt."
+  },
+  "tags": {
+    "addTag": "Tag hinzufügen",
+    "clearTagFilter": "Filter löschen",
+    "createTag": "Tag erstellen",
+    "currentTags": "Aktuelle Tags",
+    "filterByTag": "Nach Tag filtern",
+    "manageAllTags": "Alle Tags verwalten",
+    "noAvailableTags": "Keine verfügbaren Tags",
+    "noMatchingTags": "Keine passenden Tags",
+    "noTags": "Keine Tags",
+    "removeTag": "Tag entfernen",
+    "searchTags": "Suchen...",
+    "tagColor": "Tag-Farbe",
+    "tagName": "Tag-Name",
+    "title": "Tags"
+  },
+  "tagsModal": {
+    "addTags": "Tags hinzufügen",
+    "currentTags": "Aktuelle Tags",
+    "done": "Fertig",
+    "noTagsAssigned": "Dieser Aufnahme sind keine Tags zugewiesen",
+    "searchTags": "Tags suchen..."
+  },
+  "time": {
+    "dayAgo": "Vor 1 Tag",
+    "daysAgo": "Vor {{count}} Tagen",
+    "hourAgo": "Vor 1 Stunde",
+    "hoursAgo": "Vor {{count}} Stunden",
+    "justNow": "Gerade eben",
+    "minuteAgo": "Vor 1 Minute",
+    "minutesAgo": "Vor {{count}} Minuten",
+    "monthAgo": "Vor 1 Monat",
+    "monthsAgo": "Vor {{count}} Monaten",
+    "weekAgo": "Vor 1 Woche",
+    "weeksAgo": "Vor {{count}} Wochen",
+    "yearAgo": "Vor 1 Jahr",
+    "yearsAgo": "Vor {{count}} Jahren"
+  },
+  "tooltips": {
+    "changeSpeaker": "Sprecher ändern",
+    "clearChat": "Chat leeren",
+    "copyTranscript": "Transkript kopieren",
+    "deleteTeam": "Gruppe Löschen",
+    "doubleClickToEdit": "Doppelklicken zum Bearbeiten",
+    "downloadTranscriptWithTemplate": "Transkript mit Vorlage herunterladen",
+    "editTeam": "Gruppe Bearbeiten",
+    "editText": "Text bearbeiten",
+    "editTitle": "Titel bearbeiten",
+    "regenerateTitle": "Titel mit KI neu generieren",
+    "assignFolder": "Ordner zuweisen",
+    "discardIncognito": "Inkognito-Aufnahme verwerfen",
+    "editTranscript": "Transkript bearbeiten",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "Erweitern",
+    "followPlayerDisabled": "Automatisches Scrollen aktivieren - Transkript folgt der Audiowiedergabe",
+    "followPlayerEnabled": "Automatisches Scrollen deaktivieren - Transkript bleibt an Ort und Stelle",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "Öffentliche Freigabeberechtigung erteilen",
+    "hideVideo": "Hide video",
+    "highlight": "Hervorheben",
+    "makeAdmin": "Zum Admin Machen",
+    "manageMembers": "Mitglieder Verwalten",
+    "manageTeamTags": "Gruppen-Tags Verwalten",
+    "markAsRead": "Als gelesen markieren",
+    "maximizeChat": "Chat maximieren",
+    "minimize": "Minimieren",
+    "moveToInbox": "In Posteingang verschieben",
+    "mute": "Stumm",
+    "pause": "Pause",
+    "play": "Abspielen",
+    "playbackSpeed": "Wiedergabegeschwindigkeit",
+    "removeAdmin": "Admin Entfernen",
+    "removeFromQueue": "Aus Warteschlange entfernen",
+    "removeFromTeam": "Aus Team entfernen",
+    "removeHighlight": "Hervorhebung entfernen",
+    "reprocessTranscription": "Transkript neu verarbeiten",
+    "reprocessWithAsr": "Mit ASR neu verarbeiten",
+    "restoreChat": "Chat wiederherstellen",
+    "revokePublicSharing": "Öffentliche Freigabeberechtigung widerrufen",
+    "shareWithUsers": "Mit Benutzern teilen",
+    "showVideo": "Show video",
+    "switchToDarkMode": "Zum Dunkelmodus Wechseln",
+    "switchToLightMode": "Zum Hellmodus Wechseln",
+    "unmute": "Ton an"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Verfügbare Vorlagen",
+    "availableVars": "Verfügbare Variablen",
+    "cancel": "Abbrechen",
+    "chooseTemplate": "Vorlage wählen...",
+    "createDefaults": "Standardvorlagen Erstellen",
+    "createNew": "Vorlage Erstellen",
+    "default": "Standard",
+    "delete": "Löschen",
+    "description": "Anpassen, wie Transkripte für Download und Export formatiert werden.",
+    "downloadDefault": "Standard herunterladen",
+    "downloadWithoutTemplate": "Ohne Vorlage Herunterladen",
+    "filters": "Filter: |upper für Großbuchstaben, |srt für Untertitelformat",
+    "save": "Speichern",
+    "selectOrCreate": "Wählen Sie eine Vorlage zum Bearbeiten oder erstellen Sie eine neue",
+    "selectTemplate": "Vorlage Auswählen",
+    "setDefault": "Als Standardvorlage festlegen",
+    "tabTitle": "Transkript",
+    "template": "Vorlage",
+    "templateName": "Vorlagenname",
+    "title": "Transkript-Vorlagen",
+    "viewGuide": "Vorlagen-Leitfaden Anzeigen"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Sprecher automatisch identifizieren",
+    "bubble": "Blase",
+    "cancelEdit": "Bearbeitung abbrechen",
+    "copy": "Kopieren",
+    "copyToClipboard": "In Zwischenablage kopieren",
+    "download": "Herunterladen",
+    "downloadTranscript": "Transkript herunterladen",
+    "edit": "Bearbeiten",
+    "editSpeakers": "Sprecher bearbeiten",
+    "editTranscription": "Transkription bearbeiten",
+    "highlightSearchResults": "Suchergebnisse hervorheben",
+    "noTranscription": "Keine Transkription verfügbar",
+    "regenerateTranscription": "Transkription neu generieren",
+    "saveTranscription": "Transkription speichern",
+    "searchInTranscript": "In Transkript suchen...",
+    "simple": "Einfach",
+    "speaker": "Sprecher {{number}}",
+    "speakerLabels": "Sprecher-Labels",
+    "title": "Transkription",
+    "unknownSpeaker": "Unbekannter Sprecher"
+  },
+  "upload": {
+    "chunking": "Große Dateien werden automatisch für die Verarbeitung aufgeteilt",
+    "completed": "Abgeschlossen",
+    "copies": "Kopien dieser Datei",
+    "dropzone": "Audio-Dateien hier hineinziehen oder klicken zum Durchsuchen",
+    "duplicateDetected": "Diese Datei scheint ein Duplikat von \"{{existingName}}\" zu sein (hochgeladen am {{existingDate}})",
+    "duplicateFile": "Doppelte Datei",
+    "failed": "Fehlgeschlagen",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "Maximale Dateigröße",
+    "queued": "In Warteschlange",
+    "selectFiles": "Dateien auswählen",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "Zusammenfasse...",
+    "supportedFormats": "Unterstützt MP3, WAV, M4A, MP4, MOV, AVI, AMR und mehr",
+    "title": "Audio hochladen",
+    "transcribing": "Transkribiere...",
+    "untitled": "Unbenannte Aufnahme",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "Upload-Fortschritt",
+    "videoRetained": "Video für Wiedergabe beibehalten",
+    "willAutoSummarize": "Wird nach der Transkription automatisch zusammengefasst"
+  },
+  "uploadProgress": {
+    "title": "Upload-Fortschritt"
+  },
+  "promptVariables": {
+    "title": "Prompt-Variablen",
+    "infoTooltip": "Über Prompt-Variablen",
+    "hintUpload": "Das ausgewählte Tag oder der Ordner verwendet Platzhalter im Prompt. Fülle sie aus und sie werden in den Zusammenfassungs-Prompt für diese Aufnahme eingesetzt. Leere Werte werden zu einer leeren Zeichenkette. Bis zu 8.000 Zeichen pro Wert, 32.000 insgesamt.",
+    "hintReprocess": "Diese Werte werden in die Platzhalter im aufgelösten Prompt eingesetzt. Änderungen werden in der Aufnahme gespeichert. Leere Werte werden zu einer leeren Zeichenkette. Bis zu 8.000 Zeichen pro Wert, 32.000 insgesamt.",
+    "placeholderPrefix": "Eingeben"
+  },
+  "summaryMode": {
+    "applyMode": "Anwendungsmodus",
+    "append": "Anhängen",
+    "appendHelp": "Standard-Prompt verwenden und dies als zusätzlichen Kontext hinzufügen.",
+    "replace": "Ersetzen",
+    "replaceHelp": "Nur diesen Text als Zusammenfassungsanweisungen verwenden."
+  },
+  "customizeSummary": {
+    "title": "Zusammenfassungs-Prompt anpassen",
+    "body": "Einmaligen Kontext für diese Zusammenfassung hinzufügen oder den aufgelösten Prompt vollständig ersetzen.",
+    "additionalContext": "Zusätzlicher Kontext",
+    "customPrompt": "Benutzerdefinierter Prompt",
+    "appendPlaceholder": "z. B. Die heutige Tagesordnung ist: ...",
+    "replacePlaceholder": "Vollständigen Zusammenfassungs-Prompt eingeben...",
+    "generateSummary": "Zusammenfassung generieren"
+  },
+  "asrEditor": {
+    "saved": "Gespeichert",
+    "ctrlSHint": "Strg+S zum Speichern",
+    "saveWithoutClosing": "Speichern ohne Schließen (Strg+S)"
+  },
+  "preview": {
+    "placeholderLegend": "Platzhalter-Legende:",
+    "systemReplaced": "vom System ersetzt (aktuelles Datum, Transkript, Tag-Namen usw.)",
+    "userSupplied": "vom Benutzer beim Hochladen oder erneuten Verarbeiten angegeben",
+    "userMessageHeading": "Benutzernachricht:",
+    "liveUpdateNote": "Der Bereich Zusammenfassungsanweisungen aktualisiert sich, während du deinen Prompt oben bearbeitest. Platzhalter werden bei der Verarbeitung einer Aufnahme durch echte Werte ersetzt."
+  },
+  "preferences": {
+    "description": "Einstellungen zu Anzeige und Editor-Verhalten. Diese werden in deinem Konto gespeichert und gelten geräteübergreifend.",
+    "editorAutosave": "Automatisches Speichern im Transkript-Editor",
+    "editorAutosaveHelp": "Wenn aktiviert, werden Änderungen im Transkript-Editor wenige Sekunden nach Tippende automatisch gespeichert. Standardmäßig deaktiviert; speichern erfolgt explizit über die Speichern-Buttons oder Strg+S.",
+    "showTimestampsSimpleView": "Zeitstempel in der einfachen Ansicht anzeigen",
+    "showTimestampsSimpleViewHelp": "Zeigt einen kompakten Zeitstempel mm:ss neben jedem Sprechernamen in der einfachen Ansicht. Die Bubble-Ansicht ist nicht betroffen.",
+    "transcriptDisplay": "Transkriptanzeige",
+    "transcriptEditor": "Transkript-Editor"
+  }
+}
diff --git a/static/locales/en.json b/static/locales/en.json
new file mode 100644
index 00000000..df6353ac
--- /dev/null
+++ b/static/locales/en.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "AI Summarization",
+    "aiSummarizationDesc": "OpenRouter and Ollama integration with custom prompts",
+    "asrEnabled": "ASR Enabled",
+    "asrEndpoint": "ASR Endpoint",
+    "audioTranscription": "Audio Transcription",
+    "audioTranscriptionDesc": "Whisper API and custom ASR support with high accuracy",
+    "backend": "Backend",
+    "database": "Database",
+    "deployment": "Deployment",
+    "dockerDescription": "Official Docker images",
+    "dockerHub": "Docker Hub",
+    "documentation": "Documentation",
+    "documentationDescription": "User guide and tutorials",
+    "endpoint": "Endpoint",
+    "frontend": "Frontend",
+    "githubDescription": "Source code, issues, and releases",
+    "githubRepository": "GitHub Repository",
+    "inquireMode": "Inquire Mode",
+    "inquireModeDesc": "Semantic search across all your recordings",
+    "interactiveChat": "Interactive Chat",
+    "interactiveChatDesc": "Chat with your transcriptions using AI",
+    "keyFeatures": "Key Features",
+    "largeLanguageModel": "Large Language Model",
+    "model": "Model",
+    "projectDescription": "Transform your audio recordings into organized, searchable notes with AI-powered transcription, summarization, and interactive chat features.",
+    "projectLinks": "Project Links",
+    "sharingExport": "Sharing & Export",
+    "sharingExportDesc": "Share recordings and export to various formats",
+    "speakerDiarization": "Speaker Diarization",
+    "speakerDiarizationDesc": "Identify and label different speakers automatically",
+    "speechRecognition": "Speech Recognition",
+    "systemConfiguration": "System Configuration",
+    "tagline": "AI-Powered Audio Transcription & Note-Taking",
+    "technologyStack": "Technology Stack",
+    "title": "About",
+    "version": "Version",
+    "whisperApi": "Whisper API"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "OpenRouter and Ollama integration with custom prompts",
+    "asrEnabled": "ASR Enabled",
+    "asrEndpoint": "ASR Endpoint",
+    "audioTranscriptionDesc": "Whisper API and custom ASR support with high accuracy",
+    "backend": "Backend",
+    "database": "Database",
+    "deployment": "Deployment",
+    "dockerDescription": "Official Docker images",
+    "documentationDescription": "Setup guides and user manual",
+    "endpoint": "Endpoint",
+    "frontend": "Frontend",
+    "githubDescription": "Source code, issues, and releases",
+    "inquireModeDesc": "Semantic search across all your recordings",
+    "interactiveChatDesc": "Chat with your transcriptions using AI",
+    "model": "Model",
+    "no": "No",
+    "sharingExportDesc": "Share recordings and export to various formats",
+    "speakerDiarizationDesc": "Identify and label different speakers automatically",
+    "whisperApi": "Whisper API",
+    "yes": "Yes"
+  },
+  "account": {
+    "accountActions": "Account Actions",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "Change Password",
+    "chooseLanguageForInterface": "Choose the language for the application interface",
+    "companyOrganization": "Company / Organization",
+    "completedRecordings": "Completed",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "Email",
+    "failedRecordings": "Failed",
+    "fullName": "Full Name",
+    "goToRecordings": "Go to Recordings",
+    "interfaceLanguage": "Interface Language",
+    "jobTitle": "Job Title",
+    "languageForSummaries": "Language for titles, summaries, and chat. Leave blank for default (default behavior of your chosen models).",
+    "languagePreferences": "Language Preferences",
+    "leaveBlankForAutoDetect": "Leave blank for auto-detection by transcription service",
+    "manageSpeakers": "Manage Speakers",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "Personal Information",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "Preferred Chatbot and Summarization Language",
+    "processingRecordings": "Processing",
+    "saveAllPreferences": "Save All Preferences",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "Account Statistics",
+    "title": "Account Information",
+    "totalRecordings": "Total Recordings",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "Transcription Language",
+    "userDetails": "User Details",
+    "username": "Username"
+  },
+  "accountTabs": {
+    "about": "About",
+    "apiTokens": "API Tokens",
+    "customPrompts": "Custom Prompts",
+    "folderManagement": "Folder Management",
+    "namingTemplates": "Naming",
+    "preferences": "Preferences",
+    "promptOptions": "Prompt Options",
+    "sharedTranscripts": "Shared Transcripts",
+    "speakersManagement": "Speakers Management",
+    "tagManagement": "Tag Management",
+    "templates": "Templates",
+    "transcriptTemplates": "Transcript Templates"
+  },
+  "admin": {
+    "title": "Admin",
+    "userMenu": "User Menu"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "About Inquire Mode",
+    "actions": "ACTIONS",
+    "addNewUser": "Add New User",
+    "addUser": "Add User",
+    "additionalContext": "Additional Context",
+    "admin": "ADMIN",
+    "adminDefaultPrompt": "Admin Default Prompt",
+    "adminDefaultPromptDesc": "The prompt configured above (shown on this page)",
+    "adminUser": "Admin User",
+    "allRecordingsProcessed": "All recordings are processed!",
+    "allowed": "Allowed",
+    "available": "Available",
+    "blocked": "blocked",
+    "budgetWarnings": "Budget Warnings",
+    "characters": "characters",
+    "chunkSize": "Chunk Size",
+    "complete": "complete",
+    "completedRecordings": "Completed",
+    "confirmPasswordLabel": "Confirm Password",
+    "contextNotes": {
+      "jsonConversion": "JSON transcripts are converted to clean text format before sending",
+      "modelConfig": "The model used is configured via TEXT_MODEL_NAME environment variable",
+      "tagPrompts": "If multiple tag prompts exist, they are merged in the order tags were added",
+      "transcriptLimit": "Transcripts are limited to a configurable character count (default: 30,000)"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "Current usage",
+    "currentUsageMinutes": "Current Usage",
+    "defaultPromptInfo": "This default prompt will be used for all users who haven't set their own custom prompt in their account settings.",
+    "defaultPrompts": "Default Prompts",
+    "defaultSummarizationPrompt": "Default Summarization Prompt",
+    "description": "Description",
+    "editUser": "Edit User",
+    "email": "EMAIL",
+    "emailLabel": "Email",
+    "embeddingModel": "Embedding Model",
+    "embeddingsStatus": "Embeddings Status",
+    "errors": {
+      "failedToLoadPrompt": "Failed to load default prompt",
+      "failedToSavePrompt": "Failed to save default prompt. Please try again.",
+      "invalidFileSize": "Please enter a valid size between 1 and 10000 MB",
+      "invalidInteger": "Please enter a valid integer",
+      "invalidNumber": "Please enter a valid number",
+      "maxTimeout": "Timeout cannot exceed 10 hours (36000 seconds)",
+      "minCharacters": "Please enter a valid number of at least 1000 characters",
+      "minTimeout": "Timeout must be at least 60 seconds"
+    },
+    "failedRecordings": "Failed",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "Inquire Mode allows users to search across multiple transcriptions using natural language questions. It works by breaking transcriptions into chunks and creating searchable embeddings using AI models.",
+    "languagePreferenceNote": "Note: If the user has set an output language preference, \" Ensure your response is in {language}.\" will be added.",
+    "lastUpdated": "Last updated",
+    "maxFileSizeHelp": "Maximum file size in megabytes (1-10000 MB)",
+    "megabytes": "MB",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "minutes",
+    "monthlyCost": "Monthly Cost",
+    "monthlyTokenBudget": "Monthly Token Budget",
+    "monthlyTranscriptionBudget": "Monthly Transcription Budget (minutes)",
+    "needProcessing": "Need Processing",
+    "never": "Never",
+    "newPasswordLabel": "New Password (leave blank to keep current)",
+    "no": "No",
+    "noData": "No data",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "No description available",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "No Limit",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "No transcription usage data available",
+    "none": "None",
+    "notSet": "Not set",
+    "overlap": "Overlap",
+    "passwordLabel": "Password",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "Pending",
+    "percentUsed": "used",
+    "placeholdersNote": "Placeholders are replaced with actual values when processing a recording.",
+    "processAllRecordings": "Process All Recordings",
+    "processNext10": "Process Next 10",
+    "processedForInquire": "Processed for Inquire",
+    "processing": "Processing...",
+    "processingActions": "Processing Actions",
+    "processingProgress": "Processing Progress",
+    "processingRecordings": "Processing",
+    "promptDescription": "This prompt will be used to generate summaries for all recordings when users haven't set their own prompt.",
+    "promptHierarchy": "Prompt Hierarchy",
+    "promptPriorityDescription": "The system uses the following priority order when selecting which prompt to use:",
+    "promptResetMessage": "Prompt reset to system default. Click \"Save Changes\" to apply.",
+    "promptSavedSuccessfully": "Default prompt saved successfully!",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "Recording Status Distribution",
+    "recordings": "RECORDINGS",
+    "recordingsNeedProcessing": "There are {{count}} recordings that need to be processed for Inquire Mode.",
+    "refreshStatus": "Refresh Status",
+    "resetToDefault": "Reset to Default",
+    "saving": "Saving...",
+    "searchUsers": "Search users...",
+    "seconds": "seconds",
+    "settings": {
+      "asrTimeoutDesc": "Maximum time in seconds to wait for ASR transcription to complete. Default is 1800 seconds (30 minutes).",
+      "defaultSummaryPromptDesc": "Default summarization prompt used when users have not set their own prompt. This serves as the base prompt for all users.",
+      "maxFileSizeDesc": "Maximum file size allowed for audio uploads in megabytes (MB).",
+      "recordingDisclaimerDesc": "Legal disclaimer shown to users before recording starts. Supports Markdown formatting. Leave empty to disable.",
+      "uploadDisclaimerDesc": "Legal disclaimer shown before file uploads. Supports Markdown. Leave empty to disable.",
+      "customBannerDesc": "Custom banner shown at the top of the page. Supports Markdown. Leave empty to disable.",
+      "transcriptLengthLimitDesc": "Maximum number of characters to send from transcript to LLM for summarization and chat. Use -1 for no limit."
+    },
+    "storageUsed": "STORAGE USED",
+    "summarizationInstructions": "Summarization Instructions",
+    "systemFallback": "System Fallback",
+    "systemFallbackDesc": "A hardcoded default if none of the above are set",
+    "systemPrompt": "System Prompt",
+    "systemSettings": "System Settings",
+    "systemStatistics": "System Statistics",
+    "tagCustomPrompt": "Tag Custom Prompt",
+    "tagCustomPromptDesc": "If a recording has tags with custom prompts",
+    "textSearchOnly": "Text Search Only",
+    "thisMonth": "This Month",
+    "timeoutRecommendation": "Recommended: 30-120 minutes for long audio files",
+    "title": "Admin Dashboard",
+    "todaysMinutes": "Today's Minutes",
+    "tokenBudgetExceeded": "Monthly token budget exceeded. Please contact your administrator.",
+    "tokenBudgetHelp": "Set a monthly token limit for AI features. Leave empty for unlimited.",
+    "tokenBudgetPlaceholder": "Leave empty for unlimited",
+    "tokenUsage": "Token usage",
+    "tokens": "tokens",
+    "topUsers": "Top Users",
+    "topUsersByStorage": "Top Users by Storage",
+    "total": "Total",
+    "totalChunks": "Total Chunks",
+    "totalQueries": "Total Queries",
+    "totalRecordings": "Total Recordings",
+    "totalStorage": "Total Storage",
+    "totalUsers": "Total Users",
+    "transcriptionBudgetHelp": "Limit transcription minutes per month. Leave empty for unlimited.",
+    "transcriptionBudgetPlaceholder": "Leave empty for unlimited",
+    "transcriptionUsage": "Transcription Usage",
+    "updateUser": "Update User",
+    "userCustomPrompt": "User Custom Prompt",
+    "userCustomPromptDesc": "If the user has set their own prompt in account settings",
+    "userManagement": "User Management",
+    "userMessageTemplate": "User Message Template",
+    "userTranscriptionUsage": "User Transcription Usage (This Month)",
+    "username": "USERNAME",
+    "usernameLabel": "Username",
+    "vectorDimensions": "Vector Dimensions",
+    "vectorStore": "Vector Store",
+    "vectorStoreManagement": "Vector Store Management",
+    "vectorStoreUpToDate": "The vector store is up to date.",
+    "viewFullPromptStructure": "View Full LLM Prompt Structure",
+    "warning": "warning",
+    "yes": "Yes"
+  },
+  "apiTokens": {
+    "activeTokens": "Active Tokens",
+    "createFirstToken": "Create your first API token to enable programmatic access",
+    "createToken": "Create Token",
+    "created": "Created",
+    "description": "Create and manage API tokens for programmatic access to your account",
+    "expires": "Expires",
+    "lastUsed": "Last used",
+    "neverUsed": "Never used",
+    "noExpiration": "No expiration",
+    "noTokens": "No API Tokens",
+    "securityNotice": "Security Notice",
+    "securityWarning": "Treat API tokens like passwords. They provide full access to your account. Never share tokens in publicly accessible areas such as GitHub, client-side code, or logs",
+    "title": "API Tokens",
+    "usageExamples": "Usage Examples"
+  },
+  "buttons": {
+    "addSegment": "Add Segment",
+    "addSpeaker": "Add Speaker",
+    "cancel": "Cancel",
+    "clearAllFilters": "Clear all filters",
+    "clearCompleted": "Clear completed uploads",
+    "clearSearchText": "Clear search text",
+    "close": "Close",
+    "copy": "Copy",
+    "copyMessage": "Copy message",
+    "copyNotes": "Copy notes",
+    "copySummary": "Copy summary",
+    "copyToClipboard": "Copy to clipboard",
+    "createTag": "Create Tag",
+    "deleteAll": "Delete All",
+    "deleteSpeaker": "Delete speaker",
+    "deleteTag": "Delete tag",
+    "deleteUser": "Delete User",
+    "downloadAsWord": "Download as Word",
+    "downloadAudio": "Download audio",
+    "downloadChat": "Download chat as Word document",
+    "downloadNotes": "Download Notes as Word Document",
+    "downloadSummary": "Download Summary as Word Document",
+    "editNotes": "Edit notes",
+    "editSetting": "Edit Setting",
+    "editSpeakers": "Edit Speakers...",
+    "editSummary": "Edit summary",
+    "editTag": "Edit tag",
+    "editTags": "Edit Tags",
+    "editTranscription": "Edit transcription",
+    "editUser": "Edit User",
+    "exportCalendar": "Export to Calendar",
+    "help": "Help",
+    "identifySpeakers": "Identify speakers",
+    "next": "Next",
+    "previous": "Previous",
+    "refresh": "Refresh",
+    "reprocessSummary": "Reprocess summary",
+    "reprocessTranscription": "Reprocess transcription",
+    "reprocessWithAsr": "Reprocess with ASR",
+    "resetStuckProcessing": "Reset stuck processing",
+    "saveChanges": "Save Changes",
+    "saveCustomPrompt": "Save Custom Prompt",
+    "saveNames": "Save Names",
+    "saveSettings": "Save Settings",
+    "shareRecording": "Share recording",
+    "toggleTheme": "Toggle theme",
+    "updateTag": "Update Tag"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Confirm New Password",
+    "currentPassword": "Current Password",
+    "newPassword": "New Password",
+    "passwordRequirement": "Password must be at least 8 characters long",
+    "title": "Change Password"
+  },
+  "chat": {
+    "availableAfterTranscription": "Chat will be available once transcription is complete",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "Chat with Transcription",
+    "clearChat": "Clear Chat",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "Failed to send message",
+    "noMessages": "No messages yet",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "Ask a question about this recording...",
+    "placeholderWithHint": "Ask a question about this recording... (Enter to send, Ctrl+Enter for new line)",
+    "send": "Send",
+    "suggestedQuestions": "Suggested Questions",
+    "thinking": "Thinking...",
+    "title": "Chat",
+    "whatAreActionItems": "What are the action items?",
+    "whatAreKeyPoints": "What are the key points?",
+    "whatWasDiscussed": "What was discussed?",
+    "whoSaidWhat": "Who said what?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Choose a recording from the sidebar to view its transcription and summary",
+    "darkThemes": "Dark Themes",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "Light Themes",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "Reset to Default",
+    "selectRecording": "Select a Recording",
+    "subtitle": "Customize your interface with beautiful color themes",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Ocean Blue",
+          "description": "Classic blue theme with professional appeal"
+        },
+        "emerald": {
+          "name": "Forest Emerald",
+          "description": "Fresh green theme for a natural feel"
+        },
+        "purple": {
+          "name": "Royal Purple",
+          "description": "Elegant purple theme with sophistication"
+        },
+        "rose": {
+          "name": "Sunset Rose",
+          "description": "Warm pink theme with gentle energy"
+        },
+        "amber": {
+          "name": "Golden Amber",
+          "description": "Warm yellow theme for brightness"
+        },
+        "teal": {
+          "name": "Ocean Teal",
+          "description": "Cool teal theme for tranquility"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Midnight Blue",
+          "description": "Deep blue theme for focused work"
+        },
+        "emerald": {
+          "name": "Dark Forest",
+          "description": "Rich green theme for comfortable viewing"
+        },
+        "purple": {
+          "name": "Deep Purple",
+          "description": "Mysterious purple theme for creativity"
+        },
+        "rose": {
+          "name": "Dark Rose",
+          "description": "Muted pink theme with subtle warmth"
+        },
+        "amber": {
+          "name": "Dark Amber",
+          "description": "Warm brown theme for cozy sessions"
+        },
+        "teal": {
+          "name": "Deep Teal",
+          "description": "Dark teal theme for calm focus"
+        }
+      }
+    },
+    "title": "Choose Color Scheme"
+  },
+  "common": {
+    "back": "Back",
+    "cancel": "Cancel",
+    "changesSaved": "Changes saved",
+    "close": "Close",
+    "confirm": "Confirm",
+    "delete": "Delete",
+    "deselectAll": "Deselect All",
+    "download": "Download",
+    "edit": "Edit",
+    "error": "Error",
+    "failed": "Failed",
+    "filter": "Filter",
+    "info": "Info",
+    "loading": "Loading...",
+    "new": "New",
+    "next": "Next",
+    "no": "No",
+    "noResults": "No results found",
+    "ok": "OK",
+    "or": "Or",
+    "previous": "Previous",
+    "processing": "Processing...",
+    "refresh": "Refresh",
+    "retry": "Retry",
+    "save": "Save",
+    "search": "Search",
+    "selectAll": "Select All",
+    "sort": "Sort",
+    "success": "Success",
+    "untitled": "Untitled",
+    "upload": "Upload",
+    "warning": "Warning",
+    "yes": "Yes"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Current Default Prompt (Used if you leave the above blank)",
+    "promptDescription": "This prompt will be used to generate summaries for your transcriptions. It overrides the admin's default prompt.",
+    "promptPlaceholder": "Describe how you want your summaries structured. Leave blank to use the admin's default prompt.",
+    "summaryGeneration": "Summary Generation Prompt",
+    "tip1": "Be specific about the sections you want in your summary",
+    "tip2": "Use clear formatting instructions (e.g., \"Use bullet points\", \"Create numbered lists\")",
+    "tip3": "Specify if you want certain information prioritized",
+    "tip4": "The system will automatically provide the transcript content to the AI",
+    "tip5": "Your output language preference (if set) will be applied automatically",
+    "tipsTitle": "Tips for Writing Effective Prompts",
+    "yourCustomPrompt": "Your Custom Summary Prompt"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "Are you sure you want to delete all saved speakers? This action cannot be undone.",
+    "title": "Delete All Speakers"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Cancel",
+      "confirm": "Delete",
+      "message": "Are you sure you want to delete this recording? This action cannot be undone.",
+      "title": "Delete Recording"
+    },
+    "deleteShare": {
+      "message": "Are you sure you want to delete this share? This will revoke access to the public link.",
+      "title": "Delete Share"
+    },
+    "reprocessTranscription": {
+      "cancel": "Cancel",
+      "confirm": "Reprocess",
+      "message": "Are you sure you want to reprocess this transcription? The current transcription will be replaced.",
+      "title": "Reprocess Transcription"
+    },
+    "unsavedChanges": {
+      "cancel": "Cancel",
+      "discard": "Discard",
+      "message": "You have unsaved changes. Do you want to save them before leaving?",
+      "save": "Save",
+      "title": "Unsaved Changes"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} hour",
+    "hoursPlural": "{{count}} hours",
+    "minutes": "{{count}} minute",
+    "minutesPlural": "{{count}} minutes",
+    "seconds": "{{count}} second",
+    "secondsPlural": "{{count}} seconds"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "ASR Default Settings",
+    "asrSettingsDescription": "These settings will be applied by default when using this tag with ASR transcription",
+    "color": "Color",
+    "colorDescription": "Choose a color for easy identification",
+    "createTitle": "Create Tag",
+    "customPrompt": "Custom Summary Prompt",
+    "customPromptPlaceholder": "Optional: Custom prompt for generating summaries for recordings with this tag",
+    "defaultLanguage": "Default Language",
+    "defaultPromptPlaceholder": "Leer lassen, um Ihren Standard-Zusammenfassungs-Prompt zu verwenden",
+    "exportTemplate": "Export Template",
+    "exportTemplateHint": "Select an export template to use when exporting recordings with this tag",
+    "leaveBlankPrompt": "Leave blank to use your default summary prompt",
+    "maxSpeakers": "Max Speakers",
+    "minSpeakers": "Min Speakers",
+    "namingTemplate": "Naming Template",
+    "namingTemplateHint": "Select a naming template to automatically format titles for recordings with this tag",
+    "noExportTemplate": "No template (use user default)",
+    "noNamingTemplate": "No template (use user default or AI title)",
+    "tagName": "Tag Name *",
+    "tagNamePlaceholder": "e.g., Meetings, Interviews",
+    "title": "Edit Tag",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "This tag is set up as a watch folder and the prompt contains placeholder variables. Recordings ingested through the auto-process directory have no UI for users to fill those values, so the placeholders will substitute to empty strings on the first summary run. Either remove the placeholders or fill the values via reprocess after upload."
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "音频录制失败。请检查您的麦克风。",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "文件太大",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "发生错误",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "Error loading shares",
+    "networkError": "网络错误。请检查您的连接。",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "未找到",
+    "permissionDenied": "权限被拒绝",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "存储配额已超出",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "Server error ({{status}}): Response was not JSON",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "摘要生成失败。请重试。",
+    "transcriptionFailed": "转录失败。请重试。",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "未授权",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "不支持的文件格式",
+    "uploadFailed": "上传失败。请重试。",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "验证错误",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "When enabled, the AI will identify meetings, appointments, and deadlines mentioned in your recordings and create downloadable calendar events.",
+    "enableLabel": "Enable automatic event extraction from transcripts",
+    "info": "Extracted events will appear in an 'Events' tab on recordings where calendar items are detected.",
+    "title": "Event Extraction"
+  },
+  "events": {
+    "add": "Add",
+    "addToCalendar": "Add to Calendar",
+    "attendees": "Attendees",
+    "confirmDelete": "Delete event \"{title}\"?",
+    "delete": "Delete",
+    "deleteFailed": "Failed to delete event",
+    "deleted": "Event deleted",
+    "end": "End",
+    "location": "Location",
+    "noEvents": "No events detected in this recording",
+    "start": "Start",
+    "title": "Events"
+  },
+  "exportLabels": {
+    "created": "Created",
+    "date": "Date",
+    "fileSize": "File Size",
+    "footer": "Generated with [Speakr](https://github.com/learnedmachine/speakr)",
+    "metadata": "Metadata",
+    "notes": "Notes",
+    "originalFile": "Original File",
+    "participants": "Participants",
+    "summarizationTime": "Summarization Time",
+    "summary": "Summary",
+    "tags": "Tags",
+    "transcription": "Transcription",
+    "transcriptionTime": "Transcription Time"
+  },
+  "exportTemplates": {
+    "availableLabels": "Localized Labels (auto-translated)",
+    "availableTemplates": "Available Templates",
+    "availableVars": "Available Variables",
+    "cancel": "Cancel",
+    "conditionals": "Conditionals",
+    "conditionalsHint": "Use {{#if variable}}...{{/if}} to conditionally include content",
+    "contentSections": "Content Sections",
+    "createDefaults": "Create Default Template",
+    "createNew": "Create Template",
+    "default": "Default",
+    "delete": "Delete",
+    "description": "Customize how recordings are exported to markdown files.",
+    "recordingData": "Recording Data",
+    "save": "Save",
+    "selectOrCreate": "Select a template to edit or create a new one",
+    "setDefault": "Set as default template",
+    "tabTitle": "Export",
+    "template": "Template",
+    "templateDescription": "Description",
+    "templateName": "Template Name",
+    "title": "Export Templates",
+    "viewGuide": "View Template Guide"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "All Folders",
+    "asrDefaults": "ASR Defaults",
+    "autoShareOnApply": "Auto-share with group members",
+    "autoShareOnApplyHelp": "Auto-share recordings with all group members when added to this folder",
+    "confirmDelete": "Are you sure you want to delete this folder? Recordings will be removed from this folder but not deleted.",
+    "createFolder": "Create Folder",
+    "customPrompt": "Custom Prompt",
+    "defaultLanguage": "Default Language",
+    "deleteFolder": "Delete Folder",
+    "description": "Organize your recordings into folders. Unlike tags, a recording can only belong to one folder. Folder prompts are applied before user prompts but after tag prompts.",
+    "editFolder": "Edit Folder",
+    "filterByFolder": "Filter by Folder",
+    "folderColor": "Folder Color",
+    "folderName": "Folder Name",
+    "groupSettings": "Group Settings",
+    "maxSpeakers": "Max Speakers",
+    "minSpeakers": "Min Speakers",
+    "moveToFolder": "Move to Folder",
+    "namingTemplate": "Naming Template",
+    "noFolder": "No Folder",
+    "noFolders": "No folders created yet",
+    "noFoldersDescription": "Create your first folder to organize your recordings",
+    "protectFromDeletion": "Protect from Deletion",
+    "protectFromDeletionHelp": "Protect recordings in this folder from auto-deletion",
+    "recordings": "recordings",
+    "removeFromFolder": "Remove from folder",
+    "retentionDays": "Retention Days",
+    "retentionDaysHelp": "Recordings in this folder will be deleted after this many days. Leave empty to use global retention.",
+    "retentionSettings": "Retention Settings",
+    "selectNamingTemplate": "Select naming template...",
+    "shareWithGroupLead": "Share with group admins",
+    "shareWithGroupLeadHelp": "Share recordings with group admins when added to this folder",
+    "title": "Folder Management"
+  },
+  "form": {
+    "auto": "Auto",
+    "autoDetect": "Auto-detect",
+    "dateFrom": "From",
+    "dateTo": "To",
+    "enterNotesMarkdown": "Enter notes in Markdown format...",
+    "enterSummaryMarkdown": "Enter summary in Markdown format...",
+    "folder": "Folder",
+    "defaultTranscriptionModel": "Default transcription model",
+    "defaultTranscriptionModelHelp": "Override which transcription model is used for recordings with this tag or folder.",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "Language",
+    "maxSpeakers": "Max Speakers",
+    "meetingDate": "Meeting Date",
+    "minSpeakers": "Min Speakers",
+    "minutes": "Minutes",
+    "notes": "Notes",
+    "notesPlaceholder": "Type your notes in Markdown format...",
+    "optional": "Optional",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "Participants",
+    "placeholderAuto": "Auto",
+    "placeholderCharacterLimit": "Enter character limit (e.g., 30000)",
+    "placeholderMinutes": "Minutes",
+    "placeholderOptional": "Optional",
+    "placeholderSeconds": "Seconds",
+    "placeholderSizeMB": "Enter size in MB",
+    "searchSpeakers": "Search speakers...",
+    "searchTags": "Search tags...",
+    "seconds": "Seconds",
+    "shareNotes": "Share Notes",
+    "shareSummary": "Share Summary",
+    "shareableLink": "Shareable Link",
+    "summaryPromptPlaceholder": "Enter the default summarization prompt...",
+    "title": "Title",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "Your full name",
+    "transcriptionModel": "Transcription model",
+    "useResolvedDefault": "(use tag/folder/global default)"
+  },
+  "groups": {
+    "addMembers": "Add members...",
+    "autoShare": "Auto-share",
+    "autoShareNote": "Note: If both are enabled, all team members will have access. If only \"team admins\" is enabled, only group leads will have access.",
+    "autoShareTeam": "Auto-share recordings with all team members when this tag is applied",
+    "autoSharesWithTeam": "Auto-shares with all team members",
+    "confirmDelete": "Are you sure you want to delete this group? This action cannot be undone.",
+    "createTeam": "Create Group",
+    "createTeamTag": "Create New Group Tag",
+    "dayRetention": "day retention",
+    "deleteTeam": "Delete Group",
+    "deletionExempt": "Exempt from deletion",
+    "deletionExemptHelp": "Recordings with this tag will be exempt from automatic deletion, even if they exceed the retention period.",
+    "editTeam": "Edit Group",
+    "editTeamTag": "Edit Group Tag",
+    "globalRetention": "Global retention",
+    "members": "Members",
+    "noMembers": "No members in this group",
+    "noTeamTags": "No group tags created yet",
+    "noTeams": "No teams created yet",
+    "retentionHelp": "Recordings with this tag will be deleted after this many days. Leave empty to use global retention ({{days}} days).",
+    "retentionPeriod": "Retention Period (days)",
+    "retentionPlaceholder": "Leave empty to use global retention",
+    "searchUsers": "Search users...",
+    "selectTeamLead": "Select group lead...",
+    "shareWithAdmins": "Share recordings with team admins when this tag is applied",
+    "sharesWithAdminsOnly": "Shares with team admins only",
+    "syncComplete": "Group shares synchronized successfully",
+    "syncTeamShares": "Sync Group Shares",
+    "syncTeamSharesDescription": "This will retroactively share all recordings that have group tags with the appropriate group members based on the tag's sharing settings.",
+    "teamLead": "Group Lead",
+    "teamName": "Group Name",
+    "teamNamePlaceholder": "Enter group name",
+    "teamTags": "Group Tags",
+    "title": "Group Management",
+    "updateTeam": "Update Group"
+  },
+  "help": {
+    "actions": "Actions",
+    "activeFilters": "Active filters",
+    "addSegmentBelow": "Add segment below",
+    "advancedAsrOptions": "Advanced ASR Options",
+    "allRecordingsLoaded": "All recordings loaded",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "Applied {{count}} suggested name",
+    "appliedSuggestedNamesPlural": "Applied {{count}} suggested names",
+    "applySuggested": "Apply Suggested",
+    "applySuggestedMobile": "Suggest",
+    "approachingLimit": "Approaching {{limit}}MB limit",
+    "askAboutTranscription": "Ask questions about this transcription",
+    "audioDeletedDescription": "The audio file for this recording has been deleted, but the transcription remains available.",
+    "audioDeletedMessage": "Audio file has been archived and is no longer available for playback.",
+    "audioDeletedTitle": "Audio file deleted",
+    "audioPlayer": "Audio Player",
+    "autoIdentify": "Auto Identify",
+    "autoIdentifyMobile": "Auto",
+    "bothAudioDesc": "Records your voice + meeting participants (recommended for online meetings)",
+    "clearFilters": "clear filters",
+    "clickToAddNotes": "Click to add notes...",
+    "colorRepeats": "Color repeats from speaker {{number}}",
+    "completedFiles": "Completed Files",
+    "confirmReprocessingTitle": "Confirm Reprocessing",
+    "copyMessage": "Copy message",
+    "createFolders": "Create folders",
+    "createPublicLink": "Create a public link to share this recording. Sharing is only available on secure (HTTPS) connections.",
+    "createTags": "Create tags",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "Delete segment",
+    "discard": "Discard",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "End",
+    "enterNameFor": "Enter name for",
+    "enterSpeakerName": "Enter speaker name...",
+    "entireScreen": "Entire Screen",
+    "errorChangingSpeaker": "Error changing speaker",
+    "errorOpeningTextEditor": "Error opening text editor",
+    "errorSavingText": "Error saving text",
+    "estimatedSize": "Estimated size",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "Generating summary...",
+    "groups": "groups",
+    "howToRecordSystemAudio": "How to Record System Audio",
+    "identifyAllSpeakers": "Identify all speakers",
+    "identifying": "Identifying...",
+    "importantNote": "Important note",
+    "internalSharingDesc": "Share with specific users in your organization",
+    "lines": "{{count}} lines",
+    "loadingMore": "Loading more recordings...",
+    "loadingRecordings": "Loading recordings...",
+    "me": "Me",
+    "microphoneDesc": "Records your voice only",
+    "modelReasoning": "Model Reasoning",
+    "moreSpeakersThanColors": "More speakers than available colors",
+    "navigate": "Navigate",
+    "noDateSet": "No date set",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "No participants",
+    "noRecordingSelected": "No recording selected.",
+    "noSpeakersIdentified": "No speakers could be identified from the context.",
+    "noSuggestionsToApply": "No suggestions to apply",
+    "noTagsCreated": "No tags created yet.",
+    "of": "of",
+    "playFromHere": "Play from here",
+    "pleaseEnterSpeakerName": "Please enter a speaker name",
+    "processingTime": "Processing time",
+    "processingTimeDescription": "This may take a few minutes to complete. You can continue using the app while processing.",
+    "processingTranscription": "Processing transcription...",
+    "publicLinkDesc": "Anyone with this link can access the recording",
+    "recordSystemSteps1": "Click \"Record System Audio\" or \"Record Both\".",
+    "recordSystemSteps2": "In the popup, choose",
+    "recordSystemSteps3": "Make sure to check the box that says",
+    "recordingFinished": "Recording finished",
+    "recordingInProgress": "Recording in progress...",
+    "regenerateSummaryAfterNames": "Regenerate summary after updating names",
+    "saved": "Saved!",
+    "savingProgress": "Saving...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "Sentence",
+    "shareSystemAudio": "Share system audio",
+    "shareTabAudio": "Share tab audio",
+    "sharedOn": "Shared on",
+    "sharingWindowNoAudio": "Sharing a \"Window\" will not capture audio.",
+    "speakerAdded": "Speaker added successfully",
+    "speakerCount": "Speaker",
+    "speakerName": "Speaker Name",
+    "speakerNamesUpdated": "Speaker names updated successfully!",
+    "speakers": "Speakers",
+    "speakersIdentified": "{{count}} speaker identified successfully!",
+    "speakersIdentifiedPlural": "{{count}} speakers identified successfully!",
+    "speakersUpdatedSaveToApply": "Speakers updated! Save the transcript to apply changes.",
+    "specificBrowserTab": "specific browser tab",
+    "startTime": "Start",
+    "startingAutoIdentification": "Starting automatic speaker identification...",
+    "summaryGenerationFailed": "Summary generation failed",
+    "summaryGenerationTimedOut": "Summary generation timed out",
+    "summaryRegenerationStarted": "Summary regeneration started",
+    "summaryUpdated": "Summary updated!",
+    "systemAudioDesc": "Records meeting participants and system sounds",
+    "tagManagement": "Tag Management",
+    "thisActionCannotBeUndone": "This action cannot be undone.",
+    "toCaptureAudioFromMeetings": "To capture audio from meetings or other apps, you must share your screen or a browser tab.",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "Transcript updated successfully!",
+    "troubleshooting": "Troubleshooting",
+    "tryAdjustingSearch": "Try adjusting your search or",
+    "unsupportedBrowser": "Unsupported Browser",
+    "untitled": "Untitled Recording",
+    "uploadRecordingNotes": "Upload Recording & Notes",
+    "whatWillHappen": "What will happen?",
+    "whyNotWorking": "Why isn't it working?",
+    "youHaveXSpeakers": "You have {{count}} speakers, but only 16 unique colors are available. Colors will repeat after the 16th speaker."
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "Active Filters:",
+    "askQuestions": "Ask Questions About Your Transcriptions",
+    "clearAll": "Clear All",
+    "dateRange": "Date Range",
+    "dateRangeActive": "Date range active",
+    "exampleQuestion1": "\"What action items were discussed?\"",
+    "exampleQuestion2": "\"When did we decide to change the timeline?\"",
+    "exampleQuestion3": "\"What concerns were raised about the budget?\"",
+    "exampleQuestion4": "\"Who was responsible for the marketing tasks?\"",
+    "exampleQuestions": "Example Questions:",
+    "filters": "Filters",
+    "filtersActive": "Filters active",
+    "from": "From",
+    "noSpeakerData": "No speaker data available",
+    "placeholder": "Ask questions about your filtered transcriptions...",
+    "selectFilters": "Select filters on the left to narrow down your transcriptions, then ask questions to get insights from your recordings.",
+    "sendHint": "Press Enter to send • Ctrl+Enter for new line",
+    "speakerRequirement": "Speaker identification requires recordings with multiple speakers",
+    "speakers": "Speakers",
+    "speakersCount": "speakers",
+    "tags": "Tags",
+    "tagsCount": "tags",
+    "title": "Inquire",
+    "to": "To"
+  },
+  "languages": {
+    "ar": "Arabic",
+    "de": "German",
+    "en": "English",
+    "es": "Spanish",
+    "fr": "French",
+    "hi": "Hindi",
+    "it": "Italian",
+    "ja": "Japanese",
+    "ko": "Korean",
+    "nl": "Dutch",
+    "pt": "Portuguese",
+    "pt-BR": "Portuguese (Brazil)",
+    "ru": "Russian",
+    "zh": "Chinese",
+    "pl": "Polish",
+    "uk": "Ukrainian",
+    "vi": "Vietnamese",
+    "th": "Thai",
+    "tr": "Turkish",
+    "id": "Indonesian",
+    "sv": "Swedish",
+    "autoDetect": "Auto-detect",
+    "defaultModelDecides": "Default (model decides)"
+  },
+  "manageSpeakersModal": {
+    "created": "Created",
+    "description": "Manage your saved speakers. These are automatically saved when you use speaker names in your recordings.",
+    "failedToLoad": "Failed to load speakers",
+    "lastUsed": "Last used",
+    "loadingSpeakers": "Loading speakers...",
+    "noSpeakersYet": "No speakers saved yet",
+    "speakersSaved": "{{count}} speakers saved",
+    "speakersWillAppear": "Speakers will appear here when you use speaker names in your recordings",
+    "times": "times",
+    "title": "Manage Speakers",
+    "used": "Used"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "Copied to clipboard",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "Download started",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "Notes updated successfully",
+    "passwordChanged": "Password changed successfully",
+    "profileUpdated": "Profile updated successfully",
+    "recordingDeleted": "Recording deleted successfully",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "Recording saved successfully",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "Settings saved successfully",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "Summary generated successfully",
+    "tagAdded": "Tag added successfully",
+    "tagRemoved": "Tag removed successfully",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "Transcription updated successfully"
+  },
+  "metadata": {
+    "cancelEdit": "Cancel",
+    "createdAt": "Created",
+    "duration": "Duration",
+    "editMetadata": "Edit Metadata",
+    "fileName": "File Name",
+    "fileSize": "File Size",
+    "language": "Language",
+    "meetingDate": "Meeting Date",
+    "processingTime": "Processing Time",
+    "saveMetadata": "Save",
+    "status": "Status",
+    "title": "Metadata",
+    "updatedAt": "Updated",
+    "wordCount": "Word Count"
+  },
+  "modal": {
+    "addSpeaker": "Add New Speaker",
+    "colorScheme": "Color Scheme",
+    "deleteRecording": "Delete Recording",
+    "editAsrTranscription": "Edit ASR Transcription",
+    "editParticipants": "Edit Participants",
+    "editRecording": "Edit Recording",
+    "editSpeakers": "Edit Speakers",
+    "editTags": "Edit Recording Tags",
+    "editTranscription": "Edit Transcription",
+    "identifySpeakers": "Identify Speakers",
+    "recordingNotice": "Recording Notice",
+    "reprocessSummary": "Reprocess Summary",
+    "reprocessTranscription": "Reprocess Transcription",
+    "resetStatus": "Reset Recording Status?",
+    "shareRecording": "Share Recording",
+    "sharedTranscripts": "Shared Transcripts",
+    "systemAudioHelp": "System Audio Help",
+    "uploadFiles": "Upload Files",
+    "uploadNotice": "Upload Notice"
+  },
+  "namingTemplates": {
+    "addPattern": "Add Pattern",
+    "availableTemplates": "Available Templates",
+    "availableVars": "Built-in Variables",
+    "cancel": "Cancel",
+    "createDefaults": "Create Default Templates",
+    "createNew": "Create Template",
+    "customVarsHint": "Define regex patterns below to extract custom variables from filenames.",
+    "delete": "Delete",
+    "description": "Define how recording titles are generated from filenames and transcription content.",
+    "descriptionLabel": "Description",
+    "noDefault": "No default (AI title only)",
+    "regexHint": "Extract data from filenames. Use capture groups () to specify the match. Example: (\\d{10}) for phone numbers.",
+    "regexPatterns": "Regex Patterns (Optional)",
+    "result": "Result:",
+    "save": "Save",
+    "selectOrCreate": "Select a template to edit or create a new one",
+    "tabTitle": "Naming",
+    "template": "Template",
+    "templateName": "Template Name",
+    "test": "Test",
+    "testTemplate": "Test Template",
+    "title": "Naming Templates",
+    "userDefault": "Default Template",
+    "userDefaultHint": "Applied when no tag has a naming template set."
+  },
+  "nav": {
+    "account": "Account",
+    "accountSettings": "Account Settings",
+    "admin": "Admin",
+    "adminDashboard": "Admin Dashboard",
+    "darkMode": "Dark Mode",
+    "groupManagement": "Group Management",
+    "home": "Home",
+    "language": "Language",
+    "lightMode": "Light Mode",
+    "newRecording": "New Recording",
+    "recording": "Recording",
+    "settings": "Settings",
+    "signOut": "Sign Out",
+    "teamManagement": "Group Management",
+    "upload": "Upload",
+    "userProfile": "User Profile"
+  },
+  "notes": {
+    "cancelEdit": "Cancel Edit",
+    "characterCount": "{{count}} character",
+    "characterCountPlural": "{{count}} characters",
+    "editNotes": "Edit Notes",
+    "lastUpdated": "Last updated",
+    "placeholder": "Add your notes here...",
+    "saveNotes": "Save Notes",
+    "title": "Notes"
+  },
+  "preferences": {
+    "description": "Display and editor behaviour preferences. These settings are saved to your account and apply across devices.",
+    "editorAutosave": "Auto-save edits in the transcript editor",
+    "editorAutosaveHelp": "When enabled, edits in the transcript editor are saved automatically a couple of seconds after you stop typing. When disabled (default), you save explicitly via the Save buttons or Ctrl+S.",
+    "showTimestampsSimpleView": "Show timestamps in simple view",
+    "showTimestampsSimpleViewHelp": "Display a compact mm:ss timestamp next to each speaker label in the simple transcript view. The bubble view is unaffected.",
+    "transcriptDisplay": "Transcript display",
+    "transcriptEditor": "Transcript editor"
+  },
+  "pwa": {
+    "installApp": "Install App",
+    "installed": "Installed successfully",
+    "installing": "Installing...",
+    "notificationPermissionDenied": "Notification permission denied",
+    "notificationsEnabled": "Notifications enabled",
+    "offline": "You're offline",
+    "screenAwake": "Screen will stay awake during recording",
+    "screenAwakeFailed": "Could not keep screen awake",
+    "updateAvailable": "Update available"
+  },
+  "recording": {
+    "acceptDisclaimer": "I Accept",
+    "cancelRecording": "Cancel",
+    "discardRecovery": "Discard",
+    "disclaimer": "Recording Disclaimer",
+    "duration": "Duration",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "Microphone",
+    "microphoneAndSystem": "Microphone + System",
+    "microphonePermissionDenied": "Microphone permission denied",
+    "modeBoth": "Microphone + System",
+    "modeMicrophone": "Microphone",
+    "modeSystem": "System Audio",
+    "notes": "Notes",
+    "notesPlaceholder": "Add notes about this recording...",
+    "pauseRecording": "Pause",
+    "recordingFailed": "Recording failed",
+    "recordingInProgress": "Recording in progress...",
+    "recordingMode": "Recording Mode",
+    "recordingSize": "Estimated Size",
+    "recordingStopped": "Recording stopped",
+    "recordingTime": "Recording Time",
+    "recoveryDescription": "We found an unfinished recording from a previous session. Would you like to restore it?",
+    "recoveryFound": "Unsaved Recording Detected",
+    "recoveryTitle": "Recover Recording",
+    "restoreRecording": "Restore",
+    "resumeRecording": "Resume",
+    "saveRecording": "Save Recording",
+    "size": "Size",
+    "startRecording": "Start Recording",
+    "startedAt": "Started At",
+    "stopRecording": "Stop Recording",
+    "systemAudio": "System Audio",
+    "systemAudioNotSupported": "System audio recording is not supported in this browser",
+    "title": "Audio Recording"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "The audio will be re-transcribed from scratch. This will also regenerate the title and summary based on the new transcription.",
+    "audioReTranscribedWithAsr": "The audio will be re-transcribed using the ASR endpoint. This includes diarization and will regenerate the title and summary.",
+    "manualEditsOverwritten": "Any manual edits to the transcription, title, or summary will be overwritten.",
+    "manualEditsOverwrittenSummary": "Any manual edits to the summary will be overwritten.",
+    "newTitleAndSummary": "A new summary will be generated based on the existing transcription."
+  },
+  "settings": {
+    "apiKeys": "API Keys",
+    "appearance": "Appearance",
+    "changePassword": "Change Password",
+    "dataExport": "Data Export",
+    "deleteAccount": "Delete Account",
+    "integrations": "Integrations",
+    "language": "Language",
+    "notifications": "Notifications",
+    "preferences": "Preferences",
+    "privacy": "Privacy",
+    "profile": "Profile",
+    "security": "Security",
+    "theme": "Theme",
+    "title": "Settings",
+    "twoFactorAuth": "Two-Factor Authentication"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "You haven't shared any transcripts yet.",
+    "shareNotes": "Share Notes",
+    "shareSummary": "Share Summary",
+    "sharedOn": "Shared on"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "You have not shared any transcripts yet."
+  },
+  "sharing": {
+    "canEdit": "Can edit",
+    "canReshare": "Can reshare",
+    "internalSharing": "Internal Sharing",
+    "notSharedYet": "Not shared yet",
+    "publicBadge": "Public",
+    "publicLink": "Public Link",
+    "publicLinks": "public link(s)",
+    "publicLinksGenerated": "public link(s) generated",
+    "searchUsers": "Search users...",
+    "sharedBadge": "Shared",
+    "sharedBy": "Shared by",
+    "sharedWith": "Shared with",
+    "teamBadge": "Group",
+    "teamRecording": "Group recording",
+    "unknown": "Unknown",
+    "users": "user(s)"
+  },
+  "sidebar": {
+    "advancedSearch": "Advanced Search",
+    "archived": "Archived",
+    "archivedRecordings": "Archived Recordings",
+    "dateRange": "Date Range",
+    "filters": "Filters",
+    "highlighted": "Highlighted",
+    "inbox": "Inbox",
+    "lastMonth": "Last Month",
+    "lastWeek": "Last Week",
+    "loadMore": "Load More",
+    "markAsRead": "Mark as read",
+    "moveToInbox": "Move to Inbox",
+    "noRecordings": "No recordings found",
+    "older": "Older",
+    "removeFromHighlighted": "Remove from starred",
+    "searchRecordings": "Search recordings...",
+    "sharedWithMe": "Shared with Me",
+    "sortBy": "Sort By",
+    "sortByDate": "Created Date",
+    "sortByMeetingDate": "Meeting Date",
+    "starred": "Starred",
+    "tags": "Tags",
+    "thisMonth": "This Month",
+    "thisWeek": "This Week",
+    "today": "Today",
+    "totalRecordings": "{{count}} recording",
+    "totalRecordingsPlural": "{{count}} recordings",
+    "upcoming": "Upcoming",
+    "yesterday": "Yesterday"
+  },
+  "speakers": {
+    "filterBySpeaker": "Filter by speaker",
+    "noMatchingSpeakers": "No matching speakers",
+    "searchSpeakers": "Search..."
+  },
+  "speakersManagement": {
+    "added": "Added",
+    "confidence": "Confidence",
+    "confidenceHigh": "high",
+    "confidenceLow": "low",
+    "confidenceMedium": "medium",
+    "created": "Created",
+    "description": "Manage your saved speakers. These are automatically saved when you use speaker names in your recordings.",
+    "failedToLoad": "Failed to load speakers",
+    "failedToLoadSnippets": "Failed to load snippets",
+    "keepThisSpeaker": "Keep this speaker (others will be merged into it):",
+    "last": "Last",
+    "lastUsed": "Last used",
+    "loadingSpeakers": "Loading speakers...",
+    "match": "match",
+    "mergeDescription": "Combine multiple speaker profiles into one. All embeddings, snippets, and usage data will be merged.",
+    "mergeFailed": "Failed to merge speakers",
+    "mergeNSpeakers": "Merge {{count}} Speakers",
+    "mergeSpeakers": "Merge Speakers",
+    "mergeSuccess": "Speakers merged successfully",
+    "noSnippetsAvailable": "No snippets available",
+    "noSpeakersYet": "No speakers saved yet",
+    "sample": "sample",
+    "samples": "samples",
+    "selectToMerge": "Select 2+ to Merge",
+    "speakersToMerge": "Speakers to merge:",
+    "speakersWillAppear": "Speakers will appear here when you use speaker names in your recordings",
+    "targetWillReceive": "The selected speaker will receive all voice data and snippets from the others.",
+    "time": "time",
+    "times": "times",
+    "totalSpeakers": "speakers saved",
+    "used": "Used",
+    "usedTimes": "Used",
+    "viewSnippets": "View Snippets",
+    "voiceMatchSuggestions": "Voice Match Suggestions",
+    "voiceProfile": "Voice Profile"
+  },
+  "status": {
+    "completed": "Completed",
+    "failed": "Failed",
+    "processing": "Processing",
+    "queued": "Queued",
+    "stuck": "Reset stuck processing",
+    "summarizing": "Summarizing",
+    "transcribing": "Transcribing",
+    "uploading": "Uploading"
+  },
+  "summary": {
+    "actionItems": "Action Items",
+    "cancelEdit": "Cancel Edit",
+    "decisions": "Decisions",
+    "editSummary": "Edit Summary",
+    "generateSummary": "Generate Summary",
+    "keyPoints": "Key Points",
+    "noSummary": "No summary available",
+    "participants": "Participants",
+    "regenerateSummary": "Regenerate Summary",
+    "saveSummary": "Save Summary",
+    "summaryFailed": "Summary generation failed",
+    "summaryInProgress": "Summary generation in progress...",
+    "title": "Summary"
+  },
+  "tagManagement": {
+    "asrDefaults": "ASR Defaults",
+    "createTag": "Create Tag",
+    "customPrompt": "Custom Prompt",
+    "description": "Organize your recordings with custom tags. Each tag can have its own summary prompt and default ASR settings.",
+    "maxSpeakers": "Max",
+    "minSpeakers": "Min",
+    "noTags": "You haven't created any tags yet."
+  },
+  "tags": {
+    "addTag": "Add Tag",
+    "clearTagFilter": "Clear filter",
+    "createTag": "Create Tag",
+    "currentTags": "Current Tags",
+    "filterByTag": "Filter by tag",
+    "manageAllTags": "Manage All Tags",
+    "noAvailableTags": "No available tags",
+    "noMatchingTags": "No matching tags",
+    "noTags": "No tags",
+    "removeTag": "Remove Tag",
+    "searchTags": "Search...",
+    "tagColor": "Tag Color",
+    "tagName": "Tag Name",
+    "title": "Tags"
+  },
+  "tagsModal": {
+    "addTags": "Add Tags",
+    "currentTags": "Current Tags",
+    "done": "Done",
+    "noTagsAssigned": "No tags assigned to this recording",
+    "searchTags": "Search tags..."
+  },
+  "time": {
+    "dayAgo": "1 day ago",
+    "daysAgo": "{{count}} days ago",
+    "hourAgo": "1 hour ago",
+    "hoursAgo": "{{count}} hours ago",
+    "justNow": "Just now",
+    "minuteAgo": "1 minute ago",
+    "minutesAgo": "{{count}} minutes ago",
+    "monthAgo": "1 month ago",
+    "monthsAgo": "{{count}} months ago",
+    "weekAgo": "1 week ago",
+    "weeksAgo": "{{count}} weeks ago",
+    "yearAgo": "1 year ago",
+    "yearsAgo": "{{count}} years ago"
+  },
+  "tooltips": {
+    "changeSpeaker": "Change speaker",
+    "clearChat": "Clear chat",
+    "copyTranscript": "Copy transcript",
+    "deleteTeam": "Delete Group",
+    "doubleClickToEdit": "Double-click to edit",
+    "downloadTranscriptWithTemplate": "Download transcript with template",
+    "editTeam": "Edit Group",
+    "editText": "Edit text",
+    "editTitle": "Edit title",
+    "regenerateTitle": "Regenerate title with AI",
+    "assignFolder": "Assign Folder",
+    "discardIncognito": "Discard incognito recording",
+    "editTranscript": "Edit transcript",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "Expand",
+    "followPlayerDisabled": "Enable auto-scroll - transcript follows audio playback",
+    "followPlayerEnabled": "Disable auto-scroll - transcript stays in place",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "Grant public sharing permission",
+    "hideVideo": "Hide video",
+    "highlight": "Highlight",
+    "makeAdmin": "Make Admin",
+    "manageMembers": "Manage Members",
+    "manageTeamTags": "Manage Group Tags",
+    "markAsRead": "Mark as read",
+    "maximizeChat": "Maximize chat",
+    "minimize": "Minimize",
+    "moveToInbox": "Move to inbox",
+    "mute": "Mute",
+    "pause": "Pause",
+    "play": "Play",
+    "playbackSpeed": "Playback speed",
+    "removeAdmin": "Remove Admin",
+    "removeFromQueue": "Remove from queue",
+    "removeFromTeam": "Remove from team",
+    "removeHighlight": "Remove highlight",
+    "reprocessTranscription": "Reprocess transcription",
+    "reprocessWithAsr": "Reprocess with ASR",
+    "restoreChat": "Restore chat",
+    "revokePublicSharing": "Revoke public sharing permission",
+    "shareWithUsers": "Share with users",
+    "showVideo": "Show video",
+    "switchToDarkMode": "Switch to Dark Mode",
+    "switchToLightMode": "Switch to Light Mode",
+    "unmute": "Unmute"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Available Templates",
+    "availableVars": "Available Variables",
+    "cancel": "Cancel",
+    "chooseTemplate": "Choose template...",
+    "createDefaults": "Create Default Templates",
+    "createNew": "Create Template",
+    "default": "Default",
+    "delete": "Delete",
+    "description": "Customize how transcripts are formatted for download and export.",
+    "downloadDefault": "Download default",
+    "downloadWithoutTemplate": "Download without template",
+    "filters": "Filters: |upper for uppercase, |srt for subtitle time format",
+    "save": "Save",
+    "selectOrCreate": "Select a template to edit or create a new one",
+    "selectTemplate": "Select Template",
+    "setDefault": "Set as default template",
+    "tabTitle": "Transcript",
+    "template": "Template",
+    "templateName": "Template Name",
+    "title": "Transcript Templates",
+    "viewGuide": "View Template Guide"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Auto-identify Speakers",
+    "bubble": "Bubble",
+    "cancelEdit": "Cancel Edit",
+    "copy": "Copy",
+    "copyToClipboard": "Copy to Clipboard",
+    "download": "Download",
+    "downloadTranscript": "Download Transcript",
+    "edit": "Edit",
+    "editSpeakers": "Edit Speakers",
+    "editTranscription": "Edit Transcription",
+    "highlightSearchResults": "Highlight search results",
+    "noTranscription": "No transcription available",
+    "regenerateTranscription": "Regenerate Transcription",
+    "saveTranscription": "Save Transcription",
+    "searchInTranscript": "Search in transcript...",
+    "simple": "Simple",
+    "speaker": "Speaker {{number}}",
+    "speakerLabels": "Speaker Labels",
+    "title": "Transcription",
+    "unknownSpeaker": "Unknown Speaker"
+  },
+  "upload": {
+    "chunking": "Large files will be automatically chunked for processing",
+    "completed": "Completed",
+    "copies": "copies of this file",
+    "dropzone": "Drag and drop audio files here, or click to browse",
+    "duplicateDetected": "This file appears to be a duplicate of \"{{existingName}}\" (uploaded {{existingDate}})",
+    "duplicateFile": "Duplicate file",
+    "failed": "Failed",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "Maximum file size",
+    "queued": "Queued",
+    "selectFiles": "Select Files",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "Summarizing...",
+    "supportedFormats": "Supports MP3, WAV, M4A, MP4, MOV, AVI, AMR, and more",
+    "title": "Upload Audio",
+    "transcribing": "Transcribing...",
+    "untitled": "Untitled Recording",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "Upload Progress",
+    "videoRetained": "Video preserved for playback",
+    "willAutoSummarize": "Will auto-summarize after transcription"
+  },
+  "uploadProgress": {
+    "title": "Upload Progress"
+  },
+  "promptVariables": {
+    "title": "Prompt variables",
+    "infoTooltip": "About prompt variables",
+    "hintUpload": "The selected tag or folder uses prompt placeholders. Fill these in and they'll be substituted into the summarisation prompt for this recording. Empty values substitute to an empty string. Up to 8,000 characters per value, 32,000 across all variables.",
+    "hintReprocess": "These values are substituted into placeholders in the resolved prompt. Edits here are saved on the recording. Empty values substitute to an empty string. Up to 8,000 characters per value, 32,000 across all variables.",
+    "placeholderPrefix": "Enter"
+  },
+  "summaryMode": {
+    "applyMode": "Apply mode",
+    "append": "Append",
+    "appendHelp": "Use the default prompt and add this as extra context.",
+    "replace": "Replace",
+    "replaceHelp": "Use only this text as the summarisation instructions."
+  },
+  "customizeSummary": {
+    "title": "Customise summary prompt",
+    "body": "Add one-off context for this summary, or replace the resolved prompt entirely.",
+    "additionalContext": "Additional context",
+    "customPrompt": "Custom prompt",
+    "appendPlaceholder": "e.g. Today's agenda is: ...",
+    "replacePlaceholder": "Enter a complete summarisation prompt...",
+    "generateSummary": "Generate Summary"
+  },
+  "asrEditor": {
+    "saved": "Saved",
+    "ctrlSHint": "Ctrl+S to save",
+    "saveWithoutClosing": "Save without closing (Ctrl+S)"
+  },
+  "preview": {
+    "placeholderLegend": "Placeholder legend:",
+    "systemReplaced": "system-replaced (current date, transcript, tag names, etc.)",
+    "userSupplied": "user-supplied at upload or reprocess",
+    "userMessageHeading": "User Message:",
+    "liveUpdateNote": "The Summarization Instructions slot updates as you edit your custom prompt above. Placeholders are replaced with real values when a recording is processed."
+  }
+}
diff --git a/static/locales/es.json b/static/locales/es.json
new file mode 100644
index 00000000..a18114d2
--- /dev/null
+++ b/static/locales/es.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "Resumen con IA",
+    "aiSummarizationDesc": "Integración de OpenRouter y Ollama con prompts personalizados",
+    "asrEnabled": "ASR Habilitado",
+    "asrEndpoint": "Punto de Acceso ASR",
+    "audioTranscription": "Transcripción de Audio",
+    "audioTranscriptionDesc": "API de Whisper y soporte ASR personalizado con alta precisión",
+    "backend": "Backend",
+    "database": "Base de Datos",
+    "deployment": "Despliegue",
+    "dockerDescription": "Imágenes oficiales de Docker",
+    "dockerHub": "Docker Hub",
+    "documentation": "Documentación",
+    "documentationDescription": "Guías de configuración y manual del usuario",
+    "endpoint": "Punto de Acceso",
+    "frontend": "Frontend",
+    "githubDescription": "Código fuente, problemas y versiones",
+    "githubRepository": "Repositorio de GitHub",
+    "inquireMode": "Modo de Consulta",
+    "inquireModeDesc": "Búsqueda semántica en todas tus grabaciones",
+    "interactiveChat": "Chat Interactivo",
+    "interactiveChatDesc": "Chatea con tus transcripciones usando IA",
+    "keyFeatures": "Características Principales",
+    "largeLanguageModel": "Modelo de Lenguaje Grande",
+    "model": "Modelo",
+    "projectDescription": "Transforma tus grabaciones de audio en notas organizadas y buscables con funciones de transcripción, resumen y chat interactivo impulsadas por IA.",
+    "projectLinks": "Enlaces del Proyecto",
+    "sharingExport": "Compartir y Exportar",
+    "sharingExportDesc": "Comparte grabaciones y exporta a varios formatos",
+    "speakerDiarization": "Diarización de Hablantes",
+    "speakerDiarizationDesc": "Identifica y etiqueta diferentes hablantes automáticamente",
+    "speechRecognition": "Reconocimiento de Voz",
+    "systemConfiguration": "Configuración del Sistema",
+    "tagline": "Transcripción de Audio y Toma de Notas Impulsada por IA",
+    "technologyStack": "Pila Tecnológica",
+    "title": "Acerca de",
+    "version": "Versión",
+    "whisperApi": "API de Whisper"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "Integración con OpenRouter y Ollama con prompts personalizados",
+    "asrEnabled": "ASR Habilitado",
+    "asrEndpoint": "Punto de Acceso ASR",
+    "audioTranscriptionDesc": "API de Whisper y soporte ASR personalizado con alta precisión",
+    "backend": "Backend",
+    "database": "Base de Datos",
+    "deployment": "Implementación",
+    "dockerDescription": "Imágenes oficiales de Docker",
+    "documentationDescription": "Guías de configuración y manual de usuario",
+    "endpoint": "Punto de Acceso",
+    "frontend": "Frontend",
+    "githubDescription": "Código fuente, problemas y versiones",
+    "inquireModeDesc": "Búsqueda semántica en todas tus grabaciones",
+    "interactiveChatDesc": "Chatea con tus transcripciones usando IA",
+    "model": "Modelo",
+    "no": "No",
+    "sharingExportDesc": "Comparte grabaciones y exporta a varios formatos",
+    "speakerDiarizationDesc": "Identifica y etiqueta diferentes oradores automáticamente",
+    "whisperApi": "API de Whisper",
+    "yes": "Sí"
+  },
+  "account": {
+    "accountActions": "Acciones de la Cuenta",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "Cambiar Contraseña",
+    "chooseLanguageForInterface": "Elige el idioma para la interfaz de la aplicación",
+    "companyOrganization": "Empresa / Organización",
+    "completedRecordings": "Completadas",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "Correo Electrónico",
+    "failedRecordings": "Fallidas",
+    "fullName": "Nombre Completo",
+    "goToRecordings": "Ir a Grabaciones",
+    "interfaceLanguage": "Idioma de la Interfaz",
+    "jobTitle": "Cargo",
+    "languageForSummaries": "Idioma para títulos, resúmenes y chat. Dejar en blanco para el predeterminado (comportamiento predeterminado de sus modelos elegidos).",
+    "languagePreferences": "Preferencias de Idioma",
+    "leaveBlankForAutoDetect": "Dejar en blanco para detección automática por el servicio de transcripción",
+    "manageSpeakers": "Gestionar Hablantes",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "Información Personal",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "Idioma Preferido para Chatbot y Resúmenes",
+    "processingRecordings": "En Procesamiento",
+    "saveAllPreferences": "Guardar Todas las Preferencias",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "Estadísticas de la Cuenta",
+    "title": "Información de la Cuenta",
+    "totalRecordings": "Total de Grabaciones",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "Idioma de Transcripción",
+    "userDetails": "Detalles del Usuario",
+    "username": "Nombre de Usuario"
+  },
+  "accountTabs": {
+    "about": "Acerca de",
+    "apiTokens": "Tokens de API",
+    "customPrompts": "Prompts Personalizados",
+    "folderManagement": "Gestión de carpetas",
+    "namingTemplates": "Nombrado",
+    "promptOptions": "Opciones de Prompt",
+    "sharedTranscripts": "Transcripciones Compartidas",
+    "speakersManagement": "Gestión de Hablantes",
+    "tagManagement": "Gestión de Etiquetas",
+    "templates": "Plantillas",
+    "transcriptTemplates": "Plantillas de Transcripción",
+    "preferences": "Preferencias"
+  },
+  "admin": {
+    "title": "Administración",
+    "userMenu": "Menú de Usuario"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "Acerca del Modo Consulta",
+    "actions": "ACCIONES",
+    "addNewUser": "Agregar Nuevo Usuario",
+    "addUser": "Agregar Usuario",
+    "additionalContext": "Contexto Adicional",
+    "admin": "ADMIN",
+    "adminDefaultPrompt": "Prompt Predeterminado del Administrador",
+    "adminDefaultPromptDesc": "El prompt configurado arriba (mostrado en esta página)",
+    "adminUser": "Usuario Administrador",
+    "allRecordingsProcessed": "¡Todas las grabaciones están procesadas!",
+    "allowed": "Allowed",
+    "available": "Disponible",
+    "blocked": "bloqueado",
+    "budgetWarnings": "Advertencias de Presupuesto",
+    "characters": "caracteres",
+    "chunkSize": "Tamaño del Fragmento",
+    "complete": "completado",
+    "completedRecordings": "Completadas",
+    "confirmPasswordLabel": "Confirmar contraseña",
+    "contextNotes": {
+      "jsonConversion": "Las transcripciones JSON se convierten a formato de texto limpio antes de enviar",
+      "modelConfig": "El modelo utilizado se configura a través de la variable de entorno TEXT_MODEL_NAME",
+      "tagPrompts": "Si existen múltiples indicaciones de etiquetas, se fusionan en el orden en que se agregaron las etiquetas",
+      "transcriptLimit": "Las transcripciones están limitadas a un número configurable de caracteres (predeterminado: 30,000)"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "Uso actual",
+    "currentUsageMinutes": "Uso Actual",
+    "defaultPromptInfo": "Este prompt predeterminado se utilizará para todos los usuarios que no hayan establecido su propio prompt personalizado en la configuración de su cuenta.",
+    "defaultPrompts": "Prompts por Defecto",
+    "defaultSummarizationPrompt": "Prompt de Resumen Predeterminado",
+    "description": "Description",
+    "editUser": "Editar Usuario",
+    "email": "E-MAIL",
+    "emailLabel": "Correo electrónico",
+    "embeddingModel": "Modelo de Incrustación",
+    "embeddingsStatus": "Estado de Incrustaciones",
+    "errors": {
+      "failedToLoadPrompt": "Error al cargar el prompt predeterminado",
+      "failedToSavePrompt": "Error al guardar el prompt predeterminado. Por favor, inténtalo de nuevo.",
+      "invalidFileSize": "Por favor ingrese un tamaño válido entre 1 y 10000 MB",
+      "invalidInteger": "Por favor ingrese un número entero válido",
+      "invalidNumber": "Por favor ingrese un número válido",
+      "maxTimeout": "El tiempo de espera no puede exceder 10 horas (36000 segundos)",
+      "minCharacters": "Por favor ingrese un número válido de al menos 1000 caracteres",
+      "minTimeout": "El tiempo de espera debe ser de al menos 60 segundos"
+    },
+    "failedRecordings": "Fallidas",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "El Modo Inquire permite a los usuarios buscar en múltiples transcripciones usando preguntas en lenguaje natural. Funciona dividiendo las transcripciones en fragmentos y creando incrustaciones buscables usando modelos de IA.",
+    "languagePreferenceNote": "Nota: Si el usuario ha establecido una preferencia de idioma de salida, se agregará \" Asegúrese de que su respuesta esté en {idioma}.\".",
+    "lastUpdated": "Última actualización",
+    "maxFileSizeHelp": "Tamaño máximo de archivo en megabytes (1-10000 MB)",
+    "megabytes": "MB",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "minutos",
+    "monthlyCost": "Costo Mensual",
+    "monthlyTokenBudget": "Presupuesto Mensual de Tokens",
+    "monthlyTranscriptionBudget": "Presupuesto Mensual de Transcripción (minutos)",
+    "needProcessing": "Necesita Procesamiento",
+    "never": "Nunca",
+    "newPasswordLabel": "Nueva Contraseña (dejar en blanco para mantener la actual)",
+    "no": "No",
+    "noData": "Sin datos",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "Sin descripción disponible",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "Sin Límite",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "No hay datos de uso de transcripción disponibles",
+    "none": "Ninguno",
+    "notSet": "No establecido",
+    "overlap": "Superposición",
+    "passwordLabel": "Contraseña",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "Pendientes",
+    "percentUsed": "usado",
+    "placeholdersNote": "Los marcadores de posición se reemplazan con valores reales al procesar una grabación.",
+    "processAllRecordings": "Procesar Todas las Grabaciones",
+    "processNext10": "Procesar Próximas 10",
+    "processedForInquire": "Procesado para Consulta",
+    "processing": "Procesando...",
+    "processingActions": "Acciones de Procesamiento",
+    "processingProgress": "Progreso de Procesamiento",
+    "processingRecordings": "En Procesamiento",
+    "promptDescription": "Este prompt se utilizará para generar resúmenes para todas las grabaciones cuando los usuarios no hayan establecido su propio prompt.",
+    "promptHierarchy": "Jerarquía de Prompts",
+    "promptPriorityDescription": "El sistema utiliza el siguiente orden de prioridad al seleccionar qué prompt usar:",
+    "promptResetMessage": "Prompt restablecido al predeterminado del sistema. Haz clic en \"Guardar Cambios\" para aplicar.",
+    "promptSavedSuccessfully": "¡Prompt predeterminado guardado con éxito!",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "Distribución del Estado de Grabaciones",
+    "recordings": "GRABACIONES",
+    "recordingsNeedProcessing": "Hay {{count}} grabaciones que necesitan ser procesadas para el Modo Inquire.",
+    "refreshStatus": "Actualizar Estado",
+    "resetToDefault": "Restablecer a Predeterminado",
+    "saving": "Guardando...",
+    "searchUsers": "Buscar usuarios...",
+    "seconds": "segundos",
+    "settings": {
+      "asrTimeoutDesc": "Tiempo máximo en segundos para esperar a que se complete la transcripción ASR. El valor predeterminado es 1800 segundos (30 minutos).",
+      "defaultSummaryPromptDesc": "Indicación de resumen predeterminada utilizada cuando los usuarios no han establecido su propia indicación. Esto sirve como la indicación base para todos los usuarios.",
+      "maxFileSizeDesc": "Tamaño máximo de archivo permitido para cargas de audio en megabytes (MB).",
+      "recordingDisclaimerDesc": "Aviso legal mostrado a los usuarios antes de comenzar la grabación. Admite formato Markdown. Dejar vacío para desactivar.",
+      "uploadDisclaimerDesc": "Aviso legal mostrado antes de subir archivos. Admite Markdown. Dejar vacío para desactivar.",
+      "customBannerDesc": "Banner personalizado mostrado en la parte superior de la página. Admite Markdown. Dejar vacío para desactivar.",
+      "transcriptLengthLimitDesc": "Número máximo de caracteres a enviar desde la transcripción al LLM para resumen y chat. Use -1 para sin límite."
+    },
+    "storageUsed": "ALMACENAMIENTO USADO",
+    "summarizationInstructions": "Instrucciones de Resumen",
+    "systemFallback": "Respaldo del Sistema",
+    "systemFallbackDesc": "Un valor predeterminado codificado si ninguno de los anteriores está establecido",
+    "systemPrompt": "Prompt del Sistema",
+    "systemSettings": "Configuración del Sistema",
+    "systemStatistics": "Estadísticas del Sistema",
+    "tagCustomPrompt": "Prompt Personalizado de Etiqueta",
+    "tagCustomPromptDesc": "Si una grabación tiene etiquetas con prompts personalizados",
+    "textSearchOnly": "Solo Búsqueda de Texto",
+    "thisMonth": "Este Mes",
+    "timeoutRecommendation": "Recomendado: 30-120 minutos para archivos de audio largos",
+    "title": "Panel de Administración",
+    "todaysMinutes": "Minutos de Hoy",
+    "tokenBudgetExceeded": "Presupuesto mensual de tokens excedido. Por favor contacte a su administrador.",
+    "tokenBudgetHelp": "Establezca un límite mensual de tokens para funciones de IA. Deje vacío para ilimitado.",
+    "tokenBudgetPlaceholder": "Deje vacío para ilimitado",
+    "tokenUsage": "Uso de tokens",
+    "tokens": "tokens",
+    "topUsers": "Usuarios Principales",
+    "topUsersByStorage": "Principales Usuarios por Almacenamiento",
+    "total": "Total",
+    "totalChunks": "Total de Fragmentos",
+    "totalQueries": "Total de Consultas",
+    "totalRecordings": "Total de Grabaciones",
+    "totalStorage": "Almacenamiento Total",
+    "totalUsers": "Total de Usuarios",
+    "transcriptionBudgetHelp": "Limite los minutos de transcripción por mes. Deje vacío para ilimitado.",
+    "transcriptionBudgetPlaceholder": "Deje vacío para ilimitado",
+    "transcriptionUsage": "Uso de Transcripción",
+    "updateUser": "Actualizar Usuario",
+    "userCustomPrompt": "Prompt Personalizado del Usuario",
+    "userCustomPromptDesc": "Si el usuario ha establecido su propio prompt en la configuración de la cuenta",
+    "userManagement": "Gestión de Usuarios",
+    "userMessageTemplate": "Plantilla de Mensaje del Usuario",
+    "userTranscriptionUsage": "Uso de Transcripción por Usuario (Este Mes)",
+    "username": "NOMBRE DE USUARIO",
+    "usernameLabel": "Nombre de usuario",
+    "vectorDimensions": "Dimensiones del Vector",
+    "vectorStore": "Almacén Vectorial",
+    "vectorStoreManagement": "Gestión del Almacén Vectorial",
+    "vectorStoreUpToDate": "El almacén de vectores está actualizado.",
+    "viewFullPromptStructure": "Ver Estructura Completa del Prompt LLM",
+    "warning": "advertencia",
+    "yes": "Sí"
+  },
+  "apiTokens": {
+    "activeTokens": "Tokens activos",
+    "createFirstToken": "Crea tu primer token de API para habilitar el acceso programático",
+    "createToken": "Crear token",
+    "created": "Creado",
+    "description": "Crea y gestiona tokens de API para acceso programático a tu cuenta",
+    "expires": "Expira",
+    "lastUsed": "Último uso",
+    "neverUsed": "Nunca usado",
+    "noExpiration": "Sin expiración",
+    "noTokens": "Sin tokens de API",
+    "securityNotice": "Aviso de seguridad",
+    "securityWarning": "Trata los tokens de API como contraseñas. Proporcionan acceso completo a tu cuenta. Nunca compartas tokens en áreas públicas como GitHub, código del lado del cliente o logs",
+    "title": "Tokens de API",
+    "usageExamples": "Ejemplos de uso"
+  },
+  "buttons": {
+    "addSegment": "Agregar Segmento",
+    "addSpeaker": "Añadir Hablante",
+    "cancel": "Cancel",
+    "clearAllFilters": "Limpiar todos los filtros",
+    "clearCompleted": "Limpiar cargas completadas",
+    "clearSearchText": "Limpiar texto de búsqueda",
+    "close": "Close",
+    "copy": "Copiar",
+    "copyMessage": "Copiar mensaje",
+    "copyNotes": "Copiar Notas",
+    "copySummary": "Copiar Resumen",
+    "copyToClipboard": "Copiar al Portapapeles",
+    "createTag": "Create Tag",
+    "deleteAll": "Delete All",
+    "deleteSpeaker": "Eliminar hablante",
+    "deleteTag": "Eliminar etiqueta",
+    "deleteUser": "Eliminar usuario",
+    "downloadAsWord": "Descargar como Word",
+    "downloadAudio": "Descargar audio",
+    "downloadChat": "Descargar chat como documento de Word",
+    "downloadNotes": "Descargar notas como documento de Word",
+    "downloadSummary": "Descargar resumen como documento de Word",
+    "editNotes": "Editar Notas",
+    "editSetting": "Editar configuración",
+    "editSpeakers": "Editar Hablantes...",
+    "editSummary": "Editar Resumen",
+    "editTag": "Editar etiqueta",
+    "editTags": "Editar etiquetas",
+    "editTranscription": "Editar Transcripción",
+    "editUser": "Editar usuario",
+    "exportCalendar": "Exportar al Calendario",
+    "help": "Ayuda",
+    "identifySpeakers": "Identificar Hablantes",
+    "next": "Siguiente",
+    "previous": "Anterior",
+    "refresh": "Refresh",
+    "reprocessSummary": "Reprocesar resumen",
+    "reprocessTranscription": "Reprocesar transcripción",
+    "reprocessWithAsr": "Reprocesar con ASR",
+    "resetStuckProcessing": "Restablecer procesamiento bloqueado",
+    "saveChanges": "Guardar Cambios",
+    "saveCustomPrompt": "Guardar Prompt Personalizado",
+    "saveNames": "Guardar Nombres",
+    "saveSettings": "Guardar Configuración",
+    "shareRecording": "Compartir Grabación",
+    "toggleTheme": "Cambiar tema",
+    "updateTag": "Update Tag"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Confirmar Nueva Contraseña",
+    "currentPassword": "Contraseña Actual",
+    "newPassword": "Nueva Contraseña",
+    "passwordRequirement": "La contraseña debe tener al menos 8 caracteres",
+    "title": "Cambiar Contraseña"
+  },
+  "chat": {
+    "availableAfterTranscription": "El chat estará disponible una vez que se complete la transcripción",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "Chatear con la Transcripción",
+    "clearChat": "Limpiar Chat",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "Error al enviar el mensaje",
+    "noMessages": "No hay mensajes aún",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "Haz una pregunta sobre esta grabación...",
+    "placeholderWithHint": "Haz una pregunta sobre esta grabación... (Enter para enviar, Ctrl+Enter para nueva línea)",
+    "send": "Enviar",
+    "suggestedQuestions": "Preguntas Sugeridas",
+    "thinking": "Pensando...",
+    "title": "Chat",
+    "whatAreActionItems": "¿Cuáles son los elementos de acción?",
+    "whatAreKeyPoints": "¿Cuáles son los puntos clave?",
+    "whatWasDiscussed": "¿Qué se discutió?",
+    "whoSaidWhat": "¿Quién dijo qué?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Elige una grabación de la barra lateral para ver su transcripción y resumen",
+    "darkThemes": "Temas Oscuros",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "Temas Claros",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "Restablecer por Defecto",
+    "selectRecording": "Seleccionar una Grabación",
+    "subtitle": "Personaliza tu interfaz con hermosos temas de color",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Azul Océano",
+          "description": "Tema azul clásico con atractivo profesional"
+        },
+        "emerald": {
+          "name": "Esmeralda Bosque",
+          "description": "Tema verde fresco para sensación natural"
+        },
+        "purple": {
+          "name": "Púrpura Real",
+          "description": "Tema púrpura elegante con sofisticación"
+        },
+        "rose": {
+          "name": "Rosa Atardecer",
+          "description": "Tema rosa cálido con energía suave"
+        },
+        "amber": {
+          "name": "Ámbar Dorado",
+          "description": "Tema amarillo cálido para luminosidad"
+        },
+        "teal": {
+          "name": "Turquesa Océano",
+          "description": "Tema turquesa fresco para tranquilidad"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Azul Medianoche",
+          "description": "Tema azul profundo para trabajo enfocado"
+        },
+        "emerald": {
+          "name": "Bosque Oscuro",
+          "description": "Tema verde rico para visualización cómoda"
+        },
+        "purple": {
+          "name": "Púrpura Profundo",
+          "description": "Tema púrpura misterioso para creatividad"
+        },
+        "rose": {
+          "name": "Rosa Oscuro",
+          "description": "Tema rosa tenue con calidez sutil"
+        },
+        "amber": {
+          "name": "Ámbar Oscuro",
+          "description": "Tema marrón cálido para sesiones acogedoras"
+        },
+        "teal": {
+          "name": "Turquesa Profundo",
+          "description": "Tema turquesa oscuro para enfoque tranquilo"
+        }
+      }
+    },
+    "title": "Elegir Esquema de Color"
+  },
+  "common": {
+    "back": "Atrás",
+    "cancel": "Cancelar",
+    "changesSaved": "Cambios guardados",
+    "close": "Cerrar",
+    "confirm": "Confirmar",
+    "delete": "Eliminar",
+    "deselectAll": "Deseleccionar Todo",
+    "download": "Descargar",
+    "edit": "Editar",
+    "error": "Error",
+    "failed": "Fallido",
+    "filter": "Filtrar",
+    "info": "Información",
+    "loading": "Cargando...",
+    "new": "Nuevo",
+    "next": "Siguiente",
+    "no": "No",
+    "noResults": "No se encontraron resultados",
+    "ok": "OK",
+    "or": "Or",
+    "previous": "Anterior",
+    "processing": "Procesando...",
+    "refresh": "Actualizar",
+    "retry": "Reintentar",
+    "save": "Guardar",
+    "search": "Buscar",
+    "selectAll": "Seleccionar Todo",
+    "sort": "Ordenar",
+    "success": "Éxito",
+    "untitled": "Grabación sin título",
+    "upload": "Subir",
+    "warning": "Advertencia",
+    "yes": "Sí"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Prompt Predeterminado Actual (Se usa si dejas lo anterior en blanco)",
+    "promptDescription": "Este prompt se utilizará para generar resúmenes de tus transcripciones. Anula el prompt predeterminado del administrador.",
+    "promptPlaceholder": "Describe cómo quieres que estén estructurados tus resúmenes. Deja en blanco para usar el prompt predeterminado del administrador.",
+    "summaryGeneration": "Prompt de Generación de Resúmenes",
+    "tip1": "Sé específico sobre las secciones que quieres en tu resumen",
+    "tip2": "Usa instrucciones de formato claras (ej. \"Usa viñetas\", \"Crea listas numeradas\")",
+    "tip3": "Especifica si quieres que cierta información sea priorizada",
+    "tip4": "El sistema proporcionará automáticamente el contenido de la transcripción a la IA",
+    "tip5": "Tu preferencia de idioma de salida (si está configurada) se aplicará automáticamente",
+    "tipsTitle": "Consejos para Escribir Prompts Efectivos",
+    "yourCustomPrompt": "Tu Prompt Personalizado de Resumen"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "¿Estás seguro de que quieres eliminar todos los oradores guardados? Esta acción no se puede deshacer.",
+    "title": "Eliminar Todos los Oradores"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Cancelar",
+      "confirm": "Eliminar",
+      "message": "¿Estás seguro de que deseas eliminar esta grabación? Esta acción no se puede deshacer.",
+      "title": "Eliminar Grabación"
+    },
+    "deleteShare": {
+      "message": "¿Estás seguro de que quieres eliminar este enlace compartido? Esto revocará el acceso al enlace público.",
+      "title": "Eliminar enlace compartido"
+    },
+    "reprocessTranscription": {
+      "cancel": "Cancelar",
+      "confirm": "Reprocesar",
+      "message": "¿Estás seguro de que deseas reprocesar esta transcripción? La transcripción actual será reemplazada.",
+      "title": "Reprocesar Transcripción"
+    },
+    "unsavedChanges": {
+      "cancel": "Cancelar",
+      "discard": "Descartar",
+      "message": "Tienes cambios sin guardar. ¿Deseas guardarlos antes de salir?",
+      "save": "Guardar",
+      "title": "Cambios Sin Guardar"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} hora",
+    "hoursPlural": "{{count}} horas",
+    "minutes": "{{count}} minuto",
+    "minutesPlural": "{{count}} minutos",
+    "seconds": "{{count}} segundo",
+    "secondsPlural": "{{count}} segundos"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "Configuraciones Predeterminadas de ASR",
+    "asrSettingsDescription": "Estas configuraciones se aplicarán por defecto al usar esta etiqueta con transcripción ASR",
+    "color": "Color",
+    "colorDescription": "Elige un color para fácil identificación",
+    "createTitle": "Crear Etiqueta",
+    "customPrompt": "Prompt de Resumen Personalizado",
+    "customPromptPlaceholder": "Opcional: Prompt personalizado para generar resúmenes de grabaciones con esta etiqueta",
+    "defaultLanguage": "Idioma Predeterminado",
+    "defaultPromptPlaceholder": "Deja en blanco para usar tu prompt de resumen predeterminado",
+    "exportTemplate": "Plantilla de exportación",
+    "exportTemplateHint": "Selecciona una plantilla de exportación para usar al exportar grabaciones con esta etiqueta",
+    "leaveBlankPrompt": "Deja en blanco para usar tu prompt de resumen predeterminado",
+    "maxSpeakers": "Máximo de Oradores",
+    "minSpeakers": "Mínimo de Oradores",
+    "namingTemplate": "Plantilla de nombrado",
+    "namingTemplateHint": "Selecciona una plantilla de nombrado para formatear automáticamente los títulos de las grabaciones con esta etiqueta",
+    "noExportTemplate": "Sin plantilla (usar predeterminado del usuario)",
+    "noNamingTemplate": "Sin plantilla (usar predeterminado o título IA)",
+    "tagName": "Nombre de la Etiqueta *",
+    "tagNamePlaceholder": "ej., Reuniones, Entrevistas",
+    "title": "Editar Etiqueta",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "Esta etiqueta está configurada como carpeta vigilada y el prompt contiene variables de marcador de posición. Las grabaciones procesadas a través del directorio de auto-procesamiento no tienen interfaz para que los usuarios completen esos valores, así que los marcadores se sustituirán por cadenas vacías en el primer resumen. Elimina los marcadores o completa los valores mediante reprocesamiento tras la subida."
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "音频录制失败。请检查您的麦克风。",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "文件太大",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "发生错误",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "Error al cargar los compartidos",
+    "networkError": "网络错误。请检查您的连接。",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "未找到",
+    "permissionDenied": "权限被拒绝",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "存储配额已超出",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "服务器错误。请稍后重试。",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "摘要生成失败。请重试。",
+    "transcriptionFailed": "转录失败。请重试。",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "未授权",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "不支持的文件格式",
+    "uploadFailed": "上传失败。请重试。",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "验证错误",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "Cuando está habilitado, la IA identificará reuniones, citas y plazos mencionados en tus grabaciones y creará eventos de calendario descargables.",
+    "enableLabel": "Habilitar extracción automática de eventos de las transcripciones",
+    "info": "Los eventos extraídos aparecerán en la pestaña 'Eventos' en las grabaciones donde se detecten elementos de calendario.",
+    "title": "Extracción de Eventos"
+  },
+  "events": {
+    "add": "Agregar",
+    "addToCalendar": "Agregar al Calendario",
+    "attendees": "Asistentes",
+    "confirmDelete": "¿Eliminar evento \"{title}\"?",
+    "delete": "Eliminar",
+    "deleteFailed": "Error al eliminar el evento",
+    "deleted": "Evento eliminado",
+    "end": "Fin",
+    "location": "Ubicación",
+    "noEvents": "No se detectaron eventos en esta grabación",
+    "start": "Inicio",
+    "title": "Eventos"
+  },
+  "exportLabels": {
+    "created": "Creado",
+    "date": "Fecha",
+    "fileSize": "Tamaño del archivo",
+    "footer": "Generado con [Speakr](https://github.com/learnedmachine/speakr)",
+    "metadata": "Metadatos",
+    "notes": "Notas",
+    "originalFile": "Archivo original",
+    "participants": "Participantes",
+    "summarizationTime": "Tiempo de resumen",
+    "summary": "Resumen",
+    "tags": "Etiquetas",
+    "transcription": "Transcripción",
+    "transcriptionTime": "Tiempo de transcripción"
+  },
+  "exportTemplates": {
+    "availableLabels": "Etiquetas localizadas (traducidas automáticamente)",
+    "availableTemplates": "Plantillas disponibles",
+    "availableVars": "Variables disponibles",
+    "cancel": "Cancelar",
+    "conditionals": "Condicionales",
+    "conditionalsHint": "Usa {{#if variable}}...{{/if}} para incluir contenido condicionalmente",
+    "contentSections": "Secciones de contenido",
+    "createDefaults": "Crear plantilla predeterminada",
+    "createNew": "Crear plantilla",
+    "default": "Predeterminada",
+    "delete": "Eliminar",
+    "description": "Personaliza cómo se exportan las grabaciones a archivos markdown.",
+    "recordingData": "Datos de grabación",
+    "save": "Guardar",
+    "selectOrCreate": "Selecciona una plantilla para editar o crea una nueva",
+    "setDefault": "Establecer como plantilla predeterminada",
+    "tabTitle": "Exportación",
+    "template": "Plantilla",
+    "templateDescription": "Descripción",
+    "templateName": "Nombre de la plantilla",
+    "title": "Plantillas de exportación",
+    "viewGuide": "Ver guía de plantillas"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "Todas las carpetas",
+    "asrDefaults": "Valores ASR predeterminados",
+    "autoShareOnApply": "Compartir automáticamente con miembros del grupo",
+    "autoShareOnApplyHelp": "Compartir grabaciones automáticamente con todos los miembros del grupo al añadirlas a esta carpeta",
+    "confirmDelete": "¿Estás seguro de que quieres eliminar esta carpeta? Las grabaciones se eliminarán de la carpeta pero no se borrarán.",
+    "createFolder": "Crear carpeta",
+    "customPrompt": "Prompt personalizado",
+    "defaultLanguage": "Idioma predeterminado",
+    "deleteFolder": "Eliminar carpeta",
+    "description": "Organiza tus grabaciones en carpetas. A diferencia de las etiquetas, una grabación solo puede pertenecer a una carpeta. Los prompts de carpeta se aplican antes que los del usuario pero después de los de etiqueta.",
+    "editFolder": "Editar carpeta",
+    "filterByFolder": "Filtrar por carpeta",
+    "folderColor": "Color de carpeta",
+    "folderName": "Nombre de carpeta",
+    "groupSettings": "Configuración de grupo",
+    "maxSpeakers": "Máx. hablantes",
+    "minSpeakers": "Mín. hablantes",
+    "moveToFolder": "Mover a carpeta",
+    "namingTemplate": "Plantilla de nombrado",
+    "noFolder": "Sin carpeta",
+    "noFolders": "Aún no se han creado carpetas",
+    "noFoldersDescription": "Crea tu primera carpeta para organizar tus grabaciones",
+    "protectFromDeletion": "Proteger contra eliminación",
+    "protectFromDeletionHelp": "Proteger las grabaciones en esta carpeta contra la eliminación automática",
+    "recordings": "grabaciones",
+    "removeFromFolder": "Quitar de carpeta",
+    "retentionDays": "Días de retención",
+    "retentionDaysHelp": "Las grabaciones en esta carpeta se eliminarán después de estos días. Dejar vacío para usar la retención global.",
+    "retentionSettings": "Configuración de retención",
+    "selectNamingTemplate": "Seleccionar plantilla de nombrado...",
+    "shareWithGroupLead": "Compartir con administradores del grupo",
+    "shareWithGroupLeadHelp": "Compartir grabaciones con administradores del grupo al añadirlas a esta carpeta",
+    "title": "Gestión de carpetas"
+  },
+  "form": {
+    "auto": "Auto",
+    "autoDetect": "Detección automática",
+    "dateFrom": "Desde",
+    "dateTo": "Hasta",
+    "enterNotesMarkdown": "Ingrese notas en formato Markdown...",
+    "enterSummaryMarkdown": "Ingrese resumen en formato Markdown...",
+    "folder": "Folder",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "Idioma",
+    "maxSpeakers": "Hablantes Máximos",
+    "meetingDate": "Fecha de Reunión",
+    "minSpeakers": "Hablantes Mínimos",
+    "minutes": "Minutos",
+    "notes": "Notas",
+    "notesPlaceholder": "Escriba sus notas en formato Markdown...",
+    "optional": "Opcional",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "Participantes",
+    "placeholderAuto": "Auto",
+    "placeholderCharacterLimit": "Ingrese límite de caracteres (ej. 30000)",
+    "placeholderMinutes": "Minutos",
+    "placeholderOptional": "Opcional",
+    "placeholderSeconds": "Segundos",
+    "placeholderSizeMB": "Ingrese tamaño en MB",
+    "searchSpeakers": "Buscar hablantes...",
+    "searchTags": "Buscar etiquetas...",
+    "seconds": "Segundos",
+    "shareNotes": "Compartir Notas",
+    "shareSummary": "Compartir Resumen",
+    "shareableLink": "Enlace Compartible",
+    "summaryPromptPlaceholder": "Ingrese el prompt predeterminado de resumen...",
+    "title": "Título",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "Su nombre completo",
+    "transcriptionModel": "Modelo de transcripción",
+    "useResolvedDefault": "(usar valor por defecto de etiqueta/carpeta/global)",
+    "defaultTranscriptionModel": "Modelo de transcripción por defecto",
+    "defaultTranscriptionModelHelp": "Sobrescribe el modelo de transcripción usado para grabaciones con esta etiqueta o carpeta."
+  },
+  "groups": {
+    "addMembers": "Añadir miembros...",
+    "autoShare": "Compartir automáticamente",
+    "autoShareNote": "Nota: Si ambos están habilitados, todos los miembros del equipo tendrán acceso. Si solo \"administradores del equipo\" está habilitado, solo los líderes del equipo tendrán acceso.",
+    "autoShareTeam": "Compartir automáticamente grabaciones con todos los miembros del equipo cuando se aplique esta etiqueta",
+    "autoSharesWithTeam": "Comparte automáticamente con todos los miembros del equipo",
+    "confirmDelete": "¿Estás seguro de que quieres eliminar este equipo? Esta acción no se puede deshacer.",
+    "createTeam": "Crear Equipo",
+    "createTeamTag": "Crear Nueva Etiqueta de Equipo",
+    "dayRetention": "días de retención",
+    "deleteTeam": "Eliminar Equipo",
+    "deletionExempt": "Exento de eliminación",
+    "deletionExemptHelp": "Las grabaciones con esta etiqueta estarán exentas de eliminación automática, incluso si exceden el período de retención.",
+    "editTeam": "Editar Equipo",
+    "editTeamTag": "Editar Etiqueta de Equipo",
+    "globalRetention": "Retención global",
+    "members": "Miembros",
+    "noMembers": "No hay miembros en este equipo",
+    "noTeamTags": "Aún no se han creado etiquetas de equipo",
+    "noTeams": "Aún no se han creado equipos",
+    "retentionHelp": "Las grabaciones con esta etiqueta serán eliminadas después de estos días. Dejar vacío para usar retención global ({{days}} días).",
+    "retentionPeriod": "Período de Retención (días)",
+    "retentionPlaceholder": "Dejar vacío para usar retención global",
+    "searchUsers": "Buscar usuarios...",
+    "selectTeamLead": "Seleccionar líder del equipo...",
+    "shareWithAdmins": "Compartir grabaciones con administradores del equipo cuando se aplique esta etiqueta",
+    "sharesWithAdminsOnly": "Comparte solo con administradores del equipo",
+    "syncComplete": "Compartidos del equipo sincronizados exitosamente",
+    "syncTeamShares": "Sincronizar Compartidos del Equipo",
+    "syncTeamSharesDescription": "Esto compartirá retroactivamente todas las grabaciones con etiquetas de equipo con los miembros apropiados según la configuración de compartición de la etiqueta.",
+    "teamLead": "Líder del Equipo",
+    "teamName": "Nombre del Equipo",
+    "teamNamePlaceholder": "Ingrese nombre del equipo",
+    "teamTags": "Etiquetas del Equipo",
+    "title": "Gestión de Grupos",
+    "updateTeam": "Actualizar Equipo"
+  },
+  "help": {
+    "actions": "Acciones",
+    "activeFilters": "Filtros activos",
+    "addSegmentBelow": "Añadir segmento debajo",
+    "advancedAsrOptions": "Opciones ASR Avanzadas",
+    "allRecordingsLoaded": "Todas las grabaciones cargadas",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "{{count}} nombre sugerido aplicado",
+    "appliedSuggestedNamesPlural": "{{count}} nombres sugeridos aplicados",
+    "applySuggested": "Aplicar sugeridos",
+    "applySuggestedMobile": "Sugerir",
+    "approachingLimit": "Acercándose al límite de {{limit}}MB",
+    "askAboutTranscription": "Haz preguntas sobre esta transcripción",
+    "audioDeletedDescription": "El archivo de audio de esta grabación ha sido eliminado, pero la transcripción sigue disponible.",
+    "audioDeletedMessage": "El archivo de audio ha sido archivado y ya no está disponible para reproducción.",
+    "audioDeletedTitle": "Archivo de audio eliminado",
+    "audioPlayer": "Reproductor de Audio",
+    "autoIdentify": "Identificar Automáticamente",
+    "autoIdentifyMobile": "Auto",
+    "bothAudioDesc": "Graba tu voz + participantes de reunión (recomendado para reuniones en línea)",
+    "clearFilters": "limpiar filtros",
+    "clickToAddNotes": "Haz clic para añadir notas...",
+    "colorRepeats": "Color se repite desde el hablante {{number}}",
+    "completedFiles": "Archivos Completados",
+    "confirmReprocessingTitle": "Confirmar Reprocesamiento",
+    "copyMessage": "Copiar mensaje",
+    "createFolders": "Create folders",
+    "createPublicLink": "Crear un enlace público para compartir esta grabación. Compartir solo está disponible en conexiones seguras (HTTPS).",
+    "createTags": "Crear etiquetas",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "Eliminar segmento",
+    "discard": "Descartar",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "Fin",
+    "enterNameFor": "Ingresa nombre para",
+    "enterSpeakerName": "Ingrese nombre del orador...",
+    "entireScreen": "Pantalla Completa",
+    "errorChangingSpeaker": "Error al cambiar hablante",
+    "errorOpeningTextEditor": "Error al abrir el editor de texto",
+    "errorSavingText": "Error al guardar texto",
+    "estimatedSize": "Tamaño estimado",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "Generando resumen...",
+    "groups": "grupos",
+    "howToRecordSystemAudio": "Cómo Grabar Audio del Sistema",
+    "identifyAllSpeakers": "Identificar todos los hablantes",
+    "identifying": "Identificando...",
+    "importantNote": "Nota importante",
+    "internalSharingDesc": "Compartir con usuarios específicos de su organización",
+    "lines": "{{count}} líneas",
+    "loadingMore": "Cargando más grabaciones...",
+    "loadingRecordings": "Cargando grabaciones...",
+    "me": "Yo",
+    "microphoneDesc": "Graba solo tu voz",
+    "modelReasoning": "Razonamiento del Modelo",
+    "moreSpeakersThanColors": "Más hablantes que colores disponibles",
+    "navigate": "Navegar",
+    "noDateSet": "Sin fecha establecida",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "Sin participantes",
+    "noRecordingSelected": "No se seleccionó ninguna grabación.",
+    "noSpeakersIdentified": "No se pudieron identificar hablantes a partir del contexto.",
+    "noSuggestionsToApply": "No hay sugerencias para aplicar",
+    "noTagsCreated": "Aún no se han creado etiquetas.",
+    "of": "de",
+    "playFromHere": "Reproducir desde aquí",
+    "pleaseEnterSpeakerName": "Por favor ingresa un nombre de hablante",
+    "processingTime": "Tiempo de procesamiento",
+    "processingTimeDescription": "Esto puede tardar unos minutos en completarse. Puedes continuar usando la aplicación mientras se procesa.",
+    "processingTranscription": "Procesando transcripción...",
+    "publicLinkDesc": "Cualquiera con este enlace puede acceder a la grabación",
+    "recordSystemSteps1": "Haz clic en \"Grabar Audio del Sistema\" o \"Grabar Ambos\".",
+    "recordSystemSteps2": "En la ventana emergente, elige",
+    "recordSystemSteps3": "Asegúrate de marcar la casilla que dice",
+    "recordingFinished": "Grabación terminada",
+    "recordingInProgress": "Grabación en progreso...",
+    "regenerateSummaryAfterNames": "Regenerar resumen después de actualizar nombres",
+    "saved": "¡Guardado!",
+    "savingProgress": "Guardando...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "Oración",
+    "shareSystemAudio": "Compartir audio del sistema",
+    "shareTabAudio": "Compartir audio de pestaña",
+    "sharedOn": "Compartido el",
+    "sharingWindowNoAudio": "Compartir una \"Ventana\" no capturará audio.",
+    "speakerAdded": "Hablante añadido correctamente",
+    "speakerCount": "Hablante",
+    "speakerName": "Nombre del hablante",
+    "speakerNamesUpdated": "¡Nombres de hablantes actualizados correctamente!",
+    "speakers": "Hablantes",
+    "speakersIdentified": "{{count}} hablante identificado correctamente!",
+    "speakersIdentifiedPlural": "{{count}} hablantes identificados correctamente!",
+    "speakersUpdatedSaveToApply": "¡Hablantes actualizados! Guarda la transcripción para aplicar los cambios.",
+    "specificBrowserTab": "pestaña específica del navegador",
+    "startTime": "Inicio",
+    "startingAutoIdentification": "Iniciando identificación automática de hablantes...",
+    "summaryGenerationFailed": "Error al generar el resumen",
+    "summaryGenerationTimedOut": "La generación del resumen expiró",
+    "summaryRegenerationStarted": "Regeneración del resumen iniciada",
+    "summaryUpdated": "¡Resumen actualizado!",
+    "systemAudioDesc": "Graba participantes de reunión y sonidos del sistema",
+    "tagManagement": "Gestión de Etiquetas",
+    "thisActionCannotBeUndone": "Esta acción no se puede deshacer.",
+    "toCaptureAudioFromMeetings": "Para capturar audio de reuniones u otras aplicaciones, debes compartir tu pantalla o una pestaña del navegador.",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "¡Transcripción actualizada correctamente!",
+    "troubleshooting": "Solución de Problemas",
+    "tryAdjustingSearch": "Intenta ajustar tu búsqueda o",
+    "unsupportedBrowser": "Navegador No Soportado",
+    "untitled": "Grabación Sin Título",
+    "uploadRecordingNotes": "Subir Grabación y Notas",
+    "whatWillHappen": "¿Qué pasará?",
+    "whyNotWorking": "¿Por qué no funciona?",
+    "youHaveXSpeakers": "Tiene {{count}} oradores, pero solo hay 16 colores únicos disponibles. Los colores se repetirán después del decimosexto orador."
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "Filtros Activos:",
+    "askQuestions": "Haga Preguntas Sobre Sus Transcripciones",
+    "clearAll": "Limpiar Todo",
+    "dateRange": "Rango de Fechas",
+    "dateRangeActive": "Rango de fechas activo",
+    "exampleQuestion1": "\"¿Qué elementos de acción se discutieron?\"",
+    "exampleQuestion2": "\"¿Cuándo decidimos cambiar la cronología?\"",
+    "exampleQuestion3": "\"¿Qué preocupaciones se plantearon sobre el presupuesto?\"",
+    "exampleQuestion4": "\"¿Quién fue responsable de las tareas de marketing?\"",
+    "exampleQuestions": "Preguntas de Ejemplo:",
+    "filters": "Filtros",
+    "filtersActive": "Filtros activos",
+    "from": "Desde",
+    "noSpeakerData": "No hay datos de oradores disponibles",
+    "placeholder": "Haga preguntas sobre sus transcripciones filtradas...",
+    "selectFilters": "Seleccione filtros a la izquierda para reducir sus transcripciones, luego haga preguntas para obtener información de sus grabaciones.",
+    "sendHint": "Presione Enter para enviar • Ctrl+Enter para nueva línea",
+    "speakerRequirement": "La identificación de oradores requiere grabaciones con múltiples oradores",
+    "speakers": "Oradores",
+    "speakersCount": "oradores",
+    "tags": "Etiquetas",
+    "tagsCount": "etiquetas",
+    "title": "Consultar",
+    "to": "Hasta"
+  },
+  "languages": {
+    "ar": "Árabe",
+    "de": "Alemán",
+    "en": "Inglés",
+    "es": "Español",
+    "fr": "Francés",
+    "hi": "Hindi",
+    "it": "Italiano",
+    "ja": "Japonés",
+    "ko": "Coreano",
+    "nl": "Holandés",
+    "pt": "Portugués",
+    "pt-BR": "Portugués (Brasil)",
+    "ru": "Ruso",
+    "zh": "Chino",
+    "pl": "Polaco",
+    "uk": "Ucraniano",
+    "vi": "Vietnamita",
+    "th": "Tailandés",
+    "tr": "Turco",
+    "id": "Indonesio",
+    "sv": "Sueco",
+    "autoDetect": "Detección automática",
+    "defaultModelDecides": "Por defecto (decide el modelo)"
+  },
+  "manageSpeakersModal": {
+    "created": "Creado",
+    "description": "Gestiona tus oradores guardados. Estos se guardan automáticamente cuando usas nombres de oradores en tus grabaciones.",
+    "failedToLoad": "Error al cargar oradores",
+    "lastUsed": "Último uso",
+    "loadingSpeakers": "Cargando oradores...",
+    "noSpeakersYet": "Aún no hay oradores guardados",
+    "speakersSaved": "{{count}} oradores guardados",
+    "speakersWillAppear": "Los oradores aparecerán aquí cuando uses nombres de oradores en tus grabaciones",
+    "times": "veces",
+    "title": "Gestionar Oradores",
+    "used": "Usado"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "Copiado al portapapeles",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "Descarga iniciada",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "Notas actualizadas exitosamente",
+    "passwordChanged": "Contraseña cambiada exitosamente",
+    "profileUpdated": "Perfil actualizado exitosamente",
+    "recordingDeleted": "Grabación eliminada exitosamente",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "Grabación guardada exitosamente",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "Configuración guardada exitosamente",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "Resumen generado exitosamente",
+    "tagAdded": "Etiqueta añadida exitosamente",
+    "tagRemoved": "Etiqueta eliminada exitosamente",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "Transcripción actualizada exitosamente"
+  },
+  "metadata": {
+    "cancelEdit": "Cancelar",
+    "createdAt": "Creado",
+    "duration": "Duración",
+    "editMetadata": "Editar Metadatos",
+    "fileName": "Nombre del Archivo",
+    "fileSize": "Tamaño del Archivo",
+    "language": "Idioma",
+    "meetingDate": "Fecha de Reunión",
+    "processingTime": "Tiempo de Procesamiento",
+    "saveMetadata": "Guardar",
+    "status": "Estado",
+    "title": "Metadatos",
+    "updatedAt": "Actualizado",
+    "wordCount": "Recuento de Palabras"
+  },
+  "modal": {
+    "addSpeaker": "Agregar Nuevo Orador",
+    "colorScheme": "Esquema de Color",
+    "deleteRecording": "Eliminar Grabación",
+    "editAsrTranscription": "Editar Transcripción ASR",
+    "editParticipants": "Editar Participantes",
+    "editRecording": "Editar Grabación",
+    "editSpeakers": "Editar Oradores",
+    "editTags": "Editar Etiquetas de Grabación",
+    "editTranscription": "Editar Transcripción",
+    "identifySpeakers": "Identificar Hablantes",
+    "recordingNotice": "Aviso de Grabación",
+    "reprocessSummary": "Reprocesar Resumen",
+    "reprocessTranscription": "Reprocesar Transcripción",
+    "resetStatus": "¿Restablecer Estado de Grabación?",
+    "shareRecording": "Compartir Grabación",
+    "sharedTranscripts": "Mis Transcripciones Compartidas",
+    "systemAudioHelp": "Ayuda de Audio del Sistema",
+    "uploadFiles": "Subir Archivos",
+    "uploadNotice": "Aviso de Carga"
+  },
+  "namingTemplates": {
+    "addPattern": "Añadir Patrón",
+    "availableTemplates": "Plantillas Disponibles",
+    "availableVars": "Variables Disponibles",
+    "cancel": "Cancelar",
+    "createDefaults": "Crear Plantillas Predeterminadas",
+    "createNew": "Crear Plantilla",
+    "customVarsHint": "Define patrones regex para extraer variables personalizadas de nombres de archivo.",
+    "delete": "Eliminar",
+    "description": "Define cómo se generan los títulos de las grabaciones a partir de nombres de archivo y contenido de transcripción.",
+    "descriptionLabel": "Descripción",
+    "noDefault": "Sin predeterminado (solo título IA)",
+    "regexHint": "Extrae datos de nombres de archivo. Usa grupos de captura () para especificar la coincidencia.",
+    "regexPatterns": "Patrones Regex (Opcional)",
+    "result": "Resultado:",
+    "save": "Guardar",
+    "selectOrCreate": "Selecciona una plantilla para editar o crea una nueva",
+    "tabTitle": "Nombrado",
+    "template": "Plantilla",
+    "templateName": "Nombre de Plantilla",
+    "test": "Probar",
+    "testTemplate": "Probar Plantilla",
+    "title": "Plantillas de Nombrado",
+    "userDefault": "Plantilla Predeterminada",
+    "userDefaultHint": "Se aplica cuando ninguna etiqueta tiene una plantilla de nombrado."
+  },
+  "nav": {
+    "account": "Cuenta",
+    "accountSettings": "Configuración de Cuenta",
+    "admin": "Administración",
+    "adminDashboard": "Panel de Administración",
+    "darkMode": "Modo Oscuro",
+    "groupManagement": "Gestión de Grupos",
+    "home": "Inicio",
+    "language": "Idioma",
+    "lightMode": "Modo Claro",
+    "newRecording": "Nueva Grabación",
+    "recording": "Grabación",
+    "settings": "Configuración",
+    "signOut": "Cerrar Sesión",
+    "teamManagement": "Gestión de Grupos",
+    "upload": "Subir",
+    "userProfile": "Perfil de Usuario"
+  },
+  "notes": {
+    "cancelEdit": "Cancelar Edición",
+    "characterCount": "{{count}} carácter",
+    "characterCountPlural": "{{count}} caracteres",
+    "editNotes": "Editar Notas",
+    "lastUpdated": "Última actualización",
+    "placeholder": "Añade tus notas aquí...",
+    "saveNotes": "Guardar Notas",
+    "title": "Notas"
+  },
+  "pwa": {
+    "installApp": "Instalar App",
+    "installed": "Instalado exitosamente",
+    "installing": "Instalando...",
+    "notificationPermissionDenied": "Permiso de notificación denegado",
+    "notificationsEnabled": "Notificaciones habilitadas",
+    "offline": "Estás desconectado",
+    "screenAwake": "La pantalla permanecerá activa durante la grabación",
+    "screenAwakeFailed": "No se pudo mantener la pantalla activa",
+    "updateAvailable": "Actualización disponible"
+  },
+  "recording": {
+    "acceptDisclaimer": "Acepto",
+    "cancelRecording": "Cancelar",
+    "discardRecovery": "Descartar",
+    "disclaimer": "Aviso de Grabación",
+    "duration": "Duración",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "Micrófono",
+    "microphoneAndSystem": "Micrófono + Sistema",
+    "microphonePermissionDenied": "Permiso del micrófono denegado",
+    "modeBoth": "Micrófono + Sistema",
+    "modeMicrophone": "Micrófono",
+    "modeSystem": "Audio del sistema",
+    "notes": "Notas",
+    "notesPlaceholder": "Añade notas sobre esta grabación...",
+    "pauseRecording": "Pausar",
+    "recordingFailed": "La grabación falló",
+    "recordingInProgress": "Grabación en progreso...",
+    "recordingMode": "Modo de grabación",
+    "recordingSize": "Tamaño Estimado",
+    "recordingStopped": "Grabación detenida",
+    "recordingTime": "Tiempo de Grabación",
+    "recoveryDescription": "Encontramos una grabación sin terminar de una sesión anterior. ¿Deseas restaurarla?",
+    "recoveryFound": "Grabación no guardada detectada",
+    "recoveryTitle": "Recuperar grabación",
+    "restoreRecording": "Restaurar",
+    "resumeRecording": "Reanudar",
+    "saveRecording": "Guardar Grabación",
+    "size": "Tamaño",
+    "startRecording": "Iniciar Grabación",
+    "startedAt": "Iniciado el",
+    "stopRecording": "Detener Grabación",
+    "systemAudio": "Audio del Sistema",
+    "systemAudioNotSupported": "La grabación de audio del sistema no es compatible con este navegador",
+    "title": "Grabación de Audio"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "El audio será re-transcrito desde cero. Esto también regenerará el título y resumen basado en la nueva transcripción.",
+    "audioReTranscribedWithAsr": "El audio será re-transcrito usando el endpoint ASR. Esto incluye diarización y regenerará el título y resumen.",
+    "manualEditsOverwritten": "Cualquier edición manual de la transcripción, título o resumen será sobrescrita.",
+    "manualEditsOverwrittenSummary": "Cualquier edición manual del resumen será sobrescrita.",
+    "newTitleAndSummary": "Se generará un nuevo resumen basado en la transcripción existente."
+  },
+  "settings": {
+    "apiKeys": "Claves API",
+    "appearance": "Apariencia",
+    "changePassword": "Cambiar Contraseña",
+    "dataExport": "Exportación de Datos",
+    "deleteAccount": "Eliminar Cuenta",
+    "integrations": "Integraciones",
+    "language": "Idioma",
+    "notifications": "Notificaciones",
+    "preferences": "Preferencias",
+    "privacy": "Privacidad",
+    "profile": "Perfil",
+    "security": "Seguridad",
+    "theme": "Tema",
+    "title": "Configuración",
+    "twoFactorAuth": "Autenticación de Dos Factores"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "Aún no has compartido ninguna transcripción.",
+    "shareNotes": "Compartir Notas",
+    "shareSummary": "Compartir Resumen",
+    "sharedOn": "Compartido el"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "Aún no has compartido ninguna transcripción."
+  },
+  "sharing": {
+    "canEdit": "Puede editar",
+    "canReshare": "Puede recompartir",
+    "internalSharing": "Compartir Interno",
+    "notSharedYet": "Aún no compartido",
+    "publicBadge": "Público",
+    "publicLink": "Enlace Público",
+    "publicLinks": "enlace(s) público(s)",
+    "publicLinksGenerated": "enlace(s) público(s) generado(s)",
+    "searchUsers": "Buscar usuarios...",
+    "sharedBadge": "Compartido",
+    "sharedBy": "Compartido por",
+    "sharedWith": "Compartido con",
+    "teamBadge": "Equipo",
+    "teamRecording": "Grabación del equipo",
+    "unknown": "Desconocido",
+    "users": "usuario(s)"
+  },
+  "sidebar": {
+    "advancedSearch": "Búsqueda Avanzada",
+    "archived": "Archivado",
+    "archivedRecordings": "Grabaciones Archivadas",
+    "dateRange": "Rango de Fechas",
+    "filters": "Filtros",
+    "highlighted": "Destacado",
+    "inbox": "Bandeja de Entrada",
+    "lastMonth": "Mes Pasado",
+    "lastWeek": "Semana Pasada",
+    "loadMore": "Cargar Más",
+    "markAsRead": "Marcar como leído",
+    "moveToInbox": "Mover a bandeja de entrada",
+    "noRecordings": "No se encontraron grabaciones",
+    "older": "Más Antiguo",
+    "removeFromHighlighted": "Quitar de destacados",
+    "searchRecordings": "Buscar grabaciones...",
+    "sharedWithMe": "Compartido Conmigo",
+    "sortBy": "Ordenar Por",
+    "sortByDate": "Fecha de Creación",
+    "sortByMeetingDate": "Fecha de Reunión",
+    "starred": "Starred",
+    "tags": "Etiquetas",
+    "thisMonth": "Este Mes",
+    "thisWeek": "Esta Semana",
+    "today": "Hoy",
+    "totalRecordings": "{{count}} grabación",
+    "totalRecordingsPlural": "{{count}} grabaciones",
+    "upcoming": "Próximo",
+    "yesterday": "Ayer"
+  },
+  "speakers": {
+    "filterBySpeaker": "Filtrar por orador",
+    "noMatchingSpeakers": "No hay oradores coincidentes",
+    "searchSpeakers": "Buscar..."
+  },
+  "speakersManagement": {
+    "added": "Añadido",
+    "confidence": "Confianza",
+    "confidenceHigh": "alta",
+    "confidenceLow": "baja",
+    "confidenceMedium": "media",
+    "created": "Creado",
+    "description": "Gestiona tus hablantes guardados. Se guardan automáticamente cuando usas nombres de hablantes en tus grabaciones.",
+    "failedToLoad": "Error al cargar hablantes",
+    "failedToLoadSnippets": "Error al cargar fragmentos",
+    "keepThisSpeaker": "Mantener este hablante (los demás se fusionarán en él):",
+    "last": "Último",
+    "lastUsed": "Último uso",
+    "loadingSpeakers": "Cargando hablantes...",
+    "match": "coincidencia",
+    "mergeDescription": "Combinar varios perfiles de hablante en uno. Todos los embeddings, fragmentos y datos de uso se fusionarán.",
+    "mergeFailed": "Error al fusionar hablantes",
+    "mergeNSpeakers": "Fusionar {{count}} hablantes",
+    "mergeSpeakers": "Fusionar hablantes",
+    "mergeSuccess": "Hablantes fusionados correctamente",
+    "noSnippetsAvailable": "Sin fragmentos disponibles",
+    "noSpeakersYet": "Aún no hay hablantes guardados",
+    "sample": "muestra",
+    "samples": "muestras",
+    "selectToMerge": "Seleccionar 2+ para fusionar",
+    "speakersToMerge": "Hablantes a fusionar:",
+    "speakersWillAppear": "Los hablantes aparecerán aquí cuando uses nombres de hablantes en tus grabaciones",
+    "targetWillReceive": "El hablante seleccionado recibirá todos los datos de voz y fragmentos de los demás.",
+    "time": "vez",
+    "times": "veces",
+    "totalSpeakers": "hablantes guardados",
+    "used": "Usado",
+    "usedTimes": "Usado",
+    "viewSnippets": "Ver fragmentos",
+    "voiceMatchSuggestions": "Sugerencias de coincidencia de voz",
+    "voiceProfile": "Perfil de voz"
+  },
+  "status": {
+    "completed": "Completado",
+    "failed": "Falló",
+    "processing": "Procesando",
+    "queued": "En cola",
+    "stuck": "Restablecer procesamiento bloqueado",
+    "summarizing": "Resumiendo",
+    "transcribing": "Transcribiendo",
+    "uploading": "Subiendo"
+  },
+  "summary": {
+    "actionItems": "Elementos de Acción",
+    "cancelEdit": "Cancelar Edición",
+    "decisions": "Decisiones",
+    "editSummary": "Editar Resumen",
+    "generateSummary": "Generar Resumen",
+    "keyPoints": "Puntos Clave",
+    "noSummary": "No hay resumen disponible",
+    "participants": "Participantes",
+    "regenerateSummary": "Regenerar Resumen",
+    "saveSummary": "Guardar Resumen",
+    "summaryFailed": "La generación del resumen falló",
+    "summaryInProgress": "Generación de resumen en progreso...",
+    "title": "Resumen"
+  },
+  "tagManagement": {
+    "asrDefaults": "Configuraciones ASR Predeterminadas",
+    "createTag": "Crear Etiqueta",
+    "customPrompt": "Prompt Personalizado",
+    "description": "Organiza tus grabaciones con etiquetas personalizadas. Cada etiqueta puede tener su propio prompt de resumen y configuraciones ASR predeterminadas.",
+    "maxSpeakers": "Máx",
+    "minSpeakers": "Mín",
+    "noTags": "Aún no has creado ninguna etiqueta."
+  },
+  "tags": {
+    "addTag": "Añadir Etiqueta",
+    "clearTagFilter": "Limpiar filtro",
+    "createTag": "Crear Etiqueta",
+    "currentTags": "Etiquetas Actuales",
+    "filterByTag": "Filtrar por etiqueta",
+    "manageAllTags": "Gestionar Todas las Etiquetas",
+    "noAvailableTags": "No hay etiquetas disponibles",
+    "noMatchingTags": "No hay etiquetas coincidentes",
+    "noTags": "Sin etiquetas",
+    "removeTag": "Eliminar Etiqueta",
+    "searchTags": "Buscar...",
+    "tagColor": "Color de Etiqueta",
+    "tagName": "Nombre de Etiqueta",
+    "title": "Etiquetas"
+  },
+  "tagsModal": {
+    "addTags": "Añadir Etiquetas",
+    "currentTags": "Etiquetas Actuales",
+    "done": "Listo",
+    "noTagsAssigned": "No hay etiquetas asignadas a esta grabación",
+    "searchTags": "Buscar etiquetas..."
+  },
+  "time": {
+    "dayAgo": "Hace 1 día",
+    "daysAgo": "Hace {{count}} días",
+    "hourAgo": "Hace 1 hora",
+    "hoursAgo": "Hace {{count}} horas",
+    "justNow": "Justo ahora",
+    "minuteAgo": "Hace 1 minuto",
+    "minutesAgo": "Hace {{count}} minutos",
+    "monthAgo": "Hace 1 mes",
+    "monthsAgo": "Hace {{count}} meses",
+    "weekAgo": "Hace 1 semana",
+    "weeksAgo": "Hace {{count}} semanas",
+    "yearAgo": "Hace 1 año",
+    "yearsAgo": "Hace {{count}} años"
+  },
+  "tooltips": {
+    "changeSpeaker": "Cambiar orador",
+    "clearChat": "Limpiar chat",
+    "copyTranscript": "Copiar transcripción",
+    "deleteTeam": "Eliminar Grupo",
+    "doubleClickToEdit": "Doble clic para editar",
+    "downloadTranscriptWithTemplate": "Descargar transcripción con plantilla",
+    "editTeam": "Editar Grupo",
+    "editText": "Editar texto",
+    "editTitle": "Editar título",
+    "regenerateTitle": "Regenerar título con IA",
+    "assignFolder": "Asignar carpeta",
+    "discardIncognito": "Descartar grabación incógnita",
+    "editTranscript": "Editar transcripción",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "Expandir",
+    "followPlayerDisabled": "Activar desplazamiento automático - la transcripción sigue la reproducción de audio",
+    "followPlayerEnabled": "Desactivar desplazamiento automático - la transcripción permanece en su lugar",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "Otorgar permiso para compartir públicamente",
+    "hideVideo": "Hide video",
+    "highlight": "Resaltar",
+    "makeAdmin": "Hacer Administrador",
+    "manageMembers": "Administrar Miembros",
+    "manageTeamTags": "Administrar Etiquetas de Grupo",
+    "markAsRead": "Marcar como leído",
+    "maximizeChat": "Maximizar chat",
+    "minimize": "Minimizar",
+    "moveToInbox": "Mover a la bandeja de entrada",
+    "mute": "Silenciar",
+    "pause": "Pausa",
+    "play": "Reproducir",
+    "playbackSpeed": "Velocidad de reproducción",
+    "removeAdmin": "Remover Administrador",
+    "removeFromQueue": "Eliminar de la cola",
+    "removeFromTeam": "Eliminar del equipo",
+    "removeHighlight": "Quitar resaltado",
+    "reprocessTranscription": "Reprocesar transcripción",
+    "reprocessWithAsr": "Reprocesar con ASR",
+    "restoreChat": "Restaurar chat",
+    "revokePublicSharing": "Revocar permiso para compartir públicamente",
+    "shareWithUsers": "Compartir con usuarios",
+    "showVideo": "Show video",
+    "switchToDarkMode": "Cambiar a Modo Oscuro",
+    "switchToLightMode": "Cambiar a Modo Claro",
+    "unmute": "Activar sonido"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Plantillas Disponibles",
+    "availableVars": "Variables Disponibles",
+    "cancel": "Cancelar",
+    "chooseTemplate": "Elegir plantilla...",
+    "createDefaults": "Crear Plantillas Predeterminadas",
+    "createNew": "Crear Plantilla",
+    "default": "Predeterminado",
+    "delete": "Eliminar",
+    "description": "Personaliza cómo se formatean las transcripciones para descarga y exportación.",
+    "downloadDefault": "Descargar predeterminado",
+    "downloadWithoutTemplate": "Descargar sin plantilla",
+    "filters": "Filtros: |upper para mayúsculas, |srt para formato de subtítulos",
+    "save": "Guardar",
+    "selectOrCreate": "Selecciona una plantilla para editar o crea una nueva",
+    "selectTemplate": "Seleccionar Plantilla",
+    "setDefault": "Establecer como plantilla predeterminada",
+    "tabTitle": "Transcripción",
+    "template": "Plantilla",
+    "templateName": "Nombre de Plantilla",
+    "title": "Plantillas de Transcripción",
+    "viewGuide": "Ver Guía de Plantillas"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Identificar Hablantes Automáticamente",
+    "bubble": "Burbuja",
+    "cancelEdit": "Cancelar Edición",
+    "copy": "Copiar",
+    "copyToClipboard": "Copiar al Portapapeles",
+    "download": "Descargar",
+    "downloadTranscript": "Descargar Transcripción",
+    "edit": "Editar",
+    "editSpeakers": "Editar Hablantes",
+    "editTranscription": "Editar Transcripción",
+    "highlightSearchResults": "Resaltar resultados de búsqueda",
+    "noTranscription": "No hay transcripción disponible",
+    "regenerateTranscription": "Regenerar Transcripción",
+    "saveTranscription": "Guardar Transcripción",
+    "searchInTranscript": "Buscar en la transcripción...",
+    "simple": "Simple",
+    "speaker": "Hablante {{number}}",
+    "speakerLabels": "Etiquetas de Hablante",
+    "title": "Transcripción",
+    "unknownSpeaker": "Hablante Desconocido"
+  },
+  "upload": {
+    "chunking": "Los archivos grandes se dividirán automáticamente para su procesamiento",
+    "completed": "Completado",
+    "copies": "copias de este archivo",
+    "dropzone": "Arrastra y suelta archivos de audio aquí, o haz clic para explorar",
+    "duplicateDetected": "Este archivo parece ser un duplicado de \"{{existingName}}\" (subido el {{existingDate}})",
+    "duplicateFile": "Archivo duplicado",
+    "failed": "Falló",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "Tamaño máximo de archivo",
+    "queued": "En cola",
+    "selectFiles": "Seleccionar Archivos",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "Resumiendo...",
+    "supportedFormats": "Soporta MP3, WAV, M4A, MP4, MOV, AVI, AMR, y más",
+    "title": "Subir Audio",
+    "transcribing": "Transcribiendo...",
+    "untitled": "Grabación Sin Título",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "Progreso de Carga",
+    "videoRetained": "Video conservado para reproducción",
+    "willAutoSummarize": "Se resumirá automáticamente después de la transcripción"
+  },
+  "uploadProgress": {
+    "title": "Progreso de Carga"
+  },
+  "promptVariables": {
+    "title": "Variables del prompt",
+    "infoTooltip": "Acerca de las variables del prompt",
+    "hintUpload": "La etiqueta o carpeta seleccionada usa marcadores de posición. Complétalos y se sustituirán en el prompt de resumen para esta grabación. Los valores vacíos se sustituyen por una cadena vacía. Hasta 8.000 caracteres por valor, 32.000 en total.",
+    "hintReprocess": "Estos valores se sustituyen en los marcadores de posición del prompt resuelto. Los cambios se guardan en la grabación. Los valores vacíos se sustituyen por una cadena vacía. Hasta 8.000 caracteres por valor, 32.000 en total.",
+    "placeholderPrefix": "Introducir"
+  },
+  "summaryMode": {
+    "applyMode": "Modo de aplicación",
+    "append": "Añadir",
+    "appendHelp": "Usar el prompt por defecto y añadir esto como contexto adicional.",
+    "replace": "Reemplazar",
+    "replaceHelp": "Usar únicamente este texto como instrucciones de resumen."
+  },
+  "customizeSummary": {
+    "title": "Personalizar prompt de resumen",
+    "body": "Añade contexto puntual para este resumen o reemplaza por completo el prompt resuelto.",
+    "additionalContext": "Contexto adicional",
+    "customPrompt": "Prompt personalizado",
+    "appendPlaceholder": "p. ej. El orden del día es: ...",
+    "replacePlaceholder": "Introduce un prompt de resumen completo...",
+    "generateSummary": "Generar resumen"
+  },
+  "asrEditor": {
+    "saved": "Guardado",
+    "ctrlSHint": "Ctrl+S para guardar",
+    "saveWithoutClosing": "Guardar sin cerrar (Ctrl+S)"
+  },
+  "preview": {
+    "placeholderLegend": "Leyenda de marcadores:",
+    "systemReplaced": "reemplazado por el sistema (fecha actual, transcripción, nombres de etiquetas, etc.)",
+    "userSupplied": "proporcionado por el usuario al subir o reprocesar",
+    "userMessageHeading": "Mensaje del usuario:",
+    "liveUpdateNote": "La sección de instrucciones de resumen se actualiza mientras editas tu prompt personalizado arriba. Los marcadores se sustituyen por valores reales al procesar una grabación."
+  },
+  "preferences": {
+    "description": "Preferencias de visualización y comportamiento del editor. Estos ajustes se guardan en tu cuenta y se aplican en todos los dispositivos.",
+    "editorAutosave": "Guardar automáticamente en el editor de transcripción",
+    "editorAutosaveHelp": "Cuando está activado, las ediciones en el editor de transcripción se guardan automáticamente un par de segundos después de dejar de escribir. Por defecto está desactivado, y guardas explícitamente con los botones Guardar o Ctrl+S.",
+    "showTimestampsSimpleView": "Mostrar marcas de tiempo en la vista simple",
+    "showTimestampsSimpleViewHelp": "Muestra una marca de tiempo compacta mm:ss junto a cada etiqueta de hablante en la vista simple. La vista de burbujas no se ve afectada.",
+    "transcriptDisplay": "Visualización de la transcripción",
+    "transcriptEditor": "Editor de transcripción"
+  }
+}
diff --git a/static/locales/fr.json b/static/locales/fr.json
new file mode 100644
index 00000000..7849291f
--- /dev/null
+++ b/static/locales/fr.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "Résumé par IA",
+    "aiSummarizationDesc": "Intégration OpenRouter et Ollama avec invites personnalisées",
+    "asrEnabled": "ASR Activé",
+    "asrEndpoint": "Point de Terminaison ASR",
+    "audioTranscription": "Transcription Audio",
+    "audioTranscriptionDesc": "API Whisper et support ASR personnalisé avec haute précision",
+    "backend": "Backend",
+    "database": "Base de Données",
+    "deployment": "Déploiement",
+    "dockerDescription": "Images Docker officielles",
+    "dockerHub": "Docker Hub",
+    "documentation": "Documentation",
+    "documentationDescription": "Guides de configuration et manuel utilisateur",
+    "endpoint": "Point de Terminaison",
+    "frontend": "Frontend",
+    "githubDescription": "Code source, problèmes et versions",
+    "githubRepository": "Référentiel GitHub",
+    "inquireMode": "Mode Enquête",
+    "inquireModeDesc": "Recherche sémantique dans tous vos enregistrements",
+    "interactiveChat": "Chat Interactif",
+    "interactiveChatDesc": "Discutez avec vos transcriptions en utilisant l'IA",
+    "keyFeatures": "Fonctionnalités Principales",
+    "largeLanguageModel": "Grand Modèle de Langage",
+    "model": "Modèle",
+    "projectDescription": "Transformez vos enregistrements audio en notes organisées et consultables avec des fonctionnalités de transcription, de résumé et de chat interactif pilotées par IA.",
+    "projectLinks": "Liens du Projet",
+    "sharingExport": "Partage et Exportation",
+    "sharingExportDesc": "Partagez des enregistrements et exportez vers divers formats",
+    "speakerDiarization": "Diarisation des Orateurs",
+    "speakerDiarizationDesc": "Identifie et étiquette automatiquement différents orateurs",
+    "speechRecognition": "Reconnaissance Vocale",
+    "systemConfiguration": "Configuration du Système",
+    "tagline": "Transcription Audio et Prise de Notes Pilotées par IA",
+    "technologyStack": "Pile Technologique",
+    "title": "À Propos",
+    "version": "Version",
+    "whisperApi": "API Whisper"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "Intégration OpenRouter et Ollama avec invites personnalisées",
+    "asrEnabled": "ASR Activé",
+    "asrEndpoint": "Point de Terminaison ASR",
+    "audioTranscriptionDesc": "API Whisper et support ASR personnalisé avec haute précision",
+    "backend": "Backend",
+    "database": "Base de Données",
+    "deployment": "Déploiement",
+    "dockerDescription": "Images Docker officielles",
+    "documentationDescription": "Guides de configuration et manuel utilisateur",
+    "endpoint": "Point de Terminaison",
+    "frontend": "Frontend",
+    "githubDescription": "Code source, problèmes et versions",
+    "inquireModeDesc": "Recherche sémantique dans tous vos enregistrements",
+    "interactiveChatDesc": "Chattez avec vos transcriptions en utilisant l'IA",
+    "model": "Modèle",
+    "no": "Non",
+    "sharingExportDesc": "Partagez des enregistrements et exportez vers divers formats",
+    "speakerDiarizationDesc": "Identifier et étiqueter automatiquement les différents intervenants",
+    "whisperApi": "API Whisper",
+    "yes": "Oui"
+  },
+  "account": {
+    "accountActions": "Actions du Compte",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "Changer le Mot de Passe",
+    "chooseLanguageForInterface": "Choisissez la langue pour l'interface de l'application",
+    "companyOrganization": "Entreprise / Organisation",
+    "completedRecordings": "Terminés",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "E-mail",
+    "failedRecordings": "Échoués",
+    "fullName": "Nom Complet",
+    "goToRecordings": "Aller aux Enregistrements",
+    "interfaceLanguage": "Langue de l'Interface",
+    "jobTitle": "Titre du Poste",
+    "languageForSummaries": "Langue pour les titres, résumés et chat. Laisser vide pour le défaut (comportement par défaut de vos modèles choisis).",
+    "languagePreferences": "Préférences Linguistiques",
+    "leaveBlankForAutoDetect": "Laisser vide pour la détection automatique par le service de transcription",
+    "manageSpeakers": "Gérer les Orateurs",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "Informations Personnelles",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "Langue Préférée pour Chatbot et Résumés",
+    "processingRecordings": "En Traitement",
+    "saveAllPreferences": "Sauvegarder Toutes les Préférences",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "Statistiques du Compte",
+    "title": "Informations du Compte",
+    "totalRecordings": "Total d'Enregistrements",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "Langue de Transcription",
+    "userDetails": "Détails de l'Utilisateur",
+    "username": "Nom d'Utilisateur"
+  },
+  "accountTabs": {
+    "about": "À Propos",
+    "apiTokens": "Jetons API",
+    "customPrompts": "Invites Personnalisées",
+    "folderManagement": "Gestion des dossiers",
+    "namingTemplates": "Nommage",
+    "promptOptions": "Options de Prompt",
+    "sharedTranscripts": "Transcriptions Partagées",
+    "speakersManagement": "Gestion des Locuteurs",
+    "tagManagement": "Gestion des Étiquettes",
+    "templates": "Modèles",
+    "transcriptTemplates": "Modèles de Transcription",
+    "preferences": "Préférences"
+  },
+  "admin": {
+    "title": "Administration",
+    "userMenu": "Menu Utilisateur"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "À Propos du Mode Enquête",
+    "actions": "ACTIONS",
+    "addNewUser": "Ajouter un Nouvel Utilisateur",
+    "addUser": "Ajouter un Utilisateur",
+    "additionalContext": "Contexte Supplémentaire",
+    "admin": "ADMIN",
+    "adminDefaultPrompt": "Invite par Défaut de l'Admin",
+    "adminDefaultPromptDesc": "L'invite configurée ci-dessus (affichée sur cette page)",
+    "adminUser": "Utilisateur Administrateur",
+    "allRecordingsProcessed": "Tous les enregistrements sont traités !",
+    "allowed": "Allowed",
+    "available": "Disponible",
+    "blocked": "bloqué",
+    "budgetWarnings": "Alertes de Budget",
+    "characters": "caractères",
+    "chunkSize": "Taille du Morceau",
+    "complete": "terminé",
+    "completedRecordings": "Terminés",
+    "confirmPasswordLabel": "Confirmer le mot de passe",
+    "contextNotes": {
+      "jsonConversion": "Les transcriptions JSON sont converties en format texte brut avant l'envoi",
+      "modelConfig": "Le modèle utilisé est configuré via la variable d'environnement TEXT_MODEL_NAME",
+      "tagPrompts": "Si plusieurs invites d'étiquettes existent, elles sont fusionnées dans l'ordre où les étiquettes ont été ajoutées",
+      "transcriptLimit": "Les transcriptions sont limitées à un nombre configurable de caractères (par défaut : 30 000)"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "Utilisation actuelle",
+    "currentUsageMinutes": "Utilisation Actuelle",
+    "defaultPromptInfo": "Cette invite par défaut sera utilisée pour tous les utilisateurs qui n'ont pas défini leur propre invite personnalisée dans les paramètres de leur compte.",
+    "defaultPrompts": "Invites par Défaut",
+    "defaultSummarizationPrompt": "Invite de Résumé par Défaut",
+    "description": "Description",
+    "editUser": "Modifier l'Utilisateur",
+    "email": "E-MAIL",
+    "emailLabel": "E-mail",
+    "embeddingModel": "Modèle d'Intégration",
+    "embeddingsStatus": "Statut des Intégrations",
+    "errors": {
+      "failedToLoadPrompt": "Échec du chargement de l'invite par défaut",
+      "failedToSavePrompt": "Échec de la sauvegarde de l'invite par défaut. Veuillez réessayer.",
+      "invalidFileSize": "Veuillez entrer une taille valide entre 1 et 10000 Mo",
+      "invalidInteger": "Veuillez entrer un nombre entier valide",
+      "invalidNumber": "Veuillez entrer un nombre valide",
+      "maxTimeout": "Le délai d'attente ne peut pas dépasser 10 heures (36000 secondes)",
+      "minCharacters": "Veuillez entrer un nombre valide d'au moins 1000 caractères",
+      "minTimeout": "Le délai d'attente doit être d'au moins 60 secondes"
+    },
+    "failedRecordings": "Échoués",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "Le mode Enquête permet aux utilisateurs de rechercher dans plusieurs transcriptions en utilisant des questions en langage naturel. Il fonctionne en divisant les transcriptions en morceaux et en créant des intégrations consultables à l'aide de modèles IA.",
+    "languagePreferenceNote": "Note: Si l'utilisateur a défini une préférence de langue de sortie, \" Assurez-vous que votre réponse est en {langue}.\" sera ajouté.",
+    "lastUpdated": "Dernière mise à jour",
+    "maxFileSizeHelp": "Taille maximale du fichier en mégaoctets (1-10000 Mo)",
+    "megabytes": "Mo",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "minutes",
+    "monthlyCost": "Coût Mensuel",
+    "monthlyTokenBudget": "Budget Mensuel de Tokens",
+    "monthlyTranscriptionBudget": "Budget Mensuel de Transcription (minutes)",
+    "needProcessing": "Nécessite un Traitement",
+    "never": "Jamais",
+    "newPasswordLabel": "Nouveau Mot de Passe (laisser vide pour conserver l'actuel)",
+    "no": "Non",
+    "noData": "Aucune donnée",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "Aucune description disponible",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "Aucune Limite",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "Aucune donnée d'utilisation de transcription disponible",
+    "none": "Aucun",
+    "notSet": "Non défini",
+    "overlap": "Chevauchement",
+    "passwordLabel": "Mot de passe",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "En Attente",
+    "percentUsed": "utilisé",
+    "placeholdersNote": "Les espaces réservés sont remplacés par des valeurs réelles lors du traitement d'un enregistrement.",
+    "processAllRecordings": "Traiter Tous les Enregistrements",
+    "processNext10": "Traiter les 10 Prochains",
+    "processedForInquire": "Traité pour Enquête",
+    "processing": "Traitement en cours...",
+    "processingActions": "Actions de Traitement",
+    "processingProgress": "Progression du Traitement",
+    "processingRecordings": "En Traitement",
+    "promptDescription": "Cette invite sera utilisée pour générer des résumés pour tous les enregistrements lorsque les utilisateurs n'ont pas défini leur propre invite.",
+    "promptHierarchy": "Hiérarchie des Invites",
+    "promptPriorityDescription": "Le système utilise l'ordre de priorité suivant lors de la sélection de l'invite à utiliser:",
+    "promptResetMessage": "Invite réinitialisée par défaut du système. Cliquez sur \"Enregistrer les modifications\" pour appliquer.",
+    "promptSavedSuccessfully": "Invite par défaut enregistrée avec succès !",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "Répartition du Statut des Enregistrements",
+    "recordings": "ENREGISTREMENTS",
+    "recordingsNeedProcessing": "Il y a {{count}} enregistrements qui doivent être traités pour le mode Enquête.",
+    "refreshStatus": "Actualiser le Statut",
+    "resetToDefault": "Réinitialiser par Défaut",
+    "saving": "Enregistrement...",
+    "searchUsers": "Rechercher des utilisateurs...",
+    "seconds": "secondes",
+    "settings": {
+      "asrTimeoutDesc": "Temps maximal en secondes pour attendre la fin de la transcription ASR. La valeur par défaut est 1800 secondes (30 minutes).",
+      "defaultSummaryPromptDesc": "Invite de résumé par défaut utilisée lorsque les utilisateurs n'ont pas défini leur propre invite. Cela sert d'invite de base pour tous les utilisateurs.",
+      "maxFileSizeDesc": "Taille maximale de fichier autorisée pour les téléchargements audio en mégaoctets (Mo).",
+      "recordingDisclaimerDesc": "Avis légal affiché aux utilisateurs avant le début de l'enregistrement. Prend en charge le formatage Markdown. Laisser vide pour désactiver.",
+      "uploadDisclaimerDesc": "Avis légal affiché avant le téléchargement de fichiers. Prend en charge Markdown. Laisser vide pour désactiver.",
+      "customBannerDesc": "Bannière personnalisée affichée en haut de la page. Prend en charge Markdown. Laisser vide pour désactiver.",
+      "transcriptLengthLimitDesc": "Nombre maximal de caractères à envoyer de la transcription au LLM pour le résumé et le chat. Utilisez -1 pour aucune limite."
+    },
+    "storageUsed": "STOCKAGE UTILISÉ",
+    "summarizationInstructions": "Instructions de Résumé",
+    "systemFallback": "Repli Système",
+    "systemFallbackDesc": "Une valeur par défaut codée en dur si aucune des précédentes n'est définie",
+    "systemPrompt": "Invite Système",
+    "systemSettings": "Paramètres du Système",
+    "systemStatistics": "Statistiques du Système",
+    "tagCustomPrompt": "Invite Personnalisée de l'Étiquette",
+    "tagCustomPromptDesc": "Si un enregistrement a des étiquettes avec des invites personnalisées",
+    "textSearchOnly": "Recherche de Texte Uniquement",
+    "thisMonth": "Ce Mois",
+    "timeoutRecommendation": "Recommandé : 30-120 minutes pour les longs fichiers audio",
+    "title": "Tableau de Bord Administrateur",
+    "todaysMinutes": "Minutes Aujourd'hui",
+    "tokenBudgetExceeded": "Budget mensuel de tokens dépassé. Veuillez contacter votre administrateur.",
+    "tokenBudgetHelp": "Définissez une limite mensuelle de tokens pour les fonctionnalités IA. Laissez vide pour illimité.",
+    "tokenBudgetPlaceholder": "Laissez vide pour illimité",
+    "tokenUsage": "Utilisation des tokens",
+    "tokens": "tokens",
+    "topUsers": "Meilleurs Utilisateurs",
+    "topUsersByStorage": "Principaux Utilisateurs par Stockage",
+    "total": "Total",
+    "totalChunks": "Total des Segments",
+    "totalQueries": "Total des Requêtes",
+    "totalRecordings": "Total des Enregistrements",
+    "totalStorage": "Stockage Total",
+    "totalUsers": "Total des Utilisateurs",
+    "transcriptionBudgetHelp": "Limitez les minutes de transcription par mois. Laissez vide pour illimité.",
+    "transcriptionBudgetPlaceholder": "Laissez vide pour illimité",
+    "transcriptionUsage": "Utilisation de la Transcription",
+    "updateUser": "Mettre à jour l'Utilisateur",
+    "userCustomPrompt": "Invite Personnalisée de l'Utilisateur",
+    "userCustomPromptDesc": "Si l'utilisateur a défini sa propre invite dans les paramètres du compte",
+    "userManagement": "Gestion des Utilisateurs",
+    "userMessageTemplate": "Modèle de Message Utilisateur",
+    "userTranscriptionUsage": "Utilisation de Transcription par Utilisateur (Ce Mois)",
+    "username": "NOM D'UTILISATEUR",
+    "usernameLabel": "Nom d'utilisateur",
+    "vectorDimensions": "Dimensions du Vecteur",
+    "vectorStore": "Magasin Vectoriel",
+    "vectorStoreManagement": "Gestion du Magasin Vectoriel",
+    "vectorStoreUpToDate": "Le magasin de vecteurs est à jour.",
+    "viewFullPromptStructure": "Voir la Structure Complète de l'Invite LLM",
+    "warning": "avertissement",
+    "yes": "Oui"
+  },
+  "apiTokens": {
+    "activeTokens": "Jetons actifs",
+    "createFirstToken": "Créez votre premier jeton API pour activer l'accès programmatique",
+    "createToken": "Créer un jeton",
+    "created": "Créé",
+    "description": "Créez et gérez des jetons API pour l'accès programmatique à votre compte",
+    "expires": "Expire",
+    "lastUsed": "Dernière utilisation",
+    "neverUsed": "Jamais utilisé",
+    "noExpiration": "Pas d'expiration",
+    "noTokens": "Aucun jeton API",
+    "securityNotice": "Avis de sécurité",
+    "securityWarning": "Traitez les jetons API comme des mots de passe. Ils fournissent un accès complet à votre compte. Ne partagez jamais les jetons dans des zones accessibles au public comme GitHub, le code côté client ou les logs",
+    "title": "Jetons API",
+    "usageExamples": "Exemples d'utilisation"
+  },
+  "buttons": {
+    "addSegment": "Ajouter un Segment",
+    "addSpeaker": "Ajouter un orateur",
+    "cancel": "Cancel",
+    "clearAllFilters": "Effacer tous les filtres",
+    "clearCompleted": "Effacer les téléchargements terminés",
+    "clearSearchText": "Effacer le texte de recherche",
+    "close": "Close",
+    "copy": "Copier",
+    "copyMessage": "Copier le message",
+    "copyNotes": "Copier les Notes",
+    "copySummary": "Copier le Résumé",
+    "copyToClipboard": "Copier dans le Presse-papiers",
+    "createTag": "Create Tag",
+    "deleteAll": "Delete All",
+    "deleteSpeaker": "Supprimer l'intervenant",
+    "deleteTag": "Supprimer l'étiquette",
+    "deleteUser": "Supprimer l'utilisateur",
+    "downloadAsWord": "Télécharger en Word",
+    "downloadAudio": "Télécharger l'audio",
+    "downloadChat": "Télécharger la conversation en document Word",
+    "downloadNotes": "Télécharger les notes en document Word",
+    "downloadSummary": "Télécharger le résumé en document Word",
+    "editNotes": "Modifier les Notes",
+    "editSetting": "Éditer le paramètre",
+    "editSpeakers": "Éditer les orateurs...",
+    "editSummary": "Modifier le Résumé",
+    "editTag": "Éditer l'étiquette",
+    "editTags": "Éditer les étiquettes",
+    "editTranscription": "Modifier la Transcription",
+    "editUser": "Éditer l'utilisateur",
+    "exportCalendar": "Exporter vers le calendrier",
+    "help": "Aide",
+    "identifySpeakers": "Identifier les Orateurs",
+    "next": "Suivant",
+    "previous": "Précédent",
+    "refresh": "Refresh",
+    "reprocessSummary": "Retraiter le résumé",
+    "reprocessTranscription": "Retraiter la transcription",
+    "reprocessWithAsr": "Retraiter avec ASR",
+    "resetStuckProcessing": "Réinitialiser le traitement bloqué",
+    "saveChanges": "Enregistrer les Modifications",
+    "saveCustomPrompt": "Save Custom Prompt",
+    "saveNames": "Enregistrer les noms",
+    "saveSettings": "Enregistrer les Paramètres",
+    "shareRecording": "Partager l'Enregistrement",
+    "toggleTheme": "Changer de thème",
+    "updateTag": "Update Tag"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Confirmer le Nouveau Mot de Passe",
+    "currentPassword": "Mot de Passe Actuel",
+    "newPassword": "Nouveau Mot de Passe",
+    "passwordRequirement": "Le mot de passe doit comporter au moins 8 caractères",
+    "title": "Changer le Mot de Passe"
+  },
+  "chat": {
+    "availableAfterTranscription": "Le chat sera disponible une fois la transcription terminée",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "Discuter avec la Transcription",
+    "clearChat": "Effacer la Discussion",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "Échec de l'envoi du message",
+    "noMessages": "Pas encore de messages",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "Posez une question sur cet enregistrement...",
+    "placeholderWithHint": "Posez une question sur cet enregistrement... (Entrée pour envoyer, Ctrl+Entrée pour nouvelle ligne)",
+    "send": "Envoyer",
+    "suggestedQuestions": "Questions Suggérées",
+    "thinking": "Réflexion...",
+    "title": "Discussion",
+    "whatAreActionItems": "Quelles sont les actions à mener?",
+    "whatAreKeyPoints": "Quels sont les points clés?",
+    "whatWasDiscussed": "Qu'est-ce qui a été discuté?",
+    "whoSaidWhat": "Qui a dit quoi?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Choisissez un enregistrement dans la barre latérale pour voir sa transcription et son résumé",
+    "darkThemes": "Thèmes Sombres",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "Thèmes Clairs",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "Réinitialiser par Défaut",
+    "selectRecording": "Sélectionner un Enregistrement",
+    "subtitle": "Personnalisez votre interface avec de magnifiques thèmes de couleur",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Bleu Océan",
+          "description": "Thème bleu classique avec attrait professionnel"
+        },
+        "emerald": {
+          "name": "Émeraude Forêt",
+          "description": "Thème vert frais pour une sensation naturelle"
+        },
+        "purple": {
+          "name": "Violet Royal",
+          "description": "Thème violet élégant avec sophistication"
+        },
+        "rose": {
+          "name": "Rose Coucher de Soleil",
+          "description": "Thème rose chaud avec énergie douce"
+        },
+        "amber": {
+          "name": "Ambre Doré",
+          "description": "Thème jaune chaud pour la luminosité"
+        },
+        "teal": {
+          "name": "Turquoise Océan",
+          "description": "Thème turquoise frais pour la tranquillité"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Bleu Minuit",
+          "description": "Thème bleu profond pour travail concentré"
+        },
+        "emerald": {
+          "name": "Forêt Sombre",
+          "description": "Thème vert riche pour visualisation confortable"
+        },
+        "purple": {
+          "name": "Violet Profond",
+          "description": "Thème violet mystérieux pour la créativité"
+        },
+        "rose": {
+          "name": "Rose Sombre",
+          "description": "Thème rose atténué avec chaleur subtile"
+        },
+        "amber": {
+          "name": "Ambre Sombre",
+          "description": "Thème marron chaud pour sessions confortables"
+        },
+        "teal": {
+          "name": "Turquoise Profond",
+          "description": "Thème turquoise sombre pour concentration calme"
+        }
+      }
+    },
+    "title": "Choisir le Schéma de Couleurs"
+  },
+  "common": {
+    "back": "Retour",
+    "cancel": "Annuler",
+    "changesSaved": "Modifications enregistrées",
+    "close": "Fermer",
+    "confirm": "Confirmer",
+    "delete": "Supprimer",
+    "deselectAll": "Tout Désélectionner",
+    "download": "Télécharger",
+    "edit": "Modifier",
+    "error": "Erreur",
+    "failed": "Échoué",
+    "filter": "Filtrer",
+    "info": "Information",
+    "loading": "Chargement...",
+    "new": "Nouveau",
+    "next": "Suivant",
+    "no": "Non",
+    "noResults": "Aucun résultat trouvé",
+    "ok": "OK",
+    "or": "Or",
+    "previous": "Précédent",
+    "processing": "Traitement...",
+    "refresh": "Actualiser",
+    "retry": "Réessayer",
+    "save": "Enregistrer",
+    "search": "Rechercher",
+    "selectAll": "Tout Sélectionner",
+    "sort": "Trier",
+    "success": "Succès",
+    "untitled": "Sans titre",
+    "upload": "Télécharger",
+    "warning": "Avertissement",
+    "yes": "Oui"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Invite Par Défaut Actuelle (Utilisée si vous laissez le champ ci-dessus vide)",
+    "promptDescription": "Cette invite sera utilisée pour générer des résumés de vos transcriptions. Elle remplace l'invite par défaut de l'administrateur.",
+    "promptPlaceholder": "Décrivez comment vous voulez que vos résumés soient structurés. Laissez vide pour utiliser l'invite par défaut de l'administrateur.",
+    "summaryGeneration": "Invite de Génération de Résumé",
+    "tip1": "Soyez spécifique sur les sections que vous voulez dans votre résumé",
+    "tip2": "Utilisez des instructions de formatage claires (ex. \"Utilisez des puces\", \"Créez des listes numérotées\")",
+    "tip3": "Spécifiez si vous voulez que certaines informations soient prioritaires",
+    "tip4": "Le système fournira automatiquement le contenu de la transcription à l'IA",
+    "tip5": "Votre préférence de langue de sortie (si définie) sera appliquée automatiquement",
+    "tipsTitle": "Conseils pour Rédiger des Invites Efficaces",
+    "yourCustomPrompt": "Votre Invite Personnalisée de Résumé"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "Êtes-vous sûr de vouloir supprimer tous les intervenants sauvegardés ? Cette action ne peut pas être annulée.",
+    "title": "Supprimer Tous les Intervenants"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Annuler",
+      "confirm": "Supprimer",
+      "message": "Êtes-vous sûr de vouloir supprimer cet enregistrement? Cette action ne peut pas être annulée.",
+      "title": "Supprimer l'Enregistrement"
+    },
+    "deleteShare": {
+      "message": "Êtes-vous sûr de vouloir supprimer ce partage ? Cela révoquera l'accès au lien public.",
+      "title": "Supprimer le partage"
+    },
+    "reprocessTranscription": {
+      "cancel": "Annuler",
+      "confirm": "Retraiter",
+      "message": "Êtes-vous sûr de vouloir retraiter cette transcription? La transcription actuelle sera remplacée.",
+      "title": "Retraiter la Transcription"
+    },
+    "unsavedChanges": {
+      "cancel": "Annuler",
+      "discard": "Ignorer",
+      "message": "Vous avez des modifications non enregistrées. Voulez-vous les enregistrer avant de partir?",
+      "save": "Enregistrer",
+      "title": "Modifications Non Enregistrées"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} heure",
+    "hoursPlural": "{{count}} heures",
+    "minutes": "{{count}} minute",
+    "minutesPlural": "{{count}} minutes",
+    "seconds": "{{count}} seconde",
+    "secondsPlural": "{{count}} secondes"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "Paramètres ASR par Défaut",
+    "asrSettingsDescription": "Ces paramètres seront appliqués par défaut lors de l'utilisation de cette étiquette avec la transcription ASR",
+    "color": "Couleur",
+    "colorDescription": "Choisissez une couleur pour faciliter l'identification",
+    "createTitle": "Créer une Étiquette",
+    "customPrompt": "Invite de Résumé Personnalisée",
+    "customPromptPlaceholder": "Optionnel : Invite personnalisée pour générer des résumés pour les enregistrements avec cette étiquette",
+    "defaultLanguage": "Langue par Défaut",
+    "defaultPromptPlaceholder": "Laissez vide pour utiliser votre invite de résumé par défaut",
+    "exportTemplate": "Modèle d'exportation",
+    "exportTemplateHint": "Sélectionnez un modèle d'exportation à utiliser lors de l'exportation des enregistrements avec cette étiquette",
+    "leaveBlankPrompt": "Laissez vide pour utiliser votre invite de résumé par défaut",
+    "maxSpeakers": "Maximum d'Intervenants",
+    "minSpeakers": "Minimum d'Intervenants",
+    "namingTemplate": "Modèle de nommage",
+    "namingTemplateHint": "Sélectionnez un modèle de nommage pour formater automatiquement les titres des enregistrements avec cette étiquette",
+    "noExportTemplate": "Aucun modèle (utiliser le défaut de l'utilisateur)",
+    "noNamingTemplate": "Pas de modèle (utiliser le défaut ou le titre IA)",
+    "tagName": "Nom de l'Étiquette *",
+    "tagNamePlaceholder": "ex., Réunions, Entretiens",
+    "title": "Modifier l'Étiquette",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "Ce tag est configuré comme dossier surveillé et l'invite contient des variables d'espace réservé. Les enregistrements traités via le répertoire d'auto-traitement n'ont pas d'interface permettant aux utilisateurs de saisir ces valeurs, donc les espaces réservés seront remplacés par des chaînes vides lors du premier résumé. Supprimez les espaces réservés ou renseignez les valeurs via le retraitement après téléversement."
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "音频录制失败。请检查您的麦克风。",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "文件太大",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "发生错误",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "Erreur lors du chargement des partages",
+    "networkError": "网络错误。请检查您的连接。",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "未找到",
+    "permissionDenied": "权限被拒绝",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "存储配额已超出",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "服务器错误。请稍后重试。",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "摘要生成失败。请重试。",
+    "transcriptionFailed": "转录失败。请重试。",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "未授权",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "不支持的文件格式",
+    "uploadFailed": "上传失败。请重试。",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "验证错误",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "Lorsqu'activé, l'IA identifiera les réunions, rendez-vous et échéances mentionnés dans vos enregistrements et créera des événements de calendrier téléchargeables.",
+    "enableLabel": "Activer l'extraction automatique d'événements des transcriptions",
+    "info": "Les événements extraits apparaîtront dans l'onglet 'Événements' sur les enregistrements où des éléments de calendrier sont détectés.",
+    "title": "Extraction d'Événements"
+  },
+  "events": {
+    "add": "Ajouter",
+    "addToCalendar": "Ajouter au Calendrier",
+    "attendees": "Participants",
+    "confirmDelete": "Supprimer l'événement « {title} » ?",
+    "delete": "Supprimer",
+    "deleteFailed": "Échec de la suppression de l'événement",
+    "deleted": "Événement supprimé",
+    "end": "Fin",
+    "location": "Lieu",
+    "noEvents": "Aucun événement détecté dans cet enregistrement",
+    "start": "Début",
+    "title": "Événements"
+  },
+  "exportLabels": {
+    "created": "Créé",
+    "date": "Date",
+    "fileSize": "Taille du fichier",
+    "footer": "Généré avec [Speakr](https://github.com/learnedmachine/speakr)",
+    "metadata": "Métadonnées",
+    "notes": "Notes",
+    "originalFile": "Fichier original",
+    "participants": "Participants",
+    "summarizationTime": "Temps de résumé",
+    "summary": "Résumé",
+    "tags": "Tags",
+    "transcription": "Transcription",
+    "transcriptionTime": "Temps de transcription"
+  },
+  "exportTemplates": {
+    "availableLabels": "Libellés localisés (traduits automatiquement)",
+    "availableTemplates": "Modèles disponibles",
+    "availableVars": "Variables disponibles",
+    "cancel": "Annuler",
+    "conditionals": "Conditions",
+    "conditionalsHint": "Utilisez {{#if variable}}...{{/if}} pour inclure conditionnellement du contenu",
+    "contentSections": "Sections de contenu",
+    "createDefaults": "Créer un modèle par défaut",
+    "createNew": "Créer un modèle",
+    "default": "Par défaut",
+    "delete": "Supprimer",
+    "description": "Personnalisez la façon dont les enregistrements sont exportés vers des fichiers markdown.",
+    "recordingData": "Données d'enregistrement",
+    "save": "Enregistrer",
+    "selectOrCreate": "Sélectionnez un modèle à modifier ou créez-en un nouveau",
+    "setDefault": "Définir comme modèle par défaut",
+    "tabTitle": "Exportation",
+    "template": "Modèle",
+    "templateDescription": "Description",
+    "templateName": "Nom du modèle",
+    "title": "Modèles d'exportation",
+    "viewGuide": "Voir le guide des modèles"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "Tous les dossiers",
+    "asrDefaults": "Paramètres ASR par défaut",
+    "autoShareOnApply": "Partager automatiquement avec les membres du groupe",
+    "autoShareOnApplyHelp": "Partager automatiquement les enregistrements avec tous les membres du groupe lors de l'ajout à ce dossier",
+    "confirmDelete": "Êtes-vous sûr de vouloir supprimer ce dossier ? Les enregistrements seront retirés du dossier mais pas supprimés.",
+    "createFolder": "Créer un dossier",
+    "customPrompt": "Prompt personnalisé",
+    "defaultLanguage": "Langue par défaut",
+    "deleteFolder": "Supprimer le dossier",
+    "description": "Organisez vos enregistrements dans des dossiers. Contrairement aux étiquettes, un enregistrement ne peut appartenir qu'à un seul dossier. Les prompts de dossier sont appliqués avant les prompts utilisateur mais après les prompts d'étiquette.",
+    "editFolder": "Modifier le dossier",
+    "filterByFolder": "Filtrer par dossier",
+    "folderColor": "Couleur du dossier",
+    "folderName": "Nom du dossier",
+    "groupSettings": "Paramètres de groupe",
+    "maxSpeakers": "Orateurs max.",
+    "minSpeakers": "Orateurs min.",
+    "moveToFolder": "Déplacer vers le dossier",
+    "namingTemplate": "Modèle de nommage",
+    "noFolder": "Aucun dossier",
+    "noFolders": "Aucun dossier créé pour le moment",
+    "noFoldersDescription": "Créez votre premier dossier pour organiser vos enregistrements",
+    "protectFromDeletion": "Protéger contre la suppression",
+    "protectFromDeletionHelp": "Protéger les enregistrements de ce dossier contre la suppression automatique",
+    "recordings": "enregistrements",
+    "removeFromFolder": "Retirer du dossier",
+    "retentionDays": "Jours de rétention",
+    "retentionDaysHelp": "Les enregistrements de ce dossier seront supprimés après ce nombre de jours. Laisser vide pour utiliser la rétention globale.",
+    "retentionSettings": "Paramètres de rétention",
+    "selectNamingTemplate": "Sélectionner un modèle de nommage...",
+    "shareWithGroupLead": "Partager avec les administrateurs du groupe",
+    "shareWithGroupLeadHelp": "Partager les enregistrements avec les administrateurs du groupe lors de l'ajout à ce dossier",
+    "title": "Gestion des dossiers"
+  },
+  "form": {
+    "auto": "Auto",
+    "autoDetect": "Détection automatique",
+    "dateFrom": "De",
+    "dateTo": "À",
+    "enterNotesMarkdown": "Entrez des notes au format Markdown...",
+    "enterSummaryMarkdown": "Entrez un résumé au format Markdown...",
+    "folder": "Folder",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "Langue",
+    "maxSpeakers": "Orateurs Maximum",
+    "meetingDate": "Date de Réunion",
+    "minSpeakers": "Orateurs Minimum",
+    "minutes": "Minutes",
+    "notes": "Notes",
+    "notesPlaceholder": "Tapez vos notes au format Markdown...",
+    "optional": "Optionnel",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "Participants",
+    "placeholderAuto": "Auto",
+    "placeholderCharacterLimit": "Entrez la limite de caractères (ex. 30000)",
+    "placeholderMinutes": "Minutes",
+    "placeholderOptional": "Optionnel",
+    "placeholderSeconds": "Secondes",
+    "placeholderSizeMB": "Entrez la taille en Mo",
+    "searchSpeakers": "Rechercher des intervenants...",
+    "searchTags": "Rechercher des étiquettes...",
+    "seconds": "Secondes",
+    "shareNotes": "Partager les Notes",
+    "shareSummary": "Partager le Résumé",
+    "shareableLink": "Lien Partageable",
+    "summaryPromptPlaceholder": "Entrez l'invite de résumé par défaut...",
+    "title": "Titre",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "Votre nom complet",
+    "transcriptionModel": "Modèle de transcription",
+    "useResolvedDefault": "(utiliser la valeur par défaut tag/dossier/global)",
+    "defaultTranscriptionModel": "Modèle de transcription par défaut",
+    "defaultTranscriptionModelHelp": "Remplace le modèle de transcription utilisé pour les enregistrements avec ce tag ou ce dossier."
+  },
+  "groups": {
+    "addMembers": "Ajouter des membres...",
+    "autoShare": "Partage automatique",
+    "autoShareNote": "Note : Si les deux sont activés, tous les membres de l'équipe auront accès. Si seulement \"administrateurs de l'équipe\" est activé, seuls les chefs d'équipe auront accès.",
+    "autoShareTeam": "Partager automatiquement les enregistrements avec tous les membres de l'équipe lorsque cette étiquette est appliquée",
+    "autoSharesWithTeam": "Partage automatiquement avec tous les membres de l'équipe",
+    "confirmDelete": "Êtes-vous sûr de vouloir supprimer cette équipe ? Cette action ne peut pas être annulée.",
+    "createTeam": "Créer une Équipe",
+    "createTeamTag": "Créer une Nouvelle Étiquette d'Équipe",
+    "dayRetention": "jours de rétention",
+    "deleteTeam": "Supprimer l'Équipe",
+    "deletionExempt": "Exempté de suppression",
+    "deletionExemptHelp": "Les enregistrements avec cette étiquette seront exemptés de suppression automatique, même s'ils dépassent la période de rétention.",
+    "editTeam": "Modifier l'Équipe",
+    "editTeamTag": "Modifier l'Étiquette d'Équipe",
+    "globalRetention": "Rétention globale",
+    "members": "Membres",
+    "noMembers": "Aucun membre dans cette équipe",
+    "noTeamTags": "Aucune étiquette d'équipe créée",
+    "noTeams": "Aucune équipe créée",
+    "retentionHelp": "Les enregistrements avec cette étiquette seront supprimés après ce nombre de jours. Laisser vide pour utiliser la rétention globale ({{days}} jours).",
+    "retentionPeriod": "Période de Rétention (jours)",
+    "retentionPlaceholder": "Laisser vide pour utiliser la rétention globale",
+    "searchUsers": "Rechercher des utilisateurs...",
+    "selectTeamLead": "Sélectionner le chef d'équipe...",
+    "shareWithAdmins": "Partager les enregistrements avec les administrateurs de l'équipe lorsque cette étiquette est appliquée",
+    "sharesWithAdminsOnly": "Partage uniquement avec les administrateurs de l'équipe",
+    "syncComplete": "Partages d'équipe synchronisés avec succès",
+    "syncTeamShares": "Synchroniser les Partages d'Équipe",
+    "syncTeamSharesDescription": "Cela partagera rétroactivement tous les enregistrements avec des étiquettes d'équipe avec les membres appropriés selon les paramètres de partage de l'étiquette.",
+    "teamLead": "Chef d'Équipe",
+    "teamName": "Nom de l'Équipe",
+    "teamNamePlaceholder": "Entrez le nom de l'équipe",
+    "teamTags": "Étiquettes d'Équipe",
+    "title": "Gestion de Groupe",
+    "updateTeam": "Mettre à jour l'Équipe"
+  },
+  "help": {
+    "actions": "Actions",
+    "activeFilters": "Filtres actifs",
+    "addSegmentBelow": "Ajouter un segment en dessous",
+    "advancedAsrOptions": "Options ASR Avancées",
+    "allRecordingsLoaded": "Tous les enregistrements chargés",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "{{count}} nom suggéré appliqué",
+    "appliedSuggestedNamesPlural": "{{count}} noms suggérés appliqués",
+    "applySuggested": "Appliquer les suggestions",
+    "applySuggestedMobile": "Suggérer",
+    "approachingLimit": "Approche de la limite de {{limit}}MB",
+    "askAboutTranscription": "Posez des questions sur cette transcription",
+    "audioDeletedDescription": "Le fichier audio de cet enregistrement a été supprimé, mais la transcription reste disponible.",
+    "audioDeletedMessage": "Le fichier audio a été archivé et n'est plus disponible pour la lecture.",
+    "audioDeletedTitle": "Fichier audio supprimé",
+    "audioPlayer": "Lecteur Audio",
+    "autoIdentify": "Identifier Automatiquement",
+    "autoIdentifyMobile": "Auto",
+    "bothAudioDesc": "Enregistre votre voix + les participants à la réunion (recommandé pour les réunions en ligne)",
+    "clearFilters": "effacer les filtres",
+    "clickToAddNotes": "Cliquez pour ajouter des notes...",
+    "colorRepeats": "La couleur se répète à partir de l'orateur {{number}}",
+    "completedFiles": "Fichiers Terminés",
+    "confirmReprocessingTitle": "Confirmer le Retraitement",
+    "copyMessage": "Copier le message",
+    "createFolders": "Create folders",
+    "createPublicLink": "Créer un lien public pour partager cet enregistrement. Le partage n'est disponible que sur les connexions sécurisées (HTTPS).",
+    "createTags": "Créer des étiquettes",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "Supprimer le segment",
+    "discard": "Ignorer",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "Fin",
+    "enterNameFor": "Entrez le nom pour",
+    "enterSpeakerName": "Entrez le nom du locuteur...",
+    "entireScreen": "Écran Entier",
+    "errorChangingSpeaker": "Erreur lors du changement d'orateur",
+    "errorOpeningTextEditor": "Erreur lors de l'ouverture de l'éditeur de texte",
+    "errorSavingText": "Erreur lors de la sauvegarde du texte",
+    "estimatedSize": "Taille estimée",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "Génération du résumé...",
+    "groups": "groupes",
+    "howToRecordSystemAudio": "Comment Enregistrer l'Audio Système",
+    "identifyAllSpeakers": "Identifier tous les orateurs",
+    "identifying": "Identification...",
+    "importantNote": "Note importante",
+    "internalSharingDesc": "Partager avec des utilisateurs spécifiques de votre organisation",
+    "lines": "{{count}} lignes",
+    "loadingMore": "Chargement de plus d'enregistrements...",
+    "loadingRecordings": "Chargement des enregistrements...",
+    "me": "Moi",
+    "microphoneDesc": "Enregistre uniquement votre voix",
+    "modelReasoning": "Raisonnement du Modèle",
+    "moreSpeakersThanColors": "Plus d'orateurs que de couleurs disponibles",
+    "navigate": "Naviguer",
+    "noDateSet": "Aucune date définie",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "Aucun participant",
+    "noRecordingSelected": "Aucun enregistrement sélectionné.",
+    "noSpeakersIdentified": "Aucun orateur n'a pu être identifié à partir du contexte.",
+    "noSuggestionsToApply": "Aucune suggestion à appliquer",
+    "noTagsCreated": "Aucune étiquette créée pour le moment.",
+    "of": "sur",
+    "playFromHere": "Lire à partir d'ici",
+    "pleaseEnterSpeakerName": "Veuillez entrer un nom d'orateur",
+    "processingTime": "Temps de traitement",
+    "processingTimeDescription": "Cela peut prendre quelques minutes. Vous pouvez continuer à utiliser l'application pendant le traitement.",
+    "processingTranscription": "Traitement de la transcription...",
+    "publicLinkDesc": "Toute personne disposant de ce lien peut accéder à l'enregistrement",
+    "recordSystemSteps1": "Cliquez sur \"Enregistrer l'Audio Système\" ou \"Enregistrer les Deux\".",
+    "recordSystemSteps2": "Dans la fenêtre contextuelle, choisissez",
+    "recordSystemSteps3": "Assurez-vous de cocher la case qui dit",
+    "recordingFinished": "Enregistrement terminé",
+    "recordingInProgress": "Enregistrement en cours...",
+    "regenerateSummaryAfterNames": "Régénérer le résumé après la mise à jour des noms",
+    "saved": "Sauvegardé !",
+    "savingProgress": "Sauvegarde en cours...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "Phrase",
+    "shareSystemAudio": "Partager l'audio du système",
+    "shareTabAudio": "Partager l'audio de l'onglet",
+    "sharedOn": "Partagé le",
+    "sharingWindowNoAudio": "Partager une \"Fenêtre\" ne capturera pas l'audio.",
+    "speakerAdded": "Orateur ajouté avec succès",
+    "speakerCount": "Orateur",
+    "speakerName": "Nom de l'orateur",
+    "speakerNamesUpdated": "Noms des orateurs mis à jour avec succès !",
+    "speakers": "Orateurs",
+    "speakersIdentified": "{{count}} orateur identifié avec succès !",
+    "speakersIdentifiedPlural": "{{count}} orateurs identifiés avec succès !",
+    "speakersUpdatedSaveToApply": "Orateurs mis à jour ! Sauvegardez la transcription pour appliquer les modifications.",
+    "specificBrowserTab": "onglet de navigateur spécifique",
+    "startTime": "Début",
+    "startingAutoIdentification": "Identification automatique des orateurs en cours...",
+    "summaryGenerationFailed": "Échec de la génération du résumé",
+    "summaryGenerationTimedOut": "La génération du résumé a expiré",
+    "summaryRegenerationStarted": "Régénération du résumé lancée",
+    "summaryUpdated": "Résumé mis à jour !",
+    "systemAudioDesc": "Enregistre les participants à la réunion et les sons du système",
+    "tagManagement": "Gestion des Étiquettes",
+    "thisActionCannotBeUndone": "Cette action ne peut pas être annulée.",
+    "toCaptureAudioFromMeetings": "Pour capturer l'audio des réunions ou d'autres applications, vous devez partager votre écran ou un onglet du navigateur.",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "Transcription mise à jour avec succès !",
+    "troubleshooting": "Dépannage",
+    "tryAdjustingSearch": "Essayez d'ajuster votre recherche ou",
+    "unsupportedBrowser": "Navigateur Non Pris en Charge",
+    "untitled": "Enregistrement Sans Titre",
+    "uploadRecordingNotes": "Télécharger l'Enregistrement et les Notes",
+    "whatWillHappen": "Que va-t-il se passer?",
+    "whyNotWorking": "Pourquoi ça ne marche pas?",
+    "youHaveXSpeakers": "Vous avez {{count}} locuteurs, mais seulement 16 couleurs uniques sont disponibles. Les couleurs se répéteront après le 16ème locuteur."
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "Filtres Actifs :",
+    "askQuestions": "Posez des Questions sur Vos Transcriptions",
+    "clearAll": "Effacer Tout",
+    "dateRange": "Plage de Dates",
+    "dateRangeActive": "Plage de dates active",
+    "exampleQuestion1": "\"Quels éléments d'action ont été discutés ?\"",
+    "exampleQuestion2": "\"Quand avons-nous décidé de changer le calendrier ?\"",
+    "exampleQuestion3": "\"Quelles préoccupations ont été soulevées concernant le budget ?\"",
+    "exampleQuestion4": "\"Qui était responsable des tâches de marketing ?\"",
+    "exampleQuestions": "Exemples de Questions :",
+    "filters": "Filtres",
+    "filtersActive": "Filtres actifs",
+    "from": "De",
+    "noSpeakerData": "Aucune donnée d'intervenant disponible",
+    "placeholder": "Posez des questions sur vos transcriptions filtrées...",
+    "selectFilters": "Sélectionnez les filtres à gauche pour affiner vos transcriptions, puis posez des questions pour obtenir des informations à partir de vos enregistrements.",
+    "sendHint": "Appuyez sur Entrée pour envoyer • Ctrl+Entrée pour nouvelle ligne",
+    "speakerRequirement": "L'identification des intervenants nécessite des enregistrements avec plusieurs intervenants",
+    "speakers": "Intervenants",
+    "speakersCount": "intervenants",
+    "tags": "Étiquettes",
+    "tagsCount": "étiquettes",
+    "title": "Enquêter",
+    "to": "À"
+  },
+  "languages": {
+    "ar": "Arabe",
+    "de": "Allemand",
+    "en": "Anglais",
+    "es": "Espagnol",
+    "fr": "Français",
+    "hi": "Hindi",
+    "it": "Italien",
+    "ja": "Japonais",
+    "ko": "Coréen",
+    "nl": "Néerlandais",
+    "pt": "Portugais",
+    "pt-BR": "Portugais (Brésil)",
+    "ru": "Russe",
+    "zh": "Chinois",
+    "pl": "Polonais",
+    "uk": "Ukrainien",
+    "vi": "Vietnamien",
+    "th": "Thaï",
+    "tr": "Turc",
+    "id": "Indonésien",
+    "sv": "Suédois",
+    "autoDetect": "Détection automatique",
+    "defaultModelDecides": "Par défaut (le modèle décide)"
+  },
+  "manageSpeakersModal": {
+    "created": "Créé",
+    "description": "Gérez vos intervenants sauvegardés. Ils sont automatiquement sauvegardés lorsque vous utilisez des noms d'intervenants dans vos enregistrements.",
+    "failedToLoad": "Échec du chargement des intervenants",
+    "lastUsed": "Dernière utilisation",
+    "loadingSpeakers": "Chargement des intervenants...",
+    "noSpeakersYet": "Aucun intervenant sauvegardé pour le moment",
+    "speakersSaved": "{{count}} intervenants sauvegardés",
+    "speakersWillAppear": "Les intervenants apparaîtront ici lorsque vous utiliserez des noms d'intervenants dans vos enregistrements",
+    "times": "fois",
+    "title": "Gérer les Intervenants",
+    "used": "Utilisé"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "Copié dans le presse-papiers",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "Téléchargement commencé",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "Notes mises à jour avec succès",
+    "passwordChanged": "Mot de passe changé avec succès",
+    "profileUpdated": "Profil mis à jour avec succès",
+    "recordingDeleted": "Enregistrement supprimé avec succès",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "Enregistrement sauvegardé avec succès",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "Paramètres enregistrés avec succès",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "Résumé généré avec succès",
+    "tagAdded": "Étiquette ajoutée avec succès",
+    "tagRemoved": "Étiquette supprimée avec succès",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "Transcription mise à jour avec succès"
+  },
+  "metadata": {
+    "cancelEdit": "Annuler",
+    "createdAt": "Créé",
+    "duration": "Durée",
+    "editMetadata": "Modifier les Métadonnées",
+    "fileName": "Nom du Fichier",
+    "fileSize": "Taille du Fichier",
+    "language": "Langue",
+    "meetingDate": "Date de Réunion",
+    "processingTime": "Temps de Traitement",
+    "saveMetadata": "Enregistrer",
+    "status": "Statut",
+    "title": "Métadonnées",
+    "updatedAt": "Mis à jour",
+    "wordCount": "Nombre de Mots"
+  },
+  "modal": {
+    "addSpeaker": "Ajouter un Nouveau Locuteur",
+    "colorScheme": "Schéma de Couleurs",
+    "deleteRecording": "Supprimer l'Enregistrement",
+    "editAsrTranscription": "Modifier la Transcription ASR",
+    "editParticipants": "Modifier les Participants",
+    "editRecording": "Modifier l'Enregistrement",
+    "editSpeakers": "Modifier les Locuteurs",
+    "editTags": "Modifier les Étiquettes d'Enregistrement",
+    "editTranscription": "Modifier la Transcription",
+    "identifySpeakers": "Identifier les Orateurs",
+    "recordingNotice": "Avis d'Enregistrement",
+    "reprocessSummary": "Retraiter le Résumé",
+    "reprocessTranscription": "Retraiter la Transcription",
+    "resetStatus": "Réinitialiser le Statut de l'Enregistrement?",
+    "shareRecording": "Partager l'Enregistrement",
+    "sharedTranscripts": "Mes Transcriptions Partagées",
+    "systemAudioHelp": "Aide Audio Système",
+    "uploadFiles": "Télécharger les fichiers",
+    "uploadNotice": "Avis de Téléchargement"
+  },
+  "namingTemplates": {
+    "addPattern": "Ajouter un Motif",
+    "availableTemplates": "Modèles Disponibles",
+    "availableVars": "Variables Disponibles",
+    "cancel": "Annuler",
+    "createDefaults": "Créer des Modèles par Défaut",
+    "createNew": "Créer un Modèle",
+    "customVarsHint": "Définissez des motifs regex pour extraire des variables personnalisées des noms de fichiers.",
+    "delete": "Supprimer",
+    "description": "Définissez comment les titres d'enregistrement sont générés à partir des noms de fichiers et du contenu de transcription.",
+    "descriptionLabel": "Description",
+    "noDefault": "Pas de défaut (titre IA uniquement)",
+    "regexHint": "Extraire des données des noms de fichiers. Utilisez des groupes de capture () pour spécifier la correspondance.",
+    "regexPatterns": "Motifs Regex (Optionnel)",
+    "result": "Résultat:",
+    "save": "Enregistrer",
+    "selectOrCreate": "Sélectionnez un modèle à modifier ou créez-en un nouveau",
+    "tabTitle": "Nommage",
+    "template": "Modèle",
+    "templateName": "Nom du Modèle",
+    "test": "Tester",
+    "testTemplate": "Tester le Modèle",
+    "title": "Modèles de Nommage",
+    "userDefault": "Modèle par Défaut",
+    "userDefaultHint": "Appliqué quand aucune étiquette n'a de modèle de nommage."
+  },
+  "nav": {
+    "account": "Compte",
+    "accountSettings": "Paramètres du Compte",
+    "admin": "Administration",
+    "adminDashboard": "Tableau de Bord Admin",
+    "darkMode": "Mode Sombre",
+    "groupManagement": "Gestion de Groupe",
+    "home": "Accueil",
+    "language": "Langue",
+    "lightMode": "Mode Clair",
+    "newRecording": "Nouvel Enregistrement",
+    "recording": "Enregistrement",
+    "settings": "Paramètres",
+    "signOut": "Déconnexion",
+    "teamManagement": "Gestion de Groupe",
+    "upload": "Télécharger",
+    "userProfile": "Profil Utilisateur"
+  },
+  "notes": {
+    "cancelEdit": "Annuler la Modification",
+    "characterCount": "{{count}} caractère",
+    "characterCountPlural": "{{count}} caractères",
+    "editNotes": "Modifier les Notes",
+    "lastUpdated": "Dernière mise à jour",
+    "placeholder": "Ajoutez vos notes ici...",
+    "saveNotes": "Enregistrer les Notes",
+    "title": "Notes"
+  },
+  "pwa": {
+    "installApp": "Installer l'App",
+    "installed": "Installé avec succès",
+    "installing": "Installation...",
+    "notificationPermissionDenied": "Permission de notification refusée",
+    "notificationsEnabled": "Notifications activées",
+    "offline": "Vous êtes hors ligne",
+    "screenAwake": "L'écran restera actif pendant l'enregistrement",
+    "screenAwakeFailed": "Impossible de garder l'écran actif",
+    "updateAvailable": "Mise à jour disponible"
+  },
+  "recording": {
+    "acceptDisclaimer": "J'accepte",
+    "cancelRecording": "Annuler",
+    "discardRecovery": "Ignorer",
+    "disclaimer": "Avertissement d'Enregistrement",
+    "duration": "Durée",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "Microphone",
+    "microphoneAndSystem": "Microphone + Système",
+    "microphonePermissionDenied": "Permission du microphone refusée",
+    "modeBoth": "Microphone + Système",
+    "modeMicrophone": "Microphone",
+    "modeSystem": "Audio système",
+    "notes": "Notes",
+    "notesPlaceholder": "Ajouter des notes sur cet enregistrement...",
+    "pauseRecording": "Pause",
+    "recordingFailed": "L'enregistrement a échoué",
+    "recordingInProgress": "Enregistrement en cours...",
+    "recordingMode": "Mode d'enregistrement",
+    "recordingSize": "Taille Estimée",
+    "recordingStopped": "Enregistrement arrêté",
+    "recordingTime": "Temps d'Enregistrement",
+    "recoveryDescription": "Nous avons trouvé un enregistrement inachevé d'une session précédente. Souhaitez-vous le restaurer ?",
+    "recoveryFound": "Enregistrement non sauvegardé détecté",
+    "recoveryTitle": "Récupérer l'enregistrement",
+    "restoreRecording": "Restaurer",
+    "resumeRecording": "Reprendre",
+    "saveRecording": "Enregistrer l'Enregistrement",
+    "size": "Taille",
+    "startRecording": "Démarrer l'Enregistrement",
+    "startedAt": "Commencé le",
+    "stopRecording": "Arrêter l'Enregistrement",
+    "systemAudio": "Audio Système",
+    "systemAudioNotSupported": "L'enregistrement audio système n'est pas pris en charge dans ce navigateur",
+    "title": "Enregistrement Audio"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "L'audio sera re-transcrit à partir de zéro. Cela régénérera également le titre et le résumé basés sur la nouvelle transcription.",
+    "audioReTranscribedWithAsr": "L'audio sera re-transcrit en utilisant l'endpoint ASR. Cela inclut la diarisation et régénérera le titre et le résumé.",
+    "manualEditsOverwritten": "Toute modification manuelle de la transcription, du titre ou du résumé sera écrasée.",
+    "manualEditsOverwrittenSummary": "Toute modification manuelle du résumé sera écrasée.",
+    "newTitleAndSummary": "Un nouveau résumé sera généré basé sur la transcription existante."
+  },
+  "settings": {
+    "apiKeys": "Clés API",
+    "appearance": "Apparence",
+    "changePassword": "Changer le Mot de Passe",
+    "dataExport": "Export de Données",
+    "deleteAccount": "Supprimer le Compte",
+    "integrations": "Intégrations",
+    "language": "Langue",
+    "notifications": "Notifications",
+    "preferences": "Préférences",
+    "privacy": "Confidentialité",
+    "profile": "Profil",
+    "security": "Sécurité",
+    "theme": "Thème",
+    "title": "Paramètres",
+    "twoFactorAuth": "Authentification à Deux Facteurs"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "Vous n'avez encore partagé aucune transcription.",
+    "shareNotes": "Partager les Notes",
+    "shareSummary": "Partager le Résumé",
+    "sharedOn": "Partagé le"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "Vous n'avez pas encore partagé de transcriptions."
+  },
+  "sharing": {
+    "canEdit": "Peut modifier",
+    "canReshare": "Peut repartager",
+    "internalSharing": "Partage Interne",
+    "notSharedYet": "Pas encore partagé",
+    "publicBadge": "Public",
+    "publicLink": "Lien Public",
+    "publicLinks": "lien(s) public(s)",
+    "publicLinksGenerated": "lien(s) public(s) généré(s)",
+    "searchUsers": "Rechercher des utilisateurs...",
+    "sharedBadge": "Partagé",
+    "sharedBy": "Partagé par",
+    "sharedWith": "Partagé avec",
+    "teamBadge": "Équipe",
+    "teamRecording": "Enregistrement d'équipe",
+    "unknown": "Inconnu",
+    "users": "utilisateur(s)"
+  },
+  "sidebar": {
+    "advancedSearch": "Recherche Avancée",
+    "archived": "Archivé",
+    "archivedRecordings": "Enregistrements Archivés",
+    "dateRange": "Plage de Dates",
+    "filters": "Filtres",
+    "highlighted": "Mis en Évidence",
+    "inbox": "Boîte de Réception",
+    "lastMonth": "Mois Dernier",
+    "lastWeek": "Semaine Dernière",
+    "loadMore": "Charger Plus",
+    "markAsRead": "Marquer comme lu",
+    "moveToInbox": "Déplacer vers la boîte de réception",
+    "noRecordings": "Aucun enregistrement trouvé",
+    "older": "Plus Ancien",
+    "removeFromHighlighted": "Retirer des favoris",
+    "searchRecordings": "Rechercher des enregistrements...",
+    "sharedWithMe": "Partagé avec Moi",
+    "sortBy": "Trier Par",
+    "sortByDate": "Date de Création",
+    "sortByMeetingDate": "Date de Réunion",
+    "starred": "Starred",
+    "tags": "Étiquettes",
+    "thisMonth": "Ce Mois",
+    "thisWeek": "Cette Semaine",
+    "today": "Aujourd'hui",
+    "totalRecordings": "{{count}} enregistrement",
+    "totalRecordingsPlural": "{{count}} enregistrements",
+    "upcoming": "À venir",
+    "yesterday": "Hier"
+  },
+  "speakers": {
+    "filterBySpeaker": "Filtrer par intervenant",
+    "noMatchingSpeakers": "Aucun intervenant correspondant",
+    "searchSpeakers": "Rechercher..."
+  },
+  "speakersManagement": {
+    "added": "Ajouté",
+    "confidence": "Confiance",
+    "confidenceHigh": "élevée",
+    "confidenceLow": "faible",
+    "confidenceMedium": "moyenne",
+    "created": "Créé",
+    "description": "Gérez vos orateurs sauvegardés. Ils sont automatiquement enregistrés lorsque vous utilisez des noms d'orateurs dans vos enregistrements.",
+    "failedToLoad": "Échec du chargement des orateurs",
+    "failedToLoadSnippets": "Échec du chargement des extraits",
+    "keepThisSpeaker": "Garder cet orateur (les autres seront fusionnés) :",
+    "last": "Dernier",
+    "lastUsed": "Dernière utilisation",
+    "loadingSpeakers": "Chargement des orateurs...",
+    "match": "correspondance",
+    "mergeDescription": "Combiner plusieurs profils d'orateurs en un seul. Tous les embeddings, extraits et données d'utilisation seront fusionnés.",
+    "mergeFailed": "Échec de la fusion des orateurs",
+    "mergeNSpeakers": "Fusionner {{count}} orateurs",
+    "mergeSpeakers": "Fusionner les orateurs",
+    "mergeSuccess": "Orateurs fusionnés avec succès",
+    "noSnippetsAvailable": "Aucun extrait disponible",
+    "noSpeakersYet": "Aucun orateur sauvegardé pour le moment",
+    "sample": "échantillon",
+    "samples": "échantillons",
+    "selectToMerge": "Sélectionner 2+ pour fusionner",
+    "speakersToMerge": "Orateurs à fusionner :",
+    "speakersWillAppear": "Les orateurs apparaîtront ici lorsque vous utiliserez des noms d'orateurs dans vos enregistrements",
+    "targetWillReceive": "L'orateur sélectionné recevra toutes les données vocales et les extraits des autres.",
+    "time": "fois",
+    "times": "fois",
+    "totalSpeakers": "orateurs sauvegardés",
+    "used": "Utilisé",
+    "usedTimes": "Utilisé",
+    "viewSnippets": "Voir les extraits",
+    "voiceMatchSuggestions": "Suggestions de correspondance vocale",
+    "voiceProfile": "Profil vocal"
+  },
+  "status": {
+    "completed": "Terminé",
+    "failed": "Échec",
+    "processing": "Traitement",
+    "queued": "En file d'attente",
+    "stuck": "Réinitialiser le traitement bloqué",
+    "summarizing": "Résumé",
+    "transcribing": "Transcription",
+    "uploading": "Téléchargement"
+  },
+  "summary": {
+    "actionItems": "Actions à Mener",
+    "cancelEdit": "Annuler la Modification",
+    "decisions": "Décisions",
+    "editSummary": "Modifier le Résumé",
+    "generateSummary": "Générer un Résumé",
+    "keyPoints": "Points Clés",
+    "noSummary": "Aucun résumé disponible",
+    "participants": "Participants",
+    "regenerateSummary": "Régénérer le Résumé",
+    "saveSummary": "Enregistrer le Résumé",
+    "summaryFailed": "La génération du résumé a échoué",
+    "summaryInProgress": "Génération du résumé en cours...",
+    "title": "Résumé"
+  },
+  "tagManagement": {
+    "asrDefaults": "Paramètres ASR par Défaut",
+    "createTag": "Créer une Étiquette",
+    "customPrompt": "Invite Personnalisée",
+    "description": "Organisez vos enregistrements avec des étiquettes personnalisées. Chaque étiquette peut avoir sa propre invite de résumé et ses paramètres ASR par défaut.",
+    "maxSpeakers": "Max",
+    "minSpeakers": "Min",
+    "noTags": "Vous n'avez pas encore créé d'étiquettes."
+  },
+  "tags": {
+    "addTag": "Ajouter une Étiquette",
+    "clearTagFilter": "Effacer le filtre",
+    "createTag": "Créer une Étiquette",
+    "currentTags": "Étiquettes Actuelles",
+    "filterByTag": "Filtrer par étiquette",
+    "manageAllTags": "Gérer Toutes les Étiquettes",
+    "noAvailableTags": "Aucune étiquette disponible",
+    "noMatchingTags": "Aucune étiquette correspondante",
+    "noTags": "Aucune étiquette",
+    "removeTag": "Supprimer l'Étiquette",
+    "searchTags": "Rechercher...",
+    "tagColor": "Couleur de l'Étiquette",
+    "tagName": "Nom de l'Étiquette",
+    "title": "Étiquettes"
+  },
+  "tagsModal": {
+    "addTags": "Ajouter des Étiquettes",
+    "currentTags": "Étiquettes Actuelles",
+    "done": "Terminé",
+    "noTagsAssigned": "Aucune étiquette assignée à cet enregistrement",
+    "searchTags": "Rechercher des étiquettes..."
+  },
+  "time": {
+    "dayAgo": "Il y a 1 jour",
+    "daysAgo": "Il y a {{count}} jours",
+    "hourAgo": "Il y a 1 heure",
+    "hoursAgo": "Il y a {{count}} heures",
+    "justNow": "À l'instant",
+    "minuteAgo": "Il y a 1 minute",
+    "minutesAgo": "Il y a {{count}} minutes",
+    "monthAgo": "Il y a 1 mois",
+    "monthsAgo": "Il y a {{count}} mois",
+    "weekAgo": "Il y a 1 semaine",
+    "weeksAgo": "Il y a {{count}} semaines",
+    "yearAgo": "Il y a 1 an",
+    "yearsAgo": "Il y a {{count}} ans"
+  },
+  "tooltips": {
+    "changeSpeaker": "Changer le locuteur",
+    "clearChat": "Effacer le chat",
+    "copyTranscript": "Copier la transcription",
+    "deleteTeam": "Supprimer le Groupe",
+    "doubleClickToEdit": "Double-cliquez pour modifier",
+    "downloadTranscriptWithTemplate": "Télécharger la transcription avec modèle",
+    "editTeam": "Modifier le Groupe",
+    "editText": "Modifier le texte",
+    "editTitle": "Modifier le titre",
+    "regenerateTitle": "Régénérer le titre avec l'IA",
+    "assignFolder": "Attribuer un dossier",
+    "discardIncognito": "Supprimer l'enregistrement incognito",
+    "editTranscript": "Modifier la transcription",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "Développer",
+    "followPlayerDisabled": "Activer le défilement automatique - la transcription suit la lecture audio",
+    "followPlayerEnabled": "Désactiver le défilement automatique - la transcription reste en place",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "Accorder la permission de partage public",
+    "hideVideo": "Hide video",
+    "highlight": "Surligner",
+    "makeAdmin": "Nommer Administrateur",
+    "manageMembers": "Gérer les Membres",
+    "manageTeamTags": "Gérer les Étiquettes de Groupe",
+    "markAsRead": "Marquer comme lu",
+    "maximizeChat": "Maximiser le chat",
+    "minimize": "Réduire",
+    "moveToInbox": "Déplacer vers la boîte de réception",
+    "mute": "Muet",
+    "pause": "Pause",
+    "play": "Lecture",
+    "playbackSpeed": "Vitesse de lecture",
+    "removeAdmin": "Retirer l'Administrateur",
+    "removeFromQueue": "Retirer de la file d'attente",
+    "removeFromTeam": "Retirer de l'équipe",
+    "removeHighlight": "Retirer le surlignage",
+    "reprocessTranscription": "Retraiter la transcription",
+    "reprocessWithAsr": "Retraiter avec ASR",
+    "restoreChat": "Restaurer le chat",
+    "revokePublicSharing": "Révoquer la permission de partage public",
+    "shareWithUsers": "Partager avec des utilisateurs",
+    "showVideo": "Show video",
+    "switchToDarkMode": "Passer en Mode Sombre",
+    "switchToLightMode": "Passer en Mode Clair",
+    "unmute": "Activer le son"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Modèles Disponibles",
+    "availableVars": "Variables Disponibles",
+    "cancel": "Annuler",
+    "chooseTemplate": "Choisir un modèle...",
+    "createDefaults": "Créer des Modèles par Défaut",
+    "createNew": "Créer un Modèle",
+    "default": "Par Défaut",
+    "delete": "Supprimer",
+    "description": "Personnalisez le formatage des transcriptions pour le téléchargement et l'exportation.",
+    "downloadDefault": "Télécharger par défaut",
+    "downloadWithoutTemplate": "Télécharger sans modèle",
+    "filters": "Filtres: |upper pour majuscules, |srt pour format sous-titres",
+    "save": "Enregistrer",
+    "selectOrCreate": "Sélectionnez un modèle à éditer ou créez-en un nouveau",
+    "selectTemplate": "Sélectionner un Modèle",
+    "setDefault": "Définir comme modèle par défaut",
+    "tabTitle": "Transcription",
+    "template": "Modèle",
+    "templateName": "Nom du Modèle",
+    "title": "Modèles de Transcription",
+    "viewGuide": "Voir le Guide des Modèles"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Identifier Automatiquement les Orateurs",
+    "bubble": "Bulle",
+    "cancelEdit": "Annuler la Modification",
+    "copy": "Copier",
+    "copyToClipboard": "Copier dans le Presse-papiers",
+    "download": "Télécharger",
+    "downloadTranscript": "Télécharger la Transcription",
+    "edit": "Éditer",
+    "editSpeakers": "Modifier les Orateurs",
+    "editTranscription": "Modifier la Transcription",
+    "highlightSearchResults": "Surligner les résultats de recherche",
+    "noTranscription": "Aucune transcription disponible",
+    "regenerateTranscription": "Régénérer la Transcription",
+    "saveTranscription": "Enregistrer la Transcription",
+    "searchInTranscript": "Rechercher dans la transcription...",
+    "simple": "Simple",
+    "speaker": "Orateur {{number}}",
+    "speakerLabels": "Étiquettes d'Orateur",
+    "title": "Transcription",
+    "unknownSpeaker": "Orateur Inconnu"
+  },
+  "upload": {
+    "chunking": "Les gros fichiers seront automatiquement divisés pour le traitement",
+    "completed": "Terminé",
+    "copies": "copies de ce fichier",
+    "dropzone": "Glissez et déposez des fichiers audio ici, ou cliquez pour parcourir",
+    "duplicateDetected": "Ce fichier semble être un doublon de \"{{existingName}}\" (importé le {{existingDate}})",
+    "duplicateFile": "Fichier en double",
+    "failed": "Échec",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "Taille maximale du fichier",
+    "queued": "En file d'attente",
+    "selectFiles": "Sélectionner des Fichiers",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "Résumé...",
+    "supportedFormats": "Supports MP3, WAV, M4A, MP4, MOV, AVI, AMR, et plus",
+    "title": "Télécharger Audio",
+    "transcribing": "Transcription...",
+    "untitled": "Enregistrement Sans Titre",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "Progression du Téléchargement",
+    "videoRetained": "Vidéo conservée pour la lecture",
+    "willAutoSummarize": "Résumé automatique après la transcription"
+  },
+  "uploadProgress": {
+    "title": "Progression du Téléchargement"
+  },
+  "promptVariables": {
+    "title": "Variables de l'invite",
+    "infoTooltip": "À propos des variables de l'invite",
+    "hintUpload": "Le tag ou le dossier sélectionné utilise des espaces réservés. Renseignez-les et ils seront substitués dans l'invite de résumé pour cet enregistrement. Les valeurs vides sont remplacées par une chaîne vide. Jusqu'à 8 000 caractères par valeur, 32 000 au total.",
+    "hintReprocess": "Ces valeurs sont substituées aux espaces réservés dans l'invite résolue. Les modifications sont enregistrées sur l'enregistrement. Les valeurs vides sont remplacées par une chaîne vide. Jusqu'à 8 000 caractères par valeur, 32 000 au total.",
+    "placeholderPrefix": "Entrer"
+  },
+  "summaryMode": {
+    "applyMode": "Mode d'application",
+    "append": "Ajouter",
+    "appendHelp": "Utiliser l'invite par défaut et ajouter ceci comme contexte supplémentaire.",
+    "replace": "Remplacer",
+    "replaceHelp": "Utiliser uniquement ce texte comme instructions de résumé."
+  },
+  "customizeSummary": {
+    "title": "Personnaliser l'invite de résumé",
+    "body": "Ajoutez un contexte ponctuel pour ce résumé ou remplacez entièrement l'invite résolue.",
+    "additionalContext": "Contexte supplémentaire",
+    "customPrompt": "Invite personnalisée",
+    "appendPlaceholder": "ex. L'ordre du jour est : ...",
+    "replacePlaceholder": "Saisissez une invite de résumé complète...",
+    "generateSummary": "Générer le résumé"
+  },
+  "asrEditor": {
+    "saved": "Enregistré",
+    "ctrlSHint": "Ctrl+S pour enregistrer",
+    "saveWithoutClosing": "Enregistrer sans fermer (Ctrl+S)"
+  },
+  "preview": {
+    "placeholderLegend": "Légende des espaces réservés :",
+    "systemReplaced": "remplacé par le système (date du jour, transcription, noms des tags, etc.)",
+    "userSupplied": "fourni par l'utilisateur lors du téléversement ou du retraitement",
+    "userMessageHeading": "Message utilisateur :",
+    "liveUpdateNote": "L'emplacement des instructions de résumé se met à jour pendant que vous modifiez votre invite personnalisée ci-dessus. Les espaces réservés sont remplacés par les valeurs réelles lors du traitement d'un enregistrement."
+  },
+  "preferences": {
+    "description": "Préférences d'affichage et de comportement de l'éditeur. Ces paramètres sont enregistrés sur votre compte et s'appliquent à tous les appareils.",
+    "editorAutosave": "Enregistrer automatiquement dans l'éditeur de transcription",
+    "editorAutosaveHelp": "Lorsque cette option est activée, les modifications dans l'éditeur de transcription sont enregistrées automatiquement quelques secondes après l'arrêt de la saisie. Désactivée par défaut, vous enregistrez explicitement via les boutons Enregistrer ou Ctrl+S.",
+    "showTimestampsSimpleView": "Afficher les horodatages dans la vue simple",
+    "showTimestampsSimpleViewHelp": "Affiche un horodatage compact mm:ss à côté de chaque libellé de locuteur dans la vue simple. La vue bulle n'est pas affectée.",
+    "transcriptDisplay": "Affichage de la transcription",
+    "transcriptEditor": "Éditeur de transcription"
+  }
+}
diff --git a/static/locales/pt-BR.json b/static/locales/pt-BR.json
new file mode 100644
index 00000000..18d9a3b5
--- /dev/null
+++ b/static/locales/pt-BR.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "Resumo por IA",
+    "aiSummarizationDesc": "Integração com OpenRouter e Ollama para prompts personalizados",
+    "asrEnabled": "ASR Habilitado",
+    "asrEndpoint": "Endpoint de ASR",
+    "audioTranscription": "Transcrição de Áudio",
+    "audioTranscriptionDesc": "Whisper API and custom ASR support with high accuracy",
+    "backend": "Backend",
+    "database": "Banco de Dados",
+    "deployment": "Implantação",
+    "dockerDescription": "Imagens oficiais do Docker",
+    "dockerHub": "Docker Hub",
+    "documentation": "Documentation",
+    "documentationDescription": "User guide and tutorials",
+    "endpoint": "Endpoint",
+    "frontend": "Frontend",
+    "githubDescription": "Código-fonte, problemas e lançamentos",
+    "githubRepository": "Repositório do GitHub",
+    "inquireMode": "Inquire Mode",
+    "inquireModeDesc": "Semantic search across all your recordings",
+    "interactiveChat": "Interactive Chat",
+    "interactiveChatDesc": "Chat with your transcriptions using AI",
+    "keyFeatures": "Recursos Principais",
+    "largeLanguageModel": "Modelo de Linguagem Grande (LLM)",
+    "model": "Modelo",
+    "projectDescription": "Transforme suas gravações de áudio em anotações organizadas e pesquisáveis com transcrição alimentada por IA, resumo e recursos de chat interativo.",
+    "projectLinks": "Links do Projeto",
+    "sharingExport": "Sharing & Export",
+    "sharingExportDesc": "Share recordings and export to various formats",
+    "speakerDiarization": "Speaker Diarization",
+    "speakerDiarizationDesc": "Identify and label different speakers automatically",
+    "speechRecognition": "Speech Recognition",
+    "systemConfiguration": "System Configuration",
+    "tagline": "AI-Powered Audio Transcription & Note-Taking",
+    "technologyStack": "Technology Stack",
+    "title": "About",
+    "version": "Version",
+    "whisperApi": "Whisper API"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "OpenRouter and Ollama integration with custom prompts",
+    "asrEnabled": "ASR Enabled",
+    "asrEndpoint": "ASR Endpoint",
+    "audioTranscriptionDesc": "API Whisper e suporte de ASR personalizado com alta precisão",
+    "backend": "Backend",
+    "database": "Banco de Dados",
+    "deployment": "Implantação",
+    "dockerDescription": "Imagens oficiais do Docker",
+    "documentationDescription": "Guias de configuração e manual do usuário",
+    "endpoint": "Endpoint",
+    "frontend": "Frontend",
+    "githubDescription": "Source code, issues, and releases",
+    "inquireModeDesc": "Semantic search across all your recordings",
+    "interactiveChatDesc": "Chat with your transcriptions using AI",
+    "model": "Model",
+    "no": "No",
+    "sharingExportDesc": "Share recordings and export to various formats",
+    "speakerDiarizationDesc": "Identify and label different speakers automatically",
+    "whisperApi": "Whisper API",
+    "yes": "Yes"
+  },
+  "account": {
+    "accountActions": "Account Actions",
+    "autoLabel": "Auto-Rotular",
+    "autoSummarizationDisabled": "Auto-resumo desabilitado pelo administrador",
+    "autoSummarize": "Auto-Resumo",
+    "changePassword": "Alterar Senha",
+    "chooseLanguageForInterface": "Escolha o idioma para a interface do aplicativo",
+    "companyOrganization": "Empresa / Organização",
+    "completedRecordings": "Concluído",
+    "defaultHotwords": "Palavras-chave Padrão",
+    "defaultHotwordsPlaceholder": "p.ex., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Instrução Inicial Padrão",
+    "defaultInitialPromptPlaceholder": "p.ex., Esta é uma reunião sobre ferramentas de transcrição de IA. Os palestrantes discutem CTranslate2, PyAnnote e SDRs.",
+    "email": "Email",
+    "failedRecordings": "Falhas",
+    "fullName": "Nome Completo",
+    "goToRecordings": "Ir para Gravações",
+    "interfaceLanguage": "Idioma da Interface",
+    "jobTitle": "Cargo",
+    "languageForSummaries": "Idioma para títulos, resumos e chat. Deixe em branco para o padrão (comportamento padrão dos seus modelos escolhidos).",
+    "languagePreferences": "Preferências de Idioma",
+    "leaveBlankForAutoDetect": "Deixe em branco para detecção automática pelo serviço de transcrição",
+    "manageSpeakers": "Gerenciar Oradores",
+    "personalFolder": "Pasta Pessoal (Não Associada a um Grupo)",
+    "personalInfo": "Informações Pessoais",
+    "personalTag": "Etiqueta Pessoal (Não Associada a um Grupo)",
+    "preferredOutputLanguage": "Idioma Preferido para Chatbot e Resumo",
+    "processingRecordings": "Processando",
+    "saveAllPreferences": "Salvar Todas as Preferências",
+    "ssoLinkAccount": "Vincular conta {{provider}}",
+    "ssoLinked": "Vinculado",
+    "ssoNotLinked": "Não vinculado",
+    "ssoProvider": "Provedor",
+    "ssoSetPasswordFirst": "Para desvincular o SSO, você deve primeiro definir uma senha.",
+    "ssoSubject": "Assunto:",
+    "ssoUnlinkAccount": "Desvincular conta {{provider}}",
+    "ssoUnlinkConfirm": "Tem certeza de que deseja desvincular sua conta SSO? Você precisará usar sua senha para fazer login.",
+    "statistics": "Estatísticas da Conta",
+    "title": "Informações da Conta",
+    "totalRecordings": "Total de Gravações",
+    "transcriptionHints": "Dicas de Transcrição",
+    "transcriptionHintsDesc": "Esses padrões são usados quando nenhuma etiqueta ou pasta substitui as definições. Eles ajudam a melhorar a precisão da transcrição para seu caso de uso específico.",
+    "transcriptionLanguage": "Idioma da Transcrição",
+    "userDetails": "Detalhes do Usuário",
+    "username": "Nome de Usuário"
+  },
+  "accountTabs": {
+    "about": "Sobre",
+    "apiTokens": "Tokens de API",
+    "customPrompts": "Instruções Personalizadas",
+    "folderManagement": "Gerenciamento de Pastas",
+    "namingTemplates": "Nomenclatura",
+    "promptOptions": "Opções de Instrução",
+    "sharedTranscripts": "Transcrições Compartilhadas",
+    "speakersManagement": "Gerenciamento de Oradores",
+    "tagManagement": "Gerenciamento de Etiquetas",
+    "templates": "Modelos",
+    "transcriptTemplates": "Modelos de Transcrição",
+    "preferences": "Preferências"
+  },
+  "admin": {
+    "title": "Admin",
+    "userMenu": "Menu do Usuário"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "Sobre o Modo Consulta",
+    "actions": "AÇÕES",
+    "addNewUser": "Adicionar Novo Usuário",
+    "addUser": "Adicionar Usuário",
+    "additionalContext": "Contexto Adicional",
+    "admin": "ADMIN",
+    "adminDefaultPrompt": "Instrução Padrão do Administrador",
+    "adminDefaultPromptDesc": "A instrução configurada acima (mostrada nesta página)",
+    "adminUser": "Usuário Administrador",
+    "allRecordingsProcessed": "Todas as gravações foram processadas!",
+    "allowed": "Permitido",
+    "available": "Disponível",
+    "blocked": "bloqueado",
+    "budgetWarnings": "Avisos de Orçamento",
+    "characters": "caracteres",
+    "chunkSize": "Tamanho do Fragmento",
+    "complete": "completo",
+    "completedRecordings": "Concluído",
+    "confirmPasswordLabel": "Confirmar Senha",
+    "contextNotes": {
+      "jsonConversion": "Transcrições JSON são convertidas para formato de texto limpo antes de enviar",
+      "modelConfig": "O modelo usado é configurado através da variável de ambiente TEXT_MODEL_NAME",
+      "tagPrompts": "Se existirem múltiplos prompts de etiqueta, elas são mescladas na ordem em que as etiquetas foram adicionadas",
+      "transcriptLimit": "As transcrições são limitadas a uma contagem de caracteres configurável (padrão: 30.000)"
+    },
+    "createFirstGroup": "Crie seu Primeiro Grupo",
+    "created": "Criado",
+    "currentUsage": "Uso atual",
+    "currentUsageMinutes": "Uso Atual",
+    "defaultPromptInfo": "Esta instrução padrão será usada para todos os usuários que não configuraram sua própria instrução personalizada nas configurações da conta.",
+    "defaultPrompts": "Instruções Padrão",
+    "defaultSummarizationPrompt": "Instrução de Resumo Padrão",
+    "description": "Descrição",
+    "editUser": "Editar Usuário",
+    "email": "EMAIL",
+    "emailLabel": "Email",
+    "embeddingModel": "Modelo de Embedding",
+    "embeddingsStatus": "Status das Embeddings",
+    "errors": {
+      "failedToLoadPrompt": "Falha ao carregar instrução padrão",
+      "failedToSavePrompt": "Falha ao salvar instrução padrão. Tente novamente.",
+      "invalidFileSize": "Digite um tamanho válido entre 1 e 10.000 MB",
+      "invalidInteger": "Digite um número inteiro válido",
+      "invalidNumber": "Digite um número válido",
+      "maxTimeout": "O tempo limite não pode exceder 10 horas (36.000 segundos)",
+      "minCharacters": "Digite um número válido de pelo menos 1.000 caracteres",
+      "minTimeout": "O tempo limite deve ser de pelo menos 60 segundos"
+    },
+    "failedRecordings": "Falhas",
+    "groupName": "Nome do Grupo",
+    "groupsTab": "Grupos",
+    "id": "ID",
+    "inquireModeDescription": "O Modo Consulta permite que os usuários pesquisem em múltiplas transcrições usando perguntas em linguagem natural. Funciona dividindo as transcrições em fragmentos e criando incorporações pesquisáveis usando modelos de IA.",
+    "languagePreferenceNote": "Nota: Se o usuário tiver definido uma preferência de idioma de saída, \"Garanta que sua resposta esteja em {language}.\" será adicionada.",
+    "lastUpdated": "Última atualização",
+    "maxFileSizeHelp": "Tamanho máximo do arquivo em megabytes (1-10.000 MB)",
+    "megabytes": "MB",
+    "members": "Membros",
+    "membersCount": "membros",
+    "minutes": "minutos",
+    "monthlyCost": "Custo Mensal",
+    "monthlyTokenBudget": "Orçamento Mensal de Tokens",
+    "monthlyTranscriptionBudget": "Orçamento Mensal de Transcrição (minutos)",
+    "needProcessing": "Precisa Processar",
+    "never": "Nunca",
+    "newPasswordLabel": "Nova Senha (deixe em branco para manter a atual)",
+    "no": "Não",
+    "noData": "Sem dados",
+    "noDescription": "Sem descrição",
+    "noDescriptionAvailable": "Nenhuma descrição disponível",
+    "noGroupsAdmin": "Você não é administrador de nenhum grupo ainda",
+    "noGroupsCreated": "Nenhum grupo criado ainda",
+    "noLimit": "Sem Limite",
+    "noMembersYet": "Sem membros ainda",
+    "noTranscriptionData": "Nenhum dado de uso de transcrição disponível",
+    "none": "Nenhum",
+    "notSet": "Não definido",
+    "overlap": "Sobreposição",
+    "passwordLabel": "Senha",
+    "passwordsDoNotMatch": "As senhas não correspondem",
+    "pendingRecordings": "Pendente",
+    "percentUsed": "usados",
+    "placeholdersNote": "Os espaços reservados são substituídos pelos valores reais ao processar uma gravação.",
+    "processAllRecordings": "Processar Todas as Gravações",
+    "processNext10": "Processar Próximas 10",
+    "processedForInquire": "Processado para Consulta",
+    "processing": "Processando...",
+    "processingActions": "Ações de Processamento",
+    "processingProgress": "Progresso do Processamento",
+    "processingRecordings": "Processando",
+    "promptDescription": "Esta instrução será usada para gerar resumos para todas as gravações quando os usuários não configuraram sua própria instrução.",
+    "promptHierarchy": "Hierarquia de Instruções",
+    "promptPriorityDescription": "O sistema usa a seguinte ordem de prioridade ao selecionar qual instrução usar:",
+    "promptResetMessage": "Instrução redefinida para o padrão do sistema. Clique em \"Salvar Alterações\" para aplicar.",
+    "promptSavedSuccessfully": "Instrução padrão salva com sucesso!",
+    "publicShare": "Compartilhamento Público",
+    "recordingStatusDistribution": "Distribuição de Status da Gravação",
+    "recordings": "GRAVAÇÕES",
+    "recordingsNeedProcessing": "Existem {{count}} gravações que precisam ser processadas para o Modo Consulta.",
+    "refreshStatus": "Atualizar Status",
+    "resetToDefault": "Redefinir para Padrão",
+    "saving": "Salvando...",
+    "searchUsers": "Pesquisar usuários...",
+    "seconds": "segundos",
+    "settings": {
+      "asrTimeoutDesc": "Tempo máximo em segundos para aguardar a conclusão da transcrição de ASR. O padrão é 1.800 segundos (30 minutos).",
+      "defaultSummaryPromptDesc": "Instrução de resumo padrão usada quando os usuários não configuraram sua própria instrução. Serve como a instrução base para todos os usuários.",
+      "maxFileSizeDesc": "Tamanho máximo de arquivo permitido para uploads de áudio em megabytes (MB).",
+      "recordingDisclaimerDesc": "Aviso legal mostrado aos usuários antes do início da gravação. Suporta formatação Markdown. Deixe em branco para desabilitar.",
+      "uploadDisclaimerDesc": "Aviso legal mostrado antes dos uploads de arquivo. Suporta Markdown. Deixe em branco para desabilitar.",
+      "customBannerDesc": "Banner personalizado mostrado no topo da página. Suporta Markdown. Deixe em branco para desabilitar.",
+      "transcriptLengthLimitDesc": "Número máximo de caracteres para enviar da transcrição ao LLM para resumo e chat. Use -1 para nenhum limite."
+    },
+    "storageUsed": "ARMAZENAMENTO USADO",
+    "summarizationInstructions": "Instruções de Resumo",
+    "systemFallback": "Fallback do Sistema",
+    "systemFallbackDesc": "Um padrão codificado se nenhum dos itens acima for definido",
+    "systemPrompt": "Instrução do Sistema",
+    "systemSettings": "Configurações do Sistema",
+    "systemStatistics": "Estatísticas do Sistema",
+    "tagCustomPrompt": "Instrução Personalizada da Etiqueta",
+    "tagCustomPromptDesc": "Se uma gravação tiver etiquetas com instruções personalizadas",
+    "textSearchOnly": "Apenas Busca de Texto",
+    "thisMonth": "Este Mês",
+    "timeoutRecommendation": "Recomendado: 30-120 minutos para arquivos de áudio longos",
+    "title": "Painel de Controle do Admin",
+    "todaysMinutes": "Minutos de Hoje",
+    "tokenBudgetExceeded": "Orçamento mensal de tokens excedido. Entre em contato com seu administrador.",
+    "tokenBudgetHelp": "Defina um limite mensal de tokens para recursos de IA. Deixe em branco para ilimitado.",
+    "tokenBudgetPlaceholder": "Deixe em branco para ilimitado",
+    "tokenUsage": "Uso de tokens",
+    "tokens": "tokens",
+    "topUsers": "Principais Usuários",
+    "topUsersByStorage": "Principais Usuários por Armazenamento",
+    "total": "Total",
+    "totalChunks": "Total de Chunks",
+    "totalQueries": "Total de Consultas",
+    "totalRecordings": "Total de Gravações",
+    "totalStorage": "Armazenamento Total",
+    "totalUsers": "Total de Usuários",
+    "transcriptionBudgetHelp": "Limite de minutos de transcrição por mês. Deixe em branco para ilimitado.",
+    "transcriptionBudgetPlaceholder": "Deixe em branco para ilimitado",
+    "transcriptionUsage": "Uso de Transcrição",
+    "updateUser": "Atualizar Usuário",
+    "userCustomPrompt": "Instrução Personalizada do Usuário",
+    "userCustomPromptDesc": "Se o usuário configurou sua própria instrução nas configurações da conta",
+    "userManagement": "Gerenciamento de Usuários",
+    "userMessageTemplate": "Modelo de Mensagem do Usuário",
+    "userTranscriptionUsage": "Uso de Transcrição do Usuário (Este Mês)",
+    "username": "NOME DE USUÁRIO",
+    "usernameLabel": "Nome de Usuário",
+    "vectorDimensions": "Dimensões do Vetor",
+    "vectorStore": "Armazenamento Vetorial",
+    "vectorStoreManagement": "Gerenciamento do Armazenamento Vetorial",
+    "vectorStoreUpToDate": "O armazenamento vetorial está atualizado.",
+    "viewFullPromptStructure": "Ver Estrutura Completa da Instrução do LLM",
+    "warning": "aviso",
+    "yes": "Sim"
+  },
+  "apiTokens": {
+    "activeTokens": "Tokens Ativos",
+    "createFirstToken": "Crie seu primeiro token de API para habilitar acesso programático",
+    "createToken": "Criar Token",
+    "created": "Criado",
+    "description": "Crie e gerencie tokens de API para acesso programático à sua conta",
+    "expires": "Expira",
+    "lastUsed": "Último uso",
+    "neverUsed": "Nunca usado",
+    "noExpiration": "Sem expiração",
+    "noTokens": "Nenhum Token de API",
+    "securityNotice": "Aviso de Segurança",
+    "securityWarning": "Trate os tokens de API como senhas. Eles fornecem acesso total à sua conta. Nunca compartilhe tokens em áreas acessíveis ao público, como GitHub, código do lado do cliente ou registros",
+    "title": "Tokens de API",
+    "usageExamples": "Exemplos de Uso"
+  },
+  "buttons": {
+    "addSegment": "Adicionar Segmento",
+    "addSpeaker": "Adicionar Orador",
+    "cancel": "Cancelar",
+    "clearAllFilters": "Limpar todos os filtros",
+    "clearCompleted": "Limpar uploads concluídos",
+    "clearSearchText": "Limpar texto de pesquisa",
+    "close": "Fechar",
+    "copy": "Copiar",
+    "copyMessage": "Copiar mensagem",
+    "copyNotes": "Copiar notas",
+    "copySummary": "Copiar resumo",
+    "copyToClipboard": "Copiar para área de transferência",
+    "createTag": "Criar Etiqueta",
+    "deleteAll": "Deletar Tudo",
+    "deleteSpeaker": "Deletar orador",
+    "deleteTag": "Deletar etiqueta",
+    "deleteUser": "Deletar Usuário",
+    "downloadAsWord": "Baixar como Word",
+    "downloadAudio": "Baixar áudio",
+    "downloadChat": "Baixar chat como documento Word",
+    "downloadNotes": "Baixar Notas como Documento Word",
+    "downloadSummary": "Baixar Resumo como Documento Word",
+    "editNotes": "Editar notas",
+    "editSetting": "Editar Configuração",
+    "editSpeakers": "Editar Oradores...",
+    "editSummary": "Editar resumo",
+    "editTag": "Editar etiqueta",
+    "editTags": "Editar Etiquetas",
+    "editTranscription": "Editar transcrição",
+    "editUser": "Editar Usuário",
+    "exportCalendar": "Exportar para Calendário",
+    "help": "Ajuda",
+    "identifySpeakers": "Identificar oradores",
+    "next": "Próximo",
+    "previous": "Anterior",
+    "refresh": "Atualizar",
+    "reprocessSummary": "Reprocessar resumo",
+    "reprocessTranscription": "Reprocessar transcrição",
+    "reprocessWithAsr": "Reprocessar com ASR",
+    "resetStuckProcessing": "Redefinir processamento travado",
+    "saveChanges": "Salvar Alterações",
+    "saveCustomPrompt": "Salvar Instrução Personalizada",
+    "saveNames": "Salvar Nomes",
+    "saveSettings": "Salvar Configurações",
+    "shareRecording": "Compartilhar gravação",
+    "toggleTheme": "Alternar tema",
+    "updateTag": "Atualizar Etiqueta"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Confirmar Nova Senha",
+    "currentPassword": "Senha Atual",
+    "newPassword": "Nova Senha",
+    "passwordRequirement": "A senha deve ter pelo menos 8 caracteres",
+    "title": "Alterar Senha"
+  },
+  "chat": {
+    "availableAfterTranscription": "O chat estará disponível após a conclusão da transcrição",
+    "cannotChatTranscriptionFailed": "Não é possível conversar: transcrição falhou. Reprocesse a transcrição primeiro.",
+    "chatWithTranscription": "Conversar com Transcrição",
+    "clearChat": "Limpar Chat",
+    "cleared": "Chat limpo",
+    "downloadFailed": "Falha ao baixar chat",
+    "downloadSuccess": "Chat baixado com sucesso!",
+    "error": "Falha ao enviar mensagem",
+    "noMessages": "Sem mensagens ainda",
+    "noMessagesToDownload": "Nenhuma mensagem de chat para baixar.",
+    "placeholder": "Faça uma pergunta sobre esta gravação...",
+    "placeholderWithHint": "Faça uma pergunta sobre esta gravação... (Enter para enviar, Ctrl+Enter para nova linha)",
+    "send": "Enviar",
+    "suggestedQuestions": "Perguntas Sugeridas",
+    "thinking": "Pensando...",
+    "title": "Chat",
+    "whatAreActionItems": "Quais são os itens de ação?",
+    "whatAreKeyPoints": "Quais são os pontos-chave?",
+    "whatWasDiscussed": "O que foi discutido?",
+    "whoSaidWhat": "Quem disse o quê?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Escolha uma gravação na barra lateral para visualizar sua transcrição e resumo",
+    "darkThemes": "Temas Escuros",
+    "descriptions": {
+      "blue": "Tema azul clássico com aparência profissional e limpa",
+      "emerald": "Tema verde inspirado na natureza para uma experiência calmante",
+      "purple": "Tema roxo rico com aparência elegante e moderna",
+      "rose": "Tema rosa quente com estética morna e convidativa",
+      "amber": "Tons de âmbar quente para uma sensação aconchegante e produtiva",
+      "teal": "Tema azul-petróleo refrescante com vibe moderno"
+    },
+    "lightThemes": "Temas Claros",
+    "names": {
+      "blue": "Azul Oceano",
+      "emerald": "Verde Floresta",
+      "purple": "Roxo Real",
+      "rose": "Rosa Coral",
+      "amber": "Âmbar Dourado",
+      "teal": "Azul-petróleo Ártico"
+    },
+    "resetToDefault": "Redefinir para Padrão",
+    "selectRecording": "Selecionar uma Gravação",
+    "subtitle": "Personalize sua interface com belos temas de cores",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Azul Oceano",
+          "description": "Tema azul clássico com apelo profissional"
+        },
+        "emerald": {
+          "name": "Esmeralda Floresta",
+          "description": "Tema verde fresco para uma sensação natural"
+        },
+        "purple": {
+          "name": "Roxo Real",
+          "description": "Tema roxo elegante com sofisticação"
+        },
+        "rose": {
+          "name": "Rosa Pôr do Sol",
+          "description": "Tema rosa quente com energia suave"
+        },
+        "amber": {
+          "name": "Âmbar Dourado",
+          "description": "Tema amarelo quente para brilho"
+        },
+        "teal": {
+          "name": "Azul-petróleo Oceano",
+          "description": "Tema azul-petróleo legal para tranquilidade"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Azul Meia-noite",
+          "description": "Tema azul profundo para trabalho focado"
+        },
+        "emerald": {
+          "name": "Floresta Escura",
+          "description": "Tema verde rico para visualização confortável"
+        },
+        "purple": {
+          "name": "Roxo Profundo",
+          "description": "Tema roxo misterioso para criatividade"
+        },
+        "rose": {
+          "name": "Rosa Escuro",
+          "description": "Tema rosa silenciado com calor sutil"
+        },
+        "amber": {
+          "name": "Âmbar Escuro",
+          "description": "Tema marrom quente para sessões aconchegantes"
+        },
+        "teal": {
+          "name": "Azul-petróleo Profundo",
+          "description": "Tema azul-petróleo escuro para foco calmo"
+        }
+      }
+    },
+    "title": "Escolher Esquema de Cores"
+  },
+  "common": {
+    "back": "Voltar",
+    "cancel": "Cancelar",
+    "changesSaved": "Alterações salvas",
+    "close": "Fechar",
+    "confirm": "Confirmar",
+    "delete": "Deletar",
+    "deselectAll": "Desselecionar Tudo",
+    "download": "Baixar",
+    "edit": "Editar",
+    "error": "Erro",
+    "failed": "Falha",
+    "filter": "Filtro",
+    "info": "Info",
+    "loading": "Carregando...",
+    "new": "Novo",
+    "next": "Próximo",
+    "no": "Não",
+    "noResults": "Nenhum resultado encontrado",
+    "ok": "OK",
+    "or": "Ou",
+    "previous": "Anterior",
+    "processing": "Processando...",
+    "refresh": "Atualizar",
+    "retry": "Tentar Novamente",
+    "save": "Salvar",
+    "search": "Pesquisar",
+    "selectAll": "Selecionar Tudo",
+    "sort": "Ordenar",
+    "success": "Sucesso",
+    "untitled": "Sem Título",
+    "upload": "Enviar",
+    "warning": "Aviso",
+    "yes": "Sim"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Instrução Padrão Atual (Usada se você deixar acima em branco)",
+    "promptDescription": "Esta instrução será usada para gerar resumos de suas transcrições. Isso substitui a instrução padrão do administrador.",
+    "promptPlaceholder": "Descreva como você deseja que seus resumos sejam estruturados. Deixe em branco para usar a instrução padrão do administrador.",
+    "summaryGeneration": "Instrução de Geração de Resumo",
+    "tip1": "Seja específico sobre as seções que você deseja em seu resumo",
+    "tip2": "Use instruções de formatação clara (p.ex., \"Use marcadores\", \"Crie listas numeradas\")",
+    "tip3": "Especifique se você deseja que certas informações sejam priorizadas",
+    "tip4": "O sistema fornecerá automaticamente o conteúdo da transcrição à IA",
+    "tip5": "Sua preferência de idioma de saída (se definida) será aplicada automaticamente",
+    "tipsTitle": "Dicas para Escrever Instruções Eficazes",
+    "yourCustomPrompt": "Sua Instrução de Resumo Personalizada"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "Tem certeza de que deseja deletar todos os oradores salvos? Esta ação não pode ser desfeita.",
+    "title": "Deletar Todos os Oradores"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Cancelar",
+      "confirm": "Deletar",
+      "message": "Tem certeza de que deseja deletar esta gravação? Esta ação não pode ser desfeita.",
+      "title": "Deletar Gravação"
+    },
+    "deleteShare": {
+      "message": "Tem certeza de que deseja deletar este compartilhamento? Isso revogará o acesso ao link público.",
+      "title": "Deletar Compartilhamento"
+    },
+    "reprocessTranscription": {
+      "cancel": "Cancelar",
+      "confirm": "Reprocessar",
+      "message": "Tem certeza de que deseja reprocessar esta transcrição? A transcrição atual será substituída.",
+      "title": "Reprocessar Transcrição"
+    },
+    "unsavedChanges": {
+      "cancel": "Cancelar",
+      "discard": "Descartar",
+      "message": "Você tem alterações não salvas. Deseja salvá-las antes de sair?",
+      "save": "Salvar",
+      "title": "Alterações Não Salvas"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} hora",
+    "hoursPlural": "{{count}} horas",
+    "minutes": "{{count}} minuto",
+    "minutesPlural": "{{count}} minutos",
+    "seconds": "{{count}} segundo",
+    "secondsPlural": "{{count}} segundos"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "Configurações Padrão de ASR",
+    "asrSettingsDescription": "Essas configurações serão aplicadas por padrão ao usar esta etiqueta com transcrição de ASR",
+    "color": "Cor",
+    "colorDescription": "Escolha uma cor para identificação fácil",
+    "createTitle": "Criar Etiqueta",
+    "customPrompt": "Instrução de Resumo Personalizado",
+    "customPromptPlaceholder": "Opcional: Instrução personalizada para gerar resumos para gravações com esta etiqueta",
+    "defaultLanguage": "Idioma Padrão",
+    "defaultPromptPlaceholder": "Deixe em branco para usar sua instrução de resumo padrão",
+    "exportTemplate": "Modelo de Exportação",
+    "exportTemplateHint": "Selecione um modelo de exportação para usar ao exportar gravações com esta etiqueta",
+    "leaveBlankPrompt": "Deixe em branco para usar sua instrução de resumo padrão",
+    "maxSpeakers": "Máximo de Oradores",
+    "minSpeakers": "Mínimo de Oradores",
+    "namingTemplate": "Modelo de Nomenclatura",
+    "namingTemplateHint": "Selecione um modelo de nomenclatura para formatar automaticamente títulos de gravações com esta etiqueta",
+    "noExportTemplate": "Sem modelo (usar padrão do usuário)",
+    "noNamingTemplate": "Sem modelo (usar padrão do usuário ou título de IA)",
+    "tagName": "Nome da Etiqueta *",
+    "tagNamePlaceholder": "p.ex., Reuniões, Entrevistas",
+    "title": "Editar Etiqueta",
+    "watchFolder": "Pasta de Monitoramento",
+    "watchFolderPath": "Soltar arquivos em:",
+    "watchFolderGroupTagError": "Pastas de monitoramento não estão disponíveis para etiquetas de grupo",
+    "watchFolderCreated": "Pasta de monitoramento criada",
+    "watchFolderRemoved": "Pasta de monitoramento removida",
+    "watchFolderError": "Não foi possível criar pasta de monitoramento",
+    "watchFolderVariableWarning": "Esta tag está configurada como pasta monitorada e o prompt contém variáveis de espaço reservado. As gravações processadas via diretório de auto-processamento não possuem interface para os usuários preencherem esses valores, portanto os espaços reservados serão substituídos por strings vazias na primeira execução do resumo. Remova os espaços reservados ou preencha os valores via reprocessamento após o envio."
+  },
+  "errors": {
+    "audioExtractionFailed": "Falha na Extração de Áudio",
+    "audioExtractionFailedGuidance": "Tente converter o arquivo para um formato de áudio padrão (MP3, WAV) antes de enviar.",
+    "audioExtractionFailedMessage": "Não foi possível extrair áudio do arquivo enviado.",
+    "audioRecordingFailed": "Falha na gravação de áudio. Verifique seu microfone.",
+    "authenticationError": "Erro de Autenticação",
+    "authenticationErrorGuidance": "Verifique se a chave de API está correta e não expirou.",
+    "authenticationErrorMessage": "O serviço de transcrição rejeitou as credenciais de API.",
+    "checkApiKeyGuidance": "Verifique a chave de API nas configurações",
+    "checkNetworkGuidance": "Verifique a conexão de rede",
+    "connectionError": "Erro de Conexão",
+    "connectionErrorGuidance": "Verifique sua conexão com a Internet e certifique-se de que o serviço está disponível.",
+    "connectionErrorMessage": "Não foi possível conectar ao serviço de transcrição.",
+    "convertFormatGuidance": "Converta para MP3 ou WAV antes de enviar",
+    "convertStandardGuidance": "Converter para formato de áudio padrão",
+    "enableChunkingGuidance": "Habilite o fragmentação nas configurações ou comprima o arquivo",
+    "fallbackMessage": "Ocorreu um erro",
+    "fallbackTitle": "Erro",
+    "fileTooLarge": "Arquivo Muito Grande",
+    "fileTooLargeGuidance": "Tente ativar a fragmentação de áudio nas configurações ou compacte o arquivo de áudio antes de enviar.",
+    "fileTooLargeMaxSize": "Arquivo muito grande. Máx: {{size}} MB.",
+    "fileTooLargeMessage": "O arquivo de áudio excede o tamanho máximo permitido pelo serviço de transcrição.",
+    "fileTooLargeTitle": "Arquivo Muito Grande",
+    "generic": "Ocorreu um erro",
+    "invalidAudioFormat": "Formato de Áudio Inválido",
+    "invalidAudioFormatGuidance": "Tente converter o áudio para o formato MP3 ou WAV antes de enviar.",
+    "invalidAudioFormatMessage": "O formato do arquivo de áudio não é suportado ou o arquivo pode estar corrompido.",
+    "loadingShares": "Erro ao carregar compartilhamentos",
+    "networkError": "Erro de rede. Verifique sua conexão.",
+    "networkErrorDuringUpload": "Erro de rede durante o envio",
+    "notFound": "Não encontrado",
+    "permissionDenied": "Permissão Negada",
+    "processingError": "Erro de Processamento",
+    "processingErrorFallbackGuidance": "Tente reprocessar a gravação",
+    "processingErrorGuidance": "Se esse erro persistir, tente reprocessar a gravação.",
+    "processingErrorMessage": "Ocorreu um erro durante o processamento.",
+    "processingFailedOnServer": "Falha no processamento no servidor.",
+    "processingFailedWithStatus": "Falha no processamento com status {{status}}",
+    "processingTimeout": "Tempo Limite de Processamento Excedido",
+    "processingTimeoutGuidance": "Isso pode acontecer com gravações muito longas. Tente dividir o áudio em partes menores.",
+    "processingTimeoutMessage": "A transcrição demorou muito para ser concluída.",
+    "quotaExceeded": "Cota de armazenamento excedida",
+    "rateLimitExceeded": "Limite de Taxa Excedido",
+    "rateLimitExceededGuidance": "Aguarde alguns minutos e tente reprocessar.",
+    "rateLimitExceededMessage": "Muitas solicitações foram enviadas ao serviço de transcrição.",
+    "serverError": "Erro do servidor ({{status}}): Resposta não era JSON",
+    "serverErrorStatus": "Erro do servidor ({{status}})",
+    "serviceUnavailable": "Serviço Indisponível",
+    "serviceUnavailableGuidance": "Isso geralmente é temporário. Tente novamente em alguns minutos.",
+    "serviceUnavailableMessage": "O serviço de transcrição está temporariamente indisponível.",
+    "splitAudioGuidance": "Tente dividir o áudio em partes menores",
+    "summaryFailed": "Falha na geração de resumo. Tente novamente.",
+    "transcriptionFailed": "Falha na transcrição. Tente novamente.",
+    "tryAgainLaterGuidance": "Tente novamente em alguns minutos",
+    "unauthorized": "Não Autorizado",
+    "unexpectedResponse": "Resposta de sucesso inesperada do servidor após o envio.",
+    "unsupportedFormat": "Formato Não Suportado",
+    "uploadFailed": "Falha no envio. Tente novamente.",
+    "uploadFailedWithStatus": "Falha no envio com status {{status}}",
+    "uploadTimedOut": "Tempo limite de envio excedido",
+    "validationError": "Erro de Validação",
+    "waitAndRetryGuidance": "Aguarde alguns minutos e tente novamente"
+  },
+  "eventExtraction": {
+    "description": "Quando ativado, a IA identificará reuniões, compromissos e prazos mencionados em suas gravações e criará eventos de calendário para inserir na agenda.",
+    "enableLabel": "Habilitar extração automática de eventos de transcrições",
+    "info": "Os eventos extraídos aparecerão em uma aba 'Eventos' em gravações onde itens de calendário são detectados.",
+    "title": "Extração de Eventos"
+  },
+  "events": {
+    "add": "Adicionar",
+    "addToCalendar": "Adicionar ao Calendário",
+    "attendees": "Participantes",
+    "confirmDelete": "Deletar evento \"{title}\"?",
+    "delete": "Deletar",
+    "deleteFailed": "Falha ao deletar evento",
+    "deleted": "Evento deletado",
+    "end": "Término",
+    "location": "Localização",
+    "noEvents": "Nenhum evento detectado nesta gravação",
+    "start": "Início",
+    "title": "Eventos"
+  },
+  "exportLabels": {
+    "created": "Criado",
+    "date": "Data",
+    "fileSize": "Tamanho do Arquivo",
+    "footer": "Gerado com [Speakr](https://github.com/murtaza-nasir/speakr)",
+    "metadata": "Metadados",
+    "notes": "Notas",
+    "originalFile": "Arquivo Original",
+    "participants": "Participantes",
+    "summarizationTime": "Tempo de Resumo",
+    "summary": "Resumo",
+    "tags": "Etiquetas",
+    "transcription": "Transcrição",
+    "transcriptionTime": "Tempo de Transcrição"
+  },
+  "exportTemplates": {
+    "availableLabels": "Rótulos Localizados (traduzidos automaticamente)",
+    "availableTemplates": "Modelos Disponíveis",
+    "availableVars": "Variáveis Disponíveis",
+    "cancel": "Cancelar",
+    "conditionals": "Condicionais",
+    "conditionalsHint": "Use {{#if variable}}...{{/if}} para incluir condicionalmente o conteúdo",
+    "contentSections": "Seções de Conteúdo",
+    "createDefaults": "Criar Modelo Padrão",
+    "createNew": "Criar Modelo",
+    "default": "Padrão",
+    "delete": "Deletar",
+    "description": "Personalize como as gravações são exportadas para arquivos markdown.",
+    "recordingData": "Dados de Gravação",
+    "save": "Salvar",
+    "selectOrCreate": "Selecione um modelo para editar ou crie um novo",
+    "setDefault": "Definir como modelo padrão",
+    "tabTitle": "Exportação",
+    "template": "Modelo",
+    "templateDescription": "Descrição",
+    "templateName": "Nome do Modelo",
+    "title": "Modelos de Exportação",
+    "viewGuide": "Ver Guia de Modelo"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "Todas as Pastas",
+    "asrDefaults": "Padrões de ASR",
+    "autoShareOnApply": "Compartilhar automaticamente com membros do grupo",
+    "autoShareOnApplyHelp": "Compartilhe automaticamente gravações com todos os membros do grupo quando adicionadas a esta pasta",
+    "confirmDelete": "Tem certeza de que deseja deletar esta pasta? As gravações serão removidas desta pasta, mas não serão deletadas.",
+    "createFolder": "Criar Pasta",
+    "customPrompt": "Instrução Personalizada",
+    "defaultLanguage": "Idioma Padrão",
+    "deleteFolder": "Deletar Pasta",
+    "description": "Organize suas gravações em pastas. Diferentemente das etiquetas, uma gravação pode pertencer a apenas uma pasta. As instruções da pasta são aplicadas antes das instruções do usuário, mas depois das instruções da etiqueta.",
+    "editFolder": "Editar Pasta",
+    "filterByFolder": "Filtrar por Pasta",
+    "folderColor": "Cor da Pasta",
+    "folderName": "Nome da Pasta",
+    "groupSettings": "Configurações do Grupo",
+    "maxSpeakers": "Máximo de Oradores",
+    "minSpeakers": "Mínimo de Oradores",
+    "moveToFolder": "Mover para Pasta",
+    "namingTemplate": "Modelo de Nomenclatura",
+    "noFolder": "Sem Pasta",
+    "noFolders": "Nenhuma pasta criada ainda",
+    "noFoldersDescription": "Crie sua primeira pasta para organizar suas gravações",
+    "protectFromDeletion": "Proteger de Deleção",
+    "protectFromDeletionHelp": "Proteja gravações nesta pasta de auto-deleção",
+    "recordings": "gravações",
+    "removeFromFolder": "Remover da pasta",
+    "retentionDays": "Dias de Retenção",
+    "retentionDaysHelp": "As gravações nesta pasta serão deletadas após este número de dias. Deixe em branco para usar a retenção global.",
+    "retentionSettings": "Configurações de Retenção",
+    "selectNamingTemplate": "Selecione modelo de nomenclatura...",
+    "shareWithGroupLead": "Compartilhar com administradores do grupo",
+    "shareWithGroupLeadHelp": "Compartilhe gravações com administradores do grupo quando adicionadas a esta pasta",
+    "title": "Gerenciamento de Pastas"
+  },
+  "form": {
+    "auto": "Automático",
+    "autoDetect": "Detecção Automática",
+    "dateFrom": "De",
+    "dateTo": "Para",
+    "enterNotesMarkdown": "Digite notas em formato Markdown...",
+    "enterSummaryMarkdown": "Digite resumo em formato Markdown...",
+    "folder": "Pasta",
+    "hotwords": "Palavras-chave",
+    "hotwordsHelp": "Palavras separadas por vírgula para melhorar o reconhecimento de termos específicos do domínio",
+    "hotwordsPlaceholder": "p.ex., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Instrução Inicial",
+    "initialPromptHelp": "Contexto para orientar o estilo e o vocábulário do modelo de transcrição",
+    "initialPromptPlaceholder": "p.ex., Esta é uma reunião sobre ferramentas de transcrição de IA.",
+    "language": "Idioma",
+    "maxSpeakers": "Máximo de Oradores",
+    "meetingDate": "Data da Reunião",
+    "minSpeakers": "Mínimo de Oradores",
+    "minutes": "Minutos",
+    "notes": "Notas",
+    "notesPlaceholder": "Digite suas notas em formato Markdown...",
+    "optional": "Opcional",
+    "participantNamePlaceholder": "Nome do participante...",
+    "participants": "Participantes",
+    "placeholderAuto": "Automático",
+    "placeholderCharacterLimit": "Digite limite de caracteres (p.ex., 30000)",
+    "placeholderMinutes": "Minutos",
+    "placeholderOptional": "Opcional",
+    "placeholderSeconds": "Segundos",
+    "placeholderSizeMB": "Digite tamanho em MB",
+    "searchSpeakers": "Pesquisar oradores...",
+    "searchTags": "Pesquisar etiquetas...",
+    "seconds": "Segundos",
+    "shareNotes": "Compartilhar Notas",
+    "shareSummary": "Compartilhar Resumo",
+    "shareableLink": "Link Compartílhável",
+    "summaryPromptPlaceholder": "Digite a instrução de resumo padrão...",
+    "title": "Título",
+    "transcriptionLanguage": "Idioma da Transcrição",
+    "yourFullName": "Seu nome completo",
+    "defaultTranscriptionModel": "Modelo de transcrição padrão",
+    "defaultTranscriptionModelHelp": "Sobrescreve o modelo de transcrição usado para gravações com esta tag ou pasta.",
+    "transcriptionModel": "Modelo de transcrição",
+    "useResolvedDefault": "(usar padrão de tag/pasta/global)"
+  },
+  "groups": {
+    "addMembers": "Adicionar membros...",
+    "autoShare": "Compartilhamento Automático",
+    "autoShareNote": "Nota: Se ambos estiverem ativados, todos os membros da equipe terão acesso. Se apenas \"administradores da equipe\" estiver ativado, apenas os líderes do grupo terão acesso.",
+    "autoShareTeam": "Compartilhar automaticamente gravações com todos os membros da equipe quando esta etiqueta é aplicada",
+    "autoSharesWithTeam": "Compartilhamento automático com todos os membros da equipe",
+    "confirmDelete": "Tem certeza de que deseja deletar este grupo? Esta ação não pode ser desfeita.",
+    "createTeam": "Criar Grupo",
+    "createTeamTag": "Criar Nova Etiqueta de Grupo",
+    "dayRetention": "retenção de dia",
+    "deleteTeam": "Deletar Grupo",
+    "deletionExempt": "Isento de deleção",
+    "deletionExemptHelp": "Gravações com esta etiqueta serão isentas de deleção automática, mesmo que excedam o período de retenção.",
+    "editTeam": "Editar Grupo",
+    "editTeamTag": "Editar Etiqueta de Grupo",
+    "globalRetention": "Retenção global",
+    "members": "Membros",
+    "noMembers": "Sem membros neste grupo",
+    "noTeamTags": "Nenhuma etiqueta de grupo criada ainda",
+    "noTeams": "Nenhum grupo criado ainda",
+    "retentionHelp": "Gravações com esta etiqueta serão deletadas após este número de dias. Deixe em branco para usar a retenção global ({{days}} dias).",
+    "retentionPeriod": "Período de Retenção (dias)",
+    "retentionPlaceholder": "Deixe em branco para usar a retenção global",
+    "searchUsers": "Pesquisar usuários...",
+    "selectTeamLead": "Selecione líder do grupo...",
+    "shareWithAdmins": "Compartilhe gravações com administradores da equipe quando esta etiqueta é aplicada",
+    "sharesWithAdminsOnly": "Compartilhamento apenas com administradores da equipe",
+    "syncComplete": "Compartilhamentos do grupo sincronizados com sucesso",
+    "syncTeamShares": "Sincronizar Compartilhamentos do Grupo",
+    "syncTeamSharesDescription": "Isso compartilhará retroativamente todas as gravações que tênham etiquetas de grupo com os membros apropriados do grupo com base nas configurações de compartilhamento da etiqueta.",
+    "teamLead": "Líder do Grupo",
+    "teamName": "Nome do Grupo",
+    "teamNamePlaceholder": "Digite nome do grupo",
+    "teamTags": "Etiquetas do Grupo",
+    "title": "Gerenciamento de Grupos",
+    "updateTeam": "Atualizar Grupo"
+  },
+  "help": {
+    "actions": "Ações",
+    "activeFilters": "Filtros ativos",
+    "addSegmentBelow": "Adicionar segmento abaixo",
+    "advancedAsrOptions": "Opções Avançadas de ASR",
+    "allRecordingsLoaded": "Todas as gravações carregadas",
+    "allTagsSelected": "Todas as etiquetas selecionadas",
+    "appliedSuggestedNames": "Aplicado {{count}} nome sugerido",
+    "appliedSuggestedNamesPlural": "Aplicados {{count}} nomes sugeridos",
+    "applySuggested": "Aplicar Sugerido",
+    "applySuggestedMobile": "Sugerir",
+    "approachingLimit": "Aproximando limite de {{limit}}MB",
+    "askAboutTranscription": "Faça perguntas sobre esta transcrição",
+    "audioDeletedDescription": "O arquivo de áudio para esta gravação foi deletado, mas a transcrição permanece disponível.",
+    "audioDeletedMessage": "O arquivo de áudio foi arquivado e não está mais disponível para reprodução.",
+    "audioDeletedTitle": "Arquivo de áudio deletado",
+    "audioPlayer": "Reprodutor de Áudio",
+    "autoIdentify": "Identificar Automaticamente",
+    "autoIdentifyMobile": "Auto",
+    "bothAudioDesc": "Grava sua voz + áudio dos participantes da reunião (recomendado para reuniões online)",
+    "clearFilters": "limpar filtros",
+    "clickToAddNotes": "Clique para adicionar notas...",
+    "colorRepeats": "A cor se repete a partir do orador {{number}}",
+    "completedFiles": "Arquivos Concluídos",
+    "confirmReprocessingTitle": "Confirmar Reprocessamento",
+    "copyMessage": "Copiar mensagem",
+    "createFolders": "Criar pastas",
+    "createPublicLink": "Crie um link público para compartilhar esta gravação. O compartilhamento só está disponível em conexões seguras (HTTPS).",
+    "createTags": "Criar etiquetas",
+    "defaultHotwordsHelp": "Palavras ou frases separadas por vírgula que o modelo de transcrição deve priorizar reconhecer (nomes de marca, acrônimos, termos técnicos).",
+    "defaultInitialPromptHelp": "Contexto para orientar o estilo e vocabulário do modelo de transcrição. Descreva o tópico ou o conteúdo esperado de suas gravações.",
+    "deleteSegment": "Deletar segmento",
+    "discard": "Descartar",
+    "dragToReorder": "Arraste para reorganizar",
+    "endTime": "Fim",
+    "enterNameFor": "Digite nome para",
+    "enterSpeakerName": "Digite nome do orador...",
+    "entireScreen": "Tela Inteira",
+    "errorChangingSpeaker": "Erro ao alterar orador",
+    "errorOpeningTextEditor": "Erro ao abrir editor de texto",
+    "errorSavingText": "Erro ao salvar texto",
+    "estimatedSize": "Tamanho estimado",
+    "firstTagAsrSettings": "As configurações de ASR da primeira etiqueta serão aplicadas:",
+    "firstTagDefaultsApplied": "Padrões da primeira etiqueta aplicados",
+    "folderHasCustomPrompt": "Esta pasta tem uma instrução de resumo personalizada",
+    "generatingSummary": "Gerando resumo...",
+    "groups": "grupos",
+    "howToRecordSystemAudio": "Como Gravar Áudio do Sistema",
+    "identifyAllSpeakers": "Identificar todos os oradores",
+    "identifying": "Identificando...",
+    "importantNote": "Nota importante",
+    "internalSharingDesc": "Compartilhe com usuários específicos em sua organização",
+    "lines": "{{count}} linhas",
+    "loadingMore": "Carregando mais gravações...",
+    "loadingRecordings": "Carregando gravações...",
+    "me": "Eu",
+    "microphoneDesc": "Grava apenas sua voz",
+    "modelReasoning": "Raciocínio do Modelo",
+    "moreSpeakersThanColors": "Mais oradores do que cores disponíveis",
+    "navigate": "Navegar",
+    "noDateSet": "Nenhuma data definida",
+    "noMatchingTags": "Nenhuma etiqueta correspondente",
+    "noParticipants": "Sem participantes",
+    "noRecordingSelected": "Nenhuma gravação selecionada.",
+    "noSpeakersIdentified": "Nenhum orador pôde ser identificado a partir do contexto.",
+    "noSuggestionsToApply": "Nenhuma sugestão para aplicar",
+    "noTagsCreated": "Nenhuma etiqueta criada ainda.",
+    "of": "de",
+    "playFromHere": "Reproduzir daqui",
+    "pleaseEnterSpeakerName": "Por favor, digite um nome de orador",
+    "processingTime": "Tempo de processamento",
+    "processingTimeDescription": "Isso pode levar alguns minutos para ser concluído. Você pode continuar usando o aplicativo durante o processamento.",
+    "processingTranscription": "Processando transcrição...",
+    "publicLinkDesc": "Qualquer pessoa com este link pode acessar a gravação",
+    "recordSystemSteps1": "Clique em \"Gravar Áudio do Sistema\" ou \"Gravar Ambos\".",
+    "recordSystemSteps2": "Na janela pop-up, escolha",
+    "recordSystemSteps3": "Certifique-se de marcar a caixa que diz",
+    "recordingFinished": "Gravação concluída",
+    "recordingInProgress": "Gravação em andamento...",
+    "regenerateSummaryAfterNames": "Regenerar resumo após atualizar nomes",
+    "saved": "Salvo!",
+    "savingProgress": "Salvando...",
+    "selectedTagsCustomPrompts": "As etiquetas selecionadas incluem instruções de resumo personalizadas",
+    "sentence": "Sentença",
+    "shareSystemAudio": "Compartilhar áudio do sistema",
+    "shareTabAudio": "Compartilhar áudio da aba",
+    "sharedOn": "Compartilhado em",
+    "sharingWindowNoAudio": "Compartilhar uma \"Janela\" não capturará áudio.",
+    "speakerAdded": "Orador adicionado com sucesso",
+    "speakerCount": "Orador",
+    "speakerName": "Nome do Orador",
+    "speakerNamesUpdated": "Nomes dos oradores atualizados com sucesso!",
+    "speakers": "Oradores",
+    "speakersIdentified": "{{count}} orador identificado com sucesso!",
+    "speakersIdentifiedPlural": "{{count}} oradores identificados com sucesso!",
+    "speakersUpdatedSaveToApply": "Oradores atualizados! Salve a transcrição para aplicar mudanças.",
+    "specificBrowserTab": "aba específica do navegador",
+    "startTime": "Início",
+    "startingAutoIdentification": "Iniciando identificação automática de oradores...",
+    "summaryGenerationFailed": "Falha na geração do resumo",
+    "summaryGenerationTimedOut": "Geração de resumo expirou",
+    "summaryRegenerationStarted": "Regeneração de resumo iniciada",
+    "summaryUpdated": "Resumo atualizado!",
+    "systemAudioDesc": "Grava participantes da reunião e sons do sistema",
+    "tagManagement": "Gerenciamento de Etiquetas",
+    "thisActionCannotBeUndone": "Esta ação não pode ser desfeita.",
+    "toCaptureAudioFromMeetings": "Para capturar áudio de reuniões ou outros aplicativos, você deve compartilhar sua tela ou uma aba do navegador.",
+    "toOrganizeRecordings": "para organizar suas gravações",
+    "transcriptUpdated": "Transcrição atualizada com sucesso!",
+    "troubleshooting": "Solução de Problemas",
+    "tryAdjustingSearch": "Tente ajustar sua pesquisa ou",
+    "unsupportedBrowser": "Navegador Não Suportado",
+    "untitled": "Gravação Sem Título",
+    "uploadRecordingNotes": "Enviar Gravação e Notas",
+    "whatWillHappen": "O que acontecerá?",
+    "whyNotWorking": "Por que não está funcionando?",
+    "youHaveXSpeakers": "Você tem {{count}} oradores, mas apenas 16 cores únicas estão disponíveis. As cores se repetirão após o 16º orador."
+  },
+  "incognito": {
+    "audioNotStored": "Áudio não armazenado em modo incógnito",
+    "discardConfirm": "Isso descartará permanentemente sua gravação de incógnito. Continuar?",
+    "mode": "Modo Incógnito",
+    "notSavedToAccount": "Não salvo na conta",
+    "oneFileAtATime": "Modo incógnito suporta um arquivo por vez",
+    "processInIncognito": "Processar em Incógnito",
+    "processWithoutSaving": "Processar sem salvar",
+    "processing": "Processando...",
+    "processingComplete": "Processamento concluído!",
+    "processingInProgress": "Processando em modo incógnito...",
+    "recordingDiscarded": "Gravação de incógnito descartada",
+    "recordingProcessed": "Gravação de incógnito processada - dados serão perdidos quando a aba fechar",
+    "recordingReady": "Gravação de incógnito pronta!",
+    "recordingTitle": "Gravação de Incógnito",
+    "selectExactlyOneFile": "Selecione exatamente 1 arquivo",
+    "sessionOnly": "Apenas sessão",
+    "uploadingFile": "Enviando arquivo para processamento de incógnito..."
+  },
+  "inquire": {
+    "activeFilters": "Filtros Ativos:",
+    "askQuestions": "Faça Perguntas Sobre Suas Transcrições",
+    "clearAll": "Limpar Tudo",
+    "dateRange": "Intervalo de Datas",
+    "dateRangeActive": "Intervalo de datas ativo",
+    "exampleQuestion1": "\"Quais itens de ação foram discutidos?\"",
+    "exampleQuestion2": "\"Quando decidimos mudar a linha do tempo?\"",
+    "exampleQuestion3": "\"Que preocupações foram levantadas sobre o orçamento?\"",
+    "exampleQuestion4": "\"Quem foi responsável pelas tarefas de marketing?\"",
+    "exampleQuestions": "Perguntas de Exemplo:",
+    "filters": "Filtros",
+    "filtersActive": "Filtros ativos",
+    "from": "De",
+    "noSpeakerData": "Nenhum dado de orador disponível",
+    "placeholder": "Faça perguntas sobre suas transcrições filtradas...",
+    "selectFilters": "Selecione filtros à esquerda para restringir suas transcrições e, em seguida, faça perguntas para obter insights de suas gravações.",
+    "sendHint": "Pressione Enter para enviar • Ctrl+Enter para nova linha",
+    "speakerRequirement": "A identificação de oradores requer gravações com múltiplos oradores",
+    "speakers": "Oradores",
+    "speakersCount": "oradores",
+    "tags": "Etiquetas",
+    "tagsCount": "etiquetas",
+    "title": "Inquire",
+    "to": "Para"
+  },
+  "languages": {
+    "ar": "Árabe",
+    "de": "Alemão",
+    "en": "Inglês",
+    "es": "Espanhol",
+    "fr": "Francês",
+    "hi": "Hindi",
+    "it": "Italiano",
+    "ja": "Japonês",
+    "ko": "Coreano",
+    "nl": "Holandês",
+    "pt": "Português",
+    "pt-BR": "Português (Brasil)",
+    "ru": "Russo",
+    "zh": "Chinês",
+    "autoDetect": "Detecção automática",
+    "defaultModelDecides": "Padrão (o modelo decide)",
+    "id": "Indonésio",
+    "pl": "Polonês",
+    "sv": "Sueco",
+    "th": "Tailandês",
+    "tr": "Turco",
+    "uk": "Ucraniano",
+    "vi": "Vietnamita"
+  },
+  "manageSpeakersModal": {
+    "created": "Criado",
+    "description": "Gerencie seus oradores salvos. Eles são salvos automaticamente quando você usa nomes de oradores em suas gravações.",
+    "failedToLoad": "Falha ao carregar oradores",
+    "lastUsed": "Último uso",
+    "loadingSpeakers": "Carregando oradores...",
+    "noSpeakersYet": "Nenhum orador salvo ainda",
+    "speakersSaved": "{{count}} oradores salvos",
+    "speakersWillAppear": "Os oradores aparecerão aqui quando você usar nomes de oradores em suas gravações",
+    "times": "vezes",
+    "title": "Gerenciar Oradores",
+    "used": "Usado"
+  },
+  "messages": {
+    "colorSchemeApplied": "Esquema de cores aplicado",
+    "colorSchemeReset": "Esquema de cores redefinido para padrão",
+    "copiedSuccessfully": "Copiado para área de transferência!",
+    "copiedToClipboard": "Copiado para área de transferência",
+    "copyFailed": "Falha na cópia",
+    "copyNotSupported": "Cópia falhou. Seu navegador pode não suportar este recurso.",
+    "downloadStarted": "Download iniciado",
+    "errorRecoveringRecording": "Erro ao recuperar gravação",
+    "eventDownloadFailed": "Falha ao baixar evento",
+    "eventDownloadSuccess": "Evento \"{{title}}\" baixado. Abra o arquivo para adicionar ao seu calendário.",
+    "eventsExportFailed": "Falha ao exportar eventos",
+    "eventsExportSuccess": "{{count}} eventos exportados",
+    "failedToDeleteJob": "Falha ao deletar trabalho",
+    "failedToRecoverRecording": "Falha ao recuperar gravação",
+    "failedToRetryJob": "Falha ao tentar novamente o trabalho",
+    "failedToSave": "Falha ao salvar: {{error}}",
+    "failedToSaveParticipants": "Falha ao salvar participantes",
+    "followPlayerDisabled": "Modo de seguimento do jogador desabilitado",
+    "followPlayerEnabled": "Modo de seguimento do jogador habilitado",
+    "invalidEventData": "Dados de evento inválidos",
+    "jobQueuedForRetry": "Trabalho enfileirado para nova tentativa",
+    "noEventsToExport": "Sem eventos para exportar",
+    "noNotesAvailableDownload": "Nenhuma nota disponível para baixar.",
+    "noNotesToCopy": "Nenhuma nota disponível para copiar.",
+    "noPermissionToEdit": "Você não tem permissão para editar esta gravação",
+    "noSummaryToCopy": "Nenhum resumo disponível para copiar.",
+    "noSummaryToDownload": "Nenhum resumo disponível para baixar.",
+    "noTranscriptionToCopy": "Nenhuma transcrição disponível para copiar.",
+    "noTranscriptionToDownload": "Nenhuma transcrição disponível para baixar.",
+    "notesCopied": "Notas copiadas para área de transferência!",
+    "notesDownloadFailed": "Falha ao baixar notas",
+    "notesDownloadSuccess": "Notas baixadas com sucesso!",
+    "notesUpdated": "Notas atualizadas com sucesso",
+    "passwordChanged": "Senha alterada com sucesso",
+    "profileUpdated": "Perfil atualizado com sucesso",
+    "recordingDeleted": "Gravação deletada com sucesso",
+    "recordingDiscarded": "Gravação descartada",
+    "recordingRecovered": "Gravação recuperada com sucesso",
+    "recordingSaved": "Gravação salva com sucesso",
+    "saveParticipantsFailed": "Falha ao salvar: {{error}}",
+    "settingsSaved": "Configurações salvas com sucesso",
+    "summaryCopied": "Resumo copiado para área de transferência!",
+    "summaryDownloadFailed": "Falha ao baixar resumo",
+    "summaryDownloadSuccess": "Resumo baixado com sucesso!",
+    "summaryGenerated": "Resumo gerado com sucesso",
+    "tagAdded": "Etiqueta adicionada com sucesso",
+    "tagRemoved": "Etiqueta removida com sucesso",
+    "transcriptDownloadFailed": "Falha ao baixar transcrição",
+    "transcriptDownloadSuccess": "Transcrição baixada com sucesso!",
+    "transcriptionCopied": "Transcrição copiada para área de transferência!",
+    "transcriptionUpdated": "Transcrição atualizada com sucesso"
+  },
+  "metadata": {
+    "cancelEdit": "Cancelar",
+    "createdAt": "Criado",
+    "duration": "Duração",
+    "editMetadata": "Editar Metadados",
+    "fileName": "Nome do Arquivo",
+    "fileSize": "Tamanho do Arquivo",
+    "language": "Idioma",
+    "meetingDate": "Data da Reunião",
+    "processingTime": "Tempo de Processamento",
+    "saveMetadata": "Salvar",
+    "status": "Status",
+    "title": "Metadados",
+    "updatedAt": "Atualizado",
+    "wordCount": "Contagem de Palavras"
+  },
+  "modal": {
+    "addSpeaker": "Adicionar Novo Orador",
+    "colorScheme": "Esquema de Cores",
+    "deleteRecording": "Deletar Gravação",
+    "editAsrTranscription": "Editar Transcrição de ASR",
+    "editParticipants": "Editar Participantes",
+    "editRecording": "Editar Gravação",
+    "editSpeakers": "Editar Oradores",
+    "editTags": "Editar Etiquetas da Gravação",
+    "editTranscription": "Editar Transcrição",
+    "identifySpeakers": "Identificar Oradores",
+    "recordingNotice": "Aviso de Gravação",
+    "reprocessSummary": "Reprocessar Resumo",
+    "reprocessTranscription": "Reprocessar Transcrição",
+    "resetStatus": "Redefinir Status da Gravação?",
+    "shareRecording": "Compartilhar Gravação",
+    "sharedTranscripts": "Transcrições Compartilhadas",
+    "systemAudioHelp": "Ajuda de Áudio do Sistema",
+    "uploadFiles": "Enviar Arquivos",
+    "uploadNotice": "Aviso de Envio"
+  },
+  "namingTemplates": {
+    "addPattern": "Adicionar Padrão",
+    "availableTemplates": "Modelos Disponíveis",
+    "availableVars": "Variáveis Integradas",
+    "cancel": "Cancelar",
+    "createDefaults": "Criar Modelos Padrão",
+    "createNew": "Criar Modelo",
+    "customVarsHint": "Defina padrões de expressão regular abaixo para extrair variáveis personalizadas dos nomes de arquivo.",
+    "delete": "Deletar",
+    "description": "Defina como os títulos das gravações são gerados a partir de nomes de arquivo e conteúdo de transcrição.",
+    "descriptionLabel": "Descrição",
+    "noDefault": "Sem padrão (apenas título de IA)",
+    "regexHint": "Extrair dados de nomes de arquivo. Use grupos de captura () para especificar a correspondência. Exemplo: (\\d{10}) para números de telefone.",
+    "regexPatterns": "Padrões de Expressão Regular (Opcional)",
+    "result": "Resultado:",
+    "save": "Salvar",
+    "selectOrCreate": "Selecione um modelo para editar ou crie um novo",
+    "tabTitle": "Nomenclatura",
+    "template": "Modelo",
+    "templateName": "Nome do Modelo",
+    "test": "Testar",
+    "testTemplate": "Testar Modelo",
+    "title": "Modelos de Nomenclatura",
+    "userDefault": "Modelo Padrão",
+    "userDefaultHint": "Aplicado quando nenhuma etiqueta tem um modelo de nomenclatura definido."
+  },
+  "nav": {
+    "account": "Conta",
+    "accountSettings": "Configurações de Conta",
+    "admin": "Admin",
+    "adminDashboard": "Painel de Controle do Admin",
+    "darkMode": "Modo Escuro",
+    "groupManagement": "Gerenciamento de Grupos",
+    "home": "Início",
+    "language": "Idioma",
+    "lightMode": "Modo Claro",
+    "newRecording": "Nova Gravação",
+    "recording": "Gravação",
+    "settings": "Configurações",
+    "signOut": "Sair",
+    "teamManagement": "Gerenciamento de Grupos",
+    "upload": "Enviar",
+    "userProfile": "Perfil do Usuário"
+  },
+  "notes": {
+    "cancelEdit": "Cancelar Edição",
+    "characterCount": "{{count}} caractere",
+    "characterCountPlural": "{{count}} caracteres",
+    "editNotes": "Editar Notas",
+    "lastUpdated": "Última atualização",
+    "placeholder": "Adicione suas notas aqui...",
+    "saveNotes": "Salvar Notas",
+    "title": "Notas"
+  },
+  "pwa": {
+    "installApp": "Instalar Aplicativo",
+    "installed": "Instalado com sucesso",
+    "installing": "Instalando...",
+    "notificationPermissionDenied": "Permissão de notificação negada",
+    "notificationsEnabled": "Notificações ativadas",
+    "offline": "Você está offline",
+    "screenAwake": "A tela permanecerá acordada durante a gravação",
+    "screenAwakeFailed": "Não foi possível manter a tela acordada",
+    "updateAvailable": "Atualização disponível"
+  },
+  "recording": {
+    "acceptDisclaimer": "Eu Aceito",
+    "cancelRecording": "Cancelar",
+    "discardRecovery": "Descartar",
+    "disclaimer": "Aviso de Gravação",
+    "duration": "Duração",
+    "micPlusSys": "Mic + Sis",
+    "microphone": "Microfone",
+    "microphoneAndSystem": "Microfone + Sistema",
+    "microphonePermissionDenied": "Permissão do microfone negada",
+    "modeBoth": "Microfone + Sistema",
+    "modeMicrophone": "Microfone",
+    "modeSystem": "Áudio do Sistema",
+    "notes": "Notas",
+    "notesPlaceholder": "Adicione notas sobre esta gravação...",
+    "pauseRecording": "Pausar",
+    "recordingFailed": "Falha na gravação",
+    "recordingInProgress": "Gravação em andamento...",
+    "recordingMode": "Modo de Gravação",
+    "recordingSize": "Tamanho Estimado",
+    "recordingStopped": "Gravação parada",
+    "recordingTime": "Tempo de Gravação",
+    "recoveryDescription": "Encontramos uma gravação inacabada de uma sessão anterior. Deseja restaurá-la?",
+    "recoveryFound": "Gravação Não Salva Detectada",
+    "recoveryTitle": "Recuperar Gravação",
+    "restoreRecording": "Restaurar",
+    "resumeRecording": "Retomar",
+    "saveRecording": "Salvar Gravação",
+    "size": "Tamanho",
+    "startRecording": "Iniciar Gravação",
+    "startedAt": "Iniciado em",
+    "stopRecording": "Parar Gravação",
+    "systemAudio": "Áudio do Sistema",
+    "systemAudioNotSupported": "A gravação de áudio do sistema não é suportada neste navegador",
+    "title": "Gravação de Áudio"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "O áudio será retranscrito do zero. Isso também regenerará o título e o resumo com base na nova transcrição.",
+    "audioReTranscribedWithAsr": "O áudio será retranscrito usando o endpoint de ASR. Isso inclui diarização e regenerará o título e o resumo.",
+    "manualEditsOverwritten": "Qualquer edição manual da transcrição, título ou resumo será sobrescrita.",
+    "manualEditsOverwrittenSummary": "Qualquer edição manual do resumo será sobrescrita.",
+    "newTitleAndSummary": "Um novo resumo será gerado com base na transcrição existente."
+  },
+  "settings": {
+    "apiKeys": "Chaves de API",
+    "appearance": "Aparência",
+    "changePassword": "Alterar Senha",
+    "dataExport": "Exportação de Dados",
+    "deleteAccount": "Deletar Conta",
+    "integrations": "Integrações",
+    "language": "Idioma",
+    "notifications": "Notificações",
+    "preferences": "Preferências",
+    "privacy": "Privacidade",
+    "profile": "Perfil",
+    "security": "Segurança",
+    "theme": "Tema",
+    "title": "Configurações",
+    "twoFactorAuth": "Autenticação de Dois Fatores"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "Você não compartilhou nenhuma transcrição ainda.",
+    "shareNotes": "Compartilhar Notas",
+    "shareSummary": "Compartilhar Resumo",
+    "sharedOn": "Compartilhado em"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "Você ainda não compartilhou nenhuma transcrição."
+  },
+  "sharing": {
+    "canEdit": "Pode editar",
+    "canReshare": "Pode compartilhar novamente",
+    "internalSharing": "Compartilhamento Interno",
+    "notSharedYet": "Não compartilhado ainda",
+    "publicBadge": "Público",
+    "publicLink": "Link Público",
+    "publicLinks": "link(s) público(s)",
+    "publicLinksGenerated": "link(s) público(s) gerado(s)",
+    "searchUsers": "Pesquisar usuários...",
+    "sharedBadge": "Compartilhado",
+    "sharedBy": "Compartilhado por",
+    "sharedWith": "Compartilhado com",
+    "teamBadge": "Grupo",
+    "teamRecording": "Gravação do grupo",
+    "unknown": "Desconhecido",
+    "users": "usuário(s)"
+  },
+  "sidebar": {
+    "advancedSearch": "Busca Avançada",
+    "archived": "Arquivado",
+    "archivedRecordings": "Gravações Arquivadas",
+    "dateRange": "Intervalo de Datas",
+    "filters": "Filtros",
+    "highlighted": "Destacado",
+    "inbox": "Caixa de Entrada",
+    "lastMonth": "Último Mês",
+    "lastWeek": "Última Semana",
+    "loadMore": "Carregar Mais",
+    "markAsRead": "Marcar como lido",
+    "moveToInbox": "Mover para Caixa de Entrada",
+    "noRecordings": "Nenhuma gravação encontrada",
+    "older": "Mais Antiga",
+    "removeFromHighlighted": "Remover estrela",
+    "searchRecordings": "Pesquisar gravações...",
+    "sharedWithMe": "Compartilhado Comigo",
+    "sortBy": "Ordenar Por",
+    "sortByDate": "Data de Criação",
+    "sortByMeetingDate": "Data da Reunião",
+    "starred": "Destaques",
+    "tags": "Etiquetas",
+    "thisMonth": "Este Mês",
+    "thisWeek": "Esta Semana",
+    "today": "Hoje",
+    "totalRecordings": "{{count}} gravação",
+    "totalRecordingsPlural": "{{count}} gravações",
+    "upcoming": "Próximos",
+    "yesterday": "Ontem"
+  },
+  "speakers": {
+    "filterBySpeaker": "Filtrar por orador",
+    "noMatchingSpeakers": "Nenhum orador correspondente",
+    "searchSpeakers": "Pesquisar..."
+  },
+  "speakersManagement": {
+    "added": "Adicionado",
+    "confidence": "Confiança",
+    "confidenceHigh": "alta",
+    "confidenceLow": "baixa",
+    "confidenceMedium": "média",
+    "created": "Criado",
+    "description": "Gerencie seus oradores salvos. Eles são salvos automaticamente quando você usa nomes de oradores em suas gravações.",
+    "failedToLoad": "Falha ao carregar oradores",
+    "failedToLoadSnippets": "Falha ao carregar trechos",
+    "keepThisSpeaker": "Mantenha este orador (outros serão mesclados nele):",
+    "last": "Último",
+    "lastUsed": "Último uso",
+    "loadingSpeakers": "Carregando oradores...",
+    "match": "correspondência",
+    "mergeDescription": "Combine múltiplos perfis de orador em um. Todos os embeddings, trechos e dados de uso serão mesclados.",
+    "mergeFailed": "Falha ao mesclar oradores",
+    "mergeNSpeakers": "Mesclar {{count}} Oradores",
+    "mergeSpeakers": "Mesclar Oradores",
+    "mergeSuccess": "Oradores mesclados com sucesso",
+    "noSnippetsAvailable": "Nenhum trecho disponível",
+    "noSpeakersYet": "Nenhum orador salvo ainda",
+    "sample": "amostra",
+    "samples": "amostras",
+    "selectToMerge": "Selecione 2+ para Mesclar",
+    "speakersToMerge": "Oradores para mesclar:",
+    "speakersWillAppear": "Os oradores aparecerão aqui quando você usar nomes de oradores em suas gravações",
+    "targetWillReceive": "O orador selecionado receberá todos os dados de voz e trechos dos outros.",
+    "time": "hora",
+    "times": "horas",
+    "totalSpeakers": "oradores salvos",
+    "used": "Usado",
+    "usedTimes": "Usado",
+    "viewSnippets": "Ver Trechos",
+    "voiceMatchSuggestions": "Sugestões de Correspondência de Voz",
+    "voiceProfile": "Perfil de Voz"
+  },
+  "status": {
+    "completed": "Concluído",
+    "failed": "Falha",
+    "processing": "Processando",
+    "queued": "Enfileirado",
+    "stuck": "Redefinir processamento travado",
+    "summarizing": "Resumindo",
+    "transcribing": "Transcrevendo",
+    "uploading": "Enviando"
+  },
+  "summary": {
+    "actionItems": "Itens de Ação",
+    "cancelEdit": "Cancelar Edição",
+    "decisions": "Decisões",
+    "editSummary": "Editar Resumo",
+    "generateSummary": "Gerar Resumo",
+    "keyPoints": "Pontos-chave",
+    "noSummary": "Nenhum resumo disponível",
+    "participants": "Participantes",
+    "regenerateSummary": "Regenerar Resumo",
+    "saveSummary": "Salvar Resumo",
+    "summaryFailed": "Falha na geração do resumo",
+    "summaryInProgress": "Geração de resumo em andamento...",
+    "title": "Resumo"
+  },
+  "tagManagement": {
+    "asrDefaults": "Padrões de ASR",
+    "createTag": "Criar Etiqueta",
+    "customPrompt": "Instrução Personalizada",
+    "description": "Organize suas gravações com etiquetas personalizadas. Cada etiqueta pode ter sua própria instrução de resumo e configurações ASR padrão.",
+    "maxSpeakers": "Máximo",
+    "minSpeakers": "Mínimo",
+    "noTags": "Você ainda não criou nenhuma etiqueta."
+  },
+  "tags": {
+    "addTag": "Adicionar Etiqueta",
+    "clearTagFilter": "Limpar filtro",
+    "createTag": "Criar Etiqueta",
+    "currentTags": "Etiquetas Atuais",
+    "filterByTag": "Filtrar por etiqueta",
+    "manageAllTags": "Gerenciar Todas as Etiquetas",
+    "noAvailableTags": "Nenhuma etiqueta disponível",
+    "noMatchingTags": "Nenhuma etiqueta correspondente",
+    "noTags": "Sem etiquetas",
+    "removeTag": "Remover Etiqueta",
+    "searchTags": "Pesquisar...",
+    "tagColor": "Cor da Etiqueta",
+    "tagName": "Nome da Etiqueta",
+    "title": "Etiquetas"
+  },
+  "tagsModal": {
+    "addTags": "Adicionar Etiquetas",
+    "currentTags": "Etiquetas Atuais",
+    "done": "Concluído",
+    "noTagsAssigned": "Nenhuma etiqueta atribuída a esta gravação",
+    "searchTags": "Pesquisar etiquetas..."
+  },
+  "time": {
+    "dayAgo": "1 dia atrás",
+    "daysAgo": "{{count}} dias atrás",
+    "hourAgo": "1 hora atrás",
+    "hoursAgo": "{{count}} horas atrás",
+    "justNow": "Agora mesmo",
+    "minuteAgo": "1 minuto atrás",
+    "minutesAgo": "{{count}} minutos atrás",
+    "monthAgo": "1 mês atrás",
+    "monthsAgo": "{{count}} meses atrás",
+    "weekAgo": "1 semana atrás",
+    "weeksAgo": "{{count}} semanas atrás",
+    "yearAgo": "1 ano atrás",
+    "yearsAgo": "{{count}} anos atrás"
+  },
+  "tooltips": {
+    "changeSpeaker": "Alterar orador",
+    "clearChat": "Limpar chat",
+    "copyTranscript": "Copiar transcrição",
+    "deleteTeam": "Deletar Grupo",
+    "doubleClickToEdit": "Clique duplo para editar",
+    "downloadTranscriptWithTemplate": "Baixar transcrição com modelo",
+    "editTeam": "Editar Grupo",
+    "editText": "Editar texto",
+    "editTitle": "Editar título",
+    "regenerateTitle": "Regenerar título com IA",
+    "assignFolder": "Atribuir Pasta",
+    "discardIncognito": "Descartar gravação de incógnito",
+    "editTranscript": "Editar transcrição",
+    "exitFullscreen": "Sair da tela cheia",
+    "expand": "Expandir",
+    "followPlayerDisabled": "Ativar deslocamento automático - transcrição acompanha reproducão de áudio",
+    "followPlayerEnabled": "Desativar deslocamento automático - transcrição fica no lugar",
+    "fullscreenVideo": "Vídeo em tela cheia",
+    "grantPublicSharing": "Conceder permissão de compartilhamento público",
+    "hideVideo": "Ocultar vídeo",
+    "highlight": "Destacar",
+    "makeAdmin": "Tornar Admin",
+    "manageMembers": "Gerenciar Membros",
+    "manageTeamTags": "Gerenciar Etiquetas de Grupo",
+    "markAsRead": "Marcar como lido",
+    "maximizeChat": "Maximizar chat",
+    "minimize": "Minimizar",
+    "moveToInbox": "Mover para caixa de entrada",
+    "mute": "Silenciar",
+    "pause": "Pausar",
+    "play": "Reproduzir",
+    "playbackSpeed": "Velocidade de Reprodução",
+    "removeAdmin": "Remover Admin",
+    "removeFromQueue": "Remover da fila",
+    "removeFromTeam": "Remover do grupo",
+    "removeHighlight": "Remover destaque",
+    "reprocessTranscription": "Reprocessar transcrição",
+    "reprocessWithAsr": "Reprocessar com ASR",
+    "restoreChat": "Restaurar chat",
+    "revokePublicSharing": "Revogar permissão de compartilhamento público",
+    "shareWithUsers": "Compartilhar com usuários",
+    "showVideo": "Mostrar vídeo",
+    "switchToDarkMode": "Mudar para Modo Escuro",
+    "switchToLightMode": "Mudar para Modo Claro",
+    "unmute": "Dessilenciar"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Modelos Disponíveis",
+    "availableVars": "Variáveis Disponíveis",
+    "cancel": "Cancelar",
+    "chooseTemplate": "Escolha um modelo...",
+    "createDefaults": "Criar Modelos Padrão",
+    "createNew": "Criar Modelo",
+    "default": "Padrão",
+    "delete": "Deletar",
+    "description": "Personalize como as transcrições são formatadas para download e exportação.",
+    "downloadDefault": "Baixar padrão",
+    "downloadWithoutTemplate": "Baixar sem modelo",
+    "filters": "Filtros: |upper para maiúsculas, |srt para formato de tempo de legenda",
+    "save": "Salvar",
+    "selectOrCreate": "Selecione um modelo para editar ou crie um novo",
+    "selectTemplate": "Selecionar Modelo",
+    "setDefault": "Definir como modelo padrão",
+    "tabTitle": "Transcrição",
+    "template": "Modelo",
+    "templateName": "Nome do Modelo",
+    "title": "Modelos de Transcrição",
+    "viewGuide": "Ver Guia de Modelo"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Identificar Oradores Automaticamente",
+    "bubble": "Bolha",
+    "cancelEdit": "Cancelar Edição",
+    "copy": "Copiar",
+    "copyToClipboard": "Copiar para Área de Transferência",
+    "download": "Baixar",
+    "downloadTranscript": "Baixar Transcrição",
+    "edit": "Editar",
+    "editSpeakers": "Editar Oradores",
+    "editTranscription": "Editar Transcrição",
+    "highlightSearchResults": "Destacar resultados da pesquisa",
+    "noTranscription": "Nenhuma transcrição disponível",
+    "regenerateTranscription": "Regenerar Transcrição",
+    "saveTranscription": "Salvar Transcrição",
+    "searchInTranscript": "Pesquisar na transcrição...",
+    "simple": "Simples",
+    "speaker": "Orador {{number}}",
+    "speakerLabels": "Rótulos de Orador",
+    "title": "Transcrição",
+    "unknownSpeaker": "Orador Desconhecido"
+  },
+  "upload": {
+    "chunking": "Arquivos grandes serão automaticamente divididos para processamento",
+    "completed": "Concluído",
+    "copies": "cópias deste arquivo",
+    "dropzone": "Arraste e solte arquivos de áudio aqui, ou clique para procurar",
+    "duplicateDetected": "Este arquivo parece ser uma duplicata de \"{{existingName}}\" (enviado em {{existingDate}})",
+    "duplicateFile": "Arquivo duplicado",
+    "failed": "Falha",
+    "fileExceedsMaxSize": "Arquivo \"{{name}}\" excede o tamanho máximo de {{size}} MB e foi ignorado.",
+    "fileRemovedFromQueue": "Arquivo removido da fila",
+    "filesToUpload": "Arquivos para Enviar",
+    "invalidFileType": "Tipo de arquivo inválido \"{{name}}\". Apenas arquivos de áudio e contêineres de vídeo com áudio (MP3, WAV, MP4, MOV, AVI, etc.) são aceitos. Arquivo ignorado.",
+    "maxFileSize": "Tamanho máximo de arquivo",
+    "queued": "Enfileirado",
+    "selectFiles": "Selecionar Arquivos",
+    "settingsApplyToAll": "As configurações se aplicam a todos os arquivos nesta sessão",
+    "summarizing": "Resumindo...",
+    "supportedFormats": "Suporta MP3, WAV, M4A, MP4, MOV, AVI, AMR e mais",
+    "title": "Enviar Áudio",
+    "transcribing": "Transcrevendo...",
+    "untitled": "Gravação Sem Título",
+    "uploadNFiles": "Enviar {{count}} Arquivo(s)",
+    "uploadProgress": "Progresso do Envio",
+    "videoRetained": "Vídeo preservado para reprodução",
+    "willAutoSummarize": "Será resumido automaticamente após a transcrição"
+  },
+  "uploadProgress": {
+    "title": "Progresso do Envio"
+  },
+  "asrEditor": {
+    "ctrlSHint": "Ctrl+S para salvar",
+    "saveWithoutClosing": "Salvar sem fechar (Ctrl+S)",
+    "saved": "Salvo"
+  },
+  "customizeSummary": {
+    "additionalContext": "Contexto adicional",
+    "appendPlaceholder": "ex.: A pauta de hoje é: ...",
+    "body": "Adicione um contexto pontual para este resumo, ou substitua completamente o prompt resolvido.",
+    "customPrompt": "Prompt personalizado",
+    "generateSummary": "Gerar resumo",
+    "replacePlaceholder": "Digite um prompt de resumo completo...",
+    "title": "Personalizar prompt de resumo"
+  },
+  "preferences": {
+    "description": "Preferências de exibição e comportamento do editor. Estas configurações ficam salvas em sua conta e se aplicam a todos os dispositivos.",
+    "editorAutosave": "Salvar automaticamente as edições no editor de transcrição",
+    "editorAutosaveHelp": "Quando habilitado, as edições no editor de transcrição são salvas automaticamente alguns segundos após você parar de digitar. Quando desabilitado (padrão), você salva explicitamente pelos botões Salvar ou pelo Ctrl+S.",
+    "showTimestampsSimpleView": "Mostrar marcações de tempo na visualização simples",
+    "showTimestampsSimpleViewHelp": "Exibe uma marcação de tempo compacta mm:ss ao lado de cada rótulo de orador na visualização simples. A visualização em balões não é afetada.",
+    "transcriptDisplay": "Exibição da transcrição",
+    "transcriptEditor": "Editor de transcrição"
+  },
+  "preview": {
+    "liveUpdateNote": "A seção Instruções de Resumo é atualizada à medida que você edita seu prompt personalizado acima. Os espaços reservados são substituídos pelos valores reais quando uma gravação é processada.",
+    "placeholderLegend": "Legenda dos espaços reservados:",
+    "systemReplaced": "substituído pelo sistema (data atual, transcrição, nomes de tags, etc.)",
+    "userMessageHeading": "Mensagem do usuário:",
+    "userSupplied": "fornecido pelo usuário no envio ou no reprocessamento"
+  },
+  "promptVariables": {
+    "hintReprocess": "Estes valores são substituídos nos espaços reservados do prompt resolvido. As edições aqui são salvas na gravação. Valores vazios são substituídos por uma string vazia. Até 8.000 caracteres por valor, 32.000 no total entre todas as variáveis.",
+    "hintUpload": "A tag ou pasta selecionada usa espaços reservados de prompt. Preencha-os e eles serão substituídos no prompt de resumo desta gravação. Valores vazios são substituídos por uma string vazia. Até 8.000 caracteres por valor, 32.000 no total entre todas as variáveis.",
+    "infoTooltip": "Sobre as variáveis de prompt",
+    "placeholderPrefix": "Digite",
+    "title": "Variáveis de prompt"
+  },
+  "summaryMode": {
+    "append": "Acrescentar",
+    "appendHelp": "Usar o prompt padrão e adicionar isto como contexto extra.",
+    "applyMode": "Modo de aplicação",
+    "replace": "Substituir",
+    "replaceHelp": "Usar apenas este texto como instruções de resumo."
+  }
+}
diff --git a/static/locales/ru.json b/static/locales/ru.json
new file mode 100644
index 00000000..15f32b9e
--- /dev/null
+++ b/static/locales/ru.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "ИИ-резюмирование",
+    "aiSummarizationDesc": "Интеграция OpenRouter и Ollama с настраиваемыми запросами",
+    "asrEnabled": "ASR включён",
+    "asrEndpoint": "ASR-эндпоинт",
+    "audioTranscription": "Транскрибирование аудио",
+    "audioTranscriptionDesc": "Поддержка Whisper API и пользовательских ASR с высокой точностью",
+    "backend": "Бэкенд",
+    "database": "База данных",
+    "deployment": "Развёртывание",
+    "dockerDescription": "Официальные Docker-образы",
+    "dockerHub": "Docker Hub",
+    "documentation": "Документация",
+    "documentationDescription": "Руководство пользователя и учебные материалы",
+    "endpoint": "Эндпоинт",
+    "frontend": "Фронтенд",
+    "githubDescription": "Исходный код, задачи и релизы",
+    "githubRepository": "Репозиторий GitHub",
+    "inquireMode": "Режим Inquire",
+    "inquireModeDesc": "Семантический поиск по всем вашим записям",
+    "interactiveChat": "Интерактивный чат",
+    "interactiveChatDesc": "Общайтесь с транскрипциями при помощи ИИ",
+    "keyFeatures": "Ключевые возможности",
+    "largeLanguageModel": "Большая языковая модель",
+    "model": "Модель",
+    "projectDescription": "Преобразуйте аудиозаписи в организованные заметки с поддержкой поиска. ИИ-транскрибирование, резюмирование и интерактивный чат.",
+    "projectLinks": "Ссылки на проект",
+    "sharingExport": "Обмен и экспорт",
+    "sharingExportDesc": "Делитесь записями и экспортируйте в разные форматы",
+    "speakerDiarization": "Диаризация спикеров",
+    "speakerDiarizationDesc": "Автоматическое определение и маркировка разных спикеров",
+    "speechRecognition": "Распознавание речи",
+    "systemConfiguration": "Конфигурация системы",
+    "tagline": "ИИ-транскрибирование аудио и создание заметок",
+    "technologyStack": "Технологический стек",
+    "title": "О продукте",
+    "version": "Версия",
+    "whisperApi": "Whisper API"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "Интеграция OpenRouter и Ollama с настраиваемыми запросами",
+    "asrEnabled": "ASR включён",
+    "asrEndpoint": "ASR-эндпоинт",
+    "audioTranscriptionDesc": "Поддержка Whisper API и пользовательских ASR с высокой точностью",
+    "backend": "Бэкенд",
+    "database": "База данных",
+    "deployment": "Развёртывание",
+    "dockerDescription": "Официальные Docker-образы",
+    "documentationDescription": "Инструкции по настройке и руководство пользователя",
+    "endpoint": "Эндпоинт",
+    "frontend": "Фронтенд",
+    "githubDescription": "Исходный код, задачи и релизы",
+    "inquireModeDesc": "Семантический поиск по всем вашим записям",
+    "interactiveChatDesc": "Общайтесь с транскрипциями при помощи ИИ",
+    "model": "Модель",
+    "no": "Нет",
+    "sharingExportDesc": "Делитесь записями и экспортируйте в разные форматы",
+    "speakerDiarizationDesc": "Автоматическое определение и маркировка разных спикеров",
+    "whisperApi": "Whisper API",
+    "yes": "Да"
+  },
+  "account": {
+    "accountActions": "Действия с аккаунтом",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "Изменить пароль",
+    "chooseLanguageForInterface": "Выберите язык интерфейса приложения",
+    "companyOrganization": "Компания / Организация",
+    "completedRecordings": "Завершено",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "Email",
+    "failedRecordings": "С ошибкой",
+    "fullName": "Полное имя",
+    "goToRecordings": "Перейти к записям",
+    "interfaceLanguage": "Язык интерфейса",
+    "jobTitle": "Должность",
+    "languageForSummaries": "Язык для заголовков, резюме и чата. Оставьте пустым для использования поведения по умолчанию выбранных моделей.",
+    "languagePreferences": "Языковые настройки",
+    "leaveBlankForAutoDetect": "Оставьте пустым для автоматического определения сервисом транскрибирования",
+    "manageSpeakers": "Управление спикерами",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "Личная информация",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "Предпочитаемый язык чат-бота и резюмирования",
+    "processingRecordings": "В обработке",
+    "saveAllPreferences": "Сохранить все настройки",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "Статистика аккаунта",
+    "title": "Информация об аккаунте",
+    "totalRecordings": "Всего записей",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "Язык транскрибирования",
+    "userDetails": "Данные пользователя",
+    "username": "Имя пользователя"
+  },
+  "accountTabs": {
+    "about": "О продукте",
+    "apiTokens": "API-токены",
+    "customPrompts": "Пользовательские запросы",
+    "folderManagement": "Управление папками",
+    "namingTemplates": "Именование",
+    "promptOptions": "Настройки запросов",
+    "sharedTranscripts": "Общие транскрипты",
+    "speakersManagement": "Управление спикерами",
+    "tagManagement": "Управление тегами",
+    "templates": "Шаблоны",
+    "transcriptTemplates": "Шаблоны транскриптов",
+    "preferences": "Настройки"
+  },
+  "admin": {
+    "title": "Администратор",
+    "userMenu": "Меню пользователя"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "О режиме Inquire",
+    "actions": "ДЕЙСТВИЯ",
+    "addNewUser": "Добавить нового пользователя",
+    "addUser": "Добавить пользователя",
+    "additionalContext": "Дополнительный контекст",
+    "admin": "АДМИНИСТРАТОР",
+    "adminDefaultPrompt": "Системный запрос по умолчанию",
+    "adminDefaultPromptDesc": "Запрос, настроенный выше (показан на этой странице)",
+    "adminUser": "Администратор",
+    "allRecordingsProcessed": "Все записи обработаны!",
+    "allowed": "Allowed",
+    "available": "Доступно",
+    "blocked": "заблокировано",
+    "budgetWarnings": "Предупреждения о бюджете",
+    "characters": "символов",
+    "chunkSize": "Размер фрагмента",
+    "complete": "завершено",
+    "completedRecordings": "Завершено",
+    "confirmPasswordLabel": "Подтвердите пароль",
+    "contextNotes": {
+      "jsonConversion": "JSON-транскрипты конвертируются в чистый текст перед отправкой",
+      "modelConfig": "Используемая модель задаётся через переменную окружения TEXT_MODEL_NAME",
+      "tagPrompts": "Если существует несколько запросов тегов, они объединяются в порядке добавления тегов",
+      "transcriptLimit": "Транскрипты ограничены настраиваемым количеством символов (по умолчанию: 30 000)"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "Текущее использование",
+    "currentUsageMinutes": "Текущее использование",
+    "defaultPromptInfo": "Этот запрос по умолчанию будет использоваться для всех пользователей, которые не настроили свой собственный в настройках аккаунта.",
+    "defaultPrompts": "Запросы по умолчанию",
+    "defaultSummarizationPrompt": "Запрос резюмирования по умолчанию",
+    "description": "Description",
+    "editUser": "Редактировать пользователя",
+    "email": "EMAIL",
+    "emailLabel": "Email",
+    "embeddingModel": "Модель эмбеддингов",
+    "embeddingsStatus": "Статус эмбеддингов",
+    "errors": {
+      "failedToLoadPrompt": "Не удалось загрузить запрос по умолчанию",
+      "failedToSavePrompt": "Не удалось сохранить запрос по умолчанию. Попробуйте снова.",
+      "invalidFileSize": "Введите корректный размер от 1 до 10000 МБ",
+      "invalidInteger": "Введите корректное целое число",
+      "invalidNumber": "Введите корректное число",
+      "maxTimeout": "Время ожидания не может превышать 10 часов (36000 секунд)",
+      "minCharacters": "Введите корректное число, не менее 1000 символов",
+      "minTimeout": "Время ожидания должно быть не менее 60 секунд"
+    },
+    "failedRecordings": "С ошибкой",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "Режим Inquire позволяет пользователям искать в нескольких транскрипциях, используя вопросы на естественном языке. Работает путём разбиения транскрипций на фрагменты и создания эмбеддингов для поиска с помощью ИИ-моделей.",
+    "languagePreferenceNote": "Примечание: если у пользователя установлен предпочитаемый язык вывода, будет добавлено \"Ensure your response is in {language}.\"",
+    "lastUpdated": "Последнее обновление",
+    "maxFileSizeHelp": "Максимальный размер файла в мегабайтах (1-10000 МБ)",
+    "megabytes": "МБ",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "минут",
+    "monthlyCost": "Месячная стоимость",
+    "monthlyTokenBudget": "Месячный лимит токенов",
+    "monthlyTranscriptionBudget": "Месячный бюджет транскрипции (минуты)",
+    "needProcessing": "Требуют обработки",
+    "never": "Никогда",
+    "newPasswordLabel": "Новый пароль (оставьте пустым, чтобы сохранить текущий)",
+    "no": "Нет",
+    "noData": "Нет данных",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "Описание недоступно",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "Без ограничений",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "Данные об использовании транскрипции недоступны",
+    "none": "Нет",
+    "notSet": "Не задано",
+    "overlap": "Перекрытие",
+    "passwordLabel": "Пароль",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "В ожидании",
+    "percentUsed": "использовано",
+    "placeholdersNote": "Заполнители заменяются фактическими значениями при обработке записи.",
+    "processAllRecordings": "Обработать все записи",
+    "processNext10": "Обработать следующие 10",
+    "processedForInquire": "Обработано для Inquire",
+    "processing": "Обработка...",
+    "processingActions": "Действия обработки",
+    "processingProgress": "Прогресс обработки",
+    "processingRecordings": "В обработке",
+    "promptDescription": "Этот запрос будет использоваться для генерации резюме всех записей, когда пользователи не установили свой собственный запрос.",
+    "promptHierarchy": "Иерархия запросов",
+    "promptPriorityDescription": "Система использует следующий порядок приоритетов при выборе запроса:",
+    "promptResetMessage": "Запрос сброшен на системный по умолчанию. Нажмите \"Сохранить изменения\" для применения.",
+    "promptSavedSuccessfully": "Запрос по умолчанию успешно сохранён!",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "Распределение статусов записей",
+    "recordings": "ЗАПИСИ",
+    "recordingsNeedProcessing": "{{count}} записей требуют обработки для режима Inquire.",
+    "refreshStatus": "Обновить статус",
+    "resetToDefault": "Сбросить на стандартный",
+    "saving": "Сохранение...",
+    "searchUsers": "Поиск пользователей...",
+    "seconds": "секунд",
+    "settings": {
+      "asrTimeoutDesc": "Максимальное время ожидания завершения ASR-транскрибирования в секундах. По умолчанию 1800 секунд (30 минут).",
+      "defaultSummaryPromptDesc": "Запрос резюмирования по умолчанию, используемый когда пользователи не установили свой собственный. Служит базовым запросом для всех пользователей.",
+      "maxFileSizeDesc": "Максимальный допустимый размер файла для загрузки аудио в мегабайтах (МБ).",
+      "recordingDisclaimerDesc": "Юридическое предупреждение, показываемое пользователям перед началом записи. Поддерживает форматирование Markdown. Оставьте пустым, чтобы отключить.",
+      "uploadDisclaimerDesc": "Юридическое предупреждение, показываемое перед загрузкой файлов. Поддерживает Markdown. Оставьте пустым, чтобы отключить.",
+      "customBannerDesc": "Пользовательский баннер в верхней части страницы. Поддерживает Markdown. Оставьте пустым, чтобы отключить.",
+      "transcriptLengthLimitDesc": "Максимальное количество символов транскрипта для отправки в LLM для резюмирования и чата. Используйте -1 для отсутствия ограничений."
+    },
+    "storageUsed": "ИСПОЛЬЗОВАНО ХРАНИЛИЩА",
+    "summarizationInstructions": "Инструкции для резюмирования",
+    "systemFallback": "Системный резервный",
+    "systemFallbackDesc": "Жёстко заданный по умолчанию, если ничего из вышеперечисленного не установлено",
+    "systemPrompt": "Системный запрос",
+    "systemSettings": "Системные настройки",
+    "systemStatistics": "Системная статистика",
+    "tagCustomPrompt": "Пользовательский запрос тега",
+    "tagCustomPromptDesc": "Если у записи есть теги с пользовательскими запросами",
+    "textSearchOnly": "Только текстовый поиск",
+    "thisMonth": "Этот месяц",
+    "timeoutRecommendation": "Рекомендуется: 30-120 минут для длинных аудиофайлов",
+    "title": "Панель администратора",
+    "todaysMinutes": "Минуты сегодня",
+    "tokenBudgetExceeded": "Месячный лимит токенов превышен. Пожалуйста, свяжитесь с администратором.",
+    "tokenBudgetHelp": "Установите месячный лимит токенов для функций ИИ. Оставьте пустым для неограниченного использования.",
+    "tokenBudgetPlaceholder": "Оставьте пустым для неограниченного",
+    "tokenUsage": "Использование токенов",
+    "tokens": "токенов",
+    "topUsers": "Топ пользователей",
+    "topUsersByStorage": "Топ пользователей по использованию хранилища",
+    "total": "Всего",
+    "totalChunks": "Всего фрагментов",
+    "totalQueries": "Всего запросов",
+    "totalRecordings": "Всего записей",
+    "totalStorage": "Общее хранилище",
+    "totalUsers": "Всего пользователей",
+    "transcriptionBudgetHelp": "Ограничьте минуты транскрипции в месяц. Оставьте пустым для неограниченного.",
+    "transcriptionBudgetPlaceholder": "Оставьте пустым для неограниченного",
+    "transcriptionUsage": "Использование транскрипции",
+    "updateUser": "Обновить пользователя",
+    "userCustomPrompt": "Пользовательский запрос",
+    "userCustomPromptDesc": "Если пользователь установил свой собственный запрос в настройках аккаунта",
+    "userManagement": "Управление пользователями",
+    "userMessageTemplate": "Шаблон сообщения пользователя",
+    "userTranscriptionUsage": "Использование транскрипции пользователями (Этот месяц)",
+    "username": "ИМЯ ПОЛЬЗОВАТЕЛЯ",
+    "usernameLabel": "Имя пользователя",
+    "vectorDimensions": "Размерность векторов",
+    "vectorStore": "Векторное хранилище",
+    "vectorStoreManagement": "Управление векторным хранилищем",
+    "vectorStoreUpToDate": "Векторное хранилище актуально.",
+    "viewFullPromptStructure": "Показать полную структуру запросов LLM",
+    "warning": "предупреждение",
+    "yes": "Да"
+  },
+  "apiTokens": {
+    "activeTokens": "Активные токены",
+    "createFirstToken": "Создайте свой первый API-токен для программного доступа",
+    "createToken": "Создать токен",
+    "created": "Создан",
+    "description": "Создавайте и управляйте API-токенами для программного доступа к вашему аккаунту",
+    "expires": "Истекает",
+    "lastUsed": "Последнее использование",
+    "neverUsed": "Не использовался",
+    "noExpiration": "Без срока истечения",
+    "noTokens": "Нет API-токенов",
+    "securityNotice": "Уведомление о безопасности",
+    "securityWarning": "Относитесь к API-токенам как к паролям. Они предоставляют полный доступ к вашему аккаунту. Никогда не публикуйте токены в общедоступных местах, таких как GitHub, клиентский код или логи",
+    "title": "API-токены",
+    "usageExamples": "Примеры использования"
+  },
+  "buttons": {
+    "addSegment": "Добавить сегмент",
+    "addSpeaker": "Добавить спикера",
+    "cancel": "Отмена",
+    "clearAllFilters": "Сбросить все фильтры",
+    "clearCompleted": "Очистить завершённые загрузки",
+    "clearSearchText": "Очистить текст поиска",
+    "close": "Закрыть",
+    "copy": "Копировать",
+    "copyMessage": "Копировать сообщение",
+    "copyNotes": "Копировать заметки",
+    "copySummary": "Копировать резюме",
+    "copyToClipboard": "Скопировать в буфер обмена",
+    "createTag": "Создать тег",
+    "deleteAll": "Удалить всё",
+    "deleteSpeaker": "Удалить спикера",
+    "deleteTag": "Удалить тег",
+    "deleteUser": "Удалить пользователя",
+    "downloadAsWord": "Скачать как Word",
+    "downloadAudio": "Скачать аудио",
+    "downloadChat": "Скачать чат как документ Word",
+    "downloadNotes": "Скачать заметки как документ Word",
+    "downloadSummary": "Скачать резюме как документ Word",
+    "editNotes": "Редактировать заметки",
+    "editSetting": "Редактировать настройку",
+    "editSpeakers": "Редактировать спикеров...",
+    "editSummary": "Редактировать резюме",
+    "editTag": "Редактировать тег",
+    "editTags": "Редактировать теги",
+    "editTranscription": "Редактировать транскрипцию",
+    "editUser": "Редактировать пользователя",
+    "exportCalendar": "Экспортировать в календарь",
+    "help": "Справка",
+    "identifySpeakers": "Определить спикеров",
+    "next": "Далее",
+    "previous": "Назад",
+    "refresh": "Обновить",
+    "reprocessSummary": "Перегенерировать резюме",
+    "reprocessTranscription": "Перегенерировать транскрипцию",
+    "reprocessWithAsr": "Перегенерировать через ASR",
+    "resetStuckProcessing": "Сбросить зависшую обработку",
+    "saveChanges": "Сохранить изменения",
+    "saveCustomPrompt": "Сохранить пользовательский запрос",
+    "saveNames": "Сохранить имена",
+    "saveSettings": "Сохранить настройки",
+    "shareRecording": "Поделиться записью",
+    "toggleTheme": "Переключить тему",
+    "updateTag": "Обновить тег"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "Подтвердите новый пароль",
+    "currentPassword": "Текущий пароль",
+    "newPassword": "Новый пароль",
+    "passwordRequirement": "Пароль должен содержать не менее 8 символов",
+    "title": "Изменение пароля"
+  },
+  "chat": {
+    "availableAfterTranscription": "Чат будет доступен после завершения транскрибирования",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "Чат с транскрипцией",
+    "clearChat": "Очистить чат",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "Не удалось отправить сообщение",
+    "noMessages": "Сообщений пока нет",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "Задайте вопрос об этой записи...",
+    "placeholderWithHint": "Задайте вопрос об этой записи... (Enter для отправки, Ctrl+Enter для новой строки)",
+    "send": "Отправить",
+    "suggestedQuestions": "Предлагаемые вопросы",
+    "thinking": "Обдумываю...",
+    "title": "Чат",
+    "whatAreActionItems": "Какие есть задачи к выполнению?",
+    "whatAreKeyPoints": "Каковы ключевые моменты?",
+    "whatWasDiscussed": "Что обсуждалось?",
+    "whoSaidWhat": "Кто что сказал?"
+  },
+  "colorScheme": {
+    "chooseRecording": "Выберите запись на боковой панели, чтобы увидеть её транскрипцию и резюме",
+    "darkThemes": "Тёмные темы",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "Светлые темы",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "Сбросить на стандартную",
+    "selectRecording": "Выберите запись",
+    "subtitle": "Настройте интерфейс с помощью красивых цветовых тем",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "Океанический синий",
+          "description": "Классическая синяя тема с профессиональным видом"
+        },
+        "emerald": {
+          "name": "Лесной изумруд",
+          "description": "Свежая зелёная тема для естественного ощущения"
+        },
+        "purple": {
+          "name": "Королевский пурпур",
+          "description": "Элегантная фиолетовая тема с изысканностью"
+        },
+        "rose": {
+          "name": "Закат в розовых тонах",
+          "description": "Тёплая розовая тема с мягкой энергией"
+        },
+        "amber": {
+          "name": "Золотистый янтарь",
+          "description": "Тёплая жёлтая тема для яркости"
+        },
+        "teal": {
+          "name": "Океанский бирюзовый",
+          "description": "Прохладная бирюзовая тема для спокойствия"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "Полуночный синий",
+          "description": "Глубокий синий для сосредоточенной работы"
+        },
+        "emerald": {
+          "name": "Тёмный лес",
+          "description": "Насыщенный зелёный для комфортного просмотра"
+        },
+        "purple": {
+          "name": "Глубокий пурпур",
+          "description": "Таинственный фиолетовый для творчества"
+        },
+        "rose": {
+          "name": "Тёмная роза",
+          "description": "Приглушённый розовый с едва заметным теплом"
+        },
+        "amber": {
+          "name": "Тёмный янтарь",
+          "description": "Тёплый коричневый для уютных сессий"
+        },
+        "teal": {
+          "name": "Глубокий бирюзовый",
+          "description": "Тёмный бирюзовый для спокойной сосредоточенности"
+        }
+      }
+    },
+    "title": "Выбор цветовой схемы"
+  },
+  "common": {
+    "back": "Назад",
+    "cancel": "Отмена",
+    "changesSaved": "Изменения сохранены",
+    "close": "Закрыть",
+    "confirm": "Подтвердить",
+    "delete": "Удалить",
+    "deselectAll": "Снять выделение со всех",
+    "download": "Скачать",
+    "edit": "Редактировать",
+    "error": "Ошибка",
+    "failed": "Не удалось",
+    "filter": "Фильтр",
+    "info": "Информация",
+    "loading": "Загрузка...",
+    "new": "Новый",
+    "next": "Далее",
+    "no": "Нет",
+    "noResults": "Результатов не найдено",
+    "ok": "ОК",
+    "or": "Или",
+    "previous": "Назад",
+    "processing": "Обработка...",
+    "refresh": "Обновить",
+    "retry": "Повторить",
+    "save": "Сохранить",
+    "search": "Поиск",
+    "selectAll": "Выбрать всё",
+    "sort": "Сортировать",
+    "success": "Успешно",
+    "untitled": "Без названия",
+    "upload": "Загрузить",
+    "warning": "Предупреждение",
+    "yes": "Да"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "Текущий запрос по умолчанию (используется, если поле выше пустое)",
+    "promptDescription": "Этот запрос будет использоваться для генерации резюме ваших транскрипций. Он переопределяет запрос администратора по умолчанию.",
+    "promptPlaceholder": "Опишите, как вы хотите структурировать резюме. Оставьте пустым, чтобы использовать запрос администратора по умолчанию.",
+    "summaryGeneration": "Запрос для генерации резюме",
+    "tip1": "Будьте конкретны в отношении разделов, которые вы хотите видеть в резюме",
+    "tip2": "Используйте чёткие инструкции по форматированию (например, \"Используйте маркированные списки\", \"Создавайте нумерованные списки\")",
+    "tip3": "Укажите, если хотите приоритизировать определённую информацию",
+    "tip4": "Система автоматически предоставит содержимое транскрипта ИИ",
+    "tip5": "Ваше предпочтение по языку вывода (если установлено) будет применено автоматически",
+    "tipsTitle": "Советы по написанию эффективных запросов",
+    "yourCustomPrompt": "Ваш пользовательский запрос для резюме"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "Вы уверены, что хотите удалить всех сохранённых спикеров? Это действие нельзя отменить.",
+    "title": "Удалить всех спикеров"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "Отмена",
+      "confirm": "Удалить",
+      "message": "Вы уверены, что хотите удалить эту запись? Это действие нельзя отменить.",
+      "title": "Удаление записи"
+    },
+    "deleteShare": {
+      "message": "Вы уверены, что хотите удалить этот общий доступ? Это отзовёт доступ к публичной ссылке.",
+      "title": "Удалить общий доступ"
+    },
+    "reprocessTranscription": {
+      "cancel": "Отмена",
+      "confirm": "Перегенерировать",
+      "message": "Вы уверены, что хотите перегенерировать эту транскрипцию? Текущая транскрипция будет заменена.",
+      "title": "Перегенерация транскрипции"
+    },
+    "unsavedChanges": {
+      "cancel": "Отмена",
+      "discard": "Не сохранять",
+      "message": "У вас есть несохранённые изменения. Хотите сохранить их перед уходом?",
+      "save": "Сохранить",
+      "title": "Несохранённые изменения"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} час",
+    "hoursPlural": "{{count}} часов",
+    "minutes": "{{count}} минута",
+    "minutesPlural": "{{count}} минут",
+    "seconds": "{{count}} секунда",
+    "secondsPlural": "{{count}} секунд"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "Настройки ASR по умолчанию",
+    "asrSettingsDescription": "Эти настройки будут применяться по умолчанию при использовании этого тега с ASR-транскрибированием",
+    "color": "Цвет",
+    "colorDescription": "Выберите цвет для лёгкой идентификации",
+    "createTitle": "Создать тег",
+    "customPrompt": "Пользовательский запрос для резюме",
+    "customPromptPlaceholder": "Необязательно: пользовательский запрос для генерации резюме записей с этим тегом",
+    "defaultLanguage": "Язык по умолчанию",
+    "defaultPromptPlaceholder": "Оставьте пустым, чтобы использовать ваш запрос резюмирования по умолчанию",
+    "exportTemplate": "Шаблон экспорта",
+    "exportTemplateHint": "Выберите шаблон экспорта для использования при экспорте записей с этим тегом",
+    "leaveBlankPrompt": "Оставьте пустым, чтобы использовать ваш запрос резюмирования по умолчанию",
+    "maxSpeakers": "Макс. спикеров",
+    "minSpeakers": "Мин. спикеров",
+    "namingTemplate": "Шаблон именования",
+    "namingTemplateHint": "Выберите шаблон именования для автоматического форматирования заголовков записей с этим тегом",
+    "noExportTemplate": "Без шаблона (использовать пользовательский по умолчанию)",
+    "noNamingTemplate": "Без шаблона (использовать по умолчанию или ИИ-заголовок)",
+    "tagName": "Название тега *",
+    "tagNamePlaceholder": "например, Встречи, Интервью",
+    "title": "Редактирование тега",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "Этот тег настроен как наблюдаемая папка, а подсказка содержит переменные-подстановки. У записей, обработанных через каталог автоматической обработки, нет интерфейса для заполнения этих значений, поэтому подстановки будут заменены пустыми строками при первом запуске резюмирования. Удалите подстановки или заполните значения через повторную обработку после загрузки."
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "Не удалось записать аудио. Пожалуйста, проверьте ваш микрофон.",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "Файл слишком большой",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "Произошла ошибка",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "Ошибка загрузки общих доступов",
+    "networkError": "Ошибка сети. Пожалуйста, проверьте ваше подключение.",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "Не найдено",
+    "permissionDenied": "Доступ запрещён",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "Превышена квота хранилища",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "Ошибка сервера. Пожалуйста, попробуйте позже.",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "Не удалось сгенерировать резюме. Пожалуйста, попробуйте снова.",
+    "transcriptionFailed": "Не удалось выполнить транскрибирование. Пожалуйста, попробуйте снова.",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "Не авторизовано",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "Неподдерживаемый формат файла",
+    "uploadFailed": "Не удалось загрузить. Пожалуйста, попробуйте снова.",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "Ошибка валидации",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "При включении ИИ будет определять встречи, назначения и дедлайны, упомянутые в ваших записях, и создавать загружаемые календарные события.",
+    "enableLabel": "Включить автоматическое извлечение событий из транскриптов",
+    "info": "Извлечённые события появятся на вкладке \"События\" в записях, где обнаружены элементы календаря.",
+    "title": "Извлечение событий"
+  },
+  "events": {
+    "add": "Добавить",
+    "addToCalendar": "Добавить в календарь",
+    "attendees": "Участники",
+    "confirmDelete": "Удалить событие «{title}»?",
+    "delete": "Удалить",
+    "deleteFailed": "Не удалось удалить событие",
+    "deleted": "Событие удалено",
+    "end": "Конец",
+    "location": "Место",
+    "noEvents": "В этой записи не обнаружено событий",
+    "start": "Начало",
+    "title": "События"
+  },
+  "exportLabels": {
+    "created": "Создано",
+    "date": "Дата",
+    "fileSize": "Размер файла",
+    "footer": "Создано с помощью [Speakr](https://github.com/learnedmachine/speakr)",
+    "metadata": "Метаданные",
+    "notes": "Заметки",
+    "originalFile": "Исходный файл",
+    "participants": "Участники",
+    "summarizationTime": "Время резюмирования",
+    "summary": "Резюме",
+    "tags": "Теги",
+    "transcription": "Транскрипция",
+    "transcriptionTime": "Время транскрипции"
+  },
+  "exportTemplates": {
+    "availableLabels": "Локализованные метки (переводятся автоматически)",
+    "availableTemplates": "Доступные шаблоны",
+    "availableVars": "Доступные переменные",
+    "cancel": "Отмена",
+    "conditionals": "Условия",
+    "conditionalsHint": "Используйте {{#if variable}}...{{/if}} для условного включения содержимого",
+    "contentSections": "Разделы содержимого",
+    "createDefaults": "Создать шаблон по умолчанию",
+    "createNew": "Создать шаблон",
+    "default": "По умолчанию",
+    "delete": "Удалить",
+    "description": "Настройте, как записи экспортируются в файлы markdown.",
+    "recordingData": "Данные записи",
+    "save": "Сохранить",
+    "selectOrCreate": "Выберите шаблон для редактирования или создайте новый",
+    "setDefault": "Установить как шаблон по умолчанию",
+    "tabTitle": "Экспорт",
+    "template": "Шаблон",
+    "templateDescription": "Описание",
+    "templateName": "Название шаблона",
+    "title": "Шаблоны экспорта",
+    "viewGuide": "Просмотреть руководство по шаблонам"
+  },
+  "fileSize": {
+    "bytes": "{{count}} Б",
+    "gigabytes": "{{count}} ГБ",
+    "kilobytes": "{{count}} КБ",
+    "megabytes": "{{count}} МБ"
+  },
+  "folderManagement": {
+    "allFolders": "Все папки",
+    "asrDefaults": "Настройки ASR по умолчанию",
+    "autoShareOnApply": "Автоматически делиться с участниками группы",
+    "autoShareOnApplyHelp": "Автоматически делиться записями со всеми участниками группы при добавлении в эту папку",
+    "confirmDelete": "Вы уверены, что хотите удалить эту папку? Записи будут удалены из папки, но не удалены.",
+    "createFolder": "Создать папку",
+    "customPrompt": "Пользовательский промпт",
+    "defaultLanguage": "Язык по умолчанию",
+    "deleteFolder": "Удалить папку",
+    "description": "Организуйте записи в папках. В отличие от тегов, запись может принадлежать только одной папке. Промпты папки применяются перед пользовательскими, но после промптов тегов.",
+    "editFolder": "Редактировать папку",
+    "filterByFolder": "Фильтр по папке",
+    "folderColor": "Цвет папки",
+    "folderName": "Название папки",
+    "groupSettings": "Настройки группы",
+    "maxSpeakers": "Макс. спикеров",
+    "minSpeakers": "Мин. спикеров",
+    "moveToFolder": "Переместить в папку",
+    "namingTemplate": "Шаблон именования",
+    "noFolder": "Без папки",
+    "noFolders": "Папки ещё не созданы",
+    "noFoldersDescription": "Создайте первую папку для организации записей",
+    "protectFromDeletion": "Защитить от удаления",
+    "protectFromDeletionHelp": "Защитить записи в этой папке от автоматического удаления",
+    "recordings": "записей",
+    "removeFromFolder": "Убрать из папки",
+    "retentionDays": "Дней хранения",
+    "retentionDaysHelp": "Записи в этой папке будут удалены через указанное количество дней. Оставьте пустым для глобального правила.",
+    "retentionSettings": "Настройки хранения",
+    "selectNamingTemplate": "Выбрать шаблон именования...",
+    "shareWithGroupLead": "Поделиться с администраторами группы",
+    "shareWithGroupLeadHelp": "Делиться записями с администраторами группы при добавлении в эту папку",
+    "title": "Управление папками"
+  },
+  "form": {
+    "auto": "Автоматически",
+    "autoDetect": "Автоопределение",
+    "dateFrom": "С",
+    "dateTo": "По",
+    "enterNotesMarkdown": "Введите заметки в формате Markdown...",
+    "enterSummaryMarkdown": "Введите резюме в формате Markdown...",
+    "folder": "Folder",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "Язык",
+    "maxSpeakers": "Макс. спикеров",
+    "meetingDate": "Дата встречи",
+    "minSpeakers": "Мин. спикеров",
+    "minutes": "Минуты",
+    "notes": "Заметки",
+    "notesPlaceholder": "Введите ваши заметки в формате Markdown...",
+    "optional": "Необязательно",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "Участники",
+    "placeholderAuto": "Автоматически",
+    "placeholderCharacterLimit": "Введите лимит символов (например, 30000)",
+    "placeholderMinutes": "Минуты",
+    "placeholderOptional": "Необязательно",
+    "placeholderSeconds": "Секунды",
+    "placeholderSizeMB": "Введите размер в МБ",
+    "searchSpeakers": "Поиск спикеров...",
+    "searchTags": "Поиск тегов...",
+    "seconds": "Секунды",
+    "shareNotes": "Поделиться заметками",
+    "shareSummary": "Поделиться резюме",
+    "shareableLink": "Ссылка для общего доступа",
+    "summaryPromptPlaceholder": "Введите запрос резюмирования по умолчанию...",
+    "title": "Заголовок",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "Ваше полное имя",
+    "transcriptionModel": "Модель транскрипции",
+    "useResolvedDefault": "(использовать стандарт тега/папки/глобальный)",
+    "defaultTranscriptionModel": "Модель транскрипции по умолчанию",
+    "defaultTranscriptionModelHelp": "Переопределяет модель транскрипции для записей с этим тегом или папкой."
+  },
+  "groups": {
+    "addMembers": "Добавить участников...",
+    "autoShare": "Автоматический общий доступ",
+    "autoShareNote": "Примечание: если включены оба варианта, доступ будут иметь все участники группы. Если включен только \"администраторы группы\", доступ будут иметь только руководители группы.",
+    "autoShareTeam": "Автоматически предоставлять общий доступ к записям всем участникам группы при применении этого тега",
+    "autoSharesWithTeam": "Автоматический общий доступ для всех участников группы",
+    "confirmDelete": "Вы уверены, что хотите удалить эту группу? Это действие нельзя отменить.",
+    "createTeam": "Создать группу",
+    "createTeamTag": "Создать новый групповой тег",
+    "dayRetention": "дней хранения",
+    "deleteTeam": "Удалить группу",
+    "deletionExempt": "Исключить из удаления",
+    "deletionExemptHelp": "Записи с этим тегом будут освобождены от автоматического удаления, даже если они превышают период хранения.",
+    "editTeam": "Редактировать группу",
+    "editTeamTag": "Редактировать групповой тег",
+    "globalRetention": "Глобальное хранение",
+    "members": "Участники",
+    "noMembers": "В этой группе нет участников",
+    "noTeamTags": "Групповые теги ещё не созданы",
+    "noTeams": "Группы ещё не созданы",
+    "retentionHelp": "Записи с этим тегом будут удалены через указанное количество дней. Оставьте пустым, чтобы использовать глобальный период хранения ({{days}} дней).",
+    "retentionPeriod": "Период хранения (дни)",
+    "retentionPlaceholder": "Оставьте пустым, чтобы использовать глобальный период хранения",
+    "searchUsers": "Поиск пользователей...",
+    "selectTeamLead": "Выберите руководителя группы...",
+    "shareWithAdmins": "Предоставлять общий доступ к записям администраторам группы при применении этого тега",
+    "sharesWithAdminsOnly": "Общий доступ только для администраторов",
+    "syncComplete": "Общий доступ группы успешно синхронизирован",
+    "syncTeamShares": "Синхронизировать общий доступ группы",
+    "syncTeamSharesDescription": "Это ретроактивно предоставит общий доступ ко всем записям с групповыми тегами соответствующим участникам группы на основе настроек общего доступа тега.",
+    "teamLead": "Руководитель группы",
+    "teamName": "Название группы",
+    "teamNamePlaceholder": "Введите название группы",
+    "teamTags": "Групповые теги",
+    "title": "Управление группами",
+    "updateTeam": "Обновить группу"
+  },
+  "help": {
+    "actions": "Действия",
+    "activeFilters": "Активные фильтры",
+    "addSegmentBelow": "Добавить сегмент ниже",
+    "advancedAsrOptions": "Расширенные параметры ASR",
+    "allRecordingsLoaded": "Все записи загружены",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "Применено {{count}} предложенное имя",
+    "appliedSuggestedNamesPlural": "Применено {{count}} предложенных имён",
+    "applySuggested": "Применить предложенные",
+    "applySuggestedMobile": "Предложить",
+    "approachingLimit": "Приближается лимит в {{limit}} МБ",
+    "askAboutTranscription": "Задавайте вопросы об этой транскрипции",
+    "audioDeletedDescription": "Аудиофайл для этой записи был удалён, но транскрипция остаётся доступной.",
+    "audioDeletedMessage": "Аудиофайл был архивирован и больше не доступен для воспроизведения.",
+    "audioDeletedTitle": "Аудиофайл удалён",
+    "audioPlayer": "Аудиоплеер",
+    "autoIdentify": "Автоопределение",
+    "autoIdentifyMobile": "Авто",
+    "bothAudioDesc": "Записывает ваш голос + участников встречи (рекомендуется для онлайн-встреч)",
+    "clearFilters": "сбросить фильтры",
+    "clickToAddNotes": "Нажмите, чтобы добавить заметки...",
+    "colorRepeats": "Цвет повторяется начиная со спикера {{number}}",
+    "completedFiles": "Завершённые файлы",
+    "confirmReprocessingTitle": "Подтвердите перегенерацию",
+    "copyMessage": "Копировать сообщение",
+    "createFolders": "Create folders",
+    "createPublicLink": "Создайте публичную ссылку для общего доступа к этой записи. Общий доступ доступен только при безопасных (HTTPS) соединениях.",
+    "createTags": "Создайте теги",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "Удалить сегмент",
+    "discard": "Отклонить",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "Конец",
+    "enterNameFor": "Введите имя для",
+    "enterSpeakerName": "Введите имя спикера...",
+    "entireScreen": "Весь экран",
+    "errorChangingSpeaker": "Ошибка при смене спикера",
+    "errorOpeningTextEditor": "Ошибка при открытии текстового редактора",
+    "errorSavingText": "Ошибка при сохранении текста",
+    "estimatedSize": "Предполагаемый размер",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "Генерация резюме...",
+    "groups": "группы",
+    "howToRecordSystemAudio": "Как записать системный звук",
+    "identifyAllSpeakers": "Определить всех спикеров",
+    "identifying": "Определение...",
+    "importantNote": "Важное примечание",
+    "internalSharingDesc": "Поделиться с конкретными пользователями в вашей организации",
+    "lines": "{{count}} строк",
+    "loadingMore": "Загрузка дополнительных записей...",
+    "loadingRecordings": "Загрузка записей...",
+    "me": "Я",
+    "microphoneDesc": "Записывает только ваш голос",
+    "modelReasoning": "Рассуждения модели",
+    "moreSpeakersThanColors": "Спикеров больше, чем доступных цветов",
+    "navigate": "Навигация",
+    "noDateSet": "Дата не установлена",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "Нет участников",
+    "noRecordingSelected": "Запись не выбрана.",
+    "noSpeakersIdentified": "Не удалось определить спикеров из контекста.",
+    "noSuggestionsToApply": "Нет предложений для применения",
+    "noTagsCreated": "Теги ещё не созданы.",
+    "of": "из",
+    "playFromHere": "Воспроизвести отсюда",
+    "pleaseEnterSpeakerName": "Пожалуйста, введите имя спикера",
+    "processingTime": "Время обработки",
+    "processingTimeDescription": "Это может занять несколько минут. Вы можете продолжать использовать приложение во время обработки.",
+    "processingTranscription": "Обработка транскрипции...",
+    "publicLinkDesc": "Любой, у кого есть эта ссылка, может получить доступ к записи",
+    "recordSystemSteps1": "Нажмите \"Записать системный звук\" или \"Записать оба\".",
+    "recordSystemSteps2": "Во всплывающем окне выберите",
+    "recordSystemSteps3": "Убедитесь, что установлен флажок",
+    "recordingFinished": "Запись завершена",
+    "recordingInProgress": "Идёт запись...",
+    "regenerateSummaryAfterNames": "Перегенерируйте резюме после обновления имён",
+    "saved": "Сохранено!",
+    "savingProgress": "Сохранение...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "Предложение",
+    "shareSystemAudio": "Поделиться системным звуком",
+    "shareTabAudio": "Поделиться звуком вкладки",
+    "sharedOn": "Опубликовано",
+    "sharingWindowNoAudio": "При демонстрации \"Окна\" звук не захватывается.",
+    "speakerAdded": "Спикер успешно добавлен",
+    "speakerCount": "Спикер",
+    "speakerName": "Имя спикера",
+    "speakerNamesUpdated": "Имена спикеров успешно обновлены!",
+    "speakers": "Спикеры",
+    "speakersIdentified": "{{count}} спикер успешно определён!",
+    "speakersIdentifiedPlural": "{{count}} спикеров успешно определено!",
+    "speakersUpdatedSaveToApply": "Спикеры обновлены! Сохраните транскрипцию, чтобы применить изменения.",
+    "specificBrowserTab": "конкретную вкладку браузера",
+    "startTime": "Начало",
+    "startingAutoIdentification": "Запуск автоматического определения спикеров...",
+    "summaryGenerationFailed": "Ошибка генерации резюме",
+    "summaryGenerationTimedOut": "Превышено время генерации резюме",
+    "summaryRegenerationStarted": "Перегенерация резюме запущена",
+    "summaryUpdated": "Резюме обновлено!",
+    "systemAudioDesc": "Записывает участников встречи и системные звуки",
+    "tagManagement": "Управление тегами",
+    "thisActionCannotBeUndone": "Это действие нельзя отменить.",
+    "toCaptureAudioFromMeetings": "Чтобы захватить звук со встреч или других приложений, вы должны поделиться экраном или вкладкой браузера.",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "Транскрипция успешно обновлена!",
+    "troubleshooting": "Устранение неполадок",
+    "tryAdjustingSearch": "Попробуйте скорректировать поиск или",
+    "unsupportedBrowser": "Неподдерживаемый браузер",
+    "untitled": "Запись без названия",
+    "uploadRecordingNotes": "Загрузить запись и заметки",
+    "whatWillHappen": "Что произойдёт?",
+    "whyNotWorking": "Почему не работает?",
+    "youHaveXSpeakers": "У вас {{count}} спикеров, но доступно только 16 уникальных цветов. Цвета будут повторяться после 16-го спикера."
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "Активные фильтры:",
+    "askQuestions": "Задавайте вопросы о ваших транскрипциях",
+    "clearAll": "Сбросить всё",
+    "dateRange": "Диапазон дат",
+    "dateRangeActive": "Диапазон дат активен",
+    "exampleQuestion1": "\"Какие задачи к выполнению были обсуждены?\"",
+    "exampleQuestion2": "\"Когда мы решили изменить сроки?\"",
+    "exampleQuestion3": "\"Какие опасения были высказаны по поводу бюджета?\"",
+    "exampleQuestion4": "\"Кто отвечал за маркетинговые задачи?\"",
+    "exampleQuestions": "Примеры вопросов:",
+    "filters": "Фильтры",
+    "filtersActive": "Фильтры активны",
+    "from": "С",
+    "noSpeakerData": "Нет данных о спикерах",
+    "placeholder": "Задавайте вопросы о ваших отфильтрованных транскрипциях...",
+    "selectFilters": "Выберите фильтры слева, чтобы сузить круг транскрипций, затем задавайте вопросы для получения информации из ваших записей.",
+    "sendHint": "Нажмите Enter для отправки • Ctrl+Enter для новой строки",
+    "speakerRequirement": "Идентификация спикеров требует записей с несколькими спикерами",
+    "speakers": "Спикеры",
+    "speakersCount": "спикеров",
+    "tags": "Теги",
+    "tagsCount": "тегов",
+    "title": "Inquire",
+    "to": "По"
+  },
+  "languages": {
+    "ar": "Арабский",
+    "de": "Немецкий",
+    "en": "Английский",
+    "es": "Испанский",
+    "fr": "Французский",
+    "hi": "Хинди",
+    "it": "Итальянский",
+    "ja": "Японский",
+    "ko": "Корейский",
+    "nl": "Нидерландский",
+    "pt": "Португальский",
+    "pt-BR": "Португальский (Бразилия)",
+    "ru": "Русский",
+    "zh": "Китайский",
+    "pl": "Польский",
+    "uk": "Украинский",
+    "vi": "Вьетнамский",
+    "th": "Тайский",
+    "tr": "Турецкий",
+    "id": "Индонезийский",
+    "sv": "Шведский",
+    "autoDetect": "Автоопределение",
+    "defaultModelDecides": "По умолчанию (выбирает модель)"
+  },
+  "manageSpeakersModal": {
+    "created": "Создан",
+    "description": "Управляйте сохранёнными спикерами. Они сохраняются автоматически при использовании имён спикеров в ваших записях.",
+    "failedToLoad": "Не удалось загрузить спикеров",
+    "lastUsed": "Последнее использование",
+    "loadingSpeakers": "Загрузка спикеров...",
+    "noSpeakersYet": "Спикеров пока не сохранено",
+    "speakersSaved": "{{count}} спикеров сохранено",
+    "speakersWillAppear": "Спикеры появятся здесь, когда вы будете использовать имена спикеров в ваших записях",
+    "times": "раз",
+    "title": "Управление спикерами",
+    "used": "Использовано"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "Скопировано в буфер обмена",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "Загрузка начата",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "Заметки успешно обновлены",
+    "passwordChanged": "Пароль успешно изменён",
+    "profileUpdated": "Профиль успешно обновлён",
+    "recordingDeleted": "Запись успешно удалена",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "Запись успешно сохранена",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "Настройки успешно сохранены",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "Резюме успешно сгенерировано",
+    "tagAdded": "Тег успешно добавлен",
+    "tagRemoved": "Тег успешно удалён",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "Транскрипция успешно обновлена"
+  },
+  "metadata": {
+    "cancelEdit": "Отмена",
+    "createdAt": "Создано",
+    "duration": "Длительность",
+    "editMetadata": "Редактировать метаданные",
+    "fileName": "Имя файла",
+    "fileSize": "Размер файла",
+    "language": "Язык",
+    "meetingDate": "Дата встречи",
+    "processingTime": "Время обработки",
+    "saveMetadata": "Сохранить",
+    "status": "Статус",
+    "title": "Метаданные",
+    "updatedAt": "Обновлено",
+    "wordCount": "Количество слов"
+  },
+  "modal": {
+    "addSpeaker": "Добавить нового спикера",
+    "colorScheme": "Цветовая схема",
+    "deleteRecording": "Удалить запись",
+    "editAsrTranscription": "Редактировать ASR-транскрипцию",
+    "editParticipants": "Редактировать участников",
+    "editRecording": "Редактировать запись",
+    "editSpeakers": "Редактировать спикеров",
+    "editTags": "Редактировать теги записи",
+    "editTranscription": "Редактировать транскрипцию",
+    "identifySpeakers": "Определить спикеров",
+    "recordingNotice": "Уведомление о записи",
+    "reprocessSummary": "Перегенерировать резюме",
+    "reprocessTranscription": "Перегенерировать транскрипцию",
+    "resetStatus": "Сбросить статус записи?",
+    "shareRecording": "Поделиться записью",
+    "sharedTranscripts": "Общие транскрипты",
+    "systemAudioHelp": "Справка по системному звуку",
+    "uploadFiles": "Загрузить файлы",
+    "uploadNotice": "Уведомление о загрузке"
+  },
+  "namingTemplates": {
+    "addPattern": "Добавить шаблон",
+    "availableTemplates": "Доступные шаблоны",
+    "availableVars": "Доступные переменные",
+    "cancel": "Отмена",
+    "createDefaults": "Создать стандартные шаблоны",
+    "createNew": "Создать шаблон",
+    "customVarsHint": "Определите regex-шаблоны для извлечения пользовательских переменных из имён файлов.",
+    "delete": "Удалить",
+    "description": "Определите, как генерируются заголовки записей из имён файлов и содержимого транскрипции.",
+    "descriptionLabel": "Описание",
+    "noDefault": "Без умолчания (только ИИ-заголовок)",
+    "regexHint": "Извлекайте данные из имён файлов. Используйте группы захвата () для указания совпадения.",
+    "regexPatterns": "Regex-шаблоны (необязательно)",
+    "result": "Результат:",
+    "save": "Сохранить",
+    "selectOrCreate": "Выберите шаблон для редактирования или создайте новый",
+    "tabTitle": "Именование",
+    "template": "Шаблон",
+    "templateName": "Название шаблона",
+    "test": "Тест",
+    "testTemplate": "Тестировать шаблон",
+    "title": "Шаблоны именования",
+    "userDefault": "Шаблон по умолчанию",
+    "userDefaultHint": "Применяется, когда ни один тег не имеет шаблона именования."
+  },
+  "nav": {
+    "account": "Аккаунт",
+    "accountSettings": "Настройки аккаунта",
+    "admin": "Администратор",
+    "adminDashboard": "Панель администратора",
+    "darkMode": "Тёмная тема",
+    "groupManagement": "Управление группами",
+    "home": "Главная",
+    "language": "Язык",
+    "lightMode": "Светлая тема",
+    "newRecording": "Новая запись",
+    "recording": "Запись",
+    "settings": "Настройки",
+    "signOut": "Выйти",
+    "teamManagement": "Управление группами",
+    "upload": "Загрузить",
+    "userProfile": "Профиль пользователя"
+  },
+  "notes": {
+    "cancelEdit": "Отменить редактирование",
+    "characterCount": "{{count}} символ",
+    "characterCountPlural": "{{count}} символов",
+    "editNotes": "Редактировать заметки",
+    "lastUpdated": "Последнее обновление",
+    "placeholder": "Добавьте ваши заметки здесь...",
+    "saveNotes": "Сохранить заметки",
+    "title": "Заметки"
+  },
+  "pwa": {
+    "installApp": "Установить приложение",
+    "installed": "Успешно установлено",
+    "installing": "Установка...",
+    "notificationPermissionDenied": "Доступ к уведомлениям запрещён",
+    "notificationsEnabled": "Уведомления включены",
+    "offline": "Вы не в сети",
+    "screenAwake": "Экран будет оставаться активным во время записи",
+    "screenAwakeFailed": "Не удалось сохранить экран активным",
+    "updateAvailable": "Доступно обновление"
+  },
+  "recording": {
+    "acceptDisclaimer": "Принимаю",
+    "cancelRecording": "Отмена",
+    "discardRecovery": "Отклонить",
+    "disclaimer": "Предупреждение о записи",
+    "duration": "Длительность",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "Микрофон",
+    "microphoneAndSystem": "Микрофон + система",
+    "microphonePermissionDenied": "Доступ к микрофону запрещён",
+    "modeBoth": "Микрофон + система",
+    "modeMicrophone": "Микрофон",
+    "modeSystem": "Системный звук",
+    "notes": "Заметки",
+    "notesPlaceholder": "Добавьте заметки об этой записи...",
+    "pauseRecording": "Пауза",
+    "recordingFailed": "Запись не удалась",
+    "recordingInProgress": "Идёт запись...",
+    "recordingMode": "Режим записи",
+    "recordingSize": "Предполагаемый размер",
+    "recordingStopped": "Запись остановлена",
+    "recordingTime": "Время записи",
+    "recoveryDescription": "Мы обнаружили незавершённую запись из предыдущей сессии. Хотите восстановить её?",
+    "recoveryFound": "Обнаружена несохранённая запись",
+    "recoveryTitle": "Восстановить запись",
+    "restoreRecording": "Восстановить",
+    "resumeRecording": "Возобновить",
+    "saveRecording": "Сохранить запись",
+    "size": "Размер",
+    "startRecording": "Начать запись",
+    "startedAt": "Начато в",
+    "stopRecording": "Остановить запись",
+    "systemAudio": "Системный звук",
+    "systemAudioNotSupported": "Запись системного звука не поддерживается в этом браузере",
+    "title": "Аудиозапись"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "Аудио будет транскрибировано заново с нуля. Это также перегенерирует заголовок и резюме на основе новой транскрипции.",
+    "audioReTranscribedWithAsr": "Аудио будет транскрибировано заново с использованием ASR-эндпоинта. Это включает диаризацию и перегенерирует заголовок и резюме.",
+    "manualEditsOverwritten": "Любые ручные правки транскрипции, заголовка или резюме будут перезаписаны.",
+    "manualEditsOverwrittenSummary": "Любые ручные правки резюме будут перезаписаны.",
+    "newTitleAndSummary": "Новое резюме будет сгенерировано на основе существующей транскрипции."
+  },
+  "settings": {
+    "apiKeys": "API-ключи",
+    "appearance": "Внешний вид",
+    "changePassword": "Изменить пароль",
+    "dataExport": "Экспорт данных",
+    "deleteAccount": "Удалить аккаунт",
+    "integrations": "Интеграции",
+    "language": "Язык",
+    "notifications": "Уведомления",
+    "preferences": "Предпочтения",
+    "privacy": "Конфиденциальность",
+    "profile": "Профиль",
+    "security": "Безопасность",
+    "theme": "Тема",
+    "title": "Настройки",
+    "twoFactorAuth": "Двухфакторная аутентификация"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "Вы пока не делились транскриптами.",
+    "shareNotes": "Поделиться заметками",
+    "shareSummary": "Поделиться резюме",
+    "sharedOn": "Опубликовано"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "Вы пока не делились транскриптами."
+  },
+  "sharing": {
+    "canEdit": "Может редактировать",
+    "canReshare": "Может поделиться повторно",
+    "internalSharing": "Внутренний общий доступ",
+    "notSharedYet": "Пока не опубликовано",
+    "publicBadge": "Публичный",
+    "publicLink": "Публичная ссылка",
+    "publicLinks": "публичных ссылок",
+    "publicLinksGenerated": "публичных ссылок создано",
+    "searchUsers": "Поиск пользователей...",
+    "sharedBadge": "Общий",
+    "sharedBy": "Опубликовал",
+    "sharedWith": "Доступ есть у",
+    "teamBadge": "Группа",
+    "teamRecording": "Групповая запись",
+    "unknown": "Неизвестно",
+    "users": "пользователей"
+  },
+  "sidebar": {
+    "advancedSearch": "Расширенный поиск",
+    "archived": "Архивировано",
+    "archivedRecordings": "Архивные записи",
+    "dateRange": "Диапазон дат",
+    "filters": "Фильтры",
+    "highlighted": "Избранное",
+    "inbox": "Входящие",
+    "lastMonth": "Прошлый месяц",
+    "lastWeek": "Прошлая неделя",
+    "loadMore": "Загрузить ещё",
+    "markAsRead": "Отметить как прочитанное",
+    "moveToInbox": "Переместить во входящие",
+    "noRecordings": "Записей не найдено",
+    "older": "Более старые",
+    "removeFromHighlighted": "Убрать из избранного",
+    "searchRecordings": "Поиск записей...",
+    "sharedWithMe": "Доступные мне",
+    "sortBy": "Сортировать по",
+    "sortByDate": "Дата создания",
+    "sortByMeetingDate": "Дата встречи",
+    "starred": "Избранное",
+    "tags": "Теги",
+    "thisMonth": "Этот месяц",
+    "thisWeek": "Эта неделя",
+    "today": "Сегодня",
+    "totalRecordings": "{{count}} запись",
+    "totalRecordingsPlural": "{{count}} записей",
+    "upcoming": "Предстоящие",
+    "yesterday": "Вчера"
+  },
+  "speakers": {
+    "filterBySpeaker": "Фильтр по спикеру",
+    "noMatchingSpeakers": "Нет подходящих спикеров",
+    "searchSpeakers": "Поиск..."
+  },
+  "speakersManagement": {
+    "added": "Добавлен",
+    "confidence": "Уверенность",
+    "confidenceHigh": "высокая",
+    "confidenceLow": "низкая",
+    "confidenceMedium": "средняя",
+    "created": "Создан",
+    "description": "Управляйте сохранёнными спикерами. Они сохраняются автоматически при использовании имён спикеров в ваших записях.",
+    "failedToLoad": "Не удалось загрузить спикеров",
+    "failedToLoadSnippets": "Не удалось загрузить фрагменты",
+    "keepThisSpeaker": "Оставить этого спикера (остальные будут объединены с ним):",
+    "last": "Последний",
+    "lastUsed": "Последнее использование",
+    "loadingSpeakers": "Загрузка спикеров...",
+    "match": "совпадение",
+    "mergeDescription": "Объедините несколько профилей спикеров в один. Все эмбеддинги, фрагменты и данные об использовании будут объединены.",
+    "mergeFailed": "Не удалось объединить спикеров",
+    "mergeNSpeakers": "Объединить {{count}} спикеров",
+    "mergeSpeakers": "Объединить спикеров",
+    "mergeSuccess": "Спикеры успешно объединены",
+    "noSnippetsAvailable": "Фрагменты недоступны",
+    "noSpeakersYet": "Спикеров пока не сохранено",
+    "sample": "образец",
+    "samples": "образцов",
+    "selectToMerge": "Выберите 2+ для объединения",
+    "speakersToMerge": "Спикеры для объединения:",
+    "speakersWillAppear": "Спикеры появятся здесь, когда вы будете использовать имена спикеров в ваших записях",
+    "targetWillReceive": "Выбранный спикер получит все голосовые данные и фрагменты от остальных.",
+    "time": "раз",
+    "times": "раз",
+    "totalSpeakers": "спикеров сохранено",
+    "used": "Использовано",
+    "usedTimes": "Использовано",
+    "viewSnippets": "Просмотреть фрагменты",
+    "voiceMatchSuggestions": "Предложения совпадений голоса",
+    "voiceProfile": "Голосовой профиль"
+  },
+  "status": {
+    "completed": "Завершено",
+    "failed": "Не удалось",
+    "processing": "Обработка",
+    "queued": "В очереди",
+    "stuck": "Сбросить зависшую обработку",
+    "summarizing": "Резюмирование",
+    "transcribing": "Транскрибирование",
+    "uploading": "Загрузка"
+  },
+  "summary": {
+    "actionItems": "Задачи к выполнению",
+    "cancelEdit": "Отменить редактирование",
+    "decisions": "Решения",
+    "editSummary": "Редактировать резюме",
+    "generateSummary": "Сгенерировать резюме",
+    "keyPoints": "Ключевые моменты",
+    "noSummary": "Резюме недоступно",
+    "participants": "Участники",
+    "regenerateSummary": "Перегенерировать резюме",
+    "saveSummary": "Сохранить резюме",
+    "summaryFailed": "Не удалось сгенерировать резюме",
+    "summaryInProgress": "Генерация резюме...",
+    "title": "Резюме"
+  },
+  "tagManagement": {
+    "asrDefaults": "Настройки ASR по умолчанию",
+    "createTag": "Создать тег",
+    "customPrompt": "Пользовательский запрос",
+    "description": "Организуйте ваши записи с помощью пользовательских тегов. Каждый тег может иметь свой собственный запрос для резюме и настройки ASR по умолчанию.",
+    "maxSpeakers": "Макс.",
+    "minSpeakers": "Мин.",
+    "noTags": "Вы ещё не создали теги."
+  },
+  "tags": {
+    "addTag": "Добавить тег",
+    "clearTagFilter": "Сбросить фильтр",
+    "createTag": "Создать тег",
+    "currentTags": "Текущие теги",
+    "filterByTag": "Фильтр по тегу",
+    "manageAllTags": "Управлять всеми тегами",
+    "noAvailableTags": "Нет доступных тегов",
+    "noMatchingTags": "Нет подходящих тегов",
+    "noTags": "Нет тегов",
+    "removeTag": "Удалить тег",
+    "searchTags": "Поиск...",
+    "tagColor": "Цвет тега",
+    "tagName": "Название тега",
+    "title": "Теги"
+  },
+  "tagsModal": {
+    "addTags": "Добавить теги",
+    "currentTags": "Текущие теги",
+    "done": "Готово",
+    "noTagsAssigned": "К этой записи не назначены теги",
+    "searchTags": "Поиск тегов..."
+  },
+  "time": {
+    "dayAgo": "1 день назад",
+    "daysAgo": "{{count}} дней назад",
+    "hourAgo": "1 час назад",
+    "hoursAgo": "{{count}} часов назад",
+    "justNow": "Только что",
+    "minuteAgo": "1 минуту назад",
+    "minutesAgo": "{{count}} минут назад",
+    "monthAgo": "1 месяц назад",
+    "monthsAgo": "{{count}} месяцев назад",
+    "weekAgo": "1 неделю назад",
+    "weeksAgo": "{{count}} недель назад",
+    "yearAgo": "1 год назад",
+    "yearsAgo": "{{count}} лет назад"
+  },
+  "tooltips": {
+    "changeSpeaker": "Изменить спикера",
+    "clearChat": "Очистить чат",
+    "copyTranscript": "Копировать транскрипт",
+    "deleteTeam": "Удалить группу",
+    "doubleClickToEdit": "Двойной щелчок для редактирования",
+    "downloadTranscriptWithTemplate": "Скачать транскрипт с шаблоном",
+    "editTeam": "Редактировать группу",
+    "editText": "Редактировать текст",
+    "editTitle": "Редактировать заголовок",
+    "regenerateTitle": "Сгенерировать заголовок с помощью ИИ",
+    "assignFolder": "Назначить папку",
+    "discardIncognito": "Удалить запись инкогнито",
+    "editTranscript": "Редактировать транскрипт",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "Развернуть",
+    "followPlayerDisabled": "Включить автопрокрутку - транскрипт следует за воспроизведением аудио",
+    "followPlayerEnabled": "Отключить автопрокрутку - транскрипт остаётся на месте",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "Предоставить разрешение на публичный доступ",
+    "hideVideo": "Hide video",
+    "highlight": "Добавить в избранное",
+    "makeAdmin": "Сделать администратором",
+    "manageMembers": "Управлять участниками",
+    "manageTeamTags": "Управлять групповыми тегами",
+    "markAsRead": "Отметить как прочитанное",
+    "maximizeChat": "Развернуть чат",
+    "minimize": "Свернуть",
+    "moveToInbox": "Переместить во входящие",
+    "mute": "Без звука",
+    "pause": "Пауза",
+    "play": "Воспроизвести",
+    "playbackSpeed": "Скорость воспроизведения",
+    "removeAdmin": "Убрать права администратора",
+    "removeFromQueue": "Удалить из очереди",
+    "removeFromTeam": "Удалить из группы",
+    "removeHighlight": "Убрать из избранного",
+    "reprocessTranscription": "Перегенерировать транскрипцию",
+    "reprocessWithAsr": "Перегенерировать через ASR",
+    "restoreChat": "Восстановить чат",
+    "revokePublicSharing": "Отозвать разрешение на публичный доступ",
+    "shareWithUsers": "Поделиться с пользователями",
+    "showVideo": "Show video",
+    "switchToDarkMode": "Переключить на тёмную тему",
+    "switchToLightMode": "Переключить на светлую тему",
+    "unmute": "Включить звук"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "Доступные шаблоны",
+    "availableVars": "Доступные переменные",
+    "cancel": "Отмена",
+    "chooseTemplate": "Выберите шаблон...",
+    "createDefaults": "Создать стандартные шаблоны",
+    "createNew": "Создать шаблон",
+    "default": "По умолчанию",
+    "delete": "Удалить",
+    "description": "Настройте форматирование транскриптов для скачивания и экспорта.",
+    "downloadDefault": "Скачать с шаблоном по умолчанию",
+    "downloadWithoutTemplate": "Скачать без шаблона",
+    "filters": "Фильтры: |upper для верхнего регистра, |srt для формата временных меток субтитров",
+    "save": "Сохранить",
+    "selectOrCreate": "Выберите шаблон для редактирования или создайте новый",
+    "selectTemplate": "Выберите шаблон",
+    "setDefault": "Сделать шаблоном по умолчанию",
+    "tabTitle": "Транскрипт",
+    "template": "Шаблон",
+    "templateName": "Название шаблона",
+    "title": "Шаблоны транскриптов",
+    "viewGuide": "Посмотреть руководство по шаблонам"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "Автоопределение спикеров",
+    "bubble": "Пузыри",
+    "cancelEdit": "Отменить редактирование",
+    "copy": "Копировать",
+    "copyToClipboard": "Копировать в буфер обмена",
+    "download": "Скачать",
+    "downloadTranscript": "Скачать транскрипт",
+    "edit": "Редактировать",
+    "editSpeakers": "Редактировать спикеров",
+    "editTranscription": "Редактировать транскрипцию",
+    "highlightSearchResults": "Подсветить результаты поиска",
+    "noTranscription": "Транскрипция недоступна",
+    "regenerateTranscription": "Перегенерировать транскрипцию",
+    "saveTranscription": "Сохранить транскрипцию",
+    "searchInTranscript": "Поиск в транскрипте...",
+    "simple": "Простой",
+    "speaker": "Спикер {{number}}",
+    "speakerLabels": "Метки спикеров",
+    "title": "Транскрипция",
+    "unknownSpeaker": "Неизвестный спикер"
+  },
+  "upload": {
+    "chunking": "Большие файлы будут автоматически разделены на части для обработки",
+    "completed": "Завершено",
+    "copies": "копий этого файла",
+    "dropzone": "Перетащите аудиофайлы сюда или нажмите для выбора",
+    "duplicateDetected": "Этот файл является дубликатом \"{{existingName}}\" (загружен {{existingDate}})",
+    "duplicateFile": "Дубликат файла",
+    "failed": "Не удалось",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "Максимальный размер файла",
+    "queued": "В очереди",
+    "selectFiles": "Выбрать файлы",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "Резюмирование...",
+    "supportedFormats": "Поддерживаются форматы MP3, WAV, M4A, MP4, MOV, AVI, AMR и другие",
+    "title": "Загрузка аудио",
+    "transcribing": "Транскрибирование...",
+    "untitled": "Запись без названия",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "Прогресс загрузки",
+    "videoRetained": "Видео сохранено для воспроизведения",
+    "willAutoSummarize": "Автоматически создаст резюме после транскрибирования"
+  },
+  "uploadProgress": {
+    "title": "Прогресс загрузки"
+  },
+  "promptVariables": {
+    "title": "Переменные подсказки",
+    "infoTooltip": "О переменных подсказки",
+    "hintUpload": "Выбранный тег или папка использует подстановочные знаки. Заполните их, и они будут подставлены в подсказку для резюме этой записи. Пустые значения заменяются пустой строкой. До 8 000 символов на значение, 32 000 всего.",
+    "hintReprocess": "Эти значения подставляются в подстановочные знаки разрешённой подсказки. Правки сохраняются в записи. Пустые значения заменяются пустой строкой. До 8 000 символов на значение, 32 000 всего.",
+    "placeholderPrefix": "Введите"
+  },
+  "summaryMode": {
+    "applyMode": "Режим применения",
+    "append": "Добавить",
+    "appendHelp": "Использовать стандартную подсказку и добавить это в качестве дополнительного контекста.",
+    "replace": "Заменить",
+    "replaceHelp": "Использовать только этот текст в качестве инструкций для резюме."
+  },
+  "customizeSummary": {
+    "title": "Настроить подсказку резюме",
+    "body": "Добавьте разовый контекст для этого резюме или полностью замените разрешённую подсказку.",
+    "additionalContext": "Дополнительный контекст",
+    "customPrompt": "Своя подсказка",
+    "appendPlaceholder": "например, Сегодняшняя повестка: ...",
+    "replacePlaceholder": "Введите полную подсказку для резюме...",
+    "generateSummary": "Создать резюме"
+  },
+  "asrEditor": {
+    "saved": "Сохранено",
+    "ctrlSHint": "Ctrl+S для сохранения",
+    "saveWithoutClosing": "Сохранить без закрытия (Ctrl+S)"
+  },
+  "preview": {
+    "placeholderLegend": "Обозначения подстановок:",
+    "systemReplaced": "заменяется системой (текущая дата, транскрипция, имена тегов и т. д.)",
+    "userSupplied": "предоставляется пользователем при загрузке или повторной обработке",
+    "userMessageHeading": "Сообщение пользователя:",
+    "liveUpdateNote": "Раздел инструкций для резюме обновляется по мере редактирования вашей подсказки выше. Подстановочные знаки заменяются реальными значениями при обработке записи."
+  },
+  "preferences": {
+    "description": "Настройки отображения и поведения редактора. Эти параметры сохраняются в вашей учётной записи и применяются на всех устройствах.",
+    "editorAutosave": "Автосохранение в редакторе транскрипции",
+    "editorAutosaveHelp": "Когда включено, правки в редакторе транскрипции сохраняются автоматически через пару секунд после остановки ввода. По умолчанию выключено: сохранение явное через кнопки Сохранить или Ctrl+S.",
+    "showTimestampsSimpleView": "Показывать временные метки в простом виде",
+    "showTimestampsSimpleViewHelp": "Показывает компактную временную метку mm:ss рядом с именем каждого говорящего в простом виде. На пузырьковый вид не влияет.",
+    "transcriptDisplay": "Отображение транскрипции",
+    "transcriptEditor": "Редактор транскрипции"
+  }
+}
diff --git a/static/locales/zh.json b/static/locales/zh.json
new file mode 100644
index 00000000..dbf6ec12
--- /dev/null
+++ b/static/locales/zh.json
@@ -0,0 +1,1573 @@
+{
+  "aboutPage": {
+    "aiSummarization": "AI 摘要生成",
+    "aiSummarizationDesc": "集成 OpenRouter 和 Ollama，支持自定义提示词",
+    "asrEnabled": "ASR 已启用",
+    "asrEndpoint": "ASR 端点",
+    "audioTranscription": "音频转录",
+    "audioTranscriptionDesc": "支持 Whisper API 和自定义 ASR，准确率高",
+    "backend": "后端",
+    "database": "数据库",
+    "deployment": "部署",
+    "dockerDescription": "官方 Docker 镜像",
+    "dockerHub": "Docker Hub",
+    "documentation": "文档",
+    "documentationDescription": "设置指南和用户手册",
+    "endpoint": "端点",
+    "frontend": "前端",
+    "githubDescription": "源代码、问题和发布",
+    "githubRepository": "GitHub 仓库",
+    "inquireMode": "查询模式",
+    "inquireModeDesc": "在所有录音中进行语义搜索",
+    "interactiveChat": "交互式聊天",
+    "interactiveChatDesc": "使用 AI 与您的转录内容对话",
+    "keyFeatures": "主要功能",
+    "largeLanguageModel": "大语言模型",
+    "model": "模型",
+    "projectDescription": "通过 AI 驱动的转录、摘要和交互式聊天功能，将您的音频录音转换为有组织、可搜索的笔记。",
+    "projectLinks": "项目链接",
+    "sharingExport": "分享和导出",
+    "sharingExportDesc": "分享录音并导出为各种格式",
+    "speakerDiarization": "说话人分离",
+    "speakerDiarizationDesc": "自动识别和标记不同的说话人",
+    "speechRecognition": "语音识别",
+    "systemConfiguration": "系统配置",
+    "tagline": "AI 驱动的音频转录和笔记工具",
+    "technologyStack": "技术栈",
+    "title": "关于",
+    "version": "版本",
+    "whisperApi": "Whisper API"
+  },
+  "aboutPageDetails": {
+    "aiSummarizationDesc": "集成 OpenRouter 和 Ollama，支持自定义提示词",
+    "asrEnabled": "ASR 已启用",
+    "asrEndpoint": "ASR 端点",
+    "audioTranscriptionDesc": "支持 Whisper API 和自定义 ASR，准确率高",
+    "backend": "后端",
+    "database": "数据库",
+    "deployment": "部署",
+    "dockerDescription": "官方 Docker 镜像",
+    "documentationDescription": "设置指南和用户手册",
+    "endpoint": "端点",
+    "frontend": "前端",
+    "githubDescription": "源代码、问题和发布",
+    "inquireModeDesc": "在所有录音中进行语义搜索",
+    "interactiveChatDesc": "使用 AI 与您的转录内容对话",
+    "model": "模型",
+    "no": "否",
+    "sharingExportDesc": "分享录音并导出为各种格式",
+    "speakerDiarizationDesc": "自动识别和标记不同的说话人",
+    "whisperApi": "Whisper API",
+    "yes": "是"
+  },
+  "account": {
+    "accountActions": "账户操作",
+    "autoLabel": "Auto-label",
+    "autoSummarizationDisabled": "Auto-summarization disabled by admin",
+    "autoSummarize": "Auto-summarize",
+    "changePassword": "更改密码",
+    "chooseLanguageForInterface": "选择应用程序界面语言",
+    "companyOrganization": "公司/组织",
+    "completedRecordings": "已完成",
+    "defaultHotwords": "Default Hotwords",
+    "defaultHotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote, SDRs",
+    "defaultInitialPrompt": "Default Initial Prompt",
+    "defaultInitialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs.",
+    "email": "邮箱",
+    "failedRecordings": "失败",
+    "fullName": "全名",
+    "goToRecordings": "前往录音",
+    "interfaceLanguage": "界面语言",
+    "jobTitle": "职位",
+    "languageForSummaries": "标题、摘要和聊天的语言。留空使用默认值（您所选模型的默认行为）",
+    "languagePreferences": "语言偏好",
+    "leaveBlankForAutoDetect": "留空以自动检测语言",
+    "manageSpeakers": "管理发言人",
+    "personalFolder": "Personal Folder (Not Associated with a Group)",
+    "personalInfo": "个人信息",
+    "personalTag": "Personal Tag (Not Associated with a Group)",
+    "preferredOutputLanguage": "聊天机器人和摘要的首选语言",
+    "processingRecordings": "处理中",
+    "saveAllPreferences": "保存所有偏好设置",
+    "ssoLinkAccount": "Link {{provider}} account",
+    "ssoLinked": "Linked",
+    "ssoNotLinked": "Not linked",
+    "ssoProvider": "Provider",
+    "ssoSetPasswordFirst": "To unlink SSO, you must first set a password.",
+    "ssoSubject": "Subject:",
+    "ssoUnlinkAccount": "Unlink {{provider}} account",
+    "ssoUnlinkConfirm": "Are you sure you want to unlink your SSO account? You will need to use your password to log in.",
+    "statistics": "账户统计",
+    "title": "账户信息",
+    "totalRecordings": "录音总数",
+    "transcriptionHints": "Transcription Hints",
+    "transcriptionHintsDesc": "These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.",
+    "transcriptionLanguage": "转录语言",
+    "userDetails": "用户详情",
+    "username": "用户名"
+  },
+  "accountTabs": {
+    "about": "关于",
+    "apiTokens": "API 令牌",
+    "customPrompts": "自定义提示",
+    "folderManagement": "文件夹管理",
+    "namingTemplates": "命名",
+    "promptOptions": "提示选项",
+    "sharedTranscripts": "共享转录",
+    "speakersManagement": "发言人管理",
+    "tagManagement": "标签管理",
+    "templates": "模板",
+    "transcriptTemplates": "转录模板",
+    "preferences": "偏好设置"
+  },
+  "admin": {
+    "title": "管理员",
+    "userMenu": "用户菜单"
+  },
+  "adminDashboard": {
+    "aboutInquireMode": "关于查询模式",
+    "actions": "操作",
+    "addNewUser": "添加新用户",
+    "addUser": "添加用户",
+    "additionalContext": "附加上下文",
+    "admin": "管理员",
+    "adminDefaultPrompt": "管理员默认提示",
+    "adminDefaultPromptDesc": "上面配置的提示（显示在此页面）",
+    "adminUser": "管理员用户",
+    "allRecordingsProcessed": "所有录音已处理完成！",
+    "allowed": "Allowed",
+    "available": "可用",
+    "blocked": "已阻止",
+    "budgetWarnings": "预算警告",
+    "characters": "字符",
+    "chunkSize": "块大小",
+    "complete": "完成",
+    "completedRecordings": "已完成",
+    "confirmPasswordLabel": "确认密码",
+    "contextNotes": {
+      "jsonConversion": "JSON 转录在发送前会转换为纯文本格式",
+      "modelConfig": "使用的模型通过 TEXT_MODEL_NAME 环境变量配置",
+      "tagPrompts": "如果存在多个标签提示，它们将按添加标签的顺序合并",
+      "transcriptLimit": "转录限制为可配置的字符数（默认：30,000）"
+    },
+    "createFirstGroup": "Create Your First Group",
+    "created": "Created",
+    "currentUsage": "当前使用量",
+    "currentUsageMinutes": "当前使用量",
+    "defaultPromptInfo": "此默认提示将用于所有未在账户设置中设置自定义提示的用户。",
+    "defaultPrompts": "默认提示",
+    "defaultSummarizationPrompt": "默认摘要提示",
+    "description": "描述",
+    "editUser": "编辑用户",
+    "email": "邮箱",
+    "emailLabel": "邮箱",
+    "embeddingModel": "嵌入模型",
+    "embeddingsStatus": "嵌入状态",
+    "errors": {
+      "failedToLoadPrompt": "加载默认提示失败",
+      "failedToSavePrompt": "保存默认提示失败，请重试。",
+      "invalidFileSize": "请输入 1 到 10000 MB 之间的有效大小",
+      "invalidInteger": "请输入有效的整数",
+      "invalidNumber": "请输入有效的数字",
+      "maxTimeout": "超时不能超过 10 小时（36000 秒）",
+      "minCharacters": "请输入至少 1000 个字符",
+      "minTimeout": "超时必须至少为 60 秒"
+    },
+    "failedRecordings": "失败",
+    "groupName": "Group Name",
+    "groupsTab": "Groups",
+    "id": "ID",
+    "inquireModeDescription": "查询模式允许用户使用自然语言问题搜索多个转录。它通过将转录分成块并使用 AI 模型创建可搜索的嵌入来工作。",
+    "languagePreferenceNote": "注意：如果用户设置了输出语言偏好，将添加\"确保您的回复使用 {language}\"。",
+    "lastUpdated": "最后更新",
+    "maxFileSizeHelp": "最大文件大小（兆字节）（1-10000 MB）",
+    "megabytes": "MB",
+    "members": "Members",
+    "membersCount": "members",
+    "minutes": "分钟",
+    "monthlyCost": "月度成本",
+    "monthlyTokenBudget": "每月令牌预算",
+    "monthlyTranscriptionBudget": "每月转录预算（分钟）",
+    "needProcessing": "需要处理",
+    "never": "从未",
+    "newPasswordLabel": "新密码（留空保持不变）",
+    "no": "否",
+    "noData": "无数据",
+    "noDescription": "No description",
+    "noDescriptionAvailable": "无描述",
+    "noGroupsAdmin": "You are not an admin of any groups yet",
+    "noGroupsCreated": "No groups created yet",
+    "noLimit": "无限制",
+    "noMembersYet": "No members yet",
+    "noTranscriptionData": "暂无转录使用数据",
+    "none": "无",
+    "notSet": "未设置",
+    "overlap": "重叠",
+    "passwordLabel": "密码",
+    "passwordsDoNotMatch": "Passwords do not match",
+    "pendingRecordings": "待处理",
+    "percentUsed": "已使用",
+    "placeholdersNote": "处理录音时，占位符会被实际值替换。",
+    "processAllRecordings": "处理所有录音",
+    "processNext10": "处理接下来的 10 个",
+    "processedForInquire": "已为查询处理",
+    "processing": "处理中...",
+    "processingActions": "处理操作",
+    "processingProgress": "处理进度",
+    "processingRecordings": "处理中",
+    "promptDescription": "当用户未设置自己的提示时，此提示将用于生成所有录音的摘要。",
+    "promptHierarchy": "提示优先级",
+    "promptPriorityDescription": "系统在选择使用哪个提示时使用以下优先级顺序：",
+    "promptResetMessage": "提示已重置为系统默认值。点击\"保存更改\"应用。",
+    "promptSavedSuccessfully": "默认提示保存成功！",
+    "publicShare": "Public Share",
+    "recordingStatusDistribution": "录音状态分布",
+    "recordings": "录音",
+    "recordingsNeedProcessing": "{{count}} 个录音需要处理",
+    "refreshStatus": "刷新状态",
+    "resetToDefault": "重置为默认",
+    "saving": "保存中...",
+    "searchUsers": "搜索用户...",
+    "seconds": "秒",
+    "settings": {
+      "asrTimeoutDesc": "等待 ASR 转录完成的最大时间（秒）。默认为 1800 秒（30 分钟）。",
+      "defaultSummaryPromptDesc": "用户未设置自己的提示时使用的默认摘要提示。这作为所有用户的基础提示。",
+      "maxFileSizeDesc": "允许的音频上传最大文件大小（兆字节）。",
+      "recordingDisclaimerDesc": "录音开始前向用户显示的法律免责声明。支持 Markdown 格式。留空以禁用。",
+      "uploadDisclaimerDesc": "文件上传前显示的法律免责声明。支持 Markdown。留空以禁用。",
+      "customBannerDesc": "页面顶部显示的自定义横幅。支持 Markdown。留空以禁用。",
+      "transcriptLengthLimitDesc": "从转录发送到 LLM 进行摘要和聊天的最大字符数。使用 -1 表示无限制。"
+    },
+    "storageUsed": "已用存储",
+    "summarizationInstructions": "摘要说明",
+    "systemFallback": "系统回退",
+    "systemFallbackDesc": "如果以上都未设置，则使用硬编码默认值",
+    "systemPrompt": "系统提示",
+    "systemSettings": "系统设置",
+    "systemStatistics": "系统统计",
+    "tagCustomPrompt": "标签自定义提示",
+    "tagCustomPromptDesc": "如果录音有带自定义提示的标签",
+    "textSearchOnly": "仅文本搜索",
+    "thisMonth": "本月",
+    "timeoutRecommendation": "推荐：长音频文件使用 30-120 分钟",
+    "title": "管理仪表板",
+    "todaysMinutes": "今日分钟数",
+    "tokenBudgetExceeded": "每月令牌预算已超出。请联系您的管理员。",
+    "tokenBudgetHelp": "设置 AI 功能的每月令牌限制。留空表示无限制。",
+    "tokenBudgetPlaceholder": "留空表示无限制",
+    "tokenUsage": "令牌使用量",
+    "tokens": "令牌",
+    "topUsers": "顶级用户",
+    "topUsersByStorage": "按存储排序的顶级用户",
+    "total": "总计",
+    "totalChunks": "总块数",
+    "totalQueries": "总查询数",
+    "totalRecordings": "总录音数",
+    "totalStorage": "总存储",
+    "totalUsers": "总用户数",
+    "transcriptionBudgetHelp": "限制每月转录分钟数。留空表示无限制。",
+    "transcriptionBudgetPlaceholder": "留空表示无限制",
+    "transcriptionUsage": "转录使用情况",
+    "updateUser": "更新用户",
+    "userCustomPrompt": "用户自定义提示",
+    "userCustomPromptDesc": "如果用户在账户设置中设置了自己的提示",
+    "userManagement": "用户管理",
+    "userMessageTemplate": "用户消息模板",
+    "userTranscriptionUsage": "用户转录使用情况（本月）",
+    "username": "用户名",
+    "usernameLabel": "用户名",
+    "vectorDimensions": "向量维度",
+    "vectorStore": "向量存储",
+    "vectorStoreManagement": "向量存储管理",
+    "vectorStoreUpToDate": "向量存储是最新的",
+    "viewFullPromptStructure": "查看完整的 LLM 提示结构",
+    "warning": "警告",
+    "yes": "是"
+  },
+  "apiTokens": {
+    "activeTokens": "活跃令牌",
+    "createFirstToken": "创建您的第一个 API 令牌以启用编程访问",
+    "createToken": "创建令牌",
+    "created": "创建于",
+    "description": "创建和管理 API 令牌以编程方式访问您的账户",
+    "expires": "过期时间",
+    "lastUsed": "最后使用",
+    "neverUsed": "从未使用",
+    "noExpiration": "永不过期",
+    "noTokens": "没有 API 令牌",
+    "securityNotice": "安全提示",
+    "securityWarning": "请像密码一样对待 API 令牌。它们提供对您账户的完全访问权限。切勿在公共区域分享令牌",
+    "title": "API 令牌",
+    "usageExamples": "使用示例"
+  },
+  "buttons": {
+    "addSegment": "添加片段",
+    "addSpeaker": "添加发言人",
+    "cancel": "取消",
+    "clearAllFilters": "清除所有筛选",
+    "clearCompleted": "清除已完成的上传",
+    "clearSearchText": "清除搜索文本",
+    "close": "关闭",
+    "copy": "复制",
+    "copyMessage": "复制消息",
+    "copyNotes": "复制笔记",
+    "copySummary": "复制摘要",
+    "copyToClipboard": "复制到剪贴板",
+    "createTag": "创建标签",
+    "deleteAll": "删除全部",
+    "deleteSpeaker": "删除发言人",
+    "deleteTag": "删除标签",
+    "deleteUser": "删除用户",
+    "downloadAsWord": "下载为Word文档",
+    "downloadAudio": "下载音频",
+    "downloadChat": "下载聊天记录为Word文档",
+    "downloadNotes": "下载笔记为Word文档",
+    "downloadSummary": "下载摘要为Word文档",
+    "editNotes": "编辑笔记",
+    "editSetting": "编辑设置",
+    "editSpeakers": "编辑发言人...",
+    "editSummary": "编辑摘要",
+    "editTag": "编辑标签",
+    "editTags": "编辑标签",
+    "editTranscription": "编辑转录",
+    "editUser": "编辑用户",
+    "exportCalendar": "导出到日历",
+    "help": "帮助",
+    "identifySpeakers": "识别发言人",
+    "next": "下一个",
+    "previous": "上一个",
+    "refresh": "刷新",
+    "reprocessSummary": "重新处理摘要",
+    "reprocessTranscription": "重新处理转录",
+    "reprocessWithAsr": "使用ASR重新处理",
+    "resetStuckProcessing": "重置卡住的处理",
+    "saveChanges": "保存更改",
+    "saveCustomPrompt": "保存自定义提示",
+    "saveNames": "保存名称",
+    "saveSettings": "保存设置",
+    "shareRecording": "分享录音",
+    "toggleTheme": "切换主题",
+    "updateTag": "更新标签"
+  },
+  "changePasswordModal": {
+    "confirmPassword": "确认新密码",
+    "currentPassword": "当前密码",
+    "newPassword": "新密码",
+    "passwordRequirement": "密码必须至少 8 个字符",
+    "title": "更改密码"
+  },
+  "chat": {
+    "availableAfterTranscription": "转录完成后聊天功能将可用",
+    "cannotChatTranscriptionFailed": "Cannot chat: transcription failed. Please reprocess the transcription first.",
+    "chatWithTranscription": "与转录内容对话",
+    "clearChat": "清除聊天",
+    "cleared": "Chat cleared",
+    "downloadFailed": "Failed to download chat",
+    "downloadSuccess": "Chat downloaded successfully!",
+    "error": "发送消息失败",
+    "noMessages": "暂无消息",
+    "noMessagesToDownload": "No chat messages to download.",
+    "placeholder": "询问有关此录音的问题...",
+    "placeholderWithHint": "询问有关此录音的问题...（按回车发送，Ctrl+回车换行）",
+    "send": "发送",
+    "suggestedQuestions": "建议问题",
+    "thinking": "思考中...",
+    "title": "聊天",
+    "whatAreActionItems": "有哪些行动项？",
+    "whatAreKeyPoints": "关键要点是什么？",
+    "whatWasDiscussed": "讨论了什么？",
+    "whoSaidWhat": "谁说了什么？"
+  },
+  "colorScheme": {
+    "chooseRecording": "从侧边栏选择一个录音以查看其转录和摘要",
+    "darkThemes": "深色主题",
+    "descriptions": {
+      "blue": "Classic blue theme with a clean, professional feel",
+      "emerald": "Nature-inspired green theme for a calming experience",
+      "purple": "Rich purple theme with an elegant, modern look",
+      "rose": "Warm rose theme with a soft, inviting aesthetic",
+      "amber": "Warm amber tones for a cozy, productive feel",
+      "teal": "Cool teal theme with a refreshing, modern vibe"
+    },
+    "lightThemes": "浅色主题",
+    "names": {
+      "blue": "Ocean Blue",
+      "emerald": "Forest Green",
+      "purple": "Royal Purple",
+      "rose": "Coral Rose",
+      "amber": "Golden Amber",
+      "teal": "Arctic Teal"
+    },
+    "resetToDefault": "重置为默认",
+    "selectRecording": "选择录音",
+    "subtitle": "使用美观的颜色主题自定义您的界面",
+    "themes": {
+      "light": {
+        "blue": {
+          "name": "海洋蓝",
+          "description": "专业风格的经典蓝色主题"
+        },
+        "emerald": {
+          "name": "森林翠绿",
+          "description": "清新自然的绿色主题"
+        },
+        "purple": {
+          "name": "皇家紫",
+          "description": "优雅精致的紫色主题"
+        },
+        "rose": {
+          "name": "日落玫瑰",
+          "description": "温暖柔和的粉色主题"
+        },
+        "amber": {
+          "name": "金色琥珀",
+          "description": "明亮温暖的黄色主题"
+        },
+        "teal": {
+          "name": "海洋青",
+          "description": "清凉宁静的青色主题"
+        }
+      },
+      "dark": {
+        "blue": {
+          "name": "午夜蓝",
+          "description": "专注工作的深蓝主题"
+        },
+        "emerald": {
+          "name": "暗夜森林",
+          "description": "舒适观看的浓绿主题"
+        },
+        "purple": {
+          "name": "深紫",
+          "description": "激发创意的神秘紫色主题"
+        },
+        "rose": {
+          "name": "暗玫瑰",
+          "description": "微妙温暖的柔粉主题"
+        },
+        "amber": {
+          "name": "暗琥珀",
+          "description": "舒适温馨的棕色主题"
+        },
+        "teal": {
+          "name": "深青",
+          "description": "平静专注的深青主题"
+        }
+      }
+    },
+    "title": "选择配色方案"
+  },
+  "common": {
+    "back": "返回",
+    "cancel": "取消",
+    "changesSaved": "更改已保存",
+    "close": "关闭",
+    "confirm": "确认",
+    "delete": "删除",
+    "deselectAll": "取消全选",
+    "download": "下载",
+    "edit": "编辑",
+    "error": "错误",
+    "failed": "失败",
+    "filter": "筛选",
+    "info": "信息",
+    "loading": "加载中...",
+    "new": "新建",
+    "next": "下一步",
+    "no": "否",
+    "noResults": "未找到结果",
+    "ok": "确定",
+    "or": "或",
+    "previous": "上一步",
+    "processing": "处理中...",
+    "refresh": "刷新",
+    "retry": "重试",
+    "save": "保存",
+    "search": "搜索",
+    "selectAll": "全选",
+    "sort": "排序",
+    "success": "成功",
+    "untitled": "无标题",
+    "upload": "上传",
+    "warning": "警告",
+    "yes": "是"
+  },
+  "customPrompts": {
+    "currentDefaultPrompt": "当前默认提示（如果上面留空则使用此提示）",
+    "promptDescription": "此提示将用于生成转录的摘要。它将覆盖管理员的默认提示。",
+    "promptPlaceholder": "描述您希望摘要的结构。留空以使用管理员的默认提示。",
+    "summaryGeneration": "摘要生成提示",
+    "tip1": "具体说明您希望在摘要中包含的部分",
+    "tip2": "使用清晰的格式说明（例如，\"使用项目符号\"，\"创建编号列表\"）",
+    "tip3": "指定您是否希望优先处理某些信息",
+    "tip4": "系统将自动向 AI 提供转录内容",
+    "tip5": "您的输出语言偏好（如果设置）将自动应用",
+    "tipsTitle": "编写有效提示的技巧",
+    "yourCustomPrompt": "您的自定义摘要提示"
+  },
+  "deleteAllSpeakersModal": {
+    "confirmMessage": "您确定要删除所有保存的发言人吗？此操作无法撤销。",
+    "title": "删除所有发言人"
+  },
+  "dialogs": {
+    "deleteRecording": {
+      "cancel": "取消",
+      "confirm": "删除",
+      "message": "您确定要删除此录音吗？此操作无法撤销。",
+      "title": "删除录音"
+    },
+    "deleteShare": {
+      "message": "您确定要删除此共享吗？这将撤销对公共链接的访问。",
+      "title": "删除共享"
+    },
+    "reprocessTranscription": {
+      "cancel": "取消",
+      "confirm": "重新处理",
+      "message": "您确定要重新处理此转录吗？当前转录将被替换。",
+      "title": "重新处理转录"
+    },
+    "unsavedChanges": {
+      "cancel": "取消",
+      "discard": "放弃",
+      "message": "您有未保存的更改。在离开之前是否要保存？",
+      "save": "保存",
+      "title": "未保存的更改"
+    }
+  },
+  "duration": {
+    "hours": "{{count}} 小时",
+    "hoursPlural": "{{count}} 小时",
+    "minutes": "{{count}} 分钟",
+    "minutesPlural": "{{count}} 分钟",
+    "seconds": "{{count}} 秒",
+    "secondsPlural": "{{count}} 秒"
+  },
+  "editTagModal": {
+    "asrDefaultSettings": "ASR 默认设置",
+    "asrSettingsDescription": "使用此标签进行 ASR 转录时，这些设置将默认应用",
+    "color": "颜色",
+    "colorDescription": "选择颜色以便识别",
+    "createTitle": "创建标签",
+    "customPrompt": "自定义摘要提示",
+    "customPromptPlaceholder": "可选：为带有此标签的录音生成摘要的自定义提示",
+    "defaultLanguage": "默认语言",
+    "defaultPromptPlaceholder": "Leer lassen, um Ihren Standard-Zusammenfassungs-Prompt zu verwenden",
+    "exportTemplate": "导出模板",
+    "exportTemplateHint": "选择导出带有此标签的录音时使用的导出模板",
+    "leaveBlankPrompt": "留空以使用您的默认摘要提示",
+    "maxSpeakers": "最大发言人数",
+    "minSpeakers": "最小发言人数",
+    "namingTemplate": "命名模板",
+    "namingTemplateHint": "选择命名模板以自动格式化带有此标签的录音标题",
+    "noExportTemplate": "无模板（使用用户默认）",
+    "noNamingTemplate": "无模板（使用用户默认或 AI 标题）",
+    "tagName": "标签名称 *",
+    "tagNamePlaceholder": "例如，会议、访谈",
+    "title": "编辑标签",
+    "watchFolder": "Watch Folder",
+    "watchFolderPath": "Drop files in:",
+    "watchFolderGroupTagError": "Watch folders are not available for group tags",
+    "watchFolderCreated": "Watch folder created",
+    "watchFolderRemoved": "Watch folder removed",
+    "watchFolderError": "Could not create watch folder",
+    "watchFolderVariableWarning": "此标签被配置为监视文件夹，且提示中包含占位符变量。通过自动处理目录摄入的录音没有界面让用户填写这些值，因此首次生成摘要时占位符将被替换为空字符串。请删除占位符，或在上传后通过重新处理填写值。"
+  },
+  "errors": {
+    "audioExtractionFailed": "Audio Extraction Failed",
+    "audioExtractionFailedGuidance": "Try converting the file to a standard audio format (MP3, WAV) before uploading.",
+    "audioExtractionFailedMessage": "Could not extract audio from the uploaded file.",
+    "audioRecordingFailed": "音频录制失败。请检查您的麦克风。",
+    "authenticationError": "Authentication Error",
+    "authenticationErrorGuidance": "Please check that the API key is correct and has not expired.",
+    "authenticationErrorMessage": "The transcription service rejected the API credentials.",
+    "checkApiKeyGuidance": "Check the API key in settings",
+    "checkNetworkGuidance": "Check network connection",
+    "connectionError": "Connection Error",
+    "connectionErrorGuidance": "Check your internet connection and ensure the service is available.",
+    "connectionErrorMessage": "Could not connect to the transcription service.",
+    "convertFormatGuidance": "Convert to MP3 or WAV before uploading",
+    "convertStandardGuidance": "Convert to standard audio format",
+    "enableChunkingGuidance": "Enable chunking in settings or compress the file",
+    "fallbackMessage": "An error occurred",
+    "fallbackTitle": "Error",
+    "fileTooLarge": "文件太大",
+    "fileTooLargeGuidance": "Try enabling audio chunking in your settings, or compress the audio file before uploading.",
+    "fileTooLargeMaxSize": "File too large. Max: {{size}} MB.",
+    "fileTooLargeMessage": "The audio file exceeds the maximum size allowed by the transcription service.",
+    "fileTooLargeTitle": "File Too Large",
+    "generic": "发生错误",
+    "invalidAudioFormat": "Invalid Audio Format",
+    "invalidAudioFormatGuidance": "Try converting the audio to MP3 or WAV format before uploading.",
+    "invalidAudioFormatMessage": "The audio file format is not supported or the file may be corrupted.",
+    "loadingShares": "加载共享时出错",
+    "networkError": "网络错误。请检查您的连接。",
+    "networkErrorDuringUpload": "Network error during upload",
+    "notFound": "未找到",
+    "permissionDenied": "权限被拒绝",
+    "processingError": "Processing Error",
+    "processingErrorFallbackGuidance": "Try reprocessing the recording",
+    "processingErrorGuidance": "If this error persists, try reprocessing the recording.",
+    "processingErrorMessage": "An error occurred during processing.",
+    "processingFailedOnServer": "Processing failed on server.",
+    "processingFailedWithStatus": "Processing failed with status {{status}}",
+    "processingTimeout": "Processing Timeout",
+    "processingTimeoutGuidance": "This can happen with very long recordings. Try splitting the audio into smaller parts.",
+    "processingTimeoutMessage": "The transcription took too long to complete.",
+    "quotaExceeded": "存储配额已超出",
+    "rateLimitExceeded": "Rate Limit Exceeded",
+    "rateLimitExceededGuidance": "Please wait a few minutes and try reprocessing.",
+    "rateLimitExceededMessage": "Too many requests were sent to the transcription service.",
+    "serverError": "服务器错误。请稍后重试。",
+    "serverErrorStatus": "Server error ({{status}})",
+    "serviceUnavailable": "Service Unavailable",
+    "serviceUnavailableGuidance": "This is usually temporary. Please try again in a few minutes.",
+    "serviceUnavailableMessage": "The transcription service is temporarily unavailable.",
+    "splitAudioGuidance": "Try splitting the audio into smaller parts",
+    "summaryFailed": "摘要生成失败。请重试。",
+    "transcriptionFailed": "转录失败。请重试。",
+    "tryAgainLaterGuidance": "Try again in a few minutes",
+    "unauthorized": "未授权",
+    "unexpectedResponse": "Unexpected success response from server after upload.",
+    "unsupportedFormat": "不支持的文件格式",
+    "uploadFailed": "上传失败。请重试。",
+    "uploadFailedWithStatus": "Upload failed with status {{status}}",
+    "uploadTimedOut": "Upload timed out",
+    "validationError": "验证错误",
+    "waitAndRetryGuidance": "Wait a few minutes and try again"
+  },
+  "eventExtraction": {
+    "description": "启用后，AI将识别录音中提到的会议、约会和截止日期，并创建可下载的日历事件。",
+    "enableLabel": "启用从转录中自动提取事件",
+    "info": "提取的事件将显示在检测到日历项目的录音的\"事件\"选项卡中。",
+    "title": "事件提取"
+  },
+  "events": {
+    "add": "添加",
+    "addToCalendar": "添加到日历",
+    "attendees": "参与者",
+    "confirmDelete": "删除事件“{title}”？",
+    "delete": "删除",
+    "deleteFailed": "删除事件失败",
+    "deleted": "事件已删除",
+    "end": "结束",
+    "location": "地点",
+    "noEvents": "此录音中未检测到事件",
+    "start": "开始",
+    "title": "事件"
+  },
+  "exportLabels": {
+    "created": "创建时间",
+    "date": "日期",
+    "fileSize": "文件大小",
+    "footer": "由 [Speakr](https://github.com/learnedmachine/speakr) 生成",
+    "metadata": "元数据",
+    "notes": "笔记",
+    "originalFile": "原始文件",
+    "participants": "参与者",
+    "summarizationTime": "摘要时间",
+    "summary": "摘要",
+    "tags": "标签",
+    "transcription": "转录",
+    "transcriptionTime": "转录时间"
+  },
+  "exportTemplates": {
+    "availableLabels": "本地化标签（自动翻译）",
+    "availableTemplates": "可用模板",
+    "availableVars": "可用变量",
+    "cancel": "取消",
+    "conditionals": "条件",
+    "conditionalsHint": "使用 {{#if variable}}...{{/if}} 来有条件地包含内容",
+    "contentSections": "内容部分",
+    "createDefaults": "创建默认模板",
+    "createNew": "创建模板",
+    "default": "默认",
+    "delete": "删除",
+    "description": "自定义录音导出为 markdown 文件的方式。",
+    "recordingData": "录音数据",
+    "save": "保存",
+    "selectOrCreate": "选择一个模板进行编辑或创建新模板",
+    "setDefault": "设为默认模板",
+    "tabTitle": "导出",
+    "template": "模板",
+    "templateDescription": "描述",
+    "templateName": "模板名称",
+    "title": "导出模板",
+    "viewGuide": "查看模板指南"
+  },
+  "fileSize": {
+    "bytes": "{{count}} B",
+    "gigabytes": "{{count}} GB",
+    "kilobytes": "{{count}} KB",
+    "megabytes": "{{count}} MB"
+  },
+  "folderManagement": {
+    "allFolders": "所有文件夹",
+    "asrDefaults": "ASR 默认设置",
+    "autoShareOnApply": "自动与群组成员共享",
+    "autoShareOnApplyHelp": "添加到此文件夹时自动与所有群组成员共享录音",
+    "confirmDelete": "确定要删除此文件夹吗？录音将从文件夹中移除但不会被删除。",
+    "createFolder": "创建文件夹",
+    "customPrompt": "自定义提示词",
+    "defaultLanguage": "默认语言",
+    "deleteFolder": "删除文件夹",
+    "description": "将录音整理到文件夹中。与标签不同，录音只能属于一个文件夹。文件夹提示词在用户提示词之前、标签提示词之后应用。",
+    "editFolder": "编辑文件夹",
+    "filterByFolder": "按文件夹筛选",
+    "folderColor": "文件夹颜色",
+    "folderName": "文件夹名称",
+    "groupSettings": "群组设置",
+    "maxSpeakers": "最大发言人数",
+    "minSpeakers": "最小发言人数",
+    "moveToFolder": "移动到文件夹",
+    "namingTemplate": "命名模板",
+    "noFolder": "无文件夹",
+    "noFolders": "尚未创建文件夹",
+    "noFoldersDescription": "创建您的第一个文件夹来整理录音",
+    "protectFromDeletion": "防止删除",
+    "protectFromDeletionHelp": "保护此文件夹中的录音不被自动删除",
+    "recordings": "录音",
+    "removeFromFolder": "从文件夹中移除",
+    "retentionDays": "保留天数",
+    "retentionDaysHelp": "此文件夹中的录音将在指定天数后删除。留空使用全局保留设置。",
+    "retentionSettings": "保留设置",
+    "selectNamingTemplate": "选择命名模板...",
+    "shareWithGroupLead": "与群组管理员共享",
+    "shareWithGroupLeadHelp": "添加到此文件夹时与群组管理员共享录音",
+    "title": "文件夹管理"
+  },
+  "form": {
+    "auto": "自动",
+    "autoDetect": "自动检测",
+    "dateFrom": "从",
+    "dateTo": "至",
+    "enterNotesMarkdown": "以Markdown格式输入笔记...",
+    "enterSummaryMarkdown": "以Markdown格式输入摘要...",
+    "folder": "Folder",
+    "hotwords": "Hotwords",
+    "hotwordsHelp": "Comma-separated words to improve recognition of domain-specific terms",
+    "hotwordsPlaceholder": "e.g., Speakr, CTranslate2, PyAnnote",
+    "initialPrompt": "Initial Prompt",
+    "initialPromptHelp": "Context to steer the transcription model's style and vocabulary",
+    "initialPromptPlaceholder": "e.g., This is a meeting about AI transcription tools.",
+    "language": "语言",
+    "maxSpeakers": "最多发言人数",
+    "meetingDate": "会议日期",
+    "minSpeakers": "最少发言人数",
+    "minutes": "分钟",
+    "notes": "笔记",
+    "notesPlaceholder": "以Markdown格式输入您的笔记...",
+    "optional": "可选",
+    "participantNamePlaceholder": "Participant name...",
+    "participants": "参与者",
+    "placeholderAuto": "自动",
+    "placeholderCharacterLimit": "输入字符限制（例如：30000）",
+    "placeholderMinutes": "分钟",
+    "placeholderOptional": "可选",
+    "placeholderSeconds": "秒",
+    "placeholderSizeMB": "输入大小（MB）",
+    "searchSpeakers": "搜索发言人...",
+    "searchTags": "搜索标签...",
+    "seconds": "秒",
+    "shareNotes": "分享笔记",
+    "shareSummary": "分享摘要",
+    "shareableLink": "可分享链接",
+    "summaryPromptPlaceholder": "输入默认摘要提示...",
+    "title": "标题",
+    "transcriptionLanguage": "Transcription Language",
+    "yourFullName": "您的全名",
+    "transcriptionModel": "转录模型",
+    "useResolvedDefault": "（使用标签/文件夹/全局默认）",
+    "defaultTranscriptionModel": "默认转录模型",
+    "defaultTranscriptionModelHelp": "覆盖此标签或文件夹下录音所使用的转录模型。"
+  },
+  "groups": {
+    "addMembers": "添加成员...",
+    "autoShare": "自动分享",
+    "autoShareNote": "注意：如果两者都启用，所有团队成员都将有访问权限。如果只启用\"团队管理员\"，则只有团队负责人有访问权限。",
+    "autoShareTeam": "应用此标签时自动与所有团队成员分享录音",
+    "autoSharesWithTeam": "自动与所有团队成员分享",
+    "confirmDelete": "确定要删除此团队吗？此操作无法撤销。",
+    "createTeam": "创建团队",
+    "createTeamTag": "创建新团队标签",
+    "dayRetention": "天保留期限",
+    "deleteTeam": "删除团队",
+    "deletionExempt": "免于删除",
+    "deletionExemptHelp": "带有此标签的录音将免于自动删除，即使超过保留期限。",
+    "editTeam": "编辑团队",
+    "editTeamTag": "编辑团队标签",
+    "globalRetention": "全局保留期限",
+    "members": "成员",
+    "noMembers": "此团队暂无成员",
+    "noTeamTags": "尚未创建团队标签",
+    "noTeams": "尚未创建团队",
+    "retentionHelp": "带有此标签的录音将在此天数后删除。留空则使用全局保留期限（{{days}}天）。",
+    "retentionPeriod": "保留期限（天）",
+    "retentionPlaceholder": "留空则使用全局保留期限",
+    "searchUsers": "搜索用户...",
+    "selectTeamLead": "选择团队负责人...",
+    "shareWithAdmins": "应用此标签时与团队管理员分享录音",
+    "sharesWithAdminsOnly": "仅与团队管理员分享",
+    "syncComplete": "团队分享同步成功",
+    "syncTeamShares": "同步团队分享",
+    "syncTeamSharesDescription": "这将根据标签的分享设置，追溯性地将所有带有团队标签的录音分享给相应的团队成员。",
+    "teamLead": "团队负责人",
+    "teamName": "团队名称",
+    "teamNamePlaceholder": "输入团队名称",
+    "teamTags": "团队标签",
+    "title": "群组管理",
+    "updateTeam": "更新团队"
+  },
+  "help": {
+    "actions": "操作",
+    "activeFilters": "活动筛选器",
+    "addSegmentBelow": "在下方添加片段",
+    "advancedAsrOptions": "高级 ASR 选项",
+    "allRecordingsLoaded": "已加载所有录音",
+    "allTagsSelected": "All tags selected",
+    "appliedSuggestedNames": "已应用 {{count}} 个建议名称",
+    "appliedSuggestedNamesPlural": "已应用 {{count}} 个建议名称",
+    "applySuggested": "应用建议",
+    "applySuggestedMobile": "建议",
+    "approachingLimit": "接近 {{limit}}MB 限制",
+    "askAboutTranscription": "询问有关此转录的问题",
+    "audioDeletedDescription": "此录音的音频文件已被删除，但转录内容仍然可用。",
+    "audioDeletedMessage": "音频文件已归档，无法播放。",
+    "audioDeletedTitle": "音频文件已删除",
+    "audioPlayer": "音频播放器",
+    "autoIdentify": "自动识别",
+    "autoIdentifyMobile": "自动",
+    "bothAudioDesc": "录制您的声音 + 会议参与者（推荐用于在线会议）",
+    "clearFilters": "清除筛选",
+    "clickToAddNotes": "点击添加笔记...",
+    "colorRepeats": "颜色从发言人 {{number}} 开始重复",
+    "completedFiles": "已完成文件",
+    "confirmReprocessingTitle": "确认重新处理",
+    "copyMessage": "复制消息",
+    "createFolders": "Create folders",
+    "createPublicLink": "创建公共链接以分享此录音。分享仅在安全（HTTPS）连接上可用。",
+    "createTags": "创建标签",
+    "defaultHotwordsHelp": "Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).",
+    "defaultInitialPromptHelp": "Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.",
+    "deleteSegment": "删除片段",
+    "discard": "放弃",
+    "dragToReorder": "Drag to reorder",
+    "endTime": "结束",
+    "enterNameFor": "输入名称",
+    "enterSpeakerName": "输入发言人姓名...",
+    "entireScreen": "整个屏幕",
+    "errorChangingSpeaker": "更改发言人时出错",
+    "errorOpeningTextEditor": "打开文本编辑器时出错",
+    "errorSavingText": "保存文本时出错",
+    "estimatedSize": "预计大小",
+    "firstTagAsrSettings": "First tag's ASR settings will be applied:",
+    "firstTagDefaultsApplied": "First tag's defaults applied",
+    "folderHasCustomPrompt": "This folder has a custom summary prompt",
+    "generatingSummary": "生成摘要中...",
+    "groups": "组",
+    "howToRecordSystemAudio": "如何录制系统音频",
+    "identifyAllSpeakers": "识别所有发言人",
+    "identifying": "识别中...",
+    "importantNote": "重要提示",
+    "internalSharingDesc": "与您组织中的特定用户分享",
+    "lines": "{{count}} 行",
+    "loadingMore": "加载更多录音中...",
+    "loadingRecordings": "加载录音中...",
+    "me": "Me",
+    "microphoneDesc": "仅录制您的声音",
+    "modelReasoning": "模型推理",
+    "moreSpeakersThanColors": "发言人数超过可用颜色数",
+    "navigate": "导航",
+    "noDateSet": "未设置日期",
+    "noMatchingTags": "No matching tags",
+    "noParticipants": "无参与者",
+    "noRecordingSelected": "未选择录音。",
+    "noSpeakersIdentified": "无法从上下文中识别发言人。",
+    "noSuggestionsToApply": "没有可应用的建议",
+    "noTagsCreated": "尚未创建标签。",
+    "of": "/",
+    "playFromHere": "从此处播放",
+    "pleaseEnterSpeakerName": "请输入发言人名称",
+    "processingTime": "处理时间",
+    "processingTimeDescription": "这可能需要几分钟完成。处理期间您可以继续使用应用。",
+    "processingTranscription": "处理转录中...",
+    "publicLinkDesc": "任何拥有此链接的人都可以访问录音",
+    "recordSystemSteps1": "点击\"录制系统音频\"或\"录制两者\"。",
+    "recordSystemSteps2": "在弹出窗口中，选择",
+    "recordSystemSteps3": "确保勾选显示的框",
+    "recordingFinished": "录音完成",
+    "recordingInProgress": "录音进行中...",
+    "regenerateSummaryAfterNames": "更新名称后重新生成摘要",
+    "saved": "已保存！",
+    "savingProgress": "保存中...",
+    "selectedTagsCustomPrompts": "Selected tags include custom summary prompts",
+    "sentence": "句子",
+    "shareSystemAudio": "共享系统音频",
+    "shareTabAudio": "共享标签页音频",
+    "sharedOn": "共享于",
+    "sharingWindowNoAudio": "共享\"窗口\"不会捕获音频。",
+    "speakerAdded": "发言人添加成功",
+    "speakerCount": "发言人",
+    "speakerName": "发言人名称",
+    "speakerNamesUpdated": "发言人名称更新成功！",
+    "speakers": "发言人",
+    "speakersIdentified": "成功识别 {{count}} 位发言人！",
+    "speakersIdentifiedPlural": "成功识别 {{count}} 位发言人！",
+    "speakersUpdatedSaveToApply": "发言人已更新！保存转录以应用更改。",
+    "specificBrowserTab": "特定浏览器标签页",
+    "startTime": "开始",
+    "startingAutoIdentification": "正在启动自动发言人识别...",
+    "summaryGenerationFailed": "摘要生成失败",
+    "summaryGenerationTimedOut": "摘要生成超时",
+    "summaryRegenerationStarted": "摘要重新生成已开始",
+    "summaryUpdated": "摘要已更新！",
+    "systemAudioDesc": "录制会议参与者和系统声音",
+    "tagManagement": "标签管理",
+    "thisActionCannotBeUndone": "此操作无法撤销。",
+    "toCaptureAudioFromMeetings": "要从会议或其他应用捕获音频，您必须共享屏幕或浏览器标签页。",
+    "toOrganizeRecordings": "to organize your recordings",
+    "transcriptUpdated": "转录更新成功！",
+    "troubleshooting": "故障排除",
+    "tryAdjustingSearch": "尝试调整您的搜索或",
+    "unsupportedBrowser": "不支持的浏览器",
+    "untitled": "无标题录音",
+    "uploadRecordingNotes": "上传录音和笔记",
+    "whatWillHappen": "会发生什么？",
+    "whyNotWorking": "为什么不工作？",
+    "youHaveXSpeakers": "您有 {{count}} 位发言人，但只有16种独特的颜色可用。颜色将在第16位发言人之后重复。"
+  },
+  "incognito": {
+    "audioNotStored": "Audio not stored in incognito mode",
+    "discardConfirm": "This will permanently discard your incognito recording. Continue?",
+    "mode": "Incognito Mode",
+    "notSavedToAccount": "Not saved to account",
+    "oneFileAtATime": "Incognito mode supports one file at a time",
+    "processInIncognito": "Process in Incognito",
+    "processWithoutSaving": "Process without saving",
+    "processing": "Processing...",
+    "processingComplete": "Processing complete!",
+    "processingInProgress": "Processing in incognito mode...",
+    "recordingDiscarded": "Incognito recording discarded",
+    "recordingProcessed": "Incognito recording processed - data will be lost when tab closes",
+    "recordingReady": "Incognito recording ready!",
+    "recordingTitle": "Incognito Recording",
+    "selectExactlyOneFile": "Select exactly 1 file",
+    "sessionOnly": "Session only",
+    "uploadingFile": "Uploading file for incognito processing..."
+  },
+  "inquire": {
+    "activeFilters": "活动筛选器：",
+    "askQuestions": "询问您的转录内容",
+    "clearAll": "清除全部",
+    "dateRange": "日期范围",
+    "dateRangeActive": "日期范围已激活",
+    "exampleQuestion1": "\"讨论了哪些行动项目？\"",
+    "exampleQuestion2": "\"我们什么时候决定更改时间表？\"",
+    "exampleQuestion3": "\"对预算提出了什么担忧？\"",
+    "exampleQuestion4": "\"谁负责营销任务？\"",
+    "exampleQuestions": "示例问题：",
+    "filters": "筛选器",
+    "filtersActive": "筛选器已激活",
+    "from": "开始日期",
+    "noSpeakerData": "无发言人数据",
+    "placeholder": "询问关于您筛选的转录内容...",
+    "selectFilters": "在左侧选择筛选器以缩小转录范围，然后提问以从录音中获得见解。",
+    "sendHint": "按Enter发送 • Ctrl+Enter换行",
+    "speakerRequirement": "发言人识别需要包含多个发言人的录音",
+    "speakers": "发言人",
+    "speakersCount": "个发言人",
+    "tags": "标签",
+    "tagsCount": "个标签",
+    "title": "查询",
+    "to": "结束日期"
+  },
+  "languages": {
+    "ar": "阿拉伯语",
+    "de": "德语",
+    "en": "英语",
+    "es": "西班牙语",
+    "fr": "法语",
+    "hi": "印地语",
+    "it": "意大利语",
+    "ja": "日语",
+    "ko": "韩语",
+    "nl": "荷兰语",
+    "pt": "葡萄牙语",
+    "pt-BR": "葡萄牙语（巴西）",
+    "ru": "俄语",
+    "zh": "中文",
+    "pl": "波兰语",
+    "uk": "乌克兰语",
+    "vi": "越南语",
+    "th": "泰语",
+    "tr": "土耳其语",
+    "id": "印尼语",
+    "sv": "瑞典语",
+    "autoDetect": "自动检测",
+    "defaultModelDecides": "默认（由模型决定）"
+  },
+  "manageSpeakersModal": {
+    "created": "创建时间",
+    "description": "管理您保存的发言人。当您在录音中使用发言人名称时，这些会自动保存。",
+    "failedToLoad": "加载发言人失败",
+    "lastUsed": "最后使用",
+    "loadingSpeakers": "加载发言人中...",
+    "noSpeakersYet": "尚未保存发言人",
+    "speakersSaved": "已保存 {{count}} 位发言人",
+    "speakersWillAppear": "当您在录音中使用发言人名称时，发言人将显示在这里",
+    "times": "次",
+    "title": "管理发言人",
+    "used": "已使用"
+  },
+  "messages": {
+    "colorSchemeApplied": "Color scheme applied",
+    "colorSchemeReset": "Color scheme reset to default",
+    "copiedSuccessfully": "Copied to clipboard!",
+    "copiedToClipboard": "已复制到剪贴板",
+    "copyFailed": "Failed to copy",
+    "copyNotSupported": "Copy failed. Your browser may not support this feature.",
+    "downloadStarted": "下载已开始",
+    "errorRecoveringRecording": "Error recovering recording",
+    "eventDownloadFailed": "Failed to download event",
+    "eventDownloadSuccess": "Event \"{{title}}\" downloaded. Open the file to add to your calendar.",
+    "eventsExportFailed": "Failed to export events",
+    "eventsExportSuccess": "Exported {{count}} events",
+    "failedToDeleteJob": "Failed to delete job",
+    "failedToRecoverRecording": "Failed to recover recording",
+    "failedToRetryJob": "Failed to retry job",
+    "failedToSave": "Failed to save: {{error}}",
+    "failedToSaveParticipants": "Failed to save participants",
+    "followPlayerDisabled": "Follow player mode disabled",
+    "followPlayerEnabled": "Follow player mode enabled",
+    "invalidEventData": "Invalid event data",
+    "jobQueuedForRetry": "Job queued for retry",
+    "noEventsToExport": "No events to export",
+    "noNotesAvailableDownload": "No notes available to download.",
+    "noNotesToCopy": "No notes available to copy.",
+    "noPermissionToEdit": "You do not have permission to edit this recording",
+    "noSummaryToCopy": "No summary available to copy.",
+    "noSummaryToDownload": "No summary available to download.",
+    "noTranscriptionToCopy": "No transcription available to copy.",
+    "noTranscriptionToDownload": "No transcription available to download.",
+    "notesCopied": "Notes copied to clipboard!",
+    "notesDownloadFailed": "Failed to download notes",
+    "notesDownloadSuccess": "Notes downloaded successfully!",
+    "notesUpdated": "笔记更新成功",
+    "passwordChanged": "密码更改成功",
+    "profileUpdated": "个人资料更新成功",
+    "recordingDeleted": "录音删除成功",
+    "recordingDiscarded": "Recording discarded",
+    "recordingRecovered": "Recording recovered successfully",
+    "recordingSaved": "录音保存成功",
+    "saveParticipantsFailed": "Save failed: {{error}}",
+    "settingsSaved": "设置保存成功",
+    "summaryCopied": "Summary copied to clipboard!",
+    "summaryDownloadFailed": "Failed to download summary",
+    "summaryDownloadSuccess": "Summary downloaded successfully!",
+    "summaryGenerated": "摘要生成成功",
+    "tagAdded": "标签添加成功",
+    "tagRemoved": "标签删除成功",
+    "transcriptDownloadFailed": "Failed to download transcript",
+    "transcriptDownloadSuccess": "Transcript downloaded successfully!",
+    "transcriptionCopied": "Transcription copied to clipboard!",
+    "transcriptionUpdated": "转录更新成功"
+  },
+  "metadata": {
+    "cancelEdit": "取消",
+    "createdAt": "创建时间",
+    "duration": "时长",
+    "editMetadata": "编辑元数据",
+    "fileName": "文件名",
+    "fileSize": "文件大小",
+    "language": "语言",
+    "meetingDate": "会议日期",
+    "processingTime": "处理时间",
+    "saveMetadata": "保存",
+    "status": "状态",
+    "title": "元数据",
+    "updatedAt": "更新时间",
+    "wordCount": "字数"
+  },
+  "modal": {
+    "addSpeaker": "添加新发言人",
+    "colorScheme": "配色方案",
+    "deleteRecording": "删除录音",
+    "editAsrTranscription": "编辑 ASR 转录",
+    "editParticipants": "编辑参与者",
+    "editRecording": "编辑录音",
+    "editSpeakers": "编辑发言人",
+    "editTags": "编辑录音标签",
+    "editTranscription": "编辑转录",
+    "identifySpeakers": "识别发言人",
+    "recordingNotice": "录音提示",
+    "reprocessSummary": "重新处理摘要",
+    "reprocessTranscription": "重新处理转录",
+    "resetStatus": "重置录音状态？",
+    "shareRecording": "分享录音",
+    "sharedTranscripts": "我的共享转录",
+    "systemAudioHelp": "系统音频帮助",
+    "uploadFiles": "上传文件",
+    "uploadNotice": "上传提示"
+  },
+  "namingTemplates": {
+    "addPattern": "添加模式",
+    "availableTemplates": "可用模板",
+    "availableVars": "可用变量",
+    "cancel": "取消",
+    "createDefaults": "创建默认模板",
+    "createNew": "创建模板",
+    "customVarsHint": "定义正则表达式模式以从文件名中提取自定义变量。",
+    "delete": "删除",
+    "description": "定义如何从文件名和转录内容生成录音标题。",
+    "descriptionLabel": "描述",
+    "noDefault": "无默认（仅 AI 标题）",
+    "regexHint": "从文件名中提取数据。使用捕获组 () 指定匹配项。",
+    "regexPatterns": "正则表达式模式（可选）",
+    "result": "结果：",
+    "save": "保存",
+    "selectOrCreate": "选择要编辑的模板或创建新模板",
+    "tabTitle": "命名",
+    "template": "模板",
+    "templateName": "模板名称",
+    "test": "测试",
+    "testTemplate": "测试模板",
+    "title": "命名模板",
+    "userDefault": "默认模板",
+    "userDefaultHint": "当没有标签设置命名模板时应用。"
+  },
+  "nav": {
+    "account": "账户",
+    "accountSettings": "账户设置",
+    "admin": "管理",
+    "adminDashboard": "管理面板",
+    "darkMode": "深色模式",
+    "groupManagement": "群组管理",
+    "home": "主页",
+    "language": "语言",
+    "lightMode": "浅色模式",
+    "newRecording": "新录音",
+    "recording": "录音",
+    "settings": "设置",
+    "signOut": "退出登录",
+    "teamManagement": "群组管理",
+    "upload": "上传",
+    "userProfile": "用户资料"
+  },
+  "notes": {
+    "cancelEdit": "取消编辑",
+    "characterCount": "{{count}} 个字符",
+    "characterCountPlural": "{{count}} 个字符",
+    "editNotes": "编辑笔记",
+    "lastUpdated": "最后更新",
+    "placeholder": "在此添加您的笔记...",
+    "saveNotes": "保存笔记",
+    "title": "笔记"
+  },
+  "pwa": {
+    "installApp": "安装应用",
+    "installed": "安装成功",
+    "installing": "安装中...",
+    "notificationPermissionDenied": "通知权限被拒绝",
+    "notificationsEnabled": "通知已启用",
+    "offline": "您处于离线状态",
+    "screenAwake": "录音时屏幕将保持唤醒",
+    "screenAwakeFailed": "无法保持屏幕唤醒",
+    "updateAvailable": "有可用更新"
+  },
+  "recording": {
+    "acceptDisclaimer": "我接受",
+    "cancelRecording": "取消",
+    "discardRecovery": "丢弃",
+    "disclaimer": "录音免责声明",
+    "duration": "时长",
+    "micPlusSys": "Mic + Sys",
+    "microphone": "麦克风",
+    "microphoneAndSystem": "麦克风 + 系统",
+    "microphonePermissionDenied": "麦克风权限被拒绝",
+    "modeBoth": "麦克风 + 系统",
+    "modeMicrophone": "麦克风",
+    "modeSystem": "系统音频",
+    "notes": "笔记",
+    "notesPlaceholder": "添加关于此录音的笔记...",
+    "pauseRecording": "暂停",
+    "recordingFailed": "录音失败",
+    "recordingInProgress": "录音进行中...",
+    "recordingMode": "录音模式",
+    "recordingSize": "预计大小",
+    "recordingStopped": "录音已停止",
+    "recordingTime": "录音时长",
+    "recoveryDescription": "我们发现了上次会话中未完成的录音。是否要恢复？",
+    "recoveryFound": "检测到未保存的录音",
+    "recoveryTitle": "恢复录音",
+    "restoreRecording": "恢复",
+    "resumeRecording": "恢复",
+    "saveRecording": "保存录音",
+    "size": "大小",
+    "startRecording": "开始录音",
+    "startedAt": "开始时间",
+    "stopRecording": "停止录音",
+    "systemAudio": "系统音频",
+    "systemAudioNotSupported": "此浏览器不支持系统音频录制",
+    "title": "音频录制"
+  },
+  "reprocessModal": {
+    "audioReTranscribedFromScratch": "音频将从头重新转录。这也将基于新转录重新生成标题和摘要。",
+    "audioReTranscribedWithAsr": "音频将使用 ASR 端点重新转录。这包括说话人分离，并将重新生成标题和摘要。",
+    "manualEditsOverwritten": "对转录、标题或摘要的任何手动编辑都将被覆盖。",
+    "manualEditsOverwrittenSummary": "对摘要的任何手动编辑都将被覆盖。",
+    "newTitleAndSummary": "将基于现有转录生成新的摘要。"
+  },
+  "settings": {
+    "apiKeys": "API密钥",
+    "appearance": "外观",
+    "changePassword": "更改密码",
+    "dataExport": "数据导出",
+    "deleteAccount": "删除账户",
+    "integrations": "集成",
+    "language": "语言",
+    "notifications": "通知",
+    "preferences": "偏好设置",
+    "privacy": "隐私",
+    "profile": "个人资料",
+    "security": "安全",
+    "theme": "主题",
+    "title": "设置",
+    "twoFactorAuth": "双因素认证"
+  },
+  "sharedTranscripts": {
+    "noSharedTranscripts": "您尚未分享任何转录。",
+    "shareNotes": "分享笔记",
+    "shareSummary": "分享摘要",
+    "sharedOn": "分享于"
+  },
+  "sharedTranscriptsPage": {
+    "noSharedTranscripts": "您尚未分享任何转录。"
+  },
+  "sharing": {
+    "canEdit": "可以编辑",
+    "canReshare": "可以转发",
+    "internalSharing": "内部分享",
+    "notSharedYet": "尚未分享",
+    "publicBadge": "公开",
+    "publicLink": "公开链接",
+    "publicLinks": "个公开链接",
+    "publicLinksGenerated": "个公开链接已生成",
+    "searchUsers": "搜索用户...",
+    "sharedBadge": "已分享",
+    "sharedBy": "分享者",
+    "sharedWith": "分享给",
+    "teamBadge": "团队",
+    "teamRecording": "团队录音",
+    "unknown": "未知",
+    "users": "位用户"
+  },
+  "sidebar": {
+    "advancedSearch": "高级搜索",
+    "archived": "已归档",
+    "archivedRecordings": "已归档录音",
+    "dateRange": "日期范围",
+    "filters": "筛选器",
+    "highlighted": "已标记",
+    "inbox": "收件箱",
+    "lastMonth": "上月",
+    "lastWeek": "上周",
+    "loadMore": "加载更多",
+    "markAsRead": "标记为已读",
+    "moveToInbox": "移至收件箱",
+    "noRecordings": "没有录音",
+    "older": "更早",
+    "removeFromHighlighted": "取消标记",
+    "searchRecordings": "搜索录音",
+    "sharedWithMe": "分享给我",
+    "sortBy": "排序方式",
+    "sortByDate": "按日期排序",
+    "sortByMeetingDate": "会议日期",
+    "starred": "Starred",
+    "tags": "标签",
+    "thisMonth": "本月",
+    "thisWeek": "本周",
+    "today": "今天",
+    "totalRecordings": "{{count}} 个录音",
+    "totalRecordingsPlural": "{{count}} 个录音",
+    "upcoming": "即将到来",
+    "yesterday": "昨天"
+  },
+  "speakers": {
+    "filterBySpeaker": "按发言人筛选",
+    "noMatchingSpeakers": "没有匹配的发言人",
+    "searchSpeakers": "搜索..."
+  },
+  "speakersManagement": {
+    "added": "添加时间",
+    "confidence": "置信度",
+    "confidenceHigh": "高",
+    "confidenceLow": "低",
+    "confidenceMedium": "中",
+    "created": "创建时间",
+    "description": "管理您保存的发言人。当您在录音中使用发言人姓名时，这些会自动保存。",
+    "failedToLoad": "加载发言人失败",
+    "failedToLoadSnippets": "加载片段失败",
+    "keepThisSpeaker": "保留此发言人（其他将合并到其中）：",
+    "last": "上次",
+    "lastUsed": "上次使用",
+    "loadingSpeakers": "加载发言人...",
+    "match": "匹配",
+    "mergeDescription": "将多个发言人档案合并为一个。所有嵌入、片段和使用数据将被合并。",
+    "mergeFailed": "合并发言人失败",
+    "mergeNSpeakers": "合并 {{count}} 个发言人",
+    "mergeSpeakers": "合并发言人",
+    "mergeSuccess": "发言人合并成功",
+    "noSnippetsAvailable": "无可用片段",
+    "noSpeakersYet": "尚未保存发言人",
+    "sample": "个样本",
+    "samples": "个样本",
+    "selectToMerge": "选择2个以上进行合并",
+    "speakersToMerge": "要合并的发言人：",
+    "speakersWillAppear": "当您在录音中使用发言人姓名时，发言人将出现在这里",
+    "targetWillReceive": "选定的发言人将接收所有其他人的声音数据和片段。",
+    "time": "次",
+    "times": "次",
+    "totalSpeakers": "个已保存发言人",
+    "used": "已使用",
+    "usedTimes": "已使用",
+    "viewSnippets": "查看片段",
+    "voiceMatchSuggestions": "声音匹配建议",
+    "voiceProfile": "声音档案"
+  },
+  "status": {
+    "completed": "已完成",
+    "failed": "失败",
+    "processing": "处理中",
+    "queued": "排队中",
+    "stuck": "重置卡住的处理",
+    "summarizing": "生成摘要中",
+    "transcribing": "转录中",
+    "uploading": "上传中"
+  },
+  "summary": {
+    "actionItems": "行动事项",
+    "cancelEdit": "取消编辑",
+    "decisions": "决定",
+    "editSummary": "编辑摘要",
+    "generateSummary": "生成摘要",
+    "keyPoints": "关键要点",
+    "noSummary": "无可用摘要",
+    "participants": "参与者",
+    "regenerateSummary": "重新生成摘要",
+    "saveSummary": "保存摘要",
+    "summaryFailed": "摘要生成失败",
+    "summaryInProgress": "摘要生成中...",
+    "title": "摘要"
+  },
+  "tagManagement": {
+    "asrDefaults": "ASR 默认值",
+    "createTag": "创建标签",
+    "customPrompt": "自定义提示",
+    "description": "使用自定义标签组织您的录音。每个标签可以有自己的摘要提示和默认 ASR 设置。",
+    "maxSpeakers": "最大",
+    "minSpeakers": "最小",
+    "noTags": "您尚未创建任何标签。"
+  },
+  "tags": {
+    "addTag": "添加标签",
+    "clearTagFilter": "清除筛选",
+    "createTag": "创建标签",
+    "currentTags": "当前标签",
+    "filterByTag": "按标签筛选",
+    "manageAllTags": "管理所有标签",
+    "noAvailableTags": "没有可用标签",
+    "noMatchingTags": "没有匹配的标签",
+    "noTags": "无标签",
+    "removeTag": "删除标签",
+    "searchTags": "搜索...",
+    "tagColor": "标签颜色",
+    "tagName": "标签名称",
+    "title": "标签"
+  },
+  "tagsModal": {
+    "addTags": "添加标签",
+    "currentTags": "当前标签",
+    "done": "完成",
+    "noTagsAssigned": "此录音未分配标签",
+    "searchTags": "搜索标签..."
+  },
+  "time": {
+    "dayAgo": "1 天前",
+    "daysAgo": "{{count}} 天前",
+    "hourAgo": "1 小时前",
+    "hoursAgo": "{{count}} 小时前",
+    "justNow": "刚刚",
+    "minuteAgo": "1 分钟前",
+    "minutesAgo": "{{count}} 分钟前",
+    "monthAgo": "1 个月前",
+    "monthsAgo": "{{count}} 个月前",
+    "weekAgo": "1 周前",
+    "weeksAgo": "{{count}} 周前",
+    "yearAgo": "1 年前",
+    "yearsAgo": "{{count}} 年前"
+  },
+  "tooltips": {
+    "changeSpeaker": "更改发言人",
+    "clearChat": "清空聊天",
+    "copyTranscript": "复制转录",
+    "deleteTeam": "删除群组",
+    "doubleClickToEdit": "双击编辑",
+    "downloadTranscriptWithTemplate": "使用模板下载转录",
+    "editTeam": "编辑群组",
+    "editText": "编辑文本",
+    "editTitle": "编辑标题",
+    "regenerateTitle": "使用AI重新生成标题",
+    "assignFolder": "分配文件夹",
+    "discardIncognito": "丢弃隐身录音",
+    "editTranscript": "编辑转录",
+    "exitFullscreen": "Exit fullscreen",
+    "expand": "展开",
+    "followPlayerDisabled": "启用自动滚动 - 文字记录跟随音频播放",
+    "followPlayerEnabled": "禁用自动滚动 - 文字记录保持位置",
+    "fullscreenVideo": "Fullscreen video",
+    "grantPublicSharing": "授予公开分享权限",
+    "hideVideo": "Hide video",
+    "highlight": "高亮",
+    "makeAdmin": "设为管理员",
+    "manageMembers": "管理成员",
+    "manageTeamTags": "管理群组标签",
+    "markAsRead": "标记为已读",
+    "maximizeChat": "最大化聊天",
+    "minimize": "最小化",
+    "moveToInbox": "移至收件箱",
+    "mute": "静音",
+    "pause": "暂停",
+    "play": "播放",
+    "playbackSpeed": "播放速度",
+    "removeAdmin": "移除管理员",
+    "removeFromQueue": "从队列中移除",
+    "removeFromTeam": "从团队中移除",
+    "removeHighlight": "移除高亮",
+    "reprocessTranscription": "重新处理转录",
+    "reprocessWithAsr": "使用ASR重新处理",
+    "restoreChat": "恢复聊天",
+    "revokePublicSharing": "撤销公开分享权限",
+    "shareWithUsers": "与用户分享",
+    "showVideo": "Show video",
+    "switchToDarkMode": "切换到深色模式",
+    "switchToLightMode": "切换到浅色模式",
+    "unmute": "取消静音"
+  },
+  "transcriptTemplates": {
+    "availableTemplates": "可用模板",
+    "availableVars": "可用变量",
+    "cancel": "取消",
+    "chooseTemplate": "选择模板...",
+    "createDefaults": "创建默认模板",
+    "createNew": "创建模板",
+    "default": "默认",
+    "delete": "删除",
+    "description": "自定义转录的下载和导出格式。",
+    "downloadDefault": "下载默认",
+    "downloadWithoutTemplate": "不使用模板下载",
+    "filters": "过滤器：|upper 转大写，|srt 字幕格式",
+    "save": "保存",
+    "selectOrCreate": "选择要编辑的模板或创建新模板",
+    "selectTemplate": "选择模板",
+    "setDefault": "设为默认模板",
+    "tabTitle": "转录",
+    "template": "模板",
+    "templateName": "模板名称",
+    "title": "转录模板",
+    "viewGuide": "查看模板指南"
+  },
+  "transcription": {
+    "autoIdentifySpeakers": "自动识别发言人",
+    "bubble": "气泡",
+    "cancelEdit": "取消编辑",
+    "copy": "复制",
+    "copyToClipboard": "复制到剪贴板",
+    "download": "下载",
+    "downloadTranscript": "下载转录文本",
+    "edit": "编辑",
+    "editSpeakers": "编辑发言人",
+    "editTranscription": "编辑转录",
+    "highlightSearchResults": "高亮搜索结果",
+    "noTranscription": "无可用转录",
+    "regenerateTranscription": "重新生成转录",
+    "saveTranscription": "保存转录",
+    "searchInTranscript": "在转录中搜索...",
+    "simple": "简单",
+    "speaker": "发言人 {{number}}",
+    "speakerLabels": "发言人标签",
+    "title": "转录",
+    "unknownSpeaker": "未知发言人"
+  },
+  "upload": {
+    "chunking": "大文件将自动分块处理",
+    "completed": "已完成",
+    "copies": "份此文件的副本",
+    "dropzone": "拖拽音频文件到此处，或点击浏览",
+    "duplicateDetected": "此文件似乎与 \"{{existingName}}\" 重复（上传于 {{existingDate}}）",
+    "duplicateFile": "重复文件",
+    "failed": "失败",
+    "fileExceedsMaxSize": "File \"{{name}}\" exceeds the maximum size of {{size}} MB and was skipped.",
+    "fileRemovedFromQueue": "File removed from queue",
+    "filesToUpload": "Files to Upload",
+    "invalidFileType": "Invalid file type \"{{name}}\". Only audio files and video containers with audio (MP3, WAV, MP4, MOV, AVI, etc.) are accepted. File skipped.",
+    "maxFileSize": "最大文件大小",
+    "queued": "排队中",
+    "selectFiles": "选择文件",
+    "settingsApplyToAll": "Settings apply to all files in this session",
+    "summarizing": "生成摘要中...",
+    "supportedFormats": "支持 MP3, WAV, M4A, MP4, MOV, AVI, AMR 等格式",
+    "title": "上传音频",
+    "transcribing": "转录中...",
+    "untitled": "无标题录音",
+    "uploadNFiles": "Upload {{count}} File(s)",
+    "uploadProgress": "上传进度",
+    "videoRetained": "视频已保留供播放",
+    "willAutoSummarize": "转录后将自动生成摘要"
+  },
+  "uploadProgress": {
+    "title": "上传进度"
+  },
+  "promptVariables": {
+    "title": "提示变量",
+    "infoTooltip": "关于提示变量",
+    "hintUpload": "所选标签或文件夹使用提示占位符。填写后将替换到此录音的摘要提示中。空值替换为空字符串。每个值最多 8,000 字符，全部变量合计最多 32,000 字符。",
+    "hintReprocess": "这些值会替换已解析提示中的占位符。此处的修改会保存到录音中。空值替换为空字符串。每个值最多 8,000 字符，全部变量合计最多 32,000 字符。",
+    "placeholderPrefix": "输入"
+  },
+  "summaryMode": {
+    "applyMode": "应用模式",
+    "append": "追加",
+    "appendHelp": "使用默认提示，并将此内容作为额外上下文。",
+    "replace": "替换",
+    "replaceHelp": "仅使用此文本作为摘要指令。"
+  },
+  "customizeSummary": {
+    "title": "自定义摘要提示",
+    "body": "为此摘要添加一次性上下文，或完全替换已解析的提示。",
+    "additionalContext": "附加上下文",
+    "customPrompt": "自定义提示",
+    "appendPlaceholder": "例如：今天的议程是：…",
+    "replacePlaceholder": "输入完整的摘要提示…",
+    "generateSummary": "生成摘要"
+  },
+  "asrEditor": {
+    "saved": "已保存",
+    "ctrlSHint": "Ctrl+S 保存",
+    "saveWithoutClosing": "保存但不关闭 (Ctrl+S)"
+  },
+  "preview": {
+    "placeholderLegend": "占位符图例：",
+    "systemReplaced": "由系统替换（当前日期、转录、标签名称等）",
+    "userSupplied": "上传或重新处理时由用户提供",
+    "userMessageHeading": "用户消息：",
+    "liveUpdateNote": "上方编辑自定义提示时，摘要指令区会实时更新。处理录音时，占位符将被替换为真实值。"
+  },
+  "preferences": {
+    "description": "显示与编辑器行为偏好。这些设置保存在您的账户中，并在所有设备上生效。",
+    "editorAutosave": "自动保存转录编辑器中的修改",
+    "editorAutosaveHelp": "启用后，转录编辑器中的修改会在停止输入约两秒后自动保存。默认关闭，您需要通过保存按钮或 Ctrl+S 手动保存。",
+    "showTimestampsSimpleView": "在简单视图中显示时间戳",
+    "showTimestampsSimpleViewHelp": "在简单视图中，每个发言人标签旁显示紧凑的 mm:ss 时间戳。气泡视图不受影响。",
+    "transcriptDisplay": "转录显示",
+    "transcriptEditor": "转录编辑器"
+  }
+}
diff --git a/static/manifest.json b/static/manifest.json
new file mode 100644
index 00000000..2b527d77
--- /dev/null
+++ b/static/manifest.json
@@ -0,0 +1,122 @@
+{
+  "id": "com.speakr.app",
+  "name": "Speakr",
+  "short_name": "Speakr",
+  "description": "Speakr - Audio transcription and summarization",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "display_override": ["window-controls-overlay", "standalone"],
+  "background_color": "#000000",
+  "theme_color": "#000000",
+  "orientation": "any",
+  "prefer_related_applications": false,
+  "categories": ["productivity", "utilities", "business"],
+  "lang": "en",
+  "dir": "ltr",
+  "icons": [
+    {
+      "src": "/static/img/icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/static/img/icon-maskable-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    },
+    {
+      "src": "/static/img/icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/static/img/icon-180x180.png",
+      "sizes": "180x180",
+      "type": "image/png",
+      "purpose": "any"
+    }
+  ],
+  "screenshots": [
+    {
+      "src": "/static/img/screenshots/main-view.png",
+      "sizes": "1920x1080",
+      "type": "image/png",
+      "form_factor": "wide",
+      "label": "Main recording gallery view"
+    },
+    {
+      "src": "/static/img/screenshots/recording-interface.png",
+      "sizes": "1920x1080",
+      "type": "image/png",
+      "form_factor": "wide",
+      "label": "Live recording interface with notes"
+    },
+    {
+      "src": "/static/img/screenshots/transcript-view.png",
+      "sizes": "1920x1080",
+      "type": "image/png",
+      "form_factor": "wide",
+      "label": "Transcript view with speaker identification"
+    },
+    {
+      "src": "/static/img/screenshots/mobile-view.png",
+      "sizes": "390x844",
+      "type": "image/png",
+      "form_factor": "narrow",
+      "label": "Mobile recording view"
+    }
+  ],
+  "shortcuts": [
+    {
+      "name": "New Recording",
+      "short_name": "New",
+      "description": "Upload or record new audio",
+      "url": "/#upload",
+      "icons": [{ "src": "/static/img/icon-192x192.png", "sizes": "192x192" }]
+    },
+    {
+      "name": "View Gallery",
+      "short_name": "Gallery",
+      "description": "Access your recordings gallery",
+      "url": "/#gallery",
+      "icons": [{ "src": "/static/img/icon-192x192.png", "sizes": "192x192" }]
+    }
+  ],
+  "share_target": {
+    "action": "/#upload",
+    "method": "POST",
+    "enctype": "multipart/form-data",
+    "params": {
+      "title": "title",
+      "text": "text",
+      "url": "url",
+      "files": [
+        {
+          "name": "shared_audio",
+          "accept": ["audio/*"]
+        }
+      ]
+    }
+  },
+  "edge_side_panel": {
+    "preferred_width": 480
+  },
+  "file_handlers": [
+    {
+      "action": "/",
+      "accept": {
+        "audio/*": [".mp3", ".wav", ".m4a", ".ogg", ".webm", ".flac", ".aac", ".wma", ".opus"]
+      }
+    }
+  ],
+  "protocol_handlers": [
+    {
+      "protocol": "web+speakr",
+      "url": "/?audio=%s"
+    }
+  ]
+}
diff --git a/static/offline.html b/static/offline.html
new file mode 100644
index 00000000..fc054898
--- /dev/null
+++ b/static/offline.html
@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Offline - Speakr</title>
+    <link rel="icon" href="/static/img/favicon.ico" type="image/svg+xml">
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+            background-color: #f0f2f5;
+            color: #1c1e21;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100vh;
+            margin: 0;
+            text-align: center;
+            padding: 20px;
+            box-sizing: border-box;
+        }
+        .container {
+            background-color: #ffffff;
+            padding: 40px;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1), 0 8px 16px rgba(0, 0, 0, 0.1);
+        }
+        img {
+            width: 60px;
+            height: 60px;
+            margin-bottom: 20px;
+        }
+        h1 {
+            font-size: 24px;
+            margin-bottom: 10px;
+        }
+        p {
+            font-size: 16px;
+            color: #606770;
+        }
+        @media (prefers-color-scheme: dark) {
+            body {
+                background-color: #1c1e21;
+                color: #e4e6eb;
+            }
+            .container {
+                background-color: #242526;
+                box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2), 0 8px 16px rgba(0, 0, 0, 0.2);
+            }
+            p {
+                color: #b0b3b8;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <img src="/static/img/favicon.ico" alt="Speakr Logo">
+        <h1>You're Offline</h1>
+        <p>It looks like you're not connected to the internet. Please check your connection and try again.</p>
+        <p>Some content may be unavailable until you're back online.</p>
+    </div>
+</body>
+</html>
diff --git a/static/robots.txt b/static/robots.txt
new file mode 100644
index 00000000..7275cbad
--- /dev/null
+++ b/static/robots.txt
@@ -0,0 +1,65 @@
+# Speakr - Block all web crawlers and search engines
+# This application contains private user data and should not be indexed
+
+User-agent: *
+Disallow: /
+
+# Specific directives for major search engines
+User-agent: Googlebot
+Disallow: /
+
+User-agent: Googlebot-Image
+Disallow: /
+
+User-agent: Bingbot
+Disallow: /
+
+User-agent: Slurp
+Disallow: /
+
+User-agent: DuckDuckBot
+Disallow: /
+
+User-agent: Baiduspider
+Disallow: /
+
+User-agent: YandexBot
+Disallow: /
+
+User-agent: ia_archiver
+Disallow: /
+
+# AI Crawlers
+User-agent: GPTBot
+Disallow: /
+
+User-agent: ChatGPT-User
+Disallow: /
+
+User-agent: CCBot
+Disallow: /
+
+User-agent: anthropic-ai
+Disallow: /
+
+User-agent: Claude-Web
+Disallow: /
+
+User-agent: cohere-ai
+Disallow: /
+
+# Social Media Crawlers
+User-agent: facebookexternalhit
+Disallow: /
+
+User-agent: Twitterbot
+Disallow: /
+
+User-agent: LinkedInBot
+Disallow: /
+
+User-agent: Slackbot
+Disallow: /
+
+User-agent: Discordbot
+Disallow: /
diff --git a/static/sw.js b/static/sw.js
new file mode 100644
index 00000000..a15f7a4f
--- /dev/null
+++ b/static/sw.js
@@ -0,0 +1,541 @@
+const CACHE_NAME = 'Speakr-cache-v4';
+const ASSETS_TO_CACHE = [
+  '/',
+  '/static/offline.html',
+  '/static/manifest.json',
+  '/static/css/styles.css',
+  '/static/js/app.modular.js',
+  '/static/js/i18n.js',
+  '/static/js/csrf-refresh.js',
+  '/static/img/icon-192x192.png',
+  '/static/img/icon-512x512.png',
+  '/static/img/favicon.ico',
+  // Local vendor assets (no external CDN dependencies)
+  '/static/vendor/js/tailwind.min.js',
+  '/static/vendor/js/vue.global.js',
+  '/static/vendor/js/marked.min.js',
+  '/static/vendor/js/easymde.min.js',
+  '/static/vendor/css/fontawesome.min.css',
+  '/static/vendor/css/easymde.min.css'
+];
+
+// Function to update shortcuts (structure from your example)
+// The actual `lists` data would need to be sent from your client-side app.js
+const updateShortcuts = async (lists) => {
+  if (!self.registration || !('shortcuts' in self.registration)) {
+    console.log('Shortcuts API not supported or registration not available.');
+    return;
+  }
+
+  try {
+    let shortcuts = [
+      {
+        name: "New Recording",
+        short_name: "New",
+        description: "Upload or record new audio",
+        url: "/#upload", // Or your direct upload page route
+        icons: [{ src: "/static/img/icon-192x192.png", sizes: "192x192" }]
+      },
+      {
+        name: "View Gallery",
+        short_name: "Gallery",
+        description: "Access your recordings gallery",
+        url: "/#gallery", // Or your direct gallery page route
+        icons: [{ src: "/static/img/icon-192x192.png", sizes: "192x192" }]
+      }
+    ];
+
+    // Example: If you had dynamic lists to add as shortcuts
+    if (Array.isArray(lists) && lists.length > 0) {
+      const dynamicShortcuts = lists.slice(0, 2).map(list => { // Max 2 dynamic, total 4
+        if (list && list.id && list.title) {
+          return {
+            name: list.title,
+            short_name: list.title.length > 10 ? list.title.substring(0, 9) + '…' : list.title,
+            description: `View ${list.title}`,
+            url: `/list/${list.id}`, // Example dynamic URL
+            icons: [{ src: "/static/img/icon-192x192.png", sizes: "192x192" }]
+          };
+        }
+        return null;
+      }).filter(Boolean);
+      shortcuts = [...shortcuts, ...dynamicShortcuts];
+    }
+
+    await self.registration.shortcuts.set(shortcuts);
+    console.log('PWA shortcuts updated successfully:', shortcuts);
+  } catch (error) {
+    console.error('Error updating PWA shortcuts:', error);
+  }
+};
+
+
+// Cache first strategy: Respond from cache if available, otherwise fetch from network and cache.
+const cacheFirst = async (request) => {
+  const responseFromCache = await caches.match(request);
+  if (responseFromCache) {
+    return responseFromCache;
+  }
+  try {
+    const responseFromNetwork = await fetch(request);
+    // Check if the response is valid before caching
+    if (responseFromNetwork && responseFromNetwork.ok) {
+      const cache = await caches.open(CACHE_NAME);
+      cache.put(request, responseFromNetwork.clone());
+    }
+    return responseFromNetwork;
+  } catch (error) {
+    console.error('CacheFirst: Network request failed for:', request.url, error);
+    // For assets, returning a generic error or specific offline asset might be better than network error.
+    // However, if it's a critical asset not found, this indicates an issue.
+    return new Response('Network error trying to fetch asset.', {
+      status: 408,
+      headers: { 'Content-Type': 'text/plain' },
+    });
+  }
+};
+
+// Stale-while-revalidate strategy: Respond from cache immediately if available,
+// then update the cache with a fresh response from the network.
+const staleWhileRevalidate = async (request) => {
+  const cache = await caches.open(CACHE_NAME);
+  const cachedResponsePromise = cache.match(request);
+  const networkResponsePromise = fetch(request).then(networkResponse => {
+    if (networkResponse && networkResponse.ok) {
+      cache.put(request, networkResponse.clone());
+    }
+    return networkResponse;
+  }).catch(error => {
+    console.error('StaleWhileRevalidate: Network request failed for:', request.url, error);
+    // If network fails, we still might have a cached response.
+    // If not, this error will propagate.
+    return new Response('API request failed and no cache available.', {
+        status: 503, // Service Unavailable
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ error: 'Service temporarily unavailable. Please try again later.' })
+    });
+  });
+
+  return (await cachedResponsePromise) || networkResponsePromise;
+};
+
+// Network first strategy: Try to fetch from network first.
+// If network fails, fall back to cache. If cache also fails, serve offline page for navigation.
+const networkFirst = async (request) => {
+  try {
+    const networkResponse = await fetch(request);
+    if (networkResponse && networkResponse.ok) {
+      const cache = await caches.open(CACHE_NAME);
+      cache.put(request, networkResponse.clone());
+    }
+    return networkResponse;
+  } catch (error) {
+    console.warn('NetworkFirst: Network request failed for:', request.url, error);
+    const cachedResponse = await caches.match(request);
+    if (cachedResponse) {
+      return cachedResponse;
+    }
+    // For navigation requests, fall back to the offline page if both network and cache fail.
+    if (request.mode === 'navigate') {
+      const offlinePage = await caches.match('/static/offline.html');
+      if (offlinePage) return offlinePage;
+    }
+    // For other types of requests, or if offline page isn't cached, re-throw or return error.
+    return new Response('Network error and no cache available.', {
+      status: 408,
+      headers: { 'Content-Type': 'text/plain' },
+    });
+  }
+};
+
+self.addEventListener('install', (event) => {
+  self.skipWaiting(); // Activate new service worker immediately
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => {
+      console.log('Service Worker: Caching app shell');
+      return cache.addAll(ASSETS_TO_CACHE.map(url => new Request(url, { cache: 'reload' }))) // Force reload from network for app shell
+        .catch(error => {
+          console.error('Failed to cache app shell during install:', error);
+          // You might want to log which specific asset failed
+          ASSETS_TO_CACHE.forEach(url => {
+            cache.add(new Request(url, { cache: 'reload' })).catch(err => console.warn(`Failed to cache: ${url}`, err));
+          });
+        });
+    })
+  );
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((cacheNames) => {
+      return Promise.all(
+        cacheNames
+          .filter((name) => name !== CACHE_NAME)
+          .map((name) => {
+            console.log('Service Worker: Deleting old cache', name);
+            return caches.delete(name);
+          })
+      );
+    }).then(() => {
+      console.log('Service Worker: Activated and old caches cleared.');
+      return self.clients.claim(); // Take control of all open clients
+    })
+  );
+});
+
+self.addEventListener('fetch', (event) => {
+  const request = event.request;
+  const url = new URL(request.url);
+
+  // Skip non-GET requests from caching strategies (they should pass through)
+  if (request.method !== 'GET') {
+    // event.respondWith(fetch(request)); // Let non-GET requests pass through to the network
+    return; // Or simply return to let the browser handle it
+  }
+
+  // Serve API calls from /api/ with stale-while-revalidate
+  // (excluding auth-related endpoints)
+  if (url.pathname.startsWith('/api/')) {
+    if (url.pathname.includes('/login') || url.pathname.includes('/logout') || url.pathname.includes('/auth')) {
+      // For auth, always go to network, don't cache
+      event.respondWith(fetch(request));
+      return;
+    }
+    event.respondWith(staleWhileRevalidate(request));
+    return;
+  }
+  
+  // Serve /audio/<id> requests with cache-first, then network.
+  // These are media files and can be large, so cache-first is good.
+  if (url.pathname.startsWith('/audio/')) {
+    event.respondWith(cacheFirst(request));
+    return;
+  }
+
+  // Handle navigation requests (HTML pages) with network-first, then cache, then offline page.
+  if (request.mode === 'navigate') {
+    event.respondWith(networkFirst(request));
+    return;
+  }
+
+  // For static assets listed in ASSETS_TO_CACHE, use cache-first.
+  // This ensures that if an asset path is directly requested, it's served from cache if possible.
+  // We need to match against the origin + pathname for ASSETS_TO_CACHE.
+  const requestPath = url.origin === self.origin ? url.pathname : request.url;
+  if (ASSETS_TO_CACHE.includes(requestPath)) {
+    event.respondWith(cacheFirst(request));
+    return;
+  }
+
+  // Default strategy for other GET requests: try cache, then network.
+  // This is a good general fallback for other static assets not explicitly listed
+  // or for assets from other origins if not handled by ASSETS_TO_CACHE.
+  event.respondWith(
+    caches.match(request).then((cachedResponse) => {
+      if (cachedResponse) {
+        return cachedResponse;
+      }
+      return fetch(request).then(networkResponse => {
+        // Optionally cache other successful GET responses here if desired
+        // if (networkResponse && networkResponse.ok) {
+        //   const cache = await caches.open(CACHE_NAME);
+        //   cache.put(request, networkResponse.clone());
+        // }
+        return networkResponse;
+      }).catch(() => {
+        // If network fails for a non-navigation, non-API, non-explicitly-cached asset
+        // there isn't much we can do other than return an error or nothing.
+        // For simplicity, let the browser handle the error.
+      });
+    })
+  );
+});
+
+// Listen for messages from the client (e.g., to update shortcuts)
+self.addEventListener('message', (event) => {
+  if (event.data && event.data.type === 'UPDATE_SHORTCUTS') {
+    console.log('Service Worker: Received UPDATE_SHORTCUTS message:', event.data.lists);
+    // updateShortcuts(event.data.lists); // Call if you implement dynamic shortcuts based on client data
+  }
+  if (event.data && event.data.type === 'SKIP_WAITING') {
+    self.skipWaiting();
+  }
+});
+
+// Background sync for failed uploads
+self.addEventListener('sync', (event) => {
+  console.log('[Service Worker] Background sync triggered:', event.tag);
+
+  if (event.tag === 'sync-uploads') {
+    event.waitUntil(syncFailedUploads());
+  }
+});
+
+// IndexedDB helper for failed uploads
+async function openFailedUploadsDB() {
+  return new Promise((resolve, reject) => {
+    const request = indexedDB.open('SpeakrFailedUploads', 1);
+
+    request.onerror = () => reject(request.error);
+    request.onsuccess = () => resolve(request.result);
+
+    request.onupgradeneeded = (event) => {
+      const db = event.target.result;
+      if (!db.objectStoreNames.contains('failedUploads')) {
+        const objectStore = db.createObjectStore('failedUploads', { keyPath: 'id', autoIncrement: true });
+        objectStore.createIndex('timestamp', 'timestamp', { unique: false });
+        objectStore.createIndex('clientId', 'clientId', { unique: false });
+      }
+    };
+  });
+}
+
+// Get all failed uploads from IndexedDB
+async function getFailedUploads(db) {
+  return new Promise((resolve, reject) => {
+    const transaction = db.transaction(['failedUploads'], 'readonly');
+    const objectStore = transaction.objectStore('failedUploads');
+    const request = objectStore.getAll();
+
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+  });
+}
+
+// Delete a failed upload after successful retry
+async function deleteFailedUpload(db, id) {
+  return new Promise((resolve, reject) => {
+    const transaction = db.transaction(['failedUploads'], 'readwrite');
+    const objectStore = transaction.objectStore('failedUploads');
+    const request = objectStore.delete(id);
+
+    request.onsuccess = () => resolve();
+    request.onerror = () => reject(request.error);
+  });
+}
+
+// Update retry count for a failed upload
+async function updateRetryCount(db, id, retryCount, error) {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const transaction = db.transaction(['failedUploads'], 'readwrite');
+      const objectStore = transaction.objectStore('failedUploads');
+      const getRequest = objectStore.get(id);
+
+      getRequest.onsuccess = () => {
+        const upload = getRequest.result;
+        if (!upload) {
+          reject(new Error('Upload not found'));
+          return;
+        }
+
+        upload.retryCount = retryCount;
+        upload.lastRetry = Date.now();
+        if (error) {
+          upload.lastError = error;
+        }
+
+        const putRequest = objectStore.put(upload);
+        putRequest.onsuccess = () => resolve();
+        putRequest.onerror = () => reject(putRequest.error);
+      };
+
+      getRequest.onerror = () => reject(getRequest.error);
+    } catch (error) {
+      reject(error);
+    }
+  });
+}
+
+// Retry uploading a failed upload
+async function retryUpload(upload) {
+  const formData = new FormData();
+
+  // Reconstruct File from ArrayBuffer
+  const file = new File([upload.fileData], upload.fileName, { type: upload.mimeType });
+  formData.append('file', file);
+
+  if (upload.notes) {
+    formData.append('notes', upload.notes);
+  }
+
+  if (upload.tags && upload.tags.length > 0) {
+    upload.tags.forEach(tag => {
+      formData.append('tags[]', JSON.stringify(tag));
+    });
+  }
+
+  if (upload.asrOptions) {
+    if (upload.asrOptions.language) {
+      formData.append('asr_language', upload.asrOptions.language);
+    }
+    if (upload.asrOptions.min_speakers) {
+      formData.append('asr_min_speakers', upload.asrOptions.min_speakers);
+    }
+    if (upload.asrOptions.max_speakers) {
+      formData.append('asr_max_speakers', upload.asrOptions.max_speakers);
+    }
+  }
+
+  // Get CSRF token from cookies
+  const csrfToken = getCookie('csrf_access_token');
+  const headers = csrfToken ? { 'X-CSRF-TOKEN': csrfToken } : {};
+
+  const response = await fetch('/upload', {
+    method: 'POST',
+    headers: headers,
+    body: formData,
+    credentials: 'same-origin'
+  });
+
+  if (!response.ok) {
+    throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+  }
+
+  return response.json();
+}
+
+// Get cookie value
+function getCookie(name) {
+  const value = `; ${self.cookies || ''}`;
+  const parts = value.split(`; ${name}=`);
+  if (parts.length === 2) return parts.pop().split(';').shift();
+  return null;
+}
+
+// Sync failed uploads from IndexedDB
+async function syncFailedUploads() {
+  console.log('[Service Worker] Syncing failed uploads');
+
+  try {
+    const db = await openFailedUploadsDB();
+    const failedUploads = await getFailedUploads(db);
+
+    if (failedUploads.length === 0) {
+      console.log('[Service Worker] No failed uploads to retry');
+      return Promise.resolve();
+    }
+
+    console.log(`[Service Worker] Found ${failedUploads.length} failed uploads to retry`);
+
+    // Notify that sync started
+    await self.registration.showNotification('Speakr Upload Sync', {
+      body: `Retrying ${failedUploads.length} failed upload(s)...`,
+      icon: '/static/img/icon-192x192.png',
+      badge: '/static/img/icon-192x192.png',
+      tag: 'upload-sync',
+      requireInteraction: false
+    });
+
+    let successCount = 0;
+    let failCount = 0;
+
+    for (const upload of failedUploads) {
+      try {
+        // Limit retries to 3 attempts
+        if (upload.retryCount >= 3) {
+          console.log(`[Service Worker] Upload ${upload.id} exceeded retry limit (${upload.retryCount})`);
+          failCount++;
+          continue;
+        }
+
+        console.log(`[Service Worker] Retrying upload ${upload.id} (attempt ${upload.retryCount + 1})`);
+
+        await retryUpload(upload);
+
+        // Success - delete from IndexedDB
+        await deleteFailedUpload(db, upload.id);
+        successCount++;
+
+        console.log(`[Service Worker] Successfully retried upload ${upload.id}`);
+      } catch (error) {
+        // Update retry count
+        await updateRetryCount(db, upload.id, upload.retryCount + 1, error.message);
+        failCount++;
+
+        console.error(`[Service Worker] Failed to retry upload ${upload.id}:`, error);
+      }
+    }
+
+    // Show final notification
+    await self.registration.showNotification('Speakr Upload Sync Complete', {
+      body: `${successCount} succeeded, ${failCount} failed`,
+      icon: '/static/img/icon-192x192.png',
+      badge: '/static/img/icon-192x192.png',
+      tag: 'upload-sync-complete',
+      requireInteraction: false
+    });
+
+    return Promise.resolve();
+  } catch (error) {
+    console.error('[Service Worker] Failed to sync uploads:', error);
+
+    await self.registration.showNotification('Speakr Upload Sync Failed', {
+      body: 'Could not sync failed uploads. Will retry later.',
+      icon: '/static/img/icon-192x192.png',
+      badge: '/static/img/icon-192x192.png',
+      tag: 'upload-sync-error',
+      requireInteraction: false
+    });
+
+    return Promise.reject(error);
+  }
+}
+
+// Push notification handler
+self.addEventListener('push', (event) => {
+  console.log('[Service Worker] Push notification received');
+
+  const options = {
+    icon: '/static/img/icon-192x192.png',
+    badge: '/static/img/icon-192x192.png',
+    vibrate: [200, 100, 200],
+    data: {
+      dateOfArrival: Date.now(),
+      primaryKey: 1
+    }
+  };
+
+  if (event.data) {
+    const data = event.data.json();
+    event.waitUntil(
+      self.registration.showNotification(data.title || 'Speakr Notification', {
+        body: data.body || 'You have a new notification',
+        ...options,
+        data: data
+      })
+    );
+  } else {
+    event.waitUntil(
+      self.registration.showNotification('Speakr Notification', {
+        body: 'You have a new notification',
+        ...options
+      })
+    );
+  }
+});
+
+// Notification click handler
+self.addEventListener('notificationclick', (event) => {
+  console.log('[Service Worker] Notification clicked:', event.notification.tag);
+  event.notification.close();
+
+  // Handle different notification types
+  const urlToOpen = event.notification.data?.url || '/';
+
+  event.waitUntil(
+    clients.matchAll({ type: 'window', includeUncontrolled: true })
+      .then((clientList) => {
+        // Check if there's already a window open
+        for (const client of clientList) {
+          if (client.url === urlToOpen && 'focus' in client) {
+            return client.focus();
+          }
+        }
+        // If no window is open, open a new one
+        if (clients.openWindow) {
+          return clients.openWindow(urlToOpen);
+        }
+      })
+  );
+});
diff --git a/templates/account.html b/templates/account.html
index 91479cc1..9db86475 100644
--- a/templates/account.html
+++ b/templates/account.html
@@ -3,103 +3,405 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
     <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
+
+    <!-- Loading overlay to prevent FOUC -->
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        // Initialize i18n
+        let t = (key) => key; // Default fallback
+        
+        async function initializeI18n(language) {
+            const userLanguage = language || "{{ user_language }}";
+
+            // Initialize the global i18n instance
+            if (window.i18n) {
+                await window.i18n.init(userLanguage);
+
+                // Create a shorthand translation function
+                t = (key, params) => window.i18n.t(key, params);
+
+                // Update all elements with data-i18n attribute
+                document.querySelectorAll('[data-i18n]').forEach(el => {
+                    const key = el.getAttribute('data-i18n');
+                    const paramsAttr = el.getAttribute('data-i18n-params');
+                    const params = paramsAttr ? JSON.parse(paramsAttr) : {};
+                    el.textContent = t(key, params);
+                });
+
+                // Update all elements with data-i18n-placeholder attribute
+                document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
+                    const key = el.getAttribute('data-i18n-placeholder');
+                    el.placeholder = t(key);
+                });
+            }
+        }
+
+        // Function to update all UI elements after language change
+        function updateAllUIElements() {
+            // Update all elements with data-i18n attribute
+            document.querySelectorAll('[data-i18n]').forEach(el => {
+                const key = el.getAttribute('data-i18n');
+                const paramsAttr = el.getAttribute('data-i18n-params');
+                const params = paramsAttr ? JSON.parse(paramsAttr) : {};
+                el.textContent = t(key, params);
+            });
+
+            // Update all elements with data-i18n-placeholder attribute
+            document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
+                const key = el.getAttribute('data-i18n-placeholder');
+                el.placeholder = t(key);
+            });
+            
+            // Update language options in dropdown to show native names
+            const langSelect = document.getElementById('ui_language');
+            if (langSelect) {
+                const langOptions = {
+                    'en': 'English',
+                    'es': 'Español (Spanish)',
+                    'fr': 'Français (French)',
+                    'zh': '中文 (Chinese)',
+                    'de': 'Deutsch (German)',
+                    'ru': 'Русский (Russian)',
+                    'pt-BR': 'Português (Brasil)'
+                };
+                
+                Array.from(langSelect.options).forEach(option => {
+                    if (langOptions[option.value]) {
+                        option.textContent = langOptions[option.value];
+                    }
+                });
+            }
+            
+            // Force update any Vue or dynamic content by dispatching a custom event
+            window.dispatchEvent(new CustomEvent('language-changed', { detail: { language: window.i18n.currentLanguage } }));
+        }
+
+        // Function to change language immediately
+        async function changeLanguageImmediately(newLanguage) {
+            try {
+                // Show loading indicator
+                const uiLanguageSelect = document.getElementById('ui_language');
+                uiLanguageSelect.disabled = true;
+                
+                // Add a loading message
+                const originalText = uiLanguageSelect.parentElement.querySelector('p').textContent;
+                const loadingMsg = uiLanguageSelect.parentElement.querySelector('p');
+                if (loadingMsg) {
+                    loadingMsg.textContent = 'Applying language change...';
+                }
+                
+                // Get CSRF token
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                
+                // Create form data with just the language change
+                const formData = new FormData();
+                formData.append('csrf_token', csrfToken);
+                formData.append('user_name', document.getElementById('user_name').value || '');
+                formData.append('user_job_title', document.getElementById('user_job_title').value || '');
+                formData.append('user_company', document.getElementById('user_company').value || '');
+                formData.append('ui_language', newLanguage);
+                formData.append('transcription_language', document.getElementById('transcription_language').value || '');
+                formData.append('output_language', document.getElementById('output_language').value || '');
+                
+                // Send AJAX request to update language preference
+                const response = await fetch('{{ url_for("auth.account") }}', {
+                    method: 'POST',
+                    headers: {
+                        'X-Requested-With': 'XMLHttpRequest',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: formData
+                });
+                
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                // Store the new language in localStorage for other pages
+                localStorage.setItem('preferredLanguage', newLanguage);
+                localStorage.setItem('ui_language_changed', 'true');
+                
+                // Store current tab to restore after reload
+                const activeTab = document.querySelector('.tab-link.border-\\[var\\(--border-accent\\)\\]');
+                if (activeTab) {
+                    const tabName = activeTab.getAttribute('onclick')?.match(/show(\w+)Tab/)?.[1]?.toLowerCase();
+                    if (tabName) {
+                        localStorage.setItem('activeAccountTab', tabName);
+                    }
+                }
+                
+                // Reload the page to apply the new language completely
+                // This ensures all server-side rendered content is also updated
+                window.location.reload();
+                
+            } catch (error) {
+                console.error('Error updating language:', error);
+                alert('Failed to update language. Please try again.');
+                // Revert the dropdown to previous value if update failed
+                document.getElementById('ui_language').value = currentUILanguage;
+                document.getElementById('ui_language').disabled = false;
+                
+                // Restore original text if loading message was shown
+                const loadingMsg = document.getElementById('ui_language').parentElement.querySelector('p');
+                if (loadingMsg) {
+                    loadingMsg.textContent = originalText;
+                }
+            }
+        }
+        
+        // Function to apply the theme based on localStorage
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
+
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
     <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
-
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
+        /* Make the page take full height */
+        html, body {
+            height: 100%;
+            margin: 0;
+            padding: 0;
+        }
+
+        /* Container layout for full height */
+        .main-container {
+            min-height: 100vh;
+            display: flex;
+            flex-direction: column;
+        }
+
+        /* Tab content area with fixed height and scrolling */
+        .tab-content-wrapper {
+            height: calc(100vh - 280px); /* Adjust based on header and tab nav height */
+            overflow-y: auto;
+            overflow-x: hidden;
+        }
+
+        @media (max-width: 640px) {
+            .tab-content-wrapper {
+                height: calc(100vh - 320px); /* Slightly less height on mobile */
+            }
+        }
+
+        /* Ensure all tab content divs take full height */
+        .tab-content {
+            min-height: 100%;
+            display: flex;
+            flex-direction: column;
+        }
+
+        /* Custom scrollbar for content areas */
+        .tab-content-wrapper::-webkit-scrollbar {
+            width: 8px;
+        }
+
+        .tab-content-wrapper::-webkit-scrollbar-track {
+            background: transparent;
+        }
+
+        .tab-content-wrapper::-webkit-scrollbar-thumb {
+            background-color: var(--border-secondary);
+            border-radius: 4px;
+        }
+
+        .tab-content-wrapper::-webkit-scrollbar-thumb:hover {
+            background-color: var(--border-accent);
+        }
+
+        /* Horizontal scrollbar for tab navigation */
+        .tab-nav {
+            scrollbar-width: thin;
+            scrollbar-color: var(--border-secondary) transparent;
+        }
+
+        .tab-nav::-webkit-scrollbar {
+            height: 6px;
+        }
+
+        .tab-nav::-webkit-scrollbar-track {
+            background: transparent;
+        }
+
+        .tab-nav::-webkit-scrollbar-thumb {
+            background-color: var(--border-secondary);
+            border-radius: 3px;
+        }
+
+        .tab-nav::-webkit-scrollbar-thumb:hover {
+            background-color: var(--border-accent);
+        }
+
+
+
+        /* Custom scrollbar styling for Speakers Management */
+        #content-speakers .overflow-y-auto::-webkit-scrollbar {
+            width: 8px;
+        }
+        
+        #content-speakers .overflow-y-auto::-webkit-scrollbar-track {
+            background: transparent;
+            border-radius: 4px;
+        }
+        
+        #content-speakers .overflow-y-auto::-webkit-scrollbar-thumb {
+            background-color: var(--border-secondary);
+            border-radius: 4px;
+            transition: background-color 0.2s;
+        }
+        
+        #content-speakers .overflow-y-auto::-webkit-scrollbar-thumb:hover {
+            background-color: var(--border-accent);
+        }
+        
+        /* Ensure the content fits properly */
+        #content-speakers {
+            container-type: inline-size;
+        }
+        
+        /* Responsive grid adjustments */
+        @container (max-width: 640px) {
+            #speakersTabGrid {
+                grid-template-columns: 1fr;
+            }
+        }
+        
+        @container (min-width: 641px) and (max-width: 768px) {
+            #speakersTabGrid {
+                grid-template-columns: repeat(2, 1fr);
+            }
+        }
+        
+        @container (min-width: 769px) and (max-width: 1024px) {
+            #speakersTabGrid {
+                grid-template-columns: repeat(3, 1fr);
+            }
+        }
+        
+        @container (min-width: 1025px) {
+            #speakersTabGrid {
+                grid-template-columns: repeat(4, 1fr);
+            }
+        }
+        /* Hide scrollbar for tabs */
+        .scrollbar-hide {
+            -ms-overflow-style: none;
+            scrollbar-width: none;
+        }
+        .scrollbar-hide::-webkit-scrollbar {
+            display: none;
+        }
+
+        /* Custom themed audio player for speaker snippets */
+        .snippet-audio-container {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            padding: 6px 8px;
+            background: var(--bg-tertiary);
+            border: 1px solid var(--border-secondary);
+            border-radius: 6px;
+            width: 100%;
+        }
+
+        .snippet-audio-btn {
+            width: 24px;
+            height: 24px;
+            border-radius: 50%;
+            background: var(--bg-accent);
+            color: var(--text-accent);
+            border: none;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            cursor: pointer;
+            flex-shrink: 0;
+            font-size: 10px;
+            transition: opacity 0.2s;
+        }
+
+        .snippet-audio-btn:hover {
+            opacity: 0.8;
+        }
+
+        .snippet-audio-progress {
+            flex: 1;
+            height: 4px;
+            background: var(--bg-secondary);
+            border-radius: 2px;
+            position: relative;
+            cursor: pointer;
+            overflow: hidden;
+        }
+
+        .snippet-audio-progress-bar {
+            position: absolute;
+            left: 0;
+            top: 0;
+            height: 100%;
+            background: var(--bg-accent);
+            border-radius: 2px;
+            transition: width 0.1s linear;
+        }
+
+        .snippet-audio-time {
+            font-size: 10px;
+            color: var(--text-muted);
+            font-variant-numeric: tabular-nums;
+            flex-shrink: 0;
+        }
+
+        /* Hide the native audio element */
+        .snippet-audio {
+            display: none;
+        }
     </style>
 </head>
 <body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+    <div class="main-container container mx-auto px-4 sm:px-6 lg:px-8 py-6">
         <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
             <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/icon-192x192.png') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
             </h1>
             <div class="flex items-center space-x-2">
                 <button id="darkModeToggle" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200">
@@ -111,31 +413,80 @@ <h1 class="text-3xl font-bold text-[var(--text-primary)]">
                         <span>{{ current_user.username }}</span>
                         <i class="fas fa-chevron-down ml-2"></i>
                     </button>
-                    <div id="userDropdownMenu" class="hidden absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-home mr-2"></i> Home
+                    <div id="userDropdownMenu" class="hidden absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-50">
+                        <a href="{{ url_for('recordings.index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas fa-home mr-2"></i> <span data-i18n="nav.home">Home</span>
                         </a>
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
-                            <i class="fas fa-user-circle mr-2"></i> Account
+                        <a href="{{ url_for('auth.account') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
+                            <i class="fas fa-user-circle mr-2"></i> <span data-i18n="nav.account">Account</span>
                         </a>
-                        {% if current_user.is_admin %}
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
+                        {% if current_user.is_admin or is_team_admin %}
+                        <a href="{{ url_for('admin.admin') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas {% if current_user.is_admin %}fa-user-shield{% else %}fa-users-cog{% endif %} mr-2"></i>
+                            <span data-i18n="{% if current_user.is_admin %}nav.admin{% else %}nav.groupManagement{% endif %}">{% if current_user.is_admin %}Admin{% else %}Team Management{% endif %}</span>
                         </a>
                         {% endif %}
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
+                        <a href="{{ url_for('auth.logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
+                            <i class="fas fa-sign-out-alt mr-2"></i> <span data-i18n="nav.signOut">Logout</span>
                         </a>
                     </div>
                 </div>
             </div>
         </header>
 
-        <main class="flex-grow">
-            <div class="bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Account Information</h2>
-                
-                {% with messages = get_flashed_messages(with_categories=true) %}
+        <main class="flex-grow flex flex-col">
+            <div class="bg-[var(--bg-secondary)] rounded-xl shadow-lg border border-[var(--border-primary)] flex flex-col flex-grow overflow-hidden">
+                <div class="border-b border-[var(--border-primary)]">
+                    <div class="relative">
+                        <!-- Scroll gradient indicators -->
+                        <div class="absolute left-0 top-0 bottom-0 w-12 bg-gradient-to-r from-[var(--bg-secondary)] to-transparent z-[1] opacity-0 transition-opacity duration-200 flex items-center justify-start cursor-pointer hover:bg-[var(--bg-tertiary)] hover:bg-opacity-30" id="left-scroll-indicator">
+                            <i class="fas fa-chevron-left text-[var(--text-muted)] ml-1"></i>
+                        </div>
+                        <div class="absolute right-0 top-0 bottom-0 w-12 bg-gradient-to-l from-[var(--bg-secondary)] to-transparent z-[1] opacity-100 transition-opacity duration-200 flex items-center justify-end cursor-pointer hover:bg-[var(--bg-tertiary)] hover:bg-opacity-30" id="right-scroll-indicator">
+                            <i class="fas fa-chevron-right text-[var(--text-muted)] mr-1"></i>
+                        </div>
+
+                        <nav class="tab-nav px-1 sm:px-4 lg:px-6 pt-3 sm:pt-4 lg:pt-6 pb-4 sm:pb-6 -mb-px overflow-x-auto scrollbar-hide" aria-label="Tabs" id="tabs-container">
+                            <div class="inline-flex gap-1 sm:gap-2">
+                        <a href="#" id="tab-account" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-[var(--border-accent)] text-[var(--text-accent)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-user-circle mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="account.title">Account</span>
+                        </a>
+                        <a href="#" id="tab-preferences" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-sliders-h mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.preferences">Preferences</span>
+                        </a>
+                        <a href="#" id="tab-prompts" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-cog mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.promptOptions">Prompts</span>
+                        </a>
+                        <a href="#" id="tab-shares" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-share-alt mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.sharedTranscripts">Shares</span>
+                        </a>
+                        <a href="#" id="tab-speakers" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-users mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.speakersManagement">Speakers</span>
+                        </a>
+                        <a href="#" id="tab-folders" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]" style="display: none;">
+                            <i class="fas fa-folder mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.folderManagement">Folder Management</span>
+                        </a>
+                        <a href="#" id="tab-tags" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-tags mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.tagManagement">Tags</span>
+                        </a>
+                        <a href="#" id="tab-templates" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-file-alt mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.templates">Templates</span>
+                        </a>
+                        <a href="#" id="tab-tokens" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-key mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.apiTokens">API Tokens</span>
+                        </a>
+                        <a href="#" id="tab-about" class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)] rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                            <i class="fas fa-info-circle mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span data-i18n="accountTabs.about">About</span>
+                        </a>
+                            </div>
+                        </nav>
+                    </div>
+                </div>
+
+                <div class="tab-content-wrapper px-4 sm:px-6 lg:px-8 pb-4 sm:pb-6 lg:pb-8">
+                    <div id="content-account" class="tab-content pt-6">
+                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6" data-i18n="account.title">Account Information</h2>
+                    {% with messages = get_flashed_messages(with_categories=true) %}
                     {% if messages %}
                         {% for category, message in messages %}
                             <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
@@ -146,198 +497,7016 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Account Infor
                 {% endwith %}
                 
                 <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+                    <!-- Left Column: Form -->
                     <div>
-                        <div class="mb-6">
-                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">User Details</h3>
+                        <form id="accountInfoForm" method="POST" action="{{ url_for('auth.account') }}" class="space-y-6">
+                            <div class="mb-6">
+                                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                                <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2" data-i18n="account.personalInfo">Personal Information</h3>
+                                <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] space-y-4">
+                                    <div>
+                                        <label for="user_name" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.fullName">Full Name</label>
+                                        <input type="text" name="user_name" id="user_name" value="{{ current_user.name or '' }}" data-i18n-placeholder="form.yourFullName" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    </div>
+                                    <div>
+                                        <label for="user_job_title" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.jobTitle">Job Title</label>
+                                        <input type="text" name="user_job_title" id="user_job_title" value="{{ current_user.job_title or '' }}" placeholder="e.g., Software Engineer" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    </div>
+                                    <div>
+                                        <label for="user_company" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.companyOrganization">Company / Organization</label>
+                                        <input type="text" name="user_company" id="user_company" value="{{ current_user.company or '' }}" placeholder="e.g., Acme Corp" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    </div>
+                                </div>
+                            </div>
+
+                            <button type="submit" class="w-full inline-flex items-center justify-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                <i class="fas fa-save mr-2"></i> <span data-i18n="account.saveAllPreferences">Save All Preferences</span>
+                            </button>
+                        </form>
+                    </div>
+                    
+                    <!-- Right Column: Stats, User Details, Account Actions -->
+                    <div class="space-y-6">
+                        <div>
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2" data-i18n="account.statistics">Account Statistics</h3>
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                                <div class="grid grid-cols-2 gap-4">
+                                    <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                        <span class="block text-3xl font-bold text-[var(--text-accent)]">{{ current_user.recordings|length }}</span>
+                                        <span class="block text-sm text-[var(--text-muted)]" data-i18n="account.totalRecordings">Total Recordings</span>
+                                    </div>
+                                    
+                                    <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                        <span class="block text-3xl font-bold text-[var(--text-accent)]">
+                                            {% set completed_count = current_user.recordings|selectattr('status', 'equalto', 'COMPLETED')|list|length %}
+                                            {{ completed_count }}
+                                        </span>
+                                        <span class="block text-sm text-[var(--text-muted)]" data-i18n="account.completedRecordings">Completed</span>
+                                    </div>
+                                    
+                                    <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                        <span class="block text-3xl font-bold text-[var(--text-warn-strong)]">
+                                            {% set processing_count = current_user.recordings|selectattr('status', 'in', ['PENDING', 'PROCESSING', 'SUMMARIZING'])|list|length %}
+                                            {{ processing_count }}
+                                        </span>
+                                        <span class="block text-sm text-[var(--text-muted)]" data-i18n="account.processingRecordings">Processing</span>
+                                    </div>
+                                    
+                                    <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                        <span class="block text-3xl font-bold text-[var(--text-danger)]">
+                                            {% set failed_count = current_user.recordings|selectattr('status', 'equalto', 'FAILED')|list|length %}
+                                            {{ failed_count }}
+                                        </span>
+                                        <span class="block text-sm text-[var(--text-muted)]" data-i18n="account.failedRecordings">Failed</span>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="mt-6"> <!-- Added mt-6 for spacing, was mb-6 on User Details -->
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2" data-i18n="account.userDetails">User Details</h3>
                             <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
                                 <div class="mb-3">
-                                    <span class="block text-sm font-medium text-[var(--text-muted)]">Username</span>
+                                    <span class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.username">Username</span>
                                     <span class="block text-[var(--text-primary)]">{{ current_user.username }}</span>
                                 </div>
-                                <div>
+                                <div class="mb-3">
                                     <span class="block text-sm font-medium text-[var(--text-muted)]">Email</span>
                                     <span class="block text-[var(--text-primary)]">{{ current_user.email }}</span>
                                 </div>
                             </div>
                         </div>
+
+                        {% if sso_enabled %}
+                        <div class="mt-6">
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">Single Sign-On</h3>
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] space-y-3">
+                                <div class="flex items-center justify-between">
+                                    <div>
+                                        <span class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.ssoProvider">Provider</span>
+                                        <span class="block text-[var(--text-primary)]">{{ sso_provider_name }}</span>
+                                    </div>
+                                    {% if sso_linked %}
+                                    <span class="px-2 py-1 text-xs rounded bg-[var(--bg-success-light)] text-[var(--text-success-strong)]" data-i18n="account.ssoLinked">Linked</span>
+                                    {% else %}
+                                    <span class="px-2 py-1 text-xs rounded bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]" data-i18n="account.ssoNotLinked">Not linked</span>
+                                    {% endif %}
+                                </div>
+
+                                {% if sso_linked %}
+                                <div class="text-xs text-[var(--text-muted)] break-all">
+                                    <span class="font-medium text-[var(--text-secondary)]" data-i18n="account.ssoSubject">Subject:</span> {{ sso_subject }}
+                                </div>
+                                {% if has_password %}
+                                <form method="POST" action="{{ url_for('auth.sso_unlink') }}" class="mt-2">
+                                    <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                                    <button type="submit" onclick="return confirm(t('account.ssoUnlinkConfirm'))" class="w-full inline-flex items-center justify-center px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                        <i class="fas fa-unlink mr-2"></i> <span data-i18n="account.ssoUnlinkAccount" data-i18n-params='{"provider": "{{ sso_provider_name }}"}'>Unlink {{ sso_provider_name }} account</span>
+                                    </button>
+                                </form>
+                                {% elif not password_login_disabled or current_user.is_admin %}
+                                <div class="mt-2 text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-info-circle mr-1"></i> <span data-i18n="account.ssoSetPasswordFirst">To unlink SSO, you must first set a password.</span>
+                                </div>
+                                {% endif %}
+                                {% else %}
+                                <form method="POST" action="{{ url_for('auth.sso_link') }}" class="mt-2">
+                                    <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                                    <button type="submit" class="w-full inline-flex items-center justify-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                        <i class="fas fa-link mr-2"></i> <span data-i18n="account.ssoLinkAccount" data-i18n-params='{"provider": "{{ sso_provider_name }}"}'>Link {{ sso_provider_name }} account</span>
+                                    </button>
+                                </form>
+                                {% endif %}
+                            </div>
+                        </div>
+                        {% endif %}
                         
-                        <div>
-                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">Account Actions</h3>
+                        <div class="mt-6"> <!-- Added mt-6 for spacing, was mt-8 on Account Actions -->
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2" data-i18n="account.accountActions">Account Actions</h3>
                             <div class="flex flex-col space-y-3">
-                                <a href="{{ url_for('index') }}" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
-                                    <i class="fas fa-microphone mr-2"></i> Go to Recordings
+                                <a href="{{ url_for('recordings.index') }}" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-microphone mr-2"></i> <span data-i18n="account.goToRecordings">Go to Recordings</span>
                                 </a>
+                                {% if not password_login_disabled or current_user.is_admin %}
                                 <button id="changePasswordBtn" class="inline-flex items-center px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
-                                    <i class="fas fa-key mr-2"></i> Change Password
+                                    <i class="fas fa-key mr-2"></i> <span data-i18n="account.changePassword">{% if has_password %}Change Password{% else %}Set Password{% endif %}</span>
                                 </button>
+                                {% endif %}
                             </div>
                         </div>
                     </div>
-                    
-                    <div>
-                        <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2">Account Statistics</h3>
-                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
-                            <div class="grid grid-cols-2 gap-4">
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-accent)]">{{ current_user.recordings|length }}</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Total Recordings</span>
-                                </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-accent)]">
-                                        {% set completed_count = current_user.recordings|selectattr('status', 'equalto', 'COMPLETED')|list|length %}
-                                        {{ completed_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Completed</span>
+                </div>
+                </div>
+
+                    <div id="content-prompts" class="hidden tab-content pt-6">
+                    <!-- Header with Auto-summarization toggle -->
+                    <div class="flex items-center justify-between mb-6">
+                        <h2 class="text-2xl font-semibold text-[var(--text-primary)]" data-i18n="accountTabs.promptOptions">Prompt Options</h2>
+                        {% if not admin_disabled_auto_summarization %}
+                        <div class="flex items-center gap-3" title="Automatically generate summaries after transcription completes">
+                            <span class="text-sm text-[var(--text-secondary)]" data-i18n="account.autoSummarize">Auto-summarize</span>
+                            <label class="relative inline-flex items-center cursor-pointer">
+                                <input type="checkbox" id="autoSummarizationToggle" class="sr-only peer" {% if auto_summarization %}checked{% endif %}>
+                                <div class="w-11 h-6 bg-[var(--bg-tertiary)] peer-focus:outline-none peer-focus:ring-2 peer-focus:ring-[var(--border-focus)] rounded-full peer peer-checked:after:translate-x-full rtl:peer-checked:after:-translate-x-full after:content-[''] after:absolute after:top-[2px] after:start-[2px] after:bg-[var(--text-muted)] after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-[var(--bg-accent)] peer-checked:after:bg-white"></div>
+                            </label>
+                        </div>
+                        {% else %}
+                        <div class="text-sm text-[var(--text-muted)] italic" title="Auto-summarization has been disabled by the administrator">
+                            <i class="fas fa-lock mr-1"></i> <span data-i18n="account.autoSummarizationDisabled">Auto-summarization disabled by admin</span>
+                        </div>
+                        {% endif %}
+                    </div>
+
+                    <form id="customPromptsForm" method="POST" action="{{ url_for('auth.account') }}" class="space-y-6">
+                        <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+
+                        <!-- Event Extraction Settings -->
+                        <div class="bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)]">
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">
+                                <i class="fas fa-calendar-alt mr-2"></i>
+                                <span data-i18n="eventExtraction.title">Event Extraction</span>
+                            </h3>
+
+                            <div class="mb-4">
+                                <label class="flex items-start space-x-3">
+                                    <input type="checkbox" name="extract_events" id="extract_events"
+                                        {% if current_user.extract_events %}checked{% endif %}
+                                        class="mt-1 h-4 w-4 text-[var(--border-accent)] focus:ring-[var(--border-focus)] border-[var(--border-secondary)] rounded">
+                                    <div>
+                                        <span class="block text-sm font-medium text-[var(--text-primary)]" data-i18n="eventExtraction.enableLabel">
+                                            Enable automatic event extraction from transcripts
+                                        </span>
+                                        <span class="block text-xs text-[var(--text-muted)] mt-1" data-i18n="eventExtraction.description">
+                                            When enabled, the AI will identify meetings, appointments, and deadlines mentioned in your recordings and create downloadable calendar events.
+                                        </span>
+                                    </div>
+                                </label>
+                            </div>
+
+                            <div class="mt-4 p-3 bg-[var(--bg-info-light)] text-[var(--text-info-strong)] rounded-lg text-sm">
+                                <i class="fas fa-info-circle mr-1"></i>
+                                <span data-i18n="eventExtraction.info">
+                                    Extracted events will appear in a new "Events" tab on recordings where calendar items are detected.
+                                </span>
+                            </div>
+                        </div>
+
+                        <!-- Custom Prompts Section -->
+                        <div class="bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)]">
+                            <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4" data-i18n="customPrompts.summaryGeneration">Summary Generation Prompt</h3>
+                            
+                            <div class="mb-4">
+                                <label for="summary_prompt_custom" class="block text-sm font-medium text-[var(--text-muted)] mb-2">
+                                    <span data-i18n="customPrompts.yourCustomPrompt">Your Custom Summary Prompt</span>
+                                </label>
+                                <textarea name="summary_prompt" id="summary_prompt_custom" rows="8"
+                                    placeholder="Describe how you want your summaries structured. Leave blank to use the admin's default prompt."
+                                    data-i18n-placeholder="customPrompts.promptPlaceholder"
+                                    class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">{{ current_user.summary_prompt or '' }}</textarea>
+                                <p class="text-xs text-[var(--text-light)] mt-2">
+                                    <span data-i18n="customPrompts.promptDescription">This prompt will be used to generate summaries for your transcriptions. It overrides the admin's default prompt.</span>
+                                </p>
+                            </div>
+                            
+                            <div class="mt-6 p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-secondary)]">
+                                <h4 class="text-sm font-semibold text-[var(--text-accent)] mb-2">
+                                    <i class="fas fa-info-circle mr-1"></i>
+                                    <span data-i18n="customPrompts.currentDefaultPrompt">Current Default Prompt (Used if you leave the above blank)</span>
+                                </h4>
+                                <div class="bg-[var(--bg-primary)] p-3 rounded border border-[var(--border-primary)]">
+                                    <pre id="currentDefaultPromptDisplay" class="text-xs text-[var(--text-muted)] whitespace-pre-wrap font-mono">{{ default_summary_prompt_text }}</pre>
                                 </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-warn-strong)]">
-                                        {% set processing_count = current_user.recordings|selectattr('status', 'in', ['PENDING', 'PROCESSING', 'SUMMARIZING'])|list|length %}
-                                        {{ processing_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Processing</span>
+                            </div>
+
+                            {# Full LLM prompt structure preview — mirrors the one on /admin so users
+                               can see the system message, transcript wrapper, and language directive
+                               that get prepended/appended to their summarisation instructions. #}
+                            <div class="mt-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-secondary)]">
+                                <button type="button" id="toggleFullPromptStructure"
+                                        class="w-full px-4 py-3 flex justify-between items-center text-sm text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors duration-200 rounded-lg">
+                                    <span><i class="fas fa-code mr-2"></i><span data-i18n="adminDashboard.viewFullPromptStructure">View Full LLM Prompt Structure</span></span>
+                                    <i id="fullPromptChevron" class="fas fa-chevron-down text-[var(--text-muted)]"></i>
+                                </button>
+                                <div id="fullPromptStructureBody" class="hidden border-t border-[var(--border-secondary)] p-4 space-y-4">
+                                    <div class="flex flex-wrap items-center gap-3 text-xs text-[var(--text-secondary)]">
+                                        <span class="font-medium" data-i18n="preview.placeholderLegend">Placeholder legend:</span>
+                                        <span class="inline-flex items-center gap-1.5">
+                                            <span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-blue-500/15 text-blue-300 border border-blue-500/30 font-mono">{example}</span>
+                                            <span data-i18n="preview.systemReplaced">system-replaced (current date, transcript, tag names, etc.)</span>
+                                        </span>
+                                        <span class="inline-flex items-center gap-1.5">
+                                            <span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-amber-500/15 text-amber-300 border border-amber-500/30 font-mono">{% raw %}{{example}}{% endraw %}</span>
+                                            <span data-i18n="preview.userSupplied">user-supplied at upload or reprocess</span>
+                                        </span>
+                                    </div>
+
+                                    <div>
+                                        <h5 class="text-xs font-semibold text-[var(--text-accent)] mb-1" data-i18n="adminDashboard.systemPrompt">System Prompt:</h5>
+                                        <div class="bg-[var(--bg-primary)] p-3 rounded border border-[var(--border-primary)]">
+                                            <pre id="previewSystemPrompt" class="text-xs text-[var(--text-secondary)] whitespace-pre-wrap font-mono"></pre>
+                                        </div>
+                                    </div>
+
+                                    <div>
+                                        <h5 class="text-xs font-semibold text-[var(--text-accent)] mb-1" data-i18n="preview.userMessageHeading">User Message:</h5>
+                                        <div class="bg-[var(--bg-primary)] p-3 rounded border border-[var(--border-primary)]">
+                                            <pre id="previewUserMessage" class="text-xs text-[var(--text-secondary)] whitespace-pre-wrap font-mono"></pre>
+                                        </div>
+                                        <p class="text-xs text-[var(--text-muted)] mt-2">
+                                            <i class="fas fa-info-circle mr-1"></i>
+                                            <span data-i18n="preview.liveUpdateNote">The Summarization Instructions slot updates as you edit your custom prompt above. Placeholders are replaced with real values when a recording is processed.</span>
+                                        </p>
+                                    </div>
                                 </div>
-                                
-                                <div class="text-center p-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
-                                    <span class="block text-3xl font-bold text-[var(--text-danger)]">
-                                        {% set failed_count = current_user.recordings|selectattr('status', 'equalto', 'FAILED')|list|length %}
-                                        {{ failed_count }}
-                                    </span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Failed</span>
+                            </div>
+
+                            <div class="mt-4">
+                                <details class="cursor-pointer">
+                                    <summary class="text-sm text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]">
+                                        <i class="fas fa-question-circle mr-1"></i>
+                                        <span data-i18n="customPrompts.tipsTitle">Tips for Writing Effective Prompts</span>
+                                    </summary>
+                                    <div class="mt-3 p-3 bg-[var(--bg-info-light)] text-[var(--text-info-strong)] rounded-lg text-sm">
+                                        <ul class="list-disc list-inside space-y-1">
+                                            <li data-i18n="customPrompts.tip1">Be specific about the sections you want in your summary</li>
+                                            <li data-i18n="customPrompts.tip2">Use clear formatting instructions (e.g., "Use bullet points", "Create numbered lists")</li>
+                                            <li data-i18n="customPrompts.tip3">Specify if you want certain information prioritized</li>
+                                            <li data-i18n="customPrompts.tip4">The system will automatically provide the transcript content to the AI</li>
+                                            <li data-i18n="customPrompts.tip5">Your output language preference (if set) will be applied automatically</li>
+                                        </ul>
+                                    </div>
+                                </details>
+                            </div>
+
+                            <!-- Transcription Hints Section -->
+                            <div class="mt-8 pt-6 border-t border-[var(--border-secondary)]">
+                                <h3 class="text-base font-semibold text-[var(--text-primary)] mb-1">
+                                    <i class="fas fa-spell-check mr-2 text-[var(--text-accent)]"></i>
+                                    <span data-i18n="account.transcriptionHints">Transcription Hints</span>
+                                </h3>
+                                <p class="text-xs text-[var(--text-muted)] mb-4" data-i18n="account.transcriptionHintsDesc">
+                                    These defaults are used when no tag or folder overrides are set. They help improve transcription accuracy for your specific use case.
+                                </p>
+
+                                <div class="space-y-4">
+                                    <div>
+                                        <label for="transcription_hotwords" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="account.defaultHotwords">
+                                            Default Hotwords
+                                        </label>
+                                        <input type="text" name="transcription_hotwords" id="transcription_hotwords"
+                                               value="{{ current_user.transcription_hotwords or '' }}"
+                                               data-i18n-placeholder="account.defaultHotwordsPlaceholder"
+                                               placeholder="e.g., Speakr, CTranslate2, PyAnnote, SDRs"
+                                               class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="help.defaultHotwordsHelp">
+                                            Comma-separated words or phrases that the transcription model should prioritize recognizing (brand names, acronyms, technical terms).
+                                        </p>
+                                    </div>
+
+                                    <div>
+                                        <label for="transcription_initial_prompt" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="account.defaultInitialPrompt">
+                                            Default Initial Prompt
+                                        </label>
+                                        <textarea name="transcription_initial_prompt" id="transcription_initial_prompt" rows="2"
+                                                  data-i18n-placeholder="account.defaultInitialPromptPlaceholder"
+                                                  placeholder="e.g., This is a meeting about AI transcription tools. The speakers discuss CTranslate2, PyAnnote, and SDRs."
+                                                  class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">{{ current_user.transcription_initial_prompt or '' }}</textarea>
+                                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="help.defaultInitialPromptHelp">
+                                            Context to steer the transcription model's style and vocabulary. Describe the topic or expected content of your recordings.
+                                        </p>
+                                    </div>
                                 </div>
                             </div>
                         </div>
-                    </div>
+
+                        <div class="flex justify-end">
+                            <button type="submit" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                <i class="fas fa-save mr-2"></i> <span data-i18n="buttons.saveSettings">Save Settings</span>
+                            </button>
+                        </div>
+                    </form>
                 </div>
-            </div>
-        </main>
 
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; {{ now.year }}
-        </footer>
-    </div>
+                    <div id="content-preferences" class="hidden tab-content pt-6">
+                        <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-2" data-i18n="accountTabs.preferences">Preferences</h2>
+                        <p class="text-sm text-[var(--text-muted)] mb-6" data-i18n="preferences.description">Display and editor behaviour preferences. These settings are saved to your account and apply across devices.</p>
 
-    <!-- Change Password Modal -->
-    <div id="changePasswordModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
-        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
-            <div class="flex justify-between items-center mb-4">
-                <h3 class="text-xl font-semibold text-[var(--text-primary)]">Change Password</h3>
-                <button id="closeModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
-            </div>
-            <form id="changePasswordForm" method="POST" action="{{ url_for('change_password') }}">
-                <div class="mb-4">
-                    <label for="current_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Current Password</label>
-                    <input type="password" id="current_password" name="current_password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                </div>
-                <div class="mb-4">
-                    <label for="new_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">New Password</label>
-                    <input type="password" id="new_password" name="new_password" required minlength="8" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    <p class="text-xs text-[var(--text-muted)] mt-1">Password must be at least 8 characters long</p>
-                </div>
-                <div class="mb-6">
-                    <label for="confirm_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Confirm New Password</label>
-                    <input type="password" id="confirm_password" name="confirm_password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <form id="preferencesForm" class="grid grid-cols-1 lg:grid-cols-2 gap-x-8 gap-y-4">
+                            <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                            <input type="hidden" name="preferences_form" value="1">
+
+                            <!-- Left column: Language Preferences -->
+                            <div class="space-y-4">
+                                <h3 class="text-sm font-semibold text-[var(--text-secondary)] uppercase tracking-wide" data-i18n="account.languagePreferences">Language Preferences</h3>
+                                <div class="space-y-4 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-md">
+                                    <div>
+                                        <label for="ui_language" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.interfaceLanguage">Interface Language</label>
+                                        <select name="ui_language" id="ui_language" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                            <option value="en" {% if current_user.ui_language == 'en' or not current_user.ui_language %}selected{% endif %}>English</option>
+                                            <option value="zh" {% if current_user.ui_language == 'zh' %}selected{% endif %}>中文 (Chinese)</option>
+                                            <option value="de" {% if current_user.ui_language == 'de' %}selected{% endif %}>Deutsch (German)</option>
+                                            <option value="es" {% if current_user.ui_language == 'es' %}selected{% endif %}>Español (Spanish)</option>
+                                            <option value="fr" {% if current_user.ui_language == 'fr' %}selected{% endif %}>Français (French)</option>
+                                            <option value="ru" {% if current_user.ui_language == 'ru' %}selected{% endif %}>Русский (Russian)</option>
+                                            <option value="pt-BR" {% if current_user.ui_language == 'pt-BR' %}selected{% endif %}>Português (Brasil)</option>
+                                        </select>
+                                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="account.chooseLanguageForInterface">Choose the language for the application interface.</p>
+                                    </div>
+                                    <div>
+                                        <label for="transcription_language" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.transcriptionLanguage">Transcription Language</label>
+                                        <select name="transcription_language" id="transcription_language" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                            <option value="" data-i18n="languages.autoDetect" {% if not current_user.transcription_language %}selected{% endif %}>Auto-detect</option>
+                                            <option value="en" data-i18n="languages.en" {% if current_user.transcription_language == 'en' %}selected{% endif %}>English</option>
+                                            <option value="es" data-i18n="languages.es" {% if current_user.transcription_language == 'es' %}selected{% endif %}>Spanish</option>
+                                            <option value="fr" data-i18n="languages.fr" {% if current_user.transcription_language == 'fr' %}selected{% endif %}>French</option>
+                                            <option value="de" data-i18n="languages.de" {% if current_user.transcription_language == 'de' %}selected{% endif %}>German</option>
+                                            <option value="it" data-i18n="languages.it" {% if current_user.transcription_language == 'it' %}selected{% endif %}>Italian</option>
+                                            <option value="pt" data-i18n="languages.pt" {% if current_user.transcription_language == 'pt' %}selected{% endif %}>Portuguese</option>
+                                            <option value="nl" data-i18n="languages.nl" {% if current_user.transcription_language == 'nl' %}selected{% endif %}>Dutch</option>
+                                            <option value="ru" data-i18n="languages.ru" {% if current_user.transcription_language == 'ru' %}selected{% endif %}>Russian</option>
+                                            <option value="zh" data-i18n="languages.zh" {% if current_user.transcription_language == 'zh' %}selected{% endif %}>Chinese</option>
+                                            <option value="ja" data-i18n="languages.ja" {% if current_user.transcription_language == 'ja' %}selected{% endif %}>Japanese</option>
+                                            <option value="ko" data-i18n="languages.ko" {% if current_user.transcription_language == 'ko' %}selected{% endif %}>Korean</option>
+                                            <option value="ar" data-i18n="languages.ar" {% if current_user.transcription_language == 'ar' %}selected{% endif %}>Arabic</option>
+                                            <option value="hi" data-i18n="languages.hi" {% if current_user.transcription_language == 'hi' %}selected{% endif %}>Hindi</option>
+                                            <option value="pl" data-i18n="languages.pl" {% if current_user.transcription_language == 'pl' %}selected{% endif %}>Polish</option>
+                                            <option value="uk" data-i18n="languages.uk" {% if current_user.transcription_language == 'uk' %}selected{% endif %}>Ukrainian</option>
+                                            <option value="vi" data-i18n="languages.vi" {% if current_user.transcription_language == 'vi' %}selected{% endif %}>Vietnamese</option>
+                                            <option value="th" data-i18n="languages.th" {% if current_user.transcription_language == 'th' %}selected{% endif %}>Thai</option>
+                                            <option value="tr" data-i18n="languages.tr" {% if current_user.transcription_language == 'tr' %}selected{% endif %}>Turkish</option>
+                                            <option value="id" data-i18n="languages.id" {% if current_user.transcription_language == 'id' %}selected{% endif %}>Indonesian</option>
+                                            <option value="sv" data-i18n="languages.sv" {% if current_user.transcription_language == 'sv' %}selected{% endif %}>Swedish</option>
+                                            <option value="pt-BR" data-i18n="languages.pt-BR" {% if current_user.transcription_language == 'pt-BR' %}selected{% endif %}>Portuguese (Brazilian)</option>
+                                        </select>
+                                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="account.leaveBlankForAutoDetect">Select auto-detect to let the transcription service determine the language.</p>
+                                    </div>
+                                    <div>
+                                        <label for="output_language" class="block text-sm font-medium text-[var(--text-muted)]" data-i18n="account.preferredOutputLanguage">Preferred Output Language</label>
+                                        <select name="output_language" id="output_language" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                            <option value="" data-i18n="languages.defaultModelDecides" {% if not current_user.output_language %}selected{% endif %}>Default (model decides)</option>
+                                            <option value="English" data-i18n="languages.en" {% if current_user.output_language == 'English' %}selected{% endif %}>English</option>
+                                            <option value="Spanish" data-i18n="languages.es" {% if current_user.output_language == 'Spanish' %}selected{% endif %}>Spanish</option>
+                                            <option value="French" data-i18n="languages.fr" {% if current_user.output_language == 'French' %}selected{% endif %}>French</option>
+                                            <option value="German" data-i18n="languages.de" {% if current_user.output_language == 'German' %}selected{% endif %}>German</option>
+                                            <option value="Italian" data-i18n="languages.it" {% if current_user.output_language == 'Italian' %}selected{% endif %}>Italian</option>
+                                            <option value="Portuguese" data-i18n="languages.pt" {% if current_user.output_language == 'Portuguese' %}selected{% endif %}>Portuguese</option>
+                                            <option value="Dutch" data-i18n="languages.nl" {% if current_user.output_language == 'Dutch' %}selected{% endif %}>Dutch</option>
+                                            <option value="Russian" data-i18n="languages.ru" {% if current_user.output_language == 'Russian' %}selected{% endif %}>Russian</option>
+                                            <option value="Chinese" data-i18n="languages.zh" {% if current_user.output_language == 'Chinese' %}selected{% endif %}>Chinese</option>
+                                            <option value="Japanese" data-i18n="languages.ja" {% if current_user.output_language == 'Japanese' %}selected{% endif %}>Japanese</option>
+                                            <option value="Korean" data-i18n="languages.ko" {% if current_user.output_language == 'Korean' %}selected{% endif %}>Korean</option>
+                                            <option value="Arabic" data-i18n="languages.ar" {% if current_user.output_language == 'Arabic' %}selected{% endif %}>Arabic</option>
+                                            <option value="Hindi" data-i18n="languages.hi" {% if current_user.output_language == 'Hindi' %}selected{% endif %}>Hindi</option>
+                                            <option value="Polish" data-i18n="languages.pl" {% if current_user.output_language == 'Polish' %}selected{% endif %}>Polish</option>
+                                            <option value="Ukrainian" data-i18n="languages.uk" {% if current_user.output_language == 'Ukrainian' %}selected{% endif %}>Ukrainian</option>
+                                            <option value="Vietnamese" data-i18n="languages.vi" {% if current_user.output_language == 'Vietnamese' %}selected{% endif %}>Vietnamese</option>
+                                            <option value="Thai" data-i18n="languages.th" {% if current_user.output_language == 'Thai' %}selected{% endif %}>Thai</option>
+                                            <option value="Turkish" data-i18n="languages.tr" {% if current_user.output_language == 'Turkish' %}selected{% endif %}>Turkish</option>
+                                            <option value="Indonesian" data-i18n="languages.id" {% if current_user.output_language == 'Indonesian' %}selected{% endif %}>Indonesian</option>
+                                            <option value="Swedish" data-i18n="languages.sv" {% if current_user.output_language == 'Swedish' %}selected{% endif %}>Swedish</option>
+                                            <option value="Portuguese (Brazilian)" data-i18n="languages.pt-BR" {% if current_user.output_language == 'Portuguese (Brazilian)' %}selected{% endif %}>Portuguese (Brazilian)</option>
+                                        </select>
+                                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="account.languageForSummaries">Language for titles, summaries, and chat. Leave on Default to follow the model's own behaviour.</p>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Right column: Display + Editor toggles -->
+                            <div class="space-y-4">
+                                <h3 class="text-sm font-semibold text-[var(--text-secondary)] uppercase tracking-wide" data-i18n="preferences.transcriptDisplay">Transcript display</h3>
+                                <label class="flex items-start gap-3 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-md cursor-pointer hover:bg-[var(--bg-accent-hover)]">
+                                    <input type="checkbox" id="prefShowTimestampsSimpleView" name="show_timestamps_simple_view" {% if current_user.show_timestamps_simple_view %}checked{% endif %} class="mt-1 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)] bg-[var(--bg-input)]">
+                                    <span class="flex-1">
+                                        <span class="block text-sm font-medium text-[var(--text-primary)]" data-i18n="preferences.showTimestampsSimpleView">Show timestamps in simple view</span>
+                                        <span class="block text-xs text-[var(--text-muted)] mt-0.5" data-i18n="preferences.showTimestampsSimpleViewHelp">Display a compact <code>mm:ss</code> timestamp next to each speaker label in the simple transcript view. The bubble view is unaffected.</span>
+                                    </span>
+                                </label>
+
+                                <h3 class="text-sm font-semibold text-[var(--text-secondary)] uppercase tracking-wide pt-4" data-i18n="preferences.transcriptEditor">Transcript editor</h3>
+                                <label class="flex items-start gap-3 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-md cursor-pointer hover:bg-[var(--bg-accent-hover)]">
+                                    <input type="checkbox" id="prefEditorAutosave" name="editor_autosave" {% if current_user.editor_autosave %}checked{% endif %} class="mt-1 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)] bg-[var(--bg-input)]">
+                                    <span class="flex-1">
+                                        <span class="block text-sm font-medium text-[var(--text-primary)]" data-i18n="preferences.editorAutosave">Auto-save edits in the transcript editor</span>
+                                        <span class="block text-xs text-[var(--text-muted)] mt-0.5" data-i18n="preferences.editorAutosaveHelp">When enabled, edits in the transcript editor are saved automatically a couple of seconds after you stop typing. When disabled (default), you save explicitly via the Save buttons or <code>Ctrl+S</code>.</span>
+                                    </span>
+                                </label>
+                            </div>
+
+                            <!-- Save button spans both columns -->
+                            <div class="lg:col-span-2 flex justify-end pt-2">
+                                <button type="submit" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-save mr-2"></i> <span data-i18n="buttons.saveSettings">Save Settings</span>
+                                </button>
+                            </div>
+                        </form>
+                    </div>
+
+                    <div id="content-shares" class="hidden tab-content pt-6">
+                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6" data-i18n="accountTabs.sharedTranscripts">Shared Transcripts</h2>
+                    <div id="shares-container" class="space-y-4">
+                        <!-- Shares will be loaded here by JavaScript -->
+                    </div>
                 </div>
-                <div class="flex justify-end space-x-3">
-                    <button type="button" id="cancelBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                    <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Change Password</button>
+
+                    <div id="content-speakers" class="hidden tab-content pt-6 flex flex-col h-full">
+                    <!-- Header with Auto-label toggle -->
+                    <div class="flex-shrink-0 mb-4 flex items-center justify-between">
+                        <div>
+                            <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-1" data-i18n="accountTabs.speakersManagement">Speakers Management</h2>
+                            <p class="text-sm text-[var(--text-secondary)] hidden sm:block" data-i18n="speakersManagement.description">Manage your saved speakers. These are automatically saved when you use speaker names in your recordings.</p>
+                        </div>
+                        {% if speaker_embeddings_enabled %}
+                        <div class="flex items-center gap-2 sm:gap-3 ml-4 flex-shrink-0" title="Automatically label speakers in new recordings when voice profiles match">
+                            <span class="text-sm text-[var(--text-secondary)] hidden sm:inline" data-i18n="account.autoLabel">Auto-label</span>
+                            <label class="relative inline-flex items-center cursor-pointer">
+                                <input type="checkbox" id="autoSpeakerLabellingToggle" class="sr-only peer" {% if auto_speaker_labelling %}checked{% endif %}>
+                                <div class="w-11 h-6 bg-[var(--bg-tertiary)] peer-focus:outline-none peer-focus:ring-2 peer-focus:ring-[var(--border-focus)] rounded-full peer peer-checked:after:translate-x-full rtl:peer-checked:after:-translate-x-full after:content-[''] after:absolute after:top-[2px] after:start-[2px] after:bg-[var(--text-muted)] after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-[var(--bg-accent)] peer-checked:after:bg-white"></div>
+                            </label>
+                            <select id="autoSpeakerLabellingThreshold" class="text-sm bg-[var(--bg-secondary)] border border-[var(--border-secondary)] rounded-md px-2 py-1 text-[var(--text-primary)] focus:ring-2 focus:ring-blue-500 disabled:opacity-50 disabled:cursor-not-allowed" {% if not auto_speaker_labelling %}disabled{% endif %}>
+                                <option value="high" {% if auto_speaker_labelling_threshold == 'high' %}selected{% endif %}>High</option>
+                                <option value="medium" {% if auto_speaker_labelling_threshold == 'medium' %}selected{% endif %}>Medium</option>
+                                <option value="low" {% if auto_speaker_labelling_threshold == 'low' %}selected{% endif %}>Low</option>
+                            </select>
+                        </div>
+                        {% endif %}
+                    </div>
+
+                    <!-- Top toolbar with bulk actions -->
+                    <div class="flex-shrink-0 flex flex-wrap justify-between items-center gap-2 py-2 sm:py-3 px-3 sm:px-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] mb-3">
+                        <div class="flex items-center gap-2 sm:gap-4">
+                            <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                                <input type="checkbox" id="selectAllSpeakersTop" class="select-all-checkbox mr-1.5 sm:mr-2 rounded border-gray-300 dark:border-gray-600 text-blue-600 focus:ring-blue-500">
+                                <span class="hidden sm:inline">Select All</span>
+                                <span class="sm:hidden">All</span>
+                            </label>
+                            <span class="text-sm text-[var(--text-muted)]">
+                                <span id="speakersTabCountTop" class="speakers-count">0</span> <span class="hidden sm:inline" data-i18n="speakersManagement.totalSpeakers">speakers saved</span>
+                            </span>
+                            <input type="text" id="speakerSearchInput" placeholder="Filter by name..." class="speaker-search-input px-2 py-1 text-sm rounded-md border border-[var(--border-primary)] bg-[var(--bg-primary)] text-[var(--text-primary)] placeholder-[var(--text-light)] focus:outline-none focus:border-[var(--border-accent)] focus:ring-1 focus:ring-[var(--border-accent)] w-32 sm:w-40" autocomplete="off">
+                        </div>
+                        <div class="flex space-x-1 sm:space-x-2">
+                            <button class="bulk-delete-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-red-600 dark:bg-red-500 text-white rounded-md hover:bg-red-700 dark:hover:bg-red-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Delete">
+                                <i class="fas fa-trash"></i>
+                                <span class="hidden sm:inline ml-1">Delete</span>
+                            </button>
+                            <button class="bulk-clear-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-orange-600 dark:bg-orange-500 text-white rounded-md hover:bg-orange-700 dark:hover:bg-orange-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Clear Profiles">
+                                <i class="fas fa-eraser"></i>
+                                <span class="hidden sm:inline ml-1">Clear</span>
+                            </button>
+                            <button class="bulk-merge-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-md hover:bg-[var(--bg-accent-hover)] disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Merge">
+                                <i class="fas fa-object-group"></i>
+                                <span class="hidden sm:inline ml-1">Merge</span>
+                            </button>
+                        </div>
+                    </div>
+
+                    <!-- Scrollable content area -->
+                    <div class="flex-1 overflow-y-auto min-h-0 pr-2" style="scrollbar-width: thin; scrollbar-color: var(--border-secondary) transparent;">
+                        <!-- Loading state -->
+                        <div id="speakersTabLoading" class="text-center py-8 hidden">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="text-[var(--text-muted)] mt-2" data-i18n="speakersManagement.loadingSpeakers">Loading speakers...</p>
+                        </div>
+
+                        <!-- Error state -->
+                        <div id="speakersTabError" class="hidden bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] p-3 rounded-lg mb-4">
+                            <i class="fas fa-exclamation-triangle mr-2"></i>
+                            <span id="speakersTabErrorMessage" data-i18n="speakersManagement.failedToLoad">Failed to load speakers</span>
+                        </div>
+
+                        <!-- Empty state -->
+                        <div id="speakersTabEmpty" class="text-center py-12 hidden">
+                            <i class="fas fa-users text-4xl text-[var(--text-light)] mb-4"></i>
+                            <p class="text-[var(--text-muted)] text-lg mb-2" data-i18n="speakersManagement.noSpeakersYet">No speakers saved yet</p>
+                            <p class="text-sm text-[var(--text-light)]" data-i18n="speakersManagement.speakersWillAppear">Speakers will appear here when you use speaker names in your recordings</p>
+                        </div>
+
+                        <!-- Speakers grid -->
+                        <div id="speakersTabGrid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5 gap-3">
+                            <!-- Speakers will be populated here -->
+                        </div>
+                    </div>
+
+                    <!-- Bottom toolbar with bulk actions -->
+                    <div class="flex-shrink-0 flex flex-wrap justify-between items-center gap-2 py-2 sm:py-3 px-3 sm:px-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] mt-3">
+                        <div class="flex items-center gap-2 sm:gap-4">
+                            <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                                <input type="checkbox" id="selectAllSpeakersBottom" class="select-all-checkbox mr-1.5 sm:mr-2 rounded border-gray-300 dark:border-gray-600 text-blue-600 focus:ring-blue-500">
+                                <span class="hidden sm:inline">Select All</span>
+                                <span class="sm:hidden">All</span>
+                            </label>
+                            <span class="text-sm text-[var(--text-muted)]">
+                                <span id="speakersTabCountBottom" class="speakers-count">0</span> <span class="hidden sm:inline" data-i18n="speakersManagement.totalSpeakers">speakers saved</span>
+                            </span>
+                        </div>
+                        <div class="flex space-x-1 sm:space-x-2">
+                            <button class="bulk-delete-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-red-600 dark:bg-red-500 text-white rounded-md hover:bg-red-700 dark:hover:bg-red-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Delete">
+                                <i class="fas fa-trash"></i>
+                                <span class="hidden sm:inline ml-1">Delete</span>
+                            </button>
+                            <button class="bulk-clear-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-orange-600 dark:bg-orange-500 text-white rounded-md hover:bg-orange-700 dark:hover:bg-orange-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Clear Profiles">
+                                <i class="fas fa-eraser"></i>
+                                <span class="hidden sm:inline ml-1">Clear</span>
+                            </button>
+                            <button class="bulk-merge-btn px-2 sm:px-3 py-1 sm:py-1.5 text-sm bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-md hover:bg-[var(--bg-accent-hover)] disabled:opacity-50 disabled:cursor-not-allowed transition-colors" disabled title="Merge">
+                                <i class="fas fa-object-group"></i>
+                                <span class="hidden sm:inline ml-1">Merge</span>
+                            </button>
+                        </div>
+                    </div>
                 </div>
-            </form>
-        </div>
-    </div>
 
-    <script>
-        // Dark mode toggle functionality
-        const darkModeToggle = document.getElementById('darkModeToggle');
-        const darkModeIcon = document.getElementById('darkModeIcon');
-        
-        // Initialize dark mode based on localStorage or system preference
+                    <!-- Folders Tab Content -->
+                    <div id="content-folders" class="hidden tab-content pt-6">
+                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6" data-i18n="folderManagement.title">Folder Management</h2>
+
+                    <div class="mb-6">
+                        <div class="flex justify-between items-center mb-4">
+                            <p class="text-[var(--text-secondary)]" data-i18n="folderManagement.description">Organize your recordings into folders. Unlike tags, a recording can only belong to one folder. Folder prompts are applied before user prompts but after tag prompts.</p>
+                            <button id="createFolderBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                <i class="fas fa-plus mr-2"></i> <span data-i18n="folderManagement.createFolder">Create Folder</span>
+                            </button>
+                        </div>
+
+                        <!-- Loading state -->
+                        <div id="foldersLoading" class="text-center py-8 hidden">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="text-[var(--text-muted)] mt-2" data-i18n="common.loading">Loading...</p>
+                        </div>
+
+                        <!-- Error state -->
+                        <div id="foldersError" class="hidden bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] p-3 rounded-lg mb-4">
+                            <i class="fas fa-exclamation-triangle mr-2"></i>
+                            <span id="foldersErrorMessage" data-i18n="common.error">Failed to load folders</span>
+                        </div>
+
+                        <!-- Empty state -->
+                        <div id="foldersEmpty" class="text-center py-12 hidden">
+                            <i class="fas fa-folder text-4xl text-[var(--text-light)] mb-4"></i>
+                            <p class="text-[var(--text-muted)] text-lg mb-2" data-i18n="folderManagement.noFolders">No folders created yet</p>
+                            <p class="text-sm text-[var(--text-light)]" data-i18n="folderManagement.noFoldersDescription">Create your first folder to organize your recordings</p>
+                        </div>
+
+                        <!-- Folders grid -->
+                        <div id="foldersGrid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                            <!-- Folders will be populated here -->
+                        </div>
+                    </div>
+                </div>
+
+                    <div id="content-tags" class="hidden tab-content pt-6">
+                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6" data-i18n="accountTabs.tagManagement">Tag Management</h2>
+
+                    <div class="mb-6">
+                        <div class="flex justify-between items-center mb-4">
+                            <p class="text-[var(--text-secondary)]" data-i18n="tagManagement.description">Organize your recordings with custom tags. Each tag can have its own summary prompt and default ASR settings.</p>
+                            <button id="createTagBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                <i class="fas fa-plus mr-2"></i> <span data-i18n="tagManagement.createTag">Create Tag</span>
+                            </button>
+                        </div>
+
+                        <!-- Loading state -->
+                        <div id="tagsLoading" class="text-center py-8 hidden">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="text-[var(--text-muted)] mt-2">Loading tags...</p>
+                        </div>
+
+                        <!-- Error state -->
+                        <div id="tagsError" class="hidden bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] p-3 rounded-lg mb-4">
+                            <i class="fas fa-exclamation-triangle mr-2"></i>
+                            <span id="tagsErrorMessage">Failed to load tags</span>
+                        </div>
+
+                        <!-- Empty state -->
+                        <div id="tagsEmpty" class="text-center py-12 hidden">
+                            <i class="fas fa-tags text-4xl text-[var(--text-light)] mb-4"></i>
+                            <p class="text-[var(--text-muted)] text-lg mb-2">No tags created yet</p>
+                            <p class="text-sm text-[var(--text-light)]">Create your first tag to organize your recordings</p>
+                        </div>
+
+                        <!-- Tags grid -->
+                        <div id="tagsGrid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                            <!-- Tags will be populated here -->
+                        </div>
+                    </div>
+                </div>
+
+                    <div id="content-templates" class="hidden tab-content pt-6">
+                    <div class="space-y-6">
+                        <!-- Sub-tabs for Templates (sticky) -->
+                        <div class="sticky top-0 z-10 bg-[var(--bg-secondary)] -mx-4 px-4 sm:-mx-6 sm:px-6 lg:-mx-8 lg:px-8 -mt-6 pt-6 pb-0 border-b border-[var(--border-primary)]">
+                            <nav class="flex gap-4" id="templates-subtabs">
+                                <button id="subtab-transcript" class="pb-2 px-1 text-sm font-medium border-b-2 border-[var(--border-accent)] text-[var(--text-accent)]" data-i18n="transcriptTemplates.tabTitle">
+                                    Transcript
+                                </button>
+                                <button id="subtab-export" class="pb-2 px-1 text-sm font-medium border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)]" style="display: none;" data-i18n="exportTemplates.tabTitle">
+                                    Export
+                                </button>
+                                <button id="subtab-naming" class="pb-2 px-1 text-sm font-medium border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)]" data-i18n="namingTemplates.tabTitle">
+                                    Naming
+                                </button>
+                            </nav>
+                        </div>
+
+                        <!-- Transcript Templates Sub-content -->
+                        <div id="subcontent-transcript" class="space-y-6">
+                            <!-- Templates Header -->
+                            <div class="flex flex-col sm:flex-row justify-between items-start sm:items-center gap-4">
+                                <div>
+                                    <h2 class="text-2xl font-semibold text-[var(--text-primary)]" data-i18n="transcriptTemplates.title">Transcript Templates</h2>
+                                    <p class="text-[var(--text-secondary)]" data-i18n="transcriptTemplates.description">Customize how transcripts are formatted for download and export.</p>
+                                </div>
+                                <button id="createTemplateBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-plus mr-2"></i>
+                                    <span data-i18n="transcriptTemplates.createNew">Create Template</span>
+                                </button>
+                            </div>
+
+                            <!-- Templates Grid -->
+                            <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+                                <!-- Templates List (Left) -->
+                                <div class="lg:col-span-1">
+                                    <div class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-4">
+                                        <h3 class="text-sm font-medium text-[var(--text-secondary)] mb-3" data-i18n="transcriptTemplates.availableTemplates">Available Templates</h3>
+                                        <div id="templatesList" class="space-y-2">
+                                            <!-- Templates will be populated here -->
+                                        </div>
+                                        <button id="createDefaultTemplatesBtn" class="mt-4 w-full px-3 py-2 text-sm bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-accent-light)] transition-colors">
+                                            <i class="fas fa-magic mr-2"></i>
+                                            <span data-i18n="transcriptTemplates.createDefaults">Create Default Templates</span>
+                                        </button>
+                                    </div>
+                                </div>
+
+                                <!-- Template Editor (Right) -->
+                                <div class="lg:col-span-2">
+                                    <div id="templateEditor" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-6 hidden">
+                                        <form id="templateForm" class="space-y-4">
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="transcriptTemplates.templateName">Template Name</label>
+                                                <input type="text" id="templateName" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]" required>
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="transcriptTemplates.description">Description</label>
+                                                <input type="text" id="templateDescription" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="transcriptTemplates.template">Template</label>
+                                                <textarea id="templateContent" rows="6" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] font-mono text-sm" required></textarea>
+
+                                                <!-- Available Variables -->
+                                                <div class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md">
+                                                    <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="transcriptTemplates.availableVars">Available Variables:</p>
+                                                    <div class="flex flex-wrap gap-2">
+                                                        {% raw %}<code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded">{{index}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded">{{speaker}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded">{{text}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded">{{start_time}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded">{{end_time}}</code>{% endraw %}
+                                                    </div>
+                                                    <p class="text-xs text-[var(--text-muted)] mt-2" data-i18n="transcriptTemplates.filters">Filters: |upper for uppercase, |srt for subtitle time format</p>
+                                                </div>
+                                            </div>
+
+                                            <div class="flex items-center">
+                                                <input type="checkbox" id="templateIsDefault" class="mr-2">
+                                                <label for="templateIsDefault" class="text-sm text-[var(--text-secondary)]" data-i18n="transcriptTemplates.setDefault">Set as default template</label>
+                                            </div>
+
+                                            <div class="flex gap-3">
+                                                <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                                    <i class="fas fa-save mr-2"></i>
+                                                    <span data-i18n="transcriptTemplates.save">Save</span>
+                                                </button>
+                                                <button type="button" id="cancelTemplateBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-secondary)]">
+                                                    <span data-i18n="transcriptTemplates.cancel">Cancel</span>
+                                                </button>
+                                                <button type="button" id="deleteTemplateBtn" class="px-4 py-2 bg-[var(--bg-danger)] text-white rounded-md hover:bg-[var(--bg-danger-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-red-500 transition-colors duration-200 hidden">
+                                                    <i class="fas fa-trash mr-2"></i>
+                                                    <span data-i18n="transcriptTemplates.delete">Delete</span>
+                                                </button>
+                                            </div>
+                                        </form>
+                                    </div>
+
+                                    <!-- Empty State -->
+                                    <div id="templateEmptyState" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-12 text-center">
+                                        <i class="fas fa-file-alt text-4xl text-[var(--text-muted)] mb-4"></i>
+                                        <p class="text-[var(--text-muted)]" data-i18n="transcriptTemplates.selectOrCreate">Select a template to edit or create a new one</p>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Documentation Link -->
+                            <div class="mt-8 text-center">
+                                <a href="https://murtaza-nasir.github.io/speakr/user-guide/transcript-templates/" target="_blank" class="text-sm text-[var(--text-muted)] hover:text-[var(--text-secondary)] transition-colors">
+                                    <i class="fas fa-question-circle mr-1"></i>
+                                    <span data-i18n="transcriptTemplates.viewGuide">View Template Guide</span>
+                                </a>
+                            </div>
+                        </div>
+
+                        <!-- Export Templates Sub-content -->
+                        <div id="subcontent-export" class="space-y-6 hidden">
+                            <!-- Export Templates Header -->
+                            <div class="flex flex-col sm:flex-row justify-between items-start sm:items-center gap-4">
+                                <div>
+                                    <h2 class="text-2xl font-semibold text-[var(--text-primary)]" data-i18n="exportTemplates.title">Export Templates</h2>
+                                    <p class="text-[var(--text-secondary)]" data-i18n="exportTemplates.description">Customize how recordings are exported to markdown files.</p>
+                                </div>
+                                <button id="createExportTemplateBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-plus mr-2"></i>
+                                    <span data-i18n="exportTemplates.createNew">Create Template</span>
+                                </button>
+                            </div>
+
+                            <!-- Export Templates Grid -->
+                            <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+                                <!-- Export Templates List (Left) -->
+                                <div class="lg:col-span-1">
+                                    <div class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-4">
+                                        <h3 class="text-sm font-medium text-[var(--text-secondary)] mb-3" data-i18n="exportTemplates.availableTemplates">Available Templates</h3>
+                                        <div id="exportTemplatesList" class="space-y-2">
+                                            <!-- Export templates will be populated here -->
+                                        </div>
+                                        <button id="createDefaultExportTemplatesBtn" class="mt-4 w-full px-3 py-2 text-sm bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-accent-light)] transition-colors">
+                                            <i class="fas fa-magic mr-2"></i>
+                                            <span data-i18n="exportTemplates.createDefaults">Create Default Template</span>
+                                        </button>
+                                    </div>
+                                </div>
+
+                                <!-- Export Template Editor (Right) -->
+                                <div class="lg:col-span-2">
+                                    <div id="exportTemplateEditor" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-6 hidden">
+                                        <form id="exportTemplateForm" class="space-y-4">
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="exportTemplates.templateName">Template Name</label>
+                                                <input type="text" id="exportTemplateName" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]" required>
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="exportTemplates.templateDescription">Description</label>
+                                                <input type="text" id="exportTemplateDescription" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="exportTemplates.template">Template</label>
+                                                <textarea id="exportTemplateContent" rows="12" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] font-mono text-sm" required></textarea>
+
+                                                <!-- Available Variables -->
+                                                <div class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md space-y-3">
+                                                    <div>
+                                                        <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="exportTemplates.recordingData">Recording Data:</p>
+                                                        <div class="flex flex-wrap gap-2">
+                                                            {% raw %}<button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{title}}" title="Click to copy"><code>{{title}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{meeting_date}}" title="Click to copy"><code>{{meeting_date}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{created_at}}" title="Click to copy"><code>{{created_at}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{original_filename}}" title="Click to copy"><code>{{original_filename}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{file_size}}" title="Click to copy"><code>{{file_size}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{participants}}" title="Click to copy"><code>{{participants}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{tags}}" title="Click to copy"><code>{{tags}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>{% endraw %}
+                                                        </div>
+                                                    </div>
+                                                    <div>
+                                                        <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="exportTemplates.contentSections">Content Sections:</p>
+                                                        <div class="flex flex-wrap gap-2">
+                                                            {% raw %}<button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{notes}}" title="Click to copy"><code>{{notes}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{summary}}" title="Click to copy"><code>{{summary}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{transcription}}" title="Click to copy"><code>{{transcription}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>{% endraw %}
+                                                        </div>
+                                                    </div>
+                                                    <div>
+                                                        <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="exportTemplates.availableLabels">Localized Labels (auto-translated):</p>
+                                                        <div class="flex flex-wrap gap-2">
+                                                            {% raw %}<button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.metadata}}" title="Click to copy"><code>{{label.metadata}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.notes}}" title="Click to copy"><code>{{label.notes}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.summary}}" title="Click to copy"><code>{{label.summary}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.transcription}}" title="Click to copy"><code>{{label.transcription}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.date}}" title="Click to copy"><code>{{label.date}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>
+                                                            <button type="button" class="copy-var-btn text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-pointer hover:bg-[var(--bg-accent-light)] transition-colors flex items-center gap-1" data-copy="{{label.created}}" title="Click to copy"><code>{{label.created}}</code><i class="fas fa-copy text-[var(--text-muted)] text-[10px]"></i></button>{% endraw %}
+                                                        </div>
+                                                    </div>
+                                                    <div>
+                                                        <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="exportTemplates.conditionals">Conditionals:</p>
+                                                        <p class="text-xs text-[var(--text-muted)]" data-i18n="exportTemplates.conditionalsHint">Use {% raw %}{{#if variable}}...{{/if}}{% endraw %} to conditionally include content</p>
+                                                    </div>
+                                                </div>
+                                            </div>
+
+                                            <div class="flex items-center">
+                                                <input type="checkbox" id="exportTemplateIsDefault" class="mr-2">
+                                                <label for="exportTemplateIsDefault" class="text-sm text-[var(--text-secondary)]" data-i18n="exportTemplates.setDefault">Set as default template</label>
+                                            </div>
+
+                                            <div class="flex gap-3">
+                                                <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                                    <i class="fas fa-save mr-2"></i>
+                                                    <span data-i18n="exportTemplates.save">Save</span>
+                                                </button>
+                                                <button type="button" id="cancelExportTemplateBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-secondary)]">
+                                                    <span data-i18n="exportTemplates.cancel">Cancel</span>
+                                                </button>
+                                                <button type="button" id="deleteExportTemplateBtn" class="px-4 py-2 bg-[var(--bg-danger)] text-white rounded-md hover:bg-[var(--bg-danger-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-red-500 transition-colors duration-200 hidden">
+                                                    <i class="fas fa-trash mr-2"></i>
+                                                    <span data-i18n="exportTemplates.delete">Delete</span>
+                                                </button>
+                                            </div>
+                                        </form>
+                                    </div>
+
+                                    <!-- Empty State -->
+                                    <div id="exportTemplateEmptyState" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-12 text-center">
+                                        <i class="fas fa-file-export text-4xl text-[var(--text-muted)] mb-4"></i>
+                                        <p class="text-[var(--text-muted)]" data-i18n="exportTemplates.selectOrCreate">Select a template to edit or create a new one</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Naming Templates Sub-content -->
+                        <div id="subcontent-naming" class="space-y-6 hidden">
+                            <!-- Naming Templates Header -->
+                            <div class="flex flex-col sm:flex-row justify-between items-start sm:items-center gap-4">
+                                <div>
+                                    <h2 class="text-2xl font-semibold text-[var(--text-primary)]" data-i18n="namingTemplates.title">Naming Templates</h2>
+                                    <p class="text-[var(--text-secondary)]" data-i18n="namingTemplates.description">Define how recording titles are generated from filenames and transcription content.</p>
+                                </div>
+                                <button id="createNamingTemplateBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-plus mr-2"></i>
+                                    <span data-i18n="namingTemplates.createNew">Create Template</span>
+                                </button>
+                            </div>
+
+                            <!-- Naming Templates Grid -->
+                            <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+                                <!-- Naming Templates List (Left) -->
+                                <div class="lg:col-span-1">
+                                    <div class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-4">
+                                        <h3 class="text-sm font-medium text-[var(--text-secondary)] mb-3" data-i18n="namingTemplates.availableTemplates">Available Templates</h3>
+                                        <div id="namingTemplatesList" class="space-y-2">
+                                            <!-- Templates will be populated here -->
+                                        </div>
+                                        <button id="createDefaultNamingTemplatesBtn" class="mt-4 w-full px-3 py-2 text-sm bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-accent-light)] transition-colors">
+                                            <i class="fas fa-magic mr-2"></i>
+                                            <span data-i18n="namingTemplates.createDefaults">Create Default Templates</span>
+                                        </button>
+                                    </div>
+
+                                    <!-- User Default Selection -->
+                                    <div class="mt-4 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-4">
+                                        <h3 class="text-sm font-medium text-[var(--text-secondary)] mb-3" data-i18n="namingTemplates.userDefault">Default Template</h3>
+                                        <select id="userDefaultNamingTemplate" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                                            <option value="" data-i18n="namingTemplates.noDefault">No default (AI title only)</option>
+                                        </select>
+                                        <p class="mt-2 text-xs text-[var(--text-muted)]" data-i18n="namingTemplates.userDefaultHint">Applied when no tag has a naming template set.</p>
+                                    </div>
+                                </div>
+
+                                <!-- Naming Template Editor (Right) -->
+                                <div class="lg:col-span-2">
+                                    <div id="namingTemplateEditor" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-6 hidden">
+                                        <form id="namingTemplateForm" class="space-y-4">
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="namingTemplates.templateName">Template Name</label>
+                                                <input type="text" id="namingTemplateName" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]" required>
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="namingTemplates.descriptionLabel">Description</label>
+                                                <input type="text" id="namingTemplateDescription" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                                            </div>
+
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="namingTemplates.template">Template</label>
+                                                <input type="text" id="namingTemplateContent" class="w-full px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] font-mono text-sm" required placeholder="{% raw %}{{date}} - {{ai_title}}{% endraw %}">
+
+                                                <!-- Available Variables -->
+                                                <div class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md">
+                                                    <p class="text-xs font-medium text-[var(--text-secondary)] mb-2" data-i18n="namingTemplates.availableVars">Built-in Variables:</p>
+                                                    <div class="flex flex-wrap gap-2 mb-2">
+                                                        {% raw %}<code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-help" title="AI-generated title from transcription">{{ai_title}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-help" title="Original filename without extension">{{filename}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-help" title="Recording date (YYYY-MM-DD)">{{date}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-help" title="Recording date and time">{{datetime}}</code>
+                                                        <code class="text-xs bg-[var(--bg-primary)] px-2 py-1 rounded cursor-help" title="Time only (HH:MM)">{{time}}</code>{% endraw %}
+                                                    </div>
+                                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="namingTemplates.customVarsHint">Define regex patterns below to extract custom variables from filenames.</p>
+                                                </div>
+                                            </div>
+
+                                            <!-- Regex Patterns -->
+                                            <div>
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="namingTemplates.regexPatterns">Regex Patterns (Optional)</label>
+                                                <div id="regexPatternsContainer" class="space-y-2">
+                                                    <!-- Regex patterns will be added here dynamically -->
+                                                </div>
+                                                <button type="button" id="addRegexPatternBtn" class="mt-2 text-sm text-[var(--text-accent)] hover:text-[var(--text-primary)]">
+                                                    <i class="fas fa-plus mr-1"></i>
+                                                    <span data-i18n="namingTemplates.addPattern">Add Pattern</span>
+                                                </button>
+                                                <p class="mt-1 text-xs text-[var(--text-muted)]" data-i18n="namingTemplates.regexHint">Extract data from filenames. Use capture groups () to specify the match. Example: (\d{10}) for phone numbers.</p>
+                                            </div>
+
+                                            <!-- Test Section -->
+                                            <div class="border-t border-[var(--border-primary)] pt-4 mt-4">
+                                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="namingTemplates.testTemplate">Test Template</label>
+                                                <div class="flex gap-2">
+                                                    <input type="text" id="testFilename" class="flex-1 px-3 py-2 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm" placeholder="sample-file-name.mp3">
+                                                    <button type="button" id="testNamingTemplateBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-accent-light)]">
+                                                        <i class="fas fa-play mr-1"></i>
+                                                        <span data-i18n="namingTemplates.test">Test</span>
+                                                    </button>
+                                                </div>
+                                                <div id="testResult" class="mt-2 p-2 bg-[var(--bg-tertiary)] rounded-md hidden">
+                                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="namingTemplates.result">Result:</p>
+                                                    <p id="testResultText" class="text-sm text-[var(--text-primary)] font-medium"></p>
+                                                </div>
+                                            </div>
+
+                                            <div class="flex gap-3">
+                                                <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                                    <i class="fas fa-save mr-2"></i>
+                                                    <span data-i18n="namingTemplates.save">Save</span>
+                                                </button>
+                                                <button type="button" id="cancelNamingTemplateBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-secondary)]">
+                                                    <span data-i18n="namingTemplates.cancel">Cancel</span>
+                                                </button>
+                                                <button type="button" id="deleteNamingTemplateBtn" class="px-4 py-2 bg-[var(--bg-danger)] text-white rounded-md hover:bg-[var(--bg-danger-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-red-500 transition-colors duration-200 hidden">
+                                                    <i class="fas fa-trash mr-2"></i>
+                                                    <span data-i18n="namingTemplates.delete">Delete</span>
+                                                </button>
+                                            </div>
+                                        </form>
+                                    </div>
+
+                                    <!-- Empty State -->
+                                    <div id="namingTemplateEmptyState" class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] p-12 text-center">
+                                        <i class="fas fa-heading text-4xl text-[var(--text-muted)] mb-4"></i>
+                                        <p class="text-[var(--text-muted)]" data-i18n="namingTemplates.selectOrCreate">Select a template to edit or create a new one</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                    <!-- API Tokens Tab Content -->
+                    <div id="content-tokens" class="hidden tab-content pt-6">
+                        <div class="space-y-6">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <h2 class="text-2xl font-semibold text-[var(--text-primary)]">
+                                        <i class="fas fa-key mr-2 text-[var(--text-accent)]"></i>
+                                        <span data-i18n="apiTokens.title">API Tokens</span>
+                                    </h2>
+                                    <p class="mt-2 text-sm text-[var(--text-muted)]" data-i18n="apiTokens.description">
+                                        Create and manage API tokens for programmatic access to your account.
+                                    </p>
+                                </div>
+                                <button id="createTokenBtn" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                                    <i class="fas fa-plus mr-2"></i>
+                                    <span data-i18n="apiTokens.createToken">Create Token</span>
+                                </button>
+                            </div>
+
+                            <!-- Security Notice -->
+                            <div class="bg-amber-50 border border-amber-200 rounded-lg p-4">
+                                <div class="flex">
+                                    <div class="flex-shrink-0">
+                                        <i class="fas fa-exclamation-triangle text-amber-400"></i>
+                                    </div>
+                                    <div class="ml-3">
+                                        <h3 class="text-sm font-medium text-amber-800" data-i18n="apiTokens.securityNotice">Security Notice</h3>
+                                        <div class="mt-2 text-sm text-amber-700">
+                                            <p data-i18n="apiTokens.securityWarning">
+                                                Treat API tokens like passwords. They provide full access to your account. Never share tokens in publicly accessible areas such as GitHub, client-side code, or logs.
+                                            </p>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Loading State -->
+                            <div id="tokensLoading" class="text-center py-12">
+                                <i class="fas fa-spinner fa-spin text-4xl text-[var(--text-muted)] mb-4"></i>
+                                <p class="text-[var(--text-muted)]">Loading tokens...</p>
+                            </div>
+
+                            <!-- Token List Container -->
+                            <div id="tokensContainer" class="hidden">
+                                <!-- Active Tokens Section -->
+                                <div id="activeTokensSection" class="hidden">
+                                    <h3 class="text-sm font-medium text-[var(--text-muted)] mb-3">
+                                        <span data-i18n="apiTokens.activeTokens">Active Tokens</span>
+                                        <span id="activeTokensCount" class="ml-1 text-xs"></span>
+                                    </h3>
+                                    <div id="activeTokensList" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-3">
+                                        <!-- Populated dynamically -->
+                                    </div>
+                                </div>
+
+                                <!-- No Tokens Message -->
+                                <div id="noTokensMessage" class="hidden text-center py-12 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg">
+                                    <i class="fas fa-key text-4xl text-[var(--text-muted)] mb-4"></i>
+                                    <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-2" data-i18n="apiTokens.noTokens">No API Tokens</h3>
+                                    <p class="text-sm text-[var(--text-muted)] mb-4" data-i18n="apiTokens.createFirstToken">Create your first API token to enable programmatic access.</p>
+                                    <button id="createTokenBtnEmpty" class="inline-flex items-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] transition-colors">
+                                        <i class="fas fa-plus mr-2"></i>
+                                        <span data-i18n="apiTokens.createToken">Create Token</span>
+                                    </button>
+                                </div>
+
+                                <!-- Usage Examples -->
+                                <div class="mt-8">
+                                    <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-3">
+                                        <i class="fas fa-book mr-2"></i>
+                                        <span data-i18n="apiTokens.usageExamples">Usage Examples</span>
+                                    </h3>
+                                    <div class="bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg p-4 space-y-4">
+                                        <div>
+                                            <h4 class="text-sm font-semibold text-[var(--text-primary)] mb-2">Using with curl:</h4>
+                                            <pre class="bg-[var(--bg-tertiary)] p-3 rounded text-xs overflow-x-auto"><code>curl -H "Authorization: Bearer YOUR_TOKEN_HERE" \
+     https://your-speakr-instance.com/api/recordings</code></pre>
+                                        </div>
+                                        <div>
+                                            <h4 class="text-sm font-semibold text-[var(--text-primary)] mb-2">Alternative header formats:</h4>
+                                            <pre class="bg-[var(--bg-tertiary)] p-3 rounded text-xs overflow-x-auto"><code># X-API-Token header
+curl -H "X-API-Token: YOUR_TOKEN_HERE" ...
+
+# API-Token header
+curl -H "API-Token: YOUR_TOKEN_HERE" ...
+
+# Query parameter
+curl "https://your-speakr-instance.com/api/recordings?token=YOUR_TOKEN_HERE"</code></pre>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <div id="content-about" class="hidden tab-content pt-6">
+                    <div class="space-y-8">
+                        <!-- Header Section -->
+                        <div class="text-center">
+                            <div class="flex items-center justify-center mb-4">
+                                <img src="{{ url_for('static', filename='img/icon-192x192.png') }}" alt="Speakr Logo" class="h-16 w-16 mr-4">
+                                <div>
+                                    <h2 class="text-3xl font-bold text-[var(--text-primary)]">Speakr</h2>
+                                    <p class="text-[var(--text-secondary)]" data-i18n="aboutPage.tagline">AI-Powered Audio Transcription & Note-Taking</p>
+                                </div>
+                            </div>
+                            <div class="inline-flex items-center px-3 py-1 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-full text-sm font-medium">
+                                <i class="fas fa-tag mr-2"></i>
+                                Version <span id="system-version" class="ml-1 font-mono">Loading...</span>
+                            </div>
+                        </div>
+
+                        <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
+                            <!-- System Information -->
+                            <div class="bg-[var(--bg-secondary)] rounded-xl p-6 border border-[var(--border-primary)] shadow-sm">
+                                <div class="flex items-center mb-4">
+                                    <div class="p-2 bg-[var(--bg-accent)] rounded-lg mr-3">
+                                        <i class="fas fa-cogs text-[var(--text-accent)] text-lg"></i>
+                                    </div>
+                                    <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="aboutPage.systemConfiguration">System Configuration</h3>
+                                </div>
+                                
+                                <div class="space-y-4">
+                                    <div class="border-l-4 border-[var(--border-accent)] pl-4">
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-2" data-i18n="aboutPage.largeLanguageModel">Large Language Model</h4>
+                                        <div class="space-y-1 text-sm">
+                                            <p class="text-[var(--text-secondary)]">
+                                                <span class="font-medium" data-i18n="aboutPage.model">Model:</span> 
+                                                <span id="llm-model" class="font-mono text-[var(--text-primary)] bg-[var(--bg-tertiary)] px-2 py-1 rounded ml-1">Loading...</span>
+                                            </p>
+                                            <p class="text-[var(--text-secondary)]">
+                                                <span class="font-medium" data-i18n="aboutPage.endpoint">Endpoint:</span> 
+                                                <span id="llm-endpoint" class="font-mono text-xs text-[var(--text-muted)] break-all ml-1">Loading...</span>
+                                            </p>
+                                        </div>
+                                    </div>
+                                    
+                                    <div class="border-l-4 border-green-500 pl-4">
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-2" data-i18n="aboutPage.speechRecognition">Speech Recognition</h4>
+                                        <div class="space-y-1 text-sm">
+                                            <p class="text-[var(--text-secondary)]">
+                                                <span class="font-medium" data-i18n="aboutPage.model">Model:</span>
+                                                <span id="transcription-model" class="font-mono text-xs bg-[var(--bg-tertiary)] px-2 py-0.5 rounded text-[var(--text-primary)] ml-1">Loading...</span>
+                                            </p>
+                                            <p class="text-[var(--text-secondary)]">
+                                                <span class="font-medium" data-i18n="aboutPage.endpoint">Endpoint:</span>
+                                                <span id="transcription-endpoint" class="font-mono text-xs text-[var(--text-muted)] ml-1">Loading...</span>
+                                            </p>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Project Information -->
+                            <div class="bg-[var(--bg-secondary)] rounded-xl p-6 border border-[var(--border-primary)] shadow-sm">
+                                <div class="flex items-center mb-4">
+                                    <div class="p-2 bg-gray-800 rounded-lg mr-3">
+                                        <i class="fab fa-github text-white text-lg"></i>
+                                    </div>
+                                    <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="aboutPage.projectLinks">Project Links</h3>
+                                </div>
+                                
+                                <div class="space-y-3">
+                                    <a href="https://github.com/murtaza-nasir/speakr" target="_blank" rel="noopener noreferrer" 
+                                       class="flex items-center p-3 bg-gray-800 hover:bg-gray-700 text-white rounded-lg transition-all duration-200 group transform hover:scale-[1.02]">
+                                        <i class="fab fa-github text-xl mr-3"></i>
+                                        <div class="flex-1">
+                                            <div class="font-medium" data-i18n="aboutPage.githubRepository">GitHub Repository</div>
+                                            <div class="text-sm text-gray-300" data-i18n="aboutPage.githubDescription">Source code, issues, and releases</div>
+                                        </div>
+                                        <i class="fas fa-external-link-alt text-sm opacity-70 group-hover:opacity-100"></i>
+                                    </a>
+                                    
+                                    <a href="https://hub.docker.com/r/learnedmachine/speakr" target="_blank" rel="noopener noreferrer"
+                                       class="flex items-center p-3 bg-blue-600 hover:bg-blue-500 text-white rounded-lg transition-all duration-200 group transform hover:scale-[1.02]">
+                                        <i class="fab fa-docker text-xl mr-3"></i>
+                                        <div class="flex-1">
+                                            <div class="font-medium" data-i18n="aboutPage.dockerHub">Docker Hub</div>
+                                            <div class="text-sm text-blue-100" data-i18n="aboutPage.dockerDescription">Official Docker images</div>
+                                        </div>
+                                        <i class="fas fa-external-link-alt text-sm opacity-70 group-hover:opacity-100"></i>
+                                    </a>
+                                    
+                                    <a href="https://murtaza-nasir.github.io/speakr" target="_blank" rel="noopener noreferrer"
+                                       class="flex items-center p-3 bg-green-600 hover:bg-green-500 text-white rounded-lg transition-all duration-200 group transform hover:scale-[1.02]">
+                                        <i class="fas fa-book text-xl mr-3"></i>
+                                        <div class="flex-1">
+                                            <div class="font-medium" data-i18n="aboutPage.documentation">Documentation</div>
+                                            <div class="text-sm text-green-100" data-i18n="aboutPage.documentationDescription">User guide and tutorials</div>
+                                        </div>
+                                        <i class="fas fa-external-link-alt text-sm opacity-70 group-hover:opacity-100"></i>
+                                    </a>
+                                </div>
+                                
+                                <div class="mt-6 p-3 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)]">
+                                    <p class="text-sm text-[var(--text-secondary)] leading-relaxed">
+                                        <i class="fas fa-info-circle text-[var(--text-accent)] mr-2"></i>
+                                        <span data-i18n="aboutPage.projectDescription">Transform your audio recordings into organized, searchable notes with AI-powered transcription, summarization, and interactive chat features.</span>
+                                    </p>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Key Features -->
+                        <div class="bg-[var(--bg-secondary)] rounded-xl p-6 border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center mb-6">
+                                <div class="p-2 bg-purple-600 rounded-lg mr-3">
+                                    <i class="fas fa-star text-white text-lg"></i>
+                                </div>
+                                <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="aboutPage.keyFeatures">Key Features</h3>
+                            </div>
+                            
+                            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-blue-100 dark:bg-blue-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-microphone text-blue-600 dark:text-blue-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.audioTranscription">Audio Transcription</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.audioTranscriptionDesc">Whisper API and custom ASR support with high accuracy</p>
+                                    </div>
+                                </div>
+                                
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-purple-100 dark:bg-purple-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-robot text-purple-600 dark:text-purple-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.aiSummarization">AI Summarization</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.aiSummarizationDesc">OpenRouter and Ollama integration with custom prompts</p>
+                                    </div>
+                                </div>
+                                
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-green-100 dark:bg-green-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-users text-green-600 dark:text-green-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.speakerDiarization">Speaker Diarization</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.speakerDiarizationDesc">Identify and label different speakers automatically</p>
+                                    </div>
+                                </div>
+                                
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-orange-100 dark:bg-orange-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-comments text-orange-600 dark:text-orange-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.interactiveChat">Interactive Chat</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.interactiveChatDesc">Chat with your transcriptions using AI</p>
+                                    </div>
+                                </div>
+                                
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-indigo-100 dark:bg-indigo-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-search text-indigo-600 dark:text-indigo-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.inquireMode">Inquire Mode</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.inquireModeDesc">Semantic search across all your recordings</p>
+                                    </div>
+                                </div>
+                                
+                                <div class="flex items-start p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-accent)] transition-colors">
+                                    <div class="p-2 bg-teal-100 dark:bg-teal-900 rounded-lg mr-3 mt-1">
+                                        <i class="fas fa-share-alt text-teal-600 dark:text-teal-400"></i>
+                                    </div>
+                                    <div>
+                                        <h4 class="font-medium text-[var(--text-primary)] mb-1" data-i18n="aboutPage.sharingExport">Sharing & Export</h4>
+                                        <p class="text-sm text-[var(--text-secondary)]" data-i18n="aboutPage.sharingExportDesc">Share recordings and export to various formats</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Technology Stack -->
+                        <div class="bg-[var(--bg-secondary)] rounded-xl p-6 border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center mb-4">
+                                <div class="p-2 bg-red-500 rounded-lg mr-3">
+                                    <i class="fas fa-code text-white text-lg"></i>
+                                </div>
+                                <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="aboutPage.technologyStack">Technology Stack</h3>
+                            </div>
+                            
+                            <div class="grid grid-cols-2 md:grid-cols-4 gap-4">
+                                <div class="text-center p-3 bg-[var(--bg-tertiary)] rounded-lg">
+                                    <i class="fab fa-python text-3xl text-blue-500 mb-2"></i>
+                                    <p class="text-sm font-medium text-[var(--text-primary)]">Python Flask</p>
+                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="aboutPage.backend">Backend</p>
+                                </div>
+                                <div class="text-center p-3 bg-[var(--bg-tertiary)] rounded-lg">
+                                    <i class="fab fa-vuejs text-3xl text-green-500 mb-2"></i>
+                                    <p class="text-sm font-medium text-[var(--text-primary)]">Vue.js</p>
+                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="aboutPage.frontend">Frontend</p>
+                                </div>
+                                <div class="text-center p-3 bg-[var(--bg-tertiary)] rounded-lg">
+                                    <i class="fas fa-database text-3xl text-purple-500 mb-2"></i>
+                                    <p class="text-sm font-medium text-[var(--text-primary)]">SQLite</p>
+                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="aboutPage.database">Database</p>
+                                </div>
+                                <div class="text-center p-3 bg-[var(--bg-tertiary)] rounded-lg">
+                                    <i class="fab fa-docker text-3xl text-blue-600 mb-2"></i>
+                                    <p class="text-sm font-medium text-[var(--text-primary)]">Docker</p>
+                                    <p class="text-xs text-[var(--text-muted)]" data-i18n="aboutPage.deployment">Deployment</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    </div>
+                </div>
+            </div>
+        </main>
+
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            <span id="footer-text">Speakr &copy; {{ now.year }}</span>
+        </footer>
+    </div>
+
+    <!-- Change Password Modal -->
+    <div id="changePasswordModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+            <div class="flex justify-between items-center mb-4">
+                <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="account.changePassword">{% if has_password %}Change Password{% else %}Set Password{% endif %}</h3>
+                <button id="closeModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
+            </div>
+            <form id="changePasswordForm" method="POST" action="{{ url_for('auth.change_password') }}">
+                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                {% if has_password %}
+                <div class="mb-4">
+                    <label for="current_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="changePasswordModal.currentPassword">Current Password</label>
+                    <input type="password" id="current_password" name="current_password" autocomplete="current-password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                </div>
+                {% else %}
+                <div class="mb-4 p-3 bg-[var(--bg-tertiary)] rounded-md">
+                    <p class="text-sm text-[var(--text-muted)]"><i class="fas fa-info-circle mr-1"></i> You don't have a password set. Create one to enable local login.</p>
+                </div>
+                {% endif %}
+                <div class="mb-4">
+                    <label for="new_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="changePasswordModal.newPassword">New Password</label>
+                    <input type="password" id="new_password" name="new_password" autocomplete="new-password" required minlength="8" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                    <p class="text-xs text-[var(--text-muted)] mt-1" data-i18n="changePasswordModal.passwordRequirement">Password must be at least 8 characters long</p>
+                </div>
+                <div class="mb-6">
+                    <label for="confirm_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="changePasswordModal.confirmPassword">Confirm New Password</label>
+                    <input type="password" id="confirm_password" name="confirm_password" autocomplete="new-password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                </div>
+                <div class="flex justify-end space-x-3">
+                    <button type="button" id="cancelBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
+                    <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]" data-i18n="account.changePassword">{% if has_password %}Change Password{% else %}Set Password{% endif %}</button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <!-- Manage Speakers Modal -->
+    <div id="manageSpeakersModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] overflow-hidden">
+            <div class="flex justify-between items-center mb-4">
+                <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="account.manageSpeakers">Manage Speakers</h3>
+                <button id="closeSpeakersModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
+            </div>
+            
+            <div class="mb-4">
+                <p class="text-sm text-[var(--text-muted)] mb-4">
+                    <span data-i18n="manageSpeakersModal.description">Manage your saved speakers. These are automatically saved when you use speaker names in your recordings.</span>
+                </p>
+                
+                <!-- Loading state -->
+                <div id="speakersLoading" class="text-center py-8 hidden">
+                    <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                    <p class="text-[var(--text-muted)] mt-2" data-i18n="manageSpeakersModal.loadingSpeakers">Loading speakers...</p>
+                </div>
+                
+                <!-- Error state -->
+                <div id="speakersError" class="hidden bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] p-3 rounded-lg mb-4">
+                    <i class="fas fa-exclamation-triangle mr-2"></i>
+                    <span id="speakersErrorMessage" data-i18n="manageSpeakersModal.failedToLoad">Failed to load speakers</span>
+                </div>
+                
+                <!-- Empty state -->
+                <div id="speakersEmpty" class="text-center py-8 hidden">
+                    <i class="fas fa-users text-4xl text-[var(--text-light)] mb-4"></i>
+                    <p class="text-[var(--text-muted)]" data-i18n="manageSpeakersModal.noSpeakersYet">No speakers saved yet</p>
+                    <p class="text-sm text-[var(--text-light)]" data-i18n="manageSpeakersModal.speakersWillAppear">Speakers will appear here when you use speaker names in your recordings</p>
+                </div>
+                
+                <!-- Speakers list -->
+                <div id="speakersList" class="space-y-2 max-h-96 overflow-y-auto">
+                    <!-- Speakers will be populated here -->
+                </div>
+            </div>
+            
+            <div class="flex justify-between items-center pt-4 border-t border-[var(--border-primary)]">
+                <div class="text-sm text-[var(--text-muted)]">
+                    <span><span id="speakersCount">0</span> <span data-i18n="manageSpeakersModal.speakersSaved">speakers saved</span></span>
+                </div>
+                <div class="flex space-x-3">
+                    <button id="deleteAllSpeakersBtn" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)] disabled:opacity-50 disabled:cursor-not-allowed" disabled>
+                        <i class="fas fa-trash mr-2"></i> <span data-i18n="buttons.deleteAll">Delete All</span>
+                    </button>
+                    <button id="closeSpeakersBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">
+                        <span data-i18n="buttons.close">Close</span>
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Delete All Speakers Confirmation Modal -->
+    <div id="deleteAllSpeakersModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-60 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+            <div class="flex items-center mb-4">
+                <i class="fas fa-exclamation-triangle text-[var(--text-danger)] text-2xl mr-3"></i>
+                <h3 class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="buttons.deleteAll">Delete All Speakers</h3>
+            </div>
+            <p class="text-[var(--text-secondary)] mb-6">
+                <span data-i18n="deleteAllSpeakersModal.confirmMessage">Are you sure you want to delete all saved speakers? This action cannot be undone.</span>
+            </p>
+            <div class="flex justify-end space-x-3">
+                <button id="cancelDeleteAllBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">
+                    <span data-i18n="buttons.cancel">Cancel</span>
+                </button>
+                <button id="confirmDeleteAllBtn" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">
+                    <i class="fas fa-trash mr-2"></i> Delete All
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Delete Selected Speakers Confirmation Modal -->
+    <div id="deleteSelectedSpeakersModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm hidden">
+        <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+            <!-- Header -->
+            <div class="p-6 border-b border-[var(--border-primary)]">
+                <div class="flex items-center gap-4">
+                    <div class="w-12 h-12 bg-gradient-to-br from-red-500 to-red-600 rounded-full flex items-center justify-center shadow-lg">
+                        <i class="fas fa-trash text-white text-lg"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-xl font-bold text-[var(--text-primary)]">Delete Speakers</h3>
+                        <p class="text-sm text-[var(--text-muted)] mt-0.5">This action cannot be undone</p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Content -->
+            <div class="p-6">
+                <div class="mb-4">
+                    <p class="text-[var(--text-secondary)] mb-3">
+                        You are about to delete <strong id="deleteSelectedCount" class="text-[var(--text-primary)]">0</strong> speaker(s):
+                    </p>
+                    <div id="deleteSelectedSpeakersList" class="max-h-48 overflow-y-auto space-y-2 bg-[var(--bg-tertiary)] rounded-lg p-3 border border-[var(--border-primary)]">
+                        <!-- Populated dynamically -->
+                    </div>
+                </div>
+
+                <div class="flex items-start space-x-3 bg-red-50 dark:bg-red-900/20 p-3 rounded-lg border border-red-200 dark:border-red-800">
+                    <div class="w-6 h-6 bg-red-100 dark:bg-red-900/40 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-exclamation-triangle text-red-600 dark:text-red-400 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-sm text-red-800 dark:text-red-200">
+                            All voice profiles, recordings associations, and usage data will be permanently deleted.
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Footer -->
+            <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)]">
+                <button id="cancelDeleteSelectedBtn" class="px-5 py-2.5 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-all duration-200 flex items-center shadow-sm font-medium">
+                    <i class="fas fa-times mr-2"></i>
+                    Cancel
+                </button>
+                <button id="confirmDeleteSelectedBtn" class="px-5 py-2.5 bg-gradient-to-r from-red-500 to-red-600 text-white rounded-lg hover:from-red-600 hover:to-red-700 transition-all duration-200 flex items-center shadow-lg font-medium">
+                    <i class="fas fa-trash mr-2"></i>
+                    Delete Speakers
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Clear Voice Profiles Confirmation Modal -->
+    <div id="clearVoiceProfilesModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm hidden">
+        <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+            <!-- Header -->
+            <div class="bg-gradient-to-r from-orange-500 to-[var(--bg-secondary)] p-5 rounded-t-xl flex items-center">
+                <div class="flex items-center">
+                    <div class="w-12 h-12 bg-gradient-to-br from-orange-500 to-amber-600 rounded-full flex items-center justify-center mr-4 shadow-lg">
+                        <i class="fas fa-eraser text-white text-lg"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-xl font-bold text-[var(--text-primary)] mb-1">Clear Voice Profiles</h3>
+                        <p class="text-sm text-[var(--text-muted)]">Remove voice recognition data</p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Content -->
+            <div class="p-6 modal-content">
+                <div class="mb-4">
+                    <p class="text-[var(--text-secondary)] mb-3">
+                        Clear voice profiles for <strong id="clearVoiceProfilesCount" class="text-[var(--text-primary)]">0</strong> speaker(s):
+                    </p>
+                    <div id="clearVoiceProfilesList" class="max-h-48 overflow-y-auto space-y-2 bg-[var(--bg-tertiary)] rounded-lg p-3 border border-[var(--border-primary)]">
+                        <!-- Populated dynamically -->
+                    </div>
+                </div>
+
+                <div class="space-y-3">
+                    <div class="flex items-start space-x-3">
+                        <div class="w-6 h-6 bg-amber-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                            <i class="fas fa-info-circle text-amber-600 text-xs"></i>
+                        </div>
+                        <div>
+                            <p class="text-[var(--text-secondary)] font-medium mb-1">What will happen:</p>
+                            <p class="text-sm text-[var(--text-muted)]">
+                                All voice embeddings and recognition data will be removed. Speaker names and usage history will be preserved.
+                            </p>
+                        </div>
+                    </div>
+
+                    <div class="flex items-start space-x-3">
+                        <div class="w-6 h-6 bg-green-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                            <i class="fas fa-check text-green-600 text-xs"></i>
+                        </div>
+                        <div>
+                            <p class="text-sm text-[var(--text-muted)]">
+                                New voice profiles will be created when you identify these speakers in future recordings.
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Footer -->
+            <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)]">
+                <button id="cancelClearVoiceProfilesBtn" class="px-5 py-2.5 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-all duration-200 flex items-center shadow-sm font-medium">
+                    <i class="fas fa-times mr-2"></i>
+                    Cancel
+                </button>
+                <button id="confirmClearVoiceProfilesBtn" class="px-5 py-2.5 bg-gradient-to-r from-orange-500 to-amber-600 text-white rounded-lg hover:from-orange-600 hover:to-amber-700 transition-all duration-200 flex items-center shadow-lg font-medium">
+                    <i class="fas fa-eraser mr-2"></i>
+                    Clear Profiles
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Merge Speakers Modal -->
+    <div id="mergeSpeakersModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-60 p-4 backdrop-blur-sm hidden">
+        <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-lg max-h-[80vh] flex flex-col transform transition-all duration-300 ease-in-out">
+            <!-- Header -->
+            <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-secondary)] p-5 rounded-t-xl flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center">
+                    <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center mr-4 shadow-lg">
+                        <i class="fas fa-object-group text-white text-lg"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-xl font-bold text-[var(--text-primary)] mb-1">Merge Speakers</h3>
+                        <p class="text-sm text-[var(--text-muted)]">Combine speaker profiles</p>
+                    </div>
+                </div>
+                <button id="closeMergeModal" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none w-8 h-8 flex items-center justify-center rounded-full hover:bg-[var(--bg-tertiary)] transition-colors">&times;</button>
+            </div>
+
+            <!-- Info Section -->
+            <div class="p-6 flex-shrink-0 border-b border-[var(--border-primary)]">
+                <div class="flex items-start space-x-3">
+                    <div class="w-6 h-6 bg-blue-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-info-circle text-blue-600 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-sm text-[var(--text-secondary)]">
+                            Click on the speaker you want to keep. All voice data, snippets, and usage statistics from other speakers will be merged into it.
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Scrollable speaker list -->
+            <div class="flex-1 overflow-y-auto min-h-0 p-6">
+                <div id="mergeSpeakersList" class="space-y-2">
+                    <!-- Populated dynamically -->
+                </div>
+            </div>
+
+            <!-- Footer -->
+            <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)] flex-shrink-0">
+                <button id="cancelMergeBtn" class="px-5 py-2.5 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-all duration-200 flex items-center shadow-sm font-medium">
+                    <i class="fas fa-times mr-2"></i>
+                    Cancel
+                </button>
+                <button id="executeMergeBtn" class="px-5 py-2.5 bg-gradient-to-r from-blue-500 to-purple-600 text-white rounded-lg hover:from-blue-600 hover:to-purple-700 disabled:opacity-50 disabled:cursor-not-allowed transition-all duration-200 flex items-center shadow-lg font-medium" disabled>
+                    <i class="fas fa-object-group mr-2"></i>
+                    <span>Merge Speakers</span>
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Edit Speaker Modal -->
+    <div id="editSpeakerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-60 p-4 backdrop-blur-sm hidden">
+        <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+            <!-- Header -->
+            <div class="p-5 border-b border-[var(--border-primary)]">
+                <div class="flex items-center justify-between">
+                    <div class="flex items-center">
+                        <div class="w-10 h-10 bg-[var(--bg-accent)] rounded-full flex items-center justify-center mr-3">
+                            <i class="fas fa-edit text-[var(--text-button)]"></i>
+                        </div>
+                        <h3 class="text-lg font-bold text-[var(--text-primary)]">Edit Speaker Name</h3>
+                    </div>
+                    <button id="closeEditSpeakerModal" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none w-8 h-8 flex items-center justify-center rounded-full hover:bg-[var(--bg-tertiary)] transition-colors">&times;</button>
+                </div>
+            </div>
+
+            <!-- Body -->
+            <div class="p-6">
+                <label for="editSpeakerNameInput" class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                    Speaker Name
+                </label>
+                <input
+                    type="text"
+                    id="editSpeakerNameInput"
+                    class="w-full px-4 py-2 border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                    placeholder="Enter speaker name">
+                <div id="editSpeakerError" class="mt-2 text-sm text-[var(--text-danger)] hidden"></div>
+            </div>
+
+            <!-- Footer -->
+            <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)]">
+                <button id="cancelEditSpeakerBtn" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                    Cancel
+                </button>
+                <button id="saveEditSpeakerBtn" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                    <i class="fas fa-save mr-2"></i>
+                    Save
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Create/Edit Tag Modal -->
+    <div id="tagModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-lg max-h-[90vh] overflow-y-auto">
+            <div class="flex justify-between items-center mb-4">
+                <h3 id="tagModalTitle" class="text-xl font-semibold text-[var(--text-primary)]" data-i18n="editTagModal.createTitle">Create Tag</h3>
+                <button id="closeTagModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
+            </div>
+
+            <form id="tagForm" class="space-y-4">
+                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                <input type="hidden" id="tagId" name="tag_id">
+
+                <!-- Name and Color (always visible, outside tabs) -->
+                <div>
+                    <label for="tagName" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="editTagModal.tagName">Tag Name *</label>
+                    <input type="text" id="tagName" name="name" required maxlength="50" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., Meetings, Interviews">
+                </div>
+
+                <div>
+                    <label for="tagColor" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="editTagModal.color">Color</label>
+                    <div class="flex items-center space-x-3">
+                        <input type="color" id="tagColor" name="color" value="#3B82F6" class="w-12 h-10 rounded border border-[var(--border-secondary)]">
+                        <span class="text-sm text-[var(--text-muted)]" data-i18n="editTagModal.colorDescription">Choose a color for easy identification</span>
+                    </div>
+                </div>
+
+                {% if enable_auto_processing %}
+                <!-- Auto-process watch folder toggle -->
+                <div id="tagAutoProcessRow" class="flex items-center justify-between py-2 px-3 bg-[var(--bg-tertiary)] rounded-md">
+                    <div class="flex items-center space-x-2">
+                        <i class="fas fa-folder-open text-[var(--text-muted)] text-sm"></i>
+                        <label for="tagAutoProcess" class="text-sm font-medium text-[var(--text-secondary)] cursor-pointer" data-i18n="editTagModal.watchFolder">Watch Folder</label>
+                    </div>
+                    <label class="relative inline-flex items-center cursor-pointer">
+                        <input type="checkbox" id="tagAutoProcess" class="sr-only peer">
+                        <div class="w-9 h-5 bg-[var(--bg-quaternary)] peer-focus:outline-none peer-focus:ring-2 peer-focus:ring-[var(--border-focus)] rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-gray-300 after:border after:rounded-full after:h-4 after:w-4 after:transition-all peer-checked:bg-[var(--bg-success)]"></div>
+                    </label>
+                </div>
+                <div id="tagAutoProcessPath" class="hidden px-3 py-2 bg-[var(--bg-tertiary)] rounded-md -mt-2">
+                    <span class="text-xs text-[var(--text-muted)]" data-i18n="editTagModal.watchFolderPath">Drop files in:</span>
+                    <code id="tagAutoProcessPathValue" class="block text-xs text-[var(--text-primary)] font-mono mt-1 break-all"></code>
+                </div>
+                {% endif %}
+
+                <!-- Tab Navigation -->
+                <div class="border-b border-[var(--border-primary)]">
+                    <nav class="flex -mb-px space-x-1" id="tagModalTabs">
+                        <button type="button" class="tag-modal-tab active px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-[var(--border-focus)] text-[var(--text-accent)]" data-tab="tagTabTranscription">
+                            <i class="fas fa-microphone mr-1"></i>Transcription
+                        </button>
+                        <button type="button" class="tag-modal-tab px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)]" data-tab="tagTabSummary">
+                            <i class="fas fa-file-alt mr-1"></i>Summary & Templates
+                        </button>
+                        <button type="button" id="tagTabSharingBtn" class="tag-modal-tab px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hidden" data-tab="tagTabSharing">
+                            <i class="fas fa-users mr-1"></i>Sharing
+                        </button>
+                    </nav>
+                </div>
+
+                <!-- Tab: Transcription & Retention -->
+                <div id="tagTabTranscription" class="tag-modal-tab-content space-y-4">
+                    {% if connector_supports_diarization %}
+                    <div>
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3" data-i18n="editTagModal.asrDefaultSettings">Transcription Default Settings</h4>
+                        <div class="space-y-3">
+                            <div>
+                                <label for="tagLanguage" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="editTagModal.defaultLanguage">Default Language</label>
+                                <input type="text" id="tagLanguage" name="default_language" maxlength="10" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., en, es, zh">
+                            </div>
+                            <div class="grid grid-cols-2 gap-3">
+                                <div>
+                                    <label for="tagMinSpeakers" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="editTagModal.minSpeakers">Min Speakers</label>
+                                    <input type="number" id="tagMinSpeakers" name="default_min_speakers" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                </div>
+                                <div>
+                                    <label for="tagMaxSpeakers" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="editTagModal.maxSpeakers">Max Speakers</label>
+                                    <input type="number" id="tagMaxSpeakers" name="default_max_speakers" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    {% endif %}
+
+                    <!-- Hotwords & Initial Prompt -->
+                    {% if connector_supports_hotwords %}
+                    <div>
+                        <label for="tagHotwords" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.hotwords">Hotwords</label>
+                        <input type="text" id="tagHotwords" name="default_hotwords" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" data-i18n-placeholder="form.hotwordsPlaceholder" placeholder="e.g., Speakr, CTranslate2, PyAnnote">
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.hotwordsHelp">Comma-separated words to improve recognition of domain-specific terms</p>
+                    </div>
+                    {% endif %}
+                    {% if connector_supports_initial_prompt %}
+                    <div>
+                        <label for="tagInitialPrompt" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.initialPrompt">Initial Prompt</label>
+                        <textarea id="tagInitialPrompt" name="default_initial_prompt" rows="2" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" data-i18n-placeholder="form.initialPromptPlaceholder" placeholder="e.g., This is a meeting about AI transcription tools."></textarea>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.initialPromptHelp">Context to steer the transcription model's style and vocabulary</p>
+                    </div>
+                    {% endif %}
+
+                    <!-- Default transcription model (issue #266) — only rendered when admin set TRANSCRIPTION_MODELS_AVAILABLE -->
+                    <div id="tagTranscriptionModelSection" class="hidden">
+                        <label for="tagTranscriptionModel" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.defaultTranscriptionModel">Default transcription model</label>
+                        <select id="tagTranscriptionModel" name="default_transcription_model" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">(use admin/global default)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.defaultTranscriptionModelHelp">Override which transcription model is used for recordings with this tag.</p>
+                    </div>
+
+                    <!-- Retention Period Override (only shown when auto-deletion is enabled) -->
+                    <div id="tagRetentionSection" class="hidden border-t border-[var(--border-primary)] pt-4 mt-2">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-clock mr-2"></i>Retention & Auto-Deletion
+                        </h4>
+                        <div class="space-y-3">
+                            <div id="tagRetentionDaysContainer">
+                                <label for="tagRetentionDays" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Retention Period (days)</label>
+                                <input type="number" id="tagRetentionDays" name="retention_days" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Leave empty to use global retention">
+                                <p class="text-xs text-[var(--text-light)] mt-1">Leave empty to use global retention period.</p>
+                            </div>
+                            <div class="flex items-start space-x-3 p-3 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-md">
+                                <input type="checkbox" id="tagProtectFromDeletion" class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="tagProtectFromDeletion" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-shield-alt mr-1 text-yellow-600 dark:text-yellow-400"></i>
+                                        Protect from Auto-Deletion (Infinite Retention)
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">Recordings with this tag will never be automatically deleted.</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Tab: Summary & Templates -->
+                <div id="tagTabSummary" class="tag-modal-tab-content space-y-4 hidden">
+                    <div>
+                        <label for="tagCustomPrompt" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="editTagModal.customPrompt">Custom Summary Prompt</label>
+                        <textarea id="tagCustomPrompt" name="custom_prompt" rows="4" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Optional: Custom prompt for generating summaries for recordings with this tag" data-i18n-placeholder="editTagModal.customPromptPlaceholder"></textarea>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="editTagModal.leaveBlankPrompt">Leave blank to use your default summary prompt</p>
+
+                        {# Warning when this tag uses placeholder variables AND is configured as a watch-folder (auto-process) tag.
+                           Drop-folder ingest has no UI for users to fill values, so placeholders silently substitute to empty strings. #}
+                        <div id="tagAutoProcessVariableWarning" class="hidden mt-2 flex items-start gap-2 p-2.5 bg-[var(--bg-warning-light)] border border-[var(--border-warning)] rounded-md text-xs text-[var(--text-warning-strong)]">
+                            <i class="fas fa-exclamation-triangle mt-0.5"></i>
+                            <span data-i18n="editTagModal.watchFolderVariableWarning">This tag is set up as a watch folder and the prompt contains placeholder variables. Recordings ingested through the auto-process directory have no UI for users to fill those values, so the placeholders will substitute to empty strings on the first summary run. Either remove the placeholders or fill the values via reprocess after upload.</span>
+                        </div>
+                    </div>
+                    <div>
+                        <label for="tagNamingTemplate" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="editTagModal.namingTemplate">Naming Template</label>
+                        <select id="tagNamingTemplate" name="naming_template_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="" data-i18n="editTagModal.noNamingTemplate">No template (use user default or AI title)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="editTagModal.namingTemplateHint">Select a naming template to automatically format titles for recordings with this tag</p>
+                    </div>
+                    {% if enable_auto_export %}
+                    <div>
+                        <label for="tagExportTemplate" class="block text-sm font-medium text-[var(--text-secondary)] mb-1" data-i18n="editTagModal.exportTemplate">Export Template</label>
+                        <select id="tagExportTemplate" name="export_template_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="" data-i18n="editTagModal.noExportTemplate">No template (use user default)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="editTagModal.exportTemplateHint">Select an export template to use when exporting recordings with this tag</p>
+                    </div>
+                    {% endif %}
+                </div>
+
+                <!-- Tab: Sharing -->
+                <div id="tagTabSharing" class="tag-modal-tab-content space-y-4 hidden">
+                    <div id="tagGroupSelectionSection" class="hidden">
+                        <label for="tagGroupId" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Group Assignment (Optional)</label>
+                        <select id="tagGroupId" name="group_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="" data-i18n="account.personalTag">Personal Tag (Not Associated with a Group)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1">Assign this tag to a group to enable auto-sharing when applied to recordings</p>
+                    </div>
+                    <div id="tagGroupSettingsSection" class="hidden">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-users mr-2"></i>Group Sharing Settings
+                        </h4>
+                        <div class="space-y-3">
+                            <div class="flex items-start space-x-3">
+                                <input type="checkbox" id="tagAutoShareOnApply" name="auto_share_on_apply" checked class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="tagAutoShareOnApply" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-share-alt mr-1"></i>Auto-share with all group members
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">All group members will automatically get access to recordings with this tag</p>
+                                </div>
+                            </div>
+                            <div class="flex items-start space-x-3">
+                                <input type="checkbox" id="tagShareWithGroupLead" name="share_with_group_lead" checked class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="tagShareWithGroupLead" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-user-shield mr-1"></i>Share with group admins only
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">Only group admins will get access (not all members)</p>
+                                </div>
+                            </div>
+                        </div>
+                        <p class="text-xs text-[var(--text-light)] italic mt-3">Note: If both are enabled, all group members will have access.</p>
+                    </div>
+                </div>
+
+                <div class="flex justify-end space-x-3 pt-4 border-t border-[var(--border-primary)]">
+                    <button type="button" id="cancelTagBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]" data-i18n="buttons.cancel">Cancel</button>
+                    <button type="submit" id="saveTagBtn" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        <i class="fas fa-save mr-2"></i> <span data-i18n="buttons.createTag">Save Tag</span>
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <!-- Create/Edit Folder Modal -->
+    <div id="folderModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-lg max-h-[90vh] overflow-y-auto">
+            <div class="flex justify-between items-center mb-4">
+                <h3 id="folderModalTitle" class="text-xl font-semibold text-[var(--text-primary)]">Create Folder</h3>
+                <button id="closeFolderModalBtn" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
+            </div>
+
+            <form id="folderForm" class="space-y-4">
+                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+                <input type="hidden" id="folderId" name="folder_id">
+
+                <!-- Name and Color (always visible, outside tabs) -->
+                <div>
+                    <label for="folderName" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Folder Name *</label>
+                    <input type="text" id="folderName" name="name" required maxlength="50" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., Office Calls, Interviews">
+                </div>
+
+                <div>
+                    <label for="folderColor" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Color</label>
+                    <div class="flex items-center space-x-3">
+                        <input type="color" id="folderColor" name="color" value="#10B981" class="w-12 h-10 rounded border border-[var(--border-secondary)]">
+                        <span class="text-sm text-[var(--text-muted)]">Choose a color for easy identification</span>
+                    </div>
+                </div>
+
+                <!-- Tab Navigation -->
+                <div class="border-b border-[var(--border-primary)]">
+                    <nav class="flex -mb-px space-x-1" id="folderModalTabs">
+                        <button type="button" class="folder-modal-tab active px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-[var(--border-focus)] text-[var(--text-accent)]" data-tab="folderTabTranscription">
+                            <i class="fas fa-microphone mr-1"></i>Transcription
+                        </button>
+                        <button type="button" class="folder-modal-tab px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)]" data-tab="folderTabSummary">
+                            <i class="fas fa-file-alt mr-1"></i>Summary & Templates
+                        </button>
+                        <button type="button" id="folderTabSharingBtn" class="folder-modal-tab px-3 py-2 text-xs font-medium rounded-t-md border-b-2 border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hidden" data-tab="folderTabSharing">
+                            <i class="fas fa-users mr-1"></i>Sharing
+                        </button>
+                    </nav>
+                </div>
+
+                <!-- Tab: Transcription & Retention -->
+                <div id="folderTabTranscription" class="folder-modal-tab-content space-y-4">
+                    {% if connector_supports_diarization %}
+                    <div>
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Transcription Default Settings</h4>
+                        <p class="text-xs text-[var(--text-light)] mb-3">Tag settings take priority over folder settings</p>
+                        <div class="space-y-3">
+                            <div>
+                                <label for="folderLanguage" class="block text-sm font-medium text-[var(--text-muted)] mb-1">Default Language</label>
+                                <input type="text" id="folderLanguage" name="default_language" maxlength="10" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., en, es, zh">
+                            </div>
+                            <div class="grid grid-cols-2 gap-3">
+                                <div>
+                                    <label for="folderMinSpeakers" class="block text-sm font-medium text-[var(--text-muted)] mb-1">Min Speakers</label>
+                                    <input type="number" id="folderMinSpeakers" name="default_min_speakers" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                </div>
+                                <div>
+                                    <label for="folderMaxSpeakers" class="block text-sm font-medium text-[var(--text-muted)] mb-1">Max Speakers</label>
+                                    <input type="number" id="folderMaxSpeakers" name="default_max_speakers" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    {% endif %}
+
+                    <!-- Hotwords & Initial Prompt -->
+                    {% if connector_supports_hotwords %}
+                    <div>
+                        <label for="folderHotwords" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.hotwords">Hotwords</label>
+                        <input type="text" id="folderHotwords" name="default_hotwords" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" data-i18n-placeholder="form.hotwordsPlaceholder" placeholder="e.g., Speakr, CTranslate2, PyAnnote">
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.hotwordsHelp">Comma-separated words to improve recognition of domain-specific terms</p>
+                    </div>
+                    {% endif %}
+                    {% if connector_supports_initial_prompt %}
+                    <div>
+                        <label for="folderInitialPrompt" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.initialPrompt">Initial Prompt</label>
+                        <textarea id="folderInitialPrompt" name="default_initial_prompt" rows="2" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" data-i18n-placeholder="form.initialPromptPlaceholder" placeholder="e.g., This is a meeting about AI transcription tools."></textarea>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.initialPromptHelp">Context to steer the transcription model's style and vocabulary</p>
+                    </div>
+                    {% endif %}
+
+                    <!-- Default transcription model (issue #266) — only rendered when admin set TRANSCRIPTION_MODELS_AVAILABLE -->
+                    <div id="folderTranscriptionModelSection" class="hidden">
+                        <label for="folderTranscriptionModel" class="block text-sm font-medium text-[var(--text-muted)] mb-1" data-i18n="form.defaultTranscriptionModel">Default transcription model</label>
+                        <select id="folderTranscriptionModel" name="default_transcription_model" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">(use admin/global default)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1" data-i18n="form.defaultTranscriptionModelHelp">Override which transcription model is used for recordings in this folder.</p>
+                    </div>
+
+                    <!-- Retention Period Override (only shown when auto-deletion is enabled) -->
+                    <div id="folderRetentionSection" class="hidden border-t border-[var(--border-primary)] pt-4 mt-2">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-clock mr-2"></i>Retention & Auto-Deletion
+                        </h4>
+                        <div class="space-y-3">
+                            <div id="folderRetentionDaysContainer">
+                                <label for="folderRetentionDays" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Retention Period (days)</label>
+                                <input type="number" id="folderRetentionDays" name="retention_days" min="1" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Leave empty to use global retention">
+                                <p class="text-xs text-[var(--text-light)] mt-1">Leave empty to use global retention period.</p>
+                            </div>
+                            <div class="flex items-start space-x-3 p-3 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-md">
+                                <input type="checkbox" id="folderProtectFromDeletion" class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="folderProtectFromDeletion" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-shield-alt mr-1 text-yellow-600 dark:text-yellow-400"></i>
+                                        Protect from Auto-Deletion (Infinite Retention)
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">Recordings in this folder will never be automatically deleted.</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Tab: Summary & Templates -->
+                <div id="folderTabSummary" class="folder-modal-tab-content space-y-4 hidden">
+                    <div>
+                        <label for="folderCustomPrompt" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Custom Summary Prompt</label>
+                        <textarea id="folderCustomPrompt" name="custom_prompt" rows="4" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Optional: Custom prompt for generating summaries for recordings in this folder"></textarea>
+                        <p class="text-xs text-[var(--text-light)] mt-1">Leave blank to use your default summary prompt. Tag prompts take priority over folder prompts.</p>
+                    </div>
+                    <div>
+                        <label for="folderNamingTemplate" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Naming Template</label>
+                        <select id="folderNamingTemplate" name="naming_template_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">No template (use user default or AI title)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1">Select a naming template to automatically format titles for recordings in this folder</p>
+                    </div>
+                    {% if enable_auto_export %}
+                    <div>
+                        <label for="folderExportTemplate" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Export Template</label>
+                        <select id="folderExportTemplate" name="export_template_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">No template (use user default)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1">Select an export template to use when exporting recordings in this folder</p>
+                    </div>
+                    {% endif %}
+                </div>
+
+                <!-- Tab: Sharing -->
+                <div id="folderTabSharing" class="folder-modal-tab-content space-y-4 hidden">
+                    <div id="folderGroupSelectionSection" class="hidden">
+                        <label for="folderGroupId" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Group Assignment (Optional)</label>
+                        <select id="folderGroupId" name="group_id" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="" data-i18n="account.personalFolder">Personal Folder (Not Associated with a Group)</option>
+                        </select>
+                        <p class="text-xs text-[var(--text-light)] mt-1">Assign this folder to a group to enable auto-sharing when recordings are moved to it</p>
+                    </div>
+                    <div id="folderGroupSettingsSection" class="hidden">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-users mr-2"></i>Group Sharing Settings
+                        </h4>
+                        <div class="space-y-3">
+                            <div class="flex items-start space-x-3">
+                                <input type="checkbox" id="folderAutoShareOnApply" name="auto_share_on_apply" checked class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="folderAutoShareOnApply" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-share-alt mr-1"></i>Auto-share with all group members
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">All group members will automatically get access to recordings in this folder</p>
+                                </div>
+                            </div>
+                            <div class="flex items-start space-x-3">
+                                <input type="checkbox" id="folderShareWithGroupLead" name="share_with_group_lead" checked class="mt-1 h-4 w-4 text-[var(--bg-accent)] border-gray-300 rounded focus:ring-[var(--border-focus)]">
+                                <div class="flex-1">
+                                    <label for="folderShareWithGroupLead" class="block text-sm font-medium text-[var(--text-secondary)] cursor-pointer">
+                                        <i class="fas fa-user-shield mr-1"></i>Share with group admins only
+                                    </label>
+                                    <p class="text-xs text-[var(--text-light)] mt-1">Only group admins will get access (not all members)</p>
+                                </div>
+                            </div>
+                        </div>
+                        <p class="text-xs text-[var(--text-light)] italic mt-3">Note: If both are enabled, all group members will have access.</p>
+                    </div>
+                </div>
+
+                <div class="flex justify-end space-x-3 pt-4 border-t border-[var(--border-primary)]">
+                    <button type="button" id="cancelFolderBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
+                    <button type="submit" id="saveFolderBtn" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        <i class="fas fa-save mr-2"></i> <span>Save Folder</span>
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <!-- Create API Token Modal -->
+    <div id="createTokenModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+            <div class="flex justify-between items-center mb-4">
+                <h3 class="text-xl font-semibold text-[var(--text-primary)]">
+                    <i class="fas fa-key mr-2 text-[var(--text-accent)]"></i>Create API Token
+                </h3>
+                <button id="closeCreateTokenModal" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
+            </div>
+
+            <form id="createTokenForm" class="space-y-4">
+                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+
+                <div>
+                    <label for="tokenNameInput" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Token Name *</label>
+                    <input type="text" id="tokenNameInput" name="name" required maxlength="100" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., n8n automation, CLI access">
+                    <p class="text-xs text-[var(--text-light)] mt-1">A descriptive name to help you identify this token</p>
+                </div>
+
+                <div>
+                    <label for="tokenExpirationSelect" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Expiration</label>
+                    <select id="tokenExpirationSelect" name="expires_in_days" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <option value="0">Never expires</option>
+                        <option value="7">7 days</option>
+                        <option value="30">30 days</option>
+                        <option value="90">90 days</option>
+                        <option value="365">1 year</option>
+                    </select>
+                    <p class="text-xs text-[var(--text-light)] mt-1">When this token should expire</p>
+                </div>
+
+                <div class="bg-amber-50 border border-amber-200 rounded-lg p-3">
+                    <div class="flex">
+                        <i class="fas fa-info-circle text-amber-500 mr-2 mt-0.5"></i>
+                        <p class="text-xs text-amber-700">
+                            The token will only be shown once after creation. Make sure to copy and save it securely.
+                        </p>
+                    </div>
+                </div>
+
+                <div class="flex justify-end space-x-3 pt-2">
+                    <button type="button" id="cancelCreateTokenBtn" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
+                    <button type="submit" id="submitCreateTokenBtn" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        <i class="fas fa-plus mr-2"></i>Create Token
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <!-- Token Secret Modal (shown after creation) -->
+    <div id="tokenSecretModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+            <div class="flex justify-between items-center mb-4">
+                <h3 class="text-xl font-semibold text-[var(--text-primary)]">
+                    <i class="fas fa-check-circle mr-2 text-green-500"></i>Token Created!
+                </h3>
+            </div>
+
+            <div class="space-y-4">
+                <div class="bg-red-50 border border-red-200 rounded-lg p-3">
+                    <div class="flex">
+                        <i class="fas fa-exclamation-triangle text-red-500 mr-2 mt-0.5"></i>
+                        <p class="text-xs text-red-700">
+                            <strong>Important!</strong> This is the only time you'll see this token. Copy it now and store it securely.
+                        </p>
+                    </div>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Your API Token</label>
+                    <div class="relative">
+                        <input type="text" id="newTokenValue" readonly class="w-full px-3 py-2 pr-12 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-tertiary)] text-[var(--text-primary)] font-mono text-sm">
+                        <button type="button" id="copyTokenBtn" class="absolute right-2 top-1/2 transform -translate-y-1/2 px-3 py-1.5 hover:bg-[var(--bg-tertiary)] rounded-md transition-all duration-200 flex items-center gap-1.5 border border-transparent hover:border-[var(--border-secondary)]" title="Copy to clipboard">
+                            <i id="copyTokenIcon" class="fas fa-copy text-[var(--text-muted)]"></i>
+                            <span id="copyTokenText" class="text-xs text-[var(--text-muted)] hidden">Copied!</span>
+                        </button>
+                    </div>
+                </div>
+
+                <div id="newTokenInfo" class="space-y-2 text-sm">
+                    <!-- Populated dynamically -->
+                </div>
+
+                <div class="flex justify-end pt-2">
+                    <button type="button" id="closeTokenSecretModal" class="px-4 py-2 bg-green-600 text-white rounded-md hover:bg-green-700">
+                        <i class="fas fa-check mr-2"></i>I've Saved My Token
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', async function() {
+            try {
+                // Initialize i18n
+                await initializeI18n();
+            } catch (error) {
+                console.error('Error initializing i18n:', error);
+            }
+
+            // ====================================================
+            // Full LLM prompt structure preview
+            // ====================================================
+            // Pure-JS render (account page is Jinja-only, no Vue). Builds the
+            // chip markup as real DOM nodes - never innerHTML - so the chip
+            // injection cannot interpret user-supplied text as HTML. The whole
+            // function body is inside a Jinja raw block because it contains
+            // literal double-brace strings that Jinja would otherwise eat.
+            {% raw %}
+            (function setupFullPromptPreview() {
+                const toggleBtn = document.getElementById('toggleFullPromptStructure');
+                const body = document.getElementById('fullPromptStructureBody');
+                const chevron = document.getElementById('fullPromptChevron');
+                const sysEl = document.getElementById('previewSystemPrompt');
+                const userEl = document.getElementById('previewUserMessage');
+                const customDisplay = document.getElementById('currentDefaultPromptDisplay');
+                const promptTextarea = document.getElementById('summary_prompt_custom');
+                if (!toggleBtn || !body || !sysEl || !userEl) return;
+
+                // Match `{{user_var}}` first (longer pattern) and `{system_var}`
+                // second. Combined regex with two capture groups so we can
+                // tell which kind matched without a second pass.
+                const PLACEHOLDER_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}|\{(\s*[A-Za-z_][A-Za-z0-9_]*\s*)\}/g;
+
+                // Build a chip span for a placeholder match. Returns a real
+                // DOM element so caller can append directly.
+                const makeChip = (kind, name) => {
+                    const span = document.createElement('span');
+                    if (kind === 'user') {
+                        span.className = 'px-1.5 py-0.5 rounded text-[11px] font-semibold bg-amber-500/15 text-amber-300 border border-amber-500/30';
+                        span.title = 'User-supplied variable. Filled at upload or reprocess.';
+                        span.textContent = '{{' + name + '}}';
+                    } else {
+                        span.className = 'px-1.5 py-0.5 rounded text-[11px] font-semibold bg-blue-500/15 text-blue-300 border border-blue-500/30';
+                        span.title = 'System placeholder. Replaced by the framework before the LLM call.';
+                        span.textContent = '{' + name + '}';
+                    }
+                    return span;
+                };
+
+                // Append chip-decorated text into the target element. Plain
+                // segments go in as text nodes; placeholders go in as chip
+                // spans. Caller clears target first if needed.
+                const decorateInto = (target, text) => {
+                    if (!text) return;
+                    let last = 0;
+                    for (const match of text.matchAll(PLACEHOLDER_RE)) {
+                        if (match.index > last) {
+                            target.appendChild(document.createTextNode(text.slice(last, match.index)));
+                        }
+                        if (match[1] !== undefined) {
+                            target.appendChild(makeChip('user', match[1]));
+                        } else {
+                            target.appendChild(makeChip('system', match[2]));
+                        }
+                        last = match.index + match[0].length;
+                    }
+                    if (last < text.length) {
+                        target.appendChild(document.createTextNode(text.slice(last)));
+                    }
+                };
+
+                // Decorate the small "Current Default Prompt" pre below the
+                // textarea so the admin default's placeholders show as chips.
+                const defaultPromptFallback = customDisplay ? customDisplay.textContent : '';
+                if (customDisplay) {
+                    customDisplay.textContent = '';
+                    decorateInto(customDisplay, defaultPromptFallback);
+                }
+
+                const SYSTEM_PROMPT_TEMPLATE =
+                    'You are an AI assistant that generates comprehensive summaries for meeting transcripts. Respond only with the summary in Markdown format. Do NOT use markdown code blocks (```markdown). Provide raw markdown content directly.\n\n' +
+                    'Context:\n' +
+                    '- Current date: {current_date}\n' +
+                    '- Recording date: {recording_date}    [if meeting date is set]\n' +
+                    '- Recording title: {recording_title}    [if title is set]\n' +
+                    '- Folder: {folder_name}    [if recording is in a folder]\n' +
+                    '- Tags applied to this transcript by the user: {tag_names}    [if tags exist]\n' +
+                    '- Information about the user: Name: {name}, Job title: {job_title}, Company: {company}    [only the fields you have filled in your account]\n\n' +
+                    'Language Requirement: You MUST generate the entire summary in {user_output_language}. This is mandatory.    [only added if your output language is set]';
+
+                const userMessageBefore =
+                    'Transcription:\n"""\n{transcript_text}\n"""\n\n' +
+                    'Summarization Instructions:\n';
+                const userMessageAfter =
+                    '\n\n{language_directive}    [resolves to: "IMPORTANT: You MUST provide the summary in <your-language>." — only added if language preference is set]';
+
+                const renderPreview = () => {
+                    const userPrompt = (promptTextarea && promptTextarea.value.trim())
+                        ? promptTextarea.value
+                        : defaultPromptFallback;
+                    sysEl.textContent = '';
+                    decorateInto(sysEl, SYSTEM_PROMPT_TEMPLATE);
+                    userEl.textContent = '';
+                    decorateInto(userEl, userMessageBefore);
+                    decorateInto(userEl, userPrompt);
+                    decorateInto(userEl, userMessageAfter);
+                };
+
+                renderPreview();
+
+                if (promptTextarea) {
+                    promptTextarea.addEventListener('input', renderPreview);
+                }
+
+                toggleBtn.addEventListener('click', () => {
+                    const isHidden = body.classList.toggle('hidden');
+                    chevron.classList.toggle('fa-chevron-down', isHidden);
+                    chevron.classList.toggle('fa-chevron-up', !isHidden);
+                });
+            })();
+            {% endraw %}
+
+            // Setup auto speaker labelling toggle and dropdown
+            const autoLabelToggle = document.getElementById('autoSpeakerLabellingToggle');
+            const autoLabelThreshold = document.getElementById('autoSpeakerLabellingThreshold');
+
+            async function updateAutoSpeakerLabelling() {
+                const enabled = autoLabelToggle ? autoLabelToggle.checked : false;
+                const threshold = autoLabelThreshold ? autoLabelThreshold.value : 'medium';
+
+                // Enable/disable dropdown based on toggle
+                if (autoLabelThreshold) {
+                    autoLabelThreshold.disabled = !enabled;
+                }
+
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                try {
+                    const response = await fetch('/api/user/auto-speaker-labelling', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-CSRFToken': csrfToken
+                        },
+                        body: JSON.stringify({
+                            enabled: enabled,
+                            threshold: threshold
+                        })
+                    });
+
+                    if (!response.ok) {
+                        console.error('Failed to update auto speaker labelling settings');
+                    }
+                } catch (error) {
+                    console.error('Error updating auto speaker labelling:', error);
+                }
+            }
+
+            if (autoLabelToggle) {
+                autoLabelToggle.addEventListener('change', updateAutoSpeakerLabelling);
+            }
+            if (autoLabelThreshold) {
+                autoLabelThreshold.addEventListener('change', updateAutoSpeakerLabelling);
+            }
+
+            // Setup auto summarization toggle
+            const autoSummarizationToggle = document.getElementById('autoSummarizationToggle');
+
+            async function updateAutoSummarization() {
+                if (!autoSummarizationToggle) return;
+
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                try {
+                    const response = await fetch('/api/user/auto-summarization', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-CSRFToken': csrfToken
+                        },
+                        body: JSON.stringify({
+                            enabled: autoSummarizationToggle.checked
+                        })
+                    });
+
+                    if (!response.ok) {
+                        console.error('Failed to update auto summarization setting');
+                    }
+                } catch (error) {
+                    console.error('Error updating auto summarization:', error);
+                }
+            }
+
+            if (autoSummarizationToggle) {
+                autoSummarizationToggle.addEventListener('change', updateAutoSummarization);
+            }
+
+            // Setup merge modal event listeners
+            const closeMergeModalBtn = document.getElementById('closeMergeModal');
+            const cancelMergeBtn = document.getElementById('cancelMergeBtn');
+            const executeMergeBtn = document.getElementById('executeMergeBtn');
+            const mergeSpeakersModal = document.getElementById('mergeSpeakersModal');
+
+            if (closeMergeModalBtn) {
+                closeMergeModalBtn.addEventListener('click', () => {
+                    mergeSpeakersModal.classList.add('hidden');
+                });
+            }
+
+            if (cancelMergeBtn) {
+                cancelMergeBtn.addEventListener('click', () => {
+                    mergeSpeakersModal.classList.add('hidden');
+                });
+            }
+
+            if (executeMergeBtn) {
+                executeMergeBtn.addEventListener('click', () => {
+                    executeSpeakerMerge();
+                });
+            }
+
+            // Setup edit speaker modal event listeners
+            const closeEditSpeakerModalBtn = document.getElementById('closeEditSpeakerModal');
+            const cancelEditSpeakerBtn = document.getElementById('cancelEditSpeakerBtn');
+            const saveEditSpeakerBtn = document.getElementById('saveEditSpeakerBtn');
+            const editSpeakerModal = document.getElementById('editSpeakerModal');
+            const editSpeakerNameInput = document.getElementById('editSpeakerNameInput');
+            const editSpeakerError = document.getElementById('editSpeakerError');
+
+            let currentEditingSpeakerId = null;
+
+            function closeEditSpeakerModalFn() {
+                editSpeakerModal.classList.add('hidden');
+                editSpeakerNameInput.value = '';
+                editSpeakerError.classList.add('hidden');
+                currentEditingSpeakerId = null;
+            }
+
+            if (closeEditSpeakerModalBtn) {
+                closeEditSpeakerModalBtn.addEventListener('click', closeEditSpeakerModalFn);
+            }
+
+            if (cancelEditSpeakerBtn) {
+                cancelEditSpeakerBtn.addEventListener('click', closeEditSpeakerModalFn);
+            }
+
+            // Close modal when clicking outside
+            editSpeakerModal.addEventListener('click', (event) => {
+                if (event.target === editSpeakerModal) {
+                    closeEditSpeakerModalFn();
+                }
+            });
+
+            // Handle Enter key to save
+            editSpeakerNameInput.addEventListener('keypress', (event) => {
+                if (event.key === 'Enter') {
+                    event.preventDefault();
+                    saveEditSpeakerBtn.click();
+                }
+            });
+
+            if (saveEditSpeakerBtn) {
+                saveEditSpeakerBtn.addEventListener('click', async () => {
+                    const newName = editSpeakerNameInput.value.trim();
+
+                    if (!newName) {
+                        editSpeakerError.textContent = 'Speaker name cannot be empty';
+                        editSpeakerError.classList.remove('hidden');
+                        return;
+                    }
+
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const response = await fetch(`/speakers/${currentEditingSpeakerId}`, {
+                            method: 'PUT',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': csrfToken
+                            },
+                            body: JSON.stringify({ name: newName })
+                        });
+
+                        const data = await response.json();
+
+                        if (!response.ok) {
+                            editSpeakerError.textContent = data.error || 'Failed to update speaker';
+                            editSpeakerError.classList.remove('hidden');
+                            return;
+                        }
+
+                        showToast('Speaker name updated successfully');
+                        closeEditSpeakerModalFn();
+
+                        // Reload speakers - reset flag to force reload
+                        speakersTabLoaded = false;
+                        await loadSpeakersTab();
+                    } catch (error) {
+                        console.error('Error updating speaker:', error);
+                        editSpeakerError.textContent = 'Failed to update speaker';
+                        editSpeakerError.classList.remove('hidden');
+                    }
+                });
+            }
+
+            // Setup delete selected speakers modal event listeners
+            const cancelDeleteSelectedBtn = document.getElementById('cancelDeleteSelectedBtn');
+            const confirmDeleteSelectedBtn = document.getElementById('confirmDeleteSelectedBtn');
+            const deleteSelectedSpeakersModal = document.getElementById('deleteSelectedSpeakersModal');
+
+            if (cancelDeleteSelectedBtn) {
+                cancelDeleteSelectedBtn.addEventListener('click', () => {
+                    deleteSelectedSpeakersModal.classList.add('hidden');
+                });
+            }
+
+            if (confirmDeleteSelectedBtn) {
+                confirmDeleteSelectedBtn.addEventListener('click', () => {
+                    executeDeleteSelectedSpeakers();
+                });
+            }
+
+            // Setup clear voice profiles modal event listeners
+            const cancelClearVoiceProfilesBtn = document.getElementById('cancelClearVoiceProfilesBtn');
+            const confirmClearVoiceProfilesBtn = document.getElementById('confirmClearVoiceProfilesBtn');
+            const clearVoiceProfilesModal = document.getElementById('clearVoiceProfilesModal');
+
+            if (cancelClearVoiceProfilesBtn) {
+                cancelClearVoiceProfilesBtn.addEventListener('click', () => {
+                    clearVoiceProfilesModal.classList.add('hidden');
+                });
+            }
+
+            if (confirmClearVoiceProfilesBtn) {
+                confirmClearVoiceProfilesBtn.addEventListener('click', () => {
+                    executeClearVoiceProfiles();
+                });
+            }
+
+            // Hide loading overlay
+            if (window.AppLoader) {
+                window.AppLoader.hide();
+            }
+
+            // Setup scroll indicators for tabs
+            const tabsContainer = document.getElementById('tabs-container');
+            const leftIndicator = document.getElementById('left-scroll-indicator');
+            const rightIndicator = document.getElementById('right-scroll-indicator');
+
+            function updateScrollIndicators() {
+                if (tabsContainer && leftIndicator && rightIndicator) {
+                    const scrollLeft = tabsContainer.scrollLeft;
+                    const scrollWidth = tabsContainer.scrollWidth;
+                    const clientWidth = tabsContainer.clientWidth;
+
+                    // Show/hide left indicator
+                    if (scrollLeft > 10) {
+                        leftIndicator.classList.remove('opacity-0');
+                        leftIndicator.classList.add('opacity-100');
+                    } else {
+                        leftIndicator.classList.add('opacity-0');
+                        leftIndicator.classList.remove('opacity-100');
+                    }
+
+                    // Show/hide right indicator
+                    if (scrollLeft < scrollWidth - clientWidth - 10) {
+                        rightIndicator.classList.remove('opacity-0');
+                        rightIndicator.classList.add('opacity-100');
+                    } else {
+                        rightIndicator.classList.add('opacity-0');
+                        rightIndicator.classList.remove('opacity-100');
+                    }
+                }
+            }
+
+            if (tabsContainer) {
+                tabsContainer.addEventListener('scroll', updateScrollIndicators);
+                window.addEventListener('resize', updateScrollIndicators);
+                // Initial check - run immediately and after a delay
+                updateScrollIndicators();
+                setTimeout(updateScrollIndicators, 100);
+                setTimeout(updateScrollIndicators, 500);
+
+                // Add click handlers for scroll indicators
+                if (leftIndicator) {
+                    leftIndicator.addEventListener('click', () => {
+                        tabsContainer.scrollBy({ left: -200, behavior: 'smooth' });
+                    });
+                }
+                if (rightIndicator) {
+                    rightIndicator.addEventListener('click', () => {
+                        tabsContainer.scrollBy({ left: 200, behavior: 'smooth' });
+                    });
+                }
+            }
+
+            const tabAccount = document.getElementById('tab-account');
+            const tabPrompts = document.getElementById('tab-prompts');
+            const tabShares = document.getElementById('tab-shares');
+            const tabFolders = document.getElementById('tab-folders');
+            const tabTags = document.getElementById('tab-tags');
+            const tabTemplates = document.getElementById('tab-templates');
+            const tabTokens = document.getElementById('tab-tokens');
+            const tabAbout = document.getElementById('tab-about');
+            const tabPreferences = document.getElementById('tab-preferences');
+            const contentAccount = document.getElementById('content-account');
+            const contentPrompts = document.getElementById('content-prompts');
+            const contentPreferences = document.getElementById('content-preferences');
+            const contentShares = document.getElementById('content-shares');
+            const contentSpeakers = document.getElementById('content-speakers');
+            const contentFolders = document.getElementById('content-folders');
+            const contentTags = document.getElementById('content-tags');
+            const contentTemplates = document.getElementById('content-templates');
+            const contentTokens = document.getElementById('content-tokens');
+            const contentAbout = document.getElementById('content-about');
+            const sharesContainer = document.getElementById('shares-container');
+
+
+            // Simplified tab switching
+            const tabSpeakers = document.getElementById('tab-speakers');
+
+            const tabs = [
+                { tab: tabAccount, content: contentAccount, name: 'account' },
+                { tab: tabPreferences, content: contentPreferences, name: 'preferences' },
+                { tab: tabPrompts, content: contentPrompts, name: 'prompts' },
+                { tab: tabShares, content: contentShares, name: 'shares' },
+                { tab: tabSpeakers, content: contentSpeakers, name: 'speakers' },
+                { tab: tabFolders, content: contentFolders, name: 'folders' },
+                { tab: tabTags, content: contentTags, name: 'tags' },
+                { tab: tabTemplates, content: contentTemplates, name: 'templates' },
+                { tab: tabTokens, content: contentTokens, name: 'tokens' },
+                { tab: tabAbout, content: contentAbout, name: 'about' }
+            ];
+
+            function switchToTab(targetName) {
+                tabs.forEach(({ tab, content, name }) => {
+                    if (name === targetName) {
+                        // Active tab
+                        tab.classList.add('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                        tab.classList.remove('border-transparent', 'text-[var(--text-muted)]', 'hover:text-[var(--text-secondary)]', 'hover:border-[var(--border-secondary)]');
+                        content.classList.remove('hidden');
+                    } else {
+                        // Inactive tab
+                        tab.classList.add('border-transparent', 'text-[var(--text-muted)]', 'hover:text-[var(--text-secondary)]', 'hover:border-[var(--border-secondary)]');
+                        tab.classList.remove('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                        content.classList.add('hidden');
+                    }
+                });
+
+                // Load content when switching tabs
+                if (targetName === 'speakers') {
+                    loadSpeakersTab();
+                } else if (targetName === 'shares') {
+                    loadShares();
+                } else if (targetName === 'folders') {
+                    loadFolders();
+                } else if (targetName === 'tags') {
+                    loadTags();
+                } else if (targetName === 'templates') {
+                    loadTemplates();
+                } else if (targetName === 'tokens') {
+                    loadTokensTab();
+                } else if (targetName === 'about') {
+                    loadSystemInfo();
+                }
+            }
+
+            function showAccountTab() {
+                switchToTab('account');
+            }
+
+            function showPreferencesTab() {
+                switchToTab('preferences');
+            }
+
+            function showPromptsTab() {
+                switchToTab('prompts');
+            }
+
+            function showSharesTab() {
+                switchToTab('shares');
+            }
+
+            function showSpeakersTab() {
+                switchToTab('speakers');
+            }
+
+            function showTagsTab() {
+                switchToTab('tags');
+            }
+
+            function showFoldersTab() {
+                switchToTab('folders');
+            }
+
+            function showTemplatesTab() {
+                switchToTab('templates');
+            }
+
+            function showTokensTab() {
+                switchToTab('tokens');
+            }
+
+            function showAboutTab() {
+                switchToTab('about');
+            }
+
+            tabAccount.addEventListener('click', (e) => {
+                e.preventDefault();
+                showAccountTab();
+            });
+
+            if (tabPreferences) {
+                tabPreferences.addEventListener('click', (e) => {
+                    e.preventDefault();
+                    showPreferencesTab();
+                });
+            }
+
+            tabPrompts.addEventListener('click', (e) => {
+                e.preventDefault();
+                showPromptsTab();
+            });
+
+            tabShares.addEventListener('click', (e) => {
+                e.preventDefault();
+                showSharesTab();
+            });
+
+            tabSpeakers.addEventListener('click', (e) => {
+                e.preventDefault();
+                showSpeakersTab();
+            });
+
+            tabTags.addEventListener('click', (e) => {
+                e.preventDefault();
+                showTagsTab();
+            });
+
+            if (tabFolders) {
+                tabFolders.addEventListener('click', (e) => {
+                    e.preventDefault();
+                    showFoldersTab();
+                });
+            }
+
+            tabTemplates.addEventListener('click', (e) => {
+                e.preventDefault();
+                showTemplatesTab();
+            });
+
+            tabTokens.addEventListener('click', (e) => {
+                e.preventDefault();
+                showTokensTab();
+            });
+
+            tabAbout.addEventListener('click', (e) => {
+                e.preventDefault();
+                showAboutTab();
+            });
+
+            // Load speakers for the Speakers Management tab
+            let speakersTabData = [];
+            let speakersTabLoaded = false;
+            
+            async function loadSpeakersTab() {
+                // Don't reload if already loaded
+                if (speakersTabLoaded) return;
+                
+                const speakersTabLoading = document.getElementById('speakersTabLoading');
+                const speakersTabError = document.getElementById('speakersTabError');
+                const speakersTabErrorMessage = document.getElementById('speakersTabErrorMessage');
+                const speakersTabEmpty = document.getElementById('speakersTabEmpty');
+                const speakersTabGrid = document.getElementById('speakersTabGrid');
+                const speakersTabCount = document.getElementById('speakersTabCount');
+
+                // Show loading state
+                speakersTabLoading.classList.remove('hidden');
+                speakersTabError.classList.add('hidden');
+                speakersTabEmpty.classList.add('hidden');
+                speakersTabGrid.classList.add('hidden');
+
+                try {
+                    const response = await fetch('/speakers');
+                    if (!response.ok) {
+                        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                    }
+
+                    speakersTabData = await response.json();
+                    speakersTabLoaded = true;
+
+                    // Hide loading state
+                    speakersTabLoading.classList.add('hidden');
+
+                    if (speakersTabData.length === 0) {
+                        speakersTabEmpty.classList.remove('hidden');
+                        speakersTabGrid.classList.add('hidden');
+                    } else {
+                        speakersTabEmpty.classList.add('hidden');
+                        speakersTabGrid.classList.remove('hidden');
+                        renderSpeakersTabGrid();
+                    }
+                    
+                    // Update counts in all locations
+                    document.querySelectorAll('.speakers-count').forEach(el => {
+                        el.textContent = speakersTabData.length;
+                    });
+                    
+                } catch (error) {
+                    console.error('Error loading speakers:', error);
+                    speakersTabLoading.classList.add('hidden');
+                    speakersTabError.classList.remove('hidden');
+                    speakersTabEmpty.classList.add('hidden');
+                    speakersTabGrid.classList.add('hidden');
+                    speakersTabErrorMessage.textContent = error.message;
+                    document.querySelectorAll('.speakers-count').forEach(el => {
+                        el.textContent = '0';
+                    });
+                }
+            }
+            
+            function renderSpeakersTabGrid() {
+                const speakersTabGrid = document.getElementById('speakersTabGrid');
+                speakersTabGrid.innerHTML = '';
+
+                // Re-apply active filter after render
+                const searchInput = document.getElementById('speakerSearchInput');
+                const activeFilter = searchInput ? searchInput.value : '';
+
+                speakersTabData.forEach(speaker => {
+                    const createdDate = new Date(speaker.created_at).toLocaleDateString();
+                    const lastUsedDate = new Date(speaker.last_used).toLocaleDateString();
+
+                    // Voice profile status
+                    const hasVoiceProfile = speaker.embedding_count && speaker.embedding_count > 0;
+                    const confidenceLevel = speaker.confidence_score
+                        ? (speaker.confidence_score >= 0.8 ? 'high' : speaker.confidence_score >= 0.6 ? 'medium' : 'low')
+                        : null;
+                    const confidenceBadge = hasVoiceProfile && confidenceLevel
+                        ? `<span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium" style="background-color: ${confidenceLevel === 'high' ? '#10b981' : confidenceLevel === 'medium' ? '#f59e0b' : '#f97316'}; color: white;">
+                            <i class="fas fa-shield-alt mr-1"></i>${confidenceLevel}
+                          </span>`
+                        : '';
+
+                    const speakerCard = document.createElement('div');
+                    speakerCard.className = 'bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] hover:border-[var(--border-accent)] transition-colors duration-200';
+                    speakerCard.dataset.speakerId = speaker.id;
+                    speakerCard.dataset.speakerName = speaker.name.toLowerCase();
+
+                    speakerCard.innerHTML = `
+                        <div class="p-3">
+                            <!-- Header with checkbox, name, and action buttons -->
+                            <div class="flex items-center justify-between mb-2">
+                                <div class="flex items-center flex-1 min-w-0 gap-2">
+                                    <input type="checkbox" class="speaker-select-checkbox rounded border-gray-300 dark:border-gray-600 text-blue-600 focus:ring-blue-500 flex-shrink-0"
+                                           data-speaker-id="${speaker.id}" data-speaker-name="${escapeHtml(speaker.name)}">
+                                    <i class="fas fa-user text-[var(--text-accent)] text-sm flex-shrink-0"></i>
+                                    <h3 class="font-medium text-sm text-[var(--text-primary)] truncate">${escapeHtml(speaker.name)}</h3>
+                                </div>
+                                <div class="flex gap-1 flex-shrink-0">
+                                    <button class="edit-speaker-tab-btn p-1 text-[var(--text-accent)] hover:bg-[var(--bg-accent-light)] rounded transition-colors"
+                                            data-speaker-id="${speaker.id}"
+                                            data-speaker-name="${escapeHtml(speaker.name)}"
+                                            title="Edit speaker name">
+                                        <i class="fas fa-edit text-xs"></i>
+                                    </button>
+                                    <button class="delete-speaker-tab-btn p-1 text-[var(--text-danger)] hover:bg-[var(--bg-danger-light)] rounded transition-colors"
+                                            data-speaker-id="${speaker.id}"
+                                            data-speaker-name="${escapeHtml(speaker.name)}"
+                                            title="Delete speaker">
+                                        <i class="fas fa-trash text-xs"></i>
+                                    </button>
+                                </div>
+                            </div>
+
+                            <!-- Voice Profile Badge (if exists) -->
+                            ${hasVoiceProfile ? `
+                            <div class="flex items-center justify-between gap-2 mb-2 px-2 py-1 bg-[var(--bg-secondary)] rounded">
+                                <div class="flex items-center gap-1.5 min-w-0">
+                                    <i class="fas fa-eraser text-blue-500 text-[10px] flex-shrink-0"></i>
+                                    <span class="text-[10px] text-[var(--text-muted)] truncate">${speaker.embedding_count} sample${speaker.embedding_count !== 1 ? 's' : ''}</span>
+                                </div>
+                                ${confidenceBadge}
+                            </div>
+                            ` : ''}
+
+                            <!-- Stats in compact grid -->
+                            <div class="grid grid-cols-2 gap-1 text-[10px] text-[var(--text-muted)] mb-2">
+                                <div class="flex items-center gap-1">
+                                    <i class="fas fa-chart-line opacity-60"></i>
+                                    <span>${speaker.use_count}x</span>
+                                </div>
+                                <div class="flex items-center gap-1">
+                                    <i class="fas fa-clock opacity-60"></i>
+                                    <span class="truncate">${lastUsedDate}</span>
+                                </div>
+                            </div>
+
+                            <!-- View Voice Samples Button -->
+                            <button class="view-snippets-btn w-full px-2 py-1 text-[10px] bg-[var(--bg-secondary)] hover:bg-[var(--bg-primary)] text-[var(--text-secondary)] rounded border border-[var(--border-secondary)] transition-colors"
+                                    data-speaker-id="${speaker.id}">
+                                <i class="fas fa-volume-up mr-1"></i>
+                                <span>Voice Samples</span>
+                                <i class="fas fa-chevron-down ml-1 transition-transform duration-200"></i>
+                            </button>
+
+                            <!-- Snippets Container -->
+                            <div class="snippets-container mt-2 hidden">
+                                <div class="snippets-loading text-center py-3">
+                                    <i class="fas fa-spinner fa-spin text-[var(--text-muted)] text-xs"></i>
+                                </div>
+                                <div class="snippets-content"></div>
+                            </div>
+                        </div>
+                    `;
+
+                    // Add edit functionality
+                    const editBtn = speakerCard.querySelector('.edit-speaker-tab-btn');
+                    editBtn.addEventListener('click', () => openEditSpeakerModal(speaker.id, speaker.name));
+
+                    // Add delete functionality
+                    const deleteBtn = speakerCard.querySelector('.delete-speaker-tab-btn');
+                    deleteBtn.addEventListener('click', () => deleteSpeakerFromTab(speaker.id, speaker.name));
+
+                    // Add view snippets functionality
+                    const viewSnippetsBtn = speakerCard.querySelector('.view-snippets-btn');
+                    const snippetsContainer = speakerCard.querySelector('.snippets-container');
+                    viewSnippetsBtn.addEventListener('click', () => toggleSpeakerSnippets(speaker.id, viewSnippetsBtn, snippetsContainer));
+
+                    speakersTabGrid.appendChild(speakerCard);
+                });
+
+                // Update bulk operation buttons state
+                updateBulkOperationButtons();
+
+                // Re-apply search filter if active
+                if (activeFilter) {
+                    filterSpeakers(activeFilter);
+                }
+            }
+            
+            function openEditSpeakerModal(speakerId, currentName) {
+                currentEditingSpeakerId = speakerId;
+                editSpeakerNameInput.value = currentName;
+                editSpeakerError.classList.add('hidden');
+                editSpeakerModal.classList.remove('hidden');
+                // Focus input and select text for easy editing
+                setTimeout(() => {
+                    editSpeakerNameInput.focus();
+                    editSpeakerNameInput.select();
+                }, 100);
+            }
+
+            async function deleteSpeakerFromTab(speakerId, speakerName) {
+                if (!confirm(`Are you sure you want to delete "${speakerName}"?`)) {
+                    return;
+                }
+
+                try {
+                    // Get CSRF token
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                    
+                    const headers = {};
+                    if (csrfToken) {
+                        headers['X-CSRFToken'] = csrfToken;
+                    }
+                    
+                    const response = await fetch(`/speakers/${speakerId}`, { 
+                        method: 'DELETE',
+                        headers: headers
+                    });
+                    
+                    if (!response.ok) {
+                        const errorData = await response.json();
+                        throw new Error(errorData.error || `HTTP ${response.status}: ${response.statusText}`);
+                    }
+                    
+                    // Remove from local array and re-render
+                    speakersTabData = speakersTabData.filter(s => s.id !== speakerId);
+                    
+                    if (speakersTabData.length === 0) {
+                        document.getElementById('speakersTabEmpty').classList.remove('hidden');
+                        document.getElementById('speakersTabGrid').classList.add('hidden');
+                    } else {
+                        renderSpeakersTabGrid();
+                    }
+                    
+                    document.querySelectorAll('.speakers-count').forEach(el => {
+                        el.textContent = speakersTabData.length;
+                    });
+                    showToast(`Speaker "${speakerName}" deleted successfully`);
+                } catch (error) {
+                    console.error('Error deleting speaker:', error);
+                    showToast(`Failed to delete speaker: ${error.message}`, 'error');
+                }
+            }
+
+            // Toggle speaker snippets
+            async function toggleSpeakerSnippets(speakerId, button, container) {
+                const isExpanded = !container.classList.contains('hidden');
+                const chevron = button.querySelector('.fa-chevron-down');
+
+                if (isExpanded) {
+                    container.classList.add('hidden');
+                    chevron.classList.remove('rotate-180');
+                    // Pause all audio players in this container
+                    container.querySelectorAll('audio').forEach(audio => audio.pause());
+                    return;
+                }
+
+                // Expand and load snippets
+                container.classList.remove('hidden');
+                chevron.classList.add('rotate-180');
+
+                const loadingEl = container.querySelector('.snippets-loading');
+                const contentEl = container.querySelector('.snippets-content');
+
+                loadingEl.classList.remove('hidden');
+                contentEl.classList.add('hidden');
+
+                try {
+                    const response = await fetch(`/speakers/${speakerId}/snippets?limit=3`);
+                    if (!response.ok) throw new Error('Failed to load snippets');
+
+                    const data = await response.json();
+                    const snippets = data.snippets || [];
+
+                    loadingEl.classList.add('hidden');
+                    contentEl.classList.remove('hidden');
+
+                    if (snippets.length === 0) {
+                        contentEl.innerHTML = `
+                            <div class="text-xs text-[var(--text-muted)] text-center py-3 px-2">
+                                <i class="fas fa-info-circle mb-2 text-blue-500"></i>
+                                <p class="mb-1">No voice samples found</p>
+                                <p class="text-[10px] leading-relaxed">Voice samples are created when you identify speakers in recordings</p>
+                            </div>
+                        `;
+                    } else {
+                        contentEl.innerHTML = `
+                            <div class="space-y-2 mt-2">
+                                ${snippets.map((snippet, idx) => `
+                                    <div class="bg-[var(--bg-secondary)] p-2 rounded border border-[var(--border-secondary)]">
+                                        <!-- Compact audio player -->
+                                        <div class="flex items-center gap-2">
+                                            <div
+                                                class="flex items-center justify-center w-5 h-5 rounded-full bg-[var(--bg-accent)] text-[var(--text-accent)] text-[10px] font-medium flex-shrink-0 cursor-help"
+                                                title="${escapeHtml(snippet.recording_title)}">
+                                                ${idx + 1}
+                                            </div>
+                                            <div class="snippet-audio-container">
+                                                <button class="snippet-audio-btn snippet-play-btn" data-audio-id="snippet-${speakerId}-${idx}">
+                                                    <i class="fas fa-play"></i>
+                                                </button>
+                                                <div class="snippet-audio-progress" data-audio-id="snippet-${speakerId}-${idx}">
+                                                    <div class="snippet-audio-progress-bar"></div>
+                                                </div>
+                                                <div class="snippet-audio-time">
+                                                    <span class="snippet-current-time">0:00</span>
+                                                </div>
+                                                <audio
+                                                    class="snippet-audio"
+                                                    id="snippet-${speakerId}-${idx}"
+                                                    preload="none"
+                                                    src="/speakers/snippet-audio/${snippet.recording_id}?start=${snippet.start_time}&duration=${snippet.duration}">
+                                                </audio>
+                                            </div>
+                                        </div>
+                                    </div>
+                                `).join('')}
+                            </div>
+                        `;
+
+                        // Initialize custom audio players
+                        initSnippetAudioPlayers(contentEl, speakerId);
+                    }
+                } catch (error) {
+                    console.error('Error loading snippets:', error);
+                    loadingEl.classList.add('hidden');
+                    contentEl.classList.remove('hidden');
+                    contentEl.innerHTML = '<p class="text-xs text-red-500 text-center py-2">Failed to load snippets</p>';
+                }
+            }
+
+            // Initialize custom audio players for snippets
+            function initSnippetAudioPlayers(container, speakerId) {
+                const savedVolume = window.vueApp?.playerVolume ?? 1.0;
+
+                container.querySelectorAll('.snippet-audio').forEach(audio => {
+                    const audioId = audio.id;
+                    const playBtn = container.querySelector(`.snippet-play-btn[data-audio-id="${audioId}"]`);
+                    const progressBar = container.querySelector(`.snippet-audio-progress[data-audio-id="${audioId}"]`);
+                    const progressFill = progressBar.querySelector('.snippet-audio-progress-bar');
+                    const timeDisplay = playBtn.closest('.snippet-audio-container').querySelector('.snippet-current-time');
+                    const icon = playBtn.querySelector('i');
+
+                    // Set volume
+                    audio.volume = savedVolume;
+
+                    // Play/pause button
+                    playBtn.addEventListener('click', () => {
+                        if (audio.paused) {
+                            // Pause all other snippet audios
+                            container.querySelectorAll('.snippet-audio').forEach(otherAudio => {
+                                if (otherAudio !== audio && !otherAudio.paused) {
+                                    otherAudio.pause();
+                                }
+                            });
+                            audio.play();
+                        } else {
+                            audio.pause();
+                        }
+                    });
+
+                    // Update play/pause icon
+                    audio.addEventListener('play', () => {
+                        icon.classList.remove('fa-play');
+                        icon.classList.add('fa-pause');
+                    });
+
+                    audio.addEventListener('pause', () => {
+                        icon.classList.remove('fa-pause');
+                        icon.classList.add('fa-play');
+                    });
+
+                    // Update progress and time
+                    audio.addEventListener('timeupdate', () => {
+                        if (audio.duration) {
+                            const percent = (audio.currentTime / audio.duration) * 100;
+                            progressFill.style.width = percent + '%';
+                            timeDisplay.textContent = formatTime(audio.currentTime);
+                        }
+                    });
+
+                    // Reset on end
+                    audio.addEventListener('ended', () => {
+                        progressFill.style.width = '0%';
+                        timeDisplay.textContent = '0:00';
+                        icon.classList.remove('fa-pause');
+                        icon.classList.add('fa-play');
+                    });
+
+                    // Seek by clicking progress bar
+                    progressBar.addEventListener('click', (e) => {
+                        const rect = progressBar.getBoundingClientRect();
+                        const percent = (e.clientX - rect.left) / rect.width;
+                        audio.currentTime = percent * audio.duration;
+                    });
+                });
+
+                // Helper to format time
+                function formatTime(seconds) {
+                    const mins = Math.floor(seconds / 60);
+                    const secs = Math.floor(seconds % 60);
+                    return `${mins}:${secs.toString().padStart(2, '0')}`;
+                }
+            }
+
+            // Update bulk operation buttons based on checkboxes
+            function updateBulkOperationButtons() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                const count = checkboxes.length;
+
+                // Update all merge buttons
+                document.querySelectorAll('.bulk-merge-btn').forEach(btn => {
+                    btn.disabled = count < 2;
+                    const btnText = btn.querySelector('span');
+                    if (btnText) {
+                        btnText.textContent = count >= 2 ? `Merge (${count})` : 'Merge';
+                    }
+                });
+
+                // Update all delete buttons
+                document.querySelectorAll('.bulk-delete-btn').forEach(btn => {
+                    btn.disabled = count === 0;
+                    const btnText = btn.querySelector('span');
+                    if (btnText) {
+                        btnText.textContent = count > 0 ? `Delete (${count})` : 'Delete';
+                    }
+                });
+
+                // Update all clear profile buttons
+                document.querySelectorAll('.bulk-clear-btn').forEach(btn => {
+                    btn.disabled = count === 0;
+                    const btnText = btn.querySelector('span');
+                    if (btnText) {
+                        btnText.textContent = count > 0 ? `Clear (${count})` : 'Clear Profiles';
+                    }
+                });
+
+                // Update speaker counts (respect active filter)
+                const searchInput = document.getElementById('speakerSearchInput');
+                const currentFilter = searchInput ? searchInput.value.trim() : '';
+                if (!currentFilter) {
+                    document.querySelectorAll('.speakers-count').forEach(el => {
+                        el.textContent = speakersTabData.length;
+                    });
+                }
+
+                // Update select-all checkboxes state
+                const allCheckboxes = document.querySelectorAll('.speaker-select-checkbox');
+                const checkedCheckboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                const allSelected = allCheckboxes.length === checkedCheckboxes.length && allCheckboxes.length > 0;
+                document.querySelectorAll('.select-all-checkbox').forEach(cb => {
+                    cb.checked = allSelected;
+                });
+            }
+
+            // Filter speakers by name
+            function filterSpeakers(query) {
+                const cards = document.querySelectorAll('#speakersTabGrid > div[data-speaker-name]');
+                const lowerQuery = query.toLowerCase().trim();
+                let visibleCount = 0;
+
+                cards.forEach(card => {
+                    const match = !lowerQuery || card.dataset.speakerName.includes(lowerQuery);
+                    card.style.display = match ? '' : 'none';
+                    if (match) visibleCount++;
+                });
+
+                const total = speakersTabData.length;
+                const label = lowerQuery ? `${visibleCount} of ${total}` : `${total}`;
+                document.querySelectorAll('.speakers-count').forEach(el => {
+                    el.textContent = label;
+                });
+            }
+
+            document.getElementById('speakerSearchInput').addEventListener('input', (e) => {
+                filterSpeakers(e.target.value);
+            });
+
+            // Handle checkbox changes
+            document.addEventListener('change', (e) => {
+                // Handle select-all checkboxes
+                if (e.target.classList.contains('select-all-checkbox')) {
+                    const checkboxes = document.querySelectorAll('#speakersTabGrid > div[data-speaker-name]:not([style*="display: none"]) .speaker-select-checkbox');
+                    checkboxes.forEach(cb => cb.checked = e.target.checked);
+                    // Also uncheck hidden cards when unchecking all
+                    if (!e.target.checked) {
+                        document.querySelectorAll('.speaker-select-checkbox').forEach(cb => cb.checked = false);
+                    }
+                    // Sync all select-all checkboxes
+                    document.querySelectorAll('.select-all-checkbox').forEach(cb => {
+                        cb.checked = e.target.checked;
+                    });
+                    updateBulkOperationButtons();
+                } else if (e.target.classList.contains('speaker-select-checkbox')) {
+                    updateBulkOperationButtons();
+                }
+            });
+
+            // Handle bulk operation button clicks
+            document.addEventListener('click', (e) => {
+                const btn = e.target.closest('.bulk-delete-btn, .bulk-clear-btn, .bulk-merge-btn');
+                if (!btn) return;
+
+                if (btn.classList.contains('bulk-delete-btn')) {
+                    deleteSelectedSpeakers();
+                } else if (btn.classList.contains('bulk-clear-btn')) {
+                    clearSelectedVoiceProfiles();
+                } else if (btn.classList.contains('bulk-merge-btn')) {
+                    openMergeSpeakersModal();
+                }
+            });
+
+            // Track selected target speaker for merge
+            let mergeTargetSpeakerId = null;
+
+            // Open merge modal
+            async function openMergeSpeakersModal() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                if (checkboxes.length < 2) {
+                    showToast('Please select at least 2 speakers to merge', 'error');
+                    return;
+                }
+
+                const selectedSpeakers = Array.from(checkboxes).map(cb => ({
+                    id: parseInt(cb.dataset.speakerId),
+                    name: cb.dataset.speakerName
+                }));
+
+                const modal = document.getElementById('mergeSpeakersModal');
+                const list = document.getElementById('mergeSpeakersList');
+                const executeBtn = document.getElementById('executeMergeBtn');
+
+                // Reset target selection
+                mergeTargetSpeakerId = null;
+                executeBtn.disabled = true;
+
+                // Populate list with clickable cards
+                list.innerHTML = selectedSpeakers.map(s => `
+                    <div class="merge-speaker-card flex items-center justify-between px-4 py-3 bg-[var(--bg-tertiary)] hover:bg-[var(--bg-primary)] border-2 border-transparent rounded-lg cursor-pointer transition-all"
+                         data-speaker-id="${s.id}">
+                        <div class="flex items-center">
+                            <i class="fas fa-user text-[var(--text-accent)] mr-3"></i>
+                            <span class="text-[var(--text-primary)] font-medium">${escapeHtml(s.name)}</span>
+                        </div>
+                        <i class="fas fa-check text-green-500 text-lg hidden check-icon"></i>
+                    </div>
+                `).join('');
+
+                // Add click handlers to speaker cards
+                list.querySelectorAll('.merge-speaker-card').forEach(card => {
+                    card.addEventListener('click', function() {
+                        // Remove selection from all cards
+                        list.querySelectorAll('.merge-speaker-card').forEach(c => {
+                            c.classList.remove('border-green-500', 'bg-[var(--bg-accent)]', 'bg-opacity-10');
+                            c.querySelector('.check-icon').classList.add('hidden');
+                        });
+
+                        // Select this card
+                        this.classList.add('border-green-500', 'bg-[var(--bg-accent)]', 'bg-opacity-10');
+                        this.querySelector('.check-icon').classList.remove('hidden');
+
+                        mergeTargetSpeakerId = parseInt(this.dataset.speakerId);
+                        executeBtn.disabled = false;
+                    });
+                });
+
+                modal.classList.remove('hidden');
+            }
+
+            // Execute speaker merge
+            async function executeSpeakerMerge() {
+                const targetId = mergeTargetSpeakerId;
+
+                if (!targetId) {
+                    showToast('Please select which speaker to keep', 'error');
+                    return;
+                }
+
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                const allIds = Array.from(checkboxes).map(cb => parseInt(cb.dataset.speakerId));
+                const sourceIds = allIds.filter(id => id !== targetId);
+
+                if (sourceIds.length === 0) {
+                    showToast('No source speakers to merge', 'error');
+                    return;
+                }
+
+                try {
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+
+                    const response = await fetch('/speakers/merge', {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-CSRFToken': csrfToken
+                        },
+                        body: JSON.stringify({
+                            target_id: targetId,
+                            source_ids: sourceIds
+                        })
+                    });
+
+                    const data = await response.json();
+                    if (!response.ok) throw new Error(data.error || 'Merge failed');
+
+                    showToast(data.message || 'Speakers merged successfully');
+                    document.getElementById('mergeSpeakersModal').classList.add('hidden');
+
+                    // Reload speakers - reset flag to force reload
+                    speakersTabLoaded = false;
+                    await loadSpeakersTab();
+                } catch (error) {
+                    console.error('Error merging speakers:', error);
+                    showToast(`Failed to merge speakers: ${error.message}`, 'error');
+                }
+            }
+
+            // Open delete selected speakers modal
+            function deleteSelectedSpeakers() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                if (checkboxes.length === 0) {
+                    showToast('Please select speakers to delete', 'error');
+                    return;
+                }
+
+                const selectedSpeakers = Array.from(checkboxes).map(cb => ({
+                    id: parseInt(cb.dataset.speakerId),
+                    name: cb.dataset.speakerName
+                }));
+
+                const modal = document.getElementById('deleteSelectedSpeakersModal');
+                const countEl = document.getElementById('deleteSelectedCount');
+                const listEl = document.getElementById('deleteSelectedSpeakersList');
+
+                // Update count
+                countEl.textContent = selectedSpeakers.length;
+
+                // Populate list
+                listEl.innerHTML = selectedSpeakers.map(s => `
+                    <div class="flex items-center px-3 py-2 bg-[var(--bg-secondary)] rounded border border-[var(--border-secondary)]">
+                        <i class="fas fa-user text-[var(--text-accent)] mr-2"></i>
+                        <span class="text-[var(--text-primary)]">${escapeHtml(s.name)}</span>
+                    </div>
+                `).join('');
+
+                modal.classList.remove('hidden');
+            }
+
+            // Execute deletion of selected speakers
+            async function executeDeleteSelectedSpeakers() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                const selectedSpeakers = Array.from(checkboxes).map(cb => ({
+                    id: parseInt(cb.dataset.speakerId),
+                    name: cb.dataset.speakerName
+                }));
+
+                // Hide modal
+                document.getElementById('deleteSelectedSpeakersModal').classList.add('hidden');
+
+                try{
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                    const headers = csrfToken ? { 'X-CSRFToken': csrfToken } : {};
+
+                    const deletePromises = selectedSpeakers.map(speaker =>
+                        fetch(`/speakers/${speaker.id}`, {
+                            method: 'DELETE',
+                            headers: headers
+                        })
+                    );
+
+                    const results = await Promise.allSettled(deletePromises);
+                    const failures = results.filter(result => result.status === 'rejected');
+
+                    if (failures.length > 0) {
+                        console.error('Some speakers failed to delete:', failures);
+                        showToast(`${failures.length} speaker(s) failed to delete`, 'error');
+                    }
+
+                    // Reset and reload
+                    speakersTabLoaded = false;
+                    await loadSpeakersTab();
+
+                    const successCount = results.length - failures.length;
+                    if (successCount > 0) {
+                        showToast(`${successCount} speaker(s) deleted successfully`);
+                    }
+                } catch (error) {
+                    console.error('Error deleting speakers:', error);
+                    showToast(`Failed to delete speakers: ${error.message}`, 'error');
+                }
+            }
+
+            // Open clear voice profiles modal
+            function clearSelectedVoiceProfiles() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                if (checkboxes.length === 0) {
+                    showToast('Please select speakers to clear voice profiles', 'error');
+                    return;
+                }
+
+                const selectedSpeakers = Array.from(checkboxes).map(cb => ({
+                    id: parseInt(cb.dataset.speakerId),
+                    name: cb.dataset.speakerName
+                }));
+
+                const modal = document.getElementById('clearVoiceProfilesModal');
+                const countEl = document.getElementById('clearVoiceProfilesCount');
+                const listEl = document.getElementById('clearVoiceProfilesList');
+
+                // Update count
+                countEl.textContent = selectedSpeakers.length;
+
+                // Populate list
+                listEl.innerHTML = selectedSpeakers.map(s => `
+                    <div class="flex items-center px-3 py-2 bg-[var(--bg-secondary)] rounded border border-[var(--border-secondary)]">
+                        <i class="fas fa-user text-[var(--text-accent)] mr-2"></i>
+                        <span class="text-[var(--text-primary)]">${escapeHtml(s.name)}</span>
+                    </div>
+                `).join('');
+
+                modal.classList.remove('hidden');
+            }
+
+            // Execute clearing voice profiles
+            async function executeClearVoiceProfiles() {
+                const checkboxes = document.querySelectorAll('.speaker-select-checkbox:checked');
+                const selectedSpeakers = Array.from(checkboxes).map(cb => ({
+                    id: parseInt(cb.dataset.speakerId),
+                    name: cb.dataset.speakerName
+                }));
+
+                // Hide modal
+                document.getElementById('clearVoiceProfilesModal').classList.add('hidden');
+
+                try {
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+
+                    const clearPromises = selectedSpeakers.map(speaker =>
+                        fetch(`/speakers/${speaker.id}/clear_embeddings`, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': csrfToken
+                            }
+                        })
+                    );
+
+                    const results = await Promise.allSettled(clearPromises);
+                    const failures = results.filter(result => result.status === 'rejected');
+
+                    if (failures.length > 0) {
+                        console.error('Some voice profiles failed to clear:', failures);
+                        showToast(`${failures.length} voice profile(s) failed to clear`, 'error');
+                    }
+
+                    // Reset and reload
+                    speakersTabLoaded = false;
+                    await loadSpeakersTab();
+
+                    const successCount = results.length - failures.length;
+                    if (successCount > 0) {
+                        showToast(`${successCount} voice profile(s) cleared successfully`);
+                    }
+                } catch (error) {
+                    console.error('Error clearing voice profiles:', error);
+                    showToast(`Failed to clear voice profiles: ${error.message}`, 'error');
+                }
+            }
+
+            async function loadSystemInfo() {
+                try {
+                    const response = await fetch('/api/system/info');
+                    if (!response.ok) {
+                        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                    }
+                    
+                    const data = await response.json();
+                    
+                    // Update version in multiple places
+                    document.getElementById('system-version').textContent = data.version;
+                    
+                    // Update LLM info
+                    document.getElementById('llm-endpoint').textContent = data.llm_endpoint;
+                    document.getElementById('llm-model').textContent = data.llm_model;
+                    
+                    // Update Speech Recognition info
+                    // Display model name from connector info, with fallback
+                    const transcriptionModel = data.transcription?.model || data.transcription?.connector || 'whisper-1';
+                    document.getElementById('transcription-model').textContent = transcriptionModel;
+                    // Show the active transcription endpoint (ASR or OpenAI depending on config)
+                    document.getElementById('transcription-endpoint').textContent = data.transcription_endpoint || data.whisper_endpoint;
+                } catch (error) {
+                    document.getElementById('system-version').textContent = 'Failed to load';
+                    document.getElementById('llm-endpoint').textContent = 'Failed to load';
+                    document.getElementById('llm-model').textContent = 'Failed to load';
+                    document.getElementById('transcription-model').textContent = 'Failed to load';
+                    document.getElementById('transcription-endpoint').textContent = 'Failed to load';
+                }
+            }
+
+            async function loadShares() {
+                sharesContainer.innerHTML = '<div class="text-center"><i class="fas fa-spinner fa-spin text-2xl"></i></div>';
+                try {
+                    const response = await fetch('/api/shares');
+                    const shares = await response.json();
+                    if (!response.ok) throw new Error(shares.error || 'Failed to load');
+                    
+                    if (shares.length === 0) {
+                        sharesContainer.innerHTML = `<p class="text-center text-[var(--text-muted)]">${t('sharedTranscriptsPage.noSharedTranscripts')}</p>`;
+                        return;
+                    }
+
+                    sharesContainer.innerHTML = '';
+                    shares.forEach(share => {
+                        const shareEl = document.createElement('div');
+                        shareEl.className = 'bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]';
+                        shareEl.innerHTML = `
+                            <div class="flex justify-between items-start">
+                                <div>
+                                    <p class="font-semibold">${escapeHtml(share.recording_title)}</p>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('sharedTranscripts.sharedOn')}: ${share.created_at}</p>
+                                </div>
+                                <button data-share-id="${share.id}" class="delete-share-btn text-red-500 hover:text-red-700 p-1"><i class="fas fa-trash"></i></button>
+                            </div>
+                            <div class="mt-4 flex items-center gap-4">
+                                <label class="flex items-center text-sm">
+                                    <input type="checkbox" data-share-id="${share.id}" data-share-prop="share_summary" class="share-checkbox h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" ${share.share_summary ? 'checked' : ''}>
+                                    <span class="ml-2">${t('sharedTranscripts.shareSummary')}</span>
+                                </label>
+                                <label class="flex items-center text-sm">
+                                    <input type="checkbox" data-share-id="${share.id}" data-share-prop="share_notes" class="share-checkbox h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" ${share.share_notes ? 'checked' : ''}>
+                                    <span class="ml-2">${t('sharedTranscripts.shareNotes')}</span>
+                                </label>
+                            </div>
+                            <div class="mt-4 relative">
+                                <input value="{{ request.url_root }}share/${share.public_id}" readonly class="share-link-input w-full px-3 py-2 pr-12 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-accent)]">
+                                <button class="copy-share-link-btn absolute right-1.5 top-1/2 -translate-y-1/2 w-7 h-7 flex items-center justify-center rounded bg-[var(--bg-button)] text-[var(--text-button)] hover:bg-[var(--bg-button-hover)] transition-colors" title="${t('buttons.copy')}">
+                                    <i class="fas fa-copy text-xs"></i>
+                                </button>
+                            </div>
+                        `;
+                        sharesContainer.appendChild(shareEl);
+                    });
+
+                    document.querySelectorAll('.delete-share-btn').forEach(btn => {
+                        btn.addEventListener('click', handleDeleteShare);
+                    });
+                    document.querySelectorAll('.share-checkbox').forEach(box => {
+                        box.addEventListener('change', handleUpdateShare);
+                    });
+                    document.querySelectorAll('.copy-share-link-btn').forEach(btn => {
+                        btn.addEventListener('click', function(e) {
+                            const button = e.currentTarget;
+                            const input = button.previousElementSibling;
+
+                            navigator.clipboard.writeText(input.value).then(() => {
+                                const icon = button.querySelector('i');
+
+                                // Change to success state
+                                icon.className = 'fas fa-check text-xs';
+                                button.style.transition = 'background-color 0.2s ease';
+                                button.style.backgroundColor = 'var(--bg-success, #10b981)';
+
+                                // Revert after delay
+                                setTimeout(() => {
+                                    button.style.backgroundColor = '';
+                                    icon.className = 'fas fa-copy text-xs';
+                                    setTimeout(() => {
+                                        button.style.transition = '';
+                                    }, 200);
+                                }, 1500);
+                            }).catch(err => {
+                                console.error('Failed to copy:', err);
+                            });
+                        });
+                    });
+
+                } catch (error) {
+                    sharesContainer.innerHTML = `<p class="text-center text-red-500">${t('errors.loadingShares')}: ${error.message}</p>`;
+                }
+            }
+
+            async function handleDeleteShare(event) {
+                const shareId = event.currentTarget.dataset.shareId;
+                if (!confirm('Are you sure you want to delete this share? This will revoke access to the public link.')) return;
+                
+                try {
+                    // Get CSRF token
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                    
+                    const headers = {};
+                    if (csrfToken) {
+                        headers['X-CSRFToken'] = csrfToken;
+                    }
+                    
+                    const response = await fetch(`/api/share/${shareId}`, { 
+                        method: 'DELETE',
+                        headers: headers
+                    });
+                    if (!response.ok) throw new Error('Failed to delete');
+                    loadShares();
+                } catch (error) {
+                    alert('Error deleting share.');
+                }
+            }
+
+            async function handleUpdateShare(event) {
+                const shareId = event.currentTarget.dataset.shareId;
+                const prop = event.currentTarget.dataset.shareProp;
+                const value = event.currentTarget.checked;
+
+                try {
+                    // Get CSRF token
+                    const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                    
+                    const headers = { 'Content-Type': 'application/json' };
+                    if (csrfToken) {
+                        headers['X-CSRFToken'] = csrfToken;
+                    }
+                    
+                    const response = await fetch(`/api/share/${shareId}`, {
+                        method: 'PUT',
+                        headers: headers,
+                        body: JSON.stringify({ [prop]: value })
+                    });
+                    if (!response.ok) throw new Error('Failed to update');
+                } catch (error) {
+                    alert('Error updating share.');
+                    event.currentTarget.checked = !value; // Revert on failure
+                }
+            }
+
+            function escapeHtml(text) {
+                const div = document.createElement('div');
+                div.textContent = text;
+                return div.innerHTML;
+            }
+            
+            // Update footer with version
+            async function updateFooter() {
+                try {
+                    const response = await fetch('/api/system/info');
+                    if (response.ok) {
+                        const data = await response.json();
+                        const footerText = document.getElementById('footer-text');
+                        if (footerText && data.version) {
+                            footerText.textContent = `Speakr ${data.version} © {{ now.year }}`;
+                        }
+                    }
+                } catch (error) {
+                    console.log('Could not fetch version for footer');
+                }
+            }
+            
+            // Update footer on page load
+            updateFooter();
+        
+        // Dark mode toggle functionality
+        const darkModeToggle = document.getElementById('darkModeToggle');
+        const darkModeIcon = document.getElementById('darkModeIcon');
+        
+        // Initialize dark mode based on localStorage or system preference
         function initializeDarkMode() {
             const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
             const savedMode = localStorage.getItem('darkMode');
             
-            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
-                document.documentElement.classList.add('dark');
-                darkModeIcon.classList.remove('fa-moon');
-                darkModeIcon.classList.add('fa-sun');
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+                darkModeIcon.classList.remove('fa-moon');
+                darkModeIcon.classList.add('fa-sun');
+            } else {
+                document.documentElement.classList.remove('dark');
+                darkModeIcon.classList.remove('fa-sun');
+                darkModeIcon.classList.add('fa-moon');
+            }
+        }
+        
+        // Toggle dark mode
+        darkModeToggle.addEventListener('click', () => {
+            const isDarkMode = document.documentElement.classList.toggle('dark');
+            localStorage.setItem('darkMode', isDarkMode);
+            
+            if (isDarkMode) {
+                darkModeIcon.classList.remove('fa-moon');
+                darkModeIcon.classList.add('fa-sun');
+            } else {
+                darkModeIcon.classList.remove('fa-sun');
+                darkModeIcon.classList.add('fa-moon');
+            }
+        });
+        
+        // User dropdown functionality
+        const userDropdownButton = document.getElementById('userDropdownButton');
+        const userDropdownMenu = document.getElementById('userDropdownMenu');
+        
+        userDropdownButton.addEventListener('click', () => {
+            userDropdownMenu.classList.toggle('hidden');
+        });
+        
+        // Close dropdown when clicking outside
+        document.addEventListener('click', (event) => {
+            if (!userDropdownButton.contains(event.target) && !userDropdownMenu.contains(event.target)) {
+                userDropdownMenu.classList.add('hidden');
+            }
+        });
+        
+        // Initialize dark mode on page load
+        initializeDarkMode();
+        
+        // Change Password Modal functionality
+        const changePasswordBtn = document.getElementById('changePasswordBtn');
+        const changePasswordModal = document.getElementById('changePasswordModal');
+        const closeModalBtn = document.getElementById('closeModalBtn');
+        const cancelBtn = document.getElementById('cancelBtn');
+        const changePasswordForm = document.getElementById('changePasswordForm');
+        const newPasswordInput = document.getElementById('new_password');
+        const confirmPasswordInput = document.getElementById('confirm_password');
+
+        // Open modal (only if button exists)
+        if (changePasswordBtn) {
+            changePasswordBtn.addEventListener('click', () => {
+                changePasswordModal.classList.remove('hidden');
+                // Reset form
+                changePasswordForm.reset();
+            });
+        }
+        
+        // Close modal functions
+        function closeModal() {
+            changePasswordModal.classList.add('hidden');
+        }
+        
+        closeModalBtn.addEventListener('click', closeModal);
+        cancelBtn.addEventListener('click', closeModal);
+        
+        // Close modal when clicking outside
+        changePasswordModal.addEventListener('click', (event) => {
+            if (event.target === changePasswordModal) {
+                closeModal();
+            }
+        });
+        
+        // Form validation
+        changePasswordForm.addEventListener('submit', (event) => {
+            if (newPasswordInput.value !== confirmPasswordInput.value) {
+                event.preventDefault();
+                alert('New password and confirmation do not match.');
+            }
+        });
+
+        // Keep the modal functionality for backward compatibility if button still exists
+        const manageSpeakersBtn = document.getElementById('manageSpeakersBtn');
+        const manageSpeakersModal = document.getElementById('manageSpeakersModal');
+        const closeSpeakersModalBtn = document.getElementById('closeSpeakersModalBtn');
+        const closeSpeakersBtn = document.getElementById('closeSpeakersBtn');
+        const deleteAllSpeakersBtn = document.getElementById('deleteAllSpeakersBtn');
+        const deleteAllSpeakersModal = document.getElementById('deleteAllSpeakersModal');
+        const cancelDeleteAllBtn = document.getElementById('cancelDeleteAllBtn');
+        const confirmDeleteAllBtn = document.getElementById('confirmDeleteAllBtn');
+        
+        const speakersLoading = document.getElementById('speakersLoading');
+        const speakersError = document.getElementById('speakersError');
+        const speakersErrorMessage = document.getElementById('speakersErrorMessage');
+        const speakersEmpty = document.getElementById('speakersEmpty');
+        const speakersList = document.getElementById('speakersList');
+        const speakersCount = document.getElementById('speakersCount');
+
+        let speakers = [];
+
+        // Open speakers modal only if button exists
+        if (manageSpeakersBtn) {
+            manageSpeakersBtn.addEventListener('click', () => {
+                manageSpeakersModal.classList.remove('hidden');
+                loadSpeakers();
+            });
+        }
+
+        // Close speakers modal functions
+        function closeSpeakersModal() {
+            manageSpeakersModal.classList.add('hidden');
+        }
+
+        closeSpeakersModalBtn.addEventListener('click', closeSpeakersModal);
+        closeSpeakersBtn.addEventListener('click', closeSpeakersModal);
+
+        // Close modal when clicking outside
+        manageSpeakersModal.addEventListener('click', (event) => {
+            if (event.target === manageSpeakersModal) {
+                closeSpeakersModal();
+            }
+        });
+
+        // Load speakers from API
+        async function loadSpeakers() {
+            showLoadingState();
+            
+            try {
+                const response = await fetch('/speakers');
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                speakers = await response.json();
+                displaySpeakers();
+            } catch (error) {
+                console.error('Error loading speakers:', error);
+                showErrorState(error.message);
+            }
+        }
+
+        // Show loading state
+        function showLoadingState() {
+            speakersLoading.classList.remove('hidden');
+            speakersError.classList.add('hidden');
+            speakersEmpty.classList.add('hidden');
+            speakersList.classList.add('hidden');
+        }
+
+        // Show error state
+        function showErrorState(message) {
+            speakersLoading.classList.add('hidden');
+            speakersError.classList.remove('hidden');
+            speakersEmpty.classList.add('hidden');
+            speakersList.classList.add('hidden');
+            speakersErrorMessage.textContent = message;
+            updateSpeakersCount(0);
+        }
+
+        // Display speakers
+        function displaySpeakers() {
+            speakersLoading.classList.add('hidden');
+            speakersError.classList.add('hidden');
+            
+            if (speakers.length === 0) {
+                speakersEmpty.classList.remove('hidden');
+                speakersList.classList.add('hidden');
+                deleteAllSpeakersBtn.disabled = true;
+            } else {
+                speakersEmpty.classList.add('hidden');
+                speakersList.classList.remove('hidden');
+                deleteAllSpeakersBtn.disabled = false;
+                renderSpeakersList();
+            }
+            
+            updateSpeakersCount(speakers.length);
+        }
+
+        // Render speakers list
+        function renderSpeakersList() {
+            speakersList.innerHTML = '';
+            
+            speakers.forEach(speaker => {
+                const speakerItem = createSpeakerItem(speaker);
+                speakersList.appendChild(speakerItem);
+            });
+        }
+
+        // Create speaker item element
+        function createSpeakerItem(speaker) {
+            const div = document.createElement('div');
+            div.className = 'flex items-center justify-between p-3 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] hover:bg-[var(--bg-accent)] transition-colors duration-200';
+            
+            const createdDate = new Date(speaker.created_at).toLocaleDateString();
+            const lastUsedDate = new Date(speaker.last_used).toLocaleDateString();
+            
+            div.innerHTML = `
+                <div class="flex-1">
+                    <div class="flex items-center">
+                        <i class="fas fa-user text-[var(--text-muted)] mr-2"></i>
+                        <span class="font-medium text-[var(--text-primary)]">${escapeHtml(speaker.name)}</span>
+                    </div>
+                    <div class="text-xs text-[var(--text-muted)] mt-1">
+                        Used ${speaker.use_count} time${speaker.use_count !== 1 ? 's' : ''} • 
+                        Last used: ${lastUsedDate} • 
+                        Created: ${createdDate}
+                    </div>
+                </div>
+                <button class="delete-speaker-btn ml-3 p-2 text-[var(--text-danger)] hover:bg-[var(--bg-danger-light)] rounded-md transition-colors duration-200" 
+                        data-speaker-id="${speaker.id}" 
+                        data-i18n-title="buttons.deleteSpeaker">
+                    <i class="fas fa-trash text-sm"></i>
+                </button>
+            `;
+            
+            // Add delete functionality
+            const deleteBtn = div.querySelector('.delete-speaker-btn');
+            deleteBtn.addEventListener('click', () => deleteSpeaker(speaker.id, speaker.name));
+            
+            return div;
+        }
+
+        // Delete individual speaker
+        async function deleteSpeaker(speakerId, speakerName) {
+            if (!confirm(`Are you sure you want to delete "${speakerName}"?`)) {
+                return;
+            }
+            
+            try {
+                // Get CSRF token
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                
+                const headers = {};
+                if (csrfToken) {
+                    headers['X-CSRFToken'] = csrfToken;
+                }
+                
+                const response = await fetch(`/speakers/${speakerId}`, {
+                    method: 'DELETE',
+                    headers: headers
+                });
+                
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || `HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                // Remove from local array
+                speakers = speakers.filter(s => s.id !== speakerId);
+                displaySpeakers();
+                showToast(`Speaker "${speakerName}" deleted successfully`);
+            } catch (error) {
+                console.error('Error deleting speaker:', error);
+                showToast(`Failed to delete speaker: ${error.message}`, 'error');
+            }
+        }
+
+        // Delete all speakers
+        deleteAllSpeakersBtn.addEventListener('click', () => {
+            deleteAllSpeakersModal.classList.remove('hidden');
+        });
+
+        // Cancel delete all
+        cancelDeleteAllBtn.addEventListener('click', () => {
+            deleteAllSpeakersModal.classList.add('hidden');
+        });
+
+        // Close delete all modal when clicking outside
+        deleteAllSpeakersModal.addEventListener('click', (event) => {
+            if (event.target === deleteAllSpeakersModal) {
+                deleteAllSpeakersModal.classList.add('hidden');
+            }
+        });
+
+        // Confirm delete all speakers
+        confirmDeleteAllBtn.addEventListener('click', async () => {
+            deleteAllSpeakersModal.classList.add('hidden');
+            
+            try {
+                // Get CSRF token
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                
+                const headers = {};
+                if (csrfToken) {
+                    headers['X-CSRFToken'] = csrfToken;
+                }
+                
+                // Delete all speakers one by one
+                const deletePromises = speakers.map(speaker => 
+                    fetch(`/speakers/${speaker.id}`, { 
+                        method: 'DELETE',
+                        headers: headers
+                    })
+                );
+                
+                const results = await Promise.allSettled(deletePromises);
+                
+                // Check for any failures
+                const failures = results.filter(result => result.status === 'rejected');
+                if (failures.length > 0) {
+                    console.error('Some speakers failed to delete:', failures);
+                    showToast(`${failures.length} speaker(s) failed to delete`, 'error');
+                }
+                
+                // Reload speakers list
+                await loadSpeakers();
+                showToast(`${speakers.length === 0 ? 'All speakers' : (results.length - failures.length) + ' speakers'} deleted successfully`);
+            } catch (error) {
+                console.error('Error deleting all speakers:', error);
+                showToast(`Failed to delete speakers: ${error.message}`, 'error');
+            }
+        });
+
+        // Update speakers count
+        function updateSpeakersCount(count) {
+            speakersCount.textContent = count;
+        }
+
+        // Utility function to escape HTML
+        function escapeHtml(text) {
+            const div = document.createElement('div');
+            div.textContent = text;
+            return div.innerHTML;
+        }
+
+        // Toast notification function
+        function showToast(message, type = 'success') {
+            // Create toast element
+            const toast = document.createElement('div');
+            toast.className = `fixed top-4 right-4 z-50 px-4 py-2 rounded-lg shadow-lg transition-all duration-300 transform translate-x-full ${
+                type === 'error'
+                    ? 'bg-[var(--bg-danger)] text-[var(--text-button)]'
+                    : 'bg-[var(--bg-success-light)] text-[var(--text-success-strong)]'
+            }`;
+            toast.style.cursor = 'pointer';
+            toast.innerHTML = `
+                <div class="flex items-center">
+                    <i class="fas ${type === 'error' ? 'fa-exclamation-circle' : 'fa-check-circle'} mr-2"></i>
+                    <span>${escapeHtml(message)}</span>
+                </div>
+            `;
+
+            document.body.appendChild(toast);
+
+            // Animate in
+            setTimeout(() => {
+                toast.classList.remove('translate-x-full');
+            }, 10);
+
+            // Function to dismiss the toast
+            const dismissToast = () => {
+                toast.classList.add('translate-x-full');
+                setTimeout(() => {
+                    if (toast.parentNode) {
+                        document.body.removeChild(toast);
+                    }
+                }, 300);
+            };
+
+            // Add click handler to dismiss toast
+            toast.addEventListener('click', () => {
+                clearTimeout(timeoutId);
+                dismissToast();
+            });
+
+            // Auto-dismiss after 3 seconds
+            const timeoutId = setTimeout(dismissToast, 3000);
+        }
+
+        // ===== MODAL TAB SWITCHING =====
+        function switchModalTab(navId, tabClass, contentClass, targetTabId) {
+            const nav = document.getElementById(navId);
+            if (!nav) return;
+            // Update tab buttons
+            nav.querySelectorAll('.' + tabClass).forEach(btn => {
+                if (btn.dataset.tab === targetTabId) {
+                    btn.classList.add('active', 'border-[var(--border-focus)]', 'text-[var(--text-accent)]');
+                    btn.classList.remove('border-transparent', 'text-[var(--text-muted)]');
+                } else {
+                    btn.classList.remove('active', 'border-[var(--border-focus)]', 'text-[var(--text-accent)]');
+                    btn.classList.add('border-transparent', 'text-[var(--text-muted)]');
+                }
+            });
+            // Show/hide tab content
+            document.querySelectorAll('.' + contentClass).forEach(panel => {
+                panel.classList.toggle('hidden', panel.id !== targetTabId);
+            });
+        }
+
+        // Attach tab click handlers for tag modal
+        document.getElementById('tagModalTabs')?.addEventListener('click', function(e) {
+            const btn = e.target.closest('.tag-modal-tab');
+            if (btn && btn.dataset.tab) {
+                switchModalTab('tagModalTabs', 'tag-modal-tab', 'tag-modal-tab-content', btn.dataset.tab);
+            }
+        });
+
+        // Attach tab click handlers for folder modal
+        document.getElementById('folderModalTabs')?.addEventListener('click', function(e) {
+            const btn = e.target.closest('.folder-modal-tab');
+            if (btn && btn.dataset.tab) {
+                switchModalTab('folderModalTabs', 'folder-modal-tab', 'folder-modal-tab-content', btn.dataset.tab);
+            }
+        });
+
+        // Show sharing tabs when internal sharing is enabled
+        const isInternalSharingForTabs = {{ 'true' if enable_internal_sharing else 'false' }};
+        if (isInternalSharingForTabs) {
+            document.getElementById('tagTabSharingBtn')?.classList.remove('hidden');
+            document.getElementById('folderTabSharingBtn')?.classList.remove('hidden');
+        }
+
+        // ===== TAG MANAGEMENT FUNCTIONALITY =====
+
+        // Tag management elements
+        const createTagBtn = document.getElementById('createTagBtn');
+        const tagModal = document.getElementById('tagModal');
+        const closeTagModalBtn = document.getElementById('closeTagModalBtn');
+        const cancelTagBtn = document.getElementById('cancelTagBtn');
+        const tagForm = document.getElementById('tagForm');
+        const tagModalTitle = document.getElementById('tagModalTitle');
+        const saveTagBtn = document.getElementById('saveTagBtn');
+        
+        const tagsLoading = document.getElementById('tagsLoading');
+        const tagsError = document.getElementById('tagsError');
+        const tagsErrorMessage = document.getElementById('tagsErrorMessage');
+        const tagsEmpty = document.getElementById('tagsEmpty');
+        const tagsGrid = document.getElementById('tagsGrid');
+
+        let tags = [];
+        let isEditingTag = false;
+
+        // Groups where current user is admin (passed from backend)
+        let userAdminGroups = {{ user_admin_groups | tojson }};
+        console.log('User admin groups:', userAdminGroups);
+
+        // Update visibility of group selection based on whether user is admin of any groups
+        function updateGroupSelectionVisibility() {
+            const groupSelectionSection = document.getElementById('tagGroupSelectionSection');
+            if (groupSelectionSection) {
+                const isInternalSharingEnabled = {{ 'true' if enable_internal_sharing else 'false' }};
+                if (isInternalSharingEnabled && userAdminGroups.length > 0) {
+                    groupSelectionSection.classList.remove('hidden');
+                    populateGroupDropdown();
+                } else {
+                    groupSelectionSection.classList.add('hidden');
+                }
+            }
+        }
+
+        // Populate the group dropdown with groups where user is admin
+        function populateGroupDropdown() {
+            const groupSelect = document.getElementById('tagGroupId');
+            if (!groupSelect) return;
+
+            // Clear existing options except the first one
+            while (groupSelect.options.length > 1) {
+                groupSelect.remove(1);
+            }
+
+            // Add group options
+            userAdminGroups.forEach(group => {
+                const option = document.createElement('option');
+                option.value = group.id;
+                option.textContent = group.name;
+                groupSelect.appendChild(option);
+            });
+        }
+
+        // Toggle group settings section based on selection
+        function toggleGroupSettings() {
+            const groupSelect = document.getElementById('tagGroupId');
+            const groupSettingsSection = document.getElementById('tagGroupSettingsSection');
+
+            if (groupSelect && groupSettingsSection) {
+                if (groupSelect.value) {
+                    groupSettingsSection.classList.remove('hidden');
+                } else {
+                    groupSettingsSection.classList.add('hidden');
+                }
+            }
+        }
+
+        // Add event listener for group selection changes
+        const tagGroupSelect = document.getElementById('tagGroupId');
+        if (tagGroupSelect) {
+            tagGroupSelect.addEventListener('change', toggleGroupSettings);
+        }
+
+        // Add event listener for protect from deletion checkbox
+        const tagProtectCheckbox = document.getElementById('tagProtectFromDeletion');
+        const tagRetentionDaysInput = document.getElementById('tagRetentionDays');
+
+        if (tagProtectCheckbox && tagRetentionDaysInput) {
+            tagProtectCheckbox.addEventListener('change', function() {
+                if (this.checked) {
+                    // When protect is enabled, disable retention field and set to -1
+                    tagRetentionDaysInput.value = '';
+                    tagRetentionDaysInput.disabled = true;
+                    tagRetentionDaysInput.classList.add('opacity-50', 'cursor-not-allowed');
+                    tagRetentionDaysInput.placeholder = 'Infinite retention (protected)';
+                } else {
+                    // When protect is disabled, re-enable retention field
+                    tagRetentionDaysInput.disabled = false;
+                    tagRetentionDaysInput.classList.remove('opacity-50', 'cursor-not-allowed');
+                    tagRetentionDaysInput.placeholder = 'Leave empty to use global retention';
+                }
+            });
+        }
+
+        // Check if auto-deletion is enabled and show/hide the retention section
+        function checkAutoDeletionEnabled() {
+            const isAutoDeletionEnabled = {{ 'true' if enable_auto_deletion else 'false' }};
+            const retentionSection = document.getElementById('tagRetentionSection');
+
+            if (retentionSection && isAutoDeletionEnabled) {
+                retentionSection.classList.remove('hidden');
+            }
+        }
+
+        // Initialize visibility based on user's admin groups
+        updateGroupSelectionVisibility();
+        checkAutoDeletionEnabled();
+
+        // Load tags from API
+        async function loadTags() {
+            showTagsLoadingState();
+            
+            try {
+                const response = await fetch('/api/tags');
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                tags = await response.json();
+                displayTags();
+            } catch (error) {
+                console.error('Error loading tags:', error);
+                showTagsErrorState(error.message);
+            }
+        }
+
+        // Show loading state
+        function showTagsLoadingState() {
+            tagsLoading.classList.remove('hidden');
+            tagsError.classList.add('hidden');
+            tagsEmpty.classList.add('hidden');
+            tagsGrid.classList.add('hidden');
+        }
+
+        // Show error state
+        function showTagsErrorState(message) {
+            tagsLoading.classList.add('hidden');
+            tagsError.classList.remove('hidden');
+            tagsEmpty.classList.add('hidden');
+            tagsGrid.classList.add('hidden');
+            tagsErrorMessage.textContent = message;
+        }
+
+        // Display tags
+        function displayTags() {
+            tagsLoading.classList.add('hidden');
+            tagsError.classList.add('hidden');
+            
+            if (tags.length === 0) {
+                tagsEmpty.classList.remove('hidden');
+                tagsGrid.classList.add('hidden');
+            } else {
+                tagsEmpty.classList.add('hidden');
+                tagsGrid.classList.remove('hidden');
+                renderTagsGrid();
+            }
+        }
+
+        // Render tags grid
+        function renderTagsGrid() {
+            tagsGrid.innerHTML = '';
+            
+            tags.forEach(tag => {
+                const tagCard = createTagCard(tag);
+                tagsGrid.appendChild(tagCard);
+            });
+        }
+
+        // Create tag card element
+        function createTagCard(tag) {
+            const div = document.createElement('div');
+            const isGroupTag = tag.group_id !== null && tag.group_id !== undefined;
+            const canEdit = tag.can_edit !== undefined ? tag.can_edit : true;
+
+            div.className = `bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] hover:shadow-md transition-shadow duration-200 overflow-hidden`;
+
+            // Build metadata badges
+            const metadata = [];
+
+            // Protection/Retention badge
+            if (tag.protect_from_deletion || tag.retention_days === -1) {
+                metadata.push(`<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium" style="background-color: #f59e0b; color: white;" title="Protected with infinite retention">
+                    <i class="fas fa-shield-alt"></i>
+                    <span>∞</span>
+                </span>`);
+            } else if (tag.retention_days && tag.retention_days > 0) {
+                metadata.push(`<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium" style="background-color: #2563eb; color: white;" title="Retention: ${tag.retention_days} days">
+                    <i class="fas fa-clock"></i>
+                    <span>${tag.retention_days}d</span>
+                </span>`);
+            }
+
+            // Sharing badge for group tags
+            if (isGroupTag) {
+                const shareIcon = tag.auto_share_on_apply ? 'user-friends' : (tag.share_with_group_lead ? 'user-tie' : 'user-lock');
+                const shareText = tag.auto_share_on_apply ? 'All members' : (tag.share_with_group_lead ? 'Admins only' : 'Manual');
+                const shareTooltip = tag.auto_share_on_apply ? 'Auto-shares with all group members' : (tag.share_with_group_lead ? 'Shares with group admins only' : 'Manual sharing only');
+                metadata.push(`<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium" style="background-color: #9333ea; color: white;" title="${shareTooltip}">
+                    <i class="fas fa-${shareIcon}"></i>
+                    <span>${shareText}</span>
+                </span>`);
+            }
+
+            // ASR defaults badges
+            if (tag.default_language) {
+                metadata.push(`<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium" style="background-color: #16a34a; color: white;" title="Language: ${escapeHtml(tag.default_language)}">
+                    <i class="fas fa-language"></i>
+                    <span>${escapeHtml(tag.default_language).toUpperCase()}</span>
+                </span>`);
+            }
+            if (tag.default_min_speakers || tag.default_max_speakers) {
+                const min = tag.default_min_speakers || '?';
+                const max = tag.default_max_speakers || '?';
+                metadata.push(`<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium" style="background-color: #0d9488; color: white;" title="Speaker range: ${min}-${max}">
+                    <i class="fas fa-users"></i>
+                    <span>${min}-${max}</span>
+                </span>`);
+            }
+
+            // Custom prompt indicator
+            const hasPrompt = tag.custom_prompt && tag.custom_prompt.trim().length > 0;
+
+            div.innerHTML = `
+                <!-- Header with color indicator and name -->
+                <div class="flex items-center justify-between gap-2 px-3 py-2 bg-[var(--bg-secondary)] border-b border-[var(--border-primary)]">
+                    <div class="flex items-center gap-2 flex-1 min-w-0">
+                        ${isGroupTag
+                            ? `<i class="fas fa-users flex-shrink-0 text-sm" style="color: ${escapeHtml(tag.color)}"></i>`
+                            : `<div class="w-3 h-3 rounded-full flex-shrink-0 border border-white/20" style="background-color: ${escapeHtml(tag.color)}"></div>`
+                        }
+                        <h3 class="font-semibold text-sm text-[var(--text-primary)] truncate" title="${escapeHtml(tag.name)}">
+                            ${isGroupTag ? `<span class="text-xs opacity-60">${escapeHtml(tag.group_name || 'Group')}:</span> ` : ''}${escapeHtml(tag.name)}
+                        </h3>
+                    </div>
+                    <div class="flex items-center gap-1 flex-shrink-0">
+                        ${!canEdit ? `
+                            <span class="px-1.5 py-0.5 text-[10px] text-[var(--text-muted)] bg-[var(--bg-secondary)] rounded border border-[var(--border-secondary)]" title="Team tag - cannot edit">
+                                <i class="fas fa-lock"></i>
+                            </span>
+                        ` : ''}
+                        ${canEdit ? `
+                            <button class="edit-tag-btn p-1 text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors rounded" data-tag-id="${tag.id}" title="Edit tag">
+                                <i class="fas fa-edit text-xs"></i>
+                            </button>
+                            <button class="delete-tag-btn p-1 text-[var(--text-muted)] hover:text-red-500 transition-colors rounded" data-tag-id="${tag.id}" title="Delete tag">
+                                <i class="fas fa-trash text-xs"></i>
+                            </button>
+                        ` : ''}
+                    </div>
+                </div>
+
+                <!-- Metadata badges -->
+                ${metadata.length > 0 ? `
+                    <div class="px-3 py-2 flex flex-wrap gap-1.5">
+                        ${metadata.join('')}
+                    </div>
+                ` : ''}
+
+                <!-- Custom prompt section (collapsible) -->
+                ${hasPrompt ? `
+                    <div class="border-t border-[var(--border-primary)]">
+                        <button class="toggle-prompt-btn w-full px-3 py-2 flex items-center justify-between text-left hover:bg-[var(--bg-secondary)] transition-colors group" data-tag-id="${tag.id}">
+                            <span class="text-xs font-medium text-[var(--text-secondary)] flex items-center gap-1.5">
+                                <i class="fas fa-message-lines text-[10px]"></i>
+                                Custom Prompt
+                            </span>
+                            <i class="fas fa-chevron-down text-[10px] text-[var(--text-muted)] transition-transform group-hover:text-[var(--text-secondary)]"></i>
+                        </button>
+                        <div class="prompt-content hidden px-3 pb-2">
+                            <div class="text-xs text-[var(--text-muted)] bg-[var(--bg-secondary)] rounded p-2 max-h-24 overflow-y-auto custom-scrollbar border border-[var(--border-secondary)]">
+                                ${escapeHtml(tag.custom_prompt)}
+                            </div>
+                        </div>
+                    </div>
+                ` : ''}
+            `;
+
+            // Add event listeners
+            const editBtn = div.querySelector('.edit-tag-btn');
+            const deleteBtn = div.querySelector('.delete-tag-btn');
+            const toggleBtn = div.querySelector('.toggle-prompt-btn');
+
+            if (editBtn) {
+                editBtn.addEventListener('click', () => editTag(tag));
+            }
+            if (deleteBtn) {
+                deleteBtn.addEventListener('click', () => deleteTag(tag.id, tag.name));
+            }
+            if (toggleBtn) {
+                toggleBtn.addEventListener('click', function(e) {
+                    e.preventDefault();
+                    const content = this.nextElementSibling;
+                    const icon = this.querySelector('.fa-chevron-down');
+                    content.classList.toggle('hidden');
+                    icon.style.transform = content.classList.contains('hidden') ? 'rotate(0deg)' : 'rotate(180deg)';
+                });
+            }
+
+            return div;
+        }
+
+        // Create tag modal functionality
+        createTagBtn.addEventListener('click', () => {
+            openTagModal();
+        });
+
+        // Close tag modal functions
+        function closeTagModal() {
+            tagModal.classList.add('hidden');
+            tagForm.reset();
+            isEditingTag = false;
+            document.getElementById('tagId').value = '';
+        }
+
+        closeTagModalBtn.addEventListener('click', closeTagModal);
+        cancelTagBtn.addEventListener('click', closeTagModal);
+
+        // Close modal when clicking outside
+        tagModal.addEventListener('click', (event) => {
+            if (event.target === tagModal) {
+                closeTagModal();
+            }
+        });
+
+        // Open tag modal for create
+        function openTagModal(tag = null) {
+            if (tag) {
+                // Edit mode
+                isEditingTag = true;
+                tagModalTitle.textContent = 'Edit Tag';
+                saveTagBtn.innerHTML = '<i class="fas fa-save mr-2"></i> Update Tag';
+
+                // Populate form
+                document.getElementById('tagId').value = tag.id;
+                document.getElementById('tagName').value = tag.name;
+                document.getElementById('tagColor').value = tag.color;
+                document.getElementById('tagCustomPrompt').value = tag.custom_prompt || '';
+
+                // Populate group selection
+                const groupIdSelect = document.getElementById('tagGroupId');
+                const groupSelectionSection = document.getElementById('tagGroupSelectionSection');
+                const isInternalSharingEnabled = {{ 'true' if enable_internal_sharing else 'false' }};
+
+                if (groupIdSelect && isInternalSharingEnabled) {
+                    // If this tag has a group_id, force show the group selection section
+                    if (tag.group_id) {
+                        groupSelectionSection?.classList.remove('hidden');
+
+                        // Ensure the current group is in the dropdown (in case async load hasn't finished)
+                        if (tag.group_name) {
+                            // Check if option already exists
+                            const existingOption = Array.from(groupIdSelect.options).find(opt => opt.value == tag.group_id);
+                            if (!existingOption) {
+                                // Add the current group as an option
+                                const option = document.createElement('option');
+                                option.value = tag.group_id;
+                                option.textContent = tag.group_name;
+                                groupIdSelect.appendChild(option);
+                            }
+                        }
+                    }
+
+                    groupIdSelect.value = tag.group_id || '';
+                    toggleGroupSettings();
+                }
+
+                // Populate group-specific settings
+                if (document.getElementById('tagAutoShareOnApply')) {
+                    document.getElementById('tagAutoShareOnApply').checked = tag.auto_share_on_apply !== undefined ? tag.auto_share_on_apply : true;
+                }
+                if (document.getElementById('tagShareWithGroupLead')) {
+                    document.getElementById('tagShareWithGroupLead').checked = tag.share_with_group_lead !== undefined ? tag.share_with_group_lead : true;
+                }
+
+                // Populate retention settings
+                // If retention_days is -1, it means protected from deletion
+                const retentionDaysInput = document.getElementById('tagRetentionDays');
+                const protectCheckbox = document.getElementById('tagProtectFromDeletion');
+
+                if (tag.retention_days === -1 || tag.protect_from_deletion) {
+                    // Protected from deletion
+                    if (protectCheckbox) {
+                        protectCheckbox.checked = true;
+                    }
+                    if (retentionDaysInput) {
+                        retentionDaysInput.value = '';
+                        retentionDaysInput.disabled = true;
+                        retentionDaysInput.classList.add('opacity-50', 'cursor-not-allowed');
+                        retentionDaysInput.placeholder = 'Infinite retention (protected)';
+                    }
+                } else {
+                    // Not protected
+                    if (protectCheckbox) {
+                        protectCheckbox.checked = false;
+                    }
+                    if (retentionDaysInput) {
+                        retentionDaysInput.value = tag.retention_days || '';
+                        retentionDaysInput.disabled = false;
+                        retentionDaysInput.classList.remove('opacity-50', 'cursor-not-allowed');
+                        retentionDaysInput.placeholder = 'Leave empty to use global retention';
+                    }
+                }
+
+                // Populate ASR settings
+                if (document.getElementById('tagLanguage')) {
+                    document.getElementById('tagLanguage').value = tag.default_language || '';
+                }
+                if (document.getElementById('tagMinSpeakers')) {
+                    document.getElementById('tagMinSpeakers').value = tag.default_min_speakers || '';
+                }
+                if (document.getElementById('tagMaxSpeakers')) {
+                    document.getElementById('tagMaxSpeakers').value = tag.default_max_speakers || '';
+                }
+                if (document.getElementById('tagHotwords')) {
+                    document.getElementById('tagHotwords').value = tag.default_hotwords || '';
+                }
+                if (document.getElementById('tagInitialPrompt')) {
+                    document.getElementById('tagInitialPrompt').value = tag.default_initial_prompt || '';
+                }
+                if (document.getElementById('tagTranscriptionModel')) {
+                    const savedTagModel = tag.default_transcription_model || '';
+                    document.getElementById('tagTranscriptionModel').value = savedTagModel;
+                    if (typeof window.validateTranscriptionModelSelect === 'function') {
+                        window.validateTranscriptionModelSelect('tagTranscriptionModel', savedTagModel);
+                    }
+                }
+
+                // Populate naming template
+                if (document.getElementById('tagNamingTemplate')) {
+                    document.getElementById('tagNamingTemplate').value = tag.naming_template_id || '';
+                }
+
+                // Populate export template
+                if (document.getElementById('tagExportTemplate')) {
+                    document.getElementById('tagExportTemplate').value = tag.export_template_id || '';
+                }
+
+                // Populate auto-process toggle
+                const autoProcessCheckbox = document.getElementById('tagAutoProcess');
+                if (autoProcessCheckbox) {
+                    autoProcessCheckbox.checked = tag.is_auto_process || false;
+                    const pathEl = document.getElementById('tagAutoProcessPath');
+                    const pathValueEl = document.getElementById('tagAutoProcessPathValue');
+                    if (tag.is_auto_process && tag.auto_process_folder_name) {
+                        pathEl?.classList.remove('hidden');
+                        if (pathValueEl) pathValueEl.textContent = tag.auto_process_folder_name;
+                    } else {
+                        pathEl?.classList.add('hidden');
+                    }
+                    // Hide auto-process for group tags
+                    const autoProcessRow = document.getElementById('tagAutoProcessRow');
+                    if (autoProcessRow) {
+                        autoProcessRow.style.display = tag.group_id ? 'none' : '';
+                    }
+                }
+                refreshTagAutoProcessVariableWarning();
+            } else {
+                // Create mode
+                isEditingTag = false;
+                tagModalTitle.textContent = 'Create Tag';
+                saveTagBtn.innerHTML = '<i class="fas fa-save mr-2"></i> Save Tag';
+                tagForm.reset();
+                document.getElementById('tagColor').value = '#3B82F6';
+
+                // Reset group selection
+                if (document.getElementById('tagGroupId')) {
+                    document.getElementById('tagGroupId').value = '';
+                    toggleGroupSettings();
+                }
+
+                // Set default values for group settings
+                if (document.getElementById('tagAutoShareOnApply')) {
+                    document.getElementById('tagAutoShareOnApply').checked = true;
+                }
+                if (document.getElementById('tagShareWithGroupLead')) {
+                    document.getElementById('tagShareWithGroupLead').checked = true;
+                }
+
+                // Clear retention settings and ensure field is enabled
+                const retentionInput = document.getElementById('tagRetentionDays');
+                const protectCheck = document.getElementById('tagProtectFromDeletion');
+
+                if (retentionInput) {
+                    retentionInput.value = '';
+                    retentionInput.disabled = false;
+                    retentionInput.classList.remove('opacity-50', 'cursor-not-allowed');
+                    retentionInput.placeholder = 'Leave empty to use global retention';
+                }
+                if (protectCheck) {
+                    protectCheck.checked = false;
+                }
+
+                // Reset naming template
+                if (document.getElementById('tagNamingTemplate')) {
+                    document.getElementById('tagNamingTemplate').value = '';
+                }
+
+                // Reset export template
+                if (document.getElementById('tagExportTemplate')) {
+                    document.getElementById('tagExportTemplate').value = '';
+                }
+
+                // Reset auto-process
+                const autoProcessCheckbox = document.getElementById('tagAutoProcess');
+                if (autoProcessCheckbox) {
+                    autoProcessCheckbox.checked = false;
+                    document.getElementById('tagAutoProcessPath')?.classList.add('hidden');
+                    const autoProcessRow = document.getElementById('tagAutoProcessRow');
+                    if (autoProcessRow) autoProcessRow.style.display = '';
+                }
+                refreshTagAutoProcessVariableWarning();
+            }
+
+            // Load naming templates for dropdown
+            loadNamingTemplatesForTagModal();
+
+            // Load export templates for dropdown
+            loadExportTemplatesForTagModal();
+
+            // Reset to first tab
+            switchModalTab('tagModalTabs', 'tag-modal-tab', 'tag-modal-tab-content', 'tagTabTranscription');
+
+            tagModal.classList.remove('hidden');
+        }
+
+        // Load naming templates for the tag modal dropdown
+        async function loadNamingTemplatesForTagModal() {
+            const select = document.getElementById('tagNamingTemplate');
+            if (!select) return;
+
+            try {
+                const response = await fetch('/api/naming-templates');
+                if (!response.ok) return;
+
+                const templates = await response.json();
+
+                // Preserve current selection
+                const currentValue = select.value;
+
+                // Clear all options except the first one
+                select.innerHTML = '<option value="">No template (use user default or AI title)</option>';
+
+                // Add template options
+                templates.forEach(template => {
+                    const option = document.createElement('option');
+                    option.value = template.id;
+                    option.textContent = template.name;
+                    if (template.description) {
+                        option.title = template.description;
+                    }
+                    select.appendChild(option);
+                });
+
+                // Restore selection
+                if (currentValue) {
+                    select.value = currentValue;
+                }
+            } catch (error) {
+                console.error('Error loading naming templates for tag modal:', error);
+            }
+        }
+
+        // Load export templates for the tag modal dropdown
+        async function loadExportTemplatesForTagModal() {
+            const select = document.getElementById('tagExportTemplate');
+            if (!select) return;
+
+            try {
+                const response = await fetch('/api/export-templates');
+                if (!response.ok) return;
+
+                const templates = await response.json();
+
+                // Preserve current selection
+                const currentValue = select.value;
+
+                // Clear all options and add default
+                select.textContent = '';
+                const defaultOpt = document.createElement('option');
+                defaultOpt.value = '';
+                defaultOpt.textContent = 'No template (use user default)';
+                select.appendChild(defaultOpt);
+
+                // Add template options
+                templates.forEach(template => {
+                    const option = document.createElement('option');
+                    option.value = template.id;
+                    option.textContent = template.name + (template.is_default ? ' (Default)' : '');
+                    select.appendChild(option);
+                });
+
+                // Restore selection
+                if (currentValue) {
+                    select.value = currentValue;
+                }
+            } catch (error) {
+                console.error('Error loading export templates for tag modal:', error);
+            }
+        }
+
+        // Edit tag
+        function editTag(tag) {
+            openTagModal(tag);
+        }
+
+        // Delete tag
+        async function deleteTag(tagId, tagName) {
+            if (!confirm(`Are you sure you want to delete "${tagName}"?`)) {
+                return;
+            }
+            
+            try {
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                
+                const headers = {};
+                if (csrfToken) {
+                    headers['X-CSRFToken'] = csrfToken;
+                }
+                
+                const response = await fetch(`/api/tags/${tagId}`, {
+                    method: 'DELETE',
+                    headers: headers
+                });
+                
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || `HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                // Remove from local array
+                tags = tags.filter(t => t.id !== tagId);
+                displayTags();
+                showToast(`Tag "${tagName}" deleted successfully`);
+            } catch (error) {
+                console.error('Error deleting tag:', error);
+                showToast(`Failed to delete tag: ${error.message}`, 'error');
+            }
+        }
+
+        // Save tag form submission
+        tagForm.addEventListener('submit', async (e) => {
+            e.preventDefault();
+
+            const formData = new FormData(tagForm);
+
+            // Determine retention_days: -1 if protected, otherwise use the input value
+            const isProtected = document.getElementById('tagProtectFromDeletion')?.checked || false;
+            let retentionDays = null;
+
+            if (isProtected) {
+                retentionDays = -1; // -1 means protected/infinite retention
+            } else {
+                const retentionInput = formData.get('retention_days');
+                retentionDays = retentionInput ? parseInt(retentionInput) : null;
+            }
+
+            const namingTemplateId = formData.get('naming_template_id');
+            const exportTemplateId = formData.get('export_template_id');
+            const tagData = {
+                name: formData.get('name'),
+                color: formData.get('color'),
+                custom_prompt: formData.get('custom_prompt') || null,
+                naming_template_id: namingTemplateId ? parseInt(namingTemplateId) : null,
+                export_template_id: exportTemplateId ? parseInt(exportTemplateId) : null,
+                default_language: formData.get('default_language') || null,
+                default_min_speakers: formData.get('default_min_speakers') ? parseInt(formData.get('default_min_speakers')) : null,
+                default_max_speakers: formData.get('default_max_speakers') ? parseInt(formData.get('default_max_speakers')) : null,
+                default_hotwords: formData.get('default_hotwords') || null,
+                default_initial_prompt: formData.get('default_initial_prompt') || null,
+                default_transcription_model: formData.get('default_transcription_model') || null,
+                retention_days: retentionDays,
+                is_auto_process: document.getElementById('tagAutoProcess')?.checked || false
+            };
+
+            // Add group-related fields
+            const groupId = formData.get('group_id');
+            if (groupId) {
+                tagData.group_id = parseInt(groupId);
+                tagData.auto_share_on_apply = document.getElementById('tagAutoShareOnApply')?.checked || false;
+                tagData.share_with_group_lead = document.getElementById('tagShareWithGroupLead')?.checked || false;
+            } else {
+                tagData.group_id = null;
+            }
+            
+            try {
+                const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                
+                const headers = { 'Content-Type': 'application/json' };
+                if (csrfToken) {
+                    headers['X-CSRFToken'] = csrfToken;
+                }
+                
+                let url = '/api/tags';
+                let method = 'POST';
+                
+                if (isEditingTag) {
+                    url += `/${formData.get('tag_id')}`;
+                    method = 'PUT';
+                }
+                
+                const response = await fetch(url, {
+                    method: method,
+                    headers: headers,
+                    body: JSON.stringify(tagData)
+                });
+                
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || `HTTP ${response.status}: ${response.statusText}`);
+                }
+                
+                const savedTag = await response.json();
+                
+                if (isEditingTag) {
+                    // Update existing tag in local array
+                    const index = tags.findIndex(t => t.id === savedTag.id);
+                    if (index !== -1) {
+                        tags[index] = savedTag;
+                    }
+                    showToast(`Tag "${savedTag.name}" updated successfully`);
+                } else {
+                    // Add new tag to local array
+                    tags.push(savedTag);
+                    showToast(`Tag "${savedTag.name}" created successfully`);
+                }
+
+                // Show auto-process folder notifications
+                if (savedTag.auto_process_folder_path) {
+                    showToast(translations?.editTagModal?.watchFolderCreated || 'Watch folder created');
+                }
+                if (savedTag.auto_process_folder_warning) {
+                    showToast(translations?.editTagModal?.watchFolderError || 'Could not create watch folder', 'error');
+                }
+
+                displayTags();
+                closeTagModal();
+            } catch (error) {
+                console.error('Error saving tag:', error);
+                showToast(`Failed to save tag: ${error.message}`, 'error');
+            }
+        });
+
+        // ========== FOLDERS MANAGEMENT ==========
+        let folders = [];
+        let isEditingFolder = false;
+        let foldersEnabled = false;
+
+        // Folder management elements
+        const createFolderBtn = document.getElementById('createFolderBtn');
+        const folderModal = document.getElementById('folderModal');
+        const closeFolderModalBtn = document.getElementById('closeFolderModalBtn');
+        const cancelFolderBtn = document.getElementById('cancelFolderBtn');
+        const folderForm = document.getElementById('folderForm');
+        const folderModalTitle = document.getElementById('folderModalTitle');
+        const saveFolderBtn = document.getElementById('saveFolderBtn');
+
+        const foldersLoading = document.getElementById('foldersLoading');
+        const foldersError = document.getElementById('foldersError');
+        const foldersErrorMessage = document.getElementById('foldersErrorMessage');
+        const foldersEmpty = document.getElementById('foldersEmpty');
+        const foldersGrid = document.getElementById('foldersGrid');
+
+        // Check if folders feature is enabled and show/hide the tab
+        // Also check if auto-export is enabled for export templates sub-tab
+        async function checkFeaturesEnabled() {
+            try {
+                const response = await fetch('/api/config');
+                if (response.ok) {
+                    const config = await response.json();
+                    foldersEnabled = config.enable_folders === true;
+
+                    if (foldersEnabled && tabFolders) {
+                        tabFolders.style.display = '';
+                    }
+
+                    // Show export templates sub-tab if auto-export is enabled
+                    const exportSubtab = document.getElementById('subtab-export');
+                    if (config.enable_auto_export === true && exportSubtab) {
+                        exportSubtab.style.display = '';
+                    }
+
+                    // Populate the per-tag and per-folder transcription-model
+                    // dropdowns when the admin has configured a model list
+                    // (issue #266).
+                    const modelOptions = Array.isArray(config.transcription_model_options)
+                        ? config.transcription_model_options : [];
+                    window._transcriptionModelOptions = modelOptions;
+                    if (modelOptions.length > 0) {
+                        const populate = (selectId, sectionId) => {
+                            const select = document.getElementById(selectId);
+                            const section = document.getElementById(sectionId);
+                            if (!select || !section) return;
+                            for (const opt of modelOptions) {
+                                const o = document.createElement('option');
+                                o.value = opt.value;
+                                o.textContent = opt.label || opt.value;
+                                select.appendChild(o);
+                            }
+                            section.classList.remove('hidden');
+                            select.addEventListener('change', () => {
+                                window.validateTranscriptionModelSelect(selectId);
+                            });
+                        };
+                        populate('tagTranscriptionModel', 'tagTranscriptionModelSection');
+                        populate('folderTranscriptionModel', 'folderTranscriptionModelSection');
+                    }
+                }
+            } catch (error) {
+                console.error('Error checking features enabled status:', error);
+            }
+        }
+        checkFeaturesEnabled();
+
+        /**
+         * If a tag or folder still has a `default_transcription_model` value
+         * that has been removed from the admin-curated visible list, highlight
+         * the dropdown and surface a compact warning. The user can pick a new
+         * model or leave blank to fall back to the global default.
+         *
+         * `expectedValue` is the value the caller tried to set on the select.
+         * Pass it from editTag/editFolder because HTML <select> silently
+         * ignores a value that has no matching <option>, so reading
+         * `select.value` after the assignment would not reveal the staleness.
+         * Pass undefined or omit to validate against the current select.value
+         * (e.g. from the change listener).
+         */
+        window.validateTranscriptionModelSelect = function (selectId, expectedValue) {
+            const select = document.getElementById(selectId);
+            if (!select) return;
+            const validValues = new Set();
+            const visibleOptions = window._transcriptionModelOptions || [];
+            for (const opt of visibleOptions) validValues.add(opt.value);
+            validValues.add('');  // blank means "use admin/global default"
+
+            const warningId = selectId + 'StaleWarning';
+            let warning = document.getElementById(warningId);
+            const errorClasses = ['ring-1', 'ring-[var(--text-danger)]'];
+            const errorBorder = 'border-[var(--text-danger)]';
+
+            // Drop any previous synthetic option before recomputing.
+            const previousStale = select.querySelector('option[data-stale="1"]');
+            if (previousStale) previousStale.remove();
+
+            const target = (expectedValue !== undefined ? expectedValue : (select.value || '')).trim();
+            const isStale = target !== '' && !validValues.has(target);
+
+            if (isStale) {
+                const staleOption = document.createElement('option');
+                staleOption.value = target;
+                staleOption.textContent = target + ' (no longer available)';
+                staleOption.dataset.stale = '1';
+                select.appendChild(staleOption);
+                select.value = target;
+                select.classList.add(errorBorder, ...errorClasses);
+                if (!warning) {
+                    warning = document.createElement('p');
+                    warning.id = warningId;
+                    warning.className = 'text-xs text-[var(--text-danger)] mt-1';
+                    select.parentNode.insertBefore(warning, select.nextSibling);
+                }
+                warning.textContent = 'The previously selected model "' + target + '" is no longer available. Choose a different model or leave blank to use the default.';
             } else {
-                document.documentElement.classList.remove('dark');
-                darkModeIcon.classList.remove('fa-sun');
-                darkModeIcon.classList.add('fa-moon');
+                select.classList.remove(errorBorder, ...errorClasses);
+                if (warning) warning.remove();
+            }
+        };
+
+        {% raw %}
+        // Detect `{{name}}` placeholders so config-time guards can warn when
+        // the prompt source has no UI for users to fill the values.
+        const _PROMPT_VAR_RE = /\{\{\s*[A-Za-z_][A-Za-z0-9_]*\s*\}\}/;
+        {% endraw %}
+        function promptHasVariables(text) {
+            return typeof text === 'string' && _PROMPT_VAR_RE.test(text);
+        }
+
+        // Tag-edit form: warn when this tag is configured as an auto-process
+        // watch folder AND its custom prompt contains template variables.
+        // Drop-folder uploads have no UI to fill variables, so the
+        // placeholders silently substitute to empty strings on first run.
+        function refreshTagAutoProcessVariableWarning() {
+            const warningEl = document.getElementById('tagAutoProcessVariableWarning');
+            if (!warningEl) return;
+            const promptEl = document.getElementById('tagCustomPrompt');
+            const autoProcessEl = document.getElementById('tagAutoProcess');
+            const isAutoProcess = !!(autoProcessEl && autoProcessEl.checked);
+            const promptText = promptEl ? promptEl.value : '';
+            const shouldShow = isAutoProcess && promptHasVariables(promptText);
+            warningEl.classList.toggle('hidden', !shouldShow);
+        }
+
+        document.addEventListener('input', (e) => {
+            if (e.target && e.target.id === 'tagCustomPrompt') {
+                refreshTagAutoProcessVariableWarning();
+            }
+        });
+        document.addEventListener('change', (e) => {
+            if (e.target && e.target.id === 'tagAutoProcess') {
+                refreshTagAutoProcessVariableWarning();
+            }
+        });
+
+        // Load folders from API
+        async function loadFolders() {
+            if (!foldersEnabled) {
+                if (foldersError) {
+                    foldersErrorMessage.textContent = 'Folders feature is not enabled';
+                    foldersError.classList.remove('hidden');
+                }
+                return;
+            }
+            showFoldersLoadingState();
+
+            try {
+                const response = await fetch('/api/folders');
+                if (!response.ok) {
+                    throw new Error('HTTP ' + response.status + ': ' + response.statusText);
+                }
+
+                folders = await response.json();
+                displayFolders();
+            } catch (error) {
+                console.error('Error loading folders:', error);
+                showFoldersErrorState(error.message);
+            }
+        }
+
+        function showFoldersLoadingState() {
+            if (foldersLoading) foldersLoading.classList.remove('hidden');
+            if (foldersError) foldersError.classList.add('hidden');
+            if (foldersEmpty) foldersEmpty.classList.add('hidden');
+            if (foldersGrid) foldersGrid.classList.add('hidden');
+        }
+
+        function showFoldersErrorState(message) {
+            if (foldersLoading) foldersLoading.classList.add('hidden');
+            if (foldersError) foldersError.classList.remove('hidden');
+            if (foldersEmpty) foldersEmpty.classList.add('hidden');
+            if (foldersGrid) foldersGrid.classList.add('hidden');
+            if (foldersErrorMessage) foldersErrorMessage.textContent = message;
+        }
+
+        function displayFolders() {
+            if (foldersLoading) foldersLoading.classList.add('hidden');
+            if (foldersError) foldersError.classList.add('hidden');
+
+            if (folders.length === 0) {
+                if (foldersEmpty) foldersEmpty.classList.remove('hidden');
+                if (foldersGrid) foldersGrid.classList.add('hidden');
+            } else {
+                if (foldersEmpty) foldersEmpty.classList.add('hidden');
+                if (foldersGrid) foldersGrid.classList.remove('hidden');
+                renderFoldersGrid();
+            }
+        }
+
+        function renderFoldersGrid() {
+            if (!foldersGrid) return;
+            foldersGrid.textContent = '';
+
+            folders.forEach(folder => {
+                const folderCard = createFolderCard(folder);
+                foldersGrid.appendChild(folderCard);
+            });
+        }
+
+        function createFolderCard(folder) {
+            const div = document.createElement('div');
+            const isGroupFolder = folder.group_id !== null && folder.group_id !== undefined;
+            const canEdit = folder.can_edit !== undefined ? folder.can_edit : true;
+
+            div.className = 'bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] hover:shadow-md transition-shadow duration-200 overflow-hidden';
+
+            // Create header
+            const header = document.createElement('div');
+            header.className = 'flex items-center px-4 py-3 border-b border-[var(--border-primary)]';
+            header.style.backgroundColor = folder.color + '15';
+
+            const colorDot = document.createElement('div');
+            colorDot.className = 'w-3 h-3 rounded-full mr-3 flex-shrink-0';
+            colorDot.style.backgroundColor = folder.color;
+
+            const titleWrapper = document.createElement('div');
+            titleWrapper.className = 'flex-grow';
+
+            const title = document.createElement('h3');
+            title.className = 'font-medium text-[var(--text-primary)] truncate';
+            title.textContent = folder.name;
+            titleWrapper.appendChild(title);
+
+            if (isGroupFolder) {
+                const groupLabel = document.createElement('span');
+                groupLabel.className = 'text-xs text-[var(--text-muted)]';
+                const groupIcon = document.createElement('i');
+                groupIcon.className = 'fas fa-users mr-1';
+                groupLabel.appendChild(groupIcon);
+                groupLabel.appendChild(document.createTextNode(folder.group_name || ''));
+                titleWrapper.appendChild(groupLabel);
+            }
+
+            header.appendChild(colorDot);
+            header.appendChild(titleWrapper);
+
+            if (canEdit) {
+                const actions = document.createElement('div');
+                actions.className = 'flex items-center space-x-2';
+
+                const editBtn = document.createElement('button');
+                editBtn.className = 'edit-folder-btn text-[var(--text-muted)] hover:text-[var(--text-accent)] p-1';
+                editBtn.title = 'Edit folder';
+                const editIcon = document.createElement('i');
+                editIcon.className = 'fas fa-edit';
+                editBtn.appendChild(editIcon);
+                editBtn.addEventListener('click', () => openFolderModal(folder));
+
+                const deleteBtn = document.createElement('button');
+                deleteBtn.className = 'delete-folder-btn text-[var(--text-muted)] hover:text-red-500 p-1';
+                deleteBtn.title = 'Delete folder';
+                const deleteIcon = document.createElement('i');
+                deleteIcon.className = 'fas fa-trash';
+                deleteBtn.appendChild(deleteIcon);
+                deleteBtn.addEventListener('click', () => deleteFolder(folder.id, folder.name));
+
+                actions.appendChild(editBtn);
+                actions.appendChild(deleteBtn);
+                header.appendChild(actions);
+            } else {
+                const lockIcon = document.createElement('span');
+                lockIcon.className = 'text-xs text-[var(--text-muted)]';
+                lockIcon.title = "You don't have permission to edit this group folder";
+                const lock = document.createElement('i');
+                lock.className = 'fas fa-lock';
+                lockIcon.appendChild(lock);
+                header.appendChild(lockIcon);
+            }
+
+            // Create body
+            const body = document.createElement('div');
+            body.className = 'px-4 py-3';
+
+            // Metadata badges
+            const badges = document.createElement('div');
+            badges.className = 'flex flex-wrap gap-2 mb-2';
+
+            if (folder.protect_from_deletion || folder.retention_days === -1) {
+                const badge = document.createElement('span');
+                badge.className = 'inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium';
+                badge.style.backgroundColor = '#f59e0b';
+                badge.style.color = 'white';
+                badge.title = 'Protected with infinite retention';
+                const shieldIcon = document.createElement('i');
+                shieldIcon.className = 'fas fa-shield-alt';
+                badge.appendChild(shieldIcon);
+                badge.appendChild(document.createTextNode(' ∞'));
+                badges.appendChild(badge);
+            } else if (folder.retention_days && folder.retention_days > 0) {
+                const badge = document.createElement('span');
+                badge.className = 'inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium';
+                badge.style.backgroundColor = '#2563eb';
+                badge.style.color = 'white';
+                badge.title = 'Retention: ' + folder.retention_days + ' days';
+                const clockIcon = document.createElement('i');
+                clockIcon.className = 'fas fa-clock';
+                badge.appendChild(clockIcon);
+                badge.appendChild(document.createTextNode(' ' + folder.retention_days + 'd'));
+                badges.appendChild(badge);
+            }
+
+            if (isGroupFolder) {
+                const badge = document.createElement('span');
+                badge.className = 'inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs font-medium';
+                badge.style.backgroundColor = '#9333ea';
+                badge.style.color = 'white';
+                const shareIcon = document.createElement('i');
+                if (folder.auto_share_on_apply) {
+                    shareIcon.className = 'fas fa-user-friends';
+                    badge.title = 'Auto-shares with all group members';
+                    badge.appendChild(shareIcon);
+                    badge.appendChild(document.createTextNode(' All members'));
+                } else if (folder.share_with_group_lead) {
+                    shareIcon.className = 'fas fa-user-tie';
+                    badge.title = 'Shares with group admins only';
+                    badge.appendChild(shareIcon);
+                    badge.appendChild(document.createTextNode(' Admins only'));
+                } else {
+                    shareIcon.className = 'fas fa-user-lock';
+                    badge.title = 'Manual sharing only';
+                    badge.appendChild(shareIcon);
+                    badge.appendChild(document.createTextNode(' Manual'));
+                }
+                badges.appendChild(badge);
+            }
+
+            if (badges.childNodes.length > 0) {
+                body.appendChild(badges);
+            }
+
+            // Info row
+            const infoRow = document.createElement('div');
+            infoRow.className = 'text-sm text-[var(--text-muted)]';
+
+            if (folder.custom_prompt) {
+                const promptIcon = document.createElement('i');
+                promptIcon.className = 'fas fa-comment-alt mr-1';
+                promptIcon.title = 'Has custom prompt';
+                infoRow.appendChild(promptIcon);
+            }
+            if (folder.default_language) {
+                const langIcon = document.createElement('i');
+                langIcon.className = 'fas fa-language mr-1';
+                langIcon.title = 'Language: ' + folder.default_language;
+                infoRow.appendChild(langIcon);
+            }
+            if (folder.naming_template_name) {
+                const templateIcon = document.createElement('i');
+                templateIcon.className = 'fas fa-heading mr-1';
+                templateIcon.title = 'Naming template: ' + folder.naming_template_name;
+                infoRow.appendChild(templateIcon);
+            }
+
+            const countSpan = document.createElement('span');
+            countSpan.className = 'ml-auto';
+            const count = folder.recording_count || 0;
+            countSpan.textContent = count + ' recording' + (count !== 1 ? 's' : '');
+            infoRow.appendChild(countSpan);
+            body.appendChild(infoRow);
+
+            div.appendChild(header);
+            div.appendChild(body);
+
+            return div;
+        }
+
+        // Close folder modal
+        function closeFolderModal() {
+            if (folderModal) folderModal.classList.add('hidden');
+            if (folderForm) folderForm.reset();
+            isEditingFolder = false;
+            document.getElementById('folderId').value = '';
+        }
+
+        if (closeFolderModalBtn) closeFolderModalBtn.addEventListener('click', closeFolderModal);
+        if (cancelFolderBtn) cancelFolderBtn.addEventListener('click', closeFolderModal);
+
+        // Close modal when clicking outside
+        if (folderModal) {
+            folderModal.addEventListener('click', (event) => {
+                if (event.target === folderModal) {
+                    closeFolderModal();
+                }
+            });
+        }
+
+        // Open folder modal
+        function openFolderModal(folder) {
+            folder = folder || null;
+            if (folder) {
+                // Edit mode
+                isEditingFolder = true;
+                if (folderModalTitle) folderModalTitle.textContent = 'Edit Folder';
+                if (saveFolderBtn) {
+                    saveFolderBtn.textContent = '';
+                    const saveIcon = document.createElement('i');
+                    saveIcon.className = 'fas fa-save mr-2';
+                    saveFolderBtn.appendChild(saveIcon);
+                    saveFolderBtn.appendChild(document.createTextNode(' Update Folder'));
+                }
+
+                // Populate form
+                document.getElementById('folderId').value = folder.id;
+                document.getElementById('folderName').value = folder.name;
+                document.getElementById('folderColor').value = folder.color;
+                document.getElementById('folderCustomPrompt').value = folder.custom_prompt || '';
+                var langField = document.getElementById('folderLanguage');
+                if (langField) langField.value = folder.default_language || '';
+                var minField = document.getElementById('folderMinSpeakers');
+                if (minField) minField.value = folder.default_min_speakers || '';
+                var maxField = document.getElementById('folderMaxSpeakers');
+                if (maxField) maxField.value = folder.default_max_speakers || '';
+                var hwField = document.getElementById('folderHotwords');
+                if (hwField) hwField.value = folder.default_hotwords || '';
+                var ipField = document.getElementById('folderInitialPrompt');
+                if (ipField) ipField.value = folder.default_initial_prompt || '';
+                var modelField = document.getElementById('folderTranscriptionModel');
+                if (modelField) {
+                    var savedFolderModel = folder.default_transcription_model || '';
+                    modelField.value = savedFolderModel;
+                    if (typeof window.validateTranscriptionModelSelect === 'function') {
+                        window.validateTranscriptionModelSelect('folderTranscriptionModel', savedFolderModel);
+                    }
+                }
+
+                // Group selection
+                const folderGroupId = document.getElementById('folderGroupId');
+                if (folderGroupId) {
+                    folderGroupId.value = folder.group_id || '';
+                    updateFolderGroupSettingsVisibility();
+                }
+
+                // Group settings
+                var autoShare = document.getElementById('folderAutoShareOnApply');
+                if (autoShare) autoShare.checked = folder.auto_share_on_apply !== false;
+                var shareWithLead = document.getElementById('folderShareWithGroupLead');
+                if (shareWithLead) shareWithLead.checked = folder.share_with_group_lead !== false;
+
+                // Retention settings
+                const folderRetentionDays = document.getElementById('folderRetentionDays');
+                const folderProtectFromDeletion = document.getElementById('folderProtectFromDeletion');
+                if (folderProtectFromDeletion && folderRetentionDays) {
+                    if (folder.retention_days === -1 || folder.protect_from_deletion) {
+                        folderProtectFromDeletion.checked = true;
+                        folderRetentionDays.value = '';
+                        folderRetentionDays.disabled = true;
+                    } else {
+                        folderProtectFromDeletion.checked = false;
+                        folderRetentionDays.value = folder.retention_days || '';
+                        folderRetentionDays.disabled = false;
+                    }
+                }
+            } else {
+                // Create mode
+                isEditingFolder = false;
+                if (folderModalTitle) folderModalTitle.textContent = 'Create Folder';
+                if (saveFolderBtn) {
+                    saveFolderBtn.textContent = '';
+                    const saveIcon = document.createElement('i');
+                    saveIcon.className = 'fas fa-save mr-2';
+                    saveFolderBtn.appendChild(saveIcon);
+                    saveFolderBtn.appendChild(document.createTextNode(' Save Folder'));
+                }
+                if (folderForm) folderForm.reset();
+                document.getElementById('folderColor').value = '#10B981';
+                document.getElementById('folderId').value = '';
+            }
+
+            // Load naming templates for dropdown (pass folder to set initial value)
+            loadNamingTemplatesForFolderModal(folder);
+
+            // Load export templates for dropdown (pass folder to set initial value)
+            loadExportTemplatesForFolderModal(folder);
+
+            // Reset to first tab
+            switchModalTab('folderModalTabs', 'folder-modal-tab', 'folder-modal-tab-content', 'folderTabTranscription');
+
+            if (folderModal) folderModal.classList.remove('hidden');
+        }
+
+        // Load naming templates for folder modal
+        async function loadNamingTemplatesForFolderModal(folder) {
+            const select = document.getElementById('folderNamingTemplate');
+            if (!select) return;
+
+            try {
+                const response = await fetch('/api/naming-templates');
+                if (response.ok) {
+                    const templates = await response.json();
+                    select.textContent = '';
+                    const defaultOpt = document.createElement('option');
+                    defaultOpt.value = '';
+                    defaultOpt.textContent = 'No template (use user default or AI title)';
+                    select.appendChild(defaultOpt);
+                    templates.forEach(function(t) {
+                        const option = document.createElement('option');
+                        option.value = t.id;
+                        option.textContent = t.name;
+                        select.appendChild(option);
+                    });
+
+                    // Set value if editing
+                    if (folder && folder.naming_template_id) {
+                        select.value = folder.naming_template_id;
+                    }
+                }
+            } catch (error) {
+                console.error('Error loading naming templates:', error);
+            }
+        }
+
+        // Load export templates for folder modal
+        async function loadExportTemplatesForFolderModal(folder) {
+            const select = document.getElementById('folderExportTemplate');
+            if (!select) return;
+
+            try {
+                const response = await fetch('/api/export-templates');
+                if (response.ok) {
+                    const templates = await response.json();
+                    select.textContent = '';
+                    const defaultOpt = document.createElement('option');
+                    defaultOpt.value = '';
+                    defaultOpt.textContent = 'No template (use user default)';
+                    select.appendChild(defaultOpt);
+                    templates.forEach(function(t) {
+                        const option = document.createElement('option');
+                        option.value = t.id;
+                        option.textContent = t.name + (t.is_default ? ' (Default)' : '');
+                        select.appendChild(option);
+                    });
+
+                    // Set value if editing
+                    if (folder && folder.export_template_id) {
+                        select.value = folder.export_template_id;
+                    }
+                }
+            } catch (error) {
+                console.error('Error loading export templates:', error);
+            }
+        }
+
+        // Update folder group settings visibility
+        function updateFolderGroupSettingsVisibility() {
+            const folderGroupId = document.getElementById('folderGroupId');
+            const folderGroupSettingsSection = document.getElementById('folderGroupSettingsSection');
+            if (folderGroupId && folderGroupSettingsSection) {
+                if (folderGroupId.value) {
+                    folderGroupSettingsSection.classList.remove('hidden');
+                } else {
+                    folderGroupSettingsSection.classList.add('hidden');
+                }
+            }
+        }
+
+        // Folder group selection change
+        const folderGroupIdSelect = document.getElementById('folderGroupId');
+        if (folderGroupIdSelect) {
+            folderGroupIdSelect.addEventListener('change', updateFolderGroupSettingsVisibility);
+        }
+
+        // Folder protect from deletion checkbox
+        const folderProtectCheckbox = document.getElementById('folderProtectFromDeletion');
+        const folderRetentionInput = document.getElementById('folderRetentionDays');
+        if (folderProtectCheckbox && folderRetentionInput) {
+            folderProtectCheckbox.addEventListener('change', function() {
+                if (folderProtectCheckbox.checked) {
+                    folderRetentionInput.value = '';
+                    folderRetentionInput.disabled = true;
+                    folderRetentionInput.classList.add('opacity-50', 'cursor-not-allowed');
+                } else {
+                    folderRetentionInput.disabled = false;
+                    folderRetentionInput.classList.remove('opacity-50', 'cursor-not-allowed');
+                }
+            });
+        }
+
+        // Delete folder
+        async function deleteFolder(folderId, folderName) {
+            if (!confirm('Are you sure you want to delete the folder "' + folderName + '"?\n\nRecordings in this folder will be removed from the folder but not deleted.')) {
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name=csrf-token]');
+                const csrfValue = csrfToken ? csrfToken.getAttribute('content') : '';
+                const response = await fetch('/api/folders/' + folderId, {
+                    method: 'DELETE',
+                    headers: {
+                        'X-CSRFToken': csrfValue
+                    }
+                });
+
+                if (!response.ok) {
+                    const data = await response.json();
+                    throw new Error(data.error || 'Failed to delete folder');
+                }
+
+                folders = folders.filter(function(f) { return f.id !== folderId; });
+                displayFolders();
+                showToast('Folder "' + folderName + '" deleted successfully');
+            } catch (error) {
+                console.error('Error deleting folder:', error);
+                showToast('Failed to delete folder: ' + error.message, 'error');
+            }
+        }
+
+        // Create folder button
+        if (createFolderBtn) {
+            createFolderBtn.addEventListener('click', function() { openFolderModal(); });
+        }
+
+        // Save folder form
+        if (folderForm) {
+            folderForm.addEventListener('submit', async function(e) {
+                e.preventDefault();
+
+                const folderId = document.getElementById('folderId').value;
+                const folderName = document.getElementById('folderName').value.trim();
+
+                if (!folderName) {
+                    showToast('Folder name is required', 'error');
+                    return;
+                }
+
+                const folderData = {
+                    name: folderName,
+                    color: document.getElementById('folderColor').value,
+                    custom_prompt: document.getElementById('folderCustomPrompt').value.trim() || null
+                };
+
+                var langEl = document.getElementById('folderLanguage');
+                folderData.default_language = langEl ? langEl.value.trim() || null : null;
+                var minEl = document.getElementById('folderMinSpeakers');
+                folderData.default_min_speakers = minEl && minEl.value ? parseInt(minEl.value) : null;
+                var maxEl = document.getElementById('folderMaxSpeakers');
+                folderData.default_max_speakers = maxEl && maxEl.value ? parseInt(maxEl.value) : null;
+                var hwEl = document.getElementById('folderHotwords');
+                folderData.default_hotwords = hwEl ? hwEl.value.trim() || null : null;
+                var ipEl = document.getElementById('folderInitialPrompt');
+                folderData.default_initial_prompt = ipEl ? ipEl.value.trim() || null : null;
+                var modelEl = document.getElementById('folderTranscriptionModel');
+                folderData.default_transcription_model = modelEl ? modelEl.value.trim() || null : null;
+                var templateEl = document.getElementById('folderNamingTemplate');
+                folderData.naming_template_id = templateEl && templateEl.value ? parseInt(templateEl.value) : null;
+                var exportTemplateEl = document.getElementById('folderExportTemplate');
+                folderData.export_template_id = exportTemplateEl && exportTemplateEl.value ? parseInt(exportTemplateEl.value) : null;
+
+                // Group settings
+                const folderGroupIdEl = document.getElementById('folderGroupId');
+                if (folderGroupIdEl && folderGroupIdEl.value) {
+                    folderData.group_id = parseInt(folderGroupIdEl.value);
+                    var autoShareEl = document.getElementById('folderAutoShareOnApply');
+                    folderData.auto_share_on_apply = autoShareEl ? autoShareEl.checked : true;
+                    var shareLeadEl = document.getElementById('folderShareWithGroupLead');
+                    folderData.share_with_group_lead = shareLeadEl ? shareLeadEl.checked : true;
+                }
+
+                // Retention settings
+                const folderProtect = document.getElementById('folderProtectFromDeletion');
+                const folderRetention = document.getElementById('folderRetentionDays');
+                if (folderProtect && folderProtect.checked) {
+                    folderData.retention_days = -1;
+                } else if (folderRetention && folderRetention.value) {
+                    folderData.retention_days = parseInt(folderRetention.value);
+                }
+
+                try {
+                    const csrfToken = document.querySelector('meta[name=csrf-token]');
+                    const csrfValue = csrfToken ? csrfToken.getAttribute('content') : '';
+                    const url = isEditingFolder ? '/api/folders/' + folderId : '/api/folders';
+                    const method = isEditingFolder ? 'PUT' : 'POST';
+
+                    const response = await fetch(url, {
+                        method: method,
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-CSRFToken': csrfValue
+                        },
+                        body: JSON.stringify(folderData)
+                    });
+
+                    if (!response.ok) {
+                        const data = await response.json();
+                        throw new Error(data.error || 'Failed to save folder');
+                    }
+
+                    const savedFolder = await response.json();
+
+                    if (isEditingFolder) {
+                        const index = folders.findIndex(function(f) { return f.id === parseInt(folderId); });
+                        if (index !== -1) {
+                            folders[index] = savedFolder;
+                        }
+                        showToast('Folder "' + savedFolder.name + '" updated successfully');
+                    } else {
+                        folders.push(savedFolder);
+                        showToast('Folder "' + savedFolder.name + '" created successfully');
+                    }
+
+                    displayFolders();
+                    closeFolderModal();
+                } catch (error) {
+                    console.error('Error saving folder:', error);
+                    showToast('Failed to save folder: ' + error.message, 'error');
+                }
+            });
+        }
+
+        // Check if auto-deletion is enabled for folder retention section
+        function checkFolderAutoDeletionEnabled() {
+            const isAutoDeletionEnabled = {{ 'true' if enable_auto_deletion else 'false' }};
+            const retentionSection = document.getElementById('folderRetentionSection');
+
+            if (retentionSection && isAutoDeletionEnabled) {
+                retentionSection.classList.remove('hidden');
+            }
+        }
+        checkFolderAutoDeletionEnabled();
+
+        // Initialize folder group selection visibility
+        function initFolderGroupSelection() {
+            const folderGroupSection = document.getElementById('folderGroupSelectionSection');
+            if (folderGroupSection && userAdminGroups && userAdminGroups.length > 0) {
+                folderGroupSection.classList.remove('hidden');
+
+                // Populate folder group dropdown
+                const folderGroupIdEl = document.getElementById('folderGroupId');
+                if (folderGroupIdEl) {
+                    folderGroupIdEl.textContent = '';
+                    const defaultOpt = document.createElement('option');
+                    defaultOpt.value = '';
+                    defaultOpt.textContent = t('account.personalFolder');
+                    folderGroupIdEl.appendChild(defaultOpt);
+                    userAdminGroups.forEach(function(group) {
+                        const option = document.createElement('option');
+                        option.value = group.id;
+                        option.textContent = group.name;
+                        folderGroupIdEl.appendChild(option);
+                    });
+                }
+            }
+        }
+        initFolderGroupSelection();
+
+        // ========== END FOLDERS MANAGEMENT ==========
+
+        // AJAX form submission for Account Information
+        const accountInfoForm = document.getElementById('accountInfoForm');
+        if (accountInfoForm) {
+            accountInfoForm.addEventListener('submit', async function(e) {
+                e.preventDefault();
+
+                const formData = new FormData(accountInfoForm);
+
+                try {
+                    const response = await fetch('/account', {
+                        method: 'POST',
+                        body: formData
+                    });
+
+                    if (response.ok) {
+                        showToast('Account information updated successfully', 'success');
+                    } else {
+                        var text = await response.text();
+                        showToast('Failed to update account information', 'error');
+                    }
+                } catch (error) {
+                    showToast('Network error: ' + error.message, 'error');
+                }
+            });
+        }
+        
+        // AJAX form submission for Preferences
+        const preferencesForm = document.getElementById('preferencesForm');
+        if (preferencesForm) {
+            preferencesForm.addEventListener('submit', async (e) => {
+                e.preventDefault();
+                const formData = new FormData(preferencesForm);
+                try {
+                    const response = await fetch('/account', {
+                        method: 'POST',
+                        headers: { 'X-Requested-With': 'XMLHttpRequest' },
+                        body: formData,
+                    });
+                    if (response.ok) {
+                        showToast('Preferences saved', 'success');
+                    } else {
+                        showToast('Failed to save preferences', 'error');
+                    }
+                } catch (error) {
+                    showToast('Network error: ' + error.message, 'error');
+                }
+            });
+        }
+
+        // AJAX form submission for Custom Prompts
+        const customPromptsForm = document.getElementById('customPromptsForm');
+        if (customPromptsForm) {
+            customPromptsForm.addEventListener('submit', async (e) => {
+                e.preventDefault();
+                
+                const formData = new FormData(customPromptsForm);
+                
+                try {
+                    const response = await fetch('/account', {
+                        method: 'POST',
+                        body: formData
+                    });
+                    
+                    if (response.ok) {
+                        showToast('Custom prompt saved successfully', 'success');
+                    } else {
+                        const text = await response.text();
+                        showToast('Failed to save custom prompt', 'error');
+                    }
+                } catch (error) {
+                    showToast('Network error: ' + error.message, 'error');
+                }
+            });
+        }
+        
+        // Check for stored tab preference (from language change reload)
+        const storedTab = localStorage.getItem('activeAccountTab');
+        if (storedTab) {
+            localStorage.removeItem('activeAccountTab'); // Clean up after use
+        }
+        
+        // Check for URL hash and show appropriate tab
+        const urlHash = window.location.hash.substring(1); // Remove the '#' symbol
+        if (urlHash === 'preferences') {
+            showPreferencesTab();
+        } else if (urlHash === 'prompts') {
+            showPromptsTab();
+        } else if (urlHash === 'tags') {
+            showTagsTab();
+        } else if (urlHash === 'shares') {
+            showSharesTab();
+        } else if (urlHash === 'about') {
+            showAboutTab();
+        } else if (storedTab) {
+            // Restore previously active tab after language change
+            if (storedTab === 'preferences') {
+                showPreferencesTab();
+            } else if (storedTab === 'prompts') {
+                showPromptsTab();
+            } else if (storedTab === 'tags') {
+                showTagsTab();
+            } else if (storedTab === 'shares') {
+                showSharesTab();
+            } else if (storedTab === 'about') {
+                showAboutTab();
+            } else {
+                showAccountTab();
+            }
+        } else {
+            // Default to account tab
+            showAccountTab();
+        }
+        
+        // Track original UI language to detect changes
+        let currentUILanguage = document.getElementById('ui_language').value;
+        const originalUILanguage = currentUILanguage;
+        
+        // Add immediate language change listener to the UI language dropdown
+        const uiLanguageSelect = document.getElementById('ui_language');
+        if (uiLanguageSelect) {
+            uiLanguageSelect.addEventListener('change', async function(e) {
+                const newLanguage = e.target.value;
+                if (newLanguage !== currentUILanguage) {
+                    await changeLanguageImmediately(newLanguage);
+                    // Update the current language tracker
+                    currentUILanguage = newLanguage;
+                }
+            });
+        }
+        
+        // Add event listener to the account info form
+        document.getElementById('accountInfoForm').addEventListener('submit', function(e) {
+            const newUILanguage = document.getElementById('ui_language').value;
+            if (newUILanguage !== originalUILanguage) {
+                // Language has changed, store flag to reload main app
+                localStorage.setItem('ui_language_changed', 'true');
+                localStorage.setItem('preferredLanguage', newUILanguage);
+            }
+        });
+
+        // API Tokens Management Functions
+        let tokensData = [];
+        let tokensTabLoaded = false;
+
+        async function loadTokensTab() {
+            if (tokensTabLoaded) return;
+
+            const tokensLoading = document.getElementById('tokensLoading');
+            const tokensContainer = document.getElementById('tokensContainer');
+
+            try {
+                tokensLoading.classList.remove('hidden');
+                tokensContainer.classList.add('hidden');
+
+                const response = await fetch('/api/tokens');
+                if (!response.ok) {
+                    throw new Error('Failed to load tokens');
+                }
+
+                const data = await response.json();
+                tokensData = data.tokens || [];
+
+                renderTokensList();
+                tokensTabLoaded = true;
+
+                tokensLoading.classList.add('hidden');
+                tokensContainer.classList.remove('hidden');
+            } catch (error) {
+                console.error('Error loading tokens:', error);
+                tokensLoading.innerHTML = `
+                    <div class="text-center py-12">
+                        <i class="fas fa-exclamation-triangle text-4xl text-red-500 mb-4"></i>
+                        <p class="text-red-600">Failed to load tokens: ${error.message}</p>
+                    </div>
+                `;
+            }
+        }
+
+        function renderTokensList() {
+            const activeTokensSection = document.getElementById('activeTokensSection');
+            const activeTokensList = document.getElementById('activeTokensList');
+            const activeTokensCount = document.getElementById('activeTokensCount');
+            const noTokensMessage = document.getElementById('noTokensMessage');
+
+            // Filter active tokens
+            const activeTokens = tokensData.filter(token => !token.revoked && !isTokenExpired(token));
+
+            if (activeTokens.length > 0) {
+                activeTokensSection.classList.remove('hidden');
+                noTokensMessage.classList.add('hidden');
+                activeTokensCount.textContent = `(${activeTokens.length})`;
+
+                activeTokensList.innerHTML = activeTokens.map(token => {
+                    const statusClass = getTokenStatusClass(token);
+                    const status = getTokenStatus(token);
+                    const createdDate = new Date(token.created_at).toLocaleDateString();
+                    const lastUsed = token.last_used_at ? new Date(token.last_used_at).toLocaleDateString() : null;
+
+                    return `
+                        <div class="bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] hover:border-[var(--border-accent)] transition-colors duration-200">
+                            <div class="p-3">
+                                <!-- Header with name, status badge, and delete button -->
+                                <div class="flex items-center justify-between mb-2">
+                                    <div class="flex items-center gap-2 flex-1 min-w-0">
+                                        <i class="fas fa-key text-[var(--text-accent)] text-sm flex-shrink-0"></i>
+                                        <h4 class="font-medium text-sm text-[var(--text-primary)] truncate">${escapeHtml(token.name)}</h4>
+                                    </div>
+                                    <div class="flex items-center gap-1 flex-shrink-0">
+                                        <span class="${statusClass} capitalize">${status}</span>
+                                        <button onclick="revokeToken(${token.id}, '${escapeHtml(token.name).replace(/'/g, "\\'")}' )"
+                                                class="p-1 text-[var(--text-danger)] hover:bg-[var(--bg-danger-light)] rounded transition-colors"
+                                                title="Revoke token">
+                                            <i class="fas fa-trash text-xs"></i>
+                                        </button>
+                                    </div>
+                                </div>
+
+                                <!-- Compact stats grid -->
+                                <div class="grid grid-cols-2 gap-1 text-[10px] text-[var(--text-muted)]">
+                                    <div class="flex items-center gap-1">
+                                        <i class="fas fa-calendar-plus opacity-60"></i>
+                                        <span>${createdDate}</span>
+                                    </div>
+                                    <div class="flex items-center gap-1">
+                                        <i class="fas fa-clock opacity-60"></i>
+                                        <span>${lastUsed || 'Never used'}</span>
+                                    </div>
+                                </div>
+
+                                <!-- Expiration badge -->
+                                <div class="mt-2">
+                                    ${token.expires_at ? `
+                                        <span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-[10px] font-medium bg-blue-100 text-blue-800">
+                                            <i class="fas fa-hourglass-half"></i>
+                                            Expires ${new Date(token.expires_at).toLocaleDateString()}
+                                        </span>
+                                    ` : `
+                                        <span class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-[10px] font-medium bg-gray-100 text-gray-600">
+                                            <i class="fas fa-infinity"></i>
+                                            No expiration
+                                        </span>
+                                    `}
+                                </div>
+                            </div>
+                        </div>
+                    `;
+                }).join('');
+            } else {
+                activeTokensSection.classList.add('hidden');
+                noTokensMessage.classList.remove('hidden');
+            }
+        }
+
+        function isTokenExpired(token) {
+            if (!token.expires_at) return false;
+            const expiryDate = new Date(token.expires_at);
+            return expiryDate < new Date();
+        }
+
+        function formatTokenDate(dateString) {
+            if (!dateString) return 'Never';
+            const date = new Date(dateString);
+            return date.toLocaleDateString() + ' ' + date.toLocaleTimeString();
+        }
+
+        function getTokenStatus(token) {
+            if (token.revoked) return 'revoked';
+            if (isTokenExpired(token)) return 'expired';
+            return 'active';
+        }
+
+        function getTokenStatusClass(token) {
+            const status = getTokenStatus(token);
+            const baseClasses = 'px-2 py-1 text-xs font-semibold rounded';
+
+            switch (status) {
+                case 'active':
+                    return `${baseClasses} bg-green-100 text-green-800`;
+                case 'expired':
+                    return `${baseClasses} bg-yellow-100 text-yellow-800`;
+                case 'revoked':
+                    return `${baseClasses} bg-red-100 text-red-800`;
+                default:
+                    return `${baseClasses} bg-gray-100 text-gray-800`;
+            }
+        }
+
+        // Token modal elements - same pattern as tag modal
+        const createTokenModal = document.getElementById('createTokenModal');
+        const tokenSecretModal = document.getElementById('tokenSecretModal');
+        const createTokenForm = document.getElementById('createTokenForm');
+        const createTokenBtn = document.getElementById('createTokenBtn');
+        const createTokenBtnEmpty = document.getElementById('createTokenBtnEmpty');
+
+        // Close create token modal
+        function closeCreateTokenModal() {
+            createTokenModal.classList.add('hidden');
+            createTokenForm.reset();
+        }
+
+        // Close token secret modal
+        function closeTokenSecretModal() {
+            tokenSecretModal.classList.add('hidden');
+        }
+
+        // Open create token modal
+        function openCreateTokenModal() {
+            createTokenForm.reset();
+            createTokenModal.classList.remove('hidden');
+        }
+
+        // Show token secret modal
+        function showTokenSecretModal(tokenValue, tokenName, expiresAt) {
+            document.getElementById('newTokenValue').value = tokenValue;
+            document.getElementById('newTokenInfo').innerHTML = `
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">Name:</span>
+                    <span class="text-[var(--text-primary)] font-medium">${escapeHtml(tokenName)}</span>
+                </div>
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">Expires:</span>
+                    <span class="text-[var(--text-primary)]">${expiresAt ? formatTokenDate(expiresAt) : 'Never'}</span>
+                </div>
+            `;
+            tokenSecretModal.classList.remove('hidden');
+        }
+
+        // Create token button click handlers
+        if (createTokenBtn) {
+            createTokenBtn.addEventListener('click', openCreateTokenModal);
+        }
+        if (createTokenBtnEmpty) {
+            createTokenBtnEmpty.addEventListener('click', openCreateTokenModal);
+        }
+
+        // Close modal handlers
+        document.getElementById('closeCreateTokenModal')?.addEventListener('click', closeCreateTokenModal);
+        document.getElementById('cancelCreateTokenBtn')?.addEventListener('click', closeCreateTokenModal);
+        document.getElementById('closeTokenSecretModal')?.addEventListener('click', closeTokenSecretModal);
+
+        // Close modals when clicking outside (on the backdrop)
+        createTokenModal?.addEventListener('click', (event) => {
+            if (event.target === createTokenModal) {
+                closeCreateTokenModal();
+            }
+        });
+        tokenSecretModal?.addEventListener('click', (event) => {
+            if (event.target === tokenSecretModal) {
+                closeTokenSecretModal();
+            }
+        });
+
+        // Copy token button
+        document.getElementById('copyTokenBtn')?.addEventListener('click', async () => {
+            const tokenValue = document.getElementById('newTokenValue').value;
+            const copyBtn = document.getElementById('copyTokenBtn');
+            const copyIcon = document.getElementById('copyTokenIcon');
+            const copyText = document.getElementById('copyTokenText');
+
+            try {
+                await navigator.clipboard.writeText(tokenValue);
+
+                // Visual feedback - change to success state
+                copyIcon.classList.remove('fa-copy', 'text-[var(--text-muted)]');
+                copyIcon.classList.add('fa-check', 'text-green-500');
+                copyText.classList.remove('hidden', 'text-[var(--text-muted)]');
+                copyText.classList.add('text-green-500');
+                copyBtn.classList.add('bg-green-50', 'border-green-200');
+
+                // Reset after 2 seconds
+                setTimeout(() => {
+                    copyIcon.classList.remove('fa-check', 'text-green-500');
+                    copyIcon.classList.add('fa-copy', 'text-[var(--text-muted)]');
+                    copyText.classList.add('hidden', 'text-[var(--text-muted)]');
+                    copyText.classList.remove('text-green-500');
+                    copyBtn.classList.remove('bg-green-50', 'border-green-200');
+                }, 2000);
+
+                showToast('Token copied to clipboard', 'success');
+            } catch (error) {
+                console.error('Error copying token:', error);
+                showToast('Failed to copy token to clipboard', 'error');
+            }
+        });
+
+        // Form submission handler
+        createTokenForm?.addEventListener('submit', async (e) => {
+            e.preventDefault();
+
+            const tokenName = document.getElementById('tokenNameInput').value.trim();
+            const expiresInDays = parseInt(document.getElementById('tokenExpirationSelect').value);
+
+            if (!tokenName) {
+                showToast('Please enter a token name', 'error');
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch('/api/tokens', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify({
+                        name: tokenName,
+                        expires_in_days: expiresInDays
+                    })
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to create token');
+                }
+
+                const data = await response.json();
+
+                // Add to local list
+                tokensData.unshift({
+                    id: data.id,
+                    name: data.name,
+                    created_at: data.created_at,
+                    last_used_at: data.last_used_at,
+                    expires_at: data.expires_at,
+                    revoked: data.revoked
+                });
+
+                renderTokensList();
+
+                // Close create modal and show secret modal
+                closeCreateTokenModal();
+                showTokenSecretModal(data.token, data.name, data.expires_at);
+
+                showToast('API token created successfully', 'success');
+            } catch (error) {
+                console.error('Error creating token:', error);
+                showToast('Failed to create token: ' + error.message, 'error');
+            }
+        });
+
+        // Make revokeToken globally accessible for inline onclick handlers
+        window.revokeToken = async function(tokenId, tokenName) {
+            if (!confirm(`Are you sure you want to revoke the token "${tokenName}"? This action cannot be undone and any applications using this token will lose access.`)) {
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch(`/api/tokens/${tokenId}`, {
+                    method: 'DELETE',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to revoke token');
+                }
+
+                // Remove from local list
+                tokensData = tokensData.filter(t => t.id !== tokenId);
+                renderTokensList();
+
+                showToast('Token revoked successfully', 'success');
+            } catch (error) {
+                console.error('Error revoking token:', error);
+                showToast('Failed to revoke token: ' + error.message, 'error');
+            }
+        };
+
+        // Template Management Functions
+        let templates = [];
+        let currentTemplate = null;
+        let isEditingTemplate = false;
+
+        async function loadTemplates() {
+            try {
+                const response = await fetch('/api/transcript-templates');
+                if (!response.ok) {
+                    throw new Error('Failed to load templates');
+                }
+                templates = await response.json();
+
+                // Create default templates if none exist
+                if (templates.length === 0) {
+                    document.getElementById('createDefaultTemplatesBtn').style.display = 'block';
+                } else {
+                    document.getElementById('createDefaultTemplatesBtn').style.display = 'none';
+                }
+
+                renderTemplatesList();
+            } catch (error) {
+                console.error('Error loading templates:', error);
+                showToast('Failed to load templates', 'error');
             }
         }
-        
-        // Toggle dark mode
-        darkModeToggle.addEventListener('click', () => {
-            const isDarkMode = document.documentElement.classList.toggle('dark');
-            localStorage.setItem('darkMode', isDarkMode);
-            
-            if (isDarkMode) {
-                darkModeIcon.classList.remove('fa-moon');
-                darkModeIcon.classList.add('fa-sun');
-            } else {
-                darkModeIcon.classList.remove('fa-sun');
-                darkModeIcon.classList.add('fa-moon');
+
+        function renderTemplatesList() {
+            const templatesList = document.getElementById('templatesList');
+            templatesList.innerHTML = '';
+
+            if (templates.length === 0) {
+                templatesList.innerHTML = '<p class="text-sm text-[var(--text-muted)] text-center py-4">No templates yet</p>';
+                return;
             }
+
+            templates.forEach(template => {
+                const templateItem = document.createElement('div');
+                templateItem.className = 'p-3 bg-[var(--bg-primary)] rounded-md hover:bg-[var(--bg-tertiary)] cursor-pointer transition-colors border border-[var(--border-primary)]';
+                if (template.is_default) {
+                    templateItem.className += ' ring-2 ring-[var(--ring-focus)]';
+                }
+
+                templateItem.innerHTML = `
+                    <div class="flex items-start justify-between">
+                        <div class="flex-1">
+                            <h4 class="text-sm font-medium text-[var(--text-primary)]">${template.name}</h4>
+                            ${template.description ? `<p class="text-xs text-[var(--text-muted)] mt-1">${template.description}</p>` : ''}
+                            ${template.is_default ? `<span class="text-xs text-[var(--text-accent)] mt-1"><i class="fas fa-star mr-1"></i>${t('transcriptTemplates.default')}</span>` : ''}
+                        </div>
+                    </div>
+                `;
+
+                templateItem.addEventListener('click', () => selectTemplate(template));
+                templatesList.appendChild(templateItem);
+            });
+        }
+
+        function selectTemplate(template) {
+            currentTemplate = template;
+            isEditingTemplate = true;
+
+            // Show editor, hide empty state
+            document.getElementById('templateEditor').classList.remove('hidden');
+            document.getElementById('templateEmptyState').classList.add('hidden');
+
+            // Populate form
+            document.getElementById('templateName').value = template.name;
+            document.getElementById('templateDescription').value = template.description || '';
+            document.getElementById('templateContent').value = template.template;
+            document.getElementById('templateIsDefault').checked = template.is_default;
+
+            // Show delete button
+            document.getElementById('deleteTemplateBtn').classList.remove('hidden');
+        }
+
+        function createNewTemplate() {
+            currentTemplate = null;
+            isEditingTemplate = false;
+
+            // Show editor, hide empty state
+            document.getElementById('templateEditor').classList.remove('hidden');
+            document.getElementById('templateEmptyState').classList.add('hidden');
+
+            // Clear form
+            document.getElementById('templateForm').reset();
+
+            // Hide delete button
+            document.getElementById('deleteTemplateBtn').classList.add('hidden');
+        }
+
+        document.getElementById('createTemplateBtn')?.addEventListener('click', createNewTemplate);
+
+        document.getElementById('cancelTemplateBtn')?.addEventListener('click', () => {
+            // Hide editor, show empty state
+            document.getElementById('templateEditor').classList.add('hidden');
+            document.getElementById('templateEmptyState').classList.remove('hidden');
+            currentTemplate = null;
+            isEditingTemplate = false;
         });
-        
-        // User dropdown functionality
-        const userDropdownButton = document.getElementById('userDropdownButton');
-        const userDropdownMenu = document.getElementById('userDropdownMenu');
-        
-        userDropdownButton.addEventListener('click', () => {
-            userDropdownMenu.classList.toggle('hidden');
+
+        document.getElementById('templateForm')?.addEventListener('submit', async (e) => {
+            e.preventDefault();
+
+            const templateData = {
+                name: document.getElementById('templateName').value,
+                description: document.getElementById('templateDescription').value,
+                template: document.getElementById('templateContent').value,
+                is_default: document.getElementById('templateIsDefault').checked
+            };
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const url = isEditingTemplate ? `/api/transcript-templates/${currentTemplate.id}` : '/api/transcript-templates';
+                const method = isEditingTemplate ? 'PUT' : 'POST';
+
+                const response = await fetch(url, {
+                    method: method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify(templateData)
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to save template');
+                }
+
+                const savedTemplate = await response.json();
+
+                if (isEditingTemplate) {
+                    // Update existing template
+                    const index = templates.findIndex(t => t.id === savedTemplate.id);
+                    if (index !== -1) {
+                        templates[index] = savedTemplate;
+                    }
+                } else {
+                    // Add new template
+                    templates.push(savedTemplate);
+                }
+
+                // Update default status for other templates if needed
+                if (savedTemplate.is_default) {
+                    templates.forEach(t => {
+                        if (t.id !== savedTemplate.id) {
+                            t.is_default = false;
+                        }
+                    });
+                }
+
+                renderTemplatesList();
+                showToast(isEditingTemplate ? 'Template updated successfully' : 'Template created successfully', 'success');
+
+                // Hide editor
+                document.getElementById('templateEditor').classList.add('hidden');
+                document.getElementById('templateEmptyState').classList.remove('hidden');
+                currentTemplate = null;
+                isEditingTemplate = false;
+            } catch (error) {
+                console.error('Error saving template:', error);
+                showToast(error.message || 'Failed to save template', 'error');
+            }
         });
-        
-        // Close dropdown when clicking outside
-        document.addEventListener('click', (event) => {
-            if (!userDropdownButton.contains(event.target) && !userDropdownMenu.contains(event.target)) {
-                userDropdownMenu.classList.add('hidden');
+
+        document.getElementById('deleteTemplateBtn')?.addEventListener('click', async () => {
+            if (!currentTemplate || !confirm('Are you sure you want to delete this template?')) {
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch(`/api/transcript-templates/${currentTemplate.id}`, {
+                    method: 'DELETE',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to delete template');
+                }
+
+                // Remove from local array
+                templates = templates.filter(t => t.id !== currentTemplate.id);
+                renderTemplatesList();
+
+                // Hide editor
+                document.getElementById('templateEditor').classList.add('hidden');
+                document.getElementById('templateEmptyState').classList.remove('hidden');
+                currentTemplate = null;
+                isEditingTemplate = false;
+
+                showToast('Template deleted successfully', 'success');
+            } catch (error) {
+                console.error('Error deleting template:', error);
+                showToast('Failed to delete template', 'error');
             }
         });
-        
-        // Initialize dark mode on page load
-        initializeDarkMode();
-        
-        // Change Password Modal functionality
-        const changePasswordBtn = document.getElementById('changePasswordBtn');
-        const changePasswordModal = document.getElementById('changePasswordModal');
-        const closeModalBtn = document.getElementById('closeModalBtn');
-        const cancelBtn = document.getElementById('cancelBtn');
-        const changePasswordForm = document.getElementById('changePasswordForm');
-        const newPasswordInput = document.getElementById('new_password');
-        const confirmPasswordInput = document.getElementById('confirm_password');
-        
-        // Open modal
-        changePasswordBtn.addEventListener('click', () => {
-            changePasswordModal.classList.remove('hidden');
-            // Reset form
-            changePasswordForm.reset();
+
+        document.getElementById('createDefaultTemplatesBtn')?.addEventListener('click', async () => {
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch('/api/transcript-templates/create-defaults', {
+                    method: 'POST',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to create default templates');
+                }
+
+                const result = await response.json();
+                templates = result.templates;
+                renderTemplatesList();
+                showToast('Default templates created successfully', 'success');
+            } catch (error) {
+                console.error('Error creating default templates:', error);
+                showToast('Failed to create default templates', 'error');
+            }
         });
-        
-        // Close modal functions
-        function closeModal() {
-            changePasswordModal.classList.add('hidden');
+
+        // ============================================
+        // Templates Sub-tabs (Transcript / Export / Naming)
+        // ============================================
+        const subtabTranscript = document.getElementById('subtab-transcript');
+        const subtabExport = document.getElementById('subtab-export');
+        const subtabNaming = document.getElementById('subtab-naming');
+        const subcontentTranscript = document.getElementById('subcontent-transcript');
+        const subcontentExport = document.getElementById('subcontent-export');
+        const subcontentNaming = document.getElementById('subcontent-naming');
+
+        function switchTemplateSubtab(tab) {
+            // Reset all tabs
+            [subtabTranscript, subtabExport, subtabNaming].forEach(t => {
+                if (t) {
+                    t.classList.remove('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                    t.classList.add('border-transparent', 'text-[var(--text-muted)]');
+                }
+            });
+            // Hide all content
+            [subcontentTranscript, subcontentExport, subcontentNaming].forEach(c => {
+                if (c) c.classList.add('hidden');
+            });
+
+            if (tab === 'transcript') {
+                subtabTranscript?.classList.add('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                subtabTranscript?.classList.remove('border-transparent', 'text-[var(--text-muted)]');
+                subcontentTranscript?.classList.remove('hidden');
+            } else if (tab === 'export') {
+                subtabExport?.classList.add('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                subtabExport?.classList.remove('border-transparent', 'text-[var(--text-muted)]');
+                subcontentExport?.classList.remove('hidden');
+                loadExportTemplates();
+            } else if (tab === 'naming') {
+                subtabNaming?.classList.add('border-[var(--border-accent)]', 'text-[var(--text-accent)]');
+                subtabNaming?.classList.remove('border-transparent', 'text-[var(--text-muted)]');
+                subcontentNaming?.classList.remove('hidden');
+                loadNamingTemplates();
+            }
         }
-        
-        closeModalBtn.addEventListener('click', closeModal);
-        cancelBtn.addEventListener('click', closeModal);
-        
-        // Close modal when clicking outside
-        changePasswordModal.addEventListener('click', (event) => {
-            if (event.target === changePasswordModal) {
-                closeModal();
+
+        subtabTranscript?.addEventListener('click', () => switchTemplateSubtab('transcript'));
+        subtabExport?.addEventListener('click', () => switchTemplateSubtab('export'));
+        subtabNaming?.addEventListener('click', () => switchTemplateSubtab('naming'));
+
+        // ============================================
+        // Copy Variable Button Handler
+        // ============================================
+        document.querySelectorAll('.copy-var-btn').forEach(btn => {
+            btn.addEventListener('click', async function(e) {
+                e.preventDefault();
+                const textToCopy = this.getAttribute('data-copy');
+                try {
+                    await navigator.clipboard.writeText(textToCopy);
+                    // Visual feedback - change icon temporarily
+                    const icon = this.querySelector('i');
+                    if (icon) {
+                        icon.classList.remove('fa-copy');
+                        icon.classList.add('fa-check');
+                        icon.classList.remove('text-[var(--text-muted)]');
+                        icon.classList.add('text-green-500');
+                        setTimeout(() => {
+                            icon.classList.remove('fa-check');
+                            icon.classList.add('fa-copy');
+                            icon.classList.remove('text-green-500');
+                            icon.classList.add('text-[var(--text-muted)]');
+                        }, 1000);
+                    }
+                } catch (err) {
+                    console.error('Failed to copy:', err);
+                }
+            });
+        });
+
+        // ============================================
+        // Export Templates Management
+        // ============================================
+        let exportTemplates = [];
+        let currentExportTemplate = null;
+        let isEditingExportTemplate = false;
+        let exportTemplatesLoaded = false;
+
+        async function loadExportTemplates() {
+            if (exportTemplatesLoaded) return;
+
+            try {
+                const response = await fetch('/api/export-templates');
+                if (!response.ok) {
+                    throw new Error('Failed to load export templates');
+                }
+                exportTemplates = await response.json();
+                exportTemplatesLoaded = true;
+
+                // Show/hide create defaults button
+                if (exportTemplates.length === 0) {
+                    document.getElementById('createDefaultExportTemplatesBtn').style.display = 'block';
+                } else {
+                    document.getElementById('createDefaultExportTemplatesBtn').style.display = 'none';
+                }
+
+                renderExportTemplatesList();
+            } catch (error) {
+                console.error('Error loading export templates:', error);
+                showToast('Failed to load export templates', 'error');
+            }
+        }
+
+        function renderExportTemplatesList() {
+            const list = document.getElementById('exportTemplatesList');
+            if (!list) return;
+            list.textContent = '';
+
+            if (exportTemplates.length === 0) {
+                const emptyMsg = document.createElement('p');
+                emptyMsg.className = 'text-sm text-[var(--text-muted)] text-center py-4';
+                emptyMsg.textContent = 'No templates yet';
+                list.appendChild(emptyMsg);
+                return;
+            }
+
+            exportTemplates.forEach(template => {
+                const item = document.createElement('div');
+                item.className = 'p-3 bg-[var(--bg-primary)] rounded-md hover:bg-[var(--bg-tertiary)] cursor-pointer transition-colors border border-[var(--border-primary)]';
+                if (template.is_default) {
+                    item.className += ' ring-2 ring-[var(--ring-focus)]';
+                }
+
+                const wrapper = document.createElement('div');
+                wrapper.className = 'flex items-start justify-between';
+
+                const inner = document.createElement('div');
+                inner.className = 'flex-1';
+
+                const nameEl = document.createElement('h4');
+                nameEl.className = 'text-sm font-medium text-[var(--text-primary)]';
+                nameEl.textContent = template.name;
+                inner.appendChild(nameEl);
+
+                if (template.description) {
+                    const descEl = document.createElement('p');
+                    descEl.className = 'text-xs text-[var(--text-muted)] mt-1';
+                    descEl.textContent = template.description;
+                    inner.appendChild(descEl);
+                }
+
+                if (template.is_default) {
+                    const defaultEl = document.createElement('span');
+                    defaultEl.className = 'text-xs text-[var(--text-accent)] mt-1';
+                    const starIcon = document.createElement('i');
+                    starIcon.className = 'fas fa-star mr-1';
+                    defaultEl.appendChild(starIcon);
+                    defaultEl.appendChild(document.createTextNode(t('exportTemplates.default')));
+                    inner.appendChild(defaultEl);
+                }
+
+                wrapper.appendChild(inner);
+                item.appendChild(wrapper);
+
+                item.addEventListener('click', () => selectExportTemplate(template));
+                list.appendChild(item);
+            });
+        }
+
+        function selectExportTemplate(template) {
+            currentExportTemplate = template;
+            isEditingExportTemplate = true;
+
+            // Show editor, hide empty state
+            document.getElementById('exportTemplateEditor').classList.remove('hidden');
+            document.getElementById('exportTemplateEmptyState').classList.add('hidden');
+
+            // Populate form
+            document.getElementById('exportTemplateName').value = template.name;
+            document.getElementById('exportTemplateDescription').value = template.description || '';
+            document.getElementById('exportTemplateContent').value = template.template;
+            document.getElementById('exportTemplateIsDefault').checked = template.is_default;
+
+            // Show delete button
+            document.getElementById('deleteExportTemplateBtn').classList.remove('hidden');
+        }
+
+        function createNewExportTemplate() {
+            currentExportTemplate = null;
+            isEditingExportTemplate = false;
+
+            // Show editor, hide empty state
+            document.getElementById('exportTemplateEditor').classList.remove('hidden');
+            document.getElementById('exportTemplateEmptyState').classList.add('hidden');
+
+            // Clear form
+            document.getElementById('exportTemplateForm').reset();
+
+            // Hide delete button
+            document.getElementById('deleteExportTemplateBtn').classList.add('hidden');
+        }
+
+        document.getElementById('createExportTemplateBtn')?.addEventListener('click', createNewExportTemplate);
+
+        document.getElementById('cancelExportTemplateBtn')?.addEventListener('click', () => {
+            document.getElementById('exportTemplateEditor').classList.add('hidden');
+            document.getElementById('exportTemplateEmptyState').classList.remove('hidden');
+            currentExportTemplate = null;
+            isEditingExportTemplate = false;
+        });
+
+        document.getElementById('exportTemplateForm')?.addEventListener('submit', async (e) => {
+            e.preventDefault();
+
+            const templateData = {
+                name: document.getElementById('exportTemplateName').value,
+                description: document.getElementById('exportTemplateDescription').value,
+                template: document.getElementById('exportTemplateContent').value,
+                is_default: document.getElementById('exportTemplateIsDefault').checked
+            };
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const url = isEditingExportTemplate ? `/api/export-templates/${currentExportTemplate.id}` : '/api/export-templates';
+                const method = isEditingExportTemplate ? 'PUT' : 'POST';
+
+                const response = await fetch(url, {
+                    method: method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify(templateData)
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to save export template');
+                }
+
+                const savedTemplate = await response.json();
+
+                if (isEditingExportTemplate) {
+                    const index = exportTemplates.findIndex(t => t.id === savedTemplate.id);
+                    if (index !== -1) {
+                        exportTemplates[index] = savedTemplate;
+                    }
+                } else {
+                    exportTemplates.push(savedTemplate);
+                }
+
+                // Update default status for other templates if needed
+                if (savedTemplate.is_default) {
+                    exportTemplates.forEach(t => {
+                        if (t.id !== savedTemplate.id) {
+                            t.is_default = false;
+                        }
+                    });
+                }
+
+                renderExportTemplatesList();
+                showToast(isEditingExportTemplate ? 'Export template updated successfully' : 'Export template created successfully', 'success');
+
+                document.getElementById('exportTemplateEditor').classList.add('hidden');
+                document.getElementById('exportTemplateEmptyState').classList.remove('hidden');
+                currentExportTemplate = null;
+                isEditingExportTemplate = false;
+            } catch (error) {
+                console.error('Error saving export template:', error);
+                showToast(error.message || 'Failed to save export template', 'error');
             }
         });
-        
-        // Form validation
-        changePasswordForm.addEventListener('submit', (event) => {
-            if (newPasswordInput.value !== confirmPasswordInput.value) {
-                event.preventDefault();
-                alert('New password and confirmation do not match.');
+
+        document.getElementById('deleteExportTemplateBtn')?.addEventListener('click', async () => {
+            if (!currentExportTemplate || !confirm('Are you sure you want to delete this export template?')) {
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch(`/api/export-templates/${currentExportTemplate.id}`, {
+                    method: 'DELETE',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to delete export template');
+                }
+
+                exportTemplates = exportTemplates.filter(t => t.id !== currentExportTemplate.id);
+                renderExportTemplatesList();
+
+                document.getElementById('exportTemplateEditor').classList.add('hidden');
+                document.getElementById('exportTemplateEmptyState').classList.remove('hidden');
+                currentExportTemplate = null;
+                isEditingExportTemplate = false;
+
+                showToast('Export template deleted successfully', 'success');
+            } catch (error) {
+                console.error('Error deleting export template:', error);
+                showToast('Failed to delete export template', 'error');
+            }
+        });
+
+        document.getElementById('createDefaultExportTemplatesBtn')?.addEventListener('click', async () => {
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch('/api/export-templates/create-defaults', {
+                    method: 'POST',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to create default export template');
+                }
+
+                const result = await response.json();
+                exportTemplates = result.templates;
+                renderExportTemplatesList();
+                document.getElementById('createDefaultExportTemplatesBtn').style.display = 'none';
+                showToast('Default export template created successfully', 'success');
+            } catch (error) {
+                console.error('Error creating default export template:', error);
+                showToast('Failed to create default export template', 'error');
+            }
+        });
+
+        // ============================================
+        // Naming Templates Management
+        // ============================================
+        let namingTemplates = [];
+        let currentNamingTemplate = null;
+        let isEditingNamingTemplate = false;
+        let userDefaultNamingTemplateId = null;
+
+        async function loadNamingTemplates() {
+            try {
+                const [templatesRes, defaultRes] = await Promise.all([
+                    fetch('/api/naming-templates'),
+                    fetch('/api/naming-templates/default')
+                ]);
+
+                if (!templatesRes.ok) {
+                    throw new Error('Failed to load naming templates');
+                }
+
+                namingTemplates = await templatesRes.json();
+
+                if (defaultRes.ok) {
+                    const defaultData = await defaultRes.json();
+                    userDefaultNamingTemplateId = defaultData.default_naming_template_id;
+                }
+
+                // Show/hide create defaults button
+                if (namingTemplates.length === 0) {
+                    document.getElementById('createDefaultNamingTemplatesBtn').style.display = 'block';
+                } else {
+                    document.getElementById('createDefaultNamingTemplatesBtn').style.display = 'none';
+                }
+
+                renderNamingTemplatesList();
+                updateUserDefaultSelect();
+            } catch (error) {
+                console.error('Error loading naming templates:', error);
+                showToast('Failed to load naming templates', 'error');
+            }
+        }
+
+        function renderNamingTemplatesList() {
+            const list = document.getElementById('namingTemplatesList');
+            list.innerHTML = '';
+
+            if (namingTemplates.length === 0) {
+                list.innerHTML = '<p class="text-sm text-[var(--text-muted)] text-center py-4">No templates yet</p>';
+                return;
+            }
+
+            namingTemplates.forEach(template => {
+                const item = document.createElement('div');
+                item.className = 'p-3 bg-[var(--bg-primary)] rounded-md hover:bg-[var(--bg-tertiary)] cursor-pointer transition-colors border border-[var(--border-primary)]';
+                if (userDefaultNamingTemplateId === template.id) {
+                    item.className += ' ring-2 ring-[var(--ring-focus)]';
+                }
+
+                const nameEl = document.createElement('h4');
+                nameEl.className = 'text-sm font-medium text-[var(--text-primary)]';
+                nameEl.textContent = template.name;
+
+                const templateEl = document.createElement('p');
+                templateEl.className = 'text-xs text-[var(--text-muted)] mt-1 font-mono';
+                templateEl.textContent = template.template;
+
+                const wrapper = document.createElement('div');
+                wrapper.className = 'flex items-start justify-between';
+                const inner = document.createElement('div');
+                inner.className = 'flex-1';
+                inner.appendChild(nameEl);
+                inner.appendChild(templateEl);
+
+                if (template.description) {
+                    const descEl = document.createElement('p');
+                    descEl.className = 'text-xs text-[var(--text-muted)] mt-1';
+                    descEl.textContent = template.description;
+                    inner.appendChild(descEl);
+                }
+
+                if (userDefaultNamingTemplateId === template.id) {
+                    const defaultEl = document.createElement('span');
+                    defaultEl.className = 'text-xs text-[var(--text-accent)] mt-1';
+                    defaultEl.innerHTML = '<i class="fas fa-star mr-1"></i>Default';
+                    inner.appendChild(defaultEl);
+                }
+
+                wrapper.appendChild(inner);
+                item.appendChild(wrapper);
+
+                item.addEventListener('click', () => selectNamingTemplate(template));
+                list.appendChild(item);
+            });
+        }
+
+        function updateUserDefaultSelect() {
+            const select = document.getElementById('userDefaultNamingTemplate');
+            select.innerHTML = '<option value="">No default (AI title only)</option>';
+
+            namingTemplates.forEach(template => {
+                const option = document.createElement('option');
+                option.value = template.id;
+                option.textContent = template.name;
+                if (userDefaultNamingTemplateId === template.id) {
+                    option.selected = true;
+                }
+                select.appendChild(option);
+            });
+        }
+
+        document.getElementById('userDefaultNamingTemplate')?.addEventListener('change', async (e) => {
+            const templateId = e.target.value ? parseInt(e.target.value) : null;
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch('/api/naming-templates/default', {
+                    method: 'PUT',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify({ template_id: templateId })
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to update default template');
+                }
+
+                userDefaultNamingTemplateId = templateId;
+                renderNamingTemplatesList();
+                showToast('Default naming template updated', 'success');
+            } catch (error) {
+                console.error('Error updating default template:', error);
+                showToast('Failed to update default template', 'error');
+            }
+        });
+
+        function selectNamingTemplate(template) {
+            currentNamingTemplate = template;
+            isEditingNamingTemplate = true;
+
+            document.getElementById('namingTemplateEditor').classList.remove('hidden');
+            document.getElementById('namingTemplateEmptyState').classList.add('hidden');
+
+            document.getElementById('namingTemplateName').value = template.name;
+            document.getElementById('namingTemplateDescription').value = template.description || '';
+            document.getElementById('namingTemplateContent').value = template.template;
+
+            // Populate regex patterns
+            renderRegexPatterns(template.regex_patterns || {});
+
+            document.getElementById('deleteNamingTemplateBtn').classList.remove('hidden');
+        }
+
+        function createNewNamingTemplate() {
+            currentNamingTemplate = null;
+            isEditingNamingTemplate = false;
+
+            document.getElementById('namingTemplateEditor').classList.remove('hidden');
+            document.getElementById('namingTemplateEmptyState').classList.add('hidden');
+
+            document.getElementById('namingTemplateForm').reset();
+            renderRegexPatterns({});
+
+            document.getElementById('deleteNamingTemplateBtn').classList.add('hidden');
+        }
+
+        function renderRegexPatterns(patterns) {
+            const container = document.getElementById('regexPatternsContainer');
+            container.innerHTML = '';
+
+            Object.entries(patterns).forEach(([varName, pattern]) => {
+                addRegexPatternRow(varName, pattern);
+            });
+        }
+
+        function addRegexPatternRow(varName = '', pattern = '') {
+            const container = document.getElementById('regexPatternsContainer');
+            const row = document.createElement('div');
+            row.className = 'flex gap-2 items-center';
+
+            const varInput = document.createElement('input');
+            varInput.type = 'text';
+            varInput.placeholder = 'Variable name';
+            varInput.value = varName;
+            varInput.className = 'flex-1 px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md regex-var-name';
+
+            const patternInput = document.createElement('input');
+            patternInput.type = 'text';
+            patternInput.placeholder = 'Regex pattern';
+            patternInput.value = pattern;
+            patternInput.className = 'flex-2 px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded-md regex-pattern font-mono';
+
+            const removeBtn = document.createElement('button');
+            removeBtn.type = 'button';
+            removeBtn.className = 'text-[var(--text-danger)] hover:text-[var(--text-danger-hover)] remove-regex-btn';
+            removeBtn.innerHTML = '<i class="fas fa-times"></i>';
+            removeBtn.addEventListener('click', () => row.remove());
+
+            row.appendChild(varInput);
+            row.appendChild(patternInput);
+            row.appendChild(removeBtn);
+            container.appendChild(row);
+        }
+
+        document.getElementById('addRegexPatternBtn')?.addEventListener('click', () => addRegexPatternRow());
+
+        document.getElementById('createNamingTemplateBtn')?.addEventListener('click', createNewNamingTemplate);
+
+        document.getElementById('cancelNamingTemplateBtn')?.addEventListener('click', () => {
+            document.getElementById('namingTemplateEditor').classList.add('hidden');
+            document.getElementById('namingTemplateEmptyState').classList.remove('hidden');
+            currentNamingTemplate = null;
+            isEditingNamingTemplate = false;
+        });
+
+        document.getElementById('namingTemplateForm')?.addEventListener('submit', async (e) => {
+            e.preventDefault();
+
+            // Collect regex patterns
+            const regexPatterns = {};
+            document.querySelectorAll('#regexPatternsContainer > div').forEach(row => {
+                const varName = row.querySelector('.regex-var-name').value.trim();
+                const pattern = row.querySelector('.regex-pattern').value.trim();
+                if (varName && pattern) {
+                    regexPatterns[varName] = pattern;
+                }
+            });
+
+            const templateData = {
+                name: document.getElementById('namingTemplateName').value,
+                description: document.getElementById('namingTemplateDescription').value,
+                template: document.getElementById('namingTemplateContent').value,
+                regex_patterns: regexPatterns
+            };
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const url = isEditingNamingTemplate ? `/api/naming-templates/${currentNamingTemplate.id}` : '/api/naming-templates';
+                const method = isEditingNamingTemplate ? 'PUT' : 'POST';
+
+                const response = await fetch(url, {
+                    method: method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify(templateData)
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to save naming template');
+                }
+
+                const savedTemplate = await response.json();
+
+                if (isEditingNamingTemplate) {
+                    const index = namingTemplates.findIndex(t => t.id === savedTemplate.id);
+                    if (index !== -1) {
+                        namingTemplates[index] = savedTemplate;
+                    }
+                } else {
+                    namingTemplates.push(savedTemplate);
+                }
+
+                renderNamingTemplatesList();
+                updateUserDefaultSelect();
+                showToast(isEditingNamingTemplate ? 'Naming template updated' : 'Naming template created', 'success');
+
+                document.getElementById('namingTemplateEditor').classList.add('hidden');
+                document.getElementById('namingTemplateEmptyState').classList.remove('hidden');
+                currentNamingTemplate = null;
+                isEditingNamingTemplate = false;
+            } catch (error) {
+                console.error('Error saving naming template:', error);
+                showToast(error.message || 'Failed to save naming template', 'error');
+            }
+        });
+
+        document.getElementById('deleteNamingTemplateBtn')?.addEventListener('click', async () => {
+            if (!currentNamingTemplate || !confirm('Are you sure you want to delete this naming template?')) {
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch(`/api/naming-templates/${currentNamingTemplate.id}`, {
+                    method: 'DELETE',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to delete naming template');
+                }
+
+                namingTemplates = namingTemplates.filter(t => t.id !== currentNamingTemplate.id);
+
+                if (userDefaultNamingTemplateId === currentNamingTemplate.id) {
+                    userDefaultNamingTemplateId = null;
+                }
+
+                renderNamingTemplatesList();
+                updateUserDefaultSelect();
+
+                document.getElementById('namingTemplateEditor').classList.add('hidden');
+                document.getElementById('namingTemplateEmptyState').classList.remove('hidden');
+                currentNamingTemplate = null;
+                isEditingNamingTemplate = false;
+
+                showToast('Naming template deleted', 'success');
+            } catch (error) {
+                console.error('Error deleting naming template:', error);
+                showToast(error.message || 'Failed to delete naming template', 'error');
+            }
+        });
+
+        document.getElementById('createDefaultNamingTemplatesBtn')?.addEventListener('click', async () => {
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch('/api/naming-templates/create-defaults', {
+                    method: 'POST',
+                    headers: {
+                        'X-CSRFToken': csrfToken
+                    }
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to create default naming templates');
+                }
+
+                const result = await response.json();
+                namingTemplates = result.templates;
+                renderNamingTemplatesList();
+                updateUserDefaultSelect();
+                showToast('Default naming templates created', 'success');
+            } catch (error) {
+                console.error('Error creating default naming templates:', error);
+                showToast('Failed to create default naming templates', 'error');
+            }
+        });
+
+        document.getElementById('testNamingTemplateBtn')?.addEventListener('click', async () => {
+            const templateId = currentNamingTemplate?.id;
+            const testFilename = document.getElementById('testFilename').value || 'sample-file.mp3';
+
+            if (!templateId) {
+                showToast('Save the template first to test it', 'info');
+                return;
+            }
+
+            try {
+                const csrfToken = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content');
+                const response = await fetch(`/api/naming-templates/${templateId}/test`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-CSRFToken': csrfToken
+                    },
+                    body: JSON.stringify({ filename: testFilename, ai_title: 'Sample AI Title' })
+                });
+
+                if (!response.ok) {
+                    throw new Error('Failed to test template');
+                }
+
+                const result = await response.json();
+                document.getElementById('testResult').classList.remove('hidden');
+                document.getElementById('testResultText').textContent = result.result;
+            } catch (error) {
+                console.error('Error testing template:', error);
+                showToast('Failed to test template', 'error');
             }
         });
+
+        function showToast(message, type = 'info') {
+            // Simple toast notification
+            const toast = document.createElement('div');
+            toast.className = `fixed top-4 right-4 px-4 py-2 rounded-md text-white z-50 ${
+                type === 'success' ? 'bg-green-600' :
+                type === 'error' ? 'bg-red-600' :
+                'bg-blue-600'
+            }`;
+            toast.style.cursor = 'pointer';
+            toast.textContent = message;
+            document.body.appendChild(toast);
+
+            // Function to dismiss the toast
+            const dismissToast = () => {
+                if (toast.parentNode) {
+                    toast.remove();
+                }
+            };
+
+            // Add click handler to dismiss toast
+            toast.addEventListener('click', () => {
+                clearTimeout(timeoutId);
+                dismissToast();
+            });
+
+            // Auto-dismiss after 3 seconds
+            const timeoutId = setTimeout(dismissToast, 3000);
+        }
+    });
     </script>
+
 </body>
 </html>
diff --git a/templates/admin.html b/templates/admin.html
index e61932a3..292b0b12 100644
--- a/templates/admin.html
+++ b/templates/admin.html
@@ -3,131 +3,152 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Admin Dashboard - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>{% if is_group_admin_only %}Group Management{% else %}Admin Dashboard{% endif %} - Speakr</title>
+
+    <!-- Loading overlay to prevent FOUC - MUST be first -->
+    {% include 'includes/loading_overlay.html' %}
+
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
     <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
+        /* Hide Vue content until compiled */
+        [v-cloak] {
+            display: none !important;
+        }
+
+        /* Hide scrollbar for tabs */
+        .scrollbar-hide {
+            -ms-overflow-style: none;
+            scrollbar-width: none;
+        }
+        .scrollbar-hide::-webkit-scrollbar {
+            display: none;
         }
 
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
+        /* Custom select dropdown styling */
+        select {
+            appearance: none;
+            -webkit-appearance: none;
+            -moz-appearance: none;
+            padding-right: 2.5rem !important;
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23666' d='M6 9L1 4h10z'/%3E%3C/svg%3E");
+            background-repeat: no-repeat;
+            background-position: right 0.75rem center;
+            background-size: 12px 12px;
         }
 
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+        .dark select {
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23aaa' d='M6 9L1 4h10z'/%3E%3C/svg%3E");
         }
-        html, body { height: 100%; margin: 0; }
-        .custom-scrollbar::-webkit-scrollbar { width: 6px; }
-        .custom-scrollbar::-webkit-scrollbar-track { background: var(--scrollbar-track); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); }
     </style>
+    <script>
+        // Initialize i18n
+        let t = (key) => key; // Default fallback
+        
+        async function initializeI18n() {
+            const userLanguage = "{{ user_language }}";
+            
+            // Initialize the global i18n instance
+            if (window.i18n) {
+                await window.i18n.init(userLanguage);
+                
+                // Create a shorthand translation function
+                t = (key, params) => window.i18n.t(key, params);
+                
+                // Update all elements with data-i18n attribute
+                document.querySelectorAll('[data-i18n]').forEach(el => {
+                    const key = el.getAttribute('data-i18n');
+                    el.textContent = t(key);
+                });
+                
+                // Update all elements with data-i18n-placeholder attribute
+                document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
+                    const key = el.getAttribute('data-i18n-placeholder');
+                    el.placeholder = t(key);
+                });
+            }
+        }
+        
+        // Function to apply the theme based on localStorage
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
+
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
 </head>
 <body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div id="app" class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+    <div id="app" v-cloak class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
         <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
             <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/icon-192x192.png') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
             </h1>
             <div class="flex items-center space-x-2">
                 <button @click="toggleDarkMode" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isDarkMode ? 'Switch to Light Mode' : 'Switch to Dark Mode'">
                     <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
                 </button>
-                <div class="relative" @click.away="isDropdownOpen = false">
-                    <button @click="isDropdownOpen = !isDropdownOpen" class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
-                        <i class="fas fa-user-shield mr-2"></i>
+                <div class="relative">
+                    <button @click="isUserMenuOpen = !isUserMenuOpen"
+                            data-user-menu-toggle
+                            class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
+                        <i :class="isTeamAdminOnly ? 'fas fa-users-cog mr-2' : 'fas fa-user-shield mr-2'"></i>
                         <span>{{ current_user.username }}</span>
                         <i class="fas fa-chevron-down ml-2"></i>
                     </button>
-                    <div v-show="isDropdownOpen" class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-home mr-2"></i> Home
+                    <div v-if="isUserMenuOpen"
+                         data-user-menu-dropdown
+                         class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
+                        <a href="{{ url_for('recordings.index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas fa-home mr-2"></i> ${t('nav.home')}
                         </a>
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user mr-2"></i> Account
+                        <a href="{{ url_for('auth.account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas fa-user mr-2"></i> ${t('nav.account')}
                         </a>
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
+                        <a href="{{ url_for('admin.admin') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
+                            <i :class="isTeamAdminOnly ? 'fas fa-users-cog mr-2' : 'fas fa-user-shield mr-2'"></i>
+                            <span v-text="isTeamAdminOnly ? t('nav.groupManagement') : t('nav.admin')"></span>
                         </a>
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
+                        <a href="{{ url_for('auth.logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
+                            <i class="fas fa-sign-out-alt mr-2"></i> ${t('nav.signOut')}
                         </a>
                     </div>
                 </div>
@@ -135,8 +156,8 @@ <h1 class="text-3xl font-bold text-[var(--text-primary)]">
         </header>
 
         <main class="flex-grow">
-            <div class="bg-[var(--bg-secondary)] p-6 rounded-xl shadow-lg border border-[var(--border-primary)]">
-                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Admin Dashboard</h2>
+            <div class="bg-[var(--bg-secondary)] p-4 sm:p-6 lg:p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6" v-text="isTeamAdminOnly ? t('nav.groupManagement') : t('nav.adminDashboard')"></h2>
                 
                 {% with messages = get_flashed_messages(with_categories=true) %}
                     {% if messages %}
@@ -150,33 +171,64 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Admin Dashboa
                 
                 <!-- Tabs -->
                 <div class="border-b border-[var(--border-primary)] mb-6">
-                    <nav class="-mb-px flex space-x-8" aria-label="Tabs">
-                        <button @click="activeTab = 'users'" 
-                                :class="activeTab === 'users' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                class="whitespace-nowrap py-4 px-1 border-b-2 font-medium text-sm">
-                            <i class="fas fa-users mr-2"></i> User Management
-                        </button>
-                        <button @click="activeTab = 'stats'" 
-                                :class="activeTab === 'stats' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                class="whitespace-nowrap py-4 px-1 border-b-2 font-medium text-sm">
-                            <i class="fas fa-chart-bar mr-2"></i> System Statistics
-                        </button>
-                    </nav>
+                    <div class="relative">
+                        <!-- Scroll gradient indicators -->
+                        <div class="absolute left-0 top-0 bottom-0 w-12 bg-gradient-to-r from-[var(--bg-secondary)] to-transparent z-[1] pointer-events-none opacity-0 transition-opacity duration-200 flex items-center justify-start" id="admin-left-scroll-indicator">
+                            <i class="fas fa-chevron-left text-[var(--text-muted)] ml-1"></i>
+                        </div>
+                        <div class="absolute right-0 top-0 bottom-0 w-12 bg-gradient-to-l from-[var(--bg-secondary)] to-transparent z-[1] pointer-events-none opacity-100 transition-opacity duration-200 flex items-center justify-end" id="admin-right-scroll-indicator">
+                            <i class="fas fa-chevron-right text-[var(--text-muted)] mr-1"></i>
+                        </div>
+                        <nav class="tab-nav px-1 sm:px-4 lg:px-6 pt-3 sm:pt-4 lg:pt-6 pb-4 sm:pb-6 -mb-px overflow-x-auto scrollbar-hide" aria-label="Tabs" id="admin-tabs-container">
+                            <div class="inline-flex gap-1 sm:gap-2">
+                                <button v-if="!isTeamAdminOnly" @click="activeTab = 'users'"
+                                        :class="activeTab === 'users' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-users mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.userManagement')}</span>
+                                </button>
+                                <button v-if="!isTeamAdminOnly" @click="activeTab = 'stats'"
+                                        :class="activeTab === 'stats' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-chart-bar mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.systemStatistics')}</span>
+                                </button>
+                                <button v-if="!isTeamAdminOnly" @click="activeTab = 'settings'"
+                                        :class="activeTab === 'settings' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-cogs mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.systemSettings')}</span>
+                                </button>
+                                <button v-if="!isTeamAdminOnly" @click="activeTab = 'prompts'"
+                                        :class="activeTab === 'prompts' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-file-alt mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.defaultPrompts')}</span>
+                                </button>
+                                <button @click="activeTab = 'groups'"
+                                        :class="activeTab === 'groups' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-users-cog mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.groupsTab')}</span>
+                                </button>
+                                <button v-if="!isTeamAdminOnly && inquireModeEnabled" @click="activeTab = 'vectorstore'"
+                                        :class="activeTab === 'vectorstore' ? 'border-[var(--border-accent)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
+                                        class="inline-flex items-center whitespace-nowrap py-1 px-1.5 sm:py-3 sm:px-3 border-b-2 font-medium text-xs sm:text-sm rounded-t-md sm:rounded-t-lg hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-database mr-0.5 sm:mr-2 text-xs sm:text-sm"></i><span>${t('adminDashboard.vectorStore')}</span>
+                                </button>
+                            </div>
+                        </nav>
+                    </div>
                 </div>
                 
                 <!-- User Management Tab -->
                 <div v-show="activeTab === 'users'">
                     <div class="flex justify-between items-center mb-4">
-                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">User Management</h3>
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">${t('adminDashboard.userManagement')}</h3>
                         <button @click="showAddUserModal = true" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                            <i class="fas fa-user-plus mr-2"></i> Add User
+                            <i class="fas fa-user-plus mr-2"></i> ${t('adminDashboard.addUser')}
                         </button>
                     </div>
                     
                     <!-- Search and Filter -->
                     <div class="mb-4 flex">
                         <div class="relative flex-grow">
-                            <input type="text" v-model="userSearchQuery" placeholder="Search users..." class="w-full px-4 py-2 border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <input type="text" v-model="userSearchQuery" :placeholder="t('adminDashboard.searchUsers')" class="w-full px-4 py-2 border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                             <button v-if="userSearchQuery" @click="userSearchQuery = ''" class="absolute right-3 top-2.5 text-[var(--text-muted)] hover:text-[var(--text-secondary)]">
                                 <i class="fas fa-times"></i>
                             </button>
@@ -188,13 +240,14 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)]">User Management</h3
                         <table class="min-w-full divide-y divide-[var(--border-primary)]">
                             <thead class="bg-[var(--bg-tertiary)]">
                                 <tr>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">ID</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Username</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Email</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Admin</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Recordings</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Storage Used</th>
-                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Actions</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.id')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.username')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.email')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.admin')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.publicShare')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.recordings')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.storageUsed')}</th>
+                                    <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.actions')}</th>
                                 </tr>
                             </thead>
                             <tbody class="bg-[var(--bg-secondary)] divide-y divide-[var(--border-primary)]">
@@ -203,27 +256,39 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)]">User Management</h3
                                     <td class="px-6 py-4 whitespace-nowrap text-sm font-medium text-[var(--text-primary)]">${ user.username }</td>
                                     <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ user.email }</td>
                                     <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">
-                                        <span v-if="user.is_admin" class="px-2 inline-flex text-xs leading-5 font-semibold rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">Yes</span>
-                                        <span v-else class="px-2 inline-flex text-xs leading-5 font-semibold rounded-full bg-[var(--bg-pending-light)] text-[var(--text-pending-strong)]">No</span>
+                                        <span v-if="user.is_admin" class="px-2 inline-flex items-center text-xs leading-5 font-semibold rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">Yes</span>
+                                        <span v-else class="px-2 inline-flex items-center text-xs leading-5 font-semibold rounded-full bg-[var(--bg-pending-light)] text-[var(--text-pending-strong)]">No</span>
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">
+                                        <button @click="togglePublicSharingPermission(user)"
+                                                class="inline-flex items-center"
+                                                :title="user.can_share_publicly ? 'Revoke public sharing permission' : 'Grant public sharing permission'">
+                                            <span v-if="user.can_share_publicly" class="px-2 inline-flex items-center text-xs leading-5 font-semibold rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">
+                                                <i class="fas fa-check mr-1"></i> ${t('adminDashboard.allowed')}
+                                            </span>
+                                            <span v-else class="px-2 inline-flex items-center text-xs leading-5 font-semibold rounded-full bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]">
+                                                <i class="fas fa-times mr-1"></i> ${t('adminDashboard.blocked')}
+                                            </span>
+                                        </button>
                                     </td>
                                     <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ user.recordings_count }</td>
                                     <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">${ formatFileSize(user.storage_used) }</td>
                                     <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-secondary)]">
                                         <div class="flex space-x-2">
-                                            <button @click="editUser(user)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]" title="Edit User">
+                                            <button @click="editUser(user)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]" :title="t('buttons.editUser')">
                                                 <i class="fas fa-edit"></i>
                                             </button>
                                             <button @click="toggleAdminStatus(user)" :class="user.is_admin ? 'text-[var(--text-warn-strong)]' : 'text-[var(--text-info-strong)]'" :title="user.is_admin ? 'Remove Admin' : 'Make Admin'">
                                                 <i class="fas" :class="user.is_admin ? 'fa-user-minus' : 'fa-user-shield'"></i>
                                             </button>
-                                            <button @click="confirmDeleteUser(user)" class="text-[var(--text-danger)] hover:text-[var(--text-danger-hover)]" title="Delete User">
+                                            <button @click="confirmDeleteUser(user)" class="text-[var(--text-danger)] hover:text-[var(--text-danger-hover)]" :title="t('buttons.deleteUser')">
                                                 <i class="fas fa-trash"></i>
                                             </button>
                                         </div>
                                     </td>
                                 </tr>
                                 <tr v-if="filteredUsers.length === 0">
-                                    <td colspan="7" class="px-6 py-4 text-center text-sm text-[var(--text-muted)]">
+                                    <td colspan="8" class="px-6 py-4 text-center text-sm text-[var(--text-muted)]">
                                         <div v-if="isLoadingUsers">
                                             <i class="fas fa-spinner fa-spin mr-2"></i> Loading users...
                                         </div>
@@ -239,7 +304,7 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)]">User Management</h3
                 
                 <!-- System Statistics Tab -->
                 <div v-show="activeTab === 'stats'">
-                    <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statistics</h3>
+                    <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">${t('adminDashboard.systemStatistics')}</h3>
                     
                     <!-- Summary Cards -->
                     <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4 mb-6">
@@ -249,7 +314,7 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statist
                                     <i class="fas fa-users text-xl"></i>
                                 </div>
                                 <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Users</p>
+                                    <p class="text-sm font-medium text-[var(--text-muted)]">${t('adminDashboard.totalUsers')}</p>
                                     <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_users }</p>
                                 </div>
                             </div>
@@ -261,7 +326,7 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statist
                                     <i class="fas fa-file-audio text-xl"></i>
                                 </div>
                                 <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Recordings</p>
+                                    <p class="text-sm font-medium text-[var(--text-muted)]">${t('adminDashboard.totalRecordings')}</p>
                                     <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_recordings }</p>
                                 </div>
                             </div>
@@ -273,7 +338,7 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statist
                                     <i class="fas fa-database text-xl"></i>
                                 </div>
                                 <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Storage Used</p>
+                                    <p class="text-sm font-medium text-[var(--text-muted)]">${t('adminDashboard.totalStorage')}</p>
                                     <p class="text-2xl font-semibold text-[var(--text-primary)]">${ formatFileSize(stats.total_storage) }</p>
                                 </div>
                             </div>
@@ -285,7 +350,7 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statist
                                     <i class="fas fa-comments text-xl"></i>
                                 </div>
                                 <div class="ml-4">
-                                    <p class="text-sm font-medium text-[var(--text-muted)]">Total Queries</p>
+                                    <p class="text-sm font-medium text-[var(--text-muted)]">${t('adminDashboard.totalQueries')}</p>
                                     <p class="text-2xl font-semibold text-[var(--text-primary)]">${ stats.total_queries }</p>
                                 </div>
                             </div>
@@ -295,29 +360,29 @@ <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">System Statist
                     <!-- Status Distribution -->
                     <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-6">
                         <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Recording Status Distribution</h4>
+                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">${t('adminDashboard.recordingStatusDistribution')}</h4>
                             <div class="grid grid-cols-2 gap-4">
                                 <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
                                     <span class="block text-2xl font-bold text-[var(--text-success-strong)]">${ stats.completed_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Completed</span>
+                                    <span class="block text-sm text-[var(--text-muted)]">${t('adminDashboard.completedRecordings')}</span>
                                 </div>
                                 <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
                                     <span class="block text-2xl font-bold text-[var(--text-warn-strong)]">${ stats.processing_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Processing</span>
+                                    <span class="block text-sm text-[var(--text-muted)]">${t('adminDashboard.processingRecordings')}</span>
                                 </div>
                                 <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
                                     <span class="block text-2xl font-bold text-[var(--text-pending-strong)]">${ stats.pending_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Pending</span>
+                                    <span class="block text-sm text-[var(--text-muted)]">${t('adminDashboard.pendingRecordings')}</span>
                                 </div>
                                 <div class="text-center p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] shadow-sm">
                                     <span class="block text-2xl font-bold text-[var(--text-danger-strong)]">${ stats.failed_recordings }</span>
-                                    <span class="block text-sm text-[var(--text-muted)]">Failed</span>
+                                    <span class="block text-sm text-[var(--text-muted)]">${t('adminDashboard.failedRecordings')}</span>
                                 </div>
                             </div>
                         </div>
                         
                         <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
-                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Top Users by Storage</h4>
+                            <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">${t('adminDashboard.topUsersByStorage')}</h4>
                             <div class="space-y-3">
                                 <div v-for="user in stats.top_users" :key="user.id" class="flex justify-between items-center p-2 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
                                     <div class="flex items-center">
@@ -335,6 +400,829 @@ <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Top Users by S
                             </div>
                         </div>
                     </div>
+
+                    <!-- Token Usage Section -->
+                    <div class="mt-6">
+                        <h4 class="text-lg font-medium text-[var(--text-secondary)] mb-4">
+                            <i class="fas fa-coins mr-2"></i> Token Usage Statistics
+                        </h4>
+
+                        <!-- Token Stats and Per-User Usage Side by Side -->
+                        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-6">
+                            <!-- Token Usage Summary Cards (LLM and Embedding tracked separately) -->
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Usage Summary</h5>
+
+                                <!-- LLM bucket (chat, summarization, title, etc.) -->
+                                <div class="mb-3">
+                                    <p class="text-xs uppercase tracking-wide text-[var(--text-muted)] mb-2"><i class="fas fa-robot mr-1"></i> LLM</p>
+                                    <div class="grid grid-cols-3 gap-3">
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">Today</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">${ (tokenStats.today?.llm_tokens || 0).toLocaleString() }</p>
+                                        </div>
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">This Month</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">${ (tokenStats.current_month?.llm_tokens || 0).toLocaleString() }</p>
+                                        </div>
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">Monthly Cost</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">$${ (tokenStats.current_month?.llm_cost || 0).toFixed(4) }</p>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Embedding bucket -->
+                                <div class="mb-3">
+                                    <p class="text-xs uppercase tracking-wide text-[var(--text-muted)] mb-2"><i class="fas fa-vector-square mr-1"></i> Embeddings</p>
+                                    <div class="grid grid-cols-3 gap-3">
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">Today</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">${ (tokenStats.today?.embedding_tokens || 0).toLocaleString() }</p>
+                                        </div>
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">This Month</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">${ (tokenStats.current_month?.embedding_tokens || 0).toLocaleString() }</p>
+                                        </div>
+                                        <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                            <p class="text-xs text-[var(--text-muted)]">Monthly Cost</p>
+                                            <p class="text-lg font-semibold text-[var(--text-primary)]">$${ (tokenStats.current_month?.embedding_cost || 0).toFixed(4) }</p>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Budget warnings -->
+                                <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                    <div class="flex items-center">
+                                        <div class="p-2 rounded-full" :class="tokenStats.users_at_100_percent > 0 ? 'bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]' : 'bg-[var(--bg-accent)] text-[var(--text-accent)]'">
+                                            <i class="fas fa-exclamation-triangle"></i>
+                                        </div>
+                                        <div class="ml-3">
+                                            <p class="text-xs text-[var(--text-muted)]">Budget Warnings</p>
+                                            <p class="text-sm font-semibold">
+                                                <span v-if="tokenStats.users_at_100_percent > 0" class="text-[var(--text-danger-strong)]">${ tokenStats.users_at_100_percent } blocked</span>
+                                                <span v-else-if="tokenStats.users_over_80_percent > 0" class="text-[var(--text-warn-strong)]">${ tokenStats.users_over_80_percent } warning</span>
+                                                <span v-else class="text-[var(--text-success-strong)]">None</span>
+                                            </p>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Operation breakdown for the current month -->
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm lg:col-span-2">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Tokens by Operation (This Month)</h5>
+                                <div v-if="(tokenStats.current_month?.by_operation || []).length === 0" class="text-sm text-[var(--text-muted)]">
+                                    No usage recorded yet this month.
+                                </div>
+                                <div v-else class="grid grid-cols-2 md:grid-cols-4 gap-3">
+                                    <div v-for="op in (tokenStats.current_month?.by_operation || [])"
+                                         :key="op.operation_type"
+                                         class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <p class="text-xs text-[var(--text-muted)] capitalize">${ op.operation_type.replace('_', ' ') }</p>
+                                        <p class="text-base font-semibold text-[var(--text-primary)]">${ op.tokens.toLocaleString() }</p>
+                                        <p class="text-xs text-[var(--text-muted)]">
+                                            ${ op.requests } req<span v-if="op.cost > 0"> · $${ op.cost.toFixed(4) }</span>
+                                        </p>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Per-User Token Usage -->
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">User Token Usage (This Month)</h5>
+                                <div class="space-y-2 max-h-48 overflow-y-auto">
+                                    <div v-for="user in tokenUserStats" :key="user.user_id" class="p-2 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex justify-between items-center">
+                                            <div class="flex items-center">
+                                                <i class="fas fa-user text-[var(--text-accent)] mr-2 text-xs"></i>
+                                                <span class="text-sm font-medium text-[var(--text-primary)]">${ user.username }</span>
+                                            </div>
+                                            <div class="text-sm text-right">
+                                                <span class="font-semibold" :class="{
+                                                    'text-[var(--text-danger-strong)]': user.percentage >= 100,
+                                                    'text-[var(--text-warn-strong)]': user.percentage >= 80 && user.percentage < 100,
+                                                    'text-[var(--text-primary)]': !user.monthly_budget || user.percentage < 80
+                                                }">${ user.current_usage?.toLocaleString() || 0 }</span>
+                                                <span v-if="user.monthly_budget" class="text-[var(--text-muted)] text-xs"> / ${ user.monthly_budget?.toLocaleString() }</span>
+                                                <span v-else class="text-[var(--text-muted)] text-xs ml-1">(unlimited)</span>
+                                            </div>
+                                        </div>
+                                        <div v-if="user.monthly_budget" class="mt-1.5">
+                                            <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-1">
+                                                <div class="h-1 rounded-full transition-all"
+                                                    :class="{
+                                                        'bg-[var(--text-danger-strong)]': user.percentage >= 100,
+                                                        'bg-[var(--text-warn-strong)]': user.percentage >= 80 && user.percentage < 100,
+                                                        'bg-[var(--text-success-strong)]': user.percentage < 80
+                                                    }"
+                                                    :style="{width: Math.min(user.percentage || 0, 100) + '%'}">
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <div v-if="tokenUserStats.length === 0" class="text-center text-sm text-[var(--text-muted)] p-4">
+                                        No token usage data available
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Token Usage Charts (LLM and Embeddings shown separately) -->
+                        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Daily LLM Tokens (Last 30 Days)</h5>
+                                <div class="h-64"><canvas id="dailyTokenChart"></canvas></div>
+                            </div>
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Daily Embedding Tokens (Last 30 Days)</h5>
+                                <div class="h-64"><canvas id="dailyEmbeddingChart"></canvas></div>
+                            </div>
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Monthly LLM Tokens (Last 12 Months)</h5>
+                                <div class="h-64"><canvas id="monthlyTokenChart"></canvas></div>
+                            </div>
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Monthly Embedding Tokens (Last 12 Months)</h5>
+                                <div class="h-64"><canvas id="monthlyEmbeddingChart"></canvas></div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Transcription Usage Section -->
+                    <div class="mt-8">
+                        <h4 class="text-lg font-medium text-[var(--text-secondary)] mb-4">
+                            <i class="fas fa-microphone mr-2"></i>${t('adminDashboard.transcriptionUsage')}
+                        </h4>
+
+                        <!-- Transcription Stats and Per-User Usage Side by Side -->
+                        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+                            <!-- Transcription Usage Summary Cards (2x2 grid) -->
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">Usage Summary</h5>
+                                <div class="grid grid-cols-2 gap-3">
+                                    <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex items-center">
+                                            <div class="p-2 rounded-full bg-[var(--bg-info-light)] text-[var(--text-info-strong)]">
+                                                <i class="fas fa-calendar-day"></i>
+                                            </div>
+                                            <div class="ml-3">
+                                                <p class="text-xs text-[var(--text-muted)]">${t('adminDashboard.todaysMinutes')}</p>
+                                                <p class="text-lg font-semibold text-[var(--text-primary)]">${ transcriptionStats.today?.minutes || 0 }</p>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex items-center">
+                                            <div class="p-2 rounded-full bg-[var(--bg-success-light)] text-[var(--text-success-strong)]">
+                                                <i class="fas fa-calendar-alt"></i>
+                                            </div>
+                                            <div class="ml-3">
+                                                <p class="text-xs text-[var(--text-muted)]">${t('adminDashboard.thisMonth')}</p>
+                                                <p class="text-lg font-semibold text-[var(--text-primary)]">${ transcriptionStats.current_month?.minutes || 0 } min</p>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex items-center">
+                                            <div class="p-2 rounded-full bg-[var(--bg-warn-light)] text-[var(--text-warn-strong)]">
+                                                <i class="fas fa-dollar-sign"></i>
+                                            </div>
+                                            <div class="ml-3">
+                                                <p class="text-xs text-[var(--text-muted)]">${t('adminDashboard.monthlyCost')}</p>
+                                                <p class="text-lg font-semibold text-[var(--text-primary)]">$${ (transcriptionStats.current_month?.cost || 0).toFixed(4) }</p>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <div class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex items-center">
+                                            <div class="p-2 rounded-full" :class="transcriptionStats.users_at_100_percent > 0 ? 'bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]' : 'bg-[var(--bg-accent)] text-[var(--text-accent)]'">
+                                                <i class="fas fa-exclamation-triangle"></i>
+                                            </div>
+                                            <div class="ml-3">
+                                                <p class="text-xs text-[var(--text-muted)]">${t('adminDashboard.budgetWarnings')}</p>
+                                                <p class="text-lg font-semibold">
+                                                    <span v-if="transcriptionStats.users_at_100_percent > 0" class="text-[var(--text-danger-strong)]">${ transcriptionStats.users_at_100_percent } ${t('adminDashboard.blocked')}</span>
+                                                    <span v-else-if="transcriptionStats.users_over_80_percent > 0" class="text-[var(--text-warn-strong)]">${ transcriptionStats.users_over_80_percent } ${t('adminDashboard.warning')}</span>
+                                                    <span v-else class="text-[var(--text-success-strong)]">${t('adminDashboard.none')}</span>
+                                                </p>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Per-User Transcription Usage -->
+                            <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                                <h5 class="text-md font-medium text-[var(--text-secondary)] mb-3">${t('adminDashboard.userTranscriptionUsage')}</h5>
+                                <div class="space-y-2 max-h-48 overflow-y-auto">
+                                    <div v-for="user in transcriptionUserStats" :key="user.user_id" class="p-2 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)]">
+                                        <div class="flex justify-between items-center">
+                                            <div class="flex items-center">
+                                                <i class="fas fa-user text-[var(--text-accent)] mr-2 text-xs"></i>
+                                                <span class="text-sm font-medium text-[var(--text-primary)]">${ user.username }</span>
+                                            </div>
+                                            <div class="text-sm text-right">
+                                                <span class="font-semibold" :class="{
+                                                    'text-[var(--text-danger-strong)]': user.percentage >= 100,
+                                                    'text-[var(--text-warn-strong)]': user.percentage >= 80 && user.percentage < 100,
+                                                    'text-[var(--text-primary)]': !user.monthly_budget_minutes || user.percentage < 80
+                                                }">${ user.current_usage_minutes || 0 } min</span>
+                                                <span v-if="user.monthly_budget_minutes" class="text-[var(--text-muted)] text-xs"> / ${ user.monthly_budget_minutes } min</span>
+                                                <span v-else class="text-[var(--text-muted)] text-xs ml-1">(unlimited)</span>
+                                            </div>
+                                        </div>
+                                        <div v-if="user.monthly_budget_minutes" class="mt-1.5">
+                                            <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-1">
+                                                <div class="h-1 rounded-full transition-all"
+                                                    :class="{
+                                                        'bg-[var(--text-danger-strong)]': user.percentage >= 100,
+                                                        'bg-[var(--text-warn-strong)]': user.percentage >= 80 && user.percentage < 100,
+                                                        'bg-[var(--text-success-strong)]': user.percentage < 80
+                                                    }"
+                                                    :style="{width: Math.min(user.percentage || 0, 100) + '%'}">
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <div v-if="transcriptionUserStats.length === 0" class="text-center text-sm text-[var(--text-muted)] p-4">
+                                        ${t('adminDashboard.noTranscriptionData')}
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- System Settings Tab -->
+                <div v-show="activeTab === 'settings'">
+                    <div class="flex justify-between items-center mb-4">
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">${t('adminDashboard.systemSettings')}</h3>
+                        <button @click="loadSettings" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
+                            <i class="fas fa-sync-alt mr-2"></i> ${t('buttons.refresh')}
+                        </button>
+                    </div>
+
+                    <!-- Transcription Models curation -->
+                    <div class="mb-6 bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                        <div class="flex justify-between items-start mb-3">
+                            <div>
+                                <h4 class="text-md font-semibold text-[var(--text-primary)]"><i class="fas fa-microphone-lines mr-2"></i>Transcription Models</h4>
+                                <p class="text-sm text-[var(--text-muted)] mt-1">Discover models on the active transcription provider, then choose which ones users can pick from at upload time. Saved choices override <code>TRANSCRIPTION_MODELS_AVAILABLE</code> in the environment.</p>
+                            </div>
+                            <button @click="discoverTranscriptionModels" :disabled="discoveringModels"
+                                    class="px-3 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded-lg shadow hover:bg-[var(--bg-tertiary)] disabled:opacity-50">
+                                <i :class="discoveringModels ? 'fas fa-spinner fa-spin' : 'fas fa-search'" class="mr-2"></i>
+                                ${ discoveringModels ? 'Discovering...' : 'Discover models' }
+                            </button>
+                        </div>
+
+                        <div v-if="modelDiscoveryError" class="mb-3 text-sm text-[var(--text-danger-strong)]">
+                            ${ modelDiscoveryError }
+                        </div>
+
+                        <div v-if="modelDiscoveryResult" class="mb-3 text-xs text-[var(--text-muted)]">
+                            Active connector: <code>${ modelDiscoveryResult.connector }</code>
+                            <span v-if="!modelDiscoveryResult.supported"> (no model discovery API; add models manually below)</span>
+                        </div>
+
+                        <table v-if="visibleTranscriptionModels.length > 0 || (modelDiscoveryResult && modelDiscoveryResult.models && modelDiscoveryResult.models.length > 0)"
+                               class="w-full text-sm border-collapse">
+                            <thead>
+                                <tr class="text-left text-xs uppercase text-[var(--text-muted)] border-b border-[var(--border-primary)]">
+                                    <th class="py-2">Visible</th>
+                                    <th class="py-2">Default</th>
+                                    <th class="py-2">Model id</th>
+                                    <th class="py-2">Label shown to users</th>
+                                    <th class="py-2">Source</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <tr v-for="row in transcriptionModelRows" :key="row.value"
+                                    class="border-b border-[var(--border-primary)]/50">
+                                    <td class="py-2"><input type="checkbox" v-model="row.visible"></td>
+                                    <td class="py-2"><input type="radio" :value="row.value" v-model="transcriptionDefaultModel" :disabled="!row.visible"></td>
+                                    <td class="py-2 font-mono text-xs">${ row.value }</td>
+                                    <td class="py-2"><input type="text" v-model="row.label" class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded"></td>
+                                    <td class="py-2 text-xs text-[var(--text-muted)]">${ row.source }</td>
+                                </tr>
+                            </tbody>
+                        </table>
+
+                        <p v-else class="text-sm text-[var(--text-muted)] mb-3">No models discovered yet. Click "Discover models" to probe the active connector, or set <code>TRANSCRIPTION_MODELS_AVAILABLE</code> in your environment.</p>
+
+                        <div class="flex items-center gap-3 mt-4">
+                            <button @click="addManualTranscriptionModel"
+                                    class="px-3 py-2 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded-lg hover:bg-[var(--bg-tertiary)]">
+                                <i class="fas fa-plus mr-1"></i> Add custom model id
+                            </button>
+                            <button @click="saveVisibleTranscriptionModels" :disabled="savingModels"
+                                    class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] disabled:opacity-50">
+                                <i :class="savingModels ? 'fas fa-spinner fa-spin' : 'fas fa-save'" class="mr-2"></i>
+                                ${ savingModels ? 'Saving...' : 'Save selection' }
+                            </button>
+                            <span v-if="modelSaveMessage" class="text-sm" :class="modelSaveError ? 'text-[var(--text-danger-strong)]' : 'text-[var(--text-success-strong)]'">${ modelSaveMessage }</span>
+                        </div>
+                    </div>
+
+                    <!-- Settings List -->
+                    <div class="space-y-4">
+                        <div v-for="setting in settings" :key="setting.id" class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex justify-between items-start">
+                                <div class="flex-grow">
+                                    <h4 class="text-md font-medium text-[var(--text-primary)] mb-1">${ setting.key }</h4>
+                                    <p class="text-sm text-[var(--text-muted)] mb-2">${ getSettingDescription(setting) }</p>
+                                    <div class="flex items-center space-x-2">
+                                        <span class="text-xs px-2 py-1 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded">${ setting.setting_type }</span>
+                                        <span class="text-xs text-[var(--text-muted)]">${t('adminDashboard.lastUpdated')}: ${ formatDate(setting.updated_at) }</span>
+                                    </div>
+                                </div>
+                                <div class="ml-4 flex items-center space-x-2">
+                                    <div class="text-right">
+                                        <div class="text-sm font-medium text-[var(--text-primary)]">
+                                            <span v-if="setting.setting_type === 'boolean'">
+                                                <span v-if="setting.value === 'true'" class="text-[var(--text-success-strong)]">
+                                                    <i class="fas fa-check-circle mr-1"></i> Enabled
+                                                </span>
+                                                <span v-else class="text-[var(--text-danger-strong)]">
+                                                    <i class="fas fa-times-circle mr-1"></i> Disabled
+                                                </span>
+                                            </span>
+                                            <span v-else-if="setting.key === 'transcript_length_limit' && setting.value === '-1'" class="text-[var(--text-info-strong)]">
+                                                <i class="fas fa-infinity mr-1"></i> ${t('adminDashboard.noLimit')}
+                                            </span>
+                            <span v-else-if="setting.key === 'transcript_length_limit'" class="text-[var(--text-primary)]">
+                                ${ Number(setting.value).toLocaleString() } ${t('adminDashboard.characters')}
+                            </span>
+                            <span v-else-if="setting.key === 'max_file_size_mb'" class="text-[var(--text-primary)]">
+                                ${ Number(setting.value).toLocaleString() } ${t('adminDashboard.megabytes')}
+                            </span>
+                            <span v-else-if="setting.key === 'asr_timeout_seconds'" class="text-[var(--text-primary)]">
+                                ${ Number(setting.value).toLocaleString() } ${t('adminDashboard.seconds')}
+                            </span>
+                                            <span v-else-if="setting.value && setting.value.length > 80" class="text-[var(--text-muted)] italic">${ setting.value.substring(0, 80) }...</span>
+                                            <span v-else>${ setting.value || t('adminDashboard.notSet') }</span>
+                                        </div>
+                                    </div>
+                                    <button @click="editSetting(setting)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)] p-1" :title="t('buttons.editSetting')">
+                                        <i class="fas fa-edit"></i>
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+                        
+                        <div v-if="settings.length === 0" class="text-center py-8">
+                            <div v-if="isLoadingSettings">
+                                <i class="fas fa-spinner fa-spin mr-2"></i> Loading settings...
+                            </div>
+                            <div v-else class="text-[var(--text-muted)]">
+                                No system settings found.
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Default Prompts Tab -->
+                <div v-show="activeTab === 'prompts'">
+                    <div class="mb-6">
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)] mb-4">${t('adminDashboard.defaultPrompts')}</h3>
+                        <div class="bg-[var(--bg-info-light)] text-[var(--text-info-strong)] p-4 rounded-lg mb-4">
+                            <i class="fas fa-info-circle mr-2"></i>
+                            ${t('adminDashboard.defaultPromptInfo')}
+                        </div>
+                    </div>
+                    
+                    <div class="bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)]">
+                        <div class="mb-4">
+                            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                                ${t('adminDashboard.defaultSummarizationPrompt')}
+                            </label>
+                            <p class="text-sm text-[var(--text-muted)] mb-3">
+                                ${t('adminDashboard.promptDescription')}
+                            </p>
+                            <textarea
+                                v-model="defaultSummaryPrompt"
+                                rows="8"
+                                class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                :placeholder="t('form.summaryPromptPlaceholder')">
+                            </textarea>
+                        </div>
+                        
+                        <div class="flex justify-between items-center">
+                            <div>
+                                <button @click="resetDefaultPrompt" 
+                                        class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">
+                                    <i class="fas fa-undo mr-2"></i> ${t('adminDashboard.resetToDefault')}
+                                </button>
+                            </div>
+                            <div>
+                                <button @click="saveDefaultPrompt" 
+                                        :disabled="isSavingPrompt"
+                                        class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] disabled:opacity-50 disabled:cursor-not-allowed">
+                                    <i v-if="isSavingPrompt" class="fas fa-spinner fa-spin mr-2"></i>
+                                    <i v-else class="fas fa-save mr-2"></i>
+                                    ${ isSavingPrompt ? t('adminDashboard.saving') : t('buttons.saveChanges') }
+                                </button>
+                            </div>
+                        </div>
+                        
+                        <div v-if="promptSaveMessage" class="mt-4">
+                            <div :class="promptSaveError ? 'bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]' : 'bg-[var(--bg-success-light)] text-[var(--text-success-strong)]'" 
+                                 class="p-3 rounded-md text-sm">
+                                ${ promptSaveMessage }
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <div class="mt-6 bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)]">
+                        <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">${t('adminDashboard.promptHierarchy')}</h4>
+                        <p class="text-sm text-[var(--text-muted)] mb-3">
+                            ${t('adminDashboard.promptPriorityDescription')}
+                        </p>
+                        <ol class="list-decimal list-inside space-y-2 text-sm text-[var(--text-secondary)]">
+                            <li><strong>${t('adminDashboard.tagCustomPrompt')}:</strong> ${t('adminDashboard.tagCustomPromptDesc')}</li>
+                            <li><strong>Folder Custom Prompt:</strong> Applied when recording is in a folder with a custom prompt (if Folders feature enabled)</li>
+                            <li><strong>${t('adminDashboard.userCustomPrompt')}:</strong> ${t('adminDashboard.userCustomPromptDesc')}</li>
+                            <li><strong>${t('adminDashboard.adminDefaultPrompt')}:</strong> ${t('adminDashboard.adminDefaultPromptDesc')}</li>
+                            <li><strong>${t('adminDashboard.systemFallback')}:</strong> ${t('adminDashboard.systemFallbackDesc')}</li>
+                        </ol>
+                    </div>
+                    
+                    <!-- Full LLM Prompt Structure Expander -->
+                    <div class="mt-6 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)]">
+                        <button @click="showFullPromptStructure = !showFullPromptStructure" 
+                                class="w-full p-6 flex justify-between items-center hover:bg-[var(--bg-quaternary)] transition-colors duration-200">
+                            <h4 class="text-md font-medium text-[var(--text-secondary)]">
+                                <i class="fas fa-code mr-2"></i>
+                                ${t('adminDashboard.viewFullPromptStructure')}
+                            </h4>
+                            <i :class="showFullPromptStructure ? 'fas fa-chevron-up' : 'fas fa-chevron-down'" 
+                               class="text-[var(--text-muted)]"></i>
+                        </button>
+                        
+                        <div v-show="showFullPromptStructure" class="border-t border-[var(--border-primary)]">
+                            <div class="p-6 space-y-6">
+                                <!-- Placeholder legend so the two distinct syntaxes in the previews below are unambiguous. -->
+                                <div class="flex flex-wrap items-center gap-3 text-xs text-[var(--text-secondary)] -mt-2">
+                                    <span class="font-medium">${ t('preview.placeholderLegend') }</span>
+                                    <span class="inline-flex items-center gap-1.5">
+                                        <span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-blue-500/15 text-blue-300 border border-blue-500/30 font-mono">{example}</span>
+                                        <span>${ t('preview.systemReplaced') }</span>
+                                    </span>
+                                    <span class="inline-flex items-center gap-1.5">
+                                        <span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-amber-500/15 text-amber-300 border border-amber-500/30 font-mono">{{example}}</span>
+                                        <span>${ t('preview.userSupplied') }</span>
+                                    </span>
+                                </div>
+
+                                <div>
+                                    <h5 class="text-sm font-semibold text-[var(--text-accent)] mb-2">${t('adminDashboard.systemPrompt')}:</h5>
+                                    <div class="bg-[var(--bg-secondary)] p-4 rounded-md border border-[var(--border-secondary)]">
+                                        <pre class="text-xs text-[var(--text-secondary)] whitespace-pre-wrap font-mono"><span v-html="formatPromptPreview('You are an AI assistant that generates comprehensive summaries for meeting transcripts. Respond only with the summary in Markdown format. Do NOT use markdown code blocks (```markdown). Provide raw markdown content directly.\n\nContext:\n- Current date: {current_date}')"></span>
+<span v-html="formatPromptPreview('- Recording date: {recording_date}')"></span> <span class="text-[var(--text-muted)]">(if meeting date is set)</span>
+<span v-html="formatPromptPreview('- Recording title: {recording_title}')"></span> <span class="text-[var(--text-muted)]">(if title is set)</span>
+<span v-html="formatPromptPreview('- Folder: {folder_name}')"></span> <span class="text-[var(--text-muted)]">(if recording is in a folder)</span>
+<span v-html="formatPromptPreview('- Tags applied to this transcript by the user: {tag_names}')"></span> <span class="text-[var(--text-muted)]">(if tags exist)</span>
+<span v-html="formatPromptPreview('- Information about the user: Name: {name}, Job title: {job_title}, Company: {company}')"></span> <span class="text-[var(--text-muted)]">(only the fields the user has filled in their account)</span>
+
+<span class="text-[var(--text-muted)]"><span v-html="formatPromptPreview('Language Requirement: You MUST generate the entire summary in {user_output_language}. This is mandatory.')"></span> (if language preference is set)</span></pre>
+                                    </div>
+                                </div>
+
+                                <div>
+                                    <h5 class="text-sm font-semibold text-[var(--text-accent)] mb-2">${t('adminDashboard.userMessageTemplate')}:</h5>
+                                    <div class="bg-[var(--bg-secondary)] p-4 rounded-md border border-[var(--border-secondary)]">
+                                        <pre class="text-xs text-[var(--text-secondary)] whitespace-pre-wrap font-mono">Transcription:
+"""
+<span v-html="formatPromptPreview('{transcript_text}')"></span>
+"""
+
+Summarization Instructions:
+<span class="text-[var(--text-muted)]">/* This section is dynamically replaced with one of the following (in order of priority):
+   1. Combined tag prompts (if tags with custom prompts are selected)
+   2. User's personal summarization prompt (if set in account settings)
+   3. Admin default prompt (shown below)
+   4. System fallback prompt */</span>
+<span v-if="defaultSummaryPrompt || originalDefaultPrompt" v-html="formatPromptPreview(defaultSummaryPrompt || originalDefaultPrompt)"></span>
+
+<span class="text-[var(--text-muted)]"><span v-html="formatPromptPreview('{language_directive}')"></span> (e.g., "IMPORTANT: You MUST provide the summary in English. The entire response must be in English." — only added if language preference is set)</span></pre>
+                                    </div>
+                                    <p class="text-xs text-[var(--text-muted)] mt-2">
+                                        <i class="fas fa-info-circle mr-1"></i>
+                                        ${t('adminDashboard.placeholdersNote')}
+                                    </p>
+                                </div>
+                                
+                                <div>
+                                    <h5 class="text-sm font-semibold text-[var(--text-accent)] mb-2">${t('adminDashboard.additionalContext')}:</h5>
+                                    <div class="bg-[var(--bg-info-light)] p-4 rounded-md">
+                                        <ul class="text-xs text-[var(--text-info-strong)] space-y-2">
+                                            <li><i class="fas fa-check-circle mr-1"></i> ${t('adminDashboard.contextNotes.transcriptLimit')}</li>
+                                            <li><i class="fas fa-check-circle mr-1"></i> ${t('adminDashboard.contextNotes.jsonConversion')}</li>
+                                            <li><i class="fas fa-check-circle mr-1"></i> ${t('adminDashboard.contextNotes.tagPrompts')}</li>
+                                            <li><i class="fas fa-check-circle mr-1"></i> ${t('adminDashboard.contextNotes.modelConfig')}</li>
+                                        </ul>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Vector Store Tab -->
+                <div v-show="activeTab === 'vectorstore'" v-if="inquireModeEnabled">
+                    <div class="flex justify-between items-center mb-6">
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">${t('adminDashboard.vectorStoreManagement')}</h3>
+                        <button @click="loadInquireStatus" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
+                            <i class="fas fa-sync-alt mr-2"></i> ${t('adminDashboard.refreshStatus')}
+                        </button>
+                    </div>
+                    
+                    <!-- Vector Store Info -->
+                    <div class="bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)] mb-6">
+                        <h4 class="text-md font-semibold text-[var(--text-primary)] mb-4">
+                            <i class="fas fa-info-circle mr-2"></i>${t('adminDashboard.aboutInquireMode')}
+                        </h4>
+                        <p class="text-sm text-[var(--text-secondary)] mb-3">
+                            ${t('adminDashboard.inquireModeDescription')}
+                        </p>
+                        <div class="grid grid-cols-2 gap-4 text-sm">
+                            <div>
+                                <span class="text-[var(--text-muted)]">${t('adminDashboard.chunkSize')}:</span>
+                                <span class="ml-2 text-[var(--text-primary)]">500 ${t('adminDashboard.characters')}</span>
+                            </div>
+                            <div>
+                                <span class="text-[var(--text-muted)]">${t('adminDashboard.overlap')}:</span>
+                                <span class="ml-2 text-[var(--text-primary)]">50 ${t('adminDashboard.characters')}</span>
+                            </div>
+                            <div>
+                                <span class="text-[var(--text-muted)]">${t('adminDashboard.embeddingModel')}:</span>
+                                <span class="ml-2 text-[var(--text-primary)] break-all">${ inquireStatus.embedding_model || 'all-MiniLM-L6-v2' }</span>
+                            </div>
+                            <div>
+                                <span class="text-[var(--text-muted)]">Provider:</span>
+                                <span class="ml-2 text-[var(--text-primary)]">
+                                    <template v-if="inquireStatus.embedding_provider === 'api'">
+                                        API (${ inquireStatus.embedding_base_url })
+                                    </template>
+                                    <template v-else>
+                                        Local (sentence-transformers)
+                                    </template>
+                                </span>
+                            </div>
+                            <div v-if="inquireStatus.embedding_dimensions_override">
+                                <span class="text-[var(--text-muted)]">${t('adminDashboard.vectorDimensions')}:</span>
+                                <span class="ml-2 text-[var(--text-primary)]">${ inquireStatus.embedding_dimensions_override }</span>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Identifier mismatch alert: chunks were embedded with a previous configuration -->
+                    <div v-if="inquireStatus.embedding_identifier_mismatch" class="mb-6 p-4 rounded-lg bg-[var(--bg-warning-light)] border border-[var(--border-warning)]">
+                        <div class="flex items-start">
+                            <i class="fas fa-exclamation-triangle text-[var(--text-warning-strong)] mt-0.5 mr-3"></i>
+                            <div class="flex-1">
+                                <p class="font-semibold text-[var(--text-warning-strong)]">Embedding configuration changed</p>
+                                <p class="text-sm text-[var(--text-secondary)] mt-1">
+                                    ${ inquireStatus.total_chunks } stored chunks were embedded with
+                                    <code class="px-1 rounded bg-[var(--bg-tertiary)]">${ inquireStatus.embedding_identifier_stored }</code>,
+                                    but the active configuration is
+                                    <code class="px-1 rounded bg-[var(--bg-tertiary)]">${ inquireStatus.embedding_identifier }</code>.
+                                    Inquire mode will return wrong results until you re-embed all recordings.
+                                </p>
+                                <button @click="reembedAllRecordings"
+                                        :disabled="isProcessingRecordings"
+                                        class="mt-3 px-4 py-2 bg-[var(--bg-warning-strong)] text-white rounded-lg shadow hover:opacity-90 disabled:opacity-50 disabled:cursor-not-allowed">
+                                    <i :class="isProcessingRecordings ? 'fas fa-spinner fa-spin' : 'fas fa-sync-alt'" class="mr-2"></i>
+                                    ${ isProcessingRecordings ? 'Re-embedding...' : 'Re-embed all recordings now' }
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <!-- Statistics Grid -->
+                    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6 mb-6">
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.totalRecordings')}</p>
+                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ inquireStatus.total_completed_recordings || 0 }</p>
+                                </div>
+                                <i class="fas fa-file-audio text-3xl text-[var(--text-accent)] opacity-50"></i>
+                            </div>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.processedForInquire')}</p>
+                                    <p class="text-2xl font-semibold text-[var(--text-success-strong)]">${ inquireStatus.processed_for_inquire || 0 }</p>
+                                </div>
+                                <i class="fas fa-check-circle text-3xl text-[var(--text-success-strong)] opacity-50"></i>
+                            </div>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.needProcessing')}</p>
+                                    <p class="text-2xl font-semibold" :class="inquireStatus.need_processing > 0 ? 'text-[var(--text-warning-strong)]' : 'text-[var(--text-primary)]'">
+                                        ${ inquireStatus.need_processing || 0 }
+                                    </p>
+                                </div>
+                                <i class="fas fa-clock text-3xl opacity-50" :class="inquireStatus.need_processing > 0 ? 'text-[var(--text-warning-strong)]' : 'text-[var(--text-muted)]'"></i>
+                            </div>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.totalChunks')}</p>
+                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ inquireStatus.total_chunks || 0 }</p>
+                                </div>
+                                <i class="fas fa-th text-3xl text-[var(--text-accent)] opacity-50"></i>
+                            </div>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.embeddingsStatus')}</p>
+                                    <p class="text-lg font-semibold" :class="inquireStatus.embeddings_available ? 'text-[var(--text-success-strong)]' : 'text-[var(--text-warning-strong)]'">
+                                        <i :class="inquireStatus.embeddings_available ? 'fas fa-check-circle' : 'fas fa-exclamation-triangle'" class="mr-2"></i>
+                                        ${ inquireStatus.embeddings_available ? t('adminDashboard.available') : t('adminDashboard.textSearchOnly') }
+                                    </p>
+                                </div>
+                                <i class="fas fa-brain text-3xl opacity-50" :class="inquireStatus.embeddings_available ? 'text-[var(--text-success-strong)]' : 'text-[var(--text-warning-strong)]'"></i>
+                            </div>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">${t('adminDashboard.processingProgress')}</p>
+                                    <div class="mt-2">
+                                        <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-2.5">
+                                            <div class="bg-[var(--text-accent)] h-2.5 rounded-full" :style="{width: getProcessingProgress() + '%'}"></div>
+                                        </div>
+                                        <p class="text-xs text-[var(--text-muted)] mt-1">${ getProcessingProgress() }% ${t('adminDashboard.complete')}</p>
+                                    </div>
+                                </div>
+                                <i class="fas fa-tasks text-3xl text-[var(--text-accent)] opacity-50"></i>
+                            </div>
+                        </div>
+
+                        <!-- Embedding API usage (only meaningful in API mode) -->
+                        <div v-if="inquireStatus.embedding_provider === 'api'" class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">Embedding API tokens</p>
+                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">${ (inquireStatus.embedding_usage && inquireStatus.embedding_usage.total_tokens || 0).toLocaleString() }</p>
+                                    <p class="text-xs text-[var(--text-muted)] mt-1">${ inquireStatus.embedding_usage && inquireStatus.embedding_usage.request_count || 0 } API requests</p>
+                                </div>
+                                <i class="fas fa-coins text-3xl text-[var(--text-accent)] opacity-50"></i>
+                            </div>
+                        </div>
+
+                        <div v-if="inquireStatus.embedding_provider === 'api'" class="bg-[var(--bg-secondary)] p-6 rounded-lg border border-[var(--border-primary)] shadow-sm">
+                            <div class="flex items-center justify-between">
+                                <div>
+                                    <p class="text-sm text-[var(--text-muted)]">Embedding API cost</p>
+                                    <p class="text-2xl font-semibold text-[var(--text-primary)]">$${ (inquireStatus.embedding_usage && inquireStatus.embedding_usage.total_cost || 0).toFixed(4) }</p>
+                                    <p class="text-xs text-[var(--text-muted)] mt-1" v-if="inquireStatus.embedding_usage && inquireStatus.embedding_usage.total_cost === 0">Provider did not return cost</p>
+                                </div>
+                                <i class="fas fa-dollar-sign text-3xl text-[var(--text-accent)] opacity-50"></i>
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <!-- Processing Actions -->
+                    <div class="bg-[var(--bg-tertiary)] p-6 rounded-lg border border-[var(--border-primary)]">
+                        <h4 class="text-md font-semibold text-[var(--text-primary)] mb-4">
+                            <i class="fas fa-cog mr-2"></i>${t('adminDashboard.processingActions')}
+                        </h4>
+                        
+                        <div v-if="inquireStatus.need_processing > 0" class="mb-4">
+                            <p class="text-sm text-[var(--text-secondary)] mb-4">
+                                ${ recordingsNeedProcessingMessage }
+                            </p>
+                            
+                            <div class="flex flex-wrap gap-3">
+                                <button @click="processAllRecordings" 
+                                        :disabled="isProcessingRecordings"
+                                        class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out disabled:opacity-50 disabled:cursor-not-allowed">
+                                    <i :class="isProcessingRecordings ? 'fas fa-spinner fa-spin' : 'fas fa-play'" class="mr-2"></i>
+                                    ${ isProcessingRecordings ? t('adminDashboard.processing') : t('adminDashboard.processAllRecordings') }
+                                </button>
+                                
+                                <button @click="processBatchRecordings(10)" 
+                                        :disabled="isProcessingRecordings"
+                                        class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded-lg shadow hover:bg-[var(--bg-tertiary)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out disabled:opacity-50 disabled:cursor-not-allowed">
+                                    <i class="fas fa-forward mr-2"></i>
+                                    ${t('adminDashboard.processNext10')}
+                                </button>
+                            </div>
+                            
+                            <div v-if="processingResult" class="mt-4 p-4 rounded-lg" 
+                                 :class="processingResult.success ? 'bg-[var(--bg-success-light)] text-[var(--text-success-strong)]' : 'bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]'">
+                                <p class="font-medium">${ processingResult.message }</p>
+                                <div v-if="processingResult.failed && processingResult.failed.length > 0" class="mt-2">
+                                    <p class="text-sm font-medium">Failed recordings:</p>
+                                    <ul class="text-xs mt-1 space-y-1">
+                                        <li v-for="fail in processingResult.failed" :key="fail.id">
+                                            ID ${ fail.id }: ${ fail.title } - ${ fail.reason }
+                                        </li>
+                                    </ul>
+                                </div>
+                            </div>
+                        </div>
+                        
+                        <div v-else class="text-center py-4">
+                            <i class="fas fa-check-circle text-4xl text-[var(--text-success-strong)] mb-3"></i>
+                            <p class="text-[var(--text-success-strong)] font-medium">${t('adminDashboard.allRecordingsProcessed')}</p>
+                            <p class="text-sm text-[var(--text-muted)] mt-1">${t('adminDashboard.vectorStoreUpToDate')}</p>
+                        </div>
+
+                        <!-- Re-embed all (always available) -->
+                        <div class="mt-6 pt-4 border-t border-[var(--border-primary)]">
+                            <p class="text-sm text-[var(--text-secondary)] mb-3">
+                                Re-embed every completed recording with the current configuration. Use this after switching <code class="px-1 rounded bg-[var(--bg-tertiary)]">EMBEDDING_MODEL</code> or <code class="px-1 rounded bg-[var(--bg-tertiary)]">EMBEDDING_BASE_URL</code>. Existing chunks are deleted and replaced.
+                            </p>
+                            <button @click="reembedAllRecordings"
+                                    :disabled="isProcessingRecordings || (inquireStatus.processed_for_inquire || 0) === 0"
+                                    class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded-lg shadow hover:bg-[var(--bg-tertiary)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out disabled:opacity-50 disabled:cursor-not-allowed">
+                                <i :class="isProcessingRecordings ? 'fas fa-spinner fa-spin' : 'fas fa-sync-alt'" class="mr-2"></i>
+                                ${ isProcessingRecordings ? 'Re-embedding...' : 'Re-embed all recordings' }
+                            </button>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Groups Tab -->
+                <div v-show="activeTab === 'groups'">
+                    <div class="flex justify-between items-center mb-4">
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">Group Management</h3>
+                        <button v-if="!isTeamAdminOnly" @click="openCreateTeamModal" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
+                            <i class="fas fa-plus mr-2"></i> Create Group
+                        </button>
+                    </div>
+
+                    <!-- Groups List -->
+                    <div class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] overflow-hidden">
+                        <div v-if="groups.length > 0">
+                            <table class="min-w-full divide-y divide-[var(--border-primary)]">
+                                <thead class="bg-[var(--bg-tertiary)]">
+                                    <tr>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.groupName')}</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.description')}</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.members')}</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.created')}</th>
+                                        <th scope="col" class="px-6 py-3 text-right text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">${t('adminDashboard.actions')}</th>
+                                    </tr>
+                                </thead>
+                                <tbody class="bg-[var(--bg-secondary)] divide-y divide-[var(--border-primary)]">
+                                    <tr v-for="group in groups" :key="group.id" class="hover:bg-[var(--bg-tertiary)]">
+                                        <td class="px-6 py-4 whitespace-nowrap">
+                                            <div class="text-sm font-medium text-[var(--text-primary)]">${ group.name }</div>
+                                        </td>
+                                        <td class="px-6 py-4">
+                                            <div class="text-sm text-[var(--text-secondary)]">${ group.description || t('adminDashboard.noDescription') }</div>
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap">
+                                            <div class="text-sm text-[var(--text-secondary)]">
+                                                <i class="fas fa-users mr-1"></i>
+                                                ${ group.member_count || 0 } ${t('adminDashboard.membersCount')}
+                                            </div>
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-muted)]">
+                                            ${ new Date(group.created_at).toLocaleDateString() }
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium space-x-2">
+                                            <button @click="openManageTeamModal(group)" class="text-blue-500 hover:text-blue-700" title="Manage Members">
+                                                <i class="fas fa-users-cog"></i>
+                                            </button>
+                                            <button @click="openManageTeamTagsModal(group)" class="text-purple-500 hover:text-purple-700" title="Manage Group Tags">
+                                                <i class="fas fa-tags"></i>
+                                            </button>
+                                            <button @click="openEditTeamModal(group)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]" title="Edit Group">
+                                                <i class="fas fa-edit"></i>
+                                            </button>
+                                            <button v-if="!isTeamAdminOnly" @click="confirmDeleteTeam(group)" class="text-red-500 hover:text-red-700" title="Delete Group">
+                                                <i class="fas fa-trash"></i>
+                                            </button>
+                                        </td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+                        <div v-else class="p-8 text-center">
+                            <i class="fas fa-users-slash text-4xl text-[var(--text-muted)] mb-3"></i>
+                            <p class="text-[var(--text-muted)]" v-text="isTeamAdminOnly ? t('adminDashboard.noGroupsAdmin') : t('adminDashboard.noGroupsCreated')"></p>
+                            <button v-if="!isTeamAdminOnly" @click="openCreateTeamModal" class="mt-4 px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)]">
+                                <i class="fas fa-plus mr-2"></i> ${t('adminDashboard.createFirstGroup')}
+                            </button>
+                        </div>
+                    </div>
                 </div>
             </div>
         </main>
@@ -342,77 +1230,121 @@ <h4 class="text-md font-medium text-[var(--text-secondary)] mb-3">Top Users by S
         <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
             Speakr &copy; {{ now.year }}
         </footer>
-        
+
         <!-- Add User Modal -->
-        <div v-if="showAddUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+        <div v-if="showAddUserModal" @click.self="showAddUserModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
                 <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Add New User</h3>
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">${t('adminDashboard.addNewUser')}</h3>
                     <button @click="showAddUserModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
                 </div>
                 <form @submit.prevent="addUser">
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Username</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.usernameLabel')}</label>
                         <input v-model="newUser.username" type="text" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Email</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.emailLabel')}</label>
                         <input v-model="newUser.email" type="email" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Password</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.passwordLabel')}</label>
                         <input v-model="newUser.password" type="password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Confirm Password</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.confirmPasswordLabel')}</label>
                         <input v-model="newUser.confirmPassword" type="password" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
-                    <div class="mb-4 flex items-center">
-                        <input v-model="newUser.isAdmin" type="checkbox" id="isAdmin" class="rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
-                        <label for="isAdmin" class="ml-2 text-sm text-[var(--text-secondary)]">Admin User</label>
+                    <div class="mb-4">
+                        <label class="flex items-center cursor-pointer">
+                            <input v-model="newUser.isAdmin" type="checkbox" class="sr-only peer">
+                            <div class="relative w-11 h-6 bg-gray-600 peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-[var(--text-accent)]"></div>
+                            <span class="ml-3 text-sm text-[var(--text-secondary)]">${t('adminDashboard.adminUser')}</span>
+                        </label>
+                    </div>
+                    <div class="mb-4">
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.monthlyTokenBudget')}</label>
+                        <input v-model.number="newUser.monthlyTokenBudget" type="number" min="100000" step="10000" :placeholder="t('adminDashboard.tokenBudgetPlaceholder')" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <p class="text-xs text-[var(--text-muted)] mt-1">${t('adminDashboard.tokenBudgetHelp')}</p>
+                    </div>
+                    <div class="mb-4">
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.monthlyTranscriptionBudget')}</label>
+                        <input v-model.number="newUser.monthlyTranscriptionBudgetMinutes" type="number" min="10" step="10" :placeholder="t('adminDashboard.transcriptionBudgetPlaceholder')" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <p class="text-xs text-[var(--text-muted)] mt-1">${t('adminDashboard.transcriptionBudgetHelp')}</p>
                     </div>
                     <div class="flex justify-end space-x-3">
-                        <button type="button" @click="showAddUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
-                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Add User</button>
+                        <button type="button" @click="showAddUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">${t('buttons.cancel')}</button>
+                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">${t('adminDashboard.addUser')}</button>
                     </div>
                 </form>
             </div>
         </div>
-        
+
         <!-- Edit User Modal -->
-        <div v-if="showEditUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+        <div v-if="showEditUserModal" @click.self="showEditUserModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
                 <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Edit User</h3>
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">${t('adminDashboard.editUser')}</h3>
                     <button @click="showEditUserModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
                 </div>
                 <form @submit.prevent="updateUser">
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Username</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.usernameLabel')}</label>
                         <input v-model="editingUser.username" type="text" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Email</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.emailLabel')}</label>
                         <input v-model="editingUser.email" type="email" required class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
                     <div class="mb-4">
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">New Password (leave blank to keep current)</label>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.newPasswordLabel')}</label>
                         <input v-model="editingUser.password" type="password" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
                     </div>
-                    <div class="mb-4 flex items-center">
-                        <input v-model="editingUser.is_admin" type="checkbox" id="editIsAdmin" class="rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
-                        <label for="editIsAdmin" class="ml-2 text-sm text-[var(--text-secondary)]">Admin User</label>
+                    <div class="mb-4">
+                        <label class="flex items-center cursor-pointer">
+                            <input v-model="editingUser.is_admin" type="checkbox" class="sr-only peer">
+                            <div class="relative w-11 h-6 bg-gray-600 peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-[var(--text-accent)]"></div>
+                            <span class="ml-3 text-sm text-[var(--text-secondary)]">${t('adminDashboard.adminUser')}</span>
+                        </label>
                     </div>
-                    <div class="flex justify-end space-x-3">
-                        <button type="button" @click="showEditUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
-                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Update User</button>
+                    <div class="mb-4">
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.monthlyTokenBudget')}</label>
+                        <input v-model.number="editingUser.monthly_token_budget" type="number" min="100000" step="10000" :placeholder="t('adminDashboard.tokenBudgetPlaceholder')" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <p class="text-xs text-[var(--text-muted)] mt-1">${t('adminDashboard.tokenBudgetHelp')}</p>
+                        <div v-if="editingUser.monthly_token_budget && editingUser.current_token_usage !== undefined" class="mt-2">
+                            <div class="flex justify-between text-xs text-[var(--text-muted)] mb-1">
+                                <span>${t('adminDashboard.currentUsage')}: ${ editingUser.current_token_usage?.toLocaleString() || 0 } ${t('adminDashboard.tokens')}</span>
+                                <span :class="{'text-[var(--text-danger-strong)]': editingUser.token_usage_percentage >= 100, 'text-[var(--text-warn-strong)]': editingUser.token_usage_percentage >= 80 && editingUser.token_usage_percentage < 100}">${ editingUser.token_usage_percentage || 0 }%</span>
+                            </div>
+                            <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-2">
+                                <div class="h-2 rounded-full" :class="{'bg-[var(--text-danger-strong)]': editingUser.token_usage_percentage >= 100, 'bg-[var(--text-warn-strong)]': editingUser.token_usage_percentage >= 80 && editingUser.token_usage_percentage < 100, 'bg-[var(--text-success-strong)]': editingUser.token_usage_percentage < 80}" :style="{width: Math.min(editingUser.token_usage_percentage || 0, 100) + '%'}"></div>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="mb-4">
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">${t('adminDashboard.monthlyTranscriptionBudget')}</label>
+                        <input v-model.number="editingUser.monthly_transcription_budget_minutes" type="number" min="10" step="10" :placeholder="t('adminDashboard.transcriptionBudgetPlaceholder')" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                        <p class="text-xs text-[var(--text-muted)] mt-1">${t('adminDashboard.transcriptionBudgetHelp')}</p>
+                        <div v-if="editingUser.monthly_transcription_budget && editingUser.current_transcription_usage !== undefined" class="mt-2">
+                            <div class="flex justify-between text-xs text-[var(--text-muted)] mb-1">
+                                <span>${t('adminDashboard.currentUsageMinutes')}: ${ editingUser.current_transcription_usage_minutes || 0 } ${t('adminDashboard.minutes')}</span>
+                                <span :class="{'text-[var(--text-danger-strong)]': editingUser.transcription_usage_percentage >= 100, 'text-[var(--text-warn-strong)]': editingUser.transcription_usage_percentage >= 80 && editingUser.transcription_usage_percentage < 100}">${ editingUser.transcription_usage_percentage || 0 }%</span>
+                            </div>
+                            <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-2">
+                                <div class="h-2 rounded-full" :class="{'bg-[var(--text-danger-strong)]': editingUser.transcription_usage_percentage >= 100, 'bg-[var(--text-warn-strong)]': editingUser.transcription_usage_percentage >= 80 && editingUser.transcription_usage_percentage < 100, 'bg-[var(--text-success-strong)]': editingUser.transcription_usage_percentage < 80}" :style="{width: Math.min(editingUser.transcription_usage_percentage || 0, 100) + '%'}"></div>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="flex justify-end space-x-3">
+                        <button type="button" @click="showEditUserModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
+                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">${t('adminDashboard.updateUser')}</button>
                     </div>
                 </form>
             </div>
         </div>
-        
+
         <!-- Delete User Confirmation Modal -->
-        <div v-if="showDeleteUserModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+        <div v-if="showDeleteUserModal" @click.self="showDeleteUserModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
                 <div class="flex justify-between items-center mb-4">
                     <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
@@ -425,15 +1357,531 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                 </div>
             </div>
         </div>
+        
+        <!-- Edit System Setting Modal -->
+        <div v-if="showEditSettingModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-lg max-h-[85vh] flex flex-col overflow-hidden">
+                <div class="flex-shrink-0 flex justify-between items-center p-6 pb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Edit System Setting</h3>
+                    <button @click="showEditSettingModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)] text-2xl leading-none">&times;</button>
+                </div>
+
+                <div v-if="editingSetting" class="flex-1 overflow-y-auto px-6 pb-6 space-y-4">
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Setting Key</label>
+                        <div class="px-3 py-2 bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded-md font-mono text-sm">
+                            ${ editingSetting.key }
+                        </div>
+                    </div>
+                    
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Description</label>
+                        <div class="px-3 py-2 text-[var(--text-muted)] text-sm">
+                            ${ editingSetting.description || 'No description available' }
+                        </div>
+                    </div>
+                    
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Type</label>
+                        <span class="inline-block px-2 py-1 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded text-xs">
+                            ${ editingSetting.setting_type }
+                        </span>
+                    </div>
+                    
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Current Value</label>
+                        <div class="px-3 py-2 bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded-md max-h-24 overflow-y-auto text-sm break-words">
+                            <span v-if="editingSetting.key === 'transcript_length_limit' && editingSetting.value === '-1'">
+                                ${t('adminDashboard.noLimit')}
+                            </span>
+                            <span v-else-if="editingSetting.key === 'transcript_length_limit'">
+                                ${ Number(editingSetting.value).toLocaleString() } ${t('adminDashboard.characters')}
+                            </span>
+                            <span v-else-if="editingSetting.key === 'max_file_size_mb'">
+                                ${ Number(editingSetting.value).toLocaleString() } ${t('adminDashboard.megabytes')}
+                            </span>
+                            <span v-else-if="editingSetting.key === 'asr_timeout_seconds'">
+                                ${ Number(editingSetting.value).toLocaleString() } ${t('adminDashboard.seconds')} (${ Math.round(Number(editingSetting.value) / 60) } ${t('adminDashboard.minutes')})
+                            </span>
+                            <span v-else>${ editingSetting.value || t('adminDashboard.notSet') }</span>
+                        </div>
+                    </div>
+                    
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">New Value</label>
+                        
+                        <!-- Boolean type -->
+                        <div v-if="editingSetting.setting_type === 'boolean'" class="flex items-center space-x-4">
+                            <label class="flex items-center cursor-pointer">
+                                <input v-model="settingNewValue" type="radio" value="true" class="mr-2 text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
+                                <span class="text-[var(--text-primary)]">Enabled</span>
+                            </label>
+                            <label class="flex items-center cursor-pointer">
+                                <input v-model="settingNewValue" type="radio" value="false" class="mr-2 text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
+                                <span class="text-[var(--text-primary)]">Disabled</span>
+                            </label>
+                        </div>
+                        
+                        <!-- Integer/Float type with special handling for specific keys -->
+                        <div v-else-if="editingSetting.setting_type === 'integer' || editingSetting.setting_type === 'float'" class="space-y-2">
+                            <!-- Special input for transcript_length_limit -->
+                            <div v-if="editingSetting.key === 'transcript_length_limit'" class="space-y-2">
+                                <div class="flex items-center space-x-2">
+                                    <input v-model="settingUseNoLimit" type="checkbox" id="noLimit" class="rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)]">
+                                    <label for="noLimit" class="text-sm text-[var(--text-secondary)]">No limit (use entire transcript)</label>
+                                </div>
+                                <input v-if="!settingUseNoLimit" v-model.number="settingNewValue" type="number" min="1000" step="1000" 
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                       :placeholder="t('form.placeholderCharacterLimit')">
+                                <small v-if="!settingUseNoLimit" class="text-[var(--text-muted)]">Recommended: 30000-50000 characters for most LLMs</small>
+                            </div>
+                            
+                            <!-- Special input for max_file_size_mb -->
+                            <div v-else-if="editingSetting.key === 'max_file_size_mb'" class="space-y-2">
+                                <input v-model.number="settingNewValue" type="number" min="1" max="10000" step="50"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                       :placeholder="t('form.placeholderSizeMB')">
+                                <small class="text-[var(--text-muted)]">${t('adminDashboard.maxFileSizeHelp')}</small>
+                            </div>
+                            
+                            <!-- Special input for asr_timeout_seconds -->
+                            <div v-else-if="editingSetting.key === 'asr_timeout_seconds'" class="space-y-2">
+                                <div class="flex space-x-2">
+                                    <div class="flex-1">
+                                        <input v-model.number="settingTimeoutMinutes" type="number" min="1" max="600" step="1"
+                                               class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                               :placeholder="t('form.placeholderMinutes')">
+                                        <small class="text-[var(--text-muted)]">${t('adminDashboard.minutes')}</small>
+                                    </div>
+                                    <div class="flex-1">
+                                        <input v-model.number="settingTimeoutSeconds" type="number" min="0" max="59" step="1"
+                                               class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                               :placeholder="t('form.placeholderSeconds')">
+                                        <small class="text-[var(--text-muted)]">${t('adminDashboard.seconds')}</small>
+                                    </div>
+                                </div>
+                                <div class="text-sm text-[var(--text-muted)]">
+                                    ${t('adminDashboard.total')}: <span class="font-medium text-[var(--text-primary)]">${ (settingTimeoutMinutes * 60 + settingTimeoutSeconds).toLocaleString() } ${t('adminDashboard.seconds')}</span>
+                                </div>
+                                <small class="text-[var(--text-muted)]">${t('adminDashboard.timeoutRecommendation')}</small>
+                            </div>
+                            
+                            <!-- Default number input -->
+                            <input v-else v-model.number="settingNewValue" :type="editingSetting.setting_type === 'integer' ? 'number' : 'text'" 
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                   :placeholder="`Enter ${editingSetting.setting_type} value`">
+                        </div>
+                        
+                        <!-- String type -->
+                        <textarea v-else v-model="settingNewValue" rows="3"
+                                  class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                  :placeholder="'Enter value'"></textarea>
+                    </div>
+                    
+                    <div v-if="settingError" class="p-3 bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] rounded-md text-sm">
+                        ${ settingError }
+                    </div>
+                </div>
+
+                <div class="flex-shrink-0 flex justify-end space-x-3 p-6 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)] rounded-b-lg">
+                    <button @click="showEditSettingModal = false"
+                            class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">
+                        Cancel
+                    </button>
+                    <button @click="saveSettingValue"
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        ${t('buttons.saveChanges')}
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Create/Edit Group Modal -->
+        <div v-if="showTeamModal" @click.self="closeTeamModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">${ editingTeam ? 'Edit Group' : 'Create Group' }</h3>
+                    <button @click="closeTeamModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <form @submit.prevent="saveTeam">
+                    <div class="space-y-4">
+                        <div>
+                            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Group Name *</label>
+                            <input v-model="teamForm.name" type="text" required
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                   placeholder="Enter group name">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Description</label>
+                            <textarea v-model="teamForm.description" rows="3"
+                                      class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                      placeholder="Optional description"></textarea>
+                        </div>
+                        <div v-if="teamError" class="p-3 bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] rounded-md text-sm">
+                            ${ teamError }
+                        </div>
+                    </div>
+                    <div class="flex justify-end space-x-3 mt-6">
+                        <button type="button" @click="closeTeamModal"
+                                class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">
+                            Cancel
+                        </button>
+                        <button type="submit"
+                                class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                            ${ editingTeam ? 'Update Group' : 'Create Group' }
+                        </button>
+                    </div>
+                </form>
+            </div>
+        </div>
+
+        <!-- Manage Group Members Modal -->
+        <div v-if="showManageTeamModal" @click.self="closeManageTeamModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-2xl max-h-[90vh] overflow-y-auto">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Manage Group: ${ currentTeam?.name }</h3>
+                    <button @click="closeManageTeamModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+
+                <!-- Add Member Section -->
+                <div class="mb-6 p-4 bg-[var(--bg-tertiary)] rounded-lg">
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Add Member</h4>
+                    <div class="flex space-x-2">
+                        <div class="flex-1">
+                            <select v-model="newMemberUserId"
+                                    class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                <option value="">Select a user...</option>
+                                <option v-for="user in availableUsers" :key="user.id" :value="user.id">
+                                    ${ user.username } (${ user.email })
+                                </option>
+                            </select>
+                        </div>
+                        <div>
+                            <select v-model="newMemberRole"
+                                    class="px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                <option value="member">Member</option>
+                                <option value="admin">Admin</option>
+                            </select>
+                        </div>
+                        <button @click="addTeamMember" :disabled="!newMemberUserId"
+                                class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] disabled:opacity-50 disabled:cursor-not-allowed">
+                            <i class="fas fa-plus"></i> Add
+                        </button>
+                    </div>
+                </div>
+
+                <!-- Current Members -->
+                <div>
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Current Members (${ teamMembers.length })</h4>
+                    <div v-if="teamMembers.length > 0" class="space-y-2">
+                        <div v-for="member in teamMembers" :key="member.user_id"
+                             class="flex items-center justify-between p-3 bg-[var(--bg-tertiary)] rounded-md">
+                            <div class="flex items-center space-x-3">
+                                <i class="fas fa-user text-[var(--text-muted)]"></i>
+                                <div>
+                                    <div class="text-sm font-medium text-[var(--text-primary)]">${ member.username }</div>
+                                    <div class="text-xs text-[var(--text-muted)]">${ member.email }</div>
+                                </div>
+                            </div>
+                            <div class="flex items-center space-x-2">
+                                <select v-model="member.role" @change="updateMemberRole(member)"
+                                        class="px-2 py-1 text-sm border border-[var(--border-secondary)] rounded bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    <option value="member">Member</option>
+                                    <option value="admin">Admin</option>
+                                </select>
+                                <button @click="removeTeamMember(member)"
+                                        class="text-red-500 hover:text-red-700" title="Remove from group">
+                                    <i class="fas fa-times"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                    <div v-else class="text-center py-4 text-[var(--text-muted)]">
+                        ${t('adminDashboard.noMembersYet')}
+                    </div>
+                </div>
+
+                <div v-if="teamMemberError" class="mt-4 p-3 bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] rounded-md text-sm">
+                    ${ teamMemberError }
+                </div>
+
+                <div class="flex justify-between mt-6">
+                    <button @click="syncTeamShares"
+                            class="px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 flex items-center gap-2">
+                        <i class="fas fa-sync-alt"></i>
+                        Sync Group Shares
+                    </button>
+                    <button @click="closeManageTeamModal"
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        Done
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Sync Group Shares Confirmation Modal -->
+        <div v-if="showSyncSharesModal" @click.self="showSyncSharesModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Sync Group Shares</h3>
+                    <button @click="showSyncSharesModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <p class="mb-4 text-[var(--text-secondary)]">
+                    This will create shares for all recordings with group tags that have auto-sharing enabled.
+                </p>
+                <p class="mb-4 text-[var(--text-muted)] text-sm">
+                    <i class="fas fa-info-circle mr-1"></i>
+                    Only missing shares will be created - existing shares won't be duplicated.
+                </p>
+                <div class="flex justify-end space-x-3">
+                    <button @click="showSyncSharesModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
+                    <button @click="confirmSyncShares" class="px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700">
+                        <i class="fas fa-sync-alt mr-2"></i>Sync Now
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Sync Results Modal -->
+        <div v-if="showSyncResultsModal" @click.self="showSyncResultsModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">
+                        <i class="fas fa-check-circle text-green-500 mr-2"></i>Sync Complete
+                    </h3>
+                    <button @click="showSyncResultsModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <div class="mb-4 space-y-2">
+                    <div class="flex justify-between text-[var(--text-secondary)]">
+                        <span>Shares created:</span>
+                        <span class="font-semibold">${ syncResults.shares_created }</span>
+                    </div>
+                    <div class="flex justify-between text-[var(--text-secondary)]">
+                        <span>Recordings processed:</span>
+                        <span class="font-semibold">${ syncResults.recordings_processed }</span>
+                    </div>
+                </div>
+                <div class="flex justify-end">
+                    <button @click="showSyncResultsModal = false" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        Done
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Delete Group Confirmation Modal -->
+        <div v-if="showDeleteTeamModal" @click.self="showDeleteTeamModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Delete Group</h3>
+                    <button @click="showDeleteTeamModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <p class="mb-4 text-[var(--text-secondary)]">Are you sure you want to delete the group <span class="font-semibold">${ teamToDelete?.name }</span>? This will remove all members from the group. This action cannot be undone.</p>
+                <div class="flex justify-end space-x-3">
+                    <button @click="showDeleteTeamModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
+                    <button @click="deleteTeam" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">Delete Group</button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Manage Group Tags Modal -->
+        <div v-if="showManageTeamTagsModal" @click.self="closeManageTeamTagsModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-3xl max-h-[90vh] overflow-y-auto">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Manage Tags for ${ currentTeam?.name }</h3>
+                    <button @click="closeManageTeamTagsModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+
+                <!-- Create/Edit Tag Form -->
+                <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg mb-4 border border-[var(--border-primary)]">
+                    <div class="flex justify-between items-center mb-3">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)]">
+                            ${ editingTeamTagId ? 'Edit Group Tag' : 'Create New Group Tag' }
+                        </h4>
+                        <button v-if="editingTeamTagId" @click="cancelEditTeamTag" type="button" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                            <i class="fas fa-times mr-1"></i> Cancel
+                        </button>
+                    </div>
+                    <form @submit.prevent="saveTeamTag" class="space-y-3">
+                        <div class="grid grid-cols-2 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Tag Name *</label>
+                                <input v-model="newTeamTag.name" type="text" required maxlength="50"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="e.g., Project Alpha">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Color</label>
+                                <input v-model="newTeamTag.color" type="color"
+                                       class="w-full h-10 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] cursor-pointer">
+                            </div>
+                        </div>
+
+                        <!-- Custom Prompt -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Custom Summarization Prompt
+                                <span class="text-[var(--text-muted)] font-normal">- Optional AI instructions</span>
+                            </label>
+                            <textarea v-model="newTeamTag.custom_prompt" rows="3"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Enter custom instructions for AI summarization (e.g., 'Focus on action items and deadlines')"></textarea>
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings with this tag will use this prompt for AI summaries and chat.
+                            </p>
+                        </div>
+
+                        <!-- Transcription Settings -->
+                        <div class="grid grid-cols-3 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Default Language</label>
+                                <select v-model="newTeamTag.default_language"
+                                        class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]">
+                                    <option value="">Auto-detect</option>
+                                    <option value="en">English</option>
+                                    <option value="es">Spanish</option>
+                                    <option value="fr">French</option>
+                                    <option value="de">German</option>
+                                    <option value="zh">Chinese</option>
+                                    <option value="ja">Japanese</option>
+                                    <option value="pt">Portuguese</option>
+                                    <option value="it">Italian</option>
+                                </select>
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Min Speakers</label>
+                                <input v-model.number="newTeamTag.default_min_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="1">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Max Speakers</label>
+                                <input v-model.number="newTeamTag.default_max_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="5">
+                            </div>
+                        </div>
+
+                        <!-- Retention and Protection -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Retention Period (days)
+                                <span class="text-[var(--text-muted)] font-normal">- Optional override for auto-deletion</span>
+                            </label>
+                            <input v-model.number="newTeamTag.retention_days" type="number" min="0" step="1"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Leave empty to use global retention">
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings with this tag will be deleted after this many days. Leave empty to use global retention (${ globalRetentionDays } days).
+                            </p>
+                        </div>
+                        <div class="flex items-center">
+                            <input v-model="newTeamTag.protect_from_deletion" type="checkbox" id="protectFromDeletion"
+                                   class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                            <label for="protectFromDeletion" class="text-xs text-[var(--text-secondary)]">
+                                <i class="fas fa-shield-alt mr-1"></i> Protect recordings with this tag from auto-deletion
+                            </label>
+                        </div>
+                        <div class="space-y-2">
+                            <div class="flex items-center">
+                                <input v-model="newTeamTag.auto_share_on_apply" type="checkbox" id="autoShareOnApply"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="autoShareOnApply" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-friends mr-1"></i> Auto-share recordings with all group members when this tag is applied
+                                </label>
+                            </div>
+                            <div class="flex items-center">
+                                <input v-model="newTeamTag.share_with_group_lead" type="checkbox" id="shareWithGroupLead"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="shareWithGroupLead" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-tie mr-1"></i> Share recordings with group admins when this tag is applied
+                                </label>
+                            </div>
+                            <p class="text-xs text-[var(--text-muted)] ml-6">
+                                Note: If both are enabled, all group members will have access. If only "group admins" is enabled, only group leads will have access.
+                            </p>
+                        </div>
+                        <div v-if="teamTagError" class="text-[var(--text-danger)] text-xs">${ teamTagError }</div>
+                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] text-sm">
+                            <i :class="editingTeamTagId ? 'fas fa-save' : 'fas fa-plus'" class="mr-1"></i>
+                            ${ editingTeamTagId ? 'Update Tag' : 'Create Tag' }
+                        </button>
+                    </form>
+                </div>
+
+                <!-- Existing Group Tags -->
+                <div>
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Group Tags</h4>
+                    <div v-if="teamTags.length > 0" class="space-y-3">
+                        <div v-for="tag in teamTags" :key="tag.id"
+                             class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex items-start justify-between mb-2">
+                                <div class="flex items-center space-x-3 flex-1">
+                                    <span class="inline-block w-4 h-4 rounded flex-shrink-0" :style="{ backgroundColor: tag.color }"></span>
+                                    <div class="flex-1">
+                                        <div class="text-sm font-medium text-[var(--text-primary)]">${ tag.name }</div>
+                                        <div class="text-xs text-[var(--text-muted)] mt-1 space-x-3">
+                                            <span v-if="tag.retention_days">
+                                                <i class="fas fa-clock mr-1"></i> ${ tag.retention_days } day retention
+                                            </span>
+                                            <span v-else>
+                                                <i class="fas fa-globe mr-1"></i> Global retention
+                                            </span>
+                                            <span v-if="tag.protect_from_deletion" class="text-green-500">
+                                                <i class="fas fa-shield-alt mr-1"></i> Protected
+                                            </span>
+                                        </div>
+                                    </div>
+                                </div>
+                                <div class="flex gap-2 flex-shrink-0">
+                                    <button @click="editTeamTag(tag)" class="text-blue-500 hover:text-blue-700 px-2 py-1" title="Edit Tag">
+                                        <i class="fas fa-edit"></i>
+                                    </button>
+                                    <button @click="deleteTeamTag(tag)" class="text-red-500 hover:text-red-700 px-2 py-1" title="Delete Tag">
+                                        <i class="fas fa-trash"></i>
+                                    </button>
+                                </div>
+                            </div>
+
+                            <!-- Additional details if configured -->
+                            <div v-if="tag.custom_prompt || tag.default_language || tag.default_min_speakers || tag.default_max_speakers"
+                                 class="mt-2 pt-2 border-t border-[var(--border-secondary)] space-y-1">
+                                <div v-if="tag.custom_prompt" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-comment-dots mr-1"></i> Custom prompt configured
+                                </div>
+                                <div v-if="tag.default_language" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-language mr-1"></i> Language: ${ tag.default_language.toUpperCase() }
+                                </div>
+                                <div v-if="tag.default_min_speakers || tag.default_max_speakers" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-users mr-1"></i> Speakers:
+                                    <span v-if="tag.default_min_speakers">${ tag.default_min_speakers }-</span><span v-if="tag.default_max_speakers">${ tag.default_max_speakers }</span><span v-else>auto</span>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <div v-else class="text-center py-8 text-[var(--text-muted)]">
+                        <i class="fas fa-tags text-3xl mb-2"></i>
+                        <p class="text-sm">No group tags created yet</p>
+                    </div>
+                </div>
+            </div>
+        </div>
     </div>
-    
+
     <script>
         const { createApp, ref, computed, onMounted, watch } = Vue
         
-        createApp({
+        // Initialize i18n before Vue app creation
+        initializeI18n().then(() => {
+            // Get the i18n instance to properly bind the t function
+            const i18nInstance = window.i18n;
+            
+            createApp({
             setup() {
+                
                 // State
-                const activeTab = ref('users');
+                const isTeamAdminOnly = ref({% if is_group_admin_only %}true{% else %}false{% endif %});
+                const activeTab = ref({% if is_group_admin_only %}'teams'{% else %}'users'{% endif %});
                 const users = ref([]);
                 const stats = ref({
                     total_users: 0,
@@ -446,10 +1894,168 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                     failed_recordings: 0,
                     top_users: []
                 });
+                const tokenStats = ref({
+                    today: { tokens: 0, cost: 0 },
+                    current_month: { tokens: 0, cost: 0 },
+                    user_count_with_usage: 0,
+                    users_over_80_percent: 0,
+                    users_at_100_percent: 0
+                });
+                const tokenUserStats = ref([]);
+                const transcriptionStats = ref({
+                    today: { seconds: 0, minutes: 0, cost: 0 },
+                    current_month: { seconds: 0, minutes: 0, cost: 0 },
+                    user_count_with_usage: 0,
+                    users_over_80_percent: 0,
+                    users_at_100_percent: 0
+                });
+                const transcriptionUserStats = ref([]);
+                const dailyTokenChart = ref(null);
+                const monthlyTokenChart = ref(null);
+                const dailyEmbeddingChart = ref(null);
+                const monthlyEmbeddingChart = ref(null);
+                const settings = ref([]);
+                // Transcription model curation state
+                const visibleTranscriptionModels = ref([]); // [{value, label}, ...]
+                const transcriptionDefaultModel = ref(null);
+                const transcriptionDefaultModelSaved = ref(null); // For change tracking
+                const modelDiscoveryResult = ref(null);
+                const modelDiscoveryError = ref('');
+                const discoveringModels = ref(false);
+                const savingModels = ref(false);
+                const modelSaveMessage = ref('');
+                const modelSaveError = ref(false);
+                const manualModelRows = ref([]); // for "Add custom model id" entries
+
+                // Combined view: discovered ∪ saved ∪ manual, deduped by id.
+                const transcriptionModelRows = computed(() => {
+                    const map = new Map();
+                    // Saved selections come first so order is stable.
+                    for (const opt of visibleTranscriptionModels.value) {
+                        if (opt && opt.value && !map.has(opt.value)) {
+                            map.set(opt.value, {
+                                value: opt.value,
+                                label: opt.label || opt.value,
+                                visible: true,
+                                source: 'saved',
+                            });
+                        }
+                    }
+                    // Discovery additions
+                    const discovered = (modelDiscoveryResult.value && modelDiscoveryResult.value.models) || [];
+                    for (const m of discovered) {
+                        if (!m.id) continue;
+                        if (map.has(m.id)) {
+                            const row = map.get(m.id);
+                            if (row.source === 'saved') row.source = 'saved + discovered';
+                        } else {
+                            map.set(m.id, {
+                                value: m.id,
+                                label: m.label || m.id,
+                                visible: false,
+                                source: 'discovered (' + (m.owned_by || 'unknown') + ')',
+                            });
+                        }
+                    }
+                    // Manual additions
+                    for (const m of manualModelRows.value) {
+                        if (!m.value) continue;
+                        if (!map.has(m.value)) {
+                            map.set(m.value, {
+                                value: m.value,
+                                label: m.label || m.value,
+                                visible: true,
+                                source: 'manual',
+                            });
+                        }
+                    }
+                    return Array.from(map.values());
+                });
+
+                const loadVisibleTranscriptionModels = async () => {
+                    try {
+                        const r = await fetch('/admin/transcription/visible-models');
+                        if (!r.ok) return;
+                        const data = await r.json();
+                        visibleTranscriptionModels.value = (data.options || []).map(o => ({
+                            value: o.value,
+                            label: o.label || o.value,
+                        }));
+                        transcriptionDefaultModel.value = data.default_model || null;
+                        transcriptionDefaultModelSaved.value = data.default_model || null;
+                    } catch (e) {
+                        console.error('Failed to load visible transcription models:', e);
+                    }
+                };
+
+                const discoverTranscriptionModels = async () => {
+                    discoveringModels.value = true;
+                    modelDiscoveryError.value = '';
+                    try {
+                        const r = await fetch('/admin/transcription/discover-models');
+                        const data = await r.json();
+                        if (!r.ok) {
+                            modelDiscoveryError.value = data.error || 'Discovery failed';
+                            modelDiscoveryResult.value = null;
+                        } else {
+                            modelDiscoveryResult.value = data;
+                            if (data.supported && (!data.models || data.models.length === 0)) {
+                                modelDiscoveryError.value = 'Connector reports no models. Is the upstream service running?';
+                            }
+                        }
+                    } catch (e) {
+                        modelDiscoveryError.value = 'Network error: ' + e.message;
+                    } finally {
+                        discoveringModels.value = false;
+                    }
+                };
+
+                const addManualTranscriptionModel = () => {
+                    const id = window.prompt('Enter the model id (e.g. whisper-1, large-v3, voxtral-mini-latest):');
+                    if (!id) return;
+                    manualModelRows.value.push({ value: id.trim(), label: id.trim() });
+                };
+
+                const saveVisibleTranscriptionModels = async () => {
+                    savingModels.value = true;
+                    modelSaveMessage.value = '';
+                    modelSaveError.value = false;
+                    try {
+                        const visible = transcriptionModelRows.value
+                            .filter(r => r.visible)
+                            .map(r => ({ value: r.value, label: r.label || r.value }));
+                        // Drop default if it's not in the visible list anymore
+                        const defaultModel = visible.some(o => o.value === transcriptionDefaultModel.value)
+                            ? transcriptionDefaultModel.value
+                            : null;
+                        const r = await fetch('/admin/transcription/visible-models', {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').getAttribute('content'),
+                            },
+                            body: JSON.stringify({ options: visible, default_model: defaultModel }),
+                        });
+                        const data = await r.json();
+                        if (!r.ok) throw new Error(data.error || 'Save failed');
+                        visibleTranscriptionModels.value = data.options || [];
+                        transcriptionDefaultModel.value = data.default_model || null;
+                        transcriptionDefaultModelSaved.value = data.default_model || null;
+                        manualModelRows.value = [];
+                        modelSaveMessage.value = `Saved ${data.options.length} model${data.options.length === 1 ? '' : 's'}.`;
+                    } catch (e) {
+                        modelSaveMessage.value = 'Save failed: ' + e.message;
+                        modelSaveError.value = true;
+                    } finally {
+                        savingModels.value = false;
+                    }
+                };
+
                 const isLoadingUsers = ref(true);
+                const isLoadingSettings = ref(false);
                 const userSearchQuery = ref('');
                 const isDarkMode = ref(false);
-                const isDropdownOpen = ref(false);
+                const isUserMenuOpen = ref(false);
                 
                 // Modal state
                 const showAddUserModal = ref(false);
@@ -460,21 +2066,114 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                     email: '',
                     password: '',
                     confirmPassword: '',
-                    isAdmin: false
+                    isAdmin: false,
+                    monthlyTokenBudget: null,
+                    monthlyTranscriptionBudgetMinutes: null
                 });
                 const editingUser = ref(null);
                 const userToDelete = ref(null);
                 
+                // Inquire Mode state
+                const inquireModeEnabled = ref({{ 'true' if inquire_mode_enabled else 'false' }});
+                const inquireStatus = ref({
+                    total_completed_recordings: 0,
+                    recordings_with_transcriptions: 0,
+                    processed_for_inquire: 0,
+                    need_processing: 0,
+                    total_chunks: 0,
+                    embeddings_available: false
+                });
+                const isProcessingRecordings = ref(false);
+                const processingResult = ref(null);
+
+                // Teams state
+                const groups = ref([]);
+                const showTeamModal = ref(false);
+                const showManageTeamModal = ref(false);
+                const showDeleteTeamModal = ref(false);
+                const showSyncSharesModal = ref(false);
+                const showSyncResultsModal = ref(false);
+                const syncResults = ref({ shares_created: 0, recordings_processed: 0 });
+                const editingTeam = ref(null);
+                const teamToDelete = ref(null);
+                const currentTeam = ref(null);
+                const teamForm = ref({ name: '', description: '' });
+                const teamError = ref('');
+                const teamMembers = ref([]);
+                const newMemberUserId = ref('');
+                const newMemberRole = ref('member');
+                const teamMemberError = ref('');
+
+                // Group Tags state
+                const showManageTeamTagsModal = ref(false);
+                const teamTags = ref([]);
+                const editingTeamTagId = ref(null);
+                const newTeamTag = ref({
+                    name: '',
+                    color: '#3B82F6',
+                    custom_prompt: '',
+                    default_language: '',
+                    default_min_speakers: null,
+                    default_max_speakers: null,
+                    retention_days: null,
+                    protect_from_deletion: false,
+                    auto_share_on_apply: true,
+                    share_with_group_lead: true
+                });
+                const teamTagError = ref('');
+                const globalRetentionDays = ref({{ global_retention_days }});
+
+                // Default Prompts state
+                const defaultSummaryPrompt = ref('');
+                const isSavingPrompt = ref(false);
+                const promptSaveMessage = ref('');
+                const promptSaveError = ref(false);
+                const showFullPromptStructure = ref(false);
+                const originalDefaultPrompt = `Generate a comprehensive summary that includes the following sections:
+- **Key Issues Discussed**: A bulleted list of the main topics
+- **Key Decisions Made**: A bulleted list of any decisions reached
+- **Action Items**: A bulleted list of tasks assigned, including who is responsible if mentioned`;
+
+                {% raw %}
+                // Render a prompt-preview string with placeholder chips:
+                //   { var }   -> blue chip ("system-replaced", e.g. {transcript_text})
+                //   {{ var }} -> amber chip ("user value at upload time")
+                // HTML-escape the source first so any stray markup is rendered as text.
+                const _escapeHtml = (s) => String(s).replace(/[&<>"']/g, c => ({
+                    '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
+                }[c]));
+                const formatPromptPreview = (text) => {
+                    if (!text) return '';
+                    return _escapeHtml(text)
+                        // Amber for {{user_var}} — substituted at upload/reprocess time. Match
+                        // first because it is the longer pattern; prevents single-brace pass
+                        // from biting into the inner {var}.
+                        .replace(/\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g,
+                            '<span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-amber-500/15 text-amber-300 border border-amber-500/30" title="User-supplied variable. Filled at upload or reprocess.">{{$1}}</span>')
+                        // Blue for {system_var} — replaced by the framework (current_date,
+                        // tag_names, transcript_text, ...). Only match identifier-shaped
+                        // names so we don't mangle JSON-looking literals.
+                        .replace(/\{(\s*[A-Za-z_][A-Za-z0-9_]*\s*)\}/g,
+                            '<span class="px-1.5 py-0.5 rounded text-[11px] font-semibold bg-blue-500/15 text-blue-300 border border-blue-500/30" title="System placeholder. Replaced by the framework before the LLM call.">{$1}</span>');
+                };
+                {% endraw %}
+                
                 // Computed properties
                 const filteredUsers = computed(() => {
                     if (!userSearchQuery.value) return users.value;
-                    
+
                     const query = userSearchQuery.value.toLowerCase();
-                    return users.value.filter(user => 
-                        user.username.toLowerCase().includes(query) || 
+                    return users.value.filter(user =>
+                        user.username.toLowerCase().includes(query) ||
                         user.email.toLowerCase().includes(query)
                     );
                 });
+
+                const availableUsers = computed(() => {
+                    if (!currentTeam.value) return users.value;
+                    const memberUserIds = teamMembers.value.map(m => m.user_id);
+                    return users.value.filter(user => !memberUserIds.includes(user.id));
+                });
                 
                 // Methods
                 const loadUsers = async () => {
@@ -506,139 +2205,978 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                     }
                 };
                 
-                const addUser = async () => {
-                    if (newUser.value.password !== newUser.value.confirmPassword) {
-                        alert('Passwords do not match');
-                        return;
+                const loadSettings = async () => {
+                    isLoadingSettings.value = true;
+                    try {
+                        const response = await fetch('/admin/settings');
+                        if (response.status === 429) {
+                            throw new Error('Rate limit exceeded. Please wait a moment and try again.');
+                        }
+                        if (!response.ok) throw new Error('Failed to load settings');
+
+                        const data = await response.json();
+                        // Sort so related settings are grouped together
+                        const settingOrder = [
+                            'transcript_length_limit',
+                            'max_file_size_mb',
+                            'asr_timeout_seconds',
+                            'admin_default_summary_prompt',
+                            'recording_disclaimer',
+                            'upload_disclaimer',
+                            'custom_banner',
+                            'disable_auto_summarization',
+                            'enable_folders'
+                        ];
+                        data.sort((a, b) => {
+                            const ai = settingOrder.indexOf(a.key);
+                            const bi = settingOrder.indexOf(b.key);
+                            // Unknown keys go to the end in original order
+                            const aOrder = ai === -1 ? settingOrder.length : ai;
+                            const bOrder = bi === -1 ? settingOrder.length : bi;
+                            return aOrder - bOrder;
+                        });
+                        settings.value = data;
+                    } catch (error) {
+                        console.error('Error loading settings:', error);
+                        // Show error notification
+                    } finally {
+                        isLoadingSettings.value = false;
+                    }
+                };
+
+                // Token Stats Functions
+                const loadTokenStats = async () => {
+                    try {
+                        // Load summary stats
+                        const statsResponse = await fetch('/admin/token-stats');
+                        if (statsResponse.ok) {
+                            tokenStats.value = await statsResponse.json();
+                        }
+
+                        // Load user stats
+                        const userStatsResponse = await fetch('/admin/token-stats/users');
+                        if (userStatsResponse.ok) {
+                            const data = await userStatsResponse.json();
+                            tokenUserStats.value = data.users || [];
+                        }
+
+                        // Load and render charts
+                        await loadTokenCharts();
+                    } catch (error) {
+                        console.error('Error loading token stats:', error);
+                    }
+                };
+
+                const loadTokenCharts = async () => {
+                    try {
+                        const dailyResponse = await fetch('/admin/token-stats/daily?days=30');
+                        if (dailyResponse.ok) {
+                            const { stats } = await dailyResponse.json();
+                            renderDailyChart(stats);
+                        }
+                        const monthlyResponse = await fetch('/admin/token-stats/monthly?months=12');
+                        if (monthlyResponse.ok) {
+                            const { stats } = await monthlyResponse.json();
+                            renderMonthlyChart(stats);
+                        }
+                    } catch (error) {
+                        console.error('Error loading token charts:', error);
+                    }
+                };
+
+                // Transcription Stats Functions
+                const loadTranscriptionStats = async () => {
+                    try {
+                        // Load summary stats
+                        const statsResponse = await fetch('/admin/transcription-stats');
+                        if (statsResponse.ok) {
+                            transcriptionStats.value = await statsResponse.json();
+                        }
+
+                        // Load user stats
+                        const userStatsResponse = await fetch('/admin/transcription-stats/users');
+                        if (userStatsResponse.ok) {
+                            const data = await userStatsResponse.json();
+                            transcriptionUserStats.value = data.users || [];
+                        }
+                    } catch (error) {
+                        console.error('Error loading transcription stats:', error);
+                    }
+                };
+
+                // Shared bar-chart factory: builds either the LLM or embedding
+                // daily chart against its own canvas. LLM and embedding tokens
+                // never share a chart since their magnitudes and per-token
+                // costs differ by orders of magnitude.
+                const _renderDailyBar = (canvasId, ref_, dataField, displayLabel, colorRgb) => {
+                    const ctx = document.getElementById(canvasId);
+                    if (!ctx) return;
+                    if (ref_.value) ref_.value.destroy();
+                    const isDark = document.documentElement.classList.contains('dark');
+                    const textColor = isDark ? '#9ca3af' : '#6b7280';
+                    const gridColor = isDark ? '#374151' : '#e5e7eb';
+                    ref_.value = new Chart(ctx, {
+                        type: 'bar',
+                        data: {
+                            labels: window._dailyLabels || [],
+                            datasets: [{
+                                label: displayLabel,
+                                data: window._dailyData ? window._dailyData.map(d => d[dataField] || 0) : [],
+                                backgroundColor: `rgba(${colorRgb}, ${isDark ? 0.7 : 0.7})`,
+                                borderColor: `rgba(${colorRgb}, 1)`,
+                                borderWidth: 1
+                            }]
+                        },
+                        options: {
+                            responsive: true,
+                            maintainAspectRatio: false,
+                            plugins: { legend: { display: false } },
+                            scales: {
+                                x: { ticks: { color: textColor, maxRotation: 45, minRotation: 45 }, grid: { color: gridColor } },
+                                y: { beginAtZero: true, ticks: { color: textColor }, grid: { color: gridColor } }
+                            }
+                        }
+                    });
+                };
+
+                const renderDailyChart = (data) => {
+                    window._dailyLabels = data.map(d => d.date);
+                    window._dailyData = data;
+                    _renderDailyBar('dailyTokenChart', dailyTokenChart, 'llm_tokens', 'LLM tokens', '79, 70, 229');
+                    _renderDailyBar('dailyEmbeddingChart', dailyEmbeddingChart, 'embedding_tokens', 'Embedding tokens', '34, 197, 94');
+                };
+
+                // Shared line-chart factory for monthly LLM vs embedding usage.
+                const _renderMonthlyLine = (canvasId, ref_, labels, values, displayLabel, colorRgb) => {
+                    const ctx = document.getElementById(canvasId);
+                    if (!ctx) return;
+                    if (ref_.value) ref_.value.destroy();
+                    const isDark = document.documentElement.classList.contains('dark');
+                    const textColor = isDark ? '#9ca3af' : '#6b7280';
+                    const gridColor = isDark ? '#374151' : '#e5e7eb';
+                    ref_.value = new Chart(ctx, {
+                        type: 'line',
+                        data: {
+                            labels: labels,
+                            datasets: [{
+                                label: displayLabel,
+                                data: values,
+                                fill: true,
+                                backgroundColor: `rgba(${colorRgb}, 0.2)`,
+                                borderColor: `rgba(${colorRgb}, 1)`,
+                                borderWidth: 2,
+                                tension: 0.3
+                            }]
+                        },
+                        options: {
+                            responsive: true,
+                            maintainAspectRatio: false,
+                            plugins: { legend: { display: false } },
+                            scales: {
+                                x: { ticks: { color: textColor }, grid: { color: gridColor } },
+                                y: { beginAtZero: true, ticks: { color: textColor }, grid: { color: gridColor } }
+                            }
+                        }
+                    });
+                };
+
+                const renderMonthlyChart = (data) => {
+                    const monthNames = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+                    const labels = data.map(d => `${monthNames[d.month - 1]} ${d.year}`);
+                    const llm = data.map(d => d.llm_tokens || 0);
+                    const emb = data.map(d => d.embedding_tokens || 0);
+                    _renderMonthlyLine('monthlyTokenChart', monthlyTokenChart, labels, llm, 'LLM tokens', '22, 163, 74');
+                    _renderMonthlyLine('monthlyEmbeddingChart', monthlyEmbeddingChart, labels, emb, 'Embedding tokens', '79, 70, 229');
+                };
+
+                const showEditSettingModal = ref(false);
+                const editingSetting = ref(null);
+                const settingNewValue = ref('');
+                const settingUseNoLimit = ref(false);
+                const settingTimeoutMinutes = ref(30);
+                const settingTimeoutSeconds = ref(0);
+                const settingError = ref('');
+                
+                const editSetting = (setting) => {
+                    editingSetting.value = { ...setting };
+                    settingError.value = '';
+                    
+                    // Initialize form values based on setting type and key
+                    if (setting.key === 'transcript_length_limit') {
+                        if (setting.value === '-1') {
+                            settingUseNoLimit.value = true;
+                            settingNewValue.value = 30000; // Default if unchecked
+                        } else {
+                            settingUseNoLimit.value = false;
+                            settingNewValue.value = parseInt(setting.value) || 30000;
+                        }
+                    } else if (setting.key === 'asr_timeout_seconds') {
+                        const totalSeconds = parseInt(setting.value) || 1800;
+                        settingTimeoutMinutes.value = Math.floor(totalSeconds / 60);
+                        settingTimeoutSeconds.value = totalSeconds % 60;
+                    } else if (setting.setting_type === 'boolean') {
+                        settingNewValue.value = setting.value || 'false';
+                    } else {
+                        settingNewValue.value = setting.value || '';
                     }
                     
+                    showEditSettingModal.value = true;
+                };
+                
+                const saveSettingValue = async () => {
+                    settingError.value = '';
+                    
+                    let finalValue;
+                    
+                    // Validate and prepare the value based on setting type
+                    if (editingSetting.value.key === 'transcript_length_limit') {
+                        if (settingUseNoLimit.value) {
+                            finalValue = '-1';
+                        } else {
+                            const num = parseInt(settingNewValue.value);
+                            if (isNaN(num) || num < 1000) {
+                                settingError.value = 'Please enter a valid number of at least 1000 characters';
+                                return;
+                            }
+                            finalValue = num.toString();
+                        }
+                    } else if (editingSetting.value.key === 'max_file_size_mb') {
+                        const num = parseInt(settingNewValue.value);
+                        if (isNaN(num) || num < 1 || num > 10000) {
+                            settingError.value = 'Please enter a valid size between 1 and 10000 MB';
+                            return;
+                        }
+                        finalValue = num.toString();
+                    } else if (editingSetting.value.key === 'asr_timeout_seconds') {
+                        const totalSeconds = (settingTimeoutMinutes.value * 60) + settingTimeoutSeconds.value;
+                        if (totalSeconds < 60) {
+                            settingError.value = 'Timeout must be at least 60 seconds';
+                            return;
+                        }
+                        if (totalSeconds > 36000) {
+                            settingError.value = 'Timeout cannot exceed 10 hours (36000 seconds)';
+                            return;
+                        }
+                        finalValue = totalSeconds.toString();
+                    } else if (editingSetting.value.setting_type === 'integer') {
+                        const num = parseInt(settingNewValue.value);
+                        if (isNaN(num)) {
+                            settingError.value = 'Please enter a valid integer';
+                            return;
+                        }
+                        finalValue = num.toString();
+                    } else if (editingSetting.value.setting_type === 'float') {
+                        const num = parseFloat(settingNewValue.value);
+                        if (isNaN(num)) {
+                            settingError.value = 'Please enter a valid number';
+                            return;
+                        }
+                        finalValue = num.toString();
+                    } else {
+                        finalValue = settingNewValue.value;
+                    }
+                    
+                    // Save the setting
+                    await updateSetting(
+                        editingSetting.value.key,
+                        finalValue,
+                        editingSetting.value.description,
+                        editingSetting.value.setting_type
+                    );
+                    
+                    showEditSettingModal.value = false;
+                };
+                
+                const updateSetting = async (key, value, description, settingType) => {
+                    try {
+                        // Get CSRF token
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        
+                        const headers = {
+                            'Content-Type': 'application/json'
+                        };
+                        
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+                        
+                        const response = await fetch('/admin/settings', {
+                            method: 'POST',
+                            headers: headers,
+                            body: JSON.stringify({
+                                key: key,
+                                value: value,
+                                description: description,
+                                setting_type: settingType
+                            })
+                        });
+                        
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to update setting');
+                        }
+                        
+                        // Reload settings
+                        await loadSettings();
+                        
+                    } catch (error) {
+                        console.error('Error updating setting:', error);
+                        alert(error.message);
+                    }
+                };
+                
+                const formatDate = (dateString) => {
+                    if (!dateString) return t('adminDashboard.never');
+                    const date = new Date(dateString);
+                    return date.toLocaleDateString() + ' ' + date.toLocaleTimeString();
+                };
+                
+                const getSettingDescription = (setting) => {
+                    // Map setting keys to translation keys
+                    const descriptionKeys = {
+                        'transcript_length_limit': 'adminDashboard.settings.transcriptLengthLimitDesc',
+                        'max_file_size_mb': 'adminDashboard.settings.maxFileSizeDesc',
+                        'asr_timeout_seconds': 'adminDashboard.settings.asrTimeoutDesc',
+                        'admin_default_summary_prompt': 'adminDashboard.settings.defaultSummaryPromptDesc',
+                        'recording_disclaimer': 'adminDashboard.settings.recordingDisclaimerDesc',
+                        'upload_disclaimer': 'adminDashboard.settings.uploadDisclaimerDesc',
+                        'custom_banner': 'adminDashboard.settings.customBannerDesc'
+                    };
+                    
+                    const key = descriptionKeys[setting.key];
+                    return key ? t(key) : setting.description || t('adminDashboard.noDescriptionAvailable');
+                };
+                
+                const addUser = async () => {
+                    if (newUser.value.password !== newUser.value.confirmPassword) {
+                        alert(t('adminDashboard.passwordsDoNotMatch'));
+                        return;
+                    }
+                    
+                    try {
+                        // Get CSRF token
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        
+                        const headers = {
+                            'Content-Type': 'application/json'
+                        };
+                        
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+                        
+                        const response = await fetch('/admin/users', {
+                            method: 'POST',
+                            headers: headers,
+                            body: JSON.stringify({
+                                username: newUser.value.username,
+                                email: newUser.value.email,
+                                password: newUser.value.password,
+                                is_admin: newUser.value.isAdmin,
+                                monthly_token_budget: newUser.value.monthlyTokenBudget || null,
+                                monthly_transcription_budget: newUser.value.monthlyTranscriptionBudgetMinutes ? newUser.value.monthlyTranscriptionBudgetMinutes * 60 : null
+                            })
+                        });
+                        
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to add user');
+                        }
+                        
+                        // Reset form and close modal
+                        newUser.value = {
+                            username: '',
+                            email: '',
+                            password: '',
+                            confirmPassword: '',
+                            isAdmin: false,
+                            monthlyTokenBudget: null,
+                            monthlyTranscriptionBudgetMinutes: null
+                        };
+                        showAddUserModal.value = false;
+                        
+                        // Reload users
+                        await loadUsers();
+                        await loadStats();
+                        
+                    } catch (error) {
+                        console.error('Error adding user:', error);
+                        alert(error.message);
+                    }
+                };
+                
+                const editUser = (user) => {
+                    editingUser.value = { ...user, password: '' };
+                    showEditUserModal.value = true;
+                };
+                
+                const updateUser = async () => {
+                    try {
+                        // Convert transcription budget from minutes to seconds
+                        const transcriptionBudgetSeconds = editingUser.value.monthly_transcription_budget_minutes
+                            ? editingUser.value.monthly_transcription_budget_minutes * 60
+                            : null;
+
+                        const payload = {
+                            username: editingUser.value.username,
+                            email: editingUser.value.email,
+                            is_admin: editingUser.value.is_admin,
+                            monthly_token_budget: editingUser.value.monthly_token_budget || null,
+                            monthly_transcription_budget: transcriptionBudgetSeconds
+                        };
+
+                        // Only include password if it was changed
+                        if (editingUser.value.password) {
+                            payload.password = editingUser.value.password;
+                        }
+                        
+                        // Get CSRF token
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        
+                        const headers = {
+                            'Content-Type': 'application/json'
+                        };
+                        
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+                        
+                        const response = await fetch(`/admin/users/${editingUser.value.id}`, {
+                            method: 'PUT',
+                            headers: headers,
+                            body: JSON.stringify(payload)
+                        });
+                        
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to update user');
+                        }
+                        
+                        // Close modal and reload users
+                        showEditUserModal.value = false;
+                        await loadUsers();
+                        
+                    } catch (error) {
+                        console.error('Error updating user:', error);
+                        alert(error.message);
+                    }
+                };
+                
+                const confirmDeleteUser = (user) => {
+                    userToDelete.value = user;
+                    showDeleteUserModal.value = true;
+                };
+                
+                const deleteUser = async () => {
+                    try {
+                        // Get CSRF token
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        
+                        const headers = {};
+                        
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+                        
+                        const response = await fetch(`/admin/users/${userToDelete.value.id}`, {
+                            method: 'DELETE',
+                            headers: headers
+                        });
+                        
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to delete user');
+                        }
+                        
+                        // Close modal and reload users
+                        showDeleteUserModal.value = false;
+                        await loadUsers();
+                        await loadStats();
+                        
+                    } catch (error) {
+                        console.error('Error deleting user:', error);
+                        alert(error.message);
+                    }
+                };
+                
+                const toggleAdminStatus = async (user) => {
+                    try {
+                        // Get CSRF token
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+
+                        const headers = {};
+
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+
+                        const response = await fetch(`/admin/users/${user.id}/toggle-admin`, {
+                            method: 'POST',
+                            headers: headers
+                        });
+
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to toggle admin status');
+                        }
+
+                        // Reload users
+                        await loadUsers();
+
+                    } catch (error) {
+                        console.error('Error toggling admin status:', error);
+                        alert(error.message);
+                    }
+                };
+
+                const togglePublicSharingPermission = async (user) => {
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+
+                        if (csrfToken) {
+                            headers['X-CSRFToken'] = csrfToken;
+                        }
+
+                        const response = await fetch(`/admin/users/${user.id}`, {
+                            method: 'PUT',
+                            headers: headers,
+                            body: JSON.stringify({
+                                can_share_publicly: !user.can_share_publicly
+                            })
+                        });
+
+                        if (!response.ok) {
+                            const errorData = await response.json();
+                            throw new Error(errorData.error || 'Failed to toggle public sharing permission');
+                        }
+
+                        // Reload users
+                        await loadUsers();
+
+                    } catch (error) {
+                        console.error('Error toggling public sharing permission:', error);
+                        alert(error.message);
+                    }
+                };
+
+                // Group Management Functions
+                const loadGroups = async () => {
+                    try {
+                        const response = await fetch('/api/admin/groups');
+                        if (!response.ok) throw new Error('Failed to load groups');
+                        const data = await response.json();
+                        groups.value = data.groups || [];
+                    } catch (error) {
+                        console.error('Error loading teams:', error);
+                    }
+                };
+
+                const openCreateTeamModal = () => {
+                    editingTeam.value = null;
+                    teamForm.value = { name: '', description: '' };
+                    teamError.value = '';
+                    showTeamModal.value = true;
+                };
+
+                const openEditTeamModal = (group) => {
+                    editingTeam.value = group;
+                    teamForm.value = { name: group.name, description: group.description || '' };
+                    teamError.value = '';
+                    showTeamModal.value = true;
+                };
+
+                const closeTeamModal = () => {
+                    showTeamModal.value = false;
+                    editingTeam.value = null;
+                    teamForm.value = { name: '', description: '' };
+                    teamError.value = '';
+                };
+
+                const saveTeam = async () => {
+                    teamError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const url = editingTeam.value
+                            ? `/api/admin/groups/${editingTeam.value.id}`
+                            : '/api/admin/groups';
+                        const method = editingTeam.value ? 'PUT' : 'POST';
+
+                        const response = await fetch(url, {
+                            method,
+                            headers,
+                            body: JSON.stringify(teamForm.value)
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to save group');
+                        }
+
+                        closeTeamModal();
+                        await loadGroups();
+                    } catch (error) {
+                        teamError.value = error.message;
+                    }
+                };
+
+                const confirmDeleteTeam = (group) => {
+                    teamToDelete.value = group;
+                    showDeleteTeamModal.value = true;
+                };
+
+                const deleteTeam = async () => {
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${teamToDelete.value.id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to delete group');
+                        }
+
+                        showDeleteTeamModal.value = false;
+                        teamToDelete.value = null;
+                        await loadGroups();
+                    } catch (error) {
+                        alert(error.message);
+                    }
+                };
+
+                const openManageTeamModal = async (group) => {
+                    currentTeam.value = group;
+                    newMemberUserId.value = '';
+                    newMemberRole.value = 'member';
+                    teamMemberError.value = '';
+                    showManageTeamModal.value = true;
+                    await loadTeamMembers(group.id);
+                };
+
+                const closeManageTeamModal = () => {
+                    showManageTeamModal.value = false;
+                    currentTeam.value = null;
+                    teamMembers.value = [];
+                    newMemberUserId.value = '';
+                    newMemberRole.value = 'member';
+                    teamMemberError.value = '';
+                };
+
+                const loadTeamMembers = async (groupId) => {
+                    try {
+                        const response = await fetch(`/api/admin/groups/${groupId}`);
+                        if (!response.ok) throw new Error('Failed to load group members');
+                        const data = await response.json();
+                        teamMembers.value = data.members || [];
+                    } catch (error) {
+                        console.error('Error loading group members:', error);
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const addTeamMember = async () => {
+                    if (!newMemberUserId.value) return;
+
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members`, {
+                            method: 'POST',
+                            headers,
+                            body: JSON.stringify({
+                                user_id: parseInt(newMemberUserId.value),
+                                role: newMemberRole.value
+                            })
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to add member');
+                        }
+
+                        newMemberUserId.value = '';
+                        newMemberRole.value = 'member';
+                        await loadTeamMembers(currentTeam.value.id);
+                        await loadGroups(); // Refresh to update member count
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const updateMemberRole = async (member) => {
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members/${member.user_id}`, {
+                            method: 'PUT',
+                            headers,
+                            body: JSON.stringify({ role: member.role })
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to update role');
+                        }
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                        await loadTeamMembers(currentTeam.value.id); // Reload to revert on error
+                    }
+                };
+
+                const removeTeamMember = async (member) => {
+                    if (!confirm(`Remove ${member.username} from the group?`)) return;
+
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members/${member.user_id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to remove member');
+                        }
+
+                        await loadTeamMembers(currentTeam.value.id);
+                        await loadGroups(); // Refresh to update member count
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const syncTeamShares = () => {
+                    if (!currentTeam.value) return;
+                    showSyncSharesModal.value = true;
+                };
+
+                const confirmSyncShares = async () => {
+                    showSyncSharesModal.value = false;
+                    teamMemberError.value = '';
+
                     try {
-                        const response = await fetch('/admin/users', {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/groups/${currentTeam.value.id}/sync-shares`, {
                             method: 'POST',
-                            headers: {
-                                'Content-Type': 'application/json'
-                            },
-                            body: JSON.stringify({
-                                username: newUser.value.username,
-                                email: newUser.value.email,
-                                password: newUser.value.password,
-                                is_admin: newUser.value.isAdmin
-                            })
+                            headers
                         });
-                        
+
                         if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to add user');
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to sync shares');
                         }
-                        
-                        // Reset form and close modal
-                        newUser.value = {
-                            username: '',
-                            email: '',
-                            password: '',
-                            confirmPassword: '',
-                            isAdmin: false
+
+                        const result = await response.json();
+                        syncResults.value = {
+                            shares_created: result.shares_created,
+                            recordings_processed: result.recordings_processed
                         };
-                        showAddUserModal.value = false;
-                        
-                        // Reload users
-                        await loadUsers();
-                        await loadStats();
-                        
+                        showSyncResultsModal.value = true;
                     } catch (error) {
-                        console.error('Error adding user:', error);
-                        alert(error.message);
+                        teamMemberError.value = error.message;
                     }
                 };
-                
-                const editUser = (user) => {
-                    editingUser.value = { ...user, password: '' };
-                    showEditUserModal.value = true;
+
+                // Group Tags Management
+                const openManageTeamTagsModal = async (group) => {
+                    currentTeam.value = group;
+                    teamTagError.value = '';
+                    await loadTeamTags(group.id);
+                    showManageTeamTagsModal.value = true;
                 };
-                
-                const updateUser = async () => {
+
+                const closeManageTeamTagsModal = () => {
+                    showManageTeamTagsModal.value = false;
+                    currentTeam.value = null;
+                    teamTags.value = [];
+                    editingTeamTagId.value = null;
+                    newTeamTag.value = {
+                        name: '',
+                        color: '#3B82F6',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamTagError.value = '';
+                };
+
+                const loadTeamTags = async (groupId) => {
                     try {
-                        const payload = {
-                            username: editingUser.value.username,
-                            email: editingUser.value.email,
-                            is_admin: editingUser.value.is_admin
-                        };
-                        
-                        // Only include password if it was changed
-                        if (editingUser.value.password) {
-                            payload.password = editingUser.value.password;
-                        }
-                        
-                        const response = await fetch(`/admin/users/${editingUser.value.id}`, {
-                            method: 'PUT',
-                            headers: {
-                                'Content-Type': 'application/json'
-                            },
-                            body: JSON.stringify(payload)
-                        });
-                        
-                        if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to update user');
-                        }
-                        
-                        // Close modal and reload users
-                        showEditUserModal.value = false;
-                        await loadUsers();
-                        
+                        const response = await fetch(`/api/groups/${groupId}/tags`);
+                        if (!response.ok) throw new Error('Failed to load group tags');
+                        const data = await response.json();
+                        teamTags.value = data.tags || [];
                     } catch (error) {
-                        console.error('Error updating user:', error);
-                        alert(error.message);
+                        teamTagError.value = error.message;
                     }
                 };
-                
-                const confirmDeleteUser = (user) => {
-                    userToDelete.value = user;
-                    showDeleteUserModal.value = true;
+
+                const editTeamTag = (tag) => {
+                    editingTeamTagId.value = tag.id;
+                    newTeamTag.value = {
+                        name: tag.name,
+                        color: tag.color,
+                        custom_prompt: tag.custom_prompt || '',
+                        default_language: tag.default_language || '',
+                        default_min_speakers: tag.default_min_speakers,
+                        default_max_speakers: tag.default_max_speakers,
+                        retention_days: tag.retention_days,
+                        protect_from_deletion: tag.protect_from_deletion || false,
+                        auto_share_on_apply: tag.auto_share_on_apply !== undefined ? tag.auto_share_on_apply : true,
+                        share_with_group_lead: tag.share_with_group_lead !== undefined ? tag.share_with_group_lead : true
+                    };
+                    // Scroll to top of modal
+                    document.querySelector('.max-h-\\[90vh\\]')?.scrollTo({ top: 0, behavior: 'smooth' });
                 };
-                
-                const deleteUser = async () => {
+
+                const cancelEditTeamTag = () => {
+                    editingTeamTagId.value = null;
+                    newTeamTag.value = {
+                        name: '',
+                        color: '#3B82F6',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamTagError.value = '';
+                };
+
+                const saveTeamTag = async () => {
+                    teamTagError.value = '';
                     try {
-                        const response = await fetch(`/admin/users/${userToDelete.value.id}`, {
-                            method: 'DELETE'
-                        });
-                        
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const payload = {
+                            name: newTeamTag.value.name,
+                            color: newTeamTag.value.color,
+                            protect_from_deletion: newTeamTag.value.protect_from_deletion,
+                            auto_share_on_apply: newTeamTag.value.auto_share_on_apply,
+                            share_with_group_lead: newTeamTag.value.share_with_group_lead
+                        };
+
+                        // Add custom prompt if provided
+                        if (newTeamTag.value.custom_prompt && newTeamTag.value.custom_prompt.trim()) {
+                            payload.custom_prompt = newTeamTag.value.custom_prompt.trim();
+                        }
+
+                        // Add language if selected
+                        if (newTeamTag.value.default_language) {
+                            payload.default_language = newTeamTag.value.default_language;
+                        }
+
+                        // Add speaker settings if provided
+                        if (newTeamTag.value.default_min_speakers) {
+                            payload.default_min_speakers = newTeamTag.value.default_min_speakers;
+                        }
+                        if (newTeamTag.value.default_max_speakers) {
+                            payload.default_max_speakers = newTeamTag.value.default_max_speakers;
+                        }
+
+                        // Only include retention_days if it's set and > 0
+                        if (newTeamTag.value.retention_days && newTeamTag.value.retention_days > 0) {
+                            payload.retention_days = newTeamTag.value.retention_days;
+                        }
+
+                        let response;
+                        if (editingTeamTagId.value) {
+                            // Update existing tag
+                            response = await fetch(`/api/tags/${editingTeamTagId.value}`, {
+                                method: 'PUT',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        } else {
+                            // Create new tag
+                            response = await fetch(`/api/groups/${currentTeam.value.id}/tags`, {
+                                method: 'POST',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        }
+
                         if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to delete user');
+                            const error = await response.json();
+                            throw new Error(error.error || (editingTeamTagId.value ? 'Failed to update tag' : 'Failed to create tag'));
                         }
-                        
-                        // Close modal and reload users
-                        showDeleteUserModal.value = false;
-                        await loadUsers();
-                        await loadStats();
-                        
+
+                        // Reset form and reload
+                        editingTeamTagId.value = null;
+                        newTeamTag.value = {
+                            name: '',
+                            color: '#3B82F6',
+                            custom_prompt: '',
+                            default_language: '',
+                            default_min_speakers: null,
+                            default_max_speakers: null,
+                            retention_days: null,
+                            protect_from_deletion: false,
+                            auto_share_on_apply: true,
+                            share_with_group_lead: true
+                        };
+                        await loadTeamTags(currentTeam.value.id);
                     } catch (error) {
-                        console.error('Error deleting user:', error);
-                        alert(error.message);
+                        teamTagError.value = error.message;
                     }
                 };
-                
-                const toggleAdminStatus = async (user) => {
+
+                const deleteTeamTag = async (tag) => {
+                    if (!confirm(`Delete the tag "${tag.name}"? This will remove the tag from all recordings.`)) return;
+
+                    teamTagError.value = '';
                     try {
-                        const response = await fetch(`/admin/users/${user.id}/toggle-admin`, {
-                            method: 'POST'
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/tags/${tag.id}`, {
+                            method: 'DELETE',
+                            headers
                         });
-                        
+
                         if (!response.ok) {
-                            const errorData = await response.json();
-                            throw new Error(errorData.error || 'Failed to toggle admin status');
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to delete tag');
                         }
-                        
-                        // Reload users
-                        await loadUsers();
-                        
+
+                        await loadTeamTags(currentTeam.value.id);
                     } catch (error) {
-                        console.error('Error toggling admin status:', error);
-                        alert(error.message);
+                        teamTagError.value = error.message;
                     }
                 };
-                
+
                 const formatFileSize = (bytes) => {
                     if (!bytes || bytes === 0) return '0 Bytes';
                     
@@ -664,7 +3202,7 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                 const initializeDarkMode = () => {
                     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
                     const savedMode = localStorage.getItem('darkMode');
-                    
+
                     if (savedMode === 'true' || (savedMode === null && prefersDark)) {
                         isDarkMode.value = true;
                         document.documentElement.classList.add('dark');
@@ -673,32 +3211,339 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                         document.documentElement.classList.remove('dark');
                     }
                 };
+
+                /**
+                 * Set up global click handler to close dropdowns when clicking outside
+                 * Provides elegant UX by closing menus when users click elsewhere
+                 */
+                const setupGlobalClickHandler = () => {
+                    document.addEventListener('click', (event) => {
+                        const target = event.target;
+
+                        // Close user menu if clicking outside of it
+                        if (isUserMenuOpen.value) {
+                            const userMenuButton = target.closest('[data-user-menu-toggle]');
+                            const userMenuDropdown = target.closest('[data-user-menu-dropdown]');
+
+                            if (!userMenuButton && !userMenuDropdown) {
+                                isUserMenuOpen.value = false;
+                            }
+                        }
+                    });
+                };
+
+                // Inquire Mode methods
+                // Default Prompts methods
+                const loadDefaultPrompt = async () => {
+                    try {
+                        // Use already loaded settings if available, otherwise load them
+                        let settingsData = settings.value;
+                        
+                        if (!settingsData || settingsData.length === 0) {
+                            const response = await fetch('/admin/settings');
+                            if (response.status === 429) {
+                                throw new Error('Rate limit exceeded. Please wait a moment and try again.');
+                            }
+                            if (!response.ok) throw new Error('Failed to load settings');
+                            settingsData = await response.json();
+                            settings.value = settingsData;
+                        }
+                        
+                        const promptSetting = settingsData.find(s => s.key === 'admin_default_summary_prompt');
+                        if (promptSetting) {
+                            defaultSummaryPrompt.value = promptSetting.value || '';
+                        }
+                    } catch (error) {
+                        console.error('Error loading default prompt:', error);
+                        promptSaveMessage.value = t('adminDashboard.errors.failedToLoadPrompt');
+                        promptSaveError.value = true;
+                    }
+                };
+                
+                const saveDefaultPrompt = async () => {
+                    isSavingPrompt.value = true;
+                    promptSaveMessage.value = '';
+                    promptSaveError.value = false;
+                    
+                    try {
+                        const response = await fetch('/admin/settings', {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').content
+                            },
+                            body: JSON.stringify({
+                                key: 'admin_default_summary_prompt',
+                                value: defaultSummaryPrompt.value,
+                                description: 'Default summarization prompt used when users have not set their own prompt. This serves as the base prompt for all users.',
+                                setting_type: 'string'
+                            })
+                        });
+                        
+                        if (!response.ok) throw new Error('Failed to save prompt');
+                        
+                        promptSaveMessage.value = t('adminDashboard.promptSavedSuccessfully');
+                        promptSaveError.value = false;
+                        
+                        // Clear message after 3 seconds
+                        setTimeout(() => {
+                            promptSaveMessage.value = '';
+                        }, 3000);
+                    } catch (error) {
+                        console.error('Error saving default prompt:', error);
+                        promptSaveMessage.value = t('adminDashboard.errors.failedToSavePrompt');
+                        promptSaveError.value = true;
+                    } finally {
+                        isSavingPrompt.value = false;
+                    }
+                };
+                
+                const resetDefaultPrompt = () => {
+                    defaultSummaryPrompt.value = originalDefaultPrompt;
+                    promptSaveMessage.value = t('adminDashboard.promptResetMessage');
+                    promptSaveError.value = false;
+                };
+                
+                const loadInquireStatus = async () => {
+                    try {
+                        const response = await fetch('/admin/inquire/status');
+                        if (!response.ok) throw new Error('Failed to load inquire status');
+                        
+                        const data = await response.json();
+                        inquireStatus.value = data;
+                    } catch (error) {
+                        console.error('Error loading inquire status:', error);
+                    }
+                };
+                
+                const processAllRecordings = async () => {
+                    if (isProcessingRecordings.value) return;
+                    
+                    isProcessingRecordings.value = true;
+                    processingResult.value = null;
+                    
+                    try {
+                        const response = await fetch('/admin/inquire/process-recordings', {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
+                            },
+                            body: JSON.stringify({})
+                        });
+                        
+                        if (!response.ok) throw new Error('Failed to process recordings');
+                        
+                        const data = await response.json();
+                        processingResult.value = data;
+                        
+                        // Reload status after processing
+                        await loadInquireStatus();
+                    } catch (error) {
+                        console.error('Error processing recordings:', error);
+                        processingResult.value = {
+                            success: false,
+                            message: 'Failed to process recordings. Please try again.'
+                        };
+                    } finally {
+                        isProcessingRecordings.value = false;
+                    }
+                };
+                
+                const reembedAllRecordings = async () => {
+                    if (isProcessingRecordings.value) return;
+                    if (!confirm('Re-embed every completed recording with the current configuration? Existing chunks will be deleted and rebuilt. This may take a while and (in API mode) will incur cost.')) {
+                        return;
+                    }
+                    isProcessingRecordings.value = true;
+                    processingResult.value = null;
+                    try {
+                        const response = await fetch('/admin/inquire/process-recordings', {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
+                            },
+                            body: JSON.stringify({ force: true })
+                        });
+                        if (!response.ok) throw new Error('Failed to re-embed recordings');
+                        const data = await response.json();
+                        processingResult.value = data;
+                        await loadInquireStatus();
+                    } catch (error) {
+                        console.error('Error re-embedding:', error);
+                        processingResult.value = { success: false, message: 'Failed to re-embed recordings.' };
+                    } finally {
+                        isProcessingRecordings.value = false;
+                    }
+                };
+
+                const processBatchRecordings = async (batchSize) => {
+                    if (isProcessingRecordings.value) return;
+                    
+                    isProcessingRecordings.value = true;
+                    processingResult.value = null;
+                    
+                    try {
+                        const response = await fetch('/admin/inquire/process-recordings', {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
+                            },
+                            body: JSON.stringify({ max_recordings: batchSize })
+                        });
+                        
+                        if (!response.ok) throw new Error('Failed to process recordings');
+                        
+                        const data = await response.json();
+                        processingResult.value = data;
+                        
+                        // Reload status after processing
+                        await loadInquireStatus();
+                    } catch (error) {
+                        console.error('Error processing recordings:', error);
+                        processingResult.value = {
+                            success: false,
+                            message: 'Failed to process recordings. Please try again.'
+                        };
+                    } finally {
+                        isProcessingRecordings.value = false;
+                    }
+                };
                 
-                // Lifecycle hooks
-                onMounted(() => {
-                    loadUsers();
-                    loadStats();
+                const getProcessingProgress = () => {
+                    const total = (inquireStatus.value.processed_for_inquire || 0) + (inquireStatus.value.need_processing || 0);
+                    if (total === 0) return 100;
+                    return Math.round((inquireStatus.value.processed_for_inquire / total) * 100);
+                };
+
+                // Built outside the template so the inline ${...} interpolation
+                // does not have to contain a JS object literal. Vue's custom
+                // ${...} delimiter does not track nested braces, so embedding
+                // `{ count: ... }` inside the interpolation breaks compilation.
+                const recordingsNeedProcessingMessage = computed(() =>
+                    t('adminDashboard.recordingsNeedProcessing', {
+                        count: inquireStatus.value.need_processing || 0,
+                    })
+                );
+                
+                // Lifecycle hooks - MUST be registered before any await statements
+                onMounted(async () => {
+                    // Only load admin-specific data if user is full admin
+                    if (!isTeamAdminOnly.value) {
+                        loadUsers();
+                        loadStats();
+                        loadTokenStats();
+                        loadTranscriptionStats();
+
+                        // Load settings first, then default prompt can use that data
+                        if (activeTab.value === 'settings' || activeTab.value === 'prompts') {
+                            await loadSettings();
+                        }
+                        loadDefaultPrompt();
+                        loadVisibleTranscriptionModels();
+
+                        if (inquireModeEnabled.value) {
+                            loadInquireStatus();
+                        }
+                    } else {
+                        // Group admins only need users list (for adding members) and groups
+                        loadUsers();
+                        loadGroups();
+                    }
+
                     initializeDarkMode();
+                    setupGlobalClickHandler();
+
+                    // Setup scroll indicators for tabs
+                    const tabsContainer = document.getElementById('admin-tabs-container');
+                    const leftIndicator = document.getElementById('admin-left-scroll-indicator');
+                    const rightIndicator = document.getElementById('admin-right-scroll-indicator');
+
+                    function updateScrollIndicators() {
+                        if (tabsContainer && leftIndicator && rightIndicator) {
+                            const scrollLeft = tabsContainer.scrollLeft;
+                            const scrollWidth = tabsContainer.scrollWidth;
+                            const clientWidth = tabsContainer.clientWidth;
+
+                            // Show/hide left indicator
+                            if (scrollLeft > 10) {
+                                leftIndicator.classList.remove('opacity-0');
+                                leftIndicator.classList.add('opacity-100');
+                            } else {
+                                leftIndicator.classList.remove('opacity-100');
+                                leftIndicator.classList.add('opacity-0');
+                            }
+
+                            // Show/hide right indicator
+                            if (scrollWidth - scrollLeft - clientWidth > 10) {
+                                rightIndicator.classList.remove('opacity-0');
+                                rightIndicator.classList.add('opacity-100');
+                            } else {
+                                rightIndicator.classList.remove('opacity-100');
+                                rightIndicator.classList.add('opacity-0');
+                            }
+                        }
+                    }
+
+                    if (tabsContainer) {
+                        tabsContainer.addEventListener('scroll', updateScrollIndicators);
+                        window.addEventListener('resize', updateScrollIndicators);
+                        // Initial check
+                        updateScrollIndicators();
+                        setTimeout(updateScrollIndicators, 100);
+                        setTimeout(updateScrollIndicators, 500);
+                    }
                 });
                 
                 // Watch for tab changes to reload data
-                watch(activeTab, (newTab) => {
-                    if (newTab === 'users') {
-                        loadUsers();
-                    } else if (newTab === 'stats') {
-                        loadStats();
+                watch(activeTab, async (newTab) => {
+                    // Only allow full admins to load admin-specific data
+                    if (!isTeamAdminOnly.value) {
+                        if (newTab === 'users') {
+                            loadUsers();
+                        } else if (newTab === 'stats') {
+                            loadStats();
+                        } else if (newTab === 'settings') {
+                            await loadSettings();
+                        } else if (newTab === 'prompts') {
+                            // If settings aren't loaded, load them first
+                            if (!settings.value || settings.value.length === 0) {
+                                await loadSettings();
+                            }
+                            loadDefaultPrompt();
+                        } else if (newTab === 'vectorstore' && inquireModeEnabled.value) {
+                            loadInquireStatus();
+                        }
+                    }
+
+                    // Both full admins and group admins can access teams
+                    if (newTab === 'groups') {
+                        loadGroups();
+                        loadUsers(); // Load users for member selection
                     }
                 });
                 
                 return {
+                    // i18n - bind to i18n instance to maintain context
+                    t: (key, params) => i18nInstance ? i18nInstance.t(key, params) : key,
+
                     // State
+                    isTeamAdminOnly,
                     activeTab,
                     users,
                     stats,
+                    tokenStats,
+                    tokenUserStats,
+                    transcriptionStats,
+                    transcriptionUserStats,
+                    settings,
                     isLoadingUsers,
+                    isLoadingSettings,
                     userSearchQuery,
                     isDarkMode,
-                    isDropdownOpen,
+                    isUserMenuOpen,
                     
                     // Modal state
                     showAddUserModal,
@@ -708,24 +3553,146 @@ <h3 class="text-xl font-semibold text-[var(--text-primary)]">Confirm Delete</h3>
                     editingUser,
                     userToDelete,
                     
+                    // Settings modal state
+                    showEditSettingModal,
+                    editingSetting,
+                    settingNewValue,
+                    settingUseNoLimit,
+                    settingTimeoutMinutes,
+                    settingTimeoutSeconds,
+                    settingError,
+                    
+                    // Inquire Mode state
+                    inquireModeEnabled,
+                    inquireStatus,
+                    isProcessingRecordings,
+                    processingResult,
+
+                    // Teams state
+                    groups,
+                    showTeamModal,
+                    showManageTeamModal,
+                    showDeleteTeamModal,
+                    showSyncSharesModal,
+                    showSyncResultsModal,
+                    syncResults,
+                    editingTeam,
+                    teamToDelete,
+                    currentTeam,
+                    teamForm,
+                    teamError,
+                    teamMembers,
+                    newMemberUserId,
+                    newMemberRole,
+                    teamMemberError,
+
+                    // Group Tags state
+                    showManageTeamTagsModal,
+                    teamTags,
+                    editingTeamTagId,
+                    newTeamTag,
+                    teamTagError,
+                    globalRetentionDays,
+
+                    // Default Prompts state
+                    defaultSummaryPrompt,
+                    isSavingPrompt,
+                    promptSaveMessage,
+                    promptSaveError,
+                    showFullPromptStructure,
+                    originalDefaultPrompt,
+                    formatPromptPreview,
+                    
                     // Computed
                     filteredUsers,
-                    
+                    availableUsers,
+                    getProcessingProgress,
+                    recordingsNeedProcessingMessage,
+
                     // Methods
                     loadUsers,
                     loadStats,
+                    loadSettings,
+                    loadTokenStats,
+                    loadTranscriptionStats,
+                    editSetting,
+                    saveSettingValue,
+                    updateSetting,
+                    formatDate,
+                    getSettingDescription,
                     addUser,
                     editUser,
                     updateUser,
                     confirmDeleteUser,
                     deleteUser,
                     toggleAdminStatus,
+                    togglePublicSharingPermission,
                     formatFileSize,
-                    toggleDarkMode
+                    toggleDarkMode,
+
+                    // Group Management methods
+                    loadGroups,
+                    openCreateTeamModal,
+                    openEditTeamModal,
+                    closeTeamModal,
+                    saveTeam,
+                    confirmDeleteTeam,
+                    deleteTeam,
+                    openManageTeamModal,
+                    closeManageTeamModal,
+                    loadTeamMembers,
+                    addTeamMember,
+                    updateMemberRole,
+                    removeTeamMember,
+                    syncTeamShares,
+                    confirmSyncShares,
+
+                    // Group Tags methods
+                    openManageTeamTagsModal,
+                    closeManageTeamTagsModal,
+                    loadTeamTags,
+                    saveTeamTag,
+                    editTeamTag,
+                    cancelEditTeamTag,
+                    deleteTeamTag,
+
+                    // Inquire Mode methods
+                    loadInquireStatus,
+                    processAllRecordings,
+                    processBatchRecordings,
+                    reembedAllRecordings,
+
+                    // Transcription model curation
+                    visibleTranscriptionModels,
+                    transcriptionDefaultModel,
+                    modelDiscoveryResult,
+                    modelDiscoveryError,
+                    discoveringModels,
+                    savingModels,
+                    modelSaveMessage,
+                    modelSaveError,
+                    transcriptionModelRows,
+                    discoverTranscriptionModels,
+                    addManualTranscriptionModel,
+                    saveVisibleTranscriptionModels,
+                    loadVisibleTranscriptionModels,
+
+                    // Default Prompts methods
+                    loadDefaultPrompt,
+                    saveDefaultPrompt,
+                    resetDefaultPrompt
                 };
             },
             delimiters: ['${', '}'] // Use different delimiters to avoid conflict with Flask's Jinja2
         }).mount('#app');
+
+        // Hide loading overlay after Vue is mounted
+        Vue.nextTick(() => {
+            if (window.AppLoader) {
+                window.AppLoader.hide();
+            }
+        });
+        }); // End of initializeI18n().then()
     </script>
 </body>
 </html>
diff --git a/templates/auth/check_email.html b/templates/auth/check_email.html
new file mode 100644
index 00000000..92bf9cb9
--- /dev/null
+++ b/templates/auth/check_email.html
@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>{{ title }} - Speakr</title>
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        function applyTheme() {
+            if (!document.documentElement) return;
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+            if (savedScheme !== 'blue') {
+                document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
+</head>
+<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
+            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
+            </h1>
+        </header>
+
+        <main class="flex-grow flex items-center justify-center">
+            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                {% with messages = get_flashed_messages(with_categories=true) %}
+                    {% if messages %}
+                        {% for category, message in messages %}
+                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% elif category == 'warning' %}bg-[var(--bg-warning-light)] text-[var(--text-warning-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
+                                {{ message }}
+                            </div>
+                        {% endfor %}
+                    {% endif %}
+                {% endwith %}
+
+                <div class="text-center">
+                    <div class="mb-6">
+                        <div class="w-20 h-20 mx-auto bg-[var(--bg-info-light)] rounded-full flex items-center justify-center">
+                            <i class="fas fa-envelope text-[var(--text-info-strong)] text-3xl"></i>
+                        </div>
+                    </div>
+
+                    {% if action == 'verification' %}
+                        <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Check Your Email</h2>
+                        <p class="text-[var(--text-secondary)] mb-2">We've sent a verification link to:</p>
+                        <p class="text-[var(--text-primary)] font-medium mb-6">{{ email }}</p>
+                        <p class="text-[var(--text-muted)] text-sm mb-6">
+                            Click the link in the email to verify your account. The link will expire in 24 hours.
+                        </p>
+                    {% elif action == 'verification_required' %}
+                        <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Email Verification Required</h2>
+                        <p class="text-[var(--text-secondary)] mb-2">Please verify your email address:</p>
+                        <p class="text-[var(--text-primary)] font-medium mb-6">{{ email }}</p>
+                        <p class="text-[var(--text-muted)] text-sm mb-6">
+                            Check your inbox for a verification email. If you haven't received it, you can request a new one.
+                        </p>
+                    {% elif action == 'password_reset' %}
+                        <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Check Your Email</h2>
+                        <p class="text-[var(--text-secondary)] mb-2">If an account exists with this email:</p>
+                        <p class="text-[var(--text-primary)] font-medium mb-6">{{ email }}</p>
+                        <p class="text-[var(--text-muted)] text-sm mb-6">
+                            We've sent a password reset link. The link will expire in 1 hour.
+                        </p>
+                    {% endif %}
+
+                    {% if show_resend and (action == 'verification' or action == 'verification_required') %}
+                        <div class="mb-6">
+                            <form method="POST" action="{{ url_for('auth.resend_verification') }}">
+                                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+                                <input type="hidden" name="email" value="{{ email }}">
+                                <button type="submit" class="text-[var(--text-accent)] hover:underline text-sm">
+                                    <i class="fas fa-redo mr-1"></i> Resend verification email
+                                </button>
+                            </form>
+                        </div>
+                    {% endif %}
+
+                    <div class="pt-4 border-t border-[var(--border-secondary)]">
+                        <a href="{{ url_for('auth.login') }}" class="text-[var(--text-accent)] hover:underline">
+                            <i class="fas fa-arrow-left mr-1"></i> Back to Login
+                        </a>
+                    </div>
+                </div>
+            </div>
+        </main>
+
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            Speakr &copy; {{ now.year }}
+        </footer>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
+</body>
+</html>
diff --git a/templates/auth/forgot_password.html b/templates/auth/forgot_password.html
new file mode 100644
index 00000000..e3902827
--- /dev/null
+++ b/templates/auth/forgot_password.html
@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>{{ title }} - Speakr</title>
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        function applyTheme() {
+            if (!document.documentElement) return;
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+            if (savedScheme !== 'blue') {
+                document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
+</head>
+<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
+            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
+            </h1>
+        </header>
+
+        <main class="flex-grow flex items-center justify-center">
+            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-2 text-center">Forgot Password</h2>
+                <p class="text-[var(--text-muted)] text-sm text-center mb-6">
+                    Enter your email address and we'll send you a link to reset your password.
+                </p>
+
+                {% with messages = get_flashed_messages(with_categories=true) %}
+                    {% if messages %}
+                        {% for category, message in messages %}
+                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% elif category == 'warning' %}bg-[var(--bg-warning-light)] text-[var(--text-warning-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
+                                {{ message }}
+                            </div>
+                        {% endfor %}
+                    {% endif %}
+                {% endwith %}
+
+                <form method="POST" action="{{ url_for('auth.forgot_password') }}">
+                    <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+
+                    <div class="mb-6">
+                        <label for="email" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Email Address</label>
+                        <input type="email" id="email" name="email" required
+                               class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]"
+                               placeholder="Enter your email address">
+                    </div>
+
+                    <div class="flex flex-col space-y-4">
+                        <button type="submit" class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]">
+                            <i class="fas fa-paper-plane mr-2"></i> Send Reset Link
+                        </button>
+
+                        <div class="text-center text-sm text-[var(--text-muted)]">
+                            <span>Remember your password?</span>
+                            <a href="{{ url_for('auth.login') }}" class="font-medium text-[var(--text-accent)] hover:underline">Back to Login</a>
+                        </div>
+                    </div>
+                </form>
+            </div>
+        </main>
+
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            Speakr &copy; {{ now.year }}
+        </footer>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
+</body>
+</html>
diff --git a/templates/auth/reset_password.html b/templates/auth/reset_password.html
new file mode 100644
index 00000000..f699bc8f
--- /dev/null
+++ b/templates/auth/reset_password.html
@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>{{ title }} - Speakr</title>
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        function applyTheme() {
+            if (!document.documentElement) return;
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+            if (savedScheme !== 'blue') {
+                document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
+</head>
+<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
+            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
+            </h1>
+        </header>
+
+        <main class="flex-grow flex items-center justify-center">
+            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-2 text-center">Reset Password</h2>
+                <p class="text-[var(--text-muted)] text-sm text-center mb-6">
+                    Enter your new password below.
+                </p>
+
+                {% with messages = get_flashed_messages(with_categories=true) %}
+                    {% if messages %}
+                        {% for category, message in messages %}
+                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% elif category == 'warning' %}bg-[var(--bg-warning-light)] text-[var(--text-warning-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
+                                {{ message }}
+                            </div>
+                        {% endfor %}
+                    {% endif %}
+                {% endwith %}
+
+                <form method="POST" action="{{ url_for('auth.reset_password', token=token) }}">
+                    <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+
+                    <div class="mb-4">
+                        <label for="password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">New Password</label>
+                        <input type="password" id="password" name="password" required
+                               class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]"
+                               placeholder="Enter your new password">
+                        <p class="text-xs text-[var(--text-muted)] mt-1">Password must be at least 8 characters long.</p>
+                    </div>
+
+                    <div class="mb-6">
+                        <label for="confirm_password" class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Confirm Password</label>
+                        <input type="password" id="confirm_password" name="confirm_password" required
+                               class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]"
+                               placeholder="Confirm your new password">
+                    </div>
+
+                    <div class="flex flex-col space-y-4">
+                        <button type="submit" class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]">
+                            <i class="fas fa-key mr-2"></i> Reset Password
+                        </button>
+
+                        <div class="text-center text-sm text-[var(--text-muted)]">
+                            <a href="{{ url_for('auth.login') }}" class="font-medium text-[var(--text-accent)] hover:underline">
+                                <i class="fas fa-arrow-left mr-1"></i> Back to Login
+                            </a>
+                        </div>
+                    </div>
+                </form>
+            </div>
+        </main>
+
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            Speakr &copy; {{ now.year }}
+        </footer>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
+</body>
+</html>
diff --git a/templates/auth/verify_success.html b/templates/auth/verify_success.html
new file mode 100644
index 00000000..075cfd84
--- /dev/null
+++ b/templates/auth/verify_success.html
@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>{{ title }} - Speakr</title>
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        function applyTheme() {
+            if (!document.documentElement) return;
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+            if (savedScheme !== 'blue') {
+                document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
+</head>
+<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
+            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
+            </h1>
+        </header>
+
+        <main class="flex-grow flex items-center justify-center">
+            <div class="w-full max-w-md bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                <div class="text-center">
+                    <div class="mb-6">
+                        <div class="w-20 h-20 mx-auto bg-[var(--bg-success-light)] rounded-full flex items-center justify-center">
+                            <i class="fas fa-check text-[var(--text-success-strong)] text-3xl"></i>
+                        </div>
+                    </div>
+
+                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Email Verified!</h2>
+                    <p class="text-[var(--text-secondary)] mb-6">
+                        Your email address has been successfully verified. You can now log in to your account.
+                    </p>
+
+                    <a href="{{ url_for('auth.login') }}" class="inline-block w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                        <i class="fas fa-sign-in-alt mr-2"></i> Continue to Login
+                    </a>
+                </div>
+            </div>
+        </main>
+
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            Speakr &copy; {{ now.year }}
+        </footer>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
+</body>
+</html>
diff --git a/templates/components/banner.html b/templates/components/banner.html
new file mode 100644
index 00000000..25b6bcae
--- /dev/null
+++ b/templates/components/banner.html
@@ -0,0 +1,11 @@
+<!-- Custom Banner -->
+<div v-if="customBannerHtml && showBanner"
+     class="flex-shrink-0 bg-[var(--bg-accent)] bg-opacity-10 border-b border-[var(--border-accent)]
+            px-4 py-2 flex items-center gap-3 text-sm text-[var(--text-primary)]">
+    <i class="fas fa-bullhorn text-[var(--text-accent)] flex-shrink-0"></i>
+    <div class="flex-1 ai-message banner-content" v-html="customBannerHtml"></div>
+    <button @click="showBanner = false"
+            class="text-[var(--text-muted)] hover:text-[var(--text-primary)] flex-shrink-0">
+        <i class="fas fa-times"></i>
+    </button>
+</div>
diff --git a/templates/components/detail-view.html b/templates/components/detail-view.html
new file mode 100644
index 00000000..cdd1cb1b
--- /dev/null
+++ b/templates/components/detail-view.html
@@ -0,0 +1,57 @@
+<!-- Detail View Container -->
+<div v-if="currentView === 'detail' && selectedRecording" class="flex-1 flex flex-col overflow-hidden">
+    <!-- Incognito Mode Indicator Bar -->
+    <div v-if="selectedRecording.incognito" class="bg-gradient-to-r from-violet-500/10 via-purple-500/10 to-violet-500/10 border-b border-violet-300/30 dark:border-violet-500/30 px-4 py-2 flex-shrink-0">
+        <div class="flex items-center justify-between gap-4 max-w-4xl mx-auto">
+            <div class="flex items-center gap-3">
+                <div class="w-7 h-7 rounded-full bg-gradient-to-br from-violet-500 to-purple-600 flex items-center justify-center">
+                    <i class="fas fa-user-secret text-white text-xs"></i>
+                </div>
+                <div class="flex items-center gap-2 flex-wrap">
+                    <span class="text-sm font-medium text-violet-700 dark:text-violet-300">Incognito</span>
+                    <span class="text-xs text-violet-600/80 dark:text-violet-400/80">
+                        &bull; Session only &bull; Not saved to account
+                    </span>
+                </div>
+            </div>
+            <button @click="clearIncognitoRecordingWithConfirm"
+                    class="flex-shrink-0 px-2.5 py-1 text-xs font-medium text-violet-600 dark:text-violet-400 hover:text-red-600 dark:hover:text-red-400 hover:bg-red-50 dark:hover:bg-red-900/20 rounded transition-colors"
+                    title="Discard this recording">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+    </div>
+
+    <!-- Mobile View -->
+    <div v-if="isMobile" class="flex flex-col h-full overflow-hidden">
+        {% include 'components/detail/mobile-header.html' %}
+        {% include 'components/detail/audio-player.html' %}
+        {% include 'components/detail/tab-navigation.html' %}
+
+        <!-- Mobile Tab Content -->
+        <div class="flex-1 overflow-y-auto p-4">
+            {% include 'components/detail/mobile-transcript-panel.html' %}
+            {% include 'components/detail/mobile-summary-panel.html' %}
+            {% include 'components/detail/mobile-notes-panel.html' %}
+            {% include 'components/detail/mobile-chat-panel.html' %}
+            {% include 'components/detail/mobile-events-panel.html' %}
+        </div>
+    </div>
+
+    <!-- Desktop View -->
+    <div v-else class="flex-1 flex flex-col overflow-hidden">
+        {% include 'components/detail/desktop-header.html' %}
+
+        <!-- Main Content Split View -->
+        <div id="mainContentColumns" class="flex-1 flex overflow-hidden">
+            {% include 'components/detail/desktop-transcription-panel.html' %}
+
+            <!-- Resizable Divider -->
+            <div id="mainColumnResizer" @mousedown="startColumnResize"></div>
+
+            {% include 'components/detail/desktop-right-panel.html' %}
+        </div>
+    </div>
+</div>
+
+{% include 'components/detail/empty-state.html' %}
diff --git a/templates/components/detail/audio-player.html b/templates/components/detail/audio-player.html
new file mode 100644
index 00000000..27c1b764
--- /dev/null
+++ b/templates/components/detail/audio-player.html
@@ -0,0 +1,236 @@
+<!-- Audio Player Component (Mobile) -->
+<div class="bg-[var(--bg-secondary)] px-4 py-3 border-b border-[var(--border-primary)] flex-shrink-0">
+    <!-- Show message if audio has been deleted -->
+    <div v-if="selectedRecording.audio_deleted_at"
+         class="text-[var(--text-muted)] text-sm flex items-center gap-2">
+        <i class="fas fa-info-circle"></i>
+        <span v-text="t('help.audioDeletedMessage')"></span>
+    </div>
+    <!-- Show message for incognito recordings (no audio stored) -->
+    <div v-else-if="selectedRecording.incognito"
+         class="text-[var(--text-muted)] text-sm flex items-center gap-2">
+        <i class="fas fa-user-secret"></i>
+        <span v-text="t('incognito.audioNotStored')"></span>
+    </div>
+    <!-- Custom Audio Player -->
+    <div v-else>
+        <!-- Video/Audio element wrapped in Teleport for fullscreen -->
+        <Teleport to="body" :disabled="!videoFullscreen">
+            <div :class="videoFullscreen ? 'video-fullscreen-overlay' : ''"
+                 @mousemove="videoFullscreen && handleFullscreenMouseMove()"
+                 @click.self="videoFullscreen && toggleAudioPlayback()">
+
+                <component :is="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') ? 'video' : 'audio'"
+                       ref="audioPlayerElement"
+                       :src="'/audio/' + selectedRecording.id"
+                       :volume="playerVolume"
+                       @play="handleAudioPlayPause"
+                       @pause="handleAudioPlayPause"
+                       @timeupdate="handleCustomAudioTimeUpdate"
+                       @loadedmetadata="handleAudioLoadedMetadata"
+                       @durationchange="handleAudioDurationChange"
+                       @ended="handleAudioEnded"
+                       @waiting="handleAudioWaiting"
+                       @canplay="handleAudioCanPlay"
+                       @click="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && toggleAudioPlayback()"
+                       @dblclick="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && !videoFullscreen && enterVideoFullscreen()"
+                       :class="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/')
+                           ? (videoFullscreen ? 'video-fullscreen-video' : (videoCollapsed ? 'hidden' : 'w-full rounded-lg mb-2 cursor-pointer'))
+                           : 'hidden'">
+                </component>
+
+                <!-- Fullscreen Subtitle Overlay -->
+                <div v-if="videoFullscreen && currentSubtitle"
+                     class="video-fullscreen-subtitle"
+                     :class="{ 'subtitle-shifted': fullscreenControlsVisible }">
+                    <span v-if="currentSubtitle.speaker"
+                          class="video-fullscreen-subtitle-speaker"
+                          :style="{ color: 'var(--' + currentSubtitle.color + ')' }">${ currentSubtitle.speaker }:</span>
+                    <span>${ currentSubtitle.text }</span>
+                </div>
+
+                <!-- Fullscreen Control Bar -->
+                <div v-if="videoFullscreen"
+                     class="video-fullscreen-controls"
+                     :class="{ visible: fullscreenControlsVisible }"
+                     @mousemove.stop="handleFullscreenMouseMove()">
+
+                    <!-- Progress Bar -->
+                    <div class="px-4 mb-2">
+                        <div class="w-full h-5 rounded-full cursor-pointer relative group flex items-center"
+                             @mousedown="startProgressDrag"
+                             @touchstart.prevent="startProgressDrag">
+                            <div class="progress-track w-full h-1 rounded-full relative bg-white/30">
+                                <div class="h-full bg-white rounded-full pointer-events-none"
+                                     :style="{ width: audioProgressPercent + '%' }"></div>
+                            </div>
+                            <div class="absolute top-1/2 w-3 h-3 bg-white rounded-full shadow-md transition-transform group-hover:scale-125 pointer-events-none -translate-y-1/2"
+                                 :style="{ left: 'clamp(0px, calc(' + audioProgressPercent + '% - 6px), calc(100% - 12px))' }"></div>
+                        </div>
+                    </div>
+
+                    <!-- Controls Row -->
+                    <div class="flex items-center gap-3 px-4 pb-4">
+                        <!-- Play/Pause -->
+                        <button @click.stop="toggleAudioPlayback"
+                                class="w-10 h-10 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all">
+                            <i :class="audioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-lg" :style="!audioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                        </button>
+
+                        <!-- Volume -->
+                        <div class="flex items-center gap-2">
+                            <button @click.stop="toggleAudioMute"
+                                    class="w-8 h-8 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all">
+                                <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : playerVolume < 0.5 ? 'fas fa-volume-down' : 'fas fa-volume-up'" class="text-sm"></i>
+                            </button>
+                            <input type="range" min="0" max="1" step="0.05"
+                                   :value="audioIsMuted ? 0 : playerVolume"
+                                   @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                                   class="fullscreen-volume-slider w-20">
+                        </div>
+
+                        <!-- Time -->
+                        <div class="flex items-baseline gap-1 text-white">
+                            <span class="text-sm font-mono">${ formatAudioTime(displayCurrentTime) }</span>
+                            <span class="text-xs opacity-60">/</span>
+                            <span class="text-xs opacity-60 font-mono">${ formatAudioTime(audioDuration) }</span>
+                        </div>
+
+                        <div class="flex-1"></div>
+
+                        <!-- Speed -->
+                        <button @click.stop="cyclePlaybackRate"
+                                class="px-2 h-8 flex items-center justify-center rounded-lg text-white hover:bg-white/20 transition-all"
+                                title="Playback speed">
+                            <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(playbackRate) }</span>
+                        </button>
+
+                        <!-- Exit Fullscreen -->
+                        <button @click.stop="exitVideoFullscreen"
+                                class="w-8 h-8 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all"
+                                :title="t('tooltips.exitFullscreen')">
+                            <i class="fas fa-compress text-sm"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </Teleport>
+
+        <!-- Normal Controls (hidden when fullscreen) -->
+        <div v-show="!videoFullscreen">
+            <!-- Progress Bar (draggable, touch support) -->
+            <div class="w-full h-4 rounded-full cursor-pointer relative mb-2 group flex items-center"
+                 @mousedown="startProgressDrag"
+                 @touchstart.prevent="startProgressDrag">
+                <!-- Track background -->
+                <div class="progress-track w-full h-2 rounded-full relative bg-[var(--border-accent)] opacity-40">
+                    <!-- Progress fill -->
+                    <div class="h-full bg-[var(--text-accent)] rounded-full pointer-events-none opacity-100"
+                         :style="{ width: audioProgressPercent + '%' }"></div>
+                </div>
+                <!-- Progress dot - stays within track bounds -->
+                <div class="absolute top-1/2 w-4 h-4 bg-[var(--text-accent)] rounded-full shadow-md transition-transform group-hover:scale-110 pointer-events-none -translate-y-1/2"
+                     :style="{ left: 'clamp(0px, calc(' + audioProgressPercent + '% - 8px), calc(100% - 16px))' }"
+                     style="box-shadow: 0 2px 6px rgba(0,0,0,0.3);"></div>
+            </div>
+
+            <!-- Controls Row -->
+            <div class="flex items-center gap-2">
+                <!-- Play/Pause Button -->
+                <button @click="toggleAudioPlayback"
+                        class="w-10 h-10 flex items-center justify-center rounded-full player-play-button transition-all duration-200 flex-shrink-0 shadow-md hover:shadow-lg active:scale-95"
+                        :title="audioIsPlaying ? t('tooltips.pause') : t('tooltips.play')">
+                    <i :class="audioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-base" :style="!audioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                </button>
+
+                <!-- Time Display -->
+                <div class="flex items-baseline gap-1 flex-shrink-0">
+                    <span class="text-sm font-semibold font-mono" :class="isDraggingProgress ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]'">${ formatAudioTime(displayCurrentTime) }</span>
+                    <span class="text-xs text-[var(--text-muted)]">/</span>
+                    <span class="text-xs text-[var(--text-muted)] font-mono">${ formatAudioTime(audioDuration) }</span>
+                </div>
+
+                <!-- Playback Speed Control -->
+                <div class="relative flex-shrink-0">
+                    <button ref="speedButtonMobile"
+                            @click="showSpeedMenu = !showSpeedMenu; $nextTick(() => updateSpeedMenuPosition($refs.speedButtonMobile))"
+                            data-speed-toggle
+                            class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all"
+                            :title="t('tooltips.playbackSpeed') || 'Playback speed'">
+                        <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(playbackRate) }</span>
+                    </button>
+                    <!-- Dropdown menu (teleported to body, fixed positioning) -->
+                    <Teleport to="body">
+                        <div v-if="showSpeedMenu" @click.stop
+                             data-speed-dropdown
+                             class="fixed bg-[var(--bg-tertiary)] border border-[var(--border-accent)] rounded-md shadow-xl z-[9999] speed-dropdown overflow-y-auto backdrop-blur-sm"
+                             :style="speedMenuPosition">
+                            <div class="py-0.5">
+                                <button v-for="speed in playbackSpeeds" :key="speed"
+                                        @mousedown.prevent="setPlaybackRate(speed); showSpeedMenu = false"
+                                        class="w-full px-2 py-0.5 text-[11px] font-mono text-left hover:bg-[var(--bg-accent-light)] transition-colors"
+                                        :class="speed === playbackRate ? 'text-[var(--text-accent)] font-semibold bg-[var(--bg-accent-light)]' : 'text-[var(--text-primary)]'">
+                                    ${ speed }x
+                                </button>
+                            </div>
+                        </div>
+                    </Teleport>
+                </div>
+
+                <!-- Spacer -->
+                <div class="flex-1"></div>
+
+                <!-- Volume Control -->
+                <div class="relative flex items-center flex-shrink-0 group/vol"
+                     @mouseenter="showVolumeSlider = true"
+                     @mouseleave="showVolumeSlider = false">
+                    <button @click="toggleAudioMute"
+                            class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] transition-all"
+                            :class="audioIsMuted || playerVolume === 0 ? 'text-[var(--text-muted)]' : 'text-[var(--text-accent)]'"
+                            :title="audioIsMuted ? t('tooltips.unmute') : t('tooltips.mute')">
+                        <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : playerVolume < 0.5 ? 'fas fa-volume-down' : 'fas fa-volume-up'" class="text-sm"></i>
+                    </button>
+                    <!-- Volume Slider (expands on hover, outer div is invisible hover bridge) -->
+                    <div class="absolute top-full left-1/2 -translate-x-1/2 pt-2 z-50 transition-all duration-200"
+                         :class="showVolumeSlider ? 'opacity-100 pointer-events-auto scale-100' : 'opacity-0 pointer-events-none scale-95'"
+                         @mouseenter="showVolumeSlider = true"
+                         @mouseleave="showVolumeSlider = false">
+                        <div class="px-3 py-2 bg-[var(--bg-tertiary)] border border-[var(--border-accent)] rounded-lg shadow-xl flex flex-col items-center gap-1">
+                            <span class="text-[10px] font-mono text-[var(--text-muted)]">${ Math.round(playerVolume * 100) }</span>
+                            <input type="range" min="0" max="1" step="0.05"
+                                   :value="audioIsMuted ? 0 : playerVolume"
+                                   @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                                   class="volume-slider-vertical"
+                                   style="height: 80px;">
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Download Button -->
+                <a :href="'/audio/' + selectedRecording.id + '?download=true'"
+                   download
+                   class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all flex-shrink-0"
+                   :title="t('buttons.downloadAudio') || 'Download audio'">
+                    <i class="fas fa-download text-sm"></i>
+                </a>
+
+                <!-- Video Fullscreen Button -->
+                <button v-if="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && !videoCollapsed"
+                        @click="enterVideoFullscreen"
+                        class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all flex-shrink-0"
+                        :title="t('tooltips.fullscreenVideo')">
+                    <i class="fas fa-expand text-sm"></i>
+                </button>
+
+                <!-- Video Toggle Button -->
+                <button v-if="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/')"
+                        @click="videoCollapsed = !videoCollapsed"
+                        class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] transition-all flex-shrink-0"
+                        :class="videoCollapsed ? 'text-[var(--text-muted)]' : 'text-[var(--text-accent)]'"
+                        :title="videoCollapsed ? t('tooltips.showVideo') : t('tooltips.hideVideo')">
+                    <i :class="videoCollapsed ? 'fas fa-eye-slash' : 'fas fa-eye'" class="text-sm"></i>
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-chat-section.html b/templates/components/detail/desktop-chat-section.html
new file mode 100644
index 00000000..263ac143
--- /dev/null
+++ b/templates/components/detail/desktop-chat-section.html
@@ -0,0 +1,115 @@
+<!-- Desktop Chat Section -->
+<div class="border-t border-[var(--border-primary)] flex flex-col" :class="{'flex-1 overflow-hidden': isChatMaximized}">
+    <!-- Chat Toggle -->
+    <div class="bg-[var(--bg-tertiary)] px-4 py-3 hover:bg-[var(--bg-accent-hover)] transition-colors flex items-center">
+        <button @click="() => { showChat = !showChat; if (!showChat) isChatMaximized = false; }"
+                class="flex-1 text-left flex items-center">
+            <span class="font-medium flex items-center">
+                <i class="fas fa-comments mr-2"></i>
+                ${ t('chat.chatWithTranscription') }
+            </span>
+        </button>
+        <div class="flex items-center gap-2">
+            <button v-if="chatMessages.length > 0"
+                    @click="downloadChat"
+                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors"
+                    :title="t('buttons.downloadChat')">
+                <i class="fas fa-download text-sm"></i>
+            </button>
+            <button @click="toggleChatMaximize"
+                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors"
+                    :title="isChatMaximized ? t('tooltips.restoreChat') : t('tooltips.maximizeChat')">
+                <i :class="['fas text-sm', isChatMaximized ? 'fa-compress' : 'fa-expand']"></i>
+            </button>
+            <button @click="() => { showChat = !showChat; if (!showChat) isChatMaximized = false; }"
+                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                <i :class="['fas transition-transform duration-200', showChat ? 'fa-chevron-down' : 'fa-chevron-up']"></i>
+            </button>
+        </div>
+    </div>
+
+    <!-- Chat Content -->
+    <div v-if="showChat" class="flex flex-col relative" :class="isChatMaximized ? 'flex-1 overflow-hidden' : 'max-h-96'">
+        <!-- Clear button - fixed at top right -->
+        <button v-if="chatMessages.length > 0"
+                @click="clearChat"
+                class="absolute top-2 right-2 p-1 text-[var(--text-muted)] opacity-60 hover:opacity-100 hover:text-[var(--text-danger)] rounded transition-all duration-200 z-20"
+                title="Clear chat">
+            <i class="fas fa-times text-xs"></i>
+        </button>
+
+        <!-- Chat Messages -->
+        <div ref="chatMessagesRef"
+             class="flex-1 overflow-y-auto p-4 space-y-4 bg-[var(--bg-secondary)]">
+            <div v-if="chatMessages.length === 0" class="text-center py-8">
+                <i class="fas fa-robot text-3xl text-[var(--text-muted)] mb-3"></i>
+                <p class="text-[var(--text-muted)]" v-text="t('help.askAboutTranscription')"></p>
+            </div>
+
+            <div v-for="(message, index) in chatMessages"
+                 :key="index"
+                 :class="[
+                     'message relative group',
+                     message.role === 'user' ? 'user-message ml-auto' : 'ai-message',
+                     message.role === 'assistant' ? 'pr-10' : ''
+                 ]">
+                <!-- Copy button for assistant messages -->
+                <button v-if="message.role === 'assistant'"
+                        @click="copyMessage(message.content, $event)"
+                        class="absolute top-2 right-2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded transition-all duration-200"
+                        :title="t('buttons.copyMessage')">
+                    <i class="fas fa-copy text-sm"></i>
+                </button>
+                <!-- Show thinking content if available -->
+                <div v-if="message.thinking && message.role === 'assistant'" class="mb-2">
+                    <button @click="message.thinkingExpanded = !message.thinkingExpanded"
+                            class="text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)] flex items-center gap-1">
+                        <i :class="['fas', message.thinkingExpanded ? 'fa-chevron-down' : 'fa-chevron-right']"></i>
+                        <span v-text="t('help.modelReasoning')"></span>
+                        <span class="text-[var(--text-muted)]">(${message.thinking.split('\n').length} lines)</span>
+                    </button>
+                    <div v-if="message.thinkingExpanded"
+                         class="mt-2 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg text-xs text-[var(--text-muted)] max-h-64 overflow-y-auto">
+                        <pre class="whitespace-pre-wrap font-mono">${message.thinking}</pre>
+                    </div>
+                </div>
+                <!-- Main message content -->
+                <div v-if="message.html" v-html="message.html"></div>
+                <div v-else class="whitespace-pre-wrap">${message.content}</div>
+            </div>
+
+            <div v-if="isChatLoading" class="ai-message">
+                <i class="fas fa-spinner fa-spin mr-2"></i>
+                ${ t('chat.thinking') }
+            </div>
+        </div>
+
+        <!-- Chat Input -->
+        <div class="border-t border-[var(--border-primary)] p-4 bg-[var(--bg-tertiary)]">
+            <div class="flex gap-2">
+                <textarea v-model="chatInput"
+                          ref="chatInputRef"
+                          @keydown="handleChatKeydown"
+                          :disabled="selectedRecording.status !== 'COMPLETED' || processedTranscription.isError"
+                          :placeholder="t('chat.placeholderWithHint')"
+                          class="flex-1 px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm"
+                          rows="2">
+                </textarea>
+                <button @click="sendChatMessage"
+                        :disabled="!chatInput.trim() || isChatLoading || selectedRecording.status !== 'COMPLETED' || processedTranscription.isError"
+                        class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors disabled:opacity-50 disabled:cursor-not-allowed">
+                    <i class="fas fa-paper-plane"></i>
+                </button>
+            </div>
+            <p v-if="processedTranscription.isError"
+               class="text-xs text-amber-500 mt-2">
+                <i class="fas fa-exclamation-triangle mr-1"></i>
+                ${ t('chat.cannotChatTranscriptionFailed') }
+            </p>
+            <p v-else-if="selectedRecording.status !== 'COMPLETED'"
+               class="text-xs text-[var(--text-muted)] mt-2">
+                ${ t('chat.availableAfterTranscription') }
+            </p>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-events-tab.html b/templates/components/detail/desktop-events-tab.html
new file mode 100644
index 00000000..cfa7d273
--- /dev/null
+++ b/templates/components/detail/desktop-events-tab.html
@@ -0,0 +1,65 @@
+<!-- Desktop Events Tab -->
+<div v-if="selectedTab === 'events' && selectedRecording.events && selectedRecording.events.length > 0" class="h-full p-4 overflow-y-auto">
+    <div class="space-y-4">
+        <div v-for="event in selectedRecording.events" :key="event.id"
+             class="bg-[var(--bg-tertiary)] rounded-lg p-4 border border-[var(--border-primary)] hover:border-[var(--border-accent)] transition-colors">
+            <div class="flex justify-between items-start mb-3">
+                <div class="flex-1">
+                    <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-1">
+                        <i class="fas fa-calendar-check mr-2 text-[var(--text-accent)]"></i>
+                        ${ event.title }
+                    </h3>
+                    <p v-if="event.description" class="text-sm text-[var(--text-secondary)] mb-2">
+                        ${ event.description }
+                    </p>
+                </div>
+                <div class="flex items-center gap-2">
+                    <button @click="downloadEventICS(event)"
+                            class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm flex items-center gap-1.5"
+                            :title="t('events.addToCalendar')">
+                        <i class="fas fa-download"></i>
+                        <span v-text="t('events.addToCalendar')"></span>
+                    </button>
+                    <button @click="deleteEvent(event)"
+                            class="p-1.5 text-[var(--text-muted)] hover:text-red-500 hover:bg-red-500/10 rounded-lg transition-colors"
+                            :title="t('events.delete')">
+                        <i class="fas fa-trash-alt"></i>
+                    </button>
+                </div>
+            </div>
+
+            <div class="space-y-2 text-sm">
+                <div class="flex items-center gap-2" v-if="event.start_datetime">
+                    <i class="fas fa-clock text-[var(--text-muted)] w-4"></i>
+                    <span class="text-[var(--text-secondary)]">
+                        <strong v-text="t('events.start') + ':'"></strong> ${ formatEventDateTime(event.start_datetime) }
+                    </span>
+                </div>
+                <div class="flex items-center gap-2" v-if="event.end_datetime">
+                    <i class="fas fa-clock text-[var(--text-muted)] w-4"></i>
+                    <span class="text-[var(--text-secondary)]">
+                        <strong v-text="t('events.end') + ':'"></strong> ${ formatEventDateTime(event.end_datetime) }
+                    </span>
+                </div>
+                <div class="flex items-center gap-2" v-if="event.location">
+                    <i class="fas fa-map-marker-alt text-[var(--text-muted)] w-4"></i>
+                    <span class="text-[var(--text-secondary)]">
+                        <strong v-text="t('events.location') + ':'"></strong> ${ event.location }
+                    </span>
+                </div>
+                <div class="flex items-start gap-2" v-if="event.attendees && event.attendees.length > 0">
+                    <i class="fas fa-users text-[var(--text-muted)] w-4 mt-0.5"></i>
+                    <div class="text-[var(--text-secondary)]">
+                        <strong v-text="t('events.attendees') + ':'"></strong>
+                        <span class="ml-1">${ event.attendees.join(', ') }</span>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <div v-if="selectedRecording.events.length === 0" class="text-center py-8">
+            <i class="fas fa-calendar-times text-3xl text-[var(--text-muted)] mb-3"></i>
+            <p class="text-[var(--text-muted)]" v-text="t('events.noEvents')"></p>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-header.html b/templates/components/detail/desktop-header.html
new file mode 100644
index 00000000..584ba851
--- /dev/null
+++ b/templates/components/detail/desktop-header.html
@@ -0,0 +1,227 @@
+<!-- Desktop Recording Header -->
+<div class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] p-6 flex-shrink-0">
+    <div class="flex flex-col">
+        <div class="flex items-start justify-between">
+            <div class="flex-1 min-w-0">
+                <div class="flex items-center gap-2 mb-2">
+                    <h1 v-if="!editingTitle"
+                        @dblclick="selectedRecording.can_edit !== false ? toggleEditTitle() : null"
+                        :class="[
+                            'text-2xl font-bold truncate transition-opacity',
+                            selectedRecording.is_shared ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]',
+                            selectedRecording.can_edit !== false ? 'cursor-text hover:opacity-80' : ''
+                        ]"
+                        :title="selectedRecording.can_edit !== false ? 'Double-click to edit' : selectedRecording.title || 'Untitled Recording'">
+                        ${selectedRecording.title || 'Untitled Recording'}
+                    </h1>
+                    <input v-else
+                           v-model="selectedRecording.title"
+                           @blur="saveTitle"
+                           @keyup.enter="saveTitle"
+                           @keyup.esc="cancelEditTitle"
+                           ref="titleInput"
+                           class="text-2xl font-bold bg-transparent border-b-2 border-[var(--border-focus)] focus:outline-none text-[var(--text-primary)] flex-1 px-1"
+                           placeholder="Untitled Recording">
+
+                    <button v-if="!editingTitle && selectedRecording.can_edit !== false"
+                            @click="toggleEditTitle"
+                            class="p-1 text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors opacity-60 hover:opacity-100 flex-shrink-0"
+                            :title="t('tooltips.editTitle')">
+                        <i class="fas fa-pen text-sm"></i>
+                    </button>
+                    <button v-if="!editingTitle && selectedRecording.can_edit !== false && selectedRecording.status === 'COMPLETED'"
+                            @click="regenerateTitle"
+                            :disabled="regeneratingTitle"
+                            class="p-1 text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors opacity-60 hover:opacity-100 flex-shrink-0"
+                            :title="t('tooltips.regenerateTitle')">
+                        <i class="fas fa-sync-alt text-sm" :class="{ 'fa-spin': regeneratingTitle }"></i>
+                    </button>
+
+                    <!-- Status Badge (for non-completed recordings) -->
+                    <span v-if="!editingTitle && selectedRecording.status !== 'COMPLETED'"
+                          :class="getStatusClass(selectedRecording.status)"
+                          class="inline-flex items-center px-2.5 py-0.5 text-xs font-medium rounded-full whitespace-nowrap flex-shrink-0">
+                        ${formatStatus(selectedRecording.status)}
+                    </span>
+                </div>
+            </div>
+
+            <!-- Action Buttons -->
+            <div class="flex items-center gap-2 ml-4">
+                <!-- Incognito recordings have limited actions -->
+                <template v-if="!selectedRecording.incognito">
+                    <!-- Folder Assignment (icon-only dropdown matching other buttons) -->
+                    <div v-if="foldersEnabled && selectedRecording.can_edit !== false"
+                         class="relative p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                         :title="selectedRecording.folder_id ? getFolderName(selectedRecording.folder_id) : t('tooltips.assignFolder')">
+                        <select @change="assignFolderToRecording(selectedRecording.id, $event.target.value || null)"
+                                :value="selectedRecording.folder_id || ''"
+                                class="absolute inset-0 w-full h-full opacity-0 cursor-pointer">
+                            <option value="">No Folder</option>
+                            <option v-for="folder in availableFolders" :key="folder.id" :value="folder.id">
+                                ${ folder.name }
+                            </option>
+                        </select>
+                        <i class="fas fa-folder"
+                           :style="{ color: selectedRecording.folder_id ? getFolderColor(selectedRecording.folder_id) : '' }"></i>
+                    </div>
+                    <button @click="toggleInbox(selectedRecording)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :class="selectedRecording.is_inbox ? 'text-blue-500' : ''"
+                            :title="selectedRecording.is_inbox ? 'Mark as Read' : 'Move to Inbox'">
+                        <i class="fas fa-inbox"></i>
+                    </button>
+                    <button @click="toggleHighlight(selectedRecording)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :class="selectedRecording.is_highlighted ? 'text-yellow-500' : ''"
+                            :title="selectedRecording.is_highlighted ? 'Remove Highlight' : 'Highlight'">
+                        <i class="fas fa-star"></i>
+                    </button>
+                    <button @click="editRecordingTags(selectedRecording)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :title="t('buttons.editTags')">
+                        <i class="fas fa-tags"></i>
+                    </button>
+                    <button @click="confirmReprocess('transcription', selectedRecording)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :title="useAsrEndpoint ? 'Reprocess with ASR' : 'Reprocess transcription'">
+                        <i class="fas fa-redo-alt"></i>
+                    </button>
+                    <button @click="confirmReprocess('summary', selectedRecording)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :title="t('buttons.reprocessSummary')">
+                        <i class="fas fa-sync-alt"></i>
+                    </button>
+                    <button @click="confirmReset(selectedRecording)" v-if="['PENDING', 'PROCESSING', 'SUMMARIZING', 'FAILED'].includes(selectedRecording.status)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-orange-500"
+                            :title="t('buttons.resetStuckProcessing')">
+                        <i class="fas fa-undo"></i>
+                    </button>
+                    <button @click="openSpeakerModal" v-if="processedTranscription.hasDialogue"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :title="t('buttons.identifySpeakers')">
+                        <i class="fas fa-user-tag"></i>
+                    </button>
+                    <button v-if="!selectedRecording.is_shared || (selectedRecording.share_info && selectedRecording.share_info.can_reshare)"
+                            @click="openUnifiedShareModal(selectedRecording)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                            :title="t('buttons.shareRecording')">
+                        <i class="fas fa-share-alt"></i>
+                    </button>
+                    <button v-if="canDeleteRecordings && selectedRecording.can_delete !== false" @click="confirmDelete(selectedRecording)"
+                            class="p-2 rounded-lg hover:bg-[var(--bg-danger-light)] text-[var(--text-danger)] transition-colors">
+                        <i class="fas fa-trash"></i>
+                    </button>
+                </template>
+
+                <!-- Incognito mode: only show discard button -->
+                <template v-else>
+                    <span class="text-xs text-amber-600 dark:text-amber-400 mr-2">
+                        <i class="fas fa-user-secret mr-1"></i>
+                        Incognito
+                    </span>
+                    <button @click="clearIncognitoRecordingWithConfirm"
+                            class="p-2 rounded-lg hover:bg-red-100 dark:hover:bg-red-900/30 text-red-600 dark:text-red-400 transition-colors"
+                            :title="t('tooltips.discardIncognito')">
+                        <i class="fas fa-trash"></i>
+                    </button>
+                </template>
+            </div>
+        </div>
+
+        <!-- Metadata Row -->
+        <div class="flex flex-wrap items-center gap-x-6 gap-y-2 text-sm text-[var(--text-muted)] mt-2">
+            <!-- Folder Pill, Shared Status Badges and Tags -->
+            <div v-if="(foldersEnabled && selectedRecording.folder_id && !selectedRecording.incognito) || selectedRecording.is_shared || selectedRecording.shared_with_count > 0 || selectedRecording.public_share_count > 0 || selectedRecording.has_group_tags || (selectedRecording.tags && selectedRecording.tags.length > 0)" class="flex items-center gap-1.5 flex-wrap">
+                <!-- Folder Pill (shown when folder assigned) -->
+                <span v-if="foldersEnabled && selectedRecording.folder_id && !selectedRecording.incognito"
+                      class="inline-flex items-center px-2 py-0.5 text-xs font-medium rounded-full"
+                      :style="{ backgroundColor: getFolderColor(selectedRecording.folder_id), color: getContrastTextColor(getFolderColor(selectedRecording.folder_id)) }"
+                      :title="'Folder: ' + getFolderName(selectedRecording.folder_id)">
+                    <i class="fas fa-folder mr-1 text-[10px]" style="vertical-align: middle; line-height: 0;"></i>
+                    ${ getFolderName(selectedRecording.folder_id) }
+                </span>
+                <!-- Shared by someone else (INCOMING) -->
+                <span v-if="selectedRecording.is_shared"
+                      class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-purple-500 text-white"
+                      :title="t('sharing.sharedBy') + ' ' + (selectedRecording.owner_username || t('sharing.unknown'))">
+                    <i class="fas fa-arrow-down" style="vertical-align: middle; line-height: 0;"></i>
+                </span>
+
+                <!-- Group indicator (show for both owned and shared recordings with group tags) -->
+                <span v-if="selectedRecording.has_group_tags"
+                      class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-blue-500 text-white"
+                      :title="t('sharing.teamRecording')">
+                    <i class="fas fa-users" style="vertical-align: middle; line-height: 0;"></i>
+                </span>
+
+                <!-- Shared with others (OUTGOING) -->
+                <span v-if="!selectedRecording.is_shared && selectedRecording.shared_with_count > 0"
+                      class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-indigo-500 text-white"
+                      :title="t('sharing.sharedWith') + ' ' + selectedRecording.shared_with_count + ' ' + t('sharing.users')">
+                    <i class="fas fa-arrow-up" style="vertical-align: middle; line-height: 0;"></i>
+                </span>
+
+                <!-- Public link shares -->
+                <span v-if="!selectedRecording.is_shared && selectedRecording.public_share_count > 0"
+                      class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-teal-500 text-white"
+                      :title="selectedRecording.public_share_count + ' ' + t('sharing.publicLinksGenerated')">
+                    <i class="fas fa-globe" style="vertical-align: middle; line-height: 0;"></i>
+                </span>
+
+                <!-- Tags -->
+                <span v-for="tag in selectedRecording.tags" :key="tag.id"
+                      class="inline-flex items-center px-2 py-0.5 text-xs font-medium rounded-full"
+                      :style="{ backgroundColor: tag.color || '#6B7280', color: getContrastTextColor(tag.color || '#6B7280') }"
+                      :title="tag.group_id ? ('Group: ' + tag.group_name) : tag.name">
+                    <i v-if="tag.group_id" class="fas fa-users mr-1 text-[10px]" style="vertical-align: middle; line-height: 0;"></i>
+                    ${tag.name}
+                </span>
+            </div>
+
+            <!-- Participants -->
+            <div class="flex items-center gap-2">
+                <i class="fas fa-users text-[var(--text-accent)]"></i>
+                <span @click="openParticipantsModal"
+                      class="cursor-pointer hover:text-[var(--text-accent)] transition-colors max-w-[300px] truncate inline-block"
+                      :title="selectedRecording.participants || t('help.noParticipants')">
+                    ${selectedRecording.participants || t('help.noParticipants')}
+                </span>
+            </div>
+
+            <!-- Owner (for shared recordings) -->
+            <div v-if="selectedRecording.is_shared" class="flex items-center gap-2">
+                <i class="fas fa-user text-[var(--text-accent)]"></i>
+                <span class="max-w-[300px] truncate inline-block"
+                      :title="'Owner: ' + (selectedRecording.owner_username || t('sharing.unknown'))">
+                    ${selectedRecording.owner_username || t('sharing.unknown')}
+                </span>
+            </div>
+
+            <!-- Meeting Date -->
+            <div class="flex items-center gap-2">
+                <i class="fas fa-calendar text-[var(--text-accent)]"></i>
+                <span @click="openMeetingDatePicker"
+                      class="cursor-pointer hover:text-[var(--text-accent)] transition-colors">
+                    ${selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'No date set'}
+                </span>
+            </div>
+
+            <!-- Other Metadata -->
+            <div v-if="activeRecordingMetadata && activeRecordingMetadata.length > 0" class="flex flex-wrap items-center gap-x-6 gap-y-2">
+                <span v-for="(item, index) in activeRecordingMetadata" :key="index" class="flex items-center gap-1.5">
+                    <i :class="item.icon"></i>
+                    <span :title="item.fullText || item.text">${item.text}</span>
+                </span>
+            </div>
+
+            <!-- Duplicate Indicator -->
+            <button v-if="selectedRecording.duplicate_info"
+                    @click="openDuplicatesModal(selectedRecording.duplicate_info)"
+                    class="flex items-center gap-1.5 text-amber-500 hover:text-amber-400 transition-colors cursor-pointer">
+                <i class="fas fa-copy"></i>
+                <span>${ selectedRecording.duplicate_info.total_copies } ${ t('upload.copies') || 'copies' }</span>
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-notes-tab.html b/templates/components/detail/desktop-notes-tab.html
new file mode 100644
index 00000000..0aed304b
--- /dev/null
+++ b/templates/components/detail/desktop-notes-tab.html
@@ -0,0 +1,57 @@
+<!-- Desktop Notes Tab -->
+<div v-if="selectedTab === 'notes'" class="h-full p-4 overflow-y-auto">
+    <div class="content-box h-full relative">
+        <div v-if="!editingNotes" class="absolute top-2 right-4 flex gap-1 z-10">
+            <button @click="copyNotes"
+                    :title="t('buttons.copyNotes')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-copy text-sm"></i>
+            </button>
+            <button @click="downloadNotes"
+                    :title="t('buttons.downloadNotes')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-download text-sm"></i>
+            </button>
+            <button @click="toggleEditNotes"
+                    :title="t('buttons.editNotes')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-edit text-sm"></i>
+            </button>
+        </div>
+
+        <div v-if="!editingNotes"
+             class="notes-box h-full"
+             @click="clickToEditNotes">
+            <div v-if="selectedRecording.notes_html"
+                 v-html="selectedRecording.notes_html">
+            </div>
+            <div v-else-if="selectedRecording.notes"
+                 class="whitespace-pre-wrap">
+                ${selectedRecording.notes}
+            </div>
+            <div v-else class="text-[var(--text-muted)] italic cursor-pointer hover:text-[var(--text-secondary)]">
+                ${ t('help.clickToAddNotes') }
+            </div>
+        </div>
+
+        <div v-else class="h-full flex flex-col">
+            <div class="markdown-editor-container flex-1">
+                <textarea ref="notesMarkdownEditor"
+                          v-model="selectedRecording.notes"
+                          class="w-full h-full p-4 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]"
+                          :placeholder="t('form.enterNotesMarkdown')">
+                </textarea>
+            </div>
+            <div class="flex justify-end gap-2 mt-2">
+                <button @click="cancelEditNotes"
+                        class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]">
+                    Cancel
+                </button>
+                <button @click="saveEditNotes"
+                        class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]">
+                    Save
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-right-panel.html b/templates/components/detail/desktop-right-panel.html
new file mode 100644
index 00000000..6055f3bc
--- /dev/null
+++ b/templates/components/detail/desktop-right-panel.html
@@ -0,0 +1,272 @@
+<!-- Desktop Right Panel (Summary/Notes/Chat) -->
+<div id="rightMainColumn" class="flex flex-col overflow-hidden" :style="{width: rightColumnWidth + '%'}">
+    <!-- Custom Audio Player -->
+    <div class="px-4 py-3 border-b border-[var(--border-primary)] flex-shrink-0">
+        <!-- Show message if audio has been deleted -->
+        <div v-if="selectedRecording.audio_deleted_at"
+             class="text-[var(--text-muted)] text-sm flex items-center gap-2">
+            <i class="fas fa-info-circle"></i>
+            <span v-text="t('help.audioDeletedMessage')"></span>
+        </div>
+        <!-- Show message for incognito recordings (no audio stored) -->
+        <div v-else-if="selectedRecording.incognito"
+             class="text-[var(--text-muted)] text-sm flex items-center gap-2 py-2">
+            <i class="fas fa-user-secret"></i>
+            <span v-text="t('incognito.audioNotStored')"></span>
+        </div>
+        <!-- Custom Audio Player Card -->
+        <div v-else class="bg-[var(--bg-tertiary)] rounded-xl p-4 shadow-sm border border-[var(--border-primary)] overflow-hidden">
+            <!-- Video/Audio element wrapped in Teleport for fullscreen -->
+            <Teleport to="body" :disabled="!videoFullscreen">
+                <div :class="videoFullscreen ? 'video-fullscreen-overlay' : ''"
+                     @mousemove="videoFullscreen && handleFullscreenMouseMove()"
+                     @click.self="videoFullscreen && toggleAudioPlayback()">
+
+                    <component :is="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') ? 'video' : 'audio'"
+                           ref="audioPlayerElement"
+                           :src="'/audio/' + selectedRecording.id"
+                           :volume="playerVolume"
+                           @play="handleAudioPlayPause"
+                           @pause="handleAudioPlayPause"
+                           @timeupdate="handleCustomAudioTimeUpdate"
+                           @loadedmetadata="handleAudioLoadedMetadata"
+                           @durationchange="handleAudioDurationChange"
+                           @ended="handleAudioEnded"
+                           @waiting="handleAudioWaiting"
+                           @canplay="handleAudioCanPlay"
+                           @click="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && toggleAudioPlayback()"
+                           @dblclick="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && !videoFullscreen && enterVideoFullscreen()"
+                           :class="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/')
+                               ? (videoFullscreen ? 'video-fullscreen-video' : (videoCollapsed ? 'hidden' : 'w-full rounded-lg mb-3 cursor-pointer'))
+                               : 'hidden'">
+                    </component>
+
+                    <!-- Fullscreen Subtitle Overlay -->
+                    <div v-if="videoFullscreen && currentSubtitle"
+                         class="video-fullscreen-subtitle"
+                         :class="{ 'subtitle-shifted': fullscreenControlsVisible }">
+                        <span v-if="currentSubtitle.speaker"
+                              class="video-fullscreen-subtitle-speaker"
+                              :style="{ color: 'var(--' + currentSubtitle.color + ')' }">${ currentSubtitle.speaker }:</span>
+                        <span>${ currentSubtitle.text }</span>
+                    </div>
+
+                    <!-- Fullscreen Control Bar -->
+                    <div v-if="videoFullscreen"
+                         class="video-fullscreen-controls"
+                         :class="{ visible: fullscreenControlsVisible }"
+                         @mousemove.stop="handleFullscreenMouseMove()">
+
+                        <!-- Progress Bar -->
+                        <div class="px-4 mb-2">
+                            <div class="w-full h-5 rounded-full cursor-pointer relative group flex items-center"
+                                 @mousedown="startProgressDrag"
+                                 @touchstart.prevent="startProgressDrag">
+                                <div class="progress-track w-full h-1 rounded-full relative bg-white/30">
+                                    <div class="h-full bg-white rounded-full pointer-events-none"
+                                         :style="{ width: audioProgressPercent + '%' }"></div>
+                                </div>
+                                <div class="absolute top-1/2 w-3 h-3 bg-white rounded-full shadow-md transition-transform group-hover:scale-125 pointer-events-none -translate-y-1/2"
+                                     :style="{ left: 'clamp(0px, calc(' + audioProgressPercent + '% - 6px), calc(100% - 12px))' }"></div>
+                            </div>
+                        </div>
+
+                        <!-- Controls Row -->
+                        <div class="flex items-center gap-3 px-4 pb-4">
+                            <!-- Play/Pause -->
+                            <button @click.stop="toggleAudioPlayback"
+                                    class="w-10 h-10 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all">
+                                <i :class="audioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-lg" :style="!audioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                            </button>
+
+                            <!-- Volume -->
+                            <div class="flex items-center gap-2">
+                                <button @click.stop="toggleAudioMute"
+                                        class="w-8 h-8 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all">
+                                    <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : playerVolume < 0.5 ? 'fas fa-volume-down' : 'fas fa-volume-up'" class="text-sm"></i>
+                                </button>
+                                <input type="range" min="0" max="1" step="0.05"
+                                       :value="audioIsMuted ? 0 : playerVolume"
+                                       @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                                       class="fullscreen-volume-slider w-20">
+                            </div>
+
+                            <!-- Time -->
+                            <div class="flex items-baseline gap-1 text-white">
+                                <span class="text-sm font-mono">${ formatAudioTime(displayCurrentTime) }</span>
+                                <span class="text-xs opacity-60">/</span>
+                                <span class="text-xs opacity-60 font-mono">${ formatAudioTime(audioDuration) }</span>
+                            </div>
+
+                            <div class="flex-1"></div>
+
+                            <!-- Speed -->
+                            <button @click.stop="cyclePlaybackRate"
+                                    class="px-2 h-8 flex items-center justify-center rounded-lg text-white hover:bg-white/20 transition-all"
+                                    title="Playback speed">
+                                <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(playbackRate) }</span>
+                            </button>
+
+                            <!-- Exit Fullscreen -->
+                            <button @click.stop="exitVideoFullscreen"
+                                    class="w-8 h-8 flex items-center justify-center rounded-full text-white hover:bg-white/20 transition-all"
+                                    :title="t('tooltips.exitFullscreen')">
+                                <i class="fas fa-compress text-sm"></i>
+                            </button>
+                        </div>
+                    </div>
+                </div>
+            </Teleport>
+
+            <!-- Normal Controls (hidden when fullscreen) -->
+            <div v-show="!videoFullscreen">
+                <!-- Progress Bar (now on top, full width, draggable) -->
+                <div class="w-full h-4 rounded-full cursor-pointer relative mb-3 group flex items-center"
+                     @mousedown="startProgressDrag">
+                    <!-- Track background -->
+                    <div class="progress-track w-full h-2 rounded-full relative bg-[var(--border-accent)] opacity-40">
+                        <!-- Progress fill -->
+                        <div class="h-full bg-[var(--text-accent)] rounded-full pointer-events-none opacity-100"
+                             :style="{ width: audioProgressPercent + '%' }"></div>
+                    </div>
+                    <!-- Progress dot - stays within track bounds -->
+                    <div class="absolute top-1/2 w-4 h-4 bg-[var(--text-accent)] rounded-full shadow-md transition-transform group-hover:scale-110 pointer-events-none -translate-y-1/2"
+                         :style="{ left: 'clamp(0px, calc(' + audioProgressPercent + '% - 8px), calc(100% - 16px))' }"
+                         style="box-shadow: 0 2px 6px rgba(0,0,0,0.3);"></div>
+                </div>
+
+                <!-- Controls Row -->
+                <div class="flex items-center gap-2 min-w-0">
+                    <!-- Play/Pause Button -->
+                    <button @click="toggleAudioPlayback"
+                            class="w-10 h-10 flex items-center justify-center rounded-full player-play-button transition-all duration-200 flex-shrink-0 shadow-md hover:shadow-lg hover:scale-105"
+                            :title="audioIsPlaying ? t('tooltips.pause') : t('tooltips.play')">
+                        <i :class="audioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-base" :style="!audioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                    </button>
+
+                    <!-- Time Display -->
+                    <div class="flex items-baseline gap-1 flex-shrink-0 min-w-0">
+                        <span class="text-sm font-semibold font-mono" :class="isDraggingProgress ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]'">${ formatAudioTime(displayCurrentTime) }</span>
+                        <span class="text-xs text-[var(--text-muted)]">/</span>
+                        <span class="text-xs text-[var(--text-muted)] font-mono">${ formatAudioTime(audioDuration) }</span>
+                    </div>
+
+                    <!-- Playback Speed Control -->
+                    <div class="relative flex-shrink-0">
+                        <button ref="speedButtonDesktop"
+                                @click="showSpeedMenu = !showSpeedMenu; $nextTick(() => updateSpeedMenuPosition($refs.speedButtonDesktop))"
+                                data-speed-toggle
+                                class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all"
+                                :title="t('tooltips.playbackSpeed') || 'Playback speed'">
+                            <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(playbackRate) }</span>
+                        </button>
+                        <!-- Dropdown menu (teleported to body, fixed positioning) -->
+                        <Teleport to="body">
+                            <div v-if="showSpeedMenu" @click.stop
+                                 data-speed-dropdown
+                                 class="fixed bg-[var(--bg-tertiary)] border border-[var(--border-accent)] rounded-md shadow-xl z-[9999] speed-dropdown overflow-y-auto backdrop-blur-sm"
+                                 :style="speedMenuPosition">
+                                <div class="py-0.5">
+                                    <button v-for="speed in playbackSpeeds" :key="speed"
+                                            @mousedown.prevent="setPlaybackRate(speed); showSpeedMenu = false"
+                                            class="w-full px-2 py-0.5 text-[11px] font-mono text-left hover:bg-[var(--bg-accent-light)] transition-colors"
+                                            :class="speed === playbackRate ? 'text-[var(--text-accent)] font-semibold bg-[var(--bg-accent-light)]' : 'text-[var(--text-primary)]'">
+                                        ${ speed }x
+                                    </button>
+                                </div>
+                            </div>
+                        </Teleport>
+                    </div>
+
+                    <!-- Spacer -->
+                    <div class="flex-1 min-w-0"></div>
+
+                    <!-- Volume Control - hidden on very narrow screens -->
+                    <div class="hidden sm:flex items-center gap-1 flex-shrink-0">
+                        <button @click="toggleAudioMute"
+                                class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] hover:opacity-80 transition-all"
+                                :class="audioIsMuted || playerVolume === 0 ? 'text-[var(--text-muted)]' : 'text-[var(--text-accent)]'"
+                                :title="audioIsMuted ? t('tooltips.unmute') : t('tooltips.mute')">
+                            <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : playerVolume < 0.5 ? 'fas fa-volume-down' : 'fas fa-volume-up'" class="text-sm"></i>
+                        </button>
+                        <input type="range" min="0" max="1" step="0.05"
+                               :value="audioIsMuted ? 0 : playerVolume"
+                               @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                               class="volume-slider w-16">
+                    </div>
+
+                    <!-- Download Button -->
+                    <a :href="'/audio/' + selectedRecording.id + '?download=true'"
+                       download
+                       class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all flex-shrink-0"
+                       :title="t('buttons.downloadAudio') || 'Download audio'">
+                        <i class="fas fa-download text-sm"></i>
+                    </a>
+
+                    <!-- Video Fullscreen Button -->
+                    <button v-if="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') && !videoCollapsed"
+                            @click="enterVideoFullscreen"
+                            class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] text-[var(--text-accent)] hover:opacity-80 transition-all flex-shrink-0"
+                            :title="t('tooltips.fullscreenVideo')">
+                        <i class="fas fa-expand text-sm"></i>
+                    </button>
+
+                    <!-- Video Toggle Button -->
+                    <button v-if="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/')"
+                            @click="videoCollapsed = !videoCollapsed"
+                            class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-primary)] transition-all flex-shrink-0"
+                            :class="videoCollapsed ? 'text-[var(--text-muted)]' : 'text-[var(--text-accent)]'"
+                            :title="videoCollapsed ? t('tooltips.showVideo') : t('tooltips.hideVideo')">
+                        <i :class="videoCollapsed ? 'fas fa-eye-slash' : 'fas fa-eye'" class="text-sm"></i>
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Summary/Notes Tabs -->
+    <div :class="{'flex-1': !isChatMaximized, 'flex-none': isChatMaximized}" class="flex flex-col overflow-hidden">
+        <!-- Tab Navigation -->
+        <div class="bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)] flex">
+            <button @click="selectedTab = 'summary'"
+                    :class="[
+                        'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                        selectedTab === 'summary'
+                            ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                            : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                    ]">
+                ${ t('summary.title') }
+            </button>
+            <button @click="selectedTab = 'notes'"
+                    :class="[
+                        'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                        selectedTab === 'notes'
+                            ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                            : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                    ]">
+                ${ t('notes.title') }
+            </button>
+            <button v-if="selectedRecording.events && selectedRecording.events.length > 0"
+                    @click="selectedTab = 'events'"
+                    :class="[
+                        'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                        selectedTab === 'events'
+                            ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                            : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                    ]">
+                <i class="fas fa-calendar-alt mr-1"></i>
+                ${ t('events.title') } (${ selectedRecording.events.length })
+            </button>
+        </div>
+
+        <!-- Tab Content -->
+        <div v-if="!isChatMaximized" class="flex-1 overflow-hidden">
+            {% include 'components/detail/desktop-summary-tab.html' %}
+            {% include 'components/detail/desktop-notes-tab.html' %}
+            {% include 'components/detail/desktop-events-tab.html' %}
+        </div>
+    </div>
+
+    <!-- Chat Section -->
+    {% include 'components/detail/desktop-chat-section.html' %}
+</div>
diff --git a/templates/components/detail/desktop-summary-tab.html b/templates/components/detail/desktop-summary-tab.html
new file mode 100644
index 00000000..125a7d03
--- /dev/null
+++ b/templates/components/detail/desktop-summary-tab.html
@@ -0,0 +1,79 @@
+<!-- Desktop Summary Tab -->
+<div v-if="selectedTab === 'summary'" class="h-full p-4 overflow-y-auto">
+    <div v-if="selectedRecording.status === 'SUMMARIZING'" class="text-center py-8">
+        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+        <p class="mt-2 text-[var(--text-muted)]" v-text="t('summary.summaryInProgress')"></p>
+    </div>
+
+    <div v-else-if="!selectedRecording.summary" class="text-center py-8">
+        <i class="fas fa-file-alt text-3xl text-[var(--text-muted)] mb-3"></i>
+        <p class="text-[var(--text-muted)] mb-4" v-text="t('summary.noSummary')"></p>
+        <!-- Show message if transcription is an error -->
+        <p v-if="processedTranscription.isError" class="text-sm text-amber-500 mb-2">
+            <i class="fas fa-exclamation-triangle mr-1"></i>
+            Cannot generate summary: transcription failed
+        </p>
+        <div :class="['inline-flex rounded-lg shadow-lg transition-all duration-200 overflow-hidden', processedTranscription.isError ? '' : 'hover:shadow-xl']">
+            <button @click="generateSummary()"
+                    :disabled="processedTranscription.isError"
+                    :class="[
+                        'px-6 py-3 font-medium transition-colors duration-200',
+                        processedTranscription.isError
+                            ? 'bg-gray-400 text-gray-200 cursor-not-allowed'
+                            : 'bg-gradient-to-r from-blue-600 to-purple-600 text-white hover:from-blue-700 hover:to-purple-700'
+                    ]">
+                <i class="fas fa-magic mr-2"></i>${ t('summary.generateSummary') }
+            </button>
+            <button v-if="!processedTranscription.isError"
+                    @click="openCustomizeSummaryModal"
+                    title="Customise the summarisation prompt"
+                    class="px-3 py-3 font-medium text-white bg-gradient-to-r from-purple-600 to-purple-700 hover:from-purple-700 hover:to-purple-800 transition-colors duration-200 border-l border-white/20">
+                <i class="fas fa-sliders-h text-sm"></i>
+            </button>
+        </div>
+    </div>
+
+    <div v-else class="content-box relative">
+        <div v-if="!editingSummary" class="absolute top-2 right-4 flex gap-1 z-10">
+            <button @click="copySummary"
+                    :title="t('buttons.copySummary')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-copy text-sm"></i>
+            </button>
+            <button @click="downloadSummary"
+                    :title="t('buttons.downloadSummary')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-download text-sm"></i>
+            </button>
+            <button @click="toggleEditSummary"
+                    :title="t('buttons.editSummary')"
+                    class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                <i class="fas fa-edit text-sm"></i>
+            </button>
+        </div>
+
+        <div v-if="!editingSummary"
+             class="summary-box"
+             v-html="selectedRecording.summary_html || selectedRecording.summary">
+        </div>
+        <div v-else class="h-full flex flex-col">
+            <div class="markdown-editor-container flex-1">
+                <textarea ref="summaryMarkdownEditor"
+                          v-model="selectedRecording.summary"
+                          class="w-full h-full p-4 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]"
+                          :placeholder="t('form.enterSummaryMarkdown')">
+                </textarea>
+            </div>
+            <div class="flex justify-end gap-2 mt-2">
+                <button @click="cancelEditSummary"
+                        class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]">
+                    Cancel
+                </button>
+                <button @click="saveEditSummary"
+                        class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]">
+                    Save
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/desktop-transcription-panel.html b/templates/components/detail/desktop-transcription-panel.html
new file mode 100644
index 00000000..0d4cd87e
--- /dev/null
+++ b/templates/components/detail/desktop-transcription-panel.html
@@ -0,0 +1,271 @@
+<!-- Desktop Transcription Panel (Left Column) -->
+<div id="leftMainColumn" class="flex flex-col overflow-hidden" :style="{width: leftColumnWidth + '%'}">
+    <!-- Transcription Header -->
+    <div class="bg-[var(--bg-tertiary)] px-4 py-3 border-b border-[var(--border-primary)] flex items-center justify-between">
+        <h3 class="font-semibold flex items-center">
+            <i class="fas fa-file-text mr-2"></i>
+            <span v-text="t('transcription.title')"></span>
+        </h3>
+        <div class="flex items-center gap-2">
+            <!-- Follow Player Checkbox -->
+            <div v-if="processedTranscription.isJson && processedTranscription.hasDialogue"
+                 class="follow-player-control text-[var(--text-muted)] hover:text-[var(--text-primary)]"
+                 @click="toggleFollowPlayerMode"
+                 :title="followPlayerMode ? t('tooltips.followPlayerEnabled') : t('tooltips.followPlayerDisabled')">
+                <input type="checkbox"
+                       :checked="followPlayerMode"
+                       @click.stop="toggleFollowPlayerMode">
+                <i class="fas fa-arrows-alt-v follow-icon"></i>
+            </div>
+
+            <!-- View Mode Toggle -->
+            <div v-if="processedTranscription.hasDialogue" class="view-mode-toggle">
+                <button @click="toggleTranscriptionViewMode"
+                        :class="['toggle-button', transcriptionViewMode === 'simple' ? 'active' : '']">
+                    <i class="fas fa-list"></i><span v-text="t('transcription.simple')"></span>
+                </button>
+                <button @click="toggleTranscriptionViewMode"
+                        :class="['toggle-button', transcriptionViewMode === 'bubble' ? 'active' : '']">
+                    <i class="fas fa-comments"></i><span v-text="t('transcription.bubble')"></span>
+                </button>
+            </div>
+
+            <!-- Copy Button -->
+            <button @click="copyTranscription"
+                    class="copy-btn"
+                    :title="t('tooltips.copyTranscript')">
+                <i class="fas fa-copy"></i>
+            </button>
+            <!-- Download Button with Dropdown -->
+            <div v-if="selectedRecording && selectedRecording.transcription" class="relative">
+                <button @click="showDownloadMenu = !showDownloadMenu"
+                        data-download-toggle
+                        class="copy-btn flex items-center"
+                        :title="t('tooltips.downloadTranscriptWithTemplate')">
+                    <i class="fas fa-download"></i>
+                    <i class="fas fa-caret-down ml-1 text-[10px] opacity-50"></i>
+                </button>
+                <!-- Dropdown Menu -->
+                <div v-if="showDownloadMenu"
+                     data-download-dropdown
+                     class="absolute right-0 top-full mt-1 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-50 overflow-hidden whitespace-nowrap">
+                    <button @click="downloadWithDefaultTemplate(); showDownloadMenu = false"
+                            class="w-full text-left px-3 py-1.5 text-xs hover:bg-[var(--bg-tertiary)] transition-colors flex items-center gap-2">
+                        <i class="fas fa-star text-[var(--text-accent)] text-[10px]"></i>
+                        <span v-text="t('transcriptTemplates.downloadDefault')"></span>
+                    </button>
+                    <button @click="showTemplateSelector(); showDownloadMenu = false"
+                            class="w-full text-left px-3 py-1.5 text-xs hover:bg-[var(--bg-tertiary)] transition-colors flex items-center gap-2 border-t border-[var(--border-secondary)]">
+                        <i class="fas fa-list text-[var(--text-muted)] text-[10px]"></i>
+                        <span v-text="t('transcriptTemplates.chooseTemplate')"></span>
+                    </button>
+                </div>
+            </div>
+            <!-- Edit Transcription Button -->
+            <button @click="openTranscriptionEditor"
+                    v-if="selectedRecording && selectedRecording.transcription"
+                    class="copy-btn"
+                    :title="t('tooltips.editTranscript')">
+                <i class="fas fa-edit"></i>
+            </button>
+        </div>
+    </div>
+
+    <!-- Transcription Content -->
+    <div class="flex-1 overflow-y-auto p-4 relative">
+        <!-- Floating Processing Indicator -->
+        <div v-if="selectedRecording.status === 'PROCESSING'"
+             :class="['processing-indicator-floating', processingIndicatorMinimized ? 'minimized' : '']">
+            <template v-if="!processingIndicatorMinimized">
+                <div class="processing-indicator-content">
+                    <i class="fas fa-spinner fa-spin text-[var(--text-accent)]"></i>
+                    <span class="text-sm text-[var(--text-secondary)]" v-text="t('help.processingTranscription')"></span>
+                </div>
+                <button @click="processingIndicatorMinimized = true"
+                        class="processing-indicator-minimize"
+                        :title="t('tooltips.minimize')">
+                    <i class="fas fa-chevron-up"></i>
+                </button>
+            </template>
+            <template v-else>
+                <button @click="processingIndicatorMinimized = false"
+                        class="processing-indicator-expand"
+                        :title="t('help.processingTranscription')">
+                    <i class="fas fa-spinner fa-spin"></i>
+                </button>
+            </template>
+        </div>
+
+        <!-- No transcription state (only show if not processing and no transcription) -->
+        <div v-if="selectedRecording.status !== 'PROCESSING' && !selectedRecording.transcription" class="text-center py-8">
+            <i class="fas fa-file-text text-3xl text-[var(--text-muted)] mb-3"></i>
+            <p class="text-[var(--text-muted)]" v-text="t('transcription.noTranscription')"></p>
+        </div>
+
+        <!-- Error Display (when transcription is an error message) -->
+        <div v-if="processedTranscription.isError" class="error-display-container">
+            <div :class="[
+                'rounded-lg p-5 border',
+                processedTranscription.error.type === 'size_limit' ? 'bg-amber-500/10 border-amber-500/30' :
+                processedTranscription.error.type === 'timeout' ? 'bg-orange-500/10 border-orange-500/30' :
+                processedTranscription.error.type === 'auth' ? 'bg-red-500/10 border-red-500/30' :
+                processedTranscription.error.type === 'rate_limit' ? 'bg-yellow-500/10 border-yellow-500/30' :
+                processedTranscription.error.type === 'connection' ? 'bg-blue-500/10 border-blue-500/30' :
+                processedTranscription.error.type === 'service_error' ? 'bg-purple-500/10 border-purple-500/30' :
+                'bg-gray-500/10 border-gray-500/30'
+            ]">
+                <div class="flex items-start gap-4">
+                    <div :class="[
+                        'flex-shrink-0 w-12 h-12 rounded-full flex items-center justify-center',
+                        processedTranscription.error.type === 'size_limit' ? 'bg-amber-500/20' :
+                        processedTranscription.error.type === 'timeout' ? 'bg-orange-500/20' :
+                        processedTranscription.error.type === 'auth' ? 'bg-red-500/20' :
+                        processedTranscription.error.type === 'rate_limit' ? 'bg-yellow-500/20' :
+                        processedTranscription.error.type === 'connection' ? 'bg-blue-500/20' :
+                        processedTranscription.error.type === 'service_error' ? 'bg-purple-500/20' :
+                        'bg-gray-500/20'
+                    ]">
+                        <i :class="[
+                            'fas text-xl',
+                            processedTranscription.error.icon,
+                            processedTranscription.error.type === 'size_limit' ? 'text-amber-500' :
+                            processedTranscription.error.type === 'timeout' ? 'text-orange-500' :
+                            processedTranscription.error.type === 'auth' ? 'text-red-500' :
+                            processedTranscription.error.type === 'rate_limit' ? 'text-yellow-500' :
+                            processedTranscription.error.type === 'connection' ? 'text-blue-500' :
+                            processedTranscription.error.type === 'service_error' ? 'text-purple-500' :
+                            'text-gray-500'
+                        ]"></i>
+                    </div>
+                    <div class="flex-1 min-w-0">
+                        <h3 :class="[
+                            'text-lg font-semibold mb-2',
+                            processedTranscription.error.type === 'size_limit' ? 'text-amber-600 dark:text-amber-400' :
+                            processedTranscription.error.type === 'timeout' ? 'text-orange-600 dark:text-orange-400' :
+                            processedTranscription.error.type === 'auth' ? 'text-red-600 dark:text-red-400' :
+                            processedTranscription.error.type === 'rate_limit' ? 'text-yellow-600 dark:text-yellow-400' :
+                            processedTranscription.error.type === 'connection' ? 'text-blue-600 dark:text-blue-400' :
+                            processedTranscription.error.type === 'service_error' ? 'text-purple-600 dark:text-purple-400' :
+                            'text-gray-600 dark:text-gray-400'
+                        ]">
+                            ${processedTranscription.error.title}
+                        </h3>
+                        <p class="text-[var(--text-primary)] mb-3">
+                            ${processedTranscription.error.message}
+                        </p>
+                        <div v-if="processedTranscription.error.guidance" class="flex items-start gap-2 text-sm text-[var(--text-secondary)] bg-[var(--bg-tertiary)]/50 rounded-lg p-3">
+                            <i class="fas fa-lightbulb text-yellow-500 mt-0.5 flex-shrink-0"></i>
+                            <span>${processedTranscription.error.guidance}</span>
+                        </div>
+                    </div>
+                </div>
+                <!-- Action buttons -->
+                <div class="mt-4 flex items-center gap-3 pt-4 border-t border-[var(--border-secondary)]">
+                    <button @click="reprocessTranscription(selectedRecording.id)"
+                            v-if="selectedRecording.can_edit !== false"
+                            class="px-4 py-2 bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] text-white rounded-lg transition-colors flex items-center gap-2">
+                        <i class="fas fa-redo-alt"></i>
+                        <span>Reprocess</span>
+                    </button>
+                    <details class="text-xs w-full">
+                        <summary class="cursor-pointer text-[var(--text-muted)] hover:text-[var(--text-secondary)]">
+                            Technical details
+                        </summary>
+                        <pre v-if="processedTranscription.error.technical" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-lg text-[var(--text-muted)] text-xs max-h-32 overflow-auto whitespace-pre-wrap break-all w-full">${processedTranscription.error.technical}</pre>
+                    </details>
+                </div>
+            </div>
+        </div>
+
+        <!-- Speaker Legend (for dialogue transcriptions in bubble view only) -->
+        <div v-if="!processedTranscription.isError && processedTranscription.hasDialogue && processedTranscription.speakers.length > 0 && transcriptionViewMode === 'bubble'"
+             :class="['speaker-legend', legendExpanded ? 'expanded' : '']">
+            <div class="speaker-legend-header" @click="legendExpanded = !legendExpanded">
+                <div class="speaker-legend-title">
+                    <i class="fas fa-users"></i>
+                    <span v-text="t('help.speakers')"></span>
+                    <span class="speaker-count-indicator">(${processedTranscription.speakers.length})</span>
+                </div>
+                <i class="fas fa-chevron-down speaker-legend-toggle"></i>
+            </div>
+            <div class="speaker-legend-content">
+                <div v-for="(speaker, index) in processedTranscription.speakers"
+                     :key="`${selectedRecording.id}-speaker-legend-${index}`"
+                     :class="['speaker-legend-item', speaker.color]">
+                    <span class="speaker-name">${speaker.name}</span>
+                </div>
+            </div>
+        </div>
+
+        <!-- Transcription Display (hide if it's an error) -->
+        <div v-if="selectedRecording.transcription && !processedTranscription.isError">
+            <!-- Simple View -->
+            <div v-if="!processedTranscription.hasDialogue || transcriptionViewMode === 'simple'"
+                 class="transcription-simple-view">
+                <div v-if="processedTranscription.hasDialogue">
+                    <div v-for="(segment, index) in processedTranscription.simpleSegments"
+                         :key="`seg-${index}-${segment.startTime}`"
+                         :class="['speaker-segment', { 'active-playing-segment': currentPlayingSegmentIndex === index }]"
+                         @click="seekAudioFromEvent"
+                         @dblclick.stop="openAsrEditorAtSegment(index)"
+                         :title="'Double-click to edit this segment'"
+                         :data-start-time="segment.startTime"
+                         :data-segment-index="index">
+                        <template v-if="segment.showSpeaker">
+                            <div v-if="showTimestampsSimpleView"
+                                 :class="['speaker-tablet-group', segment.color]">
+                                <span class="speaker-tablet-time">${ formatTimestamp(segment.startTime) }</span>
+                                <span class="speaker-tablet-name">${segment.speaker}</span>
+                            </div>
+                            <div v-else :class="['speaker-tablet', segment.color]">
+                                ${segment.speaker}
+                            </div>
+                        </template>
+                        <div class="speaker-text">
+                            ${segment.sentence}
+                        </div>
+                    </div>
+                </div>
+                <div v-else>
+                    <div v-if="processedTranscription.simpleSegments && processedTranscription.simpleSegments.length > 0">
+                        <div v-for="(segment, index) in processedTranscription.simpleSegments"
+                             :key="`seg-${index}-${segment.startTime}`"
+                             :class="['transcript-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors', { 'active-playing-segment': currentPlayingSegmentIndex === index }]"
+                             @click="seekAudioFromEvent"
+                             @dblclick.stop="openAsrEditorAtSegment(index)"
+                             :title="'Double-click to edit this segment'"
+                             :data-start-time="segment.startTime"
+                             :data-segment-index="index">
+                            <span v-if="showTimestampsSimpleView"
+                                  class="speaker-segment-timestamp speaker-segment-timestamp--inline">
+                                ${ formatTimestamp(segment.startTime) }
+                            </span>${segment.sentence}
+                        </div>
+                    </div>
+                    <div v-else class="whitespace-pre-wrap">
+                        ${processedTranscription.content}
+                    </div>
+                </div>
+            </div>
+
+            <!-- Bubble View -->
+            <div v-else-if="transcriptionViewMode === 'bubble'"
+                 class="transcription-with-speakers">
+                <template v-for="(row, rowIndex) in processedTranscription.bubbleRows" :key="`${selectedRecording.id}-bubble-row-${rowIndex}`">
+                    <div :class="['bubble-row', row.isMe ? 'speaker-me' : '']">
+                        <div v-for="(bubble, bubbleIndex) in row.bubbles"
+                             :key="`bubble-${rowIndex}-${bubbleIndex}-${bubble.startTime}`"
+                             :class="['speaker-bubble', bubble.color, row.isMe ? 'speaker-me' : '', { 'active-playing-segment': currentPlayingSegmentIndex === getBubbleGlobalIndex(rowIndex, bubbleIndex) }]"
+                             @click="seekAudioFromEvent"
+                             :data-start-time="bubble.startTime"
+                             :data-segment-index="getBubbleGlobalIndex(rowIndex, bubbleIndex)">
+                            <div class="speaker-bubble-content">
+                                ${bubble.sentence}
+                            </div>
+                        </div>
+                    </div>
+                </template>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/empty-state.html b/templates/components/detail/empty-state.html
new file mode 100644
index 00000000..69565e08
--- /dev/null
+++ b/templates/components/detail/empty-state.html
@@ -0,0 +1,12 @@
+<!-- Empty State -->
+<div v-if="currentView === 'detail' && !selectedRecording" class="flex-1 flex items-center justify-center">
+    <div class="text-center">
+        <i class="fas fa-microphone text-6xl text-[var(--text-muted)] mb-4"></i>
+        <h2 class="text-2xl font-bold mb-2" v-text="t('colorScheme.selectRecording')"></h2>
+        <p class="text-[var(--text-muted)] mb-6" v-text="t('colorScheme.chooseRecording')"></p>
+        <button @click="switchToUploadView"
+                class="px-6 py-3 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+            <i class="fas fa-plus mr-2"></i>Upload New Recording
+        </button>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-chat-panel.html b/templates/components/detail/mobile-chat-panel.html
new file mode 100644
index 00000000..809fc375
--- /dev/null
+++ b/templates/components/detail/mobile-chat-panel.html
@@ -0,0 +1,59 @@
+<!-- Mobile Chat Panel -->
+<div v-if="mobileTab === 'chat'" class="h-full flex flex-col rounded-lg border border-[var(--border-primary)] overflow-hidden relative">
+    <!-- Clear button - fixed at top right -->
+    <button v-if="chatMessages.length > 0"
+            @click="clearChat"
+            class="absolute top-2 right-2 p-1 text-[var(--text-muted)] opacity-60 hover:opacity-100 hover:text-[var(--text-danger)] rounded transition-all duration-200 z-20"
+            title="Clear chat">
+        <i class="fas fa-times text-xs"></i>
+    </button>
+
+    <div ref="chatMessagesRef" class="flex-1 overflow-y-auto p-4 space-y-4 bg-[var(--bg-secondary)]">
+        <div v-if="chatMessages.length === 0" class="text-center py-8">
+            <i class="fas fa-robot text-3xl text-[var(--text-muted)] mb-3"></i>
+            <p class="text-[var(--text-muted)]" v-text="t('help.askAboutTranscription')"></p>
+        </div>
+        <div v-for="(message, index) in chatMessages" :key="index"
+             :class="['message relative group', message.role === 'user' ? 'user-message ml-auto' : 'ai-message',
+                      message.role === 'assistant' ? 'pr-10' : '']">
+            <!-- Copy button for assistant messages -->
+            <button v-if="message.role === 'assistant'"
+                    @click="copyMessage(message.content, $event)"
+                    class="absolute top-2 right-2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded transition-all duration-200"
+                    :title="t('buttons.copyMessage')">
+                <i class="fas fa-copy text-sm"></i>
+            </button>
+            <!-- Show thinking content if available -->
+            <div v-if="message.thinking && message.role === 'assistant'" class="mb-2">
+                <button @click="message.thinkingExpanded = !message.thinkingExpanded"
+                        class="text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)] flex items-center gap-1">
+                    <i :class="['fas', message.thinkingExpanded ? 'fa-chevron-down' : 'fa-chevron-right']"></i>
+                    <span v-text="t('help.modelReasoning')"></span>
+                    <span class="text-[var(--text-muted)]">(${message.thinking.split('\n').length} lines)</span>
+                </button>
+                <div v-if="message.thinkingExpanded"
+                     class="mt-2 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg text-xs text-[var(--text-muted)] max-h-64 overflow-y-auto">
+                    <pre class="whitespace-pre-wrap font-mono">${message.thinking}</pre>
+                </div>
+            </div>
+            <!-- Main message content -->
+            <div v-if="message.html" v-html="message.html"></div>
+            <div v-else class="whitespace-pre-wrap">${message.content}</div>
+        </div>
+        <div v-if="isChatLoading" class="ai-message">
+            <i class="fas fa-spinner fa-spin mr-2"></i> ${ t('chat.thinking') }
+        </div>
+    </div>
+    <div class="border-t border-[var(--border-primary)] p-4 bg-[var(--bg-tertiary)]">
+        <div class="flex gap-2">
+            <textarea v-model="chatInput" ref="chatInputRef" @keydown="handleChatKeydown" :disabled="selectedRecording.status !== 'COMPLETED' || processedTranscription.isError" :placeholder="t('chat.placeholder')" class="flex-1 px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm" rows="2"></textarea>
+            <button @click="sendChatMessage" :disabled="!chatInput.trim() || isChatLoading || selectedRecording.status !== 'COMPLETED' || processedTranscription.isError" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors disabled:opacity-50 disabled:cursor-not-allowed">
+                <i class="fas fa-paper-plane"></i>
+            </button>
+        </div>
+        <p v-if="processedTranscription.isError" class="text-xs text-amber-500 mt-2">
+            <i class="fas fa-exclamation-triangle mr-1"></i>
+            ${ t('chat.cannotChatTranscriptionFailed') }
+        </p>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-events-panel.html b/templates/components/detail/mobile-events-panel.html
new file mode 100644
index 00000000..93e0cc4a
--- /dev/null
+++ b/templates/components/detail/mobile-events-panel.html
@@ -0,0 +1,65 @@
+<!-- Mobile Events Panel -->
+<div v-if="mobileTab === 'events' && selectedRecording.events && selectedRecording.events.length > 0" class="h-full flex flex-col space-y-4">
+    <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+        <button @click="downloadICS" v-if="selectedRecording.events && selectedRecording.events.length > 0"
+                class="copy-btn"
+                :title="t('buttons.exportCalendar')">
+            <i class="fas fa-calendar-plus"></i>
+        </button>
+    </div>
+    <div class="flex-grow overflow-y-auto mobile-content-box">
+        <div class="space-y-3">
+            <div v-for="event in selectedRecording.events" :key="event.id"
+                 class="bg-[var(--bg-tertiary)] rounded-lg p-3 border border-[var(--border-primary)]">
+                <div class="flex justify-between items-start mb-2">
+                    <div class="flex-1 min-w-0 pr-2">
+                        <h3 class="text-base font-semibold text-[var(--text-primary)] mb-1">
+                            <i class="fas fa-calendar-check mr-2 text-[var(--text-accent)] text-sm"></i>
+                            ${ event.title }
+                        </h3>
+                        <p v-if="event.description" class="text-xs text-[var(--text-secondary)] mb-2">
+                            ${ event.description }
+                        </p>
+                    </div>
+                    <div class="flex items-center gap-1 flex-shrink-0">
+                        <button @click="downloadEventICS(event)"
+                                class="px-2 py-1 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-xs flex items-center gap-1"
+                                :title="t('events.addToCalendar')">
+                            <i class="fas fa-download text-xs"></i>
+                            <span v-text="t('events.add')"></span>
+                        </button>
+                        <button @click="deleteEvent(event)"
+                                class="p-1.5 text-[var(--text-muted)] hover:text-red-500 hover:bg-red-500/10 rounded-lg transition-colors"
+                                :title="t('events.delete')">
+                            <i class="fas fa-trash-alt text-xs"></i>
+                        </button>
+                    </div>
+                </div>
+                <div class="grid grid-cols-1 gap-2 text-xs">
+                    <div class="flex items-center text-[var(--text-muted)]">
+                        <i class="fas fa-clock mr-2 text-[var(--text-accent)]"></i>
+                        <span>
+                            ${ formatEventDateTime(event.start_datetime) }
+                            <template v-if="event.end_datetime">
+                                - ${ formatEventDateTime(event.end_datetime, true) }
+                            </template>
+                        </span>
+                    </div>
+                    <div v-if="event.location" class="flex items-center text-[var(--text-muted)]">
+                        <i class="fas fa-map-marker-alt mr-2 text-[var(--text-accent)]"></i>
+                        <span>${ event.location }</span>
+                    </div>
+                    <div v-if="event.attendees && event.attendees.length > 0" class="flex items-start text-[var(--text-muted)]">
+                        <i class="fas fa-users mr-2 text-[var(--text-accent)] mt-0.5"></i>
+                        <div class="flex-1">
+                            <span v-for="(attendee, index) in event.attendees" :key="index"
+                                  class="inline-block bg-[var(--bg-secondary)] px-2 py-0.5 rounded mr-1 mb-1">
+                                ${ attendee }
+                            </span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-header.html b/templates/components/detail/mobile-header.html
new file mode 100644
index 00000000..4f374927
--- /dev/null
+++ b/templates/components/detail/mobile-header.html
@@ -0,0 +1,160 @@
+<!-- Mobile Header for Detail View -->
+<div class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] p-4 flex-shrink-0">
+    <div @click="isMetadataExpanded = !isMetadataExpanded" class="cursor-pointer">
+        <div class="flex items-center justify-between gap-3">
+            <div class="flex-1 min-w-0">
+                <div class="flex items-center gap-1.5 mb-1">
+                    <h1 v-if="!editingTitle"
+                        @dblclick.stop="selectedRecording.can_edit !== false ? toggleEditTitle() : null"
+                        :class="[
+                            'text-lg font-bold truncate',
+                            selectedRecording.is_shared ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]',
+                            selectedRecording.can_edit !== false ? 'cursor-text hover:opacity-80 transition-opacity' : ''
+                        ]"
+                        :title="selectedRecording.can_edit !== false ? 'Double-click to edit' : selectedRecording.title || 'Untitled Recording'">
+                        ${selectedRecording.title || 'Untitled Recording'}
+                    </h1>
+                    <input v-else
+                           v-model="selectedRecording.title"
+                           @blur="saveTitle"
+                           @keyup.enter="saveTitle"
+                           @keyup.esc="cancelEditTitle"
+                           @click.stop
+                           ref="titleInput"
+                           class="text-lg font-bold bg-transparent border-b-2 border-[var(--border-focus)] focus:outline-none text-[var(--text-primary)] flex-1 px-1"
+                           placeholder="Untitled Recording">
+
+                    <button v-if="!editingTitle && selectedRecording.can_edit !== false"
+                            @click.stop="toggleEditTitle"
+                            class="p-1.5 text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors flex-shrink-0">
+                        <i class="fas fa-pen text-xs"></i>
+                    </button>
+                    <button v-if="!editingTitle && selectedRecording.can_edit !== false && selectedRecording.status === 'COMPLETED'"
+                            @click.stop="regenerateTitle"
+                            :disabled="regeneratingTitle"
+                            class="p-1.5 text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors flex-shrink-0"
+                            :title="t('tooltips.regenerateTitle')">
+                        <i class="fas fa-sync-alt text-xs" :class="{ 'fa-spin': regeneratingTitle }"></i>
+                    </button>
+
+                    <!-- Status Badge (for non-completed recordings) -->
+                    <span v-if="!editingTitle && selectedRecording.status !== 'COMPLETED'"
+                          :class="getStatusClass(selectedRecording.status)"
+                          class="inline-flex items-center px-2 py-0.5 text-xs font-medium rounded-full whitespace-nowrap flex-shrink-0">
+                        ${formatStatus(selectedRecording.status)}
+                    </span>
+                </div>
+                <p class="text-sm text-[var(--text-muted)] truncate">
+                    ${selectedRecording.participants || t('help.noParticipants')}
+                </p>
+                <!-- Folder Pill, Tags and Share Status -->
+                <div v-if="(foldersEnabled && selectedRecording.folder_id) || getRecordingTags(selectedRecording).length > 0 || selectedRecording.is_shared || selectedRecording.shared_with_count > 0 || selectedRecording.public_share_count > 0" class="flex flex-wrap gap-1 mt-2">
+                    <!-- Folder Pill -->
+                    <span v-if="foldersEnabled && selectedRecording.folder_id && !selectedRecording.incognito"
+                          class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium"
+                          :style="{ backgroundColor: getFolderColor(selectedRecording.folder_id), color: getContrastTextColor(getFolderColor(selectedRecording.folder_id)) }"
+                          :title="'Folder: ' + getFolderName(selectedRecording.folder_id)">
+                        <i class="fas fa-folder mr-1" style="vertical-align: middle; line-height: 0;"></i>
+                        ${ getFolderName(selectedRecording.folder_id) }
+                    </span>
+                    <button v-for="tag in getRecordingTags(selectedRecording)" :key="tag.id"
+                            @click.stop="filterByTag(tag)"
+                            class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium hover:opacity-80 transition-all cursor-pointer"
+                            :style="{ backgroundColor: tag.color, color: getContrastTextColor(tag.color) }"
+                            :title="tag.group_id ? ('Group: ' + tag.group_name) : tag.name">
+                        <i v-if="tag.group_id" class="fas fa-users mr-1" style="vertical-align: middle; line-height: 0;"></i>
+                        <i v-else class="fas fa-tag mr-1" style="vertical-align: middle; line-height: 0;"></i>
+                        <span v-text="tag.name"></span>
+                    </button>
+                    <span v-if="selectedRecording.is_shared" class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-purple-500 text-white">
+                        <i class="fas fa-arrow-down mr-1"></i>Shared
+                    </span>
+                    <span v-if="!selectedRecording.is_shared && selectedRecording.shared_with_count > 0" class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-indigo-500 text-white">
+                        <i class="fas fa-arrow-up mr-1"></i>${selectedRecording.shared_with_count}
+                    </span>
+                    <span v-if="!selectedRecording.is_shared && selectedRecording.public_share_count > 0" class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-teal-500 text-white">
+                        <i class="fas fa-globe mr-1"></i>${selectedRecording.public_share_count}
+                    </span>
+                </div>
+            </div>
+            <!-- Expand/Collapse Button -->
+            <button @click.stop="isMetadataExpanded = !isMetadataExpanded"
+                    class="flex items-center justify-center w-8 h-8 rounded-lg bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:bg-[var(--bg-accent-hover)] hover:text-[var(--text-accent)] transition-colors flex-shrink-0">
+                <i :class="['fas', 'fa-chevron-down', 'text-sm', 'transition-transform', { 'rotate-180': isMetadataExpanded }]"></i>
+            </button>
+        </div>
+    </div>
+    <!-- Expandable Metadata and Actions -->
+    <div v-if="isMetadataExpanded" class="mt-4 space-y-4">
+        <div class="space-y-2 text-sm text-[var(--text-muted)]">
+            <div class="flex flex-wrap items-center gap-x-4 gap-y-2">
+                <div class="flex items-center gap-2" @click.stop="openMeetingDatePicker">
+                    <i class="fas fa-calendar text-[var(--text-accent)]"></i>
+                    <span class="cursor-pointer hover:text-[var(--text-accent)] transition-colors">${selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'No date set'}</span>
+                </div>
+                <div v-if="selectedRecording.is_shared" class="flex items-center gap-2">
+                    <i class="fas fa-user text-[var(--text-accent)]"></i>
+                    <span :title="'Owner: ' + (selectedRecording.owner_username || t('sharing.unknown'))">
+                        ${selectedRecording.owner_username || t('sharing.unknown')}
+                    </span>
+                </div>
+                <template v-if="activeRecordingMetadata" v-for="(item, index) in activeRecordingMetadata" :key="index">
+                    <span v-if="!item.isTagItem" class="flex items-center gap-1.5">
+                        <i :class="item.icon"></i>
+                        <span :title="item.fullText || item.text">${item.text}</span>
+                    </span>
+                </template>
+            </div>
+            <!-- Duplicate Indicator -->
+            <button v-if="selectedRecording.duplicate_info"
+                    @click.stop="openDuplicatesModal(selectedRecording.duplicate_info)"
+                    class="flex items-center gap-1.5 text-sm text-amber-500 hover:text-amber-400 transition-colors cursor-pointer mt-2">
+                <i class="fas fa-copy"></i>
+                <span>${ selectedRecording.duplicate_info.total_copies } ${ t('upload.copies') || 'copies' }</span>
+            </button>
+        </div>
+        <!-- Action Buttons -->
+        <div class="flex items-center gap-2 overflow-x-auto pb-2">
+            <!-- Incognito recordings have limited actions -->
+            <template v-if="!selectedRecording.incognito">
+                <!-- Folder Assignment (icon-only dropdown matching other buttons) -->
+                <div v-if="foldersEnabled && selectedRecording.can_edit !== false"
+                     class="relative p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors flex-shrink-0"
+                     :title="selectedRecording.folder_id ? getFolderName(selectedRecording.folder_id) : 'Assign Folder'">
+                    <select @change="assignFolderToRecording(selectedRecording.id, $event.target.value || null)"
+                            :value="selectedRecording.folder_id || ''"
+                            class="absolute inset-0 w-full h-full opacity-0 cursor-pointer">
+                        <option value="">No Folder</option>
+                        <option v-for="folder in availableFolders" :key="folder.id" :value="folder.id">
+                            ${ folder.name }
+                        </option>
+                    </select>
+                    <i class="fas fa-folder"
+                       :style="{ color: selectedRecording.folder_id ? getFolderColor(selectedRecording.folder_id) : '' }"></i>
+                </div>
+                <button @click="toggleInbox(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :class="selectedRecording.is_inbox ? 'text-blue-500' : ''"><i class="fas fa-inbox"></i></button>
+                <button @click="toggleHighlight(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :class="selectedRecording.is_highlighted ? 'text-yellow-500' : ''"><i class="fas fa-star"></i></button>
+                <button @click="editRecordingTags(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"><i class="fas fa-tags"></i></button>
+                <button @click="confirmReprocess('transcription', selectedRecording)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"><i class="fas fa-redo-alt"></i></button>
+                <button @click="confirmReprocess('summary', selectedRecording)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"><i class="fas fa-sync-alt"></i></button>
+                <button @click="confirmReset(selectedRecording)" v-if="['PENDING', 'PROCESSING', 'SUMMARIZING', 'FAILED'].includes(selectedRecording.status)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-orange-500"><i class="fas fa-undo"></i></button>
+                <button @click="openSpeakerModal" v-if="processedTranscription.hasDialogue" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"><i class="fas fa-user-tag"></i></button>
+                <button v-if="!selectedRecording.is_shared || (selectedRecording.share_info && selectedRecording.share_info.can_reshare)" @click="openUnifiedShareModal(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"><i class="fas fa-share-alt"></i></button>
+                <button v-if="canDeleteRecordings && selectedRecording.can_delete !== false" @click="confirmDelete(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-danger-light)] text-[var(--text-danger)] transition-colors"><i class="fas fa-trash"></i></button>
+            </template>
+
+            <!-- Incognito mode: only show discard button -->
+            <template v-else>
+                <span class="text-xs text-amber-600 dark:text-amber-400 px-2">
+                    <i class="fas fa-user-secret mr-1"></i>
+                    Incognito Mode
+                </span>
+                <button @click="clearIncognitoRecordingWithConfirm"
+                        class="p-2 rounded-lg hover:bg-red-100 dark:hover:bg-red-900/30 text-red-600 dark:text-red-400 transition-colors"
+                        title="Discard incognito recording">
+                    <i class="fas fa-trash"></i>
+                </button>
+            </template>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-notes-panel.html b/templates/components/detail/mobile-notes-panel.html
new file mode 100644
index 00000000..52152463
--- /dev/null
+++ b/templates/components/detail/mobile-notes-panel.html
@@ -0,0 +1,26 @@
+<!-- Mobile Notes Panel -->
+<div v-if="mobileTab === 'notes'" class="h-full flex flex-col space-y-4">
+    <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+        <button @click="copyNotes" class="copy-btn" :title="t('buttons.copyNotes')"><i class="fas fa-copy"></i></button>
+        <button @click="downloadNotes" class="copy-btn" :title="t('buttons.downloadAsWord')"><i class="fas fa-download"></i></button>
+        <button @click="toggleEditNotes" class="copy-btn" :title="t('buttons.editNotes')"><i class="fas fa-edit"></i></button>
+    </div>
+    <div class="flex-grow overflow-y-auto mobile-content-box">
+        <div v-if="editingNotes" class="h-full flex flex-col">
+            <div class="markdown-editor-container flex-1">
+                <textarea ref="notesMarkdownEditor" v-model="selectedRecording.notes"></textarea>
+            </div>
+            <div class="flex justify-end gap-2 mt-2">
+                <button @click="cancelEditNotes" class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                <button @click="saveEditNotes" class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] border border-transparent rounded hover:bg-[var(--bg-button-hover)]" v-text="t('common.save')"></button>
+            </div>
+        </div>
+        <div v-else @click="clickToEditNotes">
+            <div v-if="!selectedRecording.notes" class="text-center py-8 cursor-pointer hover:text-[var(--text-secondary)]">
+                <i class="fas fa-sticky-note text-3xl text-[var(--text-muted)] mb-3"></i>
+                <p class="text-[var(--text-muted)]" v-text="t('help.clickToAddNotes')"></p>
+            </div>
+            <div v-else class="notes-box h-full" v-html="selectedRecording.notes_html || selectedRecording.notes"></div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-summary-panel.html b/templates/components/detail/mobile-summary-panel.html
new file mode 100644
index 00000000..d0ddc96d
--- /dev/null
+++ b/templates/components/detail/mobile-summary-panel.html
@@ -0,0 +1,53 @@
+<!-- Mobile Summary Panel -->
+<div v-if="mobileTab === 'summary'" class="h-full flex flex-col space-y-4">
+    <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+        <button @click="copySummary" class="copy-btn" :title="t('buttons.copySummary')"><i class="fas fa-copy"></i></button>
+        <button @click="downloadSummary" class="copy-btn" :title="t('buttons.downloadAsWord')"><i class="fas fa-download"></i></button>
+        <button @click="toggleEditSummary" class="copy-btn" :title="t('buttons.editSummary')"><i class="fas fa-edit"></i></button>
+    </div>
+    <div class="flex-grow overflow-y-auto mobile-content-box">
+        <div v-if="editingSummary" class="h-full flex flex-col">
+            <div class="markdown-editor-container flex-1">
+                <textarea ref="summaryMarkdownEditor" v-model="selectedRecording.summary"></textarea>
+            </div>
+            <div class="flex justify-end gap-2 mt-2">
+                <button @click="cancelEditSummary" class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                <button @click="saveEditSummary" class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] border border-transparent rounded hover:bg-[var(--bg-button-hover)]" v-text="t('common.save')"></button>
+            </div>
+        </div>
+        <div v-else>
+            <div v-if="selectedRecording.status === 'SUMMARIZING'" class="text-center py-8">
+                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.generatingSummary')"></p>
+            </div>
+            <div v-else-if="!selectedRecording.summary" class="text-center py-8">
+                <i class="fas fa-file-alt text-3xl text-[var(--text-muted)] mb-3"></i>
+                <p class="text-[var(--text-muted)] mb-4" v-text="t('summary.noSummary')"></p>
+                <!-- Show message if transcription is an error -->
+                <p v-if="processedTranscription.isError" class="text-sm text-amber-500 mb-2">
+                    <i class="fas fa-exclamation-triangle mr-1"></i>
+                    Cannot generate summary: transcription failed
+                </p>
+                <div :class="['inline-flex rounded-lg shadow-lg transition-all duration-200 overflow-hidden', processedTranscription.isError ? '' : 'hover:shadow-xl']">
+                    <button @click="generateSummary()"
+                            :disabled="processedTranscription.isError"
+                            :class="[
+                                'px-6 py-3 font-medium transition-colors duration-200',
+                                processedTranscription.isError
+                                    ? 'bg-gray-400 text-gray-200 cursor-not-allowed'
+                                    : 'bg-gradient-to-r from-blue-600 to-purple-600 text-white hover:from-blue-700 hover:to-purple-700'
+                            ]">
+                        <i class="fas fa-magic mr-2"></i>Generate Summary
+                    </button>
+                    <button v-if="!processedTranscription.isError"
+                            @click="openCustomizeSummaryModal"
+                            title="Customise the summarisation prompt"
+                            class="px-3 py-3 font-medium text-white bg-gradient-to-r from-purple-600 to-purple-700 hover:from-purple-700 hover:to-purple-800 transition-colors duration-200 border-l border-white/20">
+                        <i class="fas fa-sliders-h text-sm"></i>
+                    </button>
+                </div>
+            </div>
+            <div v-else class="summary-box h-full" v-html="selectedRecording.summary_html || selectedRecording.summary"></div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/mobile-transcript-panel.html b/templates/components/detail/mobile-transcript-panel.html
new file mode 100644
index 00000000..81626d88
--- /dev/null
+++ b/templates/components/detail/mobile-transcript-panel.html
@@ -0,0 +1,136 @@
+<!-- Mobile Transcript Panel -->
+<div v-if="mobileTab === 'transcript'" class="h-full flex flex-col space-y-4">
+    <div class="flex items-center justify-between gap-2 flex-shrink-0 px-3">
+        <!-- Follow Player Checkbox -->
+        <div v-if="processedTranscription.isJson && processedTranscription.hasDialogue"
+             class="follow-player-control text-[var(--text-muted)]"
+             @click="toggleFollowPlayerMode"
+             :title="followPlayerMode ? t('tooltips.followPlayerEnabled') : t('tooltips.followPlayerDisabled')">
+            <input type="checkbox"
+                   :checked="followPlayerMode"
+                   @click.stop="toggleFollowPlayerMode">
+            <i class="fas fa-arrows-alt-v follow-icon"></i>
+        </div>
+        <div class="flex items-center gap-2">
+            <div v-if="processedTranscription.hasDialogue" class="view-mode-toggle">
+                <button @click="toggleTranscriptionViewMode" :class="['toggle-button', transcriptionViewMode === 'simple' ? 'active' : '']"><i class="fas fa-list"></i></button>
+                <button @click="toggleTranscriptionViewMode" :class="['toggle-button', transcriptionViewMode === 'bubble' ? 'active' : '']"><i class="fas fa-comments"></i></button>
+            </div>
+            <button @click="copyTranscription" class="copy-btn" :title="t('tooltips.copyTranscript')"><i class="fas fa-copy"></i></button>
+            <button @click="downloadTranscript" v-if="selectedRecording && selectedRecording.transcription" class="copy-btn" :title="t('tooltips.downloadTranscriptWithTemplate')"><i class="fas fa-download"></i></button>
+            <button @click="openTranscriptionEditor" v-if="selectedRecording && selectedRecording.transcription" class="copy-btn" :title="t('tooltips.editTranscript')"><i class="fas fa-edit"></i></button>
+        </div>
+    </div>
+    <div class="flex-grow overflow-y-auto mobile-content-box relative">
+        <!-- Floating Processing Indicator (Mobile) -->
+        <div v-if="selectedRecording.status === 'PROCESSING'"
+             :class="['processing-indicator-floating', processingIndicatorMinimized ? 'minimized' : '']">
+            <template v-if="!processingIndicatorMinimized">
+                <div class="processing-indicator-content">
+                    <i class="fas fa-spinner fa-spin text-[var(--text-accent)]"></i>
+                    <span class="text-sm text-[var(--text-secondary)]" v-text="t('help.processingTranscription')"></span>
+                </div>
+                <button @click="processingIndicatorMinimized = true"
+                        class="processing-indicator-minimize"
+                        :title="t('tooltips.minimize')">
+                    <i class="fas fa-chevron-up"></i>
+                </button>
+            </template>
+            <template v-else>
+                <button @click="processingIndicatorMinimized = false"
+                        class="processing-indicator-expand"
+                        :title="t('help.processingTranscription')">
+                    <i class="fas fa-spinner fa-spin"></i>
+                </button>
+            </template>
+        </div>
+
+        <!-- No transcription state (only show if not processing and no transcription) -->
+        <div v-if="!selectedRecording.transcription && selectedRecording.status !== 'PROCESSING'" class="text-center py-8">
+            <i class="fas fa-file-text text-3xl text-[var(--text-muted)] mb-3"></i>
+            <p class="text-[var(--text-muted)]" v-text="t('transcription.noTranscription')"></p>
+        </div>
+
+        <!-- Error Display (when transcription is an error message) -->
+        <div v-if="processedTranscription.isError" class="error-display-container p-2">
+            <div :class="[
+                'rounded-lg p-4 border',
+                processedTranscription.error.type === 'size_limit' ? 'bg-amber-500/10 border-amber-500/30' :
+                processedTranscription.error.type === 'timeout' ? 'bg-orange-500/10 border-orange-500/30' :
+                processedTranscription.error.type === 'auth' ? 'bg-red-500/10 border-red-500/30' :
+                'bg-gray-500/10 border-gray-500/30'
+            ]">
+                <div class="flex items-start gap-3">
+                    <div :class="[
+                        'flex-shrink-0 w-10 h-10 rounded-full flex items-center justify-center',
+                        processedTranscription.error.type === 'size_limit' ? 'bg-amber-500/20' :
+                        processedTranscription.error.type === 'timeout' ? 'bg-orange-500/20' :
+                        processedTranscription.error.type === 'auth' ? 'bg-red-500/20' :
+                        'bg-gray-500/20'
+                    ]">
+                        <i :class="[
+                            'fas',
+                            processedTranscription.error.icon,
+                            processedTranscription.error.type === 'size_limit' ? 'text-amber-500' :
+                            processedTranscription.error.type === 'timeout' ? 'text-orange-500' :
+                            processedTranscription.error.type === 'auth' ? 'text-red-500' :
+                            'text-gray-500'
+                        ]"></i>
+                    </div>
+                    <div class="flex-1 min-w-0">
+                        <h3 class="font-semibold text-[var(--text-primary)] mb-1">
+                            ${processedTranscription.error.title}
+                        </h3>
+                        <p class="text-sm text-[var(--text-secondary)] mb-2">
+                            ${processedTranscription.error.message}
+                        </p>
+                        <div v-if="processedTranscription.error.guidance" class="text-xs text-[var(--text-muted)] bg-[var(--bg-tertiary)]/50 rounded p-2">
+                            <i class="fas fa-lightbulb text-yellow-500 mr-1"></i>
+                            ${processedTranscription.error.guidance}
+                        </div>
+                    </div>
+                </div>
+                <div class="mt-3 pt-3 border-t border-[var(--border-secondary)]">
+                    <button @click="reprocessTranscription(selectedRecording.id)"
+                            v-if="selectedRecording.can_edit !== false"
+                            class="w-full px-3 py-2 bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] text-white rounded-lg transition-colors text-sm">
+                        <i class="fas fa-redo-alt mr-2"></i>Reprocess
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Transcription content (show regardless of processing state if transcription exists) -->
+        <div v-if="selectedRecording.transcription && !processedTranscription.isError">
+            <div v-if="!processedTranscription.hasDialogue || transcriptionViewMode === 'simple'" class="transcription-simple-view">
+                <div v-if="processedTranscription.hasDialogue">
+                    <div v-for="(segment, index) in processedTranscription.simpleSegments" :key="`seg-${index}-${segment.startTime}`" :class="['speaker-segment', { 'active-playing-segment': currentPlayingSegmentIndex === index }]" @click="seekAudioFromEvent" @dblclick.stop="openAsrEditorAtSegment(index)" :data-start-time="segment.startTime" :data-segment-index="index">
+                        <template v-if="segment.showSpeaker">
+                            <div v-if="showTimestampsSimpleView" :class="['speaker-tablet-group', segment.color]">
+                                <span class="speaker-tablet-time">${ formatTimestamp(segment.startTime) }</span>
+                                <span class="speaker-tablet-name">${segment.speaker}</span>
+                            </div>
+                            <div v-else :class="['speaker-tablet', segment.color]">${segment.speaker}</div>
+                        </template>
+                        <div class="speaker-text">${segment.sentence}</div>
+                    </div>
+                </div>
+                <div v-else>
+                    <div v-if="processedTranscription.simpleSegments && processedTranscription.simpleSegments.length > 0">
+                        <div v-for="(segment, index) in processedTranscription.simpleSegments" :key="`seg-${index}-${segment.startTime}`" :class="['transcript-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors', { 'active-playing-segment': currentPlayingSegmentIndex === index }]" @click="seekAudioFromEvent" @dblclick.stop="openAsrEditorAtSegment(index)" :data-start-time="segment.startTime" :data-segment-index="index"><span v-if="showTimestampsSimpleView" class="speaker-segment-timestamp speaker-segment-timestamp--inline">${ formatTimestamp(segment.startTime) }</span>${segment.sentence}</div>
+                    </div>
+                    <div v-else class="whitespace-pre-wrap">${processedTranscription.content}</div>
+                </div>
+            </div>
+            <div v-else-if="transcriptionViewMode === 'bubble'" class="transcription-with-speakers">
+                <template v-for="(row, rowIndex) in processedTranscription.bubbleRows" :key="`${selectedRecording.id}-bubble-row-${rowIndex}`">
+                    <div :class="['bubble-row', row.isMe ? 'speaker-me' : '']">
+                        <div v-for="(bubble, bubbleIndex) in row.bubbles" :key="`bubble-${rowIndex}-${bubbleIndex}-${bubble.startTime}`" :class="['speaker-bubble', bubble.color, row.isMe ? 'speaker-me' : '', { 'active-playing-segment': currentPlayingSegmentIndex === getBubbleGlobalIndex(rowIndex, bubbleIndex) }]" @click="seekAudioFromEvent" :data-start-time="bubble.startTime" :data-segment-index="getBubbleGlobalIndex(rowIndex, bubbleIndex)">
+                            <div class="speaker-bubble-content">${bubble.sentence}</div>
+                        </div>
+                    </div>
+                </template>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/detail/tab-navigation.html b/templates/components/detail/tab-navigation.html
new file mode 100644
index 00000000..52692814
--- /dev/null
+++ b/templates/components/detail/tab-navigation.html
@@ -0,0 +1,20 @@
+<!-- Tab Navigation for Mobile -->
+<div class="flex-shrink-0 bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)] flex overflow-x-auto">
+    <button @click="mobileTab = 'transcript'"
+            :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'transcript' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']"
+            v-text="t('transcription.title')"></button>
+    <button @click="mobileTab = 'summary'"
+            :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'summary' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']"
+            v-text="t('summary.title')"></button>
+    <button @click="mobileTab = 'notes'"
+            :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'notes' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']"
+            v-text="t('notes.title')"></button>
+    <button @click="mobileTab = 'chat'"
+            :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'chat' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']"
+            v-text="t('chat.title')"></button>
+    <button v-if="selectedRecording.events && selectedRecording.events.length > 0"
+            @click="mobileTab = 'events'"
+            :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors whitespace-nowrap', mobileTab === 'events' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']">
+        <i class="fas fa-calendar-alt mr-1"></i>${ t('events.title') } (${ selectedRecording.events.length })
+    </button>
+</div>
diff --git a/templates/components/header.html b/templates/components/header.html
new file mode 100644
index 00000000..00555960
--- /dev/null
+++ b/templates/components/header.html
@@ -0,0 +1,99 @@
+<!-- Header Component -->
+<header class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] px-3 sm:px-4 py-3 flex items-center justify-between flex-shrink-0 z-50">
+    <!-- Left side: Menu toggle and logo -->
+    <div class="flex items-center gap-2 sm:gap-4 min-w-0 flex-shrink">
+        <!-- Menu Toggle Button -->
+        <button @click="toggleSidebar"
+                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200 flex-shrink-0 flex items-center justify-center">
+            <i class="fas fa-bars text-lg"></i>
+        </button>
+
+        <!-- Logo and Title -->
+        <div class="flex items-center gap-2 sm:gap-3 min-w-0">
+            <img src="{{ url_for('static', filename='img/icon-32x32.png') }}" alt="Speakr" class="w-7 h-7 sm:w-8 sm:h-8 flex-shrink-0">
+            <h1 class="text-lg sm:text-xl font-bold text-[var(--text-primary)] truncate">Speakr</h1>
+        </div>
+    </div>
+
+    <!-- Right side: User menu and controls -->
+    <div class="flex items-center gap-2 sm:gap-3">
+        {% include 'components/token_budget_indicator.html' %}
+
+        <!-- Inquire Mode Button -->
+        {% if inquire_mode_enabled %}
+        <a href="/inquire"
+           class="px-2 py-1.5 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:opacity-80 transition-opacity text-sm sm:px-4 sm:py-2 sm:min-w-[120px] sm:flex sm:items-center sm:gap-2 sm:justify-center">
+            <i class="fas fa-search"></i>
+            <span class="hidden sm:inline" v-text="t('inquire.title')"></span>
+        </a>
+        {% endif %}
+
+        <!-- Install PWA Button -->
+        <button v-if="showInstallButton && !isPWAInstalled"
+                @click="promptInstall"
+                class="px-2 py-1.5 bg-green-600 text-white rounded-lg hover:bg-green-700 transition-colors text-sm sm:px-4 sm:py-2 sm:flex sm:items-center sm:gap-2"
+                :title="t('pwa.installApp')">
+            <i class="fas fa-download"></i>
+            <span class="hidden sm:inline" v-text="t('pwa.installApp')"></span>
+        </button>
+
+        <!-- New Recording Button -->
+        <button @click="switchToUploadView"
+                class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm sm:px-4 sm:py-2 sm:min-w-[120px] sm:flex sm:items-center sm:gap-2 sm:justify-center">
+            <i class="fas fa-plus mr-1"></i><span v-text="t('nav.newRecording')"></span>
+        </button>
+
+        <!-- User menu -->
+        {% if current_user.is_authenticated %}
+        <div class="relative">
+            <button @click="isUserMenuOpen = !isUserMenuOpen"
+                    data-user-menu-toggle
+                    class="flex items-center gap-1 sm:gap-2 p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200"
+                    :title="t('admin.userMenu')">
+                <i class="fas fa-user-circle text-lg"></i>
+                <span class="hidden lg:inline text-sm">{{ (current_user.name or current_user.username) if current_user.is_authenticated else 'User' }}</span>
+                <i class="fas fa-chevron-down text-xs hidden sm:inline"></i>
+            </button>
+
+            <!-- User dropdown -->
+            <div v-if="isUserMenuOpen"
+                 data-user-menu-dropdown
+                 class="absolute right-0 mt-2 w-56 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-50">
+                <a href="/account" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                    <i class="fas fa-cog mr-2 w-4 text-center"></i><span v-text="t('nav.settings')"></span>
+                </a>
+                <a href="/account#tags" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                    <i class="fas fa-tags mr-2 w-4 text-center"></i><span v-text="t('help.tagManagement')"></span>
+                </a>
+                <button @click="openSharesList" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                    <i class="fas fa-share-alt mr-2 w-4 text-center"></i><span v-text="t('modal.sharedTranscripts')"></span>
+                </button>
+                {% if current_user.is_admin %}
+                <a href="/admin" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                    <i class="fas fa-user-shield mr-2 w-4 text-center"></i>
+                    <span v-text="t('admin.title')"></span>
+                </a>
+                {% elif is_group_admin %}
+                <a href="/group-management" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                    <i class="fas fa-users-cog mr-2 w-4 text-center"></i>
+                    <span v-text="t('nav.groupManagement')"></span>
+                </a>
+                {% endif %}
+                <div class="border-t border-[var(--border-primary)] my-1"></div>
+                <button @click="toggleDarkMode" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'" class="mr-2 w-4 text-center"></i>
+                    <span v-text="isDarkMode ? t('nav.lightMode') : t('nav.darkMode')"></span>
+                </button>
+                <button @click="openColorSchemeModal" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                    <i class="fas fa-palette mr-2 w-4 text-center"></i>
+                    <span v-text="t('modal.colorScheme')"></span>
+                </button>
+                <div class="border-t border-[var(--border-primary)] my-1"></div>
+                <a href="/logout" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                    <i class="fas fa-sign-out-alt mr-2 w-4 text-center"></i><span v-text="t('nav.signOut')"></span>
+                </a>
+            </div>
+        </div>
+        {% endif %}
+    </div>
+</header>
diff --git a/templates/components/progress-popup.html b/templates/components/progress-popup.html
new file mode 100644
index 00000000..f8a68795
--- /dev/null
+++ b/templates/components/progress-popup.html
@@ -0,0 +1,189 @@
+<!-- Processing Queue Popup - Compact Unified Progress Tracking -->
+<div v-if="showProcessingPopup && !progressPopupClosed"
+     :class="[
+         'fixed bottom-4 left-4 z-[100] w-80 transition-all duration-300',
+         progressPopupMinimized ? 'minimized' : ''
+     ]">
+    <div class="bg-[var(--bg-secondary)] border border-[var(--bg-accent)] rounded-lg shadow-xl overflow-hidden backdrop-blur-sm bg-opacity-95">
+        <!-- Compact Header -->
+        <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-accent-hover)] px-3 py-2">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-2 min-w-0">
+                    <i class="fas fa-tasks text-sm text-gray-800 dark:text-white"></i>
+                    <span class="font-medium text-sm text-gray-800 dark:text-white">Processing Queue</span>
+                    <span class="text-xs bg-black dark:bg-white bg-opacity-20 dark:bg-opacity-20 px-1.5 py-0.5 rounded-full text-gray-800 dark:text-white font-medium">
+                        ${totalProcessingCount}
+                    </span>
+                </div>
+                <div class="flex items-center gap-1 flex-shrink-0">
+                    <button v-if="allCompletedCount > 0" @click="clearAllCompleted()"
+                            class="px-1.5 py-0.5 text-xs bg-black dark:bg-white bg-opacity-10 dark:bg-opacity-20 hover:bg-opacity-20 dark:hover:bg-opacity-30 rounded transition-all text-gray-800 dark:text-white">
+                        Clear
+                    </button>
+                    <button @click="progressPopupMinimized = !progressPopupMinimized"
+                            class="p-1 rounded hover:bg-black dark:hover:bg-white hover:bg-opacity-10 dark:hover:bg-opacity-20 transition-colors text-gray-800 dark:text-white">
+                        <i :class="progressPopupMinimized ? 'fas fa-chevron-up text-xs' : 'fas fa-chevron-down text-xs'"></i>
+                    </button>
+                    <button @click="progressPopupClosed = true"
+                            class="p-1 rounded hover:bg-red-500 hover:bg-opacity-30 text-gray-800 dark:text-white hover:text-red-600 dark:hover:text-red-400 transition-colors">
+                        <i class="fas fa-times text-xs"></i>
+                    </button>
+                </div>
+            </div>
+            <!-- Compact Summary Line -->
+            <div v-if="activeProgressItems.length > 0" class="text-xs text-gray-800 dark:text-white opacity-70 mt-1">
+                <span v-if="activeProgressItems.filter(i => i.status === 'uploading').length > 0">
+                    ${activeProgressItems.filter(i => i.status === 'uploading').length} uploading<span v-if="activeProgressItems.filter(i => i.status !== 'uploading').length > 0">, </span>
+                </span>
+                <span v-if="activeProgressItems.filter(i => i.status === 'transcribing').length > 0">
+                    ${activeProgressItems.filter(i => i.status === 'transcribing').length} transcribing<span v-if="activeProgressItems.filter(i => ['summarizing', 'queued'].includes(i.status)).length > 0">, </span>
+                </span>
+                <span v-if="activeProgressItems.filter(i => i.status === 'summarizing').length > 0">
+                    ${activeProgressItems.filter(i => i.status === 'summarizing').length} summarizing<span v-if="activeProgressItems.filter(i => i.status === 'queued').length > 0">, </span>
+                </span>
+                <span v-if="activeProgressItems.filter(i => i.status === 'queued').length > 0">
+                    ${activeProgressItems.filter(i => i.status === 'queued').length} queued
+                </span>
+            </div>
+        </div>
+
+        <!-- Compact Content -->
+        <div v-if="!progressPopupMinimized" class="p-2 max-h-64 overflow-y-auto space-y-1.5">
+            <!-- Active Items -->
+            <template v-for="item in activeProgressItems" :key="item.id">
+                <div :class="[
+                    'px-2 py-1.5 rounded-md transition-all',
+                    item.status === 'uploading' ? 'bg-blue-500/10 border-l-2 border-blue-500' :
+                    item.status === 'transcribing' ? 'bg-purple-500/10 border-l-2 border-purple-500' :
+                    item.status === 'summarizing' ? 'bg-green-500/10 border-l-2 border-green-500' :
+                    'bg-[var(--bg-tertiary)]/50 border-l-2 border-yellow-500'
+                ]">
+                    <!-- Title row with status icon -->
+                    <div class="flex items-center gap-2">
+                        <i :class="[
+                            'fas text-xs',
+                            getStatusDisplay(item.status).icon,
+                            item.status === 'uploading' ? 'text-blue-500' :
+                            item.status === 'transcribing' ? 'text-purple-500' :
+                            item.status === 'summarizing' ? 'text-green-500' :
+                            'text-yellow-500',
+                            getStatusDisplay(item.status).animate ? 'animate-pulse' : ''
+                        ]"></i>
+                        <span class="text-xs font-medium truncate flex-1 text-[var(--text-primary)]">${item.title}</span>
+                        <span v-if="item.status === 'uploading' && item.progress !== null"
+                              class="text-xs font-bold text-blue-500">${item.progress}%</span>
+                        <span v-else :class="[
+                            'text-xs font-medium px-1.5 py-0.5 rounded',
+                            item.status === 'uploading' ? 'bg-blue-500/20 text-blue-500' :
+                            item.status === 'transcribing' ? 'bg-purple-500/20 text-purple-500' :
+                            item.status === 'summarizing' ? 'bg-green-500/20 text-green-500' :
+                            'bg-yellow-500/20 text-yellow-500'
+                        ]">${getStatusDisplay(item.status).label}</span>
+                    </div>
+                    <!-- Progress bar for uploads -->
+                    <div v-if="item.status === 'uploading' && item.progress !== null"
+                         class="mt-1 h-1 bg-black/10 dark:bg-white/10 rounded-full overflow-hidden">
+                        <div class="h-full bg-blue-500 rounded-full transition-all duration-300"
+                             :style="{width: item.progress + '%'}"></div>
+                    </div>
+                    <!-- Compact message -->
+                    <div class="flex items-center justify-between mt-0.5">
+                        <span class="text-[10px] text-[var(--text-muted)]">${item.progressMessage}</span>
+                        <button v-if="item.status === 'ready' && item.clientId"
+                                @click="removeProgressItem(item)"
+                                class="text-[10px] text-red-500 hover:text-red-600">
+                            <i class="fas fa-times"></i> Cancel
+                        </button>
+                    </div>
+                </div>
+            </template>
+
+            <!-- Failed Items -->
+            <div v-if="failedProgressItems.length > 0" class="mt-2">
+                <div class="text-[10px] font-semibold text-red-500 uppercase tracking-wider mb-1 flex items-center gap-1">
+                    <i class="fas fa-exclamation-triangle"></i>
+                    Failed (${failedProgressItems.length})
+                </div>
+                <div v-for="item in failedProgressItems"
+                     :key="item.id"
+                     :class="[
+                         'px-2 py-1.5 rounded-md mb-1 border-l-2',
+                         item.friendlyError?.type === 'size_limit' ? 'bg-amber-500/10 border-amber-500' :
+                         item.friendlyError?.type === 'timeout' ? 'bg-orange-500/10 border-orange-500' :
+                         item.friendlyError?.type === 'auth' ? 'bg-red-500/10 border-red-500' :
+                         item.friendlyError?.type === 'rate_limit' ? 'bg-yellow-500/10 border-yellow-500' :
+                         item.friendlyError?.type === 'connection' ? 'bg-blue-500/10 border-blue-500' :
+                         item.friendlyError?.type === 'service_error' ? 'bg-purple-500/10 border-purple-500' :
+                         'bg-red-500/10 border-red-500'
+                     ]">
+                    <div class="flex items-center gap-2">
+                        <i :class="[
+                            'fas text-xs',
+                            item.friendlyError?.icon || 'fa-exclamation-circle',
+                            item.friendlyError?.type === 'size_limit' ? 'text-amber-500' :
+                            item.friendlyError?.type === 'timeout' ? 'text-orange-500' :
+                            item.friendlyError?.type === 'auth' ? 'text-red-500' :
+                            item.friendlyError?.type === 'rate_limit' ? 'text-yellow-500' :
+                            item.friendlyError?.type === 'connection' ? 'text-blue-500' :
+                            item.friendlyError?.type === 'service_error' ? 'text-purple-500' :
+                            'text-red-500'
+                        ]"></i>
+                        <span class="text-xs truncate flex-1 text-[var(--text-primary)]">${item.title}</span>
+                        <div class="flex items-center gap-1">
+                            <button v-if="item.jobId" @click.stop="retryProgressItem(item)"
+                                    class="p-1 rounded bg-blue-500/20 hover:bg-blue-500/40 transition-colors"
+                                    title="Retry">
+                                <i class="fas fa-redo text-blue-500 text-[10px]"></i>
+                            </button>
+                            <button @click.stop="removeProgressItem(item)"
+                                    class="p-1 rounded bg-red-500/20 hover:bg-red-500/40 transition-colors"
+                                    title="Delete">
+                                <i class="fas fa-trash text-red-500 text-[10px]"></i>
+                            </button>
+                        </div>
+                    </div>
+                    <!-- Friendly error title and message -->
+                    <div v-if="item.friendlyError" class="mt-0.5">
+                        <span :class="[
+                            'text-[10px] font-medium',
+                            item.friendlyError.type === 'size_limit' ? 'text-amber-500' :
+                            item.friendlyError.type === 'timeout' ? 'text-orange-500' :
+                            item.friendlyError.type === 'auth' ? 'text-red-500' :
+                            item.friendlyError.type === 'rate_limit' ? 'text-yellow-500' :
+                            item.friendlyError.type === 'connection' ? 'text-blue-500' :
+                            item.friendlyError.type === 'service_error' ? 'text-purple-500' :
+                            'text-red-400'
+                        ]">${item.friendlyError.title}</span>
+                        <span v-if="item.friendlyError.guidance" class="text-[10px] text-[var(--text-muted)] block truncate">${item.friendlyError.guidance}</span>
+                    </div>
+                    <!-- Fallback to raw error message if no friendly error -->
+                    <span v-else-if="item.errorMessage" class="text-[10px] text-red-400 block truncate mt-0.5">${item.errorMessage}</span>
+                </div>
+            </div>
+
+            <!-- Completed Items -->
+            <div v-if="completedProgressItems.length > 0" class="mt-2">
+                <div class="text-[10px] font-semibold text-[var(--text-muted)] uppercase tracking-wider mb-1 flex items-center gap-1">
+                    <i class="fas fa-check-double"></i>
+                    Completed (${completedProgressItems.length})
+                </div>
+                <div v-for="item in completedProgressItems"
+                     :key="item.id"
+                     @click="item.recordingId && selectRecording({id: item.recordingId})"
+                     class="px-2 py-1 bg-[var(--bg-tertiary)]/30 rounded-md flex items-center gap-2 hover:bg-[var(--bg-tertiary)]/50 cursor-pointer mb-1">
+                    <i class="fas fa-check-circle text-xs text-green-500"></i>
+                    <span class="text-xs truncate flex-1 text-[var(--text-primary)]">${item.title}</span>
+                    <i v-if="item.duplicateWarning" class="fas fa-copy text-xs text-amber-500" title="Duplicate file detected"></i>
+                    <span class="text-[10px] px-1.5 py-0.5 rounded bg-green-500/20 text-green-500 font-medium">Done</span>
+                </div>
+            </div>
+
+            <!-- Empty State -->
+            <div v-if="unifiedProgressItems.length === 0"
+                 class="text-center py-3 text-[var(--text-muted)] text-xs">
+                <i class="fas fa-inbox text-lg mb-1 opacity-50"></i>
+                <p>No items in queue</p>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/recording-view.html b/templates/components/recording-view.html
new file mode 100644
index 00000000..841604df
--- /dev/null
+++ b/templates/components/recording-view.html
@@ -0,0 +1,403 @@
+<!-- Recording View -->
+<div v-else-if="currentView === 'recording'" class="flex-1 flex flex-col p-2 md:p-8 bg-[var(--bg-primary)] min-h-0">
+    <div class="flex-1 flex flex-col max-w-4xl w-full mx-auto bg-[var(--bg-secondary)] rounded-xl border border-[var(--border-primary)] min-h-0 overflow-hidden">
+        <!-- Top: Visualizer and Status (Fixed) -->
+        <div class="flex-shrink-0 p-3 md:p-6 text-center bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)]">
+            <div v-if="isRecording" class="w-full mx-auto mb-3 md:mb-4">
+                <!-- Dual visualizer for 'both' mode -->
+                <div v-if="recordingMode === 'both'" class="max-w-4xl mx-auto flex gap-2 md:gap-4">
+                    <div class="w-1/2 min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 flex flex-col bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2">
+                        <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                            <canvas ref="micVisualizer" class="w-full h-full"></canvas>
+                        </div>
+                        <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1" v-text="t('recording.microphone')"></p>
+                    </div>
+                    <div class="w-1/2 min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 flex flex-col bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2">
+                        <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                            <canvas ref="systemVisualizer" class="w-full h-full"></canvas>
+                        </div>
+                        <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1" v-text="t('recording.systemAudio')"></p>
+                    </div>
+                </div>
+                <!-- Single visualizer for other modes -->
+                <div v-else class="min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 max-w-2xl mx-auto bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2 flex flex-col">
+                    <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                        <canvas ref="visualizer" class="w-full h-full"></canvas>
+                    </div>
+                    <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1 capitalize">${recordingMode}</p>
+                </div>
+            </div>
+            <div v-if="!isRecording && audioBlobURL" class="w-full mb-3 md:mb-4">
+                <div class="audio-player-container">
+                    <audio :src="audioBlobURL" controls class="w-full">
+                        Your browser does not support the audio element.
+                    </audio>
+                </div>
+            </div>
+
+            <div>
+                <div class="text-xl md:text-2xl font-mono text-[var(--text-accent)]">${formatTime(recordingTime)}</div>
+                <p class="text-xs md:text-sm text-[var(--text-muted)]">${ isRecording ? 'Recording in progress...' : 'Recording finished' }</p>
+                <!-- Real-time file size display -->
+                <div v-if="isRecording && estimatedFileSize > 0" class="mt-1.5">
+                    <p class="text-xs text-[var(--text-muted)]">
+                        Estimated size: <span class="font-mono">${formatFileSize(estimatedFileSize)}</span>
+                        <span v-if="actualBitrate > 0" class="ml-2">
+                            (${Math.round(actualBitrate / 1000)}kbps)
+                        </span>
+                    </p>
+                    <!-- Size warning indicator -->
+                    <div v-if="estimatedFileSize > (maxRecordingMB * 1024 * 1024 * 0.8)" class="mt-0.5">
+                        <div class="flex items-center text-xs text-amber-600 dark:text-amber-400">
+                            <i class="fas fa-exclamation-triangle mr-1"></i>
+                            <span v-text="t('help.approachingLimit', { limit: maxRecordingMB })"></span>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Mobile Background Recording Warning - Below timer -->
+                <div v-if="isRecording && isMobileDevice"
+                     class="mt-2 p-2 bg-amber-50 dark:bg-amber-900 dark:bg-opacity-20 border border-amber-300 dark:border-amber-700 rounded">
+                    <div class="flex items-start gap-1.5 text-left">
+                        <i class="fas fa-exclamation-triangle text-amber-600 dark:text-amber-400 flex-shrink-0 text-xs" style="margin-top: 2px;"></i>
+                        <div class="flex-1 min-w-0">
+                            <div class="text-xs text-amber-800 dark:text-amber-200 leading-snug">
+                                <strong class="font-semibold">Keep this app visible!</strong>
+                                <span class="block text-[10px] mt-0.5">Recording pauses if minimized or screen locked.</span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- MIDDLE: Content Area -->
+        <div class="flex-1 min-h-0 flex flex-col">
+
+            <!-- STATE 1: Recording in progress — notes fill space, no accordion -->
+            <template v-if="isRecording">
+                <div class="flex-1 min-h-0 flex flex-col p-3 md:p-6">
+                    <label for="recordingNotes" class="block text-sm font-medium text-[var(--text-secondary)] mb-1.5 flex-shrink-0">
+                        <i class="fas fa-pencil-alt mr-1"></i>
+                        Recording Notes (Markdown)
+                    </label>
+                    <div class="recording-notes-editor recording-active" style="min-height: 150px;">
+                        <textarea ref="recordingNotesEditor" v-model="recordingNotes"
+                                  class="w-full h-full bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg p-2 md:p-3 text-sm focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] resize-none"
+                                  :placeholder="t('form.notesPlaceholder')"></textarea>
+                    </div>
+                </div>
+            </template>
+
+            <!-- STATE 2: Recording finished — accordion -->
+            <template v-else-if="audioBlobURL">
+
+                <!-- Notes Section -->
+                <div :class="['flex flex-col border-b border-[var(--border-primary)]',
+                               expandedSection === 'notes' ? 'flex-1 min-h-0' : 'flex-shrink-0']">
+                    <!-- Header bar (always visible) -->
+                    <button @click="expandedSection = expandedSection === 'notes' ? 'settings' : 'notes'"
+                            class="flex-shrink-0 flex items-center justify-between w-full px-3 md:px-6 py-2.5
+                                   bg-[var(--bg-tertiary)] hover:bg-[var(--bg-accent)] transition-colors">
+                        <span class="flex items-center gap-2 text-sm font-medium text-[var(--text-secondary)]">
+                            <i class="fas fa-pencil-alt text-[var(--text-muted)]"></i>
+                            Recording Notes
+                            <span v-if="recordingNotes" class="text-[10px] text-[var(--text-muted)]">(has content)</span>
+                        </span>
+                        <i :class="['fas text-[var(--text-muted)] transition-transform duration-200',
+                                    expandedSection === 'notes' ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                    </button>
+                    <!-- Content (when expanded) -->
+                    <div v-show="expandedSection === 'notes'" class="flex-1 min-h-0 flex flex-col p-3 md:p-6">
+                        <div class="recording-notes-editor accordion-expanded">
+                            <textarea ref="recordingNotesEditor" v-model="recordingNotes"
+                                      class="w-full h-full bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg p-2 md:p-3 text-sm focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] resize-none"
+                                      :placeholder="t('form.notesPlaceholder')"></textarea>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Settings Section -->
+                <div :class="['flex flex-col',
+                               expandedSection === 'settings' ? 'flex-1 min-h-0' : 'flex-shrink-0']">
+                    <!-- Header bar -->
+                    <button @click="expandedSection = expandedSection === 'settings' ? 'notes' : 'settings'"
+                            class="flex-shrink-0 flex items-center justify-between w-full px-3 md:px-6 py-2.5
+                                   bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)]
+                                   hover:bg-[var(--bg-accent)] transition-colors">
+                        <span class="flex items-center gap-2 text-sm font-medium text-[var(--text-secondary)]">
+                            <i class="fas fa-sliders-h text-[var(--text-muted)]"></i>
+                            Upload Settings
+                        </span>
+                        <i :class="['fas text-[var(--text-muted)] transition-transform duration-200',
+                                    expandedSection === 'settings' ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                    </button>
+                    <!-- Content (when expanded) -->
+                    <div v-show="expandedSection === 'settings'" class="flex-1 min-h-0 overflow-y-auto p-3 md:p-6">
+                        <div class="flex flex-col gap-3 md:gap-4">
+
+                            <!-- Folder Selection (only shown if folders are enabled) -->
+                            <div v-if="foldersEnabled">
+                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1.5 md:mb-2">
+                                    <i class="fas fa-folder mr-1"
+                                       :style="{ color: selectedFolderId ? getFolderColor(selectedFolderId) : 'var(--text-muted)' }"></i>
+                                    Folder (optional)
+                                </label>
+                                <div class="relative">
+                                    <select v-model="selectedFolderId"
+                                            class="w-full pl-8 pr-8 py-2 text-sm rounded-lg cursor-pointer focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] appearance-none border border-[var(--border-secondary)] bg-[var(--bg-secondary)] text-[var(--text-primary)] hover:bg-[var(--bg-input)] transition-colors">
+                                        <option :value="null">No Folder</option>
+                                        <option v-for="folder in availableFolders" :key="folder.id" :value="folder.id">
+                                            ${ folder.name }
+                                        </option>
+                                    </select>
+                                    <i class="fas fa-folder absolute left-2.5 top-1/2 transform -translate-y-1/2 pointer-events-none"
+                                       :style="{ color: selectedFolderId ? getFolderColor(selectedFolderId) : 'var(--text-muted)' }"></i>
+                                    <i class="fas fa-chevron-down absolute right-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] pointer-events-none" style="font-size: 10px;"></i>
+                                </div>
+                            </div>
+
+                            <!-- Tag Selection -->
+                            <div>
+                                <label for="recordingTagSelect" class="block text-sm font-medium text-[var(--text-secondary)] mb-1.5 md:mb-2">
+                                    <i class="fas fa-tags mr-1"></i>
+                                    Select Tags (optional, in priority order)
+                                </label>
+
+                                <!-- Selected Tags Display - Compact with Drag Reorder -->
+                                <div v-if="selectedTags.length > 0" class="mb-2">
+                                    <div class="p-1.5 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] max-h-16 overflow-y-auto"
+                                         @touchmove="handleTagTouchMove">
+                                        <div class="flex flex-wrap gap-1">
+                                            <span v-for="(tag, index) in selectedTags" :key="tag.id"
+                                                  :data-tag-index="index"
+                                                  draggable="true"
+                                                  @dragstart="handleTagDragStart(index, $event)"
+                                                  @dragover="handleTagDragOver(index, $event)"
+                                                  @drop="handleTagDrop(index, $event)"
+                                                  @dragend="handleTagDragEnd"
+                                                  @touchstart="handleTagTouchStart(index, $event)"
+                                                  @touchend="handleTagTouchEnd"
+                                                  :class="[
+                                                      'inline-flex items-center px-1.5 py-0.5 rounded-full text-[11px] font-medium transition-all duration-150',
+                                                      draggedTagIndex === index ? 'opacity-50 cursor-grabbing' : 'cursor-grab',
+                                                      dragOverTagIndex === index && draggedTagIndex !== index ? 'ring-2 ring-[var(--ring-focus)] ring-offset-1' : ''
+                                                  ]"
+                                                  :style="{ backgroundColor: tag.color, color: getContrastTextColor(tag.color) }"
+                                                  :title="(tag.group_id ? ('Group: ' + tag.group_name) : tag.name) + ' (drag to reorder)'">
+                                                <span class="opacity-75 mr-0.5 text-[9px]">${index + 1}.</span>
+                                                <i v-if="tag.group_id" class="fas fa-users mr-1 text-[9px]"></i>
+                                                <span v-if="tag.group_id" class="opacity-75">${tag.group_name}: </span>
+                                                <span>${tag.name}</span>
+                                                <button @click.stop="removeTagFromSelection(tag.id)"
+                                                        class="ml-1 hover:opacity-100 opacity-70">
+                                                    <i class="fas fa-times" style="font-size: 9px;"></i>
+                                                </button>
+                                            </span>
+                                        </div>
+                                    </div>
+                                    <p class="text-[10px] text-[var(--text-muted)] mt-0.5">
+                                        <i class="fas fa-grip-vertical mr-0.5" style="font-size: 9px;"></i>
+                                        Drag to reorder &bull; First tag's defaults applied
+                                    </p>
+                                </div>
+
+                                <!-- Tag Selection Container - Compact -->
+                                <div v-if="availableTags.filter(tag => !selectedTagIds.includes(tag.id)).length > 0"
+                                     class="border border-[var(--border-secondary)] rounded-md bg-[var(--bg-tertiary)] p-2">
+                                    <!-- Search Filter -->
+                                    <div class="mb-1.5">
+                                        <div class="relative">
+                                            <input v-model="uploadTagSearchFilter"
+                                                   type="text"
+                                                   :placeholder="t('tagsModal.searchTags')"
+                                                   class="w-full px-2 py-1 pl-6 text-xs bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                            <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 9px;"></i>
+                                            <button v-if="uploadTagSearchFilter"
+                                                    @click="uploadTagSearchFilter = ''"
+                                                    class="absolute right-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                                <i class="fas fa-times" style="font-size: 9px;"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+                                    <!-- Available Tags Grid -->
+                                    <div v-if="filteredAvailableTagsForUpload.length > 0"
+                                         class="overflow-y-auto"
+                                         style="max-height: 100px;">
+                                        <div class="grid grid-cols-2 gap-1">
+                                            <button v-for="tag in filteredAvailableTagsForUpload"
+                                                    :key="tag.id"
+                                                    @click="addTagToSelection(tag.id)"
+                                                    class="group flex items-center justify-between px-1.5 py-1 rounded border border-[var(--border-secondary)] hover:border-[var(--border-focus)] bg-[var(--bg-primary)] hover:bg-[var(--bg-secondary)] transition-all">
+                                                <div class="flex items-center gap-1 min-w-0">
+                                                    <i v-if="tag.group_id" class="fas fa-users flex-shrink-0 text-[9px]"
+                                                       :style="{ color: tag.color || '#6B7280' }"></i>
+                                                    <span v-else class="w-2 h-2 rounded-full flex-shrink-0"
+                                                          :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                                    <span class="text-[11px] text-[var(--text-primary)] truncate">
+                                                        <span v-if="tag.group_id" class="opacity-75">${tag.group_name}: </span>${tag.name}
+                                                    </span>
+                                                </div>
+                                                <i class="fas fa-plus text-[var(--text-muted)] group-hover:text-[var(--text-accent)] transition-colors" style="font-size: 9px;"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+                                    <div v-else class="py-2 text-center">
+                                        <p class="text-[11px] text-[var(--text-muted)]">
+                                            <i class="fas fa-search mr-1" style="font-size: 9px;"></i>
+                                            No matching tags
+                                        </p>
+                                    </div>
+                                </div>
+                                <!-- Empty States -->
+                                <div v-else-if="availableTags.length === 0"
+                                     class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                    <p class="text-xs text-[var(--text-muted)] text-center">
+                                        <i class="fas fa-info-circle mr-1" style="font-size: 10px;"></i>
+                                        <span v-text="t('help.noTagsCreated')"></span> <a href="/account#tags" class="text-[var(--text-accent)] hover:underline" v-text="t('help.createTags')"></a>
+                                    </p>
+                                </div>
+                                <div v-else class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                    <p class="text-xs text-[var(--text-muted)] text-center">
+                                        <i class="fas fa-check-circle mr-1" style="font-size: 10px;"></i>
+                                        All tags selected
+                                    </p>
+                                </div>
+
+                                <p v-if="selectedTags.some(tag => tag.custom_prompt)" class="text-xs text-[var(--text-muted)] mt-1">
+                                    <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                                    Selected tags include custom summary prompts
+                                </p>
+                                <p v-if="selectedTags.length > 0 && connectorSupportsDiarization && selectedTags.some(tag => tag.default_language || tag.default_min_speakers || tag.default_max_speakers)"
+                                   class="text-xs text-[var(--text-muted)] mt-1">
+                                    <i class="fas fa-cog mr-1 text-[var(--text-accent)]"></i>
+                                    First tag's ASR settings will be applied: ${selectedTags[0].name}
+                                </p>
+                            </div>
+
+                            <!-- Advanced Options for diarization-enabled connectors (collapsible) -->
+                            <div v-if="connectorSupportsDiarization">
+                                <button @click="showAdvancedOptions = !showAdvancedOptions"
+                                        class="w-full flex items-center justify-between px-3 py-2 bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] transition-colors text-xs font-medium">
+                                    <span class="flex items-center gap-2 text-[var(--text-secondary)]">
+                                        <i class="fas fa-cog text-[var(--text-muted)]"></i>
+                                        <span v-text="t('help.advancedAsrOptions')"></span>
+                                    </span>
+                                    <i :class="['fas text-[var(--text-muted)]', showAdvancedOptions ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                                </button>
+
+                                <div v-if="showAdvancedOptions" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] space-y-3">
+                                    <div>
+                                        <label for="recordingAsrLanguage" class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                            Language
+                                        </label>
+                                        <select id="recordingAsrLanguage" v-model="asrLanguage"
+                                                class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                            <option v-for="lang in languageOptions" :key="lang.value" :value="lang.value" v-text="lang.label"></option>
+                                        </select>
+                                    </div>
+
+                                    <!-- Speaker Settings - only show for connectors that support min/max speakers -->
+                                    <div v-if="connectorSupportsSpeakerCount" class="grid grid-cols-2 gap-3">
+                                        <div>
+                                            <label for="recordingAsrMinSpeakers" class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.minSpeakers')">
+                                            </label>
+                                            <input type="number" id="recordingAsrMinSpeakers" v-model="asrMinSpeakers"
+                                                   min="1" max="20" :placeholder="t('form.auto')"
+                                                   class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                        </div>
+
+                                        <div>
+                                            <label for="recordingAsrMaxSpeakers" class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.maxSpeakers')">
+                                            </label>
+                                            <input type="number" id="recordingAsrMaxSpeakers" v-model="asrMaxSpeakers"
+                                                   min="1" max="20" :placeholder="t('form.auto')"
+                                                   class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Incognito Mode Toggle (only shown if feature is enabled) -->
+                            <div v-if="enableIncognitoMode">
+                                <button @click="incognitoMode = !incognitoMode"
+                                        :class="[
+                                            'w-full flex items-center justify-between px-3 py-2.5 rounded-lg border transition-all duration-200',
+                                            incognitoMode
+                                                ? 'bg-gradient-to-r from-violet-500/10 to-purple-500/10 border-violet-400/50 dark:border-violet-500/50'
+                                                : 'bg-[var(--bg-tertiary)] border-[var(--border-secondary)] hover:border-[var(--border-focus)]'
+                                        ]">
+                                    <div class="flex items-center gap-3">
+                                        <div :class="[
+                                            'w-8 h-8 rounded-full flex items-center justify-center transition-all',
+                                            incognitoMode
+                                                ? 'bg-gradient-to-br from-violet-500 to-purple-600 text-white'
+                                                : 'bg-[var(--bg-secondary)] text-[var(--text-muted)]'
+                                        ]">
+                                            <i class="fas fa-user-secret text-sm"></i>
+                                        </div>
+                                        <div class="text-left">
+                                            <span :class="['text-sm font-medium', incognitoMode ? 'text-violet-700 dark:text-violet-300' : 'text-[var(--text-secondary)]']">
+                                                Incognito Mode
+                                            </span>
+                                            <p v-if="!incognitoMode" class="text-[10px] text-[var(--text-muted)]">
+                                                Process without saving
+                                            </p>
+                                            <p v-else class="text-[10px] text-violet-600 dark:text-violet-400">
+                                                Session only &bull; Not saved to account
+                                            </p>
+                                        </div>
+                                    </div>
+                                    <div :class="[
+                                        'w-10 h-5 rounded-full relative transition-all duration-200',
+                                        incognitoMode ? 'bg-gradient-to-r from-violet-500 to-purple-500' : 'bg-[var(--bg-secondary)]'
+                                    ]">
+                                        <div :class="[
+                                            'absolute top-0.5 w-4 h-4 rounded-full bg-white shadow transition-all duration-200',
+                                            incognitoMode ? 'left-5' : 'left-0.5'
+                                        ]"></div>
+                                    </div>
+                                </button>
+                            </div>
+
+                        </div>
+                    </div>
+                </div>
+
+            </template>
+        </div>
+
+        <!-- BOTTOM: Action Buttons (always pinned) -->
+        <div class="flex-shrink-0 p-3 md:p-6 bg-[var(--bg-tertiary)] border-t border-[var(--border-primary)]">
+            <div v-if="isRecording" class="text-center">
+                <button @click="stopRecording"
+                        class="px-6 md:px-8 py-2.5 md:py-3 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors animate-pulse text-sm md:text-base">
+                    <i class="fas fa-stop mr-2"></i>Stop Recording
+                </button>
+            </div>
+            <div v-if="!isRecording && audioBlobURL" class="flex flex-col sm:flex-row gap-3 justify-center">
+                <!-- Normal Upload Button -->
+                <button v-if="!incognitoMode || !enableIncognitoMode"
+                        @click="uploadRecordedAudio"
+                        class="flex-1 px-6 py-3 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors flex items-center justify-center gap-2">
+                    <i class="fas fa-upload"></i>
+                    <span v-text="t('help.uploadRecordingNotes')"></span>
+                </button>
+                <!-- Incognito Upload Button -->
+                <button v-else
+                        @click="uploadRecordedAudioIncognito"
+                        :disabled="incognitoProcessing"
+                        class="flex-1 px-6 py-3 bg-gradient-to-r from-violet-500 to-purple-600 text-white rounded-lg hover:from-violet-600 hover:to-purple-700 disabled:opacity-50 disabled:cursor-not-allowed transition-all flex items-center justify-center gap-2 shadow-sm">
+                    <i :class="incognitoProcessing ? 'fas fa-spinner fa-spin' : 'fas fa-user-secret'"></i>
+                    <span v-if="incognitoProcessing">Processing...</span>
+                    <span v-else>Process in Incognito</span>
+                </button>
+                <button @click="discardRecording"
+                        class="px-6 py-3 bg-[var(--bg-danger)] text-white rounded-lg hover:bg-[var(--bg-danger-hover)] transition-colors flex items-center justify-center gap-2">
+                    <i class="fas fa-trash"></i>
+                    <span v-text="t('help.discard')"></span>
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/sidebar.html b/templates/components/sidebar.html
new file mode 100644
index 00000000..7ba3fe35
--- /dev/null
+++ b/templates/components/sidebar.html
@@ -0,0 +1,604 @@
+<!-- Mobile Sidebar Backdrop -->
+<div v-if="!isSidebarCollapsed && isMobileScreen"
+     @click="toggleSidebar"
+     class="fixed inset-0 bg-black bg-opacity-50 z-40 lg:hidden">
+</div>
+
+<!-- Sidebar -->
+<aside :class="['sidebar', isSidebarCollapsed ? 'collapsed' : '']">
+    <div class="sidebar-content-wrapper">
+        <!-- Sidebar Header -->
+        <div class="p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center gap-2 mb-3">
+                <!-- Folder Selector (replaces static "Recording" title) -->
+                <div v-if="foldersEnabled && availableFolders.length > 0" class="relative flex-1 min-w-0">
+                    <select v-model="filterFolder"
+                            class="w-full h-9 pl-8 pr-7 text-base font-semibold rounded-md cursor-pointer appearance-none border-0 bg-transparent text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] transition-colors"
+                            style="outline: none !important; box-shadow: none !important; background-image: url('data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2712%27 height=%2712%27 fill=%27%236B7280%27 viewBox=%270 0 16 16%27%3E%3Cpath d=%27M8 10.5l-4-4h8l-4 4z%27/%3E%3C/svg%3E'); background-repeat: no-repeat; background-position: right 8px center;">
+                        <option value="">All Recordings</option>
+                        <option value="none">Unfiled</option>
+                        <option v-for="folder in availableFolders" :key="folder.id" :value="folder.id">
+                            ${ folder.name }
+                        </option>
+                    </select>
+                    <i class="fas fa-folder absolute left-2.5 top-1/2 transform -translate-y-1/2 pointer-events-none text-sm"
+                       :style="{ color: filterFolder && filterFolder !== 'none' ? getFolderColor(filterFolder) : 'var(--text-muted)' }"></i>
+                </div>
+                <h2 v-else class="text-lg font-semibold flex-1" v-text="t('nav.recording')"></h2>
+                <div class="flex gap-2 flex-shrink-0">
+                    <!-- Selection Mode Toggle -->
+                    <button v-if="!selectionMode && recordings.length > 0"
+                            @click="enterSelectionMode"
+                            class="w-9 h-9 flex items-center justify-center bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-md hover:opacity-80 transition-opacity"
+                            title="Select multiple">
+                        <i class="fas fa-list-check"></i>
+                    </button>
+                    <button v-if="selectionMode"
+                            @click="exitSelectionMode"
+                            class="h-9 px-3 flex items-center bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:opacity-80 transition-opacity text-sm"
+                            title="Exit selection mode">
+                        <i class="fas fa-times mr-1"></i>Done
+                    </button>
+                    <!-- New button - compact when folders enabled -->
+                    <button v-if="!selectionMode && foldersEnabled && availableFolders.length > 0"
+                            @click="switchToUploadView"
+                            class="w-9 h-9 flex items-center justify-center bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] transition-colors"
+                            title="New Recording">
+                        <i class="fas fa-plus"></i>
+                    </button>
+                    <button v-else-if="!selectionMode"
+                            @click="switchToUploadView"
+                            class="h-9 px-3 flex items-center bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] transition-colors text-sm">
+                        <i class="fas fa-plus mr-1"></i><span v-text="t('common.new')"></span>
+                    </button>
+                </div>
+            </div>
+
+            <!-- Search and Sort Controls -->
+            <div class="space-y-3">
+                <!-- Filter Toggle Button -->
+                <div class="flex items-center gap-1.5">
+                    <button @click="showAdvancedFilters = !showAdvancedFilters"
+                            class="flex-1 h-7 flex items-center justify-between pl-2 pr-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <span class="flex items-center">
+                            <i class="fas fa-filter mr-1.5 text-[var(--text-muted)] text-[10px]"></i>
+                            <span v-if="!searchQuery && filterTags.length === 0 && filterSpeakers.length === 0 && !filterDatePreset && !filterDateRange.start && !filterDateRange.end && !filterTextQuery && !filterStarred && !filterInbox"
+                                  v-text="t('sidebar.searchRecordings')">
+                            </span>
+                            <span v-else class="text-[var(--text-accent)]">
+                                Active filters (${ (filterTags.length > 0 ? 1 : 0) + (filterSpeakers.length > 0 ? 1 : 0) + (filterDatePreset || filterDateRange.start || filterDateRange.end ? 1 : 0) + (filterTextQuery ? 1 : 0) + (filterStarred ? 1 : 0) + (filterInbox ? 1 : 0) })
+                            </span>
+                        </span>
+                        <i :class="['fas fa-chevron-down transition-transform text-[var(--text-muted)] text-[10px]', showAdvancedFilters ? 'rotate-180' : '']"></i>
+                    </button>
+                    <button v-if="searchQuery || filterTags.length > 0 || filterSpeakers.length > 0 || filterDatePreset || filterDateRange.start || filterDateRange.end || filterTextQuery || filterStarred || filterInbox"
+                            @click="clearAllFilters"
+                            class="w-7 h-7 flex items-center justify-center bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-primary)] transition-colors"
+                            :title="t('buttons.clearAllFilters')">
+                        <i class="fas fa-times text-[var(--text-muted)] text-[10px]"></i>
+                    </button>
+                </div>
+
+                <!-- Advanced Filters Panel -->
+                <div v-show="showAdvancedFilters" class="p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg space-y-3">
+                    <!-- Text Search -->
+                    <div>
+                        <label class="block text-xs font-medium text-[var(--text-muted)] mb-1" v-text="t('sidebar.filters')"></label>
+                        <div class="relative">
+                            <input v-model="filterTextQuery"
+                                   type="text"
+                                   :placeholder="t('sidebar.searchRecordings')"
+                                   class="w-full px-3 py-1.5 pl-8 pr-8 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                            <i class="fas fa-search absolute left-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] text-xs"></i>
+                            <button v-if="filterTextQuery"
+                                    @click="filterTextQuery = ''"
+                                    class="absolute right-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)] text-xs"
+                                    :title="t('buttons.clearSearchText')">
+                                <i class="fas fa-times"></i>
+                            </button>
+                        </div>
+                    </div>
+
+                    <!-- Quick Filters (Starred/Inbox) -->
+                    <div class="flex gap-2">
+                        <button @click="filterStarred = !filterStarred"
+                                :class="[
+                                    'flex-1 flex items-center justify-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium transition-all border',
+                                    filterStarred
+                                        ? 'bg-yellow-500/20 border-yellow-500/50 text-yellow-400'
+                                        : 'bg-[var(--bg-input)] border-[var(--border-secondary)] text-[var(--text-muted)] hover:border-yellow-500/30 hover:text-yellow-400'
+                                ]">
+                            <i class="fas fa-star" style="font-size: 10px;"></i>
+                            <span v-text="t('sidebar.starred')"></span>
+                        </button>
+                        <button @click="filterInbox = !filterInbox"
+                                :class="[
+                                    'flex-1 flex items-center justify-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-medium transition-all border',
+                                    filterInbox
+                                        ? 'bg-blue-500/20 border-blue-500/50 text-blue-400'
+                                        : 'bg-[var(--bg-input)] border-[var(--border-secondary)] text-[var(--text-muted)] hover:border-blue-500/30 hover:text-blue-400'
+                                ]">
+                            <i class="fas fa-inbox" style="font-size: 10px;"></i>
+                            <span v-text="t('sidebar.inbox')"></span>
+                        </button>
+                    </div>
+
+                    <!-- Tag Filter -->
+                    <div class="bg-[var(--bg-secondary)] rounded-lg p-2.5 border border-[var(--border-primary)]">
+                        <div class="flex items-center justify-between gap-2 mb-2">
+                            <label class="text-xs font-medium text-[var(--text-muted)] whitespace-nowrap" v-text="t('tags.filterByTag')"></label>
+                            <div class="relative flex-1 max-w-[140px]" v-if="availableTags.length > 5">
+                                <input v-model="filterTagSearch"
+                                       type="text"
+                                       :placeholder="t('tags.searchTags')"
+                                       class="w-full px-2 py-1 pl-7 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 10px;"></i>
+                            </div>
+                        </div>
+                        <div class="max-h-24 overflow-y-auto scrollbar-thin pr-1">
+                            <div class="flex flex-wrap gap-1.5">
+                                <button v-for="tag in filteredTagsForFilter"
+                                        :key="tag.id"
+                                        @click="filterTags.includes(tag.id) ? filterTags = filterTags.filter(id => id !== tag.id) : filterTags.push(tag.id)"
+                                        :class="[
+                                            'px-2 py-1 rounded-full text-xs font-medium transition-all',
+                                            filterTags.includes(tag.id)
+                                                ? 'bg-[var(--bg-accent)] text-[var(--text-accent)] ring-1 ring-[var(--border-accent)]'
+                                                : 'bg-[var(--bg-input)] text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)]'
+                                        ]">
+                                    <span class="inline-block w-2 h-2 rounded-full mr-1" :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                    ${ tag.name }
+                                </button>
+                            </div>
+                        </div>
+                        <p v-if="availableTags.length === 0" class="text-xs text-[var(--text-muted)] italic" v-text="t('tags.noTags')"></p>
+                        <p v-else-if="filteredTagsForFilter.length === 0" class="text-xs text-[var(--text-muted)] italic py-1" v-text="t('tags.noMatchingTags')"></p>
+                    </div>
+
+                    <!-- Speaker Filter -->
+                    <div v-if="availableSpeakers.length > 0" class="bg-[var(--bg-secondary)] rounded-lg p-2.5 border border-[var(--border-primary)]">
+                        <div class="flex items-center justify-between gap-2 mb-2">
+                            <label class="text-xs font-medium text-[var(--text-muted)] whitespace-nowrap" v-text="t('speakers.filterBySpeaker')"></label>
+                            <div class="relative flex-1 max-w-[140px]" v-if="availableSpeakers.length > 5">
+                                <input v-model="filterSpeakerSearch"
+                                       type="text"
+                                       :placeholder="t('speakers.searchSpeakers')"
+                                       class="w-full px-2 py-1 pl-7 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 10px;"></i>
+                            </div>
+                        </div>
+                        <div class="max-h-24 overflow-y-auto scrollbar-thin pr-1">
+                            <div class="flex flex-wrap gap-1.5">
+                                <button v-for="speaker in filteredSpeakersForFilter"
+                                        :key="speaker.id"
+                                        @click="filterSpeakers.includes(speaker.name) ? filterSpeakers = filterSpeakers.filter(n => n !== speaker.name) : filterSpeakers.push(speaker.name)"
+                                        :class="[
+                                            'px-2 py-1 rounded-full text-xs font-medium transition-all',
+                                            filterSpeakers.includes(speaker.name)
+                                                ? 'bg-[var(--bg-accent)] text-[var(--text-accent)] ring-1 ring-[var(--border-accent)]'
+                                                : 'bg-[var(--bg-input)] text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)]'
+                                        ]">
+                                    <i class="fas fa-user mr-1" style="font-size: 9px;"></i>
+                                    ${ speaker.name }
+                                </button>
+                            </div>
+                        </div>
+                        <p v-if="filteredSpeakersForFilter.length === 0 && filterSpeakerSearch" class="text-xs text-[var(--text-muted)] italic py-1" v-text="t('speakers.noMatchingSpeakers')"></p>
+                    </div>
+
+                    <!-- Date Filter -->
+                    <div>
+                        <label class="block text-xs font-medium text-[var(--text-muted)] mb-1" v-text="t('sidebar.dateRange')"></label>
+                        <div class="grid grid-cols-3 gap-1.5 mb-2">
+                            <button v-for="preset in datePresetOptions"
+                                    :key="preset.value"
+                                    @click="filterDatePreset = filterDatePreset === preset.value ? '' : preset.value; filterDateRange = { start: '', end: '' }"
+                                    :class="[
+                                        'px-2 py-1 rounded-md text-xs transition-all',
+                                        filterDatePreset === preset.value
+                                            ? 'bg-[var(--bg-accent)] text-[var(--text-accent)]'
+                                            : 'bg-[var(--bg-secondary)] text-[var(--text-secondary)] hover:bg-[var(--bg-input)]'
+                                    ]"
+                                    :title="preset.label">
+                                ${ preset.label }
+                            </button>
+                        </div>
+                        <div class="grid grid-cols-2 gap-2">
+                            <div>
+                                <input v-model="filterDateRange.start"
+                                       @change="filterDatePreset = ''"
+                                       type="date"
+                                       class="w-full px-2 py-1 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]"
+                                       :placeholder="t('form.dateFrom')">
+                            </div>
+                            <div>
+                                <input v-model="filterDateRange.end"
+                                       @change="filterDatePreset = ''"
+                                       type="date"
+                                       class="w-full px-2 py-1 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]"
+                                       :placeholder="t('form.dateTo')">
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Compact Controls Row -->
+                <div class="flex items-center gap-1.5">
+                    <!-- Sort Toggle -->
+                    <button @click="sortBy = sortBy === 'created_at' ? 'meeting_date' : 'created_at'"
+                            :class="[
+                                'flex-1 flex items-center justify-center gap-1 px-2 py-1.5 border rounded-md text-xs transition-colors',
+                                'bg-[var(--bg-input)] border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]'
+                            ]"
+                            :title="sortBy === 'meeting_date' ? t('sidebar.sortByMeetingDate') : t('sidebar.sortByDate')">
+                        <i :class="['fas', sortBy === 'meeting_date' ? 'fa-calendar' : 'fa-upload']"></i>
+                        <span class="hidden sm:inline">Sort</span>
+                        <i class="fas fa-exchange-alt text-[var(--text-muted)] text-[10px]"></i>
+                    </button>
+
+                    <!-- Archived Toggle (only show when audio-only deletion mode is active) -->
+                    <button v-if="enableArchiveToggle" @click="showArchivedRecordings = !showArchivedRecordings"
+                            :class="[
+                                'flex-1 flex items-center justify-center gap-1 px-2 py-1.5 border rounded-md text-xs transition-colors',
+                                showArchivedRecordings
+                                    ? 'bg-[var(--bg-accent)] border-[var(--border-accent)] text-[var(--text-accent)]'
+                                    : 'bg-[var(--bg-input)] border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]'
+                            ]"
+                            :title="t('sidebar.archivedRecordings')">
+                        <i class="fas fa-archive"></i>
+                        <span class="hidden sm:inline">Archived</span>
+                        <i :class="['fas text-[10px]', showArchivedRecordings ? 'fa-toggle-on' : 'fa-toggle-off']"></i>
+                    </button>
+
+                    <!-- Shared Toggle -->
+                    <button v-if="enableInternalSharing" @click="showSharedWithMe = !showSharedWithMe"
+                            :class="[
+                                'flex-1 flex items-center justify-center gap-1 px-2 py-1.5 border rounded-md text-xs transition-colors',
+                                showSharedWithMe
+                                    ? 'bg-[var(--bg-accent)] border-[var(--border-accent)] text-[var(--text-accent)]'
+                                    : 'bg-[var(--bg-input)] border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]'
+                            ]"
+                            :title="t('sidebar.sharedWithMe')">
+                        <i class="fas fa-users"></i>
+                        <span class="hidden sm:inline">Shared</span>
+                        <i :class="['fas text-[10px]', showSharedWithMe ? 'fa-toggle-on' : 'fa-toggle-off']"></i>
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Recordings List -->
+        <div class="flex-1 overflow-y-auto p-4"
+             @scroll="(e) => {
+                const element = e.target;
+                const threshold = 100; // Load more when 100px from bottom
+                if (element.scrollHeight - element.scrollTop - element.clientHeight < threshold) {
+                    loadMoreRecordings();
+                }
+             }">
+
+            <!-- Incognito Recording (styled like a regular recording item with a subtle indicator) -->
+            <div v-if="enableIncognitoMode && incognitoRecording"
+                 @click="selectIncognitoRecording"
+                 :class="[
+                     'group mb-3 p-3 rounded-lg cursor-pointer transition-all duration-200',
+                     selectedRecording?.id === 'incognito'
+                         ? 'bg-[var(--bg-accent)] border-l-4 border-[var(--border-accent)]'
+                         : 'bg-[var(--bg-secondary)] hover:bg-[var(--bg-tertiary)] border-l-4 border-transparent hover:border-[var(--border-secondary)]'
+                 ]">
+                <div class="flex items-start justify-between gap-2">
+                    <div class="flex-1 min-w-0">
+                        <div class="flex items-center gap-2 mb-1">
+                            <span class="font-medium text-sm text-[var(--text-primary)] truncate">
+                                ${ incognitoRecording.title || 'Incognito Recording' }
+                            </span>
+                        </div>
+                        <div class="flex items-center gap-2 flex-wrap">
+                            <!-- Incognito pill badge (matches tag style with contrasting border) -->
+                            <span class="inline-flex items-center px-1.5 py-0.5 rounded-md text-xs font-medium bg-violet-500/15 dark:bg-violet-500/25 text-violet-700 dark:text-violet-300 ring-1 ring-violet-400/50 dark:ring-violet-500/50">
+                                <i class="fas fa-user-secret mr-1" style="font-size: 9px;"></i>
+                                Incognito
+                            </span>
+                            <!-- Duration pill -->
+                            <span v-if="incognitoRecording.audio_duration_seconds" class="inline-flex items-center px-1.5 py-0.5 rounded text-[10px] text-[var(--text-muted)] bg-[var(--bg-tertiary)]">
+                                <i class="fas fa-clock mr-1" style="font-size: 8px;"></i>
+                                ${ Math.floor(incognitoRecording.audio_duration_seconds / 60) }:${ String(incognitoRecording.audio_duration_seconds % 60).padStart(2, '0') }
+                            </span>
+                        </div>
+                        <p class="text-[10px] text-[var(--text-muted)] mt-1.5 opacity-70">
+                            <i class="fas fa-eye-slash mr-1"></i>
+                            Session only
+                        </p>
+                    </div>
+                    <button @click.stop="clearIncognitoRecordingWithConfirm"
+                            class="opacity-0 group-hover:opacity-100 p-1.5 text-[var(--text-muted)] hover:text-red-500 hover:bg-red-500/10 rounded transition-all"
+                            title="Discard">
+                        <i class="fas fa-times text-xs"></i>
+                    </button>
+                </div>
+            </div>
+
+            <div v-if="isLoadingRecordings && recordings.length === 0" class="text-center py-8">
+                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.loadingRecordings')"></p>
+            </div>
+
+            <div v-else-if="recordings.length === 0 && !isLoadingRecordings" class="text-center py-8">
+                <i class="fas fa-microphone-slash text-3xl text-[var(--text-muted)] mb-3"></i>
+                <p class="text-[var(--text-muted)]" v-text="t('sidebar.noRecordings')"></p>
+                <p v-if="searchQuery.trim()" class="text-sm text-[var(--text-muted)] mt-1">
+                    <span v-text="t('help.tryAdjustingSearch')"></span> <button @click="clearAllFilters()" class="text-[var(--text-accent)] hover:underline" v-text="t('help.clearFilters')"></button>
+                </p>
+            </div>
+
+            <div v-if="recordings.length > 0" class="space-y-2">
+                <!-- Selection Mode Controls -->
+                <div v-if="selectionMode" class="flex items-center justify-between px-1 py-2 mb-2 border-b border-[var(--border-primary)]">
+                    <div class="flex items-center gap-3">
+                        <button @click="allVisibleSelected ? clearSelection() : selectAll()"
+                                class="text-xs text-[var(--text-accent)] hover:underline">
+                            ${ allVisibleSelected ? 'Clear all' : 'Select all' }
+                        </button>
+                        <span class="text-xs text-[var(--text-muted)]">
+                            ${ selectedCount } selected
+                        </span>
+                    </div>
+                </div>
+
+                <div v-for="group in groupedRecordings" :key="group.title" class="mb-6">
+                    <h3 class="text-xs font-semibold text-[var(--text-muted)] uppercase tracking-wide mb-2">
+                        ${group.title}
+                    </h3>
+                    <div class="space-y-1">
+                        <div v-for="recording in group.items"
+                             :key="recording.id"
+                             @click="selectionMode ? toggleSelection(recording.id) : selectRecording(recording)"
+                             :class="[
+                                 'p-3 rounded-lg cursor-pointer transition-all duration-200 border-2',
+                                 selectionMode && isSelected(recording.id)
+                                     ? 'bg-[var(--bg-accent)] border-[var(--border-accent)]'
+                                     : selectedRecording?.id === recording.id && !selectionMode
+                                         ? 'bg-[var(--bg-accent)] border-[var(--border-accent)]'
+                                         : recording.is_shared
+                                             ? 'bg-[var(--bg-secondary)] border-[var(--bg-tertiary)] hover:bg-[var(--bg-accent-hover)]'
+                                             : 'bg-[var(--bg-tertiary)] border-transparent hover:bg-[var(--bg-accent-hover)]'
+                             ]">
+                            <!-- Title and Status Row -->
+                            <div class="flex items-center justify-between mb-1">
+                                <!-- Checkbox for selection mode -->
+                                <div v-if="selectionMode" @click.stop="toggleSelection(recording.id)" class="flex-shrink-0 mr-2">
+                                    <input type="checkbox"
+                                           :checked="isSelected(recording.id)"
+                                           class="selection-checkbox"
+                                           @click.stop="toggleSelection(recording.id)">
+                                </div>
+                                <h4 class="font-medium text-sm truncate flex-1 mr-2" :class="selectedRecording?.id === recording.id && !selectionMode ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]'">
+                                    ${ recording.title || t('common.untitled') }
+                                </h4>
+                                <div class="flex items-center gap-0.5 flex-shrink-0">
+                                    <!-- Combined sharing status badge -->
+                                    <span v-if="recording.is_shared || recording.has_group_tags || recording.shared_with_count > 0 || recording.public_share_count > 0"
+                                          class="inline-flex items-center justify-center gap-1 h-5 px-2 rounded-full text-[9px] leading-none bg-violet-100 dark:bg-violet-900/50 border border-violet-300 dark:border-violet-600"
+                                          :title="[
+                                              recording.is_shared ? t('sharing.sharedBy') + ' ' + (recording.owner_username || t('sharing.unknown')) : '',
+                                              recording.has_group_tags ? t('sharing.teamRecording') : '',
+                                              !recording.is_shared && recording.shared_with_count > 0 ? t('sharing.sharedWith') + ' ' + recording.shared_with_count + ' ' + t('sharing.users') : '',
+                                              !recording.is_shared && recording.public_share_count > 0 ? recording.public_share_count + ' ' + t('sharing.publicLinksGenerated') : ''
+                                          ].filter(s => s).join(' • ')">
+                                        <i v-if="recording.is_shared" class="fas fa-arrow-down text-purple-600 dark:text-purple-400"></i>
+                                        <i v-if="recording.has_group_tags" class="fas fa-users text-blue-600 dark:text-blue-400"></i>
+                                        <i v-if="!recording.is_shared && recording.shared_with_count > 0" class="fas fa-arrow-up text-indigo-600 dark:text-indigo-400"></i>
+                                        <i v-if="!recording.is_shared && recording.public_share_count > 0" class="fas fa-globe text-teal-600 dark:text-teal-400"></i>
+                                    </span>
+
+                                    <!-- Show Audio Deleted badge -->
+                                    <span v-if="recording.audio_deleted_at"
+                                          class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-gray-200 dark:bg-gray-700 border border-gray-300 dark:border-gray-600"
+                                          :title="t('sidebar.archived')">
+                                        <i class="fas fa-file-audio text-gray-600 dark:text-gray-400"></i>
+                                    </span>
+
+                                    <!-- Show Failed status for failed recordings -->
+                                    <span v-if="recording.status === 'FAILED'"
+                                          class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-red-100 dark:bg-red-900/50 border border-red-300 dark:border-red-700 text-red-700 dark:text-red-400">
+                                        <i class="fas fa-exclamation-circle"></i>
+                                    </span>
+
+                                    <!-- Show Processing status for non-completed recordings -->
+                                    <span v-else-if="recording.status !== 'COMPLETED'"
+                                          :class="getStatusClass(recording.status)"
+                                          class="status-badge">
+                                        ${formatStatus(recording.status)}
+                                    </span>
+
+                                    <!-- For completed recordings, show highlight and inbox badges -->
+                                    <template v-else>
+                                        <span v-if="recording.is_highlighted"
+                                              @click.stop="toggleHighlight(recording)"
+                                              class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-amber-100 dark:bg-amber-900/50 border border-amber-400 dark:border-amber-600 cursor-pointer hover:bg-amber-200 dark:hover:bg-amber-800/50"
+                                              :title="t('sidebar.removeFromHighlighted')">
+                                            <i class="fas fa-star text-amber-600 dark:text-amber-400"></i>
+                                        </span>
+                                        <span v-if="recording.is_inbox"
+                                              @click.stop="toggleInbox(recording)"
+                                              class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-blue-100 dark:bg-blue-900/50 border border-blue-400 dark:border-blue-600 cursor-pointer hover:bg-blue-200 dark:hover:bg-blue-800/50"
+                                              :title="t('sidebar.markAsRead')">
+                                            <i class="fas fa-inbox text-blue-600 dark:text-blue-400"></i>
+                                        </span>
+                                    </template>
+                                </div>
+                            </div>
+
+                            <!-- Date and Participants -->
+                            <div class="flex flex-wrap items-center gap-x-3 gap-y-1 mt-1 text-xs text-[var(--text-muted)]">
+                                <!-- Date -->
+                                <div class="flex items-center flex-shrink-0">
+                                    <i class="fas fa-calendar-alt mr-1 text-[var(--text-muted)]" style="font-size: 10px;"></i>
+                                    ${formatShortDate(sortBy === 'meeting_date' ? recording.meeting_date : recording.created_at)}
+                                </div>
+
+                                <!-- Participants -->
+                                <div v-if="recording.participants" class="flex items-center min-w-0 flex-1">
+                                    <i class="fas fa-users mr-1 text-[var(--text-muted)] flex-shrink-0" style="font-size: 10px;"></i>
+                                    <span class="truncate">
+                                        ${recording.participants}
+                                    </span>
+                                </div>
+                            </div>
+
+                            <!-- Tags -->
+                            <div v-if="getRecordingTags(recording).length > 0 || recording.duplicate_info" class="flex flex-wrap items-center gap-1 mt-1">
+                                <button v-for="tag in getRecordingTags(recording).slice(0, 4)" :key="tag.id"
+                                        @click.stop="filterByTag(tag)"
+                                        class="inline-flex items-center px-1.5 py-0.5 rounded-md text-xs font-medium hover:opacity-80 transition-all cursor-pointer"
+                                        :style="{ backgroundColor: tag.color, color: getContrastTextColor(tag.color) }"
+                                        :title="tag.group_id ? ('Group: ' + tag.group_name) : ('Filter by ' + tag.name)">
+                                    <i v-if="tag.group_id" class="fas fa-users mr-1" style="font-size: 9px; vertical-align: middle; line-height: 0;"></i>
+                                    <span v-text="tag.name"></span>
+                                </button>
+                                <span v-if="getRecordingTags(recording).length > 4"
+                                      class="inline-flex items-center px-1.5 py-0.5 rounded-md text-xs text-[var(--text-muted)]"
+                                      :title="'More tags...'">
+                                    +${getRecordingTags(recording).length - 4}
+                                </span>
+                                <button v-if="recording.duplicate_info"
+                                        @click.stop="openDuplicatesModal(recording.duplicate_info)"
+                                        class="text-amber-500 hover:text-amber-400 transition-colors"
+                                        :title="recording.duplicate_info.total_copies + ' ' + (t('upload.copies') || 'copies')">
+                                    <i class="fas fa-copy text-xs"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Load More Indicator -->
+                <div v-if="isLoadingMore" class="text-center py-4">
+                    <i class="fas fa-spinner fa-spin text-lg text-[var(--text-muted)]"></i>
+                    <p class="text-sm text-[var(--text-muted)] mt-1" v-text="t('help.loadingMore')"></p>
+                </div>
+
+                <!-- End of Results Indicator -->
+                <div v-else-if="!hasNextPage && totalRecordings > 0" class="text-center py-4 text-xs text-[var(--text-muted)]">
+                    <i class="fas fa-check-circle mr-1"></i>
+                    <span v-text="t('help.allRecordingsLoaded')"></span>
+                </div>
+            </div>
+        </div>
+
+    </div>
+</aside>
+
+<!-- Vertical Floating Bulk Action Bar - To the right of sidebar -->
+<transition name="slide-right">
+    <div v-if="selectionMode && selectedCount > 0 && !isSidebarCollapsed"
+         class="fixed top-1/2 -translate-y-1/2 left-80 z-50 flex flex-col gap-1 p-2 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-r-xl shadow-lg">
+        <!-- Selection count badge -->
+        <div class="text-center text-xs font-medium text-[var(--text-accent)] py-1 border-b border-[var(--border-primary)] mb-1">
+            ${ selectedCount }
+        </div>
+
+        <button @click="openBulkTagModal('add')"
+                class="w-10 h-10 flex items-center justify-center bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-lg transition-colors border border-[var(--border-secondary)]"
+                title="Add or remove tags">
+            <i class="fas fa-tags text-[var(--text-muted)]"></i>
+        </button>
+
+        <button v-if="foldersEnabled"
+                @click="showBulkFolderModal = true"
+                class="w-10 h-10 flex items-center justify-center bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-lg transition-colors border border-[var(--border-secondary)]"
+                title="Move to folder">
+            <i class="fas fa-folder text-emerald-500"></i>
+        </button>
+
+        <button @click="bulkToggleInbox()"
+                class="w-10 h-10 flex items-center justify-center bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-lg transition-colors border border-[var(--border-secondary)]"
+                title="Toggle inbox status">
+            <i class="fas fa-inbox text-blue-500"></i>
+        </button>
+
+        <button @click="bulkToggleHighlight()"
+                class="w-10 h-10 flex items-center justify-center bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-lg transition-colors border border-[var(--border-secondary)]"
+                title="Toggle highlight">
+            <i class="fas fa-star text-amber-500"></i>
+        </button>
+
+        <button @click="openBulkReprocessModal"
+                class="w-10 h-10 flex items-center justify-center bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-lg transition-colors border border-[var(--border-secondary)]"
+                title="Reprocess">
+            <i class="fas fa-redo text-[var(--text-muted)]"></i>
+        </button>
+
+        <div class="border-t border-[var(--border-primary)] my-1"></div>
+
+        <button @click="openBulkDeleteModal"
+                class="w-10 h-10 flex items-center justify-center bg-red-600 hover:bg-red-700 text-white rounded-lg transition-colors"
+                title="Delete selected">
+            <i class="fas fa-trash"></i>
+        </button>
+
+        <button @click="exitSelectionMode"
+                class="w-10 h-10 flex items-center justify-center text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors"
+                title="Exit selection mode">
+            <i class="fas fa-times"></i>
+        </button>
+    </div>
+</transition>
+
+<!-- Bulk Folder Assignment Modal -->
+<div v-if="showBulkFolderModal" class="fixed inset-0 bg-black/50 flex items-center justify-center z-[60]" @click.self="showBulkFolderModal = false">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl max-w-sm w-full mx-4 overflow-hidden">
+        <div class="p-4 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold text-[var(--text-primary)]">
+                    <i class="fas fa-folder mr-2 text-emerald-500"></i>
+                    Move to Folder
+                </h3>
+                <button @click="showBulkFolderModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+            <p class="text-sm text-[var(--text-muted)] mt-1">
+                ${ selectedCount } recording(s) selected
+            </p>
+        </div>
+        <div class="p-4 max-h-64 overflow-y-auto">
+            <!-- No Folder Option -->
+            <button @click="bulkAssignFolder(null)"
+                    class="w-full flex items-center gap-3 px-3 py-2.5 rounded-lg text-left hover:bg-[var(--bg-tertiary)] transition-colors mb-2 border border-[var(--border-secondary)]">
+                <i class="fas fa-folder-minus text-[var(--text-muted)]"></i>
+                <span class="text-sm text-[var(--text-secondary)]">Remove from folder</span>
+            </button>
+
+            <!-- Divider -->
+            <div v-if="availableFolders.length > 0" class="border-t border-[var(--border-primary)] my-2"></div>
+
+            <!-- Folder Options -->
+            <button v-for="folder in availableFolders"
+                    :key="folder.id"
+                    @click="bulkAssignFolder(folder.id)"
+                    class="w-full flex items-center gap-3 px-3 py-2.5 rounded-lg text-left hover:bg-[var(--bg-tertiary)] transition-colors mb-1"
+                    :style="{ borderLeft: '3px solid ' + (folder.color || '#10B981') }">
+                <i class="fas fa-folder" :style="{ color: folder.color || '#10B981' }"></i>
+                <div class="flex-1 min-w-0">
+                    <span class="text-sm text-[var(--text-primary)] block truncate">${ folder.name }</span>
+                    <span v-if="folder.group_name" class="text-xs text-[var(--text-muted)]">
+                        <i class="fas fa-users mr-1" style="font-size: 9px;"></i>${ folder.group_name }
+                    </span>
+                </div>
+                <span class="text-xs text-[var(--text-muted)]">${ folder.recording_count || 0 }</span>
+            </button>
+
+            <!-- Empty State -->
+            <p v-if="availableFolders.length === 0" class="text-sm text-[var(--text-muted)] text-center py-4">
+                No folders created. Create folders in your account settings.
+            </p>
+        </div>
+        <div class="p-4 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)]">
+            <button @click="showBulkFolderModal = false"
+                    class="w-full px-4 py-2 text-sm text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                Cancel
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/components/token_budget_indicator.html b/templates/components/token_budget_indicator.html
new file mode 100644
index 00000000..edbebc23
--- /dev/null
+++ b/templates/components/token_budget_indicator.html
@@ -0,0 +1,17 @@
+<!-- Token Budget Indicator Component -->
+<!-- Only shows if user has a budget limit set -->
+<div v-if="tokenBudget && tokenBudget.has_budget"
+     class="hidden sm:flex items-center gap-1.5 px-2 py-1 rounded text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)] transition-colors cursor-default"
+     :title="t('adminDashboard.tokenUsage') + ': ' + (tokenBudget.usage || 0).toLocaleString() + ' / ' + (tokenBudget.budget || 0).toLocaleString()">
+    <i class="fas fa-coins text-[10px]"
+       :style="tokenBudget.percentage >= 100 ? {color: '#ef4444'} : tokenBudget.percentage >= 80 ? {color: '#f59e0b'} : {}"></i>
+    <span :style="tokenBudget.percentage >= 100 ? {color: '#ef4444'} : tokenBudget.percentage >= 80 ? {color: '#f59e0b'} : {}">${ tokenBudget.percentage }%</span>
+    <div class="w-12 h-1 bg-[var(--bg-tertiary)] rounded-full overflow-hidden">
+        <div class="h-full rounded-full transition-all duration-300 bg-[var(--text-accent)]"
+             :style="{
+                 width: Math.min(tokenBudget.percentage, 100) + '%',
+                 backgroundColor: tokenBudget.percentage >= 100 ? '#ef4444' : tokenBudget.percentage >= 80 ? '#f59e0b' : null
+             }">
+        </div>
+    </div>
+</div>
diff --git a/templates/components/upload-view.html b/templates/components/upload-view.html
new file mode 100644
index 00000000..134d29b2
--- /dev/null
+++ b/templates/components/upload-view.html
@@ -0,0 +1,472 @@
+<!-- Upload View -->
+<div v-if="currentView === 'upload'" class="flex-1 flex items-center justify-center p-4 md:p-8 overflow-y-auto">
+    <div class="max-w-lg w-full my-auto">
+        <!-- Compact Header -->
+        <div class="text-center mb-3">
+            <h2 class="text-lg font-semibold flex items-center justify-center gap-2">
+                <i class="fas fa-microphone text-[var(--text-accent)]"></i>
+                <span v-text="t('upload.title')"></span>
+            </h2>
+        </div>
+
+        <div class="bg-[var(--bg-secondary)] p-4 md:p-6 rounded-xl border border-[var(--border-primary)]">
+            <!-- File Upload Area -->
+            <div @drop="handleDrop" @dragover="handleDragOver" @dragleave="handleDragLeave" @click="$refs.fileInput.click()"
+                 :class="['border-2 border-dashed rounded-lg p-6 text-center cursor-pointer transition-all duration-300', dragover ? 'border-[var(--border-accent)] bg-[var(--bg-accent)]' : 'border-[var(--border-secondary)] hover:border-[var(--border-accent)]']">
+                <i class="fas fa-cloud-upload-alt text-2xl text-[var(--text-muted)] mb-2"></i>
+                <p class="text-sm text-[var(--text-secondary)] mb-1" v-text="t('upload.dropzone')"></p>
+                <p class="text-xs text-[var(--text-muted)]" v-text="t('upload.supportedFormats')"></p>
+            </div>
+            <input ref="fileInput" type="file" @change="handleFileSelect" accept="audio/*,video/*,.mp3,.m4a,.wav,.aac,.ogg,.flac,.wma,.aiff,.opus,.caf,.3gp,.3gpp,.amr,.mp4,.mov,.webm,.mkv,.avi,.m4v,.ts,.mts,.wmv,.flv,.mpeg,.mpg,.ogv,.vob,.asf" multiple class="hidden">
+
+            <!-- Queued Files Display -->
+            <div v-if="pendingQueueFiles.length > 0" class="mt-3">
+                <div class="flex items-center justify-between mb-1.5">
+                    <h4 class="text-xs font-medium text-[var(--text-secondary)]">
+                        <i class="fas fa-list mr-1"></i>
+                        ${ t('upload.filesToUpload') } (${pendingQueueFiles.length})
+                    </h4>
+                </div>
+                <div class="space-y-1 max-h-32 overflow-y-auto">
+                    <div v-for="item in pendingQueueFiles" :key="item.clientId"
+                         class="flex items-center justify-between px-2 py-1.5 bg-[var(--bg-tertiary)] rounded border border-[var(--border-secondary)]">
+                        <div class="flex items-center gap-1.5 min-w-0 flex-1">
+                            <i class="fas fa-file-audio text-[var(--text-muted)] text-xs"></i>
+                            <span class="text-xs text-[var(--text-primary)] truncate">${item.file.name}</span>
+                            <span class="text-[10px] text-[var(--text-muted)] flex-shrink-0">(${formatFileSize(item.file.size)})</span>
+                        </div>
+                        <button @click="removeFromQueue(item.clientId)"
+                                class="ml-1.5 p-0.5 text-[var(--text-muted)] hover:text-red-500 transition-colors flex-shrink-0"
+                                title="Remove from queue">
+                            <i class="fas fa-times text-xs"></i>
+                        </button>
+                    </div>
+                </div>
+
+                <!-- Incognito Mode Toggle (only shown if feature is enabled via ENABLE_INCOGNITO_MODE env var) -->
+                <div v-if="enableIncognitoMode" class="mt-3">
+                    <button @click="incognitoMode = !incognitoMode"
+                            :class="[
+                                'w-full flex items-center justify-between px-3 py-2.5 rounded-lg border transition-all duration-200',
+                                incognitoMode
+                                    ? 'bg-gradient-to-r from-violet-500/10 to-purple-500/10 border-violet-400/50 dark:border-violet-500/50'
+                                    : 'bg-[var(--bg-tertiary)] border-[var(--border-secondary)] hover:border-[var(--border-focus)]'
+                            ]">
+                        <div class="flex items-center gap-3">
+                            <div :class="[
+                                'w-8 h-8 rounded-full flex items-center justify-center transition-all',
+                                incognitoMode
+                                    ? 'bg-gradient-to-br from-violet-500 to-purple-600 text-white'
+                                    : 'bg-[var(--bg-secondary)] text-[var(--text-muted)]'
+                            ]">
+                                <i class="fas fa-user-secret text-sm"></i>
+                            </div>
+                            <div class="text-left">
+                                <span :class="['text-sm font-medium', incognitoMode ? 'text-violet-700 dark:text-violet-300' : 'text-[var(--text-secondary)]']">
+                                    ${ t('incognito.mode') }
+                                </span>
+                                <p v-if="!incognitoMode" class="text-[10px] text-[var(--text-muted)]">
+                                    ${ t('incognito.processWithoutSaving') }
+                                </p>
+                                <p v-else class="text-[10px] text-violet-600 dark:text-violet-400">
+                                    ${ t('incognito.sessionOnly') } &bull; ${ t('incognito.notSavedToAccount') }
+                                </p>
+                            </div>
+                        </div>
+                        <div :class="[
+                            'w-10 h-5 rounded-full relative transition-all duration-200',
+                            incognitoMode ? 'bg-gradient-to-r from-violet-500 to-purple-500' : 'bg-[var(--bg-secondary)]'
+                        ]">
+                            <div :class="[
+                                'absolute top-0.5 w-4 h-4 rounded-full bg-white shadow transition-all duration-200',
+                                incognitoMode ? 'left-5' : 'left-0.5'
+                            ]"></div>
+                        </div>
+                    </button>
+                </div>
+
+                <!-- Upload Buttons -->
+                <div class="mt-2 space-y-2">
+                    <!-- Normal Upload Button (when not in incognito mode or feature disabled) -->
+                    <button v-if="!incognitoMode || !enableIncognitoMode"
+                            @click="startUpload"
+                            class="w-full px-4 py-2.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors flex items-center justify-center gap-2 font-medium text-sm">
+                        <i class="fas fa-cloud-upload-alt"></i>
+                        <span v-text="t('upload.uploadNFiles', { count: pendingQueueFiles.length })"></span>
+                    </button>
+
+                    <!-- Incognito Upload Button (only when feature enabled and mode selected) -->
+                    <button v-else-if="enableIncognitoMode && incognitoMode"
+                            @click="startIncognitoUpload"
+                            :disabled="incognitoProcessing || pendingQueueFiles.length !== 1"
+                            class="w-full px-4 py-2.5 bg-gradient-to-r from-violet-500 to-purple-600 text-white rounded-lg hover:from-violet-600 hover:to-purple-700 disabled:opacity-50 disabled:cursor-not-allowed transition-all flex items-center justify-center gap-2 font-medium text-sm shadow-sm">
+                        <i :class="incognitoProcessing ? 'fas fa-spinner fa-spin' : 'fas fa-user-secret'"></i>
+                        <span v-if="incognitoProcessing">${ t('incognito.processing') }</span>
+                        <span v-else-if="pendingQueueFiles.length !== 1">${ t('incognito.selectExactlyOneFile') }</span>
+                        <span v-else>${ t('incognito.processInIncognito') }</span>
+                    </button>
+
+                    <p v-if="enableIncognitoMode && incognitoMode && pendingQueueFiles.length > 1" class="text-xs text-violet-600 dark:text-violet-400 text-center">
+                        <i class="fas fa-info-circle mr-1"></i>
+                        ${ t('incognito.oneFileAtATime') }
+                    </p>
+                </div>
+            </div>
+
+            <!-- Divider (hidden when files are selected) -->
+            <div v-if="pendingQueueFiles.length === 0" class="my-4 flex items-center">
+                <div class="flex-grow border-t border-[var(--border-secondary)]"></div>
+                <span class="flex-shrink mx-3 text-[10px] text-[var(--text-muted)] uppercase" v-text="t('common.or')"></span>
+                <div class="flex-grow border-t border-[var(--border-secondary)]"></div>
+            </div>
+
+            <!-- Audio Recording Options (hidden when files are selected) -->
+            <div v-if="pendingQueueFiles.length === 0" class="space-y-2">
+                <h3 class="text-xs font-medium text-[var(--text-secondary)] text-center" v-text="t('recording.title')"></h3>
+
+                <!-- Microphone Recording -->
+                <button @click="startRecording('microphone')"
+                        class="w-full px-3 py-2.5 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors flex items-center justify-center gap-2 text-sm">
+                    <i class="fas fa-microphone"></i>
+                    <span v-text="t('recording.microphone')"></span>
+                </button>
+
+                <!-- System Audio and Both - Side by Side -->
+                <div v-if="canRecordSystemAudio" class="grid grid-cols-2 gap-2">
+                    <!-- System Audio Recording -->
+                    <button @click="startRecording('system')"
+                            class="px-3 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors flex items-center justify-center gap-1.5 text-sm">
+                        <i class="fas fa-desktop"></i>
+                        <span v-text="t('recording.systemAudio')"></span>
+                    </button>
+
+                    <!-- Both Audio Sources -->
+                    <button @click="startRecording('both')"
+                            class="px-3 py-2.5 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors flex items-center justify-center gap-1 text-sm">
+                        <i class="fas fa-microphone"></i>
+                        <i class="fas fa-desktop"></i>
+                        <span class="hidden sm:inline" v-text="t('recording.microphoneAndSystem')"></span>
+                        <span class="sm:hidden">${ t('recording.micPlusSys') }</span>
+                    </button>
+                </div>
+
+                <!-- Help Text - Compact -->
+                <div class="text-[10px] text-[var(--text-muted)] space-y-0.5 mt-2">
+                    <div class="flex items-center justify-between">
+                        <span><strong v-text="t('recording.microphone') + ':'"></strong> <span v-text="t('help.microphoneDesc')"></span></span>
+                        <i class="fas fa-microphone text-red-500 flex-shrink-0 ml-1"></i>
+                    </div>
+                    <div v-if="canRecordSystemAudio" class="flex items-center justify-between">
+                        <span><strong v-text="t('recording.systemAudio') + ':'"></strong> <span v-text="t('help.systemAudioDesc')"></span></span>
+                        <i class="fas fa-desktop text-blue-500 flex-shrink-0 ml-1"></i>
+                    </div>
+                    <div v-if="canRecordSystemAudio" class="flex items-center justify-between">
+                        <span><strong v-text="t('recording.microphoneAndSystem') + ':'"></strong> <span v-text="t('help.bothAudioDesc')"></span></span>
+                        <div class="flex items-center gap-0.5 flex-shrink-0 ml-1">
+                            <i class="fas fa-microphone text-purple-500"></i>
+                            <i class="fas fa-desktop text-purple-500"></i>
+                        </div>
+                    </div>
+                    <div v-if="!canRecordSystemAudio" class="text-amber-600 dark:text-amber-400">
+                        <i class="fas fa-exclamation-triangle mr-1"></i>
+                        ${ t('recording.systemAudioNotSupported') }
+                        <button @click="showSystemAudioHelp = true" class="ml-1 text-blue-500 hover:text-blue-600 underline">
+                            <span v-text="t('buttons.help')"></span>
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Folder Selection (only shown if folders are enabled) -->
+            <div v-if="foldersEnabled" class="mt-4">
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                    <i class="fas fa-folder mr-1"
+                       :style="{ color: selectedFolderId ? getFolderColor(selectedFolderId) : 'var(--text-muted)' }"></i>
+                    ${ t('form.folder') }
+                </label>
+                <div class="relative">
+                    <select v-model="selectedFolderId"
+                            class="w-full pl-8 pr-8 py-2 text-sm rounded-lg cursor-pointer focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] appearance-none border border-[var(--border-secondary)] bg-[var(--bg-tertiary)] text-[var(--text-primary)] hover:bg-[var(--bg-input)] transition-colors">
+                        <option :value="null">No Folder</option>
+                        <option v-for="folder in availableFolders" :key="folder.id" :value="folder.id">
+                            ${ folder.name }
+                        </option>
+                    </select>
+                    <i class="fas fa-folder absolute left-2.5 top-1/2 transform -translate-y-1/2 pointer-events-none"
+                       :style="{ color: selectedFolderId ? getFolderColor(selectedFolderId) : 'var(--text-muted)' }"></i>
+                    <i class="fas fa-chevron-down absolute right-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] pointer-events-none" style="font-size: 10px;"></i>
+                </div>
+                <p v-if="selectedFolderId && getFolderById(selectedFolderId)?.custom_prompt" class="text-xs text-[var(--text-muted)] mt-1">
+                    <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                    ${ t('help.folderHasCustomPrompt') }
+                </p>
+                <p v-if="availableFolders.length === 0" class="text-xs text-[var(--text-muted)] mt-1">
+                    <i class="fas fa-info-circle mr-1"></i>
+                    <a href="/account#folders" class="text-[var(--text-accent)] hover:underline">${ t('help.createFolders') }</a> ${ t('help.toOrganizeRecordings') }
+                </p>
+            </div>
+
+            <!-- Tag Selection -->
+            <div class="mt-4">
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                    <i class="fas fa-tags mr-1 text-[var(--text-muted)]"></i>
+                    ${ t('tags.title') }
+                </label>
+
+                <!-- Selected Tags Display - Compact with Drag Reorder -->
+                <div v-if="selectedTags.length > 0" class="mb-2">
+                    <div class="p-1.5 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] max-h-16 overflow-y-auto"
+                         @touchmove="handleTagTouchMove">
+                        <div class="flex flex-wrap gap-1">
+                            <span v-for="(tag, index) in selectedTags" :key="tag.id"
+                                  :data-tag-index="index"
+                                  draggable="true"
+                                  @dragstart="handleTagDragStart(index, $event)"
+                                  @dragover="handleTagDragOver(index, $event)"
+                                  @drop="handleTagDrop(index, $event)"
+                                  @dragend="handleTagDragEnd"
+                                  @touchstart="handleTagTouchStart(index, $event)"
+                                  @touchend="handleTagTouchEnd"
+                                  :class="[
+                                      'inline-flex items-center px-1.5 py-0.5 rounded-full text-[11px] font-medium transition-all duration-150',
+                                      draggedTagIndex === index ? 'opacity-50 cursor-grabbing' : 'cursor-grab',
+                                      dragOverTagIndex === index && draggedTagIndex !== index ? 'ring-2 ring-[var(--ring-focus)] ring-offset-1' : ''
+                                  ]"
+                                  :style="{ backgroundColor: tag.color, color: getContrastTextColor(tag.color) }"
+                                  :title="(tag.group_id ? ('Group: ' + tag.group_name) : tag.name) + ' (drag to reorder)'">
+                                <span class="opacity-75 mr-0.5 text-[9px]">${index + 1}.</span>
+                                <i v-if="tag.group_id" class="fas fa-users mr-1 text-[9px]"></i>
+                                <span v-if="tag.group_id" class="opacity-75">${tag.group_name}: </span>
+                                <span>${tag.name}</span>
+                                <button @click.stop="removeTagFromSelection(tag.id)"
+                                        class="ml-1 hover:opacity-100 opacity-70">
+                                    <i class="fas fa-times" style="font-size: 9px;"></i>
+                                </button>
+                            </span>
+                        </div>
+                    </div>
+                    <p class="text-[10px] text-[var(--text-muted)] mt-0.5">
+                        <i class="fas fa-grip-vertical mr-0.5" style="font-size: 9px;"></i>
+                        ${ t('help.dragToReorder') } &bull; ${ t('help.firstTagDefaultsApplied') }
+                    </p>
+                </div>
+
+                <!-- Tag Selection Container - Compact -->
+                <div v-if="availableTags.filter(tag => !selectedTagIds.includes(tag.id)).length > 0"
+                     class="border border-[var(--border-secondary)] rounded-md bg-[var(--bg-tertiary)] p-2">
+                    <!-- Search Filter (always visible if tags available) -->
+                    <div class="mb-1.5">
+                        <div class="relative">
+                            <input v-model="uploadTagSearchFilter"
+                                   type="text"
+                                   :placeholder="t('tagsModal.searchTags')"
+                                   class="w-full px-2 py-1 pl-6 text-xs bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                            <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 9px;"></i>
+                            <button v-if="uploadTagSearchFilter"
+                                    @click="uploadTagSearchFilter = ''"
+                                    class="absolute right-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                <i class="fas fa-times" style="font-size: 9px;"></i>
+                            </button>
+                        </div>
+                    </div>
+
+                    <!-- Available Tags Grid - Fixed Height -->
+                    <div v-if="filteredAvailableTagsForUpload.length > 0"
+                         class="overflow-y-auto"
+                         style="max-height: 100px;">
+                        <div class="grid grid-cols-2 gap-1">
+                            <button v-for="tag in filteredAvailableTagsForUpload"
+                                    :key="tag.id"
+                                    @click="addTagToSelection(tag.id)"
+                                    class="group flex items-center justify-between px-1.5 py-1 rounded border border-[var(--border-secondary)] hover:border-[var(--border-focus)] bg-[var(--bg-primary)] hover:bg-[var(--bg-secondary)] transition-all">
+                                <div class="flex items-center gap-1 min-w-0">
+                                    <i v-if="tag.group_id" class="fas fa-users flex-shrink-0" style="font-size: 9px;" :style="{ color: tag.color || '#6B7280' }"></i>
+                                    <span v-else class="w-2 h-2 rounded-full flex-shrink-0"
+                                          :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                    <span class="text-[11px] text-[var(--text-primary)] truncate">
+                                        <span v-if="tag.group_id" class="opacity-75">${tag.group_name}: </span>${tag.name}
+                                    </span>
+                                </div>
+                                <i class="fas fa-plus text-[var(--text-muted)] group-hover:text-[var(--text-accent)] transition-colors" style="font-size: 9px;"></i>
+                            </button>
+                        </div>
+                    </div>
+                    <div v-else class="py-2 text-center">
+                        <p class="text-[11px] text-[var(--text-muted)]">
+                            <i class="fas fa-search mr-1" style="font-size: 9px;"></i>
+                            ${ t('help.noMatchingTags') }
+                        </p>
+                    </div>
+                </div>
+                <!-- Empty States -->
+                <div v-else-if="availableTags.length === 0"
+                     class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                    <p class="text-xs text-[var(--text-muted)] text-center">
+                        <i class="fas fa-info-circle mr-1" style="font-size: 10px;"></i>
+                        <span v-text="t('help.noTagsCreated')"></span> <a href="/account#tags" class="text-[var(--text-accent)] hover:underline" v-text="t('help.createTags')"></a>
+                    </p>
+                </div>
+                <div v-else class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                    <p class="text-xs text-[var(--text-muted)] text-center">
+                        <i class="fas fa-check-circle mr-1" style="font-size: 10px;"></i>
+                        ${ t('help.allTagsSelected') }
+                    </p>
+                </div>
+
+                <p v-if="selectedTags.some(tag => tag.custom_prompt)" class="text-xs text-[var(--text-muted)] mt-1">
+                    <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                    ${ t('help.selectedTagsCustomPrompts') }
+                </p>
+                <p v-if="selectedTags.length > 0 && connectorSupportsDiarization && selectedTags.some(tag => tag.default_language || tag.default_min_speakers || tag.default_max_speakers || tag.default_hotwords || tag.default_initial_prompt)"
+                   class="text-xs text-[var(--text-muted)] mt-1">
+                    <i class="fas fa-cog mr-1 text-[var(--text-accent)]"></i>
+                    ${ t('help.firstTagAsrSettings') } ${selectedTags[0].name}
+                </p>
+            </div>
+
+            <!-- Prompt template variables (from selected tag/folder custom prompts) -->
+            <div v-if="selectedPromptVariables.length > 0" class="mt-4">
+                <div class="flex items-stretch gap-1">
+                    <button type="button" @click="showPromptVariablesPanel = !showPromptVariablesPanel"
+                            class="flex-1 flex items-center justify-between px-3 py-2 bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] transition-colors text-xs font-medium">
+                        <span class="flex items-center gap-2 text-[var(--text-secondary)]">
+                            <i class="fas fa-keyboard text-[var(--text-muted)]"></i>
+                            <span>${ t('promptVariables.title') }</span>
+                            <span class="text-[10px] text-[var(--text-muted)]">(${ selectedPromptVariables.length })</span>
+                        </span>
+                        <i :class="['fas text-[var(--text-muted)]', showPromptVariablesPanel ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                    </button>
+                    <details class="relative">
+                        <summary
+                            :title="t('promptVariables.infoTooltip')"
+                            class="list-none cursor-pointer flex items-center justify-center px-3 h-full bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors">
+                            <i class="fas fa-info-circle text-xs"></i>
+                        </summary>
+                        <div class="absolute right-0 top-full mt-1 z-20 w-64 p-3 text-[11px] text-[var(--text-secondary)] leading-snug bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg">
+                            ${ t('promptVariables.hintUpload') }
+                        </div>
+                    </details>
+                </div>
+                <div v-show="showPromptVariablesPanel" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md space-y-3 border border-[var(--border-secondary)]">
+                    <div v-for="variable in selectedPromptVariables" :key="variable.name" class="space-y-1">
+                        <label class="block text-xs font-medium text-[var(--text-secondary)]" :for="'pv-' + variable.name">
+                            ${ variable.label }
+                            <span class="ml-1 text-[10px] text-[var(--text-muted)] font-normal">
+                                <span v-for="(src, i) in variable.sources" :key="i">
+                                    <span v-if="i > 0">, </span>
+                                    <i :class="{
+                                        'fas fa-folder': src.type === 'folder',
+                                        'fas fa-tag': src.type === 'tag',
+                                        'fas fa-user': src.type === 'user',
+                                        'fas fa-cog': src.type === 'admin'
+                                    }" class="mr-0.5"></i>${ src.name }
+                                </span>
+                            </span>
+                        </label>
+                        <textarea
+                            :id="'pv-' + variable.name"
+                            :value="uploadPromptVariables[variable.name] || ''"
+                            @input="uploadPromptVariables[variable.name] = $event.target.value"
+                            rows="2"
+                            maxlength="8000"
+                            :placeholder="t('promptVariables.placeholderPrefix') + ' ' + variable.label.toLowerCase() + '...'"
+                            class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] resize-y font-mono"></textarea>
+                        <div class="flex justify-end text-[10px] text-[var(--text-muted)] font-mono">
+                            ${ (uploadPromptVariables[variable.name] || '').length } / 8000
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Advanced Options for diarization-enabled connectors (collapsible) -->
+            <div v-if="connectorSupportsDiarization" class="mt-4">
+                <button @click="showAdvancedOptions = !showAdvancedOptions"
+                        class="w-full flex items-center justify-between px-3 py-2 bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] transition-colors text-xs font-medium">
+                    <span class="flex items-center gap-2 text-[var(--text-secondary)]">
+                        <i class="fas fa-cog text-[var(--text-muted)]"></i>
+                        <span v-text="t('help.advancedAsrOptions')"></span>
+                    </span>
+                    <i :class="['fas text-[var(--text-muted)]', showAdvancedOptions ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                </button>
+
+                <div v-show="showAdvancedOptions" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md space-y-3 border border-[var(--border-secondary)]">
+                    <!-- Language Selection -->
+                    <div>
+                        <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                            ${ t('form.transcriptionLanguage') }
+                        </label>
+                        <select v-model="uploadLanguage"
+                                class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                            <option v-for="lang in languageOptions" :key="lang.value" :value="lang.value" v-text="lang.label"></option>
+                        </select>
+                    </div>
+
+                    <!-- Speaker Settings - only show for connectors that support min/max speakers -->
+                    <div v-if="connectorSupportsSpeakerCount" class="grid grid-cols-2 gap-3">
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.minSpeakers')">
+                            </label>
+                            <input v-model.number="uploadMinSpeakers"
+                                   type="number"
+                                   min="1"
+                                   max="20"
+                                   class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                        </div>
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.maxSpeakers')">
+                            </label>
+                            <input v-model.number="uploadMaxSpeakers"
+                                   type="number"
+                                   min="1"
+                                   max="20"
+                                   class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                        </div>
+                    </div>
+
+                    <!-- Hotwords -->
+                    <div v-if="connectorSupportsHotwords">
+                        <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                            ${ t('form.hotwords') }
+                        </label>
+                        <input v-model="uploadHotwords"
+                               type="text"
+                               :placeholder="t('form.hotwordsPlaceholder')"
+                               class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                        <p class="text-[10px] text-[var(--text-muted)] mt-0.5">${ t('form.hotwordsHelp') }</p>
+                    </div>
+
+                    <!-- Initial Prompt -->
+                    <div v-if="connectorSupportsInitialPrompt">
+                        <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                            ${ t('form.initialPrompt') }
+                        </label>
+                        <textarea v-model="uploadInitialPrompt"
+                                  rows="2"
+                                  :placeholder="t('form.initialPromptPlaceholder')"
+                                  class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] resize-y"></textarea>
+                        <p class="text-[10px] text-[var(--text-muted)] mt-0.5">${ t('form.initialPromptHelp') }</p>
+                    </div>
+
+                    <!-- Transcription Model (issue #266 — visible only when admin set TRANSCRIPTION_MODELS_AVAILABLE) -->
+                    <!-- Only show the dropdown when there are at least 2 visible models;
+                         a single visible model means there is no real choice to offer. -->
+                    <div v-if="transcriptionModelOptions && transcriptionModelOptions.length > 1">
+                        <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                            ${ t('form.transcriptionModel') }
+                        </label>
+                        <select v-model="uploadTranscriptionModel"
+                                class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                            <option value="">${ t('form.useResolvedDefault') }</option>
+                            <option v-for="opt in transcriptionModelOptions" :key="opt.value" :value="opt.value" v-text="opt.label || opt.value"></option>
+                        </select>
+                    </div>
+
+                    <p class="text-xs text-[var(--text-muted)] pt-1">
+                        <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                        ${ t('upload.settingsApplyToAll') }
+                    </p>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/group-admin.html b/templates/group-admin.html
new file mode 100644
index 00000000..dda66a54
--- /dev/null
+++ b/templates/group-admin.html
@@ -0,0 +1,1617 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>Group Management - Speakr</title>
+
+    <!-- Loading overlay to prevent FOUC - MUST be first -->
+    {% include 'includes/loading_overlay.html' %}
+
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
+    <style>
+        /* Hide Vue content until compiled */
+        [v-cloak] {
+            display: none !important;
+        }
+
+        /* Hide scrollbar for tabs */
+        .scrollbar-hide {
+            -ms-overflow-style: none;
+            scrollbar-width: none;
+        }
+        .scrollbar-hide::-webkit-scrollbar {
+            display: none;
+        }
+
+        /* Custom select dropdown styling */
+        select {
+            appearance: none;
+            -webkit-appearance: none;
+            -moz-appearance: none;
+            padding-right: 2.5rem !important;
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23666' d='M6 9L1 4h10z'/%3E%3C/svg%3E");
+            background-repeat: no-repeat;
+            background-position: right 0.75rem center;
+            background-size: 12px 12px;
+        }
+
+        .dark select {
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23aaa' d='M6 9L1 4h10z'/%3E%3C/svg%3E");
+        }
+    </style>
+    <script>
+        // Initialize i18n
+        let t = (key) => key; // Default fallback
+        
+        async function initializeI18n() {
+            const userLanguage = "{{ user_language }}";
+            
+            // Initialize the global i18n instance
+            if (window.i18n) {
+                await window.i18n.init(userLanguage);
+                
+                // Create a shorthand translation function
+                t = (key, params) => window.i18n.t(key, params);
+                
+                // Update all elements with data-i18n attribute
+                document.querySelectorAll('[data-i18n]').forEach(el => {
+                    const key = el.getAttribute('data-i18n');
+                    el.textContent = t(key);
+                });
+                
+                // Update all elements with data-i18n-placeholder attribute
+                document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
+                    const key = el.getAttribute('data-i18n-placeholder');
+                    el.placeholder = t(key);
+                });
+            }
+        }
+        
+        // Function to apply the theme based on localStorage
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
+
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+        applyTheme();
+    </script>
+</head>
+<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
+    <div id="app" v-cloak class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
+        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
+            <h1 class="text-3xl font-bold text-[var(--text-primary)]">
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/icon-192x192.png') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
+            </h1>
+            <div class="flex items-center space-x-2">
+                <button @click="toggleDarkMode" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isDarkMode ? 'Switch to Light Mode' : 'Switch to Dark Mode'">
+                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
+                </button>
+                <div class="relative">
+                    <button @click="isUserMenuOpen = !isUserMenuOpen"
+                            data-user-menu-toggle
+                            class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
+                        <i class="fas fa-users-cog mr-2"></i>
+                        <span>{{ current_user.username }}</span>
+                        <i class="fas fa-chevron-down ml-2"></i>
+                    </button>
+                    <div v-if="isUserMenuOpen"
+                         data-user-menu-dropdown
+                         class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
+                        <a href="{{ url_for('recordings.index') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas fa-home mr-2"></i> Home
+                        </a>
+                        <a href="{{ url_for('auth.account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
+                            <i class="fas fa-user mr-2"></i> Account
+                        </a>
+                        <a href="{{ url_for('admin.group_management') }}" class="block px-4 py-2 text-[var(--text-accent)] bg-[var(--bg-accent)]">
+                            <i class="fas fa-users-cog mr-2"></i>
+                            Group Management
+                        </a>
+                        <a href="{{ url_for('auth.logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
+                            <i class="fas fa-sign-out-alt mr-2"></i> Sign Out
+                        </a>
+                    </div>
+                </div>
+            </div>
+        </header>
+
+        <main class="flex-grow">
+            <div class="bg-[var(--bg-secondary)] p-4 sm:p-6 lg:p-8 rounded-xl shadow-lg border border-[var(--border-primary)]">
+                <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6">Group Management</h2>
+                
+                {% with messages = get_flashed_messages(with_categories=true) %}
+                    {% if messages %}
+                        {% for category, message in messages %}
+                            <div class="mb-4 p-3 rounded-lg {% if category == 'success' %}bg-[var(--bg-success-light)] text-[var(--text-success-strong)]{% elif category == 'danger' %}bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)]{% else %}bg-[var(--bg-info-light)] text-[var(--text-info-strong)]{% endif %}">
+                                {{ message }}
+                            </div>
+                        {% endfor %}
+                    {% endif %}
+                {% endwith %}
+                
+                <!-- Tabs -->
+            <!-- Main Content Area -->
+            <div class="p-6">
+                <!-- Groups Management -->
+                <div v-show="activeTab === 'groups'">
+                    <div class="flex justify-between items-center mb-4">
+                        <h3 class="text-lg font-medium text-[var(--text-secondary)]">Group Management</h3>
+                        <button v-if="!isTeamAdminOnly" @click="openCreateTeamModal" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
+                            <i class="fas fa-plus mr-2"></i> Create Group
+                        </button>
+                    </div>
+
+                    <!-- Groups List -->
+                    <div class="bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-primary)] overflow-hidden">
+                        <div v-if="groups.length > 0">
+                            <table class="min-w-full divide-y divide-[var(--border-primary)]">
+                                <thead class="bg-[var(--bg-tertiary)]">
+                                    <tr>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Group Name</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Description</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Members</th>
+                                        <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Created</th>
+                                        <th scope="col" class="px-6 py-3 text-right text-xs font-medium text-[var(--text-muted)] uppercase tracking-wider">Actions</th>
+                                    </tr>
+                                </thead>
+                                <tbody class="bg-[var(--bg-secondary)] divide-y divide-[var(--border-primary)]">
+                                    <tr v-for="group in groups" :key="group.id" class="hover:bg-[var(--bg-tertiary)]">
+                                        <td class="px-6 py-4 whitespace-nowrap">
+                                            <div class="text-sm font-medium text-[var(--text-primary)]">${ group.name }</div>
+                                        </td>
+                                        <td class="px-6 py-4">
+                                            <div class="text-sm text-[var(--text-secondary)]">${ group.description || 'No description' }</div>
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap">
+                                            <div class="text-sm text-[var(--text-secondary)]">
+                                                <i class="fas fa-users mr-1"></i>
+                                                ${ group.member_count || 0 } members
+                                            </div>
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap text-sm text-[var(--text-muted)]">
+                                            ${ new Date(group.created_at).toLocaleDateString() }
+                                        </td>
+                                        <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium space-x-2">
+                                            <button @click="openManageTeamModal(group)" class="text-blue-500 hover:text-blue-700" title="Manage Members">
+                                                <i class="fas fa-users-cog"></i>
+                                            </button>
+                                            <button @click="openManageTeamTagsModal(group)" class="text-purple-500 hover:text-purple-700" title="Manage Group Tags">
+                                                <i class="fas fa-tags"></i>
+                                            </button>
+                                            <button v-if="foldersEnabled" @click="openManageTeamFoldersModal(group)" class="text-emerald-500 hover:text-emerald-700" title="Manage Group Folders">
+                                                <i class="fas fa-folder"></i>
+                                            </button>
+                                            <button @click="openEditTeamModal(group)" class="text-[var(--text-accent)] hover:text-[var(--text-accent-hover)]" title="Edit Group">
+                                                <i class="fas fa-edit"></i>
+                                            </button>
+                                            <button v-if="!isTeamAdminOnly" @click="confirmDeleteTeam(group)" class="text-red-500 hover:text-red-700" title="Delete Group">
+                                                <i class="fas fa-trash"></i>
+                                            </button>
+                                        </td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+                        <div v-else class="p-8 text-center">
+                            <i class="fas fa-users-slash text-4xl text-[var(--text-muted)] mb-3"></i>
+                            <p class="text-[var(--text-muted)]" v-text="isTeamAdminOnly ? 'You are not an admin of any groups yet' : 'No groups created yet'"></p>
+                            <button v-if="!isTeamAdminOnly" @click="openCreateTeamModal" class="mt-4 px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)]">
+                                <i class="fas fa-plus mr-2"></i> Create Your First Group
+                            </button>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </main>
+        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
+            Speakr &copy; {{ now.year }}
+        </footer>
+        <!-- Create/Edit Group Modal -->
+        <div v-if="showTeamModal" @click.self="closeTeamModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">${ editingTeam ? 'Edit Group' : 'Create Group' }</h3>
+                    <button @click="closeTeamModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <form @submit.prevent="saveTeam">
+                    <div class="space-y-4">
+                        <div>
+                            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Group Name *</label>
+                            <input v-model="teamForm.name" type="text" required
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                   placeholder="Enter group name">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Description</label>
+                            <textarea v-model="teamForm.description" rows="3"
+                                      class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                      placeholder="Optional description"></textarea>
+                        </div>
+                        <div v-if="teamError" class="p-3 bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] rounded-md text-sm">
+                            ${ teamError }
+                        </div>
+                    </div>
+                    <div class="flex justify-end space-x-3 mt-6">
+                        <button type="button" @click="closeTeamModal"
+                                class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">
+                            Cancel
+                        </button>
+                        <button type="submit"
+                                class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                            ${ editingTeam ? 'Update Group' : 'Create Group' }
+                        </button>
+                    </div>
+                </form>
+            </div>
+        </div>
+
+        <!-- Manage Group Members Modal -->
+        <div v-if="showManageTeamModal" @click.self="closeManageTeamModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-2xl max-h-[90vh] overflow-y-auto">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Manage Group: ${ currentTeam?.name }</h3>
+                    <button @click="closeManageTeamModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+
+                <!-- Add Member Section -->
+                <div class="mb-6 p-4 bg-[var(--bg-tertiary)] rounded-lg">
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Add Member</h4>
+                    <div class="flex space-x-2">
+                        <div class="flex-1">
+                            <select v-model="newMemberUserId"
+                                    class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                <option value="">Select a user...</option>
+                                <option v-for="user in availableUsers" :key="user.id" :value="user.id">
+                                    ${ user.username } (${ user.email })
+                                </option>
+                            </select>
+                        </div>
+                        <div>
+                            <select v-model="newMemberRole"
+                                    class="px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                <option value="member">Member</option>
+                                <option value="admin">Admin</option>
+                            </select>
+                        </div>
+                        <button @click="addTeamMember" :disabled="!newMemberUserId"
+                                class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] disabled:opacity-50 disabled:cursor-not-allowed">
+                            <i class="fas fa-plus"></i> Add
+                        </button>
+                    </div>
+                </div>
+
+                <!-- Current Members -->
+                <div>
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Current Members (${ teamMembers.length })</h4>
+                    <div v-if="teamMembers.length > 0" class="space-y-2">
+                        <div v-for="member in teamMembers" :key="member.user_id"
+                             class="flex items-center justify-between p-3 bg-[var(--bg-tertiary)] rounded-md">
+                            <div class="flex items-center space-x-3">
+                                <i class="fas fa-user text-[var(--text-muted)]"></i>
+                                <div>
+                                    <div class="text-sm font-medium text-[var(--text-primary)]">${ member.username }</div>
+                                    <div class="text-xs text-[var(--text-muted)]">${ member.email }</div>
+                                </div>
+                            </div>
+                            <div class="flex items-center space-x-2">
+                                <select v-model="member.role" @change="updateMemberRole(member)"
+                                        class="px-2 py-1 text-sm border border-[var(--border-secondary)] rounded bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    <option value="member">Member</option>
+                                    <option value="admin">Admin</option>
+                                </select>
+                                <button @click="removeTeamMember(member)"
+                                        class="text-red-500 hover:text-red-700" title="Remove from group">
+                                    <i class="fas fa-times"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                    <div v-else class="text-center py-4 text-[var(--text-muted)]">
+                        No members yet
+                    </div>
+                </div>
+
+                <div v-if="teamMemberError" class="mt-4 p-3 bg-[var(--bg-danger-light)] text-[var(--text-danger-strong)] rounded-md text-sm">
+                    ${ teamMemberError }
+                </div>
+
+                <div class="flex justify-between mt-6">
+                    <button @click="syncTeamShares"
+                            class="px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 flex items-center gap-2">
+                        <i class="fas fa-sync-alt"></i>
+                        Sync Group Shares
+                    </button>
+                    <button @click="closeManageTeamModal"
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        Done
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Sync Group Shares Confirmation Modal -->
+        <div v-if="showSyncSharesModal" @click.self="showSyncSharesModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Sync Group Shares</h3>
+                    <button @click="showSyncSharesModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <p class="mb-4 text-[var(--text-secondary)]">
+                    This will create shares for all recordings with group tags that have auto-sharing enabled.
+                </p>
+                <p class="mb-4 text-[var(--text-muted)] text-sm">
+                    <i class="fas fa-info-circle mr-1"></i>
+                    Only missing shares will be created - existing shares won't be duplicated.
+                </p>
+                <div class="flex justify-end space-x-3">
+                    <button @click="showSyncSharesModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
+                    <button @click="confirmSyncShares" class="px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700">
+                        <i class="fas fa-sync-alt mr-2"></i>Sync Now
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Sync Results Modal -->
+        <div v-if="showSyncResultsModal" @click.self="showSyncResultsModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">
+                        <i class="fas fa-check-circle text-green-500 mr-2"></i>Sync Complete
+                    </h3>
+                    <button @click="showSyncResultsModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <div class="mb-4 space-y-2">
+                    <div class="flex justify-between text-[var(--text-secondary)]">
+                        <span>Shares created:</span>
+                        <span class="font-semibold">${ syncResults.shares_created }</span>
+                    </div>
+                    <div class="flex justify-between text-[var(--text-secondary)]">
+                        <span>Recordings processed:</span>
+                        <span class="font-semibold">${ syncResults.recordings_processed }</span>
+                    </div>
+                </div>
+                <div class="flex justify-end">
+                    <button @click="showSyncResultsModal = false" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">
+                        Done
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Delete Group Confirmation Modal -->
+        <div v-if="showDeleteTeamModal" @click.self="showDeleteTeamModal = false" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-md">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Delete Group</h3>
+                    <button @click="showDeleteTeamModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+                <p class="mb-4 text-[var(--text-secondary)]">Are you sure you want to delete the group <span class="font-semibold">${ teamToDelete?.name }</span>? This will remove all members from the group. This action cannot be undone.</p>
+                <div class="flex justify-end space-x-3">
+                    <button @click="showDeleteTeamModal = false" class="px-4 py-2 border border-[var(--border-secondary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--bg-tertiary)]">Cancel</button>
+                    <button @click="deleteTeam" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">Delete Group</button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Manage Group Tags Modal -->
+        <div v-if="showManageTeamTagsModal" @click.self="closeManageTeamTagsModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-3xl max-h-[90vh] overflow-y-auto">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Manage Tags for ${ currentTeam?.name }</h3>
+                    <button @click="closeManageTeamTagsModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+
+                <!-- Create/Edit Tag Form -->
+                <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg mb-4 border border-[var(--border-primary)]">
+                    <div class="flex justify-between items-center mb-3">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)]">
+                            ${ editingTeamTagId ? 'Edit Group Tag' : 'Create New Group Tag' }
+                        </h4>
+                        <button v-if="editingTeamTagId" @click="cancelEditTeamTag" type="button" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                            <i class="fas fa-times mr-1"></i> Cancel
+                        </button>
+                    </div>
+                    <form @submit.prevent="saveTeamTag" class="space-y-3">
+                        <div class="grid grid-cols-2 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Tag Name *</label>
+                                <input v-model="newTeamTag.name" type="text" required maxlength="50"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="e.g., Project Alpha">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Color</label>
+                                <input v-model="newTeamTag.color" type="color"
+                                       class="w-full h-10 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] cursor-pointer">
+                            </div>
+                        </div>
+
+                        <!-- Custom Prompt -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Custom Summarization Prompt
+                                <span class="text-[var(--text-muted)] font-normal">- Optional AI instructions</span>
+                            </label>
+                            <textarea v-model="newTeamTag.custom_prompt" rows="3"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Enter custom instructions for AI summarization (e.g., 'Focus on action items and deadlines')"></textarea>
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings with this tag will use this prompt for AI summaries and chat.
+                            </p>
+                        </div>
+
+                        <!-- Transcription Settings -->
+                        <div class="grid grid-cols-3 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Default Language</label>
+                                <select v-model="newTeamTag.default_language"
+                                        class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]">
+                                    <option value="">Auto-detect</option>
+                                    <option value="en">English</option>
+                                    <option value="es">Spanish</option>
+                                    <option value="fr">French</option>
+                                    <option value="de">German</option>
+                                    <option value="zh">Chinese</option>
+                                    <option value="ja">Japanese</option>
+                                    <option value="pt">Portuguese</option>
+                                    <option value="it">Italian</option>
+                                </select>
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Min Speakers</label>
+                                <input v-model.number="newTeamTag.default_min_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="1">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Max Speakers</label>
+                                <input v-model.number="newTeamTag.default_max_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="5">
+                            </div>
+                        </div>
+
+                        <!-- Retention and Protection -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Retention Period (days)
+                                <span class="text-[var(--text-muted)] font-normal">- Optional override for auto-deletion</span>
+                            </label>
+                            <input v-model.number="newTeamTag.retention_days" type="number" min="0" step="1"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Leave empty to use global retention">
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings with this tag will be deleted after this many days. Leave empty to use global retention (${ globalRetentionDays } days).
+                            </p>
+                        </div>
+                        <div class="flex items-center">
+                            <input v-model="newTeamTag.protect_from_deletion" type="checkbox" id="protectFromDeletion"
+                                   class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                            <label for="protectFromDeletion" class="text-xs text-[var(--text-secondary)]">
+                                <i class="fas fa-shield-alt mr-1"></i> Protect recordings with this tag from auto-deletion
+                            </label>
+                        </div>
+                        <div class="space-y-2">
+                            <div class="flex items-center">
+                                <input v-model="newTeamTag.auto_share_on_apply" type="checkbox" id="autoShareOnApply"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="autoShareOnApply" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-friends mr-1"></i> Auto-share recordings with all group members when this tag is applied
+                                </label>
+                            </div>
+                            <div class="flex items-center">
+                                <input v-model="newTeamTag.share_with_group_lead" type="checkbox" id="shareWithGroupLead"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="shareWithGroupLead" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-tie mr-1"></i> Share recordings with group admins when this tag is applied
+                                </label>
+                            </div>
+                            <p class="text-xs text-[var(--text-muted)] ml-6">
+                                Note: If both are enabled, all group members will have access. If only "group admins" is enabled, only group leads will have access.
+                            </p>
+                        </div>
+                        <div v-if="teamTagError" class="text-[var(--text-danger)] text-xs">${ teamTagError }</div>
+                        <button type="submit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] text-sm">
+                            <i :class="editingTeamTagId ? 'fas fa-save' : 'fas fa-plus'" class="mr-1"></i>
+                            ${ editingTeamTagId ? 'Update Tag' : 'Create Tag' }
+                        </button>
+                    </form>
+                </div>
+
+                <!-- Existing Group Tags -->
+                <div>
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Group Tags</h4>
+                    <div v-if="teamTags.length > 0" class="space-y-3">
+                        <div v-for="tag in teamTags" :key="tag.id"
+                             class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex items-start justify-between mb-2">
+                                <div class="flex items-center space-x-3 flex-1">
+                                    <span class="inline-block w-4 h-4 rounded flex-shrink-0" :style="{ backgroundColor: tag.color }"></span>
+                                    <div class="flex-1">
+                                        <div class="text-sm font-medium text-[var(--text-primary)]">${ tag.name }</div>
+                                        <div class="text-xs text-[var(--text-muted)] mt-1 space-x-3">
+                                            <span v-if="tag.retention_days">
+                                                <i class="fas fa-clock mr-1"></i> ${ tag.retention_days } day retention
+                                            </span>
+                                            <span v-else>
+                                                <i class="fas fa-globe mr-1"></i> Global retention
+                                            </span>
+                                            <span v-if="tag.protect_from_deletion" class="text-green-500">
+                                                <i class="fas fa-shield-alt mr-1"></i> Protected
+                                            </span>
+                                        </div>
+                                    </div>
+                                </div>
+                                <div class="flex gap-2 flex-shrink-0">
+                                    <button @click="editTeamTag(tag)" class="text-blue-500 hover:text-blue-700 px-2 py-1" title="Edit Tag">
+                                        <i class="fas fa-edit"></i>
+                                    </button>
+                                    <button @click="deleteTeamTag(tag)" class="text-red-500 hover:text-red-700 px-2 py-1" title="Delete Tag">
+                                        <i class="fas fa-trash"></i>
+                                    </button>
+                                </div>
+                            </div>
+
+                            <!-- Additional details if configured -->
+                            <div v-if="tag.custom_prompt || tag.default_language || tag.default_min_speakers || tag.default_max_speakers"
+                                 class="mt-2 pt-2 border-t border-[var(--border-secondary)] space-y-1">
+                                <div v-if="tag.custom_prompt" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-comment-dots mr-1"></i> Custom prompt configured
+                                </div>
+                                <div v-if="tag.default_language" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-language mr-1"></i> Language: ${ tag.default_language.toUpperCase() }
+                                </div>
+                                <div v-if="tag.default_min_speakers || tag.default_max_speakers" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-users mr-1"></i> Speakers:
+                                    <span v-if="tag.default_min_speakers">${ tag.default_min_speakers }-</span><span v-if="tag.default_max_speakers">${ tag.default_max_speakers }</span><span v-else>auto</span>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <div v-else class="text-center py-8 text-[var(--text-muted)]">
+                        <i class="fas fa-tags text-3xl mb-2"></i>
+                        <p class="text-sm">No group tags created yet</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Manage Group Folders Modal -->
+        <div v-if="showManageTeamFoldersModal" @click.self="closeManageTeamFoldersModal" class="fixed inset-0 bg-black bg-opacity-70 backdrop-blur-sm flex items-center justify-center z-50 p-4">
+            <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-3xl max-h-[90vh] overflow-y-auto">
+                <div class="flex justify-between items-center mb-4">
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">
+                        <i class="fas fa-folder mr-2 text-emerald-500"></i>
+                        Manage Folders for ${ currentTeam?.name }
+                    </h3>
+                    <button @click="closeManageTeamFoldersModal" class="text-[var(--text-muted)] hover:text-[var(--text-secondary)]">&times;</button>
+                </div>
+
+                <!-- Create/Edit Folder Form -->
+                <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg mb-4 border border-[var(--border-primary)]">
+                    <div class="flex justify-between items-center mb-3">
+                        <h4 class="text-sm font-medium text-[var(--text-secondary)]">
+                            ${ editingTeamFolderId ? 'Edit Group Folder' : 'Create New Group Folder' }
+                        </h4>
+                        <button v-if="editingTeamFolderId" @click="cancelEditTeamFolder" type="button" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                            <i class="fas fa-times mr-1"></i> Cancel
+                        </button>
+                    </div>
+                    <form @submit.prevent="saveTeamFolder" class="space-y-3">
+                        <div class="grid grid-cols-2 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Folder Name *</label>
+                                <input v-model="newTeamFolder.name" type="text" required maxlength="50"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="e.g., Client Calls">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Color</label>
+                                <input v-model="newTeamFolder.color" type="color"
+                                       class="w-full h-10 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] cursor-pointer">
+                            </div>
+                        </div>
+
+                        <!-- Custom Prompt -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Custom Summarization Prompt
+                                <span class="text-[var(--text-muted)] font-normal">- Optional AI instructions</span>
+                            </label>
+                            <textarea v-model="newTeamFolder.custom_prompt" rows="3"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Enter custom instructions for AI summarization"></textarea>
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings in this folder will use this prompt (unless overridden by a tag).
+                            </p>
+                        </div>
+
+                        <!-- Transcription Settings -->
+                        <div class="grid grid-cols-3 gap-3">
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Default Language</label>
+                                <select v-model="newTeamFolder.default_language"
+                                        class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]">
+                                    <option value="">Auto-detect</option>
+                                    <option value="en">English</option>
+                                    <option value="es">Spanish</option>
+                                    <option value="fr">French</option>
+                                    <option value="de">German</option>
+                                    <option value="zh">Chinese</option>
+                                    <option value="ja">Japanese</option>
+                                    <option value="pt">Portuguese</option>
+                                    <option value="it">Italian</option>
+                                </select>
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Min Speakers</label>
+                                <input v-model.number="newTeamFolder.default_min_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="1">
+                            </div>
+                            <div>
+                                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">Max Speakers</label>
+                                <input v-model.number="newTeamFolder.default_max_speakers" type="number" min="1" max="10"
+                                       class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                       placeholder="5">
+                            </div>
+                        </div>
+
+                        <!-- Retention and Protection -->
+                        <div>
+                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                Retention Period (days)
+                                <span class="text-[var(--text-muted)] font-normal">- Optional override for auto-deletion</span>
+                            </label>
+                            <input v-model.number="newTeamFolder.retention_days" type="number" min="0" step="1"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md bg-[var(--bg-input)] text-[var(--text-primary)] text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)]"
+                                   placeholder="Leave empty to use global retention">
+                            <p class="text-xs text-[var(--text-muted)] mt-1">
+                                Recordings in this folder will be deleted after this many days. Leave empty to use global retention (${ globalRetentionDays } days).
+                            </p>
+                        </div>
+                        <div class="flex items-center">
+                            <input v-model="newTeamFolder.protect_from_deletion" type="checkbox" id="folderProtectFromDeletion"
+                                   class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                            <label for="folderProtectFromDeletion" class="text-xs text-[var(--text-secondary)]">
+                                <i class="fas fa-shield-alt mr-1"></i> Protect recordings in this folder from auto-deletion
+                            </label>
+                        </div>
+                        <div class="space-y-2">
+                            <div class="flex items-center">
+                                <input v-model="newTeamFolder.auto_share_on_apply" type="checkbox" id="folderAutoShareOnApply"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="folderAutoShareOnApply" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-friends mr-1"></i> Auto-share recordings with all group members when added to this folder
+                                </label>
+                            </div>
+                            <div class="flex items-center">
+                                <input v-model="newTeamFolder.share_with_group_lead" type="checkbox" id="folderShareWithGroupLead"
+                                       class="mr-2 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] rounded focus:ring-[var(--border-focus)]">
+                                <label for="folderShareWithGroupLead" class="text-xs text-[var(--text-secondary)]">
+                                    <i class="fas fa-user-tie mr-1"></i> Share recordings with group admins when added to this folder
+                                </label>
+                            </div>
+                            <p class="text-xs text-[var(--text-muted)] ml-6">
+                                Note: If both are enabled, all group members will have access. If only "group admins" is enabled, only group leads will have access.
+                            </p>
+                        </div>
+                        <div v-if="teamFolderError" class="text-[var(--text-danger)] text-xs">${ teamFolderError }</div>
+                        <button type="submit" class="px-4 py-2 bg-emerald-600 text-white rounded-md hover:bg-emerald-700 text-sm">
+                            <i :class="editingTeamFolderId ? 'fas fa-save' : 'fas fa-plus'" class="mr-1"></i>
+                            ${ editingTeamFolderId ? 'Update Folder' : 'Create Folder' }
+                        </button>
+                    </form>
+                </div>
+
+                <!-- Existing Group Folders -->
+                <div>
+                    <h4 class="text-sm font-medium text-[var(--text-secondary)] mb-3">Group Folders</h4>
+                    <div v-if="teamFolders.length > 0" class="space-y-3">
+                        <div v-for="folder in teamFolders" :key="folder.id"
+                             class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex items-start justify-between mb-2">
+                                <div class="flex items-center space-x-3 flex-1">
+                                    <span class="inline-block w-4 h-4 rounded flex-shrink-0" :style="{ backgroundColor: folder.color || '#10B981' }"></span>
+                                    <div class="flex-1">
+                                        <div class="text-sm font-medium text-[var(--text-primary)]">${ folder.name }</div>
+                                        <div class="text-xs text-[var(--text-muted)] mt-1 space-x-3">
+                                            <span v-if="folder.retention_days">
+                                                <i class="fas fa-clock mr-1"></i> ${ folder.retention_days } day retention
+                                            </span>
+                                            <span v-else>
+                                                <i class="fas fa-globe mr-1"></i> Global retention
+                                            </span>
+                                            <span v-if="folder.protect_from_deletion" class="text-green-500">
+                                                <i class="fas fa-shield-alt mr-1"></i> Protected
+                                            </span>
+                                            <span>
+                                                <i class="fas fa-file-audio mr-1"></i> ${ folder.recording_count || 0 } recordings
+                                            </span>
+                                        </div>
+                                    </div>
+                                </div>
+                                <div class="flex gap-2 flex-shrink-0">
+                                    <button @click="editTeamFolder(folder)" class="text-blue-500 hover:text-blue-700 px-2 py-1" title="Edit Folder">
+                                        <i class="fas fa-edit"></i>
+                                    </button>
+                                    <button @click="deleteTeamFolder(folder)" class="text-red-500 hover:text-red-700 px-2 py-1" title="Delete Folder">
+                                        <i class="fas fa-trash"></i>
+                                    </button>
+                                </div>
+                            </div>
+
+                            <!-- Additional details if configured -->
+                            <div v-if="folder.custom_prompt || folder.default_language || folder.default_min_speakers || folder.default_max_speakers"
+                                 class="mt-2 pt-2 border-t border-[var(--border-secondary)] space-y-1">
+                                <div v-if="folder.custom_prompt" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-comment-dots mr-1"></i> Custom prompt configured
+                                </div>
+                                <div v-if="folder.default_language" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-language mr-1"></i> Language: ${ folder.default_language.toUpperCase() }
+                                </div>
+                                <div v-if="folder.default_min_speakers || folder.default_max_speakers" class="text-xs text-[var(--text-muted)]">
+                                    <i class="fas fa-users mr-1"></i> Speakers:
+                                    <span v-if="folder.default_min_speakers">${ folder.default_min_speakers }-</span><span v-if="folder.default_max_speakers">${ folder.default_max_speakers }</span><span v-else>auto</span>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <div v-else class="text-center py-8 text-[var(--text-muted)]">
+                        <i class="fas fa-folder text-3xl mb-2"></i>
+                        <p class="text-sm">No group folders created yet</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        const { createApp, ref, computed, onMounted, watch } = Vue
+        
+        // Initialize i18n before Vue app creation
+        initializeI18n().then(() => {
+            // Get the i18n instance to properly bind the t function
+            const i18nInstance = window.i18n;
+            
+            createApp({
+            setup() {
+                // State - groups only
+                const isTeamAdminOnly = ref(true); // This page is only for group admins
+                const activeTab = ref('groups'); // Single tab page
+                const groups = ref([]);
+                const globalRetentionDays = ref({{ global_retention_days }});
+                const isDarkMode = ref(document.documentElement.classList.contains('dark'));
+                const isUserMenuOpen = ref(false);
+
+                // Group modals state
+                const showTeamModal = ref(false);
+                const showManageTeamModal = ref(false);
+                const showDeleteTeamModal = ref(false);
+                const showSyncSharesModal = ref(false);
+                const showSyncResultsModal = ref(false);
+                const showManageTeamTagsModal = ref(false);
+                const editingTeam = ref(null);
+                const teamToDelete = ref(null);
+                const currentTeam = ref(null);
+                const teamForm = ref({ name: '', description: '' });
+                const teamError = ref('');
+                const teamMembers = ref([]);
+                const teamMemberError = ref('');
+                const newMemberUserId = ref('');
+                const newMemberRole = ref('member');
+                const availableUsers = ref([]);
+                const teamTags = ref([]);
+                const editingTeamTagId = ref(null);
+                const newTeamTag = ref({
+                    name: '',
+                    color: '#3B82F6',
+                    custom_prompt: '',
+                    default_language: '',
+                    default_min_speakers: null,
+                    default_max_speakers: null,
+                    retention_days: null,
+                    protect_from_deletion: false,
+                    auto_share_on_apply: true,
+                    share_with_group_lead: true
+                });
+                const teamTagError = ref('');
+
+                // Folders state
+                const foldersEnabled = ref(false);
+                const showManageTeamFoldersModal = ref(false);
+                const teamFolders = ref([]);
+                const editingTeamFolderId = ref(null);
+                const newTeamFolder = ref({
+                    name: '',
+                    color: '#10B981',
+                    custom_prompt: '',
+                    default_language: '',
+                    default_min_speakers: null,
+                    default_max_speakers: null,
+                    retention_days: null,
+                    protect_from_deletion: false,
+                    auto_share_on_apply: true,
+                    share_with_group_lead: true
+                });
+                const teamFolderError = ref('');
+                const syncResults = ref({ shares_created: 0, recordings_processed: 0 });
+                const users = ref([]);
+                
+                const loadGroups = async () => {
+                    try {
+                        const response = await fetch('/api/admin/groups');
+                        if (!response.ok) throw new Error('Failed to load groups');
+                        const data = await response.json();
+                        groups.value = data.groups || [];
+                    } catch (error) {
+                        console.error('Error loading teams:', error);
+                    }
+                };
+
+                const openCreateTeamModal = () => {
+                    editingTeam.value = null;
+                    teamForm.value = { name: '', description: '' };
+                    teamError.value = '';
+                    showTeamModal.value = true;
+                };
+
+                const openEditTeamModal = (group) => {
+                    editingTeam.value = group;
+                    teamForm.value = { name: group.name, description: group.description || '' };
+                    teamError.value = '';
+                    showTeamModal.value = true;
+                };
+
+                const closeTeamModal = () => {
+                    showTeamModal.value = false;
+                    editingTeam.value = null;
+                    teamForm.value = { name: '', description: '' };
+                    teamError.value = '';
+                };
+
+                const saveTeam = async () => {
+                    teamError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const url = editingTeam.value
+                            ? `/api/admin/groups/${editingTeam.value.id}`
+                            : '/api/admin/groups';
+                        const method = editingTeam.value ? 'PUT' : 'POST';
+
+                        const response = await fetch(url, {
+                            method,
+                            headers,
+                            body: JSON.stringify(teamForm.value)
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to save group');
+                        }
+
+                        closeTeamModal();
+                        await loadGroups();
+                    } catch (error) {
+                        teamError.value = error.message;
+                    }
+                };
+
+                const confirmDeleteTeam = (group) => {
+                    teamToDelete.value = group;
+                    showDeleteTeamModal.value = true;
+                };
+
+                const deleteTeam = async () => {
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${teamToDelete.value.id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to delete group');
+                        }
+
+                        showDeleteTeamModal.value = false;
+                        teamToDelete.value = null;
+                        await loadGroups();
+                    } catch (error) {
+                        alert(error.message);
+                    }
+                };
+
+                const openManageTeamModal = async (group) => {
+                    currentTeam.value = group;
+                    newMemberUserId.value = '';
+                    newMemberRole.value = 'member';
+                    teamMemberError.value = '';
+                    showManageTeamModal.value = true;
+                    await loadTeamMembers(group.id);
+                };
+
+                const closeManageTeamModal = () => {
+                    showManageTeamModal.value = false;
+                    currentTeam.value = null;
+                    teamMembers.value = [];
+                    newMemberUserId.value = '';
+                    newMemberRole.value = 'member';
+                    teamMemberError.value = '';
+                };
+
+                const loadTeamMembers = async (groupId) => {
+                    try {
+                        const response = await fetch(`/api/admin/groups/${groupId}`);
+                        if (!response.ok) throw new Error('Failed to load group members');
+                        const data = await response.json();
+                        teamMembers.value = data.members || [];
+                    } catch (error) {
+                        console.error('Error loading group members:', error);
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const addTeamMember = async () => {
+                    if (!newMemberUserId.value) return;
+
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members`, {
+                            method: 'POST',
+                            headers,
+                            body: JSON.stringify({
+                                user_id: parseInt(newMemberUserId.value),
+                                role: newMemberRole.value
+                            })
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to add member');
+                        }
+
+                        newMemberUserId.value = '';
+                        newMemberRole.value = 'member';
+                        await loadTeamMembers(currentTeam.value.id);
+                        await loadGroups(); // Refresh to update member count
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const updateMemberRole = async (member) => {
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members/${member.user_id}`, {
+                            method: 'PUT',
+                            headers,
+                            body: JSON.stringify({ role: member.role })
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to update role');
+                        }
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                        await loadTeamMembers(currentTeam.value.id); // Reload to revert on error
+                    }
+                };
+
+                const removeTeamMember = async (member) => {
+                    if (!confirm(`Remove ${member.username} from the group?`)) return;
+
+                    teamMemberError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/admin/groups/${currentTeam.value.id}/members/${member.user_id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to remove member');
+                        }
+
+                        await loadTeamMembers(currentTeam.value.id);
+                        await loadGroups(); // Refresh to update member count
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                const syncTeamShares = () => {
+                    if (!currentTeam.value) return;
+                    showSyncSharesModal.value = true;
+                };
+
+                const confirmSyncShares = async () => {
+                    showSyncSharesModal.value = false;
+                    teamMemberError.value = '';
+
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/groups/${currentTeam.value.id}/sync-shares`, {
+                            method: 'POST',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to sync shares');
+                        }
+
+                        const result = await response.json();
+                        syncResults.value = {
+                            shares_created: result.shares_created,
+                            recordings_processed: result.recordings_processed
+                        };
+                        showSyncResultsModal.value = true;
+                    } catch (error) {
+                        teamMemberError.value = error.message;
+                    }
+                };
+
+                // Group Tags Management
+                const openManageTeamTagsModal = async (group) => {
+                    currentTeam.value = group;
+                    teamTagError.value = '';
+                    await loadTeamTags(group.id);
+                    showManageTeamTagsModal.value = true;
+                };
+
+                const closeManageTeamTagsModal = () => {
+                    showManageTeamTagsModal.value = false;
+                    currentTeam.value = null;
+                    teamTags.value = [];
+                    editingTeamTagId.value = null;
+                    newTeamTag.value = {
+                        name: '',
+                        color: '#3B82F6',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamTagError.value = '';
+                };
+
+                const loadTeamTags = async (groupId) => {
+                    try {
+                        const response = await fetch(`/api/groups/${groupId}/tags`);
+                        if (!response.ok) throw new Error('Failed to load group tags');
+                        const data = await response.json();
+                        teamTags.value = data.tags || [];
+                    } catch (error) {
+                        teamTagError.value = error.message;
+                    }
+                };
+
+                const editTeamTag = (tag) => {
+                    editingTeamTagId.value = tag.id;
+                    newTeamTag.value = {
+                        name: tag.name,
+                        color: tag.color,
+                        custom_prompt: tag.custom_prompt || '',
+                        default_language: tag.default_language || '',
+                        default_min_speakers: tag.default_min_speakers,
+                        default_max_speakers: tag.default_max_speakers,
+                        retention_days: tag.retention_days,
+                        protect_from_deletion: tag.protect_from_deletion || false,
+                        auto_share_on_apply: tag.auto_share_on_apply !== undefined ? tag.auto_share_on_apply : true,
+                        share_with_group_lead: tag.share_with_group_lead !== undefined ? tag.share_with_group_lead : true
+                    };
+                    // Scroll to top of modal
+                    document.querySelector('.max-h-\\[90vh\\]')?.scrollTo({ top: 0, behavior: 'smooth' });
+                };
+
+                const cancelEditTeamTag = () => {
+                    editingTeamTagId.value = null;
+                    newTeamTag.value = {
+                        name: '',
+                        color: '#3B82F6',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamTagError.value = '';
+                };
+
+                const saveTeamTag = async () => {
+                    teamTagError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const payload = {
+                            name: newTeamTag.value.name,
+                            color: newTeamTag.value.color,
+                            protect_from_deletion: newTeamTag.value.protect_from_deletion,
+                            auto_share_on_apply: newTeamTag.value.auto_share_on_apply,
+                            share_with_group_lead: newTeamTag.value.share_with_group_lead
+                        };
+
+                        // Add custom prompt if provided
+                        if (newTeamTag.value.custom_prompt && newTeamTag.value.custom_prompt.trim()) {
+                            payload.custom_prompt = newTeamTag.value.custom_prompt.trim();
+                        }
+
+                        // Add language if selected
+                        if (newTeamTag.value.default_language) {
+                            payload.default_language = newTeamTag.value.default_language;
+                        }
+
+                        // Add speaker settings if provided
+                        if (newTeamTag.value.default_min_speakers) {
+                            payload.default_min_speakers = newTeamTag.value.default_min_speakers;
+                        }
+                        if (newTeamTag.value.default_max_speakers) {
+                            payload.default_max_speakers = newTeamTag.value.default_max_speakers;
+                        }
+
+                        // Only include retention_days if it's set and > 0
+                        if (newTeamTag.value.retention_days && newTeamTag.value.retention_days > 0) {
+                            payload.retention_days = newTeamTag.value.retention_days;
+                        }
+
+                        let response;
+                        if (editingTeamTagId.value) {
+                            // Update existing tag
+                            response = await fetch(`/api/tags/${editingTeamTagId.value}`, {
+                                method: 'PUT',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        } else {
+                            // Create new tag
+                            response = await fetch(`/api/groups/${currentTeam.value.id}/tags`, {
+                                method: 'POST',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        }
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || (editingTeamTagId.value ? 'Failed to update tag' : 'Failed to create tag'));
+                        }
+
+                        // Reset form and reload
+                        editingTeamTagId.value = null;
+                        newTeamTag.value = {
+                            name: '',
+                            color: '#3B82F6',
+                            custom_prompt: '',
+                            default_language: '',
+                            default_min_speakers: null,
+                            default_max_speakers: null,
+                            retention_days: null,
+                            protect_from_deletion: false,
+                            auto_share_on_apply: true,
+                            share_with_group_lead: true
+                        };
+                        await loadTeamTags(currentTeam.value.id);
+                    } catch (error) {
+                        teamTagError.value = error.message;
+                    }
+                };
+
+                const deleteTeamTag = async (tag) => {
+                    if (!confirm(`Delete the tag "${tag.name}"? This will remove the tag from all recordings.`)) return;
+
+                    teamTagError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/tags/${tag.id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to delete tag');
+                        }
+
+                        await loadTeamTags(currentTeam.value.id);
+                    } catch (error) {
+                        teamTagError.value = error.message;
+                    }
+                };
+
+                // Group Folders Management
+                const openManageTeamFoldersModal = async (group) => {
+                    currentTeam.value = group;
+                    teamFolderError.value = '';
+                    await loadTeamFolders(group.id);
+                    showManageTeamFoldersModal.value = true;
+                };
+
+                const closeManageTeamFoldersModal = () => {
+                    showManageTeamFoldersModal.value = false;
+                    currentTeam.value = null;
+                    teamFolders.value = [];
+                    editingTeamFolderId.value = null;
+                    newTeamFolder.value = {
+                        name: '',
+                        color: '#10B981',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamFolderError.value = '';
+                };
+
+                const loadTeamFolders = async (groupId) => {
+                    try {
+                        const response = await fetch(`/api/groups/${groupId}/folders`);
+                        if (!response.ok) throw new Error('Failed to load group folders');
+                        const data = await response.json();
+                        teamFolders.value = data.folders || [];
+                    } catch (error) {
+                        teamFolderError.value = error.message;
+                    }
+                };
+
+                const editTeamFolder = (folder) => {
+                    editingTeamFolderId.value = folder.id;
+                    newTeamFolder.value = {
+                        name: folder.name,
+                        color: folder.color || '#10B981',
+                        custom_prompt: folder.custom_prompt || '',
+                        default_language: folder.default_language || '',
+                        default_min_speakers: folder.default_min_speakers,
+                        default_max_speakers: folder.default_max_speakers,
+                        retention_days: folder.retention_days,
+                        protect_from_deletion: folder.protect_from_deletion || false,
+                        auto_share_on_apply: folder.auto_share_on_apply !== undefined ? folder.auto_share_on_apply : true,
+                        share_with_group_lead: folder.share_with_group_lead !== undefined ? folder.share_with_group_lead : true
+                    };
+                    document.querySelector('.max-h-\\[90vh\\]')?.scrollTo({ top: 0, behavior: 'smooth' });
+                };
+
+                const cancelEditTeamFolder = () => {
+                    editingTeamFolderId.value = null;
+                    newTeamFolder.value = {
+                        name: '',
+                        color: '#10B981',
+                        custom_prompt: '',
+                        default_language: '',
+                        default_min_speakers: null,
+                        default_max_speakers: null,
+                        retention_days: null,
+                        protect_from_deletion: false,
+                        auto_share_on_apply: true,
+                        share_with_group_lead: true
+                    };
+                    teamFolderError.value = '';
+                };
+
+                const saveTeamFolder = async () => {
+                    teamFolderError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = { 'Content-Type': 'application/json' };
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const payload = {
+                            name: newTeamFolder.value.name,
+                            color: newTeamFolder.value.color,
+                            protect_from_deletion: newTeamFolder.value.protect_from_deletion,
+                            auto_share_on_apply: newTeamFolder.value.auto_share_on_apply,
+                            share_with_group_lead: newTeamFolder.value.share_with_group_lead
+                        };
+
+                        if (newTeamFolder.value.custom_prompt && newTeamFolder.value.custom_prompt.trim()) {
+                            payload.custom_prompt = newTeamFolder.value.custom_prompt.trim();
+                        }
+                        if (newTeamFolder.value.default_language) {
+                            payload.default_language = newTeamFolder.value.default_language;
+                        }
+                        if (newTeamFolder.value.default_min_speakers) {
+                            payload.default_min_speakers = newTeamFolder.value.default_min_speakers;
+                        }
+                        if (newTeamFolder.value.default_max_speakers) {
+                            payload.default_max_speakers = newTeamFolder.value.default_max_speakers;
+                        }
+                        if (newTeamFolder.value.retention_days && newTeamFolder.value.retention_days > 0) {
+                            payload.retention_days = newTeamFolder.value.retention_days;
+                        }
+
+                        let response;
+                        if (editingTeamFolderId.value) {
+                            response = await fetch(`/api/folders/${editingTeamFolderId.value}`, {
+                                method: 'PUT',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        } else {
+                            response = await fetch(`/api/groups/${currentTeam.value.id}/folders`, {
+                                method: 'POST',
+                                headers,
+                                body: JSON.stringify(payload)
+                            });
+                        }
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || (editingTeamFolderId.value ? 'Failed to update folder' : 'Failed to create folder'));
+                        }
+
+                        editingTeamFolderId.value = null;
+                        newTeamFolder.value = {
+                            name: '',
+                            color: '#10B981',
+                            custom_prompt: '',
+                            default_language: '',
+                            default_min_speakers: null,
+                            default_max_speakers: null,
+                            retention_days: null,
+                            protect_from_deletion: false,
+                            auto_share_on_apply: true,
+                            share_with_group_lead: true
+                        };
+                        await loadTeamFolders(currentTeam.value.id);
+                    } catch (error) {
+                        teamFolderError.value = error.message;
+                    }
+                };
+
+                const deleteTeamFolder = async (folder) => {
+                    if (!confirm(`Delete the folder "${folder.name}"? Recordings will be removed from this folder but not deleted.`)) return;
+
+                    teamFolderError.value = '';
+                    try {
+                        const csrfToken = document.querySelector('meta[name=csrf-token]')?.getAttribute('content');
+                        const headers = {};
+                        if (csrfToken) headers['X-CSRFToken'] = csrfToken;
+
+                        const response = await fetch(`/api/folders/${folder.id}`, {
+                            method: 'DELETE',
+                            headers
+                        });
+
+                        if (!response.ok) {
+                            const error = await response.json();
+                            throw new Error(error.error || 'Failed to delete folder');
+                        }
+
+                        await loadTeamFolders(currentTeam.value.id);
+                    } catch (error) {
+                        teamFolderError.value = error.message;
+                    }
+                };
+
+                const loadFoldersEnabled = async () => {
+                    try {
+                        const response = await fetch('/api/config');
+                        if (response.ok) {
+                            const config = await response.json();
+                            foldersEnabled.value = config.enable_folders === true;
+                        }
+                    } catch (error) {
+                        console.warn('Error loading config:', error);
+                    }
+                };
+
+                const formatFileSize = (bytes) => {
+                    if (!bytes || bytes === 0) return '0 Bytes';
+                    
+                    const k = 1024;
+                    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+                    const i = Math.floor(Math.log(bytes) / Math.log(k));
+                    
+                    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+                };
+                
+                const toggleDarkMode = () => {
+                    isDarkMode.value = !isDarkMode.value;
+                    if (isDarkMode.value) {
+                        document.documentElement.classList.add('dark');
+                        localStorage.setItem('darkMode', 'true');
+                    } else {
+                        document.documentElement.classList.remove('dark');
+                        localStorage.setItem('darkMode', 'false');
+                    }
+                };
+
+                const initializeDarkMode = () => {
+                    const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+                    const savedMode = localStorage.getItem('darkMode');
+                    if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                        isDarkMode.value = true;
+                        document.documentElement.classList.add('dark');
+                    }
+                };
+
+                /**
+                 * Set up global click handler to close dropdowns when clicking outside
+                 * Provides elegant UX by closing menus when users click elsewhere
+                 */
+                const setupGlobalClickHandler = () => {
+                    document.addEventListener('click', (event) => {
+                        const target = event.target;
+
+                        // Close user menu if clicking outside of it
+                        if (isUserMenuOpen.value) {
+                            const userMenuButton = target.closest('[data-user-menu-toggle]');
+                            const userMenuDropdown = target.closest('[data-user-menu-dropdown]');
+
+                            if (!userMenuButton && !userMenuDropdown) {
+                                isUserMenuOpen.value = false;
+                            }
+                        }
+                    });
+                };
+
+                onMounted(async () => {
+                    loadGroups();
+                    loadFoldersEnabled();
+                    initializeDarkMode();
+                    setupGlobalClickHandler();
+                });
+
+                return {
+                    // i18n - bind to i18n instance to maintain context
+                    t: (key, params) => i18nInstance ? i18nInstance.t(key, params) : key,
+
+                    // State
+                    isTeamAdminOnly,
+                    activeTab,
+                    groups,
+                    globalRetentionDays,
+                    isDarkMode,
+                    isUserMenuOpen,
+                    toggleDarkMode,
+                    showTeamModal,
+                    showManageTeamModal,
+                    showDeleteTeamModal,
+                    showSyncSharesModal,
+                    showSyncResultsModal,
+                    showManageTeamTagsModal,
+                    editingTeam,
+                    teamToDelete,
+                    currentTeam,
+                    teamForm,
+                    teamError,
+                    teamMembers,
+                    teamMemberError,
+                    newMemberUserId,
+                    newMemberRole,
+                    availableUsers,
+                    teamTags,
+                    editingTeamTagId,
+                    newTeamTag,
+                    teamTagError,
+                    syncResults,
+                    users,
+                    loadGroups,
+                    openCreateTeamModal,
+                    openEditTeamModal,
+                    closeTeamModal,
+                    saveTeam,
+                    confirmDeleteTeam,
+                    deleteTeam,
+                    openManageTeamModal,
+                    closeManageTeamModal,
+                    loadTeamMembers,
+                    addTeamMember,
+                    updateMemberRole,
+                    removeTeamMember,
+                    syncTeamShares,
+                    confirmSyncShares,
+                    openManageTeamTagsModal,
+                    closeManageTeamTagsModal,
+                    loadTeamTags,
+                    editTeamTag,
+                    cancelEditTeamTag,
+                    saveTeamTag,
+                    deleteTeamTag,
+
+                    // Folders
+                    foldersEnabled,
+                    showManageTeamFoldersModal,
+                    teamFolders,
+                    editingTeamFolderId,
+                    newTeamFolder,
+                    teamFolderError,
+                    openManageTeamFoldersModal,
+                    closeManageTeamFoldersModal,
+                    loadTeamFolders,
+                    editTeamFolder,
+                    cancelEditTeamFolder,
+                    saveTeamFolder,
+                    deleteTeamFolder
+                }
+            },
+            delimiters: ['${', '}'] // Use different delimiters to avoid conflict with Flask's Jinja2
+            }).mount('#app');
+
+            // Hide loading overlay after Vue app is mounted
+            if (window.AppLoader) {
+                window.AppLoader.hide();
+            }
+        }); // End of initializeI18n().then()
+    </script>
+</body>
+</html>
diff --git a/templates/includes/loading_overlay.html b/templates/includes/loading_overlay.html
new file mode 100644
index 00000000..178cb62d
--- /dev/null
+++ b/templates/includes/loading_overlay.html
@@ -0,0 +1,69 @@
+<!-- Loading Overlay - Prevents FOUC -->
+<style>
+    /* Inline critical loading styles for instant rendering */
+    .app-loading-overlay {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: #1a1b26;
+        z-index: 9999;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        transition: opacity 0.3s ease-out;
+    }
+    .app-loading-overlay.fade-out {
+        opacity: 0;
+        pointer-events: none;
+    }
+    .app-loading-content {
+        text-align: center;
+    }
+    .app-loading-spinner {
+        width: 50px;
+        height: 50px;
+        margin: 0 auto 20px;
+        border: 3px solid rgba(255, 255, 255, 0.1);
+        border-top-color: #7aa2f7;
+        border-radius: 50%;
+        animation: spin 1s linear infinite;
+    }
+    .app-loading-text {
+        color: #a0a0b0;
+        font-size: 14px;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        letter-spacing: 0.5px;
+    }
+    @keyframes spin {
+        to { transform: rotate(360deg); }
+    }
+    body.app-loading { overflow: hidden; }
+    body.app-loading > *:not(.app-loading-overlay) { opacity: 0; }
+    body.light .app-loading-overlay { background: #ffffff; }
+    body.light .app-loading-spinner {
+        border-color: rgba(0, 0, 0, 0.1);
+        border-top-color: #3b82f6;
+    }
+    body.light .app-loading-text { color: #6b7280; }
+</style>
+<script>
+    // Immediate loading overlay initialization
+    (function() {
+        function initLoadingOverlay() {
+            if (!document.body) {
+                // Body not ready yet, wait a bit
+                setTimeout(initLoadingOverlay, 10);
+                return;
+            }
+            document.body.classList.add('app-loading');
+            var overlay = document.createElement('div');
+            overlay.className = 'app-loading-overlay';
+            overlay.innerHTML = '<div class="app-loading-content"><div class="app-loading-spinner"></div><div class="app-loading-text">Loading Speakr...</div></div>';
+            document.body.appendChild(overlay);
+        }
+        initLoadingOverlay();
+    })();
+</script>
+<script src="{{ url_for('static', filename='js/loading.js') }}"></script>
\ No newline at end of file
diff --git a/templates/index.html b/templates/index.html
index 8b68cf0c..593e4b59 100644
--- a/templates/index.html
+++ b/templates/index.html
@@ -1,1930 +1,171 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="en" class="h-full">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
-            --bg-audio-player: linear-gradient(to right, #eff6ff, #eef2ff); /* blue-50, indigo-50 */
-
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
-
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-            
-            --scrollbar-track: #f1f1f1;
-            --scrollbar-thumb: #c5c5c5;
-            --scrollbar-thumb-hover: #a8a8a8;
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
-            --bg-audio-player: linear-gradient(to right, #374151, #4b5563); /* gray-700, gray-600 */
-
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
-
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-            
-            --scrollbar-track: #2d3748; /* gray-800 */
-            --scrollbar-thumb: #4a5568; /* gray-600 */
-            --scrollbar-thumb-hover: #718096; /* gray-500 */
-        }
-
-        /* Modern UI styles */
-        .drag-area { transition: background-color 0.3s ease, border-color 0.3s ease; }
-        .custom-scrollbar::-webkit-scrollbar { width: 6px; }
-        .custom-scrollbar::-webkit-scrollbar-track { background: var(--scrollbar-track); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb); border-radius: 12px; }
-        .custom-scrollbar::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); }
-        html { /* Apply base colors to html for smoother transitions */
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-        }
-        html, body { height: 100%; margin: 0; }
-        #app { min-height: 100%; display: flex; flex-direction: column; }
-        main { flex-grow: 1; position: relative; }
-        .progress-popup { position: fixed; bottom: 1rem; left: 1rem; z-index: 100; transition: all 0.3s ease-in-out; min-width: 300px; border-radius: 12px; overflow: hidden; }
-        .progress-popup.minimized { transform: translateY(calc(100% - 45px)); }
-        .progress-list-item { display: grid; grid-template-columns: auto 1fr auto; gap: 0.5rem; align-items: center; }
-         /* Modern style for summary box */
-        .summary-box {
-            background-color: #f9fafb; /* bg-gray-50 */
-            padding: 1rem; /* p-4 */
-            border-radius: 0.75rem; /* rounded-xl */
-            border: 1px solid #e5e7eb; /* border-gray-200 */
-            min-height: 60px; /* min-h-[60px] or adjust as needed */
-            /* max-height removed to allow full height */
-            overflow-y: auto;
-            white-space: pre-wrap;
-            font-family: inherit; /* Use body font */
-            font-size: 0.875rem; /* text-sm */
-            line-height: 1.5; /* Improved line height */
-            box-shadow: 0 1px 2px rgba(0,0,0,0.03); /* Subtle shadow */
-        }
-        
-        /* Standardize border radius for all content boxes */
-        .transcription-box, 
-        .summary-box, 
-        .chat-container,
-        textarea,
-        div[v-if="!editingParticipants"],
-        div[v-if="!editingNotes"] {
-            border-radius: 0.75rem !important; /* rounded-xl */
-        }
-        
-        /* Ensure consistent height for tab content boxes */
-        .tab-content-box {
-            height: 200px !important;
-            overflow-y: auto;
-        }
-        .chat-content-box {
-            height: 650px !important;
-            overflow-y: auto;
-        }
-        .metadata-panel {
-            background-color: var(--bg-tertiary);
-            border: 1px solid var(--border-primary);
-            border-radius: 0.75rem; /* rounded-xl to match others */
-            padding: 1rem; /* p-4 to be consistent */
-            /* margin-top removed to align with other boxes */
-            font-size: 0.875rem; /* text-sm */
-            color: var(--text-secondary);
-        }
-        .metadata-panel dt {
-            font-weight: 500;
-            color: var(--text-primary);
-            margin-bottom: 0.1rem;
-        }
-        .metadata-panel dd {
-            margin-left: 0;
-            margin-bottom: 0.5rem;
-            word-break: break-all; /* Wrap long filenames */
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>Speakr - Audio Transcription & Summarization</title>
+    {% include 'includes/loading_overlay.html' %}
+    <!-- All dependencies bundled locally for offline support -->
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+    <script src="{{ url_for('static', filename='vendor/js/marked.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/easymde.min.css') }}">
+    <script src="{{ url_for('static', filename='vendor/js/easymde.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}">
+    <link rel="icon" type="image/png" sizes="32x32" href="{{ url_for('static', filename='img/icon-32x32.png') }}">
+    <link rel="icon" type="image/png" sizes="16x16" href="{{ url_for('static', filename='img/icon-16x16.png') }}">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ url_for('static', filename='img/icon-180x180.png') }}">
+    <link rel="manifest" href="{{ url_for('static', filename='manifest.json') }}">
+    <meta name="theme-color" content="#2563eb">
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    maxHeight: {
+                        '85vh': '85vh',
+                        '90vh': '90vh'
+                    },
+                    colors: {
+                        primary: 'var(--bg-primary)',
+                        secondary: 'var(--bg-secondary)',
+                        accent: 'var(--bg-accent)'
+                    }
+                }
+            }
         }
-         .status-badge {
-             display: inline-block;
-             padding: 0.15rem 0.6rem; /* Smaller padding */
-             font-size: 0.65rem; /* Smaller text */
-             font-weight: 500; /* font-medium */
-             border-radius: 9999px; /* rounded-full */
-             /* margin-top: 0.5rem; /* mt-2 */ /* Removed margin-top */
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             letter-spacing: 0.025em;
-             vertical-align: middle; /* Align with text */
-             margin-left: 0.75rem; /* Add some space */
-         }
-         .status-processing { color: #1d4ed8; background-color: #dbeafe; } /* text-blue-800 bg-blue-100 */
-         .status-summarizing { color: #92400e; background-color: #fef3c7; } /* text-amber-800 bg-amber-100 */
-         .status-completed { color: #065f46; background-color: #d1fae5; } /* text-green-800 bg-green-100 */
-         .status-failed { color: #991b1b; background-color: #fee2e2; } /* text-red-800 bg-red-100 */
-         .status-pending { color: #57534e; background-color: #f5f5f4; } /* text-stone-700 bg-stone-100 */
-         
-         /* Fixed height transcription box */
-         .transcription-box {
-             height: 400px;
-             overflow-y: auto;
-             position: relative;
-         }
-         
-         /* Modern copy button styles */
-         .copy-btn {
-             position: sticky;
-             top: 10px;
-             right: 10px;
-             float: right;
-             background-color: rgba(255, 255, 255, 0.9);
-             border: 1px solid #e5e7eb;
-             border-radius: 0.5rem;
-             padding: 0.35rem 0.75rem;
-             font-size: 0.75rem;
-             cursor: pointer;
-             z-index: 10;
-             transition: all 0.2s cubic-bezier(0.25, 0.1, 0.25, 1);
-             margin-bottom: 10px;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-         }
-         
-         .copy-btn:hover {
-             background-color: #f3f4f6;
-             transform: translateY(-1px);
-             box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-         }
-         
-         /* Hover edit button styles */
-         .content-box {
-             position: relative;
-         }
-         
-         .hover-edit-btn {
-             position: absolute;
-             top: 10px;
-             right: 10px;
-             background-color: rgba(255, 255, 255, 0.9);
-             border: 1px solid #e5e7eb;
-             border-radius: 0.5rem;
-             padding: 0.35rem 0.75rem;
-             font-size: 0.75rem;
-             cursor: pointer;
-             z-index: 10;
-             transition: all 0.2s ease;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             opacity: 0;
-         }
-         
-         .content-box:hover .hover-edit-btn {
-             opacity: 1;
-         }
-         
-         .hover-edit-btn:hover {
-             background-color: #f3f4f6;
-             transform: translateY(-1px);
-             box-shadow: 0 2px 4px rgba(0,0,0,0.1);
-         }
-         
-         .dark .hover-edit-btn {
-             background-color: rgba(55, 65, 81, 0.9);
-             border-color: #4b5563;
-         }
-         
-         .dark .hover-edit-btn:hover {
-             background-color: #4b5563;
-         }
-         
-         /* Modern chat section styles */
-         .chat-container {
-             border: 1px solid #e5e7eb;
-             border-radius: 0.75rem;
-             display: flex;
-             flex-direction: column;
-             height: 100%;
-             box-shadow: 0 1px 3px rgba(0,0,0,0.05);
-             overflow: hidden;
-         }
-         
-         .chat-messages {
-             flex-grow: 1;
-             overflow-y: auto;
-             padding: 1.25rem;
-         }
-         
-         .chat-input-container {
-             border-top: 1px solid #e5e7eb;
-             padding: 0.75rem;
-             display: flex;
-             background-color: var(--bg-tertiary);
-         }
-         
-         .message {
-             margin-bottom: 1.25rem;
-             max-width: 80%;
-             box-shadow: 0 1px 2px rgba(0,0,0,0.05);
-             line-height: 1.5;
-         }
-         
-         .user-message {
-             background-color: #dbeafe;
-             border-radius: 1.25rem 1.25rem 0.25rem 1.25rem;
-             padding: 0.875rem 1rem;
-             margin-left: auto;
-         }
-         
-         .ai-message {
-             background-color: #f3f4f6;
-             border-radius: 1.25rem 1.25rem 1.25rem 0.25rem;
-             padding: 0.875rem 1rem;
-         }
-         
-         .copyable {
-             position: relative;
-         }
-         
-         /* Markdown styling */
-         .ai-message h1, .ai-message h2, .ai-message h3, 
-         .summary-box h1, .summary-box h2, .summary-box h3 {
-             font-weight: 600;
-             margin-top: 1rem;
-             margin-bottom: 0.5rem;
-         }
-         
-         .ai-message h1, .summary-box h1 { font-size: 1.25rem; }
-         .ai-message h2, .summary-box h2 { font-size: 1.15rem; }
-         .ai-message h3, .summary-box h3 { font-size: 1.05rem; }
-         
-         .ai-message p, .summary-box p {
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message ul, .ai-message ol,
-         .summary-box ul, .summary-box ol {
-             margin-left: 1.5rem;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message ul, .summary-box ul { list-style-type: disc; }
-         .ai-message ol, .summary-box ol { list-style-type: decimal; }
-         
-         .ai-message code, .summary-box code {
-             background-color: #f1f1f1;
-             padding: 0.1rem 0.3rem;
-             border-radius: 0.25rem;
-             font-family: monospace;
-             font-size: 0.9em;
-         }
-         
-         .ai-message pre, .summary-box pre {
-             background-color: #f1f1f1;
-             padding: 0.75rem;
-             border-radius: 0.25rem;
-             overflow-x: auto;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message pre code, .summary-box pre code {
-             background-color: transparent;
-             padding: 0;
-             border-radius: 0;
-         }
-         
-         .ai-message table, .summary-box table {
-             border-collapse: collapse;
-             width: 100%;
-             margin-bottom: 0.75rem;
-         }
-         
-         .ai-message th, .ai-message td,
-         .summary-box th, .summary-box td {
-             border: 1px solid #ddd;
-             padding: 0.5rem;
-             text-align: left;
-         }
-         
-         .ai-message th, .summary-box th {
-             background-color: #f1f1f1;
-             font-weight: 600;
-         }
-         
-         .ai-message blockquote, .summary-box blockquote {
-             border-left: 4px solid #ddd;
-             padding-left: 1rem;
-             margin-left: 0;
-             margin-bottom: 0.75rem;
-             color: #666;
-         }
-         
-         /* Modern toast notification styles */
-         .toast-container {
-             position: fixed;
-             bottom: 20px;
-             right: 20px;
-             z-index: 1000;
-             display: flex;
-             flex-direction: column;
-             align-items: flex-end;
-             gap: 12px;
-         }
-         
-         .toast {
-             padding: 12px 18px;
-             border-radius: 8px;
-             background-color: #4CAF50;
-             color: white;
-             font-size: 14px;
-             box-shadow: 0 4px 12px rgba(0,0,0,0.1);
-             opacity: 0;
-             transform: translateY(20px);
-             transition: all 0.3s cubic-bezier(0.25, 0.1, 0.25, 1);
-             display: flex;
-             align-items: center;
-             min-width: 200px;
-         }
-         
-         .toast.show {
-             opacity: 1;
-             transform: translateY(0);
-         }
-         
-         .toast i {
-             margin-right: 8px;
-         }
-         
-         /* Copy button animation */
-         @keyframes copy-success {
-             0% { transform: scale(1); }
-             50% { transform: scale(1.2); }
-             100% { transform: scale(1); }
-         }
-         
-         .copy-success {
-             animation: copy-success 0.3s ease;
-             color: #4CAF50 !important;
-         }
-
-    </style>
+    </script>
 </head>
-<body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
-    <div id="app" class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col">
-        <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
-             <h1 class="text-3xl font-bold text-[var(--text-primary)] cursor-pointer" @click="switchToGalleryView" title="Go to Gallery">
-                Speakr
-            </h1>
-            <div class="flex items-center space-x-2">
-                 <button @click="toggleDarkMode" class="p-2 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isDarkMode ? 'Switch to Light Mode' : 'Switch to Dark Mode'">
-                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
-                </button>
-                {% if current_user.is_authenticated %}
-                <button @click="switchToUploadView" class="px-4 py-2 mr-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                    <i class="fas fa-plus mr-1"></i> New Recording
-                </button>
-                <button
-                    @click="switchToGalleryView"
-                    :class="{
-                        'bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)]': currentView !== 'gallery',
-                        'bg-[var(--bg-accent)] text-[var(--text-accent)] border border-[var(--border-accent)]': currentView === 'gallery'
-                    }"
-                    class="px-4 py-2 rounded-lg shadow-sm hover:bg-[var(--bg-tertiary)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-1 transition duration-150 ease-in-out">
-                    <i class="fas fa-images mr-1"></i> Gallery
-                </button>
-                <!-- User dropdown menu -->
-                <div class="relative ml-2">
-                    <button @click="isUserMenuOpen = !isUserMenuOpen" class="flex items-center px-3 py-2 border border-[var(--border-secondary)] rounded-lg text-[var(--text-secondary)] hover:text-[var(--text-accent)] focus:outline-none">
-                        <i class="fas fa-user mr-2"></i>
-                        <span>{{ current_user.username }}</span>
-                        <i class="fas fa-chevron-down ml-2"></i>
-                    </button>
-                    <div v-if="isUserMenuOpen" class="absolute right-0 mt-2 w-48 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-10">
-                        <a href="{{ url_for('account') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-circle mr-2"></i> Account
-                        </a>
-                        {% if current_user.is_admin %}
-                        <a href="{{ url_for('admin') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-accent)]">
-                            <i class="fas fa-user-shield mr-2"></i> Admin
-                        </a>
-                        {% endif %}
-                        <a href="{{ url_for('logout') }}" class="block px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-danger)]">
-                            <i class="fas fa-sign-out-alt mr-2"></i> Logout
-                        </a>
-                    </div>
-                </div>
-                {% else %}
-                <a href="{{ url_for('login') }}" class="px-4 py-2 ml-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                    <i class="fas fa-sign-in-alt mr-1"></i> Login
-                </a>
-                <a href="{{ url_for('register') }}" class="px-4 py-2 ml-2 text-[var(--text-secondary)] hover:text-[var(--text-accent)] border border-[var(--border-secondary)] rounded-lg">
-                    <i class="fas fa-user-plus mr-1"></i> Register
-                </a>
-                {% endif %}
-            </div>
-        </header>
-
-        <div v-if="globalError" class="mb-4 p-4 bg-[var(--bg-danger-light)] border border-[var(--border-danger)] text-[var(--text-danger-strong)] rounded-lg" role="alert">
-             <div class="flex justify-between items-center">
-                <div>
-                    <strong class="font-bold">Error:</strong>
-                    <span class="block sm:inline ml-2">${ globalError }</span>
-                </div>
-                <button @click="globalError = null" class="text-[var(--text-danger-strong)] hover:text-[var(--text-danger)] font-bold">&times;</button>
-            </div>
-        </div>
-
-        <!-- Sidebar toggle button will be positioned relative to the main container -->
-
-        <main class="flex-grow"
-             @dragover.prevent="dragover = true"
-             @dragleave.prevent="handleDragLeave"
-             @drop.prevent="handleDrop">
-
-            <div v-if="dragover" class="absolute inset-0 flex items-center justify-center bg-[var(--border-focus)]/20 z-10 rounded-lg pointer-events-none border-4 border-dashed border-[var(--border-focus)]">
-                <div class="text-center p-6 bg-[var(--bg-secondary)] rounded-lg shadow-xl">
-                    <i class="fas fa-upload text-4xl text-[var(--text-accent)] mb-3"></i>
-                    <p class="text-xl font-semibold text-[var(--text-secondary)]">Drop audio file(s) here to upload</p>
-                </div>
+<body class="h-full bg-[var(--bg-primary)] text-[var(--text-primary)] transition-colors duration-300">
+    <div id="loader" class="fixed inset-0 bg-gray-800 flex items-center justify-center z-50">
+        <div class="text-white text-lg">Loading...</div>
+    </div>
+    <div id="app" v-cloak
+         data-use-asr-endpoint="{{ use_asr_endpoint }}"
+         data-connector-supports-diarization="{{ connector_supports_diarization }}"
+         data-connector-supports-speaker-count="{{ connector_supports_speaker_count }}"
+         data-connector-supports-hotwords="{{ connector_supports_hotwords }}"
+         data-connector-supports-initial-prompt="{{ connector_supports_initial_prompt }}"
+         data-enable-archive-toggle="{{ enable_archive_toggle }}"
+         data-enable-internal-sharing="{{ enable_internal_sharing }}"
+         data-current-user-name="{{ (current_user.name or current_user.username) if current_user.is_authenticated else '' }}"
+         data-user-language="{{ user_language }}"
+         data-show-timestamps-simple-view="{{ 'True' if (current_user.is_authenticated and current_user.show_timestamps_simple_view) else 'False' }}"
+         data-editor-autosave="{{ 'True' if (current_user.is_authenticated and current_user.editor_autosave) else 'False' }}"
+         class="h-full flex flex-col opacity-0 transition-opacity duration-500">
+
+        <!-- Header -->
+        {% include 'components/header.html' %}
+
+        <div class="flex-1 flex overflow-hidden relative">
+            <!-- Mobile Sidebar Backdrop -->
+            <div v-if="!isSidebarCollapsed && isMobileScreen"
+                 @click="toggleSidebar"
+                 class="fixed inset-0 bg-black bg-opacity-50 z-40 lg:hidden">
             </div>
 
-            {% if current_user.is_authenticated %}
-            <div v-if="currentView === 'gallery'" class="flex-grow flex flex-col rounded-lg relative">
-                <!-- Sidebar toggle button that appears when sidebar is collapsed - positioned at the left edge of main content, aligned with title -->
-                <button v-if="isSidebarCollapsed" 
-                        @click="toggleSidebar" 
-                        class="absolute -left-3 top-6 z-20 bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-secondary)] p-2 pl-1 pr-3 rounded-r-lg shadow-lg text-[var(--text-accent)] hover:text-[var(--text-primary)] hover:shadow-xl transition-all duration-300 transform hover:translate-x-1 border-r border-t border-b border-[var(--border-accent)]"
-                        title="Show Sidebar">
-                    <i class="fas fa-chevron-right"></i>
-                </button>
-                
-                <div class="grid grid-cols-1 lg:grid-cols-4 gap-6 flex-grow">
-                    <div v-show="!isSidebarCollapsed" class="lg:col-span-1 bg-[var(--bg-secondary)] p-4 rounded-lg shadow-md flex flex-col relative">
-                         <div class="flex justify-between items-center mb-4 sticky top-0 bg-[var(--bg-secondary)] pb-3 border-b border-[var(--border-primary)]">
-                            <h3 class="text-lg font-semibold text-[var(--text-primary)]">Recordings</h3>
-                            <button @click="toggleSidebar" class="p-1 rounded-full text-[var(--text-muted)] hover:bg-[var(--bg-tertiary)] dark:text-gray-400 dark:hover:bg-gray-700 transition-colors duration-200" :title="isSidebarCollapsed ? 'Show Sidebar' : 'Hide Sidebar'">
-                                <i class="fas fa-chevron-left"></i>
-                             </button>
-                        </div>
-                         <div v-if="isLoadingRecordings" class="text-center text-[var(--text-muted)] py-4">
-                            <i class="fas fa-spinner fa-spin mr-2"></i> Loading recordings...
-                        </div>
-                        <div v-else-if="recordings.length === 0 && uploadQueue.length === 0" class="text-center text-[var(--text-muted)] py-4 flex-grow flex flex-col items-center justify-center">
-                             <i class="fas fa-folder-open text-4xl text-[var(--text-light)] mb-3"></i>
-                            <p>No recordings yet.</p>
-                            <p>Upload one or drag & drop anywhere!</p>
-                        </div>
-                        <div v-else class="space-y-4 overflow-y-auto custom-scrollbar flex-grow pr-1">
-                            <div v-for="group in groupedRecordings" :key="group.title" class="mb-3">
-                                <h4 class="font-medium text-[var(--text-muted)] text-xs uppercase tracking-wider mb-2 sticky top-0 bg-[var(--bg-secondary)] py-1">${ group.title }</h4>
-                                <ul class="space-y-1">
-                                    <li v-for="recording in group.items"
-                                        :key="recording.id"
-                                        @click="selectRecording(recording)"
-                                        class="cursor-pointer p-3 rounded-md flex justify-between items-center transition duration-150 ease-in-out"
-                                        :class="{
-                                            'bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] ring-1 ring-[var(--border-accent)] text-[var(--text-accent)]': selectedRecording?.id === recording.id,
-                                            'hover:bg-[var(--bg-tertiary)] text-[var(--text-primary)]': selectedRecording?.id !== recording.id
-                                        }">
-                                         <div class="flex items-center overflow-hidden mr-2">
-                                            <i class="fas fa-file-audio text-[var(--text-accent)] mr-2 flex-shrink-0"></i>
-                                            <span class="text-sm font-medium truncate" :title="recording.title || 'Loading title...'">${ recording.title || '(Processing...)' }</span>
-                                        </div>
-                                        <div class="flex space-x-2 flex-shrink-0 items-center">
-                                            <span v-if="recording.status === 'PROCESSING'" class="text-xs text-[var(--text-info-strong)] italic flex items-center" title="Transcribing...">
-                                                 <i class="fas fa-spinner fa-spin mr-1"></i> Transcribing
-                                            </span>
-                                             <span v-else-if="recording.status === 'SUMMARIZING'" class="text-xs text-[var(--text-warn-strong)] italic flex items-center" title="Generating Summary...">
-                                                <i class="fas fa-spinner fa-spin mr-1"></i> Summarizing
-                                            </span>
-                                            <span v-else-if="recording.status === 'PENDING'" class="text-xs text-[var(--text-pending-strong)] italic flex items-center" title="Waiting...">
-                                                <i class="fas fa-clock mr-1"></i> Pending
-                                            </span>
-                                            <span v-else-if="recording.status === 'FAILED'" class="text-xs text-[var(--text-danger-strong)] italic flex items-center" title="Processing Failed">
-                                                <i class="fas fa-exclamation-triangle mr-1"></i> Failed
-                                            </span>
-                                            <span v-else-if="recording.status === 'COMPLETED'" class="text-xs text-[var(--text-success-strong)]" title="Completed">
-                                                <i class="fas fa-check-circle"></i>
-                                            </span>
-                                             <button @click.stop="editRecording(recording)" class="text-[var(--text-muted)] hover:text-[var(--text-accent)] text-xs p-1 rounded hover:bg-[var(--bg-tertiary)]" title="Edit Details">
-                                                <i class="fas fa-edit"></i>
-                                            </button>
-                                            <button @click.stop="confirmDelete(recording)" class="text-[var(--text-muted)] hover:text-[var(--text-danger)] text-xs p-1 rounded hover:bg-[var(--bg-tertiary)]" title="Delete Recording">
-                                                <i class="fas fa-trash"></i>
-                                            </button>
-                                        </div>
-                                    </li>
-                                </ul>
-                            </div>
-                        </div>
-                    </div>
-
-                     <div :class="isSidebarCollapsed ? 'lg:col-span-4' : 'lg:col-span-3'" class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-md flex flex-col">
-                        <div v-if="selectedRecording" class="flex-grow flex flex-col">
-                            <div class="flex flex-col sm:flex-row justify-between items-start mb-4 border-b border-[var(--border-primary)] pb-4">
-                                <div class="mb-3 sm:mb-0 max-w-lg">
-                                     <h3 class="text-2xl font-semibold text-[var(--text-primary)]">${ selectedRecording.title || 'Loading...' }</h3>
-                                    <p class="text-sm text-[var(--text-muted)] mt-1">
-                                        <!-- Display Meeting Date with edit functionality -->
-                                        <span>
-                                            <i class="fas fa-calendar-alt mr-1"></i> 
-                                            <span v-if="!editingMeetingDate">
-                                                Meeting Date: 
-                                                <span @click="toggleEditMeetingDate" class="cursor-pointer hover:text-[var(--text-accent)]">
-                                                    ${ selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'Click to add' }
-                                                </span> | 
-                                            </span>
-                                            <span v-else class="inline-flex items-center">
-                                                <input type="date" v-model="selectedRecording.meeting_date" 
-                                                    @blur="saveInlineEdit('meeting_date')" 
-                                                    class="p-0 w-40 bg-transparent border-b border-[var(--border-secondary)] focus:outline-none focus:border-[var(--border-focus)]" />
-                                                <button @click="saveInlineEdit('meeting_date')" class="ml-1 text-xs text-[var(--text-accent)]">
-                                                    <i class="fas fa-check"></i>
-                                                </button>
-                                            </span>
-                                        </span>
-                                        Created: ${ new Date(selectedRecording.created_at).toLocaleString() }
-                                        <!-- Status Badge Moved Here -->
-                                        <span :class="getStatusClass(selectedRecording.status)" class="status-badge">
-                                            ${ formatStatus(selectedRecording.status) }
-                                        </span>
-                                    </p>
-                                    <!-- Removed Size from here -->
-                                    <!-- Removed separate Status Badge span -->
-                                </div>
-                                <div class="flex space-x-2 flex-shrink-0">
-                                    <button @click="editRecording(selectedRecording)" class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] text-sm shadow-sm">
-                                        <i class="fas fa-edit mr-1"></i> Edit Details
-                                    </button>
-                                    <button @click="confirmDelete(selectedRecording)" class="px-3 py-1.5 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)] text-sm shadow-sm">
-                                        <i class="fas fa-trash mr-1"></i> Delete
-                                    </button>
-                                </div>
-                            </div>
+            <!-- Sidebar -->
+            {% include 'components/sidebar.html' %}
 
-                            <!-- Adjusted Grid: md:grid-cols-5 -> Transcription (2), Right Panel (3) -->
-                            <div class="grid md:grid-cols-5 gap-6 flex-grow overflow-hidden">
-                                <!-- Left Column: Participants, Transcription, Summary & Notes -->
-                                <div class="md:col-span-2 flex flex-col overflow-hidden space-y-4">
-                                    <div>
-                                        <div class="flex justify-between items-center mb-1">
-                                            <h4 class="font-semibold text-[var(--text-secondary)]">Participants</h4>
-                                            <button @click="toggleEditParticipants" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-accent)] p-1 rounded">
-                                                <i class="fas" :class="editingParticipants ? 'fa-check' : 'fa-edit'"></i>
-                                            </button>
-                                        </div>
-                                        <div v-if="!editingParticipants" class="text-sm bg-[var(--bg-tertiary)] p-3 rounded-xl border border-[var(--border-primary)] min-h-[40px] text-[var(--text-secondary)]">${ selectedRecording.participants || 'None specified' }</div>
-                                        <textarea v-else v-model="selectedRecording.participants" @blur="saveInlineEdit('participants')" class="text-sm bg-[var(--bg-tertiary)] p-3 rounded border border-[var(--border-primary)] min-h-[40px] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] text-[var(--text-secondary)]" placeholder="Enter participants"></textarea>
-                                    </div>
-                                    <div>
-                                        <div class="flex justify-between items-center mb-1">
-                                            <h4 class="font-semibold text-[var(--text-secondary)]">Transcription</h4>
-                                            <button @click="copyTranscription($event)" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-accent)] p-1 rounded" title="Copy to clipboard">
-                                                <i class="fas fa-copy"></i>
-                                            </button>
-                                        </div>
-                                        <div class="transcription-box p-4 bg-[var(--bg-tertiary)] rounded border border-[var(--border-primary)] text-sm custom-scrollbar relative text-[var(--text-secondary)]">
-                                            <div v-if="selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'SUMMARIZING'" class="copyable">
-                                                <pre class="whitespace-pre-wrap font-sans">${ selectedRecording.transcription || 'No transcription available.' }</pre>
-                                            </div>
-                                            <div v-else-if="selectedRecording.status === 'FAILED'" class="text-[var(--text-danger)]">
-                                                <p class="font-medium mb-2">Processing Failed:</p>
-                                                <pre class="whitespace-pre-wrap font-sans">${ selectedRecording.transcription || 'An unknown error occurred.' }</pre>
-                                            </div>
-                                            <div v-else class="flex items-center justify-center text-[var(--text-muted)] h-full">
-                                                <i class="fas fa-spinner fa-spin mr-2"></i> Transcription in progress...
-                                            </div>
-                                        </div>
-                                    </div>
-                                    
-                                    <!-- Tabs for Summary and Notes (Moved from right column) -->
-                                    <div class="flex flex-col overflow-hidden">
-                                        <div class="border-b border-[var(--border-primary)]">
-                                            <nav class="-mb-px flex space-x-4" aria-label="Tabs">
-                                                <button @click="selectedTab = 'summary'" 
-                                                        :class="selectedTab === 'summary' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Summary
-                                                </button>
-                                                <button @click="selectedTab = 'notes'" 
-                                                        :class="selectedTab === 'notes' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Notes
-                                                </button>
-                                                <button @click="selectedTab = 'metadata'" 
-                                                        :class="selectedTab === 'metadata' ? 'border-[var(--border-focus)] text-[var(--text-accent)]' : 'border-transparent text-[var(--text-muted)] hover:text-[var(--text-secondary)] hover:border-[var(--border-secondary)]'"
-                                                        class="whitespace-nowrap py-3 px-1 border-b-2 font-medium text-sm">
-                                                    Metadata
-                                                </button>
-                                            </nav>
-                                        </div>
-                                        <div class="pt-4">
-                                            <!-- Summary Panel -->
-                                            <div v-show="selectedTab === 'summary'" class="overflow-hidden">
-                                                <div v-if="selectedRecording.status === 'COMPLETED'">
-                                                    <div v-if="!editingSummary" class="content-box">
-                                                        <div class="summary-box custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] text-[var(--text-secondary)] tab-content-box" v-html="selectedRecording.summary_html || selectedRecording.summary || 'No summary generated.'">
-                                                        </div>
-                                                        <button @click="toggleEditSummary" class="hover-edit-btn text-[var(--text-muted)] hover:text-[var(--text-accent)]" title="Edit Summary">
-                                                            <i class="fas fa-edit"></i>
-                                                        </button>
-                                                    </div>
-                                                    <textarea v-else v-model="selectedRecording.summary" @blur="saveInlineEdit('summary')" class="summary-box custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] text-[var(--text-secondary)] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] tab-content-box" placeholder="Enter summary"></textarea>
-                                                </div>
-                                                <div v-else-if="selectedRecording.status === 'FAILED'" class="summary-box text-[var(--text-danger)] custom-scrollbar bg-[var(--bg-tertiary)] border-[var(--border-primary)] tab-content-box" v-html="selectedRecording.summary_html || selectedRecording.summary || 'Summary generation failed or was skipped.'">
-                                                </div>
-                                                <div v-else class="h-24 flex items-center justify-center p-4 bg-[var(--bg-tertiary)] rounded border border-[var(--border-primary)] text-[var(--text-muted)]">
-                                                    <i class="fas fa-spinner fa-spin mr-2"></i> Summary pending...
-                                                </div>
-                                                
-                                            </div>
-                                            
-                                            <!-- Notes Panel -->
-                                            <div v-show="selectedTab === 'notes'" class="overflow-hidden">
-                                                <div v-if="!editingNotes" class="content-box">
-                                                    <div class="text-sm bg-[var(--bg-tertiary)] p-4 rounded-xl border border-[var(--border-primary)] custom-scrollbar text-[var(--text-secondary)] tab-content-box" v-html="selectedRecording.notes_html || selectedRecording.notes || 'No notes'"></div>
-                                                    <button @click="toggleEditNotes" class="hover-edit-btn text-[var(--text-muted)] hover:text-[var(--text-accent)]" title="Edit Notes">
-                                                        <i class="fas fa-edit"></i>
-                                                    </button>
-                                                </div>
-                                                <textarea v-else v-model="selectedRecording.notes" @blur="saveInlineEdit('notes')" class="text-sm bg-[var(--bg-tertiary)] p-4 rounded border border-[var(--border-primary)] custom-scrollbar text-[var(--text-secondary)] w-full focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] tab-content-box" placeholder="Enter notes"></textarea>
-                                            </div>
-                                            
-                                            <!-- Metadata Panel (in separate tab) -->
-                                            <div v-show="selectedTab === 'metadata'" class="overflow-hidden">
-                                                <div class="metadata-panel custom-scrollbar tab-content-box">
-                                                    <dl>
-                                                        <div v-if="selectedRecording.original_filename">
-                                                            <dt>Original Filename</dt>
-                                                            <dd>${ selectedRecording.original_filename }</dd>
-                                                        </div>
-                                                        <div>
-                                                            <dt>File Size</dt>
-                                                            <dd>${ formatFileSize(selectedRecording.file_size) }</dd>
-                                                        </div>
-                                                    </dl>
-                                                </div>
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
+            <!-- Main Content Area -->
+            <main :class="['flex-1 flex flex-col overflow-hidden main-content', !isSidebarCollapsed && !isMobileScreen ? 'sidebar-open' : '']">
+                <!-- Custom Banner -->
+                {% include 'components/banner.html' %}
+                <!-- Upload View -->
+                {% include 'components/upload-view.html' %}
 
-                                <!-- Right Column: Audio & Chat -->
-                                <div class="md:col-span-3 flex flex-col space-y-4 overflow-hidden">
-                                    <div>
-                                        <h4 class="font-semibold text-[var(--text-secondary)] mb-2">Audio Player</h4>
-                                        <!-- Beautified audio player container -->
-                                        <div class="bg-[var(--bg-audio-player)] p-3 rounded-lg shadow border border-[var(--border-primary)]">
-                                            <audio controls class="w-full h-10" :key="selectedRecording.id" :src="'/audio/' + selectedRecording.id">
-                                                Your browser does not support the audio element.
-                                            </audio>
-                                        </div>
-                                    </div>
+                <!-- Recording View -->
+                {% include 'components/recording-view.html' %}
 
-                                    <!-- Chat Section (Fixed height to match left column) -->
-                                    <div class="flex flex-col overflow-hidden">
-                                        <h4 class="font-semibold text-[var(--text-secondary)] mb-2 flex-shrink-0">Chat with Transcript</h4>
-                                        <!-- Chat container with fixed height matching left column -->
-                                        <div class="chat-container border-[var(--border-primary)] bg-[var(--bg-secondary)] chat-content-box"> 
-                                            <div class="chat-messages custom-scrollbar" ref="chatMessagesRef">
-                                                <div v-if="chatMessages.length === 0" class="flex items-center justify-center h-full text-[var(--text-muted)]">
-                                                    <div class="text-center">
-                                                        <i class="fas fa-comments text-2xl mb-2"></i>
-                                                        <p>Ask questions about the transcript</p>
-                                                    </div>
-                                                </div>
-                                                <div v-for="(message, index) in chatMessages" :key="index" class="message" :class="message.role === 'user' ? 'user-message bg-[var(--bg-accent)] text-[var(--text-accent)]' : 'ai-message bg-[var(--bg-tertiary)] text-[var(--text-secondary)]'">
-                                                    <div class="flex justify-between items-start">
-                                                        <div class="flex-grow" v-if="message.role === 'user'">${ message.content }</div>
-                                                        <div class="flex-grow" v-else v-html="message.html || message.content"></div>
-                                                        <button v-if="message.role === 'assistant'" @click="copyMessage(message.content, $event)" class="ml-2 text-[var(--text-light)] hover:text-[var(--text-muted)]" title="Copy response">
-                                                            <i class="fas fa-copy text-xs"></i>
-                                                        </button>
-                                                    </div>
-                                                </div>
-                                                <div v-if="isChatLoading" class="message ai-message bg-[var(--bg-tertiary)] text-[var(--text-secondary)]">
-                                                    <div class="flex items-center">
-                                                        <i class="fas fa-spinner fa-spin mr-2"></i> Thinking...
-                                                    </div>
-                                                </div>
-                                            </div>
-                                            <div class="chat-input-container border-t-[var(--border-primary)]">
-                                                <input 
-                                                    v-model="chatInput" 
-                                                    @keyup.enter="sendChatMessage"
-                                                    type="text" 
-                                                    placeholder="Ask about the transcript..." 
-                                                    class="flex-grow px-3 py-2 border-0 focus:ring-0 focus:outline-none bg-[var(--bg-input)] text-[var(--text-primary)] placeholder-[var(--text-muted)]"
-                                                    :disabled="isChatLoading || !selectedRecording || selectedRecording.status !== 'COMPLETED'"
-                                                >
-                                                <button 
-                                                    @click="sendChatMessage" 
-                                                    class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed"
-                                                    :disabled="!chatInput.trim() || isChatLoading || !selectedRecording || selectedRecording.status !== 'COMPLETED'"
-                                                >
-                                                    <i class="fas fa-paper-plane"></i>
-                                                </button>
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                        <div v-else class="flex flex-col items-center justify-center text-center text-[var(--text-muted)] flex-grow">
-                             <i class="fas fa-hand-pointer text-4xl text-[var(--text-light)] mb-4"></i>
-                            <p class="text-lg font-medium mb-2">Select a recording from the list to view details.</p>
-                            <p>Or, drag and drop audio file(s) anywhere on this page to upload.</p>
-                        </div>
-                    </div>
-                </div>
-            </div>
-
-             <div v-if="currentView === 'upload'"
-                 class="flex-grow flex items-center justify-center p-4">
-                 <div class="w-full max-w-lg bg-[var(--bg-secondary)] p-8 rounded-xl shadow-lg border border-[var(--border-primary)] text-center drag-area"
-                     :class="{'border-[var(--border-focus)] bg-[var(--bg-accent)]': dragover}">
-                    <div class="py-8">
-                        <i class="fas fa-cloud-upload-alt text-5xl mb-5 text-[var(--text-accent)]"></i>
-                         <h2 class="text-xl font-semibold text-[var(--text-secondary)] mb-2">Upload New Recordings</h2>
-                        <p class="text-[var(--text-muted)] mb-4">Drag & drop your audio files here or click below.</p>
-                         <input type="file" @change="handleFileSelect" accept="audio/*" class="hidden" ref="fileInput" multiple>
-                        <button @click="$refs.fileInput.click()" class="mt-4 px-6 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] shadow-sm transition duration-150 ease-in-out">
-                            <i class="fas fa-file-import mr-2"></i> Select Files
-                        </button>
-                         <p class="text-xs text-[var(--text-light)] mt-4">Max file size per file: ${ maxFileSizeMB } MB</p>
-                    </div>
-                </div>
-            </div>
-
-            {% else %}
-            <div class="flex-grow flex items-center justify-center">
-                <div class="text-center max-w-lg p-8 bg-[var(--bg-secondary)] rounded-xl shadow-lg border border-[var(--border-primary)]">
-                    <i class="fas fa-lock text-5xl mb-4 text-[var(--text-accent)]"></i>
-                    <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-4">Welcome to Speakr</h2>
-                    <p class="text-[var(--text-secondary)] mb-6">
-                        Speakr is an audio transcription and summarization app that helps you convert your audio recordings into text and generate summaries.
-                    </p>
-                    <div class="flex flex-col sm:flex-row justify-center space-y-3 sm:space-y-0 sm:space-x-4">
-                        <a href="{{ url_for('login') }}" class="px-6 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg shadow hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:ring-offset-2 transition duration-150 ease-in-out">
-                            <i class="fas fa-sign-in-alt mr-2"></i> Login
-                        </a>
-                        <a href="{{ url_for('register') }}" class="px-6 py-2 text-[var(--text-secondary)] hover:text-[var(--text-accent)] border border-[var(--border-secondary)] rounded-lg">
-                            <i class="fas fa-user-plus mr-2"></i> Register
-                        </a>
-                    </div>
-                </div>
-            </div>
-            {% endif %}
+                <!-- Detail View -->
+                {% include 'components/detail-view.html' %}
             </main>
-
-        <footer class="text-center py-4 mt-8 text-xs text-[var(--text-light)] border-t border-[var(--border-primary)]">
-            Speakr &copy; ${ new Date().getFullYear() }
-        </footer>
-
-         <div v-if="showEditModal" class="fixed inset-0 bg-black bg-opacity-60 flex items-center justify-center z-50 p-4">
-             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl w-full max-w-lg max-h-[90vh] overflow-y-auto custom-scrollbar">
-                 <div class="flex justify-between items-center mb-4">
-                    <h3 class="text-xl font-semibold text-[var(--text-primary)]">Edit Recording Details</h3>
-                    <button @click="cancelEdit" class="text-[var(--text-light)] hover:text-[var(--text-muted)] text-2xl leading-none">&times;</button>
-                </div>
-                <div v-if="editingRecording" class="space-y-4">
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Title</label>
-                        <input v-model="editingRecording.title" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Participants</label>
-                        <input v-model="editingRecording.participants" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                    <!-- Add Meeting Date Input -->
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Meeting Date</label>
-                        <input type="date" v-model="editingRecording.meeting_date" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]">
-                    </div>
-                     <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Summary</label>
-                        <textarea v-model="editingRecording.summary" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]" rows="5"></textarea>
-                    </div>
-                    <div>
-                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-1">Notes</label>
-                        <textarea v-model="editingRecording.notes" class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]" rows="4"></textarea>
-                    </div>
-                    <div class="flex justify-end space-x-3 pt-4">
-                        <button @click="cancelEdit" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                        <button @click="saveEdit" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)]">Save Changes</button>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <div v-if="showDeleteModal" class="fixed inset-0 bg-black bg-opacity-60 flex items-center justify-center z-50 p-4">
-             <div class="bg-[var(--bg-secondary)] p-6 rounded-lg shadow-xl max-w-md w-full">
-                <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-4">Confirm Delete</h3>
-                 <p v-if="recordingToDelete" class="mb-2 text-[var(--text-secondary)]">Are you sure you want to permanently delete the recording titled "<strong>${ recordingToDelete.title }</strong>"?</p>
-                <p class="text-sm text-[var(--text-danger)] mb-6">This action cannot be undone and will delete the record, transcription, summary, and the audio file.</p>
-                <div class="flex justify-end space-x-3">
-                    <button @click="cancelDelete" class="px-4 py-2 bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-md hover:bg-[var(--border-secondary)]">Cancel</button>
-                    <button @click="deleteRecording" class="px-4 py-2 bg-[var(--bg-danger)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-danger-hover)]">Delete Permanently</button>
-                </div>
-            </div>
-        </div>
-
-        <div v-if="(uploadQueue.length > 0 || currentlyProcessingFile) && !progressPopupClosed"
-             class="progress-popup bg-[var(--bg-secondary)] rounded-lg shadow-xl border border-[var(--border-primary)] overflow-hidden"
-             :class="{ 'minimized': progressPopupMinimized }">
-
-            <div class="flex justify-between items-center p-2 bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)]">
-                <h4 class="text-sm font-semibold text-[var(--text-secondary)] cursor-pointer" @click="progressPopupMinimized = !progressPopupMinimized">
-                    <i class="fas fa-upload mr-2 text-[var(--text-accent)]"></i>
-                    Upload & Process Progress (${ completedInQueue }/${ totalInQueue } completed)
-                </h4>
-                <div class="flex items-center">
-                    <button class="text-[var(--text-muted)] hover:text-[var(--text-secondary)] mr-2" @click="progressPopupMinimized = !progressPopupMinimized">
-                        <i :class="progressPopupMinimized ? 'fa-chevron-up' : 'fa-chevron-down'" class="fas fa-fw"></i>
-                    </button>
-                    <button class="text-[var(--text-muted)] hover:text-[var(--text-danger)]" @click="progressPopupClosed = true" title="Close">
-                        <i class="fas fa-times fa-fw"></i>
-                    </button>
-                </div>
-            </div>
-
-             <div class="p-3 max-h-60 overflow-y-auto custom-scrollbar" v-show="!progressPopupMinimized">
-                 <div v-if="currentlyProcessingFile" class="mb-3 pb-3 border-b border-dashed border-[var(--border-secondary)]">
-                    <div class="flex items-center justify-between mb-1">
-                        <p class="text-xs font-medium text-[var(--text-primary)] truncate mr-2" :title="currentlyProcessingFile.file.name">
-                            <i class="fas fa-spinner fa-spin text-[var(--text-accent)] mr-1"></i> Processing: ${ currentlyProcessingFile.file.name }
-                        </p>
-                        <span class="text-xs text-[var(--text-muted)] flex-shrink-0">${ formatFileSize(currentlyProcessingFile.file.size) }</span>
-                    </div>
-                     <p class="text-xs text-[var(--text-secondary)] mb-1 italic">${ processingMessage }</p>
-                    <div class="w-full bg-[var(--border-primary)] rounded-full h-1.5">
-                         <div class="bg-[var(--text-accent)] h-1.5 rounded-full transition-all duration-300" :style="{ width: processingProgress + '%' }"></div>
-                    </div>
-                </div>
-
-                 <div v-if="queuedFiles.length > 0" class="mb-2">
-                    <p class="text-xs font-semibold text-[var(--text-muted)] mb-1">${ queuedFiles.length } file(s) queued:</p>
-                    <ul class="space-y-1">
-                        <li v-for="item in queuedFiles" :key="item.clientId" class="text-xs text-[var(--text-secondary)] progress-list-item">
-                            <i class="fas fa-clock text-[var(--text-light)] fa-fw"></i>
-                            <span class="truncate" :title="item.file.name">${ item.file.name }</span>
-                            <span class="text-[var(--text-light)] flex-shrink-0">${ formatFileSize(item.file.size) }</span>
-                        </li>
-                    </ul>
-                </div>
-
-                <div v-if="finishedFilesInQueue.length > 0" class="mt-2 pt-2 border-t border-dashed border-[var(--border-secondary)]">
-                    <p class="text-xs font-semibold text-[var(--text-muted)] mb-1">Recently finished:</p>
-                    <ul class="space-y-1">
-                         <li v-for="item in finishedFilesInQueue.slice(-5)" :key="item.clientId" class="text-xs progress-list-item">
-                             <i v-if="item.status === 'completed'" class="fas fa-check-circle text-[var(--text-success-strong)] fa-fw"></i>
-                            <i v-else-if="item.status === 'failed'" class="fas fa-exclamation-triangle text-[var(--text-danger-strong)] fa-fw"></i>
-                             <i v-else class="fas fa-question-circle text-[var(--text-light)] fa-fw"></i>
-                            <span class="truncate text-[var(--text-secondary)]" :title="item.file.name">${ item.file.name }</span>
-                             <span v-if="item.status === 'failed'" class="text-[var(--text-danger)] text-xs italic flex-shrink-0">Failed</span>
-                            <span v-else class="text-[var(--text-light)] flex-shrink-0">${ formatFileSize(item.file.size) }</span>
-                        </li>
-                    </ul>
-                </div>
-
-                 <div v-if="uploadQueue.length > 0 && queuedFiles.length === 0 && !currentlyProcessingFile" class="text-xs text-center text-[var(--text-muted)] py-2">
-                    All uploads processed.
-                </div>
-            </div>
         </div>
 
+        <!-- Upload Progress Popup -->
+        {% include 'components/progress-popup.html' %}
+
+        <!-- Modals -->
+        {% include 'modals/edit-modal.html' %}
+        {% include 'modals/delete-modal.html' %}
+        {% include 'modals/edit-tags-modal.html' %}
+        {% include 'modals/datetime-picker-modal.html' %}
+        {% include 'modals/shares-list-modal.html' %}
+        {% include 'modals/reset-modal.html' %}
+        {% include 'modals/reprocess-modal.html' %}
+        {% include 'modals/speaker-modal.html' %}
+        {% include 'modals/add-speaker-modal.html' %}
+        {% include 'modals/edit-text-modal.html' %}
+        {% include 'modals/text-editor-modal.html' %}
+        {% include 'modals/asr-editor-modal.html' %}
+        {% include 'modals/customize-summary-prompt-modal.html' %}
+        {% include 'modals/edit-speakers-modal.html' %}
+        {% include 'modals/edit-participants-modal.html' %}
+        {% include 'modals/color-scheme-modal.html' %}
+        {% include 'modals/system-audio-help-modal.html' %}
+        {% include 'modals/recording-disclaimer-modal.html' %}
+        {% include 'modals/upload-disclaimer-modal.html' %}
+        {% include 'modals/recording-recovery-modal.html' %}
+        {% include 'modals/unified-share-modal.html' %}
+        {% include 'modals/share-delete-modal.html' %}
+        {% include 'modals/duplicates-modal.html' %}
+        {% include 'modals/global-error.html' %}
+        {% include 'modals/toast-container.html' %}
+
+        <!-- Bulk Operations Modals -->
+        {% include 'modals/bulk-delete-modal.html' %}
+        {% include 'modals/bulk-tag-modal.html' %}
+        {% include 'modals/bulk-reprocess-modal.html' %}
     </div>
-    
-    <!-- Toast container for notifications -->
-    <div class="toast-container" id="toastContainer"></div>
-    
-    {% raw %}
-    <script>
-        const { createApp, ref, reactive, computed, onMounted, watch, nextTick } = Vue
-
-        createApp({
-            setup() {
-                const currentView = ref('gallery');
-                const dragover = ref(false);
-                const recordings = ref([]);
-                const selectedRecording = ref(null);
-                const selectedTab = ref('summary'); // For Summary/Notes tabs
-
-                // --- Multi-Upload State ---
-                // Status: 'queued'|'uploading'|'processing'|'summarizing'|'completed'|'failed'
-                const uploadQueue = ref([]);
-                const currentlyProcessingFile = ref(null);
-                const processingProgress = ref(0);
-                const processingMessage = ref('');
-                const isProcessingActive = ref(false);
-                const pollInterval = ref(null);
-                const progressPopupMinimized = ref(false);
-                const progressPopupClosed = ref(false);
-
-                const showEditModal = ref(false);
-                const showDeleteModal = ref(false);
-                const editingRecording = ref(null); // Holds a *copy* for the modal
-                const recordingToDelete = ref(null);
-                // const autoSaveTimeout = ref(null); // Autosave not implemented for modal
-                const isLoadingRecordings = ref(true);
-                const globalError = ref(null);
-                const maxFileSizeMB = ref(250); // Default, could fetch from config if needed
-                const isDarkMode = ref(false); // Dark mode state
-                const isSidebarCollapsed = ref(false); // Sidebar state
-                const isUserMenuOpen = ref(false); // User dropdown menu state
-                
-                // Inline editing state
-                const editingParticipants = ref(false);
-                const editingMeetingDate = ref(false);
-                const editingSummary = ref(false);
-                const editingNotes = ref(false);
 
-                // --- Computed Properties ---
-                const groupedRecordings = computed(() => {
-                    const sortedRecordings = [...recordings.value].sort((a, b) => new Date(b.created_at) - new Date(a.created_at));
-                    // Grouping logic (same as before)...
-                    const groups = { today: [], yesterday: [], thisWeek: [], older: [] };
-                    const now = new Date();
-                    const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());
-                    const yesterdayStart = new Date(todayStart);
-                    yesterdayStart.setDate(todayStart.getDate() - 1);
-                    const currentDayOfWeek = now.getDay();
-                    const daysToSubtract = currentDayOfWeek === 0 ? 6 : currentDayOfWeek - 1;
-                    const weekStart = new Date(todayStart);
-                    weekStart.setDate(todayStart.getDate() - daysToSubtract);
+    <!-- CSRF Token Management -->
+    <script src="{{ url_for('static', filename='js/csrf-refresh.js') }}"></script>
 
-                    sortedRecordings.forEach(r => {
-                         const date = new Date(r.created_at);
-                        if (date >= todayStart) groups.today.push(r);
-                        else if (date >= yesterdayStart) groups.yesterday.push(r);
-                        else if (date >= weekStart) groups.thisWeek.push(r);
-                        else groups.older.push(r);
-                    });
-                     return [
-                        { title: 'Today', items: groups.today },
-                        { title: 'Yesterday', items: groups.yesterday },
-                        { title: 'This Week', items: groups.thisWeek },
-                        { title: 'Older', items: groups.older }
-                    ].filter(g => g.items.length > 0);
-                });
-
-                 const totalInQueue = computed(() => uploadQueue.value.length);
-                const completedInQueue = computed(() => uploadQueue.value.filter(item => item.status === 'completed' || item.status === 'failed').length);
-                const queuedFiles = computed(() => uploadQueue.value.filter(item => item.status === 'queued'));
-                // Filter finished: includes completed and failed
-                 const finishedFilesInQueue = computed(() => uploadQueue.value.filter(item => ['completed', 'failed'].includes(item.status)));
-
-
-                // --- Methods ---
-                const setGlobalError = (message, duration = 7000) => {
-                     globalError.value = message;
-                     if (duration > 0) {
-                        setTimeout(() => { if (globalError.value === message) globalError.value = null; }, duration);
-                    }
-                };
+    <!-- i18n System -->
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
 
-                 const formatFileSize = (bytes) => {
-                     if (bytes == null || bytes === 0) return '0 Bytes';
-                    const k = 1024;
-                    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
-                     if (bytes < 0) bytes = 0;
-                    const i = bytes === 0 ? 0 : Math.max(0, Math.floor(Math.log(bytes) / Math.log(k)));
-                     const size = i === 0 ? bytes : parseFloat((bytes / Math.pow(k, i)).toFixed(2));
-                    return size + ' ' + sizes[i];
-                };
-
-                // --- Dark Mode ---
-                const toggleDarkMode = () => {
-                    isDarkMode.value = !isDarkMode.value;
-                    if (isDarkMode.value) {
-                        document.documentElement.classList.add('dark');
-                        localStorage.setItem('darkMode', 'true');
-                    } else {
-                        document.documentElement.classList.remove('dark');
-                        localStorage.setItem('darkMode', 'false');
-                    }
-                };
-
-                const initializeDarkMode = () => {
-                    const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-                    const savedMode = localStorage.getItem('darkMode');
-                    if (savedMode === 'true' || (savedMode === null && prefersDark)) {
-                        isDarkMode.value = true;
-                        document.documentElement.classList.add('dark');
-                    } else {
-                        isDarkMode.value = false;
-                        document.documentElement.classList.remove('dark');
-                    }
-                };
-                // --- End Dark Mode ---
-
-                // --- Sidebar Toggle ---
-                const toggleSidebar = () => {
-                    isSidebarCollapsed.value = !isSidebarCollapsed.value;
-                    // Optional: Save state to localStorage if persistence is desired
-                    // localStorage.setItem('sidebarCollapsed', isSidebarCollapsed.value);
-                };
-                // --- End Sidebar Toggle ---
-                
-                // Helper to format date for display (e.g., "May 4, 2025")
-                const formatDisplayDate = (dateString) => {
-                    if (!dateString) return '';
-                    try {
-                        // Input is expected as 'YYYY-MM-DD'
-                        const date = new Date(dateString + 'T00:00:00'); // Add time to avoid timezone issues
-                        return date.toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' });
-                    } catch (e) {
-                        console.error("Error formatting date:", e);
-                        return dateString; // Return original string if formatting fails
-                    }
-                };
-
-                // Helper for status display
-                 const formatStatus = (status) => {
-                     if (!status) return 'Unknown';
-                     // Capitalize first letter, handle 'SUMMARIZING' specifically
-                     return status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
-                };
-
-                // Helper for status badge class
-                const getStatusClass = (status) => {
-                    switch(status) {
-                        case 'PENDING': return 'status-pending';
-                        case 'PROCESSING': return 'status-processing';
-                        case 'SUMMARIZING': return 'status-summarizing';
-                        case 'COMPLETED': return 'status-completed';
-                        case 'FAILED': return 'status-failed';
-                        default: return 'status-pending'; // Default or unknown
-                    }
-                };
-
-
-                const resetCurrentFileProcessingState = () => {
-                    if (pollInterval.value) clearInterval(pollInterval.value);
-                    pollInterval.value = null;
-                    currentlyProcessingFile.value = null;
-                    processingProgress.value = 0;
-                    processingMessage.value = '';
-                };
-
-                const switchToUploadView = () => {
-                    currentView.value = 'upload';
-                    selectedRecording.value = null;
-                 };
-
-                const switchToGalleryView = async () => {
-                    currentView.value = 'gallery';
-                     await loadRecordings(); // Refresh recordings when switching back
-                };
-
-                const handleDragLeave = (e) => {
-                    if (e.relatedTarget && e.currentTarget.contains(e.relatedTarget)) {
-                         return;
-                    }
-                    dragover.value = false;
+    <!-- Initialize i18n immediately with fallback -->
+    <script>
+        // Ensure i18n is initialized before Vue app
+        (async function() {
+            const startTime = Date.now();
+            const maxWait = 3000; // Max 3 seconds for i18n to load
+
+            try {
+                if (window.i18n && window.i18n.init) {
+                    const userLang = localStorage.getItem('preferredLanguage') || '{{ user_language }}' || 'en';
+
+                    // Race between i18n init and timeout
+                    await Promise.race([
+                        window.i18n.init(userLang),
+                        new Promise((resolve) => setTimeout(resolve, maxWait))
+                    ]);
+
+                    const elapsed = Date.now() - startTime;
+                    console.log('i18n initialized in', elapsed, 'ms');
+                } else {
+                    console.warn('i18n not available, continuing without translations');
                 }
+            } catch (error) {
+                console.error('Failed to initialize i18n:', error);
+                // Continue anyway - app will use fallback translations
+            }
+
+            // Hide initial loader after i18n attempt
+            const loader = document.getElementById('loader');
+            if (loader) {
+                loader.style.display = 'none';
+            }
+        })();
+    </script>
 
-                const handleDrop = (e) => {
-                    dragover.value = false;
-                    addFilesToQueue(e.dataTransfer.files);
-                 };
-
-                const handleFileSelect = (e) => {
-                    addFilesToQueue(e.target.files);
-                    e.target.value = null; // Reset input
-                };
-
-                // --- Queue Management ---
-                const addFilesToQueue = (files) => {
-                    let filesAdded = 0;
-                    for (const file of files) {
-                        if (file && file.type.startsWith('audio/')) {
-                             if (file.size > maxFileSizeMB.value * 1024 * 1024) {
-                                setGlobalError(`File "${file.name}" exceeds the maximum size of ${maxFileSizeMB.value} MB and was skipped.`);
-                                continue;
-                            }
-                             const clientId = `client-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-                            uploadQueue.value.push({
-                                file: file, status: 'queued', recordingId: null, clientId: clientId, error: null
-                            });
-                            filesAdded++;
-                        } else if (file) {
-                            setGlobalError(`Invalid file type "${file.name}". Only audio files are accepted. File skipped.`);
-                        }
-                    }
-                     if(filesAdded > 0) {
-                        console.log(`Added ${filesAdded} file(s) to the queue.`);
-                        progressPopupMinimized.value = false; // Show popup
-                        if (!isProcessingActive.value) {
-                            startProcessingQueue();
-                        }
-                    }
-                };
-
-                 const startProcessingQueue = async () => {
-                    console.log("Attempting to start processing queue...");
-                    if (isProcessingActive.value) {
-                        console.log("Queue processor already active.");
-                        return;
-                    }
-
-                    isProcessingActive.value = true;
-                    resetCurrentFileProcessingState();
-
-                     const nextFileItem = uploadQueue.value.find(item => item.status === 'queued');
-
-                    if (nextFileItem) {
-                        console.log(`Processing next file: ${nextFileItem.file.name} (Client ID: ${nextFileItem.clientId})`);
-                        currentlyProcessingFile.value = nextFileItem;
-                        nextFileItem.status = 'uploading';
-                        processingMessage.value = 'Preparing upload...';
-                        processingProgress.value = 5;
-
-                        try {
-                            const formData = new FormData();
-                            formData.append('file', nextFileItem.file);
-
-                            processingMessage.value = 'Uploading file...';
-                            processingProgress.value = 10;
-
-                            const response = await fetch('/upload', { method: 'POST', body: formData });
-                            const data = await response.json();
-
-                            if (!response.ok) {
-                                let errorMsg = data.error || `Upload failed with status ${response.status}`;
-                                if (response.status === 413) errorMsg = data.error || `File too large. Max: ${data.max_size_mb?.toFixed(0) || maxFileSizeMB.value} MB.`;
-                                throw new Error(errorMsg);
-                            }
-
-                             if (response.status === 202 && data.id) {
-                                console.log(`File ${nextFileItem.file.name} uploaded. Recording ID: ${data.id}. Starting status poll.`);
-                                // Status is now 'PENDING' on backend, will be updated by poll
-                                nextFileItem.status = 'pending'; // Reflect initial backend status
-                                nextFileItem.recordingId = data.id;
-                                processingMessage.value = 'Upload complete. Waiting for processing...';
-                                processingProgress.value = 30;
-
-                                 // Add preliminary record to gallery immediately
-                                recordings.value.unshift(data);
-                                // Optionally select the new item
-                                // selectRecording(data);
-
-                                pollProcessingStatus(nextFileItem); // Start polling
-
-                            } else {
-                                throw new Error('Unexpected success response from server after upload.');
-                            }
-
-                        } catch (error) {
-                            console.error(`Upload/Processing Error for ${nextFileItem.file.name} (Client ID: ${nextFileItem.clientId}):`, error);
-                            nextFileItem.status = 'failed';
-                            nextFileItem.error = error.message;
-                             // Find the potentially added preliminary record and mark it failed
-                             const failedRecordIndex = recordings.value.findIndex(r => r.id === nextFileItem.recordingId);
-                             if(failedRecordIndex !== -1) {
-                                recordings.value[failedRecordIndex].status = 'FAILED';
-                                recordings.value[failedRecordIndex].transcription = `Upload/Processing failed: ${error.message}`;
-                             } else {
-                                // If record wasn't even created, add a note
-                                setGlobalError(`Failed to process "${nextFileItem.file.name}": ${error.message}`);
-                             }
-
-                             // Reset state and try next file
-                             resetCurrentFileProcessingState();
-                             isProcessingActive.value = false;
-                             await nextTick();
-                             startProcessingQueue();
-                         }
-                    } else {
-                        console.log("Upload queue is empty or no files are queued.");
-                        isProcessingActive.value = false;
-                        // Optional: Auto-minimize popup after a delay
-                         // setTimeout(() => {
-                        //     if (!isProcessingActive.value && uploadQueue.value.every(f => ['completed', 'failed'].includes(f.status))) {
-                         //         progressPopupMinimized.value = true;
-                        //     }
-                         // }, 5000);
-                    }
-                };
-
-                const pollProcessingStatus = (fileItem) => {
-                     if (pollInterval.value) clearInterval(pollInterval.value);
-
-                    const recordingId = fileItem.recordingId;
-                    if (!recordingId) {
-                        console.error("Cannot poll status without recording ID for", fileItem.file.name);
-                        fileItem.status = 'failed';
-                        fileItem.error = 'Internal error: Missing recording ID for polling.';
-                        resetCurrentFileProcessingState();
-                        isProcessingActive.value = false;
-                        nextTick(startProcessingQueue); // Try next file
-                        return;
-                    }
-
-                    // Initial message based on fileItem status (should be 'pending' initially)
-                    processingMessage.value = 'Waiting for transcription...';
-                    processingProgress.value = 40;
-
-                    pollInterval.value = setInterval(async () => {
-                        // Check if the item is still the one being processed and hasn't finished/failed
-                         if (!currentlyProcessingFile.value || currentlyProcessingFile.value.clientId !== fileItem.clientId || ['completed', 'failed'].includes(fileItem.status)) {
-                             console.log(`Polling stopped for ${fileItem.clientId} as it's no longer active or finished.`);
-                            clearInterval(pollInterval.value);
-                            pollInterval.value = null;
-                             // If this was the active file, allow queue to restart
-                            if (currentlyProcessingFile.value && currentlyProcessingFile.value.clientId === fileItem.clientId) {
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-                            }
-                            return;
-                        }
-
-                        try {
-                            console.log(`Polling status for recording ID: ${recordingId} (${fileItem.file.name})`);
-                            const response = await fetch(`/status/${recordingId}`);
-                            if (!response.ok) throw new Error(`Status check failed with status ${response.status}`);
-
-                            const data = await response.json();
-                             const galleryIndex = recordings.value.findIndex(r => r.id === recordingId);
-
-                            // Update item in the main recordings list
-                            if (galleryIndex !== -1) {
-                                recordings.value[galleryIndex] = data;
-                                if(selectedRecording.value?.id === recordingId) {
-                                    selectedRecording.value = data; // Update selection if viewing details
-                                }
-                            }
-
-                            // Update the status in the uploadQueue item as well
-                            fileItem.status = data.status;
-
-                            // Update progress display based on backend status
-                            if (data.status === 'COMPLETED') {
-                                console.log(`Processing COMPLETED for ${fileItem.file.name} (ID: ${recordingId})`);
-                                processingMessage.value = 'Processing complete!';
-                                processingProgress.value = 100;
-                                fileItem.status = 'completed'; // Final status for queue item
-                                // Stop polling, reset state, and trigger next item
-                                clearInterval(pollInterval.value);
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-
-                            } else if (data.status === 'FAILED') {
-                                console.log(`Processing FAILED for ${fileItem.file.name} (ID: ${recordingId})`);
-                                processingMessage.value = 'Processing failed.';
-                                processingProgress.value = 100; // Show 100% but failed state
-                                fileItem.status = 'failed'; // Final status for queue item
-                                fileItem.error = data.transcription || data.summary || 'Processing failed on server.';
-                                setGlobalError(`Processing failed for "${data.title || fileItem.file.name}".`);
-                                // Stop polling, reset state, and trigger next item
-                                clearInterval(pollInterval.value);
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false;
-                                await nextTick();
-                                startProcessingQueue();
-
-                            } else if (data.status === 'PROCESSING') {
-                                processingMessage.value = 'Transcription in progress...';
-                                processingProgress.value = Math.min(65, processingProgress.value + Math.random() * 5); // Mid-range progress
-                            } else if (data.status === 'SUMMARIZING') {
-                                processingMessage.value = 'Generating title & summary...';
-                                processingProgress.value = Math.min(95, processingProgress.value + Math.random() * 5); // Higher progress
-                            } else { // PENDING
-                                processingMessage.value = 'Waiting in queue...';
-                                processingProgress.value = 45; // Keep progress indication while pending
-                            }
-                        } catch (error) {
-                            console.error(`Polling Error for ${fileItem.file.name} (ID: ${recordingId}):`, error);
-                             // Assume failed if polling error occurs
-                            fileItem.status = 'failed';
-                            fileItem.error = `Error checking status: ${error.message}`;
-                            setGlobalError(`Error checking status for "${fileItem.file.name}": ${error.message}.`);
-                             // Update record in gallery if found
-                             const galleryIndex = recordings.value.findIndex(r => r.id === recordingId);
-                            if (galleryIndex !== -1) recordings.value[galleryIndex].status = 'FAILED';
-
-                            clearInterval(pollInterval.value);
-                            pollInterval.value = null;
-                            resetCurrentFileProcessingState();
-                            isProcessingActive.value = false;
-                            await nextTick();
-                            startProcessingQueue(); // Process the next file
-                        }
-                    }, 5000); // Poll every 5 seconds (adjust as needed)
-                };
-
-                // --- Gallery and Detail Methods ---
-                // AutoSave removed in favor of explicit save in modal
-                // const autoSave = () => { ... };
-
-                 const saveMetadata = async (recordingDataToSave) => {
-                    globalError.value = null;
-                    if (!recordingDataToSave || !recordingDataToSave.id) return null;
-                    console.log('Saving metadata for:', recordingDataToSave.id);
-                    try {
-                        const payload = {
-                            id: recordingDataToSave.id,
-                            title: recordingDataToSave.title,
-                            participants: recordingDataToSave.participants,
-                            notes: recordingDataToSave.notes,
-                            summary: recordingDataToSave.summary, // <-- ADDED: Include summary
-                            meeting_date: recordingDataToSave.meeting_date // <-- ADDED: Include meeting_date (should be YYYY-MM-DD)
-                        };
-                        const response = await fetch('/save', {
-                            method: 'POST',
-                            headers: { 'Content-Type': 'application/json' },
-                            body: JSON.stringify(payload)
-                        });
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to save metadata');
-
-                        console.log('Save successful:', data.recording.id);
-                        // Update the master recordings list
-                        const index = recordings.value.findIndex(r => r.id === data.recording.id);
-                        if (index !== -1) {
-                            // Update only the editable fields, preserve others like status/transcription from backend
-                             recordings.value[index].title = payload.title;
-                             recordings.value[index].participants = payload.participants;
-                             recordings.value[index].notes = payload.notes;
-                             recordings.value[index].notes_html = data.recording.notes_html;
-                             recordings.value[index].summary = payload.summary;
-                             recordings.value[index].summary_html = data.recording.summary_html;
-                             recordings.value[index].meeting_date = payload.meeting_date; // <-- ADDED: Update meeting_date
-                         }
-                         // Update selected if it's the one being saved
-                         if (selectedRecording.value?.id === data.recording.id) {
-                            selectedRecording.value.title = payload.title;
-                            selectedRecording.value.participants = payload.participants;
-                            selectedRecording.value.notes = payload.notes;
-                            selectedRecording.value.notes_html = data.recording.notes_html;
-                            selectedRecording.value.summary = payload.summary;
-                            selectedRecording.value.summary_html = data.recording.summary_html;
-                            selectedRecording.value.meeting_date = payload.meeting_date; // <-- ADDED: Update meeting_date
-                         }
-                        return data.recording; // Return the full updated object from backend
-                    } catch (error) {
-                        console.error('Save Metadata Error:', error);
-                        setGlobalError(`Save failed: ${error.message}`);
-                        return null;
-                    }
-                };
-
-                const loadRecordings = async () => {
-                    globalError.value = null;
-                    isLoadingRecordings.value = true;
-                    try {
-                        const response = await fetch('/recordings');
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to load recordings');
-                        recordings.value = data;
-
-
-                        // On load, check for any recordings stuck in PENDING, PROCESSING, or SUMMARIZING
-                        // and ensure polling is active if the queue processor isn't running.
-                        const incompleteRecordings = recordings.value.filter(r => ['PENDING', 'PROCESSING', 'SUMMARIZING'].includes(r.status));
-
-                        if (incompleteRecordings.length > 0 && !isProcessingActive.value) {
-                            console.warn(`Found ${incompleteRecordings.length} incomplete recording(s) on load. Attempting to resume polling if not already queued.`);
-                            for (const recording of incompleteRecordings) {
-                                // Is this item already being tracked in the queue?
-                                let queueItem = uploadQueue.value.find(item => item.recordingId === recording.id);
-                                if (!queueItem) {
-                                    // If not in queue (likely page reload), create a placeholder to track polling
-                                    console.log(`Re-attaching poll for recording ${recording.id}.`);
-                                    queueItem = {
-                                        // Mock file object, size might be useful for display
-                                        file: { name: recording.title || `Recording ${recording.id}`, size: recording.file_size },
-                                        status: recording.status, // Use current status from DB
-                                        recordingId: recording.id,
-                                        clientId: `reload-${recording.id}`, // Unique ID for tracking
-                                        error: null
-                                    };
-                                    // Add to the *beginning* of the visual queue *if* we want to show it there
-                                    // Or just manage polling without adding to queue visually?
-                                    // Let's add it to the queue for consistency in management.
-                                    uploadQueue.value.unshift(queueItem);
-                                    // Start processing queue if it wasn't active
-                                    if (!isProcessingActive.value) {
-                                        startProcessingQueue();
-                                    } else if (currentlyProcessingFile.value?.recordingId !== recording.id) {
-                                        // If processor is active but on a different file, just ensure polling starts
-                                        // Note: startProcessingQueue handles finding the next 'queued'. This item
-                                        // might not be 'queued'. We need direct polling.
-                                        // Let's rethink: The queue processor should handle finding PENDING/PROCESSING items.
-                                        // For simplicity, let's just trigger the queue processor. It will find this item if it's next.
-                                        // If something else is truly processing, this won't interrupt.
-                                        console.log("Triggering queue processor check due to reloaded incomplete item.")
-                                        // Ensure it's marked conceptually 'queued' for the processor to pick up
-                                        queueItem.status = 'queued';
-                                        startProcessingQueue(); // Let the queue logic handle it
-                                    }
-
-                                } else if (queueItem.status !== recording.status && !['completed', 'failed'].includes(queueItem.status)) {
-                                    // If queue status differs from DB, update queue status
-                                    console.log(`Correcting queue status for ${queueItem.clientId} from ${queueItem.status} to ${recording.status}`);
-                                    queueItem.status = recording.status;
-                                    // Restart queue processing if needed
-                                    if (!isProcessingActive.value) startProcessingQueue();
-                                }
-                            }
-                        }
-
-                    } catch (error) {
-                        console.error('Load Recordings Error:', error);
-                        setGlobalError(`Failed to load recordings: ${error.message}`);
-                        recordings.value = [];
-                    } finally {
-                        isLoadingRecordings.value = false;
-                    }
-                };
-
-                 const selectRecording = (recording) => {
-                     selectedRecording.value = recording;
-                     // Optional: Check if polling needs to be restarted if user selects an incomplete item
-                     // This logic is complex and might be redundant with the loadRecordings check.
-                     // Let's rely on loadRecordings and the queue processor for robustness.
-                 };
-
-                const editRecording = (recording) => {
-                     // Create a deep copy for the modal to prevent modifying original object directly
-                    editingRecording.value = JSON.parse(JSON.stringify(recording));
-                    showEditModal.value = true;
-                };
-
-                const cancelEdit = () => {
-                    showEditModal.value = false;
-                    editingRecording.value = null;
-                };
-
-                 const saveEdit = async () => {
-                    // Save using the saveMetadata function which updates the main list & selected item
-                     const success = await saveMetadata(editingRecording.value);
-                    if (success) {
-                        cancelEdit(); // Close modal on success
-                     }
-                     // Keep modal open on failure, error shown via globalError
-                };
-
-                const confirmDelete = (recording) => {
-                    recordingToDelete.value = recording;
-                    showDeleteModal.value = true;
-                };
-
-                const cancelDelete = () => {
-                    showDeleteModal.value = false;
-                    recordingToDelete.value = null;
-                };
-
-                const deleteRecording = async () => {
-                    globalError.value = null;
-                    if (!recordingToDelete.value) return;
-                    const idToDelete = recordingToDelete.value.id;
-                    const titleToDelete = recordingToDelete.value.title; // For logging/messaging
-                    try {
-                        const response = await fetch(`/recording/${idToDelete}`, { method: 'DELETE' });
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to delete recording');
-
-                         // Remove from gallery list
-                        recordings.value = recordings.value.filter(r => r.id !== idToDelete);
-
-                        // Find and remove from upload queue
-                        const queueIndex = uploadQueue.value.findIndex(item => item.recordingId === idToDelete);
-                         if (queueIndex !== -1) {
-                            const deletedItem = uploadQueue.value.splice(queueIndex, 1)[0];
-                             console.log(`Removed item ${deletedItem.clientId} from queue.`);
-                             // If deleting the file currently being processed, stop polling and move to next
-                            if (currentlyProcessingFile.value?.clientId === deletedItem.clientId) {
-                                console.log(`Deleting currently processing file: ${titleToDelete}. Stopping poll and moving to next.`);
-                                clearInterval(pollInterval.value); // Stop polling explicitly
-                                pollInterval.value = null;
-                                resetCurrentFileProcessingState();
-                                isProcessingActive.value = false; // Allow queue to restart
-                                await nextTick();
-                                startProcessingQueue();
-                            }
-                        }
-
-                        if (selectedRecording.value?.id === idToDelete) selectedRecording.value = null;
-                        cancelDelete();
-                        console.log(`Successfully deleted recording ${idToDelete} (${titleToDelete})`);
-
-                    } catch (error) {
-                        console.error('Delete Error:', error);
-                        setGlobalError(`Failed to delete recording "${titleToDelete}": ${error.message}`);
-                        cancelDelete(); // Still close modal on error
-                    }
-                };
-                
-                // Inline editing methods
-                const toggleEditParticipants = () => {
-                    editingParticipants.value = !editingParticipants.value;
-                    if (!editingParticipants.value) {
-                        saveInlineEdit('participants');
-                    }
-                };
-                
-                const toggleEditMeetingDate = () => {
-                    editingMeetingDate.value = !editingMeetingDate.value;
-                    if (!editingMeetingDate.value) {
-                        saveInlineEdit('meeting_date');
-                    }
-                };
-                
-                const toggleEditSummary = () => {
-                    editingSummary.value = !editingSummary.value;
-                    if (!editingSummary.value) {
-                        saveInlineEdit('summary');
-                    }
-                };
-                
-                const toggleEditNotes = () => {
-                    editingNotes.value = !editingNotes.value;
-                    if (!editingNotes.value) {
-                        saveInlineEdit('notes');
-                    }
-                };
-                
-                const saveInlineEdit = async (field) => {
-                    if (!selectedRecording.value) return;
-                    
-                    // Create a payload with just the field being edited
-                    const payload = {
-                        id: selectedRecording.value.id,
-                        [field]: selectedRecording.value[field]
-                    };
-                    
-                    // For completeness, include all editable fields in the payload
-                    // This ensures the backend has all the data it needs
-                    const fullPayload = {
-                        id: selectedRecording.value.id,
-                        title: selectedRecording.value.title,
-                        participants: selectedRecording.value.participants,
-                        notes: selectedRecording.value.notes,
-                        summary: selectedRecording.value.summary,
-                        meeting_date: selectedRecording.value.meeting_date
-                    };
-                    
-                    try {
-                        const updatedRecording = await saveMetadata(fullPayload);
-                        if (updatedRecording) {
-                            // Update the HTML versions from the response
-                            if (field === 'notes') {
-                                selectedRecording.value.notes_html = updatedRecording.notes_html;
-                            } else if (field === 'summary') {
-                                selectedRecording.value.summary_html = updatedRecording.summary_html;
-                            }
-                            
-                            // Reset the editing state for the field
-                            switch(field) {
-                                case 'participants':
-                                    editingParticipants.value = false;
-                                    break;
-                                case 'meeting_date':
-                                    editingMeetingDate.value = false;
-                                    break;
-                                case 'summary':
-                                    editingSummary.value = false;
-                                    break;
-                                case 'notes':
-                                    editingNotes.value = false;
-                                    break;
-                            }
-                            showToast(`${field.charAt(0).toUpperCase() + field.slice(1).replace('_', ' ')} updated successfully`);
-                        }
-                    } catch (error) {
-                        console.error(`Save ${field} Error:`, error);
-                        setGlobalError(`Failed to save ${field}: ${error.message}`);
-                    }
-                };
-
-                // --- Lifecycle Hooks ---
-                onMounted(() => {
-                    loadRecordings();
-                    initializeDarkMode(); // Initialize dark mode on load
-                });
-
-                // --- Watchers ---
-                 watch(uploadQueue, (newQueue, oldQueue) => {
-                    if (newQueue.length === 0 && oldQueue.length > 0 && !isProcessingActive.value) {
-                        console.log("Upload queue processing finished.");
-                        // Auto-minimize after delay
-                        setTimeout(() => progressPopupMinimized.value = true, 1000);
-                        // Auto-hide popup after all uploads are complete
-                        setTimeout(() => {
-                            if (completedInQueue.value === totalInQueue.value && !isProcessingActive.value) {
-                                progressPopupClosed.value = true;
-                            }
-                        }, 5000);
-                     }
-                 }, { deep: true });
-
-
-                // --- Chat functionality ---
-                const showChat = ref(false);
-                const chatMessages = ref([]);
-                const chatInput = ref('');
-                const isChatLoading = ref(false);
-                
-                // Create a ref for the chat messages container
-                const chatMessagesRef = ref(null);
-                
-                const sendChatMessage = async () => {
-                    if (!chatInput.value.trim() || isChatLoading.value || !selectedRecording.value || selectedRecording.value.status !== 'COMPLETED') {
-                        return;
-                    }
-                    
-                    const message = chatInput.value.trim();
-
-                    // Ensure chatMessages.value is an array before pushing
-                    if (!Array.isArray(chatMessages.value)) {
-                        console.warn('chatMessages.value was not an array! Resetting. Value was:', chatMessages.value);
-                        chatMessages.value = []; // Reset if corrupted
-                    }
-
-                    chatMessages.value.push({ role: 'user', content: message });
-                    chatInput.value = '';
-                    isChatLoading.value = true;
-                    
-                    // Scroll to bottom of chat
-                    await nextTick();
-                    // Use the correctly named ref
-                    if (chatMessagesRef.value) { 
-                        chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
-                    }
-                    
-                    try {
-                        // Prepare message history for the API call
-                        // We need to convert our UI messages to the format expected by the API
-                        const messageHistory = chatMessages.value
-                            .slice(0, -1) // Exclude the message we just added (it will be sent separately)
-                            .map(msg => ({
-                                role: msg.role,
-                                content: msg.content
-                            }));
-                        
-                        const response = await fetch('/chat', {
-                            method: 'POST',
-                            headers: { 'Content-Type': 'application/json' },
-                            body: JSON.stringify({
-                                recording_id: selectedRecording.value.id,
-                                message: message,
-                                message_history: messageHistory
-                            })
-                        });
-                        
-                        const data = await response.json();
-                        if (!response.ok) throw new Error(data.error || 'Failed to get chat response');
-                        
-                        chatMessages.value.push({ 
-                            role: 'assistant', 
-                            content: data.response,
-                            html: data.response_html 
-                        });
-                    } catch (error) {
-                        console.error('Chat Error:', error);
-                        setGlobalError(`Chat error: ${error.message}`);
-                        chatMessages.value.push({ role: 'assistant', content: `Error: ${error.message}` });
-                    } finally {
-                        isChatLoading.value = false;
-                        // Scroll to bottom of chat
-                        await nextTick();
-                         // Use the correctly named ref
-                        if (chatMessagesRef.value) {
-                            chatMessagesRef.value.scrollTop = chatMessagesRef.value.scrollHeight;
-                        }
-                    }
-                };
-                
-                // Toast notification system
-                const showToast = (message, icon = 'fa-check-circle', duration = 2000) => {
-                    const toastContainer = document.getElementById('toastContainer');
-                    
-                    // Create toast element
-                    const toast = document.createElement('div');
-                    toast.className = 'toast';
-                    toast.innerHTML = `<i class="fas ${icon}"></i> ${message}`;
-                    
-                    // Add to container
-                    toastContainer.appendChild(toast);
-                    
-                    // Trigger animation
-                    setTimeout(() => {
-                        toast.classList.add('show');
-                    }, 10);
-                    
-                    // Remove after duration
-                    setTimeout(() => {
-                        toast.classList.remove('show');
-                        setTimeout(() => {
-                            toastContainer.removeChild(toast);
-                        }, 300);
-                    }, duration);
-                };
-                
-                // Add animation to copy button
-                const animateCopyButton = (button) => {
-                    button.classList.add('copy-success');
-                    
-                    // Store original content
-                    const originalContent = button.innerHTML;
-                    button.innerHTML = '<i class="fas fa-check"></i>';
-                    
-                    setTimeout(() => {
-                        button.classList.remove('copy-success');
-                        button.innerHTML = originalContent;
-                    }, 1500);
-                };
-                
-                const copyMessage = (text, event) => {
-                    // Get the button that was clicked
-                    const button = event.currentTarget;
-                    
-                    if (navigator.clipboard && window.isSecureContext) {
-                        // Use clipboard API if available (secure context)
-                        navigator.clipboard.writeText(text)
-                            .then(() => {
-                                showToast('Copied to clipboard!');
-                                animateCopyButton(button);
-                            })
-                            .catch(err => {
-                                console.error('Copy failed:', err);
-                                showToast('Failed to copy: ' + err.message, 'fa-exclamation-circle');
-                                fallbackCopyTextToClipboard(text, button);
-                            });
-                    } else {
-                        // Fallback for non-secure contexts
-                        fallbackCopyTextToClipboard(text, button);
-                    }
-                };
-                
-                // Fallback method using document.execCommand
-                const fallbackCopyTextToClipboard = (text, button = null) => {
-                    try {
-                        const textArea = document.createElement("textarea");
-                        textArea.value = text;
-                        
-                        // Make the textarea out of viewport
-                        textArea.style.position = "fixed";
-                        textArea.style.left = "-999999px";
-                        textArea.style.top = "-999999px";
-                        document.body.appendChild(textArea);
-                        
-                        // Select and copy
-                        textArea.focus();
-                        textArea.select();
-                        const successful = document.execCommand('copy');
-                        
-                        // Clean up
-                        document.body.removeChild(textArea);
-                        
-                        if (successful) {
-                            showToast('Copied to clipboard!');
-                            if (button) animateCopyButton(button);
-                        } else {
-                            showToast('Copy failed. Your browser may not support this feature.', 'fa-exclamation-circle');
-                        }
-                    } catch (err) {
-                        console.error('Fallback copy failed:', err);
-                        showToast('Unable to copy: ' + err.message, 'fa-exclamation-circle');
-                    }
-                };
-                
-                const copyTranscription = (event) => {
-                    if (!selectedRecording.value || !selectedRecording.value.transcription) {
-                        showToast('No transcription available to copy.', 'fa-exclamation-circle');
-                        return;
-                    }
-                    
-                    // Get the button that was clicked
-                    const button = event.currentTarget;
-                    
-                    // Show visual feedback on button
-                    animateCopyButton(button);
-                    
-                    if (navigator.clipboard && window.isSecureContext) {
-                        // Use clipboard API if available (secure context)
-                        navigator.clipboard.writeText(selectedRecording.value.transcription)
-                            .then(() => {
-                                showToast('Transcription copied to clipboard!');
-                            })
-                            .catch(err => {
-                                console.error('Copy failed:', err);
-                                showToast('Failed to copy: ' + err.message, 'fa-exclamation-circle');
-                                fallbackCopyTextToClipboard(selectedRecording.value.transcription);
-                            });
-                    } else {
-                        // Fallback for non-secure contexts
-                        fallbackCopyTextToClipboard(selectedRecording.value.transcription);
-                    }
-                };
-                
-                // Clear chat messages when recording changes
-                watch(selectedRecording, (newVal) => {
-                    chatMessages.value = [];
-                    showChat.value = false;
-                    selectedTab.value = 'summary'; // Reset tab when recording changes
-                });
+    <!-- Service Worker Registration handled by app.modular.js -->
 
-                return {
-                    // State
-                    currentView, dragover, recordings, selectedRecording, // currentRecording removed
-                    showEditModal, showDeleteModal, editingRecording, recordingToDelete,
-                    isLoadingRecordings, globalError, maxFileSizeMB, isDarkMode, // <-- Added isDarkMode
-                    // Multi-upload State
-                    uploadQueue, currentlyProcessingFile, processingProgress, processingMessage,
-                    isProcessingActive, progressPopupMinimized, progressPopupClosed,
-                    // Chat State
-                    showChat, chatMessages, chatInput, isChatLoading, chatMessagesRef, // <-- Added chatMessagesRef
-                    // Computed
-                    groupedRecordings, totalInQueue, completedInQueue, queuedFiles, finishedFilesInQueue,
-                    // Inline editing state
-                    editingParticipants, editingMeetingDate, editingSummary, editingNotes,
-                    // Methods
-                    handleDrop, handleFileSelect, /*autoSave removed*/ loadRecordings, selectedTab, // <-- Added selectedTab
-                    selectRecording, editRecording, cancelEdit, saveEdit, confirmDelete,
-                    cancelDelete, deleteRecording, switchToUploadView, switchToGalleryView,
-                    formatFileSize, setGlobalError, handleDragLeave, formatStatus, getStatusClass,
-                    formatDisplayDate, // <-- ADDED: Expose date formatting function
-                    toggleDarkMode, // <-- Added toggleDarkMode
-                    toggleSidebar, isSidebarCollapsed, // <-- Added sidebar state and function
-                    // Inline editing methods
-                    toggleEditParticipants, toggleEditMeetingDate, toggleEditSummary, toggleEditNotes, saveInlineEdit,
-                    // Chat Methods
-                    sendChatMessage, copyMessage, copyTranscription,
-                    // User menu
-                    isUserMenuOpen,
-                 }
-            },
-            delimiters: ['${', '}'] // Keep Vue delimiters distinct from Flask's Jinja
-        }).mount('#app');
-    </script>
-{% endraw %}
+    <!-- Vue.js Application Script -->
+    <script type="module" src="{{ url_for('static', filename='js/app.modular.js') }}"></script>
 </body>
 </html>
diff --git a/templates/index.original.html.backup b/templates/index.original.html.backup
new file mode 100644
index 00000000..f15a36eb
--- /dev/null
+++ b/templates/index.original.html.backup
@@ -0,0 +1,3480 @@
+<!DOCTYPE html>
+<html lang="en" class="h-full">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <title>Speakr - Audio Transcription & Summarization</title>
+    {% include 'includes/loading_overlay.html' %}
+    <!-- All dependencies bundled locally for offline support -->
+    <script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+    <script src="{{ url_for('static', filename='vendor/js/marked.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/easymde.min.css') }}">
+    <script src="{{ url_for('static', filename='vendor/js/easymde.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}">
+    <link rel="icon" type="image/png" sizes="32x32" href="{{ url_for('static', filename='img/icon-32x32.png') }}">
+    <link rel="icon" type="image/png" sizes="16x16" href="{{ url_for('static', filename='img/icon-16x16.png') }}">
+    <link rel="apple-touch-icon" sizes="180x180" href="{{ url_for('static', filename='img/icon-180x180.png') }}">
+    <link rel="manifest" href="{{ url_for('static', filename='manifest.json') }}">
+    <meta name="theme-color" content="#2563eb">
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    maxHeight: {
+                        '85vh': '85vh',
+                        '90vh': '90vh'
+                    },
+                    colors: {
+                        primary: 'var(--bg-primary)',
+                        secondary: 'var(--bg-secondary)',
+                        accent: 'var(--bg-accent)'
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="h-full bg-[var(--bg-primary)] text-[var(--text-primary)] transition-colors duration-300">
+    <div id="loader" class="fixed inset-0 bg-gray-800 flex items-center justify-center z-50">
+        <div class="text-white text-lg">Loading...</div>
+    </div>
+    <div id="app" v-cloak
+         data-use-asr-endpoint="{{ use_asr_endpoint }}" 
+         data-current-user-name="{{ current_user.name if current_user.is_authenticated else '' }}"
+         data-user-language="{{ user_language }}"
+         class="h-full flex flex-col opacity-0 transition-opacity duration-500">
+        
+        <!-- Header -->
+        <header class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] px-3 sm:px-4 py-3 flex items-center justify-between flex-shrink-0 z-50">
+            <!-- Left side: Menu toggle and logo -->
+            <div class="flex items-center gap-2 sm:gap-4 min-w-0 flex-shrink">
+                <!-- Menu Toggle Button -->
+                <button @click="toggleSidebar" 
+                        class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200 flex-shrink-0 flex items-center justify-center">
+                    <i class="fas fa-bars text-lg"></i>
+                </button>
+                
+                <!-- Logo and Title -->
+                <div class="flex items-center gap-2 sm:gap-3 min-w-0">
+                    <img src="{{ url_for('static', filename='img/icon-32x32.png') }}" alt="Speakr" class="w-7 h-7 sm:w-8 sm:h-8 flex-shrink-0">
+                    <h1 class="text-lg sm:text-xl font-bold text-[var(--text-primary)] truncate">Speakr</h1>
+                </div>
+            </div>
+
+            <!-- Right side: User menu and controls -->
+            <div class="flex items-center gap-3">
+                <!-- Inquire Mode Button -->
+                {% if inquire_mode_enabled %}
+                <a href="/inquire" 
+                   class="px-2 py-1.5 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:opacity-80 transition-opacity text-sm sm:px-4 sm:py-2 sm:min-w-[120px] sm:flex sm:items-center sm:gap-2 sm:justify-center">
+                    <i class="fas fa-search"></i>
+                    <span class="hidden sm:inline" v-text="t('inquire.title')"></span>
+                </a>
+                {% endif %}
+
+                <!-- New Recording Button -->
+                <button @click="switchToUploadView" 
+                        class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm sm:px-4 sm:py-2 sm:min-w-[120px] sm:flex sm:items-center sm:gap-2 sm:justify-center">
+                    <i class="fas fa-plus mr-1"></i><span v-text="t('nav.newRecording')"></span>
+                </button>
+
+                <!-- User menu -->
+                {% if current_user.is_authenticated %}
+                <div class="relative">
+                    <button @click="isUserMenuOpen = !isUserMenuOpen" 
+                            class="flex items-center gap-1 sm:gap-2 p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200"
+                            :title="t('admin.userMenu')">
+                        <i class="fas fa-user-circle text-lg"></i>
+                        <span class="hidden lg:inline text-sm">{{ current_user.name if current_user.is_authenticated else 'User' }}</span>
+                        <i class="fas fa-chevron-down text-xs hidden sm:inline"></i>
+                    </button>
+                    
+                    <!-- User dropdown -->
+                    <div v-if="isUserMenuOpen"
+                         class="absolute right-0 mt-2 w-56 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-50">
+                        <a href="/account" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-cog mr-2 w-4 text-center"></i><span v-text="t('nav.settings')"></span>
+                        </a>
+                        <a href="/account#tags" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-tags mr-2 w-4 text-center"></i><span v-text="t('help.tagManagement')"></span>
+                        </a>
+                        <button @click="openSharesList" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i class="fas fa-share-alt mr-2 w-4 text-center"></i><span v-text="t('modal.sharedTranscripts')"></span>
+                        </button>
+                        {% if current_user.is_admin or is_team_admin %}
+                        <a href="/admin" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-{% if current_user.is_admin %}user-shield{% else %}users-cog{% endif %} mr-2 w-4 text-center"></i>
+                            <span v-text="{% if current_user.is_admin %}t('admin.title'){% else %}t('nav.teamManagement'){% endif %}"></span>
+                        </a>
+                        {% endif %}
+                        <div class="border-t border-[var(--border-primary)] my-1"></div>
+                        <button @click="toggleDarkMode" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'" class="mr-2 w-4 text-center"></i>
+                            <span v-text="isDarkMode ? t('nav.lightMode') : t('nav.darkMode')"></span>
+                        </button>
+                        <button @click="openColorSchemeModal" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i class="fas fa-palette mr-2 w-4 text-center"></i>
+                            <span v-text="t('modal.colorScheme')"></span>
+                        </button>
+                        <div class="border-t border-[var(--border-primary)] my-1"></div>
+                        <a href="/logout" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-sign-out-alt mr-2 w-4 text-center"></i><span v-text="t('nav.signOut')"></span>
+                        </a>
+                    </div>
+                </div>
+                {% endif %}
+            </div>
+        </header>
+
+        <div class="flex-1 flex overflow-hidden relative">
+            <!-- Mobile Sidebar Backdrop -->
+            <div v-if="!isSidebarCollapsed && isMobileScreen" 
+                 @click="toggleSidebar"
+                 class="fixed inset-0 bg-black bg-opacity-50 z-40 lg:hidden">
+            </div>
+            
+            <!-- Sidebar -->
+            <aside :class="['sidebar', isSidebarCollapsed ? 'collapsed' : '']">
+                <div class="sidebar-content-wrapper">
+                    <!-- Sidebar Header -->
+                    <div class="p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                        <div class="flex items-center justify-between mb-4">
+                            <h2 class="text-lg font-semibold" v-text="t('nav.recording')"></h2>
+                            <div class="flex gap-2">
+                                {% if inquire_mode_enabled %}
+                                <a href="/inquire" 
+                                   class="px-2 py-1.5 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:opacity-80 transition-opacity text-sm">
+                                    <i class="fas fa-search"></i>
+                                </a>
+                                {% endif %}
+                                <button @click="switchToUploadView" 
+                                        class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm">
+                                    <i class="fas fa-plus mr-1"></i><span v-text="t('common.new')"></span>
+                                </button>
+                            </div>
+                        </div>
+                        
+                        <!-- Search and Sort Controls -->
+                        <div class="space-y-3">
+                            <!-- Filter Toggle Button -->
+                            <div class="flex items-center space-x-2">
+                                <button @click="showAdvancedFilters = !showAdvancedFilters" 
+                                        class="flex-1 flex items-center justify-between px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm hover:bg-[var(--bg-tertiary)] transition-colors">
+                                    <span class="flex items-center">
+                                        <i class="fas fa-filter mr-2 text-[var(--text-muted)]"></i>
+                                        <span v-if="!searchQuery && filterTags.length === 0 && !filterDatePreset && !filterDateRange.start && !filterDateRange.end && !filterTextQuery"
+                                              v-text="t('sidebar.searchRecordings')">
+                                        </span>
+                                        <span v-else class="text-[var(--text-accent)]">
+                                            Active filters (${ (filterTags.length > 0 ? 1 : 0) + (filterDatePreset || filterDateRange.start || filterDateRange.end ? 1 : 0) + (filterTextQuery ? 1 : 0) })
+                                        </span>
+                                    </span>
+                                    <i :class="['fas fa-chevron-down transition-transform text-[var(--text-muted)]', showAdvancedFilters ? 'rotate-180' : '']"></i>
+                                </button>
+                                <button v-if="searchQuery || filterTags.length > 0 || filterDatePreset || filterDateRange.start || filterDateRange.end || filterTextQuery"
+                                        @click="clearAllFilters"
+                                        class="px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm hover:bg-[var(--bg-tertiary)] hover:text-[var(--text-primary)] transition-colors"
+                                        :title="t('buttons.clearAllFilters')">
+                                    <i class="fas fa-times text-[var(--text-muted)]"></i>
+                                </button>
+                            </div>
+                            
+                            <!-- Advanced Filters Panel -->
+                            <div v-show="showAdvancedFilters" class="p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg space-y-3">
+                                <!-- Text Search -->
+                                <div>
+                                    <label class="block text-xs font-medium text-[var(--text-muted)] mb-1" v-text="t('sidebar.filters')"></label>
+                                    <div class="relative">
+                                        <input v-model="filterTextQuery" 
+                                               type="text" 
+                                               :placeholder="t('sidebar.searchRecordings')" 
+                                               class="w-full px-3 py-1.5 pl-8 pr-8 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                        <i class="fas fa-search absolute left-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] text-xs"></i>
+                                        <button v-if="filterTextQuery" 
+                                                @click="filterTextQuery = ''"
+                                                class="absolute right-2.5 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)] text-xs"
+                                                :title="t('buttons.clearSearchText')">
+                                            <i class="fas fa-times"></i>
+                                        </button>
+                                    </div>
+                                </div>
+                                
+                                <!-- Tag Filter -->
+                                <div>
+                                    <label class="block text-xs font-medium text-[var(--text-muted)] mb-1" v-text="t('tags.filterByTag')"></label>
+                                    <div class="flex flex-wrap gap-1.5">
+                                        <button v-for="tag in availableTags" 
+                                                :key="tag.id"
+                                                @click="filterTags.includes(tag.id) ? filterTags = filterTags.filter(id => id !== tag.id) : filterTags.push(tag.id)"
+                                                :class="[
+                                                    'px-2 py-1 rounded-full text-xs font-medium transition-all',
+                                                    filterTags.includes(tag.id) 
+                                                        ? 'bg-[var(--bg-accent)] text-[var(--text-accent)] ring-1 ring-[var(--border-accent)]' 
+                                                        : 'bg-[var(--bg-secondary)] text-[var(--text-secondary)] hover:bg-[var(--bg-input)]'
+                                                ]">
+                                            <span class="inline-block w-2 h-2 rounded-full mr-1" :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                            ${ tag.name }
+                                        </button>
+                                    </div>
+                                    <p v-if="availableTags.length === 0" class="text-xs text-[var(--text-muted)] italic" v-text="t('tags.noTags')"></p>
+                                </div>
+                                
+                                <!-- Date Filter -->
+                                <div>
+                                    <label class="block text-xs font-medium text-[var(--text-muted)] mb-1" v-text="t('sidebar.dateRange')"></label>
+                                    <div class="grid grid-cols-3 gap-1.5 mb-2">
+                                        <button v-for="preset in datePresetOptions"
+                                                :key="preset.value"
+                                                @click="filterDatePreset = filterDatePreset === preset.value ? '' : preset.value; filterDateRange = { start: '', end: '' }"
+                                                :class="[
+                                                    'px-2 py-1 rounded-md text-xs transition-all',
+                                                    filterDatePreset === preset.value 
+                                                        ? 'bg-[var(--bg-accent)] text-[var(--text-accent)]' 
+                                                        : 'bg-[var(--bg-secondary)] text-[var(--text-secondary)] hover:bg-[var(--bg-input)]'
+                                                ]"
+                                                :title="preset.label">
+                                            ${ preset.label }
+                                        </button>
+                                    </div>
+                                    <div class="grid grid-cols-2 gap-2">
+                                        <div>
+                                            <input v-model="filterDateRange.start" 
+                                                   @change="filterDatePreset = ''"
+                                                   type="date" 
+                                                   class="w-full px-2 py-1 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]"
+                                                   :placeholder="t('form.dateFrom')">
+                                        </div>
+                                        <div>
+                                            <input v-model="filterDateRange.end" 
+                                                   @change="filterDatePreset = ''"
+                                                   type="date" 
+                                                   class="w-full px-2 py-1 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-md text-xs focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]"
+                                                   :placeholder="t('form.dateTo')">
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                            
+                            <!-- Sort Toggle -->
+                            <button @click="sortBy = sortBy === 'created_at' ? 'meeting_date' : 'created_at'"
+                                    class="w-full flex items-center justify-between px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm hover:bg-[var(--bg-tertiary)] transition-colors">
+                                <span class="flex items-center">
+                                    <i :class="['fas mr-2 text-[var(--text-muted)]', sortBy === 'meeting_date' ? 'fa-calendar' : 'fa-upload']"></i>
+                                    <span v-text="t('sidebar.sortBy')"></span>: <span v-text="sortBy === 'meeting_date' ? t('sidebar.sortByMeetingDate') : t('sidebar.sortByDate')"></span>
+                                </span>
+                                <i class="fas fa-exchange-alt text-[var(--text-muted)]"></i>
+                            </button>
+
+                            <!-- Archived Recordings Toggle -->
+                            <button @click="showArchivedRecordings = !showArchivedRecordings"
+                                    :class="[
+                                        'w-full flex items-center justify-between px-3 py-2 border rounded-lg text-sm transition-colors',
+                                        showArchivedRecordings
+                                            ? 'bg-[var(--bg-accent)] border-[var(--border-accent)] text-[var(--text-accent)]'
+                                            : 'bg-[var(--bg-input)] border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]'
+                                    ]">
+                                <span class="flex items-center">
+                                    <i class="fas fa-archive mr-2"></i>
+                                    <span v-text="t('sidebar.archivedRecordings')"></span>
+                                </span>
+                                <i :class="['fas', showArchivedRecordings ? 'fa-toggle-on' : 'fa-toggle-off']"></i>
+                            </button>
+
+                            <!-- Shared with Me Toggle -->
+                            <button v-if="enableInternalSharing" @click="showSharedWithMe = !showSharedWithMe"
+                                    :class="[
+                                        'w-full flex items-center justify-between px-3 py-2 border rounded-lg text-sm transition-colors mt-2',
+                                        showSharedWithMe
+                                            ? 'bg-[var(--bg-accent)] border-[var(--border-accent)] text-[var(--text-accent)]'
+                                            : 'bg-[var(--bg-input)] border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]'
+                                    ]">
+                                <span class="flex items-center">
+                                    <i class="fas fa-users mr-2"></i>
+                                    <span v-text="t('sidebar.sharedWithMe')"></span>
+                                </span>
+                                <i :class="['fas', showSharedWithMe ? 'fa-toggle-on' : 'fa-toggle-off']"></i>
+                            </button>
+                        </div>
+                    </div>
+
+                    <!-- Recordings List -->
+                    <div class="flex-1 overflow-y-auto p-4" 
+                         @scroll="(e) => {
+                            const element = e.target;
+                            const threshold = 100; // Load more when 100px from bottom
+                            if (element.scrollHeight - element.scrollTop - element.clientHeight < threshold) {
+                                loadMoreRecordings();
+                            }
+                         }">
+                        <div v-if="isLoadingRecordings && recordings.length === 0" class="text-center py-8">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.loadingRecordings')"></p>
+                        </div>
+                        
+                        <div v-else-if="recordings.length === 0 && !isLoadingRecordings" class="text-center py-8">
+                            <i class="fas fa-microphone-slash text-3xl text-[var(--text-muted)] mb-3"></i>
+                            <p class="text-[var(--text-muted)]" v-text="t('sidebar.noRecordings')"></p>
+                            <p v-if="searchQuery.trim()" class="text-sm text-[var(--text-muted)] mt-1">
+                                <span v-text="t('help.tryAdjustingSearch')"></span> <button @click="clearAllFilters()" class="text-[var(--text-accent)] hover:underline" v-text="t('help.clearFilters')"></button>
+                            </p>
+                        </div>
+                        
+                        <div v-if="recordings.length > 0" class="space-y-2">
+                            <div v-for="group in groupedRecordings" :key="group.title" class="mb-6">
+                                <h3 class="text-xs font-semibold text-[var(--text-muted)] uppercase tracking-wide mb-2">
+                                    ${group.title}
+                                </h3>
+                                <div class="space-y-1">
+                                    <div v-for="recording in group.items" 
+                                         :key="recording.id"
+                                         @click="selectRecording(recording)"
+                                         :class="[
+                                             'p-3 rounded-lg cursor-pointer transition-all duration-200 border',
+                                             selectedRecording?.id === recording.id 
+                                                 ? 'bg-[var(--bg-accent)] border-[var(--border-accent)]' 
+                                                 : 'bg-[var(--bg-tertiary)] border-transparent hover:bg-[var(--bg-accent-hover)]'
+                                         ]">
+                                        <!-- Title and Status Row -->
+                                        <div class="flex items-center justify-between mb-1">
+                                            <h4 class="font-medium text-sm truncate flex-1 mr-2" :class="selectedRecording?.id === recording.id ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]'">
+                                                ${ recording.title || t('common.untitled') }
+                                            </h4>
+                                            <div class="flex items-center gap-0.5 flex-shrink-0">
+                                                <!-- Combined sharing status badge -->
+                                                <span v-if="recording.is_shared || recording.has_group_tags || recording.shared_with_count > 0 || recording.public_share_count > 0"
+                                                      class="inline-flex items-center justify-center gap-1 h-5 px-1.5 rounded-full text-[9px] leading-none bg-violet-100 dark:bg-violet-900/50 border border-violet-300 dark:border-violet-600"
+                                                      :title="[
+                                                          recording.is_shared ? t('sharing.sharedBy') + ' ' + (recording.owner_username || t('sharing.unknown')) : '',
+                                                          recording.has_group_tags ? t('sharing.teamRecording') : '',
+                                                          !recording.is_shared && recording.shared_with_count > 0 ? t('sharing.sharedWith') + ' ' + recording.shared_with_count + ' ' + t('sharing.users') : '',
+                                                          !recording.is_shared && recording.public_share_count > 0 ? recording.public_share_count + ' ' + t('sharing.publicLinksGenerated') : ''
+                                                      ].filter(s => s).join(' • ')">
+                                                    <i v-if="recording.is_shared" class="fas fa-arrow-down text-purple-600 dark:text-purple-400" style="line-height: 1;"></i>
+                                                    <i v-if="recording.has_group_tags" class="fas fa-users text-blue-600 dark:text-blue-400" style="line-height: 1;"></i>
+                                                    <i v-if="!recording.is_shared && recording.shared_with_count > 0" class="fas fa-arrow-up text-indigo-600 dark:text-indigo-400" style="line-height: 1;"></i>
+                                                    <i v-if="!recording.is_shared && recording.public_share_count > 0" class="fas fa-globe text-teal-600 dark:text-teal-400" style="line-height: 1;"></i>
+                                                </span>
+
+                                                <!-- Show Audio Deleted badge -->
+                                                <span v-if="recording.audio_deleted_at"
+                                                      class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-gray-200 dark:bg-gray-700 border border-gray-300 dark:border-gray-600"
+                                                      :title="t('sidebar.archived')">
+                                                    <i class="fas fa-file-audio text-gray-600 dark:text-gray-400"></i>
+                                                </span>
+
+                                                <!-- Show Failed status for failed recordings -->
+                                                <span v-if="recording.status === 'FAILED'"
+                                                      class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-red-100 dark:bg-red-900/50 border border-red-300 dark:border-red-700 text-red-700 dark:text-red-400">
+                                                    <i class="fas fa-exclamation-circle"></i>
+                                                </span>
+
+                                                <!-- Show Processing status for non-completed recordings -->
+                                                <span v-else-if="recording.status !== 'COMPLETED'"
+                                                      :class="getStatusClass(recording.status)"
+                                                      class="status-badge">
+                                                    ${formatStatus(recording.status)}
+                                                </span>
+
+                                                <!-- For completed recordings, show highlight and inbox badges -->
+                                                <template v-else>
+                                                    <span v-if="recording.is_highlighted"
+                                                          @click.stop="toggleHighlight(recording)"
+                                                          class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-amber-100 dark:bg-amber-900/50 border border-amber-400 dark:border-amber-600 cursor-pointer hover:bg-amber-200 dark:hover:bg-amber-800/50"
+                                                          :title="t('sidebar.removeFromHighlighted')">
+                                                        <i class="fas fa-star text-amber-600 dark:text-amber-400"></i>
+                                                    </span>
+                                                    <span v-if="recording.is_inbox"
+                                                          @click.stop="toggleInbox(recording)"
+                                                          class="inline-flex items-center justify-center h-5 px-1.5 rounded-full text-[9px] leading-none bg-blue-100 dark:bg-blue-900/50 border border-blue-400 dark:border-blue-600 cursor-pointer hover:bg-blue-200 dark:hover:bg-blue-800/50"
+                                                          :title="t('sidebar.markAsRead')">
+                                                        <i class="fas fa-inbox text-blue-600 dark:text-blue-400"></i>
+                                                    </span>
+                                                </template>
+                                            </div>
+                                        </div>
+
+                                        <!-- Date and Participants -->
+                                        <div class="flex flex-wrap items-center gap-x-3 gap-y-1 mt-1 text-xs text-[var(--text-muted)]">
+                                            <!-- Date -->
+                                            <div class="flex items-center flex-shrink-0">
+                                                <i class="fas fa-calendar-alt mr-1 text-[var(--text-muted)]" style="font-size: 10px;"></i>
+                                                ${formatShortDate(sortBy === 'meeting_date' ? recording.meeting_date : recording.created_at)}
+                                            </div>
+
+                                            <!-- Participants -->
+                                            <div v-if="recording.participants" class="flex items-center min-w-0 flex-1">
+                                                <i class="fas fa-users mr-1 text-[var(--text-muted)] flex-shrink-0" style="font-size: 10px;"></i>
+                                                <span class="truncate">
+                                                    ${recording.participants}
+                                                </span>
+                                            </div>
+                                        </div>
+
+                                        <!-- Tags -->
+                                        <div v-if="getRecordingTags(recording).length > 0" class="flex flex-wrap gap-1 mt-1">
+                                            <button v-for="tag in getRecordingTags(recording).slice(0, 4)" :key="tag.id"
+                                                    @click.stop="filterByTag(tag)"
+                                                    class="inline-flex items-center px-1.5 py-0.5 rounded-md text-xs font-medium text-white hover:opacity-80 transition-all cursor-pointer"
+                                                    :style="{ backgroundColor: tag.color }"
+                                                    :title="(tag.group_id ? '👥 Group Tag: ' : 'Filter by ') + tag.name">
+                                                <i v-if="tag.group_id" class="fas fa-users mr-1" style="font-size: 9px;"></i>
+                                                <span v-text="tag.name"></span>
+                                            </button>
+                                            <span v-if="getRecordingTags(recording).length > 4"
+                                                  class="inline-flex items-center px-1.5 py-0.5 rounded-md text-xs text-[var(--text-muted)]"
+                                                  :title="getRecordingTags(recording).slice(4).map(t => t.name).join(', ')">
+                                                +${getRecordingTags(recording).length - 4}
+                                            </span>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                            
+                            <!-- Load More Indicator -->
+                            <div v-if="isLoadingMore" class="text-center py-4">
+                                <i class="fas fa-spinner fa-spin text-lg text-[var(--text-muted)]"></i>
+                                <p class="text-sm text-[var(--text-muted)] mt-1" v-text="t('help.loadingMore')"></p>
+                            </div>
+                            
+                            <!-- End of Results Indicator -->
+                            <div v-else-if="!hasNextPage && totalRecordings > 0" class="text-center py-4 text-xs text-[var(--text-muted)]">
+                                <i class="fas fa-check-circle mr-1"></i>
+                                <span v-text="t('help.allRecordingsLoaded')"></span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </aside>
+
+            <!-- Main Content -->
+            <main class="main-content" 
+                  :class="{ 'sidebar-open': !isSidebarCollapsed }">
+
+                <div class="flex-1 flex flex-col overflow-hidden">
+                <!-- Upload View -->
+                <div v-if="currentView === 'upload'" class="flex-1 flex items-center justify-center p-4 md:p-8 overflow-y-auto">
+                    <div class="max-w-lg w-full my-auto">
+                        <div class="text-center mb-8">
+                            <i class="fas fa-microphone text-5xl md:text-6xl text-[var(--text-accent)] mb-4"></i>
+                            <h2 class="text-2xl md:text-3xl font-bold mb-2" v-text="t('upload.title')"></h2>
+                            <p class="text-[var(--text-muted)]" v-text="t('upload.dropzone')"></p>
+                        </div>
+                        
+                        <div class="bg-[var(--bg-secondary)] p-6 rounded-xl border border-[var(--border-primary)]">
+                            <!-- File Upload Area -->
+                            <div @drop="handleDrop" @dragover="handleDragOver" @dragleave="handleDragLeave" @click="$refs.fileInput.click()"
+                                 :class="['border-2 border-dashed rounded-xl p-8 text-center cursor-pointer transition-all duration-300', dragover ? 'border-[var(--border-accent)] bg-[var(--bg-accent)]' : 'border-[var(--border-secondary)] hover:border-[var(--border-accent)]']">
+                                <i class="fas fa-cloud-upload-alt text-3xl text-[var(--text-muted)] mb-3"></i>
+                                <p class="text-[var(--text-secondary)] mb-2" v-text="t('upload.dropzone')"></p>
+                                <p class="text-xs text-[var(--text-muted)]" v-text="t('upload.supportedFormats')"></p>
+                            </div>
+                            <input ref="fileInput" type="file" @change="handleFileSelect" accept="audio/*,video/mp4,video/quicktime,video/x-msvideo,video/webm,.mp4,.mov,.avi,.mkv,.webm" multiple class="hidden">
+
+                            <!-- Queued Files Display -->
+                            <div v-if="pendingQueueFiles.length > 0" class="mt-4">
+                                <div class="flex items-center justify-between mb-2">
+                                    <h4 class="text-sm font-medium text-[var(--text-secondary)]">
+                                        <i class="fas fa-list mr-1"></i>
+                                        Files to Upload (${pendingQueueFiles.length})
+                                    </h4>
+                                </div>
+                                <div class="space-y-2 max-h-40 overflow-y-auto">
+                                    <div v-for="item in pendingQueueFiles" :key="item.clientId"
+                                         class="flex items-center justify-between p-2 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)]">
+                                        <div class="flex items-center gap-2 min-w-0 flex-1">
+                                            <i class="fas fa-file-audio text-[var(--text-muted)]"></i>
+                                            <span class="text-sm text-[var(--text-primary)] truncate">${item.file.name}</span>
+                                            <span class="text-xs text-[var(--text-muted)] flex-shrink-0">(${formatFileSize(item.file.size)})</span>
+                                        </div>
+                                        <button @click="removeFromQueue(item.clientId)"
+                                                class="ml-2 p-1 text-[var(--text-muted)] hover:text-red-500 transition-colors flex-shrink-0"
+                                                title="Remove from queue">
+                                            <i class="fas fa-times"></i>
+                                        </button>
+                                    </div>
+                                </div>
+                                <!-- Upload Button -->
+                                <button @click="startUpload"
+                                        class="w-full mt-3 px-4 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors flex items-center justify-center gap-2 font-medium">
+                                    <i class="fas fa-cloud-upload-alt"></i>
+                                    <span>Upload ${pendingQueueFiles.length} File${pendingQueueFiles.length !== 1 ? 's' : ''}</span>
+                                </button>
+                            </div>
+
+                            <!-- Divider (hidden when files are selected) -->
+                            <div v-if="pendingQueueFiles.length === 0" class="my-6 flex items-center">
+                                <div class="flex-grow border-t border-[var(--border-secondary)]"></div>
+                                <span class="flex-shrink mx-4 text-xs text-[var(--text-muted)] uppercase" v-text="t('common.or')"></span>
+                                <div class="flex-grow border-t border-[var(--border-secondary)]"></div>
+                            </div>
+
+                            <!-- Audio Recording Options (hidden when files are selected) -->
+                            <div v-if="pendingQueueFiles.length === 0" class="space-y-3">
+                                <h3 class="text-sm font-medium text-[var(--text-secondary)] text-center" v-text="t('recording.title')"></h3>
+                                
+                                <!-- Microphone Recording -->
+                                <button @click="startRecording('microphone')"
+                                        class="w-full px-4 py-3 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors flex items-center justify-center gap-2">
+                                    <i class="fas fa-microphone"></i>
+                                    <span v-text="t('recording.microphone')"></span>
+                                </button>
+                                
+                                <!-- System Audio Recording -->
+                                <button @click="startRecording('system')"
+                                        v-if="canRecordSystemAudio"
+                                        class="w-full px-4 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors flex items-center justify-center gap-2">
+                                    <i class="fas fa-desktop"></i>
+                                    <span v-text="t('recording.systemAudio')"></span>
+                                </button>
+                                
+                                <!-- Both Audio Sources -->
+                                <button @click="startRecording('both')"
+                                        v-if="canRecordSystemAudio"
+                                        class="w-full px-4 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors flex items-center justify-center gap-2">
+                                    <i class="fas fa-microphone"></i>
+                                    <i class="fas fa-desktop ml-1"></i>
+                                    <span v-text="t('recording.microphoneAndSystem')"></span>
+                                </button>
+                                
+                                <!-- Help Text -->
+                                <div class="text-xs text-[var(--text-muted)] space-y-1 mt-3">
+                                    <div class="flex items-center justify-between">
+                                        <span><strong v-text="t('recording.microphone') + ':'"></strong> <span v-text="t('help.microphoneDesc')"></span></span>
+                                        <i class="fas fa-microphone text-red-500 flex-shrink-0"></i>
+                                    </div>
+                                    <div v-if="canRecordSystemAudio" class="flex items-center justify-between">
+                                        <span><strong v-text="t('recording.systemAudio') + ':'"></strong> <span v-text="t('help.systemAudioDesc')"></span></span>
+                                        <i class="fas fa-desktop text-blue-500 flex-shrink-0"></i>
+                                    </div>
+                                    <div v-if="canRecordSystemAudio" class="flex items-center justify-between">
+                                        <span><strong v-text="t('recording.microphoneAndSystem') + ':'"></strong> <span v-text="t('help.bothAudioDesc')"></span></span>
+                                        <div class="flex items-center gap-1 flex-shrink-0">
+                                            <i class="fas fa-microphone text-purple-500"></i>
+                                            <i class="fas fa-desktop text-purple-500"></i>
+                                        </div>
+                                    </div>
+                                    <div v-if="!canRecordSystemAudio" class="text-amber-600 dark:text-amber-400">
+                                        <i class="fas fa-exclamation-triangle mr-1"></i>
+                                        ${ t('recording.systemAudioNotSupported') }
+                                        <button @click="showSystemAudioHelp = true" class="ml-2 text-blue-500 hover:text-blue-600 underline text-sm">
+                                            <span v-text="t('buttons.help')"></span>
+                                        </button>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Tag Selection -->
+                            <div class="mt-4">
+                                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                                    <i class="fas fa-tags mr-1 text-[var(--text-muted)]"></i>
+                                    ${ t('tags.title') }
+                                </label>
+                                
+                                <!-- Selected Tags Display - Compact -->
+                                <div v-if="selectedTags.length > 0" class="mb-2">
+                                    <div class="p-1.5 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] max-h-16 overflow-y-auto">
+                                        <div class="flex flex-wrap gap-1">
+                                            <span v-for="(tag, index) in selectedTags" :key="tag.id" 
+                                                  class="inline-flex items-center px-1.5 py-0.5 rounded-full text-[11px] font-medium text-white"
+                                                  :style="{ backgroundColor: tag.color }">
+                                                <span class="opacity-75 mr-0.5 text-[9px]">${index + 1}.</span>
+                                                <span>${tag.name}</span>
+                                                <button @click="removeTagFromSelection(tag.id)" 
+                                                        class="ml-1 hover:opacity-100 opacity-70">
+                                                    <i class="fas fa-times" style="font-size: 9px;"></i>
+                                                </button>
+                                            </span>
+                                        </div>
+                                    </div>
+                                    <p class="text-[10px] text-[var(--text-muted)] mt-0.5">
+                                        <i class="fas fa-info-circle mr-0.5" style="font-size: 9px;"></i>
+                                        Tags ordered by priority
+                                    </p>
+                                </div>
+                                
+                                <!-- Tag Selection Container - Compact -->
+                                <div v-if="availableTags.filter(tag => !selectedTagIds.includes(tag.id)).length > 0" 
+                                     class="border border-[var(--border-secondary)] rounded-md bg-[var(--bg-tertiary)] p-2">
+                                    <!-- Search Filter (always visible if tags available) -->
+                                    <div class="mb-1.5">
+                                        <div class="relative">
+                                            <input v-model="uploadTagSearchFilter" 
+                                                   type="text" 
+                                                   :placeholder="t('tagsModal.searchTags')"
+                                                   class="w-full px-2 py-1 pl-6 text-xs bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                            <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 9px;"></i>
+                                            <button v-if="uploadTagSearchFilter" 
+                                                    @click="uploadTagSearchFilter = ''"
+                                                    class="absolute right-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                                <i class="fas fa-times" style="font-size: 9px;"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+                                    
+                                    <!-- Available Tags Grid - Fixed Height -->
+                                    <div v-if="filteredAvailableTagsForUpload.length > 0" 
+                                         class="overflow-y-auto" 
+                                         style="max-height: 100px;">
+                                        <div class="grid grid-cols-2 gap-1">
+                                            <button v-for="tag in filteredAvailableTagsForUpload" 
+                                                    :key="tag.id"
+                                                    @click="addTagToSelection(tag.id)"
+                                                    class="group flex items-center justify-between px-1.5 py-1 rounded border border-[var(--border-secondary)] hover:border-[var(--border-focus)] bg-[var(--bg-primary)] hover:bg-[var(--bg-secondary)] transition-all">
+                                                <div class="flex items-center gap-1 min-w-0">
+                                                    <span class="w-2 h-2 rounded-full flex-shrink-0" 
+                                                          :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                                    <span class="text-[11px] text-[var(--text-primary)] truncate" v-text="tag.name"></span>
+                                                </div>
+                                                <i class="fas fa-plus text-[var(--text-muted)] group-hover:text-[var(--text-accent)] transition-colors" style="font-size: 9px;"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+                                    <div v-else class="py-2 text-center">
+                                        <p class="text-[11px] text-[var(--text-muted)]">
+                                            <i class="fas fa-search mr-1" style="font-size: 9px;"></i>
+                                            No matching tags
+                                        </p>
+                                    </div>
+                                </div>
+                                <!-- Empty States -->
+                                <div v-else-if="availableTags.length === 0" 
+                                     class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                    <p class="text-xs text-[var(--text-muted)] text-center">
+                                        <i class="fas fa-info-circle mr-1" style="font-size: 10px;"></i>
+                                        <span v-text="t('help.noTagsCreated')"></span> <a href="/account#tags" class="text-[var(--text-accent)] hover:underline" v-text="t('help.createTags')"></a>
+                                    </p>
+                                </div>
+                                <div v-else class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                    <p class="text-xs text-[var(--text-muted)] text-center">
+                                        <i class="fas fa-check-circle mr-1" style="font-size: 10px;"></i>
+                                        All tags selected
+                                    </p>
+                                </div>
+                                
+                                <p v-if="selectedTags.some(tag => tag.custom_prompt)" class="text-xs text-[var(--text-muted)] mt-1">
+                                    <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                                    Selected tags include custom summary prompts
+                                </p>
+                                <p v-if="selectedTags.length > 0 && useAsrEndpoint && selectedTags.some(tag => tag.default_language || tag.default_min_speakers || tag.default_max_speakers)" 
+                                   class="text-xs text-[var(--text-muted)] mt-1">
+                                    <i class="fas fa-cog mr-1 text-[var(--text-accent)]"></i>
+                                    First tag's ASR settings will be applied: ${selectedTags[0].name}
+                                </p>
+                            </div>
+
+                            <!-- Advanced Options for ASR (collapsible) -->
+                            <div v-if="useAsrEndpoint" class="mt-4">
+                                <button @click="showAdvancedOptions = !showAdvancedOptions" 
+                                        class="w-full flex items-center justify-between px-3 py-2 bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] transition-colors text-xs font-medium">
+                                    <span class="flex items-center gap-2 text-[var(--text-secondary)]">
+                                        <i class="fas fa-cog text-[var(--text-muted)]"></i>
+                                        <span v-text="t('help.advancedAsrOptions')"></span>
+                                    </span>
+                                    <i :class="['fas text-[var(--text-muted)]', showAdvancedOptions ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                                </button>
+                                
+                                <div v-show="showAdvancedOptions" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md space-y-3 border border-[var(--border-secondary)]">
+                                    <!-- Language Selection -->
+                                    <div>
+                                        <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                            Transcription Language
+                                        </label>
+                                        <select v-model="uploadLanguage" 
+                                                class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                            <option v-for="lang in languageOptions" :key="lang.value" :value="lang.value" v-text="lang.label"></option>
+                                        </select>
+                                    </div>
+                                    
+                                    <!-- Speaker Settings -->
+                                    <div class="grid grid-cols-2 gap-3">
+                                        <div>
+                                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.minSpeakers')">
+                                            </label>
+                                            <input v-model.number="uploadMinSpeakers" 
+                                                   type="number" 
+                                                   min="1" 
+                                                   max="20"
+                                                   class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                        </div>
+                                        <div>
+                                            <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.maxSpeakers')">
+                                            </label>
+                                            <input v-model.number="uploadMaxSpeakers" 
+                                                   type="number" 
+                                                   min="1" 
+                                                   max="20"
+                                                   class="w-full px-2 py-1 text-sm bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                        </div>
+                                    </div>
+                                    
+                                    <p class="text-xs text-[var(--text-muted)] pt-1">
+                                        <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                                        Settings apply to all files in this session
+                                    </p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Recording View -->
+                <div v-else-if="currentView === 'recording'" class="flex-1 flex flex-col p-2 md:p-8 bg-[var(--bg-primary)] min-h-0">
+                    <div class="flex-1 flex flex-col max-w-4xl w-full mx-auto bg-[var(--bg-secondary)] rounded-xl border border-[var(--border-primary)] min-h-0 overflow-hidden">
+                        <!-- Top: Visualizer and Status (Fixed) -->
+                        <div class="flex-shrink-0 p-3 md:p-6 text-center bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)]">
+                            <div v-if="isRecording" class="w-full mx-auto mb-3 md:mb-4">
+                                <!-- Dual visualizer for 'both' mode -->
+                                <div v-if="recordingMode === 'both'" class="max-w-4xl mx-auto flex gap-2 md:gap-4">
+                                    <div class="w-1/2 min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 flex flex-col bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2">
+                                        <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                                            <canvas ref="micVisualizer" class="w-full h-full"></canvas>
+                                        </div>
+                                        <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1" v-text="t('recording.microphone')"></p>
+                                    </div>
+                                    <div class="w-1/2 min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 flex flex-col bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2">
+                                        <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                                            <canvas ref="systemVisualizer" class="w-full h-full"></canvas>
+                                        </div>
+                                        <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1" v-text="t('recording.systemAudio')"></p>
+                                    </div>
+                                </div>
+                                <!-- Single visualizer for other modes -->
+                                <div v-else class="min-h-[8rem] md:min-h-[12rem] h-32 md:h-48 max-w-2xl mx-auto bg-[var(--bg-primary)] rounded-lg p-1.5 md:p-2 flex flex-col">
+                                    <div class="flex-1 w-full overflow-hidden rounded-md" style="min-height: 6rem;">
+                                        <canvas ref="visualizer" class="w-full h-full"></canvas>
+                                    </div>
+                                    <p class="text-xs text-[var(--text-muted)] pt-0.5 md:pt-1 capitalize">${recordingMode}</p>
+                                </div>
+                            </div>
+                            <div v-if="!isRecording && audioBlobURL" class="w-full mb-3 md:mb-4">
+                                <div class="audio-player-container">
+                                    <audio :src="audioBlobURL" controls class="w-full">
+                                        Your browser does not support the audio element.
+                                    </audio>
+                                </div>
+                            </div>
+
+                            <div>
+                                <div class="text-xl md:text-2xl font-mono text-[var(--text-accent)]">${formatTime(recordingTime)}</div>
+                                <p class="text-xs md:text-sm text-[var(--text-muted)]">${ isRecording ? 'Recording in progress...' : 'Recording finished' }</p>
+                                <!-- Real-time file size display -->
+                                <div v-if="isRecording && estimatedFileSize > 0" class="mt-1.5">
+                                    <p class="text-xs text-[var(--text-muted)]">
+                                        Estimated size: <span class="font-mono">${formatFileSize(estimatedFileSize)}</span>
+                                        <span v-if="actualBitrate > 0" class="ml-2">
+                                            (${Math.round(actualBitrate / 1000)}kbps)
+                                        </span>
+                                    </p>
+                                    <!-- Size warning indicator -->
+                                    <div v-if="estimatedFileSize > (maxRecordingMB * 1024 * 1024 * 0.8)" class="mt-0.5">
+                                        <div class="flex items-center text-xs text-amber-600 dark:text-amber-400">
+                                            <i class="fas fa-exclamation-triangle mr-1"></i>
+                                            <span v-text="t('help.approachingLimit', { limit: maxRecordingMB })"></span>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Mobile Background Recording Warning - Below timer -->
+                                <div v-if="isRecording && isMobileDevice"
+                                     class="mt-2 p-2 bg-amber-50 dark:bg-amber-900 dark:bg-opacity-20 border border-amber-300 dark:border-amber-700 rounded">
+                                    <div class="flex items-start gap-1.5 text-left">
+                                        <i class="fas fa-exclamation-triangle text-amber-600 dark:text-amber-400 flex-shrink-0 text-xs" style="margin-top: 2px;"></i>
+                                        <div class="flex-1 min-w-0">
+                                            <div class="text-xs text-amber-800 dark:text-amber-200 leading-snug">
+                                                <strong class="font-semibold">Keep this app visible!</strong>
+                                                <span class="block text-[10px] mt-0.5">Recording pauses if minimized or screen locked.</span>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Scrollable Content Area: Notes + Actions -->
+                        <div class="flex-1 min-h-0 overflow-y-auto flex flex-col">
+                            <!-- Middle: Notepad (flexible height) -->
+                            <div class="flex-1 p-3 md:p-6 flex flex-col" style="min-height: 200px;">
+                                <label for="recordingNotes" class="block text-sm font-medium text-[var(--text-secondary)] mb-1.5 flex-shrink-0">
+                                    <i class="fas fa-pencil-alt mr-1"></i>
+                                    Recording Notes (Markdown)
+                                </label>
+                                <div class="flex-1 recording-notes-editor" style="min-height: 150px;">
+                                    <textarea ref="recordingNotesEditor" v-model="recordingNotes"
+                                              class="w-full h-full bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg p-2 md:p-3 text-sm focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] resize-none"
+                                              :placeholder="t('form.notesPlaceholder')"></textarea>
+                                </div>
+                            </div>
+
+                            <!-- Bottom: Action Buttons -->
+                            <div class="flex-shrink-0 p-3 md:p-6 bg-[var(--bg-tertiary)] border-t border-[var(--border-primary)]">
+                            <div v-if="isRecording" class="text-center">
+                                <button @click="stopRecording"
+                                        class="px-6 md:px-8 py-2.5 md:py-3 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors animate-pulse text-sm md:text-base">
+                                    <i class="fas fa-stop mr-2"></i>Stop Recording
+                                </button>
+                            </div>
+                            <div v-if="!isRecording && audioBlobURL" class="flex flex-col gap-3 md:gap-4">
+                                <!-- Tag Selection -->
+                                <div>
+                                    <label for="recordingTagSelect" class="block text-sm font-medium text-[var(--text-secondary)] mb-1.5 md:mb-2">
+                                        <i class="fas fa-tags mr-1"></i>
+                                        Select Tags (optional, in priority order)
+                                    </label>
+                                    
+                                    <!-- Selected Tags Display - Compact -->
+                                    <div v-if="selectedTags.length > 0" class="mb-2">
+                                        <div class="p-1.5 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] max-h-16 overflow-y-auto">
+                                            <div class="flex flex-wrap gap-1">
+                                                <span v-for="(tag, index) in selectedTags" :key="tag.id" 
+                                                      class="inline-flex items-center px-1.5 py-0.5 rounded-full text-[11px] font-medium text-white"
+                                                      :style="{ backgroundColor: tag.color }">
+                                                    <span class="opacity-75 mr-0.5 text-[9px]">${index + 1}.</span>
+                                                    <span>${tag.name}</span>
+                                                    <button @click="removeTagFromSelection(tag.id)" 
+                                                            class="ml-1 hover:opacity-100 opacity-70">
+                                                        <i class="fas fa-times" style="font-size: 9px;"></i>
+                                                    </button>
+                                                </span>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    
+                                    <!-- Tag Selection Container - Compact -->
+                                    <div v-if="availableTags.filter(tag => !selectedTagIds.includes(tag.id)).length > 0" 
+                                         class="border border-[var(--border-secondary)] rounded-md bg-[var(--bg-tertiary)] p-2">
+                                        <!-- Search Filter -->
+                                        <div class="mb-1.5">
+                                            <div class="relative">
+                                                <input v-model="uploadTagSearchFilter" 
+                                                       type="text" 
+                                                       :placeholder="t('tagsModal.searchTags')"
+                                                       class="w-full px-2 py-1 pl-6 text-xs bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                                <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 9px;"></i>
+                                                <button v-if="uploadTagSearchFilter" 
+                                                        @click="uploadTagSearchFilter = ''"
+                                                        class="absolute right-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                                    <i class="fas fa-times" style="font-size: 9px;"></i>
+                                                </button>
+                                            </div>
+                                        </div>
+                                        <!-- Available Tags Grid -->
+                                        <div v-if="filteredAvailableTagsForUpload.length > 0" 
+                                             class="overflow-y-auto" 
+                                             style="max-height: 100px;">
+                                            <div class="grid grid-cols-2 gap-1">
+                                                <button v-for="tag in filteredAvailableTagsForUpload" 
+                                                        :key="tag.id"
+                                                        @click="addTagToSelection(tag.id)"
+                                                        class="group flex items-center justify-between px-1.5 py-1 rounded border border-[var(--border-secondary)] hover:border-[var(--border-focus)] bg-[var(--bg-primary)] hover:bg-[var(--bg-secondary)] transition-all">
+                                                    <div class="flex items-center gap-1 min-w-0">
+                                                        <span class="w-2 h-2 rounded-full flex-shrink-0" 
+                                                              :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                                        <span class="text-[11px] text-[var(--text-primary)] truncate" v-text="tag.name"></span>
+                                                    </div>
+                                                    <i class="fas fa-plus text-[var(--text-muted)] group-hover:text-[var(--text-accent)] transition-colors" style="font-size: 9px;"></i>
+                                                </button>
+                                            </div>
+                                        </div>
+                                        <div v-else class="py-2 text-center">
+                                            <p class="text-[11px] text-[var(--text-muted)]">
+                                                <i class="fas fa-search mr-1" style="font-size: 9px;"></i>
+                                                No matching tags
+                                            </p>
+                                        </div>
+                                    </div>
+                                    <!-- Empty States -->
+                                    <div v-else-if="availableTags.length === 0" 
+                                         class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                        <p class="text-xs text-[var(--text-muted)] text-center">
+                                            <i class="fas fa-info-circle mr-1" style="font-size: 10px;"></i>
+                                            <span v-text="t('help.noTagsCreated')"></span> <a href="/account#tags" class="text-[var(--text-accent)] hover:underline" v-text="t('help.createTags')"></a>
+                                        </p>
+                                    </div>
+                                    <div v-else class="p-2 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)]">
+                                        <p class="text-xs text-[var(--text-muted)] text-center">
+                                            <i class="fas fa-check-circle mr-1" style="font-size: 10px;"></i>
+                                            All tags selected
+                                        </p>
+                                    </div>
+                                    
+                                    <p v-if="selectedTags.some(tag => tag.custom_prompt)" class="text-xs text-[var(--text-muted)] mt-1">
+                                        <i class="fas fa-info-circle mr-1 text-[var(--text-accent)]"></i>
+                                        Selected tags include custom summary prompts
+                                    </p>
+                                    <p v-if="selectedTags.length > 0 && useAsrEndpoint && selectedTags.some(tag => tag.default_language || tag.default_min_speakers || tag.default_max_speakers)" 
+                                       class="text-xs text-[var(--text-muted)] mt-1">
+                                        <i class="fas fa-cog mr-1 text-[var(--text-accent)]"></i>
+                                        First tag's ASR settings will be applied: ${selectedTags[0].name}
+                                    </p>
+                                </div>
+
+                                <!-- Advanced Options for ASR (collapsible) -->
+                                <div v-if="useAsrEndpoint">
+                                    <button @click="showAdvancedOptions = !showAdvancedOptions" 
+                                            class="w-full flex items-center justify-between px-3 py-2 bg-[var(--bg-tertiary)] rounded-md hover:bg-[var(--bg-accent)] transition-colors text-xs font-medium">
+                                        <span class="flex items-center gap-2 text-[var(--text-secondary)]">
+                                            <i class="fas fa-cog text-[var(--text-muted)]"></i>
+                                            <span v-text="t('help.advancedAsrOptions')"></span>
+                                        </span>
+                                        <i :class="['fas text-[var(--text-muted)]', showAdvancedOptions ? 'fa-chevron-up' : 'fa-chevron-down']"></i>
+                                    </button>
+                                    
+                                    <div v-if="showAdvancedOptions" class="mt-2 p-3 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-secondary)] space-y-3">
+                                        <div>
+                                            <label for="recordingAsrLanguage" class="block text-xs font-medium text-[var(--text-secondary)] mb-1">
+                                                Language
+                                            </label>
+                                            <select id="recordingAsrLanguage" v-model="asrLanguage"
+                                                    class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                                <option v-for="lang in languageOptions" :key="lang.value" :value="lang.value" v-text="lang.label"></option>
+                                            </select>
+                                        </div>
+                                        
+                                        <div class="grid grid-cols-2 gap-3">
+                                            <div>
+                                                <label for="recordingAsrMinSpeakers" class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.minSpeakers')">
+                                                </label>
+                                                <input type="number" id="recordingAsrMinSpeakers" v-model="asrMinSpeakers"
+                                                       min="1" max="20" :placeholder="t('form.auto')"
+                                                       class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                            </div>
+
+                                            <div>
+                                                <label for="recordingAsrMaxSpeakers" class="block text-xs font-medium text-[var(--text-secondary)] mb-1" v-text="t('form.maxSpeakers')">
+                                                </label>
+                                                <input type="number" id="recordingAsrMaxSpeakers" v-model="asrMaxSpeakers"
+                                                       min="1" max="20" :placeholder="t('form.auto')"
+                                                       class="w-full px-2 py-1 bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)] text-xs">
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Upload/Discard Buttons -->
+                                <div class="flex flex-col sm:flex-row gap-3 justify-center">
+                                    <button @click="uploadRecordedAudio"
+                                        class="flex-1 px-6 py-3 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors flex items-center justify-center gap-2">
+                                    <i class="fas fa-upload"></i>
+                                    <span v-text="t('help.uploadRecordingNotes')"></span>
+                                </button>
+                                    <button @click="discardRecording"
+                                            class="px-6 py-3 bg-[var(--bg-danger)] text-white rounded-lg hover:bg-[var(--bg-danger-hover)] transition-colors flex items-center justify-center gap-2">
+                                        <i class="fas fa-trash"></i>
+                                        <span v-text="t('help.discard')"></span>
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Recording Detail View -->
+                <div v-else-if="currentView === 'detail' && selectedRecording" class="flex-1 flex flex-col overflow-hidden">
+                    <!-- Mobile View -->
+                    <div v-if="isMobileScreen" class="flex-1 flex flex-col overflow-hidden">
+                        <!-- Mobile Header -->
+                        <div class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] p-4 flex-shrink-0">
+                            <div @click="isMetadataExpanded = !isMetadataExpanded" class="cursor-pointer">
+                                <div class="flex items-start justify-between">
+                                    <div class="flex-1 min-w-0">
+                                        <h1 class="text-lg font-bold text-[var(--text-primary)] truncate">
+                                            ${selectedRecording.title || 'Untitled Recording'}
+                                        </h1>
+                                        <p class="text-sm text-[var(--text-muted)] truncate">
+                                            ${selectedRecording.participants || t('help.noParticipants')}
+                                        </p>
+                                        <!-- Tags and Share Status -->
+                                        <div v-if="getRecordingTags(selectedRecording).length > 0 || selectedRecording.is_shared || selectedRecording.shared_with_count > 0 || selectedRecording.public_share_count > 0" class="flex flex-wrap gap-1 mt-2">
+                                            <!-- Tags -->
+                                            <button v-for="tag in getRecordingTags(selectedRecording)" :key="tag.id"
+                                                    @click.stop="filterByTag(tag)"
+                                                    class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium text-white hover:opacity-80 transition-all cursor-pointer"
+                                                    :style="{ backgroundColor: tag.color }"
+                                                    :title="(tag.group_id ? '👥 Group Tag: ' : 'Filter by ') + tag.name">
+                                                <i v-if="tag.group_id" class="fas fa-users mr-1"></i>
+                                                <i v-else class="fas fa-tag mr-1"></i>
+                                                <span v-text="tag.name"></span>
+                                            </button>
+
+                                            <!-- Shared Status Badges -->
+                                            <span v-if="selectedRecording.is_shared"
+                                                  class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-purple-500 text-white">
+                                                <i class="fas fa-arrow-down mr-1"></i>
+                                                Shared
+                                            </span>
+
+                                            <span v-if="!selectedRecording.is_shared && selectedRecording.shared_with_count > 0"
+                                                  class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-indigo-500 text-white">
+                                                <i class="fas fa-arrow-up mr-1"></i>
+                                                ${selectedRecording.shared_with_count}
+                                            </span>
+
+                                            <span v-if="!selectedRecording.is_shared && selectedRecording.public_share_count > 0"
+                                                  class="inline-flex items-center px-2 py-1 rounded-full text-xs font-medium bg-teal-500 text-white">
+                                                <i class="fas fa-globe mr-1"></i>
+                                                ${selectedRecording.public_share_count}
+                                            </span>
+                                        </div>
+                                    </div>
+                                    <i :class="['fas', 'fa-chevron-down', 'transition-transform', { 'rotate-180': isMetadataExpanded }]"></i>
+                                </div>
+                            </div>
+                            <!-- Expandable Metadata and Actions -->
+                            <div v-if="isMetadataExpanded" class="mt-4 space-y-4">
+                                <div class="space-y-2 text-sm text-[var(--text-muted)]">
+                                    <!-- Combined metadata in horizontal flow -->
+                                    <div class="flex flex-wrap items-center gap-x-4 gap-y-2">
+                                        <!-- Meeting date -->
+                                        <div class="flex items-center gap-2">
+                                            <i class="fas fa-calendar text-[var(--text-accent)]"></i>
+                                            <span>${selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'No date set'}</span>
+                                        </div>
+
+                                        <!-- Other metadata (upload date, file size, etc.) -->
+                                        <template v-if="activeRecordingMetadata" v-for="(item, index) in activeRecordingMetadata" :key="index">
+                                            <!-- Skip tags as they're shown in header -->
+                                            <span v-if="!item.isTagItem" class="flex items-center gap-1.5">
+                                                <i :class="item.icon"></i>
+                                                <span :title="item.fullText || item.text">${item.text}</span>
+                                            </span>
+                                        </template>
+                                    </div>
+
+                                    <!-- Status badge (if not completed) -->
+                                    <div v-if="selectedRecording.status !== 'COMPLETED'" class="flex items-center gap-2">
+                                        <span :class="getStatusClass(selectedRecording.status)" class="status-badge">
+                                            ${formatStatus(selectedRecording.status)}
+                                        </span>
+                                    </div>
+                                </div>
+                                <!-- Action Buttons -->
+                                <div class="flex items-center gap-2 overflow-x-auto pb-2">
+                                    <button @click="toggleInbox(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :class="selectedRecording.is_inbox ? 'text-blue-500' : ''" :title="selectedRecording.is_inbox ? t('sidebar.markAsRead') : t('sidebar.moveToInbox')"><i class="fas fa-inbox"></i></button>
+                                    <button @click="toggleHighlight(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :class="selectedRecording.is_highlighted ? 'text-yellow-500' : ''" :title="selectedRecording.is_highlighted ? t('sidebar.removeFromHighlighted') : t('sidebar.highlighted')"><i class="fas fa-star"></i></button>
+                                    <button @click="editRecording(selectedRecording)" v-if="selectedRecording.can_edit !== false" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="t('common.edit')"><i class="fas fa-edit"></i></button>
+                                    <button @click="editRecordingTags(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="t('tags.title')"><i class="fas fa-tags"></i></button>
+                                    <button @click="reprocessTranscription(selectedRecording.id)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="useAsrEndpoint ? 'Reprocess with ASR' : 'Reprocess transcription'"><i class="fas fa-redo-alt"></i></button>
+                                        <button @click="reprocessSummary(selectedRecording.id)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="t('buttons.reprocessSummary')"><i class="fas fa-sync-alt"></i></button>
+                                        <button @click="confirmReset(selectedRecording)" v-if="['PENDING', 'PROCESSING', 'SUMMARIZING', 'FAILED'].includes(selectedRecording.status)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-orange-500" :title="t('buttons.resetStuckProcessing')"><i class="fas fa-undo"></i></button>
+                                    <button @click="openSpeakerModal" v-if="selectedRecording.transcription && useAsrEndpoint" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="t('buttons.identifySpeakers')"><i class="fas fa-user-tag"></i></button>
+                                    <button @click="openShareModal(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors" :title="t('buttons.shareRecording')"><i class="fas fa-share-alt"></i></button>
+                                    <button v-if="enableInternalSharing" @click="openUnifiedShareModal(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-blue-500" title="Share with Users"><i class="fas fa-users"></i></button>
+                                    <button v-if="canDeleteRecordings" @click="confirmDelete(selectedRecording)" class="p-2 rounded-lg hover:bg-[var(--bg-danger-light)] text-[var(--text-danger)] transition-colors"><i class="fas fa-trash"></i></button>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Mobile Audio Player -->
+                        <div class="bg-[var(--bg-secondary)] p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                            <div class="audio-player-container">
+                                <!-- Show message if audio has been deleted -->
+                                <div v-if="selectedRecording.audio_deleted_at"
+                                     class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-muted)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                                    <i class="fas fa-info-circle"></i>
+                                    <span v-text="t('help.audioDeletedMessage')"></span>
+                                </div>
+                                <!-- Show audio player if audio is available -->
+                                <audio v-else
+                                       controls
+                                       :src="'/audio/' + selectedRecording.id"
+                                       :volume="playerVolume"
+                                       @volumechange="onPlayerVolumeChange"
+                                       class="w-full">
+                                    Your browser does not support the audio element.
+                                </audio>
+                            </div>
+                        </div>
+
+                        <!-- Mobile Tab Navigation -->
+                        <div class="flex-shrink-0 bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)] flex overflow-x-auto">
+                            <button @click="mobileTab = 'transcript'" :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'transcript' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']" v-text="t('transcription.title')"></button>
+                            <button @click="mobileTab = 'summary'" :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'summary' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']" v-text="t('summary.title')"></button>
+                            <button @click="mobileTab = 'notes'" :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'notes' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']" v-text="t('notes.title')"></button>
+                            <button @click="mobileTab = 'chat'" :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors', mobileTab === 'chat' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']" v-text="t('chat.title')"></button>
+                            <button v-if="selectedRecording.events && selectedRecording.events.length > 0"
+                                    @click="mobileTab = 'events'"
+                                    :class="['flex-1 px-4 py-3 text-sm font-medium transition-colors whitespace-nowrap', mobileTab === 'events' ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]']">
+                                <i class="fas fa-calendar-alt mr-1"></i>${ t('events.title') } (${ selectedRecording.events.length })
+                            </button>
+                        </div>
+
+                        <!-- Mobile Tab Content -->
+                        <div class="flex-1 overflow-y-auto p-4">
+                            <!-- Transcript Panel -->
+                            <div v-if="mobileTab === 'transcript'" class="h-full flex flex-col space-y-4">
+                                <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+                                    <div v-if="processedTranscription.hasDialogue" class="view-mode-toggle">
+                                        <button @click="toggleTranscriptionViewMode" :class="['toggle-button', transcriptionViewMode === 'simple' ? 'active' : '']"><i class="fas fa-list"></i></button>
+                                        <button @click="toggleTranscriptionViewMode" :class="['toggle-button', transcriptionViewMode === 'bubble' ? 'active' : '']"><i class="fas fa-comments"></i></button>
+                                    </div>
+                                    <button @click="copyTranscription" class="copy-btn" title="Copy transcript"><i class="fas fa-copy"></i></button>
+                                    <button @click="downloadTranscript" v-if="selectedRecording && selectedRecording.transcription" class="copy-btn" title="Download transcript with template"><i class="fas fa-download"></i></button>
+                                    <button @click="openTranscriptionEditor" v-if="selectedRecording && selectedRecording.transcription" class="copy-btn" title="Edit transcript"><i class="fas fa-edit"></i></button>
+                                </div>
+                                <div class="flex-grow overflow-y-auto mobile-content-box">
+                                    <div v-if="selectedRecording.status === 'PROCESSING'" class="text-center py-8">
+                                        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                                        <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.processingTranscription')"></p>
+                                    </div>
+                                    <div v-else-if="!selectedRecording.transcription" class="text-center py-8">
+                                        <i class="fas fa-file-text text-3xl text-[var(--text-muted)] mb-3"></i>
+                                        <p class="text-[var(--text-muted)]" v-text="t('transcription.noTranscription')"></p>
+                                    </div>
+                                    <div v-else>
+                                        <div v-if="!processedTranscription.hasDialogue || transcriptionViewMode === 'simple'" class="transcription-simple-view">
+                                            <div v-if="processedTranscription.hasDialogue">
+                                                <div v-for="segment in processedTranscription.simpleSegments" :key="segment.startTime || Math.random()" class="speaker-segment" @click="seekAudioFromEvent" :data-start-time="segment.startTime">
+                                                    <div v-if="segment.showSpeaker" :class="['speaker-tablet', segment.color]">${segment.speaker}</div>
+                                                    <div class="speaker-text">${segment.sentence}</div>
+                                                </div>
+                                            </div>
+                                            <div v-else>
+                                                <div v-if="processedTranscription.simpleSegments && processedTranscription.simpleSegments.length > 0">
+                                                    <div v-for="segment in processedTranscription.simpleSegments" :key="segment.startTime || Math.random()" class="transcript-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors" @click="seekAudioFromEvent" :data-start-time="segment.startTime">${segment.sentence}</div>
+                                                </div>
+                                                <div v-else class="whitespace-pre-wrap">${processedTranscription.content}</div>
+                                            </div>
+                                        </div>
+                                        <div v-else-if="transcriptionViewMode === 'bubble'" class="transcription-with-speakers">
+                                            <div v-for="(row, rowIndex) in processedTranscription.bubbleRows" :key="`${selectedRecording.id}-bubble-row-${rowIndex}`" :class="['bubble-row', row.isMe ? 'speaker-me' : '']">
+                                                <div v-for="bubble in row.bubbles" :key="bubble.startTime || Math.random()" :class="['speaker-bubble', bubble.color, row.isMe ? 'speaker-me' : '']" @click="seekAudioFromEvent" :data-start-time="bubble.startTime">
+                                                    <div class="speaker-bubble-content">${bubble.sentence}</div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                            <!-- Summary Panel -->
+                            <div v-if="mobileTab === 'summary'" class="h-full flex flex-col space-y-4">
+                                <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+                                    <button @click="copySummary" class="copy-btn" :title="t('buttons.copySummary')"><i class="fas fa-copy"></i></button>
+                                    <button @click="downloadSummary" class="copy-btn" :title="t('buttons.downloadAsWord')"><i class="fas fa-download"></i></button>
+                                    <button @click="toggleEditSummary" class="copy-btn" :title="t('buttons.editSummary')"><i class="fas fa-edit"></i></button>
+                                </div>
+                                <div class="flex-grow overflow-y-auto mobile-content-box">
+                                    <div v-if="editingSummary" class="h-full flex flex-col">
+                                        <div class="markdown-editor-container flex-1">
+                                            <textarea ref="summaryMarkdownEditor" v-model="selectedRecording.summary"></textarea>
+                                        </div>
+                                        <div class="flex justify-end gap-2 mt-2">
+                                            <button @click="cancelEditSummary" class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                                            <button @click="saveEditSummary" class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]" v-text="t('common.save')"></button>
+                                        </div>
+                                    </div>
+                                    <div v-else>
+                                        <div v-if="selectedRecording.status === 'SUMMARIZING'" class="text-center py-8">
+                                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                                            <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.generatingSummary')"></p>
+                                        </div>
+                                        <div v-else-if="!selectedRecording.summary" class="text-center py-8">
+                                            <i class="fas fa-file-alt text-3xl text-[var(--text-muted)] mb-3"></i>
+                                            <p class="text-[var(--text-muted)] mb-4" v-text="t('summary.noSummary')"></p>
+                                            <button @click="generateSummary" 
+                                                    class="px-6 py-3 bg-gradient-to-r from-blue-600 to-purple-600 text-white font-medium rounded-lg shadow-lg hover:shadow-xl hover:from-blue-700 hover:to-purple-700 transition-all duration-200 transform hover:scale-105">
+                                                <i class="fas fa-magic mr-2"></i>Generate Summary
+                                            </button>
+                                        </div>
+                                        <div v-else class="summary-box h-full" v-html="selectedRecording.summary_html || selectedRecording.summary"></div>
+                                    </div>
+                                </div>
+                            </div>
+                            <!-- Notes Panel -->
+                            <div v-if="mobileTab === 'notes'" class="h-full flex flex-col space-y-4">
+                                <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+                                    <button @click="copyNotes" class="copy-btn" :title="t('buttons.copyNotes')"><i class="fas fa-copy"></i></button>
+                                    <button @click="downloadNotes" class="copy-btn" :title="t('buttons.downloadAsWord')"><i class="fas fa-download"></i></button>
+                                    <button @click="toggleEditNotes" class="copy-btn" :title="t('buttons.editNotes')"><i class="fas fa-edit"></i></button>
+                                </div>
+                                <div class="flex-grow overflow-y-auto mobile-content-box">
+                                    <div v-if="editingNotes" class="h-full flex flex-col">
+                                        <div class="markdown-editor-container flex-1">
+                                            <textarea ref="notesMarkdownEditor" v-model="selectedRecording.notes"></textarea>
+                                        </div>
+                                        <div class="flex justify-end gap-2 mt-2">
+                                            <button @click="cancelEditNotes" class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                                            <button @click="saveEditNotes" class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]" v-text="t('common.save')"></button>
+                                        </div>
+                                    </div>
+                                    <div v-else @click="clickToEditNotes">
+                                        <div v-if="!selectedRecording.notes" class="text-center py-8 cursor-pointer hover:text-[var(--text-secondary)]">
+                                            <i class="fas fa-sticky-note text-3xl text-[var(--text-muted)] mb-3"></i>
+                                            <p class="text-[var(--text-muted)]" v-text="t('help.clickToAddNotes')"></p>
+                                        </div>
+                                        <div v-else class="notes-box h-full" v-html="selectedRecording.notes_html || selectedRecording.notes"></div>
+                                    </div>
+                                </div>
+                            </div>
+                            <!-- Chat Panel -->
+                            <div v-if="mobileTab === 'chat'" class="h-full flex flex-col rounded-lg border border-[var(--border-primary)] overflow-hidden relative">
+                                <!-- Clear button - fixed at top right -->
+                                <button v-if="chatMessages.length > 0"
+                                        @click="clearChat"
+                                        class="absolute top-2 right-2 p-1 text-[var(--text-muted)] opacity-60 hover:opacity-100 hover:text-[var(--text-danger)] rounded transition-all duration-200 z-20"
+                                        title="Clear chat">
+                                    <i class="fas fa-times text-xs"></i>
+                                </button>
+
+                                <div ref="chatMessagesRef" class="flex-1 overflow-y-auto p-4 space-y-4 bg-[var(--bg-secondary)]">
+                                    <div v-if="chatMessages.length === 0" class="text-center py-8">
+                                        <i class="fas fa-robot text-3xl text-[var(--text-muted)] mb-3"></i>
+                                        <p class="text-[var(--text-muted)]" v-text="t('help.askAboutTranscription')"></p>
+                                    </div>
+                                    <div v-for="(message, index) in chatMessages" :key="index" 
+                                         :class="['message relative group', message.role === 'user' ? 'user-message ml-auto' : 'ai-message', 
+                                                  message.role === 'assistant' ? 'pr-10' : '']">
+                                        <!-- Copy button for assistant messages -->
+                                        <button v-if="message.role === 'assistant'" 
+                                                @click="copyMessage(message.content, $event)" 
+                                                class="absolute top-2 right-2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded transition-all duration-200"
+                                                :title="t('buttons.copyMessage')">
+                                            <i class="fas fa-copy text-sm"></i>
+                                        </button>
+                                        <!-- Show thinking content if available -->
+                                        <div v-if="message.thinking && message.role === 'assistant'" class="mb-2">
+                                            <button @click="message.thinkingExpanded = !message.thinkingExpanded" 
+                                                    class="text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)] flex items-center gap-1">
+                                                <i :class="['fas', message.thinkingExpanded ? 'fa-chevron-down' : 'fa-chevron-right']"></i>
+                                                <span v-text="t('help.modelReasoning')"></span>
+                                                <span class="text-[var(--text-muted)]">(${message.thinking.split('\n').length} lines)</span>
+                                            </button>
+                                            <div v-if="message.thinkingExpanded" 
+                                                 class="mt-2 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg text-xs text-[var(--text-muted)] max-h-64 overflow-y-auto">
+                                                <pre class="whitespace-pre-wrap font-mono">${message.thinking}</pre>
+                                            </div>
+                                        </div>
+                                        <!-- Main message content -->
+                                        <div v-if="message.html" v-html="message.html"></div>
+                                        <div v-else class="whitespace-pre-wrap">${message.content}</div>
+                                    </div>
+                                    <div v-if="isChatLoading" class="ai-message">
+                                        <i class="fas fa-spinner fa-spin mr-2"></i> Thinking...
+                                    </div>
+                                </div>
+                                <div class="border-t border-[var(--border-primary)] p-4 bg-[var(--bg-tertiary)]">
+                                    <div class="flex gap-2">
+                                        <textarea v-model="chatInput" @keydown="handleChatKeydown" :disabled="isChatLoading || selectedRecording.status !== 'COMPLETED'" :placeholder="t('chat.placeholder')" class="flex-1 px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm" rows="2"></textarea>
+                                        <button @click="sendChatMessage" :disabled="!chatInput.trim() || isChatLoading || selectedRecording.status !== 'COMPLETED'" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors disabled:opacity-50 disabled:cursor-not-allowed">
+                                            <i class="fas fa-paper-plane"></i>
+                                        </button>
+                                    </div>
+                                </div>
+                            </div>
+                            <!-- Events Panel (Mobile) -->
+                            <div v-if="mobileTab === 'events' && selectedRecording.events && selectedRecording.events.length > 0" class="h-full flex flex-col space-y-4">
+                                <div class="flex items-center justify-end gap-2 flex-shrink-0 pr-3">
+                                    <button @click="downloadICS" v-if="selectedRecording.events && selectedRecording.events.length > 0"
+                                            class="copy-btn"
+                                            :title="t('buttons.exportCalendar')">
+                                        <i class="fas fa-calendar-plus"></i>
+                                    </button>
+                                </div>
+                                <div class="flex-grow overflow-y-auto mobile-content-box">
+                                    <div class="space-y-3">
+                                        <div v-for="event in selectedRecording.events" :key="event.id"
+                                             class="bg-[var(--bg-tertiary)] rounded-lg p-3 border border-[var(--border-primary)]">
+                                            <div class="flex justify-between items-start mb-2">
+                                                <div class="flex-1">
+                                                    <h3 class="text-base font-semibold text-[var(--text-primary)] mb-1">
+                                                        <i class="fas fa-calendar-check mr-2 text-[var(--text-accent)] text-sm"></i>
+                                                        ${ event.title }
+                                                    </h3>
+                                                    <p v-if="event.description" class="text-xs text-[var(--text-secondary)] mb-2">
+                                                        ${ event.description }
+                                                    </p>
+                                                </div>
+                                                <button @click="downloadEventICS(event)"
+                                                        class="px-2 py-1 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-xs flex items-center gap-1"
+                                                        :title="t('events.addToCalendar')">
+                                                    <i class="fas fa-download text-xs"></i>
+                                                    <span v-text="t('events.add')"></span>
+                                                </button>
+                                            </div>
+                                            <div class="grid grid-cols-1 gap-2 text-xs">
+                                                <div class="flex items-center text-[var(--text-muted)]">
+                                                    <i class="fas fa-clock mr-2 text-[var(--text-accent)]"></i>
+                                                    <span>
+                                                        ${ formatEventDateTime(event.start_datetime) }
+                                                        <template v-if="event.end_datetime">
+                                                            - ${ formatEventDateTime(event.end_datetime, true) }
+                                                        </template>
+                                                    </span>
+                                                </div>
+                                                <div v-if="event.location" class="flex items-center text-[var(--text-muted)]">
+                                                    <i class="fas fa-map-marker-alt mr-2 text-[var(--text-accent)]"></i>
+                                                    <span>${ event.location }</span>
+                                                </div>
+                                                <div v-if="event.attendees && event.attendees.length > 0" class="flex items-start text-[var(--text-muted)]">
+                                                    <i class="fas fa-users mr-2 text-[var(--text-accent)] mt-0.5"></i>
+                                                    <div class="flex-1">
+                                                        <span v-for="(attendee, index) in event.attendees" :key="index"
+                                                              class="inline-block bg-[var(--bg-secondary)] px-2 py-0.5 rounded mr-1 mb-1">
+                                                            ${ attendee }
+                                                        </span>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <!-- Desktop View -->
+                    <div v-else class="flex-1 flex flex-col overflow-hidden">
+                        <!-- Recording Header -->
+                        <div class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] p-6 flex-shrink-0">
+                            <div class="flex flex-col">
+                                <div class="flex items-start justify-between">
+                                    <div class="flex-1 min-w-0">
+                                        <h1 class="text-2xl font-bold text-[var(--text-primary)] mb-2">
+                                            ${selectedRecording.title || 'Untitled Recording'}
+                                        </h1>
+                                    </div>
+                                    
+                                    <!-- Action Buttons -->
+                                    <div class="flex items-center gap-2 ml-4">
+                                        <button @click="toggleInbox(selectedRecording)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :class="selectedRecording.is_inbox ? 'text-blue-500' : ''"
+                                                :title="selectedRecording.is_inbox ? 'Mark as Read' : 'Move to Inbox'">
+                                            <i class="fas fa-inbox"></i>
+                                        </button>
+                                        <button @click="toggleHighlight(selectedRecording)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :class="selectedRecording.is_highlighted ? 'text-yellow-500' : ''"
+                                                :title="selectedRecording.is_highlighted ? 'Remove Highlight' : 'Highlight'">
+                                            <i class="fas fa-star"></i>
+                                        </button>
+                                        <button @click="editRecording(selectedRecording)" 
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                                            <i class="fas fa-edit"></i>
+                                        </button>
+                                        <button @click="editRecordingTags(selectedRecording)" 
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :title="t('buttons.editTags')">
+                                            <i class="fas fa-tags"></i>
+                                        </button>
+                                        <button @click="reprocessTranscription(selectedRecording.id)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :title="useAsrEndpoint ? 'Reprocess with ASR' : 'Reprocess transcription'">
+                                            <i class="fas fa-redo-alt"></i>
+                                        </button>
+                                        <button @click="reprocessSummary(selectedRecording.id)" v-if="selectedRecording && selectedRecording.can_edit !== false && (selectedRecording.status === 'COMPLETED' || selectedRecording.status === 'FAILED')"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :title="t('buttons.reprocessSummary')">
+                                            <i class="fas fa-sync-alt"></i>
+                                        </button>
+                                        <button @click="confirmReset(selectedRecording)" v-if="['PENDING', 'PROCESSING', 'SUMMARIZING', 'FAILED'].includes(selectedRecording.status)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-orange-500"
+                                                :title="t('buttons.resetStuckProcessing')">
+                                            <i class="fas fa-undo"></i>
+                                        </button>
+                                        <button @click="openSpeakerModal" v-if="selectedRecording.transcription && useAsrEndpoint"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :title="t('buttons.identifySpeakers')">
+                                            <i class="fas fa-user-tag"></i>
+                                        </button>
+                                        <button @click="openShareModal(selectedRecording)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                                                :title="t('buttons.shareRecording')">
+                                            <i class="fas fa-share-alt"></i>
+                                        </button>
+                                        <button v-if="enableInternalSharing" @click="openUnifiedShareModal(selectedRecording)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors text-blue-500"
+                                                title="Share with Users">
+                                            <i class="fas fa-users"></i>
+                                        </button>
+                                        <button v-if="canDeleteRecordings" @click="confirmDelete(selectedRecording)"
+                                                class="p-2 rounded-lg hover:bg-[var(--bg-danger-light)] text-[var(--text-danger)] transition-colors">
+                                            <i class="fas fa-trash"></i>
+                                        </button>
+                                    </div>
+                                </div>
+                                
+                                <!-- Metadata Row -->
+                                <div class="flex flex-wrap items-center gap-x-6 gap-y-2 text-sm text-[var(--text-muted)] mt-2">
+                                    <!-- Shared Status Badges and Tags -->
+                                    <div v-if="selectedRecording.is_shared || selectedRecording.shared_with_count > 0 || selectedRecording.public_share_count > 0 || selectedRecording.has_group_tags || (selectedRecording.tags && selectedRecording.tags.length > 0)" class="flex items-center gap-1.5 flex-wrap">
+                                        <!-- Shared by someone else (INCOMING) -->
+                                        <span v-if="selectedRecording.is_shared"
+                                              class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-purple-500 text-white cursor-help"
+                                              :title="t('sharing.sharedBy') + ' ' + (selectedRecording.owner_username || t('sharing.unknown'))">
+                                            <i class="fas fa-arrow-down" style="line-height: 1;"></i>
+                                        </span>
+
+                                        <!-- Group indicator (show for both owned and shared recordings with group tags) -->
+                                        <span v-if="selectedRecording.has_group_tags"
+                                              class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-blue-500 text-white cursor-help"
+                                              :title="t('sharing.teamRecording')">
+                                            <i class="fas fa-users" style="line-height: 1;"></i>
+                                        </span>
+
+                                        <!-- Shared with others (OUTGOING) -->
+                                        <span v-if="!selectedRecording.is_shared && selectedRecording.shared_with_count > 0"
+                                              class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-indigo-500 text-white cursor-help"
+                                              :title="t('sharing.sharedWith') + ' ' + selectedRecording.shared_with_count + ' ' + t('sharing.users')">
+                                            <i class="fas fa-arrow-up" style="line-height: 1;"></i>
+                                        </span>
+
+                                        <!-- Public link shares -->
+                                        <span v-if="!selectedRecording.is_shared && selectedRecording.public_share_count > 0"
+                                              class="inline-flex items-center justify-center w-5 h-5 text-[10px] font-medium rounded-full bg-teal-500 text-white cursor-help"
+                                              :title="selectedRecording.public_share_count + ' ' + t('sharing.publicLinksGenerated')">
+                                            <i class="fas fa-globe" style="line-height: 1;"></i>
+                                        </span>
+
+                                        <!-- Tags -->
+                                        <span v-for="tag in selectedRecording.tags" :key="tag.id"
+                                              class="inline-flex items-center px-2 py-0.5 text-xs font-medium rounded-full text-white"
+                                              :style="{ backgroundColor: tag.color || '#6B7280' }">
+                                            <i v-if="tag.group_id" class="fas fa-users mr-1 text-[10px]"></i>
+                                            ${tag.name}
+                                        </span>
+                                    </div>
+
+                                    <!-- Participants -->
+                                    <div class="flex items-center gap-2">
+                                        <i class="fas fa-users text-[var(--text-accent)]"></i>
+                                        <span v-if="!editingParticipants"
+                                              @click="toggleEditParticipants"
+                                              class="cursor-pointer hover:text-[var(--text-accent)] transition-colors">
+                                            ${selectedRecording.participants || t('help.noParticipants')}
+                                        </span>
+                                        <input v-else
+                                               v-model="selectedRecording.participants"
+                                               @blur="toggleEditParticipants"
+                                               @keyup.enter="toggleEditParticipants"
+                                               class="bg-transparent border-b border-[var(--border-secondary)] focus:border-[var(--border-focus)] outline-none px-1">
+                                    </div>
+
+                                    <!-- Meeting Date -->
+                                    <div class="flex items-center gap-2">
+                                        <i class="fas fa-calendar text-[var(--text-accent)]"></i>
+                                        <span v-if="!editingMeetingDate" 
+                                              @click="toggleEditMeetingDate"
+                                              class="cursor-pointer hover:text-[var(--text-accent)] transition-colors">
+                                            ${selectedRecording.meeting_date ? formatDisplayDate(selectedRecording.meeting_date) : 'No date set'}
+                                        </span>
+                                        <input v-else 
+                                               v-model="selectedRecording.meeting_date" 
+                                               @blur="toggleEditMeetingDate"
+                                               @keyup.enter="toggleEditMeetingDate"
+                                               type="date"
+                                               class="bg-transparent border-b border-[var(--border-secondary)] focus:border-[var(--border-focus)] outline-none px-1">
+                                    </div>
+                                    
+                                    <!-- Other Metadata -->
+                                    <div v-if="activeRecordingMetadata && activeRecordingMetadata.length > 0" class="flex flex-wrap items-center gap-x-6 gap-y-2">
+                                        <span v-for="(item, index) in activeRecordingMetadata" :key="index" class="flex items-center gap-1.5">
+                                            <i :class="item.icon"></i>
+                                            <span :title="item.fullText || item.text">${item.text}</span>
+                                        </span>
+                                    </div>
+                                    
+                                    <!-- Status -->
+                                    <div v-if="selectedRecording.status !== 'COMPLETED'" class="flex items-center gap-2">
+                                        <span :class="getStatusClass(selectedRecording.status)" class="status-badge">
+                                            ${formatStatus(selectedRecording.status)}
+                                        </span>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Main Content Split View -->
+                        <div id="mainContentColumns" class="flex-1 flex overflow-hidden">
+                            <!-- Left Panel: Transcription -->
+                            <div id="leftMainColumn" class="flex flex-col overflow-hidden" :style="{width: leftColumnWidth + '%'}">
+                                <!-- Transcription Header -->
+                                <div class="bg-[var(--bg-tertiary)] px-4 py-3 border-b border-[var(--border-primary)] flex items-center justify-between">
+                                    <h3 class="font-semibold flex items-center">
+                                        <i class="fas fa-file-text mr-2"></i>
+                                        <span v-text="t('transcription.title')"></span>
+                                    </h3>
+                                    <div class="flex items-center gap-2">
+                                        <!-- View Mode Toggle -->
+                                        <div v-if="processedTranscription.hasDialogue" class="view-mode-toggle">
+                                            <button @click="toggleTranscriptionViewMode" 
+                                                    :class="['toggle-button', transcriptionViewMode === 'simple' ? 'active' : '']">
+                                                <i class="fas fa-list"></i><span v-text="t('transcription.simple')"></span>
+                                            </button>
+                                            <button @click="toggleTranscriptionViewMode" 
+                                                    :class="['toggle-button', transcriptionViewMode === 'bubble' ? 'active' : '']">
+                                                <i class="fas fa-comments"></i><span v-text="t('transcription.bubble')"></span>
+                                            </button>
+                                        </div>
+                                        
+                                        <!-- Copy Button -->
+                                        <button @click="copyTranscription"
+                                                class="copy-btn">
+                                            <i class="fas fa-copy mr-1"></i><span v-text="t('transcription.copy')"></span>
+                                        </button>
+                                        <!-- Download Button -->
+                                        <button @click="downloadTranscript"
+                                                v-if="selectedRecording && selectedRecording.transcription"
+                                                class="copy-btn"
+                                                title="Download transcript with template">
+                                            <i class="fas fa-download mr-1"></i><span v-text="t('transcription.download')"></span>
+                                        </button>
+                                        <!-- Edit Transcription Button -->
+                                        <button @click="openTranscriptionEditor"
+                                                v-if="selectedRecording && selectedRecording.transcription"
+                                                class="copy-btn">
+                                            <i class="fas fa-edit mr-1"></i><span v-text="t('transcription.edit')"></span>
+                                        </button>
+                                    </div>
+                                </div>
+                                
+                                <!-- Transcription Content -->
+                                <div class="flex-1 overflow-y-auto p-4">
+                                    <div v-if="selectedRecording.status === 'PROCESSING'" class="text-center py-8">
+                                        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                                        <p class="mt-2 text-[var(--text-muted)]" v-text="t('help.processingTranscription')"></p>
+                                    </div>
+                                    
+                                    <div v-else-if="!selectedRecording.transcription" class="text-center py-8">
+                                        <i class="fas fa-file-text text-3xl text-[var(--text-muted)] mb-3"></i>
+                                        <p class="text-[var(--text-muted)]" v-text="t('transcription.noTranscription')"></p>
+                                    </div>
+                                    
+                                    <!-- Speaker Legend (for dialogue transcriptions in bubble view only) -->
+                                    <div v-if="processedTranscription.hasDialogue && processedTranscription.speakers.length > 0 && transcriptionViewMode === 'bubble'" 
+                                         :class="['speaker-legend', legendExpanded ? 'expanded' : '']">
+                                        <div class="speaker-legend-header" @click="legendExpanded = !legendExpanded">
+                                            <div class="speaker-legend-title">
+                                                <i class="fas fa-users"></i>
+                                                <span v-text="t('help.speakers')"></span>
+                                                <span class="speaker-count-indicator">(${processedTranscription.speakers.length})</span>
+                                            </div>
+                                            <i class="fas fa-chevron-down speaker-legend-toggle"></i>
+                                        </div>
+                                        <div class="speaker-legend-content">
+                                            <div v-for="(speaker, index) in processedTranscription.speakers" 
+                                                 :key="`${selectedRecording.id}-speaker-legend-${index}`" 
+                                                 :class="['speaker-legend-item', speaker.color]">
+                                                <span class="speaker-name">${speaker.name}</span>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    
+                                    <!-- Transcription Display -->
+                                    <div v-if="selectedRecording.transcription">
+                                        <!-- Simple View -->
+                                        <div v-if="!processedTranscription.hasDialogue || transcriptionViewMode === 'simple'" 
+                                             class="transcription-simple-view">
+                                            <div v-if="processedTranscription.hasDialogue">
+                                                <div v-for="segment in processedTranscription.simpleSegments" 
+                                                     :key="segment.startTime || Math.random()" 
+                                                     class="speaker-segment"
+                                                     @click="seekAudioFromEvent"
+                                                     :data-start-time="segment.startTime">
+                                                    <div v-if="segment.showSpeaker" 
+                                                         :class="['speaker-tablet', segment.color]">
+                                                        ${segment.speaker}
+                                                    </div>
+                                                    <div class="speaker-text">
+                                                        ${segment.sentence}
+                                                    </div>
+                                                </div>
+                                            </div>
+                                            <div v-else>
+                                                <div v-if="processedTranscription.simpleSegments && processedTranscription.simpleSegments.length > 0">
+                                                    <div v-for="segment in processedTranscription.simpleSegments" 
+                                                         :key="segment.startTime || Math.random()" 
+                                                         class="transcript-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors"
+                                                         @click="seekAudioFromEvent"
+                                                         :data-start-time="segment.startTime">
+                                                        ${segment.sentence}
+                                                    </div>
+                                                </div>
+                                                <div v-else class="whitespace-pre-wrap">
+                                                    ${processedTranscription.content}
+                                                </div>
+                                            </div>
+                                        </div>
+                                        
+                                        <!-- Bubble View -->
+                                        <div v-else-if="transcriptionViewMode === 'bubble'" 
+                                             class="transcription-with-speakers">
+                                            <div v-for="(row, rowIndex) in processedTranscription.bubbleRows" 
+                                                 :key="`${selectedRecording.id}-bubble-row-${rowIndex}`" 
+                                                 :class="['bubble-row', row.isMe ? 'speaker-me' : '']">
+                                                <div v-for="bubble in row.bubbles" 
+                                                     :key="bubble.startTime || Math.random()" 
+                                                     :class="['speaker-bubble', bubble.color, row.isMe ? 'speaker-me' : '']"
+                                                     @click="seekAudioFromEvent"
+                                                     :data-start-time="bubble.startTime">
+                                                    <div class="speaker-bubble-content">
+                                                        ${bubble.sentence}
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Resizable Divider - Minimal but functional -->
+                            <div id="mainColumnResizer" @mousedown="startColumnResize"></div>
+
+                            <!-- Right Panel: Summary/Notes and Chat -->
+                            <div id="rightMainColumn" class="flex flex-col overflow-hidden" :style="{width: rightColumnWidth + '%'}">
+                                <!-- Audio Player -->
+                                <div class="bg-[var(--bg-secondary)] p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                                    <div class="audio-player-container">
+                                        <!-- Show message if audio has been deleted -->
+                                        <div v-if="selectedRecording.audio_deleted_at"
+                                             class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-muted)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                                            <i class="fas fa-info-circle"></i>
+                                            <span v-text="t('help.audioDeletedMessage')"></span>
+                                        </div>
+                                        <!-- Show audio player if audio is available -->
+                                        <audio v-else
+                                               controls
+                                               :src="'/audio/' + selectedRecording.id"
+                                               :volume="playerVolume"
+                                               @volumechange="onPlayerVolumeChange"
+                                               class="w-full">
+                                            Your browser does not support the audio element.
+                                        </audio>
+                                    </div>
+                                </div>
+
+                                <!-- Summary/Notes Tabs -->
+                                <div :class="{'flex-1': !isChatMaximized, 'flex-none': isChatMaximized}" class="flex flex-col overflow-hidden">
+                                    <!-- Tab Navigation -->
+                                    <div class="bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)] flex">
+                                        <button @click="selectedTab = 'summary'" 
+                                                :class="[
+                                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                                    selectedTab === 'summary' 
+                                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]' 
+                                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                                ]">
+                                            ${ t('summary.title') }
+                                        </button>
+                                        <button @click="selectedTab = 'notes'"
+                                                :class="[
+                                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                                    selectedTab === 'notes'
+                                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                                ]">
+                                            ${ t('notes.title') }
+                                        </button>
+                                        <button v-if="selectedRecording.events && selectedRecording.events.length > 0"
+                                                @click="selectedTab = 'events'"
+                                                :class="[
+                                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                                    selectedTab === 'events'
+                                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                                ]">
+                                            <i class="fas fa-calendar-alt mr-1"></i>
+                                            ${ t('events.title') } (${ selectedRecording.events.length })
+                                        </button>
+                                    </div>
+
+                                    <!-- Tab Content -->
+                                    <div v-if="!isChatMaximized" class="flex-1 overflow-hidden">
+                                        <!-- Summary Tab -->
+                                        <div v-if="selectedTab === 'summary'" class="h-full p-4 overflow-y-auto">
+                                            <div v-if="selectedRecording.status === 'SUMMARIZING'" class="text-center py-8">
+                                                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                                                <p class="mt-2 text-[var(--text-muted)]" v-text="t('summary.summaryInProgress')"></p>
+                                            </div>
+                                            
+                                            <div v-else-if="!selectedRecording.summary" class="text-center py-8">
+                                                <i class="fas fa-file-alt text-3xl text-[var(--text-muted)] mb-3"></i>
+                                                <p class="text-[var(--text-muted)] mb-4" v-text="t('summary.noSummary')"></p>
+                                                <button @click="generateSummary" 
+                                                        class="px-6 py-3 bg-gradient-to-r from-blue-600 to-purple-600 text-white font-medium rounded-lg shadow-lg hover:shadow-xl hover:from-blue-700 hover:to-purple-700 transition-all duration-200 transform hover:scale-105">
+                                                    <i class="fas fa-magic mr-2"></i>${ t('summary.generateSummary') }
+                                                </button>
+                                            </div>
+                                            
+                                            <div v-else class="content-box relative">
+                                                <div v-if="!editingSummary" class="absolute top-2 right-4 flex gap-1 z-10">
+                                                    <button @click="copySummary" 
+                                                            :title="t('buttons.copySummary')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-copy text-sm"></i>
+                                                    </button>
+                                                    <button @click="downloadSummary" 
+                                                            :title="t('buttons.downloadSummary')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-download text-sm"></i>
+                                                    </button>
+                                                    <button @click="toggleEditSummary" 
+                                                            :title="t('buttons.editSummary')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-edit text-sm"></i>
+                                                    </button>
+                                                </div>
+                                                
+                                                <div v-if="!editingSummary" 
+                                                     class="summary-box" 
+                                                     v-html="selectedRecording.summary_html || selectedRecording.summary">
+                                                </div>
+                                                <div v-else class="h-full flex flex-col">
+                                                    <div class="markdown-editor-container flex-1">
+                                                        <textarea ref="summaryMarkdownEditor" 
+                                                                  v-model="selectedRecording.summary"
+                                                                  class="w-full h-full p-4 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]"
+                                                                  :placeholder="t('form.enterSummaryMarkdown')">
+                                                        </textarea>
+                                                    </div>
+                                                    <div class="flex justify-end gap-2 mt-2">
+                                                        <button @click="cancelEditSummary" 
+                                                                class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]">
+                                                            Cancel
+                                                        </button>
+                                                        <button @click="saveEditSummary" 
+                                                                class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]">
+                                                            Save
+                                                        </button>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+
+                                        <!-- Notes Tab -->
+                                        <div v-if="selectedTab === 'notes'" class="h-full p-4 overflow-y-auto">
+                                            <div class="content-box h-full relative">
+                                                <div v-if="!editingNotes" class="absolute top-2 right-4 flex gap-1 z-10">
+                                                    <button @click="copyNotes" 
+                                                            :title="t('buttons.copyNotes')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-copy text-sm"></i>
+                                                    </button>
+                                                    <button @click="downloadNotes" 
+                                                            :title="t('buttons.downloadNotes')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-download text-sm"></i>
+                                                    </button>
+                                                    <button @click="toggleEditNotes" 
+                                                            :title="t('buttons.editNotes')"
+                                                            class="w-8 h-8 flex items-center justify-center bg-transparent hover:bg-[var(--bg-secondary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] rounded-md border border-transparent hover:border-[var(--border-secondary)] transition-all duration-200 opacity-60 hover:opacity-100">
+                                                        <i class="fas fa-edit text-sm"></i>
+                                                    </button>
+                                                </div>
+                                                
+                                                <div v-if="!editingNotes" 
+                                                     class="notes-box h-full"
+                                                     @click="clickToEditNotes">
+                                                    <div v-if="selectedRecording.notes_html" 
+                                                         v-html="selectedRecording.notes_html">
+                                                    </div>
+                                                    <div v-else-if="selectedRecording.notes" 
+                                                         class="whitespace-pre-wrap">
+                                                        ${selectedRecording.notes}
+                                                    </div>
+                                                    <div v-else class="text-[var(--text-muted)] italic cursor-pointer hover:text-[var(--text-secondary)]">
+                                                        ${ t('help.clickToAddNotes') }
+                                                    </div>
+                                                </div>
+                                                
+                                                <div v-else class="h-full flex flex-col">
+                                                    <div class="markdown-editor-container flex-1">
+                                                        <textarea ref="notesMarkdownEditor" 
+                                                                  v-model="selectedRecording.notes"
+                                                                  class="w-full h-full p-4 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]"
+                                                                  :placeholder="t('form.enterNotesMarkdown')">
+                                                        </textarea>
+                                                    </div>
+                                                    <div class="flex justify-end gap-2 mt-2">
+                                                        <button @click="cancelEditNotes" 
+                                                                class="px-3 py-1 text-sm bg-[var(--bg-secondary)] text-[var(--text-secondary)] border border-[var(--border-secondary)] rounded hover:bg-[var(--bg-tertiary)]">
+                                                            Cancel
+                                                        </button>
+                                                        <button @click="saveEditNotes" 
+                                                                class="px-3 py-1 text-sm bg-[var(--bg-button)] text-[var(--text-button)] rounded hover:bg-[var(--bg-button-hover)]">
+                                                            Save
+                                                        </button>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+
+                                        <!-- Events Tab -->
+                                        <div v-if="selectedTab === 'events' && selectedRecording.events && selectedRecording.events.length > 0" class="h-full p-4 overflow-y-auto">
+                                            <div class="space-y-4">
+                                                <div v-for="event in selectedRecording.events" :key="event.id"
+                                                     class="bg-[var(--bg-tertiary)] rounded-lg p-4 border border-[var(--border-primary)] hover:border-[var(--border-accent)] transition-colors">
+                                                    <div class="flex justify-between items-start mb-3">
+                                                        <div class="flex-1">
+                                                            <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-1">
+                                                                <i class="fas fa-calendar-check mr-2 text-[var(--text-accent)]"></i>
+                                                                ${ event.title }
+                                                            </h3>
+                                                            <p v-if="event.description" class="text-sm text-[var(--text-secondary)] mb-2">
+                                                                ${ event.description }
+                                                            </p>
+                                                        </div>
+                                                        <button @click="downloadEventICS(event)"
+                                                                class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm flex items-center gap-1.5"
+                                                                :title="t('events.addToCalendar')">
+                                                            <i class="fas fa-download"></i>
+                                                            <span v-text="t('events.addToCalendar')"></span>
+                                                        </button>
+                                                    </div>
+
+                                                    <div class="space-y-2 text-sm">
+                                                        <div class="flex items-center gap-2" v-if="event.start_datetime">
+                                                            <i class="fas fa-clock text-[var(--text-muted)] w-4"></i>
+                                                            <span class="text-[var(--text-secondary)]">
+                                                                <strong v-text="t('events.start') + ':'"></strong> ${ formatEventDateTime(event.start_datetime) }
+                                                            </span>
+                                                        </div>
+                                                        <div class="flex items-center gap-2" v-if="event.end_datetime">
+                                                            <i class="fas fa-clock text-[var(--text-muted)] w-4"></i>
+                                                            <span class="text-[var(--text-secondary)]">
+                                                                <strong v-text="t('events.end') + ':'"></strong> ${ formatEventDateTime(event.end_datetime) }
+                                                            </span>
+                                                        </div>
+                                                        <div class="flex items-center gap-2" v-if="event.location">
+                                                            <i class="fas fa-map-marker-alt text-[var(--text-muted)] w-4"></i>
+                                                            <span class="text-[var(--text-secondary)]">
+                                                                <strong v-text="t('events.location') + ':'"></strong> ${ event.location }
+                                                            </span>
+                                                        </div>
+                                                        <div class="flex items-start gap-2" v-if="event.attendees && event.attendees.length > 0">
+                                                            <i class="fas fa-users text-[var(--text-muted)] w-4 mt-0.5"></i>
+                                                            <div class="text-[var(--text-secondary)]">
+                                                                <strong v-text="t('events.attendees') + ':'"></strong>
+                                                                <span class="ml-1">${ event.attendees.join(', ') }</span>
+                                                            </div>
+                                                        </div>
+                                                    </div>
+                                                </div>
+
+                                                <div v-if="selectedRecording.events.length === 0" class="text-center py-8">
+                                                    <i class="fas fa-calendar-times text-3xl text-[var(--text-muted)] mb-3"></i>
+                                                    <p class="text-[var(--text-muted)]" v-text="t('events.noEvents')"></p>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Chat Section -->
+                                <div class="border-t border-[var(--border-primary)] flex flex-col" :class="{'flex-1 overflow-hidden': isChatMaximized}">
+                                    <!-- Chat Toggle -->
+                                    <div class="bg-[var(--bg-tertiary)] px-4 py-3 hover:bg-[var(--bg-accent-hover)] transition-colors flex items-center">
+                                        <button @click="() => { showChat = !showChat; if (!showChat) isChatMaximized = false; }"
+                                                class="flex-1 text-left flex items-center">
+                                            <span class="font-medium flex items-center">
+                                                <i class="fas fa-comments mr-2"></i>
+                                                ${ t('chat.chatWithTranscription') }
+                                            </span>
+                                        </button>
+                                        <div class="flex items-center gap-2">
+                                            <button v-if="chatMessages.length > 0"
+                                                    @click="downloadChat"
+                                                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors"
+                                                    :title="t('buttons.downloadChat')">
+                                                <i class="fas fa-download text-sm"></i>
+                                            </button>
+                                            <button @click="toggleChatMaximize"
+                                                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors"
+                                                    :title="isChatMaximized ? 'Restore chat' : 'Maximize chat'">
+                                                <i :class="['fas text-sm', isChatMaximized ? 'fa-compress' : 'fa-expand']"></i>
+                                            </button>
+                                            <button @click="() => { showChat = !showChat; if (!showChat) isChatMaximized = false; }"
+                                                    class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                                <i :class="['fas transition-transform duration-200', showChat ? 'fa-chevron-down' : 'fa-chevron-up']"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+
+                                    <!-- Chat Content -->
+                                    <div v-if="showChat" class="flex flex-col relative" :class="isChatMaximized ? 'flex-1 overflow-hidden' : 'max-h-96'">
+                                        <!-- Clear button - fixed at top right -->
+                                        <button v-if="chatMessages.length > 0"
+                                                @click="clearChat"
+                                                class="absolute top-2 right-2 p-1 text-[var(--text-muted)] opacity-60 hover:opacity-100 hover:text-[var(--text-danger)] rounded transition-all duration-200 z-20"
+                                                title="Clear chat">
+                                            <i class="fas fa-times text-xs"></i>
+                                        </button>
+
+                                        <!-- Chat Messages -->
+                                        <div ref="chatMessagesRef"
+                                             class="flex-1 overflow-y-auto p-4 space-y-4 bg-[var(--bg-secondary)]">
+                                            <div v-if="chatMessages.length === 0" class="text-center py-8">
+                                                <i class="fas fa-robot text-3xl text-[var(--text-muted)] mb-3"></i>
+                                                <p class="text-[var(--text-muted)]" v-text="t('help.askAboutTranscription')"></p>
+                                            </div>
+                                            
+                                            <div v-for="(message, index) in chatMessages" 
+                                                 :key="index" 
+                                                 :class="[
+                                                     'message relative group',
+                                                     message.role === 'user' ? 'user-message ml-auto' : 'ai-message',
+                                                     message.role === 'assistant' ? 'pr-10' : ''
+                                                 ]">
+                                                <!-- Copy button for assistant messages -->
+                                                <button v-if="message.role === 'assistant'" 
+                                                        @click="copyMessage(message.content, $event)" 
+                                                        class="absolute top-2 right-2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded transition-all duration-200"
+                                                        :title="t('buttons.copyMessage')">
+                                                    <i class="fas fa-copy text-sm"></i>
+                                                </button>
+                                                <!-- Show thinking content if available -->
+                                                <div v-if="message.thinking && message.role === 'assistant'" class="mb-2">
+                                                    <button @click="message.thinkingExpanded = !message.thinkingExpanded" 
+                                                            class="text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)] flex items-center gap-1">
+                                                        <i :class="['fas', message.thinkingExpanded ? 'fa-chevron-down' : 'fa-chevron-right']"></i>
+                                                        <span v-text="t('help.modelReasoning')"></span>
+                                                        <span class="text-[var(--text-muted)]">(${message.thinking.split('\n').length} lines)</span>
+                                                    </button>
+                                                    <div v-if="message.thinkingExpanded" 
+                                                         class="mt-2 p-3 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg text-xs text-[var(--text-muted)] max-h-64 overflow-y-auto">
+                                                        <pre class="whitespace-pre-wrap font-mono">${message.thinking}</pre>
+                                                    </div>
+                                                </div>
+                                                <!-- Main message content -->
+                                                <div v-if="message.html" v-html="message.html"></div>
+                                                <div v-else class="whitespace-pre-wrap">${message.content}</div>
+                                            </div>
+                                            
+                                            <div v-if="isChatLoading" class="ai-message">
+                                                <i class="fas fa-spinner fa-spin mr-2"></i>
+                                                ${ t('chat.thinking') }
+                                            </div>
+                                        </div>
+
+                                        <!-- Chat Input -->
+                                        <div class="border-t border-[var(--border-primary)] p-4 bg-[var(--bg-tertiary)]">
+                                            <div class="flex gap-2">
+                                                <textarea v-model="chatInput" 
+                                                          @keydown="handleChatKeydown"
+                                                          :disabled="isChatLoading || selectedRecording.status !== 'COMPLETED'"
+                                                          :placeholder="t('chat.placeholderWithHint')"
+                                                          class="flex-1 px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg resize-none focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm"
+                                                          rows="2">
+                                                </textarea>
+                                                <button @click="sendChatMessage" 
+                                                        :disabled="!chatInput.trim() || isChatLoading || selectedRecording.status !== 'COMPLETED'"
+                                                        class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors disabled:opacity-50 disabled:cursor-not-allowed">
+                                                    <i class="fas fa-paper-plane"></i>
+                                                </button>
+                                            </div>
+                                            <p v-if="selectedRecording.status !== 'COMPLETED'" 
+                                               class="text-xs text-[var(--text-muted)] mt-2">
+                                                ${ t('chat.availableAfterTranscription') }
+                                            </p>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Empty State -->
+                <div v-else-if="currentView === 'detail' && !selectedRecording" class="flex-1 flex items-center justify-center">
+                    <div class="text-center">
+                        <i class="fas fa-microphone text-6xl text-[var(--text-muted)] mb-4"></i>
+                        <h2 class="text-2xl font-bold mb-2" v-text="t('colorScheme.selectRecording')"></h2>
+                        <p class="text-[var(--text-muted)] mb-6" v-text="t('colorScheme.chooseRecording')"></p>
+                        <button @click="switchToUploadView" 
+                                class="px-6 py-3 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                            <i class="fas fa-plus mr-2"></i>Upload New Recording
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Upload Progress Popup -->
+        <div v-if="uploadQueue.length > 0 && !progressPopupClosed" 
+             :class="[
+                 'fixed bottom-4 left-4 z-[100] w-96 transition-all duration-300',
+                 progressPopupMinimized ? 'minimized' : ''
+             ]">
+            <div class="bg-[var(--bg-secondary)] border-2 border-[var(--bg-accent)] rounded-lg shadow-2xl overflow-hidden backdrop-blur-sm bg-opacity-95 
+                        ring-4 ring-[var(--bg-accent)] ring-opacity-20"
+                 style="box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04), 0 0 0 1px var(--bg-accent), 0 0 20px rgba(var(--bg-accent-rgb), 0.3)">
+                <!-- Progress Header -->
+                <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-accent-hover)] px-4 py-3">
+                    <!-- Top row: Title and buttons -->
+                    <div class="flex items-center justify-between mb-2">
+                        <div class="flex items-center gap-2 min-w-0">
+                            <i class="fas fa-upload text-gray-800 dark:text-white animate-pulse"></i>
+                            <span class="font-semibold text-gray-800 dark:text-white truncate" v-text="t('uploadProgress.title')"></span>
+                        </div>
+                        <div class="flex items-center gap-2 flex-shrink-0">
+                            <button v-if="completedInQueue > 0" @click="clearCompletedUploads()" 
+                                    class="px-2 py-0.5 text-xs bg-black dark:bg-white bg-opacity-10 dark:bg-opacity-20 hover:bg-opacity-20 dark:hover:bg-opacity-30 rounded transition-all duration-200 text-gray-800 dark:text-white font-medium"
+                                    :title="t('buttons.clearCompleted')">
+                                Clear
+                            </button>
+                            <button @click="progressPopupMinimized = !progressPopupMinimized" 
+                                    class="p-1 rounded hover:bg-black dark:hover:bg-white hover:bg-opacity-10 dark:hover:bg-opacity-20 transition-colors text-gray-800 dark:text-white">
+                                <i :class="progressPopupMinimized ? 'fas fa-chevron-up' : 'fas fa-chevron-down'"></i>
+                            </button>
+                            <button @click="progressPopupClosed = true" 
+                                    class="p-1 rounded hover:bg-red-600 dark:hover:bg-red-500 hover:bg-opacity-20 dark:hover:bg-opacity-30 text-gray-800 dark:text-white hover:text-white transition-colors">
+                                <i class="fas fa-times"></i>
+                            </button>
+                        </div>
+                    </div>
+                    <!-- Overall Progress Bar -->
+                    <div class="space-y-1">
+                        <div class="flex justify-between items-center text-xs text-gray-800 dark:text-white">
+                            <span class="font-medium">${completedInQueue} of ${totalInQueue} files</span>
+                            <span class="font-bold">${Math.round((completedInQueue / Math.max(totalInQueue, 1)) * 100)}%</span>
+                        </div>
+                        <div class="w-full bg-black dark:bg-white bg-opacity-10 dark:bg-opacity-20 rounded-full h-2 overflow-hidden">
+                            <div class="bg-white dark:bg-white bg-opacity-80 dark:bg-opacity-90 h-full rounded-full transition-all duration-500 ease-out relative overflow-hidden" 
+                                 :style="{width: (completedInQueue / Math.max(totalInQueue, 1) * 100) + '%'}">
+                                <div class="absolute inset-0 bg-white opacity-30 animate-pulse"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Progress Content -->
+                <div v-if="!progressPopupMinimized" class="p-3 max-h-64 overflow-y-auto">
+                    <div v-if="currentlyProcessingFile" class="mb-3 p-3 bg-[var(--bg-accent)] bg-opacity-10 border border-[var(--border-accent)] rounded-lg">
+                        <div class="flex items-center justify-between mb-2">
+                            <span class="font-semibold truncate min-w-0 text-sm text-[var(--text-primary)]">${currentlyProcessingFile.file.name}</span>
+                            <span class="text-sm flex-shrink-0 ml-2 font-bold text-[var(--text-accent)]">${processingProgress}%</span>
+                        </div>
+                        <div class="w-full bg-[var(--bg-tertiary)] rounded-full h-2 mb-2 overflow-hidden">
+                            <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-accent-hover)] h-full rounded-full transition-all duration-300 relative" 
+                                 :style="{width: processingProgress + '%'}">
+                                <div class="absolute inset-0 bg-white opacity-20 animate-pulse"></div>
+                            </div>
+                        </div>
+                        <p class="text-xs text-[var(--text-secondary)] font-medium">${processingMessage}</p>
+                    </div>
+
+                    <div v-if="finishedFilesInQueue.length > 0" class="space-y-2">
+                        <h4 class="text-xs font-semibold text-[var(--text-secondary)] uppercase tracking-wider opacity-70" v-text="t('help.completedFiles')"></h4>
+                        <div v-for="item in finishedFilesInQueue" 
+                             :key="item.clientId" 
+                             class="progress-list-item p-2 bg-[var(--bg-tertiary)] bg-opacity-50 rounded-lg flex items-center gap-2 hover:bg-opacity-70 transition-all duration-200">
+                            <i :class="[
+                                'fas',
+                                item.status === 'completed' ? 'fa-check-circle text-green-500' : 'fa-exclamation-circle text-red-500'
+                            ]"></i>
+                            <span class="truncate text-sm flex-1 text-[var(--text-primary)]">${item.file.name}</span>
+                            <span :class="[
+                                'text-xs px-2 py-1 rounded-full font-semibold',
+                                item.status === 'completed' ? 'bg-green-500 bg-opacity-20 text-green-600 dark:text-green-400' : 'bg-red-500 bg-opacity-20 text-red-600 dark:text-red-400'
+                            ]">
+                                ${item.status === 'completed' ? t('tagsModal.done') : t('status.failed')}
+                            </span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Modals -->
+        <!-- Edit Modal -->
+        <div v-if="showEditModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-lg">
+                <div class="p-6 border-b border-[var(--border-primary)]">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.editRecording')"></h3>
+                </div>
+                <div class="p-6 space-y-4">
+                    <div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('form.title')"></label>
+                        <input v-model="editingRecording.title" 
+                               class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('form.participants')"></label>
+                        <input v-model="editingRecording.participants" 
+                               class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('form.meetingDate')"></label>
+                        <input v-model="editingRecording.meeting_date" 
+                               type="date"
+                               class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('form.notes')"></label>
+                        <textarea v-model="editingRecording.notes" 
+                                  rows="4"
+                                  class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        </textarea>
+                    </div>
+                </div>
+                <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+                    <button @click="cancelEdit" 
+                            class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="saveEdit" 
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                        Save Changes
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Delete Confirmation Modal -->
+        <div v-if="showDeleteModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-md">
+                <div class="p-6">
+                    <div class="flex items-center gap-4 mb-4">
+                        <i class="fas fa-exclamation-triangle text-3xl text-[var(--text-danger)]"></i>
+                        <div>
+                            <h3 class="text-lg font-semibold" v-text="t('modal.deleteRecording')"></h3>
+                            <p class="text-[var(--text-muted)]" v-text="t('help.thisActionCannotBeUndone')"></p>
+                        </div>
+                    </div>
+                    <p class="text-[var(--text-secondary)] mb-6">
+                        Are you sure you want to delete "${recordingToDelete?.title || 'this recording'}"?
+                    </p>
+                    <div class="flex justify-end gap-3">
+                        <button @click="cancelDelete" 
+                                class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                            Cancel
+                        </button>
+                        <button @click="deleteRecording" 
+                                class="px-4 py-2 bg-[var(--bg-danger)] text-white rounded-lg hover:bg-[var(--bg-danger-hover)] transition-colors">
+                            Delete
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Edit Recording Tags Modal -->
+        <div v-if="showEditTagsModal" @click="closeEditTagsModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-lg max-h-[80vh] flex flex-col">
+                <div class="flex-shrink-0 p-6 border-b border-[var(--border-primary)]">
+                    <div class="flex items-center justify-between">
+                        <h3 class="text-lg font-medium text-[var(--text-primary)]" v-text="t('modal.editTags')"></h3>
+                        <button @click="closeEditTagsModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                            <i class="fas fa-times"></i>
+                        </button>
+                    </div>
+                </div>
+                <div class="flex-1 overflow-y-auto p-6 space-y-4">
+                    <!-- Current Tags Section -->
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-tags mr-1 text-[var(--text-muted)]"></i>
+                            <span v-text="t('tagsModal.currentTags')"></span>
+                        </label>
+                        <div v-if="getRecordingTags(editingRecording).length > 0" class="p-2 bg-[var(--bg-primary)] rounded-md border border-[var(--border-secondary)] max-h-20 overflow-y-auto">
+                            <div class="flex flex-wrap gap-1">
+                                <span v-for="tag in getRecordingTags(editingRecording)" :key="tag.id"
+                                      class="group inline-flex items-center px-1.5 py-0.5 rounded-full text-[11px] font-medium text-white transition-all"
+                                      :style="{ backgroundColor: tag.color }"
+                                      :title="tag.group_id ? '👥 Team Tag' : ''">
+                                    <i v-if="tag.group_id" class="fas fa-users mr-1" style="font-size: 9px;"></i>
+                                    <span v-text="tag.name"></span>
+                                    <button @click="removeTagFromRecording(tag.id)"
+                                            class="ml-1 opacity-70 hover:opacity-100 transition-opacity">
+                                        <i class="fas fa-times" style="font-size: 9px;"></i>
+                                    </button>
+                                </span>
+                            </div>
+                        </div>
+                        <div v-else class="p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)]">
+                            <p class="text-sm text-[var(--text-muted)] text-center">
+                                <i class="fas fa-inbox mr-1"></i>
+                                <span v-text="t('tagsModal.noTagsAssigned')"></span>
+                            </p>
+                        </div>
+                    </div>
+                    
+                    <!-- Add Tags Section -->
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-secondary)] mb-3">
+                            <i class="fas fa-plus-circle mr-1 text-[var(--text-muted)]"></i>
+                            <span v-text="t('tagsModal.addTags')"></span>
+                        </label>
+                        
+                        <!-- Search Filter (always visible if tags available) -->
+                        <div v-if="getAvailableTagsForRecording(editingRecording).length > 0" class="mb-2">
+                            <div class="relative">
+                                <input v-model="tagSearchFilter" 
+                                       type="text" 
+                                       :placeholder="t('tagsModal.searchTags')"
+                                       class="w-full px-2 py-1 pl-6 text-xs bg-[var(--bg-primary)] text-[var(--text-primary)] border border-[var(--border-primary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                                <i class="fas fa-search absolute left-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]" style="font-size: 9px;"></i>
+                                <button v-if="tagSearchFilter" 
+                                        @click="tagSearchFilter = ''"
+                                        class="absolute right-2 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                                    <i class="fas fa-times" style="font-size: 9px;"></i>
+                                </button>
+                            </div>
+                        </div>
+                        
+                        <!-- Available Tags Grid - Fixed Height -->
+                        <div v-if="filteredAvailableTagsForModal.length > 0" 
+                             class="border border-[var(--border-secondary)] rounded-md p-1.5 bg-[var(--bg-primary)]" 
+                             style="max-height: 150px; overflow-y: auto;">
+                            <div class="grid grid-cols-2 gap-1">
+                                <button v-for="tag in filteredAvailableTagsForModal"
+                                        :key="tag.id"
+                                        @click="addTagToRecording(tag.id)"
+                                        class="group flex items-center justify-between px-1.5 py-1 rounded border transition-all"
+                                        :class="tag.group_id ? 'border-blue-400 bg-blue-50 dark:bg-blue-900/20 hover:bg-blue-100 dark:hover:bg-blue-900/30' : 'border-[var(--border-secondary)] bg-[var(--bg-secondary)] hover:border-[var(--border-focus)] hover:bg-[var(--bg-tertiary)]'">
+                                    <div class="flex items-center gap-1 min-w-0">
+                                        <span class="w-2 h-2 rounded-full flex-shrink-0"
+                                              :style="{ backgroundColor: tag.color || '#6B7280' }"></span>
+                                        <i v-if="tag.group_id" class="fas fa-users text-blue-600 dark:text-blue-400" style="font-size: 9px;"></i>
+                                        <span class="text-[11px] text-[var(--text-primary)] truncate" v-text="tag.name"></span>
+                                    </div>
+                                    <i class="fas fa-plus text-[var(--text-muted)] group-hover:text-[var(--text-accent)] transition-colors" style="font-size: 9px;"></i>
+                                </button>
+                            </div>
+                        </div>
+                        <div v-else-if="getAvailableTagsForRecording(editingRecording).length > 0" 
+                             class="p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)]">
+                            <p class="text-sm text-[var(--text-muted)] text-center">
+                                <i class="fas fa-search mr-1"></i>
+                                No tags match your filter
+                            </p>
+                        </div>
+                        <div v-else class="p-4 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-secondary)]">
+                            <p class="text-sm text-[var(--text-muted)] text-center">
+                                <i class="fas fa-check-circle mr-1"></i>
+                                All available tags have been added
+                            </p>
+                        </div>
+                    </div>
+                </div>
+                <div class="flex-shrink-0 px-6 py-4 bg-[var(--bg-tertiary)] border-t border-[var(--border-primary)] flex justify-end gap-3 rounded-b-lg">
+                    <button @click="closeEditTagsModal" 
+                            class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-primary)] rounded-md hover:bg-[var(--bg-button-hover)] transition-colors">
+                        <span v-text="t('tagsModal.done')"></span>
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Color Scheme Modal -->
+        <div v-if="showColorSchemeModal" class="color-scheme-modal" @click.self="closeColorSchemeModal">
+            <div class="color-scheme-modal-content">
+                <div class="color-scheme-header">
+                    <h2 class="color-scheme-title">
+                        <i class="fas fa-palette"></i>
+                        <span v-text="t('colorScheme.title')"></span>
+                    </h2>
+                    <p class="color-scheme-subtitle" v-text="t('colorScheme.subtitle')"></p>
+                </div>
+
+                <div class="color-scheme-body">
+                    <div class="color-scheme-section">
+                        <h3 class="color-scheme-section-title">
+                            <i :class="isDarkMode ? 'fas fa-moon' : 'fas fa-sun'"></i>
+                            <span v-text="isDarkMode ? t('colorScheme.darkThemes') : t('colorScheme.lightThemes')"></span>
+                        </h3>
+                        <div class="color-scheme-grid">
+                            <div v-for="scheme in colorSchemes[isDarkMode ? 'dark' : 'light']"
+                                 :key="scheme.id"
+                                 @click="selectColorScheme(scheme.id)"
+                                 :class="['color-scheme-option', currentColorScheme === scheme.id ? 'active' : '']">
+                                <div class="color-scheme-preview">
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-primary color-scheme-preview-segment`"></div>
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-secondary color-scheme-preview-segment`"></div>
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-tertiary color-scheme-preview-segment`"></div>
+                                </div>
+                                <div class="color-scheme-name" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.name')"></div>
+                                <div class="color-scheme-description" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.description')"></div>
+                                <div v-if="currentColorScheme === scheme.id" class="color-scheme-check">
+                                    <i class="fas fa-check"></i>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="color-scheme-footer">
+                    <button @click="resetColorScheme" class="color-scheme-reset-btn">
+                        <i class="fas fa-undo mr-2"></i><span v-text="t('colorScheme.resetToDefault')"></span>
+                    </button>
+                    <button @click="closeColorSchemeModal" class="color-scheme-close-btn" v-text="t('common.close')">
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Reprocess Confirmation Modal -->
+        <div v-if="showReprocessModal" @click="cancelReprocess" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm transition-all duration-300 ease-in-out">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+                <!-- Header with gradient background -->
+                <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-secondary)] p-5 rounded-t-xl flex items-center">
+                    <div class="flex items-center">
+                        <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center mr-4 shadow-lg">
+                            <i class="fas fa-sync-alt text-white text-lg"></i>
+                        </div>
+                        <div>
+                            <h3 class="text-xl font-bold text-[var(--text-primary)] mb-1" v-text="t('help.confirmReprocessingTitle')"></h3>
+                            <p class="text-sm text-[var(--text-muted)] capitalize">${ reprocessType } reprocessing</p>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Content -->
+                <div class="p-6 modal-content">
+                    <div v-if="reprocessRecording" class="mb-6">
+                        <div class="bg-[var(--bg-tertiary)] rounded-lg p-4 border border-[var(--border-primary)]">
+                            <div class="flex items-start space-x-3">
+                                <i class="fas fa-file-audio text-[var(--text-accent)] mt-1"></i>
+                                <div class="flex-1 min-w-0">
+                                    <h4 class="font-medium text-[var(--text-primary)] truncate" :title="reprocessRecording.title">
+                                        ${ reprocessRecording.title || 'Untitled Recording' }
+                                    </h4>
+                                    <p class="text-sm text-[var(--text-muted)] mt-1">
+                                        Created: ${ new Date(reprocessRecording.created_at).toLocaleDateString() }
+                                    </p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <div class="space-y-4">
+                        <div class="flex items-start space-x-3">
+                            <div class="w-6 h-6 bg-amber-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                                <i class="fas fa-exclamation-triangle text-amber-600 text-xs"></i>
+                            </div>
+                            <div>
+                                <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.whatWillHappen')"></p>
+                                <p class="text-sm text-[var(--text-muted)]" v-if="reprocessType === 'transcription' && !useAsrEndpoint">
+                                    <span v-text="t('reprocessModal.audioReTranscribedFromScratch')"></span>
+                                </p>
+                                <p class="text-sm text-[var(--text-muted)]" v-else-if="reprocessType === 'transcription' && useAsrEndpoint">
+                                    <span v-text="t('reprocessModal.audioReTranscribedWithAsr')"></span>
+                                </p>
+                                <p class="text-sm text-[var(--text-muted)]" v-else-if="reprocessType === 'summary'">
+                                    <span v-text="t('reprocessModal.newTitleAndSummary')"></span>
+                                </p>
+                            </div>
+                        </div>
+                        
+                        <!-- ASR Options -->
+                        <div v-if="reprocessType === 'transcription' && useAsrEndpoint" class="space-y-4 pt-4 border-t border-[var(--border-primary)]">
+                            <h4 class="text-md font-semibold text-[var(--text-secondary)]" v-text="t('help.advancedAsrOptions')"></h4>
+                            <div>
+                                <label for="asr-language-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.language')"></label>
+                                <input type="text" id="asr-language-reprocess" v-model="asrReprocessOptions.language" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="e.g., en, es, zh (optional)">
+                            </div>
+                            <div>
+                                <label for="asr-min-speakers-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.minSpeakers')"></label>
+                                <input type="number" id="asr-min-speakers-reprocess" v-model.number="asrReprocessOptions.min_speakers" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" :placeholder="t('form.optional')">
+                            </div>
+                            <div>
+                                <label for="asr-max-speakers-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.maxSpeakers')"></label>
+                                <input type="number" id="asr-max-speakers-reprocess" v-model.number="asrReprocessOptions.max_speakers" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" :placeholder="t('form.optional')">
+                            </div>
+                        </div>
+
+                        <!-- Custom Prompt Options for Summary Reprocessing -->
+                        <div v-if="reprocessType === 'summary'" class="space-y-4 pt-4 border-t border-[var(--border-primary)]">
+                            <h4 class="text-md font-semibold text-[var(--text-secondary)]">Custom Summarization Prompt</h4>
+
+                            <!-- Prompt Source Selection -->
+                            <div>
+                                <label class="block text-sm font-medium text-[var(--text-muted)] mb-2">Prompt Source</label>
+                                <div class="space-y-2">
+                                    <label class="flex items-center space-x-2 cursor-pointer">
+                                        <input type="radio" v-model="summaryReprocessPromptSource" value="default" class="text-[var(--text-accent)]" name="promptSource">
+                                        <span class="text-sm text-[var(--text-secondary)]">Use default prompt</span>
+                                    </label>
+                                    <label class="flex items-center space-x-2 cursor-pointer" v-if="tagsWithCustomPrompts.length > 0">
+                                        <input type="radio" v-model="summaryReprocessPromptSource" value="tag" class="text-[var(--text-accent)]" name="promptSource">
+                                        <span class="text-sm text-[var(--text-secondary)]">Use prompt from tag</span>
+                                    </label>
+                                    <label class="flex items-center space-x-2 cursor-pointer">
+                                        <input type="radio" v-model="summaryReprocessPromptSource" value="custom" class="text-[var(--text-accent)]" name="promptSource">
+                                        <span class="text-sm text-[var(--text-secondary)]">Enter custom prompt</span>
+                                    </label>
+                                </div>
+                            </div>
+
+                            <!-- Tag Selection (shown when 'tag' is selected) -->
+                            <div v-if="summaryReprocessPromptSource === 'tag' && tagsWithCustomPrompts.length > 0">
+                                <label for="reprocess-tag-select" class="block text-sm font-medium text-[var(--text-muted)] mb-2">Select Tag</label>
+                                <select id="reprocess-tag-select" v-model="summaryReprocessSelectedTagId" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                                    <option value="">Select a tag...</option>
+                                    <option v-for="tag in tagsWithCustomPrompts" :key="tag.id" :value="tag.id">${ tag.name }</option>
+                                </select>
+                                <div v-if="summaryReprocessSelectedTagId" class="mt-2 p-2 bg-[var(--bg-tertiary)] rounded text-xs text-[var(--text-muted)] max-h-20 overflow-y-auto">
+                                    <strong>Preview:</strong> ${ getTagPromptPreview(summaryReprocessSelectedTagId) }
+                                </div>
+                            </div>
+
+                            <!-- Custom Prompt Textarea (shown when 'custom' is selected) -->
+                            <div v-if="summaryReprocessPromptSource === 'custom'">
+                                <label for="reprocess-custom-prompt" class="block text-sm font-medium text-[var(--text-muted)] mb-2">Custom Prompt</label>
+                                <textarea id="reprocess-custom-prompt" v-model="summaryReprocessCustomPrompt" rows="4" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Enter your custom summarization instructions..."></textarea>
+                            </div>
+
+                            <!-- Info message when no tags with custom prompts exist -->
+                            <div v-if="summaryReprocessPromptSource === 'tag' && tagsWithCustomPrompts.length === 0" class="text-xs text-[var(--text-muted)] italic">
+                                No tags with custom prompts available. Create tags with custom prompts in the Account Settings.
+                            </div>
+                        </div>
+
+                        <div class="flex items-start space-x-3">
+                            <div class="w-6 h-6 bg-blue-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                                <i class="fas fa-clock text-blue-600 text-xs"></i>
+                            </div>
+                            <div>
+                                <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.processingTime')"></p>
+                                <p class="text-sm text-[var(--text-muted)]">
+                                    <span v-text="t('help.processingTimeDescription')"></span>
+                                </p>
+                            </div>
+                        </div>
+                        
+                        <div class="flex items-start space-x-3" v-if="reprocessType === 'transcription'">
+                            <div class="w-6 h-6 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                                <i class="fas fa-info-circle text-red-600 text-xs"></i>
+                            </div>
+                            <div>
+                                <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.importantNote')"></p>
+                                <p class="text-sm text-[var(--text-muted)]">
+                                    <span v-text="t('reprocessModal.manualEditsOverwritten')"></span>
+                                </p>
+                            </div>
+                        </div>
+                        
+                        <div class="flex items-start space-x-3" v-else-if="reprocessType === 'summary'">
+                            <div class="w-6 h-6 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                                <i class="fas fa-info-circle text-red-600 text-xs"></i>
+                            </div>
+                            <div>
+                                <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.importantNote')"></p>
+                                <p class="text-sm text-[var(--text-muted)]">
+                                    <span v-text="t('reprocessModal.manualEditsOverwrittenSummary')"></span>
+                                </p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Footer with action buttons -->
+                <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)]">
+                    <button 
+                        @click="cancelReprocess" 
+                        class="px-5 py-2.5 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-all duration-200 flex items-center shadow-sm font-medium">
+                        <i class="fas fa-times mr-2"></i>
+                        Cancel
+                    </button>
+                    <button 
+                        @click="executeReprocess" 
+                        class="px-5 py-2.5 bg-gradient-to-r from-blue-500 to-purple-600 text-white rounded-lg hover:from-blue-600 hover:to-purple-700 transition-all duration-200 flex items-center shadow-lg font-medium transform hover:scale-105">
+                        <i class="fas fa-sync-alt mr-2"></i>
+                        Start Reprocessing
+                    </button>
+                </div>
+            </div>
+        </div>
+        <!-- Reset Status Confirmation Modal -->
+        <div v-if="showResetModal" @click="cancelReset" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md">
+                <div class="p-6 text-center">
+                    <div class="mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-orange-100 dark:bg-orange-800 mb-4">
+                        <i class="fas fa-exclamation-triangle text-2xl text-orange-500 dark:text-orange-300"></i>
+                    </div>
+                    <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-2" v-text="t('modal.resetStatus')"></h3>
+                    <p class="text-sm text-[var(--text-muted)] mb-6">
+                        This will mark the recording as 'Failed'. This is useful if processing is stuck. You will be able to reprocess it afterwards.
+                    </p>
+                </div>
+                <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3">
+                    <button @click="cancelReset" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]">
+                        Cancel
+                    </button>
+                    <button @click="executeReset" class="px-4 py-2 bg-orange-500 text-white rounded-lg hover:bg-orange-600">
+                        Yes, Reset Status
+                    </button>
+                </div>
+            </div>
+        </div>
+        <!-- Simple Transcription Editor Modal -->
+        <div v-if="showTextEditorModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[90vh] flex flex-col">
+                <div class="p-6 border-b border-[var(--border-primary)]">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.editTranscription')"></h3>
+                </div>
+                <div class="p-6 space-y-4 overflow-y-auto flex-1">
+                    <div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('transcription.title')"></label>
+                        <textarea v-model="editingTranscriptionContent"
+                                  rows="15"
+                                  class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] font-mono text-sm">
+                        </textarea>
+                    </div>
+                </div>
+                <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+                    <button @click="closeTextEditorModal"
+                            class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="saveTranscription"
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                        Save Changes
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- ASR Transcription Editor Modal -->
+        <div v-if="showAsrEditorModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click="closeAllSpeakerSuggestions" class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-6xl flex flex-col max-h-[90vh]">
+                <div class="p-5 border-b border-[var(--border-primary)] flex-shrink-0 flex justify-between items-center">
+                    <h3 class="text-xl font-bold text-[var(--text-primary)]" v-text="t('modal.editAsrTranscription')"></h3>
+                    <button @click="closeAsrEditorModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+
+                <!-- Audio Player Section -->
+                <div class="px-6 py-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                    <div class="audio-player-container">
+                        <!-- Show message if audio has been deleted -->
+                        <div v-if="selectedRecording.audio_deleted_at"
+                             class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-secondary)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                            <i class="fas fa-info-circle"></i>
+                            <span v-text="t('help.audioDeletedMessage')"></span>
+                        </div>
+                        <audio v-else ref="asrEditorAudio" controls class="w-full" :key="'asr-editor-' + selectedRecording.id" :src="'/audio/' + selectedRecording.id" :volume="playerVolume" @volumechange="onPlayerVolumeChange">
+                            Your browser does not support the audio element.
+                        </audio>
+                    </div>
+                </div>
+
+                <div class="flex-grow overflow-y-auto custom-scrollbar" @scroll="closeAllSpeakerSuggestions">
+                    <table class="min-w-full asr-editor-table border border-[var(--border-primary)]">
+                        <thead class="sticky top-0 z-10">
+                            <tr class="text-xs uppercase text-[var(--text-muted)]">
+                                <th class="w-40 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.speakerCount')"></th>
+                                <th class="w-20 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.startTime')"></th>
+                                <th class="w-20 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.endTime')"></th>
+                                <th class="text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.sentence')"></th>
+                                <th class="w-24 text-center py-2 px-1 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]"><span class="sr-only" v-text="t('help.actions')"></span></th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr v-for="(segment, index) in editingSegments" :key="segment.id || index" class="hover:bg-[var(--bg-tertiary)] transition-colors border-b border-[var(--border-primary)]">
+                                <td class="border-r border-[var(--border-primary)] align-middle">
+                                    <div class="relative h-full" :ref="'speakerDropdown' + index">
+                                        <div class="flex items-center h-full">
+                                            <input type="text" v-model="segment.speaker"
+                                                   @input="filterSpeakers(index); openSpeakerSuggestions(index)"
+                                                   @focus="openSpeakerSuggestions(index)"
+                                                   class="w-full h-full px-3 py-2.5 pr-7 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)]" />
+                                            <button type="button" @click.stop="openSpeakerSuggestions(index)"
+                                                    class="absolute right-2 top-1/2 -translate-y-1/2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] cursor-pointer">
+                                                <i class="fas fa-chevron-down text-xs"></i>
+                                            </button>
+                                        </div>
+                                    </div>
+                                    <!-- Fixed position dropdown that can escape modal overflow -->
+                                    <teleport to="body">
+                                        <div v-if="segment.showSuggestions"
+                                             class="fixed z-[100] w-40 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-48 overflow-y-auto"
+                                             :style="getDropdownPosition(index)">
+                                            <div v-for="speaker in segment.filteredSpeakers" @mousedown.prevent="selectSpeaker(index, speaker)" class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-tertiary)] text-sm">${speaker}</div>
+                                            <div @mousedown.prevent="openEditSpeakersModal" class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-accent)] text-sm text-[var(--text-accent)] border-t border-[var(--border-primary)] flex items-center">
+                                                <i class="fas fa-user-edit mr-2"></i> <span v-text="t('buttons.editSpeakers')"></span>
+                                            </div>
+                                        </div>
+                                    </teleport>
+                                </td>
+                                <td class="border-r border-[var(--border-primary)] align-middle">
+                                    <input type="number" step="0.01" v-model.number="segment.start_time" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] text-center" />
+                                </td>
+                                <td class="border-r border-[var(--border-primary)] align-middle">
+                                    <input type="number" step="0.01" v-model.number="segment.end_time" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] text-center" />
+                                </td>
+                                <td class="border-r border-[var(--border-primary)] align-top">
+                                    <textarea v-model="segment.sentence" rows="1" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] resize-none max-h-20 overflow-y-auto custom-scrollbar block" @input="autoResizeTextarea($event)"></textarea>
+                                </td>
+                                <td class="px-1 text-center align-middle">
+                                    <div class="flex items-center justify-center gap-1">
+                                        <button @click="seekToSegmentTime(segment.start_time)" class="p-1.5 rounded hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors" :title="t('help.playFromHere')">
+                                            <i class="fas fa-play text-xs"></i>
+                                        </button>
+                                        <button @click="addSegmentBelow(index)" class="p-1.5 rounded hover:bg-green-600/20 text-[var(--text-muted)] hover:text-green-500 transition-colors" :title="t('help.addSegmentBelow')">
+                                            <i class="fas fa-plus text-xs"></i>
+                                        </button>
+                                        <button @click="removeSegment(index)" class="p-1.5 rounded hover:bg-red-600/20 text-[var(--text-muted)] hover:text-red-500 transition-colors" :title="t('help.deleteSegment')">
+                                            <i class="fas fa-trash text-xs"></i>
+                                        </button>
+                                    </div>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
+                    <div class="py-4 flex justify-center">
+                        <button @click="addSegment" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] flex items-center text-sm">
+                            <i class="fas fa-plus mr-2"></i> Add Segment
+                        </button>
+                    </div>
+                </div>
+                <div class="bg-[var(--bg-tertiary)] px-6 py-4 flex justify-end space-x-3 border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+                    <button @click="closeAsrEditorModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                    <button @click="saveAsrTranscription" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)]" v-text="t('buttons.saveChanges')"></button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Edit Speakers Modal (for ASR Editor) -->
+        <div v-if="showEditSpeakersModal" class="fixed inset-0 bg-black bg-opacity-80 flex items-center justify-center z-[60] p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md flex flex-col max-h-[80vh]">
+                <div class="p-5 border-b border-[var(--border-primary)] flex-shrink-0 flex justify-between items-center">
+                    <h3 class="text-lg font-bold text-[var(--text-primary)]" v-text="t('buttons.editSpeakers')"></h3>
+                    <button @click="closeEditSpeakersModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+                <div class="flex-grow overflow-y-auto custom-scrollbar p-5 space-y-3">
+                    <div v-for="(speaker, index) in editingSpeakersList" :key="index" class="flex items-center gap-2">
+                        <div class="relative flex-1" :ref="'editSpeakerInput' + index">
+                            <input type="text" v-model="editingSpeakersList[index]"
+                                   @input="filterEditingSpeakerSuggestions(index)"
+                                   @focus="filterEditingSpeakerSuggestions(index)"
+                                   @blur="setTimeout(() => closeEditingSpeakerSuggestions(index), 200)"
+                                   class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-1 focus:ring-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)]"
+                                   placeholder="Speaker name">
+                        </div>
+                        <button @click="removeEditingSpeaker(index)" class="p-2 rounded hover:bg-red-600/20 text-[var(--text-muted)] hover:text-red-500 transition-colors" title="Remove speaker">
+                            <i class="fas fa-trash text-sm"></i>
+                        </button>
+                    </div>
+                    <button @click="addEditingSpeaker" class="w-full px-3 py-2 border border-dashed border-[var(--border-secondary)] rounded-md text-sm text-[var(--text-muted)] hover:border-[var(--border-focus)] hover:text-[var(--text-primary)] transition-colors flex items-center justify-center gap-2">
+                        <i class="fas fa-plus"></i> Add Speaker
+                    </button>
+                </div>
+                <div class="bg-[var(--bg-tertiary)] px-5 py-4 flex justify-end space-x-3 border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+                    <button @click="closeEditSpeakersModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] text-sm">Cancel</button>
+                    <button @click="saveEditingSpeakers" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] text-sm">Save</button>
+                </div>
+                <!-- Teleported autocomplete dropdowns -->
+                <teleport to="body">
+                    <template v-for="(speaker, index) in editingSpeakersList" :key="'suggestion-' + index">
+                        <div v-if="editingSpeakerSuggestions[index] && editingSpeakerSuggestions[index].length > 0"
+                             class="fixed z-[200] bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-32 overflow-y-auto"
+                             :style="getEditSpeakerDropdownPosition(index)">
+                            <div v-for="suggestion in editingSpeakerSuggestions[index]"
+                                 @mousedown.prevent="selectEditingSpeakerSuggestion(index, suggestion)"
+                                 class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-tertiary)] text-sm text-[var(--text-primary)]">${suggestion}</div>
+                        </div>
+                    </template>
+                </teleport>
+            </div>
+        </div>
+
+        <!-- Speaker Identification Modal -->
+        <div v-if="showSpeakerModal" @click="closeSpeakerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop @click="closeSpeakerSuggestionsOnClick" class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-4xl flex flex-col h-[85vh]">
+                <div class="p-5 border-b border-[var(--border-primary)] flex-shrink-0">
+                    <h3 class="text-xl font-bold text-[var(--text-primary)]" v-text="t('modal.identifySpeakers')"></h3>
+                    <!-- Warning for too many speakers -->
+                    <div v-if="modalSpeakers.length > 8" class="mt-3 p-3 bg-[var(--bg-warn-light)] border border-amber-300 dark:border-amber-800 rounded-lg">
+                        <div class="flex items-start">
+                            <i class="fas fa-exclamation-triangle text-[var(--text-warn-strong)] mt-0.5 mr-2"></i>
+                            <div class="text-sm">
+                                <p class="font-medium text-[var(--text-warn-strong)]" v-text="t('help.moreSpeakersThanColors')"></p>
+                                <p class="text-[var(--text-warn-strong)] mt-1" v-text="t('help.youHaveXSpeakers', { count: modalSpeakers.length })">
+                                </p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="flex-grow flex overflow-hidden modal-content">
+                    <div class="w-1/3 p-6 space-y-4 overflow-y-auto custom-scrollbar border-r border-[var(--border-primary)]">
+                        <div v-for="(speaker, index) in modalSpeakers" :key="`${selectedRecording.id}-speaker-${index}-${speaker}`" class="space-y-3">
+                            <!-- Speaker label with color indicator and "This is Me" checkbox on same line -->
+                            <div class="flex items-center justify-between">
+                                <div class="flex items-center space-x-2">
+                                    <div :class="speakerMap[speaker].color" class="w-4 h-4 rounded-full border border-white/30 shadow-sm flex-shrink-0"></div>
+                                    <span class="font-mono text-sm text-[var(--text-muted)]">${ speakerDisplayMap[speaker] || speaker }</span>
+                                    <span v-if="index >= 8" class="text-xs text-[var(--text-warn-strong)] bg-[var(--bg-warn-light)] px-2 py-0.5 rounded-full" title="Color repeats from speaker ${ ((index % 8) + 1) }">
+                                        Repeat
+                                    </span>
+                                </div>
+                                <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                                    <input type="checkbox" 
+                                           v-model="speakerMap[speaker].isMe" 
+                                           @focus="highlightSpeakerInTranscript(speaker)" 
+                                           @blur="clearSpeakerHighlight" 
+                                           class="speaker-checkbox">
+                                    <span class="ml-2 select-none" v-text="t('help.me')"></span>
+                                </label>
+                            </div>
+                            
+                            <!-- Autocomplete input field - disabled when "This is Me" is checked -->
+                            <div class="relative">
+                                <input 
+                                    type="text" 
+                                    v-model="speakerMap[speaker].name" 
+                                    @input="searchSpeakers($event.target.value, speaker)"
+                                    @focus="focusSpeaker(speaker)" 
+                                    @blur="blurSpeaker()"
+                                    :disabled="speakerMap[speaker].isMe"
+                                    class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed" 
+                                    :placeholder="speakerMap[speaker].isMe ? t('help.me') : t('help.enterNameFor') + ' ' + (speakerDisplayMap[speaker] || speaker)"
+                                    autocomplete="off">
+                                
+                                <!-- Loading indicator -->
+                                <div v-if="loadingSuggestions[speaker] && !speakerMap[speaker].isMe" class="absolute right-3 top-1/2 transform -translate-y-1/2">
+                                    <i class="fas fa-spinner fa-spin text-[var(--text-muted)] text-sm"></i>
+                                </div>
+                                
+                                <!-- Suggestions dropdown - Only show when this input is active -->
+                                <div v-if="activeSpeakerInput === speaker && speakerSuggestions[speaker] && speakerSuggestions[speaker].length > 0 && !speakerMap[speaker].isMe" 
+                                     @click.stop
+                                     class="absolute z-10 w-full mt-1 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-48 overflow-y-auto">
+                                    <div class="py-1">
+                                        <div v-for="suggestion in speakerSuggestions[speaker]" 
+                                             :key="suggestion.id"
+                                             @click="selectSpeakerSuggestion(speaker, suggestion)"
+                                             class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-tertiary)] flex items-center justify-between">
+                                            <div class="flex-grow">
+                                                <div class="text-sm font-medium text-[var(--text-primary)]">${ suggestion.name }</div>
+                                                <div class="text-xs text-[var(--text-muted)]">
+                                                    Used ${ suggestion.use_count } time${ suggestion.use_count !== 1 ? 's' : '' }
+                                                    <span v-if="suggestion.last_used">
+                                                        • Last: ${ new Date(suggestion.last_used).toLocaleDateString() }
+                                                    </span>
+                                                </div>
+                                            </div>
+                                            <i class="fas fa-user text-[var(--text-muted)] ml-2"></i>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Add Speaker Button -->
+                        <div class="pt-4 border-t border-[var(--border-primary)]">
+                            <button @click="openAddSpeakerModal" class="w-full px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors flex items-center justify-center">
+                                <i class="fas fa-plus mr-2"></i>
+                                <span v-text="t('buttons.addSpeaker')"></span>
+                            </button>
+                        </div>
+                    </div>
+                    <div class="w-2/3 p-6 flex flex-col overflow-hidden">
+                        <!-- Audio Player Section -->
+                        <div class="mb-4 flex-shrink-0">
+                            <h4 class="font-semibold text-[var(--text-secondary)] mb-2" v-text="t('help.audioPlayer')"></h4>
+                            <div class="audio-player-container">
+                                <!-- Show message if audio has been deleted -->
+                                <div v-if="selectedRecording.audio_deleted_at"
+                                     class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-secondary)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                                    <i class="fas fa-info-circle"></i>
+                                    <span v-text="t('help.audioDeletedMessage')"></span>
+                                </div>
+                                <audio v-else controls class="w-full speaker-modal-transcript" :key="selectedRecording.id" :src="'/audio/' + selectedRecording.id" :volume="playerVolume" @volumechange="onPlayerVolumeChange">
+                                    Your browser does not support the audio element.
+                                </audio>
+                            </div>
+                        </div>
+                        
+                        <!-- Transcript Section -->
+                        <div class="flex-grow overflow-y-auto custom-scrollbar speaker-modal-transcript" @click="seekAudioFromEvent">
+                            <div v-if="processedTranscription.isJson">
+                                <div v-for="(segment, index) in processedTranscription.simpleSegments" :key="index" class="speaker-segment mb-2 group relative" :data-start-time="segment.startTime">
+                                    <p class="flex items-baseline">
+                                        <span :class="[segment.color, 'speaker-tag', { 'speaker-highlight': highlightedSpeaker === segment.speakerId }]" :data-speaker-id="segment.speakerId" class="inline-block w-[120px] flex-shrink-0 truncate" :title="segment.speaker">${ segment.speaker }</span>
+                                        <span class="mx-1 flex-shrink-0">:</span>
+                                        <span class="word cursor-pointer hover:bg-[var(--bg-accent)] hover:text-[var(--text-accent)] rounded px-0.5 flex-1">${ segment.sentence }</span>
+
+                                        <!-- Edit buttons (shown on hover) -->
+                                        <span class="ml-2 opacity-0 group-hover:opacity-100 transition-opacity flex items-center space-x-1 flex-shrink-0">
+                                            <!-- Change Speaker Button -->
+                                            <button @click.stop="openSpeakerChangeDropdown(index)" class="p-1 rounded bg-[var(--bg-tertiary)] hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors" title="Change speaker">
+                                                <i class="fas fa-user-edit text-xs"></i>
+                                            </button>
+                                            <!-- Edit Text Button -->
+                                            <button @click.stop="openEditTextModal(index)" class="p-1 rounded bg-[var(--bg-tertiary)] hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors" title="Edit text">
+                                                <i class="fas fa-edit text-xs"></i>
+                                            </button>
+                                        </span>
+                                    </p>
+
+                                    <!-- Speaker Change Dropdown -->
+                                    <div v-if="editingSpeakerIndex === index" @click.stop class="mt-2 p-2 bg-[var(--bg-tertiary)] rounded-lg border border-[var(--border-primary)] shadow-lg">
+                                        <p class="text-xs text-[var(--text-muted)] mb-2">Select new speaker:</p>
+                                        <div class="space-y-1 max-h-48 overflow-y-auto custom-scrollbar">
+                                            <button v-for="speaker in modalSpeakers" :key="speaker" @click="changeSpeaker(index, speaker)" class="w-full text-left px-3 py-2 rounded hover:bg-[var(--bg-accent)] hover:text-[var(--text-accent)] transition-colors flex items-center space-x-2">
+                                                <div :class="speakerMap[speaker].color" class="w-3 h-3 rounded-full flex-shrink-0"></div>
+                                                <span class="text-sm">${ speakerMap[speaker].name || speaker }</span>
+                                            </button>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                            <div v-else v-html="highlightedTranscript"></div>
+                        </div>
+                        
+                        <!-- Speaker Navigation Controls (at bottom) - Always visible for consistent height -->
+                        <div class="mt-3 p-3 bg-[var(--bg-tertiary)] rounded-lg flex items-center justify-between flex-shrink-0" :class="{'opacity-50': !highlightedSpeaker || speakerGroups.length <= 1}">
+                            <div class="flex items-center space-x-2">
+                                <span class="text-sm text-[var(--text-muted)]">
+                                    <span v-text="t('help.navigate')"></span> <span class="font-semibold">${ speakerDisplayMap[highlightedSpeaker] || highlightedSpeaker }</span> <span v-text="t('help.groups')"></span>:
+                                </span>
+                                <span class="text-xs text-[var(--text-muted)]">
+                                    (${ currentSpeakerGroupIndex + 1 } <span v-text="t('help.of')"></span> ${ speakerGroups.length })
+                                </span>
+                            </div>
+                            <div class="flex items-center space-x-2">
+                                <button @mousedown.prevent @click="navigateToPrevSpeakerGroup"
+                                        class="px-3 py-1.5 bg-[var(--bg-secondary)] hover:bg-[var(--bg-primary)] text-[var(--text-secondary)] rounded-md border border-[var(--border-secondary)] transition-all flex items-center text-sm disabled:opacity-50 disabled:cursor-not-allowed"
+                                        :disabled="!highlightedSpeaker || speakerGroups.length <= 1">
+                                    <i class="fas fa-chevron-up mr-1.5"></i>
+                                    <span v-text="t('buttons.previous')"></span>
+                                </button>
+                                <button @mousedown.prevent @click="navigateToNextSpeakerGroup"
+                                        class="px-3 py-1.5 bg-[var(--bg-secondary)] hover:bg-[var(--bg-primary)] text-[var(--text-secondary)] rounded-md border border-[var(--border-secondary)] transition-all flex items-center text-sm disabled:opacity-50 disabled:cursor-not-allowed"
+                                        :disabled="!highlightedSpeaker || speakerGroups.length <= 1">
+                                    <span v-text="t('buttons.next')"></span>
+                                    <i class="fas fa-chevron-down ml-1.5"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="p-4 bg-[var(--bg-tertiary)] border-t border-[var(--border-primary)] flex-shrink-0">
+                    <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                        <input type="checkbox" 
+                               v-model="regenerateSummaryAfterSpeakerUpdate" 
+                               class="speaker-checkbox">
+                        <span class="ml-2 select-none" v-text="t('help.regenerateSummaryAfterNames')"></span>
+                    </label>
+                </div>
+                <div class="bg-[var(--bg-tertiary)] px-6 py-4 flex justify-between items-center border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+                    <div>
+                        <button @click="autoIdentifySpeakers" class="px-4 py-2 bg-purple-600 text-white rounded-lg hover:bg-purple-700 flex items-center" :disabled="isAutoIdentifying">
+                            <i class="fas fa-magic mr-2"></i>
+                            <span v-if="!isAutoIdentifying" v-text="t('help.autoIdentify')"></span>
+                            <span v-else>
+                                <i class="fas fa-spinner fa-spin mr-2"></i>
+                                <span v-text="t('help.identifying')"></span>
+                            </span>
+                        </button>
+                    </div>
+                    <div class="flex space-x-3">
+                        <button @click="closeSpeakerModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                        <button
+                            @click="saveSpeakerNames"
+                            :disabled="!hasSpeakerNames"
+                            :class="hasSpeakerNames
+                                ? 'px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 cursor-pointer'
+                                : 'px-4 py-2 bg-gray-400 text-gray-200 rounded-lg cursor-not-allowed'"
+                            v-text="t('buttons.saveNames')"
+                        >
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Add Speaker Modal -->
+        <div v-if="showAddSpeakerModal" @click="closeAddSpeakerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md p-6">
+                <h3 class="text-xl font-bold text-[var(--text-primary)] mb-4">Add New Speaker</h3>
+
+                <!-- "This is Me" checkbox -->
+                <div class="mb-4">
+                    <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                        <input type="checkbox" v-model="newSpeakerIsMe" class="speaker-checkbox">
+                        <span class="ml-2 select-none">This is Me</span>
+                    </label>
+                </div>
+
+                <!-- Speaker name input (disabled if "This is Me" is checked) -->
+                <div class="mb-6">
+                    <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                        Speaker Name
+                    </label>
+                    <input
+                        type="text"
+                        v-model="newSpeakerName"
+                        :disabled="newSpeakerIsMe"
+                        :placeholder="newSpeakerIsMe ? 'Me' : 'Enter speaker name...'"
+                        class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed"
+                        @keyup.enter="addNewSpeaker"
+                    >
+                </div>
+
+                <!-- Action buttons -->
+                <div class="flex justify-end space-x-3">
+                    <button @click="closeAddSpeakerModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="addNewSpeaker" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors">
+                        Add Speaker
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Edit Text Modal -->
+        <div v-if="showEditTextModal" @click="closeEditTextModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-2xl p-6">
+                <h3 class="text-xl font-bold text-[var(--text-primary)] mb-4">Edit Transcript Text</h3>
+
+                <!-- Text editor -->
+                <div class="mb-6">
+                    <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                        Text Content
+                    </label>
+                    <textarea
+                        v-model="editedText"
+                        rows="6"
+                        class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] resize-y"
+                        placeholder="Enter transcript text..."
+                    ></textarea>
+                </div>
+
+                <!-- Action buttons -->
+                <div class="flex justify-end space-x-3">
+                    <button @click="closeEditTextModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="saveEditedText" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors">
+                        Save Changes
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Global Error Display -->
+        <div v-if="globalError" 
+             class="fixed top-4 right-4 bg-[var(--bg-danger)] text-white p-4 rounded-lg shadow-lg z-50 max-w-md">
+            <div class="flex items-start gap-3">
+                <i class="fas fa-exclamation-circle text-lg flex-shrink-0 mt-0.5"></i>
+                <div class="flex-1">
+                    <p class="font-medium" v-text="t('common.error')"></p>
+                    <p class="text-sm opacity-90">${globalError}</p>
+                </div>
+                <button @click="globalError = null" 
+                        class="text-white hover:text-gray-200 transition-colors">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+        </div>
+
+        <!-- System Audio Help Modal -->
+        <div v-if="showSystemAudioHelp" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] w-full h-full md:h-auto md:max-h-[90vh] md:w-full md:max-w-2xl md:rounded-lg md:shadow-xl flex flex-col">
+                <div class="p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                    <div class="flex items-center justify-between">
+                        <h3 class="text-lg font-semibold flex items-center">
+                            <i class="fas fa-desktop mr-2 text-blue-500"></i>
+                            System Audio Recording
+                        </h3>
+                        <button @click="showSystemAudioHelp = false" class="text-[var(--text-muted)] hover:text-[var(--text-primary)]">
+                            <i class="fas fa-times"></i>
+                        </button>
+                    </div>
+                </div>
+                <div class="p-6 space-y-6 overflow-y-auto flex-grow">
+                    <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                        <h4 class="font-medium text-[var(--text-primary)] mb-2" v-text="t('help.howToRecordSystemAudio')"></h4>
+                        <p class="text-sm text-[var(--text-muted)]" v-text="t('help.toCaptureAudioFromMeetings')">
+                        </p>
+                        <ol class="list-decimal list-inside space-y-2 text-sm text-[var(--text-secondary)] mt-3">
+                            <li v-text="t('help.recordSystemSteps1')"></li>
+                            <li><span v-text="t('help.recordSystemSteps2')"></span> <strong>"${ t('help.entireScreen') }"</strong> or a <strong v-text="t('help.specificBrowserTab')"></strong>.</li>
+                            <li><span v-text="t('help.recordSystemSteps3')"></span> <strong>"${ t('help.shareTabAudio') }"</strong> or <strong>"${ t('help.shareSystemAudio') }"</strong>.</li>
+                        </ol>
+                        <p class="text-xs text-amber-600 dark:text-amber-400 mt-3"><i class="fas fa-exclamation-triangle mr-1"></i><span v-text="t('help.sharingWindowNoAudio')"></span></p>
+                    </div>
+
+                    <div class="space-y-4">
+                        <h4 class="font-medium text-[var(--text-primary)]" v-text="t('help.troubleshooting')"></h4>
+                        
+                        <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <h5 class="font-medium text-[var(--text-primary)] mb-2" v-text="t('help.whyNotWorking')"></h5>
+                            <p class="text-sm text-[var(--text-muted)]">
+                                System audio recording requires a secure (HTTPS) connection. If you are developing locally, you may need to enable a browser flag.
+                            </p>
+                        </div>
+
+                        <!-- Chrome Solution -->
+                        <div v-if="browser === 'chrome'" class="bg-[var(--bg-accent)] p-4 rounded-lg border border-[var(--border-accent)]">
+                            <h5 class="font-medium text-[var(--text-accent)] mb-3 flex items-center">
+                                <i class="fab fa-chrome mr-2"></i>
+                                For Chrome on Localhost
+                            </h5>
+                            <ol class="list-decimal list-inside space-y-2 text-sm text-[var(--text-secondary)]">
+                                <li>Go to: <code class="bg-[var(--bg-secondary)] px-2 py-1 rounded text-xs ml-1">chrome://flags/#unsafely-treat-insecure-origin-as-secure</code></li>
+                                <li>Add your local URL (e.g., <code class="bg-[var(--bg-secondary)] px-2 py-1 rounded text-xs ml-1">http://localhost:8899</code>)</li>
+                                <li>Set to <strong>"Enabled"</strong> and relaunch Chrome.</li>
+                            </ol>
+                        </div>
+
+                        <!-- Firefox Solution -->
+                        <div v-else-if="browser === 'firefox'" class="bg-[var(--bg-accent)] p-4 rounded-lg border border-[var(--border-accent)]">
+                            <h5 class="font-medium text-[var(--text-accent)] mb-3 flex items-center">
+                                <i class="fab fa-firefox-browser mr-2"></i>
+                                For Firefox on Localhost
+                            </h5>
+                            <p class="text-sm text-[var(--text-secondary)]">
+                                System audio recording is not well-supported on Firefox, even with these changes. For best results, please use Chrome.
+                            </p>
+                            <ol class="list-decimal list-inside space-y-2 text-sm text-[var(--text-secondary)] mt-2">
+                                <li>Go to: <code class="bg-[var(--bg-secondary)] px-2 py-1 rounded text-xs ml-1">about:config</code></li>
+                                <li>Search for <code class="bg-[var(--bg-secondary)] px-2 py-1 rounded text-xs ml-1">media.devices.insecure.enabled</code> and set it to `true`.</li>
+                                <li>Restart Firefox.</li>
+                            </ol>
+                        </div>
+
+                        <!-- Other Browsers -->
+                        <div v-else class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <h5 class="font-medium text-[var(--text-primary)] mb-2" v-text="t('help.unsupportedBrowser')"></h5>
+                            <p class="text-sm text-[var(--text-muted)]">
+                                For the best experience with system audio recording, we recommend using Google Chrome.
+                            </p>
+                        </div>
+                    </div>
+                </div>
+                <div class="p-4 border-t border-[var(--border-primary)] flex justify-end flex-shrink-0">
+                    <button @click="showSystemAudioHelp = false" 
+                            class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                        Got it
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Recording Disclaimer Modal -->
+        <div v-if="showRecordingDisclaimerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col overflow-hidden">
+                <div class="flex-shrink-0 p-6 border-b border-[var(--border-primary)]">
+                    <div class="flex items-center gap-3">
+                        <i class="fas fa-info-circle text-2xl text-[var(--text-accent)]"></i>
+                        <h3 class="text-xl font-semibold text-[var(--text-primary)]" v-text="t('modal.recordingNotice')"></h3>
+                    </div>
+                </div>
+                <div class="flex-1 overflow-y-auto p-6">
+                    <!-- Render markdown content -->
+                    <div class="prose prose-sm max-w-none text-[var(--text-secondary)]" 
+                         style="color: var(--text-secondary); line-height: 1.6;">
+                        <div v-html="recordingDisclaimer"></div>
+                    </div>
+                </div>
+                <div class="flex-shrink-0 p-6 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)] rounded-b-lg">
+                    <div class="flex justify-end gap-3">
+                        <button @click="cancelRecordingDisclaimer" 
+                                class="px-6 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-secondary)] rounded-lg transition-colors border border-[var(--border-secondary)]">
+                            Cancel
+                        </button>
+                        <button @click="acceptRecordingDisclaimer" 
+                                class="px-6 py-2 bg-[var(--bg-accent)] text-white rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors">
+                            <i class="fas fa-microphone mr-2"></i>
+                            Start Recording
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+        
+        <!-- Toast Container -->
+        <div id="toastContainer" class="fixed top-4 right-4 z-50 space-y-2"></div>
+
+        <!-- Share Modal -->
+        <div v-if="showShareModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-lg">
+                <div class="p-6 border-b border-[var(--border-primary)]">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.shareRecording')"></h3>
+                </div>
+                <div class="p-6 space-y-4">
+                    <p class="text-sm text-[var(--text-muted)]" v-text="t('help.createPublicLink')"></p>
+                    <div v-if="!generatedShareLink">
+                        <div class="flex items-center mb-2">
+                            <input type="checkbox" v-model="shareOptions.share_summary" id="share_summary" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="share_summary" class="ml-2 block text-sm text-[var(--text-secondary)]" v-text="t('form.shareSummary')"></label>
+                        </div>
+                        <div class="flex items-center">
+                            <input type="checkbox" v-model="shareOptions.share_notes" id="share_notes" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="share_notes" class="ml-2 block text-sm text-[var(--text-secondary)]" v-text="t('form.shareNotes')"></label>
+                        </div>
+                    </div>
+                    <div v-if="generatedShareLink" class="mt-4">
+                        <div v-if="existingShareDetected" class="mb-3 p-3 bg-blue-50 dark:bg-blue-900/20 border border-blue-200 dark:border-blue-800 rounded-lg">
+                            <div class="flex items-start gap-2">
+                                <i class="fas fa-info-circle text-blue-600 dark:text-blue-400 mt-0.5"></i>
+                                <div class="text-sm text-blue-800 dark:text-blue-300">
+                                    <p class="font-medium">Using existing share link</p>
+                                    <p class="mt-1 text-xs opacity-90">This recording was already shared. The same link has been retrieved.</p>
+                                </div>
+                            </div>
+                        </div>
+                        <label class="block text-sm font-medium mb-2" v-text="t('form.shareableLink')"></label>
+                        <div class="flex items-center gap-2">
+                            <input :value="generatedShareLink" readonly class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg">
+                            <button @click="copyShareLink" class="px-3 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)]">
+                                <i class="fas fa-copy"></i>
+                            </button>
+                        </div>
+                        <div v-if="existingShareDetected" class="mt-3">
+                            <button @click="createShare(true)" class="text-sm text-[var(--text-accent)] hover:underline">
+                                <i class="fas fa-plus-circle mr-1"></i>Create a new share link instead
+                            </button>
+                        </div>
+                    </div>
+                </div>
+                <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+                    <button @click="closeShareModal" class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="createShare()" v-if="!generatedShareLink" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                        Create Link
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Shares List Modal -->
+        <div v-if="showSharesListModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col">
+                <div class="p-6 border-b border-[var(--border-primary)] flex justify-between items-center">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.sharedTranscripts')"></h3>
+                    <button @click="closeSharesList" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+                <div class="p-6 space-y-4 overflow-y-auto">
+                    <div v-if="isLoadingShares" class="text-center">
+                        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                    </div>
+                    <div v-else-if="userShares.length === 0" class="text-center text-[var(--text-muted)]">
+                        <span v-text="t('sharedTranscripts.noSharedTranscripts')"></span>
+                    </div>
+                    <div v-else class="space-y-3">
+                        <div v-for="share in userShares" :key="share.id" class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex justify-between items-start">
+                                <div>
+                                    <p class="font-semibold">${share.recording_title}</p>
+                                    <p class="text-sm text-[var(--text-muted)]">${ t('help.sharedOn') }: ${share.created_at}</p>
+                                </div>
+                                <button @click="confirmDeleteShare(share)" class="text-red-500 hover:text-red-700 p-1"><i class="fas fa-trash"></i></button>
+                            </div>
+                            <div class="mt-4 flex items-center gap-4">
+                                <label class="flex items-center text-sm">
+                                    <input type="checkbox" v-model="share.share_summary" @change="updateShare(share)" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                                    <span class="ml-2" v-text="t('form.shareSummary')"></span>
+                                </label>
+                                <label class="flex items-center text-sm">
+                                    <input type="checkbox" v-model="share.share_notes" @change="updateShare(share)" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                                    <span class="ml-2" v-text="t('form.shareNotes')"></span>
+                                </label>
+                            </div>
+                            <div class="mt-4">
+                                <input :value="'{{ request.url_root }}share/' + share.public_id" readonly class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm">
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+        
+        <!-- Share Delete Confirmation Modal -->
+        <div v-if="showShareDeleteModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+                <!-- Header with gradient background -->
+                <div class="bg-gradient-to-r from-red-500 to-red-600 p-5 rounded-t-xl">
+                    <div class="flex items-center">
+                        <div class="w-12 h-12 bg-white/20 backdrop-blur rounded-full flex items-center justify-center mr-4">
+                            <i class="fas fa-trash-alt text-white text-lg"></i>
+                        </div>
+                        <div>
+                            <h3 class="text-lg font-bold text-white">Delete Shared Link</h3>
+                            <p class="text-red-100 text-sm mt-1">This action cannot be undone</p>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Content -->
+                <div class="p-6">
+                    <p class="text-[var(--text-secondary)] mb-4">
+                        Are you sure you want to delete the shared link for:
+                    </p>
+                    <div v-if="shareToDelete" class="bg-[var(--bg-tertiary)] p-3 rounded-lg border border-[var(--border-primary)]">
+                        <p class="font-medium text-[var(--text-primary)]">${shareToDelete.recording_title}</p>
+                        <p class="text-sm text-[var(--text-muted)] mt-1">Shared on: ${shareToDelete.created_at}</p>
+                    </div>
+                    <div class="mt-4 p-3 bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg">
+                        <div class="flex items-start">
+                            <i class="fas fa-exclamation-triangle text-red-600 dark:text-red-400 mt-0.5 mr-2"></i>
+                            <p class="text-sm text-red-800 dark:text-red-300">
+                                The share link will be permanently deleted and anyone with this link will no longer be able to access the recording.
+                            </p>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Actions -->
+                <div class="p-6 pt-0 flex justify-end gap-3">
+                    <button @click="cancelDeleteShare" class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                        Cancel
+                    </button>
+                    <button @click="deleteShare" class="px-4 py-2 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors flex items-center gap-2">
+                        <i class="fas fa-trash"></i>
+                        Delete Share Link
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Unified Internal Share Modal -->
+        <div v-if="showUnifiedShareModal && enableInternalSharing" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div @click.stop class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-3xl max-h-[90vh] flex flex-col">
+                <!-- Header -->
+                <div class="p-6 border-b border-[var(--border-primary)] flex justify-between items-center flex-shrink-0">
+                    <div>
+                        <h3 class="text-xl font-bold text-[var(--text-primary)]">Share Recording</h3>
+                        <p class="text-sm text-[var(--text-muted)] mt-1">Share with users and manage access</p>
+                    </div>
+                    <button @click="closeUnifiedShareModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+
+                <!-- Content -->
+                <div class="flex-1 overflow-y-auto p-6 space-y-6">
+                    <!-- Share with New User Section -->
+                    <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                        <h4 class="font-semibold text-[var(--text-primary)] mb-3 flex items-center">
+                            <i class="fas fa-user-plus mr-2 text-blue-500"></i>
+                            Share with User
+                        </h4>
+
+                        <!-- User Search/Selection -->
+                        <div v-if="showUsernamesInUI" class="space-y-3">
+                            <!-- Search Input (for filtering) -->
+                            <div class="relative">
+                                <input
+                                    v-model="internalShareUserSearch"
+                                    @input="searchInternalShareUsers"
+                                    type="text"
+                                    placeholder="Search users..."
+                                    class="w-full px-4 py-2 pl-10 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                                <i class="fas fa-search absolute left-3 top-3 text-[var(--text-muted)]"></i>
+                            </div>
+
+                            <!-- User Grid -->
+                            <div v-if="isLoadingAllUsers" class="text-center py-8">
+                                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                                <p class="mt-2 text-sm text-[var(--text-muted)]">Loading users...</p>
+                            </div>
+                            <div v-else-if="internalShareSearchResults.length === 0" class="text-center py-8 text-[var(--text-muted)]">
+                                <i class="fas fa-users-slash text-3xl mb-2"></i>
+                                <p>No users found</p>
+                            </div>
+                            <div v-else class="grid grid-cols-1 sm:grid-cols-2 gap-2 max-h-64 overflow-y-auto custom-scrollbar">
+                                <div
+                                    v-for="user in internalShareSearchResults"
+                                    :key="user.id"
+                                    @click="createInternalShare(user.id, user.username)"
+                                    class="group p-3 bg-[var(--bg-secondary)] hover:bg-[var(--bg-hover)] rounded-lg border border-[var(--border-secondary)] hover:border-blue-500 cursor-pointer transition-all">
+                                    <div class="flex items-center justify-between">
+                                        <div class="flex items-center space-x-2 flex-1 min-w-0">
+                                            <div class="w-8 h-8 rounded-full bg-gradient-to-br from-blue-400 to-purple-500 flex items-center justify-center flex-shrink-0">
+                                                <span class="text-white text-xs font-bold">${user.username.charAt(0).toUpperCase()}</span>
+                                            </div>
+                                            <div class="flex-1 min-w-0">
+                                                <p class="font-medium text-[var(--text-primary)] truncate">${user.username}</p>
+                                                <p v-if="user.email" class="text-xs text-[var(--text-muted)] truncate">${user.email}</p>
+                                            </div>
+                                        </div>
+                                        <i class="fas fa-user-plus text-blue-500 group-hover:scale-110 transition-transform ml-2"></i>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Username Search Input (when SHOW_USERNAMES_IN_UI is disabled) -->
+                        <div v-else class="space-y-3">
+                            <p class="text-sm text-[var(--text-muted)]">Enter a username to share with</p>
+                            <div class="relative">
+                                <input
+                                    v-model="internalShareUserSearch"
+                                    @input="searchInternalShareUsers"
+                                    type="text"
+                                    placeholder="Type username to search..."
+                                    class="w-full px-4 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                                <i v-if="isSearchingUsers" class="fas fa-spinner fa-spin absolute right-3 top-3 text-[var(--text-muted)]"></i>
+                            </div>
+
+                            <!-- Search Results -->
+                            <div v-if="internalShareSearchResults.length > 0" class="space-y-2 max-h-48 overflow-y-auto">
+                                <div
+                                    v-for="user in internalShareSearchResults"
+                                    :key="user.id"
+                                    @click="createInternalShare(user.id, user.username)"
+                                    class="p-3 bg-[var(--bg-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-hover)] hover:border-blue-500 cursor-pointer transition-all">
+                                    <div class="flex items-center justify-between">
+                                        <p class="font-medium">${'User #' + user.id}</p>
+                                        <i class="fas fa-user-plus text-blue-500"></i>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <div v-else-if="internalShareUserSearch.length >= 2 && !isSearchingUsers" class="text-center py-4 text-[var(--text-muted)]">
+                                <i class="fas fa-search text-2xl mb-2"></i>
+                                <p>No users found</p>
+                            </div>
+
+                            <div v-else-if="internalShareUserSearch.length < 2" class="text-center py-4 text-[var(--text-muted)]">
+                                <i class="fas fa-keyboard text-2xl mb-2"></i>
+                                <p>Type at least 2 characters to search</p>
+                            </div>
+                        </div>
+
+                        <!-- Permissions -->
+                        <div class="border-t border-[var(--border-primary)] mt-4 pt-4 space-y-2">
+                            <p class="text-sm font-medium text-[var(--text-secondary)]">Share Permissions</p>
+                            <div class="flex items-center">
+                                <input type="checkbox" v-model="internalSharePermissions.can_edit" id="unified_share_can_edit" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                                <label for="unified_share_can_edit" class="ml-2 block text-sm text-[var(--text-secondary)]">
+                                    <i class="fas fa-pencil-alt mr-1"></i>Allow editing notes and metadata
+                                </label>
+                            </div>
+                            <div class="flex items-center">
+                                <input type="checkbox" v-model="internalSharePermissions.can_reshare" id="unified_share_can_reshare" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                                <label for="unified_share_can_reshare" class="ml-2 block text-sm text-[var(--text-secondary)]">
+                                    <i class="fas fa-share-alt mr-1"></i>Allow re-sharing with others
+                                </label>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Already Shared With Section -->
+                    <div class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                        <h4 class="font-semibold text-[var(--text-primary)] mb-3 flex items-center justify-between">
+                            <span>
+                                <i class="fas fa-users-cog mr-2 text-purple-500"></i>
+                                Already Shared With
+                            </span>
+                            <span v-if="recordingInternalShares.length > 0" class="text-sm font-normal text-[var(--text-muted)]">
+                                ${recordingInternalShares.length} user(s)
+                            </span>
+                        </h4>
+
+                        <div v-if="isLoadingInternalShares" class="text-center py-8">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="mt-2 text-sm text-[var(--text-muted)]">Loading shares...</p>
+                        </div>
+                        <div v-else-if="recordingInternalShares.length === 0" class="text-center py-8 text-[var(--text-muted)]">
+                            <i class="fas fa-user-slash text-3xl mb-3"></i>
+                            <p>Not shared with anyone yet</p>
+                            <p class="text-sm mt-1">Select a user above to share this recording</p>
+                        </div>
+                        <div v-else class="space-y-2 max-h-80 overflow-y-auto custom-scrollbar">
+                            <div
+                                v-for="share in recordingInternalShares"
+                                :key="share.user_id"
+                                class="bg-[var(--bg-secondary)] p-4 rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-primary)] transition-colors">
+                                <div class="flex justify-between items-start">
+                                    <div class="flex items-center space-x-3 flex-1">
+                                        <div class="w-10 h-10 rounded-full bg-gradient-to-br from-purple-400 to-pink-500 flex items-center justify-center flex-shrink-0">
+                                            <span class="text-white text-sm font-bold">${showUsernamesInUI ? share.username.charAt(0).toUpperCase() : '#'}</span>
+                                        </div>
+                                        <div class="flex-1">
+                                            <p class="font-semibold text-[var(--text-primary)]">${ showUsernamesInUI ? share.username : 'User #' + share.user_id }</p>
+                                            <p class="text-xs text-[var(--text-muted)] mt-1">Shared on ${share.created_at}</p>
+                                            <div class="flex gap-3 mt-2 text-xs">
+                                                <span v-if="share.can_edit" class="inline-flex items-center px-2 py-1 rounded-full bg-green-100 dark:bg-green-900/30 text-green-700 dark:text-green-400">
+                                                    <i class="fas fa-pencil-alt mr-1"></i>Can edit
+                                                </span>
+                                                <span v-if="share.can_reshare" class="inline-flex items-center px-2 py-1 rounded-full bg-blue-100 dark:bg-blue-900/30 text-blue-700 dark:text-blue-400">
+                                                    <i class="fas fa-share-alt mr-1"></i>Can re-share
+                                                </span>
+                                                <span v-if="!share.can_edit && !share.can_reshare" class="inline-flex items-center px-2 py-1 rounded-full bg-gray-100 dark:bg-gray-800 text-gray-700 dark:text-gray-400">
+                                                    <i class="fas fa-eye mr-1"></i>View only
+                                                </span>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    <button
+                                        @click="revokeInternalShare(share.id, share.username)"
+                                        class="text-red-500 hover:text-red-700 p-2 hover:bg-red-50 dark:hover:bg-red-900/20 rounded-lg transition-colors ml-2"
+                                        title="Revoke access">
+                                        <i class="fas fa-user-times"></i>
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Footer -->
+                <div class="p-6 border-t border-[var(--border-primary)] flex justify-end flex-shrink-0">
+                    <button @click="closeUnifiedShareModal" class="px-5 py-2.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-all duration-200 flex items-center font-medium">
+                        <i class="fas fa-check mr-2"></i>
+                        Done
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- CSRF Token Management -->
+    <script src="{{ url_for('static', filename='js/csrf-refresh.js') }}"></script>
+    
+    <!-- i18n System -->
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
+    
+    <!-- Initialize i18n immediately with fallback -->
+    <script>
+        // Ensure i18n is initialized before Vue app
+        (async function() {
+            if (window.i18n && window.i18n.init) {
+                const userLang = localStorage.getItem('preferredLanguage') || '{{ user_language }}' || 'en';
+                try {
+                    await window.i18n.init(userLang);
+                    console.log('i18n pre-initialized with language:', userLang);
+                } catch (error) {
+                    console.error('Failed to initialize i18n:', error);
+                }
+            }
+            
+            // Hide loader after i18n is ready
+            const loader = document.getElementById('loader');
+            if (loader) {
+                loader.style.display = 'none';
+            }
+        })();
+    </script>
+
+    <!-- Service Worker Registration for PWA and Background Recording -->
+    <script>
+        // Register service worker for PWA functionality and background recording support
+        if ('serviceWorker' in navigator) {
+            window.addEventListener('load', () => {
+                navigator.serviceWorker.register('/static/service-worker.js')
+                    .then((registration) => {
+                        console.log('Service Worker registered successfully:', registration.scope);
+
+                        // Check for updates periodically
+                        setInterval(() => {
+                            registration.update();
+                        }, 60000); // Check every minute
+                    })
+                    .catch((error) => {
+                        console.error('Service Worker registration failed:', error);
+                    });
+            });
+        }
+    </script>
+
+    <!-- Vue.js Application Script -->
+    <script src="{{ url_for('static', filename='js/app.js') }}"></script>
+</body>
+</html>
diff --git a/templates/inquire.html b/templates/inquire.html
new file mode 100644
index 00000000..5fd406b6
--- /dev/null
+++ b/templates/inquire.html
@@ -0,0 +1,969 @@
+<!DOCTYPE html>
+<html lang="en" class="h-full">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>Inquire Mode - Speakr</title>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/marked.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+    <script src="{{ url_for('static', filename='js/i18n.js') }}"></script>
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}">
+    <link rel="icon" type="image/png" sizes="32x32" href="{{ url_for('static', filename='img/icon-32x32.png') }}">
+
+    <!-- Loading overlay to prevent FOUC -->
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    colors: {
+                        primary: 'var(--bg-primary)',
+                        secondary: 'var(--bg-secondary)',
+                        accent: 'var(--bg-accent)'
+                    }
+                }
+            }
+        }
+    </script>
+    <style>
+        /* Custom checkbox styling for better visual feedback */
+        .filter-checkbox {
+            appearance: none;
+            background-color: var(--bg-input);
+            border: 2px solid var(--border-secondary);
+            border-radius: 4px;
+            width: 16px;
+            height: 16px;
+            position: relative;
+            transition: all 0.2s ease;
+        }
+        
+        .filter-checkbox:checked {
+            background-color: var(--text-accent);
+            border-color: var(--text-accent);
+        }
+        
+        .filter-checkbox:checked::after {
+            content: '✓';
+            position: absolute;
+            top: 50%;
+            left: 50%;
+            transform: translate(-50%, -50%);
+            color: white;
+            font-size: 10px;
+            font-weight: bold;
+        }
+        
+        .filter-checkbox:focus {
+            outline: 2px solid var(--text-accent);
+            outline-offset: 2px;
+        }
+        
+        .filter-checkbox:hover {
+            border-color: var(--text-accent);
+        }
+        
+        /* Enhanced markdown styling for Inquire Mode chat messages */
+        .chat-message .prose h1,
+        .chat-message .prose h2,
+        .chat-message .prose h3,
+        .chat-message .prose h4 {
+            color: var(--text-primary);
+            font-weight: 600;
+            margin-top: 1.5em;
+            margin-bottom: 0.75em;
+            line-height: 1.3;
+        }
+        
+        .chat-message .prose h1 { font-size: 1.25em; }
+        .chat-message .prose h2 { font-size: 1.15em; }
+        .chat-message .prose h3 { font-size: 1.05em; }
+        
+        .chat-message .prose p {
+            color: var(--text-primary);
+            margin-bottom: 1em;
+            line-height: 1.6;
+        }
+        
+        .chat-message .prose ul,
+        .chat-message .prose ol {
+            color: var(--text-primary);
+            margin: 0.75em 0;
+            padding-left: 1.5em;
+        }
+        
+        .chat-message .prose li {
+            color: var(--text-primary);
+            margin: 0.25em 0;
+            line-height: 1.6;
+        }
+        
+        .chat-message .prose strong {
+            color: var(--text-primary);
+            font-weight: 700;
+        }
+        
+        .chat-message .prose ul { list-style-type: disc; }
+        .chat-message .prose ol { list-style-type: decimal; }
+        
+        .chat-message .prose code {
+            background-color: var(--bg-accent);
+            color: var(--text-accent);
+            padding: 0.15em 0.3em;
+            border-radius: 3px;
+            font-size: 0.9em;
+        }
+    </style>
+</head>
+<body class="h-full bg-[var(--bg-primary)] text-[var(--text-primary)] transition-colors duration-300">
+    <div id="inquire-app" v-cloak class="h-full flex flex-col"
+         data-current-user-name="{{ (current_user.name or current_user.username) if current_user.is_authenticated else '' }}">
+        
+        <!-- Header -->
+        <header class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] px-3 sm:px-4 py-3 flex items-center justify-between flex-shrink-0 z-50">
+            <!-- Left side: Menu and logo -->
+            <div class="flex items-center gap-2 sm:gap-4 min-w-0 flex-shrink">
+                <!-- Mobile Sidebar Toggle -->
+                <button @click="isMobileSidebarOpen = !isMobileSidebarOpen" 
+                        class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200 lg:hidden flex-shrink-0 flex items-center justify-center">
+                    <i class="fas fa-bars text-lg"></i>
+                </button>
+                
+                <!-- Logo and Title (clickable to go back) -->
+                <a href="/" class="flex items-center gap-2 sm:gap-3 min-w-0 hover:opacity-80 transition-opacity">
+                    <img src="{{ url_for('static', filename='img/icon-32x32.png') }}" alt="Speakr" class="w-6 h-6 sm:w-8 sm:h-8 flex-shrink-0">
+                    <h1 class="text-lg sm:text-xl font-bold text-[var(--text-primary)] truncate">Speakr</h1>
+                    <span class="text-xs sm:text-sm text-[var(--text-muted)] hidden sm:inline">• Inquire Mode</span>
+                </a>
+            </div>
+
+            <!-- Right side: User menu -->
+            <div class="flex items-center gap-2 sm:gap-3">
+                {% include 'components/token_budget_indicator.html' %}
+
+                <!-- New Recording Button -->
+                <a href="/"
+                   class="px-3 py-1.5 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm flex items-center gap-2">
+                    <i class="fas fa-plus"></i>
+                    <span class="hidden sm:inline">${t('nav.newRecording')}</span>
+                </a>
+
+                <!-- User menu -->
+                {% if current_user.is_authenticated %}
+                <div class="relative">
+                    <button @click="isUserMenuOpen = !isUserMenuOpen"
+                            data-user-menu-toggle
+                            class="flex items-center gap-1 sm:gap-2 p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors duration-200"
+                            :title="t('admin.userMenu')">
+                        <i class="fas fa-user-circle text-lg"></i>
+                        <span class="hidden lg:inline text-sm">{{ (current_user.name or current_user.username) if current_user.is_authenticated else 'User' }}</span>
+                        <i class="fas fa-chevron-down text-xs hidden sm:inline"></i>
+                    </button>
+
+                    <!-- User dropdown -->
+                    <div v-if="isUserMenuOpen"
+                         data-user-menu-dropdown
+                         class="absolute right-0 mt-2 w-56 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg z-50">
+                        <a href="/" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-home mr-2 w-4 text-center"></i><span v-text="t('nav.home')"></span>
+                        </a>
+                        <a href="/account" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-cog mr-2 w-4 text-center"></i><span v-text="t('nav.settings')"></span>
+                        </a>
+                        <a href="/account#tags" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-tags mr-2 w-4 text-center"></i><span v-text="t('help.tagManagement')"></span>
+                        </a>
+                        <button @click="openSharesList" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i class="fas fa-share-alt mr-2 w-4 text-center"></i><span v-text="t('modal.sharedTranscripts')"></span>
+                        </button>
+                        {% if current_user.is_admin or is_group_admin %}
+                        <a href="/admin" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-{% if current_user.is_admin %}user-shield{% else %}users-cog{% endif %} mr-2 w-4 text-center"></i>
+                            <span v-text="{% if current_user.is_admin %}t('admin.title'){% else %}t('nav.groupManagement'){% endif %}"></span>
+                        </a>
+                        {% endif %}
+                        <div class="border-t border-[var(--border-primary)] my-1"></div>
+                        <button @click="toggleDarkMode" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'" class="mr-2 w-4 text-center"></i>
+                            <span v-text="isDarkMode ? t('nav.lightMode') : t('nav.darkMode')"></span>
+                        </button>
+                        <button @click="openColorSchemeModal" class="w-full text-left px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors flex items-center">
+                            <i class="fas fa-palette mr-2 w-4 text-center"></i>
+                            <span v-text="t('modal.colorScheme')"></span>
+                        </button>
+                        <div class="border-t border-[var(--border-primary)] my-1"></div>
+                        <a href="/logout" class="block px-4 py-2 hover:bg-[var(--bg-tertiary)] transition-colors">
+                            <i class="fas fa-sign-out-alt mr-2 w-4 text-center"></i><span v-text="t('nav.signOut')"></span>
+                        </a>
+                    </div>
+                </div>
+                {% endif %}
+            </div>
+        </header>
+
+        <!-- Main Content -->
+        <div class="flex-1 flex overflow-hidden relative">
+            <!-- Mobile Sidebar Overlay -->
+            <div v-if="isMobileSidebarOpen" 
+                 @click="isMobileSidebarOpen = false"
+                 class="fixed inset-0 bg-black bg-opacity-50 z-40 lg:hidden"></div>
+            
+            <!-- Left Panel: Filters -->
+            <div class="w-80 bg-[var(--bg-secondary)] border-r border-[var(--border-primary)] flex flex-col flex-shrink-0 transition-transform duration-300 ease-in-out z-50"
+                 :class="[
+                     'lg:relative lg:translate-x-0', 
+                     isMobileSidebarOpen ? 'fixed inset-y-0 left-0 translate-x-0' : 'fixed inset-y-0 left-0 -translate-x-full lg:translate-x-0'
+                 ]">
+                <!-- Mobile close button -->
+                <div class="lg:hidden flex items-center justify-between p-4 border-b border-[var(--border-primary)]">
+                    <h2 class="text-lg font-bold">${t('inquire.filters')}</h2>
+                    <button @click="isMobileSidebarOpen = false" 
+                            class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times text-lg"></i>
+                    </button>
+                </div>
+                
+                <div class="flex-1 overflow-y-auto custom-scrollbar">
+                    <div class="p-4 space-y-4">
+                    <div class="flex items-center justify-between lg:block">
+                        <h2 class="text-lg font-bold hidden lg:block">${t('inquire.filters')}</h2>
+                        <button @click="clearInquireFilters" class="text-xs px-3 py-1 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] transition-colors flex items-center gap-1 w-full lg:w-auto justify-center">
+                            <i class="fas fa-times"></i> ${t('inquire.clearAll')}
+                        </button>
+                    </div>
+                    
+                    <!-- Tag Filters -->
+                    <div class="bg-[var(--bg-primary)] rounded-lg border border-[var(--border-secondary)] p-3">
+                        <h3 class="font-medium mb-2 flex items-center text-[var(--text-primary)]">
+                            <i class="fas fa-tags mr-2 text-[var(--text-accent)]"></i>${t('inquire.tags')}
+                        </h3>
+                        <!-- Tag search input -->
+                        <div class="mb-3">
+                            <input type="text" v-model="tagSearchQuery" :placeholder="t('form.searchTags')" 
+                                   class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-[var(--text-primary)] focus:border-[var(--border-focus)] focus:ring-1 focus:ring-[var(--border-focus)] transition-colors">
+                        </div>
+                        <div class="space-y-1 max-h-40 overflow-y-auto custom-scrollbar">
+                            <label v-for="tag in filteredTags" :key="tag.id" class="flex items-center cursor-pointer hover:bg-[var(--bg-tertiary)] p-2 rounded transition-colors group">
+                                <input type="checkbox" :value="tag.id" v-model="inquireFilters.selectedTags" 
+                                       class="filter-checkbox">
+                                <span class="ml-2 text-sm font-medium flex-1" :style="{color: tag.color}">${tag.name}</span>
+                                <span class="text-xs px-1.5 py-0.5 bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded-full">${tag.recording_count}</span>
+                            </label>
+                        </div>
+                    </div>
+                    
+                    <!-- Speaker Filters -->
+                    <div class="bg-[var(--bg-primary)] rounded-lg border border-[var(--border-secondary)] p-3">
+                        <h3 class="font-medium mb-2 flex items-center text-[var(--text-primary)]">
+                            <i class="fas fa-users mr-2 text-[var(--text-accent)]"></i>${t('inquire.speakers')}
+                        </h3>
+                        <div v-if="availableFilters.speakers.length > 0">
+                            <!-- Speaker search input -->
+                            <div class="mb-3">
+                                <input type="text" v-model="speakerSearchQuery" :placeholder="t('form.searchSpeakers')" 
+                                       class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-[var(--text-primary)] focus:border-[var(--border-focus)] focus:ring-1 focus:ring-[var(--border-focus)] transition-colors">
+                            </div>
+                            <div class="space-y-1 max-h-40 overflow-y-auto custom-scrollbar">
+                                <label v-for="speaker in filteredSpeakers" :key="speaker" class="flex items-center cursor-pointer hover:bg-[var(--bg-tertiary)] p-2 rounded transition-colors group">
+                                    <input type="checkbox" :value="speaker" v-model="inquireFilters.selectedSpeakers" 
+                                           class="filter-checkbox">
+                                    <span class="ml-2 text-sm text-[var(--text-primary)] flex-1">${speaker}</span>
+                                </label>
+                            </div>
+                        </div>
+                        
+                        <!-- No Speakers Message -->
+                        <div v-if="availableFilters.speakers.length === 0" class="text-center py-3">
+                            <i class="fas fa-users text-xl text-[var(--text-muted)] mb-2"></i>
+                            <p class="text-sm text-[var(--text-muted)]">${t('inquire.noSpeakerData')}</p>
+                            <p class="text-xs text-[var(--text-muted)] mt-1">${t('inquire.speakerRequirement')}</p>
+                        </div>
+                    </div>
+                    
+                    <!-- Date Range Filters -->
+                    <div class="bg-[var(--bg-primary)] rounded-lg border border-[var(--border-secondary)] p-3">
+                        <h3 class="font-medium mb-2 flex items-center text-[var(--text-primary)]">
+                            <i class="fas fa-calendar mr-2 text-[var(--text-accent)]"></i>${t('inquire.dateRange')}
+                        </h3>
+                        <div class="space-y-2">
+                            <div>
+                                <label class="block text-xs text-[var(--text-muted)] mb-1 font-medium">${t('inquire.from')}</label>
+                                <input type="date" v-model="inquireFilters.dateFrom" class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-[var(--text-primary)] focus:border-[var(--border-focus)] focus:ring-1 focus:ring-[var(--border-focus)] transition-colors">
+                            </div>
+                            <div>
+                                <label class="block text-xs text-[var(--text-muted)] mb-1 font-medium">${t('inquire.to')}</label>
+                                <input type="date" v-model="inquireFilters.dateTo" class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-[var(--text-primary)] focus:border-[var(--border-focus)] focus:ring-1 focus:ring-[var(--border-focus)] transition-colors">
+                            </div>
+                        </div>
+                    </div>
+                
+                <!-- Recording Filters - Commented Out -->
+                <!--
+                <div class="flex-1 flex flex-col px-6 pb-6 min-h-0">
+                    <div class="bg-[var(--bg-primary)] rounded-lg border border-[var(--border-secondary)] p-4 flex flex-col flex-1 min-h-0">
+                        <h3 class="font-medium mb-3 flex items-center flex-shrink-0 text-[var(--text-primary)]">
+                            <i class="fas fa-file-audio mr-2 text-[var(--text-accent)]"></i>Recordings
+                        </h3>
+                        <div class="space-y-1 flex-1 overflow-y-auto custom-scrollbar pr-2 min-h-0">
+                            <label v-for="recording in availableFilters.recordings" :key="recording.id" class="flex items-center cursor-pointer hover:bg-[var(--bg-tertiary)] p-3 rounded-md transition-colors border border-transparent hover:border-[var(--border-secondary)]">
+                                <input type="checkbox" :value="recording.id" v-model="inquireFilters.selectedRecordings" class="h-4 w-4 rounded border-[var(--border-secondary)] text-[var(--text-accent)] focus:ring-[var(--border-focus)] flex-shrink-0">
+                                <div class="ml-3 flex-1 min-w-0">
+                                    <div class="text-sm font-medium truncate text-[var(--text-primary)]" :title="recording.title">${recording.title}</div>
+                                    <div v-if="recording.meeting_date" class="text-xs text-[var(--text-muted)] mt-1">${formatDate(recording.meeting_date)}</div>
+                                </div>
+                            </label>
+                        </div>
+                    </div>
+                -->
+                
+                    <!-- Active Filters Summary -->
+                    <div v-if="hasActiveFilters" class="bg-[var(--bg-primary)] rounded-lg border border-[var(--border-secondary)] p-3">
+                        <h4 class="text-sm font-medium mb-2 text-[var(--text-muted)] flex items-center">
+                            <i class="fas fa-filter mr-2"></i>${t('inquire.activeFilters')}
+                        </h4>
+                        <div class="space-y-1 text-xs">
+                            <div v-if="inquireFilters.selectedTags.length" class="flex items-center px-2 py-1 bg-[var(--bg-tertiary)] rounded text-[var(--text-secondary)]">
+                                <span><i class="fas fa-tags mr-1"></i>${inquireFilters.selectedTags.length} ${t('inquire.tagsCount')}</span>
+                            </div>
+                            <div v-if="inquireFilters.selectedSpeakers.length" class="flex items-center px-2 py-1 bg-[var(--bg-tertiary)] rounded text-[var(--text-secondary)]">
+                                <span><i class="fas fa-users mr-1"></i>${inquireFilters.selectedSpeakers.length} ${t('inquire.speakersCount')}</span>
+                            </div>
+                            <div v-if="inquireFilters.dateFrom || inquireFilters.dateTo" class="flex items-center px-2 py-1 bg-[var(--bg-tertiary)] rounded text-[var(--text-secondary)]">
+                                <span><i class="fas fa-calendar mr-1"></i>${t('inquire.dateRangeActive')}</span>
+                            </div>
+                        </div>
+                    </div>
+                    </div><!-- End of p-4 space-y-4 div -->
+                </div><!-- End of flex-1 overflow-y-auto div -->
+            </div><!-- End of w-80 sidebar div -->
+            
+            <!-- Right Panel: Chat -->
+            <div class="flex-1 flex flex-col overflow-hidden"
+                 :class="isMobileSidebarOpen ? 'hidden lg:flex' : 'flex'">
+                <!-- Chat Messages Area -->
+                <div ref="inquireMessagesRef" @scroll="handleScroll" class="flex-1 overflow-y-auto p-6 space-y-4 custom-scrollbar">
+                    <!-- Welcome Message -->
+                    <div v-if="inquireChatMessages.length === 0" class="text-center py-16">
+                        <div class="mb-6 text-[var(--text-accent)]">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-24 w-24 mx-auto" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5">
+                                <path stroke-linecap="round" stroke-linejoin="round" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
+                            </svg>
+                        </div>
+                        <h2 class="text-2xl font-bold mb-4">${t('inquire.askQuestions')}</h2>
+                        <p class="text-[var(--text-muted)] max-w-lg mx-auto mb-6">
+                            ${t('inquire.selectFilters')}
+                        </p>
+                        <div class="bg-[var(--bg-tertiary)] rounded-xl p-4 max-w-md mx-auto">
+                            <h4 class="font-medium mb-2">${t('inquire.exampleQuestions')}</h4>
+                            <ul class="text-sm text-[var(--text-secondary)] space-y-1 text-left">
+                                <li>${t('inquire.exampleQuestion1')}</li>
+                                <li>${t('inquire.exampleQuestion2')}</li>
+                                <li>${t('inquire.exampleQuestion3')}</li>
+                                <li>${t('inquire.exampleQuestion4')}</li>
+                            </ul>
+                        </div>
+                    </div>
+                    
+                    <!-- Chat Messages -->
+                    <div v-for="(message, index) in inquireChatMessages" :key="index" 
+                         :class="['flex', message.role === 'user' ? 'justify-end' : 'justify-start']">
+                        <div :class="['max-w-3xl px-4 py-4 rounded-xl chat-message', 
+                                      message.role === 'user' 
+                                      ? 'bg-[var(--bg-accent)] text-[var(--text-accent)]' 
+                                      : 'bg-[var(--bg-tertiary)] text-[var(--text-primary)]']">
+                            <div class="prose prose-sm max-w-none text-[var(--text-primary)]" 
+                                 :class="message.role === 'user' ? 'prose-invert' : ''" 
+                                 v-html="message.html || message.content">
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <!-- Loading indicator with status -->
+                    <div v-if="isInquireChatLoading" class="flex justify-start">
+                        <div class="bg-[var(--bg-tertiary)] px-4 py-3 rounded-xl max-w-md">
+                            <div class="flex items-center space-x-2">
+                                <div class="animate-spin h-5 w-5 border-2 border-[var(--text-accent)] border-t-transparent rounded-full flex-shrink-0"></div>
+                                <span class="text-sm text-[var(--text-muted)]" v-if="showProcessingStatus">${chatProcessingStatus}</span>
+                                <span class="text-sm text-[var(--text-muted)]" v-else>Analyzing transcriptions...</span>
+                            </div>
+                            
+                            <!-- Progress steps indicator -->
+                            <div v-if="showProcessingStatus" class="mt-2 flex space-x-1">
+                                <div class="h-1 w-4 bg-[var(--text-accent)] rounded" :class="{ 'animate-pulse': chatProcessingStatus.includes('Analyzing') }"></div>
+                                <div class="h-1 w-4 rounded" :class="chatProcessingStatus.includes('Enriching') || chatProcessingStatus.includes('Searching') || chatProcessingStatus.includes('Responding') ? 'bg-[var(--text-accent)]' : 'bg-[var(--border-secondary)]'"></div>
+                                <div class="h-1 w-4 rounded" :class="chatProcessingStatus.includes('Searching') || chatProcessingStatus.includes('Responding') ? 'bg-[var(--text-accent)]' : 'bg-[var(--border-secondary)]'"></div>
+                                <div class="h-1 w-4 rounded" :class="chatProcessingStatus.includes('Contextualizing') || chatProcessingStatus.includes('Responding') ? 'bg-[var(--text-accent)]' : 'bg-[var(--border-secondary)]'"></div>
+                                <div class="h-1 w-4 rounded" :class="chatProcessingStatus.includes('Responding') ? 'bg-[var(--text-accent)] animate-pulse' : 'bg-[var(--border-secondary)]'"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                
+                <!-- Chat Input Area -->
+                <div class="flex-shrink-0 border-t border-[var(--border-primary)] p-6 bg-[var(--bg-secondary)]">
+                    <div class="flex gap-4">
+                        <textarea v-model="inquireChatInput" 
+                                  @keydown="handleInquireChatKeydown"
+                                  :placeholder="t('inquire.placeholder')"
+                                  class="flex-1 px-4 py-3 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-xl resize-none focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:border-transparent text-[var(--text-primary)]"
+                                  rows="3"></textarea>
+                        <button @click="sendInquireChatMessage" 
+                                :disabled="!inquireChatInput.trim() || isInquireChatLoading"
+                                class="px-6 py-3 bg-[var(--bg-button)] text-[var(--text-button)] rounded-xl hover:bg-[var(--bg-button-hover)] transition-colors disabled:opacity-50 disabled:cursor-not-allowed flex items-center justify-center min-w-[60px]">
+                            <i class="fas fa-paper-plane text-lg"></i>
+                        </button>
+                    </div>
+                    <div class="text-xs text-[var(--text-muted)] mt-3 flex items-center justify-between">
+                        <span>${t('inquire.sendHint')}</span>
+                        <span v-if="hasActiveFilters" class="text-[var(--text-accent)]">
+                            <i class="fas fa-filter mr-1"></i>${t('inquire.filtersActive')}
+                        </span>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Toast Container -->
+        <div id="toastContainer" class="fixed top-4 right-4 z-50 space-y-2"></div>
+
+        <!-- Global Error Banner -->
+        <div v-if="globalError" class="fixed top-16 left-1/2 transform -translate-x-1/2 z-50 max-w-lg w-full mx-4">
+            <div class="bg-red-600 text-white px-4 py-3 rounded-lg shadow-lg flex items-center justify-between">
+                <div class="flex items-center">
+                    <i class="fas fa-exclamation-circle mr-3"></i>
+                    <span class="text-sm font-medium">${ globalError }</span>
+                </div>
+                <button @click="globalError = null" class="ml-4 text-white hover:text-gray-200">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+        </div>
+        <!-- Color Scheme Modal -->
+        <div v-if="showColorSchemeModal" class="color-scheme-modal" @click.self="closeColorSchemeModal">
+            <div class="color-scheme-modal-content">
+                <div class="color-scheme-header">
+                    <h2 class="color-scheme-title">
+                        <i class="fas fa-palette"></i>
+                        <span v-text="t('colorScheme.title')"></span>
+                    </h2>
+                    <p class="color-scheme-subtitle" v-text="t('colorScheme.subtitle')"></p>
+                </div>
+
+                <div class="color-scheme-body">
+                    <div class="color-scheme-section">
+                        <h3 class="color-scheme-section-title">
+                            <i :class="isDarkMode ? 'fas fa-moon' : 'fas fa-sun'"></i>
+                            <span v-text="isDarkMode ? t('colorScheme.darkThemes') : t('colorScheme.lightThemes')"></span>
+                        </h3>
+                        <div class="color-scheme-grid">
+                            <div v-for="scheme in colorSchemes[isDarkMode ? 'dark' : 'light']"
+                                 :key="scheme.id"
+                                 @click="selectColorScheme(scheme.id)"
+                                 :class="['color-scheme-option', currentColorScheme === scheme.id ? 'active' : '']">
+                                <div class="color-scheme-preview">
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-primary color-scheme-preview-segment`"></div>
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-secondary color-scheme-preview-segment`"></div>
+                                    <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-tertiary color-scheme-preview-segment`"></div>
+                                </div>
+                                <div class="color-scheme-name" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.name')"></div>
+                                <div class="color-scheme-description" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.description')"></div>
+                                <div v-if="currentColorScheme === scheme.id" class="color-scheme-check">
+                                    <i class="fas fa-check"></i>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="color-scheme-footer">
+                    <button @click="resetColorScheme" class="color-scheme-reset-btn">
+                        <i class="fas fa-undo mr-2"></i><span v-text="t('colorScheme.resetToDefault')"></span>
+                    </button>
+                    <button @click="closeColorSchemeModal" class="color-scheme-close-btn" v-text="t('common.close')">
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Shares List Modal -->
+        <div v-if="showSharesListModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+            <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col">
+                <div class="p-6 border-b border-[var(--border-primary)] flex justify-between items-center">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.sharedTranscripts')"></h3>
+                    <button @click="closeSharesList" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+                <div class="p-6 space-y-4 overflow-y-auto">
+                    <div v-if="isLoadingShares" class="text-center">
+                        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                    </div>
+                    <div v-else-if="userShares.length === 0" class="text-center text-[var(--text-muted)]">
+                        <span v-text="t('sharedTranscripts.noSharedTranscripts')"></span>
+                    </div>
+                    <div v-else class="space-y-3">
+                        <div v-for="share in userShares" :key="share.id" class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex justify-between items-start">
+                                <div>
+                                    <p class="font-semibold">${share.recording_title}</p>
+                                    <p class="text-sm text-[var(--text-muted)]">${ t('help.sharedOn') }: ${share.created_at}</p>
+                                </div>
+                                <button @click="deleteShare(share.id)" class="text-red-500 hover:text-red-700 p-1"><i class="fas fa-trash"></i></button>
+                            </div>
+                            <div class="mt-4">
+                                <input :value="'{{ request.url_root }}share/' + share.public_id" readonly class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm">
+                                <button @click="copyShareLink(share.public_id)" class="mt-2 px-3 py-1 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg text-sm hover:bg-[var(--bg-button-hover)]">
+                                    <i class="fas fa-copy mr-2"></i>Copy Link
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- CSRF Token Management -->
+    <script src="{{ url_for('static', filename='js/csrf-refresh.js') }}"></script>
+    
+    <!-- Shared Components -->
+    <script src="{{ url_for('static', filename='js/shared-components.js') }}"></script>
+    
+    <!-- Inquire Mode Vue App -->
+    <script>
+        const { createApp, ref, reactive, computed, onMounted, onUnmounted, nextTick } = Vue;
+
+        // Initialize i18n
+        let t = (key) => key; // Default fallback
+        
+        async function initializeI18n() {
+            const userLanguage = "{{ user_language }}";
+            
+            // Initialize the global i18n instance
+            if (window.i18n) {
+                await window.i18n.init(userLanguage);
+                
+                // Create a shorthand translation function
+                t = (key, params) => window.i18n.t(key, params);
+            }
+        }
+
+        document.addEventListener('DOMContentLoaded', async () => {
+            await initializeI18n();
+            
+            const csrfToken = ref(document.querySelector('meta[name="csrf-token"]')?.getAttribute('content'));
+            const i18nInstance = window.i18n;
+
+            createApp({
+                setup() {
+                    // --- State ---
+                    const inquireFilters = reactive({
+                        selectedTags: [],
+                        selectedSpeakers: [],
+                        selectedRecordings: [],
+                        dateFrom: null,
+                        dateTo: null
+                    });
+                    
+                    // Search queries for filters
+                    const tagSearchQuery = ref('');
+                    const speakerSearchQuery = ref('');
+                    
+                    // Use shared components
+                    const { isDarkMode, toggleDarkMode, initializeDarkMode } = window.SharedComponents.useDarkMode();
+                    const { 
+                        showColorSchemeModal, 
+                        currentColorScheme, 
+                        colorSchemes,
+                        openColorSchemeModal, 
+                        closeColorSchemeModal, 
+                        selectColorScheme,
+                        resetColorScheme,
+                        applyColorScheme,
+                        initializeColorScheme
+                    } = window.SharedComponents.useColorScheme();
+                    const {
+                        showSharesListModal,
+                        userShares,
+                        isLoadingShares,
+                        openSharesList,
+                        closeSharesList,
+                        copyShareLink,
+                        deleteShare
+                    } = window.SharedComponents.useSharesModal();
+                    const { isUserMenuOpen, toggleUserMenu, closeUserMenu } = window.SharedComponents.useUserMenu();
+                    const isMobileSidebarOpen = ref(false);
+                    
+                    const availableFilters = reactive({
+                        tags: [],
+                        speakers: [],
+                        recordings: []
+                    });
+                    
+                    const inquireChatMessages = ref([]);
+                    const inquireChatInput = ref('');
+                    const isInquireChatLoading = ref(false);
+                    const chatProcessingStatus = ref('');
+                    const showProcessingStatus = ref(false);
+                    const inquireMessagesRef = ref(null);
+                    const globalError = ref(null);
+                    const shouldAutoScroll = ref(true); // Track if we should auto-scroll
+                    const tokenBudget = ref({
+                        has_budget: false,
+                        budget: null,
+                        usage: 0,
+                        percentage: 0
+                    });
+
+                    // --- Computed ---
+                    const hasActiveFilters = computed(() => {
+                        return inquireFilters.selectedTags.length > 0 ||
+                               inquireFilters.selectedSpeakers.length > 0 ||
+                               inquireFilters.selectedRecordings.length > 0 ||
+                               inquireFilters.dateFrom ||
+                               inquireFilters.dateTo;
+                    });
+                    
+                    const filteredTags = computed(() => {
+                        if (!tagSearchQuery.value) return availableFilters.tags;
+                        return availableFilters.tags.filter(tag => 
+                            tag.name.toLowerCase().includes(tagSearchQuery.value.toLowerCase())
+                        );
+                    });
+                    
+                    const filteredSpeakers = computed(() => {
+                        if (!speakerSearchQuery.value) return availableFilters.speakers;
+                        return availableFilters.speakers.filter(speaker => 
+                            speaker.toLowerCase().includes(speakerSearchQuery.value.toLowerCase())
+                        );
+                    });
+
+                    // --- Functions ---
+                    const setGlobalError = (message, duration = 7000) => {
+                        globalError.value = message;
+                        if (duration > 0) {
+                            setTimeout(() => { if (globalError.value === message) globalError.value = null; }, duration);
+                        }
+                    };
+
+                    const loadTokenBudget = async () => {
+                        try {
+                            const response = await fetch('/api/user/token-budget');
+                            if (response.ok) {
+                                tokenBudget.value = await response.json();
+                            }
+                        } catch (error) {
+                            console.error('Error loading token budget:', error);
+                        }
+                    };
+
+                    const loadAvailableFilters = async () => {
+                        try {
+                            const response = await fetch('/api/inquire/available_filters');
+                            if (response.ok) {
+                                const data = await response.json();
+                                availableFilters.tags = data.tags;
+                                availableFilters.speakers = data.speakers;
+                                availableFilters.recordings = data.recordings;
+                            }
+                        } catch (error) {
+                            console.error('Error loading available filters:', error);
+                        }
+                    };
+
+                    const sendInquireChatMessage = async () => {
+                        if (!inquireChatInput.value.trim() || isInquireChatLoading.value) return;
+                        
+                        const userMessage = inquireChatInput.value.trim();
+                        inquireChatMessages.value.push({ role: 'user', content: userMessage, html: userMessage });
+                        inquireChatInput.value = '';
+                        isInquireChatLoading.value = true;
+                        showProcessingStatus.value = true;
+                        chatProcessingStatus.value = 'Initializing...';
+                        
+                        // Always scroll to bottom when user sends a message
+                        shouldAutoScroll.value = true;
+                        await nextTick();
+                        scrollToBottom();
+                        
+                        try {
+                            const response = await fetch('/api/inquire/chat', {
+                                method: 'POST',
+                                headers: {
+                                    'Content-Type': 'application/json',
+                                    'X-CSRFToken': csrfToken.value
+                                },
+                                body: JSON.stringify({
+                                    message: userMessage,
+                                    message_history: inquireChatMessages.value.slice(0, -1),
+                                    filter_tags: inquireFilters.selectedTags,
+                                    filter_speakers: inquireFilters.selectedSpeakers,
+                                    filter_recording_ids: inquireFilters.selectedRecordings,
+                                    filter_date_from: inquireFilters.dateFrom,
+                                    filter_date_to: inquireFilters.dateTo,
+                                    context_chunks: 8
+                                })
+                            });
+                            
+                            if (!response.ok) {
+                                throw new Error('Chat request failed');
+                            }
+                            
+                            // Handle streaming response
+                            const reader = response.body.getReader();
+                            const decoder = new TextDecoder();
+                            let assistantMessage = reactive({ role: 'assistant', content: '', html: '' });
+                            let messageAdded = false;
+                            
+                            while (true) {
+                                const { done, value } = await reader.read();
+                                if (done) break;
+                                
+                                const chunk = decoder.decode(value, { stream: true });
+                                const lines = chunk.split('\n');
+                                
+                                for (const line of lines) {
+                                    if (line.startsWith('data: ')) {
+                                        try {
+                                            const data = JSON.parse(line.slice(6));
+                                            if (data.status && data.message) {
+                                                // Update processing status
+                                                chatProcessingStatus.value = data.message;
+                                            } else if (data.delta) {
+                                                // Hide status and start showing response
+                                                if (!messageAdded) {
+                                                    inquireChatMessages.value.push(assistantMessage);
+                                                    messageAdded = true;
+                                                    showProcessingStatus.value = false;
+                                                }
+                                                assistantMessage.content += data.delta;
+                                                assistantMessage.html = marked.parse(assistantMessage.content);
+                                                // Smart scroll during streaming
+                                                await nextTick();
+                                                scrollToBottom();
+                                            } else if (data.end_of_stream) {
+                                                return;
+                                            } else if (data.error) {
+                                                if (data.budget_exceeded) {
+                                                    throw new Error(t('adminDashboard.tokenBudgetExceeded'));
+                                                }
+                                                throw new Error(data.error);
+                                            }
+                                        } catch (parseError) {
+                                            console.warn('Failed to parse SSE data:', line);
+                                        }
+                                    }
+                                }
+                            }
+                        } catch (error) {
+                            console.error('Error in inquire chat:', error);
+                            setGlobalError(error.message || 'Chat failed. Please try again.', 10000);
+                        } finally {
+                            isInquireChatLoading.value = false;
+                            showProcessingStatus.value = false;
+                            loadTokenBudget(); // Refresh token usage after chat
+                            await nextTick();
+                            scrollToBottom(); // Use smart scrolling
+                        }
+                    };
+
+                    const handleInquireChatKeydown = (event) => {
+                        if (event.key === 'Enter') {
+                            if (event.ctrlKey || event.shiftKey) {
+                                return;
+                            } else {
+                                event.preventDefault();
+                                sendInquireChatMessage();
+                            }
+                        }
+                    };
+
+                    const clearInquireFilters = () => {
+                        inquireFilters.selectedTags = [];
+                        inquireFilters.selectedSpeakers = [];
+                        inquireFilters.selectedRecordings = [];
+                        inquireFilters.dateFrom = null;
+                        inquireFilters.dateTo = null;
+                        inquireChatMessages.value = [];
+                    };
+                    
+                    const formatDate = (dateString) => {
+                        if (!dateString) return '';
+                        const date = new Date(dateString);
+                        return date.toLocaleDateString();
+                    };
+                    
+                    // Smart scrolling functions
+                    const isNearBottom = () => {
+                        if (!inquireMessagesRef.value) return true;
+                        const container = inquireMessagesRef.value;
+                        const threshold = 100; // pixels from bottom
+                        return container.scrollTop + container.clientHeight >= container.scrollHeight - threshold;
+                    };
+                    
+                    const scrollToBottom = () => {
+                        if (inquireMessagesRef.value && shouldAutoScroll.value) {
+                            inquireMessagesRef.value.scrollTop = inquireMessagesRef.value.scrollHeight;
+                        }
+                    };
+                    
+                    const handleScroll = () => {
+                        if (inquireMessagesRef.value) {
+                            shouldAutoScroll.value = isNearBottom();
+                        }
+                    };
+                    
+
+                    // --- Theme Management (from main app.js) ---
+                    const applyThemeFromStorage = () => {
+                        const savedDarkMode = localStorage.getItem('darkMode');
+                        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+                        const isDark = savedDarkMode !== null ? savedDarkMode === 'true' : prefersDark;
+
+                        document.documentElement.classList.toggle('dark', isDark);
+
+                        const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+                        const currentMode = isDark ? 'dark' : 'light';
+                        const themeClass = savedScheme === 'blue' ? '' : `theme-${currentMode}-${savedScheme}`;
+
+                        // Remove all existing theme classes
+                        document.documentElement.className = document.documentElement.className
+                            .replace(/theme-(?:light|dark)-\w+/g, '');
+
+                        if (themeClass) {
+                            document.documentElement.classList.add(themeClass);
+                        }
+                    };
+
+                    /**
+                     * Set up global click handler to close dropdowns when clicking outside
+                     * Provides elegant UX by closing menus when users click elsewhere
+                     */
+                    const setupGlobalClickHandler = () => {
+                        document.addEventListener('click', (event) => {
+                            const target = event.target;
+
+                            // Close user menu if clicking outside of it
+                            if (isUserMenuOpen.value) {
+                                const userMenuButton = target.closest('[data-user-menu-toggle]');
+                                const userMenuDropdown = target.closest('[data-user-menu-dropdown]');
+
+                                if (!userMenuButton && !userMenuDropdown) {
+                                    isUserMenuOpen.value = false;
+                                }
+                            }
+                        });
+                    };
+
+                    // --- Lifecycle ---
+                    onMounted(async () => {
+                        // Initialize dark mode and color scheme
+                        initializeDarkMode();
+                        initializeColorScheme(isDarkMode.value);
+                        setupGlobalClickHandler();
+                        
+                        // Watch dark mode changes to update color scheme
+                        Vue.watch(isDarkMode, (newValue) => {
+                            initializeColorScheme(newValue);
+                        });
+                        
+                        // Apply theme from localStorage on page load
+                        applyThemeFromStorage();
+                        
+                        loadAvailableFilters();
+                        loadTokenBudget();
+
+                        // Add scroll listener for smart auto-scroll after DOM is ready
+                        await nextTick();
+                        if (inquireMessagesRef.value) {
+                            inquireMessagesRef.value.addEventListener('scroll', handleScroll);
+                        }
+                    });
+                    
+                    onUnmounted(() => {
+                        if (inquireMessagesRef.value) {
+                            inquireMessagesRef.value.removeEventListener('scroll', handleScroll);
+                        }
+                    });
+
+                    return {
+                        // i18n - bind to i18n instance to maintain context
+                        t: (key, params) => i18nInstance ? i18nInstance.t(key, params) : key,
+                        
+                        // State
+                        inquireFilters,
+                        availableFilters,
+                        inquireChatMessages,
+                        inquireChatInput,
+                        isInquireChatLoading,
+                        inquireMessagesRef,
+                        globalError,
+                        tokenBudget,
+                        isUserMenuOpen,
+                        isMobileSidebarOpen,
+                        chatProcessingStatus,
+                        showProcessingStatus,
+                        tagSearchQuery,
+                        speakerSearchQuery,
+                        
+                        // Dark Mode
+                        isDarkMode,
+                        toggleDarkMode,
+                        
+                        // Color Scheme
+                        showColorSchemeModal,
+                        currentColorScheme,
+                        colorSchemes,
+                        openColorSchemeModal,
+                        closeColorSchemeModal,
+                        selectColorScheme,
+                        resetColorScheme,
+                        
+                        // Shares Modal
+                        showSharesListModal,
+                        userShares,
+                        isLoadingShares,
+                        openSharesList,
+                        closeSharesList,
+                        copyShareLink,
+                        deleteShare,
+                        
+                        // Computed
+                        hasActiveFilters,
+                        filteredTags,
+                        filteredSpeakers,
+                        
+                        // Functions
+                        sendInquireChatMessage,
+                        handleInquireChatKeydown,
+                        clearInquireFilters,
+                        loadAvailableFilters,
+                        setGlobalError,
+                        formatDate,
+                        handleScroll
+                    };
+                },
+                delimiters: ['${', '}']
+            }).mount('#inquire-app');
+
+            // Hide loading overlay after app mounts
+            Vue.nextTick(() => {
+                if (window.AppLoader) {
+                    AppLoader.waitForReady();
+                }
+            });
+        });
+    </script>
+</body>
+</html>
\ No newline at end of file
diff --git a/templates/login.html b/templates/login.html
index 08bf54c0..87cab134 100644
--- a/templates/login.html
+++ b/templates/login.html
@@ -3,103 +3,61 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
     <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
 
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
+    <!-- Loading overlay to prevent FOUC -->
+    {% include 'includes/loading_overlay.html' %}
 
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
+    <script>
+        // Function to apply the theme based on localStorage
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
 
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
 
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
 
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
         }
-        html, body { height: 100%; margin: 0; }
-    </style>
+        applyTheme();
+    </script>
 </head>
 <body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
     <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
         <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
             <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
             </h1>
         </header>
 
@@ -117,9 +75,43 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">L
                     {% endif %}
                 {% endwith %}
                 
-                <form method="POST" action="{{ url_for('login') }}">
+                {% if sso_enabled %}
+                <div class="flex flex-col space-y-3 {% if not password_login_disabled %}mb-6{% endif %}">
+                    <a href="{{ url_for('auth.sso_login') }}" class="w-full inline-flex items-center justify-center px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-md hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)] transition-colors duration-200">
+                        <i class="fas fa-cloud mr-2"></i> Sign in with {{ sso_provider_name }}
+                    </a>
+                    {% if not password_login_disabled %}
+                    <div class="flex items-center text-xs text-[var(--text-muted)]">
+                        <span class="flex-grow border-t border-[var(--border-secondary)]"></span>
+                        <span class="mx-3 uppercase tracking-wide">or</span>
+                        <span class="flex-grow border-t border-[var(--border-secondary)]"></span>
+                    </div>
+                    {% endif %}
+                </div>
+                {% endif %}
+
+                {% if password_login_disabled %}
+                <div class="mt-4 text-center">
+                    <button type="button" onclick="document.getElementById('admin-login-form').classList.toggle('hidden')" class="text-xs text-[var(--text-muted)] hover:text-[var(--text-secondary)]">
+                        <i class="fas fa-lock mr-1"></i> Administrator login
+                    </button>
+                </div>
+                <form id="admin-login-form" method="POST" action="{{ url_for('auth.login') }}" class="hidden mt-4">
+                    {{ form.hidden_tag() }}
+                    <div class="mb-4">
+                        {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]", placeholder="Admin email") }}
+                    </div>
+                    <div class="mb-4">
+                        {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]", placeholder="Password") }}
+                    </div>
+                    <button type="submit" class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]">
+                        Sign in
+                    </button>
+                </form>
+                {% else %}
+                <form method="POST" action="{{ url_for('auth.login') }}">
                     {{ form.hidden_tag() }}
-                    
+
                     <div class="mb-4">
                         {{ form.email.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
                         {% if form.email.errors %}
@@ -133,8 +125,8 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">L
                             {{ form.email(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
                         {% endif %}
                     </div>
-                    
-                    <div class="mb-6">
+
+                    <div class="mb-4">
                         {{ form.password.label(class="block text-sm font-medium text-[var(--text-secondary)] mb-1") }}
                         {% if form.password.errors %}
                             {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-danger)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
@@ -147,21 +139,25 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">L
                             {{ form.password(class="mt-1 block w-full rounded-md border-[var(--border-secondary)] shadow-sm focus:border-[var(--border-focus)] focus:ring-[var(--ring-focus)] focus:ring-opacity-50 bg-[var(--bg-input)] text-[var(--text-primary)]") }}
                         {% endif %}
                     </div>
-                    
-                    <div class="flex items-center mb-6">
-                        {{ form.remember(class="h-4 w-4 text-[var(--text-accent)] focus:ring-[var(--ring-focus)] border-[var(--border-secondary)] rounded") }}
-                        {{ form.remember.label(class="ml-2 block text-sm text-[var(--text-secondary)]") }}
+
+                    <div class="flex items-center justify-between mb-6">
+                        <div class="flex items-center">
+                            {{ form.remember(class="h-4 w-4 text-[var(--text-accent)] focus:ring-[var(--ring-focus)] border-[var(--border-secondary)] rounded") }}
+                            {{ form.remember.label(class="ml-2 block text-sm text-[var(--text-secondary)]") }}
+                        </div>
+                        <a href="{{ url_for('auth.forgot_password') }}" class="text-sm text-[var(--text-accent)] hover:underline">Forgot password?</a>
                     </div>
-                    
+
                     <div class="flex flex-col space-y-4">
                         {{ form.submit(class="w-full py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-[var(--text-button)] bg-[var(--bg-button)] hover:bg-[var(--bg-button-hover)] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[var(--border-focus)]") }}
-                        
+
                         <div class="text-center text-sm text-[var(--text-muted)]">
                             <span>Don't have an account?</span>
-                            <a href="{{ url_for('register') }}" class="font-medium text-[var(--text-accent)] hover:underline">Register here</a>
+                            <a href="{{ url_for('auth.register') }}" class="font-medium text-[var(--text-accent)] hover:underline">Register here</a>
                         </div>
                     </div>
                 </form>
+                {% endif %}
             </div>
         </main>
 
@@ -169,5 +165,14 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">L
             Speakr &copy; {{ now.year }}
         </footer>
     </div>
+
+    <script>
+        // Hide loading overlay when page is ready
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
 </body>
 </html>
diff --git a/templates/modals/add-speaker-modal.html b/templates/modals/add-speaker-modal.html
new file mode 100644
index 00000000..6a19611e
--- /dev/null
+++ b/templates/modals/add-speaker-modal.html
@@ -0,0 +1,77 @@
+<!-- Add Speaker Modal -->
+<div v-if="showAddSpeakerModal" @click.self="closeAddSpeakerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between mb-4">
+                <h3 class="text-xl font-bold text-[var(--text-primary)]" v-text="t('modal.addSpeaker')"></h3>
+                <button @click="closeAddSpeakerModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6">
+
+        <!-- "This is Me" checkbox -->
+        <div class="mb-4">
+            <label class="flex items-center text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                <input type="checkbox" v-model="newSpeakerIsMe" class="speaker-checkbox">
+                <span class="ml-2 select-none" v-text="t('help.me')"></span>
+            </label>
+        </div>
+
+        <!-- Speaker name input with autocomplete (disabled if "This is Me" is checked) -->
+        <div class="mb-6 relative">
+            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2" v-text="t('help.speakerName')">
+            </label>
+            <input
+                type="text"
+                v-model="newSpeakerName"
+                @input="searchNewSpeaker"
+                @focus="showNewSpeakerSuggestions = true"
+                @blur="hideNewSpeakerSuggestionsDelayed"
+                :disabled="newSpeakerIsMe"
+                :placeholder="newSpeakerIsMe ? currentUserName : t('help.enterSpeakerName')"
+                class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed"
+                @keyup.enter="addNewSpeaker"
+                autocomplete="off"
+            >
+
+            <!-- Loading indicator -->
+            <div v-if="loadingNewSpeakerSuggestions && !newSpeakerIsMe" class="absolute right-3 top-[42px] transform -translate-y-1/2">
+                <i class="fas fa-spinner fa-spin text-[var(--text-muted)] text-sm"></i>
+            </div>
+
+            <!-- Suggestions dropdown -->
+            <div v-if="showNewSpeakerSuggestions && newSpeakerSuggestions.length > 0 && !newSpeakerIsMe"
+                 @click.stop
+                 class="absolute z-10 w-full mt-1 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-48 overflow-y-auto">
+                <div class="py-1">
+                    <div v-for="suggestion in newSpeakerSuggestions"
+                         :key="suggestion.id"
+                         @click="selectNewSpeakerSuggestion(suggestion)"
+                         class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-tertiary)] flex items-center justify-between">
+                        <div class="flex-grow">
+                            <div class="text-sm font-medium text-[var(--text-primary)]">${ suggestion.name }</div>
+                            <div class="text-xs text-[var(--text-muted)]">
+                                Used ${ suggestion.use_count } time${ suggestion.use_count !== 1 ? 's' : '' }
+                                <span v-if="suggestion.last_used">
+                                    • Last: ${ new Date(suggestion.last_used).toLocaleDateString() }
+                                </span>
+                            </div>
+                        </div>
+                        <i class="fas fa-user text-[var(--text-muted)] ml-2"></i>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Action buttons -->
+        <div class="flex justify-end space-x-3">
+            <button @click="closeAddSpeakerModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors" v-text="t('common.cancel')">
+            </button>
+            <button @click="addNewSpeaker" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors" v-text="t('buttons.addSpeaker')">
+            </button>
+        </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/asr-editor-modal.html b/templates/modals/asr-editor-modal.html
new file mode 100644
index 00000000..8c0bf964
--- /dev/null
+++ b/templates/modals/asr-editor-modal.html
@@ -0,0 +1,171 @@
+<!-- ASR Editor Modal -->
+<div v-if="showAsrEditorModal" @click.self="closeAsrEditorModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div @click="closeAllSpeakerSuggestions" class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-6xl flex flex-col max-h-[90vh]">
+        <div class="p-5 border-b border-[var(--border-primary)] flex-shrink-0 flex justify-between items-center">
+            <div class="flex items-center gap-3">
+                <h3 class="text-xl font-bold text-[var(--text-primary)]" v-text="t('modal.editAsrTranscription')"></h3>
+                <span v-if="asrEditorSaveFlash"
+                      class="inline-flex items-center gap-1.5 text-xs font-medium text-[var(--text-success-strong)] bg-[var(--bg-success-light)] px-2 py-1 rounded-md transition-opacity">
+                    <i class="fas fa-check-circle"></i>
+                    <span v-text="t('asrEditor.saved')"></span>
+                </span>
+            </div>
+            <button @click="closeAsrEditorModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+
+        <!-- Audio Player Section -->
+        <div class="px-6 py-4 border-b border-[var(--border-primary)] flex-shrink-0">
+            <!-- Show message if audio has been deleted -->
+            <div v-if="selectedRecording.audio_deleted_at"
+                 class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-secondary)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                <i class="fas fa-info-circle"></i>
+                <span v-text="t('help.audioDeletedMessage')"></span>
+            </div>
+            <!-- Show message for incognito recordings -->
+            <div v-else-if="selectedRecording.incognito"
+                 class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-secondary)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                <i class="fas fa-user-secret"></i>
+                <span>Audio not stored in incognito mode</span>
+            </div>
+            <!-- Custom Audio Player (Independent from main player) -->
+            <div v-else class="flex items-center gap-3">
+                <audio ref="asrEditorAudioRef" class="hidden"
+                       :key="'asr-editor-' + selectedRecording.id"
+                       :src="'/audio/' + selectedRecording.id"
+                       :volume="playerVolume"
+                       @play="handleModalAudioPlayPause"
+                       @pause="handleModalAudioPlayPause"
+                       @timeupdate="handleModalAudioTimeUpdate"
+                       @loadedmetadata="handleModalAudioLoadedMetadata"
+                       @ended="modalAudioIsPlaying = false">
+                </audio>
+                <!-- Play/Pause -->
+                <button @click="$refs.asrEditorAudioRef?.paused ? $refs.asrEditorAudioRef.play() : $refs.asrEditorAudioRef.pause()"
+                        class="w-10 h-10 flex items-center justify-center rounded-full bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] text-white transition-all flex-shrink-0 shadow-sm"
+                        :title="modalAudioIsPlaying ? 'Pause' : 'Play'">
+                    <i :class="modalAudioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-sm" :style="!modalAudioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                </button>
+                <!-- Time -->
+                <div class="flex flex-col items-end flex-shrink-0 leading-none">
+                    <span class="text-sm text-[var(--text-primary)] font-mono">${ formatAudioTime(modalAudioCurrentTime) }</span>
+                    <span class="text-xs text-[var(--text-muted)] font-mono">${ formatAudioTime(modalAudioDuration) }</span>
+                </div>
+                <!-- Progress Bar -->
+                <div class="flex-1 h-2 bg-[var(--bg-tertiary)] rounded-full cursor-pointer group relative"
+                     @click="(e) => { const rect = e.currentTarget.getBoundingClientRect(); const pct = (e.clientX - rect.left) / rect.width; if ($refs.asrEditorAudioRef) $refs.asrEditorAudioRef.currentTime = pct * modalAudioDuration; }">
+                    <div class="h-full bg-[var(--bg-accent)] rounded-full transition-all duration-100"
+                         :style="{ width: modalAudioProgressPercent + '%' }">
+                    </div>
+                </div>
+                <!-- Volume -->
+                <div class="flex items-center gap-2 flex-shrink-0">
+                    <button @click="$refs.asrEditorAudioRef && ($refs.asrEditorAudioRef.muted = !$refs.asrEditorAudioRef.muted)"
+                            class="w-8 h-8 flex items-center justify-center rounded hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-all">
+                        <i :class="playerVolume === 0 ? 'fas fa-volume-mute' : 'fas fa-volume-up'" class="text-sm"></i>
+                    </button>
+                    <input type="range" min="0" max="1" step="0.05" :value="playerVolume"
+                           @input="(e) => { if ($refs.asrEditorAudioRef) $refs.asrEditorAudioRef.volume = parseFloat(e.target.value); }"
+                           class="volume-slider w-20 h-1.5 rounded-full cursor-pointer">
+                </div>
+                <!-- Speed Control (compact - tap to cycle) -->
+                <button @click="cycleModalPlaybackRate(); if ($refs.asrEditorAudioRef) $refs.asrEditorAudioRef.playbackRate = modalPlaybackRate"
+                        class="w-8 h-8 flex items-center justify-center rounded hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-all flex-shrink-0"
+                        title="Playback speed (tap to change)">
+                    <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(modalPlaybackRate) }</span>
+                </button>
+            </div>
+        </div>
+
+        <div ref="asrEditorRef" class="flex-grow overflow-y-auto custom-scrollbar" @scroll="closeAllSpeakerSuggestions(); onAsrEditorScroll($event)">
+            <table class="min-w-full asr-editor-table border border-[var(--border-primary)]">
+                <thead class="sticky top-0 z-10">
+                    <tr class="text-xs uppercase text-[var(--text-muted)]">
+                        <th class="w-40 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.speakerCount')"></th>
+                        <th class="w-20 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.startTime')"></th>
+                        <th class="w-20 text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.endTime')"></th>
+                        <th class="text-left py-2 px-3 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]" v-text="t('help.sentence')"></th>
+                        <th class="w-24 text-center py-2 px-1 font-medium border border-[var(--border-primary)] bg-[var(--bg-tertiary)]"><span class="sr-only" v-text="t('help.actions')"></span></th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <!-- Virtual scroll spacer (top) -->
+                    <tr v-if="asrEditorSpacerBefore > 0"><td colspan="5" :style="{ height: asrEditorSpacerBefore + 'px', padding: 0 }"></td></tr>
+
+                    <tr v-for="segment in asrEditorVisibleSegments" :key="`asr-${segment._originalIndex}-${segment.start_time}`" :data-segment-index="segment._originalIndex" :class="['hover:bg-[var(--bg-tertiary)] transition-colors border-b border-[var(--border-primary)]', { 'asr-editor-row--highlighted': asrEditorHighlightIndex === segment._originalIndex }]">
+                        <td class="border-r border-[var(--border-primary)] align-middle">
+                            <div class="relative h-full">
+                                <div class="flex items-center h-full">
+                                    <input type="text" v-model="editingSegments[segment._originalIndex].speaker"
+                                           @input="filterSpeakerSuggestions(segment._originalIndex); openSpeakerSuggestions(segment._originalIndex)"
+                                           @focus="openSpeakerSuggestions(segment._originalIndex)"
+                                           class="w-full h-full px-3 py-2.5 pr-7 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)]" />
+                                    <button type="button" @click.stop="openSpeakerSuggestions(segment._originalIndex)"
+                                            class="absolute right-2 top-1/2 -translate-y-1/2 p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] cursor-pointer">
+                                        <i class="fas fa-chevron-down text-xs"></i>
+                                    </button>
+                                </div>
+                            </div>
+                            <!-- Fixed position dropdown -->
+                            <teleport to="body">
+                                <div v-if="isDropdownOpen(segment._originalIndex)"
+                                     class="fixed z-[100] w-40 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-48 overflow-y-auto"
+                                     :style="getDropdownPosition(segment._originalIndex)">
+                                    <div v-for="speaker in editingSegments[segment._originalIndex].filteredSpeakers" :key="speaker" @mousedown.prevent="selectSpeaker(segment._originalIndex, speaker)" class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-tertiary)] text-sm">${speaker}</div>
+                                    <div @mousedown.prevent="openEditSpeakersModal" class="px-3 py-2 cursor-pointer hover:bg-[var(--bg-accent)] text-sm text-[var(--text-accent)] border-t border-[var(--border-primary)] flex items-center">
+                                        <i class="fas fa-user-edit mr-2"></i> <span v-text="t('buttons.editSpeakers')"></span>
+                                    </div>
+                                </div>
+                            </teleport>
+                        </td>
+                        <td class="border-r border-[var(--border-primary)] align-middle">
+                            <input type="number" step="0.01" v-model.number="editingSegments[segment._originalIndex].start_time" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] text-center" />
+                        </td>
+                        <td class="border-r border-[var(--border-primary)] align-middle">
+                            <input type="number" step="0.01" v-model.number="editingSegments[segment._originalIndex].end_time" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] text-center" />
+                        </td>
+                        <td class="border-r border-[var(--border-primary)] align-top">
+                            <textarea v-model="editingSegments[segment._originalIndex].sentence" rows="1" class="w-full px-3 py-2.5 bg-transparent border-0 focus:outline-none text-sm text-[var(--text-primary)] resize-none max-h-20 overflow-y-auto custom-scrollbar block" @input="autoResizeTextarea($event)"></textarea>
+                        </td>
+                        <td class="px-1 text-center align-middle">
+                            <div class="flex items-center justify-center gap-1">
+                                <button @click="$refs.asrEditorAudioRef && ($refs.asrEditorAudioRef.currentTime = segment.start_time, $refs.asrEditorAudioRef.play())" class="p-1.5 rounded hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors" :title="t('help.playFromHere')">
+                                    <i class="fas fa-play text-xs"></i>
+                                </button>
+                                <button @click="addSegmentBelow(segment._originalIndex)" class="p-1.5 rounded hover:bg-green-600/20 text-[var(--text-muted)] hover:text-green-500 transition-colors" :title="t('help.addSegmentBelow')">
+                                    <i class="fas fa-plus text-xs"></i>
+                                </button>
+                                <button @click="removeSegment(segment._originalIndex)" class="p-1.5 rounded hover:bg-red-600/20 text-[var(--text-muted)] hover:text-red-500 transition-colors" :title="t('help.deleteSegment')">
+                                    <i class="fas fa-trash text-xs"></i>
+                                </button>
+                            </div>
+                        </td>
+                    </tr>
+
+                    <!-- Virtual scroll spacer (bottom) -->
+                    <tr v-if="asrEditorSpacerAfter > 0"><td colspan="5" :style="{ height: asrEditorSpacerAfter + 'px', padding: 0 }"></td></tr>
+                </tbody>
+            </table>
+            <div class="py-4 flex justify-center">
+                <button @click="addSegment" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] flex items-center text-sm">
+                    <i class="fas fa-plus mr-2"></i> <span v-text="t('buttons.addSegment')"></span>
+                </button>
+            </div>
+        </div>
+        <div class="bg-[var(--bg-tertiary)] px-6 py-4 flex justify-between items-center border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+            <span class="text-xs text-[var(--text-muted)] hidden sm:inline-flex items-center gap-1.5">
+                <i class="fas fa-keyboard text-[10px]"></i>
+                <span v-text="t('asrEditor.ctrlSHint')"></span>
+            </span>
+            <div class="flex justify-end space-x-3 ml-auto">
+                <button @click="closeAsrEditorModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]" v-text="t('common.cancel')"></button>
+                <button @click="saveAsrTranscription(true)" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] flex items-center gap-2" :title="t('asrEditor.saveWithoutClosing')">
+                    <i class="fas fa-save text-xs"></i>
+                    <span v-text="t('common.save')"></span>
+                </button>
+                <button @click="saveAsrTranscription(false)" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)]" v-text="t('buttons.saveChanges')"></button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/bulk-action-bar.html b/templates/modals/bulk-action-bar.html
new file mode 100644
index 00000000..572433c2
--- /dev/null
+++ b/templates/modals/bulk-action-bar.html
@@ -0,0 +1,79 @@
+<!-- Bulk Action Bar - Fixed at bottom of sidebar when in selection mode -->
+<transition name="slide-up">
+    <div v-if="selectionMode && selectedCount > 0"
+         class="fixed bottom-0 left-0 w-80 bg-[var(--bg-secondary)] border-t border-r border-[var(--border-primary)] shadow-lg z-50 transform transition-transform duration-300"
+         :class="[
+             { 'translate-y-full': bulkActionInProgress },
+             isSidebarCollapsed ? '-translate-x-full' : ''
+         ]">
+        <div class="px-3 py-2">
+            <!-- Compact vertical layout for sidebar width -->
+            <div class="flex flex-col gap-2">
+                <!-- Selection info row -->
+                <div class="flex items-center justify-between">
+                    <span class="text-sm font-medium text-[var(--text-primary)]">
+                        ${ selectedCount } selected
+                    </span>
+                    <div class="flex items-center gap-2">
+                        <button @click="allVisibleSelected ? clearSelection() : selectAll()"
+                                class="text-xs text-[var(--text-accent)] hover:underline">
+                            ${ allVisibleSelected ? 'Clear' : 'All' }
+                        </button>
+                        <button @click="exitSelectionMode"
+                                class="p-1 text-[var(--text-muted)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] rounded transition-colors"
+                                title="Exit selection mode">
+                            <i class="fas fa-times text-xs"></i>
+                        </button>
+                    </div>
+                </div>
+
+                <!-- Action buttons row -->
+                <div class="flex items-center justify-between gap-1">
+                    <button @click="openBulkTagModal('add')"
+                            class="flex-1 px-2 py-1.5 text-xs bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-md transition-colors flex items-center justify-center gap-1"
+                            title="Add or remove tags">
+                        <i class="fas fa-tags text-[var(--text-muted)]"></i>
+                        <span>Tags</span>
+                    </button>
+
+                    <button @click="bulkToggleInbox()"
+                            class="flex-1 px-2 py-1.5 text-xs bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-md transition-colors flex items-center justify-center gap-1"
+                            title="Toggle inbox status">
+                        <i class="fas fa-inbox text-blue-500"></i>
+                        <span>Inbox</span>
+                    </button>
+
+                    <button @click="bulkToggleHighlight()"
+                            class="flex-1 px-2 py-1.5 text-xs bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-md transition-colors flex items-center justify-center gap-1"
+                            title="Toggle highlight">
+                        <i class="fas fa-star text-amber-500"></i>
+                        <span>Star</span>
+                    </button>
+
+                    <button @click="openBulkReprocessModal"
+                            class="flex-1 px-2 py-1.5 text-xs bg-[var(--bg-tertiary)] hover:bg-[var(--bg-input)] rounded-md transition-colors flex items-center justify-center gap-1"
+                            title="Reprocess">
+                        <i class="fas fa-redo text-[var(--text-muted)]"></i>
+                        <span>Redo</span>
+                    </button>
+
+                    <button @click="openBulkDeleteModal"
+                            class="flex-1 px-2 py-1.5 text-xs bg-red-600 hover:bg-red-700 text-white rounded-md transition-colors flex items-center justify-center gap-1"
+                            title="Delete selected">
+                        <i class="fas fa-trash"></i>
+                        <span>Delete</span>
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Loading overlay -->
+        <div v-if="bulkActionInProgress"
+             class="absolute inset-0 bg-[var(--bg-secondary)] bg-opacity-80 flex items-center justify-center">
+            <div class="flex items-center gap-2">
+                <i class="fas fa-spinner fa-spin text-[var(--text-accent)]"></i>
+                <span class="text-xs text-[var(--text-secondary)]">Processing...</span>
+            </div>
+        </div>
+    </div>
+</transition>
diff --git a/templates/modals/bulk-delete-modal.html b/templates/modals/bulk-delete-modal.html
new file mode 100644
index 00000000..e3326529
--- /dev/null
+++ b/templates/modals/bulk-delete-modal.html
@@ -0,0 +1,48 @@
+<!-- Bulk Delete Confirmation Modal -->
+<div v-if="showBulkDeleteModal" @click.self="closeBulkDeleteModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-[100] p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-md">
+        <div class="p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="flex items-center gap-4">
+                    <div class="w-12 h-12 bg-red-100 dark:bg-red-900/30 rounded-full flex items-center justify-center">
+                        <i class="fas fa-exclamation-triangle text-xl text-red-600 dark:text-red-400"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-lg font-semibold text-[var(--text-primary)]">Delete ${ selectedCount } Recording${ selectedCount !== 1 ? 's' : '' }</h3>
+                        <p class="text-sm text-[var(--text-muted)]">This action cannot be undone</p>
+                    </div>
+                </div>
+                <button @click="closeBulkDeleteModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+
+            <div class="bg-[var(--bg-tertiary)] rounded-lg p-4 mb-6">
+                <p class="text-sm text-[var(--text-secondary)] mb-3">
+                    You are about to permanently delete:
+                </p>
+                <ul class="space-y-1 max-h-32 overflow-y-auto">
+                    <li v-for="recording in selectedRecordings.slice(0, 5)" :key="recording.id" class="text-sm text-[var(--text-primary)] flex items-center gap-2">
+                        <i class="fas fa-file-audio text-[var(--text-muted)] text-xs"></i>
+                        <span class="truncate">${ recording.title || 'Untitled' }</span>
+                    </li>
+                    <li v-if="selectedRecordings.length > 5" class="text-sm text-[var(--text-muted)] italic">
+                        ...and ${ selectedRecordings.length - 5 } more
+                    </li>
+                </ul>
+            </div>
+
+            <div class="flex justify-end gap-3">
+                <button @click="closeBulkDeleteModal"
+                        class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                    Cancel
+                </button>
+                <button @click="executeBulkDelete"
+                        class="px-4 py-2 bg-red-600 hover:bg-red-700 text-white rounded-lg transition-colors flex items-center gap-2">
+                    <i class="fas fa-trash"></i>
+                    Delete All
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/bulk-reprocess-modal.html b/templates/modals/bulk-reprocess-modal.html
new file mode 100644
index 00000000..66d01dfa
--- /dev/null
+++ b/templates/modals/bulk-reprocess-modal.html
@@ -0,0 +1,89 @@
+<!-- Bulk Reprocess Modal -->
+<div v-if="showBulkReprocessModal" @click.self="closeBulkReprocessModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-[100] p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center">
+                        <i class="fas fa-sync-alt text-white"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-lg font-semibold text-[var(--text-primary)]">Bulk Reprocess</h3>
+                        <p class="text-sm text-[var(--text-muted)]">${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' } selected</p>
+                    </div>
+                </div>
+                <button @click="closeBulkReprocessModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <div class="p-6">
+            <!-- Reprocess Type Selection -->
+            <div class="mb-6">
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-3">What do you want to reprocess?</label>
+                <div class="space-y-2">
+                    <label class="flex items-start gap-3 p-3 rounded-lg border border-[var(--border-secondary)] cursor-pointer hover:bg-[var(--bg-tertiary)] transition-colors"
+                           :class="{ 'border-[var(--border-accent)] bg-[var(--bg-accent)]': bulkReprocessType === 'summary' }">
+                        <input type="radio" v-model="bulkReprocessType" value="summary" class="mt-1">
+                        <div>
+                            <span class="font-medium text-[var(--text-primary)]">Summary Only</span>
+                            <p class="text-sm text-[var(--text-muted)] mt-0.5">
+                                Regenerate title and summary from existing transcription. Faster option.
+                            </p>
+                        </div>
+                    </label>
+                    <label class="flex items-start gap-3 p-3 rounded-lg border border-[var(--border-secondary)] cursor-pointer hover:bg-[var(--bg-tertiary)] transition-colors"
+                           :class="{ 'border-[var(--border-accent)] bg-[var(--bg-accent)]': bulkReprocessType === 'transcription' }">
+                        <input type="radio" v-model="bulkReprocessType" value="transcription" class="mt-1">
+                        <div>
+                            <span class="font-medium text-[var(--text-primary)]">Full Transcription</span>
+                            <p class="text-sm text-[var(--text-muted)] mt-0.5">
+                                Re-transcribe audio and regenerate everything. Takes longer.
+                            </p>
+                        </div>
+                    </label>
+                </div>
+            </div>
+
+            <!-- Warning -->
+            <div class="p-3 bg-amber-50 dark:bg-amber-900/20 border border-amber-200 dark:border-amber-700 rounded-lg mb-6">
+                <div class="flex items-start gap-2">
+                    <i class="fas fa-exclamation-triangle text-amber-600 dark:text-amber-400 mt-0.5"></i>
+                    <div class="text-sm">
+                        <p class="font-medium text-amber-800 dark:text-amber-200">Note</p>
+                        <p class="text-amber-700 dark:text-amber-300 mt-0.5" v-if="bulkReprocessType === 'summary'">
+                            This will overwrite any manual edits to titles and summaries.
+                        </p>
+                        <p class="text-amber-700 dark:text-amber-300 mt-0.5" v-else>
+                            This will overwrite all transcriptions, titles, and summaries. Manual edits will be lost.
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Recording count info -->
+            <div class="text-sm text-[var(--text-muted)] mb-4">
+                <i class="fas fa-info-circle mr-1"></i>
+                <span v-if="bulkReprocessType === 'summary'">
+                    ${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' } will be queued for summary regeneration.
+                </span>
+                <span v-else>
+                    ${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' } will be queued for full reprocessing.
+                </span>
+            </div>
+        </div>
+
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+            <button @click="closeBulkReprocessModal"
+                    class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="executeBulkReprocess"
+                    class="px-4 py-2 bg-gradient-to-r from-blue-500 to-purple-600 hover:from-blue-600 hover:to-purple-700 text-white rounded-lg transition-colors flex items-center gap-2">
+                <i class="fas fa-sync-alt"></i>
+                Start Reprocessing
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/bulk-tag-modal.html b/templates/modals/bulk-tag-modal.html
new file mode 100644
index 00000000..028f0a67
--- /dev/null
+++ b/templates/modals/bulk-tag-modal.html
@@ -0,0 +1,101 @@
+<!-- Bulk Tag Modal -->
+<div v-if="showBulkTagModal" @click.self="closeBulkTagModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-[100] p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[80vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-[var(--bg-accent)] rounded-full flex items-center justify-center">
+                        <i class="fas fa-tags text-[var(--text-accent)]"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-lg font-semibold text-[var(--text-primary)]">Bulk Tag Update</h3>
+                        <p class="text-sm text-[var(--text-muted)]">${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' } selected</p>
+                    </div>
+                </div>
+                <button @click="closeBulkTagModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <div class="p-6 overflow-y-auto flex-1">
+            <!-- Action Toggle -->
+            <div class="flex rounded-lg bg-[var(--bg-tertiary)] p-1 mb-4">
+                <button @click="bulkTagAction = 'add'"
+                        :class="[
+                            'flex-1 px-4 py-2 text-sm font-medium rounded-md transition-colors',
+                            bulkTagAction === 'add'
+                                ? 'bg-[var(--bg-button)] text-[var(--text-button)]'
+                                : 'text-[var(--text-muted)] hover:text-[var(--text-primary)]'
+                        ]">
+                    <i class="fas fa-plus mr-2"></i>Add Tag
+                </button>
+                <button @click="bulkTagAction = 'remove'"
+                        :class="[
+                            'flex-1 px-4 py-2 text-sm font-medium rounded-md transition-colors',
+                            bulkTagAction === 'remove'
+                                ? 'bg-[var(--bg-button)] text-[var(--text-button)]'
+                                : 'text-[var(--text-muted)] hover:text-[var(--text-primary)]'
+                        ]">
+                    <i class="fas fa-minus mr-2"></i>Remove Tag
+                </button>
+            </div>
+
+            <!-- Tag Selection -->
+            <div>
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                    Select a tag to ${ bulkTagAction }
+                </label>
+                <div class="max-h-64 overflow-y-auto space-y-2 border border-[var(--border-secondary)] rounded-lg p-3 bg-[var(--bg-input)]">
+                    <button v-for="tag in availableTags" :key="tag.id"
+                            @click="bulkTagSelectedId = tag.id"
+                            :class="[
+                                'w-full flex items-center justify-between px-3 py-2 rounded-lg transition-colors',
+                                bulkTagSelectedId == tag.id
+                                    ? 'bg-[var(--bg-accent)] ring-2 ring-[var(--border-accent)]'
+                                    : 'hover:bg-[var(--bg-tertiary)]'
+                            ]">
+                        <div class="flex items-center gap-2">
+                            <span class="w-3 h-3 rounded-full flex-shrink-0" :style="{ backgroundColor: tag.color }"></span>
+                            <span class="text-sm text-[var(--text-primary)]">${ tag.name }</span>
+                            <i v-if="tag.group_id" class="fas fa-users text-xs text-[var(--text-muted)]" title="Group tag"></i>
+                        </div>
+                        <i v-if="bulkTagSelectedId == tag.id" class="fas fa-check text-[var(--text-accent)]"></i>
+                    </button>
+                    <p v-if="availableTags.length === 0" class="text-sm text-[var(--text-muted)] text-center py-4">
+                        No tags available. Create tags in settings.
+                    </p>
+                </div>
+            </div>
+
+            <!-- Info message -->
+            <div class="mt-4 p-3 bg-[var(--bg-tertiary)] rounded-lg text-sm text-[var(--text-muted)]">
+                <i class="fas fa-info-circle mr-2"></i>
+                <span v-if="bulkTagAction === 'add'">
+                    The selected tag will be added to all ${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' }.
+                </span>
+                <span v-else>
+                    The selected tag will be removed from all ${ selectedCount } recording${ selectedCount !== 1 ? 's' : '' } that have it.
+                </span>
+            </div>
+        </div>
+
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3 flex-shrink-0">
+            <button @click="closeBulkTagModal"
+                    class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="executeBulkTag"
+                    :disabled="!bulkTagSelectedId"
+                    :class="[
+                        'px-4 py-2 rounded-lg transition-colors flex items-center gap-2',
+                        bulkTagSelectedId
+                            ? 'bg-[var(--bg-button)] text-[var(--text-button)] hover:bg-[var(--bg-button-hover)]'
+                            : 'bg-[var(--bg-tertiary)] text-[var(--text-muted)] cursor-not-allowed'
+                    ]">
+                <i :class="['fas', bulkTagAction === 'add' ? 'fa-plus' : 'fa-minus']"></i>
+                ${ bulkTagAction === 'add' ? 'Add' : 'Remove' } Tag
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/color-scheme-modal.html b/templates/modals/color-scheme-modal.html
new file mode 100644
index 00000000..82dded7c
--- /dev/null
+++ b/templates/modals/color-scheme-modal.html
@@ -0,0 +1,51 @@
+<!-- Color Scheme Modal -->
+<div v-if="showColorSchemeModal" class="color-scheme-modal" @click.self="closeColorSchemeModal">
+    <div class="color-scheme-modal-content">
+        <div class="color-scheme-header">
+            <div class="flex items-center justify-between mb-2">
+                <h2 class="color-scheme-title">
+                    <i class="fas fa-palette"></i>
+                    <span v-text="t('colorScheme.title')"></span>
+                </h2>
+                <button @click="closeColorSchemeModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+            <p class="color-scheme-subtitle" v-text="t('colorScheme.subtitle')"></p>
+        </div>
+
+        <div class="color-scheme-body">
+            <div class="color-scheme-section">
+                <h3 class="color-scheme-section-title">
+                    <i :class="isDarkMode ? 'fas fa-moon' : 'fas fa-sun'"></i>
+                    <span v-text="isDarkMode ? t('colorScheme.darkThemes') : t('colorScheme.lightThemes')"></span>
+                </h3>
+                <div class="color-scheme-grid">
+                    <div v-for="scheme in colorSchemes[isDarkMode ? 'dark' : 'light']"
+                         :key="scheme.id"
+                         @click="selectColorScheme(scheme.id)"
+                         :class="['color-scheme-option', currentColorScheme === scheme.id ? 'active' : '']">
+                        <div class="color-scheme-preview">
+                            <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-primary color-scheme-preview-segment`"></div>
+                            <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-secondary color-scheme-preview-segment`"></div>
+                            <div :class="`preview-${isDarkMode ? 'dark-' : ''}${scheme.id}-tertiary color-scheme-preview-segment`"></div>
+                        </div>
+                        <div class="color-scheme-name" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.name')"></div>
+                        <div class="color-scheme-description" v-text="t('colorScheme.themes.' + (isDarkMode ? 'dark' : 'light') + '.' + scheme.id + '.description')"></div>
+                        <div v-if="currentColorScheme === scheme.id" class="color-scheme-check">
+                            <i class="fas fa-check"></i>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <div class="color-scheme-footer">
+            <button @click="resetColorScheme" class="color-scheme-reset-btn">
+                <i class="fas fa-undo mr-2"></i><span v-text="t('colorScheme.resetToDefault')"></span>
+            </button>
+            <button @click="closeColorSchemeModal" class="color-scheme-close-btn" v-text="t('common.close')">
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/customize-summary-prompt-modal.html b/templates/modals/customize-summary-prompt-modal.html
new file mode 100644
index 00000000..fd1f1e91
--- /dev/null
+++ b/templates/modals/customize-summary-prompt-modal.html
@@ -0,0 +1,64 @@
+<!-- Customise Summary Prompt Modal -->
+<div v-if="showCustomizeSummaryModal" @click.self="closeCustomizeSummaryModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-2xl flex flex-col max-h-[85vh]">
+        <div class="p-5 border-b border-[var(--border-primary)] flex-shrink-0 flex justify-between items-center">
+            <div class="flex items-center gap-2">
+                <i class="fas fa-magic text-[var(--text-accent)]"></i>
+                <h3 class="text-lg font-semibold text-[var(--text-primary)]">${ t('customizeSummary.title') }</h3>
+            </div>
+            <button @click="closeCustomizeSummaryModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+
+        <div class="px-6 py-5 overflow-y-auto flex-1 space-y-4">
+            <p class="text-sm text-[var(--text-muted)]">
+                ${ t('customizeSummary.body') }
+            </p>
+
+            <div class="grid grid-cols-2 gap-2 p-1 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-lg">
+                <label
+                    :class="['flex items-start gap-2 p-3 rounded-md cursor-pointer transition-colors', customizeSummaryMode === 'append' ? 'bg-[var(--bg-secondary)] border border-[var(--border-accent)] shadow-sm' : 'border border-transparent hover:bg-[var(--bg-secondary)]']">
+                    <input type="radio" value="append" v-model="customizeSummaryMode" class="mt-1 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] focus:ring-[var(--border-focus)]">
+                    <span class="flex-1">
+                        <span class="block text-sm font-medium text-[var(--text-primary)]">${ t('summaryMode.append') }</span>
+                        <span class="block text-xs text-[var(--text-muted)] mt-0.5">${ t('summaryMode.appendHelp') }</span>
+                    </span>
+                </label>
+                <label
+                    :class="['flex items-start gap-2 p-3 rounded-md cursor-pointer transition-colors', customizeSummaryMode === 'replace' ? 'bg-[var(--bg-secondary)] border border-[var(--border-accent)] shadow-sm' : 'border border-transparent hover:bg-[var(--bg-secondary)]']">
+                    <input type="radio" value="replace" v-model="customizeSummaryMode" class="mt-1 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] focus:ring-[var(--border-focus)]">
+                    <span class="flex-1">
+                        <span class="block text-sm font-medium text-[var(--text-primary)]">${ t('summaryMode.replace') }</span>
+                        <span class="block text-xs text-[var(--text-muted)] mt-0.5">${ t('summaryMode.replaceHelp') }</span>
+                    </span>
+                </label>
+            </div>
+
+            <div>
+                <label class="block text-xs font-medium text-[var(--text-secondary)] mb-1.5 uppercase tracking-wide">
+                    <span v-if="customizeSummaryMode === 'append'">${ t('customizeSummary.additionalContext') }</span>
+                    <span v-else>${ t('customizeSummary.customPrompt') }</span>
+                </label>
+                <textarea
+                    v-model="customizeSummaryPrompt"
+                    rows="10"
+                    :placeholder="customizeSummaryMode === 'append' ? t('customizeSummary.appendPlaceholder') : t('customizeSummary.replacePlaceholder')"
+                    class="w-full px-3 py-2 text-sm bg-[var(--bg-input)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded-md focus:outline-none focus:ring-2 focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] resize-y font-mono"></textarea>
+            </div>
+        </div>
+
+        <div class="bg-[var(--bg-tertiary)] px-6 py-4 flex justify-end gap-3 border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+            <button @click="closeCustomizeSummaryModal"
+                    class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                ${ t('buttons.cancel') }
+            </button>
+            <button @click="submitCustomizeSummaryModal"
+                    :disabled="!customizeSummaryPrompt.trim()"
+                    :class="['px-4 py-2 rounded-lg flex items-center gap-2 transition-all', customizeSummaryPrompt.trim() ? 'bg-gradient-to-r from-blue-600 to-purple-600 text-white hover:shadow-md hover:from-blue-700 hover:to-purple-700' : 'bg-[var(--bg-secondary)] text-[var(--text-muted)] border border-[var(--border-secondary)] cursor-not-allowed']">
+                <i class="fas fa-magic text-xs"></i>
+                <span>${ t('customizeSummary.generateSummary') }</span>
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/datetime-picker-modal.html b/templates/modals/datetime-picker-modal.html
new file mode 100644
index 00000000..da79bbfa
--- /dev/null
+++ b/templates/modals/datetime-picker-modal.html
@@ -0,0 +1,132 @@
+<!-- DateTime Picker Modal -->
+<div v-if="showDateTimePicker" @click.self="closeDateTimePicker" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-sm overflow-hidden">
+        <!-- Header -->
+        <div class="p-4 border-b border-[var(--border-primary)] bg-[var(--bg-tertiary)]">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold text-[var(--text-primary)]">
+                    <i class="fas fa-calendar-alt mr-2 text-[var(--text-accent)]"></i>
+                    Select Date & Time
+                </h3>
+                <button @click="closeDateTimePicker" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors p-1">
+                    <i class="fas fa-times text-lg"></i>
+                </button>
+            </div>
+        </div>
+
+        <!-- Calendar Section -->
+        <div class="p-4">
+            <!-- Month/Year Navigation -->
+            <div class="flex items-center justify-between mb-4">
+                <button @click="prevMonth" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-chevron-left"></i>
+                </button>
+                <div class="flex items-center gap-2">
+                    <select v-model="pickerMonth" @change="updatePickerView"
+                            class="pl-3 pr-8 py-1.5 border border-[var(--border-secondary)] rounded-lg text-sm bg-[var(--bg-input)] text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        <option v-for="(month, index) in monthNames" :key="index" :value="index">${month}</option>
+                    </select>
+                    <select v-model="pickerYear" @change="updatePickerView"
+                            class="pl-3 pr-8 py-1.5 border border-[var(--border-secondary)] rounded-lg text-sm bg-[var(--bg-input)] text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        <option v-for="year in availableYears" :key="year" :value="year">${year}</option>
+                    </select>
+                </div>
+                <button @click="nextMonth" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-chevron-right"></i>
+                </button>
+            </div>
+
+            <!-- Day Names Header -->
+            <div class="grid grid-cols-7 gap-1 mb-2">
+                <div v-for="day in dayNames" :key="day" class="text-center text-xs font-medium text-[var(--text-muted)] py-1">
+                    ${day}
+                </div>
+            </div>
+
+            <!-- Calendar Grid -->
+            <div class="grid grid-cols-7 gap-1">
+                <button v-for="(day, index) in calendarDays" :key="index"
+                        @click="day.inMonth ? selectDate(day.date) : null"
+                        :disabled="!day.inMonth"
+                        :class="[
+                            'aspect-square flex items-center justify-center rounded-lg text-sm transition-all',
+                            day.inMonth ? 'hover:bg-[var(--bg-tertiary)]' : 'opacity-30 cursor-default',
+                            day.isSelected ? 'bg-[var(--text-accent)] text-white font-bold' : '',
+                            day.isToday && !day.isSelected ? 'ring-2 ring-[var(--text-accent)] ring-inset' : '',
+                            day.inMonth && !day.isSelected ? 'text-[var(--text-primary)]' : ''
+                        ]">
+                    ${day.day}
+                </button>
+            </div>
+
+            <!-- Time Selection -->
+            <div class="mt-4 pt-4 border-t border-[var(--border-secondary)]">
+                <label class="block text-sm font-medium text-[var(--text-muted)] mb-2">
+                    <i class="fas fa-clock mr-1"></i> Time
+                </label>
+                <div class="flex items-center justify-center gap-2">
+                    <select v-model="pickerHour"
+                            class="pl-3 pr-8 py-2 border border-[var(--border-secondary)] rounded-lg bg-[var(--bg-input)] text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        <option v-for="h in hours12" :key="h.value" :value="h.value">${h.label}</option>
+                    </select>
+                    <span class="text-xl font-bold text-[var(--text-muted)]">:</span>
+                    <select v-model="pickerMinute"
+                            class="pl-3 pr-8 py-2 border border-[var(--border-secondary)] rounded-lg bg-[var(--bg-input)] text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        <option v-for="m in minutes" :key="m" :value="m">${m.toString().padStart(2, '0')}</option>
+                    </select>
+                    <select v-model="pickerAmPm"
+                            class="pl-3 pr-8 py-2 border border-[var(--border-secondary)] rounded-lg bg-[var(--bg-input)] text-[var(--text-primary)] focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                        <option value="AM">AM</option>
+                        <option value="PM">PM</option>
+                    </select>
+                </div>
+            </div>
+
+            <!-- Quick Time Presets -->
+            <div class="mt-3 flex flex-wrap gap-1.5 justify-center">
+                <button @click="pickerHour = 9; pickerMinute = 0; pickerAmPm = 'AM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">9 AM</button>
+                <button @click="pickerHour = 10; pickerMinute = 0; pickerAmPm = 'AM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">10 AM</button>
+                <button @click="pickerHour = 11; pickerMinute = 0; pickerAmPm = 'AM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">11 AM</button>
+                <button @click="pickerHour = 12; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">12 PM</button>
+                <button @click="pickerHour = 1; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">1 PM</button>
+                <button @click="pickerHour = 2; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">2 PM</button>
+                <button @click="pickerHour = 3; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">3 PM</button>
+                <button @click="pickerHour = 4; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">4 PM</button>
+                <button @click="pickerHour = 5; pickerMinute = 0; pickerAmPm = 'PM'" class="px-2 py-1 text-xs bg-[var(--bg-tertiary)] text-[var(--text-muted)] rounded hover:bg-[var(--bg-input)] hover:text-[var(--text-primary)] transition-colors">5 PM</button>
+            </div>
+
+            <!-- Quick Actions -->
+            <div class="mt-3 flex flex-wrap gap-2 justify-center">
+                <button @click="setToNow" class="px-3 py-1.5 text-xs bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-lg hover:bg-[var(--bg-input)] transition-colors">
+                    <i class="fas fa-bolt mr-1"></i> Now
+                </button>
+                <button @click="setToToday" class="px-3 py-1.5 text-xs bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-lg hover:bg-[var(--bg-input)] transition-colors">
+                    <i class="fas fa-calendar-day mr-1"></i> Today
+                </button>
+                <button @click="clearDateTime" class="px-3 py-1.5 text-xs bg-[var(--bg-tertiary)] text-[var(--text-secondary)] rounded-lg hover:bg-[var(--bg-input)] transition-colors">
+                    <i class="fas fa-eraser mr-1"></i> Clear
+                </button>
+            </div>
+        </div>
+
+        <!-- Footer -->
+        <div class="p-4 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)]">
+            <div class="text-sm text-[var(--text-muted)] mb-3 text-center">
+                <span v-if="pickerSelectedDate" class="font-medium text-[var(--text-primary)]">
+                    ${formatPickerPreview()}
+                </span>
+                <span v-else class="italic">No date selected</span>
+            </div>
+            <div class="flex gap-2 justify-end">
+                <button @click="closeDateTimePicker"
+                        class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-secondary)] rounded-lg transition-colors">
+                    Cancel
+                </button>
+                <button @click="applyDateTime"
+                        class="px-4 py-2 bg-[var(--text-accent)] text-white rounded-lg hover:opacity-90 transition-opacity font-medium whitespace-nowrap">
+                    <i class="fas fa-check mr-1"></i>Apply
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/delete-modal.html b/templates/modals/delete-modal.html
new file mode 100644
index 00000000..679d1e78
--- /dev/null
+++ b/templates/modals/delete-modal.html
@@ -0,0 +1,32 @@
+<!-- Delete Confirmation Modal -->
+<div v-if="showDeleteModal" @click.self="cancelDelete" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-md">
+        <div class="p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="flex items-center gap-4">
+                    <i class="fas fa-exclamation-triangle text-3xl text-[var(--text-danger)]"></i>
+                    <div>
+                        <h3 class="text-lg font-semibold" v-text="t('modal.deleteRecording')"></h3>
+                        <p class="text-[var(--text-muted)]" v-text="t('help.thisActionCannotBeUndone')"></p>
+                    </div>
+                </div>
+                <button @click="cancelDelete" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+            <p class="text-[var(--text-secondary)] mb-6">
+                Are you sure you want to delete "${recordingToDelete?.title || 'this recording'}"?
+            </p>
+            <div class="flex justify-end gap-3">
+                <button @click="cancelDelete"
+                        class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                    Cancel
+                </button>
+                <button @click="deleteRecording"
+                        class="px-4 py-2 bg-[var(--bg-danger)] text-white rounded-lg hover:bg-[var(--bg-danger-hover)] transition-colors">
+                    Delete
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/duplicates-modal.html b/templates/modals/duplicates-modal.html
new file mode 100644
index 00000000..fb035a1f
--- /dev/null
+++ b/templates/modals/duplicates-modal.html
@@ -0,0 +1,40 @@
+<!-- Duplicates List Modal -->
+<div v-if="showDuplicatesModal && duplicatesModalData" @click.self="showDuplicatesModal = false" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-sm">
+        <div class="p-5">
+            <div class="flex items-center justify-between mb-4">
+                <div class="flex items-center gap-2.5">
+                    <div class="flex items-center justify-center h-9 w-9 rounded-full bg-amber-100 dark:bg-amber-900/50">
+                        <i class="fas fa-copy text-amber-500 dark:text-amber-400"></i>
+                    </div>
+                    <h3 class="text-base font-semibold text-[var(--text-primary)]">
+                        ${ duplicatesModalData.total_copies } ${ t('upload.copies') || 'copies' }
+                    </h3>
+                </div>
+                <button @click="showDuplicatesModal = false" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+            <div class="space-y-1">
+                <button v-for="copy in duplicatesModalData.copies" :key="copy.id"
+                        @click="navigateToDuplicate(copy.id)"
+                        class="w-full flex items-center gap-3 px-3 py-2.5 rounded-lg text-left transition-colors"
+                        :class="copy.is_self
+                            ? 'bg-[var(--bg-accent-light)] border border-[var(--border-focus)]'
+                            : 'hover:bg-[var(--bg-tertiary)]'">
+                    <i class="fas fa-file-audio text-sm flex-shrink-0"
+                       :class="copy.is_self ? 'text-[var(--text-accent)]' : 'text-[var(--text-muted)]'"></i>
+                    <div class="min-w-0 flex-1">
+                        <div class="text-sm font-medium truncate"
+                             :class="copy.is_self ? 'text-[var(--text-accent)]' : 'text-[var(--text-primary)]'">
+                            ${ copy.title }
+                            <span v-if="copy.is_self" class="text-xs font-normal text-[var(--text-muted)] ml-1">(current)</span>
+                        </div>
+                        <div class="text-xs text-[var(--text-muted)]">${ copy.created_at }</div>
+                    </div>
+                    <i v-if="!copy.is_self" class="fas fa-chevron-right text-xs text-[var(--text-muted)]"></i>
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/edit-modal.html b/templates/modals/edit-modal.html
new file mode 100644
index 00000000..e9a53f47
--- /dev/null
+++ b/templates/modals/edit-modal.html
@@ -0,0 +1,50 @@
+<!-- Edit Modal -->
+<div v-if="showEditModal" @click.self="cancelEdit" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-lg">
+        <div class="p-6 border-b border-[var(--border-primary)] flex items-center justify-between">
+            <h3 class="text-lg font-semibold" v-text="t('modal.editRecording')"></h3>
+            <button @click="cancelEdit" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                <i class="fas fa-times text-xl"></i>
+            </button>
+        </div>
+        <div class="p-6 space-y-4">
+            <div>
+                <label class="block text-sm font-medium mb-2" v-text="t('form.title')"></label>
+                <input v-model="editingRecording.title"
+                       class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+            </div>
+            <div>
+                <label class="block text-sm font-medium mb-2" v-text="t('form.participants')"></label>
+                <input v-model="editingRecording.participants"
+                       class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+            </div>
+            <div>
+                <label class="block text-sm font-medium mb-2" v-text="t('form.meetingDate')"></label>
+                <div @click="openDateTimePicker('edit_modal_meeting_date', editingRecording.meeting_date, (isoString) => { editingRecording.meeting_date = isoString; })"
+                     class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg cursor-pointer hover:border-[var(--border-focus)] transition-colors flex items-center justify-between">
+                    <span :class="editingRecording.meeting_date ? 'text-[var(--text-primary)]' : 'text-[var(--text-muted)]'">
+                        ${editingRecording.meeting_date ? formatDisplayDate(editingRecording.meeting_date) : 'Select date and time...'}
+                    </span>
+                    <i class="fas fa-calendar-alt text-[var(--text-muted)]"></i>
+                </div>
+            </div>
+            <div>
+                <label class="block text-sm font-medium mb-2" v-text="t('form.notes')"></label>
+                <textarea v-model="editingRecording.notes"
+                          rows="4"
+                          class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                </textarea>
+            </div>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+            <button @click="cancelEdit"
+                    class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="saveEdit"
+                    class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                Save Changes
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/edit-participants-modal.html b/templates/modals/edit-participants-modal.html
new file mode 100644
index 00000000..e38cd863
--- /dev/null
+++ b/templates/modals/edit-participants-modal.html
@@ -0,0 +1,61 @@
+<!-- Edit Participants Modal -->
+<div v-if="showEditParticipantsModal" @click.self="closeEditParticipantsModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div @click="closeAllParticipantSuggestions" class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[80vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold" v-text="t('modal.editParticipants')"></h3>
+                <button @click="closeEditParticipantsModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6 overflow-y-auto flex-1" @scroll="closeAllParticipantSuggestions">
+            <p class="text-sm text-[var(--text-muted)] mb-4">Manage participants for this recording.</p>
+
+            <div class="space-y-2">
+                <div v-for="(participant, index) in editingParticipantsList" :key="index" class="relative">
+                    <div class="flex items-center gap-2">
+                        <div class="flex-1 relative" @click.stop>
+                            <input v-model="participant.name"
+                                   @input="filterParticipantSuggestions(index)"
+                                   @focus="filterParticipantSuggestions(index)"
+                                   @blur="closeParticipantSuggestionsDelayed(index)"
+                                   type="text"
+                                   class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm"
+                                   placeholder="Participant name...">
+                        </div>
+                        <!-- Teleported Suggestions dropdown -->
+                        <teleport to="body">
+                            <div v-if="editingParticipantSuggestions[index]?.length > 0"
+                                 class="fixed z-[100] bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg max-h-32 overflow-y-auto"
+                                 :style="getParticipantDropdownPosition(index)">
+                                <button v-for="suggestion in editingParticipantSuggestions[index]" :key="suggestion"
+                                        @mousedown="selectParticipantSuggestion(index, suggestion)"
+                                        class="w-full px-3 py-2 text-left hover:bg-[var(--bg-tertiary)] transition-colors text-sm">
+                                    ${suggestion}
+                                </button>
+                            </div>
+                        </teleport>
+                        <button @click="removeParticipant(index)"
+                                class="p-1 text-[var(--text-muted)] hover:text-red-500 transition-colors">
+                            <i class="fas fa-times"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <button @click="addParticipant"
+                    class="mt-4 w-full px-3 py-2 border border-dashed border-[var(--border-secondary)] rounded-lg text-sm text-[var(--text-muted)] hover:border-[var(--border-accent)] hover:text-[var(--text-accent)] transition-colors">
+                <i class="fas fa-plus mr-2"></i>Add Participant
+            </button>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+            <button @click="closeEditParticipantsModal" class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="saveParticipants" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                Save Changes
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/edit-speakers-modal.html b/templates/modals/edit-speakers-modal.html
new file mode 100644
index 00000000..4a150c5b
--- /dev/null
+++ b/templates/modals/edit-speakers-modal.html
@@ -0,0 +1,63 @@
+<!-- Edit Speakers Modal -->
+<div v-if="showEditSpeakersModal" @click.self="closeEditSpeakersModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[80vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold" v-text="t('modal.editSpeakers')"></h3>
+                <button @click="closeEditSpeakersModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6 overflow-y-auto flex-1">
+            <p class="text-sm text-[var(--text-muted)] mb-4">Rename speakers in the transcript.</p>
+
+            <div class="space-y-3">
+                <div v-for="(speaker, index) in editingSpeakersList" :key="index" class="relative">
+                    <div class="flex items-center gap-2">
+                        <span class="w-24 text-sm text-[var(--text-muted)] truncate">${speaker.original || 'New'}</span>
+                        <i class="fas fa-arrow-right text-[var(--text-muted)]"></i>
+                        <div class="flex-1 relative" :ref="'editSpeakerInput' + index">
+                            <input v-model="speaker.current"
+                                   @input="filterEditingSpeakerSuggestions(index)"
+                                   @focus="filterEditingSpeakerSuggestions(index)"
+                                   @blur="onEditSpeakerBlur(index)"
+                                   type="text"
+                                   class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] text-sm"
+                                   placeholder="New name...">
+                        </div>
+                        <!-- Teleported Suggestions dropdown -->
+                        <teleport to="body">
+                            <div v-if="editingSpeakerSuggestions[index]?.length > 0"
+                                 class="fixed z-[100] bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-lg shadow-lg max-h-32 overflow-y-auto"
+                                 :style="getEditSpeakerDropdownPosition(index)">
+                                <button v-for="suggestion in editingSpeakerSuggestions[index]" :key="suggestion.id"
+                                        @mousedown="selectEditingSpeakerSuggestion(index, suggestion.name)"
+                                        class="w-full px-3 py-2 text-left hover:bg-[var(--bg-tertiary)] transition-colors text-sm">
+                                    ${suggestion.name}
+                                </button>
+                            </div>
+                        </teleport>
+                        <button @click="removeEditingSpeaker(index)"
+                                class="p-1 text-[var(--text-muted)] hover:text-red-500 transition-colors">
+                            <i class="fas fa-times"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <button @click="addEditingSpeaker"
+                    class="mt-4 w-full px-3 py-2 border border-dashed border-[var(--border-secondary)] rounded-lg text-sm text-[var(--text-muted)] hover:border-[var(--border-accent)] hover:text-[var(--text-accent)] transition-colors">
+                <i class="fas fa-plus mr-2"></i>Add Speaker
+            </button>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+            <button @click="closeEditSpeakersModal" class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="saveEditingSpeakers" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                Save Changes
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/edit-tags-modal.html b/templates/modals/edit-tags-modal.html
new file mode 100644
index 00000000..b359596d
--- /dev/null
+++ b/templates/modals/edit-tags-modal.html
@@ -0,0 +1,85 @@
+<!-- Edit Tags Modal -->
+<div v-if="showEditTagsModal" @click.self="closeEditTagsModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[80vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold" v-text="t('modal.editTags')"></h3>
+                <button @click="closeEditTagsModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6 overflow-y-auto flex-1">
+            <!-- Current Tags with Drag Reorder -->
+            <div class="mb-4">
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2" v-text="t('tags.currentTags')"></label>
+                <div v-if="editingRecording && editingRecording.tags && editingRecording.tags.length > 0"
+                     class="flex flex-wrap gap-2"
+                     @touchmove="handleModalTagTouchMove">
+                    <span v-for="(tag, index) in editingRecording.tags" :key="tag.id"
+                          :data-modal-tag-index="index"
+                          draggable="true"
+                          @dragstart="handleModalTagDragStart(index, $event)"
+                          @dragover="handleModalTagDragOver(index, $event)"
+                          @drop="handleModalTagDrop(index, $event)"
+                          @dragend="handleModalTagDragEnd"
+                          @touchstart="handleModalTagTouchStart(index, $event)"
+                          @touchend="handleModalTagTouchEnd"
+                          :class="[
+                              'inline-flex items-center px-3 py-1 rounded-full text-sm font-medium transition-all duration-150',
+                              modalDraggedTagIndex === index ? 'opacity-50 cursor-grabbing' : 'cursor-grab',
+                              modalDragOverTagIndex === index && modalDraggedTagIndex !== index ? 'ring-2 ring-[var(--ring-focus)] ring-offset-1' : ''
+                          ]"
+                          :style="{ backgroundColor: tag.color, color: getContrastTextColor(tag.color) }"
+                          :title="(tag.group_id ? ('Group: ' + tag.group_name) : tag.name) + ' (drag to reorder)'">
+                        <span class="opacity-75 mr-1 text-xs">${index + 1}.</span>
+                        <i v-if="tag.group_id" class="fas fa-users mr-1.5 text-xs"></i>
+                        <span v-if="tag.group_id" class="opacity-75">${ tag.group_name }: </span>${ tag.name }
+                        <button @click.stop="removeTagFromRecording(tag.id)" class="ml-2 hover:opacity-80">
+                            <i class="fas fa-times text-xs"></i>
+                        </button>
+                    </span>
+                </div>
+                <p v-else class="text-sm text-[var(--text-muted)] italic" v-text="t('tags.noTags')"></p>
+                <p v-if="editingRecording && editingRecording.tags && editingRecording.tags.length > 1" class="text-xs text-[var(--text-muted)] mt-2">
+                    <i class="fas fa-grip-vertical mr-1" style="font-size: 10px;"></i>
+                    Drag to reorder &bull; First tag's defaults are applied
+                </p>
+            </div>
+
+            <!-- Add Tags -->
+            <div>
+                <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2" v-text="t('tags.addTag')"></label>
+
+                <!-- Search -->
+                <div class="relative mb-3">
+                    <input v-model="tagSearchFilter" type="text" :placeholder="t('tagsModal.searchTags')"
+                           class="w-full px-3 py-2 pl-9 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                    <i class="fas fa-search absolute left-3 top-1/2 transform -translate-y-1/2 text-[var(--text-muted)]"></i>
+                </div>
+
+                <!-- Available Tags -->
+                <div class="max-h-48 overflow-y-auto space-y-2">
+                    <button v-for="tag in filteredAvailableTagsForModal" :key="tag.id"
+                            @click="addTagToRecording(tag.id)"
+                            class="w-full flex items-center justify-between px-3 py-2 rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                        <div class="flex items-center gap-2">
+                            <i v-if="tag.group_id" class="fas fa-users text-xs flex-shrink-0" :style="{ color: tag.color }"></i>
+                            <span v-else class="w-3 h-3 rounded-full flex-shrink-0" :style="{ backgroundColor: tag.color }"></span>
+                            <span class="text-sm">
+                                <span v-if="tag.group_id" class="opacity-75">${ tag.group_name }: </span>${ tag.name }
+                            </span>
+                        </div>
+                        <i class="fas fa-plus text-[var(--text-muted)]"></i>
+                    </button>
+                </div>
+                <p v-if="filteredAvailableTagsForModal.length === 0" class="text-sm text-[var(--text-muted)] text-center py-4" v-text="t('tags.noAvailableTags')"></p>
+            </div>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end">
+            <button @click="closeEditTagsModal" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                <span v-text="t('tagsModal.done')"></span>
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/edit-text-modal.html b/templates/modals/edit-text-modal.html
new file mode 100644
index 00000000..e4bf55d6
--- /dev/null
+++ b/templates/modals/edit-text-modal.html
@@ -0,0 +1,38 @@
+<!-- Edit Text Modal -->
+<div v-if="showEditTextModal" @click.self="closeEditTextModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-2xl">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <h3 class="text-xl font-bold text-[var(--text-primary)]">Edit Transcript Text</h3>
+                <button @click="closeEditTextModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6">
+
+        <!-- Text editor -->
+        <div class="mb-6">
+            <label class="block text-sm font-medium text-[var(--text-secondary)] mb-2">
+                Text Content
+            </label>
+            <textarea
+                v-model="editedText"
+                rows="6"
+                class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] resize-y"
+                placeholder="Enter transcript text..."
+            ></textarea>
+        </div>
+
+        <!-- Action buttons -->
+        <div class="flex justify-end space-x-3">
+            <button @click="closeEditTextModal" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors">
+                Cancel
+            </button>
+            <button @click="saveEditedText" class="px-4 py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors">
+                Save Changes
+            </button>
+        </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/global-error.html b/templates/modals/global-error.html
new file mode 100644
index 00000000..5126bc06
--- /dev/null
+++ b/templates/modals/global-error.html
@@ -0,0 +1,18 @@
+<!-- Global Error Display - DEPRECATED: Now using toast system for all errors -->
+<!-- Keeping this commented out in case we need to revert
+<div v-if="globalError"
+     class="fixed top-4 right-4 text-white p-4 rounded-lg shadow-lg z-[60] max-w-md border"
+     style="background-color: #ef4444; border-color: #dc2626;">
+    <div class="flex items-start gap-3">
+        <i class="fas fa-exclamation-circle text-xl flex-shrink-0 mt-0.5"></i>
+        <div class="flex-1">
+            <p class="font-semibold mb-1" v-text="t('common.error')"></p>
+            <p class="text-sm">${globalError}</p>
+        </div>
+        <button @click="globalError = null"
+                class="text-white hover:opacity-80 transition-opacity flex-shrink-0">
+            <i class="fas fa-times"></i>
+        </button>
+    </div>
+</div>
+-->
diff --git a/templates/modals/recording-disclaimer-modal.html b/templates/modals/recording-disclaimer-modal.html
new file mode 100644
index 00000000..bbed85f4
--- /dev/null
+++ b/templates/modals/recording-disclaimer-modal.html
@@ -0,0 +1,36 @@
+<!-- Recording Disclaimer Modal -->
+<div v-if="showRecordingDisclaimerModal" @click.self="cancelRecordingDisclaimer" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col overflow-hidden">
+        <div class="flex-shrink-0 p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <i class="fas fa-info-circle text-2xl text-[var(--text-accent)]"></i>
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]" v-text="t('modal.recordingNotice')"></h3>
+                </div>
+                <button @click="cancelRecordingDisclaimer" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="flex-1 overflow-y-auto p-6">
+            <!-- Render markdown content -->
+            <div class="ai-message text-[var(--text-secondary)]"
+                 style="line-height: 1.6;">
+                <div v-html="recordingDisclaimerHtml"></div>
+            </div>
+        </div>
+        <div class="flex-shrink-0 p-6 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)] rounded-b-lg">
+            <div class="flex justify-end gap-3">
+                <button @click="cancelRecordingDisclaimer"
+                        class="px-6 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-secondary)] rounded-lg transition-colors border border-[var(--border-secondary)]">
+                    Cancel
+                </button>
+                <button @click="acceptRecordingDisclaimer"
+                        class="px-6 py-2 bg-[var(--bg-accent)] text-white rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors">
+                    <i class="fas fa-microphone mr-2"></i>
+                    Start Recording
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/recording-recovery-modal.html b/templates/modals/recording-recovery-modal.html
new file mode 100644
index 00000000..4007b2c7
--- /dev/null
+++ b/templates/modals/recording-recovery-modal.html
@@ -0,0 +1,64 @@
+<!-- Recording Recovery Modal -->
+<div v-if="showRecoveryModal" @click.self="cancelRecovery" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[85vh] overflow-y-auto">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <i class="fas fa-history text-2xl text-blue-500"></i>
+                    <h3 class="text-lg font-semibold" v-text="t('recording.recoveryTitle')"></h3>
+                </div>
+                <button @click="cancelRecovery" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <div class="p-6 space-y-4">
+            <div class="p-4 bg-blue-50 dark:bg-blue-900/20 border border-blue-200 dark:border-blue-800 rounded-lg">
+                <div class="flex items-start gap-3">
+                    <i class="fas fa-info-circle text-blue-600 dark:text-blue-400 mt-0.5"></i>
+                    <div class="text-sm text-blue-700 dark:text-blue-400">
+                        <p class="font-medium mb-1">${ t('recording.recoveryFound') }</p>
+                        <p>${ t('recording.recoveryDescription') }</p>
+                    </div>
+                </div>
+            </div>
+
+            <div v-if="recoverableRecording" class="space-y-2 text-sm">
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">${ t('recording.recordingMode') }:</span>
+                    <span class="font-medium">${ formatRecordingMode(recoverableRecording.mode) }</span>
+                </div>
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">${ t('recording.duration') }:</span>
+                    <span class="font-medium">${ formatTime(recoverableRecording.duration) }</span>
+                </div>
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">${ t('recording.size') }:</span>
+                    <span class="font-medium">${ formatFileSize(recoverableRecording.totalSize) }</span>
+                </div>
+                <div class="flex justify-between">
+                    <span class="text-[var(--text-muted)]">${ t('recording.startedAt') }:</span>
+                    <span class="font-medium">${ formatDateTime(recoverableRecording.startTime) }</span>
+                </div>
+                <div v-if="recoverableRecording.notes" class="pt-2 border-t border-[var(--border-secondary)]">
+                    <span class="text-[var(--text-muted)]">${ t('recording.notes') }:</span>
+                    <p class="mt-1 text-[var(--text-primary)] max-h-32 overflow-y-auto text-xs whitespace-pre-wrap">${ recoverableRecording.notes }</p>
+                </div>
+            </div>
+        </div>
+
+        <div class="p-6 border-t border-[var(--border-primary)] flex gap-3">
+            <button
+                @click="cancelRecovery"
+                class="flex-1 px-4 py-2.5 bg-[var(--bg-tertiary)] text-[var(--text-primary)] rounded-lg hover:bg-[var(--bg-hover)] transition-colors font-medium">
+                <i class="fas fa-trash mr-2"></i>${ t('recording.discardRecovery') }
+            </button>
+            <button
+                @click="recoverRecording"
+                class="flex-1 px-4 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors font-medium">
+                <i class="fas fa-undo mr-2"></i>${ t('recording.restoreRecording') }
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/reprocess-modal.html b/templates/modals/reprocess-modal.html
new file mode 100644
index 00000000..b1272c9c
--- /dev/null
+++ b/templates/modals/reprocess-modal.html
@@ -0,0 +1,276 @@
+<!-- Reprocess Modal -->
+<div v-if="showReprocessModal" @click.self="cancelReprocess" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm transition-all duration-300 ease-in-out">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md max-h-[90vh] flex flex-col transform transition-all duration-300 ease-in-out">
+        <!-- Header with gradient background -->
+        <div class="bg-gradient-to-r from-[var(--bg-accent)] to-[var(--bg-secondary)] p-5 rounded-t-xl flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center">
+                    <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center mr-4 shadow-lg">
+                        <i class="fas fa-sync-alt text-white text-lg"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-xl font-bold text-[var(--text-primary)] mb-1" v-text="t('help.confirmReprocessingTitle')"></h3>
+                        <p class="text-sm text-[var(--text-muted)] capitalize">${ reprocessType } reprocessing</p>
+                    </div>
+                </div>
+                <button @click="cancelReprocess" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <!-- Content -->
+        <div class="p-6 modal-content overflow-y-auto flex-1">
+            <div v-if="reprocessRecording" class="mb-6">
+                <div class="bg-[var(--bg-tertiary)] rounded-lg p-4 border border-[var(--border-primary)]">
+                    <div class="flex items-start space-x-3">
+                        <i class="fas fa-file-audio text-[var(--text-accent)] mt-1"></i>
+                        <div class="flex-1 min-w-0">
+                            <h4 class="font-medium text-[var(--text-primary)] truncate" :title="reprocessRecording.title">
+                                ${ reprocessRecording.title || 'Untitled Recording' }
+                            </h4>
+                            <p class="text-sm text-[var(--text-muted)] mt-1">
+                                Created: ${ new Date(reprocessRecording.created_at).toLocaleDateString() }
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <div class="space-y-4">
+                <div class="flex items-start space-x-3">
+                    <div class="w-6 h-6 bg-amber-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-exclamation-triangle text-amber-600 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.whatWillHappen')"></p>
+                        <p class="text-sm text-[var(--text-muted)]" v-if="reprocessType === 'transcription' && !connectorSupportsDiarization">
+                            <span v-text="t('reprocessModal.audioReTranscribedFromScratch')"></span>
+                        </p>
+                        <p class="text-sm text-[var(--text-muted)]" v-else-if="reprocessType === 'transcription' && connectorSupportsDiarization">
+                            <span v-text="t('reprocessModal.audioReTranscribedWithAsr')"></span>
+                        </p>
+                        <p class="text-sm text-[var(--text-muted)]" v-else-if="reprocessType === 'summary'">
+                            <span v-text="t('reprocessModal.newTitleAndSummary')"></span>
+                        </p>
+                    </div>
+                </div>
+
+                <!-- Language Selection - show for all transcription reprocessing -->
+                <div v-if="reprocessType === 'transcription'" class="space-y-4 pt-4 border-t border-[var(--border-primary)]">
+                    <div>
+                        <label for="asr-language-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.language')"></label>
+                        <select id="asr-language-reprocess" v-model="asrReprocessOptions.language" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option v-for="lang in languageOptions" :key="lang.value" :value="lang.value" v-text="lang.label"></option>
+                        </select>
+                    </div>
+                </div>
+
+                <!-- Advanced Options for diarization-enabled connectors -->
+                <div v-if="reprocessType === 'transcription' && connectorSupportsDiarization" class="space-y-4 pt-4 border-t border-[var(--border-primary)]">
+                    <h4 class="text-md font-semibold text-[var(--text-secondary)]" v-text="t('help.advancedAsrOptions')"></h4>
+                    <!-- Min/Max Speakers - only for connectors that accept speaker count (e.g. ASR endpoint, not OpenAI) -->
+                    <template v-if="connectorSupportsSpeakerCount">
+                        <div>
+                            <label for="asr-min-speakers-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.minSpeakers')"></label>
+                            <input type="number" id="asr-min-speakers-reprocess" v-model.number="asrReprocessOptions.min_speakers" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" :placeholder="t('form.optional')">
+                        </div>
+                        <div>
+                            <label for="asr-max-speakers-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.maxSpeakers')"></label>
+                            <input type="number" id="asr-max-speakers-reprocess" v-model.number="asrReprocessOptions.max_speakers" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" :placeholder="t('form.optional')">
+                        </div>
+                    </template>
+                    <div v-if="connectorSupportsHotwords">
+                        <label for="asr-hotwords-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.hotwords')"></label>
+                        <input type="text" id="asr-hotwords-reprocess" v-model="asrReprocessOptions.hotwords" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" :placeholder="t('form.hotwordsPlaceholder')">
+                        <p class="text-[10px] text-[var(--text-muted)] mt-0.5" v-text="t('form.hotwordsHelp')"></p>
+                    </div>
+                    <div v-if="connectorSupportsInitialPrompt">
+                        <label for="asr-initial-prompt-reprocess" class="block text-sm font-medium text-[var(--text-muted)]" v-text="t('form.initialPrompt')"></label>
+                        <textarea id="asr-initial-prompt-reprocess" v-model="asrReprocessOptions.initial_prompt" rows="2" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)] resize-y" :placeholder="t('form.initialPromptPlaceholder')"></textarea>
+                        <p class="text-[10px] text-[var(--text-muted)] mt-0.5" v-text="t('form.initialPromptHelp')"></p>
+                    </div>
+                    <!-- Per-reprocess transcription model (issue #266).
+                         Only show when there are at least 2 visible models; a single
+                         visible model means there is no real choice to offer. -->
+                    <div v-if="transcriptionModelOptions && transcriptionModelOptions.length > 1">
+                        <label for="asr-model-reprocess" class="block text-sm font-medium text-[var(--text-muted)]">${ t('form.transcriptionModel') }</label>
+                        <select id="asr-model-reprocess" v-model="asrReprocessOptions.transcription_model" class="mt-1 block w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] sm:text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">${ t('form.useResolvedDefault') }</option>
+                            <option v-for="opt in transcriptionModelOptions" :key="opt.value" :value="opt.value" v-text="opt.label || opt.value"></option>
+                        </select>
+                    </div>
+                </div>
+
+                <!-- Prompt Template Variables -->
+                <div v-if="reprocessType === 'summary' && reprocessAvailableVariables.length > 0" class="space-y-3 pt-4 border-t border-[var(--border-primary)]">
+                    <h4 class="text-md font-semibold text-[var(--text-secondary)] flex items-center gap-2">
+                        <i class="fas fa-keyboard text-[var(--text-muted)] text-xs"></i>
+                        ${ t('promptVariables.title') }
+                        <details class="relative">
+                            <summary
+                                :title="t('promptVariables.infoTooltip')"
+                                class="list-none cursor-pointer text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors">
+                                <i class="fas fa-info-circle text-xs"></i>
+                            </summary>
+                            <div class="absolute left-0 top-full mt-1 z-20 w-64 p-3 text-[11px] font-normal text-[var(--text-secondary)] leading-snug bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg">
+                                ${ t('promptVariables.hintReprocess') }
+                            </div>
+                        </details>
+                    </h4>
+                    <div v-for="variable in reprocessAvailableVariables" :key="variable.name" class="space-y-1">
+                        <label class="block text-xs font-medium text-[var(--text-secondary)]" :for="'rpv-' + variable.name">
+                            ${ variable.label }
+                            <span class="ml-1 text-[10px] text-[var(--text-muted)] font-normal">
+                                <span v-for="(src, i) in variable.sources" :key="i">
+                                    <span v-if="i > 0">, </span>
+                                    <i :class="{
+                                        'fas fa-folder': src.type === 'folder',
+                                        'fas fa-tag': src.type === 'tag',
+                                        'fas fa-user': src.type === 'user',
+                                        'fas fa-cog': src.type === 'admin'
+                                    }" class="mr-0.5"></i>${ src.name }
+                                </span>
+                            </span>
+                        </label>
+                        <textarea
+                            :id="'rpv-' + variable.name"
+                            :value="reprocessPromptVariables[variable.name] || ''"
+                            @input="reprocessPromptVariables[variable.name] = $event.target.value"
+                            rows="2"
+                            maxlength="8000"
+                            :placeholder="t('promptVariables.placeholderPrefix') + ' ' + variable.label.toLowerCase() + '...'"
+                            class="w-full px-2 py-1 text-sm bg-[var(--bg-input)] text-[var(--text-primary)] border border-[var(--border-secondary)] rounded focus:outline-none focus:ring-1 focus:ring-[var(--border-focus)] resize-y font-mono"></textarea>
+                        <div class="flex justify-end text-[10px] text-[var(--text-muted)] font-mono">
+                            ${ (reprocessPromptVariables[variable.name] || '').length } / 8000
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Custom Prompt Options for Summary Reprocessing -->
+                <div v-if="reprocessType === 'summary'" class="space-y-4 pt-4 border-t border-[var(--border-primary)]">
+                    <h4 class="text-md font-semibold text-[var(--text-secondary)]">Custom Summarization Prompt</h4>
+
+                    <!-- Prompt Source Selection -->
+                    <div>
+                        <label class="block text-sm font-medium text-[var(--text-muted)] mb-2">Prompt Source</label>
+                        <div class="space-y-2">
+                            <label class="flex items-center space-x-2 cursor-pointer">
+                                <input type="radio" v-model="summaryReprocessPromptSource" value="default" class="text-[var(--text-accent)]" name="promptSource">
+                                <span class="text-sm text-[var(--text-secondary)]">Use default prompt</span>
+                            </label>
+                            <label class="flex items-center space-x-2 cursor-pointer" v-if="tagsWithCustomPrompts.length > 0">
+                                <input type="radio" v-model="summaryReprocessPromptSource" value="tag" class="text-[var(--text-accent)]" name="promptSource">
+                                <span class="text-sm text-[var(--text-secondary)]">Use prompt from tag</span>
+                            </label>
+                            <label class="flex items-center space-x-2 cursor-pointer">
+                                <input type="radio" v-model="summaryReprocessPromptSource" value="custom" class="text-[var(--text-accent)]" name="promptSource">
+                                <span class="text-sm text-[var(--text-secondary)]">Enter custom prompt</span>
+                            </label>
+                        </div>
+                    </div>
+
+                    <!-- Tag Selection (shown when 'tag' is selected) -->
+                    <div v-if="summaryReprocessPromptSource === 'tag' && tagsWithCustomPrompts.length > 0">
+                        <label for="reprocess-tag-select" class="block text-sm font-medium text-[var(--text-muted)] mb-2">Select Tag</label>
+                        <select id="reprocess-tag-select" v-model="summaryReprocessSelectedTagId" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)]">
+                            <option value="">Select a tag...</option>
+                            <option v-for="tag in tagsWithCustomPrompts" :key="tag.id" :value="tag.id">${ tag.name }</option>
+                        </select>
+                        <div v-if="summaryReprocessSelectedTagId" class="mt-2 p-2 bg-[var(--bg-tertiary)] rounded text-xs text-[var(--text-muted)] max-h-20 overflow-y-auto">
+                            <strong>Preview:</strong> ${ getTagPromptPreview(summaryReprocessSelectedTagId) }
+                        </div>
+                    </div>
+
+                    <!-- Custom Prompt Textarea (shown when 'custom' is selected) -->
+                    <div v-if="summaryReprocessPromptSource === 'custom'">
+                        <label for="reprocess-custom-prompt" class="block text-sm font-medium text-[var(--text-muted)] mb-2">Custom Prompt</label>
+                        <textarea id="reprocess-custom-prompt" v-model="summaryReprocessCustomPrompt" rows="4" class="w-full px-3 py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-[var(--border-focus)] focus:border-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)]" placeholder="Enter your custom summarization instructions..."></textarea>
+                    </div>
+
+                    {# Apply mode toggle only for custom prompts. A selected tag
+                       fully replaces the resolved default by definition, so
+                       offering Append vs Replace there is misleading. #}
+                    <div v-if="summaryReprocessPromptSource === 'custom'">
+                        <label class="block text-sm font-medium text-[var(--text-muted)] mb-2">${ t('summaryMode.applyMode') }</label>
+                        <div class="grid grid-cols-2 gap-2 p-1 bg-[var(--bg-tertiary)] border border-[var(--border-secondary)] rounded-md">
+                            <label
+                                :class="['flex items-start gap-2 p-2 rounded cursor-pointer transition-colors', summaryReprocessPromptMode === 'append' ? 'bg-[var(--bg-secondary)] border border-[var(--border-accent)] shadow-sm' : 'border border-transparent hover:bg-[var(--bg-secondary)]']">
+                                <input type="radio" v-model="summaryReprocessPromptMode" value="append" class="mt-0.5 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] focus:ring-[var(--border-focus)]">
+                                <span class="flex-1">
+                                    <span class="block text-sm font-medium text-[var(--text-primary)]">${ t('summaryMode.append') }</span>
+                                    <span class="block text-xs text-[var(--text-muted)] mt-0.5">${ t('summaryMode.appendHelp') }</span>
+                                </span>
+                            </label>
+                            <label
+                                :class="['flex items-start gap-2 p-2 rounded cursor-pointer transition-colors', summaryReprocessPromptMode === 'replace' ? 'bg-[var(--bg-secondary)] border border-[var(--border-accent)] shadow-sm' : 'border border-transparent hover:bg-[var(--bg-secondary)]']">
+                                <input type="radio" v-model="summaryReprocessPromptMode" value="replace" class="mt-0.5 h-4 w-4 text-[var(--text-accent)] border-[var(--border-secondary)] focus:ring-[var(--border-focus)]">
+                                <span class="flex-1">
+                                    <span class="block text-sm font-medium text-[var(--text-primary)]">${ t('summaryMode.replace') }</span>
+                                    <span class="block text-xs text-[var(--text-muted)] mt-0.5">${ t('summaryMode.replaceHelp') }</span>
+                                </span>
+                            </label>
+                        </div>
+                    </div>
+
+                    <!-- Info message when no tags with custom prompts exist -->
+                    <div v-if="summaryReprocessPromptSource === 'tag' && tagsWithCustomPrompts.length === 0" class="text-xs text-[var(--text-muted)] italic">
+                        No tags with custom prompts available. Create tags with custom prompts in the Account Settings.
+                    </div>
+                </div>
+
+                <div class="flex items-start space-x-3">
+                    <div class="w-6 h-6 bg-blue-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-clock text-blue-600 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.processingTime')"></p>
+                        <p class="text-sm text-[var(--text-muted)]">
+                            <span v-text="t('help.processingTimeDescription')"></span>
+                        </p>
+                    </div>
+                </div>
+
+                <div class="flex items-start space-x-3" v-if="reprocessType === 'transcription'">
+                    <div class="w-6 h-6 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-info-circle text-red-600 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.importantNote')"></p>
+                        <p class="text-sm text-[var(--text-muted)]">
+                            <span v-text="t('reprocessModal.manualEditsOverwritten')"></span>
+                        </p>
+                    </div>
+                </div>
+
+                <div class="flex items-start space-x-3" v-else-if="reprocessType === 'summary'">
+                    <div class="w-6 h-6 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0 mt-0.5">
+                        <i class="fas fa-info-circle text-red-600 text-xs"></i>
+                    </div>
+                    <div>
+                        <p class="text-[var(--text-secondary)] font-medium mb-1" v-text="t('help.importantNote')"></p>
+                        <p class="text-sm text-[var(--text-muted)]">
+                            <span v-text="t('reprocessModal.manualEditsOverwrittenSummary')"></span>
+                        </p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Footer with action buttons -->
+        <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3 border-t border-[var(--border-primary)] flex-shrink-0">
+            <button
+                @click="cancelReprocess"
+                class="px-5 py-2.5 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] transition-all duration-200 flex items-center shadow-sm font-medium">
+                <i class="fas fa-times mr-2"></i>
+                Cancel
+            </button>
+            <button
+                @click="executeReprocess"
+                class="px-5 py-2.5 bg-gradient-to-r from-blue-500 to-purple-600 text-white rounded-lg hover:from-blue-600 hover:to-purple-700 transition-all duration-200 flex items-center shadow-lg font-medium transform hover:scale-105">
+                <i class="fas fa-sync-alt mr-2"></i>
+                Start Reprocessing
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/reset-modal.html b/templates/modals/reset-modal.html
new file mode 100644
index 00000000..6acba421
--- /dev/null
+++ b/templates/modals/reset-modal.html
@@ -0,0 +1,31 @@
+<!-- Reset Status Confirmation Modal -->
+<div v-if="showResetModal" @click.self="cancelReset" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md">
+        <div class="p-6">
+            <div class="flex items-start justify-between mb-4">
+                <div class="flex items-start gap-3">
+                    <div class="flex items-center justify-center h-12 w-12 rounded-full bg-orange-100 dark:bg-orange-800">
+                        <i class="fas fa-exclamation-triangle text-2xl text-orange-500 dark:text-orange-300"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-lg font-semibold text-[var(--text-primary)] mb-2" v-text="t('modal.resetStatus')"></h3>
+                    </div>
+                </div>
+                <button @click="cancelReset" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+            <p class="text-sm text-[var(--text-muted)] mb-6">
+                This will mark the recording as 'Failed'. This is useful if processing is stuck. You will be able to reprocess it afterwards.
+            </p>
+        </div>
+        <div class="bg-[var(--bg-tertiary)] px-6 py-4 rounded-b-xl flex justify-end space-x-3">
+            <button @click="cancelReset" class="px-4 py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-lg border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)]">
+                Cancel
+            </button>
+            <button @click="executeReset" class="px-4 py-2 bg-orange-500 text-white rounded-lg hover:bg-orange-600">
+                Yes, Reset Status
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/share-delete-modal.html b/templates/modals/share-delete-modal.html
new file mode 100644
index 00000000..1f543971
--- /dev/null
+++ b/templates/modals/share-delete-modal.html
@@ -0,0 +1,52 @@
+<!-- Share Delete Confirmation Modal -->
+<div v-if="showShareDeleteModal" @click.self="cancelDeleteShare" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-md transform transition-all duration-300 ease-in-out">
+        <!-- Header with gradient background -->
+        <div class="bg-gradient-to-r from-red-500 to-red-600 p-5 rounded-t-xl">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center">
+                    <div class="w-12 h-12 bg-white/20 backdrop-blur rounded-full flex items-center justify-center mr-4">
+                        <i class="fas fa-trash-alt text-white text-lg"></i>
+                    </div>
+                    <div>
+                        <h3 class="text-lg font-bold text-white">Delete Shared Link</h3>
+                        <p class="text-red-100 text-sm mt-1">This action cannot be undone</p>
+                    </div>
+                </div>
+                <button @click="cancelDeleteShare" class="text-white/80 hover:text-white transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <!-- Content -->
+        <div class="p-6">
+            <p class="text-[var(--text-secondary)] mb-4">
+                Are you sure you want to delete the shared link for:
+            </p>
+            <div v-if="shareToDelete" class="bg-[var(--bg-tertiary)] p-3 rounded-lg border border-[var(--border-primary)]">
+                <p class="font-medium text-[var(--text-primary)]">${shareToDelete.recording_title}</p>
+                <p class="text-sm text-[var(--text-muted)] mt-1">Shared on: ${shareToDelete.created_at}</p>
+            </div>
+            <div class="mt-4 p-3 bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg">
+                <div class="flex items-start">
+                    <i class="fas fa-exclamation-triangle text-red-600 dark:text-red-400 mt-0.5 mr-2"></i>
+                    <p class="text-sm text-red-800 dark:text-red-300">
+                        The share link will be permanently deleted and anyone with this link will no longer be able to access the recording.
+                    </p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Actions -->
+        <div class="p-6 pt-0 flex justify-end gap-3">
+            <button @click="cancelDeleteShare" class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="deleteShare" class="px-4 py-2 bg-red-600 text-white rounded-lg hover:bg-red-700 transition-colors flex items-center gap-2">
+                <i class="fas fa-trash"></i>
+                Delete Share Link
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/share-modal.html b/templates/modals/share-modal.html
new file mode 100644
index 00000000..1a4b8cfa
--- /dev/null
+++ b/templates/modals/share-modal.html
@@ -0,0 +1,82 @@
+<!-- Share Modal -->
+<div v-if="showShareModal" @click.self="closeShareModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col">
+        <div class="px-6 py-4 border-b border-[var(--border-primary)] flex justify-between items-center">
+            <h3 class="text-lg font-semibold" v-text="t('modal.shareRecording')"></h3>
+            <button @click="closeShareModal" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+        <div class="px-6 py-4 space-y-3 overflow-y-auto flex-1">
+            <p class="text-xs text-[var(--text-muted)]" v-text="t('help.createPublicLink')"></p>
+
+            <!-- Share Options -->
+            <div class="flex items-center gap-3 mb-2">
+                <label class="flex items-center">
+                    <input type="checkbox" v-model="shareOptions.share_summary" id="share_summary" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                    <span class="ml-2 text-xs" v-text="t('form.shareSummary')"></span>
+                </label>
+                <label class="flex items-center">
+                    <input type="checkbox" v-model="shareOptions.share_notes" id="share_notes" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                    <span class="ml-2 text-xs" v-text="t('form.shareNotes')"></span>
+                </label>
+            </div>
+
+            <!-- Create New Share Button -->
+            <button @click="createShare(true)" class="w-full px-3 py-2 bg-[var(--bg-accent)] text-white rounded-lg hover:opacity-90 transition-opacity text-sm font-medium">
+                <i class="fas fa-plus-circle mr-1.5"></i>Create New Share Link
+            </button>
+
+            <!-- Loading State -->
+            <div v-if="isLoadingPublicShares" class="text-center py-8">
+                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                <p class="mt-2 text-sm text-[var(--text-muted)]">Loading share links...</p>
+            </div>
+
+            <!-- Existing Shares List -->
+            <div v-else-if="recordingPublicShares.length > 0" class="space-y-2">
+                <h4 class="text-xs font-medium text-[var(--text-secondary)]">
+                    Existing Share Links (${recordingPublicShares.length})
+                </h4>
+                <div v-for="share in recordingPublicShares" :key="share.id" class="bg-[var(--bg-tertiary)] p-2.5 rounded-lg border border-[var(--border-primary)]">
+                    <div class="flex justify-between items-start mb-2">
+                        <div>
+                            <p class="text-xs text-[var(--text-muted)]">${ t('help.sharedOn') }: ${share.created_at}</p>
+                        </div>
+                        <button @click="confirmDeletePublicShare(share)" class="text-red-500 hover:text-red-700 p-1">
+                            <i class="fas fa-trash text-xs"></i>
+                        </button>
+                    </div>
+                    <div class="flex items-center gap-3 mb-2">
+                        <label class="flex items-center text-xs">
+                            <input type="checkbox" v-model="share.share_summary" @change="updateShare(share)" class="h-3.5 w-3.5 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-1.5" v-text="t('form.shareSummary')"></span>
+                        </label>
+                        <label class="flex items-center text-xs">
+                            <input type="checkbox" v-model="share.share_notes" @change="updateShare(share)" class="h-3.5 w-3.5 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-1.5" v-text="t('form.shareNotes')"></span>
+                        </label>
+                    </div>
+                    <div class="relative">
+                        <input :value="share.share_url" :id="'share-link-' + share.id" readonly class="w-full px-2 py-1.5 pr-10 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs font-mono">
+                        <button @click="copyPublicShareLinkWithFeedback(share.share_url, share.id)" class="absolute right-1 top-1/2 -translate-y-1/2 w-8 h-7 flex items-center justify-center rounded bg-[var(--bg-button)] text-[var(--text-button)] hover:bg-[var(--bg-button-hover)] transition-colors" :title="t('buttons.copy')">
+                            <i :class="copiedShareId === share.id ? 'fas fa-check' : 'fas fa-copy'" class="text-xs"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- No Shares Yet -->
+            <div v-else-if="!isLoadingPublicShares" class="text-center py-8 text-[var(--text-muted)]">
+                <i class="fas fa-link text-3xl mb-2"></i>
+                <p v-text="t('sharedTranscripts.noSharedTranscripts')"></p>
+                <p class="text-xs mt-1">Click the button above to create one</p>
+            </div>
+        </div>
+        <div class="px-6 py-3 border-t border-[var(--border-primary)] flex justify-end">
+            <button @click="closeShareModal" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors text-sm font-medium">
+                Done
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/shares-list-modal.html b/templates/modals/shares-list-modal.html
new file mode 100644
index 00000000..b765e51c
--- /dev/null
+++ b/templates/modals/shares-list-modal.html
@@ -0,0 +1,46 @@
+<!-- Shares List Modal -->
+<div v-if="showSharesListModal" @click.self="closeSharesList" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)] flex justify-between items-center">
+            <h3 class="text-lg font-semibold" v-text="t('modal.sharedTranscripts')"></h3>
+            <button @click="closeSharesList" class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors">
+                <i class="fas fa-times"></i>
+            </button>
+        </div>
+        <div class="p-6 space-y-4 overflow-y-auto">
+            <div v-if="isLoadingShares" class="text-center">
+                <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+            </div>
+            <div v-else-if="userShares.length === 0" class="text-center text-[var(--text-muted)]">
+                <span v-text="t('sharedTranscripts.noSharedTranscripts')"></span>
+            </div>
+            <div v-else class="space-y-3">
+                <div v-for="share in userShares" :key="share.id" class="bg-[var(--bg-tertiary)] p-4 rounded-lg border border-[var(--border-primary)]">
+                    <div class="flex justify-between items-start">
+                        <div>
+                            <p class="font-semibold">${share.recording_title}</p>
+                            <p class="text-sm text-[var(--text-muted)]">${ t('help.sharedOn') }: ${share.created_at}</p>
+                        </div>
+                        <button @click="confirmDeleteShare(share)" class="text-red-500 hover:text-red-700 p-1"><i class="fas fa-trash"></i></button>
+                    </div>
+                    <div class="mt-4 flex items-center gap-4">
+                        <label class="flex items-center text-sm">
+                            <input type="checkbox" v-model="share.share_summary" @change="updateShare(share)" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-2" v-text="t('form.shareSummary')"></span>
+                        </label>
+                        <label class="flex items-center text-sm">
+                            <input type="checkbox" v-model="share.share_notes" @change="updateShare(share)" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-2" v-text="t('form.shareNotes')"></span>
+                        </label>
+                    </div>
+                    <div class="mt-4 relative">
+                        <input :value="'{{ request.url_root }}share/' + share.public_id" :id="'share-link-' + share.id" readonly class="w-full px-3 py-2 pr-12 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-[var(--border-accent)]">
+                        <button @click="copyIndividualShareLink(share.id)" class="absolute right-1.5 top-1/2 -translate-y-1/2 w-7 h-7 flex items-center justify-center rounded bg-[var(--bg-button)] text-[var(--text-button)] hover:bg-[var(--bg-button-hover)] transition-colors" :title="t('buttons.copy')">
+                            <i :class="copiedShareId === share.id ? 'fas fa-check' : 'fas fa-copy'" class="text-xs"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/speaker-modal.html b/templates/modals/speaker-modal.html
new file mode 100644
index 00000000..02d1fe0b
--- /dev/null
+++ b/templates/modals/speaker-modal.html
@@ -0,0 +1,353 @@
+<!-- Speaker Identification Modal -->
+<div v-if="showSpeakerModal" @click.self="closeSpeakerModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-2 sm:p-4 backdrop-blur-sm">
+    <div @click="closeSpeakerSuggestionsOnClick" class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-4xl flex flex-col h-[95vh] sm:h-[85vh]">
+        <!-- Header -->
+        <div class="p-3 sm:p-5 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <h3 class="text-base sm:text-xl font-bold text-[var(--text-primary)]" v-text="t('modal.identifySpeakers')"></h3>
+                <button @click="closeSpeakerModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+            <!-- Warning for too many speakers -->
+            <div v-if="modalSpeakers.length > 16" class="mt-3 p-3 bg-[var(--bg-warn-light)] border border-amber-300 dark:border-amber-800 rounded-lg">
+                <div class="flex items-start">
+                    <i class="fas fa-exclamation-triangle text-[var(--text-warn-strong)] mt-0.5 mr-2"></i>
+                    <div class="text-sm">
+                        <p class="font-medium text-[var(--text-warn-strong)]" v-text="t('help.moreSpeakersThanColors')"></p>
+                        <p class="text-[var(--text-warn-strong)] mt-1" v-text="t('help.youHaveXSpeakers', { count: modalSpeakers.length })">
+                        </p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Mobile Tab Switcher (hidden on lg screens) -->
+        <div class="lg:hidden flex border-b border-[var(--border-primary)] flex-shrink-0">
+            <button
+                @click="speakerModalTab = 'speakers'"
+                class="flex-1 py-2 text-xs font-medium transition-colors relative"
+                :class="speakerModalTab === 'speakers' ? 'text-[var(--text-accent)]' : 'text-[var(--text-muted)]'">
+                <i class="fas fa-users mr-1"></i>Speakers
+                <span v-if="speakerModalTab === 'speakers'" class="absolute bottom-0 left-0 right-0 h-0.5 bg-[var(--bg-accent)]"></span>
+            </button>
+            <button
+                @click="speakerModalTab = 'transcript'"
+                class="flex-1 py-2 text-xs font-medium transition-colors relative"
+                :class="speakerModalTab === 'transcript' ? 'text-[var(--text-accent)]' : 'text-[var(--text-muted)]'">
+                <i class="fas fa-file-lines mr-1"></i>Transcript
+                <span v-if="speakerModalTab === 'transcript'" class="absolute bottom-0 left-0 right-0 h-0.5 bg-[var(--bg-accent)]"></span>
+            </button>
+        </div>
+
+        <!-- Main Content - Tab-based on mobile, side-by-side on desktop -->
+        <div class="flex-grow flex flex-col lg:flex-row overflow-hidden modal-content">
+            <!-- Speaker List Panel - shown on mobile when speakers tab active, always on desktop -->
+            <div class="lg:w-1/3 p-3 sm:p-6 space-y-2 sm:space-y-4 overflow-y-auto custom-scrollbar lg:border-r border-[var(--border-primary)]"
+                 :class="{ 'hidden lg:block': speakerModalTab !== 'speakers', 'flex-1': speakerModalTab === 'speakers' }">
+                <div v-for="(speaker, index) in modalSpeakers" :key="`${selectedRecording.id}-speaker-${index}-${speaker}`" class="space-y-1.5 sm:space-y-3">
+                    <!-- Speaker label with color indicator and "This is Me" checkbox -->
+                    <div class="flex items-center justify-between gap-2">
+                        <div class="flex items-center space-x-1.5 min-w-0">
+                            <div :class="speakerMap[speaker].color" class="w-3 h-3 sm:w-4 sm:h-4 rounded-full border border-white/30 shadow-sm flex-shrink-0"></div>
+                            <span class="font-mono text-xs sm:text-sm text-[var(--text-muted)] truncate">${ speakerDisplayMap[speaker] || speaker }</span>
+                            <span v-if="index >= 16" class="text-[10px] text-[var(--text-warn-strong)] bg-[var(--bg-warn-light)] px-1.5 py-0.5 rounded-full flex-shrink-0" :title="`Color repeats from speaker ${((index % 16) + 1)}`">
+                                Repeat
+                            </span>
+                        </div>
+                        <label class="flex items-center text-xs sm:text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors flex-shrink-0">
+                            <input type="checkbox"
+                                   v-model="speakerMap[speaker].isMe"
+                                   @change="handleIsMeChange(speaker)"
+                                   @focus="highlightSpeakerInTranscript(speaker)"
+                                   @blur="clearSpeakerHighlight"
+                                   class="speaker-checkbox w-4 h-4 sm:w-4 sm:h-4">
+                            <span class="ml-1.5 select-none" v-text="t('help.me')"></span>
+                        </label>
+                    </div>
+
+                    <!-- Autocomplete input field -->
+                    <div class="relative">
+                        <input
+                            type="text"
+                            v-model="speakerMap[speaker].name"
+                            @input="searchSpeakers($event.target.value, speaker)"
+                            @focus="focusSpeaker(speaker)"
+                            @blur="blurSpeaker()"
+                            :disabled="speakerMap[speaker].isMe"
+                            class="w-full px-2 py-2 sm:py-2 border border-[var(--border-secondary)] rounded-md shadow-sm focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] focus:border-[var(--border-focus)] text-sm bg-[var(--bg-input)] text-[var(--text-primary)] disabled:bg-[var(--bg-tertiary)] disabled:text-[var(--text-muted)] disabled:cursor-not-allowed"
+                            :class="{ 'pr-28': shouldShowVoiceSuggestionPill(speaker) }"
+                            :placeholder="speakerMap[speaker].isMe ? currentUserName : t('help.enterNameFor') + ' ' + (speakerDisplayMap[speaker] || speaker)"
+                            autocomplete="off">
+
+                        <!-- Voice match suggestion pill -->
+                        <button v-if="shouldShowVoiceSuggestionPill(speaker)"
+                                @click.stop="applyVoiceSuggestion(speaker, voiceSuggestions[speaker][0])"
+                                class="absolute right-1.5 top-1/2 transform -translate-y-1/2 px-1.5 py-0.5 bg-gradient-to-r from-blue-500 to-purple-500 text-white text-[10px] rounded-full flex items-center gap-0.5 hover:from-blue-600 hover:to-purple-600 transition-all shadow-sm hover:shadow group active:scale-95">
+                            <i class="fas fa-waveform-lines text-[9px]"></i>
+                            <span class="font-medium truncate max-w-[50px] sm:max-w-[80px]">${ voiceSuggestions[speaker][0].name }</span>
+                            <span class="text-[9px] opacity-90">${ voiceSuggestions[speaker][0].similarity }%</span>
+                        </button>
+
+                        <!-- Loading indicator -->
+                        <div v-if="loadingSuggestions[speaker] && !speakerMap[speaker].isMe" class="absolute right-2 top-1/2 transform -translate-y-1/2">
+                            <i class="fas fa-spinner fa-spin text-[var(--text-muted)] text-xs"></i>
+                        </div>
+
+                        <!-- Suggestions dropdown -->
+                        <div v-if="activeSpeakerInput === speaker && speakerSuggestions[speaker] && speakerSuggestions[speaker].length > 0 && !speakerMap[speaker].isMe"
+                             @click.stop
+                             class="absolute z-10 w-full mt-1 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg max-h-40 overflow-y-auto">
+                            <div class="py-0.5">
+                                <div v-for="suggestion in speakerSuggestions[speaker]"
+                                     :key="suggestion.id"
+                                     @click="selectSpeakerSuggestion(speaker, suggestion)"
+                                     class="px-2 py-1.5 cursor-pointer hover:bg-[var(--bg-tertiary)] active:bg-[var(--bg-accent)] flex items-center justify-between">
+                                    <div class="flex-grow min-w-0">
+                                        <div class="text-xs font-medium text-[var(--text-primary)] truncate">${ suggestion.name }</div>
+                                        <div class="text-[10px] text-[var(--text-muted)]">
+                                            Used ${ suggestion.use_count }x
+                                        </div>
+                                    </div>
+                                    <i class="fas fa-user text-[var(--text-muted)] ml-1.5 flex-shrink-0 text-[10px]"></i>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Add Speaker Button -->
+                <div class="pt-2 sm:pt-4 border-t border-[var(--border-primary)]">
+                    <button @click="openAddSpeakerModal" class="w-full px-3 py-2 sm:py-2 bg-[var(--bg-accent)] text-[var(--text-accent)] rounded-md hover:bg-[var(--bg-accent-hover)] active:scale-[0.98] transition-all flex items-center justify-center text-xs sm:text-sm font-medium">
+                        <i class="fas fa-plus mr-1.5"></i>
+                        <span v-text="t('buttons.addSpeaker')"></span>
+                    </button>
+                </div>
+            </div>
+
+            <!-- Audio Player & Transcript Panel - shown on mobile when transcript tab active, always on desktop -->
+            <div class="lg:w-2/3 p-3 sm:p-6 flex flex-col overflow-hidden"
+                 :class="{ 'hidden lg:flex': speakerModalTab !== 'transcript', 'flex-1': speakerModalTab === 'transcript' }">
+                <!-- Audio Player Section -->
+                <div class="mb-2 sm:mb-4 flex-shrink-0">
+                    <!-- Show message if audio has been deleted -->
+                    <div v-if="selectedRecording.audio_deleted_at"
+                         class="text-[var(--text-muted)] text-xs flex items-center gap-2">
+                        <i class="fas fa-info-circle"></i>
+                        <span v-text="t('help.audioDeletedMessage')"></span>
+                    </div>
+                    <!-- Show message for incognito recordings -->
+                    <div v-else-if="selectedRecording.incognito"
+                         class="text-[var(--text-muted)] text-xs flex items-center gap-2">
+                        <i class="fas fa-user-secret"></i>
+                        <span>Audio not stored in incognito mode</span>
+                    </div>
+                    <!-- Custom Audio/Video Player (Independent from main player) -->
+                    <div v-else>
+                        <component :is="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') ? 'video' : 'audio'"
+                               ref="speakerModalAudioRef"
+                               :class="selectedRecording.mime_type && selectedRecording.mime_type.startsWith('video/') ? 'w-full rounded-lg mb-2' : 'hidden'"
+                               :key="'speaker-modal-' + selectedRecording.id"
+                               :src="'/audio/' + selectedRecording.id"
+                               :volume="playerVolume"
+                               @play="handleModalAudioPlayPause"
+                               @pause="handleModalAudioPlayPause"
+                               @timeupdate="handleModalAudioTimeUpdate"
+                               @loadedmetadata="handleModalAudioLoadedMetadata"
+                               @ended="modalAudioIsPlaying = false">
+                        </component>
+                        <div class="flex items-center gap-2">
+                        <!-- Play/Pause -->
+                        <button @click="$refs.speakerModalAudioRef?.paused ? $refs.speakerModalAudioRef.play() : $refs.speakerModalAudioRef.pause()"
+                                class="w-8 h-8 flex items-center justify-center rounded-full bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] text-white transition-all flex-shrink-0 shadow-sm"
+                                :title="modalAudioIsPlaying ? 'Pause' : 'Play'">
+                            <i :class="modalAudioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-xs" :style="!modalAudioIsPlaying ? 'margin-left: 1px' : ''"></i>
+                        </button>
+                        <!-- Time -->
+                        <div class="flex flex-col items-end flex-shrink-0 leading-none">
+                            <span class="text-xs text-[var(--text-primary)] font-mono">${ formatAudioTime(modalAudioCurrentTime) }</span>
+                            <span class="text-[10px] text-[var(--text-muted)] font-mono">${ formatAudioTime(modalAudioDuration) }</span>
+                        </div>
+                        <!-- Progress Bar -->
+                        <div class="flex-1 h-1.5 bg-[var(--bg-tertiary)] rounded-full cursor-pointer group relative"
+                             @click="(e) => { const rect = e.currentTarget.getBoundingClientRect(); const pct = (e.clientX - rect.left) / rect.width; if ($refs.speakerModalAudioRef) $refs.speakerModalAudioRef.currentTime = pct * modalAudioDuration; }">
+                            <div class="h-full bg-[var(--bg-accent)] rounded-full transition-all duration-100"
+                                 :style="{ width: modalAudioProgressPercent + '%' }">
+                            </div>
+                        </div>
+                        <!-- Volume Control -->
+                        <div class="relative flex items-center flex-shrink-0"
+                             @mouseenter="showModalVolumeSlider = true"
+                             @mouseleave="showModalVolumeSlider = false">
+                            <button @click="if ($refs.speakerModalAudioRef) { $refs.speakerModalAudioRef.muted = !$refs.speakerModalAudioRef.muted; audioIsMuted = $refs.speakerModalAudioRef.muted; }"
+                                    class="w-7 h-7 flex items-center justify-center rounded hover:bg-[var(--bg-tertiary)] transition-all flex-shrink-0"
+                                    :class="audioIsMuted || playerVolume === 0 ? 'text-[var(--text-muted)]' : 'text-[var(--text-primary)]'">
+                                <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : playerVolume < 0.5 ? 'fas fa-volume-down' : 'fas fa-volume-up'" class="text-xs"></i>
+                            </button>
+                            <!-- Volume Slider Popup (outer div is invisible hover bridge) -->
+                            <div class="absolute top-full left-1/2 -translate-x-1/2 pt-2 z-[9999] transition-all duration-200"
+                                 :class="showModalVolumeSlider ? 'opacity-100 pointer-events-auto scale-100' : 'opacity-0 pointer-events-none scale-95'"
+                                 @mouseenter="showModalVolumeSlider = true"
+                                 @mouseleave="showModalVolumeSlider = false">
+                                <div class="px-2.5 py-2 bg-[var(--bg-tertiary)] border border-[var(--border-accent)] rounded-lg shadow-xl flex flex-col items-center gap-1">
+                                    <span class="text-[9px] font-mono text-[var(--text-muted)]">${ Math.round(playerVolume * 100) }</span>
+                                    <input type="range" min="0" max="1" step="0.05"
+                                           :value="audioIsMuted ? 0 : playerVolume"
+                                           @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                                           class="volume-slider-vertical"
+                                           style="height: 70px;">
+                                </div>
+                            </div>
+                        </div>
+                        <!-- Speed Control (compact - tap to cycle) -->
+                        <button @click="cycleModalPlaybackRate(); if ($refs.speakerModalAudioRef) $refs.speakerModalAudioRef.playbackRate = modalPlaybackRate"
+                                class="w-7 h-7 flex items-center justify-center rounded hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-all flex-shrink-0"
+                                title="Playback speed (tap to change)">
+                            <span class="text-[10px] font-semibold font-mono">${ formatPlaybackRate(modalPlaybackRate) }</span>
+                        </button>
+                    </div>
+                </div>
+                </div>
+
+                <!-- Transcript Section (Virtual Scrolling for performance) -->
+                <div ref="speakerModalTranscriptRef"
+                     class="flex-grow overflow-y-auto custom-scrollbar speaker-modal-transcript min-h-0"
+                     @click="(e) => { const t = e.target.closest('[data-start-time]')?.dataset.startTime; if (t && $refs.speakerModalAudioRef) { $refs.speakerModalAudioRef.currentTime = parseFloat(t); $refs.speakerModalAudioRef.play(); } }"
+                     @scroll="onSpeakerModalScroll">
+                    <div v-if="processedTranscription.isJson">
+                        <!-- Virtual scroll spacer (top) -->
+                        <div :style="{ height: speakerModalSpacerBefore + 'px' }"></div>
+
+                        <!-- Only render visible segments -->
+                        <div v-for="segment in speakerModalVisibleSegments"
+                             :key="getVirtualItemKey(segment, 'sm')"
+                             class="speaker-segment mb-1.5 sm:mb-2 group relative"
+                             :data-start-time="segment.startTime"
+                             :data-segment-index="segment._originalIndex">
+                            <div class="flex items-start gap-1">
+                                <!-- Speaker tag on its own line on mobile -->
+                                <span :class="[segment.color, 'speaker-tag', { 'speaker-highlight': highlightedSpeaker === segment.speakerId }]" :data-speaker-id="segment.speakerId" class="inline-block flex-shrink-0 truncate text-xs sm:text-sm font-medium w-16 sm:w-24" :title="segment.speaker">${ segment.speaker }</span>
+                                <!-- Text content -->
+                                <span class="word cursor-pointer hover:bg-[var(--bg-accent)] hover:text-[var(--text-accent)] rounded px-0.5 flex-1 text-xs sm:text-sm leading-relaxed">${ segment.sentence }</span>
+                                <!-- Edit buttons - inline on mobile -->
+                                <span class="flex items-center gap-0.5 flex-shrink-0 sm:opacity-0 sm:group-hover:opacity-100 transition-opacity">
+                                    <button @click.stop="openSpeakerChangeDropdown(segment._originalIndex)" class="p-1 rounded bg-[var(--bg-tertiary)] hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors active:scale-95" title="Change speaker">
+                                        <i class="fas fa-user-edit text-[10px] sm:text-xs"></i>
+                                    </button>
+                                    <button @click.stop="openEditTextModal(segment._originalIndex)" class="p-1 rounded bg-[var(--bg-tertiary)] hover:bg-[var(--bg-accent)] text-[var(--text-muted)] hover:text-[var(--text-accent)] transition-colors active:scale-95" title="Edit text">
+                                        <i class="fas fa-edit text-[10px] sm:text-xs"></i>
+                                    </button>
+                                </span>
+                            </div>
+
+                            <!-- Speaker Change Dropdown - compact on mobile -->
+                            <div v-if="editingSpeakerIndex === segment._originalIndex" @click.stop class="mt-1 p-1.5 bg-[var(--bg-tertiary)] rounded-md border border-[var(--border-primary)] shadow-lg">
+                                <p class="text-[10px] text-[var(--text-muted)] mb-1">Select speaker:</p>
+                                <div class="flex flex-wrap gap-1">
+                                    <button v-for="speaker in modalSpeakers" :key="speaker" @click="changeSpeaker(segment._originalIndex, speaker)" class="px-2 py-1 rounded-md hover:bg-[var(--bg-accent)] hover:text-[var(--text-accent)] active:scale-[0.98] transition-all flex items-center gap-1 text-xs bg-[var(--bg-secondary)]">
+                                        <div :class="speakerMap[speaker].color" class="w-2.5 h-2.5 rounded-full flex-shrink-0"></div>
+                                        <span class="truncate max-w-[60px]">${ speakerMap[speaker].name || speaker }</span>
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Virtual scroll spacer (bottom) -->
+                        <div :style="{ height: speakerModalSpacerAfter + 'px' }"></div>
+                    </div>
+                    <div v-else class="whitespace-pre-wrap text-sm text-[var(--text-primary)]">${ processedTranscription.plainText }</div>
+                </div>
+
+                <!-- Speaker Navigation Controls - more compact -->
+                <div class="mt-1.5 sm:mt-3 p-1.5 sm:p-3 bg-[var(--bg-tertiary)] rounded-md flex flex-col gap-1.5 flex-shrink-0">
+                    <!-- Speaker Selector Row -->
+                    <div class="flex items-center gap-1.5">
+                        <select
+                            :value="highlightedSpeaker"
+                            @change="selectSpeakerForNavigation($event.target.value)"
+                            class="flex-1 px-2 py-1 text-xs bg-[var(--bg-secondary)] border border-[var(--border-secondary)] rounded text-[var(--text-primary)] focus:outline-none focus:ring-1 focus:ring-[var(--ring-focus)]">
+                            <option value="">Navigate to speaker...</option>
+                            <option v-for="speaker in modalSpeakers" :key="speaker" :value="speaker">
+                                ${ speakerMap[speaker]?.name || speakerDisplayMap[speaker] || speaker }
+                            </option>
+                        </select>
+                        <span v-if="highlightedSpeaker && speakerGroups.length > 0" class="text-[10px] text-[var(--text-muted)] flex-shrink-0 tabular-nums">
+                            ${ currentSpeakerGroupIndex + 1 }/${ speakerGroups.length }
+                        </span>
+                    </div>
+                    <!-- Navigation Buttons Row -->
+                    <div class="flex items-center gap-1.5" :class="{'opacity-50': !highlightedSpeaker || speakerGroups.length <= 1}">
+                        <button @mousedown.prevent @click="navigateToPrevSpeakerGroup"
+                                class="flex-1 px-2 py-1.5 bg-[var(--bg-secondary)] hover:bg-[var(--bg-primary)] text-[var(--text-secondary)] rounded border border-[var(--border-secondary)] transition-all active:scale-95 flex items-center justify-center text-xs disabled:opacity-50 disabled:cursor-not-allowed"
+                                :disabled="!highlightedSpeaker || speakerGroups.length <= 1">
+                            <i class="fas fa-chevron-up mr-1"></i>Prev
+                        </button>
+                        <button @mousedown.prevent @click="navigateToNextSpeakerGroup"
+                                class="flex-1 px-2 py-1.5 bg-[var(--bg-secondary)] hover:bg-[var(--bg-primary)] text-[var(--text-secondary)] rounded border border-[var(--border-secondary)] transition-all active:scale-95 flex items-center justify-center text-xs disabled:opacity-50 disabled:cursor-not-allowed"
+                                :disabled="!highlightedSpeaker || speakerGroups.length <= 1">
+                            Next<i class="fas fa-chevron-down ml-1"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Regenerate Summary Checkbox -->
+        <div class="p-2 sm:p-4 bg-[var(--bg-tertiary)] border-t border-[var(--border-primary)] flex-shrink-0">
+            <label class="flex items-center text-xs sm:text-sm text-[var(--text-muted)] cursor-pointer hover:text-[var(--text-primary)] transition-colors">
+                <input type="checkbox"
+                       v-model="regenerateSummaryAfterSpeakerUpdate"
+                       class="speaker-checkbox w-4 h-4">
+                <span class="ml-1.5 select-none" v-text="t('help.regenerateSummaryAfterNames')"></span>
+            </label>
+        </div>
+
+        <!-- Footer Buttons -->
+        <div class="bg-[var(--bg-tertiary)] px-3 sm:px-6 py-2 sm:py-4 flex flex-row justify-between items-center gap-2 border-t border-[var(--border-primary)] flex-shrink-0 rounded-b-xl">
+            <!-- Left: Auto Identify Split Button + Apply Suggested -->
+            <div class="flex items-center gap-2">
+                <!-- Split Button: Auto Identify -->
+                <div class="relative inline-flex" ref="autoIdSplitBtn">
+                    <!-- Main button: identify missing only -->
+                    <button @click="autoIdentifySpeakers(false)" class="px-2 sm:px-3 py-1.5 sm:py-2 bg-purple-600 text-white rounded-l-md hover:bg-purple-700 active:scale-[0.98] transition-all flex items-center justify-center text-xs sm:text-sm font-medium" :disabled="isAutoIdentifying">
+                        <i class="fas fa-magic mr-1 sm:mr-1.5"></i>
+                        <span v-if="!isAutoIdentifying" class="hidden sm:inline" v-text="t('help.autoIdentify')"></span>
+                        <span v-if="!isAutoIdentifying" class="sm:hidden" v-text="t('help.autoIdentifyMobile')"></span>
+                        <span v-else>
+                            <i class="fas fa-spinner fa-spin"></i>
+                        </span>
+                    </button>
+                    <!-- Dropdown arrow -->
+                    <button @click="showAutoIdDropdown = !showAutoIdDropdown" class="px-1.5 py-1.5 sm:py-2 bg-purple-600 text-white rounded-r-md border-l border-purple-500 hover:bg-purple-700 active:scale-[0.98] transition-all text-xs sm:text-sm" :disabled="isAutoIdentifying">
+                        <i class="fas fa-caret-down"></i>
+                    </button>
+                    <!-- Dropdown menu -->
+                    <div v-if="showAutoIdDropdown" class="absolute bottom-full left-0 mb-1 bg-[var(--bg-secondary)] border border-[var(--border-primary)] rounded-md shadow-lg z-50 min-w-[180px]">
+                        <button @click="autoIdentifySpeakers(true)" class="w-full px-3 py-2 text-left text-xs sm:text-sm text-[var(--text-primary)] hover:bg-[var(--bg-tertiary)] transition-colors rounded-md">
+                            <i class="fas fa-users mr-2"></i><span v-text="t('help.identifyAllSpeakers')"></span>
+                        </button>
+                    </div>
+                </div>
+                <!-- Apply Suggested Button -->
+                <button v-if="hasAnySuggestions" @click="applySuggestedNames" class="px-2 sm:px-3 py-1.5 sm:py-2 bg-gradient-to-r from-blue-600 to-purple-600 text-white rounded-md hover:from-blue-700 hover:to-purple-700 active:scale-[0.98] transition-all flex items-center text-xs sm:text-sm font-medium">
+                    <i class="fas fa-lightbulb mr-1 sm:mr-1.5"></i>
+                    <span class="hidden sm:inline" v-text="t('help.applySuggested')"></span>
+                    <span class="sm:hidden" v-text="t('help.applySuggestedMobile')"></span>
+                </button>
+            </div>
+            <!-- Right: Cancel & Save Buttons -->
+            <div class="flex gap-2">
+                <button @click="closeSpeakerModal" class="px-3 sm:px-4 py-1.5 sm:py-2 bg-[var(--bg-secondary)] text-[var(--text-secondary)] rounded-md border border-[var(--border-secondary)] hover:bg-[var(--bg-tertiary)] active:scale-[0.98] transition-all text-xs sm:text-sm" v-text="t('common.cancel')"></button>
+                <button
+                    @click="saveSpeakerNames"
+                    :disabled="!hasSpeakerNames"
+                    class="px-3 sm:px-4 py-1.5 sm:py-2 rounded-md transition-all text-xs sm:text-sm font-medium active:scale-[0.98]"
+                    :class="hasSpeakerNames
+                        ? 'bg-[var(--bg-accent)] text-[var(--text-accent)] hover:bg-[var(--bg-accent-hover)] cursor-pointer'
+                        : 'bg-gray-400 text-gray-200 cursor-not-allowed'"
+                    v-text="t('buttons.saveNames')"
+                ></button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/system-audio-help-modal.html b/templates/modals/system-audio-help-modal.html
new file mode 100644
index 00000000..84ee3aa9
--- /dev/null
+++ b/templates/modals/system-audio-help-modal.html
@@ -0,0 +1,53 @@
+<!-- System Audio Help Modal -->
+<div v-if="showSystemAudioHelp" @click.self="showSystemAudioHelp = false" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-lg max-h-[80vh] overflow-y-auto">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold" v-text="t('help.systemAudioHelp')"></h3>
+                <button @click="showSystemAudioHelp = false" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6 space-y-4">
+            <div class="p-4 bg-blue-50 dark:bg-blue-900/20 border border-blue-200 dark:border-blue-800 rounded-lg">
+                <div class="flex items-start gap-3">
+                    <i class="fas fa-info-circle text-blue-600 dark:text-blue-400 mt-0.5"></i>
+                    <div>
+                        <p class="font-medium text-blue-800 dark:text-blue-300 mb-2">Browser Compatibility</p>
+                        <p class="text-sm text-blue-700 dark:text-blue-400">
+                            System audio recording works best in Chrome, Edge, and Brave. Firefox is supported but requires the tab to be actively playing audio. Not supported on Safari or mobile devices.
+                        </p>
+                    </div>
+                </div>
+            </div>
+
+            <div>
+                <h4 class="font-medium mb-2">How to record system audio:</h4>
+                <ol class="list-decimal list-inside space-y-2 text-sm text-[var(--text-secondary)]">
+                    <li>Click "System Audio" or "Mic + System" button</li>
+                    <li>A screen sharing dialog will appear</li>
+                    <li>Select a tab or window that is <strong>actively playing audio</strong></li>
+                    <li>Make sure "Share audio" checkbox is <strong>checked</strong></li>
+                    <li>Click "Share" to start recording</li>
+                </ol>
+            </div>
+
+            <div>
+                <h4 class="font-medium mb-2">Troubleshooting:</h4>
+                <ul class="list-disc list-inside space-y-1 text-sm text-[var(--text-muted)]">
+                    <li><strong>Important:</strong> The tab/window must be playing audio when you share it</li>
+                    <li>Check that "Share audio" checkbox is checked in the sharing dialog</li>
+                    <li>In Firefox, start playing audio first, then click record</li>
+                    <li>Some content may have DRM protection that blocks recording</li>
+                    <li>Not supported on Safari or mobile browsers</li>
+                </ul>
+            </div>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end">
+            <button @click="showSystemAudioHelp = false" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                Got it
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/text-editor-modal.html b/templates/modals/text-editor-modal.html
new file mode 100644
index 00000000..00d71b41
--- /dev/null
+++ b/templates/modals/text-editor-modal.html
@@ -0,0 +1,32 @@
+<!-- Simple Transcription Editor Modal -->
+<div v-if="showTextEditorModal" @click.self="closeTextEditorModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[90vh] flex flex-col">
+        <div class="p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <h3 class="text-lg font-semibold" v-text="t('modal.editTranscription')"></h3>
+                <button @click="closeTextEditorModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="p-6 space-y-4 overflow-y-auto flex-1">
+            <div>
+                <label class="block text-sm font-medium mb-2" v-text="t('transcription.title')"></label>
+                <textarea v-model="editingTranscriptionContent"
+                          rows="15"
+                          class="w-full px-3 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)] font-mono text-sm">
+                </textarea>
+            </div>
+        </div>
+        <div class="p-6 border-t border-[var(--border-primary)] flex justify-end gap-3">
+            <button @click="closeTextEditorModal"
+                    class="px-4 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-tertiary)] rounded-lg transition-colors">
+                Cancel
+            </button>
+            <button @click="saveTranscription"
+                    class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                Save Changes
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/toast-container.html b/templates/modals/toast-container.html
new file mode 100644
index 00000000..1c977e6c
--- /dev/null
+++ b/templates/modals/toast-container.html
@@ -0,0 +1,2 @@
+<!-- Toast Container -->
+<div id="toastContainer" class="fixed top-4 right-4 z-50 pointer-events-none"></div>
diff --git a/templates/modals/unified-share-modal.html b/templates/modals/unified-share-modal.html
new file mode 100644
index 00000000..769718a6
--- /dev/null
+++ b/templates/modals/unified-share-modal.html
@@ -0,0 +1,281 @@
+<!-- Unified Share Modal (Public + Internal Sharing) -->
+<div v-if="showUnifiedShareModal" @click.self="closeUnifiedShareModal" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-xl shadow-2xl w-full max-w-2xl max-h-[90vh] flex flex-col">
+        <div class="px-6 py-4 border-b border-[var(--border-primary)] flex-shrink-0">
+            <div class="flex items-center justify-between">
+                <div class="flex-1">
+                    <h3 class="text-lg font-semibold" v-text="t('modal.shareRecording')"></h3>
+                    <p class="text-sm text-[var(--text-muted)] mt-0.5">${internalShareRecording?.title}</p>
+                </div>
+                <button @click="closeUnifiedShareModal" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors ml-4">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+
+        <div class="flex-1 overflow-y-auto">
+            <!-- Public Sharing Section -->
+            <div v-if="!internalShareRecording?.is_shared || internalShareRecording?.share_info?.can_reshare" class="px-6 py-4 border-b border-[var(--border-primary)]">
+                <h4 class="font-medium mb-2 flex items-center gap-2">
+                    <i class="fas fa-globe text-[var(--text-accent)]"></i>
+                    <span v-text="t('sharing.publicLink')"></span>
+                </h4>
+
+                <p class="text-xs text-[var(--text-muted)] mb-3" v-text="t('help.publicLinkDesc')"></p>
+
+                <div class="space-y-3">
+                    <!-- Share Options -->
+                    <div class="flex items-center gap-4 mb-2">
+                        <label class="flex items-center cursor-pointer">
+                            <input type="checkbox" v-model="shareOptions.share_summary" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-2 text-sm" v-text="t('form.shareSummary')"></span>
+                        </label>
+                        <label class="flex items-center cursor-pointer">
+                            <input type="checkbox" v-model="shareOptions.share_notes" class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <span class="ml-2 text-sm" v-text="t('form.shareNotes')"></span>
+                        </label>
+                    </div>
+
+                    <!-- Create New Share Button -->
+                    <button @click="createShare(true)"
+                            class="w-full px-3 py-2 bg-[var(--bg-accent)] text-white rounded-lg hover:opacity-90 transition-opacity text-sm font-medium">
+                        <i class="fas fa-plus-circle mr-1.5"></i>Create New Public Share Link
+                    </button>
+
+                    <!-- Loading State -->
+                    <div v-if="isLoadingPublicShares" class="text-center py-6">
+                        <i class="fas fa-spinner fa-spin text-xl text-[var(--text-muted)]"></i>
+                        <p class="mt-2 text-xs text-[var(--text-muted)]">Loading share links...</p>
+                    </div>
+
+                    <!-- Existing Shares List -->
+                    <div v-else-if="recordingPublicShares.length > 0" class="space-y-2">
+                        <h5 class="text-xs font-medium text-[var(--text-secondary)] mb-1.5">
+                            Existing Share Links (${recordingPublicShares.length})
+                        </h5>
+                        <div v-for="share in recordingPublicShares" :key="share.id"
+                             class="bg-[var(--bg-tertiary)] p-2.5 rounded-lg border border-[var(--border-primary)]">
+                            <div class="flex items-center justify-between gap-2 mb-2">
+                                <div class="flex items-center gap-2 flex-1 min-w-0">
+                                    <i class="fas fa-calendar text-[var(--text-muted)] text-xs"></i>
+                                    <span class="text-xs text-[var(--text-muted)] truncate">Created: ${share.created_at}</span>
+                                    <span v-if="share.share_summary" class="inline-flex items-center px-1.5 py-0.5 rounded text-xs bg-blue-100 dark:bg-blue-900/30 text-blue-700 dark:text-blue-400">
+                                        <i class="fas fa-file-alt mr-1"></i>Summary
+                                    </span>
+                                    <span v-if="share.share_notes" class="inline-flex items-center px-1.5 py-0.5 rounded text-xs bg-green-100 dark:bg-green-900/30 text-green-700 dark:text-green-400">
+                                        <i class="fas fa-sticky-note mr-1"></i>Notes
+                                    </span>
+                                </div>
+                                <button @click="confirmDeletePublicShare(share)"
+                                        class="p-1.5 rounded hover:bg-red-50 dark:hover:bg-red-900/20 text-[var(--text-muted)] hover:text-red-500 transition-colors"
+                                        :title="'Delete share link'">
+                                    <i class="fas fa-trash text-xs"></i>
+                                </button>
+                            </div>
+                            <div class="relative">
+                                <input :value="share.share_url" :id="'unified-share-link-' + share.id" readonly
+                                       class="w-full px-2 py-1.5 pr-10 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded text-xs font-mono focus:outline-none focus:ring-2 focus:ring-[var(--ring-focus)]">
+                                <button @click="copyPublicShareLinkWithFeedback(share.share_url, share.id)"
+                                        class="absolute right-1 top-1/2 -translate-y-1/2 w-8 h-7 flex items-center justify-center rounded bg-[var(--bg-button)] text-[var(--text-button)] hover:bg-[var(--bg-button-hover)] transition-all"
+                                        :title="t('buttons.copy')">
+                                    <i :class="copiedShareId === share.id ? 'fas fa-check' : 'fas fa-copy'" class="text-xs"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- No Shares Yet -->
+                    <div v-else-if="!isLoadingPublicShares" class="text-center py-4 text-xs text-[var(--text-muted)]">
+                        <i class="fas fa-link text-xl mb-1"></i>
+                        <p>No public share links yet</p>
+                        <p class="text-xs mt-0.5 opacity-75">Click the button above to create one</p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Internal Sharing Section -->
+            <div v-if="enableInternalSharing && (!internalShareRecording?.is_shared || internalShareRecording?.share_info?.can_reshare)" class="px-6 py-4">
+                <h4 class="font-medium mb-2 flex items-center gap-2">
+                    <i class="fas fa-users text-[var(--text-accent)]"></i>
+                    <span v-text="t('sharing.internalSharing')"></span>
+                </h4>
+
+                <p class="text-xs text-[var(--text-muted)] mb-3" v-text="t('help.internalSharingDesc')"></p>
+
+                <!-- Share with New User Section -->
+                <div class="bg-[var(--bg-tertiary)] p-3 rounded-lg border border-[var(--border-primary)] mb-3">
+                    <h5 class="font-medium text-sm text-[var(--text-primary)] mb-2 flex items-center">
+                        <i class="fas fa-user-plus mr-1.5 text-blue-500 text-xs"></i>
+                        Share with User
+                    </h5>
+
+                    <!-- User Search/Selection (when SHOW_USERNAMES_IN_UI is enabled) -->
+                    <div v-if="showUsernamesInUI" class="space-y-3">
+                        <!-- Search Input (for filtering) -->
+                        <div class="relative">
+                            <input v-model="internalShareUserSearch"
+                                   @input="searchInternalShareUsers()"
+                                   type="text"
+                                   placeholder="Search users..."
+                                   class="w-full px-4 py-2 pl-10 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                            <i class="fas fa-search absolute left-3 top-3 text-[var(--text-muted)]"></i>
+                        </div>
+
+                        <!-- User Grid -->
+                        <div v-if="isLoadingAllUsers" class="text-center py-8">
+                            <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                            <p class="mt-2 text-sm text-[var(--text-muted)]">Loading users...</p>
+                        </div>
+                        <div v-else-if="internalShareSearchResults.length === 0" class="text-center py-8 text-[var(--text-muted)]">
+                            <i class="fas fa-users-slash text-3xl mb-2"></i>
+                            <p>No users found</p>
+                        </div>
+                        <div v-else class="grid grid-cols-1 sm:grid-cols-2 gap-2 max-h-[50vh] sm:max-h-64 overflow-y-auto">
+                            <div v-for="user in internalShareSearchResults" :key="user.id"
+                                 @click="createInternalShare(user.id, user.username)"
+                                 class="group p-3 sm:p-2 bg-[var(--bg-secondary)] hover:bg-[var(--bg-hover)] rounded-lg border border-[var(--border-secondary)] hover:border-blue-500 cursor-pointer transition-all active:scale-[0.98]">
+                                <div class="flex items-center gap-3 sm:gap-2">
+                                    <div :class="['w-10 h-10 sm:w-8 sm:h-8 rounded-full flex items-center justify-center flex-shrink-0 font-bold text-sm sm:text-xs', getUserColorClass(user.username)]">
+                                        ${user.username ? user.username.charAt(0).toUpperCase() : '?'}
+                                    </div>
+                                    <div class="flex-1 min-w-0">
+                                        <p class="font-medium text-base sm:text-sm text-[var(--text-primary)] truncate">${user.username}</p>
+                                        <p v-if="user.email" class="text-sm sm:text-xs text-[var(--text-muted)] truncate">${user.email}</p>
+                                    </div>
+                                    <i class="fas fa-user-plus text-blue-500 text-lg sm:text-base group-hover:scale-110 transition-transform flex-shrink-0"></i>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Direct Username Entry (when SHOW_USERNAMES_IN_UI is disabled - Privacy Mode) -->
+                    <div v-else class="space-y-3">
+                        <p class="text-sm text-[var(--text-muted)]">Enter the exact username to share with</p>
+                        <div class="flex gap-2">
+                            <input v-model="internalShareUserSearch"
+                                   @keyup.enter="shareWithUsername()"
+                                   type="text"
+                                   placeholder="Enter full username..."
+                                   class="flex-1 px-4 py-2 bg-[var(--bg-input)] border border-[var(--border-secondary)] rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                            <button @click="shareWithUsername()"
+                                    :disabled="!internalShareUserSearch.trim() || isSearchingUsers"
+                                    class="px-4 py-2 bg-blue-500 text-white rounded-lg hover:bg-blue-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors">
+                                <i v-if="isSearchingUsers" class="fas fa-spinner fa-spin"></i>
+                                <span v-else>Add</span>
+                            </button>
+                        </div>
+                        <p class="text-xs text-[var(--text-muted)]">
+                            <i class="fas fa-info-circle mr-1"></i>
+                            You must enter the exact username. If the user exists, they will be added to the share list.
+                        </p>
+                    </div>
+
+                    <!-- Permissions -->
+                    <div class="border-t border-[var(--border-primary)] mt-3 pt-2.5 space-y-1.5">
+                        <p class="text-xs font-medium text-[var(--text-secondary)] mb-1.5">Share Permissions</p>
+                        <div class="flex items-center">
+                            <input type="checkbox"
+                                   v-model="internalSharePermissions.can_edit"
+                                   :disabled="!internalShareMaxPermissions.can_edit"
+                                   id="unified_share_can_edit"
+                                   class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500 disabled:opacity-50 disabled:cursor-not-allowed">
+                            <label for="unified_share_can_edit"
+                                   :class="['ml-2 block text-sm', internalShareMaxPermissions.can_edit ? 'text-[var(--text-secondary)]' : 'text-[var(--text-muted)] opacity-60']">
+                                <i class="fas fa-pencil-alt mr-1"></i>Allow editing notes and metadata
+                                <span v-if="!internalShareMaxPermissions.can_edit" class="text-xs italic ml-1">(You don't have this permission)</span>
+                            </label>
+                        </div>
+                        <div class="flex items-center">
+                            <input type="checkbox"
+                                   v-model="internalSharePermissions.can_reshare"
+                                   :disabled="!internalShareMaxPermissions.can_reshare"
+                                   id="unified_share_can_reshare"
+                                   class="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500 disabled:opacity-50 disabled:cursor-not-allowed">
+                            <label for="unified_share_can_reshare"
+                                   :class="['ml-2 block text-sm', internalShareMaxPermissions.can_reshare ? 'text-[var(--text-secondary)]' : 'text-[var(--text-muted)] opacity-60']">
+                                <i class="fas fa-share-alt mr-1"></i>Allow re-sharing with others
+                                <span v-if="!internalShareMaxPermissions.can_reshare" class="text-xs italic ml-1">(You don't have this permission)</span>
+                            </label>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Already Shared With Section -->
+                <div class="bg-[var(--bg-tertiary)] p-3 rounded-lg border border-[var(--border-primary)]">
+                    <h5 class="font-medium text-sm text-[var(--text-primary)] mb-2 flex items-center justify-between">
+                        <span class="flex items-center">
+                            <i class="fas fa-users-cog mr-1.5 text-purple-500 text-xs"></i>
+                            Already Shared With
+                        </span>
+                        <span v-if="recordingInternalShares.length > 0" class="text-xs font-normal text-[var(--text-muted)]">
+                            ${recordingInternalShares.length} user(s)
+                        </span>
+                    </h5>
+
+                    <div v-if="isLoadingInternalShares" class="text-center py-8">
+                        <i class="fas fa-spinner fa-spin text-2xl text-[var(--text-muted)]"></i>
+                        <p class="mt-2 text-sm text-[var(--text-muted)]">Loading shares...</p>
+                    </div>
+                    <div v-else-if="recordingInternalShares.length === 0" class="text-center py-8 text-[var(--text-muted)]">
+                        <i class="fas fa-user-slash text-3xl mb-3"></i>
+                        <p>Not shared with anyone yet</p>
+                        <p class="text-sm mt-1">Select a user above to share this recording</p>
+                    </div>
+                    <div v-else class="grid grid-cols-1 sm:grid-cols-2 gap-2 max-h-[50vh] sm:max-h-64 overflow-y-auto">
+                        <div v-for="share in recordingInternalShares" :key="share.user_id"
+                             class="bg-[var(--bg-secondary)] p-3 sm:p-2 rounded-lg border border-[var(--border-secondary)] hover:border-[var(--border-primary)] transition-colors">
+                            <div class="flex items-center gap-3 sm:gap-2">
+                                <div :class="['w-10 h-10 sm:w-8 sm:h-8 rounded-full flex items-center justify-center flex-shrink-0 font-bold text-sm sm:text-xs', getUserColorClass(share.username)]">
+                                    ${share.username ? share.username.charAt(0).toUpperCase() : '#'}
+                                </div>
+                                <div class="flex-1 min-w-0">
+                                    <p class="font-medium text-base sm:text-sm text-[var(--text-primary)] truncate">${share.username || 'User #' + share.user_id}</p>
+                                    <p class="text-sm sm:text-xs text-[var(--text-muted)] mb-1 sm:mb-0.5">${share.is_owner ? 'Recording Owner' : formatShareDate(share.created_at)}</p>
+                                    <div class="flex flex-wrap gap-1 text-xs sm:text-[10px]">
+                                        <span v-if="share.is_owner" class="inline-flex items-center px-2 py-0.5 sm:px-1.5 rounded bg-yellow-100 dark:bg-yellow-900/30 text-yellow-700 dark:text-yellow-400 font-medium">
+                                            <i class="fas fa-crown mr-1 sm:mr-0.5 text-xs sm:text-[9px]"></i>Owner
+                                        </span>
+                                        <template v-else>
+                                            <span v-if="share.can_edit" class="inline-flex items-center px-2 py-0.5 sm:px-1.5 rounded bg-green-100 dark:bg-green-900/30 text-green-700 dark:text-green-400">
+                                                <i class="fas fa-pencil-alt mr-1 sm:mr-0.5 text-xs sm:text-[8px]"></i>Edit
+                                            </span>
+                                            <span v-if="share.can_reshare" class="inline-flex items-center px-2 py-0.5 sm:px-1.5 rounded bg-blue-100 dark:bg-blue-900/30 text-blue-700 dark:text-blue-400">
+                                                <i class="fas fa-share-alt mr-1 sm:mr-0.5 text-xs sm:text-[8px]"></i>Reshare
+                                            </span>
+                                            <span v-if="!share.can_edit && !share.can_reshare" class="inline-flex items-center px-2 py-0.5 sm:px-1.5 rounded bg-gray-100 dark:bg-gray-800 text-gray-700 dark:text-gray-400">
+                                                <i class="fas fa-eye mr-1 sm:mr-0.5 text-xs sm:text-[8px]"></i>View
+                                            </span>
+                                        </template>
+                                    </div>
+                                </div>
+                                <button v-if="!share.is_owner"
+                                        @click="revokeInternalShare(share.id, share.username || share.user_name)"
+                                        class="p-2 sm:p-1.5 rounded-lg text-red-500 hover:bg-red-50 dark:hover:bg-red-900/20 active:scale-95 transition-all flex-shrink-0"
+                                        :title="'Revoke access'">
+                                    <i class="fas fa-user-times text-base sm:text-xs"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- No Permission Message -->
+        <div v-if="internalShareRecording?.is_shared && !internalShareRecording?.share_info?.can_reshare" class="px-6 py-6 text-center">
+            <div class="bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg p-4">
+                <i class="fas fa-info-circle text-yellow-600 dark:text-yellow-400 text-2xl mb-2"></i>
+                <p class="text-sm text-yellow-800 dark:text-yellow-300 font-medium">Sharing Not Available</p>
+                <p class="text-xs text-yellow-700 dark:text-yellow-400 mt-1">
+                    This recording was shared with you, but you don't have permission to share it with others.
+                </p>
+            </div>
+        </div>
+
+        <div class="px-6 py-3 border-t border-[var(--border-primary)] flex justify-end flex-shrink-0">
+            <button @click="closeUnifiedShareModal" class="px-4 py-2 bg-[var(--bg-button)] text-[var(--text-button)] rounded-lg hover:bg-[var(--bg-button-hover)] transition-colors">
+                <span v-text="t('tagsModal.done')"></span>
+            </button>
+        </div>
+    </div>
+</div>
diff --git a/templates/modals/upload-disclaimer-modal.html b/templates/modals/upload-disclaimer-modal.html
new file mode 100644
index 00000000..554e7985
--- /dev/null
+++ b/templates/modals/upload-disclaimer-modal.html
@@ -0,0 +1,36 @@
+<!-- Upload Disclaimer Modal -->
+<div v-if="showUploadDisclaimerModal" @click.self="cancelUploadDisclaimer" class="fixed inset-0 bg-black bg-opacity-70 flex items-center justify-center z-50 p-4 backdrop-blur-sm">
+    <div class="bg-[var(--bg-secondary)] rounded-lg shadow-xl w-full max-w-2xl max-h-[80vh] flex flex-col overflow-hidden">
+        <div class="flex-shrink-0 p-6 border-b border-[var(--border-primary)]">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <i class="fas fa-info-circle text-2xl text-[var(--text-accent)]"></i>
+                    <h3 class="text-xl font-semibold text-[var(--text-primary)]" v-text="t('modal.uploadNotice')"></h3>
+                </div>
+                <button @click="cancelUploadDisclaimer" class="text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-colors">
+                    <i class="fas fa-times text-xl"></i>
+                </button>
+            </div>
+        </div>
+        <div class="flex-1 overflow-y-auto p-6">
+            <!-- Render markdown content -->
+            <div class="ai-message text-[var(--text-secondary)]"
+                 style="line-height: 1.6;">
+                <div v-html="uploadDisclaimerHtml"></div>
+            </div>
+        </div>
+        <div class="flex-shrink-0 p-6 border-t border-[var(--border-primary)] bg-[var(--bg-tertiary)] rounded-b-lg">
+            <div class="flex justify-end gap-3">
+                <button @click="cancelUploadDisclaimer"
+                        class="px-6 py-2 text-[var(--text-secondary)] hover:bg-[var(--bg-secondary)] rounded-lg transition-colors border border-[var(--border-secondary)]">
+                    ${ t('buttons.cancel') }
+                </button>
+                <button @click="acceptUploadDisclaimer"
+                        class="px-6 py-2 bg-[var(--bg-accent)] text-white rounded-lg hover:bg-[var(--bg-accent-hover)] transition-colors">
+                    <i class="fas fa-upload mr-2"></i>
+                    <span v-text="t('modal.uploadFiles')"></span>
+                </button>
+            </div>
+        </div>
+    </div>
+</div>
diff --git a/templates/register.html b/templates/register.html
index 95692c70..f39468e0 100644
--- a/templates/register.html
+++ b/templates/register.html
@@ -3,103 +3,61 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
     <title>{{ title }} - Speakr</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
-    <style>
-        /* Dark Mode CSS Variables */
-        :root {
-            /* Light mode variables */
-            --bg-primary: #f3f4f6; /* gray-100 */
-            --bg-secondary: #ffffff; /* white */
-            --bg-tertiary: #f9fafb; /* gray-50 */
-            --bg-accent: #dbeafe; /* blue-100 */
-            --bg-accent-hover: #bfdbfe; /* blue-200 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #1d4ed8; /* blue-700 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #b91c1c; /* red-700 */
-            --bg-danger-light: #fee2e2; /* red-100 */
-            --bg-info-light: #dbeafe; /* blue-100 */
-            --bg-warn-light: #fef3c7; /* amber-100 */
-            --bg-success-light: #d1fae5; /* green-100 */
-            --bg-pending-light: #f5f5f4; /* stone-100 */
-            --bg-input: #ffffff; /* white */
+    <link rel="icon" href="{{ url_for('static', filename='img/favicon.ico') }}" type="image/svg+xml">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
 
-            --text-primary: #1f2937; /* gray-800 */
-            --text-secondary: #374151; /* gray-700 */
-            --text-muted: #6b7280; /* gray-500 */
-            --text-light: #9ca3af; /* gray-400 */
-            --text-accent: #1d4ed8; /* blue-700 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #b91c1c; /* red-700 */
-            --text-danger-strong: #991b1b; /* red-800 */
-            --text-info-strong: #1e40af; /* blue-800 */
-            --text-warn-strong: #92400e; /* amber-800 */
-            --text-success-strong: #065f46; /* green-800 */
-            --text-pending-strong: #44403c; /* stone-700 */
+    <!-- Loading overlay to prevent FOUC -->
+    {% include 'includes/loading_overlay.html' %}
 
-            --border-primary: #e5e7eb; /* gray-200 */
-            --border-secondary: #d1d5db; /* gray-300 */
-            --border-accent: #93c5fd; /* blue-300 */
-            --border-danger: #f87171; /* red-400 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #bfdbfe; /* blue-200 */
-        }
-
-        .dark {
-            /* Dark mode variables */
-            --bg-primary: #111827; /* gray-900 */
-            --bg-secondary: #1f2937; /* gray-800 */
-            --bg-tertiary: #374151; /* gray-700 */
-            --bg-accent: #1e3a8a; /* blue-900 */
-            --bg-accent-hover: #1e40af; /* blue-800 */
-            --bg-button: #2563eb; /* blue-600 */
-            --bg-button-hover: #3b82f6; /* blue-500 */
-            --bg-danger: #dc2626; /* red-600 */
-            --bg-danger-hover: #ef4444; /* red-500 */
-            --bg-danger-light: #7f1d1d; /* red-900 */
-            --bg-info-light: #1e3a8a; /* blue-900 */
-            --bg-warn-light: #78350f; /* amber-900 */
-            --bg-success-light: #064e3b; /* green-900 */
-            --bg-pending-light: #292524; /* stone-800 */
-            --bg-input: #374151; /* gray-700 */
+    <script>
+        // Function to apply the theme based on localStorage
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
 
-            --text-primary: #f3f4f6; /* gray-100 */
-            --text-secondary: #d1d5db; /* gray-300 */
-            --text-muted: #9ca3af; /* gray-400 */
-            --text-light: #6b7280; /* gray-500 */
-            --text-accent: #60a5fa; /* blue-400 */
-            --text-button: #ffffff; /* white */
-            --text-danger: #f87171; /* red-400 */
-            --text-danger-strong: #fca5a5; /* red-300 */
-            --text-info-strong: #93c5fd; /* blue-300 */
-            --text-warn-strong: #fcd34d; /* amber-300 */
-            --text-success-strong: #6ee7b7; /* green-300 */
-            --text-pending-strong: #d6d3d1; /* stone-300 */
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
 
-            --border-primary: #374151; /* gray-700 */
-            --border-secondary: #4b5563; /* gray-600 */
-            --border-accent: #1d4ed8; /* blue-700 */
-            --border-danger: #ef4444; /* red-500 */
-            --border-focus: #3b82f6; /* blue-500 */
-            --ring-focus: #1e40af; /* blue-800 */
-        }
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+            
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
 
-        html {
-            background-color: var(--bg-primary); 
-            color: var(--text-primary); 
-            transition: background-color 0.3s, color 0.3s; 
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
         }
-        html, body { height: 100%; margin: 0; }
-    </style>
+        applyTheme();
+    </script>
 </head>
 <body class="bg-[var(--bg-primary)] text-[var(--text-primary)]">
     <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-6 flex flex-col min-h-screen">
         <header class="flex justify-between items-center mb-6 pb-4 border-b border-[var(--border-primary)]">
             <h1 class="text-3xl font-bold text-[var(--text-primary)]">
-                <a href="{{ url_for('index') }}">Speakr</a>
+                <a href="{{ url_for('recordings.index') }}" class="flex items-center">
+                    <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr Logo" class="h-9 w-9 mr-2">
+                    Speakr
+                </a>
             </h1>
         </header>
 
@@ -117,7 +75,7 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">C
                     {% endif %}
                 {% endwith %}
                 
-                <form method="POST" action="{{ url_for('register') }}">
+                <form method="POST" action="{{ url_for('auth.register') }}">
                     {{ form.hidden_tag() }}
                     
                     <div class="mb-4">
@@ -182,7 +140,7 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">C
                         
                         <div class="text-center text-sm text-[var(--text-muted)]">
                             <span>Already have an account?</span>
-                            <a href="{{ url_for('login') }}" class="font-medium text-[var(--text-accent)] hover:underline">Login here</a>
+                            <a href="{{ url_for('auth.login') }}" class="font-medium text-[var(--text-accent)] hover:underline">Login here</a>
                         </div>
                     </div>
                 </form>
@@ -193,5 +151,14 @@ <h2 class="text-2xl font-semibold text-[var(--text-primary)] mb-6 text-center">C
             Speakr &copy; {{ now.year }}
         </footer>
     </div>
+
+    <script>
+        // Hide loading overlay when page is ready
+        document.addEventListener('DOMContentLoaded', function() {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
 </body>
 </html>
diff --git a/templates/share.html b/templates/share.html
new file mode 100644
index 00000000..92711fca
--- /dev/null
+++ b/templates/share.html
@@ -0,0 +1,914 @@
+<!DOCTYPE html>
+<html lang="en" class="h-full">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet, noimageindex">
+    <title>Shared Recording - {{ recording.title }}</title>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/tailwind.min.js') }}"></script>
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/vue.global.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<script src="{{ url_for('static', filename='vendor/js/axios.min.js') }}"></script>
+        <!-- All dependencies bundled locally for offline support -->
+<link rel="stylesheet" href="{{ url_for('static', filename='vendor/css/fontawesome.min.css') }}">
+
+    <!-- Loading overlay to prevent FOUC -->
+    {% include 'includes/loading_overlay.html' %}
+
+    <script>
+        tailwind.config = {
+            darkMode: 'class',
+            theme: {
+                extend: {
+                    maxHeight: {
+                        '85vh': '85vh',
+                        '90vh': '90vh'
+                    },
+                    colors: {
+                        primary: 'var(--bg-primary)',
+                        secondary: 'var(--bg-secondary)',
+                        accent: 'var(--bg-accent)'
+                    }
+                }
+            }
+        }
+
+        // Function to apply the theme based on localStorage and system preference
+        function applyTheme() {
+            // Guard against early execution
+            if (!document.documentElement) return;
+
+            // Apply dark mode
+            const savedMode = localStorage.getItem('darkMode');
+            const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            if (savedMode === 'true' || (savedMode === null && prefersDark)) {
+                document.documentElement.classList.add('dark');
+            } else {
+                document.documentElement.classList.remove('dark');
+            }
+
+            // Apply color scheme
+            const savedScheme = localStorage.getItem('colorScheme') || 'blue';
+            const isDark = document.documentElement.classList.contains('dark');
+            const themePrefix = isDark ? 'theme-dark-' : 'theme-light-';
+
+            // Remove all other theme classes
+            const themeClasses = ['blue', 'emerald', 'purple', 'rose', 'amber', 'teal'];
+            themeClasses.forEach(theme => {
+                document.documentElement.classList.remove(`theme-light-${theme}`);
+                document.documentElement.classList.remove(`theme-dark-${theme}`);
+            });
+
+            // Add the correct theme class
+            if (savedScheme !== 'blue') {
+                 document.documentElement.classList.add(themePrefix + savedScheme);
+            }
+        }
+
+        // Wait for DOM to be ready before applying theme
+        if (document.readyState === 'loading') {
+            document.addEventListener('DOMContentLoaded', applyTheme);
+        } else {
+            applyTheme();
+        }
+    </script>
+</head>
+<body class="h-full bg-[var(--bg-primary)] text-[var(--text-primary)] transition-colors duration-300">
+    <div id="app" class="h-full flex flex-col" data-recording='{{ recording|tojson|safe }}'>
+        <!-- Header -->
+        <header class="bg-[var(--bg-secondary)] border-b border-[var(--border-primary)] px-4 py-3 flex items-center justify-between flex-shrink-0 z-50">
+            <div class="flex items-center gap-3">
+                <img src="{{ url_for('static', filename='img/favicon.ico') }}" alt="Speakr" class="w-8 h-8">
+                <div>
+                    <h1 class="text-xl font-bold text-[var(--text-primary)]">${ recording.title }</h1>
+                    <p class="text-sm text-[var(--text-muted)]">Shared Recording</p>
+                </div>
+            </div>
+            <div class="flex items-center gap-2">
+                <button @click="toggleDarkMode"
+                        class="p-2 rounded-lg hover:bg-[var(--bg-tertiary)] transition-colors"
+                        title="Toggle Theme">
+                    <i :class="isDarkMode ? 'fas fa-sun' : 'fas fa-moon'"></i>
+                </button>
+            </div>
+        </header>
+
+        <!-- Main Content -->
+        <main class="flex-1 flex flex-col overflow-hidden">
+            <!-- Audio Player - Fixed at top -->
+            <div class="bg-[var(--bg-secondary)] p-4 border-b border-[var(--border-primary)] flex-shrink-0">
+                <div class="max-w-4xl mx-auto">
+                    <!-- Show message if audio has been deleted -->
+                    <div v-if="recording.audio_deleted_at"
+                         class="bg-[var(--bg-tertiary)] border border-[var(--border-primary)] text-[var(--text-muted)] px-4 py-3 rounded-lg flex items-center gap-2 text-sm">
+                        <i class="fas fa-info-circle"></i>
+                        <span>Audio file has been archived and is no longer available for playback.</span>
+                    </div>
+                    <!-- Custom Audio/Video Player -->
+                    <div v-else>
+                        <component :is="recording.mime_type && recording.mime_type.startsWith('video/') ? 'video' : 'audio'"
+                               ref="audioPlayer"
+                               :class="recording.mime_type && recording.mime_type.startsWith('video/') ? 'w-full rounded-lg mb-3' : 'hidden'"
+                               :src="'/share/audio/' + recording.public_id"
+                               @play="handleAudioPlayPause"
+                               @pause="handleAudioPlayPause"
+                               @timeupdate="handleCustomAudioTimeUpdate"
+                               @loadedmetadata="handleAudioLoadedMetadata"
+                               @durationchange="handleAudioDurationChange"
+                               @ended="handleAudioEnded">
+                        </component>
+                        <div class="flex items-center gap-3">
+                        <!-- Play/Pause -->
+                        <button @click="toggleAudioPlayback"
+                                class="w-10 h-10 flex items-center justify-center rounded-full bg-[var(--bg-accent)] hover:bg-[var(--bg-accent-hover)] text-white transition-all flex-shrink-0 shadow-sm"
+                                :title="audioIsPlaying ? 'Pause' : 'Play'">
+                            <i :class="audioIsPlaying ? 'fas fa-pause' : 'fas fa-play'" class="text-sm" :style="!audioIsPlaying ? 'margin-left: 2px' : ''"></i>
+                        </button>
+                        <!-- Time -->
+                        <div class="flex flex-col items-end flex-shrink-0 leading-none">
+                            <span class="text-sm text-[var(--text-primary)] font-mono">${ formatAudioTime(audioCurrentTime) }</span>
+                            <span class="text-xs text-[var(--text-muted)] font-mono">${ formatAudioTime(audioDuration) }</span>
+                        </div>
+                        <!-- Playback Speed Control -->
+                        <div class="relative flex-shrink-0">
+                            <button @click="showSpeedMenu = !showSpeedMenu"
+                                    class="w-8 h-8 flex items-center justify-center rounded-lg hover:bg-[var(--bg-tertiary)] text-[var(--text-accent)] hover:opacity-80 transition-all"
+                                    title="Playback speed">
+                                <span class="text-xs font-semibold font-mono">${ formatPlaybackRate(playbackRate) }</span>
+                            </button>
+                            <!-- Dropdown menu (opens downward) -->
+                            <div v-if="showSpeedMenu" @click.stop
+                                 class="absolute top-full mt-1 left-1/2 -translate-x-1/2 bg-[var(--bg-tertiary)] border border-[var(--border-accent)] rounded-md shadow-xl z-50 speed-dropdown backdrop-blur-sm">
+                                <div class="py-0.5 max-h-40 overflow-y-auto">
+                                    <button v-for="speed in playbackSpeeds" :key="speed"
+                                            @mousedown.prevent="setPlaybackRate(speed); showSpeedMenu = false"
+                                            class="w-full px-2 py-0.5 text-[11px] font-mono text-left hover:bg-[var(--bg-accent-light)] transition-colors"
+                                            :class="speed === playbackRate ? 'text-[var(--text-accent)] font-semibold bg-[var(--bg-accent-light)]' : 'text-[var(--text-primary)]'">
+                                        ${ speed }x
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+                        <!-- Progress Bar -->
+                        <div class="flex-1 h-2 bg-[var(--bg-tertiary)] rounded-full cursor-pointer group relative"
+                             @click="(e) => { const rect = e.currentTarget.getBoundingClientRect(); seekAudioByPercent(((e.clientX - rect.left) / rect.width) * 100); }">
+                            <div class="h-full bg-[var(--bg-accent)] rounded-full transition-all duration-100"
+                                 :style="{ width: audioProgressPercent + '%' }">
+                            </div>
+                        </div>
+                        <!-- Volume -->
+                        <div class="flex items-center gap-2 flex-shrink-0">
+                            <button @click="toggleAudioMute"
+                                    class="w-8 h-8 flex items-center justify-center rounded hover:bg-[var(--bg-tertiary)] text-[var(--text-muted)] hover:text-[var(--text-primary)] transition-all">
+                                <i :class="audioIsMuted || playerVolume === 0 ? 'fas fa-volume-mute' : 'fas fa-volume-up'" class="text-sm"></i>
+                            </button>
+                            <input type="range" min="0" max="1" step="0.05" :value="playerVolume"
+                                   @input="(e) => setAudioVolume(parseFloat(e.target.value))"
+                                   class="volume-slider w-20 h-1.5 rounded-full cursor-pointer">
+                        </div>
+                    </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Tab Navigation - Fixed below audio player -->
+            <div class="bg-[var(--bg-tertiary)] border-b border-[var(--border-primary)] flex-shrink-0">
+                <div class="max-w-4xl mx-auto">
+                    <div class="flex">
+                        <button @click="activeTab = 'transcription'"
+                                :class="[
+                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                    activeTab === 'transcription'
+                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                ]">
+                            <i class="fas fa-file-text mr-2"></i>Transcription
+                        </button>
+                        {% if recording.summary %}
+                        <button @click="activeTab = 'summary'"
+                                :class="[
+                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                    activeTab === 'summary'
+                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                ]">
+                            <i class="fas fa-file-alt mr-2"></i>Summary
+                        </button>
+                        {% endif %}
+                        {% if recording.notes %}
+                        <button @click="activeTab = 'notes'"
+                                :class="[
+                                    'flex-1 px-4 py-3 text-sm font-medium transition-colors',
+                                    activeTab === 'notes'
+                                        ? 'bg-[var(--bg-secondary)] text-[var(--text-accent)] border-b-2 border-[var(--border-focus)]'
+                                        : 'text-[var(--text-muted)] hover:text-[var(--text-secondary)]'
+                                ]">
+                            <i class="fas fa-sticky-note mr-2"></i>Notes
+                        </button>
+                        {% endif %}
+                    </div>
+                </div>
+            </div>
+
+            <!-- Tab Content - Fixed height container -->
+            <div class="flex-1 flex flex-col overflow-hidden">
+                <div class="w-full max-w-4xl mx-auto p-4 flex-1 flex flex-col overflow-hidden">
+                    <!-- Transcription View -->
+                    <div v-show="activeTab === 'transcription'" class="w-full flex-1 flex flex-col overflow-hidden">
+                        <!-- Transcription Controls -->
+                        <div class="flex items-center justify-between mb-4 flex-shrink-0">
+                            <div v-if="readableMode ? hasDialogue : processedTranscription.hasDialogue" class="view-mode-toggle">
+                                <button @click="transcriptView = 'simple'"
+                                        :class="['toggle-button', transcriptView === 'simple' ? 'active' : '']">
+                                    <i class="fas fa-list mr-1"></i>Simple
+                                </button>
+                                <button @click="transcriptView = 'bubble'"
+                                        :class="['toggle-button', transcriptView === 'bubble' ? 'active' : '']">
+                                    <i class="fas fa-comments mr-1"></i>Bubble
+                                </button>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                <div v-if="!recording.audio_deleted_at && (readableMode ? hasDialogue : processedTranscription.hasDialogue)"
+                                     class="follow-player-control text-[var(--text-muted)] hover:text-[var(--text-primary)] cursor-pointer"
+                                     @click="toggleFollowPlayerMode"
+                                     :title="followPlayerMode ? 'Auto-scroll enabled' : 'Auto-scroll disabled'">
+                                    <input type="checkbox"
+                                           :checked="followPlayerMode"
+                                           @click.stop="toggleFollowPlayerMode"
+                                           class="cursor-pointer">
+                                    <i class="fas fa-arrows-alt-v follow-icon"></i>
+                                </div>
+                                <button @click="copyTranscript" class="copy-btn">
+                                    <i class="fas fa-copy mr-1"></i>Copy
+                                </button>
+                            </div>
+                        </div>
+
+                        {% if readable_mode and transcript %}
+                        <!-- SERVER-RENDERED VERSION (for READABLE_PUBLIC_LINKS mode) -->
+                        <!-- Speaker Legend (only for bubble view) -->
+                        {% if transcript.has_speakers and transcript.speakers %}
+                        <div v-show="transcriptView === 'bubble'"
+                             :class="['speaker-legend', legendExpanded ? 'expanded' : '', 'flex-shrink-0', 'mb-4']">
+                            <div class="speaker-legend-header" @click="legendExpanded = !legendExpanded">
+                                <div class="speaker-legend-title">
+                                    <i class="fas fa-users"></i>
+                                    Speakers
+                                    <span class="speaker-count-indicator">({{ transcript.speakers|length }})</span>
+                                </div>
+                                <i class="fas fa-chevron-down speaker-legend-toggle"></i>
+                            </div>
+                            <div class="speaker-legend-content">
+                                {% for speaker in transcript.speakers %}
+                                <div class="speaker-legend-item {{ speaker.color }}">
+                                    <span class="speaker-name">{{ speaker.name }}</span>
+                                </div>
+                                {% endfor %}
+                            </div>
+                        </div>
+                        {% endif %}
+
+                        <!-- Transcription Content - Scrollable Box (Server-rendered for accessibility) -->
+                        <div class="w-full flex-1 overflow-y-auto transcription-box" @click="handleTranscriptClick">
+                            {% if transcript.is_json and transcript.segments %}
+                            <!-- Simple View (server-rendered) -->
+                            <div v-show="transcriptView === 'simple'" class="transcription-simple-view">
+                                {% for segment in transcript.segments %}
+                                <div class="speaker-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors mb-2"
+                                     data-start-time="{{ segment.start_time }}"
+                                     data-end-time="{{ segment.end_time }}"
+                                     data-segment-index="{{ loop.index0 }}"
+                                     style="margin-bottom: 0.5rem !important;">
+                                    {% if segment.show_speaker and segment.speaker %}
+                                    <div class="speaker-tablet {{ segment.color }}">{{ segment.speaker }}</div>
+                                    {% endif %}
+                                    <div class="speaker-text">{{ segment.text }}</div>
+                                </div>
+                                {% endfor %}
+                            </div>
+
+                            <!-- Bubble View (server-rendered) -->
+                            <div v-show="transcriptView === 'bubble'" class="transcription-with-speakers">
+                                {% set ns = namespace(last_speaker=None) %}
+                                {% for segment in transcript.segments %}
+                                {% if segment.speaker != ns.last_speaker %}
+                                {% if not loop.first %}</div>{% endif %}
+                                <div class="bubble-row {% if segment.speaker and 'me' in segment.speaker|lower %}speaker-me{% endif %}">
+                                {% endif %}
+                                    <div class="speaker-bubble {{ segment.color }} {% if segment.speaker and 'me' in segment.speaker|lower %}speaker-me{% endif %} cursor-pointer"
+                                         data-start-time="{{ segment.start_time }}"
+                                         data-end-time="{{ segment.end_time }}"
+                                         data-segment-index="{{ loop.index0 }}">
+                                        <div class="speaker-bubble-content">{{ segment.text }}</div>
+                                    </div>
+                                {% set ns.last_speaker = segment.speaker %}
+                                {% endfor %}
+                                {% if transcript.segments %}</div>{% endif %}
+                            </div>
+                            {% else %}
+                            <!-- Plain Text View (for non-JSON transcriptions) -->
+                            <div class="whitespace-pre-wrap cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors">{{ transcript.plain_text }}</div>
+                            {% endif %}
+                        </div>
+                        {% else %}
+                        <!-- VUE-RENDERED VERSION (default) -->
+                        <!-- Speaker Legend (only for bubble view) -->
+                        <div v-if="processedTranscription.hasDialogue && processedTranscription.speakers.length > 0 && transcriptView === 'bubble'"
+                             :class="['speaker-legend', legendExpanded ? 'expanded' : '', 'flex-shrink-0', 'mb-4']">
+                            <div class="speaker-legend-header" @click="legendExpanded = !legendExpanded">
+                                <div class="speaker-legend-title">
+                                    <i class="fas fa-users"></i>
+                                    Speakers
+                                    <span class="speaker-count-indicator">(${processedTranscription.speakers.length})</span>
+                                </div>
+                                <i class="fas fa-chevron-down speaker-legend-toggle"></i>
+                            </div>
+                            <div class="speaker-legend-content">
+                                <div v-for="(speaker, index) in processedTranscription.speakers"
+                                     :key="index"
+                                     :class="['speaker-legend-item', speaker.color]">
+                                    <span class="speaker-name">${speaker.name}</span>
+                                </div>
+                            </div>
+                        </div>
+
+                        <!-- Transcription Content - Scrollable Box -->
+                        <div class="w-full flex-1 overflow-y-auto transcription-box" @click="handleTranscriptClick">
+                            <!-- Simple View -->
+                            <div v-if="transcriptView === 'simple'" class="transcription-simple-view">
+                                <div v-for="(segment, index) in processedTranscription.simpleSegments"
+                                     :key="segment.startTime || Math.random()"
+                                     :class="['speaker-segment cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors mb-2', { 'active-playing-segment': currentPlayingSegmentIndex === index }]"
+                                     :data-start-time="segment.startTime"
+                                     :data-end-time="segment.endTime"
+                                     :data-segment-index="index"
+                                     style="margin-bottom: 0.5rem !important;">
+                                    <div v-if="segment.showSpeaker" :class="['speaker-tablet', segment.color]">
+                                        ${segment.speaker}
+                                    </div>
+                                    <div class="speaker-text">
+                                        ${segment.sentence}
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Bubble View -->
+                            <div v-else-if="transcriptView === 'bubble'" class="transcription-with-speakers">
+                                <div v-for="(row, rowIndex) in processedTranscription.bubbleRows"
+                                     :key="rowIndex"
+                                     :class="['bubble-row', row.isMe ? 'speaker-me' : '']">
+                                    <div v-for="(bubble, bubbleIndex) in row.bubbles"
+                                         :key="bubble.startTime || Math.random()"
+                                         :class="['speaker-bubble', bubble.color, row.isMe ? 'speaker-me' : '', 'cursor-pointer', { 'active-playing-segment': currentPlayingSegmentIndex === getBubbleGlobalIndex(rowIndex, bubbleIndex) }]"
+                                         :data-start-time="bubble.startTime"
+                                         :data-end-time="bubble.endTime"
+                                         :data-segment-index="getBubbleGlobalIndex(rowIndex, bubbleIndex)">
+                                        <div class="speaker-bubble-content">
+                                            ${bubble.sentence}
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+
+                            <!-- Plain Text View (for non-JSON transcriptions) -->
+                            <div v-if="!processedTranscription.isJson" class="whitespace-pre-wrap cursor-pointer hover:bg-[var(--bg-accent-hover)] p-2 rounded transition-colors">
+                                ${processedTranscription.content}
+                            </div>
+                        </div>
+                        {% endif %}
+                    </div>
+
+                    <!-- Summary View -->
+                    {% if recording.summary %}
+                    <div v-show="activeTab === 'summary'" class="w-full flex-1 flex flex-col overflow-hidden">
+                        <div class="flex items-center justify-end mb-4 flex-shrink-0">
+                            <button @click="copySummary" class="copy-btn">
+                                <i class="fas fa-copy mr-1"></i>Copy
+                            </button>
+                        </div>
+                        <div class="w-full flex-1 overflow-y-auto summary-box">
+                            {{ recording.summary|safe }}
+                        </div>
+                    </div>
+                    {% endif %}
+
+                    <!-- Notes View -->
+                    {% if recording.notes %}
+                    <div v-show="activeTab === 'notes'" class="w-full flex-1 flex flex-col overflow-hidden">
+                        <div class="flex items-center justify-end mb-4 flex-shrink-0">
+                            <button @click="copyNotes" class="copy-btn">
+                                <i class="fas fa-copy mr-1"></i>Copy
+                            </button>
+                        </div>
+                        <div class="w-full flex-1 overflow-y-auto notes-box">
+                            {{ recording.notes|safe }}
+                        </div>
+                    </div>
+                    {% endif %}
+                </div>
+            </div>
+        </main>
+
+        <!-- Footer -->
+        <footer class="bg-[var(--bg-secondary)] border-t border-[var(--border-primary)] py-4 px-4 flex-shrink-0">
+            <div class="max-w-4xl mx-auto flex flex-col sm:flex-row items-center justify-between gap-3 text-sm text-[var(--text-muted)]">
+                <div class="flex items-center gap-2">
+                    <span>&copy; {{ now.year }} Speakr</span>
+                    <span class="hidden sm:inline">•</span>
+                    <span class="text-xs">Powered by advanced AI transcription</span>
+                </div>
+                <div class="flex items-center gap-2">
+                    <span class="text-xs">Built with</span>
+                    <a href="https://github.com/murtaza-nasir/speakr"
+                       target="_blank"
+                       rel="noopener noreferrer"
+                       class="inline-flex items-center gap-1 text-[var(--text-accent)] hover:text-[var(--text-primary)] transition-colors font-medium">
+                        <i class="fab fa-github text-sm"></i>
+                        <span>Speakr</span>
+                        <i class="fas fa-external-link-alt text-xs opacity-70"></i>
+                    </a>
+                </div>
+            </div>
+        </footer>
+
+        <!-- Toast Container -->
+        <div id="toastContainer" class="fixed top-4 right-4 z-50 space-y-2 pointer-events-none"></div>
+    </div>
+
+    <script>
+        const { createApp, ref, computed } = Vue;
+
+        const app = createApp({
+            setup() {
+                const appElement = document.querySelector('#app');
+                const recordingData = JSON.parse(appElement.dataset.recording);
+                const recording = ref(recordingData);
+                const activeTab = ref('transcription');
+                const transcriptView = ref('simple');
+                const audioPlayer = ref(null);
+                const legendExpanded = ref(false);
+                const isDarkMode = ref(document.documentElement.classList.contains('dark'));
+
+                // Readable mode flag from server
+                const readableMode = {{ 'true' if readable_mode else 'false' }};
+                const currentPlayingSegmentIndex = ref(-1);
+                const followPlayerMode = ref(localStorage.getItem('shareFollowPlayerMode') === 'true');
+
+                // Server-rendered transcript info (only used in readable mode)
+                const hasDialogue = ref({{ 'true' if transcript and transcript.has_speakers else 'false' }});
+                const plainTextTranscript = {{ (transcript.plain_text if transcript else '')|tojson|safe }};
+
+                // Custom audio player state
+                const audioIsPlaying = ref(false);
+                const audioCurrentTime = ref(0);
+                // Use server-side duration if available (more reliable for formats like WebM)
+                const audioDuration = ref(recordingData.audio_duration || 0);
+                const audioIsMuted = ref(false);
+                const playerVolume = ref(1.0);
+
+                // Playback speed state
+                const playbackRate = ref(1.0);
+                const showSpeedMenu = ref(false);
+                const playbackSpeeds = [0.5, 0.75, 1.0, 1.25, 1.5, 1.75, 2.0, 2.5, 3.0];
+
+                // Computed property for progress percentage
+                const audioProgressPercent = computed(() => {
+                    if (!audioDuration.value) return 0;
+                    return (audioCurrentTime.value / audioDuration.value) * 100;
+                });
+
+                // Format time as m:ss or h:mm:ss
+                function formatAudioTime(seconds) {
+                    if (!seconds || isNaN(seconds)) return '0:00';
+                    const hours = Math.floor(seconds / 3600);
+                    const mins = Math.floor((seconds % 3600) / 60);
+                    const secs = Math.floor(seconds % 60);
+                    if (hours > 0) {
+                        return `${hours}:${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+                    }
+                    return `${mins}:${secs.toString().padStart(2, '0')}`;
+                }
+
+                // Audio event handlers
+                function handleAudioPlayPause(event) {
+                    audioIsPlaying.value = !event.target.paused;
+                }
+
+                function handleCustomAudioTimeUpdate(event) {
+                    audioCurrentTime.value = event.target.currentTime;
+                    updateHighlightedSegment(event.target.currentTime);
+                }
+
+                function updateHighlightedSegment(currentTime) {
+                    // Find all segments and determine which one is currently playing
+                    const segments = document.querySelectorAll('[data-segment-index]');
+                    let newIndex = -1;
+
+                    segments.forEach((el) => {
+                        const startTime = parseFloat(el.dataset.startTime) || 0;
+                        const endTime = parseFloat(el.dataset.endTime) || Infinity;
+                        const index = parseInt(el.dataset.segmentIndex);
+
+                        if (currentTime >= startTime && currentTime < endTime) {
+                            newIndex = index;
+                        }
+
+                        // Update highlight class
+                        if (currentTime >= startTime && currentTime < endTime) {
+                            el.classList.add('active-playing-segment');
+                        } else {
+                            el.classList.remove('active-playing-segment');
+                        }
+                    });
+
+                    currentPlayingSegmentIndex.value = newIndex;
+
+                    // Auto-scroll to active segment if follow mode is on
+                    if (followPlayerMode.value && newIndex >= 0) {
+                        const activeEl = document.querySelector(`[data-segment-index="${newIndex}"]`);
+                        if (activeEl) {
+                            activeEl.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                        }
+                    }
+                }
+
+                function toggleFollowPlayerMode() {
+                    followPlayerMode.value = !followPlayerMode.value;
+                    localStorage.setItem('shareFollowPlayerMode', followPlayerMode.value);
+                    if (followPlayerMode.value && currentPlayingSegmentIndex.value >= 0) {
+                        const activeEl = document.querySelector(`[data-segment-index="${currentPlayingSegmentIndex.value}"]`);
+                        if (activeEl) {
+                            activeEl.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                        }
+                    }
+                }
+
+                function handleAudioLoadedMetadata(event) {
+                    // Only set browser duration if we don't already have a server-side duration
+                    if (!audioDuration.value || audioDuration.value === 0) {
+                        const duration = event.target.duration;
+                        if (duration && isFinite(duration) && duration > 0) {
+                            audioDuration.value = duration;
+                        }
+                    }
+                    // Apply saved playback rate when audio loads
+                    if (playbackRate.value !== 1) {
+                        event.target.playbackRate = playbackRate.value;
+                    }
+                }
+
+                function handleAudioDurationChange(event) {
+                    // Only set browser duration if we don't already have a server-side duration
+                    if (!audioDuration.value || audioDuration.value === 0) {
+                        const duration = event.target.duration;
+                        if (duration && isFinite(duration) && duration > 0) {
+                            audioDuration.value = duration;
+                        }
+                    }
+                }
+
+                function handleAudioEnded() {
+                    audioIsPlaying.value = false;
+                }
+
+                // Audio control functions
+                function toggleAudioPlayback() {
+                    if (!audioPlayer.value) return;
+                    if (audioPlayer.value.paused) {
+                        audioPlayer.value.play();
+                    } else {
+                        audioPlayer.value.pause();
+                    }
+                }
+
+                function toggleAudioMute() {
+                    if (!audioPlayer.value) return;
+                    audioPlayer.value.muted = !audioPlayer.value.muted;
+                    audioIsMuted.value = audioPlayer.value.muted;
+                }
+
+                function setAudioVolume(value) {
+                    if (!audioPlayer.value) return;
+                    playerVolume.value = value;
+                    audioPlayer.value.volume = value;
+                    if (value > 0 && audioIsMuted.value) {
+                        audioPlayer.value.muted = false;
+                        audioIsMuted.value = false;
+                    }
+                }
+
+                function seekAudioByPercent(percent) {
+                    if (!audioPlayer.value || !audioDuration.value || !isFinite(audioDuration.value)) return;
+                    const time = (percent / 100) * audioDuration.value;
+                    audioPlayer.value.currentTime = time;
+                }
+
+                // Playback speed functions
+                function formatPlaybackRate(rate) {
+                    if (rate === 1) return '1x';
+                    return `${rate}x`;
+                }
+
+                function setPlaybackRate(rate) {
+                    playbackRate.value = rate;
+                    localStorage.setItem('playbackRate', rate);
+                    if (audioPlayer.value) {
+                        audioPlayer.value.playbackRate = rate;
+                    }
+                }
+
+                // Initialize playback rate from localStorage
+                const savedRate = localStorage.getItem('playbackRate');
+                if (savedRate) {
+                    const rate = parseFloat(savedRate);
+                    if (playbackSpeeds.includes(rate)) {
+                        playbackRate.value = rate;
+                    }
+                }
+
+                // processedTranscription computed property (used in Vue mode, not readable mode)
+                const processedTranscription = computed(() => {
+                    if (readableMode) {
+                        // In readable mode, content is server-rendered, so just return minimal info
+                        return { hasDialogue: hasDialogue.value, isJson: true, speakers: [], simpleSegments: [], bubbleRows: [] };
+                    }
+
+                    if (!recording.value?.transcription) {
+                        return { hasDialogue: false, content: '', speakers: [], simpleSegments: [], bubbleRows: [] };
+                    }
+
+                    const transcription = recording.value.transcription;
+                    let transcriptionData;
+
+                    try {
+                        transcriptionData = JSON.parse(transcription);
+                    } catch (e) {
+                        transcriptionData = null;
+                    }
+
+                    if (transcriptionData && Array.isArray(transcriptionData)) {
+                        const wasDiarized = transcriptionData.some(segment => segment.speaker);
+
+                        if (!wasDiarized) {
+                            const segments = transcriptionData.map(segment => ({
+                                sentence: segment.sentence,
+                                startTime: segment.start_time,
+                                endTime: segment.end_time
+                            }));
+                            return {
+                                hasDialogue: false,
+                                isJson: true,
+                                content: segments.map(s => s.sentence).join('\n'),
+                                simpleSegments: segments,
+                                speakers: [],
+                                bubbleRows: []
+                            };
+                        }
+
+                        const speakers = [...new Set(transcriptionData.map(segment => segment.speaker).filter(Boolean))];
+                        const speakerColors = {};
+                        speakers.forEach((speaker, index) => {
+                            speakerColors[speaker] = `speaker-color-${(index % 8) + 1}`;
+                        });
+
+                        const simpleSegments = transcriptionData.map(segment => ({
+                            speakerId: segment.speaker,
+                            speaker: segment.speaker,
+                            sentence: segment.sentence,
+                            startTime: segment.start_time || segment.startTime,
+                            endTime: segment.end_time || segment.endTime,
+                            color: speakerColors[segment.speaker] || 'speaker-color-1'
+                        }));
+
+                        const processedSimpleSegments = [];
+                        let lastSpeaker = null;
+                        simpleSegments.forEach(segment => {
+                            processedSimpleSegments.push({
+                                ...segment,
+                                showSpeaker: segment.speaker !== lastSpeaker
+                            });
+                            lastSpeaker = segment.speaker;
+                        });
+
+                        const bubbleRows = [];
+                        let lastBubbleSpeaker = null;
+                        simpleSegments.forEach(segment => {
+                            if (bubbleRows.length === 0 || segment.speaker !== lastBubbleSpeaker) {
+                                bubbleRows.push({
+                                    speaker: segment.speaker,
+                                    color: segment.color,
+                                    isMe: segment.speaker && (typeof segment.speaker === 'string') && segment.speaker.toLowerCase().includes('me'),
+                                    bubbles: []
+                                });
+                                lastBubbleSpeaker = segment.speaker;
+                            }
+                            bubbleRows[bubbleRows.length - 1].bubbles.push({
+                                sentence: segment.sentence,
+                                startTime: segment.startTime || segment.start_time,
+                                endTime: segment.endTime || segment.end_time,
+                                color: segment.color
+                            });
+                        });
+
+                        return {
+                            hasDialogue: true,
+                            isJson: true,
+                            segments: simpleSegments,
+                            simpleSegments: processedSimpleSegments,
+                            bubbleRows: bubbleRows,
+                            speakers: speakers.map(speaker => ({
+                                name: speaker,
+                                color: speakerColors[speaker]
+                            }))
+                        };
+                    }
+                    return { hasDialogue: false, content: transcription, speakers: [], simpleSegments: [], bubbleRows: [] };
+                });
+
+                // Helper to get global index for bubble view highlighting
+                function getBubbleGlobalIndex(rowIndex, bubbleIndex) {
+                    let globalIndex = 0;
+                    for (let i = 0; i < rowIndex; i++) {
+                        globalIndex += processedTranscription.value.bubbleRows[i]?.bubbles?.length || 0;
+                    }
+                    return globalIndex + bubbleIndex;
+                }
+
+                function seekAudio(startTime) {
+                    if (recording.value.audio_deleted_at) return;
+                    if (startTime && audioPlayer.value) {
+                        audioPlayer.value.currentTime = parseFloat(startTime);
+                        audioPlayer.value.play();
+                    }
+                }
+
+                function handleTranscriptClick(event) {
+                    if (recording.value.audio_deleted_at) return;
+                    // Use closest() to find the segment element even when clicking on child elements
+                    const segmentEl = event.target.closest('[data-start-time]');
+                    if (segmentEl && audioPlayer.value) {
+                        const startTime = segmentEl.dataset.startTime;
+                        audioPlayer.value.currentTime = parseFloat(startTime);
+                        audioPlayer.value.play();
+                    }
+                }
+
+                function copyTranscript(event) {
+                    const button = event?.currentTarget;
+                    let textToCopy = '';
+                    if (readableMode) {
+                        // Use server-provided plain text (already formatted with speaker labels if diarized)
+                        textToCopy = plainTextTranscript || recording.value.transcription;
+                    } else {
+                        // Use Vue-computed data
+                        if (processedTranscription.value.isJson && processedTranscription.value.simpleSegments) {
+                            textToCopy = processedTranscription.value.simpleSegments.map(s =>
+                                s.speaker ? `[${s.speaker}]: ${s.sentence}` : s.sentence
+                            ).join('\n');
+                        } else {
+                            textToCopy = recording.value.transcription;
+                        }
+                    }
+                    navigator.clipboard.writeText(textToCopy).then(() => {
+                        animateCopyButton(button);
+                        showToast('Transcription copied to clipboard!');
+                    });
+                }
+
+                function copySummary(event) {
+                    const button = event?.currentTarget;
+                    const textToCopy = recording.value.summary_raw || recording.value.summary;
+                    navigator.clipboard.writeText(textToCopy).then(() => {
+                        animateCopyButton(button);
+                        showToast('Summary copied to clipboard!');
+                    });
+                }
+
+                function copyNotes(event) {
+                    const button = event?.currentTarget;
+                    const textToCopy = recording.value.notes_raw || recording.value.notes;
+                    navigator.clipboard.writeText(textToCopy).then(() => {
+                        animateCopyButton(button);
+                        showToast('Notes copied to clipboard!');
+                    });
+                }
+
+                function animateCopyButton(button) {
+                    if (!button) return;
+                    const icon = button.querySelector('i');
+                    if (icon) {
+                        const originalClass = icon.className;
+                        icon.className = 'fas fa-check mr-1';
+                        setTimeout(() => {
+                            icon.className = originalClass;
+                        }, 2000);
+                    }
+                }
+
+                function toggleDarkMode() {
+                    const newDarkMode = !isDarkMode.value;
+                    isDarkMode.value = newDarkMode;
+
+                    if (newDarkMode) {
+                        document.documentElement.classList.add('dark');
+                    } else {
+                        document.documentElement.classList.remove('dark');
+                    }
+
+                    localStorage.setItem('darkMode', newDarkMode.toString());
+                }
+
+                function showToast(message) {
+                    const container = document.getElementById('toastContainer');
+                    const toast = document.createElement('div');
+                    toast.className = 'toast bg-[var(--bg-success)] text-white px-4 py-2 rounded-lg shadow-lg flex items-center gap-2 pointer-events-auto';
+                    toast.style.cursor = 'pointer';
+                    toast.innerHTML = `<i class="fas fa-check"></i>${message}`;
+
+                    container.appendChild(toast);
+
+                    // Trigger animation
+                    setTimeout(() => toast.classList.add('show'), 10);
+
+                    // Function to dismiss the toast
+                    const dismissToast = () => {
+                        toast.classList.remove('show');
+                        setTimeout(() => {
+                            if (toast.parentNode) {
+                                container.removeChild(toast);
+                            }
+                        }, 300);
+                    };
+
+                    // Add click handler to dismiss toast
+                    toast.addEventListener('click', () => {
+                        clearTimeout(timeoutId);
+                        dismissToast();
+                    });
+
+                    // Auto-dismiss after 3 seconds
+                    const timeoutId = setTimeout(dismissToast, 3000);
+                }
+
+                return {
+                    recording,
+                    activeTab,
+                    transcriptView,
+                    audioPlayer,
+                    readableMode,
+                    hasDialogue,
+                    processedTranscription,
+                    currentPlayingSegmentIndex,
+                    followPlayerMode,
+                    toggleFollowPlayerMode,
+                    getBubbleGlobalIndex,
+                    legendExpanded,
+                    isDarkMode,
+                    seekAudio,
+                    handleTranscriptClick,
+                    copyTranscript,
+                    copySummary,
+                    copyNotes,
+                    toggleDarkMode,
+                    // Custom audio player
+                    audioIsPlaying,
+                    audioCurrentTime,
+                    audioDuration,
+                    audioIsMuted,
+                    playerVolume,
+                    audioProgressPercent,
+                    formatAudioTime,
+                    handleAudioPlayPause,
+                    handleCustomAudioTimeUpdate,
+                    handleAudioLoadedMetadata,
+                    handleAudioDurationChange,
+                    handleAudioEnded,
+                    toggleAudioPlayback,
+                    toggleAudioMute,
+                    setAudioVolume,
+                    seekAudioByPercent,
+                    // Playback speed
+                    playbackRate,
+                    showSpeedMenu,
+                    playbackSpeeds,
+                    formatPlaybackRate,
+                    setPlaybackRate
+                };
+            }
+        });
+
+        app.config.compilerOptions.delimiters = ['${', '}'];
+        app.mount('#app');
+
+        // Hide loading overlay after app mounts
+        Vue.nextTick(() => {
+            if (window.AppLoader) {
+                AppLoader.waitForReady();
+            }
+        });
+    </script>
+</body>
+</html>
diff --git a/tests/test_admin_hotwords_and_bugfixes.py b/tests/test_admin_hotwords_and_bugfixes.py
new file mode 100644
index 00000000..a99f3e19
--- /dev/null
+++ b/tests/test_admin_hotwords_and_bugfixes.py
@@ -0,0 +1,404 @@
+#!/usr/bin/env python3
+"""
+Tests for recent bug fixes and improvements.
+
+Validates:
+1. Admin default hotwords (SystemSetting fallback in processing)
+2. Chat API endpoint returning proper string response (#245)
+3. Inquire mode handling empty choices in streaming (#246)
+4. User default transcription language in config endpoint (#250)
+
+Run with: docker exec speakr-dev python /app/tests/test_recent_fixes.py
+"""
+
+import os
+import sys
+import json
+import secrets
+from pathlib import Path
+from unittest.mock import patch, MagicMock, PropertyMock
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+# Test results tracking
+PASSED = 0
+FAILED = 0
+ERRORS = []
+
+
+def run_test(name, func):
+    global PASSED, FAILED, ERRORS
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+        ERRORS.append((name, str(e)))
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+        ERRORS.append((name, f"Exception: {e}"))
+
+
+# =============================================================================
+# TEST SECTION 1: Admin Default Hotwords
+# =============================================================================
+
+def test_admin_default_hotwords():
+    """Test admin_default_hotwords SystemSetting behavior."""
+    print("\n=== Testing Admin Default Hotwords ===")
+
+    from src.app import app, db
+    from src.models import SystemSetting
+
+    def t1():
+        """SystemSetting can store and retrieve admin_default_hotwords."""
+        with app.app_context():
+            # Set the value
+            SystemSetting.set_setting('admin_default_hotwords', 'TestWord, AnotherWord')
+            # Retrieve it
+            value = SystemSetting.get_setting('admin_default_hotwords', '')
+            assert value == 'TestWord, AnotherWord', f"Expected 'TestWord, AnotherWord', got '{value}'"
+            # Clean up
+            SystemSetting.set_setting('admin_default_hotwords', '')
+    run_test("admin_default_hotwords can be stored and retrieved", t1)
+
+    def t2():
+        """Empty admin_default_hotwords returns empty string."""
+        with app.app_context():
+            SystemSetting.set_setting('admin_default_hotwords', '')
+            value = SystemSetting.get_setting('admin_default_hotwords', '')
+            assert value == '', f"Expected empty string, got '{value}'"
+    run_test("Empty admin_default_hotwords returns empty string", t2)
+
+    def t3():
+        """Admin hotwords only apply when user hotwords are empty (priority chain)."""
+        # This tests the logic: if not hotwords -> use admin default
+        # Simulate the processing.py logic
+        with app.app_context():
+            SystemSetting.set_setting('admin_default_hotwords', 'AdminWord1, AdminWord2')
+
+            # Case 1: User has hotwords - admin should NOT be used
+            user_hotwords = 'UserWord1, UserWord2'
+            hotwords = user_hotwords
+            if not hotwords:
+                admin_hotwords = SystemSetting.get_setting('admin_default_hotwords', '')
+                if admin_hotwords:
+                    hotwords = admin_hotwords
+            assert hotwords == 'UserWord1, UserWord2', "User hotwords should take priority"
+
+            # Case 2: User has no hotwords - admin SHOULD be used
+            user_hotwords = ''
+            hotwords = user_hotwords
+            if not hotwords:
+                admin_hotwords = SystemSetting.get_setting('admin_default_hotwords', '')
+                if admin_hotwords:
+                    hotwords = admin_hotwords
+            assert hotwords == 'AdminWord1, AdminWord2', "Admin hotwords should be used as fallback"
+
+            # Case 3: No user hotwords AND no admin hotwords
+            SystemSetting.set_setting('admin_default_hotwords', '')
+            user_hotwords = ''
+            hotwords = user_hotwords
+            if not hotwords:
+                admin_hotwords = SystemSetting.get_setting('admin_default_hotwords', '')
+                if admin_hotwords:
+                    hotwords = admin_hotwords
+            assert hotwords == '', "Should remain empty when no hotwords at any level"
+
+            # Clean up
+            SystemSetting.set_setting('admin_default_hotwords', '')
+    run_test("Hotword priority chain: user > admin > none", t3)
+
+
+# =============================================================================
+# TEST SECTION 2: Chat API Fix (#245)
+# =============================================================================
+
+def test_chat_api_fix():
+    """Test that chat_with_recording extracts string from ChatCompletion object."""
+    print("\n=== Testing Chat API Fix (#245) ===")
+
+    from src.app import app, db
+    from src.models import User, Recording, APIToken
+    from src.utils.token_auth import hash_token
+
+    def _get_or_create_test_user():
+        user = User.query.filter_by(username="chat_test_user").first()
+        created = False
+        if not user:
+            user = User(username="chat_test_user", email="chat_test@local.test")
+            user.password_hash = "unused"
+            db.session.add(user)
+            db.session.commit()
+            created = True
+        return user, created
+
+    def _create_test_recording(user):
+        recording = Recording(
+            user_id=user.id,
+            title="Chat Test Recording",
+            original_filename="test_chat.wav",
+            transcription='[{"speaker": "Speaker 1", "text": "Hello world"}]',
+            status="COMPLETED",
+        )
+        db.session.add(recording)
+        db.session.commit()
+        return recording
+
+    def _create_api_token(user):
+        plaintext = f"test-token-{secrets.token_urlsafe(16)}"
+        token = APIToken(
+            user_id=user.id,
+            token_hash=hash_token(plaintext),
+            name="chat-test-token"
+        )
+        db.session.add(token)
+        db.session.commit()
+        return token, plaintext
+
+    def t1():
+        """Chat endpoint returns JSON string, not ChatCompletion object."""
+        with app.app_context():
+            user, created_user = _get_or_create_test_user()
+            recording = _create_test_recording(user)
+            token_record, token = _create_api_token(user)
+
+            try:
+                # Mock the LLM call to return a ChatCompletion-like object
+                mock_completion = MagicMock()
+                mock_completion.choices = [MagicMock()]
+                mock_completion.choices[0].message.content = "This is the AI response"
+
+                with patch('src.services.llm.call_chat_completion', return_value=mock_completion), \
+                     patch('src.services.llm.chat_client', new=MagicMock()), \
+                     patch('src.api.api_v1.has_recording_access', return_value=True):
+                    client = app.test_client()
+                    response = client.post(
+                        f"/api/v1/recordings/{recording.id}/chat",
+                        headers={"X-API-Token": token, "Content-Type": "application/json"},
+                        json={"message": "What was discussed?"}
+                    )
+
+                    assert response.status_code == 200, f"Expected 200, got {response.status_code}: {response.data}"
+                    data = response.get_json()
+                    assert 'response' in data, f"Missing 'response' key in: {data}"
+                    assert data['response'] == "This is the AI response"
+                    assert isinstance(data['response'], str), f"Response should be string, got {type(data['response'])}"
+            finally:
+                db.session.delete(token_record)
+                db.session.delete(recording)
+                db.session.commit()
+                if created_user:
+                    db.session.delete(user)
+                    db.session.commit()
+    run_test("Chat API returns string response, not ChatCompletion object", t1)
+
+
+# =============================================================================
+# TEST SECTION 3: Azure Empty Choices Fix (#246)
+# =============================================================================
+
+def test_azure_empty_choices():
+    """Test handling of empty choices in streaming responses."""
+    print("\n=== Testing Azure Empty Choices Fix (#246) ===")
+
+    def t1():
+        """Empty choices array should be skipped, not crash."""
+        # Simulate the streaming loop logic from inquire.py
+        collected_content = ""
+
+        # Create mock chunks - some with empty choices (Azure content filter)
+        class MockDelta:
+            def __init__(self, content=None):
+                self.content = content
+
+        class MockChoice:
+            def __init__(self, content=None):
+                self.delta = MockDelta(content)
+
+        class MockChunk:
+            def __init__(self, choices=None):
+                self.choices = choices if choices is not None else []
+
+        chunks = [
+            MockChunk(choices=[]),                          # Empty choices (Azure filter)
+            MockChunk(choices=[MockChoice("Hello ")]),      # Normal chunk
+            MockChunk(choices=[]),                          # Empty choices again
+            MockChunk(choices=[MockChoice("world")]),       # Normal chunk
+            MockChunk(choices=[MockChoice(None)]),          # Choice with None content
+        ]
+
+        for chunk in chunks:
+            if not chunk.choices:
+                continue
+            content = chunk.choices[0].delta.content
+            if content:
+                collected_content += content
+
+        assert collected_content == "Hello world", f"Expected 'Hello world', got '{collected_content}'"
+    run_test("Empty choices array is safely skipped in streaming", t1)
+
+    def t2():
+        """All-empty stream produces no output (doesn't crash)."""
+        chunks = []
+
+        class MockChunk:
+            def __init__(self):
+                self.choices = []
+
+        chunks = [MockChunk(), MockChunk(), MockChunk()]
+        collected = ""
+        for chunk in chunks:
+            if not chunk.choices:
+                continue
+            content = chunk.choices[0].delta.content
+            if content:
+                collected += content
+
+        assert collected == ""
+    run_test("All-empty-choices stream produces empty output", t2)
+
+
+# =============================================================================
+# TEST SECTION 4: User Default Transcription Language (#250)
+# =============================================================================
+
+def test_user_transcription_language():
+    """Test user transcription language in config endpoint."""
+    print("\n=== Testing User Default Transcription Language (#250) ===")
+
+    from src.app import app, db
+    from src.models import User
+
+    def t1():
+        """Config endpoint returns user_transcription_language for authenticated user."""
+        with app.app_context():
+            # Find or create a test user with a transcription language set
+            user = User.query.filter_by(username="lang_test_user").first()
+            created = False
+            if not user:
+                user = User(username="lang_test_user", email="lang_test@local.test")
+                user.password_hash = "unused"
+                db.session.add(user)
+                db.session.commit()
+                created = True
+
+            # Set transcription language
+            user.transcription_language = 'fr'
+            db.session.commit()
+
+            try:
+                client = app.test_client()
+
+                # Simulate logged-in user
+                with client.session_transaction() as sess:
+                    sess['_user_id'] = str(user.id)
+
+                response = client.get('/api/config')
+                assert response.status_code == 200, f"Expected 200, got {response.status_code}"
+
+                data = response.get_json()
+                assert 'user_transcription_language' in data, f"Missing user_transcription_language in config: {list(data.keys())}"
+                assert data['user_transcription_language'] == 'fr', f"Expected 'fr', got '{data['user_transcription_language']}'"
+            finally:
+                user.transcription_language = ''
+                db.session.commit()
+                if created:
+                    db.session.delete(user)
+                    db.session.commit()
+    run_test("Config endpoint includes user_transcription_language", t1)
+
+    def t2():
+        """Config endpoint returns empty string for user without language set."""
+        with app.app_context():
+            user = User.query.filter_by(username="lang_test_user2").first()
+            created = False
+            if not user:
+                user = User(username="lang_test_user2", email="lang_test2@local.test")
+                user.password_hash = "unused"
+                db.session.add(user)
+                db.session.commit()
+                created = True
+
+            # Ensure no language set
+            user.transcription_language = ''
+            db.session.commit()
+
+            try:
+                client = app.test_client()
+                with client.session_transaction() as sess:
+                    sess['_user_id'] = str(user.id)
+
+                response = client.get('/api/config')
+                data = response.get_json()
+                # Should be empty string (falsy) since user has no language set
+                assert data.get('user_transcription_language', '') == '' or data.get('user_transcription_language') is None
+            finally:
+                if created:
+                    db.session.delete(user)
+                    db.session.commit()
+    run_test("Config returns empty language for user without preference", t2)
+
+    def t3():
+        """Config endpoint works for unauthenticated requests (no crash)."""
+        with app.app_context():
+            client = app.test_client()
+            response = client.get('/api/config')
+            assert response.status_code == 200
+            data = response.get_json()
+            # Should still have the key, just empty
+            assert 'user_transcription_language' in data
+    run_test("Config endpoint works without authentication", t3)
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def teardown_module(module):
+    """Drop synthetic users created by this test file. pytest invokes this
+    automatically; the standalone main() also calls it explicitly so the
+    cleanup runs whether the file is executed as a script or via pytest.
+    """
+    from src.app import app, db
+    from src.models import User
+    with app.app_context():
+        for username in ('chat_test_user',):
+            user = User.query.filter_by(username=username).first()
+            if user:
+                db.session.delete(user)
+                db.session.commit()
+
+
+def main():
+    global PASSED, FAILED, ERRORS
+
+    print("=" * 60)
+    print("Recent Fixes Tests (#240, #245, #246, #250)")
+    print("=" * 60)
+
+    try:
+        test_admin_default_hotwords()
+        test_chat_api_fix()
+        test_azure_empty_choices()
+        test_user_transcription_language()
+    finally:
+        teardown_module(None)
+
+    print("\n" + "=" * 60)
+    print(f"RESULTS: {PASSED} passed, {FAILED} failed")
+    print("=" * 60)
+
+    if ERRORS:
+        print("\nFailed tests:")
+        for name, error in ERRORS:
+            print(f"  - {name}: {error}")
+
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
diff --git a/tests/test_api_v1_parity.py b/tests/test_api_v1_parity.py
new file mode 100644
index 00000000..47edb251
--- /dev/null
+++ b/tests/test_api_v1_parity.py
@@ -0,0 +1,168 @@
+#!/usr/bin/env python3
+"""
+Smoke test for issue #274: /api/v1/recordings and /api/v1/recordings/{id}
+should expose audio_duration, durations, folder, events, and deletion_exempt.
+
+Run with: docker exec speakr-dev python /app/tests/test_api_v1_parity.py
+"""
+
+import secrets
+import sys
+import uuid
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from src.app import app, db
+from src.models import User, Recording, APIToken
+from src.models.organization import Folder
+from src.utils.token_auth import hash_token
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+def setup_user_and_recording():
+    suffix = uuid.uuid4().hex[:10]
+    user = User(
+        username=f"v1parity_{suffix}",
+        email=f"v1parity_{suffix}@test.local",
+        password="x",
+    )
+    db.session.add(user)
+    db.session.flush()
+    folder = Folder(name=f"folder_{suffix}", user_id=user.id)
+    db.session.add(folder)
+    db.session.flush()
+
+    rec = Recording(
+        audio_path="/tmp/dummy.wav",
+        original_filename="dummy.wav",
+        title="parity test",
+        status="COMPLETED",
+        user_id=user.id,
+        folder_id=folder.id,
+        deletion_exempt=True,
+        transcription_duration_seconds=42,
+        summarization_duration_seconds=7,
+    )
+    db.session.add(rec)
+    db.session.flush()
+
+    plaintext = f"v1parity-{secrets.token_urlsafe(16)}"
+    token = APIToken(
+        user_id=user.id,
+        token_hash=hash_token(plaintext),
+        name="v1parity-token",
+    )
+    db.session.add(token)
+    db.session.commit()
+    return user, rec, folder, plaintext
+
+
+REQUIRED_DETAIL_FIELDS = {
+    "audio_duration",
+    "transcription_duration_seconds",
+    "summarization_duration_seconds",
+    "folder_id",
+    "folder",
+    "deletion_exempt",
+    "events",
+}
+
+REQUIRED_LIST_FIELDS = {
+    "audio_duration",
+    "transcription_duration_seconds",
+    "summarization_duration_seconds",
+    "folder_id",
+    "folder",
+    "deletion_exempt",
+    "completed_at",
+    "processing_time_seconds",
+}
+
+
+def test_detail_has_all_new_fields():
+    with app.app_context():
+        user, rec, folder, token = setup_user_and_recording()
+        client = app.test_client()
+        resp = client.get(
+            f"/api/v1/recordings/{rec.id}",
+            headers={"X-API-Token": token},
+        )
+        assert resp.status_code == 200, f"unexpected status {resp.status_code}: {resp.data!r}"
+        body = resp.get_json()
+        missing = REQUIRED_DETAIL_FIELDS - set(body.keys())
+        assert not missing, f"detail endpoint missing fields: {missing}"
+        # audio file is /tmp/dummy.wav and doesn't exist → audio_duration is None.
+        assert body["audio_duration"] is None
+        assert body["transcription_duration_seconds"] == 42
+        assert body["summarization_duration_seconds"] == 7
+        assert body["folder_id"] == folder.id
+        assert body["folder"] == {"id": folder.id, "name": folder.name}
+        assert body["deletion_exempt"] is True
+        assert body["events"] == []
+
+
+def test_list_has_all_new_fields():
+    with app.app_context():
+        user, rec, folder, token = setup_user_and_recording()
+        client = app.test_client()
+        resp = client.get(
+            "/api/v1/recordings",
+            headers={"X-API-Token": token},
+        )
+        assert resp.status_code == 200, f"unexpected status {resp.status_code}: {resp.data!r}"
+        body = resp.get_json()
+        assert body.get("recordings"), f"no recordings in response: {body!r}"
+        # Find our recording in the list (other tests may have added rows).
+        ours = next((r for r in body["recordings"] if r["id"] == rec.id), None)
+        assert ours, f"new recording {rec.id} missing from list"
+        missing = REQUIRED_LIST_FIELDS - set(ours.keys())
+        assert not missing, f"list item missing fields: {missing}"
+
+
+def cleanup_test_users():
+    """Drop every user created by this file so leaked rows do not appear in
+    the admin user-management screens or aggregate stats."""
+    with app.app_context():
+        for u in User.query.filter(User.username.like('v1parity_%')).all():
+            db.session.delete(u)
+        db.session.commit()
+
+
+def teardown_module(module):
+    """pytest auto-calls this after the last test in the module finishes.
+    Required because pytest does not invoke ``main()``, so the cleanup in
+    its ``finally`` block never runs under ``pytest tests/``."""
+    cleanup_test_users()
+
+
+def main():
+    print("=== Issue #274: API v1 parity ===\n")
+    try:
+        run("detail endpoint exposes new fields", test_detail_has_all_new_fields)
+        run("list endpoint exposes new fields", test_list_has_all_new_fields)
+    finally:
+        cleanup_test_users()
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_api_v1_speakers.py b/tests/test_api_v1_speakers.py
new file mode 100644
index 00000000..2b616c92
--- /dev/null
+++ b/tests/test_api_v1_speakers.py
@@ -0,0 +1,971 @@
+#!/usr/bin/env python3
+"""
+Test suite for Speaker API v1 endpoints.
+
+Covers:
+  - PUT  /recordings/<id>/speakers/assign   (17 tests)
+  - POST /recordings/<id>/speakers/identify (10 tests)
+  - PUT  /settings/auto-summarization        (5 tests)
+  - Regression for GET /speakers and GET /recordings/<id>/speakers (2 tests)
+
+Pattern follows tests/test_api_v1_upload.py — standalone, no pytest fixtures.
+"""
+
+import json
+import secrets
+import sys
+import os
+from unittest.mock import patch, MagicMock
+
+# Add parent directory so we can import the app
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db
+from src.models import User, APIToken, Recording, Speaker
+from src.utils.token_auth import hash_token
+
+# ---------------------------------------------------------------------------
+# Test data constants
+# ---------------------------------------------------------------------------
+
+SAMPLE_TRANSCRIPTION_JSON = json.dumps([
+    {"speaker": "SPEAKER_00", "sentence": "Hi, I'm Alice."},
+    {"speaker": "SPEAKER_01", "sentence": "Hello Alice, I'm Bob."},
+    {"speaker": "SPEAKER_00", "sentence": "Nice to meet you, Bob."},
+])
+
+SAMPLE_TRANSCRIPTION_TEXT = (
+    "[SPEAKER_00]: Hi, I'm Alice.\n"
+    "[SPEAKER_01]: Hello Alice, I'm Bob.\n"
+    "[SPEAKER_00]: Nice to meet you, Bob."
+)
+
+SAMPLE_EMBEDDINGS = json.dumps({
+    "SPEAKER_00": [0.1] * 256,
+    "SPEAKER_01": [0.2] * 256,
+})
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _get_or_create_test_user(suffix=""):
+    """Get or create a test user. Returns (user, created_bool)."""
+    username = f"speaker_test_user{suffix}"
+    user = User.query.filter_by(username=username).first()
+    created = False
+    if not user:
+        user = User(
+            username=username,
+            email=f"{username}@local.test",
+            name="Test User" if not suffix else None,
+        )
+        db.session.add(user)
+        db.session.commit()
+        created = True
+    return user, created
+
+
+def _create_api_token(user):
+    """Create a fresh API token. Returns (token_record, plaintext)."""
+    plaintext = f"test-token-{secrets.token_urlsafe(16)}"
+    token = APIToken(
+        user_id=user.id,
+        token_hash=hash_token(plaintext),
+        name="test-api-token",
+    )
+    db.session.add(token)
+    db.session.commit()
+    return token, plaintext
+
+
+def _create_test_recording(user, transcription=None, speaker_embeddings=None, status="COMPLETED"):
+    """Create a Recording owned by *user*."""
+    rec = Recording(
+        user_id=user.id,
+        title="Test Recording",
+        status=status,
+        transcription=transcription,
+        speaker_embeddings=speaker_embeddings,
+    )
+    db.session.add(rec)
+    db.session.commit()
+    return rec
+
+
+def _create_test_speaker(user, name="Alice"):
+    """Create a Speaker owned by *user*."""
+    speaker = Speaker(name=name, user_id=user.id)
+    db.session.add(speaker)
+    db.session.commit()
+    return speaker
+
+
+def _cleanup(*objects):
+    """Delete DB objects in reverse order, committing once."""
+    for obj in reversed(objects):
+        try:
+            db.session.delete(obj)
+        except Exception:
+            db.session.rollback()
+            try:
+                merged = db.session.merge(obj)
+                db.session.delete(merged)
+            except Exception:
+                pass
+    db.session.commit()
+
+
+# =========================================================================
+# Group 1: PUT /recordings/<id>/speakers/assign  (17 tests)
+# =========================================================================
+
+
+def test_assign_no_auth():
+    """No token -> 302 redirect (Flask-Login)."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              json={"speaker_map": {}})
+            assert resp.status_code in (302, 401), f"Expected 302/401, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_recording_not_found():
+    """Nonexistent recording ID -> 404."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.put("/api/v1/recordings/999999/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {}})
+            assert resp.status_code == 404, f"Expected 404, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_wrong_user_recording():
+    """Other user's recording -> 403."""
+    with app.app_context():
+        owner, co = _get_or_create_test_user("_owner")
+        other, cu = _get_or_create_test_user("_other")
+        token_rec, token = _create_api_token(other)
+        rec = _create_test_recording(owner, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "Alice"}})
+            assert resp.status_code == 403, f"Expected 403, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(other)
+            if co:
+                _cleanup(owner)
+
+
+def test_assign_missing_speaker_map():
+    """Body {} -> 400 'speaker_map is required'."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            body = resp.get_json()
+            assert "speaker_map" in body.get("error", "").lower(), f"Unexpected error: {body}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_invalid_speaker_map_type():
+    """speaker_map: 'string' -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": "not a dict"})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_string_value_json_transcript():
+    """Happy path: string names update JSON segments + participants."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "Alice", "SPEAKER_01": "Bob"}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("success") is True
+            # Verify participants
+            participants = body["recording"]["participants"]
+            assert "Alice" in participants and "Bob" in participants
+            # Verify transcription was updated
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "Alice"
+            assert segments[1]["speaker"] == "Bob"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_object_value_with_name():
+    """Happy path: {name, isMe} object format."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {
+                                  "SPEAKER_00": {"name": "Alice", "isMe": False},
+                              }})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "Alice"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_is_me_flag_with_user_name():
+    """isMe: true resolves to user.name."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()  # user.name == "Test User"
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {
+                                  "SPEAKER_00": {"name": "", "isMe": True},
+                              }})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "Test User", f"Got {segments[0]['speaker']}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_is_me_flag_without_user_name():
+    """isMe: true falls back to 'Me' when user.name is None."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user("_noname")
+        # Ensure user.name is None
+        user.name = None
+        db.session.commit()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {
+                                  "SPEAKER_00": {"name": "", "isMe": True},
+                              }})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "Me", f"Got {segments[0]['speaker']}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_plain_text_transcript():
+    """Replaces [SPEAKER_XX] in plain text format."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_TEXT)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "Alice", "SPEAKER_01": "Bob"}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            db.session.refresh(rec)
+            assert "[Alice]" in rec.transcription
+            assert "[Bob]" in rec.transcription
+            assert "[SPEAKER_00]" not in rec.transcription
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_speaker_xx_filtered_from_participants():
+    """Unresolved SPEAKER_XX labels excluded from participants."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            # Only assign one speaker - SPEAKER_01 stays unresolved
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "Alice"}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            participants = body["recording"]["participants"]
+            assert "SPEAKER_01" not in participants, f"SPEAKER_01 should be filtered: {participants}"
+            assert "Alice" in participants
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_invalid_value_type():
+    """Array value -> 400 'Invalid value type'."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": [1, 2, 3]}})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            body = resp.get_json()
+            assert "invalid value type" in body.get("error", "").lower(), f"Unexpected: {body}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_empty_speaker_map():
+    """Empty speaker_map {} -> 200 with no changes."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("success") is True
+            # Transcription should be unchanged
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "SPEAKER_00"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_regenerate_summary():
+    """regenerate_summary: true -> job_queue.enqueue called, summary_queued: true."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            mock_jq = MagicMock()
+            mock_jq.enqueue = MagicMock(return_value="job-123")
+            with patch("src.services.job_queue.job_queue", mock_jq):
+                resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                                  headers={"X-API-Token": token},
+                                  json={
+                                      "speaker_map": {"SPEAKER_00": "Alice"},
+                                      "regenerate_summary": True,
+                                  })
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("summary_queued") is True
+            mock_jq.enqueue.assert_called_once()
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_embeddings_updated():
+    """With speaker_embeddings -> update_speaker_embedding called, counts returned."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(
+            user,
+            transcription=SAMPLE_TRANSCRIPTION_JSON,
+            speaker_embeddings=SAMPLE_EMBEDDINGS,
+        )
+        speaker = _create_test_speaker(user, "Alice")
+        client = app.test_client()
+        try:
+            mock_update = MagicMock()
+            mock_snippets = MagicMock(return_value=2)
+            with patch("src.services.speaker_embedding_matcher.update_speaker_embedding", mock_update), \
+                 patch("src.services.speaker_snippets.create_speaker_snippets", mock_snippets):
+                resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                                  headers={"X-API-Token": token},
+                                  json={"speaker_map": {"SPEAKER_00": "Alice"}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("embeddings_updated") >= 1, f"embeddings_updated: {body}"
+            mock_update.assert_called()
+            return True
+        finally:
+            _cleanup(rec, speaker, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_no_transcription():
+    """Recording without transcription -> speakers applied to empty content gracefully."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=None)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "Alice"}})
+            # Should succeed (or at least not 500)
+            assert resp.status_code in (200, 400), f"Expected 200/400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_assign_whitespace_name_trimmed():
+    """Names with leading/trailing whitespace get trimmed."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.put(f"/api/v1/recordings/{rec.id}/speakers/assign",
+                              headers={"X-API-Token": token},
+                              json={"speaker_map": {"SPEAKER_00": "  Alice  "}})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            db.session.refresh(rec)
+            segments = json.loads(rec.transcription)
+            assert segments[0]["speaker"] == "Alice", f"Name not trimmed: '{segments[0]['speaker']}'"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+# =========================================================================
+# Group 2: POST /recordings/<id>/speakers/identify  (10 tests)
+# =========================================================================
+
+
+def test_identify_no_auth():
+    """No token -> 302."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify")
+            assert resp.status_code in (302, 401), f"Expected 302/401, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_recording_not_found():
+    """Nonexistent ID -> 404."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.post("/api/v1/recordings/999999/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 404, f"Expected 404, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_wrong_user_recording():
+    """Other user's recording -> 403."""
+    with app.app_context():
+        owner, co = _get_or_create_test_user("_id_owner")
+        other, cu = _get_or_create_test_user("_id_other")
+        token_rec, token = _create_api_token(other)
+        rec = _create_test_recording(owner, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 403, f"Expected 403, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(other)
+            if co:
+                _cleanup(owner)
+
+
+def test_identify_no_transcription():
+    """No transcription -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=None)
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_non_json_transcription():
+    """Plain text -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_TEXT)
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_json_but_not_list():
+    """Dict JSON -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=json.dumps({"key": "value"}))
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_happy_path():
+    """Mock LLM returns names -> 200 with speaker_map."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            # Build a mock LLM completion response
+            mock_completion = MagicMock()
+            mock_completion.choices = [MagicMock()]
+            mock_completion.choices[0].message.content = json.dumps({
+                "SPEAKER_00": "Alice",
+                "SPEAKER_01": "Bob",
+            })
+
+            with patch("src.services.llm.call_llm_completion", return_value=mock_completion), \
+                 patch("src.models.system.SystemSetting") as mock_ss:
+                mock_ss.get_setting.return_value = 30000
+                resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                                   headers={"X-API-Token": token})
+
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("success") is True
+            sm = body.get("speaker_map", {})
+            assert sm.get("SPEAKER_00") == "Alice"
+            assert sm.get("SPEAKER_01") == "Bob"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_post_processing_unknown_values():
+    """'Unknown'/'N/A' cleared to ''."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            mock_completion = MagicMock()
+            mock_completion.choices = [MagicMock()]
+            mock_completion.choices[0].message.content = json.dumps({
+                "SPEAKER_00": "Unknown",
+                "SPEAKER_01": "N/A",
+            })
+
+            with patch("src.services.llm.call_llm_completion", return_value=mock_completion), \
+                 patch("src.models.system.SystemSetting") as mock_ss:
+                mock_ss.get_setting.return_value = 30000
+                resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                                   headers={"X-API-Token": token})
+
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            sm = body.get("speaker_map", {})
+            assert sm.get("SPEAKER_00") == "", f"Expected empty, got {sm.get('SPEAKER_00')}"
+            assert sm.get("SPEAKER_01") == "", f"Expected empty, got {sm.get('SPEAKER_01')}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_no_speakers_in_transcript():
+    """Segments without speaker field -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        no_speakers = json.dumps([{"sentence": "Hello"}, {"sentence": "World"}])
+        rec = _create_test_recording(user, transcription=no_speakers)
+        client = app.test_client()
+        try:
+            resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                               headers={"X-API-Token": token})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_identify_llm_error():
+    """LLM raises exception -> 500."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            with patch("src.services.llm.call_llm_completion",
+                       side_effect=RuntimeError("LLM down")), \
+                 patch("src.models.system.SystemSetting") as mock_ss:
+                mock_ss.get_setting.return_value = 30000
+                resp = client.post(f"/api/v1/recordings/{rec.id}/speakers/identify",
+                                   headers={"X-API-Token": token})
+            assert resp.status_code == 500, f"Expected 500, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+# =========================================================================
+# Group 3: PUT /settings/auto-summarization  (5 tests)
+# =========================================================================
+
+
+def test_auto_summarization_no_auth():
+    """No token -> 302."""
+    with app.app_context():
+        client = app.test_client()
+        resp = client.put("/api/v1/settings/auto-summarization",
+                          json={"enabled": True})
+        assert resp.status_code in (302, 401), f"Expected 302/401, got {resp.status_code}"
+        return True
+
+
+def test_auto_summarization_missing_enabled():
+    """Body {} -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.put("/api/v1/settings/auto-summarization",
+                              headers={"X-API-Token": token},
+                              json={})
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            body = resp.get_json()
+            assert "enabled" in body.get("error", "").lower(), f"Unexpected: {body}"
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_auto_summarization_invalid_json():
+    """Non-JSON body -> 400."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.put("/api/v1/settings/auto-summarization",
+                              headers={"X-API-Token": token,
+                                       "Content-Type": "application/json"},
+                              data="not valid json")
+            assert resp.status_code == 400, f"Expected 400, got {resp.status_code}"
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_auto_summarization_enable():
+    """enabled: true -> updates user, returns true."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        user.auto_summarization = False
+        db.session.commit()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.put("/api/v1/settings/auto-summarization",
+                              headers={"X-API-Token": token},
+                              json={"enabled": True})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("auto_summarization") is True
+            db.session.refresh(user)
+            assert user.auto_summarization is True
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_auto_summarization_disable():
+    """enabled: false -> updates user, returns false."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        user.auto_summarization = True
+        db.session.commit()
+        token_rec, token = _create_api_token(user)
+        client = app.test_client()
+        try:
+            resp = client.put("/api/v1/settings/auto-summarization",
+                              headers={"X-API-Token": token},
+                              json={"enabled": False})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            assert body.get("auto_summarization") is False
+            db.session.refresh(user)
+            assert user.auto_summarization is False
+            return True
+        finally:
+            _cleanup(token_rec)
+            if cu:
+                _cleanup(user)
+
+
+# =========================================================================
+# Group 4: Regression tests  (2 tests)
+# =========================================================================
+
+
+def test_regression_get_speakers_list():
+    """GET /speakers still returns user's speakers."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        speaker = _create_test_speaker(user, "Regression Speaker")
+        client = app.test_client()
+        try:
+            resp = client.get("/api/v1/speakers",
+                              headers={"X-API-Token": token})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            names = [s["name"] for s in body.get("speakers", [])]
+            assert "Regression Speaker" in names, f"Speaker not found: {names}"
+            return True
+        finally:
+            _cleanup(speaker, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+def test_regression_get_recording_speakers():
+    """GET /recordings/<id>/speakers still returns transcript speakers."""
+    with app.app_context():
+        user, cu = _get_or_create_test_user()
+        token_rec, token = _create_api_token(user)
+        rec = _create_test_recording(user, transcription=SAMPLE_TRANSCRIPTION_JSON)
+        client = app.test_client()
+        try:
+            with patch("src.services.speaker_embedding_matcher.find_matching_speakers", return_value={}):
+                resp = client.get(f"/api/v1/recordings/{rec.id}/speakers",
+                                  headers={"X-API-Token": token})
+            assert resp.status_code == 200, f"Expected 200, got {resp.status_code}"
+            body = resp.get_json()
+            labels = [s["label"] for s in body.get("speakers", [])]
+            assert "SPEAKER_00" in labels and "SPEAKER_01" in labels, f"Labels: {labels}"
+            return True
+        finally:
+            _cleanup(rec, token_rec)
+            if cu:
+                _cleanup(user)
+
+
+# =========================================================================
+# Runner
+# =========================================================================
+
+ALL_TESTS = [
+    # Group 1: assign
+    test_assign_no_auth,
+    test_assign_recording_not_found,
+    test_assign_wrong_user_recording,
+    test_assign_missing_speaker_map,
+    test_assign_invalid_speaker_map_type,
+    test_assign_string_value_json_transcript,
+    test_assign_object_value_with_name,
+    test_assign_is_me_flag_with_user_name,
+    test_assign_is_me_flag_without_user_name,
+    test_assign_plain_text_transcript,
+    test_assign_speaker_xx_filtered_from_participants,
+    test_assign_invalid_value_type,
+    test_assign_empty_speaker_map,
+    test_assign_regenerate_summary,
+    test_assign_embeddings_updated,
+    test_assign_no_transcription,
+    test_assign_whitespace_name_trimmed,
+    # Group 2: identify
+    test_identify_no_auth,
+    test_identify_recording_not_found,
+    test_identify_wrong_user_recording,
+    test_identify_no_transcription,
+    test_identify_non_json_transcription,
+    test_identify_json_but_not_list,
+    test_identify_happy_path,
+    test_identify_post_processing_unknown_values,
+    test_identify_no_speakers_in_transcript,
+    test_identify_llm_error,
+    # Group 3: auto-summarization
+    test_auto_summarization_no_auth,
+    test_auto_summarization_missing_enabled,
+    test_auto_summarization_invalid_json,
+    test_auto_summarization_enable,
+    test_auto_summarization_disable,
+    # Group 4: regression
+    test_regression_get_speakers_list,
+    test_regression_get_recording_speakers,
+]
+
+
+def main():
+    print(f"Running {len(ALL_TESTS)} Speaker API tests...\n")
+    passed = 0
+    failed = 0
+    errors = []
+
+    for test_fn in ALL_TESTS:
+        name = test_fn.__name__
+        try:
+            result = test_fn()
+            if result:
+                print(f"  PASS  {name}")
+                passed += 1
+            else:
+                print(f"  FAIL  {name} (returned False)")
+                failed += 1
+                errors.append(name)
+        except Exception as e:
+            print(f"  ERROR {name}: {e}")
+            failed += 1
+            errors.append(name)
+
+    print(f"\n{'=' * 60}")
+    print(f"Results: {passed} passed, {failed} failed out of {len(ALL_TESTS)}")
+    if errors:
+        print("Failed tests:")
+        for e in errors:
+            print(f"  - {e}")
+    print('=' * 60)
+    sys.exit(0 if failed == 0 else 1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/tests/test_api_v1_upload.py b/tests/test_api_v1_upload.py
new file mode 100644
index 00000000..d0037808
--- /dev/null
+++ b/tests/test_api_v1_upload.py
@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+"""
+Integration test for API v1 recording upload endpoint.
+
+Validates API token authentication and expected 400 response when no file is provided.
+"""
+
+import secrets
+import sys
+import os
+
+# Add the parent directory to the path to import app
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db
+from src.models import User, APIToken
+from src.utils.token_auth import hash_token
+
+
+def _get_or_create_test_user():
+    user = User.query.filter_by(username="api_test_user").first()
+    created = False
+    if not user:
+        user = User(username="api_test_user", email="api_test_user@local.test")
+        db.session.add(user)
+        db.session.commit()
+        created = True
+    return user, created
+
+
+def _create_api_token(user):
+    plaintext = f"test-token-{secrets.token_urlsafe(16)}"
+    token = APIToken(
+        user_id=user.id,
+        token_hash=hash_token(plaintext),
+        name="test-api-token"
+    )
+    db.session.add(token)
+    db.session.commit()
+    return token, plaintext
+
+
+def test_upload_requires_file():
+    with app.app_context():
+        user, created_user = _get_or_create_test_user()
+        token_record, token = _create_api_token(user)
+        client = app.test_client()
+
+        try:
+            response = client.post(
+                "/api/v1/recordings/upload",
+                headers={"X-API-Token": token}
+            )
+
+            if response.status_code != 400:
+                print(f"❌ Expected 400, got {response.status_code}")
+                return False
+
+            payload = response.get_json(silent=True) or {}
+            if payload.get("error") != "No file provided":
+                print(f"❌ Unexpected error payload: {payload}")
+                return False
+
+            print("✅ Token auth works and missing file returns 400 as expected")
+            return True
+        finally:
+            db.session.delete(token_record)
+            db.session.commit()
+            if created_user:
+                db.session.delete(user)
+                db.session.commit()
+
+
+def main():
+    print("🚀 Running API v1 upload test...\n")
+    ok = test_upload_requires_file()
+    print("\n" + ("✅ PASS" if ok else "❌ FAIL"))
+    sys.exit(0 if ok else 1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/tests/test_auto_process_tags.py b/tests/test_auto_process_tags.py
new file mode 100644
index 00000000..68ced4df
--- /dev/null
+++ b/tests/test_auto_process_tags.py
@@ -0,0 +1,630 @@
+#!/usr/bin/env python3
+"""
+Tests for auto-process tag folders feature (Issue #242).
+
+Covers:
+- Model fields and database schema
+- Tag API create/update/delete with auto-process
+- File monitor tag subdirectory scanning
+- Edge cases (sanitization, multiple tags, feature disabled)
+
+Run with: python tests/test_auto_process_tags.py
+"""
+
+import os
+import sys
+import shutil
+import tempfile
+import unittest
+from unittest.mock import patch, MagicMock
+from datetime import datetime
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db
+from src.models import User, Recording, Tag, RecordingTag
+import src.api.tags as tags_module
+
+
+def _enable_auto_processing():
+    """Context manager-like helper to patch ENABLE_AUTO_PROCESSING at module level."""
+    return patch.object(tags_module, 'ENABLE_AUTO_PROCESSING', True)
+
+
+def _disable_auto_processing():
+    return patch.object(tags_module, 'ENABLE_AUTO_PROCESSING', False)
+
+
+# ---------------------------------------------------------------------------
+# Layer 1: Model & Database
+# ---------------------------------------------------------------------------
+
+class TestTagAutoProcessModel(unittest.TestCase):
+    """Test Tag model auto-process fields."""
+
+    def setUp(self):
+        self.app_context = app.app_context()
+        self.app_context.push()
+
+    def tearDown(self):
+        self.app_context.pop()
+
+    def test_tag_is_auto_process_defaults_to_false(self):
+        """New tags should default is_auto_process to False."""
+        tag = Tag(name='test', user_id=1)
+        self.assertFalse(tag.is_auto_process)
+
+    def test_tag_auto_process_folder_name_persists(self):
+        """auto_process_folder_name should be settable."""
+        tag = Tag(name='test', user_id=1, auto_process_folder_name='my-folder')
+        self.assertEqual(tag.auto_process_folder_name, 'my-folder')
+
+    def test_tag_to_dict_includes_auto_process_fields(self):
+        """to_dict() should include is_auto_process and auto_process_folder_name."""
+        tag = Tag(name='test', user_id=1, is_auto_process=True, auto_process_folder_name='test-folder')
+        tag.group = None
+        tag.naming_template = None
+        tag.export_template = None
+        tag.recording_associations = []
+        d = tag.to_dict()
+        self.assertIn('is_auto_process', d)
+        self.assertTrue(d['is_auto_process'])
+        self.assertIn('auto_process_folder_name', d)
+        self.assertEqual(d['auto_process_folder_name'], 'test-folder')
+
+    def test_tag_auto_process_column_exists(self):
+        """Verify the columns exist in the database schema."""
+        from sqlalchemy import inspect
+        inspector = inspect(db.engine)
+        columns = [col['name'] for col in inspector.get_columns('tag')]
+        self.assertIn('is_auto_process', columns)
+        self.assertIn('auto_process_folder_name', columns)
+
+
+# ---------------------------------------------------------------------------
+# Layer 2: API Tests
+# ---------------------------------------------------------------------------
+
+def _drop_synthetic_users(*usernames):
+    """Helper used by class-level teardowns to remove any synthetic users
+    created during the test run. Cascades clear their dependent rows so the
+    dev database does not accumulate test artifacts that show up in admin
+    and user-facing screens.
+    """
+    with app.app_context():
+        for name in usernames:
+            row = User.query.filter_by(username=name).first()
+            if row:
+                db.session.delete(row)
+        db.session.commit()
+
+
+class TestTagAutoProcessAPI(unittest.TestCase):
+    """Test Tag API endpoints with auto-process."""
+
+    @classmethod
+    def tearDownClass(cls):
+        _drop_synthetic_users('autotest_user', 'autotest_nonadmin')
+
+    def setUp(self):
+        self.app_context = app.app_context()
+        self.app_context.push()
+        app.config['WTF_CSRF_ENABLED'] = False
+        self.client = app.test_client()
+        self.temp_dir = tempfile.mkdtemp()
+
+        # Create test user
+        self.user = User.query.filter_by(username='autotest_user').first()
+        if not self.user:
+            self.user = User(
+                username='autotest_user',
+                email='autotest@test.com',
+                password='fakehash',
+                is_admin=True
+            )
+            db.session.add(self.user)
+            db.session.commit()
+
+        # Log in
+        with self.client.session_transaction() as sess:
+            sess['_user_id'] = str(self.user.id)
+
+    def tearDown(self):
+        Tag.query.filter_by(user_id=self.user.id).delete()
+        db.session.commit()
+        shutil.rmtree(self.temp_dir, ignore_errors=True)
+        self.app_context.pop()
+
+    def test_create_tag_with_auto_process_creates_folder(self):
+        """Creating a tag with is_auto_process=true should create a folder."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Auto Test Tag',
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertIn(resp.status_code, [200, 201])
+        data = resp.get_json()
+        self.assertTrue(data.get('is_auto_process'))
+        self.assertEqual(data.get('auto_process_folder_name'), 'auto-test-tag')
+        self.assertTrue(os.path.isdir(os.path.join(self.temp_dir, 'auto-test-tag')))
+
+    def test_create_tag_default_no_auto_process(self):
+        """Creating a tag without is_auto_process should not enable it."""
+        resp = self.client.post('/api/tags', json={
+            'name': 'Normal Tag'
+        }, content_type='application/json')
+
+        self.assertIn(resp.status_code, [200, 201])
+        data = resp.get_json()
+        self.assertFalse(data.get('is_auto_process'))
+        self.assertIsNone(data.get('auto_process_folder_name'))
+
+    def test_update_tag_enable_auto_process(self):
+        """Enabling auto-process on an existing tag should create folder."""
+        # Create tag without auto-process first
+        resp = self.client.post('/api/tags', json={
+            'name': 'Update Test'
+        }, content_type='application/json')
+        self.assertIn(resp.status_code, [200, 201])
+        tag_id = resp.get_json()['id']
+
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.put(f'/api/tags/{tag_id}', json={
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertTrue(resp.get_json()['is_auto_process'])
+        self.assertTrue(os.path.isdir(os.path.join(self.temp_dir, 'update-test')))
+
+    def test_update_tag_disable_auto_process_removes_empty_folder(self):
+        """Disabling auto-process should remove the empty folder."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Disable Test',
+                'is_auto_process': True
+            }, content_type='application/json')
+            self.assertIn(resp.status_code, [200, 201])
+            tag_id = resp.get_json()['id']
+            folder_path = os.path.join(self.temp_dir, 'disable-test')
+            self.assertTrue(os.path.isdir(folder_path))
+
+            resp = self.client.put(f'/api/tags/{tag_id}', json={
+                'is_auto_process': False
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertFalse(resp.get_json()['is_auto_process'])
+        self.assertFalse(os.path.exists(folder_path))
+
+    def test_auto_process_rejected_for_group_tags(self):
+        """Group tags should not be allowed to have auto-process."""
+        from src.models import Group, GroupMembership
+        group = Group.query.filter_by(name='autotest_group').first()
+        if not group:
+            group = Group(name='autotest_group')
+            db.session.add(group)
+            db.session.commit()
+        membership = GroupMembership.query.filter_by(group_id=group.id, user_id=self.user.id).first()
+        if not membership:
+            membership = GroupMembership(group_id=group.id, user_id=self.user.id, role='admin')
+            db.session.add(membership)
+            db.session.commit()
+
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Group Auto Tag',
+                'group_id': group.id,
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 400)
+        self.assertIn('not available for group tags', resp.get_json()['error'])
+
+        # Clean up
+        db.session.delete(membership)
+        db.session.delete(group)
+        db.session.commit()
+
+    def test_auto_process_rejected_when_feature_disabled(self):
+        """Auto-process should be rejected when ENABLE_AUTO_PROCESSING is false."""
+        with _disable_auto_processing():
+            resp = self.client.post('/api/tags', json={
+                'name': 'Disabled Feature Tag',
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 400)
+        self.assertIn('not enabled', resp.get_json()['error'])
+
+    def test_delete_tag_removes_auto_process_folder(self):
+        """Deleting an auto-process tag should remove its empty folder."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Delete Test',
+                'is_auto_process': True
+            }, content_type='application/json')
+            self.assertIn(resp.status_code, [200, 201])
+            tag_id = resp.get_json()['id']
+            folder_path = os.path.join(self.temp_dir, 'delete-test')
+            self.assertTrue(os.path.isdir(folder_path))
+
+            resp = self.client.delete(f'/api/tags/{tag_id}')
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertFalse(os.path.exists(folder_path))
+
+    def test_folder_name_unchanged_on_tag_rename(self):
+        """Renaming a tag should not change its auto_process_folder_name."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Original Name',
+                'is_auto_process': True
+            }, content_type='application/json')
+            self.assertIn(resp.status_code, [200, 201])
+            tag_id = resp.get_json()['id']
+            original_folder = resp.get_json()['auto_process_folder_name']
+
+            resp = self.client.put(f'/api/tags/{tag_id}', json={
+                'name': 'Renamed Tag'
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertEqual(resp.get_json()['auto_process_folder_name'], original_folder)
+
+    def test_trigger_endpoint_requires_admin(self):
+        """Non-admin users should get 403 from trigger endpoint."""
+        non_admin = User.query.filter_by(username='autotest_nonadmin').first()
+        if not non_admin:
+            non_admin = User(
+                username='autotest_nonadmin',
+                email='autotest_nonadmin@test.com',
+                password='fakehash',
+                is_admin=False
+            )
+            db.session.add(non_admin)
+            db.session.commit()
+
+        with self.client.session_transaction() as sess:
+            sess['_user_id'] = str(non_admin.id)
+
+        resp = self.client.post('/admin/auto-process/trigger',
+                                content_type='application/json')
+        self.assertEqual(resp.status_code, 403)
+
+        db.session.delete(non_admin)
+        db.session.commit()
+
+    def test_trigger_endpoint_returns_400_when_not_running(self):
+        """Trigger should return 400 when file monitor is not running."""
+        from src import file_monitor as fm_module
+        original = fm_module.file_monitor
+        fm_module.file_monitor = None
+        try:
+            resp = self.client.post('/admin/auto-process/trigger',
+                                    content_type='application/json')
+            self.assertEqual(resp.status_code, 400)
+        finally:
+            fm_module.file_monitor = original
+
+
+# ---------------------------------------------------------------------------
+# Layer 3: File Monitor Integration
+# ---------------------------------------------------------------------------
+
+class TestFileMonitorTagSubdirs(unittest.TestCase):
+    @classmethod
+    def tearDownClass(cls):
+        _drop_synthetic_users('autotest_monitor_user')
+
+
+    """Test file monitor tag subdirectory scanning."""
+
+    def setUp(self):
+        self.app_context = app.app_context()
+        self.app_context.push()
+        self.temp_dir = tempfile.mkdtemp()
+
+        self.user = User.query.filter_by(username='autotest_monitor_user').first()
+        if not self.user:
+            self.user = User(
+                username='autotest_monitor_user',
+                email='autotest_monitor@test.com',
+                password='fakehash',
+                is_admin=True
+            )
+            db.session.add(self.user)
+            db.session.commit()
+
+    def tearDown(self):
+        Tag.query.filter_by(user_id=self.user.id).delete()
+        db.session.commit()
+        shutil.rmtree(self.temp_dir, ignore_errors=True)
+        self.app_context.pop()
+
+    def _create_auto_process_tag(self, name, folder_name=None):
+        """Helper to create an auto-process tag."""
+        from src.api.tags import _sanitize_folder_name
+        if not folder_name:
+            folder_name = _sanitize_folder_name(name)
+        tag = Tag(
+            name=name,
+            user_id=self.user.id,
+            is_auto_process=True,
+            auto_process_folder_name=folder_name
+        )
+        db.session.add(tag)
+        db.session.commit()
+        return tag
+
+    def test_scan_detects_file_in_tag_subdirectory(self):
+        """Files in tag subdirectories should be detected by scanner."""
+        from src.file_monitor import FileMonitor
+
+        tag = self._create_auto_process_tag('Meetings')
+        tag_dir = os.path.join(self.temp_dir, tag.auto_process_folder_name)
+        os.makedirs(tag_dir)
+
+        test_file = os.path.join(tag_dir, 'test.mp3')
+        with open(test_file, 'wb') as f:
+            f.write(b'\x00' * 1024)
+
+        monitor = FileMonitor(self.temp_dir, check_interval=30, mode='admin_only')
+        monitor._admin_user_id = self.user.id
+        monitor._valid_users = {self.user.id: self.user.username}
+
+        processed = []
+        def mock_process(path, uid, tag_id=None):
+            processed.append({'path': str(path), 'user_id': uid, 'tag_id': tag_id})
+        monitor._process_file = mock_process
+        monitor._is_file_stable = lambda *a, **kw: True
+
+        monitor._scan_tag_subdirectories(monitor.base_watch_directory, self.user.id)
+
+        self.assertEqual(len(processed), 1)
+        self.assertEqual(processed[0]['tag_id'], tag.id)
+
+    def test_scan_applies_tag_to_recording(self):
+        """Files processed from tag dirs should get the tag applied."""
+        tag = self._create_auto_process_tag('Interviews')
+
+        recording = Recording(
+            title='Test Recording',
+            audio_path='/tmp/test.mp3',
+            original_filename='test.mp3',
+            status='PENDING',
+            user_id=self.user.id
+        )
+        db.session.add(recording)
+        db.session.commit()
+
+        rt = RecordingTag(recording_id=recording.id, tag_id=tag.id, order=0)
+        db.session.add(rt)
+        db.session.commit()
+
+        associations = RecordingTag.query.filter_by(recording_id=recording.id).all()
+        self.assertEqual(len(associations), 1)
+        self.assertEqual(associations[0].tag_id, tag.id)
+
+        db.session.delete(rt)
+        db.session.delete(recording)
+        db.session.commit()
+
+    def test_scan_passes_tag_settings_to_job_params(self):
+        """Tag settings (hotwords, prompt, language) should be passed to job params."""
+        tag = self._create_auto_process_tag('Technical')
+        tag.default_hotwords = 'Kubernetes, Docker'
+        tag.default_initial_prompt = 'Technical discussion'
+        tag.default_language = 'en'
+        db.session.commit()
+
+        job_params = {}
+        if tag.default_hotwords:
+            job_params['hotwords'] = tag.default_hotwords
+        if tag.default_initial_prompt:
+            job_params['initial_prompt'] = tag.default_initial_prompt
+        if tag.default_language:
+            job_params['language'] = tag.default_language
+        job_params['tag_id'] = tag.id
+
+        self.assertEqual(job_params['hotwords'], 'Kubernetes, Docker')
+        self.assertEqual(job_params['initial_prompt'], 'Technical discussion')
+        self.assertEqual(job_params['language'], 'en')
+        self.assertEqual(job_params['tag_id'], tag.id)
+
+    def test_root_directory_files_have_no_tag(self):
+        """Files in the root watch directory should not get a tag."""
+        from src.file_monitor import FileMonitor
+
+        monitor = FileMonitor(self.temp_dir, check_interval=30, mode='admin_only')
+        monitor._admin_user_id = self.user.id
+
+        test_file = os.path.join(self.temp_dir, 'root_test.mp3')
+        with open(test_file, 'wb') as f:
+            f.write(b'\x00' * 1024)
+
+        processed = []
+        def mock_process(path, uid, tag_id=None):
+            processed.append({'tag_id': tag_id})
+        monitor._process_file = mock_process
+        monitor._is_file_stable = lambda *a, **kw: True
+
+        monitor._scan_directory_for_user(monitor.base_watch_directory, self.user.id)
+
+        self.assertEqual(len(processed), 1)
+        self.assertIsNone(processed[0]['tag_id'])
+
+    def test_startup_ensures_tag_folders_exist(self):
+        """start_file_monitor should create folders for existing auto-process tags."""
+        tag = self._create_auto_process_tag('Startup Test')
+        folder_path = os.path.join(self.temp_dir, tag.auto_process_folder_name)
+        self.assertFalse(os.path.exists(folder_path))
+
+        from src.file_monitor import _ensure_tag_folders_on_startup
+        _ensure_tag_folders_on_startup(app, self.temp_dir, 'admin_only')
+
+        self.assertTrue(os.path.isdir(folder_path))
+
+    def test_folder_recreated_if_externally_deleted(self):
+        """If a tag folder is deleted externally, startup should recreate it."""
+        tag = self._create_auto_process_tag('Recreate Test')
+        folder_path = os.path.join(self.temp_dir, tag.auto_process_folder_name)
+        os.makedirs(folder_path, exist_ok=True)
+        self.assertTrue(os.path.isdir(folder_path))
+
+        os.rmdir(folder_path)
+        self.assertFalse(os.path.exists(folder_path))
+
+        from src.file_monitor import _ensure_tag_folders_on_startup
+        _ensure_tag_folders_on_startup(app, self.temp_dir, 'admin_only')
+
+        self.assertTrue(os.path.isdir(folder_path))
+
+    def test_unmatched_subdirectory_ignored(self):
+        """Subdirectories without matching tags should be skipped."""
+        from src.file_monitor import FileMonitor
+
+        random_dir = os.path.join(self.temp_dir, 'random-folder')
+        os.makedirs(random_dir)
+        test_file = os.path.join(random_dir, 'test.mp3')
+        with open(test_file, 'wb') as f:
+            f.write(b'\x00' * 1024)
+
+        monitor = FileMonitor(self.temp_dir, check_interval=30, mode='admin_only')
+        monitor._admin_user_id = self.user.id
+        monitor._valid_users = {self.user.id: self.user.username}
+
+        processed = []
+        def mock_process(path, uid, tag_id=None):
+            processed.append({'tag_id': tag_id})
+        monitor._process_file = mock_process
+        monitor._is_file_stable = lambda *a, **kw: True
+
+        monitor._scan_tag_subdirectories(monitor.base_watch_directory, self.user.id)
+
+        self.assertEqual(len(processed), 0)
+
+
+# ---------------------------------------------------------------------------
+# Layer 4: Edge Cases
+# ---------------------------------------------------------------------------
+
+class TestAutoProcessEdgeCases(unittest.TestCase):
+    @classmethod
+    def tearDownClass(cls):
+        _drop_synthetic_users('autotest_edge_user')
+
+
+    """Edge case tests for auto-process features."""
+
+    def setUp(self):
+        self.app_context = app.app_context()
+        self.app_context.push()
+        app.config['WTF_CSRF_ENABLED'] = False
+        self.temp_dir = tempfile.mkdtemp()
+
+        self.user = User.query.filter_by(username='autotest_edge_user').first()
+        if not self.user:
+            self.user = User(
+                username='autotest_edge_user',
+                email='autotest_edge@test.com',
+                password='fakehash',
+                is_admin=True
+            )
+            db.session.add(self.user)
+            db.session.commit()
+
+        self.client = app.test_client()
+        with self.client.session_transaction() as sess:
+            sess['_user_id'] = str(self.user.id)
+
+    def tearDown(self):
+        Tag.query.filter_by(user_id=self.user.id).delete()
+        db.session.commit()
+        shutil.rmtree(self.temp_dir, ignore_errors=True)
+        self.app_context.pop()
+
+    def test_sanitize_folder_name_special_characters(self):
+        """Folder name sanitization should handle special characters."""
+        from src.api.tags import _sanitize_folder_name
+
+        self.assertEqual(_sanitize_folder_name('Hello World'), 'hello-world')
+        self.assertEqual(_sanitize_folder_name('Test  Tag'), 'test-tag')
+        self.assertEqual(_sanitize_folder_name('Special!@#$%'), 'special')
+        self.assertEqual(_sanitize_folder_name('under_score'), 'under-score')
+        self.assertEqual(_sanitize_folder_name('  Spaces  '), 'spaces')
+        self.assertEqual(_sanitize_folder_name('MiXeD CaSe'), 'mixed-case')
+        self.assertEqual(_sanitize_folder_name('dots.and-dashes'), 'dots.and-dashes')
+        self.assertEqual(_sanitize_folder_name('!@#$%'), 'tag')
+
+    def test_multiple_tags_different_folders_route_correctly(self):
+        """Multiple auto-process tags should each have their own folder."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp1 = self.client.post('/api/tags', json={
+                'name': 'Tag Alpha',
+                'is_auto_process': True
+            }, content_type='application/json')
+            resp2 = self.client.post('/api/tags', json={
+                'name': 'Tag Beta',
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertEqual(resp1.status_code, 201)
+        self.assertEqual(resp2.status_code, 201)
+
+        folder1 = resp1.get_json()['auto_process_folder_name']
+        folder2 = resp2.get_json()['auto_process_folder_name']
+
+        self.assertNotEqual(folder1, folder2)
+        self.assertTrue(os.path.isdir(os.path.join(self.temp_dir, folder1)))
+        self.assertTrue(os.path.isdir(os.path.join(self.temp_dir, folder2)))
+
+    def test_user_directories_mode_tag_folders(self):
+        """In user_directories mode, tag folders should be under user dir."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'user_directories'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'User Dir Tag',
+                'is_auto_process': True
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 201)
+        data = resp.get_json()
+        expected_path = os.path.join(self.temp_dir, f'user{self.user.id}', data['auto_process_folder_name'])
+        self.assertTrue(os.path.isdir(expected_path))
+
+    def test_disable_auto_process_folder_not_empty_leaves_folder(self):
+        """Disabling auto-process should leave the folder if it has files."""
+        with _enable_auto_processing(), \
+             patch.dict(os.environ, {'AUTO_PROCESS_WATCH_DIR': self.temp_dir, 'AUTO_PROCESS_MODE': 'admin_only'}):
+            resp = self.client.post('/api/tags', json={
+                'name': 'Nonempty Test',
+                'is_auto_process': True
+            }, content_type='application/json')
+            self.assertIn(resp.status_code, [200, 201])
+            tag_id = resp.get_json()['id']
+            folder_name = resp.get_json()['auto_process_folder_name']
+            folder_path = os.path.join(self.temp_dir, folder_name)
+
+            # Put a file in the folder
+            with open(os.path.join(folder_path, 'important.mp3'), 'wb') as f:
+                f.write(b'\x00' * 100)
+
+            resp = self.client.put(f'/api/tags/{tag_id}', json={
+                'is_auto_process': False
+            }, content_type='application/json')
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertTrue(os.path.isdir(folder_path))
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/test_bugfixes.py b/tests/test_bugfixes.py
new file mode 100644
index 00000000..20863808
--- /dev/null
+++ b/tests/test_bugfixes.py
@@ -0,0 +1,251 @@
+#!/usr/bin/env python3
+"""
+Tests for specific bug fixes.
+
+- Issue #230: Bulk delete crash when recordings have speaker_snippets
+- Issue #223: File monitor stability time env var
+"""
+
+import json
+import os
+import sys
+import time
+import tempfile
+from pathlib import Path
+from unittest.mock import patch, MagicMock
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db
+from src.models import User, Recording
+from src.models.speaker_snippet import SpeakerSnippet
+
+# Disable CSRF for testing
+app.config['WTF_CSRF_ENABLED'] = False
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+def _get_or_create_user():
+    user = User.query.filter_by(username="bugfix_test_user").first()
+    if not user:
+        user = User(username="bugfix_test_user", email="bugfix@local.test")
+        db.session.add(user)
+        db.session.commit()
+    return user
+
+
+def teardown_module(module):
+    """Drop the synthetic user created by this test module so it does not
+    accumulate in the dev database and surface in admin / user-facing screens.
+    pytest auto-calls teardown_module after every test in the file completes.
+    """
+    with app.app_context():
+        user = User.query.filter_by(username="bugfix_test_user").first()
+        if user:
+            db.session.delete(user)
+            db.session.commit()
+
+
+def _create_recording_with_snippets(user):
+    """Create a recording that has speaker_snippet records attached."""
+    rec = Recording(
+        user_id=user.id,
+        title="Recording with snippets",
+        status="COMPLETED",
+        transcription=json.dumps([
+            {"speaker": "SPEAKER_00", "sentence": "Hello there."},
+        ]),
+    )
+    db.session.add(rec)
+    db.session.commit()
+
+    # We need a speaker to attach snippets to
+    from src.models import Speaker
+    speaker = Speaker.query.filter_by(user_id=user.id, name="BugfixTestSpeaker").first()
+    if not speaker:
+        speaker = Speaker(name="BugfixTestSpeaker", user_id=user.id)
+        db.session.add(speaker)
+        db.session.commit()
+
+    snippet = SpeakerSnippet(
+        speaker_id=speaker.id,
+        recording_id=rec.id,
+        segment_index=0,
+        text_snippet="Hello there.",
+    )
+    db.session.add(snippet)
+    db.session.commit()
+
+    return rec, speaker, snippet
+
+
+# ---------------------------------------------------------------------------
+# Issue #230: Deleting recordings with speaker_snippets
+# ---------------------------------------------------------------------------
+
+class TestIssue230BulkDeleteCascade:
+    """Verify that deleting a recording with speaker_snippets doesn't crash."""
+
+    def test_single_delete_with_snippets(self):
+        """Single DELETE /recording/<id> should succeed when snippets exist."""
+        with app.app_context():
+            user = _get_or_create_user()
+            rec, speaker, snippet = _create_recording_with_snippets(user)
+            rec_id = rec.id
+            snippet_id = snippet.id
+
+            with app.test_client() as client:
+                # Login
+                with client.session_transaction() as sess:
+                    sess['_user_id'] = str(user.id)
+
+                resp = client.delete(f'/recording/{rec_id}')
+                assert resp.status_code == 200, f"Delete failed: {resp.get_json()}"
+                data = resp.get_json()
+                assert data.get('success') is True
+
+            # Verify snippet was also deleted
+            orphan = db.session.get(SpeakerSnippet, snippet_id)
+            assert orphan is None, "Speaker snippet should have been deleted with recording"
+
+            # Cleanup speaker
+            db.session.delete(speaker)
+            db.session.commit()
+
+    def test_bulk_delete_with_snippets(self):
+        """DELETE /api/recordings/bulk should succeed when snippets exist."""
+        with app.app_context():
+            user = _get_or_create_user()
+            rec, speaker, snippet = _create_recording_with_snippets(user)
+            rec_id = rec.id
+            snippet_id = snippet.id
+
+            with app.test_client() as client:
+                with client.session_transaction() as sess:
+                    sess['_user_id'] = str(user.id)
+
+                resp = client.delete(
+                    '/api/recordings/bulk',
+                    json={'recording_ids': [rec_id]},
+                    content_type='application/json',
+                )
+                assert resp.status_code == 200, f"Bulk delete failed: {resp.get_json()}"
+                data = resp.get_json()
+                assert data.get('success') is True
+                assert rec_id in data.get('deleted_ids', [])
+
+            # Verify snippet was also deleted
+            orphan = db.session.get(SpeakerSnippet, snippet_id)
+            assert orphan is None, "Speaker snippet should have been deleted with recording"
+
+            # Cleanup speaker
+            db.session.delete(speaker)
+            db.session.commit()
+
+    def test_bulk_delete_multiple_with_snippets(self):
+        """Bulk deleting multiple recordings (some with snippets) should succeed."""
+        with app.app_context():
+            user = _get_or_create_user()
+            rec1, speaker, snippet = _create_recording_with_snippets(user)
+            rec2 = Recording(user_id=user.id, title="No snippets", status="COMPLETED")
+            db.session.add(rec2)
+            db.session.commit()
+
+            rec1_id, rec2_id = rec1.id, rec2.id
+
+            with app.test_client() as client:
+                with client.session_transaction() as sess:
+                    sess['_user_id'] = str(user.id)
+
+                resp = client.delete(
+                    '/api/recordings/bulk',
+                    json={'recording_ids': [rec1_id, rec2_id]},
+                    content_type='application/json',
+                )
+                assert resp.status_code == 200, f"Bulk delete failed: {resp.get_json()}"
+                data = resp.get_json()
+                assert data.get('deleted_count') == 2
+
+            # Cleanup speaker
+            db.session.delete(speaker)
+            db.session.commit()
+
+
+# ---------------------------------------------------------------------------
+# Issue #223: File monitor stability time
+# ---------------------------------------------------------------------------
+
+class TestIssue223StabilityTime:
+    """Verify AUTO_PROCESS_STABILITY_TIME env var is respected."""
+
+    def test_default_stability_time(self):
+        """Without env var, stability_time defaults to 5."""
+        from src.file_monitor import FileMonitor
+        monitor = FileMonitor.__new__(FileMonitor)
+        monitor.logger = MagicMock()
+
+        with tempfile.NamedTemporaryFile(suffix='.wav', delete=False) as f:
+            f.write(b'fake audio data')
+            tmp_path = Path(f.name)
+
+        try:
+            with patch.dict(os.environ, {}, clear=False):
+                # Remove the env var if it exists
+                os.environ.pop('AUTO_PROCESS_STABILITY_TIME', None)
+                with patch('time.sleep') as mock_sleep:
+                    monitor._is_file_stable(tmp_path)
+                    mock_sleep.assert_called_once_with(5)
+        finally:
+            tmp_path.unlink(missing_ok=True)
+
+    def test_custom_stability_time(self):
+        """AUTO_PROCESS_STABILITY_TIME=15 should sleep for 15 seconds."""
+        from src.file_monitor import FileMonitor
+        monitor = FileMonitor.__new__(FileMonitor)
+        monitor.logger = MagicMock()
+
+        with tempfile.NamedTemporaryFile(suffix='.wav', delete=False) as f:
+            f.write(b'fake audio data')
+            tmp_path = Path(f.name)
+
+        try:
+            with patch.dict(os.environ, {'AUTO_PROCESS_STABILITY_TIME': '15'}):
+                with patch('time.sleep') as mock_sleep:
+                    # _is_file_stable uses the default param, but the caller reads env
+                    # So we test the caller path via _scan_user_directory indirectly
+                    # or just call with explicit value
+                    stability_time = int(os.environ.get('AUTO_PROCESS_STABILITY_TIME', '5'))
+                    monitor._is_file_stable(tmp_path, stability_time)
+                    mock_sleep.assert_called_once_with(15)
+        finally:
+            tmp_path.unlink(missing_ok=True)
+
+    def test_no_hardcoded_cap(self):
+        """Stability time should NOT be capped at 2 seconds anymore."""
+        from src.file_monitor import FileMonitor
+        monitor = FileMonitor.__new__(FileMonitor)
+        monitor.logger = MagicMock()
+
+        with tempfile.NamedTemporaryFile(suffix='.wav', delete=False) as f:
+            f.write(b'fake audio data')
+            tmp_path = Path(f.name)
+
+        try:
+            with patch('time.sleep') as mock_sleep:
+                monitor._is_file_stable(tmp_path, stability_time=30)
+                # Should sleep for 30, NOT min(30, 2) = 2
+                mock_sleep.assert_called_once_with(30)
+        finally:
+            tmp_path.unlink(missing_ok=True)
+
+
+# ---------------------------------------------------------------------------
+# Runner
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import pytest
+    sys.exit(pytest.main([__file__, "-v"]))
diff --git a/tests/test_connector_architecture.py b/tests/test_connector_architecture.py
new file mode 100644
index 00000000..af858baf
--- /dev/null
+++ b/tests/test_connector_architecture.py
@@ -0,0 +1,564 @@
+#!/usr/bin/env python3
+"""
+Test script for the transcription connector architecture.
+
+This script tests:
+1. Connector auto-detection from environment variables
+2. Backwards compatibility with legacy config
+3. Connector specifications and capabilities
+4. Chunking logic (connector-aware)
+5. Codec handling per connector
+6. Request/Response data types
+
+Run with: docker exec speakr-dev python /app/tests/test_connector_architecture.py
+"""
+
+import os
+import sys
+import io
+import json
+from pathlib import Path
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+# Test results tracking
+PASSED = 0
+FAILED = 0
+ERRORS = []
+
+
+def run_test(name, func):
+    """Run a test function and track results."""
+    global PASSED, FAILED, ERRORS
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+        ERRORS.append((name, str(e)))
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+        ERRORS.append((name, f"Exception: {e}"))
+
+
+def clear_env():
+    """Clear all transcription-related environment variables."""
+    keys_to_clear = [
+        'TRANSCRIPTION_CONNECTOR', 'TRANSCRIPTION_API_KEY', 'TRANSCRIPTION_BASE_URL',
+        'TRANSCRIPTION_MODEL', 'WHISPER_MODEL', 'USE_ASR_ENDPOINT', 'ASR_BASE_URL',
+        'ASR_DIARIZE', 'ASR_RETURN_SPEAKER_EMBEDDINGS', 'ASR_TIMEOUT',
+        'ASR_MIN_SPEAKERS', 'ASR_MAX_SPEAKERS', 'ENABLE_CHUNKING', 'CHUNK_LIMIT',
+        'CHUNK_OVERLAP_SECONDS', 'AUDIO_UNSUPPORTED_CODECS',
+    ]
+    for key in keys_to_clear:
+        os.environ.pop(key, None)
+
+
+def reset_registry():
+    """Reset the connector registry singleton."""
+    from src.services.transcription import registry
+    registry._registry = None
+    registry.ConnectorRegistry._instance = None
+    registry.ConnectorRegistry._initialized = False
+    registry.ConnectorRegistry._active_connector = None
+    registry.ConnectorRegistry._connector_name = ""
+
+
+# =============================================================================
+# TEST SECTION 1: Base Classes and Data Types
+# =============================================================================
+
+def test_base_classes():
+    """Test base classes and data types."""
+    print("\n=== Testing Base Classes ===")
+
+    from src.services.transcription.base import (
+        TranscriptionCapability, ConnectorSpecifications, TranscriptionRequest,
+        TranscriptionResponse, TranscriptionSegment,
+    )
+
+    def t1():
+        assert TranscriptionCapability.DIARIZATION is not None
+        assert TranscriptionCapability.TIMESTAMPS is not None
+        assert TranscriptionCapability.SPEAKER_COUNT_CONTROL is not None
+    run_test("TranscriptionCapability enum has expected values", t1)
+
+    def t2():
+        specs = ConnectorSpecifications()
+        assert specs.max_file_size_bytes is None
+        assert specs.handles_chunking_internally is False
+        assert specs.recommended_chunk_seconds == 600
+    run_test("ConnectorSpecifications has correct defaults", t2)
+
+    def t3():
+        specs = ConnectorSpecifications(
+            max_file_size_bytes=25 * 1024 * 1024,
+            handles_chunking_internally=True,
+            unsupported_codecs=frozenset({'opus'})
+        )
+        assert specs.max_file_size_bytes == 25 * 1024 * 1024
+        assert 'opus' in specs.unsupported_codecs
+    run_test("ConnectorSpecifications with custom values", t3)
+
+    def t4():
+        audio = io.BytesIO(b"fake audio data")
+        request = TranscriptionRequest(audio_file=audio, filename="test.wav", diarize=True)
+        assert request.filename == "test.wav"
+        assert request.diarize is True
+    run_test("TranscriptionRequest creation", t4)
+
+    def t5():
+        segments = [
+            TranscriptionSegment(text="Hello", speaker="SPEAKER_00", start_time=0.0, end_time=1.0),
+            TranscriptionSegment(text="World", speaker="SPEAKER_01", start_time=1.0, end_time=2.0),
+        ]
+        response = TranscriptionResponse(text="Hello World", segments=segments, provider="test")
+        storage = response.to_storage_format()
+        data = json.loads(storage)
+        assert len(data) == 2
+        assert data[0]['speaker'] == "SPEAKER_00"
+    run_test("TranscriptionResponse to_storage_format", t5)
+
+    def t6():
+        segments = [TranscriptionSegment(text="Hello", speaker="SPEAKER_00")]
+        response = TranscriptionResponse(text="Hello", segments=segments)
+        assert response.has_diarization() is True
+
+        response2 = TranscriptionResponse(text="Hello", segments=None)
+        assert response2.has_diarization() is False
+    run_test("TranscriptionResponse has_diarization", t6)
+
+
+# =============================================================================
+# TEST SECTION 2: Connector Auto-Detection
+# =============================================================================
+
+def test_auto_detection():
+    """Test connector auto-detection from environment variables."""
+    print("\n=== Testing Connector Auto-Detection ===")
+
+    from src.services.transcription.registry import get_registry
+
+    def t1():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_CONNECTOR'] = 'openai_whisper'
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['ASR_BASE_URL'] = 'http://should-be-ignored:9000'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_whisper'
+    run_test("Explicit TRANSCRIPTION_CONNECTOR takes priority", t1)
+
+    def t2():
+        clear_env()
+        reset_registry()
+        os.environ['ASR_BASE_URL'] = 'http://whisperx:9000'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'asr_endpoint'
+    run_test("ASR_BASE_URL auto-detects asr_endpoint", t2)
+
+    def t3():
+        clear_env()
+        reset_registry()
+        os.environ['USE_ASR_ENDPOINT'] = 'true'
+        os.environ['ASR_BASE_URL'] = 'http://whisperx:9000'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'asr_endpoint'
+    run_test("Legacy USE_ASR_ENDPOINT=true still works", t3)
+
+    def t4():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['TRANSCRIPTION_MODEL'] = 'gpt-4o-transcribe-diarize'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_transcribe'
+    run_test("gpt-4o model auto-detects openai_transcribe", t4)
+
+    def t5():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['TRANSCRIPTION_MODEL'] = 'whisper-1'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_whisper'
+    run_test("whisper-1 model uses openai_whisper", t5)
+
+    def t6():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['WHISPER_MODEL'] = 'whisper-1'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_whisper'
+    run_test("Legacy WHISPER_MODEL still works", t6)
+
+    def t7():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_whisper'
+    run_test("Default falls back to openai_whisper", t7)
+
+
+# =============================================================================
+# TEST SECTION 3: Connector Specifications
+# =============================================================================
+
+def test_connector_specifications():
+    """Test connector specifications are correctly defined."""
+    print("\n=== Testing Connector Specifications ===")
+
+    from src.services.transcription.connectors.openai_whisper import OpenAIWhisperConnector
+    from src.services.transcription.connectors.openai_transcribe import OpenAITranscribeConnector
+    from src.services.transcription.connectors.asr_endpoint import ASREndpointConnector
+    from src.services.transcription.base import TranscriptionCapability
+
+    def t1():
+        specs = OpenAIWhisperConnector.SPECIFICATIONS
+        assert specs.max_file_size_bytes == 25 * 1024 * 1024
+        assert specs.handles_chunking_internally is False
+    run_test("OpenAI Whisper has 25MB limit", t1)
+
+    def t2():
+        specs = OpenAIWhisperConnector.SPECIFICATIONS
+        assert specs.unsupported_codecs is not None
+        assert 'opus' in specs.unsupported_codecs
+    run_test("OpenAI Whisper declares opus as unsupported", t2)
+
+    def t3():
+        specs = OpenAITranscribeConnector.SPECIFICATIONS
+        assert specs.handles_chunking_internally is False  # App must chunk for OpenAI Transcribe
+        assert specs.requires_chunking_param is True  # Must send chunking_strategy param for >30s
+    run_test("OpenAI Transcribe requires app-level chunking with chunking_strategy param", t3)
+
+    def t4():
+        specs = ASREndpointConnector.SPECIFICATIONS
+        assert specs.max_file_size_bytes is None
+        assert specs.handles_chunking_internally is True
+    run_test("ASR Endpoint has no limits (handles internally)", t4)
+
+    def t5():
+        assert TranscriptionCapability.DIARIZATION not in OpenAIWhisperConnector.CAPABILITIES
+    run_test("OpenAI Whisper does NOT support diarization", t5)
+
+    def t6():
+        # Diarization is added dynamically based on model at instance level
+        connector = OpenAITranscribeConnector({'api_key': 'test', 'model': 'gpt-4o-transcribe-diarize'})
+        assert TranscriptionCapability.DIARIZATION in connector.CAPABILITIES
+        assert connector.supports_diarization is True
+    run_test("OpenAI Transcribe with diarize model supports diarization", t6)
+
+    def t7():
+        assert TranscriptionCapability.DIARIZATION in ASREndpointConnector.CAPABILITIES
+        assert TranscriptionCapability.SPEAKER_COUNT_CONTROL in ASREndpointConnector.CAPABILITIES
+    run_test("ASR Endpoint supports diarization and speaker count control", t7)
+
+    def t8():
+        assert TranscriptionCapability.SPEAKER_COUNT_CONTROL not in OpenAIWhisperConnector.CAPABILITIES
+        assert TranscriptionCapability.SPEAKER_COUNT_CONTROL not in OpenAITranscribeConnector.CAPABILITIES
+    run_test("OpenAI connectors do NOT support speaker count control", t8)
+
+
+# =============================================================================
+# TEST SECTION 4: Chunking Logic
+# =============================================================================
+
+def test_chunking_logic():
+    """Test connector-aware chunking logic."""
+    print("\n=== Testing Chunking Logic ===")
+
+    from src.audio_chunking import get_effective_chunking_config
+    from src.services.transcription.base import ConnectorSpecifications
+
+    def t1():
+        clear_env()
+        os.environ['ENABLE_CHUNKING'] = 'true'
+        os.environ['CHUNK_LIMIT'] = '20MB'
+        specs = ConnectorSpecifications(handles_chunking_internally=True)
+        config = get_effective_chunking_config(specs)
+        assert config.enabled is False
+        assert config.source == 'connector_internal'
+    run_test("Connector with internal chunking disables app chunking", t1)
+
+    def t2():
+        clear_env()
+        os.environ['ENABLE_CHUNKING'] = 'true'
+        os.environ['CHUNK_LIMIT'] = '15MB'
+        os.environ['CHUNK_OVERLAP_SECONDS'] = '5'
+        specs = ConnectorSpecifications(handles_chunking_internally=False)
+        config = get_effective_chunking_config(specs)
+        assert config.enabled is True
+        assert config.source == 'env'
+        assert config.mode == 'size'
+        assert config.limit_value == 15.0
+    run_test("Connector without internal chunking uses ENV settings", t2)
+
+    def t3():
+        clear_env()
+        os.environ['ENABLE_CHUNKING'] = 'false'
+        specs = ConnectorSpecifications(handles_chunking_internally=False)
+        config = get_effective_chunking_config(specs)
+        assert config.enabled is False
+        assert config.source == 'disabled'
+    run_test("ENABLE_CHUNKING=false disables chunking", t3)
+
+    def t4():
+        clear_env()
+        os.environ['ENABLE_CHUNKING'] = 'true'
+        os.environ['CHUNK_LIMIT'] = '10m'
+        specs = ConnectorSpecifications(handles_chunking_internally=False)
+        config = get_effective_chunking_config(specs)
+        assert config.enabled is True
+        assert config.mode == 'duration'
+        assert config.limit_value == 600.0
+    run_test("Duration-based chunk limit parsing (10m = 600s)", t4)
+
+
+# =============================================================================
+# TEST SECTION 5: Codec Handling
+# =============================================================================
+
+def test_codec_handling():
+    """Test codec handling with connector specifications."""
+    print("\n=== Testing Codec Handling ===")
+
+    from src.services.transcription.base import ConnectorSpecifications
+
+    def reload_audio_module():
+        """Properly reload audio_conversion module with fresh env vars."""
+        import sys
+        # Remove relevant modules from cache to force fresh import
+        # app_config reads AUDIO_UNSUPPORTED_CODECS at import time
+        for mod_name in list(sys.modules.keys()):
+            if mod_name.startswith('src.utils') or mod_name.startswith('src.config'):
+                del sys.modules[mod_name]
+        from src.utils import audio_conversion
+        return audio_conversion
+
+    def t1():
+        clear_env()
+        mod = reload_audio_module()
+        codecs = mod.get_supported_codecs()
+        assert 'mp3' in codecs
+        assert 'flac' in codecs
+    run_test("Default supported codecs include common formats", t1)
+
+    def t2():
+        clear_env()
+        mod = reload_audio_module()
+        specs = ConnectorSpecifications(unsupported_codecs=frozenset({'opus', 'vorbis'}))
+        codecs = mod.get_supported_codecs(connector_specs=specs)
+        assert 'opus' not in codecs
+        assert 'vorbis' not in codecs
+        assert 'mp3' in codecs
+    run_test("Connector unsupported_codecs removes from defaults", t2)
+
+    def t3():
+        clear_env()
+        os.environ['AUDIO_UNSUPPORTED_CODECS'] = 'aac,opus'
+        mod = reload_audio_module()
+        codecs = mod.get_supported_codecs()
+        assert 'aac' not in codecs, f"aac should not be in {codecs}"
+        assert 'opus' not in codecs, f"opus should not be in {codecs}"
+    run_test("AUDIO_UNSUPPORTED_CODECS env var still works", t3)
+
+    def t4():
+        clear_env()
+        os.environ['AUDIO_UNSUPPORTED_CODECS'] = 'aac'
+        mod = reload_audio_module()
+        specs = ConnectorSpecifications(unsupported_codecs=frozenset({'opus'}))
+        codecs = mod.get_supported_codecs(connector_specs=specs)
+        assert 'aac' not in codecs, f"aac should not be in {codecs}"
+        assert 'opus' not in codecs, f"opus should not be in {codecs}"
+        assert 'mp3' in codecs
+    run_test("Both connector specs and ENV var work together", t4)
+
+
+# =============================================================================
+# TEST SECTION 6: Connector Capabilities
+# =============================================================================
+
+def test_connector_capabilities():
+    """Test connector capabilities are exposed correctly."""
+    print("\n=== Testing Connector Capabilities ===")
+
+    from src.services.transcription.connectors.asr_endpoint import ASREndpointConnector
+    from src.services.transcription.connectors.openai_transcribe import OpenAITranscribeConnector
+    from src.services.transcription.base import TranscriptionCapability
+
+    def t1():
+        connector = ASREndpointConnector({'base_url': 'http://test:9000'})
+        assert connector.supports_diarization is True
+    run_test("ASR connector supports_diarization property", t1)
+
+    def t2():
+        connector = ASREndpointConnector({'base_url': 'http://test:9000'})
+        assert connector.supports_speaker_count_control is True
+    run_test("ASR connector supports_speaker_count_control property", t2)
+
+    def t3():
+        connector = OpenAITranscribeConnector({'api_key': 'test-key', 'model': 'gpt-4o-transcribe-diarize'})
+        assert connector.supports_diarization is True
+        assert connector.supports_speaker_count_control is False
+    run_test("OpenAI Transcribe supports diarization but not speaker_count_control", t3)
+
+    def t4():
+        connector = ASREndpointConnector({'base_url': 'http://test:9000'})
+        assert connector.supports(TranscriptionCapability.DIARIZATION) is True
+        assert connector.supports(TranscriptionCapability.STREAMING) is False
+    run_test("supports() method works correctly", t4)
+
+
+# =============================================================================
+# TEST SECTION 7: Registry Operations
+# =============================================================================
+
+def test_registry_operations():
+    """Test registry listing and connector info."""
+    print("\n=== Testing Registry Operations ===")
+
+    from src.services.transcription.registry import get_registry
+
+    def t1():
+        clear_env()
+        reset_registry()
+        registry = get_registry()
+        connectors = registry.list_connectors()
+        names = [c['name'] for c in connectors]
+        assert 'openai_whisper' in names
+        assert 'openai_transcribe' in names
+        assert 'asr_endpoint' in names
+    run_test("Registry lists all built-in connectors", t1)
+
+    def t2():
+        clear_env()
+        reset_registry()
+        registry = get_registry()
+        connectors = registry.list_connectors()
+        asr = next(c for c in connectors if c['name'] == 'asr_endpoint')
+        assert 'DIARIZATION' in asr['capabilities']
+        assert 'SPEAKER_COUNT_CONTROL' in asr['capabilities']
+    run_test("Connector info includes capabilities", t2)
+
+    def t3():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['TRANSCRIPTION_MODEL'] = 'whisper-1'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'openai_whisper'
+
+        os.environ['TRANSCRIPTION_MODEL'] = 'gpt-4o-transcribe-diarize'
+        registry.reinitialize()
+        assert registry.get_active_connector_name() == 'openai_transcribe'
+    run_test("reinitialize() resets the active connector", t3)
+
+
+# =============================================================================
+# TEST SECTION 8: Edge Cases
+# =============================================================================
+
+def test_edge_cases():
+    """Test edge cases and error handling."""
+    print("\n=== Testing Edge Cases ===")
+
+    from src.services.transcription.registry import get_registry
+    from src.services.transcription.exceptions import ConfigurationError
+    from src.services.transcription.base import TranscriptionResponse, TranscriptionSegment
+
+    def t1():
+        # Empty segments list returns the text (empty string), not "[]"
+        response = TranscriptionResponse(text="", segments=[], provider="test")
+        assert response.to_storage_format() == ""
+        assert response.has_diarization() is False
+    run_test("Empty transcription response handling", t1)
+
+    def t2():
+        segments = [TranscriptionSegment(text="Hello", speaker=None)]
+        response = TranscriptionResponse(text="Hello", segments=segments)
+        storage = response.to_storage_format()
+        data = json.loads(storage)
+        assert data[0]['speaker'] == 'Unknown Speaker'
+    run_test("Transcription with unknown speaker handling", t2)
+
+    def t3():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_CONNECTOR'] = 'nonexistent_connector'
+        registry = get_registry()
+        try:
+            registry.initialize_from_env()
+            assert False, "Should have raised ConfigurationError"
+        except ConfigurationError as e:
+            assert 'Unknown connector' in str(e)
+    run_test("Invalid connector name raises ConfigurationError", t3)
+
+    def t4():
+        from src.services.transcription.connectors.asr_endpoint import ASREndpointConnector
+        try:
+            ASREndpointConnector({})
+            assert False, "Should have raised ConfigurationError"
+        except ConfigurationError as e:
+            assert 'base_url' in str(e)
+    run_test("ASR connector validates base_url is required", t4)
+
+    def t5():
+        clear_env()
+        reset_registry()
+        os.environ['ASR_BASE_URL'] = 'http://whisperx:9000  # This is a comment'
+        registry = get_registry()
+        connector = registry.initialize_from_env()
+        assert connector.base_url == 'http://whisperx:9000'
+    run_test("ASR_BASE_URL with trailing comment is handled", t5)
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def main():
+    """Run all tests."""
+    global PASSED, FAILED, ERRORS
+
+    print("=" * 60)
+    print("Transcription Connector Architecture Tests")
+    print("=" * 60)
+
+    test_base_classes()
+    test_auto_detection()
+    test_connector_specifications()
+    test_chunking_logic()
+    test_codec_handling()
+    test_connector_capabilities()
+    test_registry_operations()
+    test_edge_cases()
+
+    print("\n" + "=" * 60)
+    print(f"RESULTS: {PASSED} passed, {FAILED} failed")
+    print("=" * 60)
+
+    if ERRORS:
+        print("\nFailed tests:")
+        for name, error in ERRORS:
+            print(f"  - {name}: {error}")
+
+    clear_env()
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
diff --git a/tests/test_embedding_api_mode.py b/tests/test_embedding_api_mode.py
new file mode 100644
index 00000000..97fcd929
--- /dev/null
+++ b/tests/test_embedding_api_mode.py
@@ -0,0 +1,179 @@
+#!/usr/bin/env python3
+"""
+Unit tests for issue #262 follow-up: API-mode embeddings.
+
+Verifies that:
+- USE_API_EMBEDDINGS reflects the EMBEDDING_BASE_URL env var.
+- EMBEDDING_IDENTIFIER composes the provider + model name.
+- generate_embeddings() routes through the API client when API mode is on.
+- The local SentenceTransformer path is not initialised in API mode.
+
+The OpenAI client is patched out; the test does not make real network calls.
+
+Run with: docker exec speakr-dev python /app/tests/test_embedding_api_mode.py
+"""
+
+import importlib
+import os
+import sys
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+def reload_with_env(**env):
+    """Reload the embeddings module with the requested env overrides."""
+    keys = list(env.keys()) + [
+        "EMBEDDING_MODEL", "EMBEDDING_BASE_URL", "EMBEDDING_API_KEY", "EMBEDDING_DIMENSIONS",
+    ]
+    saved = {k: os.environ.get(k) for k in keys}
+    try:
+        for k in keys:
+            os.environ.pop(k, None)
+        for k, v in env.items():
+            if v is not None:
+                os.environ[k] = v
+        import src.services.embeddings as emb
+        importlib.reload(emb)
+        return emb
+    finally:
+        # Restore env so later tests see a clean slate, then reload again.
+        for k in keys:
+            os.environ.pop(k, None)
+            if saved[k] is not None:
+                os.environ[k] = saved[k]
+
+
+def test_default_is_local_mode():
+    emb = reload_with_env()
+    assert emb.USE_API_EMBEDDINGS is False, f"got USE_API_EMBEDDINGS={emb.USE_API_EMBEDDINGS}"
+    assert emb.EMBEDDING_MODEL == "all-MiniLM-L6-v2"
+    assert emb.EMBEDDING_IDENTIFIER == "local::all-MiniLM-L6-v2", emb.EMBEDDING_IDENTIFIER
+
+
+def test_base_url_switches_to_api_mode():
+    emb = reload_with_env(
+        EMBEDDING_BASE_URL="https://api.openai.com/v1",
+        EMBEDDING_API_KEY="sk-test",
+        EMBEDDING_MODEL="text-embedding-3-small",
+    )
+    assert emb.USE_API_EMBEDDINGS is True
+    assert emb.EMBEDDING_BASE_URL == "https://api.openai.com/v1"
+    assert emb.EMBEDDING_MODEL == "text-embedding-3-small"
+    assert emb.EMBEDDING_IDENTIFIER == "https://api.openai.com/v1::text-embedding-3-small"
+
+
+def test_dimensions_parsed():
+    emb = reload_with_env(
+        EMBEDDING_BASE_URL="https://api.openai.com/v1",
+        EMBEDDING_MODEL="text-embedding-3-large",
+        EMBEDDING_DIMENSIONS="1024",
+    )
+    assert emb.EMBEDDING_DIMENSIONS == 1024
+
+
+def test_dimensions_invalid_falls_back_to_none():
+    emb = reload_with_env(
+        EMBEDDING_BASE_URL="https://api.openai.com/v1",
+        EMBEDDING_DIMENSIONS="not-a-number",
+    )
+    assert emb.EMBEDDING_DIMENSIONS is None
+
+
+def test_generate_embeddings_uses_api_when_active():
+    emb = reload_with_env(
+        EMBEDDING_BASE_URL="http://localhost:9999/v1",
+        EMBEDDING_API_KEY="not-needed",
+        EMBEDDING_MODEL="bge-base",
+    )
+    fake_response = MagicMock()
+    fake_response.data = [
+        MagicMock(embedding=[0.1, 0.2, 0.3]),
+        MagicMock(embedding=[0.4, 0.5, 0.6]),
+    ]
+    fake_client = MagicMock()
+    fake_client.embeddings.create.return_value = fake_response
+
+    from flask import Flask
+    test_app = Flask(__name__)
+    with test_app.app_context():
+        with patch.object(emb, "get_embedding_api_client", return_value=fake_client):
+            vectors = emb.generate_embeddings(["hello", "world"])
+
+    assert len(vectors) == 2, f"expected 2 vectors, got {len(vectors)}"
+    assert all(v.dtype.name == "float32" for v in vectors)
+    fake_client.embeddings.create.assert_called_once()
+    call_kwargs = fake_client.embeddings.create.call_args.kwargs
+    assert call_kwargs["model"] == "bge-base"
+    assert call_kwargs["input"] == ["hello", "world"]
+    # No explicit dimensions, so kwarg should be absent.
+    assert "dimensions" not in call_kwargs
+
+
+def test_generate_embeddings_passes_dimensions_when_set():
+    emb = reload_with_env(
+        EMBEDDING_BASE_URL="http://localhost:9999/v1",
+        EMBEDDING_MODEL="text-embedding-3-large",
+        EMBEDDING_DIMENSIONS="512",
+    )
+    fake_response = MagicMock()
+    fake_response.data = [MagicMock(embedding=[0.0] * 512)]
+    fake_client = MagicMock()
+    fake_client.embeddings.create.return_value = fake_response
+
+    from flask import Flask
+    test_app = Flask(__name__)
+    with test_app.app_context():
+        with patch.object(emb, "get_embedding_api_client", return_value=fake_client):
+            emb.generate_embeddings(["hello"])
+
+    call_kwargs = fake_client.embeddings.create.call_args.kwargs
+    assert call_kwargs["dimensions"] == 512
+
+
+def test_get_embedding_model_returns_none_in_api_mode():
+    emb = reload_with_env(EMBEDDING_BASE_URL="http://localhost:9999/v1")
+    from flask import Flask
+    test_app = Flask(__name__)
+    with test_app.app_context():
+        assert emb.get_embedding_model() is None
+
+
+def main():
+    print("=== Issue #262 follow-up: API-mode embeddings ===\n")
+    run("default config is local mode", test_default_is_local_mode)
+    run("EMBEDDING_BASE_URL switches to API mode", test_base_url_switches_to_api_mode)
+    run("EMBEDDING_DIMENSIONS parses to int", test_dimensions_parsed)
+    run("invalid EMBEDDING_DIMENSIONS falls back to None", test_dimensions_invalid_falls_back_to_none)
+    run("generate_embeddings uses API client when active", test_generate_embeddings_uses_api_when_active)
+    run("generate_embeddings forwards dimensions when set", test_generate_embeddings_passes_dimensions_when_set)
+    run("get_embedding_model returns None in API mode", test_get_embedding_model_returns_none_in_api_mode)
+
+    # Reset the module to its default state for any subsequent test runs.
+    reload_with_env()
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_embedding_identifier_compat.py b/tests/test_embedding_identifier_compat.py
new file mode 100644
index 00000000..b3acb126
--- /dev/null
+++ b/tests/test_embedding_identifier_compat.py
@@ -0,0 +1,203 @@
+#!/usr/bin/env python3
+"""
+Regression test for the v0.8.16-alpha embedding-identifier migration.
+
+Pre-v0.8.16 instances stored only the model name under the legacy
+`embedding_model_name` SystemSetting key. The new format is
+`{provider}::{model}` under `embedding_identifier`. The compatibility check
+in src/init_db.py wraps any legacy value as `local::<value>` before comparing,
+so a default upgrade does not produce a false-positive "embeddings changed"
+warning.
+
+This test reproduces three upgrade scenarios:
+
+  1. Fresh install (no legacy, no new key)        -> first-run record only.
+  2. v0.8.15 upgrade with same default config      -> silent migration, no warn.
+  3. v0.8.15 upgrade after legitimate config change -> warning fires.
+
+Run with: docker exec speakr-dev python /app/tests/test_embedding_identifier_compat.py
+"""
+
+import importlib
+import os
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ok {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  FAIL {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  FAIL {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+def reset_settings(stored_identifier=None, legacy_model_name=None):
+    from src.app import app, db
+    from src.models import SystemSetting
+    with app.app_context():
+        for k in ('embedding_identifier', 'embedding_model_name'):
+            row = SystemSetting.query.filter_by(key=k).first()
+            if row:
+                db.session.delete(row)
+        db.session.commit()
+        if stored_identifier:
+            SystemSetting.set_setting(key='embedding_identifier', value=stored_identifier, setting_type='string')
+        if legacy_model_name:
+            SystemSetting.set_setting(key='embedding_model_name', value=legacy_model_name, setting_type='string')
+
+
+def reload_embeddings_with(**env):
+    saved = {k: os.environ.get(k) for k in ('EMBEDDING_BASE_URL', 'EMBEDDING_API_KEY', 'EMBEDDING_MODEL', 'EMBEDDING_DIMENSIONS')}
+    for k in saved:
+        os.environ.pop(k, None)
+    for k, v in env.items():
+        if v is not None:
+            os.environ[k] = v
+    import src.services.embeddings as emb
+    importlib.reload(emb)
+    return emb, saved
+
+
+def restore_env(saved):
+    for k, v in saved.items():
+        os.environ.pop(k, None)
+        if v is not None:
+            os.environ[k] = v
+    import src.services.embeddings as emb
+    importlib.reload(emb)
+
+
+def run_compat_check():
+    """Replays the inline migration block from src/init_db.py."""
+    from src.app import app
+    from src.models import SystemSetting, TranscriptChunk
+    from src.services.embeddings import EMBEDDING_IDENTIFIER
+
+    with app.app_context():
+        current = EMBEDDING_IDENTIFIER
+        stored = SystemSetting.get_setting('embedding_identifier', None)
+        legacy = SystemSetting.get_setting('embedding_model_name', None)
+        migrated_from_legacy = False
+        if stored is None and legacy:
+            stored = f"local::{legacy}"
+            migrated_from_legacy = True
+
+        if stored is None:
+            outcome = 'first-run'
+        elif stored == current:
+            outcome = 'silent-migration' if migrated_from_legacy else 'no-change'
+        else:
+            outcome = 'warn-mismatch'
+
+        return {
+            'stored': stored,
+            'current': current,
+            'migrated_from_legacy': migrated_from_legacy,
+            'outcome': outcome,
+        }
+
+
+def test_fresh_install_first_run():
+    _, saved = reload_embeddings_with(EMBEDDING_MODEL='all-MiniLM-L6-v2')
+    try:
+        reset_settings()
+        result = run_compat_check()
+        assert result['outcome'] == 'first-run', f"expected first-run, got {result}"
+    finally:
+        restore_env(saved)
+
+
+def test_legacy_default_silent_upgrade():
+    _, saved = reload_embeddings_with(EMBEDDING_MODEL='all-MiniLM-L6-v2')
+    try:
+        reset_settings(legacy_model_name='all-MiniLM-L6-v2')
+        result = run_compat_check()
+        assert result['outcome'] == 'silent-migration', f"expected silent-migration, got {result}"
+        assert result['stored'] == 'local::all-MiniLM-L6-v2'
+        assert result['current'] == 'local::all-MiniLM-L6-v2'
+    finally:
+        restore_env(saved)
+
+
+def test_legacy_then_real_change_warns():
+    _, saved = reload_embeddings_with(EMBEDDING_MODEL='all-mpnet-base-v2')
+    try:
+        reset_settings(legacy_model_name='all-MiniLM-L6-v2')
+        result = run_compat_check()
+        assert result['outcome'] == 'warn-mismatch', f"expected warn-mismatch, got {result}"
+        assert result['stored'] == 'local::all-MiniLM-L6-v2'
+        assert result['current'] == 'local::all-mpnet-base-v2'
+    finally:
+        restore_env(saved)
+
+
+def test_legacy_then_switch_to_api_warns():
+    _, saved = reload_embeddings_with(
+        EMBEDDING_BASE_URL='https://api.openai.com/v1',
+        EMBEDDING_MODEL='text-embedding-3-small',
+    )
+    try:
+        reset_settings(legacy_model_name='all-MiniLM-L6-v2')
+        result = run_compat_check()
+        assert result['outcome'] == 'warn-mismatch', f"expected warn-mismatch, got {result}"
+        assert result['stored'] == 'local::all-MiniLM-L6-v2'
+        assert result['current'] == 'https://api.openai.com/v1::text-embedding-3-small'
+    finally:
+        restore_env(saved)
+
+
+def test_already_migrated_no_change():
+    _, saved = reload_embeddings_with(EMBEDDING_MODEL='all-MiniLM-L6-v2')
+    try:
+        reset_settings(stored_identifier='local::all-MiniLM-L6-v2')
+        result = run_compat_check()
+        assert result['outcome'] == 'no-change', f"expected no-change, got {result}"
+    finally:
+        restore_env(saved)
+
+
+def restore_dev_state():
+    from src.app import app, db
+    from src.models import SystemSetting
+    with app.app_context():
+        legacy = SystemSetting.query.filter_by(key='embedding_model_name').first()
+        if legacy:
+            db.session.delete(legacy)
+        from src.services.embeddings import EMBEDDING_IDENTIFIER
+        SystemSetting.set_setting(
+            key='embedding_identifier',
+            value=EMBEDDING_IDENTIFIER,
+            description='Identifier of the embedding provider and model that produced the stored chunk vectors. Used to detect dimensionality and semantic-space mismatches at startup.',
+            setting_type='string',
+        )
+
+
+def main():
+    print("=== embedding identifier upgrade compatibility ===\n")
+    run("fresh install records identifier on first run", test_fresh_install_first_run)
+    run("default upgrade migrates legacy key silently (no warning)", test_legacy_default_silent_upgrade)
+    run("real model change after upgrade still warns", test_legacy_then_real_change_warns)
+    run("switch from local to API after upgrade warns", test_legacy_then_switch_to_api_warns)
+    run("already-migrated identifier reports no-change", test_already_migrated_no_change)
+
+    restore_dev_state()
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_ffprobe_codec_detection.py b/tests/test_ffprobe_codec_detection.py
new file mode 100644
index 00000000..be7f70b0
--- /dev/null
+++ b/tests/test_ffprobe_codec_detection.py
@@ -0,0 +1,319 @@
+#!/usr/bin/env python3
+"""
+Test script for ffprobe codec detection functionality.
+
+This script tests the new codec-based detection system to ensure it correctly
+identifies audio codecs, video files, and lossless formats.
+"""
+
+import os
+import sys
+import tempfile
+import subprocess
+from pathlib import Path
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from src.utils.ffprobe import (
+    get_codec_info,
+    is_video_file,
+    is_audio_file,
+    get_audio_codec,
+    needs_audio_conversion,
+    is_lossless_audio,
+    get_duration,
+    FFProbeError
+)
+
+
+def create_test_audio_file(codec, output_path, duration=1.0):
+    """Create a test audio file with specific codec."""
+    codec_map = {
+        'mp3': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'libmp3lame', '-b:a', '128k', output_path],
+        'aac': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'aac', '-b:a', '128k', output_path],
+        'opus': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'libopus', '-b:a', '64k', output_path],
+        'flac': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'flac', output_path],
+        'pcm_s16le': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'pcm_s16le', '-ar', '44100', output_path],
+        'vorbis': ['ffmpeg', '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}', '-acodec', 'libvorbis', '-b:a', '128k', output_path],
+    }
+    
+    if codec not in codec_map:
+        raise ValueError(f"Unknown codec: {codec}")
+    
+    subprocess.run(codec_map[codec], check=True, capture_output=True)
+
+
+def create_test_video_file(output_path, duration=1.0):
+    """Create a test video file with audio."""
+    subprocess.run([
+        'ffmpeg', '-f', 'lavfi', '-i', f'testsrc=duration={duration}:size=320x240:rate=1',
+        '-f', 'lavfi', '-i', f'sine=frequency=440:duration={duration}',
+        '-acodec', 'aac', '-vcodec', 'libx264', '-pix_fmt', 'yuv420p',
+        output_path
+    ], check=True, capture_output=True)
+
+
+def test_codec_detection():
+    """Test basic codec detection."""
+    print("\n=== Testing Codec Detection ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_files = {
+            'mp3': 'test.mp3',
+            'aac': 'test.m4a',
+            'opus': 'test.opus',
+            'flac': 'test.flac',
+            'pcm_s16le': 'test.wav',
+            'vorbis': 'test.ogg',
+        }
+        
+        for codec, filename in test_files.items():
+            filepath = os.path.join(tmpdir, filename)
+            try:
+                print(f"Creating test file: {filename} with codec {codec}...")
+                create_test_audio_file(codec, filepath)
+                
+                print(f"  Probing {filename}...")
+                codec_info = get_codec_info(filepath)
+                
+                detected_codec = codec_info['audio_codec']
+                print(f"  ✓ Detected codec: {detected_codec}")
+                print(f"    Has audio: {codec_info['has_audio']}")
+                print(f"    Has video: {codec_info['has_video']}")
+                print(f"    Format: {codec_info['format_name']}")
+                print(f"    Duration: {codec_info['duration']:.2f}s" if codec_info['duration'] else "    Duration: N/A")
+                
+                if detected_codec != codec:
+                    print(f"  ⚠️  Warning: Expected {codec}, got {detected_codec}")
+                
+                print()
+                
+            except Exception as e:
+                print(f"  ✗ Failed to test {codec}: {e}\n")
+
+
+def test_video_detection():
+    """Test video file detection."""
+    print("\n=== Testing Video Detection ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        video_path = os.path.join(tmpdir, 'test_video.mp4')
+        audio_path = os.path.join(tmpdir, 'test_audio.mp3')
+        
+        try:
+            print("Creating test video file...")
+            create_test_video_file(video_path)
+            
+            print("Creating test audio file...")
+            create_test_audio_file('mp3', audio_path)
+            
+            print(f"\nProbing video file...")
+            codec_info = get_codec_info(video_path)
+            print(f"  Audio codec: {codec_info['audio_codec']}")
+            print(f"  Video codec: {codec_info['video_codec']}")
+            print(f"  Has audio: {codec_info['has_audio']}")
+            print(f"  Has video: {codec_info['has_video']}")
+            
+            is_video = is_video_file(video_path)
+            print(f"  is_video_file(): {is_video}")
+            
+            if not is_video:
+                print("  ✗ Video file not detected as video!")
+            else:
+                print("  ✓ Video file correctly detected")
+            
+            print(f"\nProbing audio file...")
+            codec_info = get_codec_info(audio_path)
+            print(f"  Audio codec: {codec_info['audio_codec']}")
+            print(f"  Video codec: {codec_info['video_codec']}")
+            print(f"  Has audio: {codec_info['has_audio']}")
+            print(f"  Has video: {codec_info['has_video']}")
+            
+            is_video = is_video_file(audio_path)
+            print(f"  is_video_file(): {is_video}")
+            
+            if is_video:
+                print("  ✗ Audio file incorrectly detected as video!")
+            else:
+                print("  ✓ Audio file correctly identified as audio-only")
+            
+            print()
+            
+        except Exception as e:
+            print(f"✗ Failed to test video detection: {e}\n")
+
+
+def test_lossless_detection():
+    """Test lossless audio detection."""
+    print("\n=== Testing Lossless Detection ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_cases = {
+            'pcm_s16le': ('test.wav', True),
+            'flac': ('test.flac', True),
+            'mp3': ('test.mp3', False),
+            'aac': ('test.m4a', False),
+            'opus': ('test.opus', False),
+        }
+        
+        for codec, (filename, expected_lossless) in test_cases.items():
+            filepath = os.path.join(tmpdir, filename)
+            try:
+                print(f"Creating {filename} with codec {codec}...")
+                create_test_audio_file(codec, filepath)
+                
+                is_lossless = is_lossless_audio(filepath)
+                status = "✓" if is_lossless == expected_lossless else "✗"
+                
+                print(f"  {status} {codec}: is_lossless={is_lossless} (expected {expected_lossless})")
+                
+            except Exception as e:
+                print(f"  ✗ Failed to test {codec}: {e}")
+        
+        print()
+
+
+def test_conversion_check():
+    """Test conversion requirement detection."""
+    print("\n=== Testing Conversion Check ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        # Supported codecs for direct transcription
+        supported_codecs = ['pcm_s16le', 'mp3', 'flac', 'opus', 'aac']
+        
+        test_cases = {
+            'mp3': ('test.mp3', False),  # Supported, no conversion needed
+            'aac': ('test.m4a', False),  # Supported, no conversion needed
+            'opus': ('test.opus', False),  # Supported, no conversion needed
+            'vorbis': ('test.ogg', True),  # Not in supported list, needs conversion
+        }
+        
+        for codec, (filename, should_convert) in test_cases.items():
+            filepath = os.path.join(tmpdir, filename)
+            try:
+                print(f"Creating {filename} with codec {codec}...")
+                create_test_audio_file(codec, filepath)
+                
+                needs_conversion, detected_codec = needs_audio_conversion(filepath, supported_codecs)
+                status = "✓" if needs_conversion == should_convert else "✗"
+                
+                print(f"  {status} {codec}: needs_conversion={needs_conversion} (expected {should_convert})")
+                print(f"     Detected codec: {detected_codec}")
+                
+            except Exception as e:
+                print(f"  ✗ Failed to test {codec}: {e}")
+        
+        print()
+
+
+def test_misnamed_file():
+    """Test detection of files with wrong extensions."""
+    print("\n=== Testing Misnamed File Detection ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        # Create an MP3 file but name it .wav
+        wrong_name_path = os.path.join(tmpdir, 'actually_mp3.wav')
+        
+        try:
+            print("Creating MP3 file with .wav extension...")
+            create_test_audio_file('mp3', wrong_name_path)
+            
+            codec_info = get_codec_info(wrong_name_path)
+            detected_codec = codec_info['audio_codec']
+            
+            print(f"  Filename: actually_mp3.wav")
+            print(f"  Detected codec: {detected_codec}")
+            
+            if detected_codec == 'mp3':
+                print("  ✓ Correctly detected MP3 codec despite .wav extension")
+            else:
+                print(f"  ✗ Incorrectly detected as {detected_codec}")
+            
+            # Create a FLAC file but name it .mp3
+            wrong_name_path2 = os.path.join(tmpdir, 'actually_flac.mp3')
+            print("\nCreating FLAC file with .mp3 extension...")
+            create_test_audio_file('flac', wrong_name_path2)
+            
+            codec_info = get_codec_info(wrong_name_path2)
+            detected_codec = codec_info['audio_codec']
+            
+            print(f"  Filename: actually_flac.mp3")
+            print(f"  Detected codec: {detected_codec}")
+            
+            if detected_codec == 'flac':
+                print("  ✓ Correctly detected FLAC codec despite .mp3 extension")
+            else:
+                print(f"  ✗ Incorrectly detected as {detected_codec}")
+            
+            print()
+            
+        except Exception as e:
+            print(f"✗ Failed to test misnamed files: {e}\n")
+
+
+def test_duration():
+    """Test duration extraction."""
+    print("\n=== Testing Duration Extraction ===\n")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        durations = [1.0, 2.5, 5.0]
+        
+        for expected_duration in durations:
+            filepath = os.path.join(tmpdir, f'test_{expected_duration}s.mp3')
+            try:
+                print(f"Creating {expected_duration}s audio file...")
+                create_test_audio_file('mp3', filepath, duration=expected_duration)
+                
+                detected_duration = get_duration(filepath)
+                
+                # Allow 0.1s tolerance for encoding variations
+                if detected_duration and abs(detected_duration - expected_duration) < 0.1:
+                    print(f"  ✓ Duration: {detected_duration:.2f}s (expected {expected_duration}s)")
+                else:
+                    print(f"  ✗ Duration: {detected_duration:.2f}s (expected {expected_duration}s)")
+                
+            except Exception as e:
+                print(f"  ✗ Failed to test duration: {e}")
+        
+        print()
+
+
+def main():
+    """Run all tests."""
+    print("=" * 60)
+    print("FFProbe Codec Detection Test Suite")
+    print("=" * 60)
+    
+    # Check if ffmpeg/ffprobe are available
+    try:
+        subprocess.run(['ffprobe', '-version'], capture_output=True, check=True)
+        subprocess.run(['ffmpeg', '-version'], capture_output=True, check=True)
+    except (FileNotFoundError, subprocess.CalledProcessError):
+        print("\n✗ Error: ffmpeg/ffprobe not found. Please install ffmpeg to run tests.\n")
+        return 1
+    
+    try:
+        test_codec_detection()
+        test_video_detection()
+        test_lossless_detection()
+        test_conversion_check()
+        test_misnamed_file()
+        test_duration()
+        
+        print("=" * 60)
+        print("All tests completed!")
+        print("=" * 60)
+        print()
+        
+        return 0
+        
+    except Exception as e:
+        print(f"\n✗ Test suite failed with error: {e}\n")
+        import traceback
+        traceback.print_exc()
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
\ No newline at end of file
diff --git a/tests/test_hotwords.sh b/tests/test_hotwords.sh
new file mode 100755
index 00000000..88cb69b6
--- /dev/null
+++ b/tests/test_hotwords.sh
@@ -0,0 +1,241 @@
+#!/bin/bash
+# test_hotwords.sh - Test hotwords and initial_prompt features
+#
+# Usage:
+#   ./tests/test_hotwords.sh <asr_url> <audio_file>
+#   ./tests/test_hotwords.sh http://localhost:9000 temp/Recording\ 4.flac
+#
+# The audio should contain domain-specific words that Whisper tends to
+# misspell (brand names, acronyms, unusual proper nouns). The script runs
+# three transcriptions and compares the results.
+
+set -euo pipefail
+
+ASR_URL="${1:-http://localhost:9000}"
+AUDIO_FILE="${2:-temp/Recording 4.flac}"
+OUTPUT_DIR="temp/hotwords_test_results"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# Configurable test values - adjust these for your audio
+HOTWORDS="Speakr,CTranslate2,PyAnnote,WhisperX"
+INITIAL_PROMPT="This is a meeting about AI-powered audio transcription tools including Speakr, CTranslate2, and PyAnnote."
+
+echo -e "${CYAN}============================================${NC}"
+echo -e "${CYAN}  Hotwords & Initial Prompt Test Suite${NC}"
+echo -e "${CYAN}============================================${NC}"
+echo ""
+echo -e "ASR URL:       ${YELLOW}${ASR_URL}${NC}"
+echo -e "Audio file:    ${YELLOW}${AUDIO_FILE}${NC}"
+echo -e "Hotwords:      ${YELLOW}${HOTWORDS}${NC}"
+echo -e "Initial prompt: ${YELLOW}${INITIAL_PROMPT}${NC}"
+echo ""
+
+# Verify audio file exists
+if [ ! -f "$AUDIO_FILE" ]; then
+    echo -e "${RED}ERROR: Audio file not found: ${AUDIO_FILE}${NC}"
+    exit 1
+fi
+
+# Verify ASR endpoint is reachable
+echo -n "Checking ASR endpoint... "
+if curl -sf "${ASR_URL}/" > /dev/null 2>&1 || curl -sf "${ASR_URL}/health" > /dev/null 2>&1; then
+    echo -e "${GREEN}OK${NC}"
+else
+    echo -e "${RED}FAILED${NC}"
+    echo "Cannot reach ASR endpoint at ${ASR_URL}"
+    exit 1
+fi
+
+# Create output directory
+mkdir -p "$OUTPUT_DIR"
+
+# ==============================================================
+# Test 1: Baseline (no hints)
+# ==============================================================
+echo ""
+echo -e "${CYAN}--- Test 1: Baseline (no hotwords, no initial_prompt) ---${NC}"
+echo -n "Transcribing... "
+
+BASELINE_FILE="$OUTPUT_DIR/1_baseline.json"
+curl -sS -X POST "${ASR_URL}/asr?output=json&task=transcribe" \
+    -F "audio_file=@${AUDIO_FILE}" \
+    -o "$BASELINE_FILE"
+
+BASELINE_TEXT=$(python3 -c "
+import json
+d=json.load(open('$BASELINE_FILE'))
+t=d.get('text','')
+if isinstance(t, list):
+    t=' '.join(seg.get('text','') for seg in t)
+print(t[:500])
+" 2>/dev/null || echo "PARSE_ERROR")
+echo -e "${GREEN}Done${NC}"
+echo -e "Preview: ${BASELINE_TEXT:0:200}..."
+echo ""
+
+# ==============================================================
+# Test 2: With hotwords only
+# ==============================================================
+echo -e "${CYAN}--- Test 2: With hotwords ---${NC}"
+echo -n "Transcribing... "
+
+HOTWORDS_FILE="$OUTPUT_DIR/2_with_hotwords.json"
+curl -sS -X POST "${ASR_URL}/asr?output=json&task=transcribe&hotwords=${HOTWORDS}" \
+    -F "audio_file=@${AUDIO_FILE}" \
+    -o "$HOTWORDS_FILE"
+
+HOTWORDS_TEXT=$(python3 -c "
+import json
+d=json.load(open('$HOTWORDS_FILE'))
+t=d.get('text','')
+if isinstance(t, list):
+    t=' '.join(seg.get('text','') for seg in t)
+print(t[:500])
+" 2>/dev/null || echo "PARSE_ERROR")
+echo -e "${GREEN}Done${NC}"
+echo -e "Preview: ${HOTWORDS_TEXT:0:200}..."
+echo ""
+
+# ==============================================================
+# Test 3: With hotwords + initial_prompt
+# ==============================================================
+echo -e "${CYAN}--- Test 3: With hotwords + initial_prompt ---${NC}"
+echo -n "Transcribing... "
+
+BOTH_FILE="$OUTPUT_DIR/3_with_both.json"
+ENCODED_PROMPT=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$INITIAL_PROMPT'))")
+curl -sS -X POST "${ASR_URL}/asr?output=json&task=transcribe&hotwords=${HOTWORDS}&initial_prompt=${ENCODED_PROMPT}" \
+    -F "audio_file=@${AUDIO_FILE}" \
+    -o "$BOTH_FILE"
+
+BOTH_TEXT=$(python3 -c "
+import json
+d=json.load(open('$BOTH_FILE'))
+t=d.get('text','')
+if isinstance(t, list):
+    t=' '.join(seg.get('text','') for seg in t)
+print(t[:500])
+" 2>/dev/null || echo "PARSE_ERROR")
+echo -e "${GREEN}Done${NC}"
+echo -e "Preview: ${BOTH_TEXT:0:200}..."
+echo ""
+
+# ==============================================================
+# Test 4: With initial_prompt only
+# ==============================================================
+echo -e "${CYAN}--- Test 4: With initial_prompt only ---${NC}"
+echo -n "Transcribing... "
+
+PROMPT_FILE="$OUTPUT_DIR/4_with_initial_prompt.json"
+curl -sS -X POST "${ASR_URL}/asr?output=json&task=transcribe&initial_prompt=${ENCODED_PROMPT}" \
+    -F "audio_file=@${AUDIO_FILE}" \
+    -o "$PROMPT_FILE"
+
+PROMPT_TEXT=$(python3 -c "
+import json
+d=json.load(open('$PROMPT_FILE'))
+t=d.get('text','')
+if isinstance(t, list):
+    t=' '.join(seg.get('text','') for seg in t)
+print(t[:500])
+" 2>/dev/null || echo "PARSE_ERROR")
+echo -e "${GREEN}Done${NC}"
+echo -e "Preview: ${PROMPT_TEXT:0:200}..."
+echo ""
+
+# ==============================================================
+# Comparison
+# ==============================================================
+echo -e "${CYAN}============================================${NC}"
+echo -e "${CYAN}  Comparison Results${NC}"
+echo -e "${CYAN}============================================${NC}"
+echo ""
+
+# Check if hotwords appear in outputs
+python3 << 'PYEOF'
+import json
+import os
+
+def extract_text(data):
+    """Extract full text from ASR response, handling both string and segment list formats."""
+    text = data.get("text", "")
+    if isinstance(text, list):
+        return " ".join(seg.get("text", "") for seg in text)
+    return text
+
+hotwords = ["Speakr", "CTranslate2", "PyAnnote", "WhisperX"]
+output_dir = os.environ.get("OUTPUT_DIR", "temp/hotwords_test_results")
+test_files = {
+    "1. Baseline":            f"{output_dir}/1_baseline.json",
+    "2. Hotwords only":       f"{output_dir}/2_with_hotwords.json",
+    "3. Hotwords + prompt":   f"{output_dir}/3_with_both.json",
+    "4. Initial prompt only": f"{output_dir}/4_with_initial_prompt.json",
+}
+
+print(f"{'Test':<25} | {'Hotword Matches':<20} | {'Words Found'}")
+print("-" * 75)
+
+for label, filepath in test_files.items():
+    try:
+        with open(filepath) as f:
+            data = json.load(f)
+        text = extract_text(data)
+        found = []
+        for hw in hotwords:
+            if hw.lower() in text.lower():
+                found.append(hw)
+        match_str = f"{len(found)}/{len(hotwords)}"
+        found_str = ", ".join(found) if found else "(none)"
+        print(f"{label:<25} | {match_str:<20} | {found_str}")
+    except Exception as e:
+        print(f"{label:<25} | ERROR: {e}")
+
+print()
+print("Full outputs saved to: " + output_dir)
+PYEOF
+
+echo ""
+echo -e "${CYAN}============================================${NC}"
+echo -e "${CYAN}  Precedence Test via Speakr API${NC}"
+echo -e "${CYAN}============================================${NC}"
+echo ""
+echo -e "${YELLOW}To test the full precedence chain (user → folder → tag → upload form),${NC}"
+echo -e "${YELLOW}use the Speakr web API with authentication:${NC}"
+echo ""
+echo -e "1. Set user-level defaults in Account Settings → Prompt Options"
+echo -e "2. Create a tag with different hotwords/initial_prompt"
+echo -e "3. Create a folder with different hotwords/initial_prompt"
+echo -e "4. Upload via API and check server logs for resolved values:"
+echo ""
+cat << 'EXAMPLE'
+# Upload with user defaults only (no tag, no folder)
+curl -X POST "https://your-speakr/upload" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -F "file=@test.flac"
+# → Should use user defaults
+
+# Upload with a tag that has hotwords set
+curl -X POST "https://your-speakr/upload" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -F "file=@test.flac" \
+  -F "tags=TAG_ID_WITH_HOTWORDS"
+# → Should use tag defaults (overrides user)
+
+# Upload with explicit form values (highest priority)
+curl -X POST "https://your-speakr/upload" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -F "file=@test.flac" \
+  -F "tags=TAG_ID_WITH_HOTWORDS" \
+  -F "hotwords=FormOverride1,FormOverride2" \
+  -F "initial_prompt=Form level prompt"
+# → Should use form values (overrides tag and user)
+EXAMPLE
+
+echo ""
+echo -e "${GREEN}Test complete!${NC}"
diff --git a/tests/test_inquire_mode.py b/tests/test_inquire_mode.py
new file mode 100644
index 00000000..539766f7
--- /dev/null
+++ b/tests/test_inquire_mode.py
@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+"""
+Test script for Inquire Mode functionality
+"""
+import os
+import sys
+
+# Add the parent directory to the path to import app
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db, User, Recording, TranscriptChunk, InquireSession, Tag
+
+def test_database_models():
+    """Test that the new database models work correctly."""
+    with app.app_context():
+        print("🔍 Testing Inquire Mode Database Models...")
+        
+        # Test that tables exist
+        from sqlalchemy import inspect
+        inspector = inspect(db.engine)
+        tables = inspector.get_table_names()
+        
+        required_tables = ['transcript_chunk', 'inquire_session']
+        for table in required_tables:
+            if table in tables:
+                print(f"✅ Table '{table}' exists")
+            else:
+                print(f"❌ Table '{table}' missing")
+                return False
+        
+        # Test creating sample data
+        try:
+            # Create a test user (or get existing one)
+            user = User.query.first()
+            if not user:
+                print("❌ No users found. Please create a user first.")
+                return False
+            
+            print(f"📝 Using test user: {user.username}")
+            
+            # Create a test recording if none exist
+            recording = Recording.query.filter_by(user_id=user.id).first()
+            if not recording:
+                print("❌ No recordings found. Please create a recording first.")
+                return False
+            
+            print(f"🎵 Using test recording: {recording.title}")
+            
+            # Test TranscriptChunk creation
+            chunk = TranscriptChunk(
+                recording_id=recording.id,
+                user_id=user.id,
+                chunk_index=0,
+                content="This is a test transcription chunk.",
+                start_time=0.0,
+                end_time=5.0,
+                speaker_name="Test Speaker"
+            )
+            
+            db.session.add(chunk)
+            
+            # Test InquireSession creation
+            session = InquireSession(
+                user_id=user.id,
+                session_name="Test Session",
+                filter_tags='[]',
+                filter_speakers='["Test Speaker"]'
+            )
+            
+            db.session.add(session)
+            db.session.commit()
+            
+            print("✅ Successfully created test TranscriptChunk and InquireSession")
+            
+            # Clean up test data
+            db.session.delete(chunk)
+            db.session.delete(session)
+            db.session.commit()
+            
+            print("✅ Test data cleaned up")
+            
+        except Exception as e:
+            print(f"❌ Error testing models: {e}")
+            return False
+        
+        return True
+
+def test_chunking_functions():
+    """Test the chunking and embedding functions."""
+    with app.app_context():
+        print("🔧 Testing Chunking Functions...")
+        
+        try:
+            from src.app import chunk_transcription, generate_embeddings, serialize_embedding, deserialize_embedding
+            
+            # Test chunking
+            test_text = "This is a test sentence. This is another sentence for testing. And here's a third sentence to make sure chunking works properly with longer text that should be split into multiple chunks."
+            chunks = chunk_transcription(test_text, max_chunk_length=100, overlap=20)
+            
+            if len(chunks) > 1:
+                print(f"✅ Chunking works: {len(chunks)} chunks created")
+            else:
+                print("✅ Text too short for chunking (expected behavior)")
+            
+            # Test embeddings (will only work if sentence-transformers is installed)
+            try:
+                embeddings = generate_embeddings(["test sentence", "another test"])
+                if len(embeddings) == 2:
+                    print("✅ Embedding generation works")
+                    
+                    # Test serialization
+                    if embeddings[0] is not None:
+                        serialized = serialize_embedding(embeddings[0])
+                        deserialized = deserialize_embedding(serialized)
+                        if deserialized is not None and len(deserialized) > 0:
+                            print("✅ Embedding serialization/deserialization works")
+                        else:
+                            print("❌ Embedding serialization/deserialization failed")
+                else:
+                    print("❌ Embedding generation returned wrong number of embeddings")
+                    
+            except Exception as e:
+                print(f"⚠️  Embedding test skipped (sentence-transformers may not be installed): {e}")
+                
+        except Exception as e:
+            print(f"❌ Error testing chunking functions: {e}")
+            return False
+            
+        return True
+
+def test_api_imports():
+    """Test that all API endpoints can be imported."""
+    print("🔌 Testing API Endpoint Imports...")
+    
+    try:
+        from src.app import (
+            get_inquire_sessions, create_inquire_session, inquire_search, 
+            inquire_chat, get_available_filters, process_recording_chunks_endpoint
+        )
+        print("✅ All inquire mode API endpoints imported successfully")
+        return True
+    except ImportError as e:
+        print(f"❌ Failed to import API endpoints: {e}")
+        return False
+
+def main():
+    """Run all tests."""
+    print("🚀 Starting Inquire Mode Tests...\n")
+    
+    tests = [
+        ("Database Models", test_database_models),
+        ("Chunking Functions", test_chunking_functions), 
+        ("API Imports", test_api_imports)
+    ]
+    
+    results = []
+    for test_name, test_func in tests:
+        print(f"\n--- {test_name} ---")
+        try:
+            success = test_func()
+            results.append((test_name, success))
+        except Exception as e:
+            print(f"❌ {test_name} failed with exception: {e}")
+            results.append((test_name, False))
+    
+    print("\n" + "="*50)
+    print("📊 Test Results Summary:")
+    print("="*50)
+    
+    all_passed = True
+    for test_name, success in results:
+        status = "✅ PASS" if success else "❌ FAIL"
+        print(f"{status} - {test_name}")
+        if not success:
+            all_passed = False
+    
+    print("\n" + "="*50)
+    if all_passed:
+        print("🎉 All tests passed! Inquire Mode is ready to use.")
+    else:
+        print("⚠️  Some tests failed. Please check the output above.")
+        
+    return all_passed
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1)
\ No newline at end of file
diff --git a/tests/test_job_queue_race_condition.py b/tests/test_job_queue_race_condition.py
new file mode 100644
index 00000000..ae39b872
--- /dev/null
+++ b/tests/test_job_queue_race_condition.py
@@ -0,0 +1,284 @@
+#!/usr/bin/env python3
+"""
+Test script for job queue race condition fix.
+
+This script verifies that the atomic job claiming mechanism prevents
+multiple workers from claiming the same job simultaneously.
+
+The fix uses an atomic UPDATE with WHERE clause to ensure only one
+worker can claim a job, even with multiple processes/threads.
+"""
+
+import os
+import sys
+import threading
+import time
+from pathlib import Path
+from datetime import datetime
+from concurrent.futures import ThreadPoolExecutor, as_completed
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+def test_atomic_job_claiming():
+    """
+    Test that only one worker can claim a job even with concurrent attempts.
+
+    This simulates the race condition where multiple workers try to claim
+    the same job simultaneously.
+    """
+    print("\n=== Testing Atomic Job Claiming ===\n")
+
+    # Import Flask app and models
+    from src.app import app
+    from src.database import db
+    from src.models import ProcessingJob, User, Recording
+    from sqlalchemy import update
+
+    with app.app_context():
+        # Use the first existing user for testing, or create a minimal test user
+        test_user = User.query.first()
+        if not test_user:
+            test_user = User(
+                username='test_race_condition_user',
+                email='test_race@example.com',
+                password='not_used'  # Password not needed for this test
+            )
+            db.session.add(test_user)
+            db.session.commit()
+
+        # Create a test recording
+        test_recording = Recording(
+            user_id=test_user.id,
+            title='Test Race Condition Recording',
+            audio_path='/tmp/test_audio.mp3',
+            status='QUEUED'
+        )
+        db.session.add(test_recording)
+        db.session.commit()
+
+        # Create a test job in 'queued' status
+        test_job = ProcessingJob(
+            recording_id=test_recording.id,
+            user_id=test_user.id,
+            job_type='transcribe',
+            status='queued'
+        )
+        db.session.add(test_job)
+        db.session.commit()
+
+        job_id = test_job.id
+        print(f"Created test job {job_id} with status 'queued'")
+
+        # Track which threads successfully claimed the job
+        successful_claims = []
+        claim_lock = threading.Lock()
+
+        def attempt_claim(worker_id):
+            """Simulate a worker attempting to claim the job."""
+            with app.app_context():
+                try:
+                    # This is the atomic claim logic from the fix
+                    claim_time = datetime.utcnow()
+                    result = db.session.execute(
+                        update(ProcessingJob)
+                        .where(
+                            ProcessingJob.id == job_id,
+                            ProcessingJob.status == 'queued'
+                        )
+                        .values(status='processing', started_at=claim_time)
+                    )
+
+                    if result.rowcount == 1:
+                        db.session.commit()
+                        with claim_lock:
+                            successful_claims.append(worker_id)
+                        return f"Worker {worker_id}: Successfully claimed job"
+                    else:
+                        db.session.rollback()
+                        return f"Worker {worker_id}: Job already claimed (rowcount=0)"
+
+                except Exception as e:
+                    db.session.rollback()
+                    return f"Worker {worker_id}: Error - {e}"
+
+        # Spawn multiple threads to claim simultaneously
+        num_workers = 10
+        print(f"\nSpawning {num_workers} workers to claim job {job_id} simultaneously...")
+
+        # Use a barrier to ensure all threads start at the same time
+        barrier = threading.Barrier(num_workers)
+
+        def worker_with_barrier(worker_id):
+            barrier.wait()  # Wait for all threads to be ready
+            return attempt_claim(worker_id)
+
+        with ThreadPoolExecutor(max_workers=num_workers) as executor:
+            futures = {executor.submit(worker_with_barrier, i): i for i in range(num_workers)}
+
+            for future in as_completed(futures):
+                result = future.result()
+                print(f"  {result}")
+
+        # Verify results
+        print(f"\n=== Results ===")
+        print(f"Total workers: {num_workers}")
+        print(f"Successful claims: {len(successful_claims)}")
+        print(f"Workers that claimed: {successful_claims}")
+
+        # Check final job status
+        db.session.expire_all()
+        final_job = db.session.get(ProcessingJob, job_id)
+        print(f"Final job status: {final_job.status}")
+
+        # Cleanup
+        db.session.delete(final_job)
+        db.session.delete(test_recording)
+        db.session.commit()
+
+        # Assert only one worker claimed the job
+        assert len(successful_claims) == 1, f"Expected 1 successful claim, got {len(successful_claims)}"
+        assert final_job.status == 'processing', f"Expected status 'processing', got {final_job.status}"
+
+        print("\n[PASS] Only one worker successfully claimed the job!")
+        return True
+
+
+def test_multiple_jobs_fair_distribution():
+    """
+    Test that multiple jobs are distributed fairly across workers.
+    """
+    print("\n=== Testing Multiple Jobs Distribution ===\n")
+
+    from src.app import app
+    from src.database import db
+    from src.models import ProcessingJob, User, Recording
+    from sqlalchemy import update
+
+    with app.app_context():
+        # Use the first existing user for testing
+        test_user = User.query.first()
+        if not test_user:
+            test_user = User(
+                username='test_distribution_user',
+                email='test_dist@example.com',
+                password='not_used'
+            )
+            db.session.add(test_user)
+            db.session.commit()
+
+        # Create multiple test jobs
+        num_jobs = 5
+        job_ids = []
+        recording_ids = []
+
+        for i in range(num_jobs):
+            recording = Recording(
+                user_id=test_user.id,
+                title=f'Test Distribution Recording {i}',
+                audio_path=f'/tmp/test_audio_{i}.mp3',
+                status='QUEUED'
+            )
+            db.session.add(recording)
+            db.session.commit()
+            recording_ids.append(recording.id)
+
+            job = ProcessingJob(
+                recording_id=recording.id,
+                user_id=test_user.id,
+                job_type='transcribe',
+                status='queued'
+            )
+            db.session.add(job)
+            db.session.commit()
+            job_ids.append(job.id)
+
+        print(f"Created {num_jobs} test jobs: {job_ids}")
+
+        # Have workers claim jobs
+        claimed_jobs = []
+
+        def claim_any_job(worker_id):
+            with app.app_context():
+                # Find a queued job
+                candidate = ProcessingJob.query.filter(
+                    ProcessingJob.status == 'queued',
+                    ProcessingJob.job_type == 'transcribe'
+                ).first()
+
+                if not candidate:
+                    return None
+
+                # Atomic claim
+                result = db.session.execute(
+                    update(ProcessingJob)
+                    .where(
+                        ProcessingJob.id == candidate.id,
+                        ProcessingJob.status == 'queued'
+                    )
+                    .values(status='processing', started_at=datetime.utcnow())
+                )
+
+                if result.rowcount == 1:
+                    db.session.commit()
+                    return candidate.id
+                else:
+                    db.session.rollback()
+                    return None
+
+        try:
+            # Each "worker" claims one job
+            for i in range(num_jobs + 2):  # Extra attempts to ensure no double claims
+                job_id = claim_any_job(i)
+                if job_id:
+                    claimed_jobs.append(job_id)
+                    print(f"  Worker {i} claimed job {job_id}")
+                else:
+                    print(f"  Worker {i} found no available jobs")
+
+            print(f"\nClaimed jobs: {claimed_jobs}")
+            print(f"Unique jobs claimed: {len(set(claimed_jobs))}")
+
+            # Verify no duplicates
+            assert len(claimed_jobs) == len(set(claimed_jobs)), "Duplicate job claims detected!"
+            assert len(claimed_jobs) == num_jobs, f"Expected {num_jobs} claims, got {len(claimed_jobs)}"
+
+            print("\n[PASS] All jobs claimed exactly once!")
+            return True
+        finally:
+            # Cleanup must run even if the assertions above fail. Without this
+            # the synthetic 'Test Distribution Recording N' rows leak into the
+            # dev DB and show up in admin and user-facing recording lists.
+            for job_id in job_ids:
+                job = db.session.get(ProcessingJob, job_id)
+                if job:
+                    db.session.delete(job)
+            for rec_id in recording_ids:
+                rec = db.session.get(Recording, rec_id)
+                if rec:
+                    db.session.delete(rec)
+            db.session.commit()
+
+
+if __name__ == '__main__':
+    print("=" * 60)
+    print("Job Queue Race Condition Tests")
+    print("=" * 60)
+
+    try:
+        test_atomic_job_claiming()
+        test_multiple_jobs_fair_distribution()
+
+        print("\n" + "=" * 60)
+        print("All tests passed!")
+        print("=" * 60)
+
+    except AssertionError as e:
+        print(f"\n[FAIL] Test failed: {e}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n[ERROR] Unexpected error: {e}")
+        import traceback
+        traceback.print_exc()
+        sys.exit(1)
diff --git a/tests/test_json_fix.py b/tests/test_json_fix.py
new file mode 100644
index 00000000..9fe148c9
--- /dev/null
+++ b/tests/test_json_fix.py
@@ -0,0 +1,58 @@
+import json
+import sys
+import os
+
+# Add the parent directory to the path to import app
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import auto_close_json, safe_json_loads
+
+def run_tests():
+    """Runs a series of tests for the JSON fixing functions."""
+    
+    test_cases_auto_close = {
+        "Unterminated string": ('{"title": "Test", "summary": "This is a test', '{"title": "Test", "summary": "This is a test"}'),
+        "Missing closing brace": ('{"title": "Test", "summary": "This is a test"}', '{"title": "Test", "summary": "This is a test"}'),
+        "Missing closing bracket": ('[{"item": 1}, {"item": 2}', '[{"item": 1}, {"item": 2}]'),
+        "Nested unterminated": ('{"data": {"items": [1, 2', '{"data": {"items": [1, 2]}}'),
+        "String at the end": ('{"key": "value', '{"key": "value"}'),
+        "Empty string": ('', ''),
+        "Already valid": ('{"a": 1}', '{"a": 1}'),
+        "Complex nested object": ('{"a": {"b": {"c": [1, 2, {"d": "e' , '{"a": {"b": {"c": [1, 2, {"d": "e"}]}}}')
+    }
+
+    print("--- Testing auto_close_json ---")
+    for name, (input_str, expected_str) in test_cases_auto_close.items():
+        result = auto_close_json(input_str)
+        print(f"Test: {name}")
+        print(f"  Input:    '{input_str}'")
+        print(f"  Output:   '{result}'")
+        print(f"  Expected: '{expected_str}'")
+        assert result == expected_str, f"Failed: {name}"
+        print("  Result: PASSED\n")
+
+    test_cases_safe_loads = {
+        "Unterminated string": '{"title": "Test", "summary": "This is a test',
+        "Markdown with unterminated JSON": '```json\n{"title": "Test", "summary": "This is a test\n```',
+        "Missing closing brace": '{"title": "Test", "summary": "This is a test"}',
+        "Valid JSON": '{"title": "Complete", "summary": "This is a complete JSON."}',
+        "JSON with escaped quotes": '{"title": "Escaped", "summary": "This is a \\"test\\" with quotes."}',
+        "Invalid JSON": 'this is not json',
+    }
+
+    print("\n--- Testing safe_json_loads ---")
+    for name, input_str in test_cases_safe_loads.items():
+        result = safe_json_loads(input_str)
+        print(f"Test: {name}")
+        print(f"  Input: '{input_str}'")
+        print(f"  Output: {result}")
+        if name == "Invalid JSON":
+            assert result is None, f"Failed: {name}"
+            print("  Result: PASSED (Correctly returned None)\n")
+        else:
+            assert isinstance(result, dict), f"Failed: {name}"
+            print("  Result: PASSED\n")
+
+if __name__ == "__main__":
+    run_tests()
+    print("All tests completed successfully!")
diff --git a/tests/test_json_preprocessing.py b/tests/test_json_preprocessing.py
new file mode 100644
index 00000000..d3161433
--- /dev/null
+++ b/tests/test_json_preprocessing.py
@@ -0,0 +1,291 @@
+#!/usr/bin/env python3
+"""
+Test suite for JSON preprocessing functionality in Speakr app.
+Tests the safe_json_loads function with various malformed JSON scenarios.
+"""
+
+import sys
+import os
+import json
+import unittest
+from unittest.mock import Mock
+
+# Add the app directory to the path so we can import from app.py
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+# Mock the Flask app and logger for testing
+class MockApp:
+    def __init__(self):
+        self.logger = Mock()
+
+# Set up the mock app before importing
+app = MockApp()
+
+# Import the functions we want to test
+from src.app import safe_json_loads, preprocess_json_escapes, extract_json_object
+
+class TestJSONPreprocessing(unittest.TestCase):
+    """Test cases for JSON preprocessing functionality."""
+    
+    def test_valid_json(self):
+        """Test that valid JSON is parsed correctly."""
+        valid_json = '{"title": "Test Meeting", "summary": "This is a test summary"}'
+        result = safe_json_loads(valid_json)
+        expected = {"title": "Test Meeting", "summary": "This is a test summary"}
+        self.assertEqual(result, expected)
+    
+    def test_json_with_markdown_code_blocks(self):
+        """Test JSON wrapped in markdown code blocks."""
+        markdown_json = '''```json
+{
+  "title": "Meeting Notes",
+  "summary": "Key points discussed"
+}
+```'''
+        result = safe_json_loads(markdown_json)
+        expected = {"title": "Meeting Notes", "summary": "Key points discussed"}
+        self.assertEqual(result, expected)
+    
+    def test_json_with_unescaped_quotes(self):
+        """Test JSON with unescaped quotes in string values."""
+        malformed_json = '{"title": "John said "Hello world" to everyone", "summary": "Meeting summary"}'
+        result = safe_json_loads(malformed_json)
+        expected = {"title": 'John said "Hello world" to everyone', "summary": "Meeting summary"}
+        self.assertEqual(result, expected)
+    
+    def test_json_with_mixed_quotes(self):
+        """Test JSON with mixed quote scenarios."""
+        malformed_json = '{"title": "Alice\'s "big idea" presentation", "summary": "She said "this will change everything""}'
+        result = safe_json_loads(malformed_json)
+        self.assertIsInstance(result, dict)
+        self.assertIn("title", result)
+        self.assertIn("summary", result)
+    
+    def test_json_with_newlines_and_special_chars(self):
+        """Test JSON with newlines and special characters."""
+        malformed_json = '''{"title": "Complex Meeting", "summary": "Discussion about:\n- Point 1\n- Point 2 with "quotes"\n- Point 3"}'''
+        result = safe_json_loads(malformed_json)
+        self.assertIsInstance(result, dict)
+        self.assertIn("title", result)
+        self.assertIn("summary", result)
+    
+    def test_empty_or_invalid_input(self):
+        """Test handling of empty or invalid input."""
+        # Empty string
+        result = safe_json_loads("", {"default": "value"})
+        self.assertEqual(result, {"default": "value"})
+        
+        # None input
+        result = safe_json_loads(None, {"default": "value"})
+        self.assertEqual(result, {"default": "value"})
+        
+        # Non-string input
+        result = safe_json_loads(123, {"default": "value"})
+        self.assertEqual(result, {"default": "value"})
+    
+    def test_completely_malformed_json(self):
+        """Test completely malformed JSON that can't be fixed."""
+        malformed_json = '{"title": "Test", "summary": unclosed string and missing quotes}'
+        result = safe_json_loads(malformed_json, {"error": "fallback"})
+        self.assertEqual(result, {"error": "fallback"})
+    
+    def test_json_with_nested_quotes(self):
+        """Test JSON with deeply nested quote scenarios."""
+        malformed_json = '{"title": "Meeting about "Project Alpha" and "Project Beta"", "summary": "Both projects involve "cutting-edge" technology"}'
+        result = safe_json_loads(malformed_json)
+        self.assertIsInstance(result, dict)
+        # Should have successfully parsed something
+        self.assertTrue(len(result) > 0)
+    
+    def test_json_array_format(self):
+        """Test JSON array format (for transcription data)."""
+        json_array = '[{"speaker": "John", "sentence": "Hello everyone"}, {"speaker": "Jane", "sentence": "Good morning"}]'
+        result = safe_json_loads(json_array)
+        expected = [{"speaker": "John", "sentence": "Hello everyone"}, {"speaker": "Jane", "sentence": "Good morning"}]
+        self.assertEqual(result, expected)
+    
+    def test_preprocess_json_escapes_function(self):
+        """Test the preprocess_json_escapes function directly."""
+        input_json = '{"title": "John said "Hello" to Mary", "summary": "Simple test"}'
+        processed = preprocess_json_escapes(input_json)
+        # Should be valid JSON after preprocessing
+        result = json.loads(processed)
+        self.assertIsInstance(result, dict)
+        self.assertIn("title", result)
+        self.assertIn("summary", result)
+    
+    def test_extract_json_object_function(self):
+        """Test the extract_json_object function directly."""
+        # Test with extra text around JSON object
+        text_with_json = 'Here is some text {"title": "Test", "summary": "Content"} and more text'
+        extracted = extract_json_object(text_with_json)
+        result = json.loads(extracted)
+        expected = {"title": "Test", "summary": "Content"}
+        self.assertEqual(result, expected)
+        
+        # Test with JSON array
+        text_with_array = 'Some text [{"item": "one"}, {"item": "two"}] more text'
+        extracted = extract_json_object(text_with_array)
+        result = json.loads(extracted)
+        expected = [{"item": "one"}, {"item": "two"}]
+        self.assertEqual(result, expected)
+    
+    def test_real_world_llm_response_scenarios(self):
+        """Test real-world scenarios that might come from LLM responses."""
+        
+        # Scenario 1: LLM response with explanation text
+        llm_response1 = '''Here's the JSON response you requested:
+
+```json
+{
+  "title": "Q3 Planning Meeting",
+  "summary": "We discussed the "new initiative" and John's "breakthrough idea" for next quarter."
+}
+```
+
+This should help with your transcription needs.'''
+        
+        result1 = safe_json_loads(llm_response1)
+        self.assertIsInstance(result1, dict)
+        self.assertIn("title", result1)
+        self.assertIn("summary", result1)
+        
+        # Scenario 2: LLM response with unescaped quotes and no code blocks
+        llm_response2 = '{"title": "Team Standup", "summary": "Alice mentioned "the deadline is tight" and Bob said "we need more resources""}'
+        
+        result2 = safe_json_loads(llm_response2)
+        self.assertIsInstance(result2, dict)
+        self.assertIn("title", result2)
+        self.assertIn("summary", result2)
+        
+        # Scenario 3: LLM response with speaker identification
+        llm_response3 = '''{"SPEAKER_00": "John Smith", "SPEAKER_01": "Jane "The Expert" Doe", "SPEAKER_02": "Bob"}'''
+        
+        result3 = safe_json_loads(llm_response3)
+        self.assertIsInstance(result3, dict)
+        self.assertTrue(len(result3) >= 2)  # Should have parsed at least some speakers
+    
+    def test_fallback_strategies(self):
+        """Test that different parsing strategies work as fallbacks."""
+        
+        # Test ast.literal_eval fallback for simple cases
+        simple_dict = "{'title': 'Simple', 'summary': 'Test'}"
+        result = safe_json_loads(simple_dict)
+        expected = {"title": "Simple", "summary": "Test"}
+        self.assertEqual(result, expected)
+        
+        # Test regex extraction fallback
+        messy_response = 'Some text before {"title": "Extracted", "summary": "From regex"} some text after'
+        result = safe_json_loads(messy_response)
+        expected = {"title": "Extracted", "summary": "From regex"}
+        self.assertEqual(result, expected)
+    
+    def test_performance_with_large_content(self):
+        """Test performance with larger JSON content."""
+        large_summary = "This is a very long summary. " * 100  # Create a long string
+        large_json = f'{{"title": "Large Content Test", "summary": "{large_summary}"}}'
+        
+        result = safe_json_loads(large_json)
+        self.assertIsInstance(result, dict)
+        self.assertIn("title", result)
+        self.assertIn("summary", result)
+        self.assertEqual(result["title"], "Large Content Test")
+
+def run_comprehensive_test():
+    """Run a comprehensive test with various malformed JSON examples."""
+    print("🧪 Running comprehensive JSON preprocessing tests...\n")
+    
+    test_cases = [
+        {
+            "name": "Valid JSON",
+            "input": '{"title": "Test", "summary": "Valid JSON"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Unescaped quotes in title",
+            "input": '{"title": "Meeting about "Project X"", "summary": "Discussion summary"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Multiple unescaped quotes",
+            "input": '{"title": "John said "Hello" and Mary replied "Hi there"", "summary": "Conversation log"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Markdown code block",
+            "input": '```json\n{"title": "Wrapped", "summary": "In code block"}\n```',
+            "should_succeed": True
+        },
+        {
+            "name": "Mixed quotes and apostrophes",
+            "input": '{"title": "Alice\'s "big idea" presentation", "summary": "She said it\'s "revolutionary""}',
+            "should_succeed": True
+        },
+        {
+            "name": "JSON with newlines",
+            "input": '{"title": "Multi-line", "summary": "Line 1\\nLine 2 with \\"quotes\\"\\nLine 3"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Completely malformed",
+            "input": '{"title": "Test", "summary": this is not valid json at all}',
+            "should_succeed": False
+        },
+        {
+            "name": "Empty string",
+            "input": "",
+            "should_succeed": False
+        }
+    ]
+    
+    passed = 0
+    failed = 0
+    
+    for i, test_case in enumerate(test_cases, 1):
+        print(f"Test {i}: {test_case['name']}")
+        print(f"Input: {test_case['input'][:100]}{'...' if len(test_case['input']) > 100 else ''}")
+        
+        try:
+            result = safe_json_loads(test_case['input'], {"error": "fallback"})
+            
+            if test_case['should_succeed']:
+                if result != {"error": "fallback"} and isinstance(result, dict):
+                    print("✅ PASSED - Successfully parsed JSON")
+                    passed += 1
+                else:
+                    print("❌ FAILED - Expected successful parsing but got fallback")
+                    failed += 1
+            else:
+                if result == {"error": "fallback"}:
+                    print("✅ PASSED - Correctly returned fallback for malformed JSON")
+                    passed += 1
+                else:
+                    print("❌ FAILED - Expected fallback but got parsed result")
+                    failed += 1
+                    
+        except Exception as e:
+            print(f"❌ FAILED - Exception occurred: {e}")
+            failed += 1
+        
+        print("-" * 50)
+    
+    print(f"\n📊 Test Results: {passed} passed, {failed} failed")
+    return failed == 0
+
+if __name__ == "__main__":
+    print("🚀 Starting JSON Preprocessing Tests for Speakr App\n")
+    
+    # Run the comprehensive manual test
+    manual_success = run_comprehensive_test()
+    
+    print("\n" + "="*60)
+    print("🔬 Running Unit Tests")
+    print("="*60)
+    
+    # Run the unit tests
+    unittest.main(argv=[''], exit=False, verbosity=2)
+    
+    if manual_success:
+        print("\n🎉 All tests completed! JSON preprocessing should handle LLM response issues gracefully.")
+    else:
+        print("\n⚠️  Some tests failed. Please review the implementation.")
diff --git a/tests/test_json_standalone.py b/tests/test_json_standalone.py
new file mode 100644
index 00000000..c08827bd
--- /dev/null
+++ b/tests/test_json_standalone.py
@@ -0,0 +1,340 @@
+#!/usr/bin/env python3
+"""
+Standalone test for JSON preprocessing functionality.
+Tests the safe_json_loads function with various malformed JSON scenarios.
+"""
+
+import json
+import re
+import ast
+from unittest.mock import Mock
+
+# Mock logger for testing
+class MockLogger:
+    def warning(self, msg): print(f"WARNING: {msg}")
+    def info(self, msg): print(f"INFO: {msg}")
+    def debug(self, msg): print(f"DEBUG: {msg}")
+    def error(self, msg): print(f"ERROR: {msg}")
+
+# Create mock app with logger
+class MockApp:
+    logger = MockLogger()
+
+app = MockApp()
+
+def safe_json_loads(json_string, fallback_value=None):
+    """
+    Safely parse JSON with preprocessing to handle common LLM JSON formatting issues.
+    
+    Args:
+        json_string (str): The JSON string to parse
+        fallback_value: Value to return if parsing fails (default: None)
+    
+    Returns:
+        Parsed JSON object or fallback_value if parsing fails
+    """
+    if not json_string or not isinstance(json_string, str):
+        app.logger.warning(f"Invalid JSON input: {type(json_string)} - {json_string}")
+        return fallback_value
+    
+    # Step 1: Clean the input string
+    cleaned_json = json_string.strip()
+    
+    # Step 2: Extract JSON from markdown code blocks if present
+    json_match = re.search(r'```(?:json)?\s*(.*?)\s*```', cleaned_json, re.DOTALL)
+    if json_match:
+        cleaned_json = json_match.group(1).strip()
+    
+    # Step 3: Try multiple parsing strategies
+    parsing_strategies = [
+        # Strategy 1: Direct parsing (for well-formed JSON)
+        lambda x: json.loads(x),
+        
+        # Strategy 2: Fix common escape issues
+        lambda x: json.loads(preprocess_json_escapes(x)),
+        
+        # Strategy 3: Use ast.literal_eval as fallback for simple cases
+        lambda x: ast.literal_eval(x) if x.startswith(('{', '[')) else None,
+        
+        # Strategy 4: Extract JSON object/array using regex
+        lambda x: json.loads(extract_json_object(x)),
+    ]
+    
+    for i, strategy in enumerate(parsing_strategies):
+        try:
+            result = strategy(cleaned_json)
+            if result is not None:
+                if i > 0:  # Log if we had to use a fallback strategy
+                    app.logger.info(f"JSON parsed successfully using strategy {i+1}")
+                return result
+        except (json.JSONDecodeError, ValueError, SyntaxError) as e:
+            if i == 0:  # Only log the first failure to avoid spam
+                app.logger.debug(f"JSON parsing strategy {i+1} failed: {e}")
+            continue
+    
+    # All strategies failed
+    app.logger.error(f"All JSON parsing strategies failed for: {cleaned_json[:200]}...")
+    return fallback_value
+
+def preprocess_json_escapes(json_string):
+    """
+    Preprocess JSON string to fix common escape issues from LLM responses.
+    Uses a more sophisticated approach to handle nested quotes properly.
+    """
+    if not json_string:
+        return json_string
+    
+    result = []
+    i = 0
+    in_string = False
+    escape_next = False
+    expecting_value = False  # Track if we're expecting a value (after :)
+    
+    while i < len(json_string):
+        char = json_string[i]
+        
+        if escape_next:
+            # This character is escaped, add it as-is
+            result.append(char)
+            escape_next = False
+        elif char == '\\':
+            # This is an escape character
+            result.append(char)
+            escape_next = True
+        elif char == ':' and not in_string:
+            # We found a colon, next string will be a value
+            result.append(char)
+            expecting_value = True
+        elif char == ',' and not in_string:
+            # We found a comma, reset expecting_value
+            result.append(char)
+            expecting_value = False
+        elif char == '"':
+            if not in_string:
+                # Starting a string
+                in_string = True
+                result.append(char)
+            else:
+                # We're in a string, check if this quote should be escaped
+                # Look ahead to see if this is the end of the string value
+                j = i + 1
+                while j < len(json_string) and json_string[j].isspace():
+                    j += 1
+                
+                # For keys (not expecting_value), only end on colon
+                # For values (expecting_value), end on comma, closing brace, or closing bracket
+                if expecting_value:
+                    end_chars = ',}]'
+                else:
+                    end_chars = ':'
+                
+                if j < len(json_string) and json_string[j] in end_chars:
+                    # This is the end of the string
+                    in_string = False
+                    result.append(char)
+                    if not expecting_value:
+                        # We just finished a key, next will be expecting value
+                        expecting_value = True
+                else:
+                    # This is an inner quote that should be escaped
+                    result.append('\\"')
+        else:
+            result.append(char)
+        
+        i += 1
+    
+    return ''.join(result)
+
+def extract_json_object(text):
+    """
+    Extract the first complete JSON object or array from text using regex.
+    """
+    # Look for JSON object
+    obj_match = re.search(r'\{.*\}', text, re.DOTALL)
+    if obj_match:
+        return obj_match.group(0)
+    
+    # Look for JSON array
+    arr_match = re.search(r'\[.*\]', text, re.DOTALL)
+    if arr_match:
+        return arr_match.group(0)
+    
+    # Return original if no JSON structure found
+    return text
+
+def run_comprehensive_test():
+    """Run a comprehensive test with various malformed JSON examples."""
+    print("🧪 Running comprehensive JSON preprocessing tests...\n")
+    
+    test_cases = [
+        {
+            "name": "Valid JSON",
+            "input": '{"title": "Test", "summary": "Valid JSON"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Unescaped quotes in title",
+            "input": '{"title": "Meeting about "Project X"", "summary": "Discussion summary"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Multiple unescaped quotes",
+            "input": '{"title": "John said "Hello" and Mary replied "Hi there"", "summary": "Conversation log"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Markdown code block",
+            "input": '```json\n{"title": "Wrapped", "summary": "In code block"}\n```',
+            "should_succeed": True
+        },
+        {
+            "name": "Mixed quotes and apostrophes",
+            "input": '{"title": "Alice\'s "big idea" presentation", "summary": "She said it\'s "revolutionary""}',
+            "should_succeed": True
+        },
+        {
+            "name": "JSON with newlines",
+            "input": '{"title": "Multi-line", "summary": "Line 1\\nLine 2 with \\"quotes\\"\\nLine 3"}',
+            "should_succeed": True
+        },
+        {
+            "name": "LLM response with explanation",
+            "input": '''Here's the JSON:
+```json
+{
+  "title": "Q3 Planning",
+  "summary": "We discussed the "new initiative" for next quarter."
+}
+```
+Hope this helps!''',
+            "should_succeed": True
+        },
+        {
+            "name": "Speaker identification with quotes",
+            "input": '{"SPEAKER_00": "John Smith", "SPEAKER_01": "Jane "The Expert" Doe", "SPEAKER_02": "Bob"}',
+            "should_succeed": True
+        },
+        {
+            "name": "Completely malformed",
+            "input": '{"title": "Test", "summary": this is not valid json at all}',
+            "should_succeed": False
+        },
+        {
+            "name": "Empty string",
+            "input": "",
+            "should_succeed": False
+        }
+    ]
+    
+    passed = 0
+    failed = 0
+    
+    for i, test_case in enumerate(test_cases, 1):
+        print(f"Test {i}: {test_case['name']}")
+        print(f"Input: {test_case['input'][:100]}{'...' if len(test_case['input']) > 100 else ''}")
+        
+        try:
+            result = safe_json_loads(test_case['input'], {"error": "fallback"})
+            
+            if test_case['should_succeed']:
+                if result != {"error": "fallback"} and isinstance(result, (dict, list)):
+                    print("✅ PASSED - Successfully parsed JSON")
+                    print(f"   Result: {result}")
+                    passed += 1
+                else:
+                    print("❌ FAILED - Expected successful parsing but got fallback")
+                    failed += 1
+            else:
+                if result == {"error": "fallback"}:
+                    print("✅ PASSED - Correctly returned fallback for malformed JSON")
+                    passed += 1
+                else:
+                    print("❌ FAILED - Expected fallback but got parsed result")
+                    print(f"   Unexpected result: {result}")
+                    failed += 1
+                    
+        except Exception as e:
+            print(f"❌ FAILED - Exception occurred: {e}")
+            failed += 1
+        
+        print("-" * 50)
+    
+    print(f"\n📊 Test Results: {passed} passed, {failed} failed")
+    return failed == 0
+
+def test_preprocessing_function():
+    """Test the preprocessing function directly."""
+    print("\n🔧 Testing preprocessing function directly...\n")
+    
+    test_input = '{"title": "Meeting about "Project X"", "summary": "Discussion summary"}'
+    print(f"Original: {test_input}")
+    
+    processed = preprocess_json_escapes(test_input)
+    print(f"Processed: {processed}")
+    
+    try:
+        result = json.loads(processed)
+        print(f"✅ Successfully parsed: {result}")
+    except json.JSONDecodeError as e:
+        print(f"❌ Still failed: {e}")
+
+def test_specific_scenarios():
+    """Test specific real-world scenarios."""
+    print("\n🎯 Testing specific LLM response scenarios...\n")
+    
+    # Test case from the original issue
+    gemini_response = '''{"title": "Meeting about "Project Phoenix" and budget allocation", "summary": "The team discussed John's "breakthrough idea" and Mary said "this will change everything" during the Q3 planning session."}'''
+    
+    print("Testing Gemini-style response with unescaped quotes:")
+    print(f"Input: {gemini_response}")
+    
+    # Test preprocessing directly
+    processed = preprocess_json_escapes(gemini_response)
+    print(f"Processed: {processed}")
+    
+    result = safe_json_loads(gemini_response)
+    if isinstance(result, dict) and "title" in result and "summary" in result:
+        print("✅ SUCCESS - Parsed Gemini response correctly!")
+        print(f"Title: {result['title']}")
+        print(f"Summary: {result['summary'][:100]}...")
+    else:
+        print("❌ FAILED - Could not parse Gemini response")
+        print(f"Result: {result}")
+    
+    print("-" * 50)
+    
+    # Test speaker identification scenario
+    speaker_response = '''{"SPEAKER_00": "John "The Manager" Smith", "SPEAKER_01": "Alice Johnson", "SPEAKER_02": "Bob "Tech Lead" Wilson"}'''
+    
+    print("Testing speaker identification with quotes in names:")
+    print(f"Input: {speaker_response}")
+    
+    # Test preprocessing directly
+    processed = preprocess_json_escapes(speaker_response)
+    print(f"Processed: {processed}")
+    
+    result = safe_json_loads(speaker_response)
+    if isinstance(result, dict) and len(result) >= 3:
+        print("✅ SUCCESS - Parsed speaker identification correctly!")
+        for speaker, name in result.items():
+            print(f"  {speaker}: {name}")
+    else:
+        print("❌ FAILED - Could not parse speaker identification")
+        print(f"Result: {result}")
+
+if __name__ == "__main__":
+    print("🚀 Starting Standalone JSON Preprocessing Tests\n")
+    
+    # Test preprocessing function directly
+    test_preprocessing_function()
+    
+    # Run the comprehensive test
+    success = run_comprehensive_test()
+    
+    # Test specific scenarios
+    test_specific_scenarios()
+    
+    if success:
+        print("\n🎉 All tests completed successfully! JSON preprocessing should handle LLM response issues gracefully.")
+    else:
+        print("\n⚠️  Some tests failed. The implementation may need refinement.")
diff --git a/tests/test_language_normalization.py b/tests/test_language_normalization.py
new file mode 100644
index 00000000..81c32f86
--- /dev/null
+++ b/tests/test_language_normalization.py
@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""Tests for src.utils.language.normalize_language_code.
+
+Run with: docker exec speakr-dev python /app/tests/test_language_normalization.py
+"""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from src.utils.language import normalize_language_code, SUPPORTED_CODES
+
+
+PASSED = 0
+FAILED = 0
+
+
+def expect(value, expected):
+    global PASSED, FAILED
+    got = normalize_language_code(value)
+    if got == expected:
+        print(f"  ✓ normalize({value!r}) → {got!r}")
+        PASSED += 1
+    else:
+        print(f"  ✗ normalize({value!r}) → {got!r} (expected {expected!r})")
+        FAILED += 1
+
+
+def main():
+    print("=== normalize_language_code ===\n")
+
+    # Empty / auto-detect
+    expect(None, None)
+    expect("", None)
+    expect("   ", None)
+    expect("auto", None)
+    expect("Auto-Detect", None)
+
+    # Already valid ISO codes
+    expect("en", "en")
+    expect("FR", "fr")
+    expect("zh", "zh")
+    expect("yue", "yue")  # 3-letter cantonese code
+
+    # Display names — English
+    expect("English", "en")
+    expect("french", "fr")
+    expect("German", "de")
+    expect("Chinese", "zh")
+    expect("Cantonese", "yue")
+
+    # Native names — the actual issue #256 case
+    expect("Français", "fr")
+    expect("français", "fr")
+    expect("Francais", "fr")
+    expect("Deutsch", "de")
+    expect("Español", "es")
+    expect("Português", "pt")
+    expect("русский", "ru")
+    expect("日本語", "ja")
+    expect("中文", "zh")
+
+    # Locale codes
+    expect("en-US", "en")
+    expect("fr-FR", "fr")
+    expect("zh_CN", "zh")
+    expect("pt-BR", "pt")
+
+    # Invalid → None (don't crash the ASR call, let auto-detect kick in)
+    expect("Klingon", None)
+    expect("xyz", None)
+    expect("123", None)
+    expect("???", None)
+
+    # Sanity check the supported set
+    assert "fr" in SUPPORTED_CODES
+    assert "français" not in SUPPORTED_CODES, "supported set must hold codes only"
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_migration_compatibility.py b/tests/test_migration_compatibility.py
new file mode 100644
index 00000000..e8a43b52
--- /dev/null
+++ b/tests/test_migration_compatibility.py
@@ -0,0 +1,251 @@
+"""
+Test suite to ensure database migrations are compatible with both SQLite and PostgreSQL.
+
+These tests scan the init_db.py file for patterns that would break on PostgreSQL,
+such as SQLite-only boolean defaults (0/1 instead of FALSE/TRUE) and unquoted
+reserved keywords.
+
+Run with: python tests/test_migration_compatibility.py
+"""
+
+import re
+import unittest
+import os
+
+
+class TestMigrationCompatibility(unittest.TestCase):
+    """Tests to ensure init_db.py uses cross-database compatible SQL."""
+
+    @classmethod
+    def setUpClass(cls):
+        """Load init_db.py content once for all tests."""
+        # Find the project root
+        test_dir = os.path.dirname(os.path.abspath(__file__))
+        project_root = os.path.dirname(test_dir)
+        init_db_path = os.path.join(project_root, 'src', 'init_db.py')
+
+        with open(init_db_path, 'r') as f:
+            cls.content = f.read()
+
+    def test_no_raw_boolean_defaults_in_alter_table(self):
+        """
+        Ensure no raw ALTER TABLE statements use SQLite-only boolean defaults.
+
+        The pattern 'BOOLEAN DEFAULT 0' or 'BOOLEAN DEFAULT 1' in raw SQL
+        will fail on PostgreSQL, which requires 'DEFAULT FALSE' or 'DEFAULT TRUE'.
+
+        Using add_column_if_not_exists() handles this conversion automatically.
+        """
+        # Pattern to find raw SQL with text() that has BOOLEAN DEFAULT 0/1
+        # This matches: text('... BOOLEAN DEFAULT 0 ...') or text("...")
+        pattern = r"conn\.execute\s*\(\s*text\s*\(['\"]([^'\"]*BOOLEAN\s+DEFAULT\s+[01][^'\"]*)['\"]"
+
+        matches = re.findall(pattern, self.content, re.IGNORECASE)
+
+        # Filter out false positives - we're looking for raw ALTER TABLE statements
+        # not UPDATE statements or other SQL that legitimately uses 0/1
+        problematic = []
+        for match in matches:
+            match_upper = match.upper()
+            # Only flag if it's an ALTER TABLE with BOOLEAN DEFAULT 0/1
+            if 'ALTER TABLE' in match_upper and 'BOOLEAN' in match_upper:
+                if 'DEFAULT 0' in match or 'DEFAULT 1' in match:
+                    problematic.append(match)
+
+        self.assertEqual(
+            len(problematic), 0,
+            f"Found SQLite-only boolean defaults in raw ALTER TABLE statements. "
+            f"Use add_column_if_not_exists() instead:\n" +
+            "\n".join(f"  - {m[:100]}..." if len(m) > 100 else f"  - {m}" for m in problematic)
+        )
+
+    def test_no_boolean_integer_comparisons_in_raw_sql(self):
+        """
+        Ensure raw SQL doesn't compare boolean columns to integers (0/1).
+
+        PostgreSQL strictly separates boolean and integer types:
+        - 'column = 1' fails with 'operator does not exist: boolean = integer'
+        - 'column = TRUE' works on both SQLite (3.23+) and PostgreSQL
+
+        Known boolean columns in migrations: protect_from_deletion, email_verified,
+        auto_share_on_apply, share_with_group_lead, is_inbox, is_highlighted,
+        deletion_exempt, is_admin, can_share_publicly.
+        """
+        boolean_columns = [
+            'protect_from_deletion', 'email_verified', 'auto_share_on_apply',
+            'share_with_group_lead', 'is_inbox', 'is_highlighted',
+            'deletion_exempt', 'is_admin', 'can_share_publicly',
+            'auto_speaker_labelling', 'auto_summarization'
+        ]
+
+        # Find raw SQL in text() calls
+        sql_pattern = r"text\s*\(\s*['\"\"]\"\"(.*?)['\"\"]\"\"?\s*\)"
+        # Simpler: find lines with known boolean column = 0 or = 1
+        problematic = []
+        for col in boolean_columns:
+            # Match: column = 0 or column = 1 (not = TRUE/FALSE)
+            pattern = rf"{col}\s*=\s*[01]\b"
+            matches = re.finditer(pattern, self.content, re.IGNORECASE)
+            for match in matches:
+                # Get surrounding context to check if it's in a text() SQL call
+                start = max(0, match.start() - 200)
+                context = self.content[start:match.end() + 50]
+                if 'text(' in context and 'sqlite_master' not in context:
+                    problematic.append(f"{col}: ...{match.group()}...")
+
+        self.assertEqual(
+            len(problematic), 0,
+            f"Found boolean columns compared to integers in raw SQL. "
+            f"Use TRUE/FALSE instead of 1/0 for PostgreSQL compatibility:\n" +
+            "\n".join(f"  - {p}" for p in problematic)
+        )
+
+    def test_reserved_keywords_quoted_in_index_creation(self):
+        """
+        Ensure reserved keywords like 'user' are properly quoted in index creation.
+
+        Raw SQL like 'CREATE INDEX ... ON user (column)' will fail on some databases
+        because 'user' is a reserved keyword. It should be quoted as "user" or use
+        the create_index_if_not_exists() utility.
+        """
+        reserved_keywords = ['user', 'order', 'group', 'table', 'select', 'index']
+
+        problematic = []
+
+        for keyword in reserved_keywords:
+            # Pattern to find unquoted reserved keyword after ON in index creation
+            # Matches: CREATE INDEX ... ON user ( but not ON "user" or ON `user`
+            pattern = rf"CREATE\s+(?:UNIQUE\s+)?INDEX[^;]*\s+ON\s+{keyword}\s*\("
+
+            matches = re.findall(pattern, self.content, re.IGNORECASE)
+
+            for match in matches:
+                # Skip if the keyword is already quoted
+                if f'"{keyword}"' in match.lower() or f'`{keyword}`' in match.lower():
+                    continue
+                problematic.append((keyword, match[:80]))
+
+        self.assertEqual(
+            len(problematic), 0,
+            f"Found unquoted reserved keywords in index creation. "
+            f"Use create_index_if_not_exists() or quote the table name:\n" +
+            "\n".join(f"  - '{kw}' in: {sql}..." for kw, sql in problematic)
+        )
+
+    def test_add_column_uses_utility(self):
+        """
+        Ensure most ADD COLUMN operations use add_column_if_not_exists().
+
+        Direct ALTER TABLE ADD COLUMN statements should use the utility function
+        to ensure cross-database compatibility with boolean defaults and quoting.
+        """
+        # Count direct ALTER TABLE ADD COLUMN in text() calls
+        direct_pattern = r"conn\.execute\s*\(\s*text\s*\(['\"][^'\"]*ALTER\s+TABLE[^'\"]*ADD\s+COLUMN"
+        direct_matches = re.findall(direct_pattern, self.content, re.IGNORECASE)
+
+        # Count uses of add_column_if_not_exists
+        utility_pattern = r"add_column_if_not_exists\s*\("
+        utility_matches = re.findall(utility_pattern, self.content)
+
+        # We expect most ADD COLUMN operations to use the utility
+        # Allow some direct usage for special cases (e.g., table recreation)
+        # but utility usage should significantly outnumber direct usage
+        self.assertGreater(
+            len(utility_matches), len(direct_matches),
+            f"Found {len(direct_matches)} direct ALTER TABLE ADD COLUMN statements "
+            f"vs {len(utility_matches)} add_column_if_not_exists() calls. "
+            f"Consider using the utility function for cross-database compatibility."
+        )
+
+    def test_incompatible_types_handled_by_utility(self):
+        """
+        Ensure columns with PostgreSQL-incompatible types (DATETIME, BLOB) are
+        added through add_column_if_not_exists() which auto-converts them,
+        and NOT via raw ALTER TABLE statements that would bypass conversion.
+
+        PostgreSQL type differences:
+        - DATETIME -> TIMESTAMP
+        - BLOB -> BYTEA
+        """
+        incompatible_types = ['DATETIME', 'BLOB']
+
+        # Check for raw ALTER TABLE statements using incompatible types
+        for sql_type in incompatible_types:
+            pattern = rf"conn\.execute\s*\(\s*text\s*\(['\"][^'\"]*ALTER\s+TABLE[^'\"]*\b{sql_type}\b[^'\"]*['\"]"
+            matches = re.findall(pattern, self.content, re.IGNORECASE)
+
+            self.assertEqual(
+                len(matches), 0,
+                f"Found raw ALTER TABLE statements using '{sql_type}' which is incompatible with PostgreSQL. "
+                f"Use add_column_if_not_exists() which auto-converts types:\n" +
+                "\n".join(f"  - {m[:100]}..." if len(m) > 100 else f"  - {m}" for m in matches)
+            )
+
+        # Verify that add_column_if_not_exists calls using these types exist
+        # (confirming they go through the utility which handles conversion)
+        for sql_type in incompatible_types:
+            pattern = rf"add_column_if_not_exists\s*\([^)]*['\"]({sql_type})['\"]"
+            matches = re.findall(pattern, self.content, re.IGNORECASE)
+            # Just informational - these are fine because the utility converts them
+
+    def test_no_double_quoted_string_defaults(self):
+        """
+        Ensure no SQL DEFAULT values use double-quoted strings.
+
+        In SQL, double quotes denote identifiers (column/table names), not string
+        literals. SQLite tolerates this, but PostgreSQL will interpret DEFAULT "en"
+        as a reference to a column named "en" and fail with 'column "en" does not exist'.
+
+        String defaults must use single quotes: DEFAULT 'en'
+        """
+        # Match DEFAULT followed by a double-quoted string value
+        pattern = r'DEFAULT\s+"[^"]*"'
+
+        lines = self.content.splitlines()
+        problematic = []
+        for i, line in enumerate(lines, 1):
+            if re.search(pattern, line, re.IGNORECASE):
+                problematic.append(f"  Line {i}: {line.strip()}")
+
+        self.assertEqual(
+            len(problematic), 0,
+            f"Found double-quoted string defaults in init_db.py. "
+            f"PostgreSQL interprets double quotes as column identifiers, not string literals. "
+            f"Use single quotes instead (e.g., DEFAULT 'en' not DEFAULT \"en\"):\n" +
+            "\n".join(problematic)
+        )
+
+    def test_create_index_uses_utility_for_user_table(self):
+        """
+        Ensure index creation on 'user' table uses create_index_if_not_exists().
+
+        The 'user' table name is a reserved keyword that requires special quoting.
+        Using create_index_if_not_exists() handles this automatically.
+        """
+        # Find all index creation on user table
+        pattern = r"CREATE\s+(?:UNIQUE\s+)?INDEX[^;]*ON\s+[\"'`]?user[\"'`]?\s*\("
+
+        # Count raw index creation on user table in text() calls
+        raw_pattern = r"conn\.execute\s*\(\s*text\s*\(['\"][^'\"]*CREATE\s+(?:UNIQUE\s+)?INDEX[^'\"]*ON\s+[\"'`]?user"
+        raw_matches = re.findall(raw_pattern, self.content, re.IGNORECASE)
+
+        # Count uses of create_index_if_not_exists for user table
+        utility_pattern = r"create_index_if_not_exists\s*\([^)]*['\"]user['\"]"
+        utility_matches = re.findall(utility_pattern, self.content, re.IGNORECASE)
+
+        # All index creation on user table should use the utility
+        # (excluding table recreation scenarios which have their own quoting)
+        if len(raw_matches) > 0:
+            # Check if these are in table recreation blocks (acceptable)
+            table_recreation_pattern = r"CREATE\s+TABLE\s+user_new"
+            has_table_recreation = re.search(table_recreation_pattern, self.content, re.IGNORECASE)
+
+            if not has_table_recreation or len(raw_matches) > 1:
+                self.fail(
+                    f"Found {len(raw_matches)} raw CREATE INDEX statements on 'user' table. "
+                    f"Use create_index_if_not_exists() for proper quoting of reserved keywords."
+                )
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/test_mistral_connector.py b/tests/test_mistral_connector.py
new file mode 100644
index 00000000..a9ee8d11
--- /dev/null
+++ b/tests/test_mistral_connector.py
@@ -0,0 +1,720 @@
+#!/usr/bin/env python3
+"""
+Tests for the Mistral/Voxtral transcription connector.
+
+Validates:
+1. Connector initialization and configuration validation
+2. Capabilities and specifications
+3. Segment parsing (speaker_id mapping, confidence/score)
+4. Context bias (hotwords) splitting
+5. Request building (diarize, language, timestamps)
+6. Error handling
+7. Registry integration
+
+Run with: docker exec speakr-dev python /app/tests/test_mistral_connector.py
+"""
+
+import os
+import sys
+import io
+import json
+import re
+from pathlib import Path
+from unittest.mock import patch, MagicMock
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+# Test results tracking
+PASSED = 0
+FAILED = 0
+ERRORS = []
+
+
+def run_test(name, func):
+    global PASSED, FAILED, ERRORS
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+        ERRORS.append((name, str(e)))
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+        ERRORS.append((name, f"Exception: {e}"))
+
+
+# =============================================================================
+# TEST SECTION 1: Initialization and Configuration
+# =============================================================================
+
+def test_initialization():
+    """Test connector initialization and config validation."""
+    print("\n=== Testing Initialization ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+    from src.services.transcription.exceptions import ConfigurationError
+
+    def t1():
+        connector = MistralTranscriptionConnector({
+            'api_key': 'test-key-123',
+            'base_url': 'https://api.mistral.ai',
+            'model': 'voxtral-mini-latest',
+        })
+        assert connector.api_key == 'test-key-123'
+        assert connector.base_url == 'https://api.mistral.ai'
+        assert connector.model == 'voxtral-mini-latest'
+    run_test("Basic initialization with all config", t1)
+
+    def t2():
+        connector = MistralTranscriptionConnector({
+            'api_key': 'test-key',
+        })
+        assert connector.base_url == 'https://api.mistral.ai'
+        assert connector.model == 'voxtral-mini-latest'
+    run_test("Default base_url and model when not provided", t2)
+
+    def t3():
+        connector = MistralTranscriptionConnector({
+            'api_key': 'test-key',
+            'base_url': 'https://custom.endpoint.com/',
+        })
+        assert connector.base_url == 'https://custom.endpoint.com'  # Trailing slash stripped
+    run_test("Trailing slash stripped from base_url", t3)
+
+    def t4():
+        connector = MistralTranscriptionConnector({
+            'api_key': 'test-key',
+            'base_url': '',  # Empty string should fall back to default
+        })
+        assert connector.base_url == 'https://api.mistral.ai'
+    run_test("Empty base_url falls back to default", t4)
+
+    def t5():
+        try:
+            MistralTranscriptionConnector({'api_key': ''})
+            assert False, "Should have raised ConfigurationError"
+        except ConfigurationError as e:
+            assert 'api_key' in str(e)
+    run_test("Empty api_key raises ConfigurationError", t5)
+
+    def t6():
+        try:
+            MistralTranscriptionConnector({})
+            assert False, "Should have raised ConfigurationError"
+        except (ConfigurationError, KeyError):
+            pass  # Either is acceptable
+    run_test("Missing api_key raises error", t6)
+
+
+# =============================================================================
+# TEST SECTION 2: Capabilities and Specifications
+# =============================================================================
+
+def test_capabilities():
+    """Test connector capabilities and specifications."""
+    print("\n=== Testing Capabilities ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+    from src.services.transcription.base import TranscriptionCapability
+
+    def t1():
+        assert TranscriptionCapability.DIARIZATION in MistralTranscriptionConnector.CAPABILITIES
+    run_test("Supports diarization", t1)
+
+    def t2():
+        assert TranscriptionCapability.TIMESTAMPS in MistralTranscriptionConnector.CAPABILITIES
+    run_test("Supports timestamps", t2)
+
+    def t3():
+        assert TranscriptionCapability.LANGUAGE_DETECTION in MistralTranscriptionConnector.CAPABILITIES
+    run_test("Supports language detection", t3)
+
+    def t4():
+        assert TranscriptionCapability.SPEAKER_COUNT_CONTROL not in MistralTranscriptionConnector.CAPABILITIES
+    run_test("Does NOT support speaker count control (Mistral doesn't have min/max speakers)", t4)
+
+    def t5():
+        specs = MistralTranscriptionConnector.SPECIFICATIONS
+        assert specs.handles_chunking_internally is True
+    run_test("Handles chunking internally", t5)
+
+    def t6():
+        specs = MistralTranscriptionConnector.SPECIFICATIONS
+        assert specs.max_duration_seconds is None
+    run_test("No max_duration_seconds (avoids triggering app-level chunking)", t6)
+
+    def t7():
+        specs = MistralTranscriptionConnector.SPECIFICATIONS
+        assert specs.recommended_chunk_seconds == 0
+    run_test("recommended_chunk_seconds is 0 (disabled)", t7)
+
+    def t8():
+        specs = MistralTranscriptionConnector.SPECIFICATIONS
+        assert specs.max_file_size_bytes is None
+    run_test("No file size limit", t8)
+
+    def t9():
+        connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+        assert connector.supports_diarization is True
+    run_test("Instance supports_diarization property", t9)
+
+    def t10():
+        connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+        assert connector.PROVIDER_NAME == 'mistral'
+    run_test("Provider name is 'mistral'", t10)
+
+
+# =============================================================================
+# TEST SECTION 3: Segment Parsing
+# =============================================================================
+
+def test_segment_parsing():
+    """Test _parse_segments with various Mistral response formats."""
+    print("\n=== Testing Segment Parsing ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+
+    connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+
+    def t1():
+        """Mistral uses speaker_id, not speaker."""
+        segments = connector._parse_segments([
+            {'text': 'Bonjour', 'speaker_id': 'speaker_0', 'start': 0.0, 'end': 1.5, 'score': 0.95},
+            {'text': 'Salut', 'speaker_id': 'speaker_1', 'start': 1.5, 'end': 3.0, 'score': 0.88},
+        ])
+        assert len(segments) == 2
+        assert segments[0].speaker == 'speaker_0'
+        assert segments[1].speaker == 'speaker_1'
+    run_test("speaker_id field maps to speaker", t1)
+
+    def t2():
+        """Fallback to 'speaker' key if speaker_id is absent."""
+        segments = connector._parse_segments([
+            {'text': 'Hello', 'speaker': 'SPEAKER_00', 'start': 0.0, 'end': 1.0},
+        ])
+        assert segments[0].speaker == 'SPEAKER_00'
+    run_test("Falls back to 'speaker' key if speaker_id missing", t2)
+
+    def t3():
+        """Score field maps to confidence."""
+        segments = connector._parse_segments([
+            {'text': 'Test', 'score': 0.92, 'start': 0.0, 'end': 1.0},
+        ])
+        assert segments[0].confidence == 0.92
+    run_test("score field maps to confidence", t3)
+
+    def t4():
+        """Timestamps are correctly parsed."""
+        segments = connector._parse_segments([
+            {'text': 'Timestamp test', 'start': 5.5, 'end': 10.2},
+        ])
+        assert segments[0].start_time == 5.5
+        assert segments[0].end_time == 10.2
+    run_test("start/end timestamps are parsed", t4)
+
+    def t5():
+        """Handles missing optional fields gracefully."""
+        segments = connector._parse_segments([
+            {'text': 'Minimal segment'},
+        ])
+        assert len(segments) == 1
+        assert segments[0].text == 'Minimal segment'
+        assert segments[0].speaker is None
+        assert segments[0].start_time is None
+        assert segments[0].confidence is None
+    run_test("Missing optional fields default to None", t5)
+
+    def t6():
+        """Empty segments list returns empty list."""
+        segments = connector._parse_segments([])
+        assert segments == []
+    run_test("Empty segments list returns empty", t6)
+
+
+# =============================================================================
+# TEST SECTION 4: Hotwords / Context Bias Splitting
+# =============================================================================
+
+def test_hotwords_splitting():
+    """Test context_bias generation from hotwords string."""
+    print("\n=== Testing Hotwords Splitting ===")
+
+    def split_hotwords(hotwords_str):
+        """Replicate the connector's splitting logic."""
+        return [w for w in re.split(r'[,\s]+', hotwords_str) if w]
+
+    def t1():
+        result = split_hotwords("Speakr, Voxtral, PyAnnote")
+        assert result == ['Speakr', 'Voxtral', 'PyAnnote']
+    run_test("Comma-separated hotwords split correctly", t1)
+
+    def t2():
+        result = split_hotwords("Speakr Voxtral PyAnnote")
+        assert result == ['Speakr', 'Voxtral', 'PyAnnote']
+    run_test("Space-separated hotwords split correctly", t2)
+
+    def t3():
+        result = split_hotwords("Speakr,Voxtral,PyAnnote")
+        assert result == ['Speakr', 'Voxtral', 'PyAnnote']
+    run_test("Comma-only (no spaces) hotwords split correctly", t3)
+
+    def t4():
+        result = split_hotwords("  Speakr ,  Voxtral  , PyAnnote  ")
+        assert result == ['Speakr', 'Voxtral', 'PyAnnote']
+    run_test("Extra whitespace is trimmed", t4)
+
+    def t5():
+        result = split_hotwords("")
+        assert result == []
+    run_test("Empty string produces empty list", t5)
+
+    def t6():
+        result = split_hotwords("SingleWord")
+        assert result == ['SingleWord']
+    run_test("Single word produces one-item list", t6)
+
+    def t7():
+        """Each item must match ^[^,\s]+$ per Mistral spec."""
+        result = split_hotwords("hello world, foo bar, baz")
+        for item in result:
+            assert re.match(r'^[^,\s]+$', item), f"'{item}' contains comma or whitespace"
+    run_test("All split items conform to Mistral's single-token pattern", t7)
+
+
+# =============================================================================
+# TEST SECTION 5: Request Building
+# =============================================================================
+
+def test_request_building():
+    """Test that transcribe() builds the correct multipart request."""
+    print("\n=== Testing Request Building ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+    from src.services.transcription.base import TranscriptionRequest
+
+    connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+
+    def make_request(**kwargs):
+        defaults = {
+            'audio_file': io.BytesIO(b'fake audio'),
+            'filename': 'test.wav',
+        }
+        defaults.update(kwargs)
+        return TranscriptionRequest(**defaults)
+
+    def t1():
+        """Verify diarize and timestamp_granularities are always sent together."""
+        captured = {}
+
+        def mock_post(url, **kwargs):
+            captured['url'] = url
+            captured['files'] = kwargs.get('files', [])
+            mock_resp = MagicMock()
+            mock_resp.status_code = 200
+            mock_resp.json.return_value = {'text': 'test', 'segments': []}
+            return mock_resp
+
+        connector.client.post = mock_post
+        req = make_request(diarize=True)
+        connector.transcribe(req)
+
+        field_names = [f[0] for f in captured['files']]
+        assert 'diarize' in field_names, f"diarize not in fields: {field_names}"
+        assert 'timestamp_granularities' in field_names, f"timestamp_granularities not in fields: {field_names}"
+    run_test("Diarize sends both diarize and timestamp_granularities", t1)
+
+    def t2():
+        """Language is passed through when provided."""
+        captured = {}
+
+        def mock_post(url, **kwargs):
+            captured['files'] = kwargs.get('files', [])
+            mock_resp = MagicMock()
+            mock_resp.status_code = 200
+            mock_resp.json.return_value = {'text': 'test', 'segments': []}
+            return mock_resp
+
+        connector.client.post = mock_post
+        req = make_request(language='fr')
+        connector.transcribe(req)
+
+        fields = {f[0]: f[1] for f in captured['files'] if f[0] != 'file'}
+        assert 'language' in fields
+        # Value is a tuple (None, 'fr') for multipart encoding
+        assert fields['language'] == (None, 'fr')
+    run_test("Language parameter is sent when provided", t2)
+
+    def t3():
+        """Hotwords are sent as individual context_bias fields."""
+        captured = {}
+
+        def mock_post(url, **kwargs):
+            captured['files'] = kwargs.get('files', [])
+            mock_resp = MagicMock()
+            mock_resp.status_code = 200
+            mock_resp.json.return_value = {'text': 'test', 'segments': []}
+            return mock_resp
+
+        connector.client.post = mock_post
+        req = make_request(hotwords='Speakr, Voxtral, Python')
+        connector.transcribe(req)
+
+        context_bias_fields = [(name, val) for name, val in captured['files'] if name == 'context_bias']
+        assert len(context_bias_fields) == 3, f"Expected 3 context_bias fields, got {len(context_bias_fields)}"
+    run_test("Hotwords are sent as individual context_bias fields", t3)
+
+    def t4():
+        """Model is always sent."""
+        captured = {}
+
+        def mock_post(url, **kwargs):
+            captured['files'] = kwargs.get('files', [])
+            mock_resp = MagicMock()
+            mock_resp.status_code = 200
+            mock_resp.json.return_value = {'text': 'test', 'segments': []}
+            return mock_resp
+
+        connector.client.post = mock_post
+        req = make_request()
+        connector.transcribe(req)
+
+        field_names = [f[0] for f in captured['files']]
+        assert 'model' in field_names
+    run_test("Model is always included in request", t4)
+
+    def t5():
+        """Prompt parameter is ignored (Mistral doesn't support it)."""
+        captured = {}
+
+        def mock_post(url, **kwargs):
+            captured['files'] = kwargs.get('files', [])
+            mock_resp = MagicMock()
+            mock_resp.status_code = 200
+            mock_resp.json.return_value = {'text': 'test', 'segments': []}
+            return mock_resp
+
+        connector.client.post = mock_post
+        req = make_request(prompt='This is a prompt')
+        connector.transcribe(req)
+
+        field_names = [f[0] for f in captured['files']]
+        assert 'prompt' not in field_names
+        assert 'initial_prompt' not in field_names
+    run_test("Prompt parameter is NOT sent to Mistral", t5)
+
+
+# =============================================================================
+# TEST SECTION 6: Response Parsing
+# =============================================================================
+
+def test_response_parsing():
+    """Test full response parsing from a mock Mistral API response."""
+    print("\n=== Testing Response Parsing ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+    from src.services.transcription.base import TranscriptionRequest
+
+    connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+
+    def t1():
+        """Full diarized response with speaker_id and score."""
+        mock_response = {
+            'text': 'Bonjour comment allez-vous? Très bien merci.',
+            'language': 'fr',
+            'segments': [
+                {'text': 'Bonjour comment allez-vous?', 'speaker_id': 'speaker_0', 'start': 0.0, 'end': 2.5, 'score': 0.95},
+                {'text': 'Très bien merci.', 'speaker_id': 'speaker_1', 'start': 2.5, 'end': 4.0, 'score': 0.88},
+            ],
+            'usage': {'prompt_tokens': 100, 'total_tokens': 100},
+        }
+
+        def mock_post(url, **kwargs):
+            resp = MagicMock()
+            resp.status_code = 200
+            resp.json.return_value = mock_response
+            return resp
+
+        connector.client.post = mock_post
+        req = TranscriptionRequest(audio_file=io.BytesIO(b'fake'), filename='test.wav', diarize=True)
+        result = connector.transcribe(req)
+
+        assert result.text == 'Bonjour comment allez-vous? Très bien merci.'
+        assert result.language == 'fr'
+        assert result.provider == 'mistral'
+        assert len(result.segments) == 2
+        assert result.segments[0].speaker == 'speaker_0'
+        assert result.segments[1].speaker == 'speaker_1'
+        assert result.segments[0].confidence == 0.95
+        assert result.speakers == ['speaker_0', 'speaker_1']
+    run_test("Full diarized response parsed correctly", t1)
+
+    def t2():
+        """Response without segments (plain text only)."""
+        mock_response = {
+            'text': 'Hello world',
+            'language': 'en',
+        }
+
+        def mock_post(url, **kwargs):
+            resp = MagicMock()
+            resp.status_code = 200
+            resp.json.return_value = mock_response
+            return resp
+
+        connector.client.post = mock_post
+        req = TranscriptionRequest(audio_file=io.BytesIO(b'fake'), filename='test.wav')
+        result = connector.transcribe(req)
+
+        assert result.text == 'Hello world'
+        assert result.segments == []
+        assert result.speakers is None
+    run_test("Plain text response (no segments) parsed correctly", t2)
+
+    def t3():
+        """has_diarization() returns True only when segments have speakers."""
+        mock_response = {
+            'text': 'Test',
+            'segments': [
+                {'text': 'Test', 'speaker_id': 'speaker_0', 'start': 0.0, 'end': 1.0},
+            ],
+        }
+
+        def mock_post(url, **kwargs):
+            resp = MagicMock()
+            resp.status_code = 200
+            resp.json.return_value = mock_response
+            return resp
+
+        connector.client.post = mock_post
+        req = TranscriptionRequest(audio_file=io.BytesIO(b'fake'), filename='test.wav', diarize=True)
+        result = connector.transcribe(req)
+        assert result.has_diarization() is True
+    run_test("has_diarization() returns True for diarized response", t3)
+
+
+# =============================================================================
+# TEST SECTION 7: Error Handling
+# =============================================================================
+
+def test_error_handling():
+    """Test error handling for API failures."""
+    print("\n=== Testing Error Handling ===")
+
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+    from src.services.transcription.base import TranscriptionRequest
+    from src.services.transcription.exceptions import ProviderError, TranscriptionError
+
+    connector = MistralTranscriptionConnector({'api_key': 'test-key'})
+
+    def t1():
+        """Non-200 response raises ProviderError."""
+        def mock_post(url, **kwargs):
+            resp = MagicMock()
+            resp.status_code = 422
+            resp.text = '{"detail": "Invalid request"}'
+            resp.json.return_value = {'detail': 'Invalid request'}
+            return resp
+
+        connector.client.post = mock_post
+        req = TranscriptionRequest(audio_file=io.BytesIO(b'fake'), filename='test.wav')
+
+        try:
+            connector.transcribe(req)
+            assert False, "Should have raised ProviderError"
+        except ProviderError as e:
+            assert e.provider == 'mistral'
+            assert e.status_code == 422
+    run_test("API 422 error raises ProviderError with details", t1)
+
+    def t2():
+        """Timeout raises TranscriptionError."""
+        import httpx
+
+        def mock_post(url, **kwargs):
+            raise httpx.TimeoutException("Connection timed out")
+
+        connector.client.post = mock_post
+        req = TranscriptionRequest(audio_file=io.BytesIO(b'fake'), filename='test.wav')
+
+        try:
+            connector.transcribe(req)
+            assert False, "Should have raised TranscriptionError"
+        except TranscriptionError as e:
+            assert 'timed out' in str(e)
+    run_test("Timeout raises TranscriptionError", t2)
+
+    def t3():
+        """Health check returns True with valid api_key."""
+        connector2 = MistralTranscriptionConnector({'api_key': 'valid-key'})
+        assert connector2.health_check() is True
+    run_test("health_check() returns True with valid key", t3)
+
+    def t4():
+        """Health check returns False with empty api_key (if bypassing validation)."""
+        # Directly set empty key to test health_check logic
+        connector2 = MistralTranscriptionConnector.__new__(MistralTranscriptionConnector)
+        connector2.config = {'api_key': ''}
+        assert connector2.health_check() is False
+    run_test("health_check() returns False with empty key", t4)
+
+
+# =============================================================================
+# TEST SECTION 8: Registry Integration
+# =============================================================================
+
+def test_registry_integration():
+    """Test that Mistral connector is properly registered."""
+    print("\n=== Testing Registry Integration ===")
+
+    def clear_env():
+        keys = [
+            'TRANSCRIPTION_CONNECTOR', 'TRANSCRIPTION_API_KEY', 'TRANSCRIPTION_BASE_URL',
+            'TRANSCRIPTION_MODEL', 'USE_ASR_ENDPOINT', 'ASR_BASE_URL',
+        ]
+        for key in keys:
+            os.environ.pop(key, None)
+
+    def reset_registry():
+        from src.services.transcription import registry
+        registry._registry = None
+        registry.ConnectorRegistry._instance = None
+        registry.ConnectorRegistry._initialized = False
+        registry.ConnectorRegistry._active_connector = None
+        registry.ConnectorRegistry._connector_name = ""
+
+    from src.services.transcription.registry import get_registry
+
+    def t1():
+        clear_env()
+        reset_registry()
+        registry = get_registry()
+        connectors = registry.list_connectors()
+        names = [c['name'] for c in connectors]
+        assert 'mistral' in names, f"'mistral' not in registered connectors: {names}"
+    run_test("Mistral connector is registered in registry", t1)
+
+    def t2():
+        clear_env()
+        reset_registry()
+        registry = get_registry()
+        connectors = registry.list_connectors()
+        mistral = next(c for c in connectors if c['name'] == 'mistral')
+        assert 'DIARIZATION' in mistral['capabilities']
+        assert 'TIMESTAMPS' in mistral['capabilities']
+        assert 'LANGUAGE_DETECTION' in mistral['capabilities']
+    run_test("Mistral connector info shows correct capabilities", t2)
+
+    def t3():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_CONNECTOR'] = 'mistral'
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        registry = get_registry()
+        registry.initialize_from_env()
+        assert registry.get_active_connector_name() == 'mistral'
+    run_test("TRANSCRIPTION_CONNECTOR=mistral activates Mistral connector", t3)
+
+    def t4():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_CONNECTOR'] = 'mistral'
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['TRANSCRIPTION_MODEL'] = 'voxtral-mini-2602'
+        registry = get_registry()
+        connector = registry.initialize_from_env()
+        assert connector.model == 'voxtral-mini-2602'
+    run_test("Custom model name is passed to connector", t4)
+
+    def t5():
+        clear_env()
+        reset_registry()
+        os.environ['TRANSCRIPTION_CONNECTOR'] = 'mistral'
+        os.environ['TRANSCRIPTION_API_KEY'] = 'test-key'
+        os.environ['TRANSCRIPTION_BASE_URL'] = 'https://custom.endpoint.com  # comment'
+        registry = get_registry()
+        connector = registry.initialize_from_env()
+        assert connector.base_url == 'https://custom.endpoint.com'
+    run_test("Trailing comment stripped from TRANSCRIPTION_BASE_URL", t5)
+
+    # Cleanup
+    clear_env()
+
+
+# =============================================================================
+# TEST SECTION 9: Chunking Behavior
+# =============================================================================
+
+def test_chunking_behavior():
+    """Test that Mistral connector specs correctly prevent app-level chunking."""
+    print("\n=== Testing Chunking Behavior ===")
+
+    from src.audio_chunking import get_effective_chunking_config
+    from src.services.transcription.connectors.mistral import MistralTranscriptionConnector
+
+    def t1():
+        os.environ['ENABLE_CHUNKING'] = 'true'
+        os.environ['CHUNK_LIMIT'] = '20MB'
+        config = get_effective_chunking_config(MistralTranscriptionConnector.SPECIFICATIONS)
+        assert config.enabled is False, f"Chunking should be disabled for Mistral but got enabled={config.enabled}"
+        assert config.source == 'connector_internal'
+        os.environ.pop('ENABLE_CHUNKING', None)
+        os.environ.pop('CHUNK_LIMIT', None)
+    run_test("Mistral specs disable app-level chunking", t1)
+
+    def t2():
+        # MISTRAL_ENABLE_CHUNKING=true should opt the connector into app-side chunking.
+        os.environ['MISTRAL_ENABLE_CHUNKING'] = 'true'
+        os.environ['MISTRAL_MAX_DURATION_SECONDS'] = '3600'
+        try:
+            connector = MistralTranscriptionConnector({'api_key': 'test'})
+            specs = connector.SPECIFICATIONS
+            assert specs.handles_chunking_internally is False, \
+                f"Chunking should be opt-in but got handles_chunking_internally={specs.handles_chunking_internally}"
+            assert specs.max_duration_seconds == 3600, f"got max_duration_seconds={specs.max_duration_seconds}"
+            # 80% of max duration as the recommended chunk size.
+            assert specs.recommended_chunk_seconds == 2880, \
+                f"got recommended_chunk_seconds={specs.recommended_chunk_seconds}"
+        finally:
+            os.environ.pop('MISTRAL_ENABLE_CHUNKING', None)
+            os.environ.pop('MISTRAL_MAX_DURATION_SECONDS', None)
+    run_test("MISTRAL_ENABLE_CHUNKING=true opts in to app-side chunking", t2)
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def main():
+    global PASSED, FAILED, ERRORS
+
+    print("=" * 60)
+    print("Mistral/Voxtral Transcription Connector Tests")
+    print("=" * 60)
+
+    test_initialization()
+    test_capabilities()
+    test_segment_parsing()
+    test_hotwords_splitting()
+    test_request_building()
+    test_response_parsing()
+    test_error_handling()
+    test_registry_integration()
+    test_chunking_behavior()
+
+    print("\n" + "=" * 60)
+    print(f"RESULTS: {PASSED} passed, {FAILED} failed")
+    print("=" * 60)
+
+    if ERRORS:
+        print("\nFailed tests:")
+        for name, error in ERRORS:
+            print(f"  - {name}: {error}")
+
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
diff --git a/tests/test_open_redirect.py b/tests/test_open_redirect.py
new file mode 100644
index 00000000..741e6b04
--- /dev/null
+++ b/tests/test_open_redirect.py
@@ -0,0 +1,74 @@
+"""Regression tests for the open-redirect class in is_safe_url.
+
+The original implementation validated ``urljoin(host_url, target)`` while
+``redirect()`` was called with the raw ``target``. A scheme-relative input
+such as ``////evil.com`` looked safe to the validator (urljoin resolves it
+to a same-host path) but the browser, given the raw value in the Location
+header, treats it as a network-path redirect to ``evil.com``.
+
+The current validator only allows local relative paths, so the same raw
+value flows through both the safety check and the redirect call.
+"""
+
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.utils.security import is_safe_url
+
+
+def test_rejects_scheme_relative_redirect():
+    assert is_safe_url('//evil.com') is False
+    assert is_safe_url('////evil.com') is False
+    assert is_safe_url('//evil.com/path') is False
+
+
+def test_rejects_absolute_url():
+    assert is_safe_url('http://evil.com/login') is False
+    assert is_safe_url('https://evil.com/login') is False
+    assert is_safe_url('javascript:alert(1)') is False
+    assert is_safe_url('data:text/html,<script>') is False
+
+
+def test_rejects_backslash_variants():
+    assert is_safe_url('/\\evil.com') is False
+    assert is_safe_url('\\\\evil.com') is False
+    assert is_safe_url('/path\\evil.com') is False
+
+
+def test_rejects_empty_or_non_string():
+    assert is_safe_url(None) is False
+    assert is_safe_url('') is False
+    assert is_safe_url(b'/path') is False
+    assert is_safe_url(123) is False
+
+
+def test_rejects_relative_paths_without_leading_slash():
+    assert is_safe_url('recordings/123') is False
+    assert is_safe_url('account') is False
+
+
+def test_rejects_control_characters():
+    assert is_safe_url('/path\nLocation: http://evil.com') is False
+    assert is_safe_url('/path\r\nX-Injected: 1') is False
+    assert is_safe_url('/path\x00') is False
+
+
+def test_accepts_local_paths():
+    assert is_safe_url('/') is True
+    assert is_safe_url('/recordings') is True
+    assert is_safe_url('/recordings/123') is True
+    assert is_safe_url('/account?tab=preferences') is True
+    assert is_safe_url('/recordings#section') is True
+
+
+if __name__ == '__main__':
+    test_rejects_scheme_relative_redirect()
+    test_rejects_absolute_url()
+    test_rejects_backslash_variants()
+    test_rejects_empty_or_non_string()
+    test_rejects_relative_paths_without_leading_slash()
+    test_rejects_control_characters()
+    test_accepts_local_paths()
+    print('All open-redirect regression tests passed.')
diff --git a/tests/test_postgres_migrations.py b/tests/test_postgres_migrations.py
new file mode 100644
index 00000000..7ea39d27
--- /dev/null
+++ b/tests/test_postgres_migrations.py
@@ -0,0 +1,165 @@
+"""
+Integration test for database migrations against a real database engine.
+
+Runs initialize_database() and verifies that all tables and critical columns
+are created successfully. Works with both SQLite (default, for local runs)
+and PostgreSQL (when TEST_DATABASE_URI env var is set).
+
+IMPORTANT: This test uses TEST_DATABASE_URI (not SQLALCHEMY_DATABASE_URI) to
+avoid accidentally connecting to and destroying a real application database.
+
+Usage:
+    # Local (SQLite in-memory, safe):
+    python tests/test_postgres_migrations.py
+
+    # Against PostgreSQL (CI or explicit testing):
+    TEST_DATABASE_URI=postgresql://user:pass@localhost:5432/testdb \
+        python tests/test_postgres_migrations.py
+"""
+
+import os
+import sys
+import unittest
+
+# Ensure project root is on the path
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
+
+from flask import Flask
+from src.database import db
+# Importing models registers them with SQLAlchemy so create_all() builds all tables
+import src.models  # noqa: F401
+from src.init_db import initialize_database
+
+
+def create_test_app():
+    """Create a minimal Flask app for testing database operations.
+
+    Uses TEST_DATABASE_URI env var (NOT SQLALCHEMY_DATABASE_URI) to prevent
+    accidental connection to production/dev databases.
+    """
+    app = Flask(__name__)
+    app.config['SQLALCHEMY_DATABASE_URI'] = os.environ.get(
+        'TEST_DATABASE_URI', 'sqlite://'  # in-memory SQLite by default
+    )
+    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
+    app.config['TESTING'] = True
+    db.init_app(app)
+    return app
+
+
+class TestDatabaseMigrations(unittest.TestCase):
+    """Test that initialize_database() runs cleanly against the configured DB engine."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.app = create_test_app()
+        with cls.app.app_context():
+            initialize_database(cls.app)
+
+    @classmethod
+    def tearDownClass(cls):
+        with cls.app.app_context():
+            # Use raw DROP to avoid circular FK dependency errors in SQLAlchemy's
+            # drop_all() (user <-> naming_template have mutual foreign keys)
+            from sqlalchemy import inspect, text
+            tables = inspect(db.engine).get_table_names()
+            with db.engine.connect() as conn:
+                if db.engine.name == 'postgresql':
+                    for table in tables:
+                        conn.execute(text(f'DROP TABLE IF EXISTS "{table}" CASCADE'))
+                else:
+                    conn.execute(text('PRAGMA foreign_keys = OFF'))
+                    for table in tables:
+                        conn.execute(text(f'DROP TABLE IF EXISTS "{table}"'))
+                    conn.execute(text('PRAGMA foreign_keys = ON'))
+                conn.commit()
+
+    def _get_table_names(self):
+        from sqlalchemy import inspect
+        inspector = inspect(db.engine)
+        return inspector.get_table_names()
+
+    def _get_column_names(self, table):
+        from sqlalchemy import inspect
+        inspector = inspect(db.engine)
+        return [col['name'] for col in inspector.get_columns(table)]
+
+    def test_core_tables_exist(self):
+        """Verify that all core tables were created."""
+        with self.app.app_context():
+            tables = self._get_table_names()
+            expected_tables = [
+                'user', 'recording', 'transcript_chunk', 'tag',
+                'folder', 'share', 'internal_share', 'system_setting',
+                'speaker', 'processing_job', 'group', 'group_membership',
+            ]
+            for table in expected_tables:
+                self.assertIn(table, tables, f"Missing table: {table}")
+
+    def test_user_migration_columns(self):
+        """Verify columns added by migrations exist on the user table."""
+        with self.app.app_context():
+            columns = self._get_column_names('user')
+            expected = [
+                'id', 'username', 'email', 'password',
+                'transcription_language', 'output_language', 'ui_language',
+                'summary_prompt', 'extract_events', 'name', 'job_title',
+                'company', 'diarize', 'sso_provider', 'sso_subject',
+                'can_share_publicly', 'monthly_token_budget',
+                'monthly_transcription_budget', 'email_verified',
+                'auto_speaker_labelling', 'auto_summarization',
+            ]
+            for col in expected:
+                self.assertIn(col, columns, f"Missing user column: {col}")
+
+    def test_recording_migration_columns(self):
+        """Verify columns added by migrations exist on the recording table."""
+        with self.app.app_context():
+            columns = self._get_column_names('recording')
+            expected = [
+                'id', 'is_inbox', 'is_highlighted', 'mime_type',
+                'completed_at', 'processing_time_seconds', 'error_message',
+                'folder_id', 'audio_deleted_at', 'deletion_exempt',
+                'speaker_embeddings',
+            ]
+            for col in expected:
+                self.assertIn(col, columns, f"Missing recording column: {col}")
+
+    def test_tag_migration_columns(self):
+        """Verify columns added by migrations exist on the tag table."""
+        with self.app.app_context():
+            columns = self._get_column_names('tag')
+            expected = [
+                'id', 'protect_from_deletion', 'group_id',
+                'retention_days', 'auto_share_on_apply',
+                'naming_template_id', 'export_template_id',
+            ]
+            for col in expected:
+                self.assertIn(col, columns, f"Missing tag column: {col}")
+
+    def test_system_settings_initialized(self):
+        """Verify that default system settings were created."""
+        with self.app.app_context():
+            from src.models import SystemSetting
+            expected_keys = [
+                'transcript_length_limit', 'max_file_size_mb',
+                'asr_timeout_seconds', 'disable_auto_summarization',
+                'enable_folders',
+            ]
+            for key in expected_keys:
+                setting = SystemSetting.query.filter_by(key=key).first()
+                self.assertIsNotNone(setting, f"Missing system setting: {key}")
+
+    def test_engine_type_matches_expectation(self):
+        """Sanity check: confirm we're testing against the expected engine."""
+        with self.app.app_context():
+            uri = self.app.config['SQLALCHEMY_DATABASE_URI']
+            engine_name = db.engine.name
+            if uri.startswith('postgresql'):
+                self.assertEqual(engine_name, 'postgresql')
+            else:
+                self.assertEqual(engine_name, 'sqlite')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/test_prompt_variables.py b/tests/test_prompt_variables.py
new file mode 100644
index 00000000..4f4d84d3
--- /dev/null
+++ b/tests/test_prompt_variables.py
@@ -0,0 +1,177 @@
+"""
+Tests for the prompt-template variable utility.
+
+These cover the public surface: extract, substitute, infer_label, and the
+sanitise step that gates user input before it lands in the database.
+"""
+
+import pytest
+
+from src.utils.prompt_variables import (
+    extract_template_variables,
+    substitute_template_variables,
+    infer_label,
+    sanitize_variable_values,
+    MAX_VARIABLES,
+    MAX_VALUE_CHARS,
+    MAX_TOTAL_CHARS,
+)
+
+
+# ---------------------------------------------------------------------------
+# extract_template_variables
+# ---------------------------------------------------------------------------
+
+def test_extract_returns_unique_in_first_seen_order():
+    assert extract_template_variables('Hi {{name}}, {{agenda}} and again {{name}}') == ['name', 'agenda']
+
+
+def test_extract_tolerates_whitespace_inside_braces():
+    assert extract_template_variables('{{ name }} and {{  agenda  }}') == ['name', 'agenda']
+
+
+def test_extract_ignores_text_without_placeholders():
+    assert extract_template_variables('plain text without variables') == []
+
+
+def test_extract_handles_empty_input():
+    assert extract_template_variables('') == []
+    assert extract_template_variables(None) == []
+    assert extract_template_variables(123) == []
+
+
+def test_extract_does_not_match_single_braces():
+    assert extract_template_variables('this {is not} a placeholder') == []
+
+
+def test_extract_rejects_invalid_identifier_starts():
+    # Numeric-leading identifiers must not match
+    assert extract_template_variables('hi {{1bad}}') == []
+
+
+# ---------------------------------------------------------------------------
+# substitute_template_variables
+# ---------------------------------------------------------------------------
+
+def test_substitute_replaces_known_keys():
+    assert substitute_template_variables('Hi {{name}}', {'name': 'Anna'}) == 'Hi Anna'
+
+
+def test_substitute_uses_empty_string_for_missing_keys():
+    assert substitute_template_variables('Hi {{name}}', {}) == 'Hi '
+
+
+def test_substitute_coerces_non_string_values():
+    assert substitute_template_variables('count {{n}}', {'n': 42}) == 'count 42'
+
+
+def test_substitute_passes_html_unchanged_to_caller():
+    # The substitution layer is text-only; XSS sanitisation is a downstream
+    # concern of the summary renderer, not the variable substituter.
+    raw = substitute_template_variables('hi {{x}}', {'x': '<script>alert(1)</script>'})
+    assert raw == 'hi <script>alert(1)</script>'
+
+
+def test_substitute_no_template_engine_invocation():
+    # Even a value that looks like Python format-string mischief is treated as
+    # plain text on the value side.
+    out = substitute_template_variables('A {{x}} B', {'x': '{0.__class__.__bases__}'})
+    assert out == 'A {0.__class__.__bases__} B'
+
+
+def test_substitute_handles_empty_input():
+    assert substitute_template_variables('', {'x': 'y'}) == ''
+    assert substitute_template_variables(None, {'x': 'y'}) is None
+
+
+def test_substitute_with_non_dict_values_treated_as_empty():
+    assert substitute_template_variables('Hi {{name}}', None) == 'Hi '
+    assert substitute_template_variables('Hi {{name}}', 'not-a-dict') == 'Hi '
+
+
+# ---------------------------------------------------------------------------
+# infer_label
+# ---------------------------------------------------------------------------
+
+def test_infer_label_basic_cases():
+    assert infer_label('agenda') == 'Agenda'
+    assert infer_label('meeting_date') == 'Meeting date'
+    assert infer_label('whoIsHere') == 'WhoIsHere'
+
+
+def test_infer_label_handles_empty():
+    assert infer_label('') == ''
+    assert infer_label(None) == ''
+
+
+# ---------------------------------------------------------------------------
+# sanitize_variable_values
+# ---------------------------------------------------------------------------
+
+def test_sanitize_strips_invalid_keys():
+    cleaned = sanitize_variable_values({
+        'good': 'value',
+        '1bad': 'starts with digit',
+        'has space': 'no spaces',
+        'with-dash': 'no dashes',
+    })
+    assert cleaned == {'good': 'value'}
+
+
+def test_sanitize_drops_empty_and_whitespace_values():
+    assert sanitize_variable_values({'a': '', 'b': '   ', 'c': 'real'}) == {'c': 'real'}
+
+
+def test_sanitize_returns_none_for_empty_result():
+    assert sanitize_variable_values({}) is None
+    assert sanitize_variable_values({'a': ''}) is None
+
+
+def test_sanitize_returns_none_for_non_dict_input():
+    assert sanitize_variable_values(['a', 'b']) is None
+    assert sanitize_variable_values('hello') is None
+    assert sanitize_variable_values(None) is None
+
+
+def test_sanitize_strips_control_characters():
+    cleaned = sanitize_variable_values({'k': 'hello\x00\x01\x02world'})
+    assert cleaned == {'k': 'helloworld'}
+
+
+def test_sanitize_preserves_common_whitespace():
+    cleaned = sanitize_variable_values({'k': 'line1\nline2\ttabbed'})
+    assert cleaned == {'k': 'line1\nline2\ttabbed'}
+
+
+def test_sanitize_caps_variable_count():
+    raw = {f'k{i}': 'v' for i in range(MAX_VARIABLES + 20)}
+    cleaned = sanitize_variable_values(raw)
+    assert len(cleaned) == MAX_VARIABLES
+
+
+def test_sanitize_caps_value_length():
+    cleaned = sanitize_variable_values({'k': 'A' * (MAX_VALUE_CHARS + 1000)})
+    assert len(cleaned['k']) == MAX_VALUE_CHARS
+
+
+def test_sanitize_caps_total_size():
+    big_value = 'A' * 4000
+    raw = {f'k{i}': big_value for i in range(20)}
+    cleaned = sanitize_variable_values(raw)
+    total = sum(len(v) for v in cleaned.values())
+    assert total <= MAX_TOTAL_CHARS
+
+
+def test_sanitize_coerces_non_string_values():
+    cleaned = sanitize_variable_values({'count': 42, 'flag': True})
+    assert cleaned == {'count': '42', 'flag': 'True'}
+
+
+def test_sanitize_dunder_keys_are_safe_lookups():
+    # __class__ is allowed by the identifier regex but the substitution path
+    # is a plain dict lookup with no code execution. Verify the value is
+    # returned verbatim.
+    cleaned = sanitize_variable_values({'__class__': 'value'})
+    assert cleaned == {'__class__': 'value'}
+    out = substitute_template_variables('a {{__class__}} b', cleaned)
+    assert out == 'a value b'
diff --git a/tests/test_prompt_variables_integration.py b/tests/test_prompt_variables_integration.py
new file mode 100644
index 00000000..0c1e861c
--- /dev/null
+++ b/tests/test_prompt_variables_integration.py
@@ -0,0 +1,143 @@
+"""
+Integration test for prompt variable substitution in the summary task.
+
+Exercises `generate_summary_only_task` end to end (with the LLM client
+patched out) and asserts that:
+
+1. Variables in the resolved tag/folder/user/admin prompt are substituted.
+2. Variables appearing in the appended `custom_prompt_override` (issue #253
+   append mode) are also substituted, since substitution must happen on the
+   final composed prompt rather than on the resolved chain only.
+
+A regression of the substitution order (substituting before append) would
+produce a final prompt with literal `{{quarter}}` left in the appended
+section. This test catches that.
+"""
+
+import pytest
+from unittest.mock import patch, MagicMock
+
+
+@pytest.fixture
+def app_with_db():
+    """Provide a Flask app context with a clean recording + tag."""
+    from src.app import app, db
+    from src.models import User, Recording, Tag
+
+    with app.app_context():
+        user = User.query.filter_by(username="prompt_var_test_user").first()
+        created_user = False
+        if not user:
+            user = User(username="prompt_var_test_user", email="prompt_var_test@local.test")
+            user.password = "unused"
+            db.session.add(user)
+            db.session.commit()
+            created_user = True
+
+        tag = Tag(
+            name=f"prompt_var_test_tag_{user.id}",
+            user_id=user.id,
+            color="#000000",
+            custom_prompt="Generate minutes for {{agenda}}.",
+        )
+        db.session.add(tag)
+        db.session.commit()
+
+        recording = Recording(
+            user_id=user.id,
+            title="Prompt Variable Test",
+            original_filename="test_prompt_vars.wav",
+            transcription='Hello world. This is a long enough transcription to satisfy the length check.',
+            status="COMPLETED",
+            prompt_variables={"agenda": "Budget review", "quarter": "Q3"},
+        )
+        db.session.add(recording)
+        db.session.commit()
+
+        # Apply tag to recording
+        from src.models import RecordingTag
+        rt = RecordingTag(recording_id=recording.id, tag_id=tag.id, order=1)
+        db.session.add(rt)
+        db.session.commit()
+
+        try:
+            yield app, db, user, recording, tag, created_user
+        finally:
+            try:
+                from src.models import RecordingTag
+                RecordingTag.query.filter_by(recording_id=recording.id).delete()
+                db.session.delete(recording)
+                db.session.delete(tag)
+                if created_user:
+                    db.session.delete(user)
+                db.session.commit()
+            except Exception:
+                db.session.rollback()
+
+
+def _capture_summary_prompt(app):
+    """Patch `call_llm_completion` and return a holder that captures the
+    user-message content of the first call. The mock returns a stub
+    completion that yields a one-line summary so the task completes
+    without further side-effects."""
+    captured = {"user_prompt": None}
+
+    def _fake_completion(messages=None, **kwargs):
+        for msg in messages or []:
+            if msg.get("role") == "user":
+                captured["user_prompt"] = msg.get("content", "")
+                break
+        stub = MagicMock()
+        stub.choices = [MagicMock()]
+        stub.choices[0].message.content = "Test summary."
+        stub.usage = MagicMock()
+        stub.usage.prompt_tokens = 1
+        stub.usage.completion_tokens = 1
+        stub.usage.total_tokens = 2
+        return stub
+
+    return captured, _fake_completion
+
+
+def test_variables_substitute_in_resolved_prompt(app_with_db):
+    """A `{{name}}` in a tag's custom_prompt is replaced with the recording's stored value."""
+    app, db, user, recording, tag, created_user = app_with_db
+    from src.tasks.processing import generate_summary_only_task
+
+    captured, fake_completion = _capture_summary_prompt(app)
+    with patch("src.tasks.processing.call_llm_completion", side_effect=fake_completion), \
+         patch("src.tasks.processing.client", new=MagicMock()):
+        generate_summary_only_task(app.app_context(), recording.id, user_id=user.id)
+
+    prompt = captured["user_prompt"] or ""
+    assert "Budget review" in prompt, f"agenda value missing from prompt: {prompt[:500]}"
+    assert "{{agenda}}" not in prompt, f"placeholder leaked into prompt: {prompt[:500]}"
+
+
+def test_variables_substitute_in_appended_custom_prompt(app_with_db):
+    """A `{{name}}` in `custom_prompt_override` (append mode) is also substituted.
+
+    This is the regression test for the order-of-operations bug where the
+    substitution step ran before the append step, leaving placeholders in
+    the appended text intact.
+    """
+    app, db, user, recording, tag, created_user = app_with_db
+    from src.tasks.processing import generate_summary_only_task
+
+    captured, fake_completion = _capture_summary_prompt(app)
+    with patch("src.tasks.processing.call_llm_completion", side_effect=fake_completion), \
+         patch("src.tasks.processing.client", new=MagicMock()):
+        generate_summary_only_task(
+            app.app_context(),
+            recording.id,
+            custom_prompt_override="Also discuss strategic priorities for {{quarter}}.",
+            custom_prompt_append=True,
+            user_id=user.id,
+        )
+
+    prompt = captured["user_prompt"] or ""
+    # Both the resolved-chain variable and the append-text variable must substitute.
+    assert "Budget review" in prompt, f"agenda value missing: {prompt[:500]}"
+    assert "Q3" in prompt, f"quarter value (from append text) missing: {prompt[:500]}"
+    assert "{{agenda}}" not in prompt, f"agenda placeholder leaked: {prompt[:500]}"
+    assert "{{quarter}}" not in prompt, f"quarter placeholder leaked from append text: {prompt[:500]}"
diff --git a/tests/test_reprocess_hotwords.py b/tests/test_reprocess_hotwords.py
new file mode 100644
index 00000000..93561f42
--- /dev/null
+++ b/tests/test_reprocess_hotwords.py
@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+"""
+Regression test for issue #265: Reprocess transcription does not apply
+tag/folder/user default hotwords or initial_prompt.
+
+Asserts that the reprocess endpoint, given an empty request body, walks the
+same precedence chain that upload_file() uses:
+    user input > tag defaults > folder defaults > user defaults
+
+The test patches job_queue.enqueue() to capture the params dict that would be
+sent to the worker.
+
+Run with: docker exec speakr-dev python /app/tests/test_reprocess_hotwords.py
+"""
+
+import json
+import sys
+import uuid
+from pathlib import Path
+from unittest.mock import patch
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from src.app import app, db
+from src.models import User, Recording
+from src.models.organization import Tag, Folder, RecordingTag
+
+# CSRF tokens are scoped to interactive sessions. Disable for the test client.
+app.config["WTF_CSRF_ENABLED"] = False
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+def setup_recording(*, owner_hotwords=None, owner_prompt=None,
+                    tag_hotwords=None, tag_prompt=None,
+                    folder_hotwords=None, folder_prompt=None):
+    """Create a user, recording, optional tag, optional folder, and any default values."""
+    suffix = uuid.uuid4().hex[:10]
+    user = User(
+        username=f"reprocess_test_{suffix}",
+        email=f"reprocess_test_{suffix}@test.local",
+        password="x",  # column is just a hash string; auth isn't exercised in this test
+    )
+    user.transcription_hotwords = owner_hotwords
+    user.transcription_initial_prompt = owner_prompt
+    db.session.add(user)
+    db.session.flush()
+
+    folder = None
+    if folder_hotwords or folder_prompt:
+        folder = Folder(
+            name=f"f_{user.id}",
+            user_id=user.id,
+            default_hotwords=folder_hotwords,
+            default_initial_prompt=folder_prompt,
+        )
+        db.session.add(folder)
+        db.session.flush()
+
+    rec = Recording(
+        audio_path="/tmp/dummy.wav",
+        original_filename="dummy.wav",
+        title="test",
+        status="COMPLETED",
+        user_id=user.id,
+        folder_id=folder.id if folder else None,
+    )
+    db.session.add(rec)
+    db.session.flush()
+
+    if tag_hotwords or tag_prompt:
+        tag = Tag(
+            name=f"t_{user.id}",
+            user_id=user.id,
+            default_hotwords=tag_hotwords,
+            default_initial_prompt=tag_prompt,
+        )
+        db.session.add(tag)
+        db.session.flush()
+        db.session.add(RecordingTag(recording_id=rec.id, tag_id=tag.id, order=1))
+        db.session.flush()
+
+    db.session.commit()
+    return user, rec
+
+
+def call_reprocess(client, recording_id, body):
+    """POST to the reprocess endpoint and capture the job_params."""
+    from src.services import job_queue as jq_module
+
+    captured = {}
+
+    def fake_enqueue(*args, **kwargs):
+        captured.update(kwargs)
+        return 999
+
+    original = jq_module.job_queue.enqueue
+    jq_module.job_queue.enqueue = fake_enqueue
+    try:
+        with patch("src.api.recordings.os.path.exists", return_value=True):
+            resp = client.post(
+                f"/recording/{recording_id}/reprocess_transcription",
+                data=json.dumps(body),
+                content_type="application/json",
+            )
+    finally:
+        jq_module.job_queue.enqueue = original
+    return resp, captured.get("params", {})
+
+
+def login_client(client, user):
+    """Log in via the test client by writing the session cookie directly."""
+    with client.session_transaction() as sess:
+        sess["_user_id"] = str(user.id)
+        sess["_fresh"] = True
+
+
+def test_user_input_wins():
+    """Explicit hotwords/initial_prompt in the request body take priority over all defaults."""
+    with app.app_context():
+        user, rec = setup_recording(
+            owner_hotwords="user_hot", owner_prompt="user_prompt",
+            tag_hotwords="tag_hot", tag_prompt="tag_prompt",
+        )
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {
+            "hotwords": "explicit_hot",
+            "initial_prompt": "explicit_prompt",
+        })
+        assert resp.status_code in (200, 202), f"unexpected status {resp.status_code}: {resp.data!r}"
+        assert params.get("hotwords") == "explicit_hot", f"got {params!r}"
+        assert params.get("initial_prompt") == "explicit_prompt", f"got {params!r}"
+
+
+def test_tag_defaults_apply_when_no_user_input():
+    """Tag default_hotwords / default_initial_prompt apply when request body is empty."""
+    with app.app_context():
+        user, rec = setup_recording(
+            tag_hotwords="tag_hot", tag_prompt="tag_prompt",
+            folder_hotwords="folder_hot", folder_prompt="folder_prompt",
+            owner_hotwords="user_hot", owner_prompt="user_prompt",
+        )
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {})
+        assert resp.status_code in (200, 202), f"unexpected status {resp.status_code}: {resp.data!r}"
+        # Tag wins over folder and over user.  # noqa
+        assert params.get("hotwords") == "tag_hot", f"got {params!r}"
+        assert params.get("initial_prompt") == "tag_prompt", f"got {params!r}"
+
+
+def test_folder_defaults_apply_when_no_tag():
+    """Folder defaults apply when there's no tag override and no user input."""
+    with app.app_context():
+        user, rec = setup_recording(
+            folder_hotwords="folder_hot", folder_prompt="folder_prompt",
+            owner_hotwords="user_hot", owner_prompt="user_prompt",
+        )
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {})
+        assert resp.status_code in (200, 202)
+        # Folder wins over user, no tag in play.
+        assert params.get("hotwords") == "folder_hot", f"got {params!r}"
+        assert params.get("initial_prompt") == "folder_prompt", f"got {params!r}"
+
+
+def test_user_defaults_apply_as_last_resort():
+    """User account defaults apply when nothing else is set."""
+    with app.app_context():
+        user, rec = setup_recording(
+            owner_hotwords="user_hot", owner_prompt="user_prompt",
+        )
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {})
+        assert resp.status_code in (200, 202)
+        assert params.get("hotwords") == "user_hot", f"got {params!r}"
+        assert params.get("initial_prompt") == "user_prompt", f"got {params!r}"
+
+
+def test_empty_when_nothing_configured():
+    """No user input + no tag/folder/user defaults → params have None for both."""
+    with app.app_context():
+        user, rec = setup_recording()
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {})
+        assert resp.status_code in (200, 202)
+        assert params.get("hotwords") is None, f"got {params!r}"
+        assert params.get("initial_prompt") is None, f"got {params!r}"
+
+
+def cleanup_test_users():
+    """Remove every user created by this test file.
+
+    Tests run against the live dev database, so without an explicit teardown
+    the synthesised users would accumulate forever and pollute the admin
+    user-management screens.
+    """
+    with app.app_context():
+        for u in User.query.filter(User.username.like('reprocess_test_%')).all():
+            db.session.delete(u)
+        db.session.commit()
+
+
+def teardown_module(module):
+    """pytest auto-calls this after the last test in the module finishes.
+    Required because pytest does not invoke ``main()``, so the cleanup in
+    its ``finally`` block never runs under ``pytest tests/``."""
+    cleanup_test_users()
+
+
+def main():
+    print("=== Issue #265: reprocess hotwords/initial_prompt precedence ===\n")
+    try:
+        run("user input wins over all defaults", test_user_input_wins)
+        run("tag defaults apply when no user input", test_tag_defaults_apply_when_no_user_input)
+        run("folder defaults apply when no tag", test_folder_defaults_apply_when_no_tag)
+        run("user account defaults apply as last resort", test_user_defaults_apply_as_last_resort)
+        run("nothing configured → both None", test_empty_when_nothing_configured)
+    finally:
+        cleanup_test_users()
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_title_truncation.py b/tests/test_title_truncation.py
new file mode 100644
index 00000000..d585324a
--- /dev/null
+++ b/tests/test_title_truncation.py
@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+"""
+Regression test for issue #260: Title generation sends Unicode escape sequences
+(e.g. \\u0412...) instead of decoded Cyrillic characters.
+
+Root cause was that _generate_ai_title() sliced the raw transcription JSON
+*before* parsing it with json.loads(). When the slice cut a unicode escape
+mid-sequence, the parse failed and format_transcription_for_llm() returned the
+raw truncated text, with literal \\uXXXX escapes still in place. The title
+prompt then embedded those escape sequences directly.
+
+Fix: format the full transcription first, then truncate the formatted plain
+text. This test ensures the formatted output for a Cyrillic transcript with a
+small length limit contains decoded Cyrillic characters and no literal `\\u`
+escapes.
+
+Run with: docker exec speakr-dev python /app/tests/test_title_truncation.py
+"""
+
+import json
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from src.tasks.processing import format_transcription_for_llm
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+def make_cyrillic_transcript():
+    """Build an ASR-style JSON transcript stored with ensure_ascii=True (the default)."""
+    segments = [
+        {"speaker": "SPEAKER_00", "sentence": "Вобщем, давайте начнём встречу."},
+        {"speaker": "SPEAKER_01", "sentence": "Хорошо, я готов."},
+        {"speaker": "SPEAKER_00", "sentence": "Сегодня обсудим квартальный отчёт."},
+    ]
+    # ensure_ascii=True is Python's default. This is what's stored in the DB.
+    return json.dumps(segments, ensure_ascii=True)
+
+
+def test_full_transcript_decodes_cyrillic():
+    """format_transcription_for_llm() decodes \\uXXXX escapes when JSON is valid."""
+    raw = make_cyrillic_transcript()
+    out = format_transcription_for_llm(raw)
+    assert "Вобщем" in out, f"expected decoded Cyrillic, got: {out[:200]}"
+    assert "\\u" not in out, f"unexpected literal escape in output: {out[:200]}"
+
+
+def test_truncating_after_formatting_preserves_decoding():
+    """When we format first then slice, output is decoded Cyrillic — even at small limits."""
+    raw = make_cyrillic_transcript()
+    formatted = format_transcription_for_llm(raw)
+    # Truncate the *formatted* text (the new behavior).
+    truncated = formatted[:60]
+    assert "\\u" not in truncated, f"truncated output should not contain literal escapes: {truncated!r}"
+    # The first segment text should still be present (or at least its prefix).
+    assert any(ch in truncated for ch in "Вобщем"), f"expected Cyrillic prefix, got: {truncated!r}"
+
+
+def test_truncating_before_formatting_breaks_decoding():
+    """Reproduces the bug: slicing the raw JSON mid-escape breaks json.loads()."""
+    raw = make_cyrillic_transcript()
+    # Find a position partway through a \uXXXX escape so the slice is invalid JSON.
+    escape_idx = raw.find("\\u")
+    assert escape_idx > 0, "test setup: expected escape sequences in raw JSON"
+    # Cut 3 chars into the 6-char escape sequence (e.g. `\u04` instead of `В`).
+    bad_slice = raw[:escape_idx + 3]
+    out_bad = format_transcription_for_llm(bad_slice)
+    # The function falls back to returning the raw truncated text, which still
+    # contains literal escapes. This documents the old, buggy behavior.
+    assert "\\u" in out_bad, "expected literal escapes when JSON parse fails"
+
+
+def test_short_limit_does_not_leak_escapes_after_fix():
+    """End-to-end: even a tiny limit produces Cyrillic, not escape sequences."""
+    raw = make_cyrillic_transcript()
+    limit = 30  # very small — would have cut the raw JSON mid-escape
+    formatted = format_transcription_for_llm(raw)
+    transcript_text = formatted[:limit]
+    assert "\\u" not in transcript_text, f"unexpected escapes at small limit: {transcript_text!r}"
+
+
+def main():
+    print("=== Issue #260: Title truncation Unicode escape regression ===\n")
+    run("full transcript decodes Cyrillic", test_full_transcript_decodes_cyrillic)
+    run("truncating AFTER formatting preserves decoding", test_truncating_after_formatting_preserves_decoding)
+    run("truncating BEFORE formatting breaks decoding (documents bug)", test_truncating_before_formatting_breaks_decoding)
+    run("small limit produces clean text after fix", test_short_limit_does_not_leak_escapes_after_fix)
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_transcription_model_override.py b/tests/test_transcription_model_override.py
new file mode 100644
index 00000000..3a9a2bd3
--- /dev/null
+++ b/tests/test_transcription_model_override.py
@@ -0,0 +1,343 @@
+#!/usr/bin/env python3
+"""
+Tests for issue #266: per-upload, per-tag, per-folder transcription model
+selection.
+
+Validates:
+1. TRANSCRIPTION_MODEL_OPTIONS is parsed from env vars correctly.
+2. Reprocess endpoint resolves the precedence chain
+   (user input > tag default > folder default), validates against the
+   allowlist, and writes the model into job_params.
+3. The TranscriptionRequest dataclass carries `model` through to the
+   connector via _effective_model().
+4. Per-request model override falls back gracefully when the override is
+   blank or unsupported.
+
+Run with: docker exec speakr-dev python /app/tests/test_transcription_model_override.py
+"""
+
+import json
+import os
+import sys
+import uuid
+from pathlib import Path
+from unittest.mock import patch
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+# CSRF tokens are scoped to interactive sessions. Disable for the test client.
+from src.app import app, db
+app.config["WTF_CSRF_ENABLED"] = False
+
+from src.models import User, Recording
+from src.models.organization import Tag, Folder, RecordingTag
+from src.services.transcription.base import TranscriptionRequest
+from src.services.transcription.connectors.openai_whisper import (
+    OpenAIWhisperConnector,
+)
+
+
+PASSED = 0
+FAILED = 0
+
+
+def run(name, func):
+    global PASSED, FAILED
+    try:
+        func()
+        print(f"  ✓ {name}")
+        PASSED += 1
+    except AssertionError as e:
+        print(f"  ✗ {name}: {e}")
+        FAILED += 1
+    except Exception as e:
+        print(f"  ✗ {name}: EXCEPTION - {e}")
+        FAILED += 1
+
+
+# -----------------------------------------------------------------------------
+# Section 1: env-var → TRANSCRIPTION_MODEL_OPTIONS
+# -----------------------------------------------------------------------------
+
+def test_models_csv_parses_with_labels():
+    """TRANSCRIPTION_MODELS_AVAILABLE + TRANSCRIPTION_MODEL_LABELS pair correctly."""
+    # Reload the config module with env vars set.
+    import importlib
+    os.environ["TRANSCRIPTION_MODELS_AVAILABLE"] = "whisper-1, gpt-4o-transcribe ,vibevoice"
+    os.environ["TRANSCRIPTION_MODEL_LABELS"] = "Whisper,GPT-4o,VibeVoice"
+    try:
+        import src.config.app_config as cfg
+        importlib.reload(cfg)
+        assert cfg.TRANSCRIPTION_MODELS_AVAILABLE == [
+            "whisper-1", "gpt-4o-transcribe", "vibevoice"
+        ], cfg.TRANSCRIPTION_MODELS_AVAILABLE
+        assert cfg.TRANSCRIPTION_MODEL_OPTIONS == [
+            {"value": "whisper-1", "label": "Whisper"},
+            {"value": "gpt-4o-transcribe", "label": "GPT-4o"},
+            {"value": "vibevoice", "label": "VibeVoice"},
+        ], cfg.TRANSCRIPTION_MODEL_OPTIONS
+    finally:
+        os.environ.pop("TRANSCRIPTION_MODELS_AVAILABLE", None)
+        os.environ.pop("TRANSCRIPTION_MODEL_LABELS", None)
+        importlib.reload(cfg)
+
+
+def test_models_csv_unset_means_empty():
+    """When unset, TRANSCRIPTION_MODEL_OPTIONS is an empty list (dropdown hidden)."""
+    import importlib
+    os.environ.pop("TRANSCRIPTION_MODELS_AVAILABLE", None)
+    os.environ.pop("TRANSCRIPTION_MODEL_LABELS", None)
+    import src.config.app_config as cfg
+    importlib.reload(cfg)
+    assert cfg.TRANSCRIPTION_MODEL_OPTIONS == [], cfg.TRANSCRIPTION_MODEL_OPTIONS
+
+
+# -----------------------------------------------------------------------------
+# Section 2: reprocess endpoint precedence chain
+# -----------------------------------------------------------------------------
+
+def setup_recording(*, user_input=None, tag_model=None, folder_model=None,
+                    available_models=None):
+    """Build a Recording + Tag + Folder with the requested defaults.
+
+    Returns (user, recording, plain-text-token-for-test-client) where the
+    'token' is unused. Caller logs in via test_client session.
+    """
+    suffix = uuid.uuid4().hex[:10]
+    user = User(
+        username=f"models_{suffix}",
+        email=f"models_{suffix}@test.local",
+        password="x",
+    )
+    db.session.add(user)
+    db.session.flush()
+
+    folder = None
+    if folder_model:
+        folder = Folder(
+            name=f"f_{suffix}",
+            user_id=user.id,
+            default_transcription_model=folder_model,
+        )
+        db.session.add(folder)
+        db.session.flush()
+
+    rec = Recording(
+        audio_path="/tmp/dummy.wav",
+        original_filename="dummy.wav",
+        title="model test",
+        status="COMPLETED",
+        user_id=user.id,
+        folder_id=folder.id if folder else None,
+    )
+    db.session.add(rec)
+    db.session.flush()
+
+    if tag_model:
+        tag = Tag(
+            name=f"t_{suffix}",
+            user_id=user.id,
+            default_transcription_model=tag_model,
+        )
+        db.session.add(tag)
+        db.session.flush()
+        db.session.add(RecordingTag(recording_id=rec.id, tag_id=tag.id, order=1))
+        db.session.flush()
+
+    db.session.commit()
+    return user, rec
+
+
+def call_reprocess(client, recording_id, body, available_models=None,
+                   admin_default_model=None, admin_visible_models_json=None):
+    """POST to the reprocess endpoint and capture job_params.
+
+    By default this isolates the call from any admin-saved
+    ``transcription_default_model`` / ``transcription_models_visible_json``
+    SystemSetting rows that may exist in the dev DB. Tests that exercise the
+    admin-default path can pass values explicitly.
+    """
+    from src.services import job_queue as jq_module
+    from src.models import SystemSetting
+
+    captured = {}
+
+    def fake_enqueue(*args, **kwargs):
+        captured.update(kwargs)
+        return 999
+
+    real_get_setting = SystemSetting.get_setting
+
+    def fake_get_setting(key, default=None):
+        if key == 'transcription_default_model':
+            return admin_default_model if admin_default_model is not None else default
+        if key == 'transcription_models_visible_json':
+            return admin_visible_models_json if admin_visible_models_json is not None else default
+        return real_get_setting(key, default)
+
+    original_enqueue = jq_module.job_queue.enqueue
+    jq_module.job_queue.enqueue = fake_enqueue
+    try:
+        # Patch the allowlist used by the endpoint and the admin-saved
+        # SystemSetting lookups so the test does not pick up dev-DB state.
+        with patch("src.api.recordings.os.path.exists", return_value=True), \
+             patch("src.config.app_config.TRANSCRIPTION_MODELS_AVAILABLE",
+                   list(available_models) if available_models is not None else []), \
+             patch("src.api.recordings.SystemSetting.get_setting",
+                   side_effect=fake_get_setting):
+            resp = client.post(
+                f"/recording/{recording_id}/reprocess_transcription",
+                data=json.dumps(body),
+                content_type="application/json",
+            )
+    finally:
+        jq_module.job_queue.enqueue = original_enqueue
+    return resp, captured.get("params", {})
+
+
+def login_client(client, user):
+    with client.session_transaction() as sess:
+        sess["_user_id"] = str(user.id)
+        sess["_fresh"] = True
+
+
+def test_user_input_wins_over_defaults():
+    with app.app_context():
+        user, rec = setup_recording(tag_model="vibevoice", folder_model="whisper-1")
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id,
+                                       {"transcription_model": "gpt-4o-transcribe"},
+                                       available_models=["gpt-4o-transcribe", "vibevoice", "whisper-1"])
+        assert resp.status_code in (200, 202), f"unexpected status {resp.status_code}: {resp.data!r}"
+        assert params.get("transcription_model") == "gpt-4o-transcribe", f"got {params!r}"
+
+
+def test_tag_default_applied_when_no_user_input():
+    with app.app_context():
+        user, rec = setup_recording(tag_model="vibevoice", folder_model="whisper-1")
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {},
+                                       available_models=["whisper-1", "vibevoice"])
+        assert resp.status_code in (200, 202), f"unexpected status {resp.status_code}: {resp.data!r}"
+        # Tag wins over folder.
+        assert params.get("transcription_model") == "vibevoice", f"got {params!r}"
+
+
+def test_folder_default_applied_when_no_tag():
+    with app.app_context():
+        user, rec = setup_recording(folder_model="whisper-1")
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {},
+                                       available_models=["whisper-1", "vibevoice"])
+        assert resp.status_code in (200, 202)
+        assert params.get("transcription_model") == "whisper-1", f"got {params!r}"
+
+
+def test_user_supplied_model_outside_allowlist_dropped():
+    """An explicit override that isn't in the allowlist gets stripped."""
+    with app.app_context():
+        user, rec = setup_recording(tag_model="vibevoice")
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id,
+                                       {"transcription_model": "secret-internal-model"},
+                                       available_models=["whisper-1", "vibevoice"])
+        assert resp.status_code in (200, 202)
+        # Falls back to the tag default since user value was rejected.
+        # Note: the endpoint validates AFTER applying the precedence chain. The
+        # precedence chain runs first, so user input wins; then validation drops
+        # the bad value to None. Tag default is not re-applied — so we expect
+        # transcription_model to be None here.
+        assert params.get("transcription_model") is None, f"got {params!r}"
+
+
+def test_no_defaults_means_no_model_in_job_params():
+    with app.app_context():
+        user, rec = setup_recording()
+        client = app.test_client()
+        login_client(client, user)
+        resp, params = call_reprocess(client, rec.id, {})
+        assert resp.status_code in (200, 202)
+        assert params.get("transcription_model") is None, f"got {params!r}"
+
+
+# -----------------------------------------------------------------------------
+# Section 3: TranscriptionRequest carries `model` to the connector
+# -----------------------------------------------------------------------------
+
+def test_transcription_request_has_model_field():
+    req = TranscriptionRequest(
+        audio_file=None, filename="x.wav", model="custom-model",
+    )
+    assert req.model == "custom-model"
+
+
+def test_effective_model_uses_override():
+    connector = OpenAIWhisperConnector({"api_key": "x"})
+    req = TranscriptionRequest(
+        audio_file=None, filename="x.wav", model="whisper-1",
+    )
+    assert connector._effective_model(req) == "whisper-1"
+
+
+def test_effective_model_falls_back_to_default():
+    connector = OpenAIWhisperConnector({"api_key": "x", "model": "default-model"})
+    req = TranscriptionRequest(audio_file=None, filename="x.wav")
+    assert connector._effective_model(req) == "default-model"
+
+
+def test_effective_model_blank_override_falls_back():
+    connector = OpenAIWhisperConnector({"api_key": "x", "model": "default-model"})
+    req = TranscriptionRequest(audio_file=None, filename="x.wav", model="   ")
+    assert connector._effective_model(req) == "default-model"
+
+
+# -----------------------------------------------------------------------------
+# Main
+# -----------------------------------------------------------------------------
+
+def cleanup_test_users():
+    """Drop every user created by this file so leaked rows do not appear in
+    the admin user-management screens or aggregate stats."""
+    with app.app_context():
+        for u in User.query.filter(User.username.like('models_%')).all():
+            db.session.delete(u)
+        db.session.commit()
+
+
+def teardown_module(module):
+    """pytest auto-calls this after the last test in the module finishes.
+    Required because pytest does not invoke ``main()``, so the cleanup in
+    its ``finally`` block never runs under ``pytest tests/``."""
+    cleanup_test_users()
+
+
+def main():
+    print("=== Issue #266: per-upload/tag/folder transcription model ===\n")
+    try:
+        print("--- env parsing ---")
+        run("CSV + labels parses correctly", test_models_csv_parses_with_labels)
+        run("unset env var → empty options", test_models_csv_unset_means_empty)
+        print("\n--- precedence chain ---")
+        run("user input wins over tag/folder", test_user_input_wins_over_defaults)
+        run("tag default applies when no user input", test_tag_default_applied_when_no_user_input)
+        run("folder default applies when no tag", test_folder_default_applied_when_no_tag)
+        run("model outside allowlist dropped", test_user_supplied_model_outside_allowlist_dropped)
+        run("nothing configured → None", test_no_defaults_means_no_model_in_job_params)
+        print("\n--- TranscriptionRequest plumbing ---")
+        run("model field exists", test_transcription_request_has_model_field)
+        run("override propagates", test_effective_model_uses_override)
+        run("falls back when no override", test_effective_model_falls_back_to_default)
+        run("blank override falls back", test_effective_model_blank_override_falls_back)
+    finally:
+        cleanup_test_users()
+
+    print(f"\nResults: {PASSED} passed, {FAILED} failed")
+    return 0 if FAILED == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/tests/test_upload_title_and_date.py b/tests/test_upload_title_and_date.py
new file mode 100644
index 00000000..681a5e16
--- /dev/null
+++ b/tests/test_upload_title_and_date.py
@@ -0,0 +1,194 @@
+#!/usr/bin/env python3
+"""
+Tests for upload API title and meeting_date support, title generation skip logic,
+and summary context enrichment.
+"""
+
+import sys
+import os
+from datetime import datetime
+from unittest.mock import MagicMock, patch
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+
+def test_placeholder_pattern_detection():
+    """Placeholder titles should be detected, user titles should not."""
+    original_filename = "interview.mp3"
+    placeholder_patterns = [
+        f"Recording - {original_filename}",
+        f"Auto-processed - {original_filename}",
+    ]
+
+    # Placeholders match
+    assert "Recording - interview.mp3" in placeholder_patterns
+    assert "Auto-processed - interview.mp3" in placeholder_patterns
+
+    # User titles don't match
+    assert "My Custom Title" not in placeholder_patterns
+    assert "Interview with John" not in placeholder_patterns
+    assert "" not in placeholder_patterns
+
+    print("  PASS: placeholder pattern detection")
+
+
+def test_meeting_date_iso_parsing():
+    """ISO 8601 meeting_date strings should parse correctly."""
+    # With Z suffix
+    val = "2024-06-15T10:30:00Z"
+    dt = datetime.fromisoformat(val.replace('Z', '+00:00'))
+    assert dt.year == 2024
+    assert dt.month == 6
+    assert dt.day == 15
+
+    # Without timezone
+    val2 = "2024-06-15T10:30:00"
+    dt2 = datetime.fromisoformat(val2)
+    assert dt2.year == 2024
+
+    # Date only
+    val3 = "2024-06-15"
+    dt3 = datetime.fromisoformat(val3)
+    assert dt3.year == 2024
+    assert dt3.month == 6
+
+    # Invalid string should raise
+    try:
+        datetime.fromisoformat("not-a-date")
+        assert False, "Should have raised ValueError"
+    except ValueError:
+        pass
+
+    print("  PASS: ISO 8601 meeting_date parsing")
+
+
+def test_user_title_applied():
+    """User-provided title should be used instead of placeholder."""
+    original_filename = "test.mp3"
+
+    # With user title
+    user_title = "  My Custom Title  "
+    result = user_title.strip() if user_title and user_title.strip() else f"Recording - {original_filename}"
+    assert result == "My Custom Title"
+
+    # Empty string falls back to placeholder
+    user_title = "   "
+    result = user_title.strip() if user_title and user_title.strip() else f"Recording - {original_filename}"
+    assert result == f"Recording - {original_filename}"
+
+    # None falls back to placeholder
+    user_title = None
+    result = user_title.strip() if user_title and user_title.strip() else f"Recording - {original_filename}"
+    assert result == f"Recording - {original_filename}"
+
+    print("  PASS: user title application logic")
+
+
+def test_meeting_date_priority():
+    """User-provided meeting_date should take priority over file_last_modified."""
+    user_meeting_date = "2023-01-15T12:00:00Z"
+    file_last_modified = "1700000000000"  # Nov 2023
+
+    # User date takes priority
+    meeting_date = None
+    if user_meeting_date:
+        try:
+            meeting_date = datetime.fromisoformat(user_meeting_date.replace('Z', '+00:00'))
+        except (ValueError, TypeError):
+            pass
+
+    assert meeting_date is not None
+    assert meeting_date.year == 2023
+    assert meeting_date.month == 1
+    assert meeting_date.day == 15
+
+    # file_last_modified should NOT be reached
+    # (in real code, the `if not meeting_date` guard prevents it)
+    print("  PASS: meeting_date priority over file_last_modified")
+
+
+def test_summary_context_includes_metadata():
+    """Summary context should include recording date and title."""
+    context_parts = []
+    current_date = datetime.now().strftime("%B %d, %Y")
+    context_parts.append(f"Current date: {current_date}")
+
+    # Simulate recording with meeting_date and title
+    meeting_date = datetime(2024, 3, 15)
+    title = "Q1 Planning Meeting"
+
+    if meeting_date:
+        context_parts.append(f"Recording date: {meeting_date.strftime('%B %d, %Y')}")
+    if title:
+        context_parts.append(f"Recording title: {title}")
+
+    context = "\n".join(context_parts)
+    assert "Recording date: March 15, 2024" in context
+    assert "Recording title: Q1 Planning Meeting" in context
+
+    # Without metadata, those lines should be absent
+    context_parts2 = [f"Current date: {current_date}"]
+    meeting_date2 = None
+    title2 = None
+    if meeting_date2:
+        context_parts2.append(f"Recording date: {meeting_date2.strftime('%B %d, %Y')}")
+    if title2:
+        context_parts2.append(f"Recording title: {title2}")
+
+    context2 = "\n".join(context_parts2)
+    assert "Recording date:" not in context2
+    assert "Recording title:" not in context2
+
+    print("  PASS: summary context includes recording metadata")
+
+
+def test_neither_title_nor_date():
+    """Without title or meeting_date, existing behavior is preserved."""
+    original_filename = "audio.mp3"
+    user_title = None
+    user_meeting_date = None
+
+    # Title falls back to placeholder
+    title = user_title.strip() if user_title and user_title.strip() else f"Recording - {original_filename}"
+    assert title == "Recording - audio.mp3"
+
+    # meeting_date falls through to next priority
+    meeting_date = None
+    if user_meeting_date:
+        try:
+            meeting_date = datetime.fromisoformat(user_meeting_date.replace('Z', '+00:00'))
+        except (ValueError, TypeError):
+            pass
+    assert meeting_date is None  # Would proceed to file_last_modified in real code
+
+    print("  PASS: existing behavior preserved when no title/date provided")
+
+
+def main():
+    print("Running upload title and meeting_date tests...\n")
+    passed = 0
+    failed = 0
+
+    tests = [
+        test_placeholder_pattern_detection,
+        test_meeting_date_iso_parsing,
+        test_user_title_applied,
+        test_meeting_date_priority,
+        test_summary_context_includes_metadata,
+        test_neither_title_nor_date,
+    ]
+
+    for test in tests:
+        try:
+            test()
+            passed += 1
+        except Exception as e:
+            print(f"  FAIL: {test.__name__}: {e}")
+            failed += 1
+
+    print(f"\n{passed} passed, {failed} failed")
+    sys.exit(0 if failed == 0 else 1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/tests/test_user_cascade_delete.py b/tests/test_user_cascade_delete.py
new file mode 100644
index 00000000..395c2e72
--- /dev/null
+++ b/tests/test_user_cascade_delete.py
@@ -0,0 +1,327 @@
+#!/usr/bin/env python3
+"""
+Tests for user deletion cascade behavior (Issue #239).
+
+Ensures that deleting a user with related records (processing jobs, shares,
+usage tracking, etc.) does not fail with IntegrityError due to missing
+cascade configuration on NOT NULL foreign keys.
+
+Two test strategies:
+1. Runtime introspection: inspect SQLAlchemy relationships on User to verify
+   every NOT NULL FK has cascade delete configured. Catches future models.
+2. Integration: create a user with records in every related table, delete the
+   user, and verify no errors and no orphaned rows.
+
+Run with: python tests/test_user_cascade_delete.py
+"""
+
+import os
+import sys
+import unittest
+from datetime import datetime, date
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from src.app import app, db
+from src.models import (
+    User, Recording, ProcessingJob, Share, InternalShare, SharedRecordingState,
+    TokenUsage, TranscriptionUsage, GroupMembership, Group, Tag, Folder,
+    Speaker, APIToken, InquireSession, ExportTemplate, TranscriptTemplate,
+    NamingTemplate, TranscriptChunk, PushSubscription, ShareAuditLog,
+)
+
+
+# ---------------------------------------------------------------------------
+# Test 1: Runtime introspection — verify cascade on all NOT NULL User FKs
+# ---------------------------------------------------------------------------
+
+class TestUserRelationshipCascades(unittest.TestCase):
+    """
+    Inspect every SQLAlchemy relationship on the User model. For each
+    one-to-many relationship where the child FK is NOT NULL, verify that
+    cascade includes 'delete'. This catches any new model that forgets to
+    add cascade and would break user deletion.
+    """
+
+    def test_all_not_null_user_fk_relationships_have_cascade_delete(self):
+        from sqlalchemy.orm.relationships import ONETOMANY
+
+        with app.app_context():
+            missing = []
+
+            for name, rel in User.__mapper__.relationships.items():
+                # Only check one-to-many (backrefs from other models to User)
+                if rel.direction != ONETOMANY:
+                    continue
+
+                # Check FK columns on the child model
+                for parent_col, child_col in rel.synchronize_pairs:
+                    if not child_col.nullable and 'delete' not in rel.cascade:
+                        model_name = rel.mapper.class_.__name__
+                        missing.append(
+                            f"User.{name} -> {model_name}.{child_col.name} "
+                            f"(NOT NULL FK without cascade delete)"
+                        )
+
+            self.assertEqual(
+                missing, [],
+                "Found User relationships with NOT NULL foreign keys but no cascade "
+                "delete. Deleting a user will fail with IntegrityError.\n"
+                "Fix: add cascade='all, delete-orphan' (or 'all, delete' for multi-parent) "
+                "to the backref:\n" +
+                "\n".join(f"  - {m}" for m in missing)
+            )
+
+    def test_user_recordings_relationship_exists(self):
+        """Sanity check that User.recordings is defined (nullable FK, so no cascade needed)."""
+        with app.app_context():
+            self.assertTrue(
+                hasattr(User, 'recordings'),
+                "User model must have a 'recordings' relationship"
+            )
+
+
+# ---------------------------------------------------------------------------
+# Test 2: Integration — create user with related records, then delete
+# ---------------------------------------------------------------------------
+
+class TestUserDeletionIntegration(unittest.TestCase):
+    """
+    Create a user with records in every table that has a FK to user.id,
+    then delete the user and verify it succeeds without IntegrityError.
+    """
+
+    def setUp(self):
+        """Create a fresh user for each test."""
+        self.app_context = app.app_context()
+        self.app_context.push()
+        app.config['WTF_CSRF_ENABLED'] = False
+
+        # Clean up any leftover test user
+        existing = User.query.filter_by(username="cascade_test_user").first()
+        if existing:
+            db.session.delete(existing)
+            db.session.commit()
+
+        self.user = User(
+            username="cascade_test_user",
+            email="cascade_test@local.test",
+            password="fakehash",
+        )
+        db.session.add(self.user)
+        db.session.commit()
+
+    def test_delete_user_with_processing_jobs(self):
+        """Issue #239: ProcessingJob.user_id NOT NULL must cascade."""
+        rec = Recording(user_id=self.user.id, title="test", status="COMPLETED")
+        db.session.add(rec)
+        db.session.flush()
+
+        job = ProcessingJob(
+            user_id=self.user.id,
+            recording_id=rec.id,
+            job_type='transcribe',
+            status='completed',
+        )
+        db.session.add(job)
+        db.session.commit()
+        job_id = job.id
+
+        # This was the exact operation that failed before the fix
+        ProcessingJob.query.filter_by(user_id=self.user.id).delete()
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(ProcessingJob, job_id))
+
+    def test_delete_user_with_token_usage(self):
+        """TokenUsage.user_id NOT NULL must cascade."""
+        usage = TokenUsage(
+            user_id=self.user.id,
+            date=date.today(),
+            operation_type='summarize',
+            prompt_tokens=100,
+            completion_tokens=50,
+        )
+        db.session.add(usage)
+        db.session.commit()
+        usage_id = usage.id
+
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(TokenUsage, usage_id))
+
+    def test_delete_user_with_transcription_usage(self):
+        """TranscriptionUsage.user_id NOT NULL must cascade."""
+        usage = TranscriptionUsage(
+            user_id=self.user.id,
+            date=date.today(),
+            connector_type='openai_whisper',
+            audio_duration_seconds=120,
+        )
+        db.session.add(usage)
+        db.session.commit()
+        usage_id = usage.id
+
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(TranscriptionUsage, usage_id))
+
+    def test_delete_user_with_group_memberships(self):
+        """GroupMembership.user_id NOT NULL must cascade."""
+        group = Group(name="Test Group", description="for cascade test")
+        db.session.add(group)
+        db.session.flush()
+
+        membership = GroupMembership(
+            group_id=group.id,
+            user_id=self.user.id,
+            role='member',
+        )
+        db.session.add(membership)
+        db.session.commit()
+        membership_id = membership.id
+
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(GroupMembership, membership_id))
+
+        # Cleanup group
+        db.session.delete(group)
+        db.session.commit()
+
+    def test_delete_user_with_internal_shares(self):
+        """InternalShare has two NOT NULL User FKs (owner + shared_with)."""
+        # Create a second user to be the share recipient
+        other = User(
+            username="cascade_other_user",
+            email="cascade_other@local.test",
+            password="fakehash",
+        )
+        db.session.add(other)
+        db.session.flush()
+
+        rec = Recording(user_id=self.user.id, title="shared rec", status="COMPLETED")
+        db.session.add(rec)
+        db.session.flush()
+
+        share = InternalShare(
+            recording_id=rec.id,
+            owner_id=self.user.id,
+            shared_with_user_id=other.id,
+        )
+        db.session.add(share)
+        db.session.commit()
+        share_id = share.id
+
+        # Delete owner user — share should be removed
+        InternalShare.query.filter(
+            (InternalShare.owner_id == self.user.id) |
+            (InternalShare.shared_with_user_id == self.user.id)
+        ).delete()
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(InternalShare, share_id))
+
+        # Cleanup
+        db.session.delete(other)
+        db.session.commit()
+
+    def test_delete_user_with_push_subscriptions(self):
+        """PushSubscription.user_id NOT NULL must cascade."""
+        sub = PushSubscription(
+            user_id=self.user.id,
+            endpoint="https://push.example.com/test-cascade",
+            p256dh_key="fake_p256dh",
+            auth_key="fake_auth",
+        )
+        db.session.add(sub)
+        db.session.commit()
+        sub_id = sub.id
+
+        db.session.delete(self.user)
+        db.session.commit()
+
+        self.assertIsNone(db.session.get(PushSubscription, sub_id))
+
+    def test_admin_delete_user_endpoint(self):
+        """Full integration: call the admin DELETE endpoint with a user that has data."""
+        rec = Recording(user_id=self.user.id, title="admin test", status="COMPLETED")
+        db.session.add(rec)
+        db.session.flush()
+
+        job = ProcessingJob(
+            user_id=self.user.id,
+            recording_id=rec.id,
+            job_type='transcribe',
+            status='completed',
+        )
+        db.session.add(job)
+        db.session.commit()
+        user_id = self.user.id
+
+        # Create an admin user to perform the delete
+        admin = User.query.filter_by(username="cascade_admin").first()
+        if not admin:
+            admin = User(
+                username="cascade_admin",
+                email="cascade_admin@local.test",
+                password="fakehash",
+                is_admin=True,
+            )
+            db.session.add(admin)
+            db.session.commit()
+
+        with app.test_client() as client:
+            with client.session_transaction() as sess:
+                sess['_user_id'] = str(admin.id)
+
+            resp = client.delete(f'/admin/users/{user_id}')
+            self.assertEqual(resp.status_code, 200, f"Admin delete failed: {resp.get_json()}")
+            data = resp.get_json()
+            self.assertTrue(data.get('success'), f"Expected success=True, got: {data}")
+
+        # Verify user is gone
+        self.assertIsNone(db.session.get(User, user_id))
+
+        # Mark user as deleted so tearDown doesn't try to clean it up
+        self.user = None
+
+        # Cleanup admin
+        db.session.delete(admin)
+        db.session.commit()
+
+    def tearDown(self):
+        db.session.rollback()
+        # Final cleanup if test failed before deletion
+        if self.user:
+            leftover = db.session.get(User, self.user.id) if self.user.id else None
+        else:
+            leftover = User.query.filter_by(username="cascade_test_user").first()
+        if leftover:
+            ProcessingJob.query.filter_by(user_id=leftover.id).delete()
+            InternalShare.query.filter(
+                (InternalShare.owner_id == leftover.id) |
+                (InternalShare.shared_with_user_id == leftover.id)
+            ).delete()
+            db.session.delete(leftover)
+            db.session.commit()
+        # Also clean up helper users if they exist
+        for uname in ("cascade_other_user", "cascade_admin"):
+            helper = User.query.filter_by(username=uname).first()
+            if helper:
+                db.session.delete(helper)
+                db.session.commit()
+        self.app_context.pop()
+
+
+# ---------------------------------------------------------------------------
+# Runner
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)
diff --git a/tests/test_video_passthrough.py b/tests/test_video_passthrough.py
new file mode 100644
index 00000000..eb2c133b
--- /dev/null
+++ b/tests/test_video_passthrough.py
@@ -0,0 +1,435 @@
+"""
+Test suite for the VIDEO_PASSTHROUGH_ASR feature.
+
+Tests configuration, code path correctness, and interaction with VIDEO_RETENTION
+across all entry points (processing pipeline, upload handler, file monitor, incognito).
+Uses static analysis — no running server or real video files required.
+
+Run with: python tests/test_video_passthrough.py
+"""
+
+import os
+import re
+import sys
+import unittest
+from pathlib import Path
+
+TEST_DIR = os.path.dirname(os.path.abspath(__file__))
+PROJECT_ROOT = os.path.dirname(TEST_DIR)
+sys.path.insert(0, PROJECT_ROOT)
+
+
+def read_file(rel_path):
+    with open(os.path.join(PROJECT_ROOT, rel_path), 'r') as f:
+        return f.read()
+
+
+# Cache file contents once — they don't change during the run
+PROCESSING = read_file('src/tasks/processing.py')
+RECORDINGS = read_file('src/api/recordings.py')
+FILE_MONITOR = read_file('src/file_monitor.py')
+APP_CONFIG = read_file('src/config/app_config.py')
+ENV_EXAMPLE = read_file('config/env.transcription.example')
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+def get_function_body(source, func_name):
+    """Extract the body of a top-level function from source code."""
+    pattern = rf'^def {func_name}\('
+    lines = source.split('\n')
+    start = None
+    for i, line in enumerate(lines):
+        if re.match(pattern, line):
+            start = i
+            break
+    if start is None:
+        return ''
+    # Collect until next top-level def or class or EOF
+    body_lines = [lines[start]]
+    for line in lines[start + 1:]:
+        if line and not line[0].isspace() and (line.startswith('def ') or line.startswith('class ')):
+            break
+        body_lines.append(line)
+    return '\n'.join(body_lines)
+
+
+def split_at_incognito(source):
+    """Split processing.py into main and incognito sections."""
+    marker = 'def transcribe_incognito('
+    idx = source.find(marker)
+    if idx == -1:
+        return source, ''
+    return source[:idx], source[idx:]
+
+
+PROCESSING_MAIN, PROCESSING_INCOGNITO = split_at_incognito(PROCESSING)
+
+
+# ===========================================================================
+# 1. Configuration
+# ===========================================================================
+
+class TestPassthroughConfig(unittest.TestCase):
+    """VIDEO_PASSTHROUGH_ASR env var is defined and defaults to false."""
+
+    FILES_THAT_NEED_IT = [
+        ('src/config/app_config.py', APP_CONFIG),
+        ('src/tasks/processing.py', PROCESSING),
+        ('src/api/recordings.py', RECORDINGS),
+        ('src/file_monitor.py', FILE_MONITOR),
+    ]
+
+    def test_defined_in_all_files(self):
+        for rel_path, content in self.FILES_THAT_NEED_IT:
+            with self.subTest(file=rel_path):
+                self.assertIn('VIDEO_PASSTHROUGH_ASR', content,
+                              f"VIDEO_PASSTHROUGH_ASR missing from {rel_path}")
+
+    def test_default_is_false_everywhere(self):
+        for rel_path, content in self.FILES_THAT_NEED_IT:
+            match = re.search(
+                r"VIDEO_PASSTHROUGH_ASR\s*=\s*os\.environ\.get\('VIDEO_PASSTHROUGH_ASR',\s*'(\w+)'\)",
+                content
+            )
+            if match:
+                with self.subTest(file=rel_path):
+                    self.assertEqual(match.group(1), 'false',
+                                     f"Default should be 'false' in {rel_path}")
+
+    def test_canonical_definition_in_app_config(self):
+        self.assertIn(
+            "VIDEO_PASSTHROUGH_ASR = os.environ.get('VIDEO_PASSTHROUGH_ASR', 'false').lower() == 'true'",
+            APP_CONFIG
+        )
+
+    def test_documented_in_env_example(self):
+        self.assertIn('VIDEO_PASSTHROUGH_ASR', ENV_EXAMPLE)
+
+    def test_processing_imports_from_config(self):
+        self.assertIn('VIDEO_PASSTHROUGH_ASR', PROCESSING)
+        # Should import from app_config, not read os.environ directly
+        self.assertIn('import', PROCESSING)
+        # Verify it's in an import line from app_config
+        import_lines = [l for l in PROCESSING.split('\n')
+                        if 'from src.config.app_config import' in l]
+        found = any('VIDEO_PASSTHROUGH_ASR' in l for l in import_lines)
+        self.assertTrue(found, "processing.py should import VIDEO_PASSTHROUGH_ASR from app_config")
+
+
+# ===========================================================================
+# 2. Processing pipeline — main transcription path
+# ===========================================================================
+
+class TestProcessingMainPath(unittest.TestCase):
+    """Test transcribe_with_connector() video passthrough code paths."""
+
+    def test_passthrough_branch_exists_before_retention(self):
+        """VIDEO_PASSTHROUGH_ASR is checked before VIDEO_RETENTION in the is_video block."""
+        # Inside the `if is_video:` block, passthrough should be the first check
+        video_block_start = PROCESSING_MAIN.find('if is_video:')
+        self.assertNotEqual(video_block_start, -1)
+
+        after_video = PROCESSING_MAIN[video_block_start:]
+        passthrough_pos = after_video.find('if VIDEO_PASSTHROUGH_ASR:')
+        retention_pos = after_video.find('elif VIDEO_RETENTION:')
+
+        self.assertNotEqual(passthrough_pos, -1, "Missing VIDEO_PASSTHROUGH_ASR check in is_video block")
+        self.assertNotEqual(retention_pos, -1, "Missing elif VIDEO_RETENTION check")
+        self.assertLess(passthrough_pos, retention_pos,
+                        "VIDEO_PASSTHROUGH_ASR should be checked before VIDEO_RETENTION")
+
+    def test_passthrough_does_not_call_extract_audio(self):
+        """The passthrough branch must not call extract_audio_from_video."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        # Find the passthrough branch (from `if VIDEO_PASSTHROUGH_ASR:` to `elif VIDEO_RETENTION:`)
+        pt_start = video_block.find('if VIDEO_PASSTHROUGH_ASR:')
+        pt_end = video_block.find('elif VIDEO_RETENTION:')
+        passthrough_block = video_block[pt_start:pt_end]
+        self.assertNotIn('extract_audio_from_video', passthrough_block,
+                          "Passthrough branch should NOT extract audio")
+
+    def test_passthrough_keeps_original_filepath(self):
+        """Passthrough sets actual_filepath = filepath (the original video)."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        pt_start = video_block.find('if VIDEO_PASSTHROUGH_ASR:')
+        pt_end = video_block.find('elif VIDEO_RETENTION:')
+        passthrough_block = video_block[pt_start:pt_end]
+        self.assertIn('actual_filepath = filepath', passthrough_block)
+
+    def test_passthrough_with_retention_sets_recording_path(self):
+        """When both passthrough and retention are on, recording.audio_path is set."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        pt_start = video_block.find('if VIDEO_PASSTHROUGH_ASR:')
+        pt_end = video_block.find('elif VIDEO_RETENTION:')
+        passthrough_block = video_block[pt_start:pt_end]
+        self.assertIn('if VIDEO_RETENTION:', passthrough_block,
+                       "Passthrough branch should conditionally handle retention")
+        self.assertIn('recording.audio_path = filepath', passthrough_block)
+        self.assertIn("mimetypes.guess_type(filepath)", passthrough_block)
+
+    def test_video_passthrough_active_flag_set(self):
+        """video_passthrough_active flag is computed from is_video and VIDEO_PASSTHROUGH_ASR."""
+        self.assertIn('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR',
+                       PROCESSING_MAIN)
+
+    def test_conversion_skipped_when_passthrough(self):
+        """convert_if_needed is inside an else block gated by video_passthrough_active."""
+        self.assertIn('if video_passthrough_active:', PROCESSING_MAIN)
+        # The conversion call should be in the else branch
+        flag_pos = PROCESSING_MAIN.find('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR')
+        after_flag = PROCESSING_MAIN[flag_pos:]
+        passthrough_if = after_flag.find('if video_passthrough_active:')
+        else_pos = after_flag.find('else:', passthrough_if)
+        convert_pos = after_flag.find('convert_if_needed(', else_pos)
+        self.assertGreater(convert_pos, else_pos,
+                           "convert_if_needed should be in else branch after passthrough check")
+
+    def test_chunking_skipped_when_passthrough(self):
+        """Chunking evaluates to False when video_passthrough_active."""
+        # Find the chunking decision area after the flag
+        flag_pos = PROCESSING_MAIN.find('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR')
+        after_flag = PROCESSING_MAIN[flag_pos:]
+        self.assertIn('if video_passthrough_active:\n                should_chunk = False', after_flag)
+
+    def test_conversion_still_runs_for_non_passthrough(self):
+        """convert_if_needed still runs when passthrough is off or file is audio."""
+        # The else branch of the passthrough check should contain convert_if_needed
+        self.assertIn('conversion_result = convert_if_needed(', PROCESSING_MAIN)
+
+    def test_chunking_still_evaluated_for_non_passthrough(self):
+        """Chunking is still evaluated normally when passthrough is not active."""
+        self.assertIn('chunking_service.needs_chunking(actual_filepath, False, connector_specs)',
+                       PROCESSING_MAIN)
+
+
+# ===========================================================================
+# 3. Processing pipeline — VIDEO_RETENTION paths still intact
+# ===========================================================================
+
+class TestRetentionNotBroken(unittest.TestCase):
+    """Existing VIDEO_RETENTION behavior must be preserved."""
+
+    def test_retention_branch_still_extracts_audio(self):
+        """elif VIDEO_RETENTION branch still calls extract_audio_from_video."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        ret_start = video_block.find('elif VIDEO_RETENTION:')
+        # Find next else: at the same indent level
+        after_ret = video_block[ret_start:]
+        else_pos = after_ret.find('\n                else:')
+        retention_block = after_ret[:else_pos] if else_pos != -1 else after_ret[:500]
+        self.assertIn('extract_audio_from_video(filepath, cleanup_original=False)',
+                       retention_block)
+
+    def test_default_branch_still_extracts_and_deletes(self):
+        """The final else branch extracts audio with default cleanup (deletes video)."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        # The last else in the is_video block
+        self.assertIn('extract_audio_from_video(filepath)', video_block)
+
+    def test_temp_audio_cleanup_still_present(self):
+        """Temp audio from retention is still cleaned up after transcription."""
+        self.assertIn('is_video and VIDEO_RETENTION and audio_filepath', PROCESSING_MAIN)
+        self.assertIn('Cleaned up temp audio from video retention', PROCESSING_MAIN)
+
+
+# ===========================================================================
+# 4. Incognito path
+# ===========================================================================
+
+class TestIncognitoPassthrough(unittest.TestCase):
+    """Test passthrough in the incognito transcription path."""
+
+    def test_passthrough_flag_set_in_incognito(self):
+        """video_passthrough_active is computed in incognito path."""
+        self.assertIn('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR',
+                       PROCESSING_INCOGNITO)
+
+    def test_passthrough_skips_extraction_in_incognito(self):
+        """When passthrough is on, incognito skips extract_audio_from_video."""
+        # The passthrough branch logs and does NOT extract
+        self.assertIn('[Incognito] Video passthrough: sending original video to ASR',
+                       PROCESSING_INCOGNITO)
+
+    def test_passthrough_skips_conversion_in_incognito(self):
+        """When passthrough is on, incognito skips convert_if_needed."""
+        self.assertIn('[Incognito] Video passthrough: skipping codec conversion',
+                       PROCESSING_INCOGNITO)
+
+    def test_passthrough_skips_chunking_in_incognito(self):
+        """When passthrough is on, incognito chunking is False."""
+        body = PROCESSING_INCOGNITO
+        self.assertIn('if video_passthrough_active:\n            should_chunk = False', body)
+
+    def test_incognito_does_not_reference_video_retention(self):
+        """Incognito path should NOT reference VIDEO_RETENTION (no retention in incognito)."""
+        self.assertNotIn('VIDEO_RETENTION', PROCESSING_INCOGNITO)
+
+    def test_incognito_still_extracts_without_passthrough(self):
+        """Without passthrough, incognito still extracts audio from video."""
+        self.assertIn('extract_audio_from_video(filepath, cleanup_original=False)',
+                       PROCESSING_INCOGNITO)
+
+    def test_incognito_still_converts_without_passthrough(self):
+        """Without passthrough, incognito still runs convert_if_needed."""
+        self.assertIn('convert_if_needed(', PROCESSING_INCOGNITO)
+
+
+# ===========================================================================
+# 5. Upload handler (recordings.py)
+# ===========================================================================
+
+class TestUploadHandlerPassthrough(unittest.TestCase):
+    """Test recordings.py upload handler respects VIDEO_PASSTHROUGH_ASR."""
+
+    def test_skip_conversion_for_passthrough_video(self):
+        """Upload handler skips conversion when passthrough or retention + video."""
+        self.assertIn('VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR) and has_video', RECORDINGS)
+
+    def test_extension_fallback_checks_passthrough(self):
+        """Extension-based video detection also fires for VIDEO_PASSTHROUGH_ASR."""
+        self.assertIn('VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR', RECORDINGS)
+
+    def test_convert_if_needed_still_in_else(self):
+        """convert_if_needed still runs for audio files or when both flags are off."""
+        self.assertIn('convert_if_needed(', RECORDINGS)
+
+    def test_passthrough_log_message(self):
+        """Upload handler logs which mode caused the skip."""
+        self.assertIn("'VIDEO_PASSTHROUGH_ASR'", RECORDINGS)
+
+
+# ===========================================================================
+# 6. File monitor
+# ===========================================================================
+
+class TestFileMonitorPassthrough(unittest.TestCase):
+    """Test file_monitor.py respects VIDEO_PASSTHROUGH_ASR."""
+
+    def test_passthrough_defined(self):
+        self.assertIn('VIDEO_PASSTHROUGH_ASR', FILE_MONITOR)
+
+    def test_skip_conversion_for_passthrough_or_retention(self):
+        """File monitor skips conversion when passthrough or retention + video."""
+        self.assertIn('VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video', FILE_MONITOR)
+
+    def test_convert_if_needed_in_else_branch(self):
+        """convert_if_needed is in the else branch, not inside the skip block."""
+        lines = FILE_MONITOR.split('\n')
+        in_skip_block = False
+        found_else = False
+        for i, line in enumerate(lines):
+            if 'VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video' in line:
+                in_skip_block = True
+            elif in_skip_block and line.strip().startswith('else:'):
+                in_skip_block = False
+                found_else = True
+            elif in_skip_block and 'convert_if_needed' in line:
+                self.fail(f"convert_if_needed inside skip block at line {i + 1}")
+        self.assertTrue(found_else, "Should have else branch after passthrough/retention skip")
+
+    def test_log_distinguishes_passthrough_from_retention(self):
+        """Log message indicates whether passthrough or retention caused the skip."""
+        self.assertIn("'passthrough'", FILE_MONITOR)
+        self.assertIn("'retention'", FILE_MONITOR)
+
+
+# ===========================================================================
+# 7. Audio files unaffected by passthrough
+# ===========================================================================
+
+class TestAudioUnaffected(unittest.TestCase):
+    """VIDEO_PASSTHROUGH_ASR must only affect video files, never audio."""
+
+    def test_passthrough_flag_gated_on_is_video(self):
+        """video_passthrough_active is always `is_video and VIDEO_PASSTHROUGH_ASR`."""
+        # Main path
+        self.assertIn('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR',
+                       PROCESSING_MAIN)
+        # Incognito path
+        self.assertIn('video_passthrough_active = is_video and VIDEO_PASSTHROUGH_ASR',
+                       PROCESSING_INCOGNITO)
+
+    def test_upload_handler_gated_on_has_video(self):
+        """Upload handler skip is gated on `has_video`."""
+        self.assertIn('and has_video', RECORDINGS)
+
+    def test_file_monitor_gated_on_has_video(self):
+        """File monitor skip is gated on `has_video`."""
+        self.assertIn('and has_video', FILE_MONITOR)
+
+
+# ===========================================================================
+# 8. Documentation
+# ===========================================================================
+
+class TestDocumentation(unittest.TestCase):
+    """VIDEO_PASSTHROUGH_ASR is documented in all relevant places."""
+
+    DOC_FILES = [
+        'config/env.transcription.example',
+        'docs/admin-guide/system-settings.md',
+        'docs/features.md',
+        'docs/getting-started/installation.md',
+    ]
+
+    def test_documented_in_all_relevant_files(self):
+        for rel_path in self.DOC_FILES:
+            content = read_file(rel_path)
+            with self.subTest(file=rel_path):
+                self.assertIn('VIDEO_PASSTHROUGH_ASR', content,
+                              f"VIDEO_PASSTHROUGH_ASR missing from {rel_path}")
+
+    def test_env_example_commented_out_by_default(self):
+        """The env example has the option commented out (opt-in)."""
+        self.assertIn('# VIDEO_PASSTHROUGH_ASR=false', ENV_EXAMPLE)
+
+    def test_docs_warn_about_asr_compatibility(self):
+        """Docs warn that standard APIs will reject video input."""
+        system_settings = read_file('docs/admin-guide/system-settings.md')
+        installation = read_file('docs/getting-started/installation.md')
+        self.assertIn('reject', system_settings.lower())
+        self.assertIn('reject', installation.lower())
+
+
+# ===========================================================================
+# 9. Interaction matrix — structural verification
+# ===========================================================================
+
+class TestInteractionMatrix(unittest.TestCase):
+    """
+    Verify the 3-way branch structure in processing.py:
+      if VIDEO_PASSTHROUGH_ASR → passthrough
+      elif VIDEO_RETENTION      → retention
+      else                      → default extraction
+    """
+
+    def test_three_way_branch_in_main_path(self):
+        """Main path has if/elif/else for passthrough/retention/default."""
+        video_block = PROCESSING_MAIN[PROCESSING_MAIN.find('if is_video:'):]
+        # All three branches present in order
+        pt_pos = video_block.find('if VIDEO_PASSTHROUGH_ASR:')
+        ret_pos = video_block.find('elif VIDEO_RETENTION:')
+        else_pos = video_block.find('\n                else:', ret_pos)
+        self.assertNotEqual(pt_pos, -1)
+        self.assertNotEqual(ret_pos, -1)
+        self.assertNotEqual(else_pos, -1)
+        self.assertLess(pt_pos, ret_pos)
+        self.assertLess(ret_pos, else_pos)
+
+    def test_incognito_two_way_branch(self):
+        """Incognito has if/else for passthrough/extract (no retention)."""
+        video_block = PROCESSING_INCOGNITO[PROCESSING_INCOGNITO.find('if is_video:'):]
+        pt_pos = video_block.find('if VIDEO_PASSTHROUGH_ASR:')
+        else_pos = video_block.find('\n            else:', pt_pos)
+        self.assertNotEqual(pt_pos, -1)
+        self.assertNotEqual(else_pos, -1)
+        # No VIDEO_RETENTION in incognito
+        incognito_video_block = video_block[:500]
+        self.assertNotIn('VIDEO_RETENTION', incognito_video_block)
+
+
+if __name__ == '__main__':
+    unittest.main(verbosity=2)
diff --git a/tests/test_video_retention.py b/tests/test_video_retention.py
new file mode 100644
index 00000000..c4a25e70
--- /dev/null
+++ b/tests/test_video_retention.py
@@ -0,0 +1,370 @@
+"""
+Test suite for the VIDEO_RETENTION feature.
+
+Tests code paths, configuration, and template correctness for video retention.
+Does NOT require a running server or real video files - uses static analysis
+and mocking where possible.
+
+Run with: python tests/test_video_retention.py
+"""
+
+import os
+import re
+import sys
+import json
+import unittest
+from unittest.mock import patch, MagicMock
+from pathlib import Path
+
+# Find project root
+TEST_DIR = os.path.dirname(os.path.abspath(__file__))
+PROJECT_ROOT = os.path.dirname(TEST_DIR)
+sys.path.insert(0, PROJECT_ROOT)
+
+
+class TestVideoRetentionConfig(unittest.TestCase):
+    """Test that VIDEO_RETENTION env var is read correctly everywhere."""
+
+    ALL_FILES = [
+        'src/app.py',
+        'src/tasks/processing.py',
+        'src/api/system.py',
+        'src/api/recordings.py',
+        'src/file_monitor.py',
+    ]
+
+    def _read_file(self, rel_path):
+        with open(os.path.join(PROJECT_ROOT, rel_path), 'r') as f:
+            return f.read()
+
+    def test_env_var_read_in_all_entry_points(self):
+        """VIDEO_RETENTION env var is read in all files that need it."""
+        for rel_path in self.ALL_FILES:
+            content = self._read_file(rel_path)
+            self.assertIn("VIDEO_RETENTION", content, f"VIDEO_RETENTION missing from {rel_path}")
+
+    def test_exposed_in_api_config(self):
+        """VIDEO_RETENTION is exposed in the /api/config response."""
+        content = self._read_file('src/api/system.py')
+        self.assertIn("'video_retention': VIDEO_RETENTION", content)
+
+    def test_default_is_false(self):
+        """All VIDEO_RETENTION reads default to 'false'."""
+        for rel_path in self.ALL_FILES:
+            content = self._read_file(rel_path)
+            match = re.search(r"VIDEO_RETENTION\s*=\s*os\.environ\.get\('VIDEO_RETENTION',\s*'(\w+)'\)", content)
+            if match:
+                self.assertEqual(match.group(1), 'false', f"Default should be 'false' in {rel_path}")
+
+
+class TestProcessingPipelineVideoRetention(unittest.TestCase):
+    """Test processing.py video retention code paths via static analysis."""
+
+    @classmethod
+    def setUpClass(cls):
+        with open(os.path.join(PROJECT_ROOT, 'src/tasks/processing.py'), 'r') as f:
+            cls.content = f.read()
+
+    def test_video_retention_true_keeps_original(self):
+        """When VIDEO_RETENTION=True, recording.audio_path is set to original filepath."""
+        # The VIDEO_RETENTION=True branch should set recording.audio_path = filepath
+        self.assertIn('recording.audio_path = filepath', self.content)
+
+    def test_video_retention_true_extracts_without_cleanup(self):
+        """When VIDEO_RETENTION=True, extract_audio_from_video is called with cleanup_original=False."""
+        self.assertIn('extract_audio_from_video(filepath, cleanup_original=False)', self.content)
+
+    def test_video_retention_false_extracts_with_cleanup(self):
+        """When VIDEO_RETENTION=False, extract_audio_from_video is called with default cleanup."""
+        self.assertIn('extract_audio_from_video(filepath)', self.content)
+
+    def test_temp_audio_cleanup_after_transcription(self):
+        """Temp audio from video retention is cleaned up after transcription."""
+        self.assertIn('is_video and VIDEO_RETENTION and audio_filepath', self.content)
+        self.assertIn('Cleaned up temp audio from video retention', self.content)
+
+    def test_audio_filepath_initialized_to_none(self):
+        """audio_filepath is initialized to None before the is_video check."""
+        # Find the initialization line
+        self.assertIn('audio_filepath = None', self.content)
+
+    def test_video_mime_type_set_for_retention(self):
+        """When retaining video, mime_type reflects actual video type."""
+        self.assertIn("mimetypes.guess_type(filepath)[0] or 'video/mp4'", self.content)
+
+    def test_duration_uses_recording_audio_path(self):
+        """Duration lookup uses recording.audio_path (always valid), not filepath."""
+        self.assertIn('chunking_service.get_audio_duration(recording.audio_path)', self.content)
+        # Should NOT use bare filepath for duration (pre-existing bug was fixed)
+        self.assertNotIn('chunking_service.get_audio_duration(filepath)', self.content)
+
+
+class TestUploadHandlerVideoRetention(unittest.TestCase):
+    """Test recordings.py upload handler video retention code paths."""
+
+    @classmethod
+    def setUpClass(cls):
+        with open(os.path.join(PROJECT_ROOT, 'src/api/recordings.py'), 'r') as f:
+            cls.content = f.read()
+
+    def test_upload_handler_skips_conversion_for_video_retention(self):
+        """Upload handler skips convert_if_needed for videos when retention is on."""
+        self.assertIn('(VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR) and has_video', self.content)
+        self.assertIn('skipping conversion', self.content)
+
+    def test_upload_handler_has_video_from_codec_info(self):
+        """Upload handler reads has_video from codec_info probe."""
+        self.assertIn("has_video = codec_info.get('has_video', False)", self.content)
+
+    def test_convert_if_needed_still_in_else_branch(self):
+        """convert_if_needed still runs for non-video files or when retention is off."""
+        self.assertIn('convert_if_needed(', self.content)
+
+    def test_processing_pipeline_still_converts_audio(self):
+        """Processing pipeline runs convert_if_needed on extracted audio (the safety net)."""
+        proc_content = open(os.path.join(PROJECT_ROOT, 'src/tasks/processing.py')).read()
+        # After the video extraction block, convert_if_needed runs on actual_filepath
+        self.assertIn('conversion_result = convert_if_needed(\n'
+                      '                    filepath=actual_filepath,', proc_content)
+
+
+class TestFileMonitorVideoRetention(unittest.TestCase):
+    """Test file_monitor.py video retention code paths."""
+
+    @classmethod
+    def setUpClass(cls):
+        with open(os.path.join(PROJECT_ROOT, 'src/file_monitor.py'), 'r') as f:
+            cls.content = f.read()
+
+    def test_video_retention_skips_conversion(self):
+        """When VIDEO_RETENTION=True and has_video=True, convert_if_needed is skipped."""
+        # Should have the guard: if (VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video: ... skip conversion
+        self.assertIn('VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video', self.content)
+        self.assertIn('skipping conversion', self.content)
+
+    def test_no_double_extraction(self):
+        """File monitor does NOT call convert_if_needed for videos when retention is on."""
+        # The convert_if_needed call should be in the else branch
+        lines = self.content.split('\n')
+        in_retention_skip_block = False
+        found_convert_in_else = False
+
+        for i, line in enumerate(lines):
+            if 'VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video' in line and 'if' in line:
+                in_retention_skip_block = True
+            elif in_retention_skip_block and 'else:' in line:
+                in_retention_skip_block = False
+                found_convert_in_else = True
+            elif in_retention_skip_block and 'convert_if_needed' in line:
+                self.fail(f"convert_if_needed called inside VIDEO_RETENTION skip block at line {i+1}")
+
+        self.assertTrue(found_convert_in_else, "Should have else branch after video retention skip")
+
+    def test_no_video_retention_param_in_convert_call(self):
+        """convert_if_needed should NOT receive a video_retention parameter."""
+        # Ensure the old video_retention parameter isn't being passed
+        self.assertNotIn('video_retention=VIDEO_RETENTION', self.content)
+
+
+class TestAudioConversionNotModified(unittest.TestCase):
+    """Verify audio_conversion.py was fully reverted (no video_retention parameter)."""
+
+    @classmethod
+    def setUpClass(cls):
+        with open(os.path.join(PROJECT_ROOT, 'src/utils/audio_conversion.py'), 'r') as f:
+            cls.content = f.read()
+
+    def test_no_video_retention_parameter(self):
+        """convert_if_needed should not have a video_retention parameter."""
+        self.assertNotIn('video_retention', self.content)
+
+    def test_no_should_delete_original(self):
+        """No should_delete_original variable should exist."""
+        self.assertNotIn('should_delete_original', self.content)
+
+
+class TestSendFileConditional(unittest.TestCase):
+    """Test that send_file calls use conditional=True for range request support."""
+
+    def _read_file(self, rel_path):
+        with open(os.path.join(PROJECT_ROOT, rel_path), 'r') as f:
+            return f.read()
+
+    def test_recordings_streaming_has_conditional(self):
+        """Streaming send_file in recordings.py has conditional=True."""
+        content = self._read_file('src/api/recordings.py')
+        # Find the non-download send_file call
+        self.assertIn('send_file(recording.audio_path, mimetype=recording.mime_type, conditional=True)', content)
+
+    def test_recordings_download_has_conditional(self):
+        """Download send_file in recordings.py has conditional=True."""
+        content = self._read_file('src/api/recordings.py')
+        self.assertIn('as_attachment=True, download_name=filename, mimetype=recording.mime_type, conditional=True', content)
+
+    def test_shares_has_conditional(self):
+        """send_file in shares.py has conditional=True."""
+        content = self._read_file('src/api/shares.py')
+        self.assertIn('send_file(recording.audio_path, conditional=True)', content)
+
+
+class TestFrontendTemplates(unittest.TestCase):
+    """Test that frontend templates correctly switch between video and audio."""
+
+    TEMPLATE_FILES = [
+        'templates/components/detail/desktop-right-panel.html',
+        'templates/components/detail/audio-player.html',
+        'templates/modals/speaker-modal.html',
+        'templates/share.html',
+    ]
+
+    def _read_template(self, rel_path):
+        with open(os.path.join(PROJECT_ROOT, rel_path), 'r') as f:
+            return f.read()
+
+    def test_all_templates_use_dynamic_component(self):
+        """All player templates use <component :is> for video/audio switching."""
+        for tmpl in self.TEMPLATE_FILES:
+            content = self._read_template(tmpl)
+            self.assertIn("<component :is=", content, f"Missing dynamic component in {tmpl}")
+            self.assertIn("startsWith('video/')", content, f"Missing video/ check in {tmpl}")
+            self.assertIn("</component>", content, f"Missing </component> in {tmpl}")
+
+    def test_no_bare_audio_elements_in_main_players(self):
+        """Main player templates should not have bare <audio elements (replaced by component)."""
+        for tmpl in self.TEMPLATE_FILES:
+            content = self._read_template(tmpl)
+            # Count <audio and <component :is occurrences
+            audio_count = content.count('<audio ')
+            component_count = content.count('<component :is=')
+
+            # Each template should have component :is but no bare <audio for the main player
+            self.assertGreater(component_count, 0, f"No <component :is> in {tmpl}")
+            # Desktop right panel and audio player should have 0 bare audio tags
+            if 'desktop-right-panel' in tmpl or 'audio-player' in tmpl:
+                self.assertEqual(audio_count, 0, f"Unexpected bare <audio> in {tmpl}")
+
+    def test_video_element_gets_visible_styling(self):
+        """When mime_type is video/, the element should be visible (not hidden)."""
+        for tmpl in self.TEMPLATE_FILES:
+            content = self._read_template(tmpl)
+            # Should have conditional class that shows video and hides audio
+            self.assertIn("'w-full rounded-lg", content, f"Missing video styling in {tmpl}")
+            self.assertIn("'hidden'", content, f"Missing hidden fallback for audio in {tmpl}")
+
+    def test_template_div_balance(self):
+        """Verify player-specific templates have balanced div tags."""
+        # Only check templates we fully control (not share.html which has pre-existing imbalance)
+        balanced_templates = [
+            'templates/components/detail/desktop-right-panel.html',
+            'templates/components/detail/audio-player.html',
+            'templates/modals/speaker-modal.html',
+        ]
+        for tmpl in balanced_templates:
+            content = self._read_template(tmpl)
+            opens = content.count('<div')
+            closes = content.count('</div>')
+            self.assertEqual(opens, closes, f"Unbalanced divs in {tmpl}: {opens} opens, {closes} closes")
+
+
+class TestLocalization(unittest.TestCase):
+    """Test that video retention localization keys exist in all locale files."""
+
+    LOCALE_DIR = os.path.join(PROJECT_ROOT, 'static', 'locales')
+
+    def test_video_retained_key_in_all_locales(self):
+        """upload.videoRetained key exists in all locale files."""
+        locale_files = [f for f in os.listdir(self.LOCALE_DIR) if f.endswith('.json')]
+        self.assertGreater(len(locale_files), 0, "No locale files found")
+
+        for locale_file in locale_files:
+            filepath = os.path.join(self.LOCALE_DIR, locale_file)
+            with open(filepath, 'r', encoding='utf-8') as f:
+                data = json.load(f)
+
+            self.assertIn('upload', data, f"No 'upload' section in {locale_file}")
+            self.assertIn('videoRetained', data['upload'],
+                         f"Missing 'videoRetained' key in upload section of {locale_file}")
+            self.assertIsInstance(data['upload']['videoRetained'], str,
+                               f"'videoRetained' should be a string in {locale_file}")
+            self.assertGreater(len(data['upload']['videoRetained']), 0,
+                             f"'videoRetained' is empty in {locale_file}")
+
+    def test_locale_files_are_valid_json(self):
+        """All locale files are valid JSON."""
+        locale_files = [f for f in os.listdir(self.LOCALE_DIR) if f.endswith('.json')]
+        for locale_file in locale_files:
+            filepath = os.path.join(self.LOCALE_DIR, locale_file)
+            try:
+                with open(filepath, 'r', encoding='utf-8') as f:
+                    json.load(f)
+            except json.JSONDecodeError as e:
+                self.fail(f"Invalid JSON in {locale_file}: {e}")
+
+
+class TestVideoRetentionMatrix(unittest.TestCase):
+    """
+    Test the complete 2x2 matrix of (VIDEO_RETENTION x is_video) scenarios
+    by analyzing the code flow statically.
+    """
+
+    def _read_file(self, rel_path):
+        with open(os.path.join(PROJECT_ROOT, rel_path), 'r') as f:
+            return f.read()
+
+    def test_processing_has_both_branches(self):
+        """processing.py has both VIDEO_RETENTION=True and False branches for video."""
+        content = self._read_file('src/tasks/processing.py')
+        # Should have if VIDEO_RETENTION: ... else: ... inside if is_video:
+        self.assertIn('if VIDEO_RETENTION:', content)
+        # After the retention block, should have else for the default behavior
+        lines = content.split('\n')
+        found_retention_if = False
+        found_else_after = False
+        for line in lines:
+            if 'if VIDEO_RETENTION:' in line:
+                found_retention_if = True
+            elif found_retention_if and line.strip().startswith('else:'):
+                found_else_after = True
+                break
+        self.assertTrue(found_else_after, "Missing else branch after VIDEO_RETENTION check in processing.py")
+
+    def test_file_monitor_has_both_branches(self):
+        """file_monitor.py has both video retention skip and normal conversion paths."""
+        content = self._read_file('src/file_monitor.py')
+        self.assertIn('VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video', content)
+        # convert_if_needed should still exist in the else path
+        self.assertIn('convert_if_needed(', content)
+
+    def test_incognito_not_affected(self):
+        """Incognito processing path should NOT reference VIDEO_RETENTION."""
+        content = self._read_file('src/tasks/processing.py')
+        # Find the incognito section (marked with [Incognito])
+        incognito_section = content[content.find('[Incognito]'):]
+        # VIDEO_RETENTION should not appear in incognito section
+        # (incognito always strips video per the plan)
+        self.assertNotIn('VIDEO_RETENTION', incognito_section,
+                        "VIDEO_RETENTION should not be referenced in incognito processing")
+
+    def test_all_three_entry_points_skip_for_video_retention(self):
+        """All entry points (upload, file monitor, processing) handle VIDEO_RETENTION."""
+        for rel_path, marker in [
+            ('src/api/recordings.py', '(VIDEO_RETENTION or VIDEO_PASSTHROUGH_ASR) and has_video'),
+            ('src/file_monitor.py', '(VIDEO_PASSTHROUGH_ASR or VIDEO_RETENTION) and has_video'),
+            ('src/tasks/processing.py', 'if VIDEO_RETENTION:'),
+        ]:
+            content = self._read_file(rel_path)
+            self.assertIn(marker, content, f"Missing video retention guard in {rel_path}")
+
+    def test_convert_if_needed_always_runs_on_transcription_audio(self):
+        """Processing pipeline always runs convert_if_needed on audio before transcription."""
+        content = self._read_file('src/tasks/processing.py')
+        # The convert_if_needed call on actual_filepath happens AFTER the video
+        # extraction block, regardless of VIDEO_RETENTION setting
+        video_block_pos = content.find('if is_video:')
+        convert_pos = content.find('convert_if_needed(\n                    filepath=actual_filepath,')
+        self.assertGreater(convert_pos, video_block_pos,
+                          "convert_if_needed must run after video extraction block")
+
+
+if __name__ == '__main__':
+    unittest.main(verbosity=2)
diff --git a/vitest.config.js b/vitest.config.js
new file mode 100644
index 00000000..94ba357f
--- /dev/null
+++ b/vitest.config.js
@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        include: ['static/js/**/*.test.js'],
+        environment: 'node',
+        globals: false,
+    },
+});