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. The File Upload API does not return prediction results directly. The JSON response contains usage information and confirms whether file processing succeeded.

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.