An awesome Discord Bot to fetch your YouTube Channel Analytics.

• Collects data on a variety of metrics, including views, revenue, subscriber growth, & more
• Can be used to analyze the performance of a channel and identify areas for improvement
• Discord Button User-Friendly UI
• Docker Support
• Developer Mode
• Efficient API Service Build Methods & Fail-Safe(s)
• Ability to Run 24/7 using Replit & Flask (Dev Mode + Build From Document)

Start every command with !. Optional Command Input is denoted using [brackets].

Check Example Output Folder for output examples.

• MM / DD Format (MONTH/DATE, Assumes the current year) or MM / DD / YYYY:

   !stats 01/01 12/01
   !stats 01/01/2021 12/31/2021

Upon invoking the !button command, these are currently supported with a scene containing interactive buttons:

• Analytics
• Top Revenue Videos
• Top Searched Keywords
• Playlist Stats
• Geographic Data
• OS Statistics
• Traffic Source
• Shares
• Top Geographic Based Revenue

For this project, you need to enable use of Google Cloud Console YouTube Analytics/Data API for your account & create a discord bot to obtain a discord token.

Follow these well-organized steps to set up the Google Cloud Console API:

1. Create a New Project

   • Visit the Google Cloud Console website and create a new project.

2. Enable APIs and Services

   • Click on API & Services and select Enable APIs and Services.

3. Enable YouTube APIs

   • Search for and enable both the YouTube Data API and YouTube Analytics API.

4. Configure OAuth Consent Screen

   • Return to the API & Services page and click on Credentials.
   • Select User Type (External), then configure the OAuth Consent Screen by adding the following YouTube Analytics related scopes:
     • https://www.googleapis.com/auth/youtube.readonly
     • https://www.googleapis.com/auth/yt-analytics-monetary.readonly

5. Complete OAuth Configuration

   • Proceed with the rest of the configuration settings for OAuth.

6. Create OAuth Credentials

   • Click Create Credentials, then select OAuth Credentials, followed by Desktop Application. Continue with the setup.

7. Download OAuth JSON File

   • Download the JSON file and name it CLIENT_SECRET.json.
   • Place this file in the same folder as your program. You'll have the option to assign its contents to the CLIENT_SECRET environment variable after running the program and generating a refresh token.

8. Create API Key

   • Create Credentials -> API Key.
   • Copy and assign the API key to the YOUTUBE_API_KEY environment variable.

Now, your Google Cloud Console API is fully set up and ready to use!

Follow these organized steps to set up your Discord bot:

1. Create a Discord Application

   • Visit Discord Developers and create a new application. Name it "YouTube Apprise" or choose a suitable name. Accept the terms.

2. Configure OAuth2

   • Access your newly created application and go to the OAuth2 URL Generator section.

3. Select Scopes and Permissions

   • Under Scopes, choose Bot and enable the required bot permissions.
     • Ensure text permissions like Send Messages and Read Message History are enabled.
     • Additionally, enable general permissions like View Server Insights.

4. Generate Bot Invite Link

   • Copy the generated link located beneath the Permissions section. Paste this link into your browser. Use it to add the bot to your preferred server. It's recommended to add the bot to your private Discord server to safeguard sensitive information, like revenue and CPM, accessible through bot commands.

5. (Optional) Customize Profile Picture

   • Enhance your bot's appearance by uploading an appealing image in the Rich Presence section.

6. Retrieve Bot Token

   • In the Bot section of your application, obtain, reset, or retrieve the bot token. Assign this token to the DISCORD_TOKEN environment variable.

Now, your Discord bot is ready for action!

The bot can be run using Python or Docker.

1. Clone this repository, cd into it, and install dependancies:

   git clone https://github.com/Prem-ium/youtube-analytics-bot
   cd youtube-analytics-bot
   pip install -r requirements.txt

2. Configure your .env file (See below and example for options)

3. Run the script:

    python main.py

Before building the Docker container, follow these steps carefully to ensure a smooth setup. Ensure you have generated the credentials.json file locally (unless developer mode is enabled):

1. Generate Credentials JSON File

   • Run the Python script locally to generate the credentials.json file.

2. Install Docker

   • Download and install Docker on your system.

3. Configure .env File

   • Configure your .env file with the necessary settings (see below for options).

4. Build the Docker Image

   • To build the image yourself, navigate to the repository directory and execute the following command:

     docker build -t youtube-apprise .

5. Start the Bot

   • Start the bot within a Docker container with the following command:

     docker run -it --env-file ./.env --restart unless-stopped --name youtube-apprise youtube-apprise

   • Ensure that the path to your .env file is correctly specified.

6. Running the Bot

   • Once started, the bot will log in and begin its tasks.
   • IMPORTANT: Do NOT press CTRL-c as it will terminate the container and the bot. To exit the logs view, use CTRL-p followed by CTRL-q. This will exit the logs view without stopping the bot.

By following these steps, you'll have a Docker container named youtube-apprise running your bot.

As always, please refer to the `.env.example' file for examples.

As of 9/8/2024, I have disabled the Issues privilege for the general public. For direct support on any bugs or issues, please consider sponsoring me as a GitHub Sponsor under the Silver or Gold tier.

If you appreciate my work and would like to show your support, there are two convenient ways to make a donation:

1. GitHub Sponsors

   • Donate via GitHub Sponsors
   • This is the preferred donation method as it incurs no transaction fees & different tiers offer perks.

2. Buy Me A Coffee

   • Donate via Buy Me A Coffee
   • 

3. Referral Links

   • If you're unable to make a monetary donation, you can still support my work by using my curated Referral Links. Earn bonuses and rewards while contributing to my projects at the same time.
   • Explore Referral Links

Your generous donations will go a long way in helping me cover the expenses associated with developing new features and promoting the project to a wider audience. I extend my heartfelt gratitude to all those who have already contributed. Thank you for your support!

This repository uses the BSD 3-Clause “New” or “Revised” License.

Please leave a 🌟 if you found this project to be cool! Made possible thanks to Google's YouTube Analytics/Data APIs May your analytics skyrocket up📈