Ebook — Digital Book Collection & Reading Tracker

A comprehensive ebook management tool for cataloging digital books, tracking reading progress, managing highlights and annotations, rating and reviewing books, and exporting your library. All data is stored locally in JSONL format for portability and privacy.

Prerequisites

• Python 3.6+
• Bash 4+

Data Storage

All ebook records, reading sessions, highlights, and reviews are stored in ~/.ebook/data.jsonl. Each record is a JSON object with fields including id, type (book, session, highlight, review), title, author, format, pages, progress, created_at, and additional type-specific fields.

Commands

Run via: bash scripts/script.sh <command> [options]

Usage Examples

# Add a new ebook
bash scripts/script.sh add --title "Deep Work" --author "Cal Newport" --format epub --pages 296 --tags "productivity,focus"

# List all books
bash scripts/script.sh list

# List only unread books
bash scripts/script.sh list --status unread

# Search by author
bash scripts/script.sh search --author "Newport"

# Search by keyword
bash scripts/script.sh search --query "productivity"

# Update book metadata
bash scripts/script.sh update --id abc123 --status reading --tags "self-help,focus"

# Delete a book
bash scripts/script.sh delete --id abc123

# Log a reading session (30 minutes, pages 1-45)
bash scripts/script.sh read --id abc123 --start-page 1 --end-page 45 --duration 30

# Check progress
bash scripts/script.sh progress --id abc123

# Add a highlight
bash scripts/script.sh highlight --id abc123 --page 42 --text "The key to developing deep work is..."

# Write a review
bash scripts/script.sh review --id abc123 --rating 5 --text "Transformative book on focused work"

# View reading stats
bash scripts/script.sh stats

# Export library to markdown
bash scripts/script.sh export --format md --output library.md