PitchMetRx User Guide

1. Getting Started

Creating an Account

1. Navigate to the PitchMetRx login page.
2. Click "Create an account" below the sign-in form.
3. Fill in your registration details:
   • First Name, Last Name, Username
   • Email Address
   • Phone Number (used for optional SMS verification)
   • Password (must be 8+ characters with uppercase, lowercase, number, and special character)
4. Accept the Terms of Use and click Register.

Verifying Your Account

After registering, you will receive a verification email. Click the link in the email to activate your account. The link expires in 24 hours. If you don't see it, check your spam folder or click Resend Verification Email.

After email verification, you can optionally verify your phone number via SMS for additional account security.

Logging In

Enter your username (or email) and password, then click Sign In.

Password Recovery

• Forgot Password? — Click the link on the login page to receive a password reset email.
• Lost access to email? — Use the Recover Account option with your username and phone number.

2. Dashboard

After signing in, you land on the Dashboard — your home base for quick navigation.

Quick Actions

The dashboard provides four large action buttons to jump right into the app:

Button	Description
View My Pitchers	Browse and manage your pitcher roster
Start New Game	Begin tracking pitches for a new game
Manage Games	View scheduled, active, paused, and completed games
View Reports	Generate pitching analytics and reports

Dashboard Widgets

• Getting Started Guide — A progress tracker for new users: Add Pitchers, Track Games, View Analytics.
• Pitchers Preview — Shows your top 3 pitchers at a glance with an option to view all.
• Upcoming Events — Your next 5 scheduled games.
• Recent Activity — The latest games across all your pitchers.

3. My Pitchers

The My Pitchers page is where you manage your roster. Each pitcher card shows key stats at a glance: uniform number, throwing hand, team, BAA (Batting Average Against), and SLG% (Slugging Percentage).

Adding a Pitcher

1. Click the + Add Pitcher button.
2. Fill in the pitcher's details:
   • Name — Pitcher's full name
   • Team — Team name
   • Uniform Number — Jersey number
   • Throws — Left-handed (LH) or Right-handed (RH)
   • Avatar Color — Choose a color for the pitcher's avatar badge
   • Profile Photo — Upload an optional photo
3. Click Save.

Pitcher Details

Click on any pitcher card to view their individual dashboard, which includes:

• Recent game history
• Career statistics
• Pitch type breakdown
• Performance trends over time

Managing Pitch Types

Each pitcher has a set of pitch types used during game tracking. You can:

• View all pitch types assigned to a pitcher
• Add custom pitch types beyond the built-in defaults
• Edit or Delete existing custom pitch types

Built-in pitch types include: Fastball, Curveball, Change-up, Cutter, Knuckleball, Slider, Splitter, Slurve, and more — each available in Inside, Middle, and Outside variants.

4. Games

The Games page is your hub for managing all games across your pitchers.

Starting a Game

You have two options:

• Quick Start a Game — Jump right into live tracking.
• Schedule a Game — Add a game to your calendar for future tracking.

Game Setup

When starting a new game, enter:

1. Select Pitcher — Choose which pitcher is on the mound
2. Opponent — Enter the opposing team name
3. Home/Away — Designate home or visitor
4. Date & Time — (Optional) Set the game date
5. Starting Inning — Set the inning to begin tracking

Live Game Tracking

Once a game is active, you enter the Live Tracking Interface where you log every pitch:

1. Enter the Batter — Set the batter's number and handedness (LH/RH).
2. Select Pitch Type — Tap the pitch type thrown from the pitcher's assigned list.
3. Record the Outcome:
   • Strike (called, swinging, or foul)
   • Ball
   • Foul (with 2 strikes)
   • In Play (hit into the field)
4. For hits — classify the hit type:
   • GB — Ground Ball
   • LD — Line Drive
   • FB — Fly Ball
5. Mark the Spray Chart — Tap where the ball landed on the interactive field diagram.
6. MPH (optional) — Toggle on to log pitch velocity.

The system automatically tracks the ball-strike count, advances batters after outs, walks, or hits, and tallies statistics in real time.

Game Controls

