🚀 AUTO-blogger - AI-Powered WordPress Automation Tool

Copyright © 2025 AryanVBW
🌐 Website: https://aryanvbw.github.io/AUTO-blogger/website/
📧 Contact: AryanVBW@gmail.com

Transform your WordPress content strategy with intelligent automation!

AUTO-blogger is a professional-grade WordPress automation tool that combines the power of AI content generation, Getty Images integration, and comprehensive SEO optimization to revolutionize your blogging workflow.

🚀 Quick Start

```bash

Install from PyPI (Recommended)

pip install auto-blogger

Launch the application

autoblog ```

That's it! 🎉 Ready to automate your WordPress content creation.

🎯 What Makes AUTO-blogger Special?

• 🤖 Dual AI Integration: Harness both OpenAI GPT and Google Gemini for superior content quality
• 📸 Professional Imagery: Getty Images editorial collection with proper licensing
• 🔍 SEO Mastery: Advanced optimization with Yoast and AIOSEO plugin compatibility
• 🔄 Zero-Maintenance Updates: Self-updating system ensures you're always current
• 🌐 Multi-Domain Management: Handle multiple WordPress sites from one interface
• 📊 Real-Time Monitoring: Comprehensive progress tracking and detailed logging

A comprehensive GUI application for automating WordPress blog posting with AI-powered content generation, SEO optimization, and automatic updates.

✨ Key Features

🤖 AI-Powered Content Generation - Automatic article scraping from source websites - Gemini AI integration for content rewriting and paraphrasing - SEO-optimized title and meta description generation - Focus Keyphrase and Additional Keyphrases extraction for SEO - Smart internal and external link injection - Enhanced WordPress SEO compatibility with Yoast and AIOSEO plugins

🖼️ Advanced Image Generation - OpenAI DALL-E integration for AI-generated images - Featured image generation with customizable prompts - Content image insertion for enhanced article visuals - Custom prompt support for personalized image styles - Configurable image settings (size, style, model) - Getty Images editorial content integration - Professional sports photography enhancement

🔄 Auto-Update System - Automatic repository cloning and updates - Self-updating launcher that checks for new versions - One-command installation with dependency management - Cross-platform compatibility (Windows, macOS, Linux) - Zero-maintenance updates - always runs the latest version

📊 Real-Time Progress Tracking - Step-by-step progress visualization - Detailed logging with color-coded messages - Performance metrics and timing information - Task completion status tracking

🔐 Secure Authentication - WordPress REST API integration - Secure credential storage - Connection testing and validation - Multi-site support with domain-specific configurations

⚙️ Advanced Configuration - Customizable source URLs and selectors - Configurable link injection rules - Category and tag management - Processing timeout settings - Domain-specific configuration profiles

📋 Comprehensive Logging - Real-time log display with filtering - Export logs to file - Error tracking and debugging - Performance monitoring - Session-based log management

📁 Project Structure

AUTO-blogger/ ├── 📁 configs/ # Configuration files for different domains ├── 📁 docs/ # Documentation and implementation guides │ ├── fixes/ # Fix documentation │ └── installation/ # Installation guides ├── 📁 logs/ # Session-based log files ├── 📁 scripts/ # Utility and maintenance scripts │ ├── installation/ # Installation scripts │ ├── launchers/ # Launch scripts │ └── fixes/ # Fix and maintenance scripts ├── 📁 tests/ # Test files and debugging scripts │ ├── unit/ # Unit tests │ └── integration/ # Integration tests ├── 🐍 autoblog_launcher.py # Auto-update launcher with progress dialog ├── 🐍 automation_engine.py # Core automation logic ├── 🐍 gui_blogger.py # Main GUI application ├── 🐍 launch_blogger.py # Application launcher ├── 🐍 log_manager.py # Advanced logging system ├── 🔧 install.sh # Main installation script ├── 🚀 autoblog # System launcher script ├── 📄 requirements.txt # Python dependencies ├── 📄 blog_config.json # Main configuration file (auto-created) ├── 📄 posted_links.json # Duplicate prevention (auto-created) └── 📄 README.md # This file

🚀 Installation

📦 PyPI Installation (Recommended - Easiest)

Install directly from PyPI: bash pip install auto-blogger

