Skip to main content

Splice similar frames from videos

Project description


pipeline status coverage report Code style: black PyPI version

Effortlessly shorten videos.


abridge can automatically shorten video files by removing parts from the video where not much happens. This is great for making timelapse videos more engaging and removes the need for manual editing to cut these dead spots from the videos.


pip install abridge

abridge makes use of moviepy, which releys on ffmpeg. ffmpeg should be installed when the package is installed, but this may not work on some systems.


adbridge can be run as a docker image, which gaurentees it will run on all systems.

docker pull freshollie/abridge:latest

docker run freshollie/abridge


usage: abridge [-h] [-w workers] [-o outdir] [-t diff-threshold]
               [-r repetition-threshold]
               clip [clip ...]

Effortlessly shorten videos

positional arguments:
  clip                  Clip to cut or glob group

optional arguments:
  -h, --help            show this help message and exit
  -w workers            Number of clip processors
  -o outdir
  -t diff-threshold     Difference threshold required between frames for a
                        frames to be considered different
  -r repetition-threshold
                        Number of frames in a row required to make a cut


from abridge import abridge_clip



The abridge project is managed and packaged by poetry

Use poetry install to download the required packages for development

poetry run pre-commit install should be run to install the pre-commit scripts which help with ensuring code is linted before push.


Tests are written with pytest and can be run with make test


abridge is linted with pylint and formatted with black and isort

mypy is used throughout the project to ensure consitent types.

make lint will check linting, code formatting, and types

make format will format code to required standards


  • Test coverage on processor



Project details

Download files

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

Source Distribution

abridge-0.1.4.tar.gz (5.8 kB view hashes)

Uploaded Source

Built Distribution

abridge-0.1.4-py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page