Duplicate from uva-cv-lab/OmniShotCut

Co-authored-by: Boyang Wang <HikariDawn@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

OmniShotCut_ckpt.pth

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5948ea78e00626c0e6c5e742e64873ef872cf4a5071d2a0841aed51c3e686cfa
+size 164149963

README.md

@@ -0,0 +1,55 @@
+---
+license: mit
+tags:
+  - shot-boundary-detection
+  - scene-detection
+  - video
+  - transformer
+arxiv: 2604.24762
+---
+
+## OmniShotCut: Holistic Relational Shot Boundary Detection with Shot-Query Transformer
+
+**Authors:** Boyang Wang, Guangyi Xu, Jiahui Zhang, Zhipeng Tang, Zezhou Cheng  
+**Affiliation:** UVA Computer Vision Lab
+
+[![Project Page](https://img.shields.io/badge/Project%20Page-333399.svg?logo=homepage)](https://uva-computer-vision-lab.github.io/OmniShotCut_website/)
+[![Online Demo](https://img.shields.io/badge/%F0%9F%A4%97%20OnlineDemo-276cb4.svg)](https://huggingface.co/spaces/uva-cv-lab/OmniShotCut)
+[![Code](https://img.shields.io/badge/Code-black.svg?logo=github)](https://github.com/UVA-Computer-Vision-Lab/OmniShotCut)
+[![arXiv](https://img.shields.io/badge/Arxiv-b5212f.svg?logo=arxiv)](https://arxiv.org/abs/2604.24762)
+
+OmniShotCut is a sensitive and informative shot boundary detector. It detects shot changes across diverse sources (anime, vlog, game, shorts, sports, screen recording, etc.) and recognizes Sudden Jumps and Transitions (dissolve, fade, wipe, ...) with a Shot-Query-based Video Transformer.
+
+## Model Zoo
+
+| Model | Description | Link |
+|-------|-------------|------|
+| **OmniShotCut v1.5** (recommended) | Hidden dim 576, 52.8M params. Best real-world quality: fewer false cuts on continuous camera motion / lighting changes, and better dense fast-cut recall. | [Download](https://huggingface.co/uva-cv-lab/OmniShotCut_v1.5) |
+| OmniShotCut (paper) | 3 encoders, 34.5M params. Reproduces the paper (Table 1) numbers. | [Download](https://huggingface.co/uva-cv-lab/OmniShotCut_paper) |
+| OmniShotCut (preview) | 6 encoders, 41M params. Early preview release. | [Download](https://huggingface.co/uva-cv-lab/OmniShotCut) |
+
+## Usage
+
+Install:
+```bash
+pip install git+https://github.com/UVA-Computer-Vision-Lab/OmniShotCut.git
+```
+
+Run shot boundary detection:
+```python
+import omnishotcut
+
+cut_model = omnishotcut.load("uva-cv-lab/OmniShotCut_v1.5", filename="OmniShotCut_ckpt.pth")
+ranges = cut_model.inference("video.mp4", mode="clean_shot")
+```
+
+## Citation
+
+```bibtex
+@article{wang2026omnishotcut,
+  title={OmniShotCut: Holistic Relational Shot Boundary Detection with Shot-Query Transformer},
+  author={Wang, Boyang and Xu, Guangyi and Zhang, Jiahui and Tang, Zhipeng and Cheng, Zezhou},
+  journal={arXiv preprint arXiv:2604.24762},
+  year={2026}
+}
+```

config.json

@@ -0,0 +1,19 @@
+{
+  "backbone": "resnet18",
+  "position_embedding": "sine",
+  "hidden_dim": 384,
+  "enc_layers": 6,
+  "dec_layers": 6,
+  "dim_feedforward": 2048,
+  "nheads": 8,
+  "dropout": 0.0,
+  "pre_norm": false,
+  "num_queries": 24,
+  "aux_loss": true,
+  "num_intra_relation_classes": 10,
+  "num_inter_relation_classes": 7,
+  "process_height": 96,
+  "process_width": 128,
+  "max_process_window_length": 100,
+  "weight_file": "OmniShotCut_ckpt.pth"
+}