darth/HomeAssistant_YouTube_Sensors
Watch
1
0
Fork
You've already forked HomeAssistant_YouTube_Sensors
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
This Home Assistant HACS plugin retreives subscriber count, videos count and total views count from your YouTube channel — Powered by YouTube APIv3
2 commits 1 branch 0 tags 32 KiB
  • Python 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jerko Čilaš 701ad6aeb2 new stuff
2026-08-09 16:51:48 +02:00
custom_components/youtube_subscribers new stuff 2026-08-09 16:51:48 +02:00
tests new stuff 2026-08-09 16:51:48 +02:00
.gitignore new stuff 2026-08-09 16:51:48 +02:00
hacs.json Upload files to "/" 2026-08-09 16:36:50 +02:00
README.md Upload files to "/" 2026-08-09 16:36:50 +02:00

README.md

YouTube Subscribers for Home Assistant

Custom Home Assistant integration that exposes a YouTube channel's current public subscriber count, video count, and total view count as three sensors. It defaults to @LinuxRenaissance and uses the official YouTube Data API v3.

Installation

HACS (custom repository)

  1. Add this repository to HACS as an Integration custom repository.
  2. Install YouTube Subscribers and restart Home Assistant.

Manual

Copy custom_components/youtube_subscribers into the custom_components directory in your Home Assistant configuration, then restart Home Assistant.

Configuration

  1. In Google Cloud Console, enable YouTube Data API v3 and create an API key.
  2. In Home Assistant open Settings → Devices & services → Add integration.
  3. Search for YouTube Subscribers.
  4. Enter the API key and LinuxRenaissance (with or without @).

The API key is stored in Home Assistant's config-entry storage and is not written into this repository. The default update interval is 5 minutes. Change it from the integration's Configure button.

The integration creates Subscribers, Videos, and Views sensors. YouTube may return a rounded subscriber count for channels above certain sizes. Each sensor also includes the channel URL, channel ID, and whether the subscriber count is hidden.

API quota

The integration performs one channels.list request per update. At the default interval that is 288 requests per day. Avoid a needlessly short interval.