Section author: ACF (webmaster@acf-quizbowl.com)

Yellowfruit

Important

This documentation was sourced from the YellowFruit repository. See that site for the most up-to-date documentation.

🍌 YellowFruit is a desktop application designed for tracking tournament statistics. It supports complex tournament structures with multiple phases, pools, and tiebreakers.

Installation

Download the appropriate installer for your operating system from the YellowFruit GitHub releases page:

  • Windows: Use the .exe installer or download the win-unpacked.zip file and run YellowFruit.exe.

  • macOS: Use the .dmg or .app.zip files.

  • Linux: Use the AppImage file.

Getting Started

Launch YellowFruit after installation. The application guides you through setting up your tournament step by step.

1. Configure Tournament Basics

On the General page:

  • Enter tournament name, location, dates, and question set (optional).

  • Specify packet names for each round if applicable.

  • Set team and player attributes to display in reports (e.g., JV, UG designations).

2. Set Scoring Rules

On the Rules page:

  • Define point values for tossups, bonuses, and lightning rounds.

  • Configure bouncebacks, neg values, and other scoring mechanics.

  • Set maximum players per team and other game parameters.

Note: Scoring rules cannot be changed once games are entered.

3. Define the Tournament Schedule

On the Schedule page:

  • Choose from pre-configured templates for common tournament formats (4-54 teams).

  • Templates automatically handle team advancement between phases.

  • For custom schedules, manually define stages, pools, and rounds.

  • Add tiebreaker and finals stages as needed.

4. Add Teams and Rosters

On the Teams page:

  • Import teams from QBJ (Quizbowl Interchange Format) or SQBS files, or add manually.

    • QBJ files are generated by MODAQ.

  • Define team rosters with player names.

    • You can generate a roster JSON file using this QuizbowlReader page.

    • You can import the roster JSON file by selecting File → QBJ Schema → Import Teams and Rosters Only.

  • Assign teams to preliminary pools (snake seeding available for templates).

5. Enter Match Results

On the Games page:

  • Record tossup buzzes, bonus answers, and lightning round scores for each player.

  • View matches by round or by pool.

  • YellowFruit validates scores and provides warnings for potential errors.

6. Generate Statistics Reports

On the Stat Report page:

  • View live standings, individual player stats, team details, and round-by-round results.

  • Export all reports as HTML files for publication.

Tips for New Users