Metadata-Version: 2.4
Name: google-takeout-viewer
Version: 0.1.2
Summary: A tool to visualize Google Takeout data
Author: Kiduzk
License-Expression: MIT
Project-URL: Repository, https://github.com/Kiduzk/google-takeout-viewer
Project-URL: Issues, https://github.com/Kiduzk/google-takeout-viewer/issues
Keywords: google,takeout,youtube,keep,parser,viewer,data-visualization
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.104.0
Requires-Dist: google-takeout-parser>=0.1.12
Requires-Dist: click>=8.1.0
Requires-Dist: peewee>=3.17.0
Requires-Dist: uvicorn[standard]>=0.24.0
Dynamic: license-file

# google-takeout-viewer

A CLI-managed local web app for viewing your Google Takeout data in the browser.

## What is google takeout?

You can export your data from google services and products as a takeout zip file. This will contain youtube histories, notes, etc... 

## Installation

```bash
pip install google-takeout-viewer
```

## Quick Start

1. **Download your data** from [Google Takeout](https://takeout.google.com)

2. **Parse the data**:
```bash
takeout-viewer parse /path/to/takeout.zip
```
You can parse many takeouts as you want. Each parse command will add the parsed info into an SQLite command. For the parsing logic, it utilizes the takeout parser package: https://github.com/purarue/google_takeout_parser. 

3. **View in browser**:
```bash
takeout-viewer view
```

Opens http://127.0.0.1:8000 with your data:

<img width="900" alt="image" src="https://github.com/user-attachments/assets/42997283-d283-467e-a793-37bf11f41453" />

## Commands

- `takeout-viewer parse <path>` - Parse a Google Takeout ZIP or folder
- `takeout-viewer view` - Start server and open browser
- `takeout-viewer clear` - Clear the local database containing the parsed info

## Supported Data

- YouTube watch history
- YouTube search history  
- YouTube comments
- Google Keep notes

## In the works / Future goals

I see two main ways to expand this project.
1) Support more data formats like location history, music history, emails, etc ...
2) Add visualizations for existing formats. We could have for example graphs or charts.

## Contributions

Any contribution and feedback is welcome! I am hoping to create a comprehensive way to easily browse and view takeout files. 

## Tech Stack
- **Backend**: FastAPI + Peewee ORM + SQLite
- **Frontend**: React + TypeScript + Vite
- **CLI**: Click
- **Parsing**: google-takeout-parser

