blakeblackshear.frigate/frigate/http.py

382 lines
13 KiB
Python
Raw Normal View History

2020-11-25 03:36:56 +01:00
import base64
2020-11-16 14:27:56 +01:00
import datetime
2021-02-13 16:33:32 +01:00
import json
2020-11-09 14:32:30 +01:00
import logging
2020-11-01 15:06:15 +01:00
import os
2020-11-01 22:37:51 +01:00
import time
2020-11-16 14:27:56 +01:00
from functools import reduce
2020-11-01 22:37:51 +01:00
import cv2
2021-02-13 16:33:32 +01:00
import gevent
2020-11-01 22:37:51 +01:00
import numpy as np
2020-11-04 13:31:25 +01:00
from flask import (Blueprint, Flask, Response, current_app, jsonify,
make_response, request)
2021-02-13 15:09:44 +01:00
from flask_sockets import Sockets
2020-11-25 03:36:56 +01:00
from peewee import SqliteDatabase, operator, fn, DoesNotExist
2020-11-01 15:06:15 +01:00
from playhouse.shortcuts import model_to_dict
from frigate.const import CLIPS_DIR
2020-11-01 15:06:15 +01:00
from frigate.models import Event
from frigate.stats import stats_snapshot
from frigate.util import calculate_region
2020-12-19 13:51:10 +01:00
from frigate.version import VERSION
2020-11-01 15:06:15 +01:00
2020-11-25 17:37:41 +01:00
logger = logging.getLogger(__name__)
2020-11-01 15:06:15 +01:00
bp = Blueprint('frigate', __name__)
2021-02-13 15:09:44 +01:00
ws = Blueprint('ws', __name__)
2020-11-01 15:06:15 +01:00
2021-02-13 16:33:32 +01:00
class MqttBackend():
"""Interface for registering and updating WebSocket clients."""
def __init__(self, mqtt_client, topic_prefix):
self.clients = list()
self.mqtt_client = mqtt_client
self.topic_prefix = topic_prefix
def register(self, client):
"""Register a WebSocket connection for Mqtt updates."""
self.clients.append(client)
2021-02-13 16:54:20 +01:00
def publish(self, message):
2021-02-13 18:34:20 +01:00
try:
json_message = json.loads(message)
json_message = {
'topic': f"{self.topic_prefix}/{json_message['topic']}",
2021-02-16 05:10:20 +01:00
'payload': json_message['payload'],
2021-02-13 18:34:20 +01:00
'retain': json_message.get('retain', False)
}
except:
logger.warning("Unable to parse websocket message as valid json.")
return
logger.debug(f"Publishing mqtt message from websockets at {json_message['topic']}.")
self.mqtt_client.publish(json_message['topic'], json_message['payload'], retain=json_message['retain'])
2021-02-13 16:54:20 +01:00
2021-02-13 16:33:32 +01:00
def run(self):
def send(client, userdata, message):
"""Sends mqtt messages to clients."""
2021-02-13 16:54:20 +01:00
try:
2021-02-13 18:34:20 +01:00
logger.debug(f"Received mqtt message on {message.topic}.")
2021-02-13 16:54:20 +01:00
ws_message = json.dumps({
2021-02-13 17:50:36 +01:00
'topic': message.topic.replace(f"{self.topic_prefix}/",""),
2021-02-13 16:54:20 +01:00
'payload': message.payload.decode()
})
except:
# if the payload can't be decoded don't relay to clients
2021-02-13 18:34:20 +01:00
logger.debug(f"MQTT payload for {message.topic} wasn't text. Skipping...")
2021-02-13 16:54:20 +01:00
return
2021-02-13 16:33:32 +01:00
for client in self.clients:
2021-02-13 16:54:20 +01:00
try:
client.send(ws_message)
except:
2021-02-13 18:34:20 +01:00
logger.debug("Removing websocket client due to a closed connection.")
2021-02-13 16:54:20 +01:00
self.clients.remove(client)
2021-02-16 05:10:20 +01:00
2021-02-13 16:33:32 +01:00
self.mqtt_client.message_callback_add(f"{self.topic_prefix}/#", send)
def start(self):
"""Maintains mqtt subscription in the background."""
gevent.spawn(self.run)
def create_app(frigate_config, database: SqliteDatabase, stats_tracking, detected_frames_processor, mqtt_client):
2020-11-01 15:06:15 +01:00
app = Flask(__name__)
2021-02-13 15:09:44 +01:00
sockets = Sockets(app)
2020-11-01 15:06:15 +01:00
@app.before_request
def _db_connect():
database.connect()
@app.teardown_request
def _db_close(exc):
if not database.is_closed():
database.close()
2020-11-01 22:37:51 +01:00
app.frigate_config = frigate_config
app.stats_tracking = stats_tracking
2020-11-01 22:37:51 +01:00
app.detected_frames_processor = detected_frames_processor
2021-01-09 18:26:46 +01:00
2020-11-01 15:06:15 +01:00
app.register_blueprint(bp)
2021-02-13 15:09:44 +01:00
sockets.register_blueprint(ws)
2020-11-01 15:06:15 +01:00
2021-02-13 16:33:32 +01:00
app.mqtt_backend = MqttBackend(mqtt_client, frigate_config.mqtt.topic_prefix)
app.mqtt_backend.start()
2020-11-01 15:06:15 +01:00
return app
@bp.route('/')
def is_healthy():
return "Frigate is running. Alive and healthy!"
2020-11-18 04:11:19 +01:00
@bp.route('/events/summary')
def events_summary():
2021-01-16 16:26:26 +01:00
has_clip = request.args.get('has_clip', type=int)
has_snapshot = request.args.get('has_snapshot', type=int)
clauses = []
if not has_clip is None:
clauses.append((Event.has_clip == has_clip))
2021-01-26 16:04:03 +01:00
2021-01-16 16:26:26 +01:00
if not has_snapshot is None:
clauses.append((Event.has_snapshot == has_snapshot))
if len(clauses) == 0:
clauses.append((1 == 1))
2020-11-18 04:11:19 +01:00
groups = (
Event
.select(
2021-01-09 18:26:46 +01:00
Event.camera,
Event.label,
fn.strftime('%Y-%m-%d', fn.datetime(Event.start_time, 'unixepoch', 'localtime')).alias('day'),
2020-11-24 22:44:20 +01:00
Event.zones,
2020-11-18 04:11:19 +01:00
fn.COUNT(Event.id).alias('count')
)
2021-01-16 16:26:26 +01:00
.where(reduce(operator.and_, clauses))
2020-11-18 04:11:19 +01:00
.group_by(
2021-01-09 18:26:46 +01:00
Event.camera,
Event.label,
2020-11-24 22:44:20 +01:00
fn.strftime('%Y-%m-%d', fn.datetime(Event.start_time, 'unixepoch', 'localtime')),
Event.zones
2020-11-18 04:11:19 +01:00
)
)
return jsonify([e for e in groups.dicts()])
2020-11-24 22:44:59 +01:00
@bp.route('/events/<id>')
def event(id):
2020-11-25 03:36:56 +01:00
try:
return model_to_dict(Event.get(Event.id == id))
except DoesNotExist:
return "Event not found", 404
2021-01-16 18:34:09 +01:00
@bp.route('/events/<id>/thumbnail.jpg')
def event_thumbnail(id):
format = request.args.get('format', 'ios')
thumbnail_bytes = None
2020-11-25 03:36:56 +01:00
try:
event = Event.get(Event.id == id)
thumbnail_bytes = base64.b64decode(event.thumbnail)
2020-11-25 03:36:56 +01:00
except DoesNotExist:
2020-11-25 17:37:41 +01:00
# see if the object is currently being tracked
try:
for camera_state in current_app.detected_frames_processor.camera_states.values():
if id in camera_state.tracked_objects:
tracked_obj = camera_state.tracked_objects.get(id)
if not tracked_obj is None:
thumbnail_bytes = tracked_obj.get_thumbnail()
2020-11-25 17:37:41 +01:00
except:
return "Event not found", 404
2021-01-09 18:26:46 +01:00
if thumbnail_bytes is None:
2020-11-25 03:36:56 +01:00
return "Event not found", 404
2021-01-09 18:26:46 +01:00
# android notifications prefer a 2:1 ratio
if format == 'android':
jpg_as_np = np.frombuffer(thumbnail_bytes, dtype=np.uint8)
img = cv2.imdecode(jpg_as_np, flags=1)
thumbnail = cv2.copyMakeBorder(img, 0, 0, int(img.shape[1]*0.5), int(img.shape[1]*0.5), cv2.BORDER_CONSTANT, (0,0,0))
ret, jpg = cv2.imencode('.jpg', thumbnail, [int(cv2.IMWRITE_JPEG_QUALITY), 70])
thumbnail_bytes = jpg.tobytes()
2021-01-09 18:26:46 +01:00
response = make_response(thumbnail_bytes)
response.headers['Content-Type'] = 'image/jpg'
return response
2020-11-24 22:44:59 +01:00
@bp.route('/events/<id>/snapshot.jpg')
def event_snapshot(id):
jpg_bytes = None
try:
event = Event.get(Event.id == id)
if not event.has_snapshot:
return "Snapshot not available", 404
# read snapshot from disk
with open(os.path.join(CLIPS_DIR, f"{event.camera}-{id}.jpg"), 'rb') as image_file:
jpg_bytes = image_file.read()
except DoesNotExist:
# see if the object is currently being tracked
try:
for camera_state in current_app.detected_frames_processor.camera_states.values():
if id in camera_state.tracked_objects:
tracked_obj = camera_state.tracked_objects.get(id)
if not tracked_obj is None:
jpg_bytes = tracked_obj.get_jpg_bytes(
timestamp=request.args.get('timestamp', type=int),
bounding_box=request.args.get('bbox', type=int),
crop=request.args.get('crop', type=int),
height=request.args.get('h', type=int)
)
except:
return "Event not found", 404
except:
return "Event not found", 404
response = make_response(jpg_bytes)
response.headers['Content-Type'] = 'image/jpg'
return response
2020-11-01 15:06:15 +01:00
@bp.route('/events')
def events():
2020-11-16 14:27:56 +01:00
limit = request.args.get('limit', 100)
camera = request.args.get('camera')
label = request.args.get('label')
zone = request.args.get('zone')
2021-01-26 16:04:03 +01:00
after = request.args.get('after', type=float)
before = request.args.get('before', type=float)
has_clip = request.args.get('has_clip', type=int)
has_snapshot = request.args.get('has_snapshot', type=int)
include_thumbnails = request.args.get('include_thumbnails', default=1, type=int)
2020-11-16 14:27:56 +01:00
clauses = []
excluded_fields = []
2021-01-09 18:26:46 +01:00
2020-11-16 14:27:56 +01:00
if camera:
clauses.append((Event.camera == camera))
2021-01-09 18:26:46 +01:00
2020-11-16 14:27:56 +01:00
if label:
clauses.append((Event.label == label))
2021-01-09 18:26:46 +01:00
2020-11-16 14:27:56 +01:00
if zone:
clauses.append((Event.zones.cast('text') % f"*\"{zone}\"*"))
2021-01-09 18:26:46 +01:00
2020-11-16 14:27:56 +01:00
if after:
clauses.append((Event.start_time >= after))
2021-01-09 18:26:46 +01:00
2020-11-16 14:27:56 +01:00
if before:
clauses.append((Event.start_time <= before))
if not has_clip is None:
clauses.append((Event.has_clip == has_clip))
2021-01-26 16:04:03 +01:00
if not has_snapshot is None:
clauses.append((Event.has_snapshot == has_snapshot))
if not include_thumbnails:
excluded_fields.append(Event.thumbnail)
2020-11-16 14:27:56 +01:00
if len(clauses) == 0:
clauses.append((1 == 1))
events = (Event.select()
.where(reduce(operator.and_, clauses))
.order_by(Event.start_time.desc())
.limit(limit))
return jsonify([model_to_dict(e, exclude=excluded_fields) for e in events])
2020-11-01 15:06:15 +01:00
2020-11-18 04:11:19 +01:00
@bp.route('/config')
def config():
return jsonify(current_app.frigate_config.to_dict())
2020-12-19 13:51:10 +01:00
@bp.route('/version')
def version():
return VERSION
2020-11-18 04:11:19 +01:00
@bp.route('/stats')
2020-11-01 22:37:51 +01:00
def stats():
stats = stats_snapshot(current_app.stats_tracking)
2020-11-01 22:37:51 +01:00
return jsonify(stats)
@bp.route('/<camera_name>/<label>/best.jpg')
def best(camera_name, label):
2020-11-03 15:15:58 +01:00
if camera_name in current_app.frigate_config.cameras:
2020-11-01 22:37:51 +01:00
best_object = current_app.detected_frames_processor.get_best(camera_name, label)
best_frame = best_object.get('frame')
if best_frame is None:
best_frame = np.zeros((720,1280,3), np.uint8)
else:
best_frame = cv2.cvtColor(best_frame, cv2.COLOR_YUV2BGR_I420)
2021-01-09 18:26:46 +01:00
2020-11-01 22:37:51 +01:00
crop = bool(request.args.get('crop', 0, type=int))
if crop:
box = best_object.get('box', (0,0,300,300))
region = calculate_region(best_frame.shape, box[0], box[1], box[2], box[3], 1.1)
2020-11-01 22:37:51 +01:00
best_frame = best_frame[region[1]:region[3], region[0]:region[2]]
2021-01-09 18:26:46 +01:00
2020-11-01 22:37:51 +01:00
height = int(request.args.get('h', str(best_frame.shape[0])))
width = int(height*best_frame.shape[1]/best_frame.shape[0])
best_frame = cv2.resize(best_frame, dsize=(width, height), interpolation=cv2.INTER_AREA)
ret, jpg = cv2.imencode('.jpg', best_frame, [int(cv2.IMWRITE_JPEG_QUALITY), 70])
2020-11-01 22:37:51 +01:00
response = make_response(jpg.tobytes())
response.headers['Content-Type'] = 'image/jpg'
return response
else:
return "Camera named {} not found".format(camera_name), 404
@bp.route('/<camera_name>')
def mjpeg_feed(camera_name):
fps = int(request.args.get('fps', '3'))
height = int(request.args.get('h', '360'))
draw_options = {
'bounding_boxes': request.args.get('bbox', type=int),
'timestamp': request.args.get('timestamp', type=int),
'zones': request.args.get('zones', type=int),
'mask': request.args.get('mask', type=int),
'motion_boxes': request.args.get('motion', type=int),
'regions': request.args.get('regions', type=int),
}
2020-11-03 15:15:58 +01:00
if camera_name in current_app.frigate_config.cameras:
2020-11-01 22:37:51 +01:00
# return a multipart response
return Response(imagestream(current_app.detected_frames_processor, camera_name, fps, height, draw_options),
2020-11-01 22:37:51 +01:00
mimetype='multipart/x-mixed-replace; boundary=frame')
else:
return "Camera named {} not found".format(camera_name), 404
@bp.route('/<camera_name>/latest.jpg')
def latest_frame(camera_name):
draw_options = {
'bounding_boxes': request.args.get('bbox', type=int),
'timestamp': request.args.get('timestamp', type=int),
'zones': request.args.get('zones', type=int),
'mask': request.args.get('mask', type=int),
'motion_boxes': request.args.get('motion', type=int),
'regions': request.args.get('regions', type=int),
}
2020-11-03 15:15:58 +01:00
if camera_name in current_app.frigate_config.cameras:
2020-11-01 22:37:51 +01:00
# max out at specified FPS
frame = current_app.detected_frames_processor.get_current_frame(camera_name, draw_options)
2020-11-01 22:37:51 +01:00
if frame is None:
frame = np.zeros((720,1280,3), np.uint8)
height = int(request.args.get('h', str(frame.shape[0])))
width = int(height*frame.shape[1]/frame.shape[0])
frame = cv2.resize(frame, dsize=(width, height), interpolation=cv2.INTER_AREA)
ret, jpg = cv2.imencode('.jpg', frame, [int(cv2.IMWRITE_JPEG_QUALITY), 70])
2020-11-01 22:37:51 +01:00
response = make_response(jpg.tobytes())
response.headers['Content-Type'] = 'image/jpg'
return response
else:
return "Camera named {} not found".format(camera_name), 404
2021-01-09 18:26:46 +01:00
def imagestream(detected_frames_processor, camera_name, fps, height, draw_options):
2020-11-01 22:37:51 +01:00
while True:
# max out at specified FPS
gevent.sleep(1/fps)
frame = detected_frames_processor.get_current_frame(camera_name, draw_options)
2020-11-01 22:37:51 +01:00
if frame is None:
frame = np.zeros((height,int(height*16/9),3), np.uint8)
width = int(height*frame.shape[1]/frame.shape[0])
frame = cv2.resize(frame, dsize=(width, height), interpolation=cv2.INTER_LINEAR)
ret, jpg = cv2.imencode('.jpg', frame, [int(cv2.IMWRITE_JPEG_QUALITY), 70])
2020-11-01 22:37:51 +01:00
yield (b'--frame\r\n'
b'Content-Type: image/jpeg\r\n\r\n' + jpg.tobytes() + b'\r\n\r\n')
2021-02-13 15:09:44 +01:00
@ws.route('/ws')
def echo_socket(socket):
2021-02-13 16:33:32 +01:00
current_app.mqtt_backend.register(socket)
2021-02-13 15:09:44 +01:00
while not socket.closed:
2021-02-13 16:54:20 +01:00
# Sleep to prevent *constant* context-switches.
2021-02-13 16:33:32 +01:00
gevent.sleep(0.1)
2021-02-13 16:54:20 +01:00
message = socket.receive()
if message:
current_app.mqtt_backend.publish(message)