# Video Join Motion Inspector Local source edition 1.0.0. Measure direction changes across selected video joins. Download motion measurements and see the three source frames around every edit. ## Run locally Extract the complete ZIP. Use Python 3.12 from a terminal in the extracted directory. Create a virtual environment and activate it, then run: python -m pip install -r requirements.txt Install FFmpeg with ffmpeg and ffprobe on PATH before processing video. python run.py example.json results Use a new output folder for each run. Start with example.json and replace its synthetic values with your own data. Preserve field names, types and units. Files and reports are processed on your computer. ## Inputs Upload videoBase64 for an MP4 up to 3 MiB, H.264 or MPEG-4, up to 640×360 and 3–120 frames. Supply 1–12 distinct zero-based joinFrames. The first allowed index is 2. Frame indices use decoded display order before rotation metadata is applied. ## Results JOINS.csv compares motion on the transition into each selected frame with the preceding transition. Speeds are pixels per frame after resizing to 160×90. Direction cosine ranges from −1 to +1 and is blank when too little motion is measurable. FRAMES.png shows each join in time order. Review these diagnostics alongside the clip. The results folder includes summary.json and the output files produced by this input. The sample produces: JOINS.csv, FRAMES.png. ## Español · Inspector de movimiento en cortes de vídeo Mide los cambios de dirección en cada corte indicado y muestra los fotogramas contiguos. Extrae el ZIP completo y abre una terminal en esa carpeta con Python 3.12. Crea y activa un entorno virtual e instala las dependencias con el comando anterior. Instala FFmpeg y deja ffmpeg y ffprobe disponibles en PATH. Ejecuta: python run.py example.json resultados Copia example.json para preparar tus datos. Conserva los nombres y tipos de los campos, usa una carpeta de salida nueva y consulta summary.json junto con los archivos generados. La descripción detallada de los campos está en inglés. The included LICENSE covers use and modification for your own personal and commercial projects. This edition includes its source and can run locally after setup.