🎬 VLC installieren

Für die Videoausgabe benötigen wir den VLC‑Player und das passende Python‑Modul. Falls du VLC noch nicht installiert hast, führe im Terminal nacheinander diese Befehle aus (jeweils mit ENTER bestätigen):

sudo apt install vlc -y
pip install python-vlc

🧩 Projekt sauber anlegen (mit virtueller Umgebung)

Damit dein Raspberry Pi nicht durcheinanderkommt, legen wir eine eigene virtuelle Umgebung (venv) für dieses Projekt an.

👉 Öffne zuerst ein Terminal (Zubehör → Terminal). 👉 Nach jedem Befehl musst du ENTER drücken.

# 1. Projektordner anlegen
mkdir scream_frame
cd scream_frame

# 2. Virtuelle Umgebung erstellen
python3 -m venv venv

# 3. Umgebung aktivieren
source venv/bin/activate

# 4. Benötigte Pakete installieren
pip install adafruit-circuitpython-vl53l0x python-vlc

So sieht es aus, wenn die venv aktiv ist:

(venv) pi@raspberrypi:~/scream_frame $

So verlässt du die virtuelle Umgebung wieder:

deactivate

Danach sieht die Terminal‑Zeile wieder normal aus:

pi@raspberrypi:~/scream_frame $

📝 Python-Datei anlegen und speichern

Jetzt erstellen wir die Datei, in der dein kompletter Code gespeichert wird.

Datei im Terminal öffnen:

nano scream_frame.py

In nano speicherst du so:

• STRG + O → speichern
• ENTER → bestätigen
• STRG + X → schließen

💻 Mein Code

Diesen Code kopierst du komplett in die Datei scream_frame.py.

import time
import board
import busio
import adafruit_vl53l0x
import vlc
import os

os.environ["DISPLAY"] = ":0"

VIDEO_PATH = "/pfad/zu/deinem/video.mp4"
START_AT = 230500
END_AT = 240000

TRIGGER_DISTANCE = 30
COOLDOWN = 3

i2c = busio.I2C(board.SCL, board.SDA)
sensor = adafruit_vl53l0x.VL53L0X(i2c)

instance = vlc.Instance("--no-video-title-show", "--fullscreen")
player = instance.media_player_new()

def load_video():
    media = instance.media_new(VIDEO_PATH)
    player.set_media(media)
    player.play()
    time.sleep(0.3)
    while player.get_time() <= 0:
        time.sleep(0.05)
    player.set_fullscreen(True)
    player.set_time(START_AT)
    time.sleep(0.1)
    player.pause()

def play_segment():
    player.set_time(START_AT)
    time.sleep(0.1)
    player.play()
    player.set_fullscreen(True)
    while True:
        if player.get_time() >= END_AT:
            break
        time.sleep(0.02)
    player.pause()
    time.sleep(0.1)
    player.set_time(START_AT)

load_video()
print("System bereit – warte auf Person...")

while True:
    distance_cm = sensor.range / 10
    if 0 < distance_cm < TRIGGER_DISTANCE:
        print(f"Person erkannt bei {distance_cm:.1f} cm – starte Segment")
        play_segment()
        time.sleep(COOLDOWN)
    time.sleep(0.1)

💡 Hinweis: Die Werte START_AT, END_AT, TRIGGER_DISTANCE und COOLDOWN solltest du später anpassen, damit der Effekt perfekt zu deinem Video und deinem Aufbau passt.

Jeder Monitor, jeder Abstand und jedes Video ist etwas anders – daher lohnt es sich, die Zeiten ein paar Mal zu testen, bis der Ablauf genau so wirkt, wie du es möchtest.

▶️ Datei starten

Starte dein Projekt mit:

python3 scream_frame.py

💡 Wichtig: Da der VLC‑Player im Vollbildmodus läuft, kannst du nicht direkt STRG + C drücken.

Nutze zuerst die Tastenkombination ALT + TAB, um vom Vollbild‑VLC zurück zum Terminal zu wechseln.

Dort kannst du das Skript dann wie gewohnt mit STRG + C beenden.

🖼️ Monitor / Fernseher richtig kaschieren

