Play MISB video. See telemetry on the map. Work in QGIS.

User guide · Architecture · Docs site · Contributing · Discussions · Issues

QGIS FMV brings Full Motion Video into your GIS workspace: synchronized map layers (platform, footprint, sensor cone, trajectory), MISB/KLV metadata, drawing tools on video, mosaics, streams, and DJI → STANAG 4609 multiplexing.

Telemetry is handled by pymisb on PyPI. The plugin focuses on QGIS integration, playback, and geospatial visualization.

flowchart LR
  subgraph inputs [Inputs]
    V[Video file or stream]
    T[DJI telemetry]
  end
  subgraph pymisb [pymisb]
    M[mux / demux / KLV]
  end
  subgraph plugin [QGIS FMV]
    VM[Video Manager]
    P[Player + map]
    M3[Mini map · HUD]
  end
  V --> M
  T --> M
  M --> VM
  V --> VM
  VM --> P
  P --> M3

Plugins → Manage and Install Plugins → search QGIS FMV → Install Plugin

Download from GitHub Releases → Plugins → Install from ZIP

Developers — install_dev.sh symlinks the plugin and installs runtime deps into QGIS bundled Python:

./install_dev.sh          # macOS
# install_dev.bat         # Windows
# bash scripts/install_plugin_requirements.sh   # deps only

Runtime packages are defined in code/requirements.txt (not a local python_deps/ folder).

End users: first run can offer guided setup via FMV Settings → Install dependencies.

1. Open QGIS → click FMV on the toolbar.
2. File → Open Video File (or drag & drop onto the manager).
3. Wait until status is Ready (telemetry index on long files).
4. Double-click the row → player opens; map layers follow the video.

No MISB metadata? → File → Create MISB File (multiplexer). Details in USAGE.md.

Download sample MISB test videos from Google Drive to try the plugin.

25+ real-time filters in the player Filters menu, plus a dedicated AI Detection submenu for FMV/UAV imagery.

Open Filters → AI Detection in the player:

Configure models in FMV Settings → AI Detection:

• One-click Download VisDrone aerial model (YOLOv8n → ONNX, stored in ~/.qgis-fmv-models/)
• Profile aerial (FMV/UAV) vs coco (ground-level) vs custom class IDs
• Confidence, NMS, per-filter ONNX overrides

Advanced tuning in code/settings.ini → [FILTERS] (aerial profile, multiscale, NMS, tracking, overlay thresholds). See USAGE.md.

All filters use OpenCV when available; pure-numpy fallbacks when OpenCV is blocked (e.g. macOS Team ID).

All documentation lives in this repository as Markdown files (no separate docs site):

git clone https://github.com/All4Gis/QGISFMV.git && cd QGISFMV

pip install -r requirements-dev.txt
python3 build.py          # UI + resources + i18n (outside QGIS)

./install_dev.sh          # macOS — symlink + deps → ~/.qgis-fmv-packages
# install_dev.bat         # Windows
./debug_qgis.sh           # launch QGIS with QGISFMV_DEBUG=1 → Attach in Cursor

Release ZIP: python3 deploy/plugin_zip.py

QGISFMV/
├── code/                   # Plugin source (symlinked as QGISFMV)
│   ├── QgsFmv.py           # Plugin entry
│   ├── manager/            # Playlist, multiplexer, streams
│   ├── player/
│   │   ├── QgsFmvPlayer.py
│   │   ├── dialogs/        # Metadata, settings, military symbols
│   │   ├── overlays/       # HUD, mini map, sensor cone, distance rings
│   │   ├── drawing/        # On-video draw toolbar
│   │   └── features/       # Mosaic, timeline, alerts, snapshots
│   ├── video/              # Playback, filters, DNN (see subfolders)
│   │   ├── playback/       # QgsVideo widget, surface, state
│   │   ├── filters/        # VideoFilters, detection, worker
│   │   └── dnn/            # ONNX / VisDrone setup
│   ├── utils/
│   │   ├── settings/       # settings.ini + QgsFmvSettings
│   │   ├── layers/         # Map layers, styles, KML/GPX export
│   │   ├── media/          # Multimedia, ffmpeg, KLV, streams
│   │   ├── core/           # QgsFmvUtils (georef runtime)
│   │   ├── ui/             # Resources, QgsUtils, plots
│   │   ├── logging/        # stdlib logging (`utils/logging/__init__.py`)
│   │   ├── install/        # Dependency installer
│   │   └── vision/         # Object tracking
│   ├── geo/                # Geodesy helpers
│   ├── about/              # About dialog
│   ├── ui/                 # Qt Designer sources
│   ├── images/             # Icons, platform SVGs, military symbols
│   ├── i18n/               # Translations
│   └── requirements.txt    # Runtime Python deps (pymisb, OpenCV, matplotlib)
├── scripts/
│   └── install_plugin_requirements.sh
├── assets/                 # Doc screenshots
├── build.py                # Compile .ui / .qrc / .ts
└── deploy/                 # Plugin ZIP builder

• MISB ST 0601 — UAS Datalink Local Set
• MISB ST 0102 — Security Metadata
• STANAG 4609 — Motion Imagery

Use the plugin at no cost under GPL-3.0. Ask in Discussions or report bugs in Issues.

Individual donations help sustain development.

GPL v3 — LICENSE

Francisco Raga · All4Gis · [email protected]