Skip to content

Commit f9e8978

Browse files
authored
Merge pull request #128 from All4Gis/develop
minor change
2 parents bd3d681 + 5048fb4 commit f9e8978

File tree

1 file changed

+62
-62
lines changed

1 file changed

+62
-62
lines changed

README.md

+62-62
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,48 @@
1-
# QGIS Full Motion Video (FMV) [#QGISFMV](https://twitter.com/hashtag/qgisfmv?f=live)
1+
# QGIS Full Motion Video (FMV) [#QGISFMV](https://twitter.com/hashtag/qgisfmv?f=live)
22

3-
[![Build Status](https://travis-ci.org/All4Gis/QGISFMV.svg?branch=master)](https://travis-ci.org/All4Gis/QGISFMV)
3+
[![Build Status](https://travis-ci.org/All4Gis/QGISFMV.svg?branch=master)](https://travis-ci.org/All4Gis/QGISFMV)
44
[![Project Stats](https://www.openhub.net/p/QGISFMV/widgets/project_thin_badge.gif)](https://www.openhub.net/p/QGISFMV)
55

66
## Donations
77

88
If this plugin is useful for you, consider to donate to the author.Want to buy me a beer (or gadget)? Please use Paypal button or contact me directly.
99

1010
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?button=donate&business=5329N9XX4WQHY&item_name=QGIS+FMV+Plugin&quantity=&amount=&currency_code=EUR&shipping=&tax=&notify_url=&cmd=_donations&bn=JavaScriptButton_donate&env=www)
11-
1211

1312
![](images/banner.png)
1413

1514
Plugin for **QGIS 3** which allows to analyze, visualize and process videos inside the QGIS environment. **QGIS FMV** accepts multiple video formats such as _mp4, ts, avi_, etc. It is also able to extract video frames, to capture the current frame, to plot bitrate and to observe the video metadata with aerial images and more. It also offers the possibility to create reports with video metadata.
1615

1716
Standards supported:
1817

19-
- "UAS Datalink Local Set", [MISB ST0601](http://www.gwg.nga.mil/misb/docs/standards/ST0601.17.pdf)
20-
- "Security Metadata Local Set", [MISB ST0102](https://gwg.nga.mil/misb/docs/standards/ST0102.12.pdf)
21-
- "Predator UAV Basic Universal Metadata Set", [MISB EG0104](https://gwg.nga.mil/misb/docs/eg/EG0104.4.pdf)
18+
- "UAS Datalink Local Set", [MISB ST0601](http://www.gwg.nga.mil/misb/docs/standards/ST0601.17.pdf)
19+
- "Security Metadata Local Set", [MISB ST0102](https://gwg.nga.mil/misb/docs/standards/ST0102.12.pdf)
20+
- "Predator UAV Basic Universal Metadata Set", [MISB EG0104](https://gwg.nga.mil/misb/docs/eg/EG0104.4.pdf)
2221

2322
## Table of Contents
2423

25-
- [Motivation](#motivation)
26-
- [Dependencies](#dependencies)
27-
- [For show video](#for-show-video)
28-
- [Usage](#usage)
29-
- [Recommended readings](#recommended-readings)
30-
- [Installation](#installation)
31-
- [Installation on Windows](#installation-on-windows)
32-
- [Installation on Ubuntu](#installation-on-ubuntu)
33-
- [Installation on Archlinux](#installation-on-archlinux)
34-
- [Slides](#slides)
35-
- [Mentions](#mentions)
36-
- [Screenshots](#screenshots)
37-
- [Features](#features)
38-
- [Contributing](#contributing)
24+
- [QGIS Full Motion Video (FMV) #QGISFMV](#qgis-full-motion-video-fmv-qgisfmv)
25+
- [Donations](#donations)
26+
- [Table of Contents](#table-of-contents)
27+
- [Motivation](#motivation)
28+
- [Dependencies](#dependencies)
29+
- [For show video](#for-show-video)
30+
- [Usage](#usage)
31+
- [Recommended readings](#recommended-readings)
32+
- [Installation](#installation)
33+
- [Installation on Windows](#installation-on-windows)
34+
- [Installation on Ubuntu](#installation-on-ubuntu)
35+
- [Installation on Archlinux](#installation-on-archlinux)
36+
- [Slides](#slides)
37+
- [Mentions](#mentions)
38+
- [Screenshots](#screenshots)
39+
- [Features](#features)
40+
- [Contributing](#contributing)
3941
- [Contributing Code](#contributing-code)
4042
- [Contributing translations](#contributing-translations)
41-
- [Contributors List](#contributors-list)
42-
- [License](#license)
43-
- [Donations](#donations)
44-
43+
- [Contributors List](#contributors-list)
44+
- [License](#license)
45+
4546
## Motivation
4647

4748
This development arises after observing that there was no free solution for the metadata extraction and video analysis in real time. All solutions are APIs or private tools such as
@@ -52,21 +53,21 @@ for this reason, I decided to develop this open source project and, this way, of
5253

5354
## Dependencies
5455

55-
* [FFMPEG](http://ffmpeg.org/download.html) : After downloading it, you should store it in an accessible folder and modify `settings.ini` with the corresponding path. For example `D://FFMPEG` or `/usr/bin/`
56+
- [FFMPEG](http://ffmpeg.org/download.html) : After downloading it, you should store it in an accessible folder and modify `settings.ini` with the corresponding path. For example `D://FFMPEG` or `/usr/bin/`
5657

57-
* [OpenCV](https://opencv.org/) : `python3 -m pip install opencv-python`
58+
- [OpenCV](https://opencv.org/) : `python3 -m pip install opencv-python`
5859

59-
* [opencv-contrib-python](https://pypi.org/project/opencv-contrib-python/) : `python3 -m pip install opencv-contrib-python`
60+
- [opencv-contrib-python](https://pypi.org/project/opencv-contrib-python/) : `python3 -m pip install opencv-contrib-python`
6061

61-
* [MatPlotLib](https://matplotlib.org/) : `python3 -m pip install matplotlib`
62+
- [MatPlotLib](https://matplotlib.org/) : `python3 -m pip install matplotlib`
6263

63-
* [Klvdata](https://github.com/paretech/klvdata) : customized version of this library. (No need to install it)
64+
- [Klvdata](https://github.com/paretech/klvdata) : customized version of this library. (No need to install it)
6465

6566
The plugin install automatically this requisites,but you can install it using on Windows and Linux:
6667

6768
`python3 -m pip install -r requirements.txt`
6869

69-
Here is a **settings.ini** sample [Linux](code/settings_linux_sample.ini) configuration file or [Windows](code/settings_win_sample.ini) sample.
70+
Here is a **settings.ini** sample [Linux](code/settings_linux_sample.ini) configuration file or [Windows](code/settings_win_sample.ini) sample.
7071
On windows you can find the **settings.ini** file at **C:\Users\<user name>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\QGIS_FMV**.
7172

7273
&#8593; [Back to top](#table-of-contents)
@@ -75,18 +76,18 @@ On windows you can find the **settings.ini** file at **C:\Users\<user name>\AppD
7576

7677
To see the video you need:
7778

78-
- **Linux**: install <a href="https://gstreamer.freedesktop.org/documentation/installing/on-linux.html" target="_blank">GStreamer dependencies</a>
79-
- **Window**: install LAV Filters (install <a href="https://github.com/Nevcairiel/LAVFilters/releases" target="_blank">DirectShow Media Decoders</a>)
80-
79+
- **Linux**: install <a href="https://gstreamer.freedesktop.org/documentation/installing/on-linux.html" target="_blank">GStreamer dependencies</a>
80+
- **Window**: install LAV Filters (install <a href="https://github.com/Nevcairiel/LAVFilters/releases" target="_blank">DirectShow Media Decoders</a>)
81+
8182
If everything works well the plugin should install these dependencies automatically in both, Windows and Linux.
8283

8384
&#8593; [Back to top](#table-of-contents)
8485

8586
## Usage
8687

8788
The use of this application is simple.
88-
It only needs a video with metadata, like for example one of these [(ESRI copyright)](https://drive.google.com/open?id=1-B2uaW7_cfYZohZYFozrgBhIaztI1MSP)
89-
Then, open the plugin where the "video manager" will be shown, open the video and with a double-click, the "player" will be opened.
89+
It only needs a video with metadata, like for example one of these [(ESRI copyright)](https://github.com/All4Gis/QGISFMV_Samples)
90+
Then, open the plugin where the "video manager" will be shown, open the video and with a double-click, the "player" will be opened.
9091
At this moment, you will see that new shapes have been added and you will see the platform position, metadata, etc.
9192

9293
If we don't have a MISB video we can create it from a video file and telemetry file from a DJI for example.
@@ -101,19 +102,18 @@ For more information about the Unmanned Air System (UAS) metadata from STANAG 46
101102

102103
![a](images/demux.png)
103104

104-
* <a href="https://gisgeography.com/full-motion-video-fmv/" target="_blank">What is Full Motion Video (FMV)?</a>
105-
* <a href="http://www.gwg.nga.mil/misb/faq.html" target="_blank">FAQ</a>
106-
* <a href="http://www.gwg.nga.mil/misb/docs/nato_docs/STANAG_4609_Ed3.pdf" target="_blank">STANAG_4609_Ed3</a>
107-
* <a href="https://nsgreg.nga.mil/doc/view?i=5471" target="_blank">ST0601.19</a>
108-
* <a href="http://www.gwg.nga.mil/misb/docs/standards/ST0902.1.pdf" target="_blank">ST0902.1</a>
105+
- <a href="https://gisgeography.com/full-motion-video-fmv/" target="_blank">What is Full Motion Video (FMV)?</a>
106+
- <a href="http://www.gwg.nga.mil/misb/faq.html" target="_blank">FAQ</a>
107+
- <a href="http://www.gwg.nga.mil/misb/docs/nato_docs/STANAG_4609_Ed3.pdf" target="_blank">STANAG_4609_Ed3</a>
108+
- <a href="https://nsgreg.nga.mil/doc/view?i=5471" target="_blank">ST0601.19</a>
109+
- <a href="http://www.gwg.nga.mil/misb/docs/standards/ST0902.1.pdf" target="_blank">ST0902.1</a>
109110

110111
&#8593; [Back to top](#table-of-contents)
111112

112113
## Installation
113114

114115
The installation can be done from the QGIS Python Plugins Repository or from the [zip](https://github.com/All4Gis/QGISFMV/releases).
115116

116-
117117
&#8593; [Back to top](#table-of-contents)
118118

119119
## Installation on Windows
@@ -150,35 +150,36 @@ You need to restart QGIS after this.
150150

151151
`sudo apt-get remove gstreamer1.0-vaapi`
152152

153-
154153
## Installation on Archlinux
155154

156-
_Archlinux installation :_
155+
_Archlinux installation :_
156+
157157
```
158-
pacman -S qgis python-matplotlib opencv ffmpeg
158+
pacman -S qgis python-matplotlib opencv ffmpeg
159159
```
160160

161161
_ Set FFmpeg path in $HOME/.local/share/QGIS/QGIS3/profiles/[profile_name]/python/plugins/QGIS_FMV/settings.ini _
162+
162163
```
163164
ffmpeg : "/usr/bin/"
164165
ffprobe : "/usr/bin/"
165166
```
166167

167168
## Slides
168169

169-
* [Official presentation](https://slides.com/franraga/qgis-fmv/fullscreen)
170-
* [SIG libre 2021 WorkShop](https://slides.com/franraga/sig-libre-2021/fullscreen)
171-
* [SIG libre 2021 Video (Spanish)](http://hdl.handle.net/10256.1/6237)
170+
- [Official presentation](https://slides.com/franraga/qgis-fmv/fullscreen)
171+
- [SIG libre 2021 WorkShop](https://slides.com/franraga/sig-libre-2021/fullscreen)
172+
- [SIG libre 2021 Video (Spanish)](http://hdl.handle.net/10256.1/6237)
172173

173174
&#8593; [Back to top](#table-of-contents)
174175

175176
## Mentions
176177

177-
* [Beyond imagery and Video](https://docs.google.com/presentation/d/1b9FVFcThSJJLq4Q31C9Yx3pEsconY3QxKPZ4sifIAu4/edit?usp=sharing)
178+
- [Beyond imagery and Video](https://docs.google.com/presentation/d/1b9FVFcThSJJLq4Q31C9Yx3pEsconY3QxKPZ4sifIAu4/edit?usp=sharing)
178179

179-
* [MXF Experimentation, Lessons Learned, *UK DSTL*]( https://drive.google.com/file/d/1bjLKzBc73wCrFiMkGFQDx2-w_JHf0fyf/view?usp=sharing)
180+
- [MXF Experimentation, Lessons Learned, _UK DSTL_](https://drive.google.com/file/d/1bjLKzBc73wCrFiMkGFQDx2-w_JHf0fyf/view?usp=sharing)
180181

181-
* [QGIS Mexico, FMV, Luis Gallardo](https://youtu.be/edk6sbNgiAw)
182+
- [QGIS Mexico, FMV, Luis Gallardo](https://youtu.be/edk6sbNgiAw)
182183

183184
If you want to add your presentation simply upload it or send me an email
184185

@@ -215,12 +216,12 @@ Want to work on the project? Any kind of contribution is welcome!
215216

216217
Follow these steps:
217218

218-
Fork the project.
219-
Create a new branch.
220-
Make your changes and write tests ( if is possible).
221-
Commit your changes to the new branch.
222-
Send a pull request.
223-
219+
Fork the project.
220+
Create a new branch.
221+
Make your changes and write tests ( if is possible).
222+
Commit your changes to the new branch.
223+
Send a pull request.
224+
224225
See before [FMV Coding Standards!](https://all4gis.github.io/QGISFMV/CodingStandards)
225226

226227
**NOTE:** If you are use Linux need install pyuic5 and transifex client to compile the UI.
@@ -245,7 +246,6 @@ For test stream feature you can simulate stream channel,like this:
245246

246247
`ffmpeg -i rtp://127.0.0.1:8888 -c copy -map 0:v? -map 0:a? -f rtp_mpegts rtp://127.0.0.1:8898 -map 0:d? -f data -`
247248

248-
249249
And **transifex** client:
250250

251251
`pip3 install transifex-client`
@@ -254,12 +254,12 @@ And **transifex** client:
254254

255255
pip install coveralls
256256
pip install pycodestyle
257-
257+
258258
autopep8 --in-place --aggressive --aggressive -v --recursive deploy/*.py --exclude="*gui/*"
259-
259+
260260
pycodestyle --ignore=E501 code/*.py --statistics --exclude=code/gui/*.py
261261
pycodestyle --ignore=E501,W504 deploy/*.py --statistics
262-
262+
263263
And thanks for your code.
264264

265265
![a](images/thanks.gif)
@@ -270,7 +270,7 @@ Contributions are welcome!
270270

271271
[transifex](https://www.transifex.com/all4gis/QGISFMV/)
272272

273-
### Contributors List
273+
### Contributors List
274274

275275
<!-- CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
276276
<!-- prettier-ignore-start -->
@@ -288,8 +288,8 @@ Contributions are welcome!
288288

289289
<!-- markdownlint-enable -->
290290
<!-- prettier-ignore-end -->
291-
<!-- CONTRIBUTORS-LIST:END -->
292291

292+
<!-- CONTRIBUTORS-LIST:END -->
293293

294294
## License
295295

0 commit comments

Comments
 (0)