First-Party Plugins¶
First-party plugins are official components integrated directly into the VSView source code and distributed with each release.
-
Color Picker
Inspect precise pixel values directly from the viewport. View both rendered RGB and raw source values in real-time.
-
Frame Properties
Access frame properties attached by VapourSynth filters.
-
Scening
Create, manage, and export scene ranges. Supports custom parsers and serializers.
Color Picker¶
The Color Picker dock tool allows you to inspect precise pixel values at any position in the frame.
How to Use¶
- Click the Pipette icon in the toolbar to activate the tool.
- Hover the mouse over the viewport to see real-time pixel data.
- Right-click or click the tool icon again to deactivate.
Data Provided¶
The inspector provides two sets of values for the selected pixel:
- Rendered Values: The RGB values as they appear after the internal VSView rendering pipeline.
- Source Values: The raw, underlying sample values directly from the VapourSynth clip.
Frame Properties¶
The Frame Properties panel displays metadata attached to each frame by VapourSynth filters.
Features¶
- Categorization: Properties are grouped into logical categories (e.g., Video, Metrics, Field).
- Formatters: Values are automatically formatted into readable strings based on their type.
- Context Menu: Right-click a property to display a context menu with options to copy the property value or its key.
Extended Functionality
For additional property categories and formatters, see FrameProps Extended.
Scening¶
The Scening dock tool is designed for creating, managing, and exporting scene ranges.
Scene Management¶
The upper panel manages scenes, which are named containers for ranges. Each scene has a customizable color, can be bound to specific outputs, and has a display toggle to control timeline visibility.
- Create new scene adds a new scene.
- Delete removes a scene.
- The Color swatch changes the scene's color.
- The Outputs column restricts a scene to specific video outputs.
- The Display checkbox toggles the scene's visibility on the timeline.
Adding Ranges¶
The lower panel shows the ranges belonging to the selected scene. You build ranges using the Mark in / Mark out workflow:
- Navigate to the desired start frame on the timeline.
- Press Q (or click Mark in) to set the start point.
- Navigate to the desired end frame.
- Press W (or click Mark out) to set the end point.
- Press E (or click Add range) to commit the range to the selected scene.
Each range displays its Start Frame, End Frame, Start Time, End Time, and an optional Label.
Keyboard Shortcuts¶
| Shortcut | Action |
|---|---|
| Q | Toggle range start (Mark in) |
| W | Toggle range end (Mark out) |
| E | Validate / add the pending range |
| Del | Remove selected range or scene |
| Ctrl+Left | Seek to previous range boundary |
| Ctrl+Right | Seek to next range boundary |
| Ctrl+Shift+Left | Seek to previous range |
| Ctrl+Shift+Right | Seek to next range |
Each shortcut is customizable in the Settings menu.
Timeline Integration¶
When a scene's Display checkbox is enabled, its ranges are drawn as colored notches directly on the timeline. Hovering over a notch displays a tooltip with the range label (if set). Scenes can be filtered per output, so only relevant ranges are shown for the active video tab.
Import & Export¶
The toolbar provides Import scene... and Export scene... buttons for working with external files.
Supported Import Formats¶
| Format | Extension |
|---|---|
| Aegisub Advanced SSA | .ass |
| OGM Chapters | .txt |
| Matroska XML Chapters | .xml |
| XviD Log | .txt, .log |
| QP File | .qp, .txt |
| Wobbly File | .wob |
| Python List (Frames) | .txt |
| Python List (Timestamps) | .txt |
Supported Export Formats¶
| Format | Extension |
|---|---|
| OGM Chapters | .txt |
| Python List (Frames) | .txt |
| Python List (Timestamps) | .txt |
Extended Functionality
Developers can register custom parsers and serializers via the plugin hook system. See the Scening Tool API for details.