video-paste
Pi extension that adds video paste support and video-aware inspection through the read tool.
Package details
Install video-paste from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:video-paste- Package
video-paste- Version
0.1.0- Published
- Mar 16, 2026
- Downloads
- 18/mo · 5/wk
- Author
- avichalp
- License
- MIT
- Types
- extension
- Size
- 34.5 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
video-paste
A Pi extension that adds video paste support and makes Pi's read tool video-aware.
Features
- pastes copied local video file paths into the editor using Pi's normal paste flow
- keeps native image paste working by falling back to Pi's built-in image handling
- upgrades
readso common video files can be inspected directly - returns video metadata from
ffprobe - returns sampled keyframes as image attachments
- rewrites bare path-only prompts like
~/Movies/demo.mp4into an explicit video inspection request
Requirements
ffprobeffmpeg
Install
From GitHub
pi install git:github.com/avichalp/video-paste
Local dev / quick test
pi -e .
Run that from this repo root.
Do not use -e . at the same time as a global symlinked install.
Manual install
Symlink or copy this folder into one of these locations:
~/.pi/agent/extensions/for global use.pi/extensions/for project-local use
Usage
- Copy a local video file in Finder / your file manager, or copy a local video file path.
- In Pi, use the normal image paste shortcut.
- macOS/Linux:
Ctrl+V - Windows:
Alt+Vif you use Pi defaults
- macOS/Linux:
- The video path is inserted into the editor.
- Submit the message.
- Pi inspects the video through
readand returns metadata plus sampled frames.
Notes
- This is a standard Pi extension. It does not add a new native
videomessage type. - Drag and drop already pastes file paths in many terminals; this extension mainly improves paste behavior and makes
readunderstand video files. - After you publish to npm, users will be able to install it with
pi install npm:video-paste.