Skip to content

Commit 6217ca3

Browse files
moonD4rkmoonD4rk
committed
docs: update readme to v0.4.0
1 parent 04e620e commit 6217ca3

9 files changed

Lines changed: 78 additions & 175 deletions

File tree

‎README.md‎

Lines changed: 44 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -47,13 +47,13 @@ Based on Apple's security policy, some browsers **require a current user passwor
4747
| Opera | ✅ | ✅ | ✅ | ✅ |
4848
| OperaGX | ✅ | ✅ | ✅ | ✅ |
4949
| Vivaldi | ✅ | ✅ | ✅ | ✅ |
50-
| Yandex | ✅ | ✅ | ✅ | ✅ |
5150
| CocCoc | ✅ | ✅ | ✅ | ✅ |
5251
| Firefox | ✅ | ✅ | ✅ | ✅ |
5352
| Firefox Beta | ✅ | ✅ | ✅ | ✅ |
5453
| Firefox Dev | ✅ | ✅ | ✅ | ✅ |
5554
| Firefox ESR | ✅ | ✅ | ✅ | ✅ |
5655
| Firefox Nightly | ✅ | ✅ | ✅ | ✅ |
56+
| Yandex | ✅ | ✅ | ✅ | ✅ |
5757
| Safari | ❌ | ❌ | ❌ | ❌ |
5858

