Skip to content

YouTube automation tool with GUI & CLI for managing likes, comments, and subscriptions. Python-based YouTube API v3 integration with OAuth 2.0. Cross-platform support for Windows, Linux, and macOS.

License

Notifications You must be signed in to change notification settings

HaseebKaloya/Youtube-Automation-Suite

πŸŽ₯ YouTube Automation Suite

YouTube Logo

πŸš€ Professional YouTube Channel Management & Automation

Streamline your YouTube workflow with powerful automation tools

Python License Platform YouTube API

✨ Features β€’ πŸ“¦ Installation β€’ πŸ“š Documentation β€’ πŸš€ Quick Start β€’ 🀝 Contributing



πŸ‘¨β€πŸ’» Author

Haseeb Kaloya

πŸ“§ Email: [email protected]
πŸ“± Contact: +92 3294163702
πŸ’Ό Project: YouTube Automation Suite
🌟 Version: 1.0.0


🎯 Overview

YouTube Automation Suite is a powerful automation tool designed for efficient YouTube channel management. Whether you prefer a sleek graphical interface or command-line efficiency, this tool helps you automate likes, comments, and subscriptions seamlessly.

🌟 Key Highlights

πŸ–₯️ Dual Interface

Beautiful dark-themed GUI or powerful CLI - your choice

πŸ”’ Secure & Official

YouTube Data API v3 with OAuth 2.0 authentication

⚑ Smart Automation

Retry logic, rate limiting, and duplicate prevention

πŸ’‘ Pro Tip: This tool is designed for managing your own YouTube accounts. Always use responsibly and follow YouTube's Terms of Service.


✨ Features

πŸ’» User Interfaces

πŸ–₯️ GUI Version

βœ… Modern dark-themed interface
βœ… Real-time progress tracking
βœ… Live statistics dashboard
βœ… Color-coded activity logs
βœ… Responsive window sizing
βœ… Built-in settings panel

Perfect for: Visual learners and quick operations

⌨️ CLI Version

βœ… Powerful command-line interface
βœ… Automation script friendly
βœ… Colored terminal output
βœ… Detailed logging options
βœ… Batch processing support
βœ… Cross-platform compatible

Perfect for: Developers and automation workflows

πŸ€– Automation Capabilities

Feature Description API Cost Status
πŸ‘ Like Videos Automatically like videos from your custom URL list 50 units βœ… Active
πŸ’¬ Post Comments Post personalized comments on target videos 50 units βœ… Active
βž• Subscribe Channels Auto-subscribe to your favorite channels 50 units βœ… Active
πŸ”„ Smart Tracking Prevent duplicate actions with state management Free βœ… Active
⚑ Auto Retry Intelligent retry logic for API rate limits Free βœ… Active

πŸ› οΈ Advanced Features

πŸ’Ύ State Management

β€’ Resume after interruption
β€’ Prevent duplicates
β€’ Track all actions
β€’ JSON persistence

πŸ“ Smart Logging

β€’ CSV activity logs
β€’ Real-time console
β€’ Error tracking
β€’ Performance metrics

βš™οΈ Configuration

β€’ Custom delays
β€’ Action limits
β€’ Retry settings
β€’ Flexible paths

πŸ”§ Error Handling

β€’ Auto retries
β€’ Clear error messages
β€’ Graceful degradation
β€’ API limit handling

πŸ“¦ Installation

πŸ“ Prerequisites

Requirement Version Purpose
🐍 Python 3.8+ Core runtime environment
☁️ Google Cloud Free Account YouTube API access
🌐 Internet Stable API requests & authentication

⚑ Quick Setup

# Step 1: Clone or Download
git clone https://github.com/YOUR_USERNAME/Youtube-Automation-Suite.git
cd Youtube-Automation-Suite

# Step 2: Install Dependencies
pip install -r requirements.txt

# Step 3: Configure Google API (see Configuration section)

# Step 4: Run the Application
python src/youtube_automation_gui.py  # GUI
python src/youtube_automation_cli.py --help  # CLI
πŸ’‘ Note on Python Command
  • Windows: Use python
  • macOS/Linux: May need python3
  • Verify: Run python --version or python3 --version

All examples use python - replace with python3 if needed.

Virtual Environment (Recommended)

