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
- Navigate to releases page
- Download either
.tar.gzor.whl - 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
- Use
droneframeto get frames filled with GPS & timestamp data.
$ droneframe path/to/DJI_001.MP4 -f 3 # Large drone video of subject.
- Import the generated
./DJI_001folder into your photogrammetry software of choice. - 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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| droneframe-0.1.1.tar.gz | 7.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|