Skip to content

Sends an email to you if the channel released a new video (checks every day)

Notifications You must be signed in to change notification settings

peme969/youtube-release-notifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Video Release Notifier

⚡️ Latest video release notifier for YouTube

Powered by GitHub Actions 🐙 and Python 🐍

FeatureUsagePreview

GitHub issues

GitHub watchers

(*)

Important

Read all documents in this repo before doing anything!

Don't forget to star ⭐ this repository

  • Always update your repo following the original repo to get the latest update + bug fixes; I will not support anything if your repo is outdated
  • Do not enter your information ( token ) into 2 workflows file ( main.yml and manual.yml ) because it will not work and may leak your information to everyone
  • (*): Do not fork this repo if one of these or all of these ( not CodeQL ) GitHub Actions status badge show failing, and wait until one of these or two of these show passing then you can fork again
  • Daily Release Detector workflows always run every 18:00 UTC + 0; if you want to change it, refer to this

Features

  • Sends to Mail with video url and publish date 🔥
  • Accurately detects the latest video released every day ⚡

Usage

  1. Copy the youtube channel username (eg. https://youtube.com/channel/@Yarnhub -> Yarnhub)
  2. Go to Youtube Channel ID Finder and paste the channel's username
  3. Convert it
  4. Copy the Youtube channel's ID
  5. Fork this repository 🍴
  6. Go to your forked repository 🍴
  7. Go to Settings > Secrets and Variables > Actions, and click New Repository secret
  8. Use channel_id as the name and paste the channel id from Steps 4
  9. Repeat step 7 and add the email (name: email), email app password (name: email_password), and youtube data v3 api key (name: api_key)
  10. Go to your forked repository 🍴 and go to the Actions tab and press I understand my workflows, go ahead and enable them

Important

If you want to check manually, go to the Manual Release Checker workflows ( located in the Actions tab of the repo ). Then,enter the date you want to check (eg. 1). If you want to check another channel, enter the channel's id (use this to convert from username to channel id). (this is optional) If you got Oh no! the api encountered an error! then create a bug in the issues tab (create it here not in your forked repo)!

image

image

image

How to change the schedule that the workflows will run?

Important

Daily workflow file path ( default is 14:00 UTC ± 0, and DO NOT enter your token here cause it will not work and may leak your information to everyone ): .github/workflows/daily.yml

  • Well, GitHub uses UTC time ( UTC ± 0 ) for scheduling workflows, so we should convert it to our timezone

  • For example: If I want to set the daily trigger to trigger at 9:00 PM ( UTC + 7 ) , I have to set it to 2:00 PM or 14:00 ( 24-hour format ) ( UTC ± 0 ) ( 2+7=9 ):

name: Daily Release Detector
on:
  schedule:
    - cron: '0 14 * * *' # <- Use UTC Time +0 , change your time here ( 14 is hour , 0 is minutes ) and use 24-hour format
  • So, if I want the daily trigger to run at 5:00 AM ( UTC + 7 ), I have to set it to 10:00 PM ( UTC ± 0 ) ( use 24-hour format ):
name: Daily Release Detector
on:
  schedule:
    - cron: '0 22 * * *' # <- Use UTC Time +0 , change your time here ( 14 is hour , 0 is minutes ) and use 24-hour format

Note

GitHub Actions schedules can sometimes be delayed by up to 15 minutes due to high demand, so don’t worry! ⏱️

Preview

image (This is what happens when the manual release checker is run... (in github actions)) image (This is what happens when the daily release detector is run... (in github actions)) image (this is what the email looks like)

About

Sends an email to you if the channel released a new video (checks every day)

Resources

Stars

Watchers

Forks

Languages