Control	Description
Pause	Save progress and resume later
End Game	Complete the game and finalize stats
Undo	Step back through pitches if you make a mistake
Edit Pitch	Modify a previously logged pitch
Delete Pitch	Remove an incorrect pitch entry
Runs Against	Update the runs-allowed count

Resuming a Paused Game

Navigate to Games, find the paused game, and click Resume. All previous pitch data is preserved.

5. Game Reports & Analytics

After completing a game (or during a live game), PitchMetRx generates a detailed Game Report packed with statistics.

Overall Statistics

Metric	Description
Total Pitches	Total number of pitches thrown
Total Strikes	Number of strikes
Strike %	Percentage of pitches that were strikes
Runs Allowed	Runs scored against the pitcher
Hits Allowed	Total hits allowed
BAA	Batting Average Against
SLG%	Slugging Percentage
Strikeouts (K)	Total strikeouts
K%	Strikeout percentage
BB	Base on balls (walks)
BB%	Walk percentage
HBP	Hit by pitch
Batters Faced	Total batters faced
LH/RH Batters Faced	Breakdown by batter handedness
1st Pitch Strikes (FPS)	First-pitch strike count
FPS %	First-pitch strike percentage
2/3 %	Two-thirds credit percentage

Detailed Statistics

The right column breaks down outcomes further:

• Called Strikes, Fouls, Swing & Miss
• Total Hits (Singles, Doubles, Triples, Home Runs)
• Strikeout types (K Swinging vs. K Looking)
• Balls in Play (Ground Balls, Line Drives, Fly Balls) with percentages

BAA% by Pitch Count

A table showing Batting Average Against at every possible count (0-0 through 3-2), giving you insight into how the pitcher performs when ahead, behind, or even in the count.

Pitch Breakdown

A detailed table showing every pitch type thrown during the game with:

• Total thrown, Strikes, Strike %, Balls, HBP, Hits, Extra-base hits
• BAA, SLG%, WHIFF%, Freeze %
• GB%, LD%, FB% per pitch type

Filtering by Batter Handedness

Click "All Batters - Click to Filter LH/RH" to toggle between All Batters, Left-Handed Batters only, or Right-Handed Batters only.

6. Spray Charts

The Spray Chart provides a visual representation of where balls were hit into the field. Each hit is plotted on a field diagram with color-coded markers.

Reading the Spray Chart

• Red circles = Ground Balls (GB)
• Green diamonds = Line Drives (LD)
• Blue triangles = Fly Balls (FB)

Filtering the Spray Chart

You can filter the spray chart to view hits from:

• LH — Left-handed batters only
• RH — Right-handed batters only
• All — All batters combined

Click "Back to pitch type" to filter the spray chart by individual pitch type, allowing you to see where each specific pitch tends to get hit.

7. AI Game Summaries

Every completed game includes an AI-powered game summary that analyzes the pitcher's performance and highlights key takeaways.

The AI summary appears at the top of the Game Report in the Game Summary section. It provides:

• An overview of the pitcher's outing (e.g., pitches thrown, BAA, strike percentage)
• Most effective pitch identification
• Notable performance highlights (strikeouts, shut-down innings, etc.)
• Areas for improvement

Summaries are generated automatically and cached for fast access on repeat views. They update when pitch data changes.

8. Pitching Reports

The Pitching Reports page offers multiple report types beyond individual game reports.

Report Types

Report	Description
Lifetime Statistics	Aggregated stats across all games for a selected pitcher
Custom Date Range	Stats filtered to a specific time period
Post-Game Report	Detailed report for a single completed game
Mid-Game Report	Real-time stats during an active game

Lifetime & Date Range Reports

These reports include all the same statistics as the Game Report — but aggregated across multiple games. They are ideal for tracking season-long trends and overall performance.

Exporting Reports

All reports can be exported for sharing and record-keeping:

• PDF Download — A formatted, printable report with your pitcher's statistics
• CSV Download — Spreadsheet-friendly data for custom analysis
• Share PDF — Send the report via email or messaging

9. Wristband Cards Generator

