rai0603/dronetrim

DroneTrim is a Python tool for cleaning up drone video clips before you bring them into a video editor. Drone footage almost always starts with shaky takeoff frames and ends with shaky landing frames, plus sometimes the drone just hovers in place longer than you need. Trimming those parts out of every clip by hand is tedious when you have a full folder of footage. This tool does it automatically in batch. The detection works by analyzing motion between frames. It uses a technique called optical flow to measure how much the whole image is shifting or shaking from one frame to the next. A smooth, intentional camera move is treated as usable footage. High-frequency jitter, which happens during takeoff and landing, is flagged for removal. Prolonged stillness at the start or end of a clip is also trimmed away, though intentional locked-down shots are protected from being cut. You can run it two ways. There is a drag-and-drop graphical interface where you drop a folder of video files onto the window, pick an output folder, and click start. Each clip shows its trimming result as it finishes. There is also a command-line version suited for scheduled or automated workflows, with a dry-run option that shows you the analysis report without actually modifying anything. For output, you choose between two modes. Copy mode is lossless and very fast, finishing a 4K clip in a few seconds, though the cut point may be off by up to a second due to how video keyframes work. Encode mode cuts to the exact frame using hardware acceleration on macOS. Both modes save the trimmed version as a new file with a suffix added to the name, leaving the originals untouched. A CSV report of all trim decisions is also saved alongside the output files. The tool runs on macOS and Linux. It requires FFmpeg and OpenCV, and optionally PySide6 for the graphical interface. The project is released under the MIT license.