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 read so 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.mp4 into an explicit video inspection request

Requirements

• ffprobe
• ffmpeg

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

1. Copy a local video file in Finder / your file manager, or copy a local video file path.
2. In Pi, use the normal image paste shortcut.
   • macOS/Linux: Ctrl+V
   • Windows: Alt+V if you use Pi defaults
3. The video path is inserted into the editor.
4. Submit the message.
5. Pi inspects the video through read and returns metadata plus sampled frames.

Notes

• This is a standard Pi extension. It does not add a new native video message type.
• Drag and drop already pastes file paths in many terminals; this extension mainly improves paste behavior and makes read understand video files.
• After you publish to npm, users will be able to install it with pi install npm:video-paste.