🎬 Apollo

Professional Video Editor & Auto Publisher

Remove watermarks · Add branding · Generate AI captions · Auto publish to Instagram Reels & YouTube Shorts

Download · Features · Quick Start · Documentation · Support

---

📖 Table of Contents

• Features
• Screenshots
• Download
• Quick Start
• Building from Source
• API Setup Guide
• Documentation
• How It Works
• Tech Stack
• Troubleshooting
• Roadmap
• Contributing
• License
• Support
• Acknowledgments

---

✨ Features

🎨 Video Editing

• 🎭 Smart Watermark Removal — Paint over unwanted areas with intelligent inpainting
• 💧 Custom Watermark Overlay — Add your branding with drag & scale controls
• ⚡ Video Enhancement — Upscale and sharpen automatically
• 🎬 Frame-perfect Preview — See changes before rendering

🤖 AI-Powered Content

• ✨ AI Caption Generator — Powered by Google Gemini
• 🌍 14+ Languages Support — English, Persian, Arabic, Turkish, Spanish, French, German, Portuguese, Chinese, Japanese, Korean, Russian, Hindi, Indonesian
• 🏷️ Smart Hashtag Generation — SEO-optimized tags for each platform
• 📝 Topic Identification — Automatic content analysis

🚀 Publishing

• 📸 Instagram Auto Publish — Direct upload to Reels with captions & hashtags
• ▶️ YouTube Shorts Upload — OAuth-based one-click publishing
• 🔒 Privacy Controls — Choose between private, unlisted, or public
• 📊 Publishing Logs — Track every step of the upload process

💎 Experience

• 🎨 Modern Dark UI — Beautiful design with smooth animations
• 🌐 Cross-Platform — Windows desktop + Android mobile
• 🔧 Setup Wizard — Easy first-time configuration
• 📚 In-App Tutorials — Step-by-step guides for every API
• 🌍 IP Checker — Know your outgoing IP for API compatibility
• 💾 Auto-Save — Never lose your work

---

📱 Screenshots

🖥️ Windows Version

📱 Android Version

Splash Screen	Dashboard	Settings

---

📥 Download

🖥️ Windows

Download the latest installer from Releases:

File	Description	Size
Apollo_Setup_2.0.0.exe	Full installer with all dependencies	~110 MB

System Requirements:

• Windows 10 or 11 (64-bit)
• 4 GB RAM minimum (8 GB recommended)
• 500 MB free disk space
• Internet connection

📱 Android

Download the APK from Releases:

File	Best For	Size
Apollo-v2.0.0-android-app-release.apk	ALL (recommended)	~51 MB
Apollo-v2.0.0-android-app-debug.apk	Test	~177 MB

System Requirements:

• Android 7.0 (API 24) or higher
• 2 GB RAM minimum
• 200 MB free storage
• Internet connection

---

🚀 Quick Start

Windows Installation

1. Download Apollo_Setup_2.0.0.exe from Releases
2. Run the installer
3. Choose installation directory
4. Select shortcut options (Desktop / Start Menu)
5. Launch Apollo from Desktop or Start Menu
6. Complete the setup wizard with your API keys

Android Installation

1. Download Apollo-v2.0.0-android-app-release.apk from Releases
2. Enable "Install from unknown sources" in Android settings
3. Open the downloaded APK file
4. Install and grant necessary permissions
5. Launch Apollo and complete setup wizard

First-Time Setup

When you first open Apollo, a setup wizard will guide you through:

1. Welcome — Introduction to features
2. Gemini AI — Add your API key for AI content
3. Instagram — Configure your Business account (optional)
4. Cloudinary — Set up video hosting for Instagram
5. YouTube — Upload OAuth credentials
6. Finish — Review and start using Apollo

You can skip steps and configure them later from Settings.

---

🔧 Building from Source

Prerequisites

For Windows Development:

• Python 3.11
• Git
• FFmpeg (add to PATH or place in project folder)
• Inno Setup 6+ (optional, for building installer)

