Documentation

Get started with Kindleify

Installation

Install Kindleify using your preferred package manager:

pip
$pip install kindleify
pipx
$pipx install kindleify
uv
$uvx kindleify

Configure Your Kindle Email

Before sending documents, you need to set up your Kindle email credentials. This stores your configuration locally for future use.

$kindleify config set
Required Step

Before running this command, you must add your sender email to Amazon's Approved Personal Document Email List:

  1. Go to amazon.in/myk (or your regional Amazon site)
  2. Navigate to Preferences → Personal Document Settings
  3. Scroll to the bottom and find 'Approved Personal Document Email List'
  4. Add the email address you'll be sending from (e.g., your Gmail address)

Convert URL to EPUB

Convert any web page to a clean, readable EPUB format:

$kindleify url https://article.com/great-read -o book.epub

Convert PDF to EPUB

Transform PDF documents into EPUB format for better Kindle reading:

$kindleify pdf document.pdf -o book.epub

Send to Kindle

Send your EPUB directly to your Kindle via email. This uses the credentials you configured earlier:

$kindleify send book.epub

Configuration Commands

kindleify config set

Set up your Kindle email credentials

kindleify config show

View current configuration (password masked)

kindleify config clear

Remove stored credentials