Keyword personali e Python

I keyword personali sono variabili che crei tu – nell'app in “Keywords”. Nell'editor si trovano in “Variabili → Ventoview” e funzionano come tutte le altre: nei testi ({streamer}), nelle condizioni, come valore per barre o regolatori keyframe.

Da dove arriva il valore

In “Valore da” scegli da dove una keyword prende il suo valore. Comando PowerShell e Codice Python appaiono solo se in alto attivi “Avanzate” – eseguono qualcosa sul tuo PC.

Valore da	Cosa fa	Sicuro?
Testo fisso	Un valore fisso, es. il tuo nome o Discord.	Sì – legge soltanto
File di testo	Il contenuto di un file di testo, riletto ogni pochi secondi. Molti strumenti (player musicali, bot) scrivono informazioni in un file .txt.	Sì – legge soltanto
Indirizzo web	La risposta di un indirizzo, facoltativamente un suo campo (percorso JSON, vedi sotto).	Sì – legge soltanto
Comando PowerShell (Avanzate)	L'output di un comando PowerShell – arrivi a quasi tutto ciò che Windows sa.	Solo comandi tuoi!
Codice Python (Avanzate)	Codice Python tuo che crea nuove variabili da altre.	Modalità sicura: sì. Accesso completo: solo codice tuo!

Integrate ci sono anche {zeit}, {datum}, {wochentag} e {laufzeit}. In “Esempi da usare” trovi voci pronte per ogni tipo – es. il meteo della tua città con https://wttr.in/Heide?format=%t.

Creare

1. Nell'app apri “Keywords”, “+ Keyword”.
2. Inserisci il nome – solo a–z, 0–9 e _. Non può chiamarsi come una variabile di un modulo; altrimenti la riga diventa rossa.
3. In “Valore da” scegli il tipo e inserisci testo, file, indirizzo, comando o codice.
4. Per tutto tranne il testo: Ogni … s – ogni quanto viene riletto.
5. “Salva”. A destra appare il valore attuale – o l'errore in rosso.

Rinominare ed eliminare sono protetti: se un keyword è usato in design o testi del chat bot, l'app chiede prima e applica la ridenominazione ovunque.

Python

Con Python calcoli nuove variabili da quelle esistenti – es. raddoppiare il ping, arrotondare valori, rielaborare testi o contare qualcosa. Ti serve Python 3 sul PC: installalo da python.org spuntando “Add python.exe to PATH”.

Come funziona

• Tutte le variabili sono già presenti – con il loro nome, senza {}. {ping} diventa ping, {songtitle} songtitle. I numeri arrivano come numeri ("42" → 42, "3,5" → 3.5), tutto il resto come testo.
• Il valore lo imposti con il nome del keyword. Se il keyword si chiama test, scrivi test = … (maiuscole/minuscole indifferenti, va anche TEST = …).
• Se alla fine questa variabile non esiste, vale ergebnis = … – o ciò che il codice stampa con print(…).
• True/False diventano “ja”/“nein” – adatti alle condizioni nell'editor.
• Un dizionario diventa variabili separate: test = {"min": 1, "max": 9} dà {test_min} e {test_max}.
• speicher è un dizionario che resta tra un'esecuzione e l'altra (fino al riavvio dell'app) – per contatori, massimi o medie.
• variablen contiene tutte le variabili come dizionario – utile se un nome non è un nome Python valido: variablen["mein-wert"].
• Il codice viene rieseguito ogni volta all'intervallo impostato, al massimo per 10 secondi.

Esempi

Calcolare – keyword doppelt:

doppelt = ping * 2

Arrotondare e testo – keyword temptext:

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

Sì/no per le condizioni – keyword zuheiss (nell'editor: condizione “zuheiss è ja”):

zuheiss = gputemp > 80

Più casi – keyword lage:

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

Contare con memoria – keyword lags, ogni 10 s:

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

Caso e tempo – keyword gruss:

import random
from datetime import datetime
stunde = datetime.now().hour
gruss = random.choice(["Ciao", "Ehi", "Salve"]) if stunde < 18 else "Buonasera"

Trovare gli errori

Se il codice non funziona, l'errore appare in rosso nell'anteprima – con la riga del tuo codice, es. NameError: name 'pnig' is not defined (Zeile 1) (errore di battitura nel nome). Frequenti:

• NameError: la variabile non esiste (ancora) – controlla il nome e se il suo modulo è attivo.
• TypeError nei calcoli: il valore è testo invece di numero, es. perché la variabile è vuota. Soluzione: float(ping or 0).
• IndentationError: rientro non uniforme – nel campo Tab rientra di 4 spazi.
• “Python 3 non trovato”: installa Python (spunta “Add to PATH”), poi riavvia l'app.

Modalità sicura e accesso completo

I keyword Python girano di default in modalità sicura. È permesso tutto per calcoli, testo, liste e dizionari, più questi moduli: math, random, statistics, datetime, time, json, re, decimal, fractions, itertools, collections, functools, string, textwrap, calendar, operator, bisect, heapq, cmath.

Bloccati sono i file (open), altri moduli (os, subprocess, rete …), eval/exec e gli interni di Python (tutto ciò che inizia con _). Invece di "…".format() usa le f-string: f"{wert} ms".

Se ti serve di più – es. leggere un file o interrogare un sito – spunta “Accesso completo” sul keyword. Allora il codice può fare tutto ciò che puoi fare tu su questo PC.

Accesso completo e comandi PowerShell girano con i tuoi permessi: possono eliminare file, avviare programmi e inviare dati. Inserisci solo codice scritto da te o che capisci riga per riga – mai codice dalla chat, da Discord o da sconosciuti. La modalità sicura protegge da errori e da semplice codice altrui, ma non è una gabbia perfetta.

Indirizzo web e percorso JSON

Se un indirizzo restituisce JSON, il percorso estrae un campo: data.title, items[0].name – oppure cerca in tutto l'albero: **[Text~Tctl].Value prende il primo oggetto il cui campo “Text” contiene “Tctl”, e da questo “Value”.

Esempio temperatura CPU: Windows non la fornisce da solo. Avvia il gratuito LibreHardwareMonitor (ufficiale su github.com/LibreHardwareMonitor) come amministratore e attiva Options → Remote Web Server → Run. Poi usa l'esempio “Temperatura CPU” – con Intel invece di Tctl il percorso **[Text~CPU Package].Value.

Backup

I keyword finiscono nel backup completo (.vview). Se un backup contiene keyword PowerShell o Python, l'app avvisa prima di caricarlo – carica solo backup che provengono da te.