The Wristband Cards Generator is a coaching tool for creating randomized play call cards — printed wristband cards worn by players during games. It supports two modes: Pitching (pitch type sequences for a pitcher) and Offense (offensive play call sequences for batters and baserunners).

Access the Wristband Cards Generator from the sidebar navigation.

Card Mode

Select the card type at the top of the page:

Mode	Purpose
Pitching	Generate cards with pitch type codes for the pitcher. Each cell on the card shows a pitch type code (e.g., FBM, CBO). The catcher or coach calls a number combination and the pitcher reads the corresponding pitch.
Offense	Generate cards with offensive play call codes (e.g., HIT, STL, SQWZ). The coach signals a number combination and the batter/runner reads the corresponding play.

Card & Grid Settings

Grid Size

Choose how many cells appear on the card. Each grid is arranged in two sections of three blocks each, with row numbers along the left and column numbers across the top of each block:

Grid Size	Total Cells
3 x 3	54 boxes
4 x 4	96 boxes
5 x 5 (default)	150 boxes
6 x 6	216 boxes

Card Size

Select the physical card dimensions for printing:

Size	Dimensions
2.25" × 4.25" (default)	Standard wristband card size
2.5" × 4.25"
2.5" × 4.5"
3" × 5"	Index card size
4" × 6"	Large card size
Custom	Enter your own height and width in inches

Primary Color

Choose a color for the card headers, row/column labels, and center banner. Select from predefined team colors (Dark Red, Red, Blue, Green, Yellow, Orange, Purple, Pink, Black, White, Gray, Navy, Maroon) or enter a Custom Color using the color picker. The text color on headers automatically adjusts for contrast against the selected primary color.

Banner Fields

The center banner on the card displays identifying information:

• Team Name — Appears on the banner for both Pitching and Offense cards
• Player Name — Pitcher's first name; shown on Pitching cards only
• Game Date — Displayed on the banner; defaults to today's date

Setting Up Pitching Cards

Option 1 — Load from a Pitcher

1. Select a pitcher from the Select Pitcher dropdown. The pitcher's assigned pitch types are automatically added to the card, and the player name and team name fields are pre-filled from the pitcher's profile.

Option 2 — Add Pitch Types Manually

1. Use the Select a Pitch Type dropdown to choose from the available baseball and softball pitch types (e.g., FBM - Fastball Middle, CBO - Curveball Outside, DBM - Dropball Middle).
2. Click Add to add the selected pitch type to the list.
3. Repeat for each pitch type you want on the card.

Configuring Each Pitch Type

Each pitch type row shows four controls:

Control	Description
Code	3-character pitch code (auto-uppercased). Edit to customize.
Description	Full pitch name shown on the coach's reference sheet.
Color	Background color for this pitch type's cells on the card. Choose from the predefined list or select Custom.
Times Shown slider	Controls what percentage of card cells are filled with this pitch. Drag right to increase frequency. If left at default (no manual adjustment), all pitches are distributed evenly across the card.

Pitch Type Actions

• Auto Colors — Automatically assigns a distinct color to each pitch type so they are visually distinguishable on the card.
• Clear Colors — Resets all pitch type cell colors to white, preserving codes, descriptions, and percentage settings.
• Clear All — Removes all pitch types from the list (requires confirmation).
• × button — Removes an individual pitch type row.

Setting Up Offense Cards

Adding Predefined Plays

The following predefined offensive plays are available:

Code	Description
HIT	Hit Away
SACB	Sac Bunt
BNT4H	Bunt 4 Hit
SQWZ	Squeeze
BNR	Bunt & Run
FAKEB	Fake Bunt
FB-ST	Fake Bunt Steal
STL	Steal
DSTL	Delayed Steal
H&R	Hit & Run
SH&H	Show & Hit
TAKE	Take - No Swing

Use the checkboxes to select the plays you want, then click Add Selected. Use Select All / Deselect All to quickly toggle all checkboxes, or click Add All to add every predefined play at once.

Adding Custom Plays

To add a play not in the predefined list:

1. Enter a Play Code (maximum 6 characters, auto-uppercased).
2. Enter a Description for the play.
3. Click Add Custom Play.