For Android Development:

• Flutter SDK 3.19+
• Android Studio
• Android SDK 36
• JDK 17
• Android device or emulator (API 24+)

---

🖥️ Build Windows Version

Step 1: Clone the repository

git clone https://github.com/tahasite/apollo.git
cd apollo/windows

Step 2: Setup Python environment

Using auto-installer (recommended):

install.bat

Or manually:

python -m venv venv311
venv311\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt

Step 3: Add FFmpeg

Download FFmpeg and place ffmpeg.exe in the windows folder.

Step 4: Run in development

python app.py

Step 5: Build EXE

build.bat

Output: dist/Apollo/Apollo.exe

Step 6: Build Installer (optional)

"C:\Program Files (x86)\Inno Setup 6\Compil32.exe" /cc installer.iss

Output: installer_output/Apollo_Setup_2.0.0.exe

---

📱 Build Android Version

Step 1: Navigate to mobile folder

cd apollo/mobile

Step 2: Install Flutter dependencies

flutter pub get

Step 3: Verify Flutter setup

flutter doctor

Resolve any issues shown before proceeding.

Step 4: Run in development

Connect an Android device via USB (with USB debugging enabled) or start an emulator, then:

flutter run

Step 5: Build Release APK

Split by ABI (recommended, smaller files):

flutter build apk --release --split-per-abi

Single APK (larger but universal):

flutter build apk --release

App Bundle for Play Store:

flutter build appbundle --release

Output location: build/app/outputs/flutter-apk/

---

🔑 API Setup Guide

Apollo requires 4 API integrations. All are free for personal use.

Service	Purpose	Required	Guide
🤖 Google Gemini	AI captions & hashtags	Yes	Setup Guide
📸 Instagram	Publish reels	Optional	Setup Guide
☁️ Cloudinary	Video hosting (for Instagram)	Optional	Setup Guide
▶️ YouTube	Upload shorts	Optional	Setup Guide

Quick Overview

🤖 Google Gemini AI (2 minutes)

1. Visit aistudio.google.com/apikey
2. Sign in with Google account
3. Click "Create API key"
4. Copy the key (starts with AIzaSy...)
5. Paste in Apollo Settings → Gemini AI

Free tier: 1500 requests/day - more than enough for personal use

📸 Instagram API (10 minutes)

Requirements:

• Instagram Business or Creator account
• Facebook Page connected to Instagram
• Meta Developer account

Steps:

1. Create Meta App at developers.facebook.com
2. Add Instagram API use case
3. Add yourself as Instagram Tester
4. Generate Access Token
5. Copy: Access Token, Business Account ID, App Secret

See full guide for detailed steps.

☁️ Cloudinary (3 minutes)

1. Sign up free at cloudinary.com
2. Go to Dashboard
3. Copy: Cloud Name, API Key, API Secret
4. Paste in Apollo Settings → Cloudinary

Free tier: 25 GB storage + 25 GB bandwidth/month

▶️ YouTube API (10 minutes)

1. Go to Google Cloud Console
2. Create new project
3. Enable YouTube Data API v3
4. Configure OAuth Consent Screen
5. Add yourself as Test User
6. Create OAuth Client (Desktop app for Windows, Android for mobile)
7. Download JSON file
8. Upload in Apollo Settings → YouTube

See full guide for detailed steps.

---

📖 Documentation

User Guides

• Windows User Guide
• Android User Guide

API Setup

• Gemini AI Setup
• Instagram Setup
• Cloudinary Setup
• YouTube Setup

Developer

• Development Guide
• Contributing
• Architecture

Reference

• Changelog
• License

---

💡 How It Works

┌─────────────┐    ┌──────────────┐    ┌──────────────┐
│ Video File  │───▶│ Mask Editor  │───▶│  Watermark   │
└─────────────┘    └──────────────┘    └──────────────┘
                                              │
                                              ▼
