Prepare for migration

scripts/Makefile

@@ -0,0 +1,39 @@
+.PHONY: all library_folders library_items books feeds settings help
+
+all: library_folders library_items books feeds settings
+	@echo "=== Complete dump complete ==="
+
+library_folders:
+	@echo "Dumping library folders..."
+	@bash dump_library_folders.sh
+
+library_items:
+	@echo "Dumping library items..."
+	@bash dump_library_items.sh
+
+books:
+	@echo "Dumping books..."
+	@bash dump_books.sh
+
+feeds:
+	@echo "Dumping feeds..."
+	@bash dump_feeds.sh
+
+settings:
+	@echo "Dumping settings..."
+	@bash dump_settings.sh
+
+summary:
+	@echo "Running full summary..."
+	@bash dump_all.sh
+
+help:
+	@echo "Available targets:"
+	@echo "  make all        - Run all dump scripts"
+	@echo "  make summary    - Run the master summary script"
+	@echo "  make library_folders - Dump libraryFolders table"
+	@echo "  make library_items   - Dump libraryItems table"
+	@echo "  make books       - Dump books table"
+	@echo "  make feeds       - Dump feeds table"
+	@echo "  make settings    - Dump settings table"
+	@echo "  make help        - Show this help message"

scripts/SCRIPTS.md

@@ -0,0 +1,130 @@
+# Database Debug Scripts
+
+## Overview
+
+Collection of SQLite scripts to analyze the Audiobookshelf database and identify hardcoded Docker paths that need migration.
+
+## Scripts
+
+### dump_library_folders.sh
+Dumps the `libraryFolders` table showing:
+- Full paths to library root folders
+- Library IDs for reference
+
+**Usage:** `bash dump_library_folders.sh`
+
+**Key for migration:** Maps Docker paths like `/audiobooks` to local equivalents.
+
+---
+
+### dump_library_items.sh
+Dumps `libraryItems` table focusing on:
+- Full absolute paths (`path`)
+- Relative paths (`relPath`)
+- Unique path prefixes used across all items
+
+**Usage:** `bash dump_library_items.sh`
+
+**Key for migration:** Identifies which library folder each item belongs to based on path prefix.
+
+---
+
+### dump_books.sh
+Dumps `books` table focusing on:
+- Cover image paths (`coverPath`)
+- Unique cover path prefixes
+
+**Usage:** `bash dump_books.sh`
+
+**Key for migration:** Identifies metadata paths like `/metadata/items/{id}/cover.jpg`.
+
+---
+
+### dump_feeds.sh
+Dumps `feeds` table showing:
+- Server addresses (Docker hostnames)
+- Feed URLs
+- Cover paths for RSS feeds
+
+**Usage:** `bash dump_feeds.sh`
+
+**Key for migration:** Finds Docker hostnames like `http://audiobookshelf:8080` that need local URLs.
+
+---
+
+### dump_settings.sh
+Dumps `settings` table extracting:
+- Path-related values from JSON
+- URLs and server addresses
+- Configuration paths
+
+**Usage:** `bash dump_settings.sh`
+
+**Key for migration:** Finds settings like `backupPath`, server URLs in JSON config.
+
+---
+
+### dump_all.sh (Master Summary)
+Runs all dumps and provides a consolidated view:
+- Library folder paths
+- Path prefixes across items
+- Cover path prefixes
+- Server addresses
+- Settings with paths/URLs
+- Quick scan of all Docker-like paths
+
+**Usage:** `bash dump_all.sh`
+
+---
+
+## Makefile Targets
+
+Run from the `scripts/` directory:
+
+```bash
+cd scripts
+make all           # Run all dumps
+make summary       # Run master summary
+make help          # Show available targets
+```
+
+### Individual Targets
+
+```bash
+make library_folders  # libraryFolders paths
+make library_items    # libraryItems paths
+make books            # books coverPaths
+make feeds            # feeds URLs
+make settings         # settings JSON paths
+```
+
+## Example Output
+
+```
+=== libraryFolders ===
+ID | PATH | LIBRARY_ID
+---|------|-----------
+9f980819-... | /audiobooks | a04cbf28-...
+43bf8c8d-... | /libraries/romance | dad4448d-...
+
+=== Unique Path Prefixes ===
+/audiobooks
+/libraries/romance
+```
+
+## Common Docker Paths Found
+
+| Path Pattern | Description |
+|--------------|-------------|
+| `/audiobooks` | Library root |
+| `/libraries/...` | Additional libraries |
+| `/metadata/items/...` | Item metadata/covers |
+| `/metadata/backups` | Backup directory |
+| `http://audiobookshelf:8080` | Docker service URL |
+
+## Next Steps
+
+1. Run `make summary` to get complete overview
+2. Identify Docker paths specific to your deployment
+3. Create path mapping configuration
+4. Run migration script to update paths

