Command-line tool that tracks YouTube channel and video statistics over time. It refreshes the numbers on an interval, writes them to disk, keeps a local history so growth is measurable, exports the result as CSV, JSON or an HTML report, and can serve the same numbers over a small HTTP API.
| Channel statistics | Video statistics |
|---|---|
| Subscribers | Views |
| Total views | Likes |
| Video count | Comments |
Plus video length, publication date, hidden subscriber counts, comparisons between videos or channels, and terminal charts.
# Windows executable: double-click it and paste the requested values
# from source
git clone https://github.com/Klubuntu/YST.git
cd YST
pip install -r requirements.txt
# monitor a channel with console output, deltas and a summary
python src/YST.py monitor UCifZaTQPiHE2QRgEwDNfhug -dashboard=True
# compare two videos
python src/YST.py compare C7REVNM_EWY Xknt3_QJY7o
# export the stored history
python src/YST.py export UCifZaTQPiHE2QRgEwDNfhug
# serve the numbers over HTTP on http://127.0.0.1:9132
python src/YST.py serve UCifZaTQPiHE2QRgEwDNfhugOn Linux and macOS use ./scripts/yst in place of python src/YST.py.
Stop a run with Ctrl+C; results land in txt/, history in data/.
| Document | What it covers |
|---|---|
| Installation | Requirements, executables, source install, .env keys |
| Usage | Interactive mode, sub-commands, every option |
| Metrics and history | Logged values, selection, deltas, dashboard, export |
| Comparison and watchlists | Comparing videos and channels, monitoring a watchlist |
| API server | HTTP endpoints, configuration, web pages |
| Development | Layout, tests, CI, releases and signing, roadmap |
Start with usage for the full option reference.
- All releases —
YST.exefor Windows andystfor Linux and macOS, each with a checksum - In-development branch
Planned: documented scheduled runs (cron, systemd, Task Scheduler), channel-level trends in the report, and threshold alerts. Member counts and subscriber status are unavailable — YouTube removed them from the public API. The full roadmap has the details.
All pull requests, translations, and corrections are welcome — see open an issue or a PR.
If the tool is useful to you, you can support its development:
No license file has been added to this repository yet. Until one is added, the code is not granted any usage rights — please open an issue if you want to reuse it.