Video Analysis Quick Start Guide
5-Minute Setup
1. Upload a Video 🎬
Steps:
- Go to 📹 Video Analysis page
- Select detection models:
- ✅ Weapon (guns/knives)
- ✅ Violence (fighting/aggression)
- ✅ Anomaly (unusual behavior)
- ✅ Pose (unsafe positions)
- Click Drag & drop or Click to select video file
- Choose your video (MP4, AVI, MOV, or MKV)
- 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:
- Scroll to "🚨 Emergency Frames (Sensitive/High-Alert)" section
- See thumbnail gallery of critical frames
- Click any thumbnail to see full-size image
- 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:
- Scroll to top of results section
- Click 🔄 New Prediction button
- (Optional) Change model selection in Model Selection panel
- System re-analyzes the same video
- 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:
- Scroll to bottom: "📜 Previous Predictions" section
- Shows list of all previous analyses
- Each shows:
- Original filename
- When analyzed
- Detection count
- Alert count
- Emergency frames count
- 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
- Good quality video - Higher resolution = better detection
- Good lighting - Adequate light helps detection
- Clear angles - Position camera to capture threats
- Multiple models - Enable all relevant models for full coverage
⚡ Speed Up Analysis
- Shorter videos process faster
- Lower resolution = faster processing
- Skip irrelevant models to reduce processing time
- Use frame-skip setting if available
💾 Storage Tips
- Download important emergency frames
- Export processed videos for documentation
- Archive old analyses to free up space
- Back up critical analysis records
🔍 Detailed Review
- Expand frame-wise timeline to see each frame's detections
- Click alert details to understand what triggered it
- View emergency frames for visual confirmation
- 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
- ✅ Upload your first video
- ✅ Review processed output
- ✅ Check emergency frames
- ✅ Try re-analyzing with different models
- ✅ Export results for sharing/documentation
- ✅ 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