Ayuda

Cómo funciona

Firmín firma en tu Mac. Lee tu certificado del llavero de macOS, firma el PDF con su propio motor (PAdES, SHA-256) y guarda la copia firmada junto al original, con -firmado al final del nombre. No usa Java ni AutoFirma, y no sube el documento a ningún sitio.

Lo que no sale de tu Mac

• El PDF. Firmín lo lee y lo escribe en tu disco.
• Tu certificado y su clave. La clave privada no sale del llavero: macOS firma con ella cuando le das permiso.
• Mis datos. Se guardan en el llavero de tu Mac. Separar lo que pegas en NIF, domicilio, IBAN y demás se hace en tu Mac, sin IA.
• Tu firma manuscrita. También en el llavero, como imagen.
• Lo que escribes en los formularios. Los valores se ponen en tu Mac, también cuando la IA ayuda a reconocer los campos.

Sin conexión

Puedes firmar sin conexión a internet: la firma no consulta ningún servidor ni lleva sello de tiempo. Rellenar formularios también funciona sin conexión; solo la IA, si la activas, necesita internet.

Lo que se conecta a internet

Firmín hace dos cosas por internet, y nada más:

1. Buscar actualizaciones. Una vez al día pide a firmin.gobierto.es la lista de versiones. No envía nada tuyo. También puedes buscarlas a mano en Firmín → Buscar actualizaciones….
2. La IA, solo si la activas con tu clave de OpenRouter. Envía la estructura del formulario, nunca tus datos. Qué se envía exactamente, en Rellenar formularios.

La app no cuenta lo que haces ni envía estadísticas. El registro de lo que hace se queda en tu Mac, en ~/Library/Logs/Firmin.log.

Instalar

Necesitas macOS 13 o posterior, en un Mac con Apple Silicon o Intel, y tu certificado instalado en el llavero.

1. Descarga el DMG desde firmin.gobierto.es.
2. Ábrelo y arrastra Firmín a la carpeta Aplicaciones.
3. Abre Firmín una vez desde Aplicaciones. Esa primera vez registra el menú del Finder y enseña una bienvenida.

Firmín se actualiza sola: avisa cuando hay una versión nueva y la instala al aceptar.

Abrirla la primera vez

Apple todavía no ha notarizado Firmín, así que la primera vez macOS avisa de que no puede comprobar la app y no la abre.

1. Intenta abrirla una vez y cierra el aviso.
2. Ve a Ajustes del Sistema → Privacidad y seguridad, baja hasta el mensaje sobre Firmín y pulsa Abrir igualmente.
3. Confirma con la contraseña de tu Mac o con Touch ID.

Desde macOS 15, clic derecho → Abrir ya no se salta el aviso. Solo hace falta la primera vez: las actualizaciones llegan desde la propia app y no vuelven a pedirlo.

Con tu agente de IA

Si usas Claude Code, Codex u otro agente en tu Mac, pídele:

Instala Firmín en mi Mac siguiendo https://firmin.gobierto.es/instalar.md

Las instrucciones le explican cómo comprobar el Mac, instalar el DMG y firmar por ti con la orden firmin. Tu certificado solo se usa si lo permites en el aviso de macOS.

Firmar

Desde el Finder

Selecciona uno o varios PDF, haz clic derecho y elige Firmar con Firmín. También está en Acciones rápidas. Puedes arrastrar los PDF a la ventana de Firmín o usar Abrir con → Firmín.

Si no aparece en el menú:

1. Comprueba que Firmín está en Aplicaciones, no dentro del DMG, y ábrela una vez desde allí.
2. En la ventana de Firmín, pulsa ¿No aparece? Reiniciar el Finder.
3. Si sigue sin salir, actívalo en Ajustes del Sistema → General → Ítems de inicio y extensiones, en las extensiones del Finder. Para la acción rápida, en el Finder: clic derecho → Acciones rápidas → Personalizar… y marca Firmar con Firmín.

La ventana de firma

A la izquierda eliges cómo firmas y, si el PDF es un formulario, lo que se escribe en él; a la derecha está el documento con la firma ya colocada en el hueco que ha encontrado Firmín.

