github_mirrors/Kindle_download_helper
1
0
Fork 0
mirror of https://github.com/yihong0618/Kindle_download_helper.git synced 2025-11-22 07:59:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #85 from shaonianche/main

Browse Source 
doc(README):update document structure
This commit is contained in:
yihong
2022-08-01 17:04:38 +08:00
committed by GitHub
parent efb51fc577 06d0034865
commit d1a94f3e2a
1 changed files with 79 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

139
README.md
View File

@@ -1,94 +1,115 @@
# Kindle_download_helper
Download all your kindle books script.
<img width="1661" alt="image" src="https://user-images.githubusercontent.com/15976103/172113700-7be0ae1f-1aae-4b50-8377-13047c63411b.png">
Use `--readme` command to generate readme file to memory your kindle journey.
## 安装 Kindle_download_helper
<img width="1120" alt="image" src="https://user-images.githubusercontent.com/15976103/174820597-5aca1065-8d39-4853-b89d-1b6fce658a98.png">
## 下载二进制文件
### GUI 程序下载
到 [Release](https://github.com/yihong0618/Kindle_download_helper/releases) 页面查看最新版本，获取对应系统的二进制文件下载解压即可。
若打开二进制遇到问题，请参考[这个 issue](https://github.com/yihong0618/Kindle_download_helper/issues/25)
### Help
## 无法下载问题
- 若打开二进制遇到问题，请参考 [#25](https://github.com/yihong0618/Kindle_download_helper/issues/25)
触发了亚马逊风控见 [issue](https://github.com/yihong0618/Kindle_download_helper/issues/69)
- kindle 无法下载问题，触发了亚马逊风控见 [#69](https://github.com/yihong0618/Kindle_download_helper/issues/69)
## Cli
- Mac 新手指南 by @chongiscool，见 [#76](https://github.com/yihong0618/Kindle_download_helper/issues/76)
### Cli 安装使用
1. python3
2. requirements
```python
python3 --version #查看 python 版本
```
```bash
git clone https://github.com/yihong0618/Kindle_download_helper.git && cd Kindle_download_helper
```
```python
pip3 install -r requirements.txt
```
<details>
<summary> Mac 新手指南</summary>
```python
python3 kindle.py --h #查看使用参数
Added by [chongiscool](https://github.com/chongiscool)
usage: kindle.py [-h] [--cookie COOKIE | --cookie-file COOKIE_FILE] [--cn] [--jp] [--de] [--resume-from INDEX]
[--cut-length CUT_LENGTH] [-o OUTDIR] [-od OUTDEDRMDIR] [-s SESSION_FILE] [--pdoc] [--resolve_duplicate_names]
[--readme] [--dedrm] [--list]
[csrf_token]
基于我的环境和编程背景，我想补充下，没有 Python 经验的程序员，如何使用该开源库。
positional arguments:
csrf_token amazon or amazon cn csrf token
```txt
环境：macOS Catalina 10.15.7
我的编程背景：Android 开发者，使用 Java 和 Kotlin。「 Python3 学过基础语法，**没用 Python3 写过项目** 」
Kindle：我有一台 paperwhite 2
options:
-h, --help show this help message and exit
--cookie COOKIE amazon or amazon cn cookie
--cookie-file COOKIE_FILE
load cookie local file
--cn if your account is an amazon.cn account
--jp if your account is an amazon.jp account
--de if your account is an amazon.de account
--resume-from INDEX resume from the index if download failed
--cut-length CUT_LENGTH
truncate the file name
-o OUTDIR, --outdir OUTDIR
dwonload output dir
-od OUTDEDRMDIR, --outdedrmdir OUTDEDRMDIR
dwonload output dedrm dir
-s SESSION_FILE, --session-file SESSION_FILE
The reusable session dump file
--pdoc to download personal documents or ebook
--resolve_duplicate_names
Resolve duplicate names files to download
--readme If you want to generate kindle readme stats
--dedrm If you want to `dedrm` directly
--list just list books/pdoc, not to download
```
针对 README.md 的教程，自己如何在 [ **命令行** ] 的环境下，来下载电子书？
- 第一步：clone 仓库到下载目录(`~/Downloads`) ；再安装依赖 `cd ~/Downloads/Kindle_download_helper ; pip3 install -r requirements.txt --user`
- 第二步：打开 国内（amazon.cn）[电子书所有内容](http://amazon.cn/)（需要登录自己账户）的页面，按 F12
- 获取 cookie ：Network -> Fetch/XHR -> Refresh(Cmd + R) -> 点击任意一个 ajax -> Headers -> Request Headers -> Cookie -> 右键复制它 -> 在 Kindle_download_helper 目录中，新建 cookie_file.txt 来保存 cookie 。
- 获取 CSRF token : Headers 右边 -> Payload -> csrfToken -> 右键复制它。
- 第三步：下载书籍 `python3 kindle.py --cn --cookie-file ./cookie_file.txt your_csrf_Token`
可能的疑问：
1. 为什么安装依赖要加`--user`，可能是权限的问题，于是我按照命令行输出的提示，添加的，就安装依赖成功了；
2. 你应该始终，在 Kindle_download_helper 目录下，执行命令(`python3 kindle.py ***`)。
3. cookie 保存在 Kindle_download_helper/cookie_file.txt 中，方便命令行输入 和 cookie的更新，但**如果你要 PR，务必删除 ./cookie_file.txt，以免泄露个人账户信息**。
### 下载 kindle 书籍
----------------------------- 分割线 -----------------------------
[自动获取 cookie](#自动获取_cookie) ，尝试自动获取 cookie、csrfToken 进行下载
受[#41](https://github.com/yihong0618/Kindle_download_helper/issues/41))自动化的启发，如果你有 Shell 脚本的知识，也可以自行写个如下**半自动化**参考脚本；但前提，依然是你得准备好 cookie 和 csrf_token 。
```bash
#!/bin/bash
cd ~/Downloads
git clone https://github.com/yihong0618/Kindle_download_helper.git
cd ~/Downloads/Kindle_download_helper
pip3 install -r requirements.txt --user
# save cookie in ./cookie_file.txt
python3 kindle.py --cn --cookie-file ./cookie_file.txt your_csrf_Token
```python
python3 kindle.py --dedrm --cn ## --dedrm 移除 DRM
```
</details>
(推荐) 手动输入 cookie、csrfToken 进行下载
## 推荐手动输入 cookie
```python
python3 kindle.py ${csrfToken} --cookie ${cookie} --dedrm --cn #下载国区 Kindle 书籍并移除 DRM
python3 kindle.py ${csrfToken} --cookie ${cookie} --dedrm #下载美区 Kindle 书籍
```
### 手动输入 cookie
### 获取 cookie
若默认情况下提示 cookie 无效，你也可以手动输入 cookie 。方法是在上述全部书籍列表页面，按 <kbd>F12</kbd> 或右键点击——检查，进入网络面板(Network)，找到任意一个 `ajax` 请求，复制请求头里的 Cookie 即可。同时也能在 Payload 里找到 csrfToken。
若默认情况下提示 cookie 无效，你也可以手动输入 cookie。
在上述 [全部书籍](https://www.amazon.cn/hz/mycd/myx#/home/content/booksAll/dateDsc/) 列表页面，按 `F12` 或右键点击——检查，进入网络面板 (Network)，找到任意一个 `ajax` 请求，复制请求头里的 `Cookie` 即可。同时也能在 Payload 里找到 `csrfToken`。
然后，执行 `python3 kindle.py --cookie ${cookie}`。
然后，执行
```python
python3 kindle.py --cn --cookie ${cookie}
```
你也可以把 cookie 保存为文本文件，执行 `python3 kindle.py --cookie-file ${cookie_file}` 下载书籍。
### 手动输入 CSRF Token
### 获取 CSRF Token
或执行过程中提示获取 CSRF token 失败，你可以手动输入 CSRF Token。CSRF Token 可以在页面源码中找到。方法是在浏览器书籍列表页面右键点击，选择查看网页源码，再利用文本匹配工具 (Ctrl + F) 查找 `csrfToken`，将等号右边引号中的值复制出来，加到命令行参数中：
若执行过程中提示获取 CSRF token 失败，你可以手动输入 CSRF Token。
```
`CSRF Token` 可以在页面源码中找到。在 [全部书籍](https://www.amazon.cn/hz/mycd/myx#/home/content/booksAll/dateDsc/) 列表页面右键点击，选择查看网页源码，再利用文本匹配工具 (Ctrl + F) 查找 `csrfToken`，将等号右边引号中的值复制出来，加到命令行参数中。
```python
# CSRF Token
python3 kindle.py ${csrfToken}
python3 kindle.py --cn ${csrfToken}
# Both cookie and CSRF Token
python3 kindle.py --cookie ${cookie} ${csrfToken}
python3 kindle.py --cn --cookie ${cookie} ${csrfToken}
```
## 自动获取 cookie
@@ -98,24 +119,24 @@ python3 kindle.py --cookie ${cookie} ${csrfToken}
### 使用 `amazon.cn`
1. 登陆 amazon.cn
2. 访问 https://www.amazon.cn/hz/mycd/myx#/home/content/booksAll/dateDsc/
2. 访问 <https://www.amazon.cn/hz/mycd/myx#/home/content/booksAll/dateDsc/>
3. 右键查看源码，搜索 `csrfToken` 复制后面的 value
4. 执行 `python3 kindle.py --cn`
5. 如果下载推送文件 `python3 kindle.py --cn --pdoc`
5. 如果想直接 dedrm 解密(不保证好用) `python3 kindle.py --cn --pdoc --dedrm`
5. 如果想直接 dedrm 解密 (不保证好用) `python3 kindle.py --cn --pdoc --dedrm`
### how to `amazon.com`
1. login amazon.com
2. visit https://www.amazon.com/hz/mycd/myx#/home/content/booksAll/dateDsc/
2. visit <https://www.amazon.com/hz/mycd/myx#/home/content/booksAll/dateDsc/>
3. right click this page source then find `csrfToken` value copy
4. run: `python3 kindle.py`
5. if is doc file `python3 kindle.py --pdoc`
### how to `amazon.de`
### how to `amazon.de`
1. login amazon.com
2. visit https://www.amazon.de/hz/mycd/myx#/home/content/booksAll/dateDsc/
2. visit <https://www.amazon.de/hz/mycd/myx#/home/content/booksAll/dateDsc/>
3. right click this page source then find `csrfToken` value copy
4. run: `python3 kindle.py --de`
5. if is doc file `python3 kindle.py --de --pdoc`
@@ -123,7 +144,7 @@ python3 kindle.py --cookie ${cookie} ${csrfToken}
### `amazon.jp` を使用する
1. amazon.co.jp にログインする。
2. ホームページ https://www.amazon.jp/hz/mycd/myx#/home/content/booksAll/dateDsc/）にアクセスする。
2. ホームページ <https://www.amazon.jp/hz/mycd/myx#/home/content/booksAll/dateDsc/>）にアクセスする。
3. ソースコード上で右クリックし、`csrfToken`を検索して、それ以降の値をコピーします。
4. `python3 kindle.py --jp` を実行する。
5. プッシュファイルをダウンロードする場合 `python3 kindle.py --jp --pdoc`
@@ -137,7 +158,7 @@ python3 kindle.py --cookie ${cookie} ${csrfToken}
- 如果你用 [DeDRM_tools](https://github.com/apprenticeharper/DeDRM_tools) 解密 key 存在 key.txt 里
- 或者直接拖进 Calibre 里 please google it.
- 如果过程中失败了可以使用 e.g. `--resume-from ${num}`
- 如果出现名字太长的报错可以增加: `--cut-length 80` 来截断文件名
- 如果出现名字太长的报错可以增加：`--cut-length 80` 来截断文件名
- 支持推送文件下载 `--pdoc`
- 如果有很多同名 pdoc 或 book 可以使用 `--resolve_duplicate_names` 解决同名冲突
- error log 记录在 .error_books.log 中
@@ -157,9 +178,7 @@ python3 kindle.py --cookie ${cookie} ${csrfToken}
- error log is logged in .error_books.log
- Support for generating READMEs of recently finished books `--readme` generated files are in `my_kindle_stats.md`
<img width="1045" alt="image" src="https://user-images.githubusercontent.com/15976103/172113475-92862b57-bb39-4cd7-84d5-6bc428172bc4.png">
![image](https://user-images.githubusercontent.com/15976103/172113475-92862b57-bb39-4cd7-84d5-6bc428172bc4.png)
## 贡献