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.
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| droneframe-0.1.1.tar.gz | 7.3 kB | Without provenance | Details for droneframe-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| droneframe-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for droneframe-0.1.1-py3-none-any.whl |
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
|
Security for droneframe 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.