Skip to content

About

A lightweight, frame-accurate cross-platform video cutter

Resources

Stars

17 stars

Watchers

1 watching

Forks

Latest commit

 

History

44 Commits

Folders and files

Repository files navigation

Snipwright

Snipwright is a lightweight, frame-accurate video cutter for Linux. It focuses on doing one thing well — fast, frame-accurate cuts of videos and PVR/broadcast recordings without re-encoding — and takes its inspiration from VideoReDo, distilling the part many people relied on most into a free, open-source tool.

Snipwright editor

Features

  • Frame-accurate cutting of MPEG-TS and other recordings, copying the original streams so kept footage is never re-encoded.
  • Scene-based editing with mark-in / mark-out, a thumbnail strip, and clickable thumbnails for fast navigation.
  • Lossless export, including a broadcast-audio graft that copies the source audio losslessly rather than re-encoding it — every track, with audio-description tracks kept in sync and correctly labelled.
  • Subtitles kept — broadcast (DVB) subtitles are carried through every cut and every join, re-encoded or not. A Blu-ray's subtitles stay exactly as they are in an MKV export, and are converted to broadcast subtitles when disc scenes are joined, so a joined video has one subtitle track. Where a format genuinely can't hold a subtitle track (MP4 has no room for DVB subtitles, for example), the export summary says so instead of dropping it silently.
  • A VideoReDo-style Joiner that combines scenes or whole recordings — with optional title cards and fades — into one video, joined losslessly when the formats match. Select several files in Open Video to fill the list in one go.
  • Automatic commercial detection with Chalkline, the built-in detector — nothing to install or configure. It reads the channel logo, the picture shape and the aspect ratio, learns each channel's logo from the edits you save, and reports nothing at all when it cannot tell rather than guessing and removing part of the programme. Breaks become ready-to-review cuts. Comskip is supported as an alternative if you prefer it.
  • A background Watcher that scans your recording folders and prepares projects automatically, so they're waiting for you in the Batch Manager. An ignore list keeps other people's programmes out of it, and can tidy itself up as series come to an end.
  • TV and Film renamers that look titles up on TMDB and produce tidy, media-server-friendly names.
  • Project import/export — reads and writes .vprj (V3/V5) and EDL files — plus a Quick Stream Fix remux to repair broken broadcast streams.
  • MKV output via mkvmerge, alongside the native stream-copy export.
  • A translatable interface, with a German translation included and a language picker in Settings. Adding a language needs no code — see src/translations.
  • Light, dark and Modern themes — Snipwright can follow your desktop's own colours, or use a classic Light or Dark look, or the Modern look (rounded controls, more spacing, a blue accent) in light or dark. A new installation starts in Modern (follow system), which is light or dark to match your desktop; upgrading keeps the theme you already had. Change it under Settings → General → Theme.

Requirements

Snipwright is a Python application, not a standalone .exe. Python has to be installed on the machine and stays there — it is needed every time you run Snipwright, not just to install it. You never have to use Python, though: the installer fetches it for you, and you start Snipwright from a Start Menu or desktop shortcut like any other program. There is no console window and nothing to type.

