Docs/Autoclipping

1.1 preview6 min read

Detection rules & diagnostics

Understand the analysis period, distinguish growth from ordinary busy chat and tune rules using real examples.

Find it in: ToolkitAutoclippingDetection / Diagnostics

What is an analysis period?

The analysis period is the recent rolling span of chat used by a rule. It is separate from the length of the saved clip. Activity growth compares it with the equally long period immediately before it.

Earlier period12 secondsEstablish a baseline
Recent period12 secondsCompare new activity
Two adjacent periods. Growth needs both, so this example learns for 24 seconds.

Activity growth: a useful starting rule

Required increase200% example
At least three times the earlier message count, not twice.
Minimum earlier messages8 example
A baseline floor avoids triggering on a jump from almost nothing.
Minimum recent messages20 example
The new period must contain meaningful activity.
Minimum recent chatters5 example
Several distinct people must contribute.
Activity growth rule with adjacent earlier and recent analysis periodsEnlarge
The UI shows both periods, the requirements and a worked example.

Use other rules deliberately

RuleHow it qualifiesWatch out for
Fixed activity targetMinimum recent messages and distinct authors.A consistently busy chat can qualify repeatedly; new profiles leave this off.
Repeated reactionA literal phrase shared across different authors.Choose a phrase that signals a moment, not routine chat.
Reaction varietySeveral configured phrases, each shared by at least two people.Routine mixed emotes can still be false positives.
Trusted commandsAn exact command token from configured usernames.Use channel overrides and give trust carefully.
Trusted command example
!clip Great final round

A configured trusted author can use the exact first token !clip. The remaining text becomes the title. A phrase rule uses whole-word boundaries; omg does not match omgggg.

Profiles, cooldowns and limits

Use a channel profile when different chats need different baselines. Each author's counted messages are capped, duplicate IDs are ignored and a condition must subside before it triggers again. Set per-channel cooldown and hourly limits, plus a shared hourly limit.

Read Diagnostics before lowering thresholds

  1. Check the source

    Confirm the intended chat is open, selected and actually receiving new messages.

  2. Check warmup and totals

    Wait for both complete periods. Read earlier/recent messages and distinct chatters.

  3. Check the reason

    A missing baseline, unmet threshold, cooldown, hourly limit, full queue or busy player can prevent an automatic output.

  4. Change one requirement

    Try the adjusted profile in test mode and inspect several results before enabling automatic saving.

Common questions

Does steady activity qualify as growth?

No. A large chat needs a relative increase over its previous period, as well as the baseline, volume and chatter floors.

Can reactions locate the exact video moment?

No. Viewers react after watching. Reaction delay estimates an earlier moment; it is not a video-analysis system.

Why did a repeated phrase count less than expected?

Distinct authors, literal boundaries, author caps and deduplication affect what counts. Initial and restored history are excluded.

Product screenshot

Written for version 1.1. Some controls may be unavailable in an earlier installed release. See release notes.