Metadata-Version: 2.4
Name: vspreview
Version: 0.0.0+unknown
Summary: VapourSynth Preview Tool
Project-URL: Source Code, https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview
Project-URL: Contact, https://discord.gg/XTpc6Fa9eB
Author: Endilll
Maintainer-email: Setsugen no ao <setsugen@setsugen.dev>, Jaded Encoding Thaumaturgy <jaded.encoding.thaumaturgy@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.12
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: numpy>=2.0.0
Requires-Dist: pillow>=11.3.0; platform_system == 'Windows'
Requires-Dist: pyqt6-sip~=13.10.0
Requires-Dist: pyqt6~=6.10.0
Requires-Dist: pywin32>=307; platform_system == 'Windows'
Requires-Dist: pyyaml~=6.0.2
Requires-Dist: qdarkstyle>=3.2.3
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: requests>=2.32.0
Requires-Dist: vapoursynth>=69
Requires-Dist: vsjetengine>=1.2.0
Requires-Dist: vsjetpack>=1.1.0
Description-Content-Type: text/markdown

# Standalone previewer for VapourSynth scripts

Fork of Endilll's [vapoursynth-preview](https://github.com/Endilll/vapoursynth-preview) (not maintained anymore)

This program is meant to be paired with a code editor with integrated terminal like Visual Studio Code.

# Prerequisites

1. [Python](https://www.Python.org/downloads) (3.12+ required)
   - Make sure to install Python to your `PATH`.
1. [VapourSynth](https://github.com/vapoursynth/vapoursynth/releases) (R69+ required)

# Installation

Install latest stable via pypi:

```bash
pip install vspreview
```

# Usage

It can be used by running `vspreview script.vpy` or your preferred way in [your IDE](#ide-integration).

[Keyboard Shortcuts](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview/blob/master/docs/accessibility/keybinds.rst)

[Saved Frame Filename Variables](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview/tree/master/docs/save_frame_placeholders.md)

# IDE Integration

- [Visual Studio Code](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview/tree/master/docs/installation/install_vscode.rst)
- [Vim](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview/tree/master/docs/installation/install_vim.rst)
- [Notepad++](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview/tree/master/docs/installation/install_notepad++.rst)

# Plugins

You can install external plugins by using the following command:

```bash
vspreview install [plugin-name]
```

A list of plugins can be found in [this repo](https://github.com/Jaded-Encoding-Thaumaturgy/vs-preview-plugins). `plugin-name` is the name of the plugin directory in the repo.

To develop new plugins or manually install them, create a .ppy file inside the global plugins directory. You can find the path to that in the storage file. You can add additional search paths by adding them to a .pth file inside the global plugins directory, just like you can with python path and site-packages.
