Scoresheet Tools

About Scoresheet Tools

Hey there! Welcome to Scoresheet Tools, a simple yet powerful website designed to help you convert Barbershop Harmony Society Official Scoring Summaries into more usable formats. Whether you're a contest organizer, barbershop historian, or just a data enthusiast, this tool will make working with scoresheets easier and faster.

What does this site do?

Scoresheet Tools lets you upload your Barbershop Harmony Society Official Scoring Summary PDFs and quickly convert them into other formats. It supports original PDF scoresheets (not scans or images) in the new OSS format (not the old format that didn't, for example, show arrangers). You can convert to:

• CSV: Extracts the scoring table from the scoresheet, great for general spreadsheet use.
• JSON: Extracts the scoring table from the scoresheet, great for developers and data integration.
• Pivot CSV: Extracts the scoring table from the scoresheet, designed specifically for pivot table analysis.
• Metadata: Extracts other key information from the scoresheet, such as the panel, awards, draw, footnote, and more.
• Tremper Table: A simple tab-separated format of overall results, specifically designed for Steve Tremper's harmonet score archive ranked summaries.

Check out these sample outputs to see exactly what you get from each conversion, based on this sample scoresheet.

• CSV
• JSON
• Pivot CSV
• Metadata
• Tremper Table

What about other organizations?

Right now, this website only supports Official Scoring Summaries from the Barbershop Harmony Society. Scoresheets from Sweet Adelines International or other international barbershop organizations aren't currently supported—yet! Expanding to include more formats is definitely on the radar, so stay tuned.

How does it work?

Under the hood, Scoresheet Tools runs on a Python backend powered by tabula-py to extract table data from your PDF scoresheets. It runs as a lightweight Docker container deployed to AWS Lambda, so it's fast, scalable, and serverless. It's all open source—so if you're curious, want to make suggestions, or feel like contributing, check out the GitHub repo:

Scoresheet Tools Backend on GitHub

Your uploaded scoresheets are processed temporarily, and no data is saved or retained long-term. We take your privacy seriously.

Is it perfect?

Not quite! This site is very much a work in progress. It's been designed for simplicity, speed, and ease of use, but there might still be a few rough edges. If you encounter issues or have suggestions, your feedback is more than welcome!

Why did you make this?

I first developed this as part of another project I created, whosup.live. I needed a way to convert the scoresheets into a more usable format that I could quickly add for the self-scoring feature to compare yourself against the panel, and this was the best way I could think of to do it.

Thanks for using Scoresheet Tools—happy harmonizing!