┌─────────────┐    ┌──────────────┐    ┌──────────────┐
│  Instagram  │◀───│   Publish    │◀───│    Render    │
│   YouTube   │    │              │    │              │
└─────────────┘    └──────────────┘    └──────────────┘
                          ▲
                          │
                   ┌──────────────┐
                   │  AI Content  │
                   │  (Gemini)    │
                   └──────────────┘

Workflow

1. Import Video — Select video file from device
2. Mask Editor (optional) — Paint over watermarks or unwanted objects
3. Watermark (optional) — Add your branding image with drag & scale
4. Render — Process video with mask removal + watermark + enhancement
5. AI Generate (optional) — Get captions and hashtags in your language
6. Publish — One-click upload to Instagram Reels or YouTube Shorts

---

🛠️ Tech Stack

Windows Version

Technology	Purpose
Python 3.11	Core language
CustomTkinter	Modern UI framework
OpenCV	Video/image processing
FFmpeg	Video encoding
SQLite	Project storage
PyInstaller	Executable packaging
Inno Setup	Installer creation

Android Version

Technology	Purpose
Flutter 3.19+	Cross-platform framework
Dart 3	Programming language
Provider	State management
SQLite	Local database
Video Compress	Video processing
Google Sign-In	YouTube OAuth

APIs & Services

Service	Usage
Google Gemini AI	Content generation
Instagram Graph API	Reel publishing
YouTube Data API v3	Video upload
Cloudinary	Media hosting
IP-API	Location detection

---

🐛 Troubleshooting

Windows Issues

❌ "API access blocked" from Instagram

Causes:

• Instagram/Meta has blocked your current IP
• Token expired or invalid
• Rate limit reached

Solutions:

1. Regenerate Instagram Access Token
2. Wait 15 minutes and try again
3. Try without VPN/proxy
4. Verify Business Account ID is correct
5. Check if account is Business/Creator type

❌ "youtube_client_secret.json not found"

Solution:

1. Download OAuth JSON from Google Cloud Console
2. Go to Apollo Settings → YouTube
3. Click "Select client secret json"
4. Choose the downloaded file

❌ Rendering fails with FFmpeg error

Solutions:

1. Ensure ffmpeg.exe is in the Apollo installation folder
2. Try a shorter video (under 60 seconds)
3. Check available disk space (need 2-3x video size)
4. Verify video codec is supported (mp4 recommended)

❌ Python 3.14 detected error

Solution: Apollo requires Python 3.11. Install it from: Python 3.11 Download

Ensure venv311 uses Python 3.11 with:

py -3.11 -m venv venv311

Android Issues

❌ Google Sign-In error 10 (DEVELOPER_ERROR)

Cause: SHA-1 fingerprint not registered

Solution:

1. Get SHA-1 fingerprint:

   cd android
   ./gradlew signingReport

2. Copy the SHA1 from "Variant: debug"
3. Add to Google Cloud Console → Credentials → OAuth Android client
4. Package name: com.tahasite.apollo

❌ App crashes on startup

Solutions:

1. Ensure Android version is 7.0+ (API 24+)
2. Clear app data and cache
3. Reinstall the APK
4. Check if all permissions are granted

❌ Video rendering takes too long

Solutions:

• Use shorter videos (under 60 seconds recommended)
• Close other apps to free RAM
• Use a device with better specs
• Reduce video quality/resolution

Common Issues

❌ AI generation fails

Solutions:

1. Verify Gemini API key is valid
2. Check internet connection
3. Try a different Gemini model
4. Add multiple API keys for rotation
5. Check daily quota (1500 requests/day free)

❌ Cloudinary upload fails

Solutions:

1. Verify Cloud Name, API Key, API Secret
2. Check monthly bandwidth usage
3. Ensure video is under 100 MB
4. Try smaller video first

---

🗺️ Roadmap

Version 2.1 (Q4 2026)

• TikTok publishing support
• Twitter/X video upload
• Scheduled posting
• Multiple watermarks per video

