For English users, there is a fork and a nice post.
для русскоязычных пользователей здесь есть fork.
这是个Kindle的KUAL
插件,实现了邮箱推送功能,类似于亚马逊的Send-to-Kindle
,但是并不依赖于在亚马逊官方注册的@kindle.com
邮箱,而可以使用任意第三方邮箱。在使用本插件前请确保你已经把设备越狱而且安装了KUAL
和Python3
。实际上,本插件的主体功能仅使用Python3
的标准库完成,src
文件夹里的程序可以运行于任何安装了Python3
的操作系统或平台。
- 支持通过邮件附件推送文件
- 支持通过在邮件里填写文件下载链接推送文件。这有时更方便而且可以突破邮箱的文件大小的限制
- 支持以压缩包的方式推送,插件会自动完成解压,支持zip, tar, gztar, bztar等格式
- 支持在邮件中指定文件要保存的路径或文件名
- 不同于亚马逊官方服务,我们没有“已认可的发件人”或其它白名单的概念,任何邮箱都可以向你推送文件
- 不同于亚马逊官方服务,我们支持推送任意格式的文件到任意目录(不限于图书),插件不会进行检测,除了压缩包解压也不会进行任何格式转换
这里可能会有一些安全隐患(例如可以通过这种方法推送固件升级的文件),所以你最好申请一个名称相对复杂的邮箱并且不要公开。另外,你可以在config.json
文件中为root
设置一个更严格的路径,邮件推送的文件将不允许下载到root
目录及其子目录之外的地方。
- 注册一个新邮箱账户,很多邮箱限制颇多而配置繁琐,或者垃圾邮件判定严格。建议使用outlook邮箱,可以简化后续设置。请不要和其他重要账户使用同一个密码,因为MailPush采用了不安全的明文存储!
- 在邮箱管理页面开启
IMAP
服务。不同邮箱的方法不同,如outlook邮箱默认开启,无需进一步设置;而新注册的QQ邮箱则需要14天后才能开启;某些邮箱(例如Yahoo、Google、QQ)还需要你创建专门的应用程序密码(授权码),使用常规密码将登录失败,插件将无法正常工作。 git clone
本项目或前往发布页面下载压缩包并解压到你电脑的任意目录下。最外层的文件夹可以重命名。- 在
MailPush/src
文件夹里找到并编辑config.json
文件:- 将
user
改为刚刚申请的新邮箱 - 将
password
改为登录密码(也可能是IMAP授权码)。注意不要泄露config.json
文件给他人! - 将
host
、port
改为你邮箱服务商的IMAP host和port。outlook邮箱无需修改,其他邮箱则可以参考文末的对照表 - 其它参数按需修改(可选):
downloaddir
为默认下载路径,root
为允许写入的目录。root
默认为Kindle USB磁盘根目录(/mnt/us/),请谨慎修改。maxage
为下载几天内的邮件,maxnum
为一次最多下载几封邮件,mailbox
和criteria
是邮件类型,这些选项配置了菜单中Fetch emails via config.json (custom)
的功能
- 将
- 通过USB把
MailPush
文件夹复制到你Kindle设备根目录下的extensions
目录中。 - 安全弹出你的设备,现在可以在KUAL菜单里找到
MailPush
。
- 用其它邮箱向你填在
config.json
中的邮箱发邮件- 可以添加任意附件
- 主题或正文都可以为空
- 主题或正文都可以包括多行
- 主题或正文的一行可以是一个或多个文件下载链接,多个链接可用空格或
|
隔开,或者分别用<
和>
框住,注意不可以用逗号或分号分隔。 - 主题或正文的一行可以以
saveto
关键字开头,用于指定下载到Kindle中的路径或文件名,多个文件名用|
隔开,或者分别用<
和>
框住,注意不可以用空格、逗号或分号分隔。缺省路径通过参数downloaddir
配置,默认是/mnt/us/documents/downloads
。格式如:saveto abc.pdf
# 意为第一个文件保存到 /mnt/us/documents/downloads/abc.pdfsaveto books/
# 意为第一个文件保存到 /mnt/us/documents/downloads/books/ 中,文件名不变saveto /mnt/us/123.epub
# 意为第一个文件保存到 /mnt/us/123.epubsaveto abc.pdf | ../def.pdf
# 意为前两个文件分别保存到 /mnt/us/documents/downloads/abc.pdf 和 /mnt/us/documents/def.pdf
- 在Kindle上打开KUAL,在菜单中找到
MailPush
。点击Fetch unread emails
可以获取未读,或点击Fetch newest emails
可以获取最新邮件中的文件。
- 点击KUAL菜单按钮
View log
和View results
可以查看运行日志和结果。也可以USB连接Kindle到电脑,查看extensions/MailPush/
目录中的log.txt
和result.txt
- 如果在屏幕顶端看不到任何提示,或者它们显示的位置不合适,可以在电脑上修改文件
COL.txt
中的数字,例如从10改到20可以让显示更靠右。 - 如果提示
Operation failed
,请先检查log.txt
中的内容。检查Python3
的安装状态及config.json
中的配置(如password
)。 - 手动登录你填在
config.json
的邮箱,检查是否收到了邮件,必要时把发送者加入白名单。注意登录查看会使得未读邮件变已读,Fetch unread emails
会忽略这些邮件,可以点击Fetch newest emails
来测试。 - 设备的时钟错误可能会导致连接失败,请在Kindle设置里为其设置正确的时间。
- 如果屏幕上方长时间跳动
Fetching...
或提示Time out
,则可能是网络问题。可以点击Fetch newest emails
重试。 - 如果提示
Operation success
却找不到文件,请先依result.txt
中的路径检查文件,如果没有任何下载则可以点击Fetch junk mails
,尝试在垃圾邮件中寻找。 - 如果文件已下载但没有出现在你的图书馆中,请确认文件位于
/mnt/us/documents
及其子目录中,确认文件类型(后缀名)是Kindle支持的格式。确认无误后可以尝试重启设备。
邮箱类型 | host | port |
---|---|---|
gmail | imap.gmail.com | 993 |
yahoo | imap.mail.yahoo.com | 993 |
outlook | outlook.office365.com | 993 |
hotmail | outlook.office365.com | 993 |
imap.qq.com | 993 | |
126 | imap.126.com | 993 |
163 | imap.163.com | 993 |
yeah | imap.yeah.net | 993 |
sina | imap.sina.com | 993 |
- kindle-filebrowser 网页文件管理器
- MailPush 使用第三方邮箱推送文件
- BlockKindleOTA 阻止Kindle升级
- KOSSH WiFi连接的轻量ssh服务器
- ShuffleSS 打乱锁屏图片顺序