Git Product home page Git Product logo

camerasdiscovery's Introduction

Cameras Discovery:

Camera Search

Image Credits: https://kintronics.com/ip-camera-systems-professional-versus-consumer-systems/

What is Cameras Discovery?

  • Idea is to convert it from a library to a quickly-digestible tool including some other handy services & discovery options.
  • Support for searching via other mechanicsms like UPnP,mdns,port number based to get list of all potential cameras.

Features?

  • DiscoverCameras : discover cameras in your network. Supported scan types are Upnp, RTSP Port scan, Onvif.
  • GetMp4stream : gets you the rtsp or other similar url to web play-able mp4 stream.
  • Probestream : Probe a stream by giving URL as parameter. ffprobe response is returend as json giving details like
  • Stream-ops : Pass a streamURL,
    • Save the video file from stream locally.
    • Respond with html video tag playable stream. (via /mp4stream)
    • Save the video file from stream on cloud.
    • Get Image file from stream as Response. (One shot usage)
    • Get Image Steam from given stream as Response. (BULK USAGE)
    • Restream the resource locally or on cloud.
    • Access the stream via websocket.
    • Access the stream on HLS.
  • Health check call for camera via strategies:

Running:

  • Run docker directly:
docker run --rm --name=camerasdiscovery -p 8000:8000 --network host saurabhshandy/camerasdiscovery
#OR 
bash run.sh
  • Only Pullling docker image
docker pull saurabhshandy/camerasdiscovery

Dockerhub : Link

Routes with Input & Output:

List of Routes:

  • /discoverCameras : discover cameras in your network.

    Code: 

    curl --request GET \
--url http://localhost:8000/v1/rpc/discoverCameras \
--header 'content-type: application/json'

    Sample Output: 

    {
  "status": "success",
  "data": [
    {
      "urn": "urn:uuid:xxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
      "name": "IPCAM",
      "hardware": "HS-Camera",
      "location": "Country:[China]",
      "types": [
        "_0:NetworkVideoTransmitter"
      ],
      "xaddrs": [
        "http://192.168.x.y:port/onvif/device_service"
      ],
      "scopes": [
        "onvif://www.onvif.org/type/NetworkVideoTransmitter",
        "onvif://www.onvif.org/location/Country:[China]",
        "onvif://www.onvif.org/name/IPCAM",
        "onvif://www.onvif.org/hardware/HS-Camera"
      ]
    },
    {
      "urn": "urn:uuid:xxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
      "name": "Avantgarde-Test",
      "hardware": "PL1234",
      "location": "shenzhen",
      "types": [
        "dn:NetworkVideoTransmitter"
      ],
      "xaddrs": [
        "http://192.168.x.y:36000/onvif/device_service"
      ],
      "scopes": [
        "onvif://www.onvif.org/type/video_encoder",
        "onvif://www.onvif.org/type/ptz",
        "onvif://www.onvif.org/type/audio_encoder",
        "onvif://www.onvif.org/hardware/PL1234",
        "onvif://www.onvif.org/name/Avantgarde-Test",
        "onvif://www.onvif.org/location/shenzhen"
      ]
    }
  ]
}

  • /mp4stream : Returns a web play-able mp4 stream so that you can embed this as src in your video element and play the video simply. The request takes 3 params.

    • camerastream : pass uriencoded(EncodeURIComponent) stream link; ex: rtsp://192.168.x.y/live/av0?user=myuser&passwd=mypassword
    • ttl: time duration for which you want the stream to be running in seconds; ex: 600s i.e 10minutes.
    • width: the width of the video you want; ex: 720 pixels. ffmpeg conversion in the function takes care of the above params to give you html video tag embeddable video off the bat.
    Code: 

    curl --request GET \
--url http://localhost:8000/v1/rpc/mp4stream?camerastream=rtsp%3A%2F%2F192.168.x.y%2Flive%2Fav0%3Fuser%3Dmyuser%26passwd%3Dmypassword&ttl=600&width=720 \

    Sample Output: 

    

    

    • 

  • 

    /streamops : Do operations on video stream/file like saving it locally/cloud or restream it.
    

    

