Skip to content

Latest commit

 

History

History
74 lines (52 loc) · 2.84 KB

README.md

File metadata and controls

74 lines (52 loc) · 2.84 KB
Raw

Jokkis Race Hub

The Jokkis Race Hub is a web-based application built using Python and Streamlit to scrape race data from the jokkis.net website. The application allows users to search for drivers, races, and race results from various competitions available on the site. You can filter results based on driver name or club, view ongoing races, and refresh results automatically at set intervals.

Features

  • Driver and Club Search: Enter a driver or club name to find specific race results.
  • Race Results Filtering: Filter races to show only those that are unfinished.
  • Automatic Refresh: Option to automatically refresh race results every few seconds.
  • Clear Results: Easily clear the displayed results and start a new search.
  • Multilingual Support: Supports Swedish and Finnish languages.

How to Use

Online Version

You can use the application directly online without needing to install anything. Simply visit the link below:

Jokkis Race Hub Online

Local Installation and Use

  1. Clone the repository: 
    git clone https://github.com/your-username/your-repo-name.git
  2. Navigate into the project directory: 
    cd jokkis_race_hub
  3. Install the required dependencies: 
    pip install -r requirements.txt
  4. Run the application using Streamlit: 
    streamlit run jokkis_race_hub.py

Instructions

  1. Language Selection:

    • In the sidebar, select your preferred language (Swedish or Finnish).

  2. Search for a Driver or Club:

    • Enter the driver or club name in the search field to filter results.
    • The search will match the full name or parts of the name, but only return exact word matches (e.g., searching for "Naski" will return "Jerry Naski" but not names like "Koivisto").

  3. Filtering for Unfinished Races:

    • You can filter races to show only those that are still ongoing by checking the "Visa endast oavslutade lopp" option.

  4. Automatic Updates:

    • You can enable automatic updates for the race results by selecting the "Aktivera automatisk uppdatering" option and adjusting the update interval.

  5. Clear Results:

    • Clear the results from the screen using the "Rensa allt" button to start a new search.

Requirements

  • Python 3.x
  • aiohttp for async HTTP requests
  • BeautifulSoup for web scraping
  • Streamlit for the web interface
  • requests for additional HTTP requests

You can install all the required dependencies using the provided requirements.txt file.

Contributions

Feel free to contribute to the project by submitting a pull request. All contributions are welcome, including bug fixes, new features, or general improvements.

License

This project is licensed under the MIT License.