aivid

AI video toolkit - detect, analyze, and work with AI-generated videos

Features

• AI Detection: Detect AI-generated videos through C2PA metadata and heuristic analysis
• C2PA Signing: Add C2PA manifests to media files (requires c2patool)
• Metadata Extraction: Extract comprehensive metadata from video files
• Multi-tool Support: Leverages ffprobe, mediainfo, exiftool, and c2patool for thorough analysis
• MP4 Box Analysis: Binary parsing of MP4/MOV container structure
• Software Detection: Identify editing software (FFmpeg, Adobe, DaVinci, OBS, etc.)
• Multiple Output Modes: Default summary, full details, C2PA focus, or quiet mode
• JSON Export: Export reports for automation and integration
• Batch Processing: Analyze multiple files with single command

Supported AI Generators

Requirements

System Dependencies

aivid requires these command-line tools to be installed:

• ffprobe (required) - Part of FFmpeg
• mediainfo (optional, recommended)
• exiftool (optional, recommended)
• c2patool (optional) - For accurate C2PA manifest parsing and signing

macOS

brew install ffmpeg mediainfo exiftool

Ubuntu/Debian

sudo apt-get install ffmpeg mediainfo exiftool

Windows

# Using Chocolatey
choco install ffmpeg mediainfo exiftool

# Or using Scoop
scoop install ffmpeg mediainfo exiftool

Install c2patool (optional)

c2patool provides more accurate C2PA manifest parsing and signing capabilities.

# Using Cargo (Rust package manager)
cargo install c2patool

# Or download prebuilt binaries from:
# https://github.com/contentauth/c2pa-rs/releases

Python Installation

pip install aivid

Or with uv:

uv pip install aivid

Quick Start

Command Line

# Basic analysis
aivid video.mp4

# AI detection focus (C2PA mode)
aivid --c2pa video.mp4

# Full metadata details
aivid --full video.mp4

# Quick summary for multiple files
aivid -q *.mp4

# Export to JSON
aivid -o report.json video.mp4

# Sign a file with C2PA manifest (requires c2patool)
aivid --sign manifest.json -o signed_video.mp4 video.mp4

Python API

from aivid import analyze_file, check_c2patool_available, sign_with_c2pa, VideoMetadata

# Analyze a video file
metadata = analyze_file("video.mp4")

# Check if AI-generated
if metadata.is_ai_generated:
    print(f"AI Generator: {metadata.ai_generator}")

# Access metadata (pydantic models)
print(f"Duration: {metadata.duration}s")
print(f"Resolution: {metadata.resolution}")
print(f"Video codec: {metadata.technical.video.codec}")
print(f"Audio sample rate: {metadata.technical.audio.sample_rate}")

# C2PA information
if metadata.has_c2pa:
    print(f"C2PA Issuer: {metadata.provenance.c2pa.issuer}")
    print(f"C2PA Generator: {metadata.provenance.c2pa.generator}")

# Export as JSON
print(metadata.model_dump_json(indent=2))

# Sign a file with C2PA manifest (requires c2patool)
if check_c2patool_available():
    sign_with_c2pa(
        input_path="video.mp4",
        manifest_path="manifest.json",
        output_path="signed_video.mp4",
    )

Output Modes

Default Mode

Basic metadata with file info, container details, encoding info, and C2PA summary.

aivid video.mp4

C2PA Mode (--c2pa)

Focused on AI content detection with indicators and confidence levels.

aivid --c2pa video.mp4

Output includes:

• C2PA manifest detection
• AI generation indicators (audio sample rate, encoder tags, etc.)
• Detection summary with confidence levels

Note: When c2patool is installed, aivid uses it for more accurate C2PA parsing.

Full Mode (--full)

Complete metadata dump including mediainfo, exiftool, all streams, and raw data.

aivid --full video.mp4

Quiet Mode (-q)

One-line summary per file, ideal for batch processing.

aivid -q *.mp4

Sign Mode (--sign)

Add a C2PA manifest to a media file (requires c2patool).

# Create a manifest file
cat > manifest.json << 'EOF'
{
  "claim_generator": "aivid",
  "title": "My Video",
  "assertions": [
    {
      "label": "c2pa.actions",
      "data": {
        "actions": [{"action": "c2pa.edited"}]
      }
    }
  ]
}
EOF

# Sign the video
aivid --sign manifest.json -o signed_video.mp4 video.mp4

# Verify the signature
aivid --c2pa signed_video.mp4

Development

Setup

# Clone the repository
git clone https://github.com/SocialNetwork0/aivid.git
cd aivid

# Create virtual environment and install dependencies
uv venv
uv pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

Local CLI Testing

# Activate virtual environment
source .venv/bin/activate  # macOS / Linux

# Install in editable mode (code changes reflect immediately)
uv pip install -e ".[dev]"

# Test CLI
aivid --help
aivid video.mp4

Running Tests

uv run pytest

Code Quality

# Linting
uv run ruff check .

# Formatting
uv run ruff format .

# Type checking
uv run mypy src

Supported File Formats

Native MP4/MOV parsing: .mp4, .m4v, .m4a, .mov, .3gp, .3g2

Other formats: Any format supported by ffprobe

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Acknowledgments

• C2PA - Coalition for Content Provenance and Authenticity
• c2patool - C2PA command line tool
• FFmpeg - Multimedia framework
• MediaInfo - Media file analysis
• ExifTool - Metadata extraction