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
uv tool install kindle-pdf-capture
# Capture a book (open Kindle to the first page first)
kpc --out output/my-book
# Capture a right-to-left book (manga)
kpc --out output/my-manga --direction left
# Capture a book with an all-white cover (manual region selection)
kpc --out output/my-book --manual-crop
# See all options
kpc --help
With OCR
OCR needs Tesseract and Ghostscript as system dependencies, plus the [ocr] extra:
brew install tesseract tesseract-lang ghostscript
uv tool install "kindle-pdf-capture[ocr]"
kpc --out output/my-book --ocr
Working on the project itself? The installation guide covers installing from source.
Documentation
- Installation · インストール
- Usage · 使い方
- macOS permissions · macOS 権限
- Architecture · アーキテクチャ
- Troubleshooting · トラブルシューティング
- Legal · 法的事項
License
MIT — see LICENSE.
1 maintainer
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.3.tar.gz
(195.1 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.3.tar.gz.
File metadata
- Download URL: kindle_pdf_capture-1.4.3.tar.gz
- Upload date:
- Size: 195.1 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 |
a48f4a347c166323d21954b251c0ad68ec83106a54e24a894ce69a6604b4878f
|
|
| MD5 |
2e33bdd94bc7a26476d2095741a53f97
|
|
| BLAKE2b-256 |
ddb8430e1cc3a325651dcd0e169e0f2827506526e4d29b6be31de689aaa36012
|
File details
Details for the file kindle_pdf_capture-1.4.3-py3-none-any.whl.
File metadata
- Download URL: kindle_pdf_capture-1.4.3-py3-none-any.whl
- Upload date:
- Size: 40.8 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 |
d291d9bd2e7567f0348ac336562b4632d9a9f60751666756435daa769ff9717d
|
|
| MD5 |
91cc802ee627d89b84191ec3ecba1fc4
|
|
| BLAKE2b-256 |
474601cb76e6c8a694196267b70f38c63ec1ccd9c71af8308e807330e57c24c9
|