Version 2.2 (Q1 2027)

• Video trimming/cutting
• Audio replacement
• Text overlay editor
• Filter presets

Version 3.0 (Q2 2027)

• macOS support
• iOS support
• Batch processing
• Cloud sync across devices
• Team collaboration

Community Requests

Vote on features in Discussions or suggest new ones!

---

🤝 Contributing

Contributions are welcome and greatly appreciated! Every contribution helps make Apollo better.

How to Contribute

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Types of Contributions

• 🐛 Bug Reports — Open an issue
• 💡 Feature Requests — Suggest ideas
• 📖 Documentation — Improve docs and guides
• 🌍 Translations — Help translate the app
• 💻 Code — Submit pull requests
• ⭐ Star the repo to show support

Development Guidelines

• Follow existing code style
• Write clear commit messages
• Update documentation for new features
• Test on both Windows and Android
• Ensure no sensitive data is committed

See CONTRIBUTING.md for detailed guidelines.

---

📄 License

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

What this means:

✅ You can:

• Use commercially
• Modify
• Distribute
• Use privately

⚠️ You must:

• Include the license
• Include copyright notice

❌ No warranty:

• The software is provided "as is"

---

💬 Support

Need help? Have questions? Want to request features?

📞 Contact & Support

Direct Contact: @main_admin_tahasite

Response Time: Usually within 24 hours

Getting Help

• 📚 Check the Documentation first
• 🔍 Search existing issues
• 💬 Ask in Discussions
• 🐛 Report bugs
• 💡 Request features
• 📱 Contact directly: @main_admin_tahasite

Support the Project

If Apollo helped you, please:

• ⭐ Star this repository
• 🐦 Share on social media
• 📝 Write about your experience
• 🤝 Contribute code or documentation
• 💬 Tell your friends

---

⭐ Acknowledgments

Special thanks to:

• Google Gemini — AI content generation
• Meta for Developers — Instagram Graph API
• YouTube API — Video upload capability
• Cloudinary — Media hosting service
• FFmpeg — Video processing engine
• Flutter — Cross-platform framework
• CustomTkinter — Modern Python UI
• OpenCV — Computer vision library

Contributors

Thanks to all our amazing contributors! 🎉

---

📊 Stats

---

🔐 Security

Found a security vulnerability? Please do not open a public issue.

Contact directly: @main_admin_tahasite

We take security seriously and will respond promptly to any reports.

Security Best Practices

• 🔒 Never share your API keys
• 🔒 Never commit config.json or token files
• 🔒 Use strong passwords for your accounts
• 🔒 Enable 2FA on Google, Meta, and other accounts
• 🔒 Regularly rotate your API keys

---

📱 Follow the Project

Stay updated with the latest news, features, and releases:

• 💬 Telegram: @main_admin_tahasite
• ⭐ GitHub: Star this repository
• 👁️ Watch: Get notified of new releases

---

🎯 FAQ

Is Apollo free?

Yes! Apollo is 100% free and open-source. All required APIs offer generous free tiers.

Do I need a paid subscription?

No. Google Gemini, Instagram, YouTube, and Cloudinary all provide free tiers that are sufficient for personal use.

Can I use it commercially?

Yes, the MIT license allows commercial use. However, ensure you comply with each platform's API terms of service.

Is my data safe?

Yes. Apollo runs entirely on your device. Your API keys and videos never leave your computer/phone except when uploading to your own accounts.

Does Apollo work offline?

Partially. Video editing works offline, but AI generation and publishing require internet.

Can I request custom features?

Yes! Open an issue or contact @main_admin_tahasite on Telegram.

How do I update Apollo?

Check the Releases page for new versions. Download and install the latest version.

Will there be an iOS version?

Planned for Version 3.0 (Q2 2027). Contributions welcome!

---

🌟 Made with ❤️ by tahasite

If Apollo helped you, please give it a ⭐ on GitHub!

⬆ Back to Top