README template or just USAGE example

[d34db33f-1007]

hello! i've wrote example code of core features from this project, so you can just use it as a wiki. the snapshoting function now relies on PyAV library which costs additional 45MB when code compiled, but i'm in progress of writing my own h264 decoder in python3, which i would be glad to share either.

import socket
import traceback

from io import BytesIO
from PIL import Image
from av.packet import Packet
from av.codec.context import CodecContext

from dvrip.monitor import Stream
from dvrip.io import DVRIPClient


Status = {
		None: 0,
		'Wrong password': -1,
		'Banned': 2
	}

class XMEye:
	def __init__(self, ip=None, port=None):
		self.ip = ip
		self.port = port
		self.login = None
		self.password = None

	def auth(self, login, password):
		global Status

		self.Socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
		self.Socket.settimeout(4)
		self.conn = DVRIPClient(self.Socket)
		log_in = self.conn.connect((self.ip, self.port), login, password)
		return Status[log_in]

	def get_snapshot(self, ch):
		self.Socket2 = socket.create_connection((self.ip, self.port), 11)
		h264 = self.conn.monitor(self.Socket2, channel=ch, stream=Stream.HD)

		data = b''
		while True:
			if chunk := h264.read(1024):
				data += chunk
			if len(chunk) < 1024:
				break

		self.codec_264 = CodecContext.create("h264", "r")
		frame = self.codec_264.decode(Packet(data)):
#		frame[0].to_image().save(f'frame_{frame.index}.jpg')
		jpeg = BytesIO()
		frame[0].to_image().save(jpeg, format='JPEG')
		if ch == self.channels:
			self.conn.logout()
			self.Socket2.close()
		return jpeg.getvalue()

	def sys_info(self):
		info = self.conn.systeminfo()
		self.channels_count = int(info.videoin)
		self.model = f'{info.chassis}_{info.board}'
		try:
			ptz = self.conn.button(channel=0, button=PTZButton.MENU)
		except DVRIPRequestError:
			ptz = None
		if int(info.audioin) > 0 and ptz is None:
			self.model = f'{self.model}-Sound'
		elif ptz is not None:
			self.model = f'{self.model}-PTZ'
		return

#	def debug(self):
#		self.conn.keepalive()

[d34db33f-1007]

UPD: https://github.com/MasterNobody/x264 lightweight h264 decoder implementation which builds just in 2Mb

[d34db33f-1007]

UPD2: compiling custom version of ffmpeg and PyAV makes compiled binary about 8Mb. Makefile flags for ffmpeg:

./configure --enable-pic --disable-debug --enable-shared --disable-decoders --enable-decoder=h264 \ 
--disable-programs --disable-logging --disable-protocols --disable-avfoundation --disable-appkit \ 
--disable-coreimage --disable-iconv --disable-securetransport --disable-schannel \ 
--disable-safe-bitstream-reader --disable-large-tests --disable-doc --disable-postproc \ 
--disable-network --disable-encoders --disable-muxers --disable-parsers --enable-parser=h264 \ 
--enable-small --disable-runtime-cpudetect --disable-hwaccels --disable-demuxers --disable-devices

	# size in cost of perfomance:
		# --enable-small --disable-runtime-cpudetect --disable-hwaccels --disable-safe-bitstream-reader