5959
### Linux
@@ -84,14 +84,14 @@ Installation of `HackBrowserData` is dead-simple, just download [the release for
8484
8585
### Building from source
8686

87-
support `go 1.14+`
87+
only support `go 1.18+` with go generics
8888

8989
```bash
90-
git clone https://github.com/moonD4rk/HackBrowserData
90+
$ git clone https://github.com/moonD4rk/HackBrowserData
9191

92-
cd HackBrowserData
92+
$ cd HackBrowserData/cmd/hack-browser-data
9393

94-
go build
94+
$ CGO_ENABLED=1 go build
9595
```
9696

9797
### Cross compile
@@ -125,70 +125,57 @@ NAME:
125125
126126
USAGE:
127127
[hack-browser-data -b chrome -f json -dir results -cc]
128-
Get all data(password/cookie/history/bookmark) from chrome
128+
Export all browingdata(password/cookie/history/bookmark) from browser
129+
Github Link: https://github.com/moonD4rk/HackBrowserData
129130
130131
VERSION:
131-
0.3.7
132+
0.4.0
133+
132134
GLOBAL OPTIONS:
133-
--verbose, --vv verbose (default: false)
134-
--compress, --cc compress result to zip (default: false)
135-
--browser value, -b value available browsers: all|opera|firefox|chrome|edge (default: "all")
136-
--results-dir value, --dir value export dir (default: "results")
137-
--format value, -f value format, csv|json|console (default: "csv")
138-
--profile-dir-path value, -p value custom profile dir path, get with chrome://version
139-
--key-file-path value, -k value custom key file path
140-
--help, -h show help (default: false)
141-
--version, -v print the version (default: false)
142-
143-
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -cc
144-
[x]: Get 44 cookies, filename is results/microsoft_edge_cookie.json
145-
[x]: Get 54 history, filename is results/microsoft_edge_history.json
146-
[x]: Get 1 passwords, filename is results/microsoft_edge_password.json
147-
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.json
148-
[x]: Get 6 bookmarks, filename is results/360speed_bookmark.json
149-
[x]: Get 19 cookies, filename is results/360speed_cookie.json
150-
[x]: Get 18 history, filename is results/360speed_history.json
151-
[x]: Get 1 passwords, filename is results/360speed_password.json
152-
[x]: Get 12 history, filename is results/qq_history.json
153-
[x]: Get 1 passwords, filename is results/qq_password.json
154-
[x]: Get 12 bookmarks, filename is results/qq_bookmark.json
155-
[x]: Get 14 cookies, filename is results/qq_cookie.json
156-
[x]: Get 28 bookmarks, filename is results/firefox_bookmark.json
157-
[x]: Get 10 cookies, filename is results/firefox_cookie.json
158-
[x]: Get 33 history, filename is results/firefox_history.json
159-
[x]: Get 1 passwords, filename is results/firefox_password.json
160-
[x]: Get 1 passwords, filename is results/chrome_password.json
161-
[x]: Get 4 bookmarks, filename is results/chrome_bookmark.json
162-
[x]: Get 6 cookies, filename is results/chrome_cookie.json
163-
[x]: Get 6 history, filename is results/chrome_history.json
164-
[x]: Compress success, zip filename is results/archive.zip
165-
```
166-
### Run with custom browser profile path
135+
--verbose, --vv verbose (default: false)
136+
--compress, --zip compress result to zip (default: false)
137+
--browser value, -b value available browsers: all|chrome|opera-gx|vivaldi|coccoc|brave|edge|chromium|chrome-beta|opera|yandex|firefox (default: "all")
138+
--results-dir value, --dir value export dir (default: "results")
139+
--format value, -f value file name csv|json (default: "csv")
140+
--profile-path value, -p value custom profile dir path, get with chrome://version
141+
--help, -h show help (default: false)
142+
--version, -v print the version (default: false)
143+
144+
145+
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -zip
146+
[NOTICE] [browser.go:46,pickChromium] find browser Chrome success
147+
[NOTICE] [browser.go:46,pickChromium] find browser Microsoft Edge success
148+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_download.json success
149+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_password.json success
150+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_creditcard.json success
151+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_bookmark.json success
152+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_cookie.json success
153+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_history.json success
154+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.json success
155+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.json success
156+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.json success
157+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.json success
158+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.json success
159+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.json success
167160
168161
```
169-
PS C:\Users\User\Desktop> .\hack-browser-data.exe -b edge -p 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Default' -k 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Local State'
162+
### Run with custom browser profile folder
170163

171-
[x]: Get 29 history, filename is results/microsoft_edge_history.csv
172-
[x]: Get 0 passwords, filename is results/microsoft_edge_password.csv
173-
[x]: Get 1 credit cards, filename is results/microsoft_edge_credit.csv
174-
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.csv
175-
[x]: Get 54 cookies, filename is results/microsoft_edge_cookie.csv
176-
177-
178-
PS C:\Users\User\Desktop> .\hack-browser-data.exe -b edge -p 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Default'
179-
180-
[x]: Get 1 credit cards, filename is results/microsoft_edge_credit.csv
181-
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.csv
182-
[x]: Get 54 cookies, filename is results/microsoft_edge_cookie.csv
183-
[x]: Get 29 history, filename is results/microsoft_edge_history.csv
184-
[x]: Get 0 passwords, filename is results/microsoft_edge_password.csv
164+
```
165+
PS C:\Users\User\Desktop> .\hack-browser-data.exe -b chrome -p 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Default'
166+
167+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.csv success
168+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.csv success
169+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.csv success
170+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.csv success
171+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.csv success
172+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.csv success
185173
```
186174

187175
### Some other projects based on HackBrowserData
188176
[Sharp-HackBrowserData](https://github.com/S3cur3Th1sSh1t/Sharp-HackBrowserData)
189177

190178
[Reflective-HackBrowserData](https://github.com/idiotc4t/Reflective-HackBrowserData)
191-
...
192179

193180

194181
## Contributors

‎README_ZH.md‎

Lines changed: 34 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -80,16 +80,14 @@
8080
8181
### 从源码编译
8282

83-
支持版本 `go 1.14+`
83+
仅支持 `go 1.18+` 以后版本，一些函数使用到了泛型
8484

8585
``` bash
86-
git clone https://github.com/moonD4rk/HackBrowserData
86+
$ git clone https://github.com/moonD4rk/HackBrowserData
8787

88-
cd HackBrowserData
88+
$ cd HackBrowserData/cmd/hack-browser-data
8989

90-
go get -v -t -d ./...
91-
92-
go build
90+
$ CGO_ENABLED=1 go build
9391
```
9492

9593
### 跨平台编译
@@ -122,43 +120,39 @@ NAME:
122120
123121
USAGE:
124122
[hack-browser-data -b chrome -f json -dir results -cc]
125-
Get all data(password/cookie/history/bookmark) from chrome
123+
Export all browingdata(password/cookie/history/bookmark) from browser
124+
Github Link: https://github.com/moonD4rk/HackBrowserData
126125
127126
VERSION:
128-
0.3.7
127+
0.4.0
128+
129129
GLOBAL OPTIONS:
130-
--verbose, --vv verbose (default: false)
131-
--compress, --cc compress result to zip (default: false)
132-
--browser value, -b value available browsers: all|opera|firefox|chrome|edge (default: "all")
133-
--results-dir value, --dir value export dir (default: "results")
134-
--format value, -f value format, csv|json|console (default: "csv")
135-
--profile-dir-path value, -p value custom profile dir path, get with chrome://version
136-
--key-file-path value, -k value custom key file path
137-
--help, -h show help (default: false)
138-
--version, -v print the version (default: false)
139-
140-
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results --cc
141-
[x]: Get 44 cookies, filename is results/microsoft_edge_cookie.json
142-
[x]: Get 54 history, filename is results/microsoft_edge_history.json
143-
[x]: Get 1 passwords, filename is results/microsoft_edge_password.json
144-
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.json
145-
[x]: Get 6 bookmarks, filename is results/360speed_bookmark.json
146-
[x]: Get 19 cookies, filename is results/360speed_cookie.json
147-
[x]: Get 18 history, filename is results/360speed_history.json
148-
[x]: Get 1 passwords, filename is results/360speed_password.json
149-
[x]: Get 12 history, filename is results/qq_history.json
150-
[x]: Get 1 passwords, filename is results/qq_password.json
151-
[x]: Get 12 bookmarks, filename is results/qq_bookmark.json
152-
[x]: Get 14 cookies, filename is results/qq_cookie.json
153-
[x]: Get 28 bookmarks, filename is results/firefox_bookmark.json
154-
[x]: Get 10 cookies, filename is results/firefox_cookie.json
155-
[x]: Get 33 history, filename is results/firefox_history.json
156-
[x]: Get 1 passwords, filename is results/firefox_password.json
157-
[x]: Get 1 passwords, filename is results/chrome_password.json
158-
[x]: Get 4 bookmarks, filename is results/chrome_bookmark.json
159-
[x]: Get 6 cookies, filename is results/chrome_cookie.json
160-
[x]: Get 6 history, filename is results/chrome_history.json
161-
[x]: Compress success, zip filename is results/archive.zip
130+
--verbose, --vv verbose (default: false)
131+
--compress, --zip compress result to zip (default: false)
132+
--browser value, -b value available browsers: all|chrome|opera-gx|vivaldi|coccoc|brave|edge|chromium|chrome-beta|opera|yandex|firefox (default: "all")
133+
--results-dir value, --dir value export dir (default: "results")
134+
--format value, -f value file name csv|json (default: "csv")
135+
--profile-path value, -p value custom profile dir path, get with chrome://version
136+
--help, -h show help (default: false)
137+
--version, -v print the version (default: false)
138+
139+
140+
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -zip
141+
[NOTICE] [browser.go:46,pickChromium] find browser Chrome success
142+
[NOTICE] [browser.go:46,pickChromium] find browser Microsoft Edge success
143+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_download.json success
144+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_password.json success
145+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_creditcard.json success
146+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_bookmark.json success
147+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_cookie.json success
148+
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_history.json success
149+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.json success
150+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.json success
151+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.json success
152+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.json success
153+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.json success
154+
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.json success
155+
162156
```
163157

164158
### 基于此工具的一些其他项目

internal/browingdata/bookmark.go renamed to internal/browingdata/bookmark/bookmark.go

File renamed without changes.

internal/browingdata/cookie.go renamed to internal/browingdata/cookie/cookie.go

File renamed without changes.

internal/browingdata/creditcard.go renamed to internal/browingdata/creditcard/creditcard.go

File renamed without changes.

internal/browingdata/download.go renamed to internal/browingdata/download/download.go

File renamed without changes.

internal/outputter/outputter_test.go renamed to internal/browingdata/outputter_test.go

File renamed without changes.

internal/browingdata/password.go renamed to internal/browingdata/password/password.go

File renamed without changes.

‎internal/outputter/outputter.go‎

Lines changed: 0 additions & 78 deletions
This file was deleted.

0 commit comments

Comments
 (0)