Skip to main content

Extract frames from drone footage along with their EXIF data.

Project description

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

<iframe title="Abandoned Railyard Flue" frameborder="0" allowfullscreen mozallowfullscreen="true" webkitallowfullscreen="true" allow="autoplay; fullscreen; xr-spatial-tracking" xr-spatial-tracking execution-while-out-of-viewport execution-while-not-rendered web-share src="https://sketchfab.com/models/3c92d642af34444dadc83f1d2d0dd07d/embed"> </iframe>

Abandoned Railyard Flue by anwaraliahmad on Sketchfab

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.

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

droneframe-0.1.1.tar.gz (7.3 kB view hashes)

Uploaded Source

Built Distribution

droneframe-0.1.1-py3-none-any.whl (8.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page