# 🎬 Clippa or clipzy– YouTube Video Clipper SaaS

**Clippa** (or Clipzy) is a lightweight SaaS tool that allows users to clip and download specific segments of any YouTube video by simply providing the URL and desired timestamps. It trims the video on the backend using `yt-dlp` and `ffmpeg`, and instantly delivers downloadable clips — no cloud storage required.

---

## ✨ Features

- ⏱️ Precise timestamp-based clipping  
- 🎥 Supports most YouTube formats via `yt-dlp`  
- ⚡ Fast, on-demand backend trimming using `ffmpeg`  
- 🧾 Subtitles and format selection support (optional)  
- 🧼 Clean UI built with `shadcn/ui` and TailwindCSS  
- 🔐 No login, no storage — just paste and clip

---

## 🧱 Tech Stack

**Frontend**
- React + TypeScript  
- TailwindCSS + shadcn/ui

**Backend**
- Express (running on Bun)  
- `yt-dlp` for video fetching  
- `ffmpeg` for cutting and encoding  
- Supabase for optional logging/analytics  
- Hosted on Render

---

## 🚀 Getting Started

### 1. Clone the repo

```bash
git clone https://github.com/Shreyas2004wagh/clipzy.git
cd clippa

2. Install dependencies

Backend (Bun + Express):

cd backend
bun install

Frontend (React + TypeScript):

cd frontend
npm install

3. Environment Variables

Create a .env file inside the backend/ directory:

SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

Optional: Add any keys required by your analytics or logging tools.

4. Run the app

Backend:

bun run src/index.ts or bun --watch src/index.ts

Frontend:

cd frontend
npm run dev

---

🛠 Future Plans

• 🗂️ Save clip history (with optional login)
• 🧠 AI-powered timestamp suggestions
• 🐳 Docker support
• 📜 OpenAPI docs

---

🤝 Contributing

PRs are welcome! Feel free to fork the repo and submit improvements or bug fixes.

---

📄 License

MIT © 2025 Shreyas Wagh

---