Skip to content

Latest commit

 

History

History
80 lines (65 loc) · 4.89 KB

readme_EN.md

File metadata and controls

80 lines (65 loc) · 4.89 KB
Raw

Brief Introduction

KindleEar is a web application to aggregate RSS for generating periodical mobi/epub file with images and send it to your kindle or your email automatically.

The features included:

  • Support calibre-like recipe file to aggress unlimited RSS or webpage.
  • Support custom RSS, only title/url are needed, don't need to program.
  • With account management, support several kindles.
  • Generate periodical mobi/epub file with images.
  • Deliver news feeds to your kindle daily automatically.
  • Built-in shared library, can share links with others and subscribe links from others.
  • Website support multi-languages.
  • Powerful and convenient mail-transfering service.
  • Integration with Evernote/Pocket/Instapaper.

Deployment

  1. Create a Google account and Turn on Access for less secure apps.

  2. Create an application.

  3. Install Python 2.7.x.

  4. Install GAE SDK. note: choose some version before 273.0.
    google-cloud-sdk-273.0.0-windows-x86_64-bundled-python.zip google-cloud-sdk-273.0.0-darwin-x86.tar.gz google-cloud-sdk-273.0.0-darwin-x86_64.tar.gz google-cloud-sdk-273.0.0-linux-x86.tar.gz google-cloud-sdk-273.0.0-linux-x86_64.tar.gz google-cloud-sdk-273.0.0-windows-x86-bundled-python.zip google-cloud-sdk-273.0.0-windows-x86.zip google-cloud-sdk-273.0.0-windows-x86_64.zip

  5. Download KindleEar and uncompress it into a directory for example: c:\kindleear.

  6. Modify some variable in app.yaml/module-worker.yaml/config.py.

File To be changed Description
app.yaml application Your Application Id
module-worker.yaml application Your Application Id
config.py SRC_EMAIL Your Gmail Address
config.py DOMAIN [email protected]
config.py TIMEZONE Your timezone

the lines 'application' and 'version' in yaml have to be commented if you will deploy it by using gcloud.

  1. Deployment

    • Delete the first two lines of app.yaml and module-worker.yaml [application and version]
    • gcloud auth login
    • gcloud config set project YourApplicationId
    • gcloud app deploy --version=1 KindleEarFolder\app.yaml KindleEarFolder\module-worker.yaml
    • gcloud app deploy --version=1 KindleEarFolder
    • [If some error after deployment.] gcloud datastore indexes create index.yaml gcloud app deploy --version=1 app.yaml queue.yaml gcloud app deploy --version=1 app.yaml cron.yaml gcloud app deploy --version=1 app.yaml dispatch.yaml

  2. After finished, you can open the website 'http://appid.appspot.com' (appid is the name of your application),
    For example the author's site: http://kindleear.appspot.com
    The initial username is 'admin', password is 'admin', please change the password immediately after first login.

  3. More details could be found in FAQ.

Deployment simplified

If you don't want to intall GAE SDK and python, you have another choice.
Reference code repository https://github.com/bookfere/KindleEar-Uploader and tutorial https://bookfere.com/post/19.html#ke_2_1 (in Chinese, but you can translate it by Google).
This method can be deployed directly in the console window of the GAE background.

License

KindleEar is Licensed under the AGPLv3 license.

Contributors