From 23b9cf97f733097b202fe75a1dfcf396d0027032 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=B4=8D=E1=B4=8F=E1=B4=8F=C9=B4D4=CA=80=E1=B4=8B?= Date: Thu, 16 Jul 2020 11:09:13 +0800 Subject: [PATCH] add chinese readme Closes #16 --- README.md | 65 ++++++++++++++++---------------- README_EN.md | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 134 insertions(+), 33 deletions(-) create mode 100644 README_EN.md diff --git a/README.md b/README.md index d6af8c1..a15c8f1 100644 --- a/README.md +++ b/README.md @@ -1,45 +1,48 @@ # HackBrowserData -hack-browser-data is an open-source tool that could help you export data from browser. It supports the most popular browsers on the market and runs on Windows, macOS and Linux. +[English Readme](https://github.com/moonD4rk/HackBrowserData/blob/master/README_EN.md) -### Supported Browser +hack-browser-data 是一个浏览器数据（密码|历史记录|Cookies|书签）导出工具，支持全平台主流浏览器。 + +### 各平台浏览器支持情况 #### Windows -| Browser | Password | Cookie | Bookmark | History | -| :---------------------------------- | :------: | :----: | :------: | :-----: | -| Google Chrome (Full Version) | ✅ | ✅ | ✅ | ✅ | -| Firefox | ✅ | ✅ | ✅ | ✅ | -| Microsoft Edge | ✅ | ✅ | ✅ | ✅ | -| 360 Speed Browser | ✅ | ✅ | ✅ | ✅ | -| QQ Browser | ✅ | ✅ | ✅ | ✅ | -| Internet Explorer | ❌ | ❌ | ❌ | ❌ | + +| 浏览器 | 密码 | Cookie | 书签 | 历史记录 | +| :--------------------------- | :------: | :----: | :------: | :-----: | +| Google Chrome (全版本) | ✅ | ✅ | ✅ | ✅ | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Microsoft Edge | ✅ | ✅ | ✅ | ✅ | +| 360 急速浏览器 | ✅ | ✅ | ✅ | ✅ | +| QQ 浏览器 | ✅ | ✅ | ✅ | ✅ | +| IE 浏览器 | ❌ | ❌ | ❌ | ❌ | #### MacOS -Because of the security policies, all those browsers require a password. +由于 MacOS 的安全性设置，基于 `Chromium` 内核浏览器解密时需要用户密码 -| Browser | Password | Cookie | Bookmark | History | -| :---------------------------------- | :------: | :----: | :------: | :-----: | -| Google Chrome | ✅ | ✅ | ✅ | ✅ | -| Firefox | ✅ | ✅ | ✅ | ✅ | -| Microsoft Edge | ✅ | ✅ | ✅ | ✅ | -| Safari | ❌ | ❌ | ❌ | ❌ | +| Browser | Password | Cookie | Bookmark | History | +| :--------------------------- | :------: | :----: | :------: | :-----: | +| Google Chrome
需要密码 | ✅ | ✅ | ✅ | ✅ | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Microsoft Edge
需要密码 | ✅ | ✅ | ✅ | ✅ | +| Safari | ❌ | ❌ | ❌ | ❌ | #### Linux -| Browser | Password | Cookie | Bookmark | History | -| :---------------------------------- | :------: | :----: | :------: | :-----: | -| Firefox | ✅ | ✅ | ✅ | ✅ | -| Google Chrome | ❌ | ❌ | ❌ | ❌ | +| Browser | Password | Cookie | Bookmark | History | +| :------------ | :------: | :----: | :------: | :-----: | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Google Chrome | ❌ | ❌ | ❌ | ❌ | -### Install +### 安装运行 -Installation of hack-browser-data is dead-simple, just download [the release for your system](https://github.com/moonD4rk/HackBrowserData/releases) and run the binary. +基于Golang，如图方便可以下载我编译好的[二进制文件 ](https://github.com/moonD4rk/HackBrowserData/releases) 就行 -#### Building from source +#### 自己编译 -support `go 1.11+` +支持版本 `go 1.11+` ```bash git clone https://github.com/moonD4rk/HackBrowserData @@ -51,7 +54,7 @@ go get -v -t -d ./... go build ``` -#### Run +#### 运行 ```shell PS C:\hack> .\hack.exe -h NAME: @@ -77,17 +80,13 @@ PS C:\hack> .\hack.exe -b firefox ``` - - - - ### TODO [Desktop Browser Market Share Worldwide](https://gs.statcounter.com/browser-market-share/desktop/worldwide) -| Chrome | Safari | Firefox | Edge Legacy | IE | Other | -| :------:| :------: | :----: | :------: | :-----: | :--: | -| 68.33% | 9.4% | 8.91% | 4.41% | 3% | 3% | +| Chrome | Safari | Firefox | Edge Legacy | IE | Other | +| :----: | :----: | :-----: | :---------: | :--: | :---: | +| 68.33% | 9.4% | 8.91% | 4.41% | 3% | 3% | [Desktop Browser Market Share China](https://gs.statcounter.com/browser-market-share/desktop/china) diff --git a/README_EN.md b/README_EN.md new file mode 100644 index 0000000..9e3c6e8 --- /dev/null +++ b/README_EN.md @@ -0,0 +1,102 @@ +# HackBrowserData + +hack-browser-data is an open-source tool that could help you export data from browser. It supports the most popular browsers on the market and runs on Windows, macOS and Linux. + +### Supported Browser + +#### Windows +| Browser | Password | Cookie | Bookmark | History | +| :---------------------------------- | :------: | :----: | :------: | :-----: | +| Google Chrome (Full Version) | ✅ | ✅ | ✅ | ✅ | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Microsoft Edge | ✅ | ✅ | ✅ | ✅ | +| 360 Speed Browser | ✅ | ✅ | ✅ | ✅ | +| QQ Browser | ✅ | ✅ | ✅ | ✅ | +| Internet Explorer | ❌ | ❌ | ❌ | ❌ | + +#### MacOS + +Because of the security policies, some of the browsers require a password. + +| Browser | Password | Cookie | Bookmark | History | +| :---------------------------------- | :------: | :----: | :------: | :-----: | +| Google Chrome
Require Password | ✅ | ✅ | ✅ | ✅ | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Microsoft Edge
Require Password | ✅ | ✅ | ✅ | ✅ | +| Safari | ❌ | ❌ | ❌ | ❌ | + +#### Linux + +| Browser | Password | Cookie | Bookmark | History | +| :---------------------------------- | :------: | :----: | :------: | :-----: | +| Firefox | ✅ | ✅ | ✅ | ✅ | +| Google Chrome | ❌ | ❌ | ❌ | ❌ | + + +### Install + +Installation of hack-browser-data is dead-simple, just download [the release for your system](https://github.com/moonD4rk/HackBrowserData/releases) and run the binary. + +#### Building from source + +support `go 1.11+` + +```bash +git clone https://github.com/moonD4rk/HackBrowserData + +cd HackBrowserData + +go get -v -t -d ./... + +go build +``` + +#### Run + +```shell +PS C:\hack> .\hack.exe -h NAME: + hack-browser-data - Export passwords/cookies/history/bookmarks from browser + +USAGE: + [hack-browser-data -b chrome -f json -dir results -e all] + Get all data(password/cookie/history/bookmark) from chrome + +GLOBAL OPTIONS: + --verbose, --vv Verbose (default: false) + --browser value, -b value Available browsers: chrome|edge|360speed|qq|firefox (default: "chrome") + --results-dir value, --dir value Export dir (default: "results") + --format value, -f value Format, csv|json (default: "csv") + --export-data value, -e value all|password|cookie|history|bookmark (default: "all") + --help, -h show help (default: false) + +PS C:\hack> .\hack.exe -b firefox +[x]: Get 28 bookmarks, filename is results/bookmarks_firefox.csv +[x]: Get 1 login data, filename is results/login_data_firefox.csv +[x]: Get 10 cookies, filename is results/cookies_firefox.csv +[x]: Get 33 login data, filename is results/history_firefox.csv +``` + + +### TODO + +[Desktop Browser Market Share Worldwide](https://gs.statcounter.com/browser-market-share/desktop/worldwide) + +| Chrome | Safari | Firefox | Edge Legacy | IE | Other | +| :------:| :------: | :----: | :------: | :-----: | :--: | +| 68.33% | 9.4% | 8.91% | 4.41% | 3% | 3% | + +[Desktop Browser Market Share China](https://gs.statcounter.com/browser-market-share/desktop/china) + +| Chrome | 360 Safe | Firefox | QQ Browser | IE | Sogou Explorer | +| :----- | :------: | :-----: | :--------: | :---: | :------------: | +| 39.85% | 22.26% | 9.28% | 6.5% | 5.65% | 4.74% | + + + +- [x] Chrome +- [x] QQ browser +- [x] Edge +- [x] 360 speed browser +- [x] Firefox +- [ ] Safari +- [ ] IE \ No newline at end of file