Damit der Scream‑Frame wie ein echtes Gemälde aussieht, muss der Bildschirm vollständig vom Rahmen verdeckt werden. Achte darauf:

• Der Rahmen sollte den kompletten Rand des Monitors überdecken.
• Zwischen Rahmen und Display darf kein Licht durchscheinen.
• Die Innenseite des Rahmens kann schwarz ausgekleidet werden.
• Ein leicht nach vorne versetzter Rahmen wirkt besonders authentisch.

Tipp: Eine matte Displayfolie reduziert Spiegelungen und lässt das Bild „gemalter“ wirken.

🧩 Raspberry Pi sicher befestigen & verstecken

Der Raspberry Pi sollte stabil sitzen und gleichzeitig unsichtbar bleiben. So machst du es am besten:

• Nutze doppelseitiges Klebeband oder Klettband auf der Rückseite des Monitors.
• Achte darauf, dass die Lüftungsschlitze frei bleiben.
• Kabel durch eine kleine Öffnung im Rahmen führen.
• Ein schwarzes oder holzfarbenes Gehäuse wirkt am unauffälligsten.

Tipp: Der Pi kann auch in einer kleinen Box hinter der Staffelei verschwinden.

📡 Abstandssensor richtig platzieren

Der VL53L0X‑Sensor ist klein und lässt sich sehr gut verstecken. Ideal ist:

• Unterhalb des Rahmens, leicht nach vorne geneigt.
• Hinter einer kleinen Öffnung (z. B. 6 mm Loch), die du vorher gebohrt hast.
• In einer dunklen Ecke des Rahmens, damit er nicht auffällt.
• Auf Augenhöhe der Besucher für maximale Wirkung.

Tipp: Ein kleines Stück schwarzes Stoffgitter (z. B. Lautsprecherstoff) macht den Sensor unsichtbar.

🔌 Kabel sauber führen & verstecken

Sichtbare Kabel zerstören sofort die Illusion. So kaschierst du sie:

• HDMI‑ und Stromkabel hinter dem Rahmen entlangführen.
• Mit kleinen Kabelclips fixieren.
• Bei Wandmontage: dünnen Kabelkanal in Wandfarbe nutzen.
• Bei Staffelei: Kabel hinter einem Bein nach unten führen.

Tipp: Schwarzes Isolierband ist perfekt, um kleine sichtbare Stellen zu tarnen.

🎨 Präsentation: Staffelei oder Wandmontage

Damit der Scream‑Frame wie ein echtes Kunstwerk wirkt, kannst du ihn so präsentieren:

🖼️ 1. Auf einer Staffelei

• Wirkt wie ein echtes Gemälde.
• Perfekt für Halloween‑Partys oder Eingangsbereiche.
• Kabel lassen sich hinter den Staffelei‑Beinen verstecken.

🔩 2. Wandmontage

• Wirkt wie ein echtes Bild an der Wand.
• Sensor kann unauffällig unten am Rahmen angebracht werden.
• Kabel verschwinden in einem dünnen Kabelkanal.

🪑 3. Auf einem Sideboard

• Sehr flexibel – du kannst den Winkel perfekt einstellen.
• Ideal, wenn du den Sensor auf Tischhöhe nutzen willst.

👻 Tipps für maximale Illusion

• Ein LED‑Teelicht daneben erzeugt eine „Galerie‑Atmosphäre“.
• Spinnweben oder Deko‑Risse am Rahmen verstärken den Effekt.
• Der Sensor sollte erst reagieren, wenn jemand wirklich nah dran ist.
• Ein dunkler Raum verstärkt den Schockmoment enorm.
• Auf einer Staffelei leicht nach hinten kippen – wirkt wie ein echtes Gemälde.

Jetzt ist dein Scream‑Frame nicht nur technisch perfekt – sondern auch optisch ein echtes Highlight!

🎬 Problem: Video startet nicht

Mögliche Ursachen & Lösungen:

• VIDEO_PATH stimmt nicht → Prüfe, ob der Pfad korrekt ist.
• VLC ist nicht installiert → sudo apt install vlc -y
• Python‑VLC fehlt → pip install python-vlc
• Dateiformat wird nicht unterstützt → MP4 funktioniert am besten.

