Metadata-Version: 2.1
Name: yt-toolkit
Version: 0.1.5
Summary: A library for retrieving and processing YouTube data (API, scraping, transcripts, heatmaps).
Home-page: https://github.com/MartaAlet/yt-toolkit
Author: MartaAlet
Author-email: m.aletpuig@gmail.com
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: google-api-python-client (>=2.0.0)
Requires-Dist: google-auth (>=2.0.0)
Requires-Dist: selenium (>=4.0.0)
Requires-Dist: beautifulsoup4 (>=4.9.0)
Requires-Dist: lxml (>=4.6.0)
Requires-Dist: youtube-transcript-api (>=0.4.0)
Requires-Dist: svgpathtools (>=1.4.0)
Requires-Dist: trio-websocket (==0.11.1)

# YT-Toolkit

YT-Toolkit is a Python library for retrieving and processing YouTube data. It provides an easy-to-use interface for working with various YouTube functionalities, including:
- **API Interactions:** Retrieve video details, channel metrics, and search for videos using the YouTube Data API.
- **Web Scraping:** Extract elements such as heatmaps and page content using Selenium and BeautifulSoup.
- **Transcript Processing:** Retrieve and analyze YouTube transcripts to find contiguous matching segments.
- **Heatmap Analysis:** Process SVG heatmap data to generate insights on viewer rewatch.

## Features

- **YouTube API Module:**  
  Easily authenticate and retrieve video and channel data using the official YouTube API.
  
- **Scraping Module:**  
  Use Selenium and BeautifulSoup to extract dynamic content from YouTube pages.
  
- **Transcript Module:**  
  Retrieve subtitles using the `youtube_transcript_api` and perform text analysis to identify key segments.
  
- **Heatmap Module:**  
  Process SVG heatmap path data to map viewer rewatch moments.

## Installation

You can install yt-toolkit using pip:

`pip install yt-toolkit`
