ReelComp: TikTok Video Compilation Automation

Automate creating video compilations from tiktok content. Collect videos from TikTok, create compilations with smooth transitions, generate thumbnails, and upload directly to YouTube.

❤️ Sponsor This Project

If you find ReelComp useful, please consider sponsoring the project to support ongoing development and maintenance:

Your sponsorship helps keep this project active and improving!

Installation

Prerequisites

• Python 3.8+
• FFmpeg
• Playwright (for browser automation)

Setup

# Clone and setup
git clone https://github.com/YOUR_USERNAME/reelcomp.git
cd reelcomp
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python -m playwright install chromium

Installing FFmpeg

• macOS: brew install ffmpeg
• Ubuntu/Debian: sudo apt update && sudo apt install ffmpeg
• Windows: Download from ffmpeg.org and add to PATH

Usage

Collecting Videos

python -m src.url_collector.tiktok_scraper --count 10 --output tiktok_urls.txt --hashtag funny

Creating a Compilation

python -m src.main --urls tiktok_urls.txt --title "Funny Compilation"

Complete Workflow

# Collect videos and create compilation in one command
python -m src.url_collector.tiktok_scraper --count 10 --output tiktok_urls.txt --hashtag funny && python -m src.main --urls tiktok_urls.txt --title "Weekly Compilation" --upload

YouTube Shorts

# Create a YouTube Short from compilation
python -m src.main --urls tiktok_urls.txt --title "Funny Moments" --compilation-short

# Or create individual Shorts from each video
python -m src.main --urls tiktok_urls.txt --title "Best TikToks" --generate-shorts

🕒 Automated Weekly Workflow

You can automate the entire process to run weekly (or on any schedule) using a shell script and cron.

Example Shell Script

Create a file called tiktok_weekly.sh:

#!/bin/bash
# Example: Collect 10 funny TikToks and create/upload a compilation

python -m src.url_collector.tiktok_scraper --count 10 --output tiktok_urls.txt --hashtag funny
python -m src.main --urls tiktok_urls.txt --title "Weekly Funny Compilation" --upload

Make it executable:

chmod +x tiktok_weekly.sh

Example Cron Job (macOS/Linux)

To run every Wednesday at 10:10 AM, add this to your crontab (crontab -e):

10 10 * * 3 /path/to/your/reelcomp/tiktok_weekly.sh >> /path/to/your/reelcomp/logs/cron.log 2>&1

Note:

• Do not include any real TikTok URLs or sensitive data in the repository.
• Users should create their own tiktok_urls.txt and customize the script for their needs.
• tiktok_urls.txt and tiktok_weekly.sh are already in .gitignore to prevent accidental commits of sensitive or user-specific data.

Configuration

Key Settings

# Basic Settings in .env file
APP_MAX_VIDEOS_PER_COMPILATION=15  # Maximum videos to include
APP_VIDEO_WIDTH=1080               # Output video width
APP_VIDEO_HEIGHT=1920              # Output video height
APP_TRANSITION_TYPE=random         # Transition between clips

# YouTube Settings
YOUTUBE_PRIVACY_STATUS=unlisted    # Video privacy (private, unlisted, public)

Using a Config File

Create a file (e.g., config.json):

{
  "app": {
    "max_videos_per_compilation": 10,
    "video_width": 1920,
    "video_height": 1080,
    "transition_type": "crossfade",
    "use_intro": true,
    "intro_path": "data/assets/my_intro.mp4"
  },
  "youtube": {
    "privacy_status": "unlisted"
  }
}

Then run:

python -m src.main --urls tiktok_urls.txt --config config.json

Troubleshooting

Common Issues

• Videos Not Downloading: Check network connection, TikTok might have updated site structure
• YouTube Upload Fails: Delete credentials/youtube_token.json and reauthenticate
• Poor Video Quality: Increase bitrate setting or resolution
• FFmpeg Not Found: Verify installation with ffmpeg -version and check PATH

Project Structure

reelcomp/
├── src/                       # Source code
│   ├── main.py                # Main entry point
│   ├── url_collector/         # Video URL collection
│   ├── video_collection/      # Video downloading
│   ├── video_processing/      # Compilation creation
│   ├── youtube_uploader/      # YouTube integration
│   ├── thumbnail_generator/   # Thumbnail creation
│   └── utils/                 # Utility functions
├── data/                      # Data storage (created at runtime)
└── credentials/               # API credentials (empty in repo)

Contributing

We welcome contributions! Here's how you can help:

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

Please follow these guidelines:

• Follow existing code style
• Add tests for new features
• Update documentation for significant changes
• Use descriptive commit messages

Changelog

v1.0.0

• Initial release
• TikTok video collection by hashtag
• Compilation creation with transitions
• Thumbnail generation
• YouTube Shorts creation
• YouTube upload functionality

License

This project is licensed under the MIT License.

Disclaimer

This tool is for educational purposes only. Always respect platform terms of service and copyright laws. Ensure you have permission to use and redistribute content.