Skip to main content

​
Overview

OddsEngine’s desktop application provides a comprehensive interface for analyzing tennis bets, calculating probabilities, and tracking your betting performance. This guide covers the main windows, navigation patterns, and essential workflows.

​
Application Layout

​
Main Window Components

When you launch OddsEngine, you’ll see the main window divided into key areas:
Quick access buttons below the menu bar:
  • New Single Analysis: Analyze an individual bet
  • New Combined Bet: Create multi-match combination
  • Refresh Data: Update match data from API
  • Saved Analyses: View historical analyses
  • Settings: Configure application preferences
Main working space that changes based on your current task:
  • Match selection lists
  • Probability calculation displays
  • Analysis detail views
  • Comparison tables
Shows additional details for selected items:
  • Match information and statistics
  • Player profiles and recent form
  • Probability breakdown factors
  • Notes and annotations
Bottom bar displaying:
  • API connection status (Connected/Disconnected/Mock Mode)
  • Last data refresh timestamp
  • Database connection status
  • Quick stats (total saved analyses, etc.)

​
Getting Started Workflow

1

Launch the application

Run the OddsEngine desktop application from your system launcher or command line:
python -m oddsengine.app
The application initializes and connects to the Tennis API.
2

Check data connection

Look at the status bar (bottom of window):
  • Green indicator: Connected to API-Tennis.com
  • Yellow indicator: Using cached data
  • Orange indicator: Mock provider active (fallback mode)
If needed, click Refresh Data to update match information.
3

Browse upcoming matches

The Upcoming Matches section in the left sidebar shows:
  • Matches organized by date
  • Tournament names and rounds
  • Player names and rankings
Expand date groups to see all matches scheduled.
4

Select your first match to analyze

Click any match in the upcoming list. The central area displays:
  • Detailed match information
  • Probability calculations
  • Statistical factors
The right panel shows player profiles and recent performance.

​
Key Features and Navigation

​
Analyzing Individual Matches

1

Select a match from Upcoming Matches

Click on a match in the left sidebar or use File > New Analysis to open the match selector.
2

Review the probability display

The central panel shows:
  • Win probabilities for each player (large percentages)
  • Confidence level indicator (High/Medium/Low)
  • Data completeness bar
Click Show Details to expand statistical factors.
3

Examine contributing factors

Scroll through the factors list:
  • Head-to-head record
  • Current form (last 10 matches)
  • Surface performance
  • Tournament level performance
Each factor shows its contribution weight to the final probability.
4

Add notes and save

Use the Notes field in the right panel to document:
  • External factors (injuries, motivation)
  • Your confidence adjustments
  • Betting decision rationale
Click Save Analysis to store in your database.

​
Creating Combined Bets

1

Start a new combination

Click New Combined Bet in the toolbar or press Ctrl+N.
2

Add matches to your combination

Click Add Match to open the match selector:
  • Browse by date, tournament, or search player names
  • Select the match and choose which player you predict will win
  • Click Add to Combination
Repeat for all matches you want to include (minimum 2).
3

Review combined probability

The central panel displays:
  • List of all selected matches with individual probabilities
  • Combined probability (large percentage at top)
  • Risk assessment badge (Conservative/Moderate/Aggressive/High Risk)
The right panel shows expected value analysis.
4

Optimize if needed

Use the optimization tools:
  • Hover over matches to see impact of removal
  • Click Remove on weak matches to improve probability
  • Click Suggest Alternatives for match replacement recommendations
The combined probability updates in real-time.
5

Save your combined bet

Click Save Combined Bet and optionally add:
  • Stake amount
  • Bookmaker odds
  • Notes on your strategy

​
Managing Saved Analyses

​
Viewing Analysis History

Click Saved Analyses in the left sidebar to see all stored analyses:
  • List View: Sortable table with date, matches, probability, result status
  • Grid View: Card-based layout with visual probability indicators
  • Timeline View: Chronological display of your analysis history
Switch views using the icons in the top-right of the content area.

​
Filtering and Searching

