---
title: README
emoji: ⚽
colorFrom: green
colorTo: yellow
sdk: static
pinned: false
---

# OpenSportsBall

Open-source, two-phone game recording for field sports. Two phones on a
dual-phone mount film the whole field. In the cloud the two videos are
synced and stitched into one panorama, a virtual camera follows the play,
and the result is rendered as a broadcast-style game video.

- **Website:** [opensportsball.com](https://opensportsball.com)
- **Phone app, website, API and infrastructure:** [OpenSportsBall/opensportsball](https://github.com/OpenSportsBall/opensportsball) (Apache-2.0)
- **Video pipeline:** [OpenSportsBall/opensportsball-processing](https://github.com/OpenSportsBall/opensportsball-processing) (AGPL-3.0)

## On Hugging Face

**[OpenSportsBall/bench](https://huggingface.co/datasets/OpenSportsBall/bench)**
holds the benchmark data for the processing pipeline: recorded game video,
ball labels, pitch maps and the standard ball models. It shows identifiable
players, so access is gated. Request it on the dataset page, and a
maintainer reviews each request by hand.

Contributions are welcome. Start with the processing repository's
[CONTRIBUTING.md](https://github.com/OpenSportsBall/opensportsball-processing/blob/main/CONTRIBUTING.md).