Configuring Each Offensive Play

Each play row has the same controls as pitch types: Code, Description, Color, and Times Shown slider. All fields are editable after adding.

• Auto Colors — Automatically assigns distinct colors to each offensive play.
• × button — Removes an individual play row.

Generating the Card

1. After configuring your pitch types or offensive plays, click Generate Card.
2. The system randomly distributes all codes across the grid cells. If a Times Shown percentage has been set for any pitch/play, that item appears proportionally more often; all remaining cells are divided evenly among items with no percentage set.
3. A card preview appears on screen showing the randomized grid. Each block has column numbers across the top and row numbers along the left edge. The center banner displays the team name, mode (PITCHING or OFFENSE), player name (pitching mode), and game date.
4. A Coach's Reference Sheet also appears below the card preview. It shows the complete list of codes with their full descriptions and colors — used by the coach to decode calls during the game.

Downloading Cards

After generating a card, two download buttons appear:

Button	Output
Download Cards as PDF	Exports the play call cards as a PDF formatted for US Letter paper (landscape). Multiple cards are nested per sheet to minimize paper usage. Cards are sized to the card size you selected.
Download Coach Sheet as PDF	Exports the coach's reference sheet as a PDF, listing every code and its description so the coaching staff knows what each number combination signals.

Saving and Loading Configurations

Configurations save your complete card setup — mode, grid size, card size, primary color, banner fields, all pitch types or plays with their colors and percentages, and the generated grid layout — so you can reload the exact same card for future games.

Saving a Configuration

1. The Configuration Name field is automatically suggested based on the card mode, player or team name, and game date (e.g., Pitching-Smith-05/05/2026). Edit the name if desired.
2. Click Save Configuration. The configuration is saved to your account on the server (when signed in) and also to your browser's local storage as a backup.
3. When you generate a new card from a previously loaded configuration, you will be prompted to save the new layout under a versioned name (e.g., Pitching-Smith-05/05/2026-1) so both layouts are preserved.

Loading a Configuration

1. Select a saved configuration from the Saved Configurations dropdown at the top of the page or from the Load Saved Cards dropdown in the settings panel.
2. Click Load. All settings and the previously saved grid layout are restored. If the configuration includes a saved grid, the exact card layout is restored — no re-randomization occurs.

Deleting a Configuration

1. Select the configuration from the dropdown.
2. Click Delete and confirm the prompt. The configuration is removed from both the server and local storage.

Resetting the Workspace

Click Reset All Settings to clear all pitch types or offensive plays, reset the card to factory defaults (5x5 grid, 2.25"×4.25" card, Dark Red primary color, Pitching mode), and clear the card preview. This action requires confirmation and cannot be undone.

Settings Persistence

Your current card settings (mode, grid size, card size, color, banner fields, and play list) are automatically saved to your browser's local storage whenever you make a change. They are restored the next time you open the Wristband Cards Generator, so you do not need to reconfigure from scratch each session.

10. Account & Billing

Account Settings

Access your account page from the sidebar navigation to:

• View/Update Profile — Edit your name, email, and contact info
• Change Password — Update your account password
• Verify Phone Number — Add or update SMS verification
• View Subscription Status — See your current plan (active, trialing, or canceled)

Subscription & Billing

PitchMetRx uses Stripe for secure payment processing. From the Account page you can:

• Subscribe — Choose a plan and complete checkout
• Manage Billing — Access the Stripe billing portal to:
  • View billing history and download invoices
  • Update your payment method
  • Change or cancel your subscription
  • View upcoming charges

An active subscription is required to access all features. Trial users have full access during the trial period. Canceled subscriptions retain access through the end of the current billing cycle.

11. How-To Videos

The How-To Videos page provides instructional video tutorials that walk you through key features of PitchMetRx. Access it from the sidebar under How-To Videos.

Topics covered include:

• Adding and managing pitchers
• Starting and tracking a game
• Reading and exporting reports
• Using the spray chart
• And more

12. Support

Need help? Access the Support page from the sidebar for:

• FAQ and troubleshooting
• Contact information
• Links to additional resources