Computer und Sehen

Schlagwort: Python

  • MusicSearch-v2 ausprobieren

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

    musicsearch-v2 Logo

    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

    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

    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

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

    .\.venv\Scripts\activate.bat

    Alternative (PowerShell)

    .\.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

    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'

    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

    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.