Skip to main content

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.

Release files for droneframe 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for droneframe 0.1.1
File Size Uploaded
droneframe-0.1.1.tar.gz 7.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for droneframe 0.1.1
File Interpreter ABI Platform
droneframe-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 15.3 kB

Release files / droneframe-0.1.1.tar.gz

Download URL droneframe-0.1.1.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
550924f145077459a5fbfa187828fecae8a333dec4d309f72770dc03d27593f1
BLAKE2b-256 checksum
How to use checksums
8346d78e36b4282e4be27b28a3fa55e1a3694f3e47d24cb6e1b23548745c71ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.4

Release files / droneframe-0.1.1-py3-none-any.whl

Download URL droneframe-0.1.1-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fad9bfc6beb32c78fa8c384744de97a490ab9d279852885a9e3de2c6181c4696
BLAKE2b-256 checksum
How to use checksums
bb4eb6f059cc4082424ad02bbafe6c82f87a65f7dbeba6bee6feaf5410bf2d2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.4

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page