Second-Party Plugins¶

Second-party plugins are officially maintained but distributed as separate packages to keep the core installation lightweight.

Overview¶

Installation¶

Second-party plugins are officially maintained but distributed as separate Python packages.

You can install plugins individually or choose one of the pre-configured bundles.

pip install vsview[recommended]

pip install vsview[full]

uv add vsview --extra recommended

uv add vsview --extra full

Detailed installation for individual packages can be found in their respective sections below.

Comparison ¶

pip install vsview-comp

uv add vsview-comp

The Comparison plugin provides an integrated workflow for extracting frames and uploading them directly to Slow.pics.

Features¶

• Frame Selection:
  • Choose frames manually or automatically based on frame count and time range.
  • Filter by picture types (I/P/B-frames) and combed frames.
  • Select the darkest and/or lightest frames using asymmetric Gaussian brightness scoring.
• Probability Curve:
  • Bias which part of the timeline random frames are drawn from using an interactive curve editor.
  • Click Curve... next to the random frame count to open the editor.
• TMDB Integration:
  • Search and retrieve metadata from TMDB to automatically populate collection names.
  • Customize the naming format in the plugin Settings.
• Direct Upload:
  • Upload extracted frames to Slow.pics.
  • Configure login in the plugin Settings to upload directly.

Settings¶

Frame List Context Menu¶

Right-clicking any thumbnail in the selected frames list opens a context menu for managing and copying frame data. Multi-selection (Ctrl-click or Shift-click) is supported:

Double-clicking any thumbnail in the list seeks the playback directly to that frame.

Probability Curve Editor¶

Click Curve... (next to the random frame count) to open the curve editor and bias where in the timeline random frames are sampled from.

The boundary points (start/end frame) are fixed horizontally but their weights are editable. Y = 1 everywhere gives uniform sampling.

Dark / Light Frame Selection¶

Candidate frames are scored with an asymmetric Gaussian on their average luma (PlaneStatsAverage):

• Dark: peak ≈ 6.5 % (σ left = 0.015, σ right = 0.15)
• Light: peak ≈ 75 % (σ left = 0.45, σ right = 0.90)

Browser ID¶

Every upload is tagged with a persistent Browser ID UUID so Slow.pics can associate it with your browser session.

Script Integration¶

All set_output outputs are available by default. Pass allow_comp to explicitly exclude specific outputs.

VapourSynth Requirements¶

• fpng (Optional): For slightly faster frame extraction.

Dependency Graph ¶

pip install vsview-graph

uv add vsview-graph

The Dependency Graph dock renders the filter dependency graph of any output using vsgraph and Cytoscape.js.

Features¶

• Layouts: Dagre (TB / LR), breadth-first, concentric, and grid.
• Profiling: Heatmap and per-node execution timings.
• Visual encoding: Concurrency mode borders, request pattern edges, and media change highlights.
• Lineage: Highlights upstream dependencies and downstream consumers for the selected node.
• Inspector: Node and edge specs, inputs, call stacks, and copy actions (ID, Python call, report).
• Overview panel: Graph metrics, concurrency warnings, media transitions, and filter mode filters.
• Search: Space-separated keywords and /regex/flags matching node attributes and call arguments.
• Export: DOT, Mermaid, ASCII, JSON, and PNG.

Settings¶

HUD Toolbar¶

• Output: Select an output or follow the active timeline output.
• Navigation: Zoom (+ / −), fit to view (Fit), reset zoom (1:1), and orientation (↕ TB / ↔ LR).
• Actions: Toggles for Heatmap, edge Patterns, Overview panel, and ↻ (re-inspect).
• Search: Input with match count.

Search Syntax¶

Matches against node names, IDs, labels, call stack functions, namespaces, argument names, and argument values:

• Words: Space-separated terms use AND matching (e.g. std crop left 8).
• Regex: Enclose in slashes with optional flags (e.g. /crop$/i). Invalid syntax displays !.

Visual Encoding¶

• Filter modes (vs.FilterMode):
  • PARALLEL: Solid border.
  • PARALLEL_REQUESTS: Dashed green border.
  • UNORDERED: Dotted highlight border.
  • FRAME_STATE: Dashed red border (serialized frame processing).
  • Root node: Amber border.
• Request patterns (vsgraph.RequestPattern):
  • GENERAL: Solid line.
  • STRICT_SPATIAL: Dotted line (skips frame cache).
  • NO_FRAME_REUSE: Dashed line (disables frame reuse).
  • FRAME_REUSE_LAST_ONLY: Thick dashed line.
• Media transitions: Amber edges and target glows mark format, resolution, fps, or frame count changes.
• Selection & Lineage: Selecting a node highlights upstream inputs and downstream outputs; unrelated elements are dimmed.

Profiling Heatmap¶

Node background color indicates relative execution time (square-root scaled against the slowest node):

• Slate: Baseline / negligible.
• Teal: Fast.
• Amber: Moderate.
• Orange: Heavy.
• Red: Bottleneck.

Inspector Drawer¶

Clicking a node or edge opens its details (specs, performance, inputs, call stack, and copy actions) in the side drawer. Node references in the drawer are clickable and jump to the related node.

Overview Panel¶

Toggle with Overview or L. It summarizes the graph (counts, timings, formats), lists warnings and media changes, and offers filters that dim unrelated nodes on the canvas.

Context Menu & Export¶

Right-click the canvas:

Timings and caching¶

The graph is inspected once per output and cached; the displayed timings are a snapshot of the last inspection. Press the refresh button to re-inspect the current output.

Keyboard Shortcuts¶

FFT Spectrum ¶

pip install vsview-fftspectrum

uv add vsview-fftspectrum

The FFT Spectrum tool provides a visualization of the Fast Fourier Transform (FFT) spectrum of all the planes of a video clip.

Histogram ¶

pip install vsview-histogram

uv add vsview-histogram

Provides per-frame video scopes as tabs inside a single panel.

• Updates are paused during playback and resume on the active tab when playback stops.
• Right-click any plot to copy or save the view.

Levels¶

Plots a per-plane pixel value histogram for the current frame.

Luma¶

Displays a luma scope rendered through a standard graphics view.

Only GRAY and YUV inputs are supported. RGB input shows an error overlay.

Vectorscope¶

Plots chroma (U/V) distribution on a 2D plane.

Pixel ColorColor WheelDensity

Graticules show 75 % and 100 % saturation circles, a skin-tone reference line, and primary/secondary color targets that automatically adjust based on the clip's color matrix (supporting Rec. 601, Rec. 709, Rec. 2020, and ST 240M).

RGB input is not supported and shows a warning. GRAY input plots all pixels at neutral chroma.

Waveform¶

Plots pixel values column-by-column as a waveform. Logarithmic density scaling is applied per-column.

CIE Chromaticity¶

Plots the chromaticity coordinates of the frame pixels onto a standard CIE chromaticity diagram (CIE 1931 xy or CIE 1976 u'v').

Graticules show the boundary triangles for common color gamuts (Rec. 709, Rec. 601, DCI-P3, and Rec. 2020) and a reference crosshair for the D65 white point.

Only RGB input is supported. Other formats, or clips without a valid _Primaries frame property, will display an error overlay.

FrameProps Extended ¶

pip install vsview-frameprops-extended

uv add vsview-frameprops-extended

This plugin adds more categories and formatters to the built-in Frame Properties panel.

Split Planes ¶

pip install vsview-split-planes

uv add vsview-split-planes

Split Planes splits a video clip into its individual planes for inspection.

Features¶

• Extends the Graphics View's default context menu to provide a way to offset chroma plane values.