Skip to content

A website application running in Google app engine, deliver rss news to your kindle. generate mobi by using python, multilanguages supported.

Notifications You must be signed in to change notification settings

JasonQuu/KindleEar

 
 

Repository files navigation

Readme of english version refers to Readme_EN.md

#简介 这是一个运行在Google App Engine(GAE)上的Kindle个人推送服务应用,生成排版精美的杂志模式mobi/epub格式自动每天推送至您的Kindle或其他邮箱。

此应用目前的主要功能有:

  • 支持类似Calibre的recipe格式的不限量RSS/ATOM或网页内容收集
  • 不限量自定义RSS,直接输入RSS/ATOM链接和标题即可自动推送
  • 多账号管理,支持多用户和多Kindle
  • 生成带图的杂志格式mobi或带图的有目录epub
  • 自动每天定时推送
  • 强大而且方便的邮件中转服务
  • 和Evernote/Pocket/Instapaper等系统的集成

注:如果您要求不高,自定义RSS推送功能足以应付一般应用,如果要求排版和完美,可以参照books目录下的文件范本自己添加一个文件再重新上传即可,books目录下的书籍文件都不是随意预置的,每个文件都至少演示一个适用的books编写技巧。 在您懂python的前提下,您可以完全的操控网页,可以生成您需要的最完美的MOBI/EPUB文件。

#标准部署步骤

  1. 申请google账号 并暂时 启用不够安全的应用的访问权限 以便上传程序。

  2. 创建一个Application,注意不用申请GCE,那个是60天试用的,而GAE是限额范围内永久免费的。

  3. 安装 Python 2.7.x

  4. 安装 GAE SDK

  5. 下载 KindleEar ,解压到一个特定的目录。

  6. 在以下三个文件中修改一些参数:

文件 待修改内容 说明
app.yaml application 你的ApplicationId
module-worker.yaml application 你的ApplicationId
config.py SRC_EMAIL 创建GAE工程的GMAIL邮箱
config.py DOMAIN 你申请的应用的域名
  1. 转到GAE SDK安装目录(默认为:C:\Program Files\Google\google_appengine)

  2. 执行两条Cmd命令:

    • c:\python27\python.exe appcfg.py update kindleear目录\app.yaml kindleear目录\module-worker.yaml
    • c:\python27\python.exe appcfg.py update kindleear目录
  3. 全部完成后就可以尝试打开域名:
    http://appid.appspot.com (appid是你申请的application名字)
    比如作者的网站域名为:http://kindleear.appspot.com/
    注:初始用户名为 admin,密码为 admin,建议登录后及时修改密码。

  4. 更详细一点的说明请参照Github上的 FAQ 或作者网站的 FAQ 链接。有关部署失败,部署后"internal server error"等问题都有解释。
    不建议使用GAE Launcher部署KindleEar,除非你知道怎么设置Extra Flags等参数。

  5. 步骤已经说的很详细了,如果自己还是部署不成功,也可以选择直接捐赠给作者50块钱 (Wiki捐赠页面),然后将gmail地址和密码发给作者(先要提前关闭密码二步验证),作者负责帮你部署成功,并且设置好需要的RSS订阅源(如果后续有代码升级,可以免费帮忙升级)。有需要自定义抓取和分析其他网站的需求,也可以联系作者有偿实现。

#简化的部署步骤(推荐) 假如你不想安装python和GAE SDK,则可以:

  1. 下载KindleEar 并解压(改目录名为KindleEar)。
  2. 下载KindleEar-Uploader 并解压。
  3. 将KindleEar目录放到Uploader目录下,双击uploader.bat即开始上传,根据提示输入你的相关信息即可,在第一次成功部署之后,适用uploader再次升级KindleEar则不需要再次输入。
    此uploader仅适用于Windows系统。

#许可协议 KindleEar is licensed under the AGPLv3 license.
大体的许可框架是此应用代码你可以任意使用,任意修改,可以商用,但是必须将你修改后的代码开源并保留原始版权声明。

#捐赠 如果你希望支持一下KindleEar,可以戳 Wiki捐赠页面

About

A website application running in Google app engine, deliver rss news to your kindle. generate mobi by using python, multilanguages supported.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 97.2%
  • HTML 2.1%
  • Other 0.7%