NAME

       sreview-detect - detect new files for SReview

SYNOPSIS

       sreview-detect [--verbose] [--day-finish] [--help]

DESCRIPTION

       sreview-detect is used to detect new files in the SReview input directory, and add them to the database.
       Additionally, sreview-detect will update the length (but not the other metadata) of files that already
       exist in the database. This makes it safe to run on input files that are still being written to.

       It is designed to be run from cron (or a similar scheduling system) on a regular basis. Care should be
       taken to not overload the server on which it runs; while at the same time it should run regularly enough
       so that review is not waiting for too long.

OPTIONS

   --verbose
       Produce verbose output. Will log which files are being examined.

       Defaults to on if the environment variable "KUBERNETES_PORT" exists, off otherwise.

   --day-finish
       Normally, "sreview-detect" migrates talks to the next state from "waiting_for_files" if there is enough
       content available to fill all the scheduled time for that talk (minus 5 seconds, to account for the fact
       that sometimes the video does not not exactly add up to the correct length). This is normally what you
       want, when cameras record continuously and content is uploaded in between breaks in talks.

       However, if the final talk of the day ends early, and the recording system is shut down immediately when
       the speaker stops speaking but before the scheduled time for the talk has arrived, then SReview will
       never see enough content for the talk to be considered "complete", and that final talk will remain stuck
       in the "waiting_for_files" state.

       To remedy this, use the "--day-finish" flag. This will migrate all talks that are still in the
       "waiting_for_files" state, but for which at least some content was found. This will correctly ignore
       talks that are scheduled for the next day, but will allow talks for which some content was found to move
       to the cutting state.

perl v5.36.0                                       2023-11-03                                 SREVIEW-DETECT(1p)