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 original 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.

What about other organizations?

Right now, this website only supports Official Scoring Summaries from the Barbershop Harmony Society. Scoresheets from SingUnited 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 extracts PDF text with PDF.js, then parses everything in your browser. Nothing is uploaded to a server, and the parser produces downloadable CSV, JSON, pivot CSV, metadata, and Tremper Table files locally. 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 Frontend on GitHub

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!