What this skill does

# book-reader Read books (epub, pdf, txt) from various sources with progress tracking. ## Purpose Enable AI agents to read full-length books for learning, summarization, and knowledge extraction. ## Features - **Multiple sources**: Anna's Archive, Project Gutenberg, local files - **Format support**: EPUB, PDF, TXT - **Progress tracking**: Remember where you left off - **Smart chunking**: Read books in digestible sections - **Summary generation**: Extract key insights as you read ## Tools Required - `curl` or `wget` - Download books - `pandoc` - Convert EPUB to text (optional, fallback to python) - `pdftotext` (poppler-utils) - Extract PDF text - Python 3 with `ebooklib` and `beautifulsoup4` (for EPUB parsing) ## Usage ### Search for a book ```bash ./book-reader.sh search "Thinking Fast and Slow" ``` ### Download a book ```bash ./book-reader.sh download <book-id> [output-file] ``` ### Read a book (with progress tracking) ```bash ./book-reader.sh read <file> [--from-page N] [--pages N] ``` ### Show reading progress ```bash ./book-reader.sh status ``` ## Installation ```bash # Install dependencies sudo apt-get install poppler-utils pandoc # Linux # brew install poppler pandoc # macOS pip3 install ebooklib beautifulsoup4 lxml # Make executable chmod +x book-reader.sh ``` ## Book Sources 1. **Project Gutenberg** (70k+ public domain books) - API: https://gutendex.com - Free, legal, no DRM 2. **Anna's Archive** (shadow library) - Millions of books, papers, comics - Legal gray area depending on jurisdiction - Use responsibly 3. **Local files** (your own epub/pdf collection) ## Reading State Progress tracked in `~/.openclaw/workspace/memory/reading-state.json`: ```json { "currentBook": "Thinking, Fast and Slow", "file": "/path/to/book.epub", "totalPages": 499, "pagesRead": 127, "lastRead": 1770957900, "bookmarks": [50, 200], "notes": "Interesting insight about System 1 vs System 2..." } ``` ## Example Workflow ```bash # Find the book ./book-reader.sh search "Daniel Kahneman Thinking" # Download it ./book-reader.sh download 12345 ~/books/thinking-fast-slow.epub # Start reading ./book-reader.sh read ~/books/thinking-fast-slow.epub --pages 50 # Continue later ./book-reader.sh read ~/books/thinking-fast-slow.epub --pages 50 # Check progress ./book-reader.sh status ``` ## Privacy & Ethics - Public domain books (Gutenberg): Fully legal - Copyrighted books: Check your local laws - Consider buying books you find valuable to support authors - Use for personal learning, not redistribution ## Limitations - PDF OCR quality varies - DRM-protected books not supported (by design) - Large PDFs may be slow to parse - EPUB formatting may be imperfect in plain text --- **Use responsibly. Support authors when possible.**