https://github.com/niek/superview

A small program that takes a 4:3 aspect ratio video file, and transforms it to a 16:9 video using the GoPro SuperView method
https://github.com/niek/superview

ffmpeg fpv fpv-drones golang gopro hacktoberfest quadcopter scaling superview

Last synced: 6 months ago
JSON representation

A small program that takes a 4:3 aspect ratio video file, and transforms it to a 16:9 video using the GoPro SuperView method

Host: GitHub
URL: https://github.com/niek/superview
Owner: Niek
License: gpl-3.0
Created: 2019-05-30T06:13:25.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2023-11-02T21:33:26.000Z (almost 2 years ago)
Last Synced: 2025-04-10T01:12:41.769Z (6 months ago)
Topics: ffmpeg, fpv, fpv-drones, golang, gopro, hacktoberfest, quadcopter, scaling, superview
Language: Go
Homepage:
Size: 7.02 MB
Stars: 216
Watchers: 18
Forks: 21
Open Issues: 10
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# Superview

[![All Contributors](https://img.shields.io/badge/all_contributors-4-orange.svg?style=flat-square)](#contributors-)

This is a small Go program that takes a 4:3 aspect ratio video file, and transforms it to a 16:9 video using the [GoPro SuperView](https://gopro.com/help/articles/question_answer/What-is-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-source [FFmpeg](https://ffmpeg.org/) encoder.

Credits for the idea go to _Banelle_, who wrote the [initial (Python) implementation](https://intofpv.com/t-using-free-command-line-sorcery-to-fake-superview).

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

![alt text](.github/sample.gif "Sample of the scaling result")

## Requirements

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 from https://www.gyan.dev/ffmpeg/builds/ and extract the `ffmpeg-release-full` 7ZIP file in the same directory as superview
- **macOS**: Download from https://evermeet.cx/ffmpeg/ and put in the same folder as superview, or install using Homebrew: `brew install ffmpeg`

## Installation

Download the latest release from the [releases page on GitHub](https://github.com/Niek/superview/releases). There are two versions: a graphical version called `superview-gui` and a command line program called `superview-cli`.

## Usage

#### GUI
To run `superview-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.

![alt text](.github/sample-gui.png "Sample of GUI")

#### CLI
To use `superview-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
```

## Development

If you want superview from source, run `go build superview-gui.go` or `go build superview-cli.go` depending on which version you'd like to build. See [build.sh](/build.sh) for an example how to cross-compile.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Roman Kuraev}
🤔 💻

_dangr0
🐛

_DG
🤔 ⚠️

_{Nova_Max}
📖