• Con certificado. La firma electrónica: tu certificado firma el documento al pulsar Firmar, y en la página va una tarjeta que lo dice. Es la que tiene validez legal y se comprueba en VALIDe.
• A mano. Tu firma manuscrita en la página, sin certificado. Se guarda como contrato-rellenado.pdf, junto al original.
• Sin firma. Solo lo que escribas, guardado igual.

En la página:

• Poner más firmas. Con Firma elegida arriba del documento, la firma sigue al puntero en transparente y un clic la pone ahí. Sobre un hueco de firma que ha encontrado Firmín, se ajusta a él. Con certificado, el documento se firma una sola vez y esa firma cubre todas.
• Moverla. Arrástrala; tira de sus esquinas para cambiar el tamaño.
• Quitarla. ⌫ quita la firma elegida, la que tiene los tiradores, o botón derecho → Quitar la firma. Con certificado y sin ninguna en la página, el PDF se firma igual. ⌘Z deshace cada cambio.
• Pasar de página. Con ← y →, o con las flechas bajo el documento. Inicio y Fin van a la primera y a la última.
• Ampliar. ⌘ y dos dedos en el trackpad, o ⌘+ y ⌘−. ⌘9 ajusta el documento a la ventana.
• El certificado. Si tienes varios, elige uno; Firmín recuerda el último. Sin firmar con él, sus datos siguen sirviendo para rellenar el formulario.
• Lo que pone la tarjeta. Tu nombre, el DNI enmascarado (***4567**), quién emitió el certificado, la fecha y la hora. En Opciones puedes mostrar el DNI completo o quitar «Firmado con firmin.gobierto.es».

Si la etiqueta «Firma» está en una tabla, la firma va en la celda vacía de su derecha. Si el documento no tiene hueco de firma, Firmín la pone debajo del último texto de la última página. Las firmas que ya tenía el PDF siguen siendo válidas.

Firma manuscrita

La primera vez que eliges A mano, Firmín te pide la firma: dibújala con el ratón, o con el trackpad pulsado, o tómala de una foto de tu firma en papel blanco (Desde una imagen…), y el papel se vuelve transparente. Se guarda en el llavero de tu Mac y va en cada firma de la página.

Es una imagen, como una firma escaneada: vale donde acepten una firma escaneada, pero no es una firma electrónica. Se cambia con Cambiar…, en la ventana de firma o en Mis datos, donde también se quita.

Lo firmado

La copia firmada se guarda junto al original: contrato.pdf queda como contrato-firmado.pdf. En la ventana de Firmín están los últimos documentos firmados. Un clic enseña uno; dos, lo abren en tu app de PDF. Volver a editar abre el original como lo firmaste, para cambiar campos o la firma, y al volver a firmar sustituye a la copia anterior.

Rellenar formularios

Experimental. Si el PDF tiene campos, Firmín escribe tu nombre, tu NIF, tu domicilio y la fecha. Lo que tiene claro lo escribe; lo que no, te lo propone en amarillo para que lo confirmes. Puedes cambiar cualquier campo antes de firmar.

Muchos formularios son una tabla sin campos, hecha en Word: «Nombre y apellidos», «DNI», «Fecha» y una celda vacía al lado de cada una. Firmín trata cada celda vacía como un campo y, al firmar, añade al PDF un campo con lo que se escribe en ella.

En los formularios de texto corrido, con líneas de puntos o guiones bajos («D./Dª ……, con domicilio en ……, nº ……»), cada línea es un campo: Firmín propone ahí tus datos o te deja escribir en ella con un clic.

En las tablas con columnas «SI» y «NO» (o «N/A»), un clic en una celda pone una X y otro la quita. Marcar «SI» desmarca el «NO» de la misma fila. Firmín no las marca nunca por su cuenta.

Si no hace falta firmarlo, elige Sin firma o A mano arriba de la ventana: el formulario se guarda con lo escrito como solicitud-rellenado.pdf, junto al original, y macOS no pide permiso para usar la clave.

Si un dato no tiene campo, o Firmín no lo encuentra, elige Texto arriba del documento y haz clic donde quieras escribirlo. Se queda elegido para escribir varios seguidos; Esc vuelve a Firma. El texto se mueve y cambia de tamaño como la firma: arrástralo, o tira de sus esquinas para agrandar la letra. Un clic en él lo corrige, ⌫ lo quita y ⌘Z deshace.

