Por dónde empezar
- Abre «Configuración» → «Herramientas», haz clic en Elegir script… en la fila Tu propio script y elige un archivo de script. Aparece un grupo de script en el escritorio, que ejecuta el script una vez al momento. «Nueva herramienta» → «Tu propio script…», en el menú de la bandeja, hace lo mismo.
- También puedes partir de un ejemplo. Agrega uno como «Tiempo», luego haz clic con el botón derecho en su grupo y elige Editar script. El script se abre en el Bloc de notas. Cuando termines los cambios, guarda y elige Ejecutar ahora.
Qué scripts funcionan
Funcionan PowerShell (.ps1), Python (.py, .pyw), archivos por lotes (.cmd, .bat), JavaScript (.js) y programas (.exe). Para Python y JavaScript, antes hay que instalar Python y Node.js.
El script se ejecuta en su propia carpeta y no abre ninguna ventana. Si un script de PowerShell contiene letras con tilde, la ñ o emoji, guárdalo como UTF-8 con BOM. Si no, esos caracteres aparecen como signos extraños. En el Bloc de notas, usa «Guardar como» y elige esa opción en «Codificación», en la parte de abajo.
Cuánto dura y cada cuánto se ejecuta
Cada vez, un script se ejecuta como máximo 10 segundos. Si pasa de 10 segundos, PecoFence lo detiene y el grupo lo indica.
Haz clic con el botón derecho en el grupo y elige cada cuánto se ejecuta en Intervalo de ejecución: 1, 5, 15 o 30 minutos, o 1 o 3 horas. El valor predeterminado es 30 minutos. Ejecutar ahora lo ejecuta una vez al momento.
Un grupo muestra como máximo 40 líneas, y cada línea, como máximo 300 caracteres. La parte inferior del grupo muestra el nombre del script y la hora de la última ejecución.
Un ejemplo completo
Guarda las líneas siguientes en un archivo .ps1 y elígelo en «Tu propio script». Cada línea que imprime el script se convierte en una línea del grupo.
# Mis enlaces. Guárdalo como «UTF-8 con BOM».
"Hoy es $(Get-Date -Format 'dddd, d/M') | icon=📅"
"---"
"Manual de PecoFence | href=https://pecofence.jiang.jp/es/manual/ icon=📖"
"Abrir Descargas | open='$env:USERPROFILE\Downloads' icon=📁"
"Copiar mi correo | [email protected] icon=✉️"
"Unidad C: $([int]((Get-PSDrive C).Free / 1GB)) GB libres | color=green"
Lo que va antes de la barra | es el texto que se muestra. Después van los parámetros, escritos como nombre=valor. Si un valor tiene espacios, ponlo entre comillas. Una línea sin barra se muestra como texto normal.
Hacer clicable una fila o cambiar su aspecto
| Qué escribir | Qué hace |
href=dirección web | Un clic abre la dirección web en el navegador |
open=ruta | Un clic abre el archivo o la carpeta. Una ruta sin letra de unidad empieza en la carpeta del script |
run=programa param1=argumento | Un clic ejecuta el programa sin abrir ninguna ventana. Sus argumentos se escriben como param1=, param2=… |
copy=texto | Un clic copia el texto |
action=valor | Un clic vuelve a ejecutar el script con este valor (consulta la sección siguiente) |
refresh=true | El script se vuelve a ejecutar después del clic. Se puede combinar con cualquiera de los anteriores |
color=color | El color del texto: red, green, orange, yellow, blue, purple, gray o #rrggbb |
icon=texto | Se muestra al principio de la fila, por ejemplo un emoji |
tooltip=texto | La descripción que aparece cuando el cursor se detiene sobre la fila |
Una línea que solo contiene --- | Dibuja una línea separadora |
[ ] o [x] al principio de la línea | Se dibuja como la casilla de una tarea. [x] es una casilla marcada |
Si una fila tiene varios parámetros de clic, solo cuenta el primero, en este orden: href, open, run, copy, action. Este formato viene de SwiftBar, una herramienta para la barra de menús de macOS.
Volver a ejecutar el script con un clic
Cuando haces clic en una fila con action=, PecoFence vuelve a ejecutar el script al momento y le pasa el valor en PECOFENCE_ACTION. El script mira primero ese valor, hace lo que corresponde y luego imprime como siempre. En las ejecuciones programadas y con «Ejecutar ahora», el valor está vacío.
# Registro de agua: cada clic suma un vaso
$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 }
"Vasos de agua hoy: $n"
"Un vaso más | action=add icon=💧"
Con las tareas pasa lo mismo: si haces clic en la casilla de una tarea con action=, se marca al instante. Lo que el script imprima a continuación decide cómo queda.
Scripts que siguen en marcha
Escribe <pecofence.type>streamable</pecofence.type> en un comentario al principio del script, y el script seguirá en marcha, sin el límite de 10 segundos. Cada línea que imprime aparece al momento. Después de una línea con ~~~, la siguiente empieza una pantalla nueva que sustituye lo que se veía. El grupo conserva las 40 líneas más recientes. El ejemplo «Estado del PC» está escrito así.
# <pecofence.type>streamable</pecofence.type>
# Muestra la hora cada segundo
while ($true) {
"~~~"
"Son las $(Get-Date -Format 'HH:mm:ss')"
Start-Sleep -Seconds 1
}
Un script así está siempre en marcha. Cuando haces clic en una fila con action=, el valor llega a la entrada estándar del script como una línea de texto. La entrada estándar es el lugar donde un script lee normalmente lo que escribes con el teclado. El script termina cuando eliminas su grupo, desactivas el interruptor «Herramientas» o cierras PecoFence. Si el script termina por sí solo, el grupo conserva lo último que mostró, y PecoFence vuelve a iniciar el script cuando pasa el intervalo de ejecución.
Variables de entorno que puede leer un script
Las variables de entorno son unos cuantos valores que PecoFence le pasa a un script al ejecutarlo. En PowerShell se escriben $env:NOMBRE, y en Python, os.environ["NOMBRE"].
PECOFENCE | Siempre 1. Un script puede usarla para saber si lo está ejecutando PecoFence |
PECOFENCE_ACTION | El valor action= de la fila en la que hiciste clic. Vacío en las ejecuciones programadas y con «Ejecutar ahora» |
PECOFENCE_DATA | Una carpeta propia de este grupo, para lo que el script necesita recordar. PecoFence la crea por ti |
PECOFENCE_THEME | El modo de color actual de PecoFence: light (claro) o dark (oscuro) |
PECOFENCE_FENCE | El identificador del grupo |
PECOFENCE_DATA está dentro de la carpeta scripts-data de la carpeta de configuración, y su nombre es el identificador del grupo. «Configuración» → «Distribución y copias de seguridad» muestra dónde está la carpeta de configuración. Los scripts de ejemplo están en la carpeta scripts de esa misma carpeta de configuración.
Si algo sale mal
Si un script falla, el grupo muestra la primera línea del error, y la parte inferior indica el código de salida. El grupo también lo indica si no encuentra el archivo del script, si ese tipo de archivo no se puede ejecutar o si no está instalado el programa que lo ejecuta (por ejemplo, Python). Cuando hayas corregido el script, haz clic con el botón derecho en el grupo y elige «Ejecutar ahora» para probar otra vez.