Update documentation and API tests: Bookmann → Bookhoard
Documentation updates: - All docs/ files: Update project references - Bruno API collection: Update collection name and tests - Device setup guides: Update all examples - Implementation plan: Update database schema examples - README files: Update project references Part of project rename to Bookhoard.
This commit is contained in:
@@ -2,13 +2,13 @@
|
||||
|
||||
## Overview
|
||||
|
||||
Bookmann provides full Calibre-compatible wireless sync for KOReader devices, enabling seamless reading progress, highlights, and notes synchronization.
|
||||
Bookhoard provides full Calibre-compatible wireless sync for KOReader devices, enabling seamless reading progress, highlights, and notes synchronization.
|
||||
|
||||
## Setup
|
||||
|
||||
### 1. Register Your Device
|
||||
|
||||
First, register your KOReader device with Bookmann:
|
||||
First, register your KOReader device with Bookhoard:
|
||||
|
||||
```bash
|
||||
POST /api/devices/register
|
||||
@@ -31,7 +31,7 @@ Visit the approval URL in your web browser (or scan the QR code) to authenticate
|
||||
### 3. Configure KOReader
|
||||
|
||||
In KOReader settings, set:
|
||||
- **Calibre wireless URL**: `https://your-bookmann-domain.com/api/sync/koreader`
|
||||
- **Calibre wireless URL**: `https://your-bookhoard-domain.com/api/sync/koreader`
|
||||
- **Enable wireless sync**: ON
|
||||
- **Sync frequency**: Every page turn (recommended)
|
||||
|
||||
@@ -241,7 +241,7 @@ Syncs periodically to save bandwidth.
|
||||
|
||||
## Device Matching
|
||||
|
||||
Bookmann tries multiple strategies to match books:
|
||||
Bookhoard tries multiple strategies to match books:
|
||||
|
||||
1. **By UUID**: Most reliable if your book files have unique IDs (confidence: 1.0)
|
||||
2. **By SHA-256**: Hash-based matching for reliable identification (confidence: 0.9)
|
||||
@@ -251,7 +251,7 @@ Bookmann tries multiple strategies to match books:
|
||||
|
||||
### SHA-256 Matching (Phase 7 Enhancement)
|
||||
|
||||
Bookmann now supports SHA-256 hash matching for reliable book identification:
|
||||
Bookhoard now supports SHA-256 hash matching for reliable book identification:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -275,7 +275,7 @@ Bookmann now supports SHA-256 hash matching for reliable book identification:
|
||||
|
||||
### Device File Alias System
|
||||
|
||||
When a book is matched with a file path, Bookmann automatically creates a device file alias:
|
||||
When a book is matched with a file path, Bookhoard automatically creates a device file alias:
|
||||
|
||||
- **UUID + FilePath**: Creates alias with confidence 1.0
|
||||
- **SHA-256 + FilePath**: Creates alias with confidence 0.9
|
||||
@@ -359,7 +359,7 @@ Use the Bruno API collection in `/bruno/koreader/` to test endpoints:
|
||||
- `Sync Bookmarks.bru` - Test annotation sync
|
||||
|
||||
Required variables:
|
||||
- `baseUrl` - Your Bookmann server URL
|
||||
- `baseUrl` - Your Bookhoard server URL
|
||||
- `device_token` - Device authentication token
|
||||
- `book_uuid` - UUID of a test book
|
||||
|
||||
@@ -368,7 +368,7 @@ Required variables:
|
||||
- Compatible with Calibre wireless protocol
|
||||
- Supports EPUB CFI for precise locations
|
||||
- Handles reflowable and fixed-layout formats
|
||||
- Bidirectional sync (KOReader ↔ Bookmann)
|
||||
- Bidirectional sync (KOReader ↔ Bookhoard)
|
||||
- Real-time updates via WebSocket (coming in Phase 3b)
|
||||
|
||||
## Next Steps
|
||||
|
||||
Reference in New Issue
Block a user