LinedanceAfspiller/linedance-app/BUILD.md

LineDance Player — Windows Build Guide

Forudsætninger

Installer følgende på din Windows-maskine:

1. Python 3.11+
   https://www.python.org/downloads/
   ✅ Sæt flueben ved "Add Python to PATH"

2. VLC (64-bit)
   https://www.videolan.org/vlc/
   Kræves både til udvikling og til slutbrugere

3. NSIS 3.x
   https://nsis.sourceforge.io/Download
   Bruges til at bygge .exe installationsprogrammet

---

Første gang: Opsæt miljø

cd linedance-app
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

---

Byg installer

build.bat

Det gør automatisk:

1. PyInstaller → dist\LineDancePlayer\ (hele programmet)
2. NSIS → dist\LineDancePlayer-Setup.exe (installer til brugerne)

Tager 2-5 minutter første gang.

---

Upload til server

scp dist\LineDancePlayer-Setup.exe bruger@linedanceplayer.dk:/opt/docker/linedanceafspiller/linedance-api/web/public/download/

Filen er tilgængelig på:
https://linedanceplayer.dk/download/LineDancePlayer-Setup.exe

---

Ikoner (valgfrit men anbefalet)

Placer disse filer i installer\ mappen:

Fil	Størrelse	Beskrivelse
icon.ico	256×256	Program-ikon (Windows .ico format)
welcome.bmp	164×314	Velkomst-billede i installer
header.bmp	150×57	Header-billede i installer

Uden ikoner bygges der med standard NSIS-udseende.

---

Fejlfinding

PyInstaller fejler med "module not found"
Tilføj modulet til hiddenimports i build_windows.spec

VLC ikke fundet ved kørsel
Sørg for at VLC er installeret som 64-bit — samme arkitektur som Python

NSIS fejler
Kør makensis /V4 installer.nsi for detaljeret output

---

Versionsnummer

Opdater versionsnummeret i installer.nsi:

!define APP_VERSION "1.0.1"

Og i app.html på hjemmesiden:

<div class="version" id="win-version">Version 1.0.1 · 64-bit</div>