metadata

title: Camera Movement Detector
emoji: 📷
colorFrom: red
colorTo: pink
sdk: streamlit
sdk_version: 1.25.0
app_file: app.py
pinned: false

📷 Camera Movement Detector

This project was developed as part of the ATP Core Talent AI Coder Challenge 2025.
It is a Streamlit-based web application that analyzes uploaded videos and detects significant camera movements such as panning, tilting, or shaking.
It does not focus on object motion — instead, it detects changes in the global scene indicating that the camera itself moved.

📷 Screenshot

🚀 Live App

🔗 Click here to try the app online
(Replace this with your Streamlit or Hugging Face link after deployment)

🎯 Features

📼 Upload a video (MP4, AVI, MOV)
🎞️ Extracts and analyzes frames
🎯 Detects significant camera movement (not object motion)
💡 Clean, modern UI with ATP branding

🧠 Approach

Frame Extraction: Extracts all frames from the video using OpenCV.
Feature Detection & Matching: ORB feature detector is used to compare consecutive frames.
Homography Transformation: Calculates transformation matrix to estimate global scene shift.
Movement Decision: If the transformation deviates above a threshold, it is classified as camera movement.
Bonus Logic: Tries to filter out object motion by comparing matched keypoints and transformation consistency.

🛠️ Tech Stack

Python 3.13
OpenCV
Streamlit (for UI)
Datasets from Hugging Face (for CameraBench demo data)
NumPy for numerical processing

📦 Installation

To run locally:

git clone https://github.com/yourusername/camera-detector.git
cd camera-detector
pip install -r requirements.txt
streamlit run app.py

📁 File Structure

camera-detector/
├── app.py                 # Streamlit web UI
├── movement_detector.py   # Core detection logic
├── requirements.txt       # Dependencies
├── README.md              # This file

📸 Example Output

Input: Sample video with camera shake

Output:


📌 Detected camera movement at frame indices: [6, 7, 8, 10, 15, 22, 23, 24]

💬 Acknowledgements

Hugging Face CameraBench Dataset
ATP Core Talent Team for organizing the challenge

🧑‍💻 Developed by

Saadet Elizaveta Babal
Candidate – ATP Core Talent AI Coder Challenge 2025