Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
seba7236 authored Oct 20, 2024
1 parent 7771cf1 commit 3e7d00b
Showing 1 changed file with 90 additions and 2 deletions.
92 changes: 90 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,90 @@
# BrowserParser
Automatic, fast parsing of browser artifacts
## About

Browserparser aims to make parsing of browser data alot easier.
The tool is designed for use with Kape, but can be used manually.
It finds the directories of all browsers on the system, based on the normal locations as of October 2024.
Supports output in JSON or CSV.


## Compatability

Browserparser should be compatible on Linux and Windows.
The Python script contains functionality to parse push notifications. The compiled binary for Windows does *not* support this, because LevelDB has trouble on Windows.

## Usage

The tool can be used on the disk directly, using the drive letter as the source directory.

```python3 main.py <sourcedir> <outputdir> --csv / --json```


## Output

The tool parses the following artifacts on these browsers:

* Chromium
* Chrome
* Downloads
* Browsing-history
* Visited links
* Searched
* Favicons
* Cookies
* Shortcuts
* Notifications (Only in the python script!)
* Extensions
* Edge
* Downloads
* Browsing-history
* Visited links
* Searched
* Favicons
* Cookies
* Shortcuts
* Notifications (Only in the python script!)
* Extensions
* Opera
* Downloads
* Browsing-history
* Visited links
* Searched
* Favicons
* Cookies
* Shortcuts
* Notifications (Only in the python script!)
* Extensions
* Yandex
* Downloads
* Browsing-history
* Visited links
* Searched
* Favicons
* Cookies
* Shortcuts
* Notifications (Only in the python script!)
* Extensions
* Brave
* Downloads
* Browsing-history
* Visited links
* Searched
* Favicons
* Cookies
* Shortcuts
* Notifications (Only in the python script!)
* Extensions
* Non-Chromium
* Firefox
* Cookies
* Form-history
* Permissions
* Bookmarks
* Browsing-history
* "Regular" history
* "Enriched" history (History with extra metadata)
* Extensions
* Logins
* Downloads
* Favicons
* Notifications

0 comments on commit 3e7d00b

Please sign in to comment.