Skip to content

Cross-platform tool for rendering the flight controller OSD and SRT data from the Walksnail Avatar HD FPV system on top of the goggle or VRX recording

License

Notifications You must be signed in to change notification settings

avsaase/walksnail-osd-tool

Repository files navigation

Walksnail OSD Tool

Latest release Latest build Totally awesome

Cross-platform tool for rendering the flight controller OSD and SRT data from the Walksnail Avatar HD FPV system on top of the goggle or VRX recording.

image

Features

  • Easy to use graphical user interface.
  • Native installer for Windows, App bundle for MacOS.
  • Hardware-accelerated encoding powered by ffmpeg.
  • Choose between H.264 and H.265 codecs (more can be added later).
  • View basic information about the video, OSD, SRT and font files.
  • Preview OSD frames before rendering.
  • Automatically center the OSD or position it manually.
  • Render selected info from the SRT file.
  • Selectable output video bitrate (more encoder settings will be added later).
  • Upscale output video to 1440p for higher quality when uploading to YouTube.
  • Mask OSD items (demo).

Anything else? Open a feature request here.

Installation

Windows

Download and run the installer from the latest release.

MacOS

Download the app bundle for your processor architecture from the latest release and drag it to your Applications folder.

Instructions for running the first time

The MacOS binaries provided by this project are not signed with a "Developer ID Certificate". When you try to run the app for the first time you may get a warning from MacOS that it may be malicious software, the developer cannot be verified, it may be damaged, etc. Close the warning, go to System Settings -> Privacy & Security and click "Open Anyway". This should only be required the first time you open the app.

If you think this is annoying you can donate some money here so I can pay Apple for a developer account.

Linux

The project builds on Ubuntu in CI but I don't know enough about packaging for Linux to make release binaries. For now you need to build from source.

Building from source

  1. Install the Rust toolchain.
  2. Run cargo install --git https://github.com/avsaase/walksnail-osd-tool.git. The executable will be installed in $HOME/.cargo/bin/ and added to your path.
  3. To run the app you need the ffmpeg and ffprobe binaries in your path or placed next to the executable you just build.
  4. Run the app with walksnail-osd-tool.

Similar projects

  • kirek007/ws-osd-py: Python-based tool with GUI and CLI. No longer maintained in favor of this project but has a few features that this project currently lacks. Depending on your OS it can require some manual setup due to Python dependencies.
  • shellixyz/hd_fpv_video_tool: Rust-based CLI tool with support for with Walksnail and DJI. Mainly targets Linux and can be difficult to build from source on Windows and MacOS. Has some cool features like live playback of the DVR with OSD without rendering.

Disclaimer

This project is not affiliated with Walksnail/Caddx.