kindle-pdf-capture
Capture Kindle for Mac pages via screen recording and build a high-quality PDF (with optional OCR).
Features
- Automatic content-region detection (strips window chrome, title bar, and Kindle header)
- Background capture via Quartz — no need to keep Kindle in the foreground
- Smart page-turn detection (frame-diff polling, no fixed sleep)
- LTR and RTL (manga) support via
--direction - Book-like PDF page sizing (300 DPI default)
- Optional OCR text layer via Tesseract (for non-macOS viewers; macOS Live Text works without it)
- End-of-book auto-detection (duplicate-frame streak)
- Manual cover-region selection via
--manual-crop(drag-to-select UI for books with all-white covers)
Quick start
# Install (without OCR)
uv sync
# Install with OCR support
brew install tesseract tesseract-lang ghostscript
uv sync --all-extras
# Capture a book (open Kindle to the first page first)
uv run kpc --out output/my-book
# Capture a right-to-left book (manga)
uv run kpc --out output/my-manga --direction left
# Capture with OCR (requires --all-extras install above)
uv run kpc --out output/my-book --ocr
# Capture a book with an all-white cover (manual region selection)
uv run kpc --out output/my-book --manual-crop
# See all options
uv run kpc --help
Documentation
- Installation · インストール
- Usage · 使い方
- macOS permissions · macOS 権限
- Architecture · アーキテクチャ
- Troubleshooting · トラブルシューティング
- Legal · 法的事項
License
MIT — see LICENSE.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kindle_pdf_capture-1.4.2.tar.gz
(193.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kindle_pdf_capture-1.4.2.tar.gz.
File metadata
- Download URL: kindle_pdf_capture-1.4.2.tar.gz
- Upload date:
- Size: 193.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e5291a2782545eb1e59171239eb299022ab3a2ad5bce85a5829d4c29e5d5a0b
|
|
| MD5 |
8a25b9b88ad8afb7c2938bfbe9f0c6c2
|
|
| BLAKE2b-256 |
4800a923c95feb945dcbb96fd77f0beb84f3ca49ffea8e10bd159ded6489f56c
|
File details
Details for the file kindle_pdf_capture-1.4.2-py3-none-any.whl.
File metadata
- Download URL: kindle_pdf_capture-1.4.2-py3-none-any.whl
- Upload date:
- Size: 40.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f973dd2530bdde7e1a6f1275d14e0d6b0351b87c275a844faf89858d64903a09
|
|
| MD5 |
9deefdc9c7b7338c6d01746879a70124
|
|
| BLAKE2b-256 |
355723832bb6a952da563d460716e5d801f74acd3407842449f0bfd0aef4629f
|