# Video Analysis Quick Start Guide ## 5-Minute Setup ### 1. Upload a Video 🎬 **Steps:** 1. Go to **📹 Video Analysis** page 2. Select detection models: - ✅ Weapon (guns/knives) - ✅ Violence (fighting/aggression) - ✅ Anomaly (unusual behavior) - ✅ Pose (unsafe positions) 3. Click **Drag & drop** or **Click to select** video file 4. Choose your video (MP4, AVI, MOV, or MKV) 5. Click **🚀 Analyze Video** **Wait for:** - Upload progress (shows %) - Processing message - Results to load --- ### 2. View Processed Video ▶️ **What you'll see:** - Video with **colored bounding boxes** around detected objects - **Labels** showing what was detected - **Confidence percentages** for each detection - **Alert indicators** for dangerous items/behaviors **Controls:** - ⏯️ Play/Pause - 🔊 Volume - ⛶ Fullscreen - ↪️ Loop - 💾 Download processed video **Tip:** Processed video shows AI analysis in real-time! --- ### 3. Review Emergency Frames 🚨 Emergency frames are automatically captured when dangerous activity is detected. **How to find them:** 1. Scroll to **"🚨 Emergency Frames (Sensitive/High-Alert)"** section 2. See thumbnail gallery of critical frames 3. Click any thumbnail to see full-size image 4. Red "EMERGENCY" badge shows severity **Types captured:** - 🔫 Weapons detected - 👊 Violence detected - ❓ Anomalies detected - ⚠️ Critical alerts --- ### 4. Check Statistics 📊 **Summary cards show:** - 📊 **Total Frames** - How many frames in the video - ✓ **Analyzed Frames** - How many were actually processed - 🎯 **Detections** - Total objects/people/weapons found - 🚨 **Alerts** - Critical events detected - 🚨 **Emergency Frames** - High-alert frames captured --- ### 5. Re-Analyze with Different Models 🔄 Want to try different detection models on the same video? **Steps:** 1. Scroll to top of results section 2. Click **🔄 New Prediction** button 3. (Optional) Change model selection in Model Selection panel 4. System re-analyzes the same video 5. View new results with updated detections **Benefits:** - Test different combinations - Compare model accuracy - Build prediction history - NO re-uploading needed --- ### 6. View Previous Predictions 📜 See all analyses performed on this video. **To access:** 1. Scroll to bottom: **"📜 Previous Predictions"** section 2. Shows list of all previous analyses 3. Each shows: - Original filename - When analyzed - Detection count - Alert count - Emergency frames count 4. Click **View Details** to reload that analysis --- ## Common Workflows ### Workflow A: Quick Security Check ✓ ``` Upload → Analyze → Review Emergency Frames → Done Duration: 2-10 minutes depending on video length ``` ### Workflow B: Detailed Investigation 🔍 ``` Upload → Analyze → Check Emergency Frames → Review Frame-by-Frame Timeline → Read Alerts → Export Results → Done Duration: 10-30 minutes ``` ### Workflow C: Model Comparison 📊 ``` Upload → Analyze with Model Set A → Click "New Prediction" with Model Set B → Compare Results → Document Findings Duration: Depends on video length × 2 ``` --- ## What Gets Saved ### Processed Video 🎬 - Full video with detection overlays - Download and share as evidence - MP4 format - Same resolution as original ### Emergency Frames 🚨 - JPEG images of critical moments - Fully annotated with detections - Can download individually - Organized by timestamp ### Analysis Record 📋 - All detections logged - All alerts recorded - Frame-by-frame analysis - Complete audit trail --- ## Tips & Tricks ### 💡 Best Results 1. **Good quality video** - Higher resolution = better detection 2. **Good lighting** - Adequate light helps detection 3. **Clear angles** - Position camera to capture threats 4. **Multiple models** - Enable all relevant models for full coverage ### ⚡ Speed Up Analysis 1. Shorter videos process faster 2. Lower resolution = faster processing 3. Skip irrelevant models to reduce processing time 4. Use frame-skip setting if available ### 💾 Storage Tips 1. Download important emergency frames 2. Export processed videos for documentation 3. Archive old analyses to free up space 4. Back up critical analysis records ### 🔍 Detailed Review 1. Expand frame-wise timeline to see each frame's detections 2. Click alert details to understand what triggered it 3. View emergency frames for visual confirmation 4. Export analysis for reporting --- ## Keyboard Shortcuts | Action | Key | | ---------------- | -------- | | Play/Pause Video | Spacebar | | Fullscreen | F | | Download | Ctrl+S | | Refresh Results | Ctrl+R | --- ## File Size Guidelines | Video Length | Typical Size | Processing Time | | ------------ | ------------ | --------------- | | 1 minute | 10-50 MB | 30-60 sec | | 5 minutes | 50-250 MB | 2-3 min | | 10 minutes | 100-500 MB | 4-8 min | | 30 minutes | 300-1000 MB | 10-30 min | **Max upload: 500MB** --- ## Supported Formats ✅ **Recommended:** MP4 ✅ **Also supported:** AVI, MOV, MKV ❌ **Not supported:** FLV, WMV, M4V (use converter) --- ## Troubleshooting ### "File size exceeds limit" → Video is > 500MB. Compress or split video. ### "No detections found" → Try enabling more models or check if activity is present. ### "Processing taking too long" → Large videos take longer. Wait or try smaller clips. ### "Emergency frames not showing" → Verify actual detections occurred. Check model settings. ### "Can't download processed video" → Wait for processing to complete. Refresh page. --- ## Next Steps 1. ✅ Upload your first video 2. ✅ Review processed output 3. ✅ Check emergency frames 4. ✅ Try re-analyzing with different models 5. ✅ Export results for sharing/documentation 6. ✅ Integrate into security workflow --- ## Quick Reference | Item | What It Does | | ----------------------- | --------------------------------------- | | 🎬 Processed Video | Video with AI detection overlays | | 🚨 Emergency Frames | Auto-captured frames of critical events | | 📊 Statistics | Summary of findings | | 📜 Frame Timeline | Detailed breakdown by frame | | 🚨 Critical Alerts | High-priority events flagged | | 📜 Previous Predictions | History of all analyses | | 🔄 New Prediction | Re-analyze with different models | --- ## Example Results ``` 📊 Analysis Summary ├── 📹 Video: security_footage.mp4 (2:45 long) ├── 📊 Total Frames: 4950 frames ├── ✓ Analyzed: 825 frames ├── 🎯 Detections Found: 243 │ ├── Person: 127 │ ├── Car: 56 │ ├── Weapon: 12 ⚠️ │ └── Other: 48 ├── 🚨 Alerts: 8 │ ├── Weapon Detection: 4 │ ├── Violence: 2 │ └── Anomaly: 2 └── 🚨 Emergency Frames Captured: 8 ├── Frame 145 - Weapon Detected ├── Frame 289 - Violence Detected ├── Frame 412 - Anomaly Detected └── ... (5 more) ``` --- **Ready to analyze?** Upload your video and discover what AI detection reveals! 🎥 For detailed technical information, see: [VIDEO_ANALYSIS_ENHANCEMENTS.md](VIDEO_ANALYSIS_ENHANCEMENTS.md)