https://github.com/knifa/osd-dump-tools

https://github.com/knifa/osd-dump-tools

Last synced: 5 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/knifa/osd-dump-tools
• Owner: Knifa
• License: gpl-3.0
• Created: 2022-09-23T08:59:32.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2023-02-07T09:55:44.000Z (over 1 year ago)
• Last Synced: 2023-04-11T08:02:52.916Z (over 1 year ago)
• Language: Python
• Size: 35.2 KB
• Stars: 9
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Hang on a minute!

This might not be what you need.

Give the [OSD Overlay Tool](https://knifa-develop.fpv.wtf/osd-overlay) a try first. It runs entirely in-browser on your own machine and will save you the effort of installing Python, etc.

This will [become part of the official configurator](https://github.com/fpv-wtf/wtfos-configurator/pull/243) soon.

# osd-dump tools

Overlays msp-osd recordings over video files.

### Requirements

- Windows users should [use WSL](https://learn.microsoft.com/en-us/windows/wsl/install).

- Python 3.8+ is required.

- ffmpeg is required.

  ```shell

  # Debian and friends

  $ sudo apt install ffmpeg

  # macOS

  $ brew install ffmpeg

  ```

### Setup

```shell

# Setting up a virtual environment is recommended, but not required.

python -m venv venv

source ./venv/bin/activate

# Install dependencies.

$ pip install -r requirements.txt

```

### Usage

- Place font files and video files in this directory.

```shell

# Check out the options.

$ python -m osd --help

  usage: __main__.py [-h] [--font FONT] [--wide] [--hd] video

  positional arguments:

    video        video file e.g. DJIG0007.mp4

  options:

    -h, --help   show this help message and exit

    --font FONT  font basename e.g. "font"

    --wide       is this a 16:9 video?

    --hd         is this an HD OSD recording?

    --fullhd     are you using full-hd or fake-hd in this recording?

# Convert your recording!

$ python -m osd --font font_inav --hd --wide DJIG0001.mp4

  INFO:__main__:loading OSD dump from DJIG0001.osd

  INFO:__main__:rendering 168 frames

  INFO:__main__:passing to ffmpeg, out as DJIG0001_with_osd.mp4

  ... etc ...

```