Skip to content

Gypsyrevised749/book-capture

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š book-capture - Capture books into clean notes

Download book-capture

πŸš€ Getting Started

book-capture helps you capture books from Kindle, Apple Books, or PDF and turn them into structured Markdown notes for Obsidian.

It uses screenshots, OCR, and Claude agents to pull text from your pages and build clean notes you can review later.

πŸ“₯ Download and Install

Open the download page here:

Visit the book-capture page

On Windows, use this page to get the latest release or package for your system.

After you download it, follow these steps:

  1. Save the file to your Downloads folder.
  2. Open the file you downloaded.
  3. If Windows asks for permission, choose Yes.
  4. Follow the on-screen setup steps.
  5. Finish the install or launch the app if it opens right away.

If the download comes as a ZIP file, right-click it and choose Extract All, then open the extracted folder and start the app from there.

πŸ–₯️ What You Need

book-capture is made for a normal Windows desktop or laptop.

Recommended setup:

  • Windows 10 or Windows 11
  • A recent version of Chrome or Edge
  • Claude Code set up on your machine
  • Enough storage for screenshots and note files
  • An Obsidian vault ready to save your notes

For the best results, keep your source app open while you capture pages.

✨ What book-capture Does

book-capture helps you move book content into a note system with less manual typing.

It can:

  • Capture pages from Kindle
  • Capture pages from Apple Books
  • Work with PDF pages
  • Use OCR to read text from screenshots
  • Build structured Markdown for Obsidian
  • Help separate quotes, summaries, and reading notes
  • Support a full capture flow from page to note

🧠 How It Works

The app follows a simple flow:

  1. You choose a source book or PDF.
  2. You capture the page or pages.
  3. OCR reads the text from the image.
  4. Claude agents clean and shape the content.
  5. The app builds Markdown notes.
  6. You save the notes in Obsidian or another folder.

This keeps your reading notes in a format that is easy to search, edit, and store.

🧰 Main Features

πŸ“· Screenshot capture

Take screenshots from book pages so the app can read them.

πŸ”Ž OCR text reading

Use macOS Vision-based OCR logic in the workflow to pull text from images.

πŸ“ Markdown output

Create structured Markdown files that work well in Obsidian.

πŸ“š Multi-source support

Capture from Kindle, Apple Books, and PDF files.

πŸ€– AI agent flow

Use two AI agents to help shape, clean, and structure the note output.

βš™οΈ Command-based control

Use the built-in commands to manage capture, review, and export steps.

🎯 Best Use Cases

Use book-capture if you want to:

  • Save important passages from books
  • Keep reading notes in Obsidian
  • Turn screenshots into text
  • Organize quotes by chapter or topic
  • Build a study archive from books and PDFs
  • Reduce manual copy and paste work

πŸͺŸ Windows Setup

book-capture is focused on a simple Windows user flow:

  1. Download the package from the link above.
  2. Extract it if it comes in a ZIP file.
  3. Open the app or launcher file inside the folder.
  4. Allow access if Windows shows a security prompt.
  5. Open your book source in Kindle, Apple Books, or a PDF reader.
  6. Start a capture from the app or command flow.

If you use Obsidian, set your vault folder first so the app knows where to save notes.

πŸ“ Output Files

The app creates notes in Markdown format.

You can expect files such as:

  • Page notes
  • Chapter notes
  • Quote blocks
  • Summary notes
  • Structured reading notes

These files are easy to move into Obsidian or another Markdown editor.

⌨️ Commands

book-capture includes 7 commands for the main workflow.

Common command types may include:

  • Start a new capture
  • Read text from a screenshot
  • Clean captured text
  • Format notes for Obsidian
  • Export the final Markdown file
  • Review the capture output
  • Reset or stop a capture session

Use the command that matches your task and follow the on-screen prompts.

πŸ”— Obsidian Setup

If you use Obsidian, point book-capture to your vault folder.

Good vault setup tips:

  • Use one folder for book notes
  • Keep one note per book
  • Add chapter headings for longer books
  • Store screenshots in a separate assets folder
  • Use tags for topic, author, and source

This keeps your reading notes easy to find later.

πŸ“– Supported Sources

Kindle

Use Kindle pages or screenshots as your source material.

Apple Books

Capture pages from Apple Books and turn them into Markdown notes.

PDF

Use PDF pages when you want to read from documents or ebooks.

Screenshot-based capture

If the text is on screen, book-capture can work from a screenshot-based flow.

πŸ› οΈ Troubleshooting

If the app does not start:

  • Check that the file finished downloading
  • Make sure you extracted the ZIP file first
  • Try running it again as administrator
  • Confirm that Windows did not block the file
  • Check that Claude Code is installed and ready

If capture looks wrong:

  • Use a clearer screenshot
  • Make sure the page is fully visible
  • Increase screen zoom if the text is too small
  • Try the capture again with one page at a time

If Markdown output looks plain:

  • Check your Obsidian folder path
  • Make sure the export step finished
  • Open the file in a Markdown editor to review the result

🧭 Simple First Run

If this is your first time using book-capture:

  1. Download it from the link above.
  2. Open the file or extract the archive.
  3. Set your output folder.
  4. Open a book page in Kindle, Apple Books, or a PDF viewer.
  5. Run the capture command.
  6. Review the generated Markdown note.
  7. Save it in Obsidian

πŸ” Privacy and Local Use

book-capture is meant for personal reading workflows.

A typical setup keeps your screenshots and notes on your own machine. That makes it easier to manage your book archive and keep your files in one place

🧩 File Organization Tips

Use a simple folder layout like this:

  • Books/
  • Books/Title/
  • Books/Title/assets/
  • Books/Title/notes.md

A clear folder setup makes it easier to keep notes tied to the right book.

🏷️ Topics

ai-agent, anthropic, apple-books, book-capture, claude-code, claude-code-plugin, kindle, markdown, obsidian, ocr

Releases

No releases published

Packages

 
 
 

Contributors