Skip to content

itzadamh/openf1-qualifying

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 

Repository files navigation

openf1-qualifying

Python License

A small project I’m working on using the OpenF1 API.
Originally based on the Singapore 2025 qualifying results, it now supports user input for any Grand Prix.
Enter the country and year of the race you want to view, and the program will display the qualifying results.

🏎️ Project Goal

To explore working with public APIs and display real Formula 1 qualifying data in a simple, readable format.
This project also serves as a learning exercise for Python, API requests, and working with JSON data.

⚙️ Requirements

  • Python 3.x (3.7 or newer recommended)
  • requests module

Install dependencies with:

pip install requests

🚀 Usage

Run the program in your terminal:

python openf1_qualifying.py

Then follow the prompts to enter the race country and year:

Please enter the country of the race (e.g. Singapore):
Canada
Please enter the year of the race:
2024

Otherwise with command-line arguments, you can do:

python openf1_qualifying.py "United States" 2025

⚠️ Note:

For the first argument being the country name, if it includes a space such as above you must use quotation marks for it, however if there is no spaces then the quotation marks are not needed.

🧾 Example Output

In both examples, only pole position is shown for demonstration. The whole program shows the entire grid.

Please enter the country of the race (e.g. Singapore):
Azerbaijan
Please enter the year of the race:
2025

------------------------------------------------
Loading Azerbaijan 2025 Qualifying results...
------------------------------------------------
Found 20 starting positions.
Found 20 drivers.

Driver: Max VERSTAPPEN | 1
Team: Red Bull Racing
Position: 1
Fastest Lap: 01:41.117

Or with command-line arguments:

python openf1_qualifying.py "United States" 2025
Multiple meetings found for United States 2025:
  1. Miami Grand Prix
  2. United States Grand Prix
Select meeting (1-2) or 'q' to cancel: 1
---------------------------------------------------
Loading United States 2025 Qualifying results...
---------------------------------------------------
Found 20 starting positions.
Found 20 drivers.

Driver: Max VERSTAPPEN | 1
Team: Red Bull Racing
Position: 1
Fastest Lap: 01:26.204

🧩 Planned / Potential Features

  • Formatting changes — lap times formatted to mm:ss.ss
  • User input (e.g. "Silverstone", "2024")
  • Command-line arguments (e.g. python openf1_qualifying.py monaco 2024)
  • Gap timing statistics between drivers
  • Option to export results to a text or CSV file

🤝 Contributing

Contributions, suggestions, or improvements are welcome!
If you’d like to help, feel free to:

  • Open an issue to report a bug or suggest a feature.
  • Submit a pull request with improvements.

📜 License

This project is open-source under the MIT License.

🔗 Resources

About

A small project I am working on using the OpenF1 API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages