Skip to main content

Process Google Takeout data and visualize it using Dash.

Project description

Splash Image

Self Stats - Google Takeout Data Insights Visualizer 📊

Welcome to Self Stats Google Takeout Data Insights Visualizer! This Python package revolutionizes how you interact with your personal Google Analytics data extracted via Google Takeout. By offering eye-catching, interactive visualizations, this tool helps you gain deep insights into your digital footprint with Google services. Whether you're a data enthusiast or simply curious about your online habits, this tool provides valuable perspectives into your personal analytics data.

Features 🌟

  • Custom Data Processing: Import and analyze your personal Google Analytics data from Google Takeout.
  • Interactive Visualizations: Engage with your data through beautifully designed graphs and interactive charts.
  • Insight Discovery: Discover trends, patterns, and more from your personal usage data.
  • User-Friendly Interface: Easy setup and intuitive controls make your data exploration enjoyable and straightforward.

Getting Started 🚀

Prerequisites

To use the Google Takeout Data Insights Visualizer, you will need:

  • Python 3.6 or higher
  • Pip for Python package management

Installation

Install this package using pip:

pip install takeout-insights-visualizer

Data Preparation

Downloading Your Data from Google Takeout

  • Open your web browser and go to Google Takeout.
  • Google Takeout allows you to export data from your Google account products.
  • Choose the Google products you want data from. Ensure you have selected "MyActivity" and "YouTube and YouTube Music"
  • Change the file format to JSON.
  • Once your archive is ready, Google will notify you via email.
  • Download the archive and extract it.

Google Takeout Demo

Setting Up the Visualizer

  1. Prepare Your Data:

    • After extracting your data, place the relevant Google Analytics JOSN file(s) in a chosen directory.
    • The package will detect specific filenames automatically so ensure they are correctly named:
      • "watch-history.html": initiates YouTube watch history processing.
      • "MyActivity": initiates search history processing.
    • The package will ask you to specify the directory with the data.
    • Processed files will be populated in the chosen directory.
  2. Configuration:

    • Modify any necessary settings in config.py to customize how data is processed and visualized.

Usage

Run the visualization tool with:

python -m takeout_visualizer

Choose the analytics files and types of visualizations through the command line interface.

Example Visualizations 📈

  • Activity Heatmaps: Visualize your online activity patterns over time.
  • Service Interaction Overview: Understand how you use different Google services.
  • Data Footprint Analysis: Explore the volume and type of data stored across various services.

Contributing 🤝

We encourage contributions from the community! Please read our CONTRIBUTING.md for guidelines on how to participate in developing this tool further.

Data Privacy Disclaimer

While the Self Stats Google Takeout Data Insights Visualizer offers powerful insights into your personal Google Analytics data, it's important to handle your data with care. Here are some precautions we strongly advise:

  • Sensitive Information: Your Google Takeout archive may contain sensitive personal information. Ensure you securely handle and store this data to prevent unauthorized access.
  • Data Security: Only use this tool on devices you trust, within secure environments. Avoid using public or shared computers where data might be compromised.
  • Privacy Settings: Regularly review your privacy settings on Google and other online platforms to manage what data is collected about you.
  • Data Sharing: Be cautious about sharing your insights and visualizations. They could inadvertently reveal personal information about you or your habits.
  • Legal Compliance: Ensure your use of data complies with local data protection laws and regulations, including GDPR, if applicable.

By using this tool, you agree to do so at your own risk. The developers of the Self Stats Google Takeout Data Insights Visualizer are not responsible for any data breaches or privacy violations that may occur from improper handling of your data. Always prioritize your data privacy and use this tool responsibly.

License

This project is released under the MIT License - see the LICENSE file for details.

Support and Feedback 📝

For support, feature requests, or to report bugs, please use the repository's issue tracker.

Why Choose Google Takeout Data Insights Visualizer?

Our tool not only visualizes your data from Google Takeout but also provides a powerful platform to uncover and understand personal trends and usage statistics, empowering you with the knowledge to make informed decisions about your digital privacy and online habits.

TODO

  • Make a blank data folder to submit to github for user access
  • Be more explicit about JSON settings for download
  • Change package name to something different
  • Add plot titles
  • Label axis better
  • Add modules to the init files
  • Document directory names
  • Make module docstrings
  • Leave some more comments throughout the script

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

self_stats_app-0.1.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

self_stats_app-0.1.0-py3-none-any.whl (26.1 kB view details)

Uploaded Python 3

File details

Details for the file self_stats_app-0.1.0.tar.gz.

File metadata

  • Download URL: self_stats_app-0.1.0.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for self_stats_app-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d551608cc0aa897944ca622e8ab21ca280e7c1c62d4f77c09da82ea79a3013f8
MD5 e6f878f8decb5cfaae9444be71c6baf4
BLAKE2b-256 855e042ae0bcd37cf75bcd3b1a361c7a12bb158bf85e2e6332fc0b07b76d1236

See more details on using hashes here.

File details

Details for the file self_stats_app-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: self_stats_app-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 26.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for self_stats_app-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f1b43f8d6fda81de9fdd6fbad63d7b6c198c496f7d92881fdf24af891d3d9a52
MD5 6388af0f79b07b8db42dd66d0473932f
BLAKE2b-256 663a2379c124a64879b95c4a82a1ead26934d748bb7b1b507b57d8baa59cb409

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page