Scorecard Generator—Help
Description
The Scorecard Generator creates a PDF scorecard populated with the starting lineup for both teams.
It also includes the team's active roster, optionally with detailed statistics.
I use this on my iPad to import the scorecard into GoodNotes, where I keep score.
Instructions
-
Select a date and league
Choose the day and league you’re interested in.
If no games are scheduled on that league-day you will be informed.
The tool was built with future use in mind, but scorecards for past games can be created as well.
For MLB games, this seems to work as far back as 2010 but not before.
-
Choose a game
You’ll see all scheduled games for that league-day.
Note that games are presented on the day that they are listed by the MLB API, so in some cases the game may occur on a different local-time date than the MLB date.
These cases are flagged.
Users will still need to select the "official" game date to find it, not the local date.
-
Preview the lineups
This checks whether both teams have announced their starting lineups.
It also presents the basic information that I use when scoring in my pocket-sized notebook, so it makes preparing that simpler.
If both teams have not yet posted their starting lineups, you will be informed.
If you wish, you will be able to proceed to generate a blank scorecard with the roster as of today and statistics computed up to today.
This is especially useful if you are generating the card the day of the game before lineups are posted:
the rosters and statistics will be correct, and you will just need to fill in the lineups.
-
Select options
Decide whether to include player stats and logos. More details below.
-
Generate the scorecard
A PDF will open in a new tab.
This might take a little while as the program collects statistics and passes the scorecard to the compiler.
Options
-
Detailed statistics
Adds season-to-date player statistics on the third page of the scorecard.
If not selected, only the roster will print on the third page.
While the user can change the start date and included game types for these statistics, the default is for the program to present regular season statistics for regular season games and postseason statistics for postseason games.
The user is presented with the start dates of the regular, pre- and post-seasons for reference.
The game type of the selected game is also presented for reference.
Note that game types are standardized to MLB regular season.
In some rare cases, however, the method to determine the cutoff date between the regular and postseason fails.
In this case, the default is to set the start date the start date of the regular season and include regular season and postseason games.
-
Statistics included are as follows:
-
Batting: Plate appearances, batting average, on-base percentage, slugging percentage, OPS, RBI, home runs, stolen bases
-
Pitching: Innings pitched, ERA, wins, losses, saves, save percentage, WHIP, strikeouts
-
On the main scorecard and in the rosters, whether or not detailed statistics are included, players' handedness is indicated by the color of their name, jersey number, and position.
Right-handers are listed in black, left-handers in blue, and switch hitters in red.
In rare cases where handedness cannot be determined (most common in spring training games where non-rostered players are in the lineup), the player is listed in purple.
-
Show logos
Adds team and league logos where available.
Links
Feedback and suggestions
Please send any feedback or suggestions to ariell@ariellzimran.com.
Copyright 2026 Ariell Zimran.
This application and its author are not affiliated with Major League Baseball or any MLB team. Use of MLB data is subject to the notice posted at http://gdx.mlb.com/components/copyright.txt
Logos from SportsLogos.net, Wikipedia, and team pages. LaTeX compilation via YtoTech. Portions of the code were written with the assistance of ChatGPT.
|