Launch the application: ```bash autoblog

OR

auto-blogger ```

That's it! 🎉 The package includes all dependencies and is ready to use.

🔧 One-Command Installation (Development Version)

For macOS and Linux: bash curl -sSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install.sh | bash

For Windows (PowerShell as Administrator): powershell Invoke-WebRequest -Uri https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install.sh -OutFile install.sh; bash install.sh

Local Installation (if you have the repository):

```bash

Clone and install

git clone https://github.com/AryanVBW/AUTO-blogger.git cd AUTO-blogger bash install.sh ```

What the installer does: - ✅ Detects your operating system automatically - ✅ Installs Git, Python 3.8+, and Chrome/Chromium - ✅ Clones the repository with auto-update capability - ✅ Creates a virtual environment with all dependencies - ✅ Sets up system-wide launcher (autoblog command) - ✅ Creates desktop shortcuts - ✅ Tests the installation - ✅ Handles existing installations with update/reinstall options - ✅ Supports non-interactive mode for automation and CI/CD

Launch AUTO-blogger

After installation, start AUTO-blogger using any of these methods:

If installed via pip: ```bash

Available globally after pip installation

autoblog

OR

auto-blogger ```

If installed via script: ```bash

System-wide command (if available)

autoblog

From installation directory

./autoblog

Desktop shortcut (double-click)

AUTO-blogger icon on desktop

```

Prerequisites (Auto-installed)

• Python 3.8 or higher
• Git (for auto-updates)
• Chrome/Chromium browser (for web scraping)
• WordPress site with REST API enabled
• Gemini API key
• OpenAI API key (optional, for image generation)

Manual Installation (Advanced Users)

1. Clone the repository bash git clone https://github.com/AryanVBW/AUTO-blogger.git cd AUTO-blogger

2. Create virtual environment bash python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install dependencies bash pip install -r requirements.txt

4. Launch the application bash python autoblog_launcher.py

📖 Usage

1. Launch the Application

If installed via pip: ```bash autoblog # Available globally

OR

auto-blogger # Alternative command ```

If installed via script: ```bash autoblog # System-wide command

OR

./autoblog # From installation directory ```

The application will automatically check for updates before launching (script installation only).

2. Configure Authentication

