Skip to main content

Processing Video Files

PeopleTracker can be used to programmatically process video files. The time required to process a video file depends on the machine's CPU Passmark score. See our benchmarks.

Process a Single Video​

To run PeopleTracker on a video file (e.g. mp4), specify the video filename.

  1. Make sure that the video file is stored within the PeopleTracker folder.
  2. For example, with the PeopleTracker directory c:\people and the file c:\people\Videos\my_video.mp4
  3. Edit url parameter in configurations file:
    url = /people-data/Videos/my_video.mp4
  4. After editing, start or restart the container
danger
  • If the configurations file is edited, the container needs to be restarted.
  • You can process a limited number of hours per month. View your current usage in the video column.

File Upload API​

If you need to check a variety of video files, so that you don't have to restart the container, you can use the PeopleTracker as webservice.

  1. Edit the camera url in your people-config.ini file and set:
    url = file-upload
  2. Run the container with -p 8081:80. For example:
docker run --restart="unless-stopped" -t --name people-tracker \
  -p 8081:80 \
  -v c:\users\kyt\documents\people:/people-data -e LICENSE_KEY=XXXXX -e TOKEN=YYYYY \
  platerecognizer/people-tracker
  1. Upload the video. Here's an example using CURL (not using curl? try this).
curl -F "upload=@/path/to/video.avi" http://localhost:8081
  1. Calling the file upload API will not return the prediction results. The JSON response from the call contains information about usage and indicates whether the file processing was successful.

Parameters​

The Upload API accepts sample parameter with the video upload, allowing modifications to the configurations for the video being uploaded without requiring a restart.

Examples​

To adjust the sample rate for a video, simply append your curl command with a sample form field like this: curl -F "upload=@/path/to/video.avi" -F "sample=3" http://localhost:8081

What is the meaning of "Connection reset by peer"?​

This error happens when PeopleTracker is not able to communicate a response to the client (the program uploading the video). This can happen if the client crashed or was stopped while uploading or waiting for a response. It is an indication that some of the data sent may not have been received. Check if the client is using a timeout.

Floating button icon
CTRL + .