🎯 Saturday Tatts Lotto Scraper & Analyzer

A comprehensive bash-based tool for scraping Saturday Tatts Lotto results from Australia and providing statistical analysis for number recommendations.

Bash + Python 3 Weighted Odds Australia Educational

📈 Live Lotto Stats

Up-to-date statistics from winning_numbers.csv and supplementary_numbers.csv

...
Total Draws
...
Date Range
...
Most Frequent Winning Number
...
Least Frequent Winning Number
...
Most Frequent Supplementary
...
Least Frequent Supplementary
Last updated: ...

🚀 Key Features

Discover what makes this tool powerful and unique for lottery analysis

Automated Scraping

Fetches historical Saturday Tatts Lotto results from 1986-2025 with smart updates that only process new draws and terminate early after 5 consecutive skips.

Auto Data Cleaning

Built-in CSV corruption detection and repair. Automatically removes corrupted data before analysis to ensure reliable results.

Statistical Analysis

Calculates odds, probabilities, and weighted heat scores that blend main-draw frequency with supplementary momentum.

Deterministic Recommendations

Ranks combinations with an embedded Python optimizer to deliver 10 deterministic entries that avoid past winners and overlap.

Cross-Platform

Runs on macOS, Linux, and other Unix systems with automatic dependency checks, including Python 3 availability.

Educational Focus

Designed for educational and research purposes to understand lottery number patterns and statistical concepts.

📊 Project Statistics

Key metrics and capabilities of the Saturday Tatts Lotto Scraper

6
Main Numbers
45
Number Range
2
Supplementary Numbers
10
Recommendations Generated
2000+
Historical Draws
4
Supported Platforms

💻 Interactive Demo

See the tool in action with a simulated terminal interface

Terminal Simulation

$ ./master_lotto.sh
Saturday Tatts Lotto Scraper & Analyzer ====================================== 1. Scrape Lotto Results 2. Parse Data & Recommend Entries (with auto-clean) 3. Check & Install Requirements 4. Exit Enter your choice: 1
🕷️ Starting Saturday Tatts Lotto scraper... 📊 Fetching data from au.lottonumbers.com ✅ Found 2026 draws (1986-2025) 💾 Saving to winning_numbers.csv 🎉 Scraping completed successfully! 🧹 Auto-cleaning CSV files before analysis... 🎯 Running deterministic recommendation engine (Python 3)... 📈 Generated 10 ranked entries with weighted supplementary scoring.

⚙️ Installation

Get started in minutes with our simple installation process

# Clone the repository
git clone https://github.com/JDsnyke/saturday-tatts-lotto-scraper.git
cd saturday-tatts-lotto-scraper

# Make scripts executable
chmod +x *.sh

# Run the master script
./master_lotto.sh
View on GitHub Download ZIP

📖 Usage Guide

Learn how to effectively use the tool for lottery analysis

1. Scrape Lotto Results

Fetches historical data from au.lottonumbers.com, automatically skipping existing data to avoid duplicates.

2. Parse Data & Recommend

Runs the deterministic recommendation engine with weighted supplementary numbers and automatic CSV cleaning to produce 10 ranked entries.

3. Check Requirements

Confirms curl, pup, awk, grep, and Python 3 are installed before any scraping or recommendation steps run.

No. | N1 | N2 | N3 | N4 | N5 | N6 | Avg Odds        | Avg %      | Main   | Supp
-----|----|----|----|----|----|----|---------------|-----------|-------|------
1   | 1  | 8  | 11 | 18 | 22 | 42 | 1 in 7          | 16.18%     | 1773   | 553
2   | 1  | 5  | 7  | 11 | 40 | 41 | 1 in 8          | 15.92%     | 1735   | 572
3   | 1  | 6  | 7  | 8  | 12 | 19 | 1 in 8          | 15.82%     | 1733   | 542
4   | 1  | 3  | 11 | 12 | 15 | 26 | 1 in 8          | 15.76%     | 1724   | 547
5   | 5  | 6  | 11 | 15 | 19 | 42 | 1 in 8          | 15.66%     | 1707   | 561

🏗️ Architecture

Understanding the project structure and components

Lotto/
├── master_lotto.sh          # Main menu interface
├── scrape_lotto_results.sh  # Web scraper for lotto results
├── parse_and_recommend.sh   # Statistical analysis & recommendations (with auto-clean)
├── clean_csv.sh            # Manual CSV cleaning utility
├── requirements.sh          # Dependency checker/installer
├── generate_stats.sh        # Generate statistics for website
├── winning_numbers.csv      # Scraped winning numbers
├── supplementary_numbers.csv # Scraped supplementary numbers
├── index.html              # GitHub Pages website
├── assets/
│   ├── lotto_stats.json    # Live statistics data
│   └── favicon.svg         # Website favicon
└── README.md               # Documentation