Create page and domain CSV reports from your Chrome browsing history
Google Chrome lets you view and search your browsing history, although with limitations on metadata and the ability to filter or sort. Though you can export your data to an XML file from the browser or get a JSON download from your Google account, those raw data files are still inconvenient to use.
Therefore this project provides Python 3.6 tool to convert your own downloaded browsing history JSON into two easy-to-use CSV reports which you can search, filter and sort in a CSV editor.
| Title | Description |
|---|---|
| Page Report | List of URLs in the history events, including the last visit time, domain and page title. Sorted by URL. |
| Domain Report | Summary of unique domains and counts of pages associated with each. Sorted by domain but easily sortable by page count. |
$ ./historyreport.py [OPTIONS]| Flag | Description |
|---|---|
| -h | Show help message and exit. |
| -e --exclude | If provided, read the configured exclusions CSV and exclude any URLs in the file before writing the CSV report. |
Sample input files:
Sample output files:
When creating the reports, certain domains or URLs will be excluded. This is done with a config, containing app defaults and user-defined items. For example, the app will ignore www.facebook.com and you might decided to exclude Such as gmail.com.
This project cares about browsing events, so irrelevant events are ignored and define in IGNORE_EVENTS in historyreport.py.
In that script, only http and https URLs are used, filtering out items like local file paths (file:///) and FTP URLs (ftp://).
Setup and run the application with the following in the docs directory:
Your browsing history is kept totally private when using this project:
- This project does not require access to the internet to run or your Google credentials to run.
- No data is sent outside of this application - the only output is local CSV files in the project's unversioned
vardirectory.
Released under MIT.