Eigene Keywords & Python

Eigene Keywords sind Variablen, die du selbst anlegst – in der App unter „Keywords“. Im Editor stehen sie unter „Variablen → Ventoview“ und funktionieren wie alle anderen: in Texten ({streamer}), in Bedingungen, als Wert für Balken oder Keyframe-Regler.

Woher der Wert kommt

Unter „Wert aus“ wählst du, woher ein Keyword seinen Wert bekommt. PowerShell-Befehl und Python-Code erscheinen erst, wenn du oben „Erweitert“ einschaltest – sie führen etwas auf deinem PC aus.

Wert aus	Was es macht	Sicher?
Fester Text	Ein fester Wert, z. B. dein Name oder Discord.	Ja – liest nur
Textdatei	Der Inhalt einer Textdatei, alle paar Sekunden neu gelesen. Viele Tools (Musik-Player, Bots) schreiben Infos in eine .txt-Datei.	Ja – liest nur
Webadresse	Die Antwort einer Adresse, optional ein Feld daraus (JSON-Pfad, siehe unten).	Ja – liest nur
PowerShell-Befehl (Erweitert)	Die Ausgabe eines PowerShell-Befehls – damit kommst du an fast alles, was Windows weiß.	Nur eigene Befehle!
Python-Code (Erweitert)	Eigener Python-Code, der aus anderen Variablen neue macht.	Sicherer Modus: ja. Voller Zugriff: nur eigener Code!

Fest eingebaut sind außerdem {zeit}, {datum}, {wochentag} und {laufzeit}. Unter „Beispiele zum Übernehmen“ gibt es für jede Art fertige Einträge zum Anpassen – z. B. das Wetter deiner Stadt über https://wttr.in/Heide?format=%t.

Anlegen

1. In der App „Keywords“ öffnen, „+ Keyword“.
2. Name eintragen – nur a–z, 0–9 und _. Er darf nicht so heißen wie eine Variable eines Moduls; dann wird die Zeile rot.
3. Unter „Wert aus“ die Art wählen und Text, Datei, Adresse, Befehl oder Code eintragen.
4. Bei allem außer Text: Alle … s – wie oft neu gelesen wird.
5. „Speichern“. Rechts erscheint der aktuelle Wert – oder rot der Fehler.

Umbenennen und Löschen sind geschützt: Wird ein Keyword in Designs oder Chat-Bot-Texten benutzt, fragt die App vorher und zieht eine Umbenennung überall mit.

Python

Mit Python rechnest du aus vorhandenen Variablen neue – z. B. den Ping verdoppeln, Werte runden, Texte umbauen oder etwas zählen. Du brauchst Python 3 auf dem PC: von python.org installieren und dabei den Haken bei „Add python.exe to PATH“ setzen.

So funktioniert es

• Alle Variablen sind schon da – unter ihrem Namen, ohne {}. Aus {ping} wird ping, aus {songtitle} songtitle. Zahlen kommen als Zahlen an ("42" → 42, "3,5" → 3.5), alles andere als Text.
• Den Wert setzt du mit dem Namen des Keywords. Heißt das Keyword test, schreibst du test = … (Groß/klein egal, TEST = … geht auch).
• Gibt es diese Variable am Ende nicht, zählt ergebnis = … – oder was der Code mit print(…) ausgibt.
• True/False werden zu „ja“/„nein“ – passend für Bedingungen im Editor.
• Ein Wörterbuch wird zu eigenen Variablen: test = {"min": 1, "max": 9} ergibt {test_min} und {test_max}.
• speicher ist ein Wörterbuch, das zwischen den Läufen erhalten bleibt (bis die App neu startet) – für Zähler, Höchstwerte oder Durchschnitte.
• variablen enthält alle Variablen als Wörterbuch – praktisch, wenn ein Name kein gültiger Python-Name ist: variablen["mein-wert"].
• Der Code läuft im eingestellten Abstand jedes Mal neu, höchstens 10 Sekunden lang.

