MobileRead Forums - View Single Post - BooksByMail extension - Send ebooks over mail without an Amazon account

uniqdom · 07-17-2017, 12:53 AM

Hello, I have been working on a extension that allows you to send books to your device using an email, but without the need of an Amazon account.

Please, consider it as BETA software.

Requirements

You need a jailbroken Kindle Paperwhite 1 with v5.3.9 fw (may work with other models and firmwares, but not tested).
NiLuJe's Python update installed in the device.
KUAL installed.

Installation

Copy using a USB cable the folder 'bookbymail' into the folder 'extensions/'. If you want to do it over the network, copy the folder to '/mnt/us/extensions/'

Configuration

Edit the file BookByMail/etc/offlineimap.conf. Set your email provider, your account and password. Also change the parameter 'maxage' if you want to download books from mails that are older than two days. Keep in mind that you need enough space to download all those mails (they are removed after the operation is complete).
Edit the file BookByMail/etc/ebooksFormats to set the file extensions of the books that you want to download from your email to the device.
Store your passphrase to decrypt files in BookByMail/etc/passphrase.

How to send books to your device?

Use Calibre feature to send books over mail or just send you an email using your email client. There is no need for a subject or a body. Just attach your ebook. The filename of the ebook must be a valid FAT32 filename, so avoid strange symbols.
In your Kindle, open KUAL, and tap on BooksByMail.
It will take a little time to fetch the emails and unpack the attachments. Afterwards books will end up in your documents folder.

How to encrypt a book?

You may use GnuPG to encrypt the file. Just be sure to set the passhphrase in BookByMail/etc/passphrase to decrypt in your kindle.

To encrypt a book:

Code:

gpg --cipher-algo AES256 --output a.txt.gpg --symmetric a.txt

From there, just send filename.mobi.gpg to your mail. The extension '.gpg' is needed to know that the file is encrypted, and the extension '.mobi' (or another extension of supported books) is needed to know that the file is a supported book.

Restrictions

Only IMAP servers are supported, so, don't try POP servers.
Keep in mind that the max size of the book will be limited by the size of an attachment in your email account.
As the storage is in a FAT32 filesystem, don't use strange symbols in the filename of the ebook.

Contribute

Report if it works in other Kindle model/firmware
Report bugs
Send patches

You can find the project here.
https://github.com/mcastillof/BooksByMail

07-17-2017, 12:53 AM	#1
uniqdom Member Posts: 17 Karma: 2270 Join Date: Jul 2013 Device: Boox Max3	BooksByMail extension - Send ebooks over mail without an Amazon account Hello, I have been working on a extension that allows you to send books to your device using an email, but without the need of an Amazon account. Please, consider it as BETA software. Requirements You need a jailbroken Kindle Paperwhite 1 with v5.3.9 fw (may work with other models and firmwares, but not tested). NiLuJe's Python update installed in the device. KUAL installed. Installation Copy using a USB cable the folder 'bookbymail' into the folder 'extensions/'. If you want to do it over the network, copy the folder to '/mnt/us/extensions/' Configuration Edit the file BookByMail/etc/offlineimap.conf. Set your email provider, your account and password. Also change the parameter 'maxage' if you want to download books from mails that are older than two days. Keep in mind that you need enough space to download all those mails (they are removed after the operation is complete). Edit the file BookByMail/etc/ebooksFormats to set the file extensions of the books that you want to download from your email to the device. Store your passphrase to decrypt files in BookByMail/etc/passphrase. How to send books to your device? Use Calibre feature to send books over mail or just send you an email using your email client. There is no need for a subject or a body. Just attach your ebook. The filename of the ebook must be a valid FAT32 filename, so avoid strange symbols. In your Kindle, open KUAL, and tap on BooksByMail. It will take a little time to fetch the emails and unpack the attachments. Afterwards books will end up in your documents folder. How to encrypt a book? You may use GnuPG to encrypt the file. Just be sure to set the passhphrase in BookByMail/etc/passphrase to decrypt in your kindle. To encrypt a book: Code: gpg --cipher-algo AES256 --output a.txt.gpg --symmetric a.txt From there, just send filename.mobi.gpg to your mail. The extension '.gpg' is needed to know that the file is encrypted, and the extension '.mobi' (or another extension of supported books) is needed to know that the file is a supported book. Restrictions Only IMAP servers are supported, so, don't try POP servers. Keep in mind that the max size of the book will be limited by the size of an attachment in your email account. As the storage is in a FAT32 filesystem, don't use strange symbols in the filename of the ebook. Contribute Report if it works in other Kindle model/firmware Report bugs Send patches You can find the project here. https://github.com/mcastillof/BooksByMail Last edited by uniqdom; 10-22-2017 at 08:55 PM. Reason: Version 0.03 (beta). Added GnuPG