Skip to main content

Gutenberg2Kindle

A small Python tool to download and send ebooks from Project Gutenberg to a Kindle email address via SMTP

What's this?

gutenberg2kindle is a small command-line interface tool that aims to automatically download an .epub book from Project Gutenberg's library of free books in the public domain, and then send the ebook's file to a Kindle email address (although, generally, it can be sent to any email address), with just one command.

The book is sent through a SMTP server with TLS, requiring the user to configure the server settings beforehand via tool commands.

Installation

You can use your Python package manager (e.g. pip) to install gutenberg2kindle.

pip install gutenberg2kindle

Usage

gutenberg2kindle comes with a command-line interface; its help text can be accessed via:

gutenberg2kindle --help

You can check the tool's current configuration via:

# will print all config variables with their current values
gutenberg2kindle get-config

# will print only the value for the key you're specifying
gutenberg2kindle get-config --name <key name>

You can set a value for any of the settings via:

gutenberg2kindle set-config --name <key name> --value <key value>

Or you can do it all at once interactively, being able to check (and modify, if needed) the current config, just by running:

gutenberg2kindle interactive-config

Finally, once you're done configuring your project, you can send any ebook via its Project Gutenberg book ID (with flags -b or --book-id):

gutenberg2kindle send -b <book id as an integer, e.g. 1>

You can send multiple books at the same time in the same run, the -b / --book-id flag accepts multiple arguments. Book will be downloaded and sent one by one, and if the download fails at some point execution will stop. In case you want to skip books that couldn't be downloaded, consider adding the -i / --ignore-errors flag.

gutenberg2kindle send -b <first book id> [<second book id> <third book id>...]
gutenberg2kindle send -i -b <first book id> [<second book id> <third book id>...]

Note that, if using Gmail as your SMTP server, you might need to set up an App Password to use instead of your regular password.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Contributions for issues that are already open by maintainers are welcome and encouraged.

Please make sure to update tests as appropriate; a minimum coverage of 85% is expected (and enforced by Github Actions!).

License

This project is licensed under the GNU Affero General Public License v3.0.

Metadata

Release files for gutenberg2kindle 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gutenberg2kindle 0.8.1
File Size Uploaded Provenance Actions
gutenberg2kindle-0.8.1.tar.gz 18.3 kB Without provenance Details for gutenberg2kindle-0.8.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gutenberg2kindle 0.8.1
File Interpreter ABI Platform Actions
gutenberg2kindle-0.8.1-py3-none-any.whl Python 3 none any Details for gutenberg2kindle-0.8.1-py3-none-any.whl

Total release size: 39.0 kB

Release files / gutenberg2kindle-0.8.1.tar.gz

Download URL gutenberg2kindle-0.8.1.tar.gz
Size 18.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6a75fa463635eb18d08d23f361f3ed17c9de237993f4c26cc9af324c365fb5d7
BLAKE2b-256 checksum
How to use checksums
6b2c074cfb336cde3277b46727f93a057c0072726f84a58c592aafe70ddc854d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / gutenberg2kindle-0.8.1-py3-none-any.whl

Download URL gutenberg2kindle-0.8.1-py3-none-any.whl
Size 20.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
120322d4600d084fcc4fab4ff89cb2b23126646de7820a2b84fd25d65e98b5a9
BLAKE2b-256 checksum
How to use checksums
cca1133d65b4e9c1d66f0a6edc1d4c125eb38d64d8f74d4343daf436bc47d6eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Security for gutenberg2kindle 0.8.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page