Pensioner/shotplan

Dataset

7

stars

13

commits

1

linked in READMEs

Jul 19, 2026

updated

cinematic
multi-shot
shot-transition
video-generation

README

ShotPlan Training Dataset

Multi-shot video training data for ShotPlan: Cinematic Video Generation with Learnable Planning Token.

Contents

PathDescription
data/train_meta_16fps.json6,404 training samples (metadata + captions)
data/videos/V*_16fps.mp4549 source videos, re-encoded to 16 fps

Each sample is an 80-frame (5 s @ 16 fps) window over temporally contiguous shots of a source video, containing 1–3 hard cuts.

Metadata format

data/train_meta_16fps.json is a JSON list. Each record:

{
  "file_path": "videos/V000001_16fps.mp4",
  "start_frame": 102,
  "end_frame": 182,
  "cut_at": [26, 64],
  "type": "hardcut",
  "text": "Global caption ... Shot 1: <shot caption> Shot 2: <shot caption> ..."
}
FieldMeaning
file_pathVideo path relative to data/
start_frame / end_frameWindow boundaries in source-video frame indices (16 fps)
cut_atHard-cut positions in frames relative to start_frame
typeTransition type of this sample (hardcut)
textHierarchical caption: a global scene description followed by per-shot captions

Curation pipeline

Starting from the open-source VidEvent dataset (movie recap videos with naturally dense shot transitions):

  1. Standard preprocessing (subtitle and border removal), re-encoding to 16 fps.
  2. Shot boundary detection with TransNet V2, segmenting each video into shots.
  3. Sliding-window extraction of 5-second windows over contiguous shots (≥2 shots per window, ≥20 frames per shot).
  4. Semantic filtering with Gemini 2.5: only windows depicting a consistent event with stable scene context and subject continuity are kept.
  5. Hierarchical captioning with Gemini 2.5: one global description (environment, subjects, lighting) plus per-shot captions (action, camera viewpoint, motion).

Intended use

Training and evaluation of multi-shot / shot-transition-controllable video generation models. This is the dataset used to train the ShotPlan checkpoints listed above.

License and provenance

The videos are derived from the VidEvent dataset (Liang et al., 2025), which is publicly released for research at http://www.videvent.top. This derived dataset is distributed for non-commercial research purposes only, inheriting the terms of the original VidEvent release. If you use this data, please cite both ShotPlan and VidEvent, and comply with VidEvent's usage terms.

We sincerely thank the VidEvent authors for making their dataset publicly available.

@article{liang2025videvent,
  title={VidEvent: A Large Dataset for Understanding Dynamic Evolution of Events in Videos},
  author={Liang, Baoyu and Su, Qile and Zhu, Shoutai and Liang, Yuchen and Tong, Chao},
  journal={arXiv preprint arXiv:2506.02448},
  year={2025}
}

Contributors

Pensioner

13 commits

Pensioner/shotplan

Dataset

7

stars

13

commits

1

linked in READMEs

Jul 19, 2026

updated

cinematic
multi-shot
shot-transition
video-generation

README

ShotPlan Training Dataset

Multi-shot video training data for ShotPlan: Cinematic Video Generation with Learnable Planning Token.

Contents

PathDescription
data/train_meta_16fps.json6,404 training samples (metadata + captions)
data/videos/V*_16fps.mp4549 source videos, re-encoded to 16 fps

Each sample is an 80-frame (5 s @ 16 fps) window over temporally contiguous shots of a source video, containing 1–3 hard cuts.

Metadata format

data/train_meta_16fps.json is a JSON list. Each record:

{
  "file_path": "videos/V000001_16fps.mp4",
  "start_frame": 102,
  "end_frame": 182,
  "cut_at": [26, 64],
  "type": "hardcut",
  "text": "Global caption ... Shot 1: <shot caption> Shot 2: <shot caption> ..."
}
FieldMeaning
file_pathVideo path relative to data/
start_frame / end_frameWindow boundaries in source-video frame indices (16 fps)
cut_atHard-cut positions in frames relative to start_frame
typeTransition type of this sample (hardcut)
textHierarchical caption: a global scene description followed by per-shot captions

Curation pipeline

Starting from the open-source VidEvent dataset (movie recap videos with naturally dense shot transitions):

  1. Standard preprocessing (subtitle and border removal), re-encoding to 16 fps.
  2. Shot boundary detection with TransNet V2, segmenting each video into shots.
  3. Sliding-window extraction of 5-second windows over contiguous shots (≥2 shots per window, ≥20 frames per shot).
  4. Semantic filtering with Gemini 2.5: only windows depicting a consistent event with stable scene context and subject continuity are kept.
  5. Hierarchical captioning with Gemini 2.5: one global description (environment, subjects, lighting) plus per-shot captions (action, camera viewpoint, motion).

Intended use

Training and evaluation of multi-shot / shot-transition-controllable video generation models. This is the dataset used to train the ShotPlan checkpoints listed above.

License and provenance

The videos are derived from the VidEvent dataset (Liang et al., 2025), which is publicly released for research at http://www.videvent.top. This derived dataset is distributed for non-commercial research purposes only, inheriting the terms of the original VidEvent release. If you use this data, please cite both ShotPlan and VidEvent, and comply with VidEvent's usage terms.

We sincerely thank the VidEvent authors for making their dataset publicly available.

@article{liang2025videvent,
  title={VidEvent: A Large Dataset for Understanding Dynamic Evolution of Events in Videos},
  author={Liang, Baoyu and Su, Qile and Zhu, Shoutai and Liang, Yuchen and Tong, Chao},
  journal={arXiv preprint arXiv:2506.02448},
  year={2025}
}

Contributors

Pensioner

13 commits