commit 1b5539a80df1a8730b0a1c1591e0ecf64483a490
Author: Martin Tazl <martin.tazl@gmx.de>
Date:   Sun Aug 9 08:30:55 2026 +0200

    initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8aeeab7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+# radioeins Top-100-Auswertung
+
+## Installation in PowerShell
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -r requirements.txt
+```
+
+Falls die virtuelle Umgebung bereits aktiv ist, nur:
+
+```powershell
+python -m pip install -r requirements.txt
+```
+
+## Testlauf mit drei Juryseiten
+
+```powershell
+python .\radioeins_top100.py --limit 3
+```
+
+## Vollständige Auswertung
+
+```powershell
+python .\radioeins_top100.py
+```
+
+Für eine andere radioeins-Top-100-Seite:
+
+```powershell
+python .\radioeins_top100.py "https://www.radioeins.de/musik/top_100/2026/ANDERES-THEMA/"
+```
+
+## Ergebnisdateien
+
+Die Dateien werden unter `output` angelegt:
+
+- `radioeins_top100.xlsx`
+- `top100.csv`
+- `gesamtwertung.csv`
+- `einzelwertungen.csv`
+- `unaufgeloeste_eintraege.csv`
+- `fehler.csv`
+
+## Schreibvarianten korrigieren
+
+Bestätigte Varianten in `output\title_aliases.csv` eintragen:
+
+```csv
+variant,canonical
+Weck mich auf,Weck Mich Auf
+```
+
+## Unklare Interpret-Titel-Trennung korrigieren
+
+Einträge aus `output\unaufgeloeste_eintraege.csv` in
+`output\split_overrides.csv` übernehmen:
+
+```csv
+raw,artist,title
+Samy Deluxe Weck Mich Auf,Samy Deluxe,Weck Mich Auf
+```
+
+Danach das Skript erneut starten.