🎬 VideoCut-CLI

VideoCut-CLI is an AI-powered command-line tool designed to help Content Creators automate their entire video workflow: from downloading and editing (trim, caption, watermark) to publishing on social media platforms.

---

🚀 Current Status (Phase 1: MVP)

• Smart Downloader:
  • High-quality video download (yt-dlp wrapper).
  • SABR 403 Bypass: Automatically uses Android player client.
  • Cookie Persistence: Saves and reuses cookies automatically.
  • Smart Naming: {Title}_{ID}_{Resolution}.mp4 format.
  • Smart Skip: Skips already downloaded files.
  • Modes: Support for --metadata-only and --extract-audio (MP3).
• System Health:
  • videocut doctor command to check FFmpeg and JS runtime status.
• Basic Editor:
  • Text and Image watermarking.
• AI Core (Planned): Auto-Crop (9:16), Highlights, Dubbing.

📁 Documentation Navigation

👨‍💻 User Documentation

Path: /docs

• Feature explanations and Quick start guide.

🤖 AI Agent Context

Path: /context

• System architecture, schemas, and roadmap.

---

🛠️ Quick Installation

Option 1: Homebrew (Recommended for macOS/Linux)

This will automatically install system dependencies like FFmpeg and Node.js.

brew tap pendig/tap
brew install videocut

Option 2: pipx (Python Standard)

Ideal if you already have FFmpeg installed.

pipx install videocut-cli

Option 3: Standard pip

pip install videocut-cli

After installation, run the health check:

videocut doctor

---

Created with ❤️ by Pena Digital