Beispiele

Rechnen – Keyword doppelt:

doppelt = ping * 2

Runden und Text – Keyword temptext:

temptext = f"{round(gputemp)} °C"

Ja/Nein für Bedingungen – Keyword zuheiss (im Editor: Bedingung „zuheiss ist ja“):

zuheiss = gputemp > 80

Mehrere Fälle – Keyword lage:

if ping < 30:
    lage = "super"
elif ping < 80:
    lage = "okay"
else:
    lage = "lag!"

Zählen mit Gedächtnis – Keyword lags, alle 10 s:

if ping > 80:
    speicher["n"] = speicher.get("n", 0) + 1
lags = speicher.get("n", 0)

Zufall und Zeit – Keyword gruss:

import random
from datetime import datetime
stunde = datetime.now().hour
gruss = random.choice(["Hi", "Hey", "Moin"]) if stunde < 18 else "Guten Abend"

Fehler finden

Läuft der Code nicht, steht der Fehler rot in der Vorschau – mit der Zeile in deinem Code, z. B. NameError: name 'pnig' is not defined (Zeile 1) (Tippfehler im Namen). Häufig:

• NameError: Variable gibt es (noch) nicht – Name prüfen, und ob das Modul dazu läuft.
• TypeError bei Rechnen: der Wert ist Text statt Zahl, z. B. weil die Variable gerade leer ist. Abhilfe: float(ping or 0).
• IndentationError: Einrückung uneinheitlich – im Feld rückt Tab um 4 Leerzeichen ein.
• „Python 3 nicht gefunden“: Python installieren (Haken bei „Add to PATH“), dann die App neu starten.

Sicherer Modus und voller Zugriff

Python-Keywords laufen standardmäßig im sicheren Modus. Erlaubt ist alles zum Rechnen und für Text, Listen und Wörterbücher, dazu diese Module: math, random, statistics, datetime, time, json, re, decimal, fractions, itertools, collections, functools, string, textwrap, calendar, operator, bisect, heapq, cmath.

Gesperrt sind Dateien (open), andere Module (os, subprocess, Netzwerk …), eval/exec und Python-Interna (alles mit _ am Anfang). Statt "…".format() nimmst du f-Strings: f"{wert} ms".

Brauchst du mehr – z. B. eine Datei lesen oder eine Webseite abfragen –, setzt du beim Keyword den Haken „Voller Zugriff“. Dann darf der Code alles, was du auf diesem PC darfst.

Voller Zugriff und PowerShell-Befehle laufen mit deinen Rechten: Sie können Dateien löschen, Programme starten und Daten verschicken. Trag nur Code ein, den du selbst geschrieben hast oder Zeile für Zeile verstehst – niemals Code aus Chat, Discord oder von Fremden. Der sichere Modus schützt vor Versehen und einfachem fremdem Code, ist aber kein perfekter Käfig.

Webadresse und JSON-Pfad

Liefert eine Adresse JSON, holt der Pfad ein Feld heraus: data.title, items[0].name – oder er sucht im ganzen Baum: **[Text~Tctl].Value nimmt das erste Objekt, dessen Feld „Text“ „Tctl“ enthält, und davon „Value“.

Beispiel CPU-Temperatur: Windows liefert sie nicht selbst. Das kostenlose LibreHardwareMonitor (offiziell auf github.com/LibreHardwareMonitor) als Administrator starten und unter Options → Remote Web Server → Run einschalten. Dann das Beispiel „CPU-Temperatur“ übernehmen – bei Intel statt Tctl den Pfad **[Text~CPU Package].Value.

Sicherungen

Keywords kommen in die komplette Sicherung (.vview) mit. Enthält eine Sicherung PowerShell- oder Python-Keywords, warnt die App vor dem Laden – lade nur Sicherungen, die von dir stammen.