yt-live-scraper
A Python library and CLI tool for scraping YouTube channels for live and upcoming stream events.
Installation
pip install yt-live-scraper
Documentation
The full library documentation can be found here.
CLI Usage
# Show upcoming streams for one or more channels
yt-live-scraper @home_assistant @superhousetv
# Output as JSON
yt-live-scraper @home_assistant --json
# Only show streams from a specific date onwards
yt-live-scraper @home_assistant --from 2026-03-01
Library Usage
Get upcoming streams
from yt_live_scraper import get_upcoming_streams
streams = get_upcoming_streams(["@home_assistant", "@superhousetv"])
for stream in streams:
print(stream)
Check if a stream is live
from yt_live_scraper import is_stream_live
if is_stream_live("dQw4w9WgXcQ"):
print("Stream is live!")
UpcomingStream fields
Each UpcomingStream object contains:
| Field | Type | Description |
|---|---|---|
channel |
str |
Channel display name |
channel_thumbnail_url |
str |
URL of the channel's avatar image |
video_id |
str |
YouTube video ID |
title |
str |
Stream title |
scheduled_start |
datetime |
Scheduled start time (UTC) |
url |
str |
Full YouTube watch URL |
thumbnail_url |
str |
URL of the stream's thumbnail image |
live |
bool |
True if the stream is currently live |
Development
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
License
1 maintainer
Release files for yt-live-scraper 1.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yt_live_scraper-1.7.0.tar.gz | 16.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yt_live_scraper-1.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.2 kB
Release files / yt_live_scraper-1.7.0.tar.gz
| Download URL | yt_live_scraper-1.7.0.tar.gz |
|---|---|
| Size | 16.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
519a4fa8e7411daeef7a436842ca9caf8ce19ec2acd1cec078eda94abf995d97
|
|
BLAKE2b-256 checksum How to use checksums |
ccf822d6d193cab0f743578a094eedaac8a69142877d9087db3cb4f42974cdb4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / yt_live_scraper-1.7.0-py3-none-any.whl
| Download URL | yt_live_scraper-1.7.0-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e802a802b1586601d3278e238757ca1e93072371abe2c5f1f6748aac4c72a0c
|
|
BLAKE2b-256 checksum How to use checksums |
d6c4389e12dc9b7a7a4fd5c0b11e79a17797118ceba8b0652104786b96f987b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