Click to expand virtual environment setup
# Create virtual environment
python -m venv venv

# Activate virtual environment
# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

βš™οΈ Configuration

πŸ”‘ Google API Setup

1️⃣ Create Project

Visit Google Cloud Console

2️⃣ Enable API

Activate YouTube Data API v3

3️⃣ OAuth Setup

Create OAuth 2.0 credentials

4️⃣ Download

Save as credentials.json

πŸ“š Detailed Instructions: See our comprehensive Setup Guide for step-by-step configuration


Usage

GUI Version

# Launch the GUI
python src/youtube_automation_gui.py

# Or use the launcher scripts (easier method):
# Windows: Double-click START_GUI.bat or run:
START_GUI.bat

# Linux/Mac: Run:
./start_gui.sh

πŸ’‘ Launcher Options: The batch/shell scripts are shortcuts that automatically run the Python files. Use whichever method you prefer!

Workflow:

1️⃣ Select Actions β†’ 2️⃣ Load Files β†’ 3️⃣ Configure Settings β†’ 4️⃣ Start Automation β†’ 5️⃣ Monitor Progress

CLI Version

πŸ“ Click to see CLI examples
# πŸ‘ Like videos from a list
python src/youtube_automation_cli.py --action like --file likes.txt

# πŸ’¬ Post comments on a video
python src/youtube_automation_cli.py --action comment --file comments.txt --video VIDEO_ID

# βž• Subscribe to channels
python src/youtube_automation_cli.py --action subscribe --file channels.txt

# βš™οΈ Advanced usage with custom settings
python src/youtube_automation_cli.py \
  --action like \
  --file likes.txt \
  --delay 5.0 \
  --jitter 1.5 \
  --limit 50

πŸ“„ Input File Formats

File Format Example
likes.txt Video URLs/IDs
https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
VIDEO_ID
comments.txt Comment text
Great video! Very helpful.
Amazing content, thanks!
This really helped me.
channels.txt Channel URLs/IDs
https://youtube.com/channel/UC...
@YouTubeHandle
UC_CHANNEL_ID

πŸ“š Documentation

πŸ“š User Guides

Guide Description
πŸš€ Setup Guide Complete installation & configuration walkthrough
πŸ“˜ User Guide Comprehensive usage instructions for GUI & CLI
πŸ’‘ Best Practices Pro tips, optimization strategies & safe usage

πŸ› οΈ Technical Resources

Resource Description
πŸ“Š API Reference Complete technical documentation & code examples
🀝 Contributing Join our community - contribution guidelines
πŸ“œ Code of Conduct Community standards & expectations

Security & Privacy

πŸ” Security Features

βœ… Local processing only
βœ… OAuth 2.0 secure authentication
βœ… No data collection
βœ… Open source & auditable

πŸ›‘οΈ Best Practices

βœ… Never share credentials
βœ… Use on your own accounts
βœ… Respect API rate limits
βœ… Follow YouTube TOS


Contributing

We welcome contributions from the community!

πŸ›
Report Bugs
πŸ’‘
Suggest Features
πŸ”§
Submit PRs
πŸ“–
Improve Docs

πŸ‘‰ Read our Contributing Guidelines to get started!


License

MIT License

Copyright Β© 2025 Haseeb Kaloya

βœ… Free to use, modify, and distribute
βœ… Commercial use allowed
βœ… No warranty provided
βœ… Attribution appreciated

View Full License


Disclaimer

πŸ“Œ Important Information

This tool is provided for educational and legitimate use cases only.

Users are responsible for:

  • βœ… Complying with YouTube's Terms of Service
  • βœ… Respecting API rate limits and quotas
  • βœ… Using automation only on accounts they own
  • βœ… Understanding potential policy implications

βš–οΈ The developer assumes no liability for misuse of this software.


Acknowledgments


Python
Programming Language

CustomTkinter
Modern GUI Framework

Google API
YouTube Integration

Colorama
Terminal Colors
πŸ’¬
Discussions
πŸ›
Issues
πŸ“§
[email protected]

πŸ“Š Project Information

Professional YouTube Automation Tool

Built with Python | YouTube Data API v3 | CustomTkinter


Made by Haseeb Kaloya

If you find this useful, consider giving it a star

⬆ Back to Top


YouTube Automation Suite - Professional Channel Management Tool