Skip to content

Latest commit

 

History

History
59 lines (49 loc) · 3.14 KB

README.md

File metadata and controls

59 lines (49 loc) · 3.14 KB

PyPI - Version GitHub release (with filter) GitHub

Droneframe

A simple CLI tool to extract frames from drone footages with EXIF data included.

Installation

You can install DroneFrame from either from PyPI using pip or directly through GitHub releases.

Pip

$ pip install droneframe

GitHub

Install From Source

$ git clone https://github.com/anwaraliahmad/droneframe.git
$ cd droneframe 
$ pip install

Install From Release

  1. Navigate to releases page
  2. Download either .tar.gz or .whl
  3. Navigate to your download
$ pip install droneframe-version.<tar.gz or whl>

Running

Arguments

Argument/Option Description Flags Default Required
video Path to drone video file (.MP4) Yes
meta Path to metadata file (.SRT) -m, --meta Same pathname (sans file extension) as video No
frame_rate The rate for frame extraction -f, --frame_rate 30 No (but highly recommended)
output Target path to output folder (will generate a folder named after the video file there) -o, --output Working directory No
Help Display help message -h, --help

Example: Photogrammetry

Process

  1. Use droneframe to get frames filled with GPS & timestamp data.
$ droneframe path/to/DJI_001.MP4 -f 3 # Large drone video of subject.
  1. Import the generated ./DJI_001 folder into your photogrammetry software of choice.
  2. Enjoy your 3D recreation.

If constraints permit, you can always extract more with a higher framerate or generate an additional batch of frames from another video you have of the target.

End Result

Abandoned Railyard Flue

This is a model of an abandoned structure that was created by running droneframe and uploading the resulting frames onto WebODM Lightning for 3D reconstruction.

You can interact with the full model on Sketchfab

License

This project is licensed under the MIT License. See the LICENSE file for details.