Use the filter toolbar above the analysis list:
Select start and end dates to show analyses from specific time periods.
Filter by outcome:
  • All: Show all analyses
  • Pending: Matches not yet played
  • Won: Successful predictions
  • Lost: Incorrect predictions
Show specific analysis types:
  • Single Bets: Individual match analyses
  • Combined Bets: Multi-match combinations

​
Comparing Multiple Analyses

1

Select analyses to compare

In the Saved Analyses view:
  • Hold Ctrl (Windows/Linux) or Cmd (Mac) and click multiple analyses
  • Or click the checkbox on each analysis you want to compare
2

Open comparison view

Click Compare Selected button in the toolbar.
3

Review side-by-side comparison

The comparison table shows:
  • Match details for each analysis
  • Individual or combined probabilities
  • Actual results (if matches completed)
  • Your notes and reasoning
Sort by any column to identify patterns or best performers.

​
Data Management

​
Refreshing Match Data

OddsEngine automatically refreshes data every 6 hours, but you can manually update:
1

Click Refresh Data in toolbar

Or select Tools > Refresh Match Data from the menu.
2

Monitor refresh progress

A progress bar appears in the status bar showing:
  • Matches being updated
  • API calls remaining (if applicable)
  • Estimated completion time
3

Review updated matches

After refresh completes:
  • New matches appear in Upcoming Matches
  • Completed matches move to history
  • Updated odds and statistics reflect latest data
If you exceed API rate limits (1,000 requests/month on free tier), OddsEngine automatically switches to Mock Provider mode using cached historical data.

​
Understanding API Status

The status bar shows current data source:
StatusIconMeaning
Connected🟢 GreenLive data from API-Tennis.com
Cached🟡 YellowUsing recently cached data (within 24 hours)
Mock Mode🟠 OrangeUsing mock provider (historical data fallback)
Error🔴 RedConnection failed, click for details
Click the status indicator to view:
  • Last successful refresh timestamp
  • API requests remaining this month
  • Data freshness for each tournament
  • Option to force refresh or switch to mock mode

​
Customizing the Interface

​
Themes and Appearance

Navigate to View > Themes to choose:
  • Light Theme: Default bright interface
  • Dark Theme: Dark mode for reduced eye strain
  • System Default: Matches your operating system theme

​
Layout Customization

1

Toggle panel visibility

Use View menu to show/hide:
  • Left Sidebar
  • Right Context Panel
  • Status Bar
Create more screen space for the central content area.
2

Resize panels

Hover over panel borders until cursor changes to resize icon, then click and drag to adjust width/height.
3

Save layout

After arranging panels, select View > Save Layout to preserve your configuration.

​
Preferences and Settings

Click Settings toolbar button or File > Preferences to configure:
  • Default view on startup (Upcoming Matches, Saved Analyses, Dashboard)
  • Auto-refresh interval (1-24 hours)
  • Language selection
  • API-Tennis.com API key
  • Mock provider data directory
  • Database connection settings
  • Cache duration preferences
  • Default confidence level filter
  • Minimum probability thresholds
  • Combined bet maximum matches
  • Risk assessment preferences
  • Theme selection
  • Font size
  • Probability display format (percentage, decimal, fraction)
  • Date and time format
  • Alert when matches complete
  • Notify on data refresh errors
  • Show tips and hints
Click Apply to save changes or Cancel to discard.

​
Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts:
ShortcutAction
Ctrl+NNew combined bet
Ctrl+SSave current analysis
Ctrl+RRefresh match data
Ctrl+FFocus search box
Ctrl+HOpen saved analyses
Ctrl+,Open preferences/settings
F5Refresh current view
EscapeClose current dialog/panel
Ctrl+WClose current tab
Ctrl+QQuit application
View all shortcuts by pressing F1 or selecting Help > Keyboard Shortcuts.

​
Common Workflows

​
Daily Analysis Routine

1

Morning: Check upcoming matches

  • Launch OddsEngine
  • Click Refresh Data to get latest matches
  • Browse Upcoming Matches for today and upcoming days
2

