Contribute to OpenSpecs.video

Contribution Guidelines

Before You Begin

  • Check if the camera already exists in the database
  • Gather official specifications from manufacturer sources
  • Have technical manuals or spec sheets ready for reference
  • Familiarize yourself with the CineMath Camera Schema v2.7

Data Sources

We prioritize data accuracy. Please use these sources in order of preference:

  1. Official manufacturer specifications - Website, press releases
  2. Technical manuals - User manuals, service manuals
  3. Official spec sheets - PDF downloads from manufacturer
  4. Professional reviews - From reputable sources with testing data
  5. Third-party tests - Independent lab tests, measurements

Submission Process

1

Fork the Repository

Fork the OpenSpecs.video repository to your GitHub account

2

Create Camera JSON

Create a new JSON file in data/cameras/ following the schema

3

Validate Your Data

Run the validation script to ensure your JSON follows the schema

4

Submit Pull Request

Create a pull request with a clear description and source citations

Best Practices

  • Use exact values from official sources - don't round or estimate
  • Include all verification sources with URLs or document references
  • Use standardized format strings (e.g., "1920x1080" for resolution)
  • Fill in as many fields as possible - mark unknown fields as null
  • Double-check codec names against the schema enum values
  • Test your JSON with the validator before submitting

Ready to Contribute?

Start by checking our GitHub repository for open issues or cameras that need data.