SREVIEW-DETECT(1p)

💖 SREVIEW-DETECT 💖

okay bestie, gather round — this is the Perl user-doc page for sreview-detect, a lil script whose whole job is spotting new files for SReview and yeeting them into the database. 🦋

---

✨ NAME ✨

sreview-detect — detect new files for SReview 🔍💅

---

🌸 SYNOPSIS 🌸

sreview-detect [--verbose] [--day-finish] [--help] [--process-max=N]

---

👑 DESCRIPTION 👑

So like, sreview-detect is the one that goes looking for new files in the SReview input directory and adds them to the database. That's the main character job. ✨

But wait, there's more — it will also update the length of files that already exist in the database. And no, not the other metadata, just the length. Which is actually such a slay design choice, because it means it's safe to run on input files that are still being written to. Not me being paranoid about half-uploaded videos... it's fine, it's handled. 💀

It is designed to be run from cron (or some similar scheduling system) on a regular basis. But bestie, be careful — you don't want to overload the server it runs on. And at the same time (the duality of woman 😭) it should run often enough that review isn't waiting around forever. Balance, periodt.

---

💅 OPTIONS 💅

• --verbose — Produce verbose output. It will log which files are being examined. 👀

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

• --day-finish — Okay so normally, sreview-detect migrates talks to the next state from waiting_for_files if there's enough content available to fill all the scheduled time for that talk — minus 5 seconds, because sometimes the video does not exactly add up to the correct length. (Not the math being slightly off, we simply account for it. 💅)

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. Stuck. Trapped. Iconic behaviour, terrible outcome.

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. It 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. 🎀

• --process-max=N — Set the maximum number of files that will be processed in a single run; 0 means no limit. Defaults to 0.

🫶 Also there's --help, listed up in the synopsis, bestie — you know what that one does.

---

okay that's the whole page, no notes, 10/10, ate and left no crumbs 💖✨

This page came from perl v5.40.1, dated 2026-02-15. Bye bestie, go run it from cron! 🎀🦋🌈