Mis datos

En Firmín, Mis datos. Pega los datos de tu empresa o los tuyos tal como los tengas (NIF, domicilio, teléfonos, IBAN, Registro Mercantil…) y Firmín los separa. Se guardan en el llavero de tu Mac. Ahí está también tu firma manuscrita, para cambiarla o quitarla.

Escribir en los campos

Haz clic en cualquier campo y escribe en él, también sin rellenar con tus datos. Tab pasa al siguiente, ↩ o un clic fuera guardan lo escrito y Esc lo descarta. Con el botón derecho, el campo se abre en una ventanita para guardar lo escrito en Mis datos.

Con IA o sin IA

Sin IA, Firmín reconoce los campos con sus propias reglas, en tu Mac. Con IA acierta más y te pregunta menos. En nuestras pruebas con 97 formularios reales, lo que Firmín escribe solo está bien 97 de cada 100 veces. Con IA pone bien dos de cada tres datos tuyos que pide un formulario; sin IA, uno de cada dos. El detalle, formulario a formulario, en el banco de pruebas.

Qué se envía. La estructura del formulario: el texto impreso junto a cada campo («Nombre completo:», «N.º IBAN:»…), el nombre interno del campo, su tipo, su posición en la página y los títulos de los apartados.

Qué no se envía. Lo que guardas en Mis datos, tu certificado, lo que se va a escribir en el formulario y el PDF. La petición va marcada para que OpenRouter solo use proveedores que no guardan los datos. En Opciones → Uso de la IA ves cada consulta tal como se envió y la respuesta que llegó.

El modelo. Jev (typesafe/jev-1.13), a través de OpenRouter. No escribe texto: para cada campo elige entre opciones cerradas, de quién es el dato y qué dato es, y da la probabilidad de cada una. Lo que da por seguro (90 % o más) se rellena; el resto queda como sugerencia. Los datos del banco se proponen siempre para confirmar. Qué se le envía y qué responde, con dos consultas reales, en Cómo consulta Firmín a Jev.

Activarla. En Opciones (⌘,), con una clave de OpenRouter, que es tuya. Firmín la comprueba y la guarda en el llavero. Cuesta unos 0,004 € por formulario, que OpenRouter cobra en dólares; en Opciones ves lo que ha costado cada consulta.

Certificados

Firmín usa los certificados del llavero de macOS (la app Acceso a Llaveros) que estén vigentes y tengan su clave privada: de persona física o de representante.

Si tienes el certificado en un archivo .p12 o .pfx, haz doble clic sobre él para instalarlo y vuelve a abrir Firmín. El DNI electrónico y las tarjetas criptográficas todavía no funcionan.

El permiso para usar la clave

La primera vez que firmas con un certificado, macOS pide permiso para usar su clave. Escribe la contraseña de tu Mac y pulsa Permitir siempre: así no vuelve a preguntar. Mientras Firmín no está notarizada, lo pide otra vez después de cada actualización.

Comprobar una firma

Sube el PDF firmado a VALIDe, el validador de la Administración, o ábrelo en Adobe Acrobat y mira el panel de firmas. La firma es PAdES-B-B con SHA-256, la misma estructura que produce AutoFirma.

Línea de comandos

La app lleva dentro la orden firmin, para firmar desde la terminal, scripts o agentes de IA con el mismo motor y la misma firma visible. Al abrir la app queda en ~/.local/bin/firmin.

firmin certs                                  # certificados del llavero, con su huella
firmin detect contrato.pdf --cert <huella>    # dónde puede ir la firma
firmin preview contrato.pdf --cert <huella> -o /tmp/vista.png
firmin sign contrato.pdf --cert <huella>      # guarda contrato-firmado.pdf

Todas las órdenes aceptan --json. Con varios certificados, --cert es obligatorio. La firma sigue pasando por el permiso de macOS para usar la clave. Todas las opciones y lo que devuelve cada orden, en la guía de firmin, que también sirve para agentes de IA.

Si algo falla

Escríbenos a [email protected] y cuéntanos qué pasa. Si puedes, adjunta el registro de Firmín, ~/Library/Logs/Firmin.log: en el Finder, Ir → Ir a la carpeta… y pega esa ruta.