mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2026-03-01 05:29:41 +00:00
130 lines
2.9 KiB
Markdown
130 lines
2.9 KiB
Markdown
# 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
|