Goal for this part
Validate a local file path before enqueue.
Treat 03-Forms as the source of truth for this checkpoint. If your local tree drifted, re-clone that folder rather than mixing files from neighbors.
What you should already know
You do not need prior PyQt experience for part 1. Later parts assume you finished the earlier snapshots on the same machine.
- You can open a terminal and run
python3 - You are comfortable editing a
.pyfile and saving it - You have a desktop session (not a headless SSH box without display forwarding)
Why PyQt fits Soundquarry
PySide6 exposes Qt Multimedia so you can teach play/pause/seek without building a decoder. Playlists stay ordinary Python data.
Transport buttons, a slider, and a track list are natural QWidgets. Keep the player object on the window so signals stay wired.
After you run the snapshot, you should recognize the behavior described in the goal—before you move on. If the window (or server) never appears, stop and fix the run steps.
Code shape
Snapshots stay small on purpose. Look for this kind of core call as you read the folder:
player.setSource(QUrl.fromLocalFile(path))How to run it
Clone the teaching repo, open 03-Forms, install what the README asks for, then run python app.py.
git clone https://github.com/michaeldunga1/fcc-pyqt-player.git
cd fcc-pyqt-player/03-Forms
python3 -m venv .venv
source .venv/bin/activate
pip install -r ../requirements.txt
python app.pyCommon mistakes
- Ignoring platform-specific install notes in the snapshot README
- Accepting empty or invalid input without a message
- Validating only in the UI and never in the save path
- Using placeholder text as if it were real data