https://github.com/markmelnic/plot-browsing-history
Visualize your chrome browsing history using google takeout data.
https://github.com/markmelnic/plot-browsing-history
activity-histogram barchart browsing-history chart chrome google google-takeout histogram json jupyter-notebook matplotlib python takeout-data visualisation
Last synced: about 1 month ago
JSON representation
Visualize your chrome browsing history using google takeout data.
- Host: GitHub
- URL: https://github.com/markmelnic/plot-browsing-history
- Owner: markmelnic
- License: mit
- Created: 2020-08-04T09:11:10.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-26T20:31:22.000Z (10 months ago)
- Last Synced: 2025-08-20T21:18:23.789Z (about 2 months ago)
- Topics: activity-histogram, barchart, browsing-history, chart, chrome, google, google-takeout, histogram, json, jupyter-notebook, matplotlib, python, takeout-data, visualisation
- Language: Python
- Homepage:
- Size: 38.1 KB
- Stars: 14
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Visualize Your Chrome Browsing History
A lightweight tool to visualize your Chrome browsing history using Google Takeout data.
---
## Getting Started
Follow these steps to visualize your browsing history:
### 1. Initial Setup
Ensure you meet all requirements by following [this guide](https://gist.github.com/markmelnic/b5a6d399b2c08008c989829cbf9c3618).
### 2. Download Your Browsing Data
1. Learn how to download your Google data: [Google Takeout Guide](https://support.google.com/accounts/answer/3024190?hl=en).
2. Download your data from [Google Takeout](https://takeout.google.com/).
> **Note:** You only need to download your Chrome browsing history. Google provides it as a JSON file by default.
Save the `History.json` file in the same directory as the script.
### 3. Run the Script
Open your terminal or command prompt and execute the following command:
```shell
python main.py
```
Replace `` with the name of your downloaded `History.json` file (the name may vary).
---
## Script Usage
### Command Syntax
```shell
main.py [-h] [-s SIZE] [-d DAYS]
```
#### Positional Arguments:
- **``**: The JSON file downloaded from Google Takeout.
#### Optional Arguments:
- **`-h`**: Display help information.
- **`-s, --size`**: Number of top sites to display (default: 20).
- **`-d, --days`**: Number of recent days to analyze (default: 60).
---
## Examples
1. Basic usage with default settings:
```shell
python main.py History.json
```
2. Display data from the last 50 days:
```shell
python main.py History.json -d 50
```
3. Show the top 30 sites:
```shell
python main.py History.json --size 30
```
4. Analyze 90 days and display the top 50 sites:
```shell
python main.py History.json -s 50 --days 90
```