README

---

tikYou is a fully automated pipeline that downloads videos from TikTok and posts them to YouTube. It uses Playwright to control a headless Chrome browser, handling the end-to-end workflow of scraping, processing, and publishing content — with zero manual intervention.

⚡ One command. Every video. Every day.

---

🚀 Features

• Automated TikTok Scraping — Fetches videos from TikTok based on configurable criteria
• Zero-Click YouTube Publishing — Automatically uploads processed videos to YouTube
• Headless Browser Automation — Powered by Playwright with full Chrome control
• Configurable Pipeline — JSON-driven configuration for videos, schedules, and metadata
• Session Persistence — Maintains browser sessions to avoid re-authentication
• Robust Error Handling — Automatic retries and detailed logging

---

📦 Installation

Prerequisites

• Node.js ≥ 18.0.0
• Google Chrome
• Git

Clone & Setup

# Clone the repository
git clone git@github.com:legen07/tikYou.git
cd tikYou

# Install dependencies
npm install

# Install Playwright browsers
npx playwright install chromium

---

🛠️ Usage

Development

# Start Chrome with remote debugging
npm run dev

# Run the automation
npm start

Configuration

Edit videos.json to manage your video queue:

{
  "videos": [
    {
      "id": "video_id",
      "url": "https://www.tiktok.com/@user/video/id",
      "status": "pending"
    }
  ]
}

Available Scripts

Script	Description
npm start	Run the main automation pipeline
npm run dev	Launch Chrome with remote debugging enabled
npm test	Run test suite

---

📁 Project Structure

tikYou/
├── index.js              # Main entry point & orchestration logic
├── tiktok.js             # TikTok scraping & downloading module
├── youtube.js            # YouTube upload & publishing module
├── smartAutomation.js    # Intelligent scheduling & automation engine
├── organicTyper.js       # Organic content typing simulation
├── package.json          # Project configuration & dependencies
├── videos.json           # Video queue configuration
├── posted.json           # Published video log
├── .gitignore            # Git ignore rules
├── LICENSE               # MIT License
├── README.md             # This file
├── CONTRIBUTING.md       # Contribution guidelines
├── CODE_OF_CONDUCT.md    # Community guidelines
└── test/                 # Test suite

---

🤝 Contributing

Contributions are what make the open source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

See the Contributing Guide for details on how to get started.

---

📄 License

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

---

🙏 Acknowledgments

• Playwright — Browser automation framework
• Node.js — JavaScript runtime
• Google Chrome — Browser engine

---

Built with ❤️ by Joe Legen