k
/
HackBrowserData
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: update readme to v0.4.0

Browse Source
pull/125/head
ᴍᴏᴏɴD4ʀᴋ 3 years ago
parent 04e620e54c
commit 6217ca3bed
9 changed files with 78 additions and 175 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 91
      README.md
  2. 64
      README_ZH.md
  3. 0
      internal/browingdata/bookmark/bookmark.go
  4. 0
      internal/browingdata/cookie/cookie.go
  5. 0
      internal/browingdata/creditcard/creditcard.go
  6. 0
      internal/browingdata/download/download.go
  7. 0
      internal/browingdata/outputter_test.go
  8. 0
      internal/browingdata/password/password.go
  9. 78
      internal/outputter/outputter.go

91
README.md
Unescape View File

@ -47,13 +47,13 @@ Based on Apple's security policy, some browsers **require a current user passwor
| Opera | ✅ | ✅ | ✅ | ✅ | | Opera | ✅ | ✅ | ✅ | ✅ |
| OperaGX | ✅ | ✅ | ✅ | ✅ | | OperaGX | ✅ | ✅ | ✅ | ✅ |
| Vivaldi | ✅ | ✅ | ✅ | ✅ | | Vivaldi | ✅ | ✅ | ✅ | ✅ |
| Yandex | ✅ | ✅ | ✅ | ✅ |
| CocCoc | ✅ | ✅ | ✅ | ✅ | | CocCoc | ✅ | ✅ | ✅ | ✅ |
| Firefox | ✅ | ✅ | ✅ | ✅ | | Firefox | ✅ | ✅ | ✅ | ✅ |
| Firefox Beta | ✅ | ✅ | ✅ | ✅ | | Firefox Beta | ✅ | ✅ | ✅ | ✅ |
| Firefox Dev | ✅ | ✅ | ✅ | ✅ | | Firefox Dev | ✅ | ✅ | ✅ | ✅ |
| Firefox ESR | ✅ | ✅ | ✅ | ✅ | | Firefox ESR | ✅ | ✅ | ✅ | ✅ |
| Firefox Nightly | ✅ | ✅ | ✅ | ✅ | | Firefox Nightly | ✅ | ✅ | ✅ | ✅ |
| Yandex | ✅ | ✅ | ✅ | ✅ |
| Safari | ❌ | ❌ | ❌ | ❌ | | Safari | ❌ | ❌ | ❌ | ❌ |
### Linux ### Linux
@ -84,14 +84,14 @@ Installation of `HackBrowserData` is dead-simple, just download [the release for
### Building from source ### Building from source
support `go 1.14+` only support `go 1.18+` with go generics
```bash ```bash
git clone https://github.com/moonD4rk/HackBrowserData $ git clone https://github.com/moonD4rk/HackBrowserData
cd HackBrowserData $ cd HackBrowserData/cmd/hack-browser-data
go build $ CGO_ENABLED=1 go build
``` ```
### Cross compile ### Cross compile
@ -125,70 +125,57 @@ NAME:
USAGE: USAGE:
[hack-browser-data -b chrome -f json -dir results -cc] [hack-browser-data -b chrome -f json -dir results -cc]
Get all data(password/cookie/history/bookmark) from chrome Export all browingdata(password/cookie/history/bookmark) from browser
Github Link: https://github.com/moonD4rk/HackBrowserData
VERSION: VERSION:
0.3.7 0.4.0
GLOBAL OPTIONS: GLOBAL OPTIONS:
--verbose, --vv verbose (default: false) --verbose, --vv verbose (default: false)
--compress, --cc compress result to zip (default: false) --compress, --zip compress result to zip (default: false)
--browser value, -b value available browsers: all|opera|firefox|chrome|edge (default: "all") --browser value, -b value available browsers: all|chrome|opera-gx|vivaldi|coccoc|brave|edge|chromium|chrome-beta|opera|yandex|firefox (default: "all")
--results-dir value, --dir value export dir (default: "results") --results-dir value, --dir value export dir (default: "results")
--format value, -f value format, csv|json|console (default: "csv") --format value, -f value file name csv|json (default: "csv")
--profile-dir-path value, -p value custom profile dir path, get with chrome://version --profile-path value, -p value custom profile dir path, get with chrome://version
--key-file-path value, -k value custom key file path
--help, -h show help (default: false) --help, -h show help (default: false)
--version, -v print the version (default: false) --version, -v print the version (default: false)
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -cc
[x]: Get 44 cookies, filename is results/microsoft_edge_cookie.json
[x]: Get 54 history, filename is results/microsoft_edge_history.json
[x]: Get 1 passwords, filename is results/microsoft_edge_password.json
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.json
[x]: Get 6 bookmarks, filename is results/360speed_bookmark.json
[x]: Get 19 cookies, filename is results/360speed_cookie.json
[x]: Get 18 history, filename is results/360speed_history.json
[x]: Get 1 passwords, filename is results/360speed_password.json
[x]: Get 12 history, filename is results/qq_history.json
[x]: Get 1 passwords, filename is results/qq_password.json
[x]: Get 12 bookmarks, filename is results/qq_bookmark.json
[x]: Get 14 cookies, filename is results/qq_cookie.json
[x]: Get 28 bookmarks, filename is results/firefox_bookmark.json
[x]: Get 10 cookies, filename is results/firefox_cookie.json
[x]: Get 33 history, filename is results/firefox_history.json
[x]: Get 1 passwords, filename is results/firefox_password.json
[x]: Get 1 passwords, filename is results/chrome_password.json
[x]: Get 4 bookmarks, filename is results/chrome_bookmark.json
[x]: Get 6 cookies, filename is results/chrome_cookie.json
[x]: Get 6 history, filename is results/chrome_history.json
[x]: Compress success, zip filename is results/archive.zip
```
### Run with custom browser profile path
``` PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -zip
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' [NOTICE] [browser.go:46,pickChromium] find browser Chrome success
[NOTICE] [browser.go:46,pickChromium] find browser Microsoft Edge success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_download.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_password.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_creditcard.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_bookmark.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_cookie.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_history.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.json success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.json success
[x]: Get 29 history, filename is results/microsoft_edge_history.csv ```
[x]: Get 0 passwords, filename is results/microsoft_edge_password.csv ### Run with custom browser profile folder
[x]: Get 1 credit cards, filename is results/microsoft_edge_credit.csv
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.csv
[x]: Get 54 cookies, filename is results/microsoft_edge_cookie.csv
PS C:\Users\User\Desktop> .\hack-browser-data.exe -b edge -p 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Default'
[x]: Get 1 credit cards, filename is results/microsoft_edge_credit.csv ```
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.csv PS C:\Users\User\Desktop> .\hack-browser-data.exe -b chrome -p 'C:\Users\User\AppData\Local\Microsoft\Edge\User Data\Default'
[x]: Get 54 cookies, filename is results/microsoft_edge_cookie.csv
[x]: Get 29 history, filename is results/microsoft_edge_history.csv [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.csv success
[x]: Get 0 passwords, filename is results/microsoft_edge_password.csv [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.csv success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.csv success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.csv success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.csv success
[NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.csv success
``` ```
### Some other projects based on HackBrowserData ### Some other projects based on HackBrowserData
[Sharp-HackBrowserData](https://github.com/S3cur3Th1sSh1t/Sharp-HackBrowserData) [Sharp-HackBrowserData](https://github.com/S3cur3Th1sSh1t/Sharp-HackBrowserData)
[Reflective-HackBrowserData](https://github.com/idiotc4t/Reflective-HackBrowserData) [Reflective-HackBrowserData](https://github.com/idiotc4t/Reflective-HackBrowserData)
...
## Contributors ## Contributors

64
README_ZH.md
Unescape View File

@ -80,16 +80,14 @@
### 从源码编译 ### 从源码编译
支持版本 `go 1.14+` 仅支持 `go 1.18+` 以后版本，一些函数使用到了泛型
``` bash ``` bash
git clone https://github.com/moonD4rk/HackBrowserData $ git clone https://github.com/moonD4rk/HackBrowserData
cd HackBrowserData $ cd HackBrowserData/cmd/hack-browser-data
go get -v -t -d ./... $ CGO_ENABLED=1 go build
go build
``` ```
### 跨平台编译 ### 跨平台编译
@ -122,43 +120,39 @@ NAME:
USAGE: USAGE:
[hack-browser-data -b chrome -f json -dir results -cc] [hack-browser-data -b chrome -f json -dir results -cc]
Get all data(password/cookie/history/bookmark) from chrome Export all browingdata(password/cookie/history/bookmark) from browser
Github Link: https://github.com/moonD4rk/HackBrowserData
VERSION: VERSION:
0.3.7 0.4.0
GLOBAL OPTIONS: GLOBAL OPTIONS:
--verbose, --vv verbose (default: false) --verbose, --vv verbose (default: false)
--compress, --cc compress result to zip (default: false) --compress, --zip compress result to zip (default: false)
--browser value, -b value available browsers: all|opera|firefox|chrome|edge (default: "all") --browser value, -b value available browsers: all|chrome|opera-gx|vivaldi|coccoc|brave|edge|chromium|chrome-beta|opera|yandex|firefox (default: "all")
--results-dir value, --dir value export dir (default: "results") --results-dir value, --dir value export dir (default: "results")
--format value, -f value format, csv|json|console (default: "csv") --format value, -f value file name csv|json (default: "csv")
--profile-dir-path value, -p value custom profile dir path, get with chrome://version --profile-path value, -p value custom profile dir path, get with chrome://version
--key-file-path value, -k value custom key file path
--help, -h show help (default: false) --help, -h show help (default: false)
--version, -v print the version (default: false) --version, -v print the version (default: false)
PS C:\test> .\hack-browser-data.exe -b all -f json --dir results --cc
[x]: Get 44 cookies, filename is results/microsoft_edge_cookie.json PS C:\test> .\hack-browser-data.exe -b all -f json --dir results -zip
[x]: Get 54 history, filename is results/microsoft_edge_history.json [NOTICE] [browser.go:46,pickChromium] find browser Chrome success
[x]: Get 1 passwords, filename is results/microsoft_edge_password.json [NOTICE] [browser.go:46,pickChromium] find browser Microsoft Edge success
[x]: Get 4 bookmarks, filename is results/microsoft_edge_bookmark.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_download.json success
[x]: Get 6 bookmarks, filename is results/360speed_bookmark.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_password.json success
[x]: Get 19 cookies, filename is results/360speed_cookie.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_creditcard.json success
[x]: Get 18 history, filename is results/360speed_history.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_bookmark.json success
[x]: Get 1 passwords, filename is results/360speed_password.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_cookie.json success
[x]: Get 12 history, filename is results/qq_history.json [NOTICE] [browsingdata.go:59,Output] output to file results/microsoft_edge_history.json success
[x]: Get 1 passwords, filename is results/qq_password.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_history.json success
[x]: Get 12 bookmarks, filename is results/qq_bookmark.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_download.json success
[x]: Get 14 cookies, filename is results/qq_cookie.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_password.json success
[x]: Get 28 bookmarks, filename is results/firefox_bookmark.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_creditcard.json success
[x]: Get 10 cookies, filename is results/firefox_cookie.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_bookmark.json success
[x]: Get 33 history, filename is results/firefox_history.json [NOTICE] [browsingdata.go:59,Output] output to file results/chrome_cookie.json success
[x]: Get 1 passwords, filename is results/firefox_password.json
[x]: Get 1 passwords, filename is results/chrome_password.json
[x]: Get 4 bookmarks, filename is results/chrome_bookmark.json
[x]: Get 6 cookies, filename is results/chrome_cookie.json
[x]: Get 6 history, filename is results/chrome_history.json
[x]: Compress success, zip filename is results/archive.zip
``` ```
### 基于此工具的一些其他项目 ### 基于此工具的一些其他项目

0
internal/browingdata/bookmark.go → internal/browingdata/bookmark/bookmark.go
Unescape View File

0
internal/browingdata/cookie.go → internal/browingdata/cookie/cookie.go
Unescape View File

0
internal/browingdata/creditcard.go → internal/browingdata/creditcard/creditcard.go
Unescape View File

0
internal/browingdata/download.go → internal/browingdata/download/download.go
Unescape View File

0
internal/outputter/outputter_test.go → internal/browingdata/outputter_test.go
Unescape View File

0
internal/browingdata/password.go → internal/browingdata/password/password.go
Unescape View File

78
internal/outputter/outputter.go
Unescape View File

@ -1,78 +0,0 @@
package outputter
import (
"encoding/csv"
"errors"
"io"
"os"
"path/filepath"
"github.com/gocarina/gocsv"
jsoniter "github.com/json-iterator/go"
"hack-browser-data/internal/browingdata"
)
type OutPutter struct {
json bool
csv bool
}
func New(flag string) *OutPutter {
o := &OutPutter{}
if flag == "json" {
o.json = true
} else {
o.csv = true
}
return o
}
func (o *OutPutter) Write(data browingdata.Source, writer io.Writer) error {
switch o.json {
case true:
encoder := jsoniter.NewEncoder(writer)
encoder.SetIndent(" ", " ")
encoder.SetEscapeHTML(false)
return encoder.Encode(data)
default:
gocsv.SetCSVWriter(func(w io.Writer) *gocsv.SafeCSVWriter {
writer := csv.NewWriter(w)
writer.Comma = ','
return gocsv.NewSafeCSVWriter(writer)
})
return gocsv.Marshal(data, writer)
}
}
func (o *OutPutter) CreateFile(dir, filename string) (*os.File, error) {
if filename == "" {
return nil, errors.New("empty filename")
}
if dir != "" {
if _, err := os.Stat(dir); os.IsNotExist(err) {
err := os.MkdirAll(dir, 0777)
if err != nil {
return nil, err
}
}
}
var file *os.File
var err error
p := filepath.Join(dir, filename)
file, err = os.OpenFile(p, os.O_TRUNC|os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
return nil, err
}
return file, nil
}
func (o *OutPutter) Ext() string {
if o.json {
return ".json"
} else {
return ".csv"
}
}
Write Preview
Loading…
Cancel
Save