Skip to main content

Trimmy

Vertical split-crop video editor. Take any video, pick two crop regions, stack them top-and-bottom into a 9:16 frame, and export optimized for social media.

The output stacks the two crops vertically into a single 9:16 video — ideal for reaction content, split-screen tutorials, gameplay + facecam, and Reels / TikToks / Shorts.

Install

pip install trimmy

Or run it without installing, using uv:

uvx trimmy

Requires ffmpeg and ffprobe available on your PATH, plus Python 3.10+.

Usage

Launch the app:

trimmy

Or open a file directly:

trimmy path/to/video.mp4

Then:

  1. Open or drag-drop a video.
  2. Position the two crop boxes on the source frame (TOP and BOTTOM).
  3. Adjust the split ratio by dragging the red divider.
  4. Trim the timeline to the segment you want.
  5. Pick a platform and quality preset.
  6. Render — ffmpeg encodes a ready-to-upload vertical video.

Keyboard shortcuts

Key Action
K Play / Pause
J Seek backward 5s
L Seek forward 5s
Q Set trim start to playhead
E Set trim end to playhead
M Toggle mute
? Show keyboard shortcuts

Platform presets

Platform Resolution Max FPS Max Size Codec
Instagram 1080x1920 60 300 MB H.264 High 4.0
TikTok 1080x1920 60 4 GB H.264 High 4.2
Twitter/X 1080x1920 60 512 MB H.264 High 4.2
WhatsApp 720x1280 30 16 MB H.264 Main 3.1
Telegram 1080x1920 60 2 GB H.264 High 4.2

Each platform offers a Max mode (highest quality, slower encode) and an Optimized mode (smaller files, faster encode). WhatsApp auto-caps bitrate to fit the 16 MB limit.

Development

Trimmy is built with PySide6. To work on it from source:

git clone https://github.com/musantro/trimmy.git
cd trimmy
uv sync
uv run python -m trimmy

See CHANGELOG.md for release history.

Documentation

The documentation site lives in docs and is configured with MkDocs Material:

uv run --group docs mkdocs serve

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trimmy-0.16.0.tar.gz (786.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trimmy-0.16.0-py3-none-any.whl (818.4 kB view details)

Uploaded Python 3

File details

Details for the file trimmy-0.16.0.tar.gz.

File metadata

  • Download URL: trimmy-0.16.0.tar.gz
  • Upload date:
  • Size: 786.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for trimmy-0.16.0.tar.gz
Algorithm Hash digest
SHA256 5e04ed063100bfaa5197f84765778cf1bca74ea34629739972bac56bf33f94ed
MD5 4e95b404f3752504d0889f2121284e2c
BLAKE2b-256 128794d2f3c19b982d149211694104d1429115458d71242994e5fb370ca68213

See more details on using hashes here.

File details

Details for the file trimmy-0.16.0-py3-none-any.whl.

File metadata

  • Download URL: trimmy-0.16.0-py3-none-any.whl
  • Upload date:
  • Size: 818.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for trimmy-0.16.0-py3-none-any.whl
Algorithm Hash digest
SHA256 856ff93187afc6adfdfacaa43df9605a28264040e728c588f47775943c4b34b8
MD5 aaac71e8af0da74fda4d8ac1f231c43b
BLAKE2b-256 a3737fc97739061fc45363b03fca6f0ed118894d13a9417fb2e1d372de2bcb49

See more details on using hashes here.

Release history Release notifications | RSS feed

0.16.1

2 files

This release

0.16.0 This release

2 files

0.15.0

2 files

0.14.0

2 files

0.13.1

2 files

0.13.0

2 files

0.12.1

2 files

0.12.0

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page