Start

linedance-app/README.md

@@ -0,0 +1,57 @@
+# LineDance Player — Desktop App
+
+PyQt6-baseret afspiller til linedance-events.
+
+## Installation
+
+```bash
+python -m venv venv
+source venv/bin/activate          # Linux/Mac
+venv\Scripts\activate             # Windows
+
+pip install -r requirements.txt
+```
+
+VLC skal også være installeret på systemet:
+- **Linux**: `sudo apt install vlc`
+- **Windows**: Download fra https://www.videolan.org/vlc/
+- **Mac**: `brew install vlc`
+
+## Start
+
+```bash
+python main.py
+```
+
+## Mappestruktur
+
+```
+linedance-app/
+├── main.py               # Entry point
+├── requirements.txt
+├── local/                # Lokal SQLite + fil-scanning
+│   ├── local_db.py       # Database operationer
+│   ├── tag_reader.py     # Læs/skriv MP3-tags
+│   └── file_watcher.py   # Overvåg mapper med watchdog
+├── player/
+│   └── player.py         # VLC afspiller wrapper
+└── ui/
+    ├── main_window.py    # Hoved-vindue
+    ├── playlist_panel.py # Danseliste
+    ├── library_panel.py  # Musikbibliotek med søgning
+    ├── next_up_bar.py    # "Næste sang klar" banner
+    ├── vu_meter.py       # VU-meter widget
+    └── themes.py         # Lyst / mørkt tema
+```
+
+## Brug
+
+1. Klik **+ MAPPE** i biblioteks-panelet og peg på din musikmappe
+2. Appen scanner automatisk alle undermapper og høster tags
+3. Dobbeltklik på en sang for at afspille, eller højreklik → Tilføj til danseliste
+4. Brug **▶ 10 SEK** knappen til at høre introen inden dansen starter
+5. Sangen stopper automatisk når den er færdig — tryk **▶ AFSPIL NÆSTE** for at fortsætte
+
+## Lokal database
+
+Gemmes i `~/.linedance/local.db` — bevares mellem sessioner.