When working with video compression, most tools show you the decoded picture. That’s useful, but it only tells half the story. What often matters more—especially in broadcast and live environments—is how the encoder interprets motion.
That was the motivation behind VMA Motion Analyser.
This tool was built to visualise real codec motion vectors in real time, exactly as generated by the encoder and used for motion compensation. There is no optical flow, no AI inference, and no post-analysis guesswork. What you see on screen is the encoder’s own motion model, macroblock by macroblock.
What the tool does
VMA Motion Analyser decodes live streams or video files using FFmpeg and overlays motion vectors directly on the video image. The vectors are aligned to the macroblock grid, making it easy to understand how motion is distributed spatially and how the encoder reacts to different types of content.
The analyser supports:
- Live streams (UDP, RTP, RTSP, HTTP)
- Local file playback
- Macroblock grid visualisation
- Motion vectors with direction-based colouring
- Optional motion heatmap showing motion energy
- Two vector display modes:
- Enhanced mode, where vectors are scaled for readability
- True-vector mode, where vector length matches the real motion magnitude
In addition to the visual overlay, the tool continuously computes statistics such as vector count, static vs moving blocks, average and RMS motion magnitude, and motion coherence (directional consistency).
Why this matters
Motion vectors are at the heart of modern video compression. They determine bitrate efficiency, visual quality, and encoder stability. Yet they are rarely visible in real time, especially on live services.
With this analyser, it becomes much easier to:
- Compare encoder behaviour across profiles or implementations
- Identify excessive noise or unstable motion estimation
- Analyse motion complexity in live broadcasts
- Spot issues caused by lighting, grain, fast motion, or scene cuts
- Understand why certain scenes compress poorly
In short, it helps answer the question: “What is the encoder struggling with right now?”
Design philosophy
The goal was not to create a general-purpose video player, but a diagnostic instrument. Performance, determinism, and clarity were prioritised over visual polish. The tool is designed to stay responsive during HD live analysis and to behave predictably over long runs.
Closing thoughts
This tool fits naturally into the broader VMA Video Analyser Package ecosystem, alongside transport stream analysis, signal monitoring and video analysis.
If you work with compressed video and care about what happens before the pixels hit the screen, motion vectors are worth looking at—and this tool makes that possible in real time.