// faq
常见问题
我的视频会被上传吗?
不会。所有解析、解码与分析都在你的浏览器内完成,站点没有任何文件上传接口。 你可以断开网络后再打开文件,功能完全不受影响——这也是判断它是否真的本地处理最直接的办法。
需要注册或付费吗?
不需要注册,目前全部功能免费开放。
支持哪些格式和编码?
容器支持 MP4 / MOV / M4V / 3GP / MKV;视频编码支持 H.264 (AVC) 与 H.265 (HEVC)。 音频轨道可以解析容器结构与采样表,但不做码流级分析。
支持 H.265 / HEVC 吗?
支持,且包含块级分析(CU 划分、QP、运动矢量)。HEVC 由于采用 CTU 四叉树划分, 同一帧内的块尺寸差异比 H.264 大得多,分析视图里能直观看到这一点。
支持 AV1 或 VP9 吗?
暂不支持。当前块级分析仅覆盖 H.264 与 H.265。
为什么有些帧没有 QP 或 MV 显示?
分几种情况,都不是异常:
- I 帧没有运动矢量。I 帧是帧内编码,不参考任何其他帧,因此没有 MV;QP 依然会有;
- 块尺寸太小看不到箭头。只有当块在屏幕上足够大时才会绘制箭头(放大视图即可显示);
- 音频或其他轨道。音频帧、元数据轨道没有量化参数和运动矢量的概念。
为什么运动矢量的箭头指向和画面运动方向相反?
因为箭头表示的是「这块内容是从参考帧的哪个位置搬过来的」,所以它指向的是内容的来源, 而不是内容的去向。画面向右移动时,箭头会指向左。
可以批量分析吗?有 API 吗?
目前是单文件交互式分析,没有批量任务和公开 API。如果你有批量质检、 自动化测试或接入自有系统的需求,欢迎邮件说明场景,这类需求会优先考虑。
可以把分析结果导出吗?
暂时不支持导出文件。需要导出 QP / MV 数据用于二次分析的场景,可以直接邮件提出。
对浏览器有要求吗?
推荐使用较新版本的 Chrome 或 Edge:帧预览依赖浏览器内置的硬件解码器。 在其他浏览器上,码流分析与块级信息依然可用,只是没有画面预览。
文件大小有限制吗?
没有硬性限制,但分析在浏览器内存中进行:文件越大、分辨率越高,首次解析耗时越长、内存占用越高。 分析长视频时建议先定位到关键帧再看细节。
为什么比桌面工具慢?
桌面工具使用原生代码与平台的硬件加速,浏览器里的实现拿不到完全相同的加速手段。 代价是速度,换来的是零安装、跨平台、以及文件不出本机。
可以商用或集成到我自己的系统里吗?
分析能力基于 FFmpeg(LGPLv3)构建,依许可要求,本项目使用的 FFmpeg 相关源码与许可证全文已公开。 关于企业集成、私有化部署或定制需求,欢迎邮件沟通。
它和 Elecard StreamEye、CodecVisa、mp4info 这些工具比怎么样?
它们解决的问题不完全一样。Elecard StreamEye Studio 与 CodecVisa 覆盖更多编码格式(AV1 / VP9 / VVC),并且能做缓冲区(HRD / DPB)分析、标准符合性校验,以及与参考 YUV 对比的 PSNR / SSIM / VMAF —— 这些在浏览器里做不到,本工具也不做。 mp4info 是命令行工具,擅长脚本化与批处理,但需要先安装。 本工具的定位是零安装 + 块级可视化(QP 热力图与运动矢量),适合快速定位问题、评审与教学。 想看清各自的边界,见 同类工具对比。
遇到问题怎么反馈?
直接发邮件到 liuhang887654@gmail.com,附上浏览器版本、 文件的关键参数(容器 / 编码 / 分辨率)以及问题现象,会更容易定位。
// faq
Frequently asked questions
Is my video uploaded anywhere?
No. Parsing, decoding and analysis all happen in your browser. There is no upload endpoint. Unplug your network and open a file — it still works, which is the most direct way to verify that processing is truly local.
Do I need an account? Is it paid?
No account required, and all features are currently free.
Which formats and codecs are supported?
Containers: MP4 / MOV / M4V / 3GP / MKV. Video codecs: H.264 (AVC) and H.265 (HEVC). Audio tracks can be inspected at the container and sample-table level, but not at the bitstream level.
Is H.265 / HEVC supported?
Yes, including block-level analysis (CU partitioning, QP, motion vectors). Because HEVC uses quadtree CTU partitioning, block sizes vary far more within a frame than in H.264 — you can see that directly in the view.
What about AV1 or VP9?
Not supported yet. Block-level analysis currently covers H.264 and H.265 only.
Why do some frames show no QP or MV?
A few different reasons, none of them a bug:
- I frames have no motion vectors. They are intra-coded and reference nothing, so there is no MV — QP is still present;
- Blocks are too small to draw arrows. Arrows appear only once a block is large enough on screen at the current zoom — zoom in to see them;
- Audio or other tracks. Audio frames and metadata have no notion of QP or MV.
Why do motion vectors point opposite to the apparent motion?
An arrow shows where this block's content came from in the reference frame, not where it goes. If the picture moves right, the arrows point left.
Is there batch analysis or an API?
Currently it is single-file, interactive analysis — no batch jobs and no public API. If you need batch QC, automated testing or integration with your own system, email us with the use case; that kind of request gets prioritized.
Can I export the results?
Not yet. If you need QP / MV data exported for downstream analysis, let us know by email.
Which browsers are required?
A recent Chrome or Edge is recommended: frame preview uses the browser's built-in hardware decoder. On other browsers, bitstream analysis and block data still work — just without the picture preview.
Is there a file size limit?
No hard limit, but analysis runs in browser memory: larger files and higher resolutions take longer to parse on first load and use more memory.
Why is it slower than desktop tools?
Desktop tools run native code with platform hardware acceleration; the browser version cannot use quite the same shortcuts. You trade some speed for zero install, cross-platform reach, and files that never leave your machine.
Can I use it commercially or embed it in my own system?
Analysis is built on FFmpeg (LGPLv3); as the license requires, the FFmpeg sources used by this project and the full license are published. For enterprise integration, private deployment or custom work, get in touch by email.
How does it compare to Elecard StreamEye, CodecVisa or mp4info?
They do not solve exactly the same problem. Elecard StreamEye Studio and CodecVisa cover more codecs (AV1 / VP9 / VVC) and add buffer (HRD / DPB) analysis, standard compliance verification, and PSNR / SSIM / VMAF against a reference YUV — none of which is possible in a browser, and this tool does not attempt any of it. mp4info is a command-line tool built for scripting and batch work, but it has to be installed first. This tool's niche is block-level visualization (QP heatmap and motion vectors) at zero install cost, which suits quick localization, reviews and teaching. The full comparison is here.
How do I report a problem?
Email liuhang887654@gmail.com with your browser version, the file's key parameters (container / codec / resolution) and what you observed.