Code: 


    

      curl --request POST \
    --url http://localhost:8000/v1/rpc/streamops \
    --header 'content-type: application/json' \
    --data '{
    "url" : "rtsp://192.168.x.y/live/av0?user=myuser&passwd=mypassword",
    "type" : "local",
    "saveOptions" :{
      "filename" : "myfile",
      "maxfilesize" : "100M",
      "duration": "10"
    },
    "videostreamOptions" :{
      "enabled" : true,
      "restream" : false,
      "fps" : "auto",
      "videosize" : "1280x720",
      "codec" : "mpeg1video",
      "transport":"tcp",
      "format" : "mpegts"
    },
    "audiostreamOptions" :{
      "enabled" : false
    }
  }'
    

    

    

    

Sample Output: 


    

    {
  "url": "rtsp://192.168.1.99/live/av0?user=myusename&passwd=mypassword",
  "requestID": "b3efd892-fe9f-4813-b5fe-09a2a4c958b0",
  "type": "localfilepath",
  "saveOptions": {
    "filename": "myfile",
    "maxfilesize": "100M"
  },
  "videostreamOptions": {
    "enabled": true,
    "restream": "public stream URL",
    "fps": "auto",
    "videosize": "1280x720",
    "codec": "mpeg1video",
    "transport": "tcp",
    "format": [
      "mpegts"
    ]
  },
  "audiostreamOptions": {
    "enabled": false
  }
}
    

    

    

    • 

  • 

    /probestream : Do a ffprobe on the given stream.
    

    

Code: 


    

    curl --request POST \
  --url http://localhost:8000/v1/rpc/probestream \
  --header 'content-type: application/json' \
  --data '{
  "url" : "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}'
    

    

    

    

Sample Output: 


    

    {
  "streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
      "profile": "Baseline",
      "codec_type": "video",
      "codec_time_base": "1/50",
      "codec_tag_string": "[0][0][0][0]",
      "codec_tag": "0x0000",
      "width": 1280,
      "height": 720,
      "coded_width": 1280,
      "coded_height": 720,
      "has_b_frames": 1,
      "sample_aspect_ratio": "0:1",
      "display_aspect_ratio": "0:1",
      "pix_fmt": "yuvj420p",
      "level": 31,
      "color_range": "pc",
      "color_space": "bt709",
      "color_transfer": "bt709",
      "color_primaries": "bt709",
      "chroma_location": "left",
      "field_order": "progressive",
      "timecode": "N/A",
      "refs": 1,
      "is_avc": "false",
      "nal_length_size": 0,
      "id": "N/A",
      "r_frame_rate": "25/1",
      "avg_frame_rate": "25/1",
      "time_base": "1/90000",
      "start_pts": 21600,
      "start_time": 0.24,
      "duration_ts": "N/A",
      "duration": "N/A",
      "bit_rate": "N/A",
      "max_bit_rate": "N/A",
      "bits_per_raw_sample": 8,
      "nb_frames": "N/A",
      "nb_read_frames": "N/A",
      "nb_read_packets": "N/A",
      "disposition": {
        "default": 0,
        "dub": 0,
        "original": 0,
        "comment": 0,
        "lyrics": 0,
        "karaoke": 0,
        "forced": 0,
        "hearing_impaired": 0,
        "visual_impaired": 0,
        "clean_effects": 0,
        "attached_pic": 0,
        "timed_thumbnails": 0
      }
    },
    {
      "index": 1,
      "codec_name": "pcm_alaw",
      "codec_long_name": "PCM A-law / G.711 A-law",
      "profile": "unknown",
      "codec_type": "audio",
      "codec_time_base": "1/8000",
      "codec_tag_string": "[0][0][0][0]",
      "codec_tag": "0x0000",
      "sample_fmt": "s16",
      "sample_rate": 8000,
      "channels": 1,
      "channel_layout": "unknown",
      "bits_per_sample": 8,
      "id": "N/A",
      "r_frame_rate": "0/0",
      "avg_frame_rate": "0/0",
      "time_base": "1/8000",
      "start_pts": 0,
      "start_time": 0,
      "duration_ts": "N/A",
      "duration": "N/A",
      "bit_rate": 64000,
      "max_bit_rate": "N/A",
      "bits_per_raw_sample": "N/A",
      "nb_frames": "N/A",
      "nb_read_frames": "N/A",
      "nb_read_packets": "N/A",
      "disposition": {
        "default": 0,
        "dub": 0,
        "original": 0,
        "comment": 0,
        "lyrics": 0,
        "karaoke": 0,
        "forced": 0,
        "hearing_impaired": 0,
        "visual_impaired": 0,
        "clean_effects": 0,
        "attached_pic": 0,
        "timed_thumbnails": 0
      }
    }
  ],
  "format": {
    "filename": "rtsp://192.168.x.y/live/av0?user=myuser&passwd=mypassword",
    "nb_streams": 2,
    "nb_programs": 0,
    "format_name": "rtsp",
    "format_long_name": "RTSP input",
    "start_time": 0,
    "duration": "N/A",
    "size": "N/A",
    "bit_rate": "N/A",
    "probe_score": 100,
    "tags": {
      "title": "streamed by the Santachi RTSP server"
    }
  },
  "chapters": []
}
    

    

    

    • 

  • 

    /getstreams : Get rtsp stream URL for Onvif Cameras. Accepts list or single Onvif Object.
    

    