If you were hoping for a single self-contained executable to copy between machines, this isn't that — see Why not a compiled .exe? below.

  • An operating system that runs Python. Developed and tested on Linux Mint, so Linux is the best-supported platform. Windows has had limited testing — it installs and runs — and macOS has had none at all, though there's no reason it shouldn't work. See Status for the caveats.
  • Python 3.12, 3.13 or 3.14. Linux Mint 22 and later include 3.12; the Windows installer fetches 3.14 if needed.
  • Python packages: PySide6, PyAV (av), numpy, bitstring, tqdm — see requirements.txt. Each is held to the versions Snipwright has been tested with: bug-fix releases of a tested version are accepted, but nothing newer, so a new release of one of them can't break an install; newer versions are adopted once they've been tried.
  • External tools:
    • ffmpeg — required. Snipwright runs it directly to inspect recordings and for some export steps. (PyAV brings its own copy of FFmpeg for decoding, so the two versions don't need to match.)
    • mkvmerge (from MKVToolNix) — required only for MKV output.
    • Comskip — optional. Snipwright detects adverts with its own built-in Chalkline detector by default, so you only need Comskip if you would rather use it instead (Settings → Advert detection). Prebuilt binaries are the easy route; if you want to build it yourself, COMSKIP.md covers what actually works on Linux and Windows.
  • A TMDB API key — optional, only needed for the TV/Film renamers. A free key is available from your account at themoviedb.org.

Why not a compiled .exe?

Bundling Python and Qt into one executable is possible, but it would be a few hundred megabytes, and it would still need ffmpeg and mkvmerge installed separately — those are separate programs, not Python libraries, so a bundle doesn't remove the dependency. Bundled Python builds also trip antivirus false positives fairly regularly, and "Windows blocked this" is a worse first impression than running an installer. Snipwright is developed on Linux, so a Windows build would also mean shipping binaries that can't easily be tested.

The installer script does the work instead: one double-click fetches everything needed and creates the shortcuts.

Installation

The quickest way is the one-step installer for your platform, which sets up the dependencies, a virtual environment, and menu/desktop shortcuts.

Linux:

git clone https://github.com/infidelus/snipwright.git
cd snipwright/src/packaging
chmod +x install-linux.sh
./install-linux.sh

The installer fetches anything missing with your distribution's own package manager — apt on Debian, Ubuntu, Mint and Pop!_OS, dnf on Fedora and RHEL, pacman on Arch, EndeavourOS and Manjaro, zypper on openSUSE — so it's fully automatic on all of them. One thing it can't do for you: Fedora's and openSUSE's own ffmpeg can't decode H.264 or HEVC, which most broadcast recordings use, so on those it tells you how to switch to the full ffmpeg from RPM Fusion (Fedora) or Packman (openSUSE).

A distribution that isn't one of these families or built on one (Gentoo, Void or Alpine, say) uses a package manager the installer doesn't know, so it can't fetch the system packages there. Install python3, ffmpeg, mkvtoolnix and the Qt/xcb runtime libraries with your own package manager first; the installer then does the rest — the Python environment, the menu shortcuts and the checks.

Windows 10 / 11: clone or download the repository, then run the installer. The simplest way is to double-click src/packaging/install-windows.bat (or run it from a Command Prompt) — it launches the setup without you needing to touch PowerShell's execution policy. It uses winget to fetch Python, ffmpeg and mkvmerge if they're missing.

If you prefer PowerShell directly, you can instead right-click src/packaging/install-windows.ps1 and choose Run with PowerShell; if it's blocked, run Set-ExecutionPolicy -Scope Process Bypass in that same PowerShell window first (this lifts the restriction for that one session only), then run the script.

See src/packaging/README.md for details.

Uninstalling

Run the uninstaller beside the installer - bash src/packaging/uninstall-linux.sh on Linux, or double-click src/packaging/uninstall-windows.bat on Windows - then delete the Snipwright folder. It asks before removing your settings (learned channel logos included, in case you reinstall), and never touches recordings, exports, projects or logs. Details are in src/packaging/README.md.

Manual installation

If you'd rather set things up yourself:

git clone https://github.com/infidelus/snipwright.git
cd snipwright

# A virtual environment is recommended, so the locked package versions
# don't clash with anything else you've installed (use Python 3.12-3.14):
python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

python3 src/main.py

Quick start

  1. Open a recording with Open Video (or drag one in).
  2. Find your cuts. Scrub the timeline, step frame-by-frame, and use the thumbnail strip to land exactly where you want.
  3. Cut out what you don't want. In Cut Mode, the default, the whole recording starts selected: mark in and mark out around each advert break and cut it — or let Tools → Detect Commercials mark the breaks for you. If you'd rather mark the parts to keep, switch to Scene Mode in Settings → General.
  4. Export. The default export is a lossless, frame-accurate stream copy; choose MKV if you'd prefer that container.

Everything else lives in two places worth a look early on:

  • Settings — set your working folders, choose your advert detector, point Snipwright at mkvmerge (and Comskip, if you use it), add your TMDB key, pick a theme, and adjust logging.
  • The Extras menu — launch the TV/Film renamers and start the background Watcher.

Screenshots

Watch it in action (about a minute)

Chalkline finds the breaks; check them, then save.

Detecting the adverts, checking the scenes and saving

The screenshots show the Modern Dark theme.

Settings — set your folders, external tools and preferences.

Settings

Batch Manager — queue exports and process them in one pass.

Batch Manager

The Watcher — scans your recording folders and prepares projects automatically.

Watcher

TV Renamer — looks titles up on TMDB and produces media-server-friendly names.

TV Renamer

Status

Snipwright was built for, and tested mainly against, UK Freeview HD and SD recordings on Linux Mint — that's the path that's had the most real-world use. Other sources and distributions may well work, but haven't been exercised as thoroughly, so reports from them are welcome.

It's had basic testing on Windows — it installs (via the installer above) and runs — though it hasn't been through extensive functionality testing there. The core is cross-platform Python (PySide6 and PyAV), so the editor and cutting work as expected. One convenience differs on Windows: the settings land in a .config folder under your user profile rather than the usual location. The Watcher's start-on-login checkbox works on Windows as well as Linux — it places a small launcher in your Startup folder (and removes it when you untick the option), so no manual setup is needed.

It's shared as-is, in the hope that others find it useful. Bugs go in the issue tracker, which has a short form to fill in; questions and suggestions go in Discussions. Bug reports are welcome, especially with a sample recording, since almost every fix so far has come from someone sending me a file that broke it. Feature requests I'll read and consider, but I'm promising nothing: this is a hobby project maintained by one person, and it already does what I need it to. Replies may take a while. If you want Snipwright to go further than I'm likely to take it, fork it and make it your own — exactly what the licence is here to allow.

Acknowledgements

  • Inspired by VideoReDo, the Windows tool that made frame-accurate recording cuts feel effortless. Snipwright is not connected to VideoReDo in any way and its developers provide no support for it — please don't contact them about anything here.
  • The frame-accurate cutting engine in src/smartcut/ is smartcut by Santtu Keskinen (MIT licensed), used here with local modifications. See the original project at https://github.com/skeskinen/smartcut.
  • With grateful acknowledgement to Anthropic's Claude, whose assistance shaped much of this project.

Licence

Snipwright is released under the MIT Licence — see LICENSE.

It bundles the smartcut engine, which is also MIT licensed (© 2024 Santtu Keskinen); that licence is retained at src/smartcut/LICENSE.

About

A lightweight, frame-accurate cross-platform video cutter

Resources

Stars

17 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Contributors

Languages