Cómo crear scripts en Affinity y gestionar tu biblioteca

Renombrar capas, repetir una modificación en varias páginas o preparar muchos archivos para exportarlos son tareas que pueden consumir más tiempo que el propio diseño. Si ya has utilizado scripts en aplicaciones creativas, probablemente te preguntes cómo crear y ejecutar scripts en Affinity y si necesitas herramientas adicionales para hacerlo.

La respuesta ha cambiado con la actualización de septiembre de 2026: Affinity incorpora un editor de scripts, además de un panel desde el que puedes tenerlos a mano y ejecutarlos. También existen gestores desarrollados por la comunidad para organizar archivos JavaScript y descubrir herramientas compartidas por otros usuarios. Vamos a distinguir qué puedes hacer dentro de Affinity y cuándo tiene sentido acudir a una aplicación externa.

Cómo funcionan los scripts en Affinity

Los scripts de Affinity se basan en JavaScript y en su propio SDK, que define las funciones disponibles para interactuar con la aplicación. Esto no significa que un archivo .jsx preparado para una aplicación de Adobe funcione directamente: aunque ambos entornos empleen JavaScript, cada uno utiliza sus propias funciones para acceder a documentos, capas y herramientas.

Affinity reúne el trabajo vectorial, la edición de píxeles y la maquetación en una misma aplicación. Por eso, un script puede intervenir en distintas partes de un documento sin tener que cambiar de programa. Puedes plantear automatizaciones para preparar piezas repetidas, actualizar elementos de una composición o generar variaciones de un trabajo, siempre dentro de las posibilidades que ofrece el SDK.

Ten presente que la función de scripting todavía está en fase beta. La documentación del SDK puede contener errores u omisiones, por lo que conviene comprobar el resultado de cada script antes de utilizarlo en un proyecto importante.

Crear y ejecutar scripts con el editor integrado

El camino más directo es utilizar el editor integrado de Affinity. La aplicación permite escribir y ejecutar scripts sin depender de Claude ni instalar Affinity Script Manager. Además, incluye una biblioteca de ejemplos que sirve para conocer la estructura de un script antes de crear uno propio.

1. Actualiza Affinity a una versión que incluya la función de scripting y abre un documento de prueba.
2. Localiza el editor y el panel de scripts en la aplicación. Si la traducción de los menús no coincide con la documentación, busca también los nombres «Scripts» o «Índices».
3. Abre uno de los ejemplos incluidos y observa qué elementos del documento utiliza y modifica.
4. Crea una versión pequeña de tu automatización, con un cambio fácil de comprobar, antes de aplicarla a varias páginas o capas.
5. Ejecuta el script y revisa el resultado. Cuando funcione como esperas, guárdalo para recuperarlo desde el panel.

Antes de escribir funciones más complejas, consulta la documentación oficial del SDK de Affinity. Es la referencia adecuada para comprobar qué operaciones existen y cómo se utilizan en la versión instalada.

Cuándo utilizar Affinity Script Manager

Affinity Script Manager es una aplicación comunitaria independiente de Affinity y Canva. Puede interesarte si acumulas muchos archivos .js, quieres mantener una biblioteca local o prefieres explorar scripts publicados por otras personas desde una sola interfaz.

El proyecto ofrece un editor basado en Ace, opciones para importar y exportar scripts y una sección de herramientas comunitarias. También dispone de Watch Mode: cuando guardas cambios en un script que ya está instalado, el gestor intenta volver a enviarlo a Affinity. Para comunicar ambas aplicaciones utiliza el puente MCP local de Affinity; esta conexión sí es necesaria para instalar scripts mediante el gestor.

Si quieres probarlo, descárgalo desde el repositorio de su desarrollador en GitHub. Puedes empezar importando un script propio a su biblioteca local y comprobar después si aparece en Affinity. Para los scripts de terceros, revisa el código y pruébalo primero sobre una copia de un documento.

Cómo compartir scripts y repositorios comunitarios

Un archivo .js que compartas mediante Affinity Script Manager puede llevar al principio un comentario con sus metadatos. El gestor utiliza esa información para mostrar el nombre y la descripción en su biblioteca. Según la documentación del proyecto, name es obligatorio, description es recomendable y version es opcional.

/**
 * name: Preparar capas para exportar
 * description: Organiza las capas seleccionadas antes de exportarlas.
 * version: 1.0.0
 */

Ese bloque solo describe el script: debajo debes añadir el código que ejecutará la tarea. Utiliza un nombre que explique lo que hace y documenta cualquier condición importante, como la necesidad de seleccionar capas antes de lanzarlo.

Si quieres mantener tu propio catálogo público compatible con el gestor, su documentación explica cómo crear un repositorio de GitHub con un archivo registry.json en la raíz. Ese registro indica dónde descargar cada script y puede incluir categorías e imágenes de muestra. El archivo featured.json es opcional y controla los destacados de ese repositorio. Para proponer un script al catálogo comunitario existente, sus responsables indican otro camino: enviar una propuesta mediante una incidencia en GitHub para su revisión.

Qué comprobar si un script no aparece o no funciona

Primero distingue dónde falla el proceso. Si utilizas el editor de Affinity y el script se ejecuta pero no produce el resultado esperado, revisa el código, el documento abierto, la selección activa y las funciones del SDK que emplea. Haz la prueba sobre un archivo sencillo antes de repetirla en un proyecto grande.

Si el problema aparece al instalar un script desde Affinity Script Manager, comprueba que Affinity está abierto y que MCP se encuentra activado con permiso para guardar scripts. El desarrollador del gestor también recomienda abrir el panel de scripts y crear al menos una categoría antes de volver a intentar la instalación.

En macOS, el gestor puede mostrar un aviso porque su aplicación no está notarizada. Si decides instalarla, obtén la descarga desde el repositorio del desarrollador, comprueba que corresponde al proyecto que quieres utilizar y sigue las indicaciones de seguridad del sistema.

Para empezar a automatizar Affinity, el editor integrado y sus ejemplos son suficientes. El gestor comunitario aporta organización y acceso a más scripts cuando tu biblioteca crece. Sea cual sea el método, conserva una copia del documento original y revisa siempre las modificaciones y exportaciones antes de entregar el trabajo.