added en/hu readme and license
This commit is contained in:
7
LICENSE
Normal file
7
LICENSE
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
Copyright 2025 Norbert Jovari
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||||
84
README.en.md
Normal file
84
README.en.md
Normal file
@@ -0,0 +1,84 @@
|
|||||||
|
# SportSoftware OE HTML viewer
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
|
[](https://gitea.carburator.dev/carburator/oe-html-viewer/src/branch/main/README.md)
|
||||||
|
|
||||||
|
Simple Python script to serve the exported HTML results file from the SportSoftware OE application on the local network.
|
||||||
|
Use it to display the results on a TV or to serve results for the competitors.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
<ul style="list-style-type: none"> ✅ Customizable auto-scroll (see Variables section) </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Smooth scrolling </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Auto-reload at bottom </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Auto-reload at X seconds when no need for scrolling </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Supports OE11 and OE12 exported HTML </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ File serving on localhost and LAN </ul>
|
||||||
|
|
||||||
|
### Variables
|
||||||
|
|
||||||
|
The following variables can be found at the top of the `main.py` script:
|
||||||
|
|
||||||
|
- `html_file_path`: Path to the HTML file to be served. Example: `C:\Users\<username>\Documents\example-event\results.html`
|
||||||
|
- `host`: Host address for the Flask application. Leave at `0.0.0.0` for availability at all network addresses (localhost / LAN)
|
||||||
|
- `port`: Port number for the Flask application
|
||||||
|
- `is_oe11`: Boolean flag for encoding (`True` for OE11, `False` for OE12)
|
||||||
|
- `scroll_pixels`: Number of pixels to scroll each interval
|
||||||
|
- `scroll_interval`: Time interval (in seconds) between each scroll
|
||||||
|
- `bottom_wait_time`: Time to wait (in seconds) at the bottom of the page before reloading
|
||||||
|
- `top_wait_time`: Time to wait (in seconds) at the top of the page before starting to scroll
|
||||||
|
- `reload_interval`: Time interval (in seconds) to reload the page if no scrolling is needed. Set this value minimum 1 seconds larger than the export interval in OE
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- Python 3.x
|
||||||
|
- pip
|
||||||
|
- virtualenv
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
Run these commands in CMD or PowerShell.
|
||||||
|
|
||||||
|
1. Clone the repository:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone https://gitea.carburator.dev/carburator/oe-html-viewer.git
|
||||||
|
cd oe-html-viewer
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Create a virtual environment:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
python -m venv .venv
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Activate the virtual environment:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
.venv\Scripts\activate
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Install the required packages:
|
||||||
|
```sh
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
### Running the Application
|
||||||
|
|
||||||
|
0. If you downloaded earlier and want to use the program again, first activate the venv. Check: Installation - 3.
|
||||||
|
|
||||||
|
1. Start the Flask application:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
python main.py
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Open your web browser and navigate to `http://localhost:80`. From other devices on LAN: `http://<host machine IP address>`
|
||||||
|
|
||||||
|
### License
|
||||||
|
|
||||||
|
This project is licensed under the MIT License - see the `LICENSE` file for details.
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
<p style="text-align: center;"> Made with ❤️ on 603 NYÍRSÉG IC </p>
|
||||||
109
README.md
109
README.md
@@ -1,67 +1,84 @@
|
|||||||
# SportSoftware OE HTML viewer
|
# SportSoftware OE HTML megjelenítő
|
||||||
|
|
||||||
Simple Python script to serve the exported HTML results file from the SportSoftware OE application on the local network.
|
<hr>
|
||||||
|
|
||||||
## Getting Started
|
[](https://gitea.carburator.dev/carburator/oe-html-viewer/src/branch/main/README.en.md)
|
||||||
|
|
||||||
### Prerequisites
|
Egyszerű python program, amivel a tájfutó eseményeken használt OE11 és OE12 programból exportált HTML fájlokat lehet megjeleníteni kijelzőn, vagy a helyi hálózaton.
|
||||||
|
|
||||||
|
## Funkciók
|
||||||
|
|
||||||
|
<ul style="list-style-type: none"> ✅ Személyre szabható automatikus görgetés </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Finom görgetés </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Automatikus újratöltés a lap alján </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Automatikus újratöltés, ha nincs szükség görgetésre </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Támogatja az OE11 és OE12-ből exportált HTML fájlokat is </ul>
|
||||||
|
<ul style="list-style-type: none"> ✅ Megjeleníti a fájlt localhost-on és a helyi hálózaton is </ul>
|
||||||
|
|
||||||
|
### Változók
|
||||||
|
|
||||||
|
A `main.py` fájl elején található, szerkeszthető változók:
|
||||||
|
|
||||||
|
- `html_file_path`: Elérési út a HTML fájlhoz. Példa: `C:\Users\<felhasználó>\Documents\példa-verseny\eredmenyek.html`
|
||||||
|
- `host`: A webszerver IP címe. Hagyd az alapértelmezett `0.0.0.0` értéken, hogy elérhető legyen a fájl lokálisan és a lokális hálózaton is
|
||||||
|
- `port`: A webszerver portja. Alapértelmezetten `80`, ez elhagyható az URL-ből
|
||||||
|
- `is_oe11`: Változó az OE11 vagy OE12 kiválasztására. Legyen `True` ha OE11-et használsz és `False`, ha OE12-t
|
||||||
|
- `scroll_pixels`: Ennyi pixelt görget lefelé
|
||||||
|
- `scroll_interval`: Időtartam másodpercben, ennyi időnként görget
|
||||||
|
- `bottom_wait_time`: Időtartam másodpercben, ennyit vár ha a lap aljára ért újratöltés előtt
|
||||||
|
- `top_wait_time`: Időtartam másodpercben, ennyit vár a lap tetején, mielőtt elkezdődne a görgetés
|
||||||
|
- `reload_interval`: Időtartam másodpercben, ennyit vár újratöltés előtt, ha nincs szükség görgetésre, mert a tartalom kifér a képernyőre. Legyen ez az érték minimum 1 másodperccel több, mint az automatikus exportálás ideje az OE-ben.
|
||||||
|
|
||||||
|
## Használat
|
||||||
|
|
||||||
|
### Előfeltételek
|
||||||
|
|
||||||
- Python 3.x
|
- Python 3.x
|
||||||
- pip
|
- pip
|
||||||
- virtualenv
|
- virtualenv
|
||||||
|
|
||||||
### Installation
|
### Telepítés
|
||||||
|
A következő parancsokat CMD-ben vagy PowerShell-ben kell kiadni.
|
||||||
|
|
||||||
1. Clone the repository:
|
1. Töltsd le a repository-t:
|
||||||
```sh
|
|
||||||
git clone https://gitea.carburator.dev/carburator/oe-html-viewer.git
|
|
||||||
cd oe-html-viewer
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Create a virtual environment:
|
```sh
|
||||||
```sh
|
git clone https://gitea.carburator.dev/carburator/oe-html-viewer.git
|
||||||
python -m venv .venv
|
cd oe-html-viewer
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Activate the virtual environment:
|
2. Hozz létre egy virtuális környezetet:
|
||||||
|
|
||||||
- On Windows:
|
```sh
|
||||||
```sh
|
python -m venv .venv
|
||||||
.venv\Scripts\activate
|
```
|
||||||
```
|
|
||||||
- On macOS/Linux:
|
|
||||||
```sh
|
|
||||||
source .venv/bin/activate
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Install the required packages:
|
3. Aktiváld a virtuális környezetet:
|
||||||
```sh
|
|
||||||
pip install -r requirements.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
### Running the Application
|
```sh
|
||||||
|
.venv\Scripts\activate
|
||||||
|
```
|
||||||
|
|
||||||
1. Start the Flask application:
|
4. Telepítsd a szükséges csomagokat:
|
||||||
```sh
|
```sh
|
||||||
python main.py
|
pip install -r requirements.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Open your web browser and navigate to `http://localhost:80`.
|
### Futtatás
|
||||||
|
|
||||||
### Variables
|
0. Ha már telepítetted és újra használni akarod, akkor előbb aktiváld a virtuális környezetet. Lásd: Telepítés - 3.
|
||||||
|
|
||||||
The following variables can be found at the top of the `main.py` script:
|
1. Indítsd el a programot:
|
||||||
|
|
||||||
- `html_file_path`: Path to the HTML file to be served.
|
```sh
|
||||||
- `host`: Host address for the Flask application. Leave at `0.0.0.0` for availability at all network addresses (localhost / LAN)
|
python main.py
|
||||||
- `port`: Port number for the Flask application.
|
```
|
||||||
- `is_oe11`: Boolean flag for encoding (True for OE11, False for OE12).
|
|
||||||
- `scroll_pixels`: Number of pixels to scroll each interval.
|
|
||||||
- `scroll_interval`: Time interval (in seconds) between each scroll.
|
|
||||||
- `bottom_wait_time`: Time to wait (in seconds) at the bottom of the page before reloading.
|
|
||||||
- `top_wait_time`: Time to wait (in seconds) at the top of the page before starting to scroll.
|
|
||||||
- `reload_interval`: Time interval (in seconds) to reload the page if no scrolling is needed. Set this value minimum 1 seconds larger than the export interval in OE.
|
|
||||||
|
|
||||||
### License
|
2. Nyisd meg a böngészőt és írd be a címsorba: `http://localhost`. Más eszközről a helyi hálózaton: `http://<host gép ip címe>`
|
||||||
|
|
||||||
This project is licensed under the MIT License - see the `LICENSE` file for details.
|
### Licensz
|
||||||
|
|
||||||
|
Ez a projekt az MIT Licensz alatt van licenszelve - részletekért lásd a LICENSE fájlt.
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
<p style="text-align: center;"> Készült sok ❤️-el a 603 NYÍRSÉG IC-n </p>
|
||||||
Reference in New Issue
Block a user