Releases: davewalker5/CricketTracker
Release list
Version 1.3.0.0
This release introduces the first dedicated Analysis capability in Cricket Tracker.
The new Analysis tab builds on the existing match, result and innings-summary data to provide a small set of reports designed for a fan following and recording a competition for themselves.
The initial release includes:
- Team Summary
- Batting First vs Chasing
- Head-to-Head
The reports support the limited-overs formats currently modelled by Cricket Tracker:
- The Hundred
- Twenty20
- One Day International
Team Summary
The Team Summary report provides an overview of one team’s performance within a selected competition and season.
It includes:
- Matches played
- Wins, losses, ties and no-results
- Win percentage
- Runs scored and conceded
- Average innings scores
- Average wickets lost and taken
- Highest and lowest innings totals
- Record when batting first
- Eecord when chasing
- Largest and narrowest wins and defeats
- A chronological match history
Results are shown from the selected team’s perspective, making it easier to review how the team has performed across the competition.
Batting First vs Chasing
The Batting First vs Chasing report adds the first analysis designed specifically around the structure of a cricket match.
It can be used at either competition or team level and includes:
- Wins by teams batting first
- Wins by teams chasing
- Batting-first and chasing win percentages
- Average first-innings score
- Highest first-innings score
- Highest successful chase
- Lowest successfully defended total
- Team-specific records when setting or chasing a target
- A supporting table of analysed matches
Batting order is derived from the recorded innings rather than inferred from the result, home and away status or toss decision.
Head-to-Head
The Head-to-Head report compares two teams within a selected competition and season.
It includes:
- Matches played
- Wins by each team
- Ties and no-results
- Win percentages
- Total and average runs scored
- Average wickets lost
- Highest and lowest innings
- Batting-first and chasing records
- Largest and narrowest wins
- Highest successful chase
- Lowest successfully defended total
- A complete history of meetings
This provides a compact view of both the overall record and the individual matches behind it.
Format-Aware Analysis
The reports use a shared limited-overs analysis model while respecting differences between formats.
Scoring rates are displayed as:
- Runs per 100 balls for The Hundred
- Runs per over for T20 and ODI cricket
Rates are calculated from the number of balls faced, avoiding the common mistake of treating cricket over notation as a decimal value.
The reports do not combine unlike formats into a single statistical sample.
Incomplete and No-Result Matches
Analysis is calculated only where the recorded data supports the metric being shown.
For example:
- A completed result may still contribute to a team’s win-loss record when detailed innings data is unavailable
- An innings without a recorded ball count may contribute to score analysis but not scoring-rate analysis
- No-results are recorded separately and excluded from calculations where a decisive outcome is required
- Matches with ambiguous innings order are excluded from batting-first and chasing comparisons
This allows Cricket Tracker to make useful use of partially complete historical records without presenting unsupported statistics.
Scope
The Analysis tab uses match-level and innings-summary data already stored by Cricket Tracker.
It does not require:
- Ball-by-ball data
- Full scorecards
- Player batting or bowling records
- Partnerships
- Boundary analysis
- Predictive modelling
The intention is to provide a focused set of useful reports rather than turn Cricket Tracker into a general-purpose cricket statistics platform.
Looking Ahead
Possible future additions include:
- Team Form
- Venue analysis
- Toss decision analysis
- Score distributions
- All-season Head-to-Head analysis
- PDF report export
- Test cricket analysis
These will be considered separately once the initial reports have been used with a broader set of real competition data.
Version 1.2.0.0
This release expands Cricket Tracker beyond The Hundred with first-class support for Twenty20 and One Day cricket.
Competitions can now use distinct match formats and configurable rulesets while retaining compatibility with existing Hundred data.
Highlights
- Added built-in match formats for The Hundred, T20 and ODI cricket
- Added format-aware innings limits and cricket-over displays
- Added automatic result calculation for standard limited-overs matches
- Added support for revised allocations, externally supplied targets and DLS-labelled results
- Added ruleset-driven points and net run rate
- Extended CSV import and export for limited-overs data
- Added complete T20 and ODI sample datasets
Match Formats and Rulesets
Match format and competition rules are now modelled separately.
A match format defines the structure of a match, including:
- Default balls per innings
- Balls per over or scoring unit
- Wickets available per innings
- The way delivery progress is displayed
Competition rulesets continue to define competition-specific behaviour, including:
- Points for wins, ties, losses, abandonments and no results
- Whether standings and net run rate are enabled
- Table sorting order
- Whether tied results may stand
- Whether tie-break winners are allowed
- Whether revised targets may be recorded
This allows different competitions to share a format such as T20 while retaining their own points and standings rules.
Match and Innings Recording
Matches can now record:
- A scheduled delivery allocation
- A reduced or revised allocation
- An original target
- An externally supplied revised target
- A result method such as DLS
- A manual result override and its reason
Innings records now include a completion status, such as:
- Innings limit reached
- All out
- Target reached
- Declared complete
- Abandoned
- Incomplete
Input validation prevents negative scores and wickets, excessive wicket counts, and delivery totals beyond the applicable innings allocation.
Legal deliveries continue to be stored as whole ball counts. T20 and ODI progress is displayed using conventional cricket-over notation, while Hundred matches retain their existing ball-based display.
Automatic Results
Cricket Tracker can derive standard match results from completed innings, including:
- Wins by runs
- Wins by wickets
- Ties
- No results
- Abandoned matches
- Matches decided using an externally supplied revised target
The application records a result method such as DLS but does not calculate DLS targets itself.
Manual result overrides remain available for exceptional cases and are clearly identified in the interface.
Standings and Net Run Rate
League standings now use the selected competition ruleset when awarding points.
Net run rate is calculated from completed innings summaries when enabled. All-out innings use the applicable full delivery allocation.
Matches involving revised allocations or revised targets are excluded from net run rate because their competition-specific treatment cannot be derived reliably from innings summaries alone.
Import and Export
Match CSV files now support these optional fields:
scheduled_ballsrevised_ballstarget_runsrevised_target_runsresult_method
Innings CSV files now support:
innings_status
Existing Hundred CSV files remain compatible. When allocation fields are omitted, Cricket Tracker uses the default defined by the selected match format.
Self-contained T20 and ODI examples are included under data/samples.
User Interface Improvements
- Competition, match and innings editors are format-aware
- Match and innings views show the relevant format and delivery allocation
- Scores use the appropriate balls or overs presentation
- Filters support the newly added match formats
Compatibility
Existing Cricket Tracker databases are upgraded automatically when the application starts.
Existing Hundred competitions, matches, innings, imports and standings remain supported. Legacy records are associated with The Hundred format during migration where appropriate.
Supported Scope
Cricket Tracker now supports one-innings limited-overs competitions using:
- The Hundred
- Twenty20
- One Day cricket
The application does not currently support:
- Test or first-class cricket
- Matches with multiple innings per team
- Ball-by-ball scoring
- Automatic DLS calculation
- Competition-specific tie-break simulations such as Super Overs
Version 1.1.0.0
The first tagged release of Cricket Tracker establishes the application as a local-first tool for recording and exploring cricket competitions, fixtures, results, innings summaries and league standings.
This initial version focuses on The Hundred men's and women's competitions. It deliberately avoids ball-by-ball scoring and complete scorecards, concentrating instead on the information needed to maintain a clear and useful record of a competition and its results.
Highlights
- Structured management of countries, venues, teams and competitions
- Separate support for men's and women's teams and competitions
- Fixture scheduling, round and venue details
- Toss winner and toss decision recording
- Structured match results, including wins by runs or wickets
- Innings summaries containing runs, wickets and balls faced
- Automatic result calculation from completed innings data
- Configurable competition points and knockout-stage rules
- Dynamically calculated league tables
- Support for wins, losses, ties and no-results
- Net run rate calculated from innings data
- Separate CSV import and export for matches and innings
Supported Competitions
The initial release includes support for:
- The Hundred Men
- The Hundred Women
Competitions are season-specific and use configurable rules for points allocation and the inclusion or exclusion of knockout matches from league standings.
Match and Innings Recording
Match records contain the fixture-level details, including:
- Competition and round
- Date and start time
- Venue
- Home and away teams
- Toss details
- Match status
- Winning team
- Result type
- Result margin
Innings are stored separately and record:
- Innings number
- Batting team
- Runs scored
- Wickets lost
- Balls faced
This separation allows future fixtures to be imported with empty innings records and completed after the match has taken place.
Where sufficient innings data is available, Cricket Tracker can determine the winning team, result type and margin automatically.
League Tables
League standings are calculated dynamically rather than stored in the database.
The table includes:
- Played
- Won
- Lost
- Tied
- No Result
- Points
- Runs For
- Balls Faced
- Runs Against
- Balls Bowled
- Net Run Rate
The calculation respects the selected competition's points system and knockout inclusion rules.
Data Import and Export
CSV import and export are available for:
- Countries
- Venues
- Teams
- Competitions
- Matches
- Innings
Matches and innings use separate files so that fixture information can be managed independently from completed innings data.
Calculated league tables can also be exported as CSV or formatted PDF documents.
Scope
This release is intended as a competition and results tracker rather than a comprehensive scoring system.
It does not currently include:
- Ball-by-ball data
- Full batting scorecards
- Bowling figures
- Partnerships
- Fall-of-wicket details
- Player statistics
- Live scoring feeds
- Automated collection from external cricket services
The emphasis is on a maintainable, inspectable record of fixtures, results, innings summaries and competition standings.
Looking Ahead
Version 1.1.0.0 provides the cricket-specific foundation on which broader competition support and supporter-focused analysis can be developed.
Additional competitions can be introduced as their formats, points systems and standings rules are modelled.