By

Contents
  1. 1. Introudction
  2. 2. Build
    1. 2.1. Install Google Cloud SDK
    2. 2.2. Upload kindleear
  3. 3. TroubleShooting

  Nowdays, many people have their kindles, but lots of them tended to throw their machines in their lockers after losting their enthusiasm or dindn’t have too much time to read books. While others may want to use their kindles not just to read books or magzines but other stuffs like news, but web surfing can be hard on kindle cause it’s low refresh rate. So how can we make more use of our kindles without wasting our precious time. The answer is using kindle to view some news, blogs and other articals you usually view on your mobiles or computers. But now you would wonder how cause kindle’s low refresh rate as we speak before. The solution is KINDLEEAR.

Introudction

  Kindleear is a opensource application running in Google app engine, it can transfer your rss to mobi files by using python, then automatically delivery to your kindles, it also has multilanguages supported.

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 dialy automatically.
  • Website support multi-languages.
  • Powerful and convenient mail-transfering service.
  • Integration with Evernote/Pocket/Instapape

Build

So let’s look how to build it on your google app engine.

Install Google Cloud SDK

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# open your teminal (Mac ,Linux, Windows).
$ wget https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-139.0.1-darwin-x86_64.tar.gz
# this is Google Cloud SDK for Mac download address, you can find Linux or Windows versions on this: https://cloud.google.com/sdk/docs/
$ tar -xzvf google-cloud-sdk-139.0.1-darwin-x86_64.tar.gz
$ cd google-cloud-sdk
$ chmod +x install.sh
$ ./install.sh
# if you build this on windows, 
$ dir google-cloud-sdk
$ install.bat
$ hit the Enter
$ type "yes" when you meet the questions.
$ gcloud components install app-engine-python

Upload kindleear

  • Download kindleear from https://codeload.github.com/cdhigh/KindleEar/zip/master
  • Unzip it and move the fold to ~/Apllication
  • open the fold and modify some variables as follow:
    File variable changed Description
    app.yaml application Your Apllication ID
    module-worker.ymal application Your Apllication ID
    config.py SRC_EMAIL Your Gmail Address
    config.py DOMAIN appid@appspot.com
    config.py TIMEZONE Your Timezone 
1
2
3
$ cd ~/Application
$ python appcfg.py update KindleEarFolder\app.yaml KindleEarFolder\module-worker.yaml
$ python appcfg.py update KindleEarFolder
  • After finished, you can open the website http://appid.appspot.com (appid is the name of your application).
  • The initial username is ‘admin’, password is ‘admin’, please change the password immediately after first login.
  • You can create multiple accounts, but since your google app engine account is a free version with limited resourses, so I do not recommend you to create too many accouts.
  • Now you can login into your account and add your rss. Enjoy It !

TroubleShooting

  • “Command not found: gcloud” :
      when execute “gcloud components install app-engine-python during Installing Google Cloud SDK, just execute “./install.sh”(MAC or Linux) or “install.bat”(Windows) again and make sure the ‘gcloud’ command being wtritten to the right file（like .bash_profile）, or paste by yourself:
1
2
3
4
5
6
if [ -f /Users/jeff/Downloads/google-cloud-sdk/path.bash.inc ]; then
	source '/Users/jeff/Downloads/google-cloud-sdk/path.bash.inc'
fi
if [ -f /Users/jeff/Downloads/google-cloud-sdk/completion.bash.inc ]; then
	source '/Users/jeff/Downloads/google-cloud-sdk/completion.bash.inc'
fi
Contents
  1. 1. Introudction
  2. 2. Build
    1. 2.1. Install Google Cloud SDK
    2. 2.2. Upload kindleear
  3. 3. TroubleShooting