https://github.com/knifa/osd-dump-tools
https://github.com/knifa/osd-dump-tools
Last synced: about 1 year 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 (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-02-07T09:55:44.000Z (over 3 years ago)
- Last Synced: 2025-03-30T03:51:11.204Z (about 1 year ago)
- Language: Python
- Size: 35.2 KB
- Stars: 11
- Watchers: 2
- Forks: 5
- 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 ...
```