firmar-pdf

Script Python para añadir una firma de imagen a archivos PDF de forma automática.

¿Qué hace?

Toma todos los archivos .pdf en el mismo directorio que el script y les superpone la imagen firma.png en la primera página, generando un nuevo archivo con el sufijo - firmado.pdf. No modifica los originales.

Requisitos

pip install -r requirements.txt

Uso

1. Coloca firmar_pdf.py y firma.png en la misma carpeta que los PDFs a firmar.
2. Ejecuta:

python firmar_pdf.py

Los archivos firmados se crearán en el mismo directorio con el nombre <original> - firmado.pdf.

Uso como librería

from firmar_pdf import add_signature_to_pdf

add_signature_to_pdf(
    input_pdf="documento.pdf",
    output_pdf="documento_firmado.pdf",
    signature_image="firma.png",
    page_num=0,   # página donde poner la firma (0-indexed)
    x=350,        # posición horizontal (puntos desde la izquierda)
    y=80,         # posición vertical (puntos desde abajo)
    width=180     # ancho de la firma en puntos
)

Parámetros de add_signature_to_pdf

Parámetro	Tipo	Por defecto	Descripción
input_pdf	str	—	Ruta del PDF original
output_pdf	str	—	Ruta del PDF resultante
signature_image	str	—	Ruta de la imagen de firma (PNG recomendado)
page_num	int	0	Número de página (0-indexed)
x	float	400	Posición horizontal en puntos
y	float	50	Posición vertical en puntos (desde abajo)
width	float	150	Ancho de la firma; el alto se ajusta al ratio

Notas

• La imagen de firma debe llamarse firma.png cuando se usa el script directamente.
• Se omiten automáticamente los PDFs cuyo nombre ya contenga la palabra firmado.
• Si el archivo de salida ya existe, también se omite.
• Se recomienda usar imágenes PNG con fondo transparente para un resultado más limpio.