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:
Latest release

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.1.tar.gz (90.4 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.1-py3-none-any.whl (80.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: analysis_video_gui-0.1.1.tar.gz
  • Upload date:
  • Size: 90.4 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.1.tar.gz
Algorithm Hash digest
SHA256 12edf4f7d8f792ce396bc6bf0e18f59c7ec2b4f0efc7a47c4f663df10a5842ea
MD5 6de193e3a435dae6a8b5aabf89fd315e
BLAKE2b-256 1d171217a514cc51d3bd5220dd12b2c9581ad9ebb109ee6249da6124186f7da6

See more details on using hashes here.

Provenance

The following attestation bundles were made for analysis_video_gui-0.1.1.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.1-py3-none-any.whl.

File metadata

File hashes

Hashes for analysis_video_gui-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1e451e979a2d53790c637cf822eaec8d237f440c003b9493731f9999e2630b91
MD5 184b54147e39a47082344700ceb425fb
BLAKE2b-256 2ae62eae935be4a1265b9a7d153f0378d7cd008f5b689904328442c767bffcc7

See more details on using hashes here.

Provenance

The following attestation bundles were made for analysis_video_gui-0.1.1-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