🎬 SmartVideo — FastAPI + Streamlit Video Toolkit

SmartVideo — A modern, cross-platform video player and clip extractor built with FastAPI, Streamlit, and FFmpeg.
Upload, preview, trim, and stream videos — locally or via REST API.

🚀 Features

• ⚙️ Auto FFmpeg/FFprobe detection & download (Windows, macOS, Linux)
• 🌐 FastAPI backend with REST endpoints:
  • /upload — upload and probe duration
  • /extract — extract a clip (start + duration)
  • /outputs/{file} — serve generated clips
• 🖥️ Streamlit UI:
  • Drag-and-drop upload
  • HTML5 video preview player
  • Clip extraction via form controls
• 💡 CLI tools:
  • svapi → run backend server (FastAPI)
  • svui → run Streamlit UI
• 🔁 Cross-platform binaries — automatically downloaded if missing
• 🧱 Modular architecture (sv/core, sv/ui, sv/api)
• 🧪 Ready-to-use GitHub Actions for CI/CD and PyPI publishing

🧩 Project Structure

smartvideo/
├── src/smartvideo/
│   ├── sv/
│   │   ├── api.py         # FastAPI backend
│   │   ├── cli.py         # CLI launchers
│   │   └── core/
│   │       ├── config.py  # Data paths
│   │       └── services/process.py  # FFmpeg logic
│   └── ui/
│       ├── app.py         # Streamlit frontend
│       └── components/html5_player.py
├── data/uploads/          # Uploaded videos
├── data/outputs/          # Generated clips
├── tools/                 # Dev tools & publishing scripts
├── tests/                 # Basic tests
├── pyproject.toml         # Build metadata
├── CHANGELOG.md
└── LICENSE

⚡ Quick Start

1️⃣ Install

pip install smartvideo

Or for local development:

uv pip install -e .[dev]

2️⃣ Run the API (FastAPI)

svapi --port 8000

Then open http://127.0.0.1:8000/docs

3️⃣ Run the UI (Streamlit)

svui --port 8501

Then open http://localhost:8501

You can adjust upload size:

svui --max-upload-mb 4096

🔧 FFmpeg Setup

SmartVideo automatically downloads FFmpeg if missing.
But you can install it manually:

🪟 Windows

winget install Gyan.FFmpeg
# or
choco install ffmpeg

🍎 macOS

brew install ffmpeg

🐧 Linux

sudo apt install -y ffmpeg

Verify:

ffmpeg -version
ffprobe -version

🧠 API Endpoints

🧪 Development

git clone https://github.com/TamerOnLine/smartvideo
cd smartvideo
uv sync --extra dev
uv run svapi
uv run svui

Run tests:

uv run pytest

🧰 GitHub Workflows

🗓️ Changelog

See CHANGELOG.md for release history.
Example from v0.1.6:

• Added automatic FFmpeg download for Linux & macOS
• Unified resolver and improved permission handling
• Improved logging and cleanup routines

📜 License

Licensed under the MIT License © 2025 TamerOnLine

🌟 Roadmap

• 🧠 AI-powered video summarization & speech-to-text
• 🎞️ Automatic scene detection & keyframe extraction
• ☁️ Remote storage + REST streaming integration
• 🧩 Web dashboard for managing clips and metadata