README
¶
Browser data parser
This library parses and converts data from Firefox- and Chromium-based browsers.
Browsers
Key:
- R: format can be read
- W: format can be written
- D: format documentation and/or source has been consulted
Firefox
Firefox files currently parsed:
Profiles/{profile}/addons.json(R)Profiles/{profile}/bookmarkbackups/bookmarks-{date}_{count}_{hash}.{json|jsonlz4}(R)Profiles/{profile}/containers.json(R)Profiles/{profile}/extension-preferences.json(R)Profiles/{profile}/extension-settings.json(R)Profiles/{profile}/extensions.json(R)Profiles/{profile}/handlers.json(R)Profiles/{profile}/times.json(R)installs.ini(R)profiles.ini(R)
Tor Browser
No Tor Browser-specific data is currently parsed.
Chrome
Chrome files currently parsed:
{profile}/Bookmarks(R)First Run(R)
Google Takeout files currently parsed:
Takeout/Chrome/Autofill.json(R)Takeout/Chrome/Bookmarks.html(R)Takeout/Chrome/BrowserHistory.json(R)Takeout/Chrome/Extensions.json(R)Takeout/Chrome/SearchEngines.json(R)Takeout/Chrome/SyncSettings.json(R)
Brave
No Brave-specific data is currently parsed.
Edge (Chromium)
No Edge-specific data is currently parsed.
Chrome Extensions
History Trends Unlimited
exported_analysis_history_{date}.{tsv|txt}(RWD)exported_archived_history_{date}.{tsv|txt}(RWD)history_autobackup_{date}_{full|incremental}.{tsv|txt|zip}(RWD)
TabCloud
https://chrometabcloud.appspot.com/tabcloud(R)
Contributing
The project is designed to be strict and reject input that violates any
assumptions. For example, additional unknown json fields are disallowed,
which contrasts with the permissive default in encoding/json. The goal
is to prevent any data loss, so it fails early. Several types in the
structures are still unknown due to a small sample size of data and are
marked with jsonutil.UnknownObj or jsonutil.UnknownType. If you
encounter an error while parsing valid data, please
report an issue.
I am currently seeking information on the
Takeout/Chrome/Dictionary.csv file in Google Takeout.
License
This project is made available under the Mozilla Public License.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package bookmark parses Netscape-style HTML bookmark files.
|
Package bookmark parses Netscape-style HTML bookmark files. |
|
Package chrome parses many formats of Chrome data.
|
Package chrome parses many formats of Chrome data. |
|
extensions
|
|
|
historytrends
Package historytrends parses Chromium browsing history exports from the History Trends Unlimited extension.
|
Package historytrends parses Chromium browsing history exports from the History Trends Unlimited extension. |
|
tabcloud
Package tabcloud parses browser windows saved by the TabCloud Chrome extension.
|
Package tabcloud parses browser windows saved by the TabCloud Chrome extension. |
|
Package firefox parses many formats of Firefox data.
|
Package firefox parses many formats of Firefox data. |
|
Package iniutil provides utilities for parsing INI files.
|
Package iniutil provides utilities for parsing INI files. |
|
Package jsonutil provides utilities for parsing JSON files.
|
Package jsonutil provides utilities for parsing JSON files. |
|
timefmt
Package timefmt provides types for representing time formats in JSON.
|
Package timefmt provides types for representing time formats in JSON. |
|
uuid
Package uuid encodes and decodes UUIDs.
|
Package uuid encodes and decodes UUIDs. |
|
Package takeout traverses and parses Google Takeout exports.
|
Package takeout traverses and parses Google Takeout exports. |