kindle-transfer

a simple GUI script to quickly email any ebook to a Kindle.

supports acsm, epub, pdf, and mobi.

I made this script because I found reading ebooks from the library very difficult...

Example

example.mp4

Installation

!! WARNING !!

At the moment this script is only for Linux with X or Wayland.

1. first, install the dependencies kdialog gourou calibre mailutils ssmtp

the steps to install them may vary depending on your system.

for example, on arch with the paru AUR helper:

paru -S kdialog gourou calibre mailutils ssmtp

IF YOU ALREADY HAVE MAIL SET UP, SKIP TO STEP 4 !

2. if you do happen to be using a gmail address, you'll have to enable 2FA and add an app password

   to do this, first go to the google account security page and search for "2-Step Verification" and follow the prompts to enable 2FA.

   next, go back to the security page and search for "App Passwords"

   add an "Other" app like so:

   

   once you name it to anything you like, hit "GENERATE".

   

   now copy the generated password. we'll use it as our password in the next step.

3. we need to edit the config files for SSMTP. run sudo with your favorite text editor to edit /etc/ssmtp/ssmtp.conf

for example, sudo vim /etc/ssmtp/ssmtp.conf

what we need to do here is change the lines here as follows:

root=foo@bar
mailhub=smtp.bar:587
AuthUser=foo@bar
AuthPass=password
UseTLS=YES
TLS_CA_File=/etc/ssl/certs/ca-certificates.crt
UseSTARTTLS=YES
FromLineOverride=YES

where foo is your email prefix and bar is the website and password is your gmail app password that you just generated.

4. you might have to go to this link to whitelist your main email address so we can use it to send files from.

5. we need to find the kindle's email address.

on the kindle, swipe down from the top of the screen to bring up the menu and go to "All Settings"

here, go to "Your Account", then copy down the "Send-to-Kindle" email address

6. now edit the kindle-transfer script from this repo. and change

EMAIL="[email protected]"

to your kindle's email address (as we found in the previous step)

7. also change this line

EBOOK="~/ebook"

to the location on your computer where you store ebooks.

this will also be where they will be saved.

8. lastly, activate adept by running adept_activate --anonymous in a terminal.

9. you should now be all set to run kindle-transfer!

Usage

WIP