• Go to the 🔐 Authentication tab
• Enter your WordPress site URL (e.g., https://yoursite.com/wp-json/wp/v2)
• Enter your WordPress username and password
• Enter your Gemini API key
• NEW: Enter your OpenAI API key for image generation
• Click Test Connection to verify
• Click Login & Save to store credentials

3. Configure OpenAI Image Generation (Optional)

• Go to the 🖼️ OpenAI Images tab
• Configure image settings (size, style, model)
• Set prompt prefix and suffix for consistent styling
• Add custom prompts for specific image styles
• Test example prompts for different image types
• Save configuration

4. Configure Automation Settings

• Go to the 🤖 Automation tab
• Set the maximum number of articles to process
• Select Featured Images option: None, OpenAI DALL-E, or Getty Editorial
• Select Content Images option: None, OpenAI Generated, or Getty Editorial
• Enable "Use Custom Prompt" to use your custom image prompts
• Verify the source URL for article scraping
• Click ▶️ Start Automation

5. Monitor Progress

• Watch real-time progress in the step tracker
• View detailed logs in the 📋 Logs tab
• Monitor completion status and performance metrics

6. Advanced Configuration

• Go to the ⚙️ Configuration tab
• Customize source URLs and CSS selectors
• Configure internal and external link rules
• Adjust processing timeouts and settings

Configuration Options

Source Configuration

• Source URL: The website to scrape articles from
• Article Selector: CSS selector for finding article links
• Timeout: Maximum time to wait for page loads

WordPress Configuration

• Site URL: Your WordPress REST API endpoint
• Username: WordPress username with posting permissions
• Password: WordPress application password
• Gemini API Key: Google Gemini AI API key

Link Configuration

• Internal Links: JSON configuration for internal site links
• External Links: JSON configuration for external reference links

Process Flow

The automation follows this step-by-step process:

1. Fetch Article Links - Scrape source website for new articles
2. Extract Content - Use Selenium to extract article title and content
3. AI Paraphrasing - Use Gemini AI to rewrite and optimize content
4. Inject Internal Links - Add relevant internal site links
5. Inject External Links - Add authoritative external references
6. Add Content Images - Generate and insert AI images or Getty editorial images within article content
7. Generate SEO Metadata - Create optimized titles and descriptions
8. Extract Keyphrases - Generate focus keyphrase and additional keyphrases for SEO
9. Process Featured Images - Generate or source featured images using OpenAI DALL-E or Getty Images
10. Detect Categories - Automatically categorize content
11. Generate Tags - Extract and create relevant tags
12. Create WordPress Post - Publish as draft to WordPress with all media attached
13. Finalize - Complete processing and update status

🔄 Auto-Update System

AUTO-blogger features a sophisticated auto-update system:

• Automatic Updates: Every launch checks for new versions
• Progress Dialog: Visual feedback during update process
• Zero Downtime: Updates happen before application launch
• Rollback Safety: Git-based updates with version tracking
• Cross-Platform: Works on Windows, macOS, and Linux

How Auto-Updates Work

1. Launch Detection: autoblog_launcher.py checks GitHub for updates
2. Update Check: Compares local and remote commit hashes
3. Download: Pulls latest changes via Git
4. Progress Display: Shows update progress with tkinter dialog
5. Launch: Starts the updated application automatically

🔧 Troubleshooting

Installation Issues

1. Permission Errors - Run installation with appropriate permissions - On Linux/macOS: Use sudo if needed for system-wide installation - On Windows: Run PowerShell as Administrator

2. Git Not Found - The installer will automatically install Git - Manual install: https://git-scm.com/downloads

3. Python Version Issues - Requires Python 3.8 or higher - The installer will install compatible Python version - Check version: python3 --version

Runtime Issues

1. Import Errors - Ensure virtual environment is activated - Run autoblog command instead of direct Python execution - Reinstall dependencies: pip install -r requirements.txt

2. Selenium Issues - Chrome/Chromium browser required (auto-installed) - ChromeDriver automatically managed by webdriver-manager - Check firewall/antivirus blocking WebDriver

3. WordPress Connection Issues - Verify REST API is enabled on your WordPress site - Use application passwords, not regular passwords - Check URL format: https://yoursite.com/wp-json/wp/v2 - Test connection in Authentication tab

4. API Issues - Gemini API: Verify key is correct and billing is set up - OpenAI API: Check quotas and usage limits - Rate Limits: Application handles rate limiting automatically

5. Auto-Update Issues - Ensure Git is installed and accessible - Check internet connection - Verify GitHub repository access - Manual update: git pull origin main

Error Logs

Check the 📋 Logs tab for detailed error messages and debugging information. Logs are saved in the logs/ directory.

Security Notes

• Credentials are stored locally in blog_config.json
• Use WordPress application passwords instead of regular passwords
• Keep your Gemini API key secure and don't share configuration files
• The application creates draft posts for review before publishing

📞 Support

For issues and support:

1. Check Logs: Review the 📋 Logs tab for detailed error messages
2. Test Components: Verify WordPress connection and API keys in respective tabs
3. Update Check: Ensure you're running the latest version (auto-updates on launch)
4. Documentation: Check the docs/ folder for detailed guides
5. GitHub Issues: Report bugs at GitHub Issues
6. Email Support: AryanVBW@gmail.com

🏆 Benefits

For Content Creators

• Time Saving: Automate entire blog posting workflow
• SEO Optimized: Built-in SEO best practices and keyphrase extraction
• Professional Quality: AI-generated images and content
• Multi-Site Support: Manage multiple WordPress sites

For Developers

• Always Updated: Auto-update system ensures latest features
• Cross-Platform: Works on Windows, macOS, and Linux
• Extensible: Modular design for easy customization
• Well-Documented: Comprehensive documentation and guides

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• GUI Framework: Python tkinter for cross-platform interface
• Web Scraping: Selenium WebDriver with automatic driver management
• AI Integration: Google Gemini AI and OpenAI DALL-E
• WordPress API: REST API for seamless publishing
• HTML Parsing: BeautifulSoup4 for content extraction
• Image Processing: Pillow (PIL) for image manipulation
• Auto-Updates: Git-based version control and updates