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
Metadata
Release files for yt-live-scraper 1.8.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 | Provenance | Actions |
|---|---|---|---|---|
| yt_live_scraper-1.8.0.tar.gz | 17.1 kB | Without provenance | Details for yt_live_scraper-1.8.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| yt_live_scraper-1.8.0-py3-none-any.whl | Python 3 | none | any | Details for yt_live_scraper-1.8.0-py3-none-any.whl |
Total release size: 27.9 kB
Release files / yt_live_scraper-1.8.0.tar.gz
| Download URL | yt_live_scraper-1.8.0.tar.gz |
|---|---|
| Size | 17.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c154b9fb862cafa4bc9947d9d46e653763905d3b01e88c8f074cbcc733075359
|
|
BLAKE2b-256 checksum How to use checksums |
9e1e3ab6ce1f5361a10de461ceee5e49898364aafcac3875a3e549ff7d61f35a
|
| 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.8.0-py3-none-any.whl
| Download URL | yt_live_scraper-1.8.0-py3-none-any.whl |
|---|---|
| Size | 10.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb93c0e96baefea877c93971c6c62340644f6df36d5b876bbdfe9128b38bccab
|
|
BLAKE2b-256 checksum How to use checksums |
e0f62224f2a1ef1248310875470fea48d83c8836f4cde9603fb8153df4858249
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for yt-live-scraper 1.8.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.