Analyze promising opportunities

  • Select matches with favorable probabilities
  • Review statistical factors and confidence levels
  • Save analyses with notes on your reasoning
3

Build combined bets if desired

  • Create 2-3 combined bet scenarios
  • Compare risk vs. potential return
  • Save best options for later review
4

Evening: Review and place bets

  • Open Saved Analyses for the day
  • Compare all options using comparison view
  • Make final decisions based on latest information
5

Post-match: Track results

  • OddsEngine automatically updates completed matches
  • Review accuracy in History section
  • Note patterns in successful vs unsuccessful analyses

​
Weekly Performance Review

Once per week, assess your betting analysis performance:
1

Open analysis history

Navigate to Saved Analyses and set date filter to last 7 days.
2

Calculate success rate

The summary panel shows:
  • Total analyses performed
  • Win rate (% of correct predictions)
  • Combined bet success rate
  • Average probability of analyzed bets
3

Identify patterns

Look for:
  • Which probability ranges perform best
  • Surface types where predictions are more accurate
  • Tournament levels with higher success rates
4

Adjust strategy

Based on results:
  • Raise or lower probability thresholds
  • Focus on tournament types with better accuracy
  • Refine combined bet size preferences

​
Exporting Data

Share or archive your analysis data:
1

Select analyses to export

In Saved Analyses, select one or more entries (or use Select All).
2

Choose export format

Click File > Export and select:
  • PDF Report: Formatted document with all analysis details
  • CSV File: Spreadsheet-compatible data for further analysis
  • JSON: Raw data for programmatic processing
3

Configure export options

Choose what to include:
  • Match details
  • Probability calculations
  • Statistical factors
  • Notes and annotations
  • Results (for completed matches)
4

Save exported file

Select destination folder and filename, then click Save.

​
Troubleshooting

Symptoms: Double-clicking doesn’t start OddsEngine or shows error message.Solutions:
  • Verify Python 3.10+ is installed: python --version
  • Check PyQt is installed: pip show PyQt5 or pip show PyQt6
  • Run from command line to see error messages: python -m oddsengine.app
  • Check logs in ~/.oddsengine/logs/application.log
Symptoms: Upcoming Matches list is empty or shows old data.Solutions:
  • Click Refresh Data button
  • Check API status in status bar (should be green or yellow)
  • Verify internet connection
  • Check API key in Settings > Data Sources
  • Enable Mock Provider if API is unavailable: Tools > Enable Mock Provider
Symptoms: Calculated probabilities don’t match expectations.Solutions:
  • Click Show Details to review contributing factors
  • Check confidence level (Low confidence may indicate data issues)
  • Verify match details are correct (players, tournament, surface)
  • Ensure data is fresh (refresh if older than 24 hours)
  • Remember: OddsEngine uses statistical models, not guarantees
Symptoms: Save button grayed out or error when clicking Save.Solutions:
  • Check database connection in status bar
  • Verify database settings in Settings > Data Sources
  • Ensure write permissions to database directory
  • Check disk space availability
  • Review database logs: ~/.oddsengine/logs/database.log
Symptoms: Clicking buttons delays, window hangs, or stutters.Solutions:
  • Close unused tabs and panels
  • Clear analysis history: Tools > Clear Old Analyses
  • Reduce auto-refresh frequency in Settings
  • Check system resources (CPU, memory)
  • Restart application
If problems persist after trying these solutions, check the GitHub issues page or create a new issue with details about your problem and system configuration.

​
Getting Help

​
In-Application Help

  • Press F1 to open context-sensitive help
  • Hover over any button or field for tooltip explanations
  • Click Help > Documentation to open this guide
  • Select Help > Tutorial for interactive walkthrough

​
External Resources

Documentation

Browse complete OddsEngine documentation

GitHub Repository

Report issues or contribute to the project

Core Concepts

Understand how probability calculations work

API Integration

Configure data sources and API connections
Check Help > About to verify your OddsEngine version and see what’s new in the latest release.

Build docs developers (and LLMs) love

Get started for freeTalk to us