Da dove cominciare
- Apri «Impostazioni» → «Strumenti», fai clic su «Scegli script…» nella riga «Il tuo script» e scegli un file di script. Sul desktop compare un riquadro script che esegue subito lo script una volta. Anche «Nuovo strumento» → «Il tuo script…» nel menu dell’icona nell’area di notifica fa lo stesso.
- Puoi anche partire da un esempio. Aggiungine uno come «Meteo», poi fai clic destro sul suo riquadro e seleziona «Modifica script». Lo script si apre nel Blocco note. Modificalo e salvalo, poi seleziona «Esegui ora».
Quali script funzionano
PowerShell (.ps1), Python (.py, .pyw), file batch (.cmd, .bat), JavaScript (.js) e programmi (.exe) funzionano tutti. Per Python e JavaScript devi prima installare Python e Node.js.
Uno script viene eseguito nella sua cartella e non apre finestre. Se uno script PowerShell contiene lettere accentate o emoji, salvalo come «UTF-8 con BOM», altrimenti questi caratteri si vedono sbagliati. Nel Blocco note scegli «Salva con nome» e seleziona questa opzione in «Codifica».
Quanto dura e ogni quanto
Ogni volta uno script viene eseguito per al massimo 10 secondi. Dopo 10 secondi PecoFence lo ferma e il riquadro lo segnala.
Fai clic destro sul riquadro e scegli ogni quanto viene eseguito in «Intervallo di esecuzione»: 1, 5, 15 o 30 minuti, oppure 1 o 3 ore. Il valore predefinito è 30 minuti. «Esegui ora» lo esegue subito una volta.
Un riquadro mostra al massimo 40 righe, ognuna di al massimo 300 caratteri. La riga in fondo al riquadro mostra il nome dello script e l’ora dell’ultima esecuzione.
Un esempio completo
Salva le righe qui sotto come file .ps1, poi sceglilo in «Il tuo script». Ogni riga che lo script stampa diventa una riga nel riquadro.
# I miei link. Salvalo come «UTF-8 con BOM».
"Oggi è $(Get-Date -Format 'dddd d MMMM') | icon=📅"
"---"
"Manuale di PecoFence | href=https://pecofence.jiang.jp/it/manual/ icon=📖"
"Apri Download | open='$env:USERPROFILE\Downloads' icon=📁"
"Copia il mio indirizzo email | [email protected] icon=✉️"
"Unità C: $([int]((Get-PSDrive C).Free / 1GB)) GB liberi | color=green"
Il testo prima della barra | è quello che il riquadro mostra. Dopo la barra vengono i parametri, scritti come parametro=valore. Se un valore contiene spazi, mettilo tra virgolette. Una riga senza barra si vede come semplice testo.
Rendere cliccabile una riga o cambiarne l’aspetto
| Cosa scrivere | Cosa fa |
href=indirizzo web | Un clic apre l’indirizzo web nel browser |
open=percorso | Un clic apre il file o la cartella. Un percorso senza lettera di unità parte dalla cartella dello script |
run=programma param1=argomento | Un clic avvia il programma senza finestra. Scrivi gli argomenti come param1=, param2=… |
copy=testo | Un clic copia il testo |
action=valore | Un clic esegue di nuovo lo script con questo valore, vedi la sezione seguente |
refresh=true | Dopo il clic lo script viene eseguito di nuovo. Si può combinare con uno qualsiasi dei parametri qui sopra |
color=colore | Il colore del testo: red, green, orange, yellow, blue, purple, gray, oppure #rrggbb |
icon=testo | Compare all’inizio della riga, per esempio un’emoji |
tooltip=testo | Il suggerimento che compare quando il puntatore resta sulla riga |
Una riga con solo --- | Disegna una linea di separazione |
[ ] o [x] a inizio riga | Diventa una casella di attività, [x] è spuntata |
Se una riga ha più parametri cliccabili, conta solo il primo, in questo ordine: href, open, run, copy, action. Questo formato viene da SwiftBar, uno strumento per la barra dei menu di macOS.
Eseguire di nuovo lo script con un clic
Quando fai clic su una riga con action=, PecoFence esegue subito di nuovo lo script e gli passa il valore in PECOFENCE_ACTION. Lo script legge prima questo valore, fa quello che serve e poi stampa come al solito. Nelle esecuzioni programmate e con «Esegui ora» il valore è vuoto.
# Conta bicchieri d’acqua: ogni clic aggiunge un bicchiere
$file = Join-Path $env:PECOFENCE_DATA 'count.txt'
$n = if (Test-Path $file) { [int](Get-Content $file) } else { 0 }
if ($env:PECOFENCE_ACTION -eq 'add') { $n++; Set-Content $file $n }
"Bicchieri d’acqua oggi: $n"
"Ancora un bicchiere | action=add icon=💧"
Con le attività è lo stesso: fai clic sulla casella di un’attività con action= e viene spuntata subito. Alla fine conta quello che lo script stampa la volta dopo.
Script sempre attivi
Scrivi <pecofence.type>streamable</pecofence.type> in un commento all’inizio dello script, e lo script resta sempre attivo, senza il limite di 10 secondi. Ogni riga che stampa compare subito. Dopo una riga con ~~~, la riga seguente apre una nuova schermata che sostituisce quella di prima. Il riquadro tiene le 40 righe più recenti. L’esempio «Stato del PC» è scritto così.
# <pecofence.type>streamable</pecofence.type>
# Mostra l’ora ogni secondo
while ($true) {
"~~~"
"Sono le $(Get-Date -Format 'HH:mm:ss')"
Start-Sleep -Seconds 1
}
Uno script così è sempre in esecuzione. Quando fai clic su una riga con action=, il valore arriva all’input standard dello script come una riga di testo. L’input standard è il punto da cui uno script di solito legge quello che digiti. Lo script termina quando elimini il suo riquadro, disattivi l’interruttore «Strumenti» o chiudi PecoFence. Se lo script termina da solo, il riquadro tiene quello che mostrava per ultimo, e PecoFence riavvia lo script dopo l’intervallo di esecuzione.
Variabili d’ambiente che uno script può leggere
Le variabili d’ambiente sono alcuni valori che PecoFence passa a uno script quando lo esegue. In PowerShell scrivi $env:NOME, in Python os.environ["NOME"].
PECOFENCE | Sempre 1. Uno script può usarla per capire se lo sta eseguendo PecoFence |
PECOFENCE_ACTION | Il valore action= della riga su cui hai fatto clic. Vuoto nelle esecuzioni programmate e con «Esegui ora» |
PECOFENCE_DATA | Una cartella tutta per questo riquadro, per ciò che lo script deve ricordare. PecoFence la crea da solo |
PECOFENCE_THEME | La modalità colore attuale di PecoFence: light per chiaro, dark per scuro |
PECOFENCE_FENCE | L’ID del riquadro |
PECOFENCE_DATA si trova nella cartella scripts-data della cartella di configurazione e ha come nome l’ID del riquadro. Dove si trova la cartella di configurazione è indicato in «Impostazioni» → «Disposizione e backup». Gli script di esempio sono nella cartella scripts della stessa cartella di configurazione.
Se qualcosa va storto
Quando uno script non riesce, il riquadro mostra la prima riga del messaggio di errore, e la riga in fondo indica il codice di uscita. Il riquadro lo segnala anche quando il file di script non si trova, quando questo tipo di file non si può eseguire o quando manca il programma che lo esegue (per esempio Python). Dopo aver corretto lo script, fai clic destro sul riquadro e seleziona «Esegui ora» per riprovare.