Traumuhr

Deutsch · English · Technische Details: TRAUMUHR_DOKU.md

Portrait-Kiosk für Raspberry Pi 5: Wecker und Ambient-Uhr mit Touch-Menü, WLAN-Setup und Multimedia.

Einschalten → Menü → Traumuhr | Multimedia | WLAN | Ausschalten

Lizenz: nicht-kommerziell — siehe LICENSE.
Privat nutzen und unverändert kopieren: erlaubt. Kommerzialisieren: nicht erlaubt.

---

Was du brauchst

Teil	Genau
Rechner	Raspberry Pi 5 (auch 2 GB reicht)
Display	iPistBit 7″ IPS HDMI-Touch, 1024×600, mitgelieferte Lautsprecher (Ton über HDMI). Amazon: B0D7HSXY37
Strom	Offizielles USB-C-Netzteil für Pi 5
Speicherkarte	microSD (mind. 32 GB), frisch mit Raspberry Pi OS
PC	Windows/Linux/macOS mit Python 3 und SSH-Zugang zum Pi

Kein fertiges SD-Image liegt in diesem Repo. Du baust das System einmal selbst auf (Schritte unten).

---

Was das Gerät kann

1. Menü — hell, blaue Buttons, Portrait unten
2. Traumuhr — Video-Zifferblatt, Zeiger, Pendel, Wecker, Stundenton, Tick, Tag/Nacht
3. Multimedia — lokale Musik, Webradio, Spotify Connect (Lautsprecher)
4. WLAN — Heimnetz speichern oder Hotspot Traumuhr (http://192.168.4.1)

Geste in der Uhr	Wirkung
2× tippen	Einstellungen am Gerät
3× tippen	zurück zum Menü

Steuerung auch vom Handy: http://<pi-adresse>/ (Port 80) bzw. http://<pi-adresse>:8080/.

---

Installation (einmalig, Schritt für Schritt)

Arbeite die Schritte in dieser Reihenfolge ab. Jeder Schritt setzt den vorherigen voraus.

1. Raspberry Pi OS einrichten

1. Mit dem Raspberry Pi Imager Raspberry Pi OS (64-bit, Desktop) auf die microSD schreiben.
2. Im Imager unter Einstellungen festlegen:
   • Benutzername: li
   • Passwort: dein Passwort (merken)
   • Hostname: Traumuhr
   • SSH: aktiv
   • WLAN: dein Heimnetz (oder später über den Hotspot)
3. Karte in den Pi, Display per HDMI + USB-Touch anschließen, einschalten.
4. Desktop-Autologin für User li einschalten (Raspberry-Menü → Einstellungen → Raspberry Pi Configuration → System).

Prüfen: Am PC ping Traumuhr.local oder die IP im Router/Netzwerk finden. SSH muss gehen:

ssh li@Traumuhr.local

2. Repo auf den Pi legen

Auf dem Pi (SSH oder Terminal):

cd ~
sudo apt update
sudo apt install -y git python3-venv python3-pygame python3-numpy \
  python3-opencv python3-tk kanshi wlopm pipewire wireplumber
git clone https://github.com/Lissors/Traumuhr.git Traumuhr_Raspberry
cd Traumuhr_Raspberry/hub
python3 -m venv --system-site-packages .venv

3. Vom PC aus die Setup-Scripts laufen lassen

Auf dem PC dieses Repo klonen (oder schon haben), dann in PowerShell / Terminal:

cd Pfad\zu\Traumuhr_Raspberry

$env:TRAUMUHR_PI_HOST = "Traumuhr.local"
$env:TRAUMUHR_PI_USER = "li"
$env:TRAUMUHR_PI_PASS = "dein-ssh-passwort"

Danach nacheinander:

python scripts/deploy_pi.py
python scripts/fix_hdmi_audio_pi.py

Pi neu starten (HDMI-Audio braucht den Reboot):

ssh li@Traumuhr.local "sudo reboot"

Warten bis der Pi wieder erreichbar ist, dann:

python scripts/setup_autostart_pi.py
python scripts/setup_gateway_pi.py

Autostart-Skript setzen (auf dem Pi):

cp ~/Traumuhr_Raspberry/hub/pi_kiosk.sh ~/run_traumuhr.sh
chmod +x ~/run_traumuhr.sh

Optional Multimedia (Musik/Spotify):

python scripts/setup_multimedia_pi.py

4. Ersten Start prüfen

1. Pi neu starten.
2. Nach dem Boot: helles Menü (weiß, blaue Buttons).
3. Traumuhr tippen → hochkantiges Zifferblatt, Touch reagiert, Ton aus den Display-Lautsprechern.
4. Im Browser: http://Traumuhr.local/ oder http://Traumuhr.local:8080/
5. In der Uhr 3× tippen → zurück zum Menü.

Wenn kein Ton kommt: Schritt fix_hdmi_audio_pi.py + Reboot noch einmal prüfen.

---

Alltag: Code vom PC aktualisieren

$env:TRAUMUHR_PI_HOST = "Traumuhr.local"
$env:TRAUMUHR_PI_USER = "li"
$env:TRAUMUHR_PI_PASS = "dein-ssh-passwort"
python scripts/deploy_pi.py

Die Uhr startet danach wieder über den Hub (Flag traum-launch-target). Eigenes Dial-Video: mit tools/videotool erzeugen oder siehe assets/vid/README.md, dann python scripts/sync_vid_pi.py.

---

Kurz am PC ausprobieren (ohne Pi)

cd Pfad\zu\Traumuhr_Raspberry
python hub\menu.py
python -m traumuhr --windowed
python tools\videotool\videotool_pi.py

---

Projektstruktur

Traumuhr_Raspberry/
├── hub/           Menü, Intro, WLAN, Autostart
├── traumuhr/      Uhr + Web-UI
├── multimedia/    MPD / myMPD / Spotify
├── assets/        Videos, Sounds, Konfigs
├── scripts/       Setup & Deploy PC → Pi
├── tools/         PC-Hilfen (u. a. Dial-Videotool)
├── README.md
└── README_EN.md

---

Mehr Details

Dokument	Inhalt
TRAUMUHR_DOKU.md	Architektur, Ports, Hörkurve, Troubleshooting
multimedia/README.md	Multimedia-Stack
assets/vid/README.md	Eigene Dial-Videos (600×600)
tools/videotool/README.md	Ausschnitt / Loop / Export für das Zifferblatt

Gehäuse zum Drucken: MakerWorld – iPistBit-Gehäuse (Ingo_L).