first commit

README.md

@@ -0,0 +1,46 @@
+[![Build status](https://travis-ci.org/mpromonet/v4l2onvif.png)](https://travis-ci.org/mpromonet/v4l2onvif)
+[![CirusCI](https://api.cirrus-ci.com/github/mpromonet/v4l2onvif.svg)](https://cirrus-ci.com/github/mpromonet/v4l2onvif)
+[![Snap Status](https://snapcraft.io//v4l2onvif/badge.svg)](https://snapcraft.io/v4l2onvif)
+[![C/C++ CI](https://github.com/mpromonet/v4l2onvif/workflows/C/C++%20CI/badge.svg)](https://github.com/mpromonet/v4l2onvif/actions)
+
+[![Docker Pulls](https://img.shields.io/docker/pulls/mpromonet/v4l2onvif.svg)](https://hub.docker.com/r/mpromonet/v4l2onvif/)
+
+# v4l2-onvif
+
+   It is a try to implements an ONVIF server :
+   
+   * for V4L2 capture devices (NVT/NVS),
+   * for V4L2 output devices (NVD).
+   
+   The web services data binding is generated using [gSOAP](http://www.genivia.com/).
+
+## Build
+
+    make 
+
+## Usage
+
+    onvif-server.exe [-H http port] [-R rtsp port] [-u username] [-p password] [-i v4l2 input device] [-o v4l2 output device]
+
+    onvif-client.exe [-u username] [-p password] url
+
+
+Using Docker image
+===============
+You can start the application using the docker image :
+
+        docker run -p 8080:8080 -it mpromonet/v4l2onvif
+
+You can expose V4L2 devices from your host using :
+
+        docker run --device=/dev/video0 -p 8080:8080 -it mpromonet/v4l2onvif
+
+The container entry point is the onvif-server.exe application, then you can :
+
+* get the help using :
+
+        docker run -it mpromonet/v4l2onvif -h
+
+* run the container specifying some paramaters :
+
+        docker run --device=/dev/video0 -p 8080:8080 -it mpromonet/v4l2onvif -uadmin -padmin