Skip to main content

A utility to take several video inputs, take the loudest points, and create a compilation of them with smooth transitions

Project description

Highlight Video Maker

This script automatically creates a highlight reel from multiple video inputs by identifying and combining the loudest moments.

How It Works

  1. Finds a Representative Video

    • Chooses the shortest video as the "representative" video.
  2. Detects Loudest Moments

    • Analyzes the representative video to find the 10 loudest segments.
  3. Applies to All Videos

    • Uses the timestamps from the representative video to divide all others into clips.
      • Note: This will make all videos the same length, removing the excess content from the end.
  4. Combines Clips

    • Merges the loudest segments using:
      • The representative video’s timestamps
      • A randomly selected perspective clip from the other videos
  5. Final Outputs

    • A combonation of all vthe loudest clips, perspective randomly chosen
    • Same as above, but with a mobile-friendly vertical aspect ratio with blurred letterboxing
    • Both clips will be watermarked by an image input, with the image being slightly transparent on the standard video output and opaque on the mobile one

CLI Options

All options except --log-level are required.

$ vr-video-maker --help
Usage: vr-video-maker [OPTIONS] COMMAND [ARGS]...

Options:
  --log-level Sets the logging verbosity. Choose betweenDEBUG, INFO (default), WARNING, ERROR, or CRITICAL.Can be uppercase or lowercase.
  --help                          Show this message and exit.

Commands:
  run  Main function that orchestrates the video processing pipeline.



$ vr-video-maker run --help
Usage: vr-video-maker run [OPTIONS]

  Main function that orchestrates the video processing pipeline.

Options:
  --input-dir The input directory to get the source videos from.
  --watermark-image The path of the watermark image to overlay over the final output. If not specified, no watermark will be applied. It will not be scaled, so it should be sized appropriately relative to the input.
  --horiz-output-file The path to output the final video to. It should not exist and must either be an absolute path or start with "./".
  --vert-output-file The path to output the final video to. It should not exist and must either be an absolute path or start with "./".
  --help                          Show this message and exit.

Requirements

  • Operating System: Linux (tested on Arch Linux, will not work on Windows-like systems)
  • Dependencies: FFmpeg must be installed on the host system

Temporary Storage

  • The script uses /tmp/video-maker-cache for temporary files.
  • This folder can be safely deleted after the script finishes running.

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

highlight_video_maker-0.2.3.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

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

highlight_video_maker-0.2.3-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

Details for the file highlight_video_maker-0.2.3.tar.gz.

File metadata

  • Download URL: highlight_video_maker-0.2.3.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for highlight_video_maker-0.2.3.tar.gz
Algorithm Hash digest
SHA256 ae147bc5495a06dbcb6638e963036831acc4763d092e6d6bcf7c72007e121397
MD5 95b07c5e172e6cdddf0b0c705fca80df
BLAKE2b-256 9c01efe72f9ae86bc148b3dd62ac03e61bc82799ba6ceebd310997212fa18528

See more details on using hashes here.

Provenance

The following attestation bundles were made for highlight_video_maker-0.2.3.tar.gz:

Publisher: pypi.yml on MichaByte/highlight-video-maker

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file highlight_video_maker-0.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for highlight_video_maker-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7663b37f3b0213cdc0c9cb7fb11bdeacbb7fbf6ce6199b43d64621d810668cc7
MD5 0f4d41c829b3bc5086ebdd0ab0e3acf9
BLAKE2b-256 01265f0592481f3addd0ab366aa6fcf0aced55bc2f37dc658c56e19a92805b84

See more details on using hashes here.

Provenance

The following attestation bundles were made for highlight_video_maker-0.2.3-py3-none-any.whl:

Publisher: pypi.yml on MichaByte/highlight-video-maker

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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