# Install vs-preview with Homebrew Previewer for VapourSynth scripts. Version 0.20.1 via Homebrew; verified 2026-07-01. ## Install ```sh sudo av install brew:vs-preview ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install vs-preview ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:vs-preview - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.20.1 - **Source summary:** Previewer for VapourSynth scripts - **Homepage:** - **Repository:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-01T09:59:09-04:00 - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - vspreview (cli) - vspreview (alias) ## Dependencies - certifi - freetype - libyaml - numpy - pillow - pyqt - python-matplotlib - python@3.14 - vapoursynth ## Build dependencies - autoconf - automake - jpeg - meson - ninja ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-08-04 - Package-manager version: 0.20.1 - Package-manager updated: 2026-07-01 - Local data: ok - Upstream repository: https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview - info: No cached GitHub release or tag data was available. ## Project history and usage vs-preview, distributed as the `vspreview` Python package and executable, is a standalone previewer for VapourSynth scripts. It is a niche video-encoding tool for users who write `.vpy` scripts and want to inspect filtered output from an editor-oriented workflow. ### Project history The Jaded Encoding Thaumaturgy repository was created in March 2022 and identifies the project as a fork of Endilll's `vapoursynth-preview`, which the README says was no longer maintained. The PyPI page keeps that lineage visible by listing Endilll as author while showing Setsugen no ao as maintainer. The project became part of the Jaded Encoding Thaumaturgy VapourSynth ecosystem, which also includes libraries, guides, and newer previewer work. By 2026, the GitHub repository was archived, and the JET documentation for VSView describes VSView as a modern replacement for VSPreview with a cleaner and more maintainable plugin-oriented design. ### Adoption history The project is small but meaningful inside the VapourSynth encoding niche. GitHub shows about a hundred stars and a few dozen forks, and PyPI release history shows continuing published releases from the first visible 0.2.x releases in May 2022 through v0.20.1 in March 2026. Its adoption is tied to script-heavy video filtering workflows rather than general video playback. The README explicitly recommends pairing it with editors that have integrated terminals, and documents IDE integration for Visual Studio Code, Vim, and Notepad++. ### How it is used Users install `vspreview`, then run `vspreview script.vpy` from a terminal or editor task to preview a VapourSynth script. The tool also supports external plugins through `vspreview install [plugin-name]`, with plugin files placed in a global plugin directory. For package users, vs-preview fills the practical gap between writing VapourSynth Python scripts and rendering final encodes: it lets encoders inspect frames, compare processing choices, and iterate in an editor without wiring a custom preview harness. ### Why package nerds care The package is significant mostly to video-filtering power users. It packages an editor-friendly VapourSynth preview workflow as a CLI, which matters in communities where scripts, frame inspection, and repeatable encode pipelines are the normal way of working. ### Timeline - 2022: Jaded Encoding Thaumaturgy creates the vs-preview repository as a maintained fork of the older vapoursynth-preview project. - 2022-2026: PyPI release history shows frequent `vspreview` releases, from 0.2.x in May 2022 to 0.20.1 in March 2026. - 2026: The upstream repository is archived, while VSView is documented as the modern replacement. ### Related projects - vs-preview is related to VapourSynth, Endilll's vapoursynth-preview, Jaded Encoding Thaumaturgy packages, vs-jet-engine, and VSView. ### Sources - GitHub README: https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview - GitHub repository API metadata: https://api.github.com/repos/Jaded-Encoding-Thaumaturgy/vs-preview - JET organization overview: https://github.com/Jaded-Encoding-Thaumaturgy - PyPI project page and release history: https://pypi.org/project/vspreview/ - VSView documentation: https://jaded-encoding-thaumaturgy.github.io/vs-view/ ## Security Notes No matching local secret-handling manifest was found for vs-preview. Package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** vs-preview - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** yes - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://pkg.so/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [python@3.14](https://pkg.so/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [freetype](https://pkg.so/brew/freetype/) - Runtime dependency declared by Homebrew. - [numpy](https://pkg.so/brew/numpy/) - Runtime dependency declared by Homebrew. - [vapoursynth](https://pkg.so/brew/vapoursynth/) - Runtime dependency declared by Homebrew. - [pyqt](https://pkg.so/brew/pyqt/) - Runtime dependency declared by Homebrew. - [ninja](https://pkg.so/brew/ninja/) - Build dependency declared by Homebrew. - [autoconf](https://pkg.so/brew/autoconf/) - Build dependency declared by Homebrew. - [automake](https://pkg.so/brew/automake/) - Build dependency declared by Homebrew. - [meson](https://pkg.so/brew/meson/) - Build dependency declared by Homebrew. - [vsview](https://pkg.so/brew/vsview/) - Shares pkgdb curated category or tags: cli, gui, media, previewer, vapoursynth. - [aom](https://pkg.so/brew/aom/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [handbrake](https://pkg.so/brew/handbrake/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [ab-av1](https://pkg.so/brew/ab-av1/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [av1an](https://pkg.so/brew/av1an/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [mjpegtools](https://pkg.so/brew/mjpegtools/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [ffmpeg](https://pkg.so/brew/ffmpeg/) - Shares pkgdb curated category or tags: cli, encoding, media, video. - [dav1d](https://pkg.so/brew/dav1d/) - Shares pkgdb curated category or tags: cli, media, video. - [animdl](https://pkg.so/brew/animdl/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, libyaml, media, python. - [bilix](https://pkg.so/brew/bilix/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, media, python, python-3-14. ## Combined YAML source View the package source record on GitHub. [combined/vs-preview.yml](https://github.com/mxcl/pkgdb/blob/main/combined/vs-preview.yml) ## Sources - pkg.so package database - package-page enrichment - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - cross-ecosystem install command graph