analysis-video-gui

Desktop GUI for reviewing analysis-video output and tuning its scene-change detection. A hub plus several independent OS windows (no docking).

PyPI Python License: MIT

The CLI is the product; this is the verification tool. It exists to answer "did the detector pick the right frames, and is the dialogue aligned?" by eye. The two are separate packages with independent versions — fixing the GUI never forces a core re-release, and CLI-only users never download Qt. The core is pulled in automatically as a dependency.

Install

uvx analysis-video-gui@latest <video or .analysis path>   # run without installing
uv tool install analysis-video-gui                        # install as a global command

Keep the @latest: without it uvx reuses whatever version it resolved the first time, and you would keep running the old one after a release.

First run downloads about 111MB of Qt on top of the core's own download (108MB on macOS, 165MB on Linux — the core is a required dependency). Afterwards it starts from cache. The GUI does not pull the core's [stt] extra: it reads an analysis directory that already exists and never runs the pipeline itself.

Linux needs one system package — libportaudio2, for audio playback.

sudo apt install libportaudio2

sounddevice bundles PortAudio (the audio I/O C library) only in its macOS and Windows wheels; the Linux wheel is pure Python and relies on the system copy. Without it the install still succeeds and playback fails later, so install it up front.

Windows

Window Purpose
Hub Session root: UI language, analysis-unit picker, window toggles, layout save/restore, status
Player Video playback and scrubbing
Timeline Three detection signals with thresholds, colored by cause, mark navigation
Gallery Accepted and rejected frames at a glance
Compare Precision/recall report — your ground-truth flags vs the detector's picks, exportable as compare.json
Dialogue sync / Frame sync Review dialogue and frame alignment

Playback decodes with PyAV rather than QtMultimedia — Qt's bundled FFmpeg was shown by a spike to decode zero frames for AV1, so playback uses the same path as the analysis pipeline.

Supported environments

Python 3.11–3.14. Install resolution verified directly on each of these.

Platform Status
macOS (Apple Silicon · Intel) ✅
Linux x86_64 ✅ glibc 2.28+
Linux aarch64 ⚠️ glibc 2.31+ — below that no Qt wheel exists, install fails
Windows x64 ✅
Windows ARM64 ❌ same cause as the core (no opencv-python-headless wheel)

On older Linux, Qt silently resolves to an older release rather than failing — x86_64 with glibc 2.28 lands on PySide6 6.9.3, aarch64 with glibc 2.31 on 6.8.0.2. Current Qt (6.11) needs glibc 2.34 (x86_64) or 2.39 (aarch64). It is a quiet downgrade rather than an error, which makes it hard to diagnose later — hence this note. On macOS, current Qt requires macOS 13 or newer.

Links

License

MIT.

PySide6-Essentials is LGPL. Redistributing this GUI carries the corresponding notice obligations. Keeping the core CLI as a separate package is partly for this reason — the core ships without them.

Keywords: video analysis GUI · scene detection tuning · keyframe review · transcript alignment · lecture video inspector · PySide6 desktop app · Qt video player · analysis-video companion

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for UHD from gravatar.com UHD

Credits

Author: UHD

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

debugging-tool gui keyframe-extraction lecture pyside6 qt scene-detection screencast transcription video video-analysis

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

analysis_video_gui-0.1.0.tar.gz (90.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

analysis_video_gui-0.1.0-py3-none-any.whl (79.7 kB view details)

Uploaded Python 3

File details

Details for the file analysis_video_gui-0.1.0.tar.gz.

File metadata

  • Download URL: analysis_video_gui-0.1.0.tar.gz
  • Upload date:
  • Size: 90.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for analysis_video_gui-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e45866decbf08c4864dd6a06e7c843a9d2cf2a25940e7d84bf23a26d9a4285d6
MD5 9630abed0ec07e935ee01fc6087cfef1
BLAKE2b-256 9703d7a06aa0c086ff84add62bb8f2e0888cf64cf0dbcdda379a8097cd022415

See more details on using hashes here.

Provenance

The following attestation bundles were made for analysis_video_gui-0.1.0.tar.gz:

Publisher: release.yml on hwanyong/analysis-video

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file analysis_video_gui-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for analysis_video_gui-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f94f2e6ad2e55e8e0d3040b85275137976727c42015e721115faa309f40b4a16
MD5 ed4814a427071307818b260c94c8054c
BLAKE2b-256 cd0193353cb53f3e121940ef36cd513c8d583d4d83c244bc598ab590147d0ac7

See more details on using hashes here.

Provenance

The following attestation bundles were made for analysis_video_gui-0.1.0-py3-none-any.whl:

Publisher: release.yml on hwanyong/analysis-video

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page