Skip to main content

A package to talk to p2p cameras

Project description


Class to retrieve camera images from cameras using the p2p protocol

First of all i just wrote it to work as a class, the original connection and retrieval process has been made by Jheyman in his videosurveillance script. I rewrote it to run as a class instead of an application.

So i had this chinese camera laying around, it had this feature that you could access it from outside your home without the need for port forwarding. However after a couple of years this brand dissappeared and with it their services so i couldn't connect to it outside of my own network using this app.

Which made owning this camera quite useless. But i had since gotten into Home Asssistant and got the idea to get it working in there since my instance ran locally so it should be able to access the camera.


import p2pcam
import cv2
import numpy as np

def saveFile(cam, jpeg):
    RGBImage = cv2.imdecode(np.fromstring(jpeg, dtype=np.uint8), cv2.IMREAD_COLOR)
    cv2.imwrite('image.jpg', RGBImage)

camera = p2pcam.P2PCam(<own ip>, <camera ip>)
saveFile(camera, camera.retrieveImage())

Methods and Variables


Any methods that may be useful.

camera.initialize() Set some variables and attempt to connect to the camera for the first time.

camera.retrieveImage() Retrieve a jpeg string from the camera.

camera.start() Start a while true loop staying connected, this will not do anything if onJpegReceived isn't set.

camera.loop() Start a while loop doing retrieveImage() until a socket error occurs.


Some variables you may want to set.

camera.horizontal_flip Flip camera horizontally. (if true requires numpy and cv2)

camera.vertical_flip Flip camera vertically. (if true requires numpy and cv2)

camera.addTimeStamp Add a timestamp to the image. (if true requires numpy and cv2)

camera.debug If true prints out some debugging information.

The port information will have to be set before initialisation.

camera.UDP_PORT_HOST Host udp port default: 5123

camera.UDP_PORT_TARGET Target udp port default: 5000

camera.SOCKET_TIMEOUT Sets the socket timeout in seconds.

camera.NB_FRAGMENTS_TO_ACCUMULATE How many packets to get a full image. If you put this number high you will get a higher quality image but it will take longer to retrieve. Default: 80

camera.onJpegReceived Callback that will be executed if a jpeg image is retrieved. first argument will be the camera class, the second argument will be the jpeg image string.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

p2pcam-0.0.3.tar.gz (7.6 kB view hashes)

Uploaded source

Built Distribution

p2pcam-0.0.3-py3-none-any.whl (8.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page