Repository files navigation

This is a small Go program that takes a 4:3 aspect ratio video file, and transforms it to a 16:9 video using theGoPro SuperView method. This means that the image is not naively scaled, but a dynamic scaling is applied where the outer areas are stretched more while the center parts stay close to the original aspect rate.

This is not a 1-1 copy of the GoPro algorithm, but an attempt to reach similar quality of output using the open-sourceFFmpeg encoder.

Credits for the idea go toBanelle, who wrote theinitial (Python) implementation.

Here is a quick animation showing the scaling, note how the text in the center stays the same:

This program requires FFmpeg to be installed on your computer. If needed, please install it using one of these ways:

• Linux: install from your local package manager, for example:apt instal ffmpeg
• Windows: Download fromhttps://www.gyan.dev/ffmpeg/builds/ and extract theffmpeg-release-full 7ZIP file in the same directory as superview
• macOS: Download fromhttps://evermeet.cx/ffmpeg/ and put in the same folder as superview, or install using Homebrew:brew install ffmpeg

Download the latest release from thereleases page on GitHub. There are two versions: a graphical version calledsuperview-gui and a command line program calledsuperview-cli.

To runsuperview-gui, simply double-click the icon. Choose an input video file, optionally change some settings and click "Encode". The program will ask you where to save the output.

To usesuperview-cli, run the program with the-i (input file) parameter. Optionally, you can provide a-o (output) and-b (bitrate) parameter. Full usage instructions:

Usage:  superview-cli [OPTIONS]Application Options:  -i, --input=FILE         The input video filename  -o, --output=FILE        The output video filename (default: output.mp4)  -e, --encoder=ENCODER    The encoder to use, use -h to see a list. If not specified, it takes the standard encoder of the input file codec  -b, --bitrate=BITRATE    The bitrate in bytes/second to encode in. If not specified, take the same bitrate as the input file  -s, --squeeze            Squeeze 4:3 video stretched to 16:9 (e.g. Caddx Tarsier 2.7k60)Help Options:  -h, --help               Show this help message

If you want superview from source, rungo build superview-gui.go orgo build superview-cli.go depending on which version you'd like to build. Seebuild.sh for an example how to cross-compile.

Thanks goes to these wonderful people (emoji key):

Roman Kuraev 🤔💻

dangr0 🐛

DG 🤔⚠️

Nova_Max 📖

This project follows theall-contributors specification. Contributions of any kind welcome!