Computer und Sehen

Um die App auf dem eigenen Rechner zu testen, laden Sie das komplette Programmverzeichnis von GitHub herunter und entpacken es.

GitHub Download

Voraussetzungen

• Python 3 (empfohlen ≥ 3.10)
• pip3 (kommt normalerweise mit Python)
• Ein leeres Projektverzeichnis
• Eine virtuelle Umgebung (venv) innerhalb dieses Verzeichnisses
• Die Python‑Pakete
  • pyside6
  • requests

pip3 install pyside6 requests

pip3 install pyside6 requests

Repository klonen (optional)

Falls Sie das Projekt noch nicht heruntergeladen haben, können Sie es mit Git klonen:

git clone https://github.com/henrietteBaum/MusicSearch-v2.git

git clone https://github.com/henrietteBaum/MusicSearch-v2.git

Falls Git nicht installiert ist, holen Sie es sich über Ihren Paket‑Manager (z. B. sudo apt install git).

Windows‑Besonderheiten

Der einfachste Weg, die App unter Windows zu testen, ist die Nutzung von Visual Studio Code.

1. Öffnen Sie das Projektverzeichnis in VS Code.
2. Erstellen Sie über die Command Palette (Strg+Shift+P) ein virtuelles Environment.
3. Aktivieren Sie das Environment im integrierten Terminal (verwenden Sie cmd, nicht PowerShell):

.\venv\Scripts\activate

.\venv\Scripts\activate

oder, falls Sie das Environment unter .venv angelegt haben:

.\.venv\Scripts\activate.bat

.\.venv\Scripts\activate.bat

Alternative (PowerShell)

.\.venv\Scripts\Activate.ps1

.\.venv\Scripts\Activate.ps1

Installieren Sie die benötigten Pakete wie oben beschrieben.

Unter Linux

Python ist auf den meisten Distributionen bereits vorinstalliert. Gegebenenfalls muss pip3 nachinstalliert werden:

pip3 --version          # prüfen, ob pip bereits vorhanden ist

# Ubuntu / Linux Mint
sudo apt install python3-pip

# Fedora
sudo dnf install python3-pip

pip3 --version          # prüfen, ob pip bereits vorhanden ist

# Ubuntu / Linux Mint
sudo apt install python3-pip

# Fedora
sudo dnf install python3-pip

Danach die beiden Pakete installieren (wie oben).

Auf dem Mac

Die Vorgehensweise entspricht der unter Linux. Wichtig ist eine Python Version 3.10 oder höher, ansonsten kommt es zu Fehlermeldungen bei der Installation des Moduls PySide6 und später bei der App-Ausführung.

Konkret erhalten Sie die Fehlermeldung

TypeError: unsupported operand type(s) for |: 'type' and 'NoneType'

TypeError: unsupported operand type(s) for |: 'type' and 'NoneType'

Der Grund ist, dass der Pipe‑Operator (|) für Typ‑Unions erst ab Python 3.10 unterstützt wird. Stellen Sie sicher, dass Ihre venv mit einer geeigneten Python‑Version erstellt wird.

Zusammenfassung – Start im Terminal

# 1. Projektverzeichnis anlegen
mkdir my_projects
cd my_projects

# 2. Virtuelle Umgebung erstellen
python3 -m venv .venv

# 3. Umgebung aktivieren
#    Linux / macOS
source .venv/bin/activate
#    Windows (cmd)
.\.venv\Scripts\activate.bat

# 4. In das MusicSearch‑Verzeichnis wechseln (nachdem Sie das Repo entpackt/kopiert haben)
cd app

# 5. App starten
python3 main.py

# 1. Projektverzeichnis anlegen
mkdir my_projects
cd my_projects

# 2. Virtuelle Umgebung erstellen
python3 -m venv .venv

# 3. Umgebung aktivieren
#    Linux / macOS
source .venv/bin/activate
#    Windows (cmd)
.\.venv\Scripts\activate.bat

# 4. In das MusicSearch‑Verzeichnis wechseln (nachdem Sie das Repo entpackt/kopiert haben)
cd app

# 5. App starten
python3 main.py

In VS Code starten

1. Öffnen Sie das Projektverzeichnis in VS Code.
2. Installieren Sie die Python‑Extension (wird automatisch vorgeschlagen).
3. Installieren Sie außerdem die Qt‑Extension (für pyside6).
4. Öffnen Sie main.py und klicken Sie auf den Start‑Button (grünes Dreieck oben rechts).

Falls das unter Windows nicht funktioniert: Installieren Sie zusätzlich die Extension Code‑Runner und versuchen Sie es erneut.