Skip to content

README.md

Latest commit

 

History

History
37 lines (30 loc) · 1019 Bytes

README.md

File metadata and controls

37 lines (30 loc) · 1019 Bytes

Video Cropper (GTK)

A small GTK/libadwaita app to open MP4 files, define a crop region, and export the result as a GIF.

Features

  • Open MP4 with preview.
  • Crop by coordinates X, Y, Width, Height.
  • Export to GIF via FFmpeg with palette generation for better quality.

Requirements

  • Python 3.10+
  • GTK 4.10+ and libadwaita
  • GStreamer plugins for video playback
  • FFmpeg (including ffprobe)

Example install (Ubuntu/Debian)

sudo apt-get install -y \
  python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 \
  gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
  gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
  ffmpeg

Run

From the project root:

python3 -m video_cropper

Usage

  1. Click Open MP4 in the header and choose a file.
  2. Set the crop region in the Crop section.
  3. Adjust FPS and Max width if needed.
  4. Click Export GIF and choose the output filename.

If ffmpeg or ffprobe is missing, export will be disabled and a status hint will appear.
⚡