scripts/dump_all.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# Master summary script - find all Docker paths in the database
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=============================================="
+echo "DOCKER PATH SUMMARY"
+echo "=============================================="
+
+echo ""
+echo ">>> 1. LIBRARY FOLDERS (libraryFolders.path)"
+echo "=============================================="
+sqlite3 -header -column "$DB_PATH" "SELECT id, path, libraryId FROM libraryFolders;"
+
+echo ""
+echo ">>> 2. LIBRARY ITEMS - Path Prefixes"
+echo "=============================================="
+sqlite3 "$DB_PATH" "SELECT DISTINCT SUBSTR(path, 1, INSTR(path || '/', '/') - 1) AS prefix FROM libraryItems ORDER BY prefix;" | sort -u
+
+echo ""
+echo ">>> 3. BOOKS - Cover Path Prefixes"
+echo "=============================================="
+sqlite3 "$DB_PATH" "SELECT DISTINCT SUBSTR(coverPath, 1, INSTR(coverPath || '/', '/') - 1) AS prefix FROM books WHERE coverPath IS NOT NULL ORDER BY prefix;" | sort -u
+
+echo ""
+echo ">>> 4. FEEDS - Server Addresses (Docker hostnames)"
+echo "=============================================="
+sqlite3 "$DB_PATH" "SELECT DISTINCT serverAddress FROM feeds WHERE serverAddress IS NOT NULL;"
+
+echo ""
+echo ">>> 5. SETTINGS - Path-related Values"
+echo "=============================================="
+sqlite3 "$DB_PATH" "SELECT key, SUBSTR(value, 1, 200) FROM settings WHERE value LIKE '%/metadata/%' OR value LIKE '%/audiobooks%' OR value LIKE 'http://%' OR value LIKE 'https://%';"
+
+echo ""
+echo ">>> 6. ALL LIKELY DOCKER PATHS (Quick scan)"
+echo "=============================================="
+echo "Scanning for paths starting with '/' or URLs..."
+sqlite3 "$DB_PATH" "SELECT 'libraryFolders.path' AS source, path AS value FROM libraryFolders WHERE path LIKE '/%' UNION ALL SELECT 'libraryItems.path', path FROM libraryItems WHERE path LIKE '/%' UNION ALL SELECT 'books.coverPath', coverPath FROM books WHERE coverPath LIKE '/%' UNION ALL SELECT 'feeds.serverAddress', serverAddress FROM feeds WHERE serverAddress LIKE 'http://%' OR serverAddress LIKE 'https://%';" 2>/dev/null | head -50

scripts/dump_books.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Dump books table cover paths
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=== books.coverPath ==="
+echo "ID | COVER_PATH"
+echo "---|-----------"
+sqlite3 -header -column "$DB_PATH" "SELECT id, coverPath FROM books LIMIT 50;"
+
+echo ""
+echo "=== Unique Cover Path Prefixes ==="
+sqlite3 "$DB_PATH" "SELECT DISTINCT SUBSTR(coverPath, 1, INSTR(coverPath || '/', '/') - 1) FROM books WHERE coverPath IS NOT NULL;" | sort -u

scripts/dump_feeds.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Dump feeds table - URLs and server addresses
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=== feeds (URLs and Addresses) ==="
+echo "ID | SERVER_ADDRESS | FEED_URL | COVER_PATH"
+echo "---|----------------|----------|-----------"
+sqlite3 -header -column "$DB_PATH" "SELECT id, serverAddress, feedURL, coverPath FROM feeds;"
+
+echo ""
+echo "=== Unique Server Addresses ==="
+sqlite3 "$DB_PATH" "SELECT DISTINCT serverAddress FROM feeds WHERE serverAddress IS NOT NULL;"

scripts/dump_library_folders.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Dump libraryFolders table for human consumption
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=== libraryFolders ==="
+echo "ID | PATH | LIBRARY_ID"
+echo "---|------|-----------"
+sqlite3 -header -column "$DB_PATH" "SELECT id, path, libraryId FROM libraryFolders;"

scripts/dump_library_items.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Dump libraryItems table focusing on paths
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=== libraryItems (Paths) ==="
+echo "ID | PATH | REL_PATH"
+echo "---|------|---------"
+sqlite3 -header -column "$DB_PATH" "SELECT id, path, relPath FROM libraryItems LIMIT 100;"
+
+echo ""
+echo "=== Unique Path Prefixes ==="
+sqlite3 "$DB_PATH" "SELECT DISTINCT SUBSTR(path, 1, INSTR(path || '/', '/') - 1) FROM libraryItems;" | sort -u

scripts/dump_settings.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# Dump settings - extract path-related values from JSON
+
+DB_PATH="/mnt/docker/work/books/audiobookshelf/config/absdatabase.sqlite"
+
+echo "=== settings (Path-related JSON values) ==="
+
+# Extract and display server-settings JSON with key paths highlighted
+sqlite3 "$DB_PATH" "SELECT key, value FROM settings;" | while read -r key value; do
+    echo "--- $key ---"
+    echo "$value" | python3 -c "import sys, json; d=json.load(sys.stdin); [print(f'  {k}: {v}') for k,v in d.items() if 'path' in k.lower() or 'url' in k.lower() or 'address' in k.lower()]" 2>/dev/null || echo "  (No path-related keys found or JSON parse error)"
+done