Code: 


    

    curl --request POST \
  --url http://localhost:8000/v1/rpc/getstreams \
  --header 'content-type: application/json' \
  --data '[
  {
  "xaddr" : "http://192.168.1.99:36000/onvif/device_service",
  "user" : "username",
  "pass" : "password"
  },
  {
  "xaddr" : "http://192.168.1.113:36000/onvif/device_service",
  "user" : "username",
  "pass" : "password"
  }
]'
    

    

    

    

Sample Output: 


    

    [
  {
    "xaddr": "http://192.168.1.113:36000/onvif/device_service",
    "user": "admin",
    "pass": "admin",
    "url": "rtsp://192.168.1.113:554/live/av0?user=admin&passwd=admin"
  },
  {
    "xaddr": "http://192.168.1.99:36000/onvif/device_service",
    "user": "admin",
    "pass": "admin",
    "url": "rtsp://192.168.1.99:554/live/av0?user=admin&passwd=admin"
  }
]
    

    

    

    • 

  • 

    /sampleurls : Don't have streams ?? This route will give you stuff to play around.
    

    

Code: 


    

    curl --request GET --url http://localhost:8000/v1/rpc/sampleurls
    

    

    

    

Sample Output: 


    
[sampleurls.json](https://github.com/beyondszine/camerasdiscovery/blob/master/routes/sampleurls.json)

    

    

    • 

  • 

    /getimage : Get only one image for the requested stream. (Don't abuse this route too much. For getting multiple snapshots in fast manner, use getimagestream).
    

    

Code: 


    

    curl --request POST \
  --url http://localhost:8000/v1/rpc/getimage \
  --header 'content-type: application/json' \
  --data '{
  "url" : "rtsp://192.168.x.y/live/av0?user=myuser&passwd=mypassword"
}'
    

    

    

    • 

  • 

    /getimagestream : This enables to get recurring images in case you want image stream.
    

    

Code: 


    

    ## Nothing yet.
    

    

    

    • 

  • 

    /liveliness : This method is to check the liveliness of the cameras. Three strategies are put in place.
    

    

Code:


    

      # req.body must be json of following schema
  {
    "strategy": "portknock",
    "camerasList": [{
      "address": "192.168.0.109",
      "port": 554
    }]
  }

  # response.body must of  
  [
    {
        "status": true,
        "address": "192.168.0.109",
        "port": 554
    }
  ]
    

    

    

    • 



Srcs:



 License


The MIT License (MIT)


Copyright (c) @ Saurabh Shandilya


Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.














camerasdiscovery's People




Contributors

beyondszine avatar
fabriciorsf avatar





Stargazers

 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar
 avatar





Watchers

 avatar
 avatar





Forkers

ikob6688
jawar1mx
fabriciorsf
samy1937
matrixhan
saothang5







camerasdiscovery's Issues





The routine `probestream` works fine, but the `discoverCameras` doesn't.



The routine probestream works fine, but the discoverCameras doesn't.


Follow the result from test:


> curl --request POST --url http://localhost:8000/v1/rpc/probestream --header 'content-type: application/json' --data '{\"url\" : \"rtsp://192.168.128.1:8554/cam\"}'
{"streams":[{"index":0,"codec_name":"h264","codec_long_name":"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10","profile":"High 4:2:2","codec_type":"video","codec_time_base":"1/60","codec_tag_string":"[0][0][0][0]","codec_tag":"0x0000","width":640,"height":480,"coded_width":640,"coded_height":480,"has_b_frames":0,"sample_aspect_ratio":"0:1","display_aspect_ratio":"0:1","pix_fmt":"yuv422p","level":30,"color_range":"unknown","color_space":"unknown","color_transfer":"unknown","color_primaries":"unknown","chroma_location":"left","field_order":"progressive","timecode":"N/A","refs":1,"is_avc":"false","nal_length_size":0,"id":"N/A","r_frame_rate":"30/1","avg_frame_rate":"30/1","time_base":"1/90000","start_pts":17219,"start_time":0.191322,"duration_ts":"N/A","duration":"N/A","bit_rate":"N/A","max_bit_rate":"N/A","bits_per_raw_sample":8,"nb_frames":"N/A","nb_read_frames":"N/A","nb_read_packets":"N/A","disposition":{"default":0,"dub":0,"original":0,"comment":0,"lyrics":0,"karaoke":0,"forced":0,"hearing_impaired":0,"visual_impaired":0,"clean_effects":0,"attached_pic":0,"timed_thumbnails":0}}],"format":{"filename":"rtsp://192.168.128.1:8554/cam","nb_streams":1,"nb_programs":0,"format_name":"rtsp","format_long_name":"RTSP input","start_time":0.191322,"duration":"N/A","size":"N/A","bit_rate":"N/A","probe_score":100,"tags":{"title":"Stream"}},"chapters":[]}

> curl --request GET --url http://localhost:8000/v1/rpc/discoverCameras --header 'content-type: application/json'
{"status":"success","data":[]}



Follow the log from camerasdiscovery docker running in a Windows 10 host Machine:


> docker run --rm --name=camerasdiscovery -p 8000:8000 saurabhshandy/camerasdiscovery
Requested URL to probe: rtsp://192.168.128.1:8554/cam
'successfully probed URL:'
probing finished!
POST /v1/rpc/probestream 200 12005.425 ms - 1357
Starting the discovery process.
GET /v1/rpc/discoverCameras 200 3001.606 ms - 30



The routine discoverCameras failed to discover the RTPS stream rtsp://192.168.128.1:8554/cam.















Recommend Projects


    

  • 

    • 

  • 

    

    

React photo
React


    

    A declarative, efficient, and flexible JavaScript library for building user interfaces.
    

    

    • 

  • 

    

    

Vue.js photo
Vue.js


    

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
    

    

    • 

  • 

    

    

Typescript photo
Typescript


    

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
    

    

    • 

  • 

    

    

TensorFlow photo
TensorFlow


    

    An Open Source Machine Learning Framework for Everyone
    

    

    • 

  • 

    

    

Django photo
Django


    

    The Web framework for perfectionists with deadlines.
    

    

    • 

  • 


    • 

  • 

    

    

D3 photo
D3


    

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉
    

    

    • 

  • 

    



    

    • 








Recommend Topics


    

  • 

    

    

javascript


    

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
    

    

    • 

  • 

    

    

web


    

    Some thing interesting about web. New door for the world.
    

    

    • 

  • 

    

    

server


    

    A server is a program made to process requests and deliver data to clients.
    

    

    • 

  • 

    

    

Machine learning


    

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
    

    

    • 

  • 


    • 

  • 

    

    

Game


    

    Some thing interesting about game, make everyone happy.
    

    

    • 

  • 



    • 








Recommend Org


    

  • 

    

    

Facebook photo
Facebook


    

    We are working to build community through open source technology. NB: members must have two-factor auth.
    

    

    • 

  • 

    

    

Microsoft photo
Microsoft


    

    Open source projects and samples from Microsoft.
    

    

    • 

  • 

    

    

Google photo
Google


    

    Google ❤️ Open Source for everyone.
    

    

    • 

  • 


    • 

  • 

    

    

D3 photo
D3


    

    Data-Driven Documents codes.
    

    

    • 

  • 


    • 

  • 



    •