# What Happens When a Video Exceeds 10 Minutes in Claude-Video's Balanced Mode

> Discover what happens when a video exceeds 10 minutes in claude-video balanced mode. Learn about sparse-scan warnings and reduced accuracy. Get the details at bradautomates/claude-video.

- Repository: [bradautomates/claude-video](https://github.com/bradautomates/claude-video)
- Tags: how-to-guide
- Published: 2026-08-05

---

**When a video exceeds roughly 10 minutes in balanced mode, claude-video emits a sparse-scan warning and continues processing with limited frame coverage, potentially reducing analysis accuracy.**

The `bradautomates/claude-video` repository provides a video analysis tool that uses different detail modes to manage API token consumption. When using the default **balanced** mode, the system enforces a strict frame budget that creates coverage limitations when a video exceeds the 10-minute threshold.

## How the Frame Cap Works in Balanced Mode

In [`skills/watch/scripts/config.py`](https://github.com/bradautomates/claude-video/blob/main/skills/watch/scripts/config.py), the **balanced** detail mode configures a hard limit of **100 frames** via the `frame_cap("balanced")` setting. This cap exists to balance analysis depth against Claude API token costs.

When processing begins, the extraction logic distributes these 100 frames evenly across the video's duration. For short clips, this provides dense coverage; for longer content, the interval between sampled frames grows proportionally, creating gaps in the visual timeline.

## The 10-Minute Threshold and Warning Behavior

Once a video exceeds approximately 10 minutes, the frame budget spreads thinly enough to trigger the sparse-scan detection logic. At line 330 in [`skills/watch/scripts/watch.py`](https://github.com/bradautomates/claude-video/blob/main/skills/watch/scripts/watch.py), the script prints a warning similar to:

```text
Warning: This is a X-minute video. Frame coverage is sparse at this length.

```

According to the README at line 205, this warning indicates that "coverage thins out past ≈10 minutes" and signals that the script will proceed with a reduced sampling density. Processing continues, but downstream analysis may miss fine details due to the wide gaps between extracted frames.

## Mitigation Strategies for Long Videos

When a video exceeds the 10-minute threshold in balanced mode, you have three primary options to improve coverage:

**Focused Mode (`--start` / `--end`)**
Restrict analysis to a specific time window. This concentrates the 100-frame budget within a shorter duration, creating dense coverage for the segment of interest rather than spreading it thin across the full runtime.

**Token-Burner Mode (`--detail token-burner`)**
Remove the frame cap entirely. This mode keeps all scene-change frames regardless of video length, providing complete coverage at the cost of significantly higher token usage.

**Efficient Mode (`--detail efficient`)**
Switch to an even lower cap of **50 frames**. While this reduces coverage further, it may be acceptable for very long videos where only a rough overview is required and minimizing token costs is the priority.

## Practical Command Examples

The following commands demonstrate how to handle videos that exceed the balanced mode threshold:

```bash

# Default balanced mode on a 12-minute video triggers sparse-scan warning

watch https://youtu.be/abcdefg --detail balanced

# Focused 2-minute segment with dense frame coverage

watch https://youtu.be/abcdefg --detail balanced --start 02:00 --end 04:00

# Uncapped token-burner mode for full coverage (higher token cost)

watch https://youtu.be/abcdefg --detail token-burner

```

## Summary

- Balanced mode limits extraction to **100 frames** as defined in [`skills/watch/scripts/config.py`](https://github.com/bradautomates/claude-video/blob/main/skills/watch/scripts/config.py).
- Videos longer than **10 minutes** trigger a sparse-scan warning at [`skills/watch/scripts/watch.py`](https://github.com/bradautomates/claude-video/blob/main/skills/watch/scripts/watch.py) line 330.
- The warning indicates reduced accuracy potential but allows processing to continue.
- Use **focused mode** with `--start` and `--end` to concentrate frames on specific segments.
- Use **token-burner mode** to remove caps entirely for full-length analysis.
- Refer to the README at line 205 for official guidance on handling long-form content.

## Frequently Asked Questions

### What is the exact frame limit in balanced mode?

Balanced mode caps extraction at **100 frames** total, as configured in [`skills/watch/scripts/config.py`](https://github.com/bradautomates/claude-video/blob/main/skills/watch/scripts/config.py). This limit applies regardless of video resolution, frame rate, or bitrate.

### At what video length does the sparse warning typically trigger?

The warning appears when videos exceed approximately **10 minutes**, though the exact threshold depends on how the frame budget distributes across the specific content. The logic in [`watch.py`](https://github.com/bradautomates/claude-video/blob/main/watch.py) detects when the calculated interval between frames becomes large enough to potentially miss important scene changes.

### How can I analyze a full 30-minute video without sparse coverage?

Use **token-burner mode** by passing `--detail token-burner` to disable the frame cap entirely. This extracts all scene-change frames throughout the 30-minute duration, though it consumes significantly more API tokens than capped modes.

### Does efficient mode handle long videos better than balanced mode?

No. **Efficient mode** uses a lower cap of **50 frames**, making coverage even sparser than balanced mode on long videos. It is only appropriate when you need a rough overview of very long content and want to minimize token costs further.