Skip to main content

Send webpages to your Kindle through terminal

Project description


|GitHub license|

webkin lets you send webpages to your kindle device through
terminal. Note : Python3+ only.

Installation :

``pip install webkin``


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= --verbose``

.. figure::
:alt: 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 ```` 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 <>`__


- `calibre <>`__
- `Mercury Web Parser <>`__
- [@sathyabhat](\_dl/
for his clean implementation of fetching tokens in a CLI program,
which I have shamlelessly adapted for webkin.


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
`this <>`__
chrome extension. I like my stuff in the Terminal so I did it :)


MIT © Karan Sharma

`LICENSE included here <LICENSE>`__

.. |GitHub license| image::
.. |asciicast| image::

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for webkin, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size webkin-1.0.3.tar.gz (7.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page