README.md

---
title: Pycaps
emoji: 🧠
colorFrom: pink
colorTo: red
sdk: docker
app_port: 8501
tags:
- streamlit
- subtitles
- video
- captions
- whisper
- css
pinned: true
short_description: Add CSS-styled subtitles to your videos
license: mit
---

# 🧠 Pycaps Demo: Add Smart, Styled Subtitles to Any Video

> 🎥 Add *TikTok-style* subtitles to your videos with CSS-like styling, animations, and AI transcription – all in Python!

This is a demo of [**pycaps**](https://github.com/francozanardi/pycaps), an open-source Python tool that lets you:

✅ Transcribe videos using **OpenAI Whisper**  
🎨 Style subtitles using **CSS**  
💥 Animate words, lines or segments dynamically  
🧪 Insert **emojis**, **effects**, and **tags** by context or regex  
📦 Render everything into a final styled video, automatically

---

### 🔍 What can you try here?

This online demo lets you:
- Upload a short video (less than 60s)
- Automatically transcribe its audio
- Preview how subtitles look using built-in styles
- Download the final video

> ⚠️ This runs on Hugging Face CPU infra, so it's ideal for short tests. For full GPU-powered rendering, check out the [Colab Notebook](https://colab.research.google.com/drive/117g6xujecjLyXHBwhwyzx0innCMLh_nj?usp=sharing).

---

### 👉 Try Full Examples

![demo-gif](https://github.com/user-attachments/assets/fd2d3325-c986-4b6a-81ba-09c428577e61)

🔗 [GitHub Repo](https://github.com/francozanardi/pycaps)  
📓 [Google Colab Notebook](https://colab.research.google.com/drive/117g6xujecjLyXHBwhwyzx0innCMLh_nj?usp=sharing)

---

### 💡 Want more?

Explore the full project at [github.com/francozanardi/pycaps](https://github.com/francozanardi/pycaps) or visit [pycaps.com](https://www.pycaps.com/).