📢 Updates and new projects: Telegram channel
A desktop tool for Windows, macOS and Linux for browsing, cleaning up and trimming large video collections (stream recordings, archives on a NAS) through their contact sheets — preview images with a grid of timestamped frames.
It walks a folder and its subfolders, matches every video with its preview image by name, and shows the previews as a gallery. From there you can delete videos (together with their previews), generate missing previews with ffmpeg, trim videos losslessly, and send videos to your video player — without opening each file.
The whole program is a single Python file (pairview.py, standard library only). The UI is a local web page served on 127.0.0.1 and shown in its own window (pywebview) or in a browser. The interface is in English.
-
Gallery of previews. Matches
clip.mp4withclip.jpg(orclip.mp4.jpg) in the same subfolder. Collapsible folder tree with counts and sizes, sorted by name, last change, size or count; breadcrumbs; adjustable tile size; full-screen viewer; keyboard navigation that crosses folder boundaries in the tree's order. -
Safe deletion. "Delete" never erases anything: the video and its preview are moved (renamed, never copied) into
_to_deleteinside the root folder (an old_на_удалениеfolder from earlier versions is treated the same way).Ctrl+Zbrings them back. Permanent deletion is a separate, explicit action. Works for single videos, selections, whole folders and empty folders. -
Preview generation. Creates missing contact sheets with ffmpeg: a 10×9 grid, 2560 px wide, with an
HH:MM:SStimestamp on every frame (vertical and short videos get adapted grids). Frames are grabbed in batches of ~30 per ffmpeg run, because launching ffmpeg on Windows is expensive. Several videos are processed in parallel; the queue can be stopped at any time. -
Lossless trimming. In the viewer, press
Cto open a timeline under the preview. Mark parts to remove — the beginning, the end, or any number of pieces in the middle — by dragging on the timeline or withI/Oat the cursor; or drag over the part to keep and pressK. Trims of several videos wait in a queue and run one after another in the background. Hovering the timeline instantly shows the matching frame from the contact sheet, then the exact frame from ffmpeg. The video is cut with stream copy (no re-encoding, seconds even for long files); each kept piece starts at the nearest earlier keyframe, so nothing you keep is lost. The original goes to_to_delete, the trimmed file takes its place, the preview is regenerated, andCtrl+Zrestores the original together with the old preview. -
Lossless merging. Select several videos in the gallery and press Merge…: the same timeline opens with a strip of the videos above it. Drag the videos (or use
Alt+←/Alt+→) to set the order, click one to trim it with all the trimming tools, then merge. The result<first video>_merged.<ext>appears next to the first video; the originals and their previews go to_to_delete, andCtrl+Zbrings them back. Only videos with the same codec, resolution, frame rate and audio can be joined without re-encoding — otherwise the program says what differs. Merges share the background queue with trims. -
Built-in player. Videos play right in the viewer: seek bar with a frame from the contact sheet (then the exact frame), the contact sheet shown again while paused, speed, frame stepping, autoplay, next video at the end, loop, and playback resumes where you stopped.
-
External player. Play a folder, a selection or a single video in the player of your choice (menu ☰ → Video player: installed players are detected — MPC-HC, MPC-BE, VLC, PotPlayer, mpv, IINA, Celluloid…, or any program). MPC-HC is recommended on Windows: only with it videos can be appended to the playlist without starting playback, and the player window is brought to the front. Show any file in Explorer / Finder / the file manager.
-
Folder switching. The last opened folder reopens automatically; another one can be picked from the header (recent folders or a folder dialog) without restarting.
-
Updates from GitHub. The menu (☰) checks for a new release; one click downloads it, replaces the program (exe, app or AppImage) and restarts VO SP with the same folder. A green dot on the menu button means an update is available.
-
Network-friendly. Built for videos on an SMB share: no repeated directory walks in request handlers, the trash counter is kept in memory, preview images are read once and closed immediately.
Ready builds are on the releases page. Later versions install themselves from the menu (☰ → Update).
Note
Since v1.5 the app is called VO SP (it was VSPO) and the release files are named VO_SP…. VSPO 1.4 and older cannot find them, so download v1.5 once by hand; after that updates work from the menu again.
| System | File | Notes |
|---|---|---|
| Windows 10/11 | VO_SP.exe |
Single file, just run it. The exe is not code-signed, so SmartScreen may show "Windows protected your PC" on the first start: click More info → Run anyway. |
| macOS 11+ (Apple Silicon) | VO_SP-mac.zip |
Unpack and move VO_SP.app to Applications. The app is not signed by Apple, so the first start is blocked: right-click VO_SP.app → Open → Open, or run xattr -cr /Applications/VO_SP.app in Terminal once. |
| Linux x86-64 | VO_SP-x86_64.AppImage |
chmod +x VO_SP-x86_64.AppImage and run it. Opens the gallery in your browser (for an app window, run from source with pywebview, see below). |
ffmpeg is not bundled. Windows: put ffmpeg.exe and ffprobe.exe next to VO_SP.exe or in PATH. macOS: brew install ffmpeg. Linux: sudo apt install ffmpeg (or your distribution's package).
- Python 3.8+. Only the standard library is needed.
- Optional:
pywebviewfor the app window. Windows uses Microsoft Edge WebView2, macOS — the built-in WebKit. Linux needs GTK or Qt:pip install pywebview[gtk]plussudo apt install python3-gi gir1.2-webkit2-4.1(Debian/Ubuntu), orpip install pywebview[qt]. Without pywebview the gallery opens in the default browser. - Optional:
ffmpegandffprobefor creating previews and trimming. Found via--ffmpeg, next to the program (also inffmpeg/,ffmpeg/bin/,bin/), or inPATH(on macOS also in Homebrew's folders). - Optional: a video player. On Windows MPC-HC or MPC-BE is recommended (the K-Lite Codec Pack location is detected automatically).
pip install pywebview
python pairview.py "D:\Videos"On macOS and Linux: python3 pairview.py ~/Videos. Settings and the log live in ~/.config/pairview there.
Run without a folder argument to reopen the last folder (or get a folder picker on first start). pythonw.exe pairview.py ... runs without a console window; the log then goes to %APPDATA%\pairview\pairview.log.
Common options:
| Option | Meaning |
|---|---|
folder |
Root folder with videos (and previews, if they are stored together) |
--previews DIR |
Separate root for previews with the same subfolder layout |
--ffmpeg PATH, --font PATH |
ffmpeg location (file or folder), .ttf font for timestamps |
--player PATH |
Video player until one is chosen in the menu (mpc-hc64.exe, vlc, mpv, an .app on macOS…) |
--cols 10 --rows 9 --width 2560 --header |
Contact sheet layout; --header adds file info on top |
--jobs N, --gpu auto|on|off, --per-frame |
Parallel videos, NVDEC decoding, one ffmpeg run per frame |
--ignore-ext ts |
Video extensions to ignore (default: .ts stream fragments) |
--clean videos|previews [--apply] |
List or move videos without previews / previews without videos, no UI |
--purge |
Permanently delete everything in _to_delete (asks for confirmation) |
--browser, --no-browser, --port N |
Use a browser instead of the window, server only, fixed port |
Persistent options can be put into pairview.json next to the program or in %APPDATA%\pairview, using option names without dashes:
{"folder": "D:\\Videos", "player": "C:\\Program Files\\MPC-HC\\mpc-hc64.exe", "ignore_ext": "ts"}| Where | Keys |
|---|---|
| Gallery | Arrows, Home/End — select; Enter/Space/click — open the viewer with the preview sheet; E — show in Explorer / Finder; Del — delete video(s); Backspace — parent folder; [ ] — folder of the same level; PgUp PgDn — previous/next folder with videos; X, Ctrl+A — select tiles; Ctrl+Z — undo; F5 — rescan |
| Folder tree | Click a folder, then ↑/↓ — move, ←/→ — collapse/expand, Del — delete the folder, Esc — back to the gallery |
| Viewer | Space/click — play / pause; Enter/double click — full screen; ←/→ — seek 5 s while playing, previous/next when paused or on the sheet; Shift/Ctrl+←/→ — seek 30 s / 2 min; ↑/↓ — volume; , . — frame step; Backspace — back to the start and the sheet; Del — delete; I — hide the bar; Esc — from the video to the sheet, from the sheet close |
| Trimming | ←/→ — move cursor 1 s (Shift 10 s, Ctrl 1 min); I/O — start/end of a piece to remove; K — trim now, keeping only the selected piece; Del — unmark the selected piece; Esc — close |
| Merging | Same as trimming (K only marks); Alt+←/Alt+→ — move the selected video earlier/later; PgUp/PgDn — previous/next video of the merge |
GitHub Actions builds VO_SP.exe, VO_SP-mac.zip and VO_SP-x86_64.AppImage on every push (workflow Build, also runnable by hand): download them from the run's Artifacts. Pushing a tag like v1.2, or running the workflow by hand with a tag in the release field, also publishes them as a GitHub release. The tag must match VERSION in pairview.py (the build checks it): that is how the in-app updater compares versions. To build locally on Windows:
pip install pyinstaller pywebview
pyinstaller --onefile --noconsole --name VO_SP --icon assets/vo_sp.ico --collect-all webview --collect-all pythonnet --collect-all clr_loader pairview.pyThe result is a single dist\VO_SP.exe. The macOS and Linux build commands are in .github/workflows/build.yml.
- Only
127.0.0.1is used. Every request needs a random token generated at start-up; paths coming from the page are never trusted (videos are referenced by id, folders are checked to stay inside the root). - Trimming copies the first video stream and all audio streams; subtitles and other streams are not carried over.
- The screenshots use synthetic test videos generated by ffmpeg (test patterns, fractals, Game of Life).
- Developer notes (architecture, data model, pitfalls) are in
CLAUDE.md, in Russian.
VO SP is free. If it saves you time, you can support its development:
- Monobank jar (card of any bank)
- Ko-fi
- Crypto (NOWPayments)


