Skip to content
πŸ’» CLI tool to send webpages to kindle. πŸ“”
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
webkin
.gitignore
LICENSE
MANIFEST.in
README.md
README.rst
requirements.txt
setup.py

README.md

webkin

GitHub license saythanks

webkin lets you send webpages to your kindle device through terminal.

Note : Python3+ only.

Installation :

pip install webkin

asciicast

Avilable commands :

To parse URL and send it to your kindle email id.

webkin --url

To change the default directory.

 webkin --url=<url> --path=</path/to/your/place>

Example :

webkin -u=https://medium.com/@mrkaran/my-development-setup-7e767d33fc41 --verbose`

img

Pre Installation

webkin depends on calibre CLI tools and uses ebook-convert to convert html to mobi format. Please ensure that you have Calibre installed alongwith CLI tools and ebook-convert is present in your PATH.

For OSX users, you don't need to do anything besides installing Calibre. I have tested it on Ubuntu 16.04 fresh VM and after installing Calibre, it worked fine. If you install using this method, you need to manually add ebook-convert to your path, while if you install it from PPA, it's automatically in your PATH.

sudo add-apt-repository ppa:n-muench/calibre2
sudo apt-get update
sudo apt-get install calibre

Source

First Time Setup

You need to export tokens to add your Amazon Email Address (should be present in your Approved Personal Document Email List ), Kindle Email Address, Mercury Web Parser API Key ,SMTP Hostname and SMTP Port. The first time setup will guide you on how to do that.

  • To obtain your Mercury Web API key, signup here
  • If you're using GMail, you need to add smtp.gmail.com as your SMTP_Host_NAME while the default port is 587 so you can skip adding that. If you're using any other email provider, you can find a comprehensive list over here and add accordingly
  • If you're using GMail and have turned on 2FA (which you must absolutely), you rather need to add an Application Password instead of your email password. Set a new one over here

Credits

Contributing

Feel free to report any issues and/or send PRs for additional features.

Why?

Well, there are a couple of tools to already do this task, but I couldn't find any Open source tool which does it. Though Kindle uses a MOBI format which itself is closed source, I found the need of a CLI application to automate this boring task for me. If you're looking for a tool to do this but don't wanna use a terminal, you can also take a look at this chrome extension. I like my stuff in the Terminal so I did it :)

License

MIT Β© Karan Sharma LICENSE included here

You can’t perform that action at this time.