diff --git a/docs/README.md b/docs/README.md index bd4aded51..68b27e15a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,5 +1,10 @@ # Website -This website is built using [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator. +This website is built using [Docusaurus 3.5](https://docusaurus.io/docs), a modern static website generator. For installation and contributing instructions, please follow the [Contributing Docs](https://docs.frigate.video/development/contributing). + +# Development + +1. Run `npm i` to install dependencies +2. Run `npm run start` to start the website diff --git a/docs/docs/configuration/record.md b/docs/docs/configuration/record.md index e0e42f22f..fd7de42d0 100644 --- a/docs/docs/configuration/record.md +++ b/docs/docs/configuration/record.md @@ -154,7 +154,7 @@ Footage can be exported from Frigate by right-clicking (desktop) or long pressin ### Time-lapse export -Time lapse exporting is available only via the [HTTP API](../integrations/api.md#post-apiexportcamerastartstart-timestampendend-timestamp). +Time lapse exporting is available only via the [HTTP API](../integrations/api/export-recording-export-camera-name-start-start-time-end-end-time-post.api.mdx). When exporting a time-lapse the default speed-up is 25x with 30 FPS. This means that every 25 seconds of (real-time) recording is condensed into 1 second of time-lapse video (always without audio) with a smoothness of 30 FPS. diff --git a/docs/docs/configuration/snapshots.md b/docs/docs/configuration/snapshots.md index 50a6c5652..e6c260913 100644 --- a/docs/docs/configuration/snapshots.md +++ b/docs/docs/configuration/snapshots.md @@ -3,7 +3,7 @@ id: snapshots title: Snapshots --- -Frigate can save a snapshot image to `/media/frigate/clips` for each object that is detected named as `-.jpg`. They are also accessible [via the api](../integrations/api.md#get-apieventsidsnapshotjpg) +Frigate can save a snapshot image to `/media/frigate/clips` for each object that is detected named as `-.jpg`. They are also accessible [via the api](../integrations/api/event-snapshot-events-event-id-snapshot-jpg-get.api.mdx) For users with Frigate+ enabled, snapshots are accessible in the UI in the Frigate+ pane to allow for quick submission to the Frigate+ service. diff --git a/docs/docs/development/contributing.md b/docs/docs/development/contributing.md index a86b768ff..32fc13e1f 100644 --- a/docs/docs/development/contributing.md +++ b/docs/docs/development/contributing.md @@ -193,7 +193,7 @@ npm run test #### 1. Installation ```console -npm install +cd docs && npm install ``` #### 2. Local Development diff --git a/docs/docs/integrations/api.md b/docs/docs/integrations/api.md index db32af574..e69de29bb 100644 --- a/docs/docs/integrations/api.md +++ b/docs/docs/integrations/api.md @@ -1,542 +0,0 @@ ---- -id: api -title: HTTP API ---- - -A web server is available on port 5000 with the following endpoints. - -## Management & Information - -### `GET /api/config` - -A json representation of your configuration - -### `POST /api/restart` - -Restarts Frigate process. - -### `GET /api/stats` - -Contains some granular debug info that can be used for sensors in Home Assistant. - -Sample response: - -```json -{ - /* Per Camera Stats */ - "cameras": { - "back": { - /*************** - * Frames per second being consumed from your camera. If this is higher - * than it is supposed to be, you should set -r FPS in your input_args. - * camera_fps = process_fps + skipped_fps - ***************/ - "camera_fps": 5.0, - /*************** - * Number of times detection is run per second. This can be higher than - * your camera FPS because Frigate often looks at the same frame multiple times - * or in multiple locations - ***************/ - "detection_fps": 1.5, - /*************** - * PID for the ffmpeg process that consumes this camera - ***************/ - "capture_pid": 27, - /*************** - * PID for the process that runs detection for this camera - ***************/ - "pid": 34, - /*************** - * Frames per second being processed by Frigate. - ***************/ - "process_fps": 5.1, - /*************** - * Frames per second skip for processing by Frigate. - ***************/ - "skipped_fps": 0.0 - } - }, - /*************** - * Sum of detection_fps across all cameras and detectors. - * This should be the sum of all detection_fps values from cameras. - ***************/ - "detection_fps": 5.0, - /* Detectors Stats */ - "detectors": { - "coral": { - /*************** - * Timestamp when object detection started. If this value stays non-zero and constant - * for a long time, that means the detection process is stuck. - ***************/ - "detection_start": 0.0, - /*************** - * Time spent running object detection in milliseconds. - ***************/ - "inference_speed": 10.48, - /*************** - * PID for the shared process that runs object detection on the Coral. - ***************/ - "pid": 25321 - } - }, - "service": { - /* Uptime in seconds */ - "uptime": 10, - "version": "0.10.1-8883709", - "latest_version": "0.10.1", - /* Storage data in MB for important locations */ - "storage": { - "/media/frigate/clips": { - "total": 1000, - "used": 700, - "free": 300, - "mnt_type": "ext4" - }, - "/media/frigate/recordings": { - "total": 1000, - "used": 700, - "free": 300, - "mnt_type": "ext4" - }, - "/tmp/cache": { - "total": 256, - "used": 100, - "free": 156, - "mnt_type": "tmpfs" - }, - "/dev/shm": { - "total": 256, - "used": 100, - "free": 156, - "mnt_type": "tmpfs" - } - } - }, - "cpu_usages": { - "pid": { - "cmdline": "ffmpeg...", - "cpu": "5.0", - "cpu_average": "3.0", - "mem": "0.5" - } - }, - "gpu_usages": { - "gpu-type": { - "gpu": "17%", - "mem": "18%" - } - } -} -``` - -### `GET /api/version` - -Version info - -### `GET /api/ffprobe` - -Get ffprobe output for camera feed paths. - -| param | Type | Description | -| ------- | ------ | ---------------------------------- | -| `paths` | string | `,` separated list of camera paths | - -### `GET /api//ptz/info` - -Get PTZ info for the camera. - -## Camera Media - -### `GET /api/` - -An mjpeg stream for debugging. Keep in mind the mjpeg endpoint is for debugging only and will put additional load on the system when in use. - -Accepts the following query string parameters: - -| param | Type | Description | -| ----------- | ---- | ------------------------------------------------------------------ | -| `fps` | int | Frame rate | -| `h` | int | Height in pixels | -| `bbox` | int | Show bounding boxes for detected objects (0 or 1) | -| `timestamp` | int | Print the timestamp in the upper left (0 or 1) | -| `zones` | int | Draw the zones on the image (0 or 1) | -| `mask` | int | Overlay the mask on the image (0 or 1) | -| `motion` | int | Draw blue boxes for areas with detected motion (0 or 1) | -| `regions` | int | Draw green boxes for areas where object detection was run (0 or 1) | - -You can access a higher resolution mjpeg stream by appending `h=height-in-pixels` to the endpoint. For example `/api/back?h=1080`. You can also increase the FPS by appending `fps=frame-rate` to the URL such as `/api/back?fps=10` or both with `?fps=10&h=1000`. - -### `GET /api//latest.jpg[?h=300]` - -The most recent frame that Frigate has finished processing. It is a full resolution image by default. - -Accepts the following query string parameters: - -| param | Type | Description | -| ----------- | ---- | ------------------------------------------------------------------ | -| `h` | int | Height in pixels | -| `bbox` | int | Show bounding boxes for detected objects (0 or 1) | -| `timestamp` | int | Print the timestamp in the upper left (0 or 1) | -| `zones` | int | Draw the zones on the image (0 or 1) | -| `mask` | int | Overlay the mask on the image (0 or 1) | -| `motion` | int | Draw blue boxes for areas with detected motion (0 or 1) | -| `regions` | int | Draw green boxes for areas where object detection was run (0 or 1) | -| `quality` | int | Jpeg encoding quality (0-100). Defaults to 70. | - -Example parameters: - -- `h=300`: resizes the image to 300 pixels tall - -### `GET /api//