Tipp: Teste das Video einmal manuell mit vlc /pfad/video.mp4.

📡 Problem: Sensor reagiert nicht

Das sind die häufigsten Ursachen:

• I2C ist nicht aktiviert → Raspberry Pi Konfiguration öffnen und aktivieren.
• Kabel vertauscht → SDA/SCL prüfen (SDA = Pin 3, SCL = Pin 5).
• Sensor zu hoch/zu tief → Position leicht anpassen.
• TRIGGER_DISTANCE zu klein → Wert im Code erhöhen.

Tipp: Teste den Sensor separat mit einem kleinen Python‑Testskript, wenn du unsicher bist.

🐍 Problem: Das Skript startet nicht

Das kann mehrere Gründe haben:

• venv nicht aktiviert → source venv/bin/activate
• Datei falsch benannt → Muss scream_frame.py heißen.
• Python‑Fehler im Code → Terminal zeigt die Fehlermeldung.
• Falscher Ordner → Mit pwd prüfen.

Tipp: Wenn du nicht weiterkommst, kopiere die Fehlermeldung und suche nach dem Wort Traceback – dort steht die Ursache.

🖥️ Problem: VLC hängt im Vollbild

Da VLC im Vollbild läuft, kommst du nicht direkt zurück ins Terminal. So beendest du das Skript trotzdem:

• ALT + TAB drücken → zurück zum Terminal wechseln.
• STRG + C drücken → Skript sauber beenden.

Tipp: Wenn VLC sich aufhängt, hilft oft ein Neustart: sudo reboot.

🎞️ Problem: Video startet zu früh / zu spät

Das ist normal – jeder Aufbau ist anders. Passe diese Werte im Code an:

• START_AT → Startzeitpunkt des Videos
• END_AT → Endzeitpunkt des Videos
• TRIGGER_DISTANCE → Abstand, ab dem ausgelöst wird
• COOLDOWN → Pause zwischen zwei Auslösungen

Tipp: Teste die Werte in kleinen Schritten (z. B. 100 ms oder 5 cm).

🔧 Problem: Raspberry Pi reagiert nicht

Das hilft fast immer:

• Neustart → sudo reboot
• Stromversorgung prüfen → 5V/3A empfohlen
• SD‑Karte prüfen → manchmal defekt oder voll
• HDMI‑Kabel prüfen → sitzt es richtig?

Tipp: Wenn der Pi sehr warm wird, hilft ein kleiner Kühlkörper.

🎉 Geschafft!

Mit diesen Tipps solltest du alle typischen Probleme schnell lösen können. Dein Scream‑Frame ist jetzt nicht nur aufgebaut, sondern auch stabil und zuverlässig.

Wenn du willst, können wir jetzt noch einen optionalen Schritt machen: Autostart einrichten, damit der Scream‑Frame automatisch startet, sobald der Raspberry Pi eingeschaltet wird.

📝 Autostart-Datei öffnen

Öffne die Datei .bashrc im Home‑Verzeichnis:

nano ~/.bashrc

Scrolle ganz nach unten – dort fügen wir den Autostart ein.

⚙️ Autostart-Eintrag einfügen

Füge am Ende der Datei diesen Block ein. Er sorgt dafür, dass:

• der richtige Ordner geöffnet wird
• die venv automatisch aktiviert wird
• das Skript gestartet wird

# --- Scream Frame Autostart ---
cd /home/pi/scream_frame
source venv/bin/activate
python3 scream_frame.py

💡 Wichtig: Passe den Ordnerpfad an, falls dein Projekt woanders liegt.

💾 Speichern & testen

Speichere die Datei:

• STRG + O → speichern
• ENTER → bestätigen
• STRG + X → schließen

Starte den Raspberry Pi neu:

sudo reboot

Nach dem Neustart startet dein Scream‑Frame automatisch.

🛑 Skript stoppen

Da VLC im Vollbild läuft, musst du zuerst mit ALT + TAB zurück ins Terminal wechseln.

Danach kannst du das Skript wie gewohnt beenden:

STRG + C