📖 Manual de usuario · Generador de QSL

El Generador de QSL de la Liga de Radioaficionados de Medellín crea tarjetas QSL electrónicas a partir de tu log en formato ADIF, te deja personalizar su diseño, busca el nombre y el correo de cada corresponsal en QRZ.com y envía las QSL por Gmail. Este manual explica cada paso en el mismo orden en que aparece en la pantalla.

Flujo de trabajo resumido

1. Entra con tu indicativo.
2. Carga tu archivo ADIF.
3. Completa los datos de tu estación.
4. Diseña la QSL: fondo, logos, textos y tabla.
5. Consulta en QRZ los contactos seleccionados.
6. Envía las QSL por correo, o descárgalas.

1. Acceso por indicativo

Al abrir la aplicación escribe tu indicativo, por ejemplo HK4AAA, y pulsa Entrar o Enter. No hace falta contraseña: el indicativo solo separa tus datos de los de otros indicativos que usen el mismo navegador.

• La próxima vez que abras la página entrarás directamente con el último indicativo usado.
• ☀️ Tema claro / 🌙 Tema oscuro cambia la apariencia de la aplicación y del manual. Al principio se usa el tema de tu sistema; el que elijas queda guardado en el navegador, incluso después de usar Borrar todo. El tema no cambia el diseño de la QSL.
• Cambiar indicativo, arriba a la derecha, guarda tu trabajo y vuelve a la pantalla de acceso. Tus datos siguen guardados.
• 🗑 Borrar todo elimina los datos de todos los indicativos guardados en este navegador. Esta acción no se puede deshacer.

2. Archivo ADIF

Exporta tu log desde tu programa de registro (Log4OM, N1MM, WSJT-X, HRD, QRZ Logbook, etc.) en formato .adi o .adif. Luego arrastra el archivo al recuadro 1. Archivo ADIF, o haz clic en el recuadro para elegirlo.

• Los contactos aparecen en la tabla Contactos, todos seleccionados.
• Si el ADIF incluye tus datos (MY_GRIDSQUARE, MY_CITY, MY_RIG, etc.), se copian a Mi estación sin borrar lo que ya hayas escrito.
• El nombre del corresponsal se toma de los campos NAME_INTL o NAME del ADIF y se usa en {NOMBRE} y {NOMBRE_COMPLETO}. La columna Nombre lo marca con (ADIF). Si después consultas QRZ, se usa el nombre de QRZ.
• Si un contacto trae su correo en el campo EMAIL del ADIF, se usa directamente para el envío. La columna Correo lo marca con (ADIF) y ese indicativo no necesita consulta en QRZ.
• Al cargar un archivo nuevo se reemplaza la lista anterior de contactos.

3. Mi estación

Estos datos se imprimen en la QSL mediante variables como {MI_NOMBRE} o {RIG}. Rellena los que quieras mostrar: si un dato está vacío, el tramo correspondiente desaparece automáticamente del texto.

4. Diseño de la QSL

La tarjeta mide 1240 × 797 píxeles. La Vista previa muestra el contacto seleccionado en la tabla, o un contacto de ejemplo si aún no has cargado un ADIF.

Imagen de fondo

Haz clic en Subir imagen de fondo o arrastra una imagen al recuadro. Se recorta y ajusta automáticamente al tamaño de la tarjeta. El botón ✕ la quita y vuelve al fondo predeterminado.

Logos e iconos

• Logos: haz clic en un logo de la cuadrícula para añadirlo a la QSL; vuelve a hacer clic para quitarlo. Los activos se marcan con ✓.
• Mis iconos: sube tus propias imágenes, mejor en PNG con fondo transparente. Se reducen a 500 px como máximo y quedan guardadas en tu navegador. La ✕ pequeña de cada icono lo elimina.

Elementos

La QSL está formada por elementos: Mi indicativo, Datos de estación, Para (QSO con), Tabla del QSO, Pie, más los logos, iconos y textos que añadas.

• Seleccionar: haz clic en el elemento en la vista previa o en su botón de la lista. Queda resaltado con un recuadro naranja.
• Mover: arrástralo con el ratón o con el dedo, o escribe sus coordenadas X e Y en el editor.
• Redimensionar imágenes: arrastra el cuadrito naranja de la esquina inferior derecha.
• Ocultar: pulsa Supr o Retroceso con el elemento seleccionado, o desmarca Visible. Los logos e iconos se quitan de la QSL; actívalos de nuevo desde su cuadrícula.
• Deseleccionar: haz clic en una zona vacía del fondo.

Opciones del editor

• Textos: contenido (admite varias líneas y variables), tamaño, fuente, alineación, negrita, color, y color y grosor del borde.
• Tabla del QSO: tamaño, ancho, fuente, colores de datos, títulos y fondo, opacidad del fondo y columnas a mostrar (Indicativo, Fecha, Hora UTC, Frecuencia, Banda, Modo, RST enviado y recibido).
• Imágenes: posición, ancho y opacidad.

+ Añadir texto crea un texto nuevo en el centro de la tarjeta, que puedes eliminar desde el editor. Restablecer diseño devuelve los textos y la tabla a su diseño original y conserva los logos e iconos.

5. Variables

Las variables se escriben entre llaves y se reemplazan por los datos de cada contacto. Para insertarlas, haz clic en el campo de texto donde quieras ponerlas y luego en la variable de la lista Variables disponibles. Funcionan en los textos de la QSL y en el asunto y el mensaje del correo.

6. Contactos y descargas

• Seleccionar: marca o desmarca la casilla de cada fila. La casilla del encabezado selecciona todos los contactos visibles.
• Previsualizar: haz clic en una fila para verla en la vista previa.
• Filtrar: escribe parte de un indicativo, un modo o una banda en Filtrar….
• ⬇ en cada fila descarga la QSL de ese contacto.
• Descargar esta QSL descarga la QSL que está en la vista previa.
• 📋 Copiar imagen la copia al portapapeles para pegarla en WhatsApp, Telegram o un correo. Solo funciona en http://localhost:8000 o por https.
• Descargar seleccionadas (ZIP) genera un ZIP con las QSL de todos los contactos seleccionados.

La columna Estado muestra el resultado del envío: ✓ Enviado o ✗ Error. Debajo de la tabla hay un registro con lo que va ocurriendo.

El formato de los archivos, JPG o PNG, se elige en 5. Envío por Gmail → Formato de imagen.

7. Consulta en QRZ.com

QRZ proporciona el nombre y, si el corresponsal lo tiene público, el correo electrónico al que se enviará la QSL.

Obtener el Session ID

1. Necesitas una cuenta de QRZ.com con suscripción que incluya el XML Logbook Data. Sin suscripción, QRZ entrega datos limitados y normalmente sin correo.
2. Abre en el navegador, reemplazando tus datos:
   https://xmldata.qrz.com/xml/current/?username=TU_INDICATIVO;password=TU_CONTRASEÑA
3. Copia el valor que aparece entre <Key> y </Key>. Ese es tu Session ID.

Consultar

1. Pega el Session ID en 4. QRZ.com. Marca Recordar el Session ID si quieres que se guarde en este navegador.
2. Selecciona los contactos en la tabla y pulsa Consultar seleccionados.
3. Las columnas Nombre y Correo se completan. Los indicativos repetidos se consultan una sola vez.

• Los indicativos que ya tienen correo en el campo EMAIL del ADIF se omiten. Si todos los seleccionados lo tienen, no hace falta el Session ID.
• Si un indicativo tiene correo en QRZ y en el ADIF, se usa el de QRZ.
• Los indicativos portables, como EA8/LU7YZ/P, se reintentan con el indicativo base si QRZ no los encuentra.
• Los resultados se guardan; Limpiar caché los borra para volver a consultarlos.

8. Envío por Gmail

Crear una contraseña de aplicación

Gmail no acepta tu contraseña normal desde programas externos. Necesitas una contraseña de aplicación:

1. Activa la Verificación en dos pasos en tu cuenta de Google.
2. Entra a myaccount.google.com/apppasswords.
3. Escribe un nombre, por ejemplo “Generador QSL”, y pulsa Crear.
4. Copia la contraseña de 16 letras que te muestra Google.

Configurar el envío

1. Escribe tu Cuenta Gmail y pega la Contraseña de aplicación. Pulsa Probar para comprobar la conexión.
2. Revisa el Nombre del remitente, el Asunto y el Mensaje. Puedes usar variables; {NOMBRE} y {QSOS} son las más útiles.
3. Elige el Formato de imagen: JPG es más liviano, PNG tiene más calidad.
4. Opciones:
   • Un solo correo por indicativo: si trabajaste varias veces con la misma estación, recibe un único correo con todas sus QSL adjuntas.
   • No reenviar a los ya enviados: omite los contactos cuyo estado es ✓ Enviado.
5. Pulsa Enviar QSL por correo y confirma. Se envían solo los contactos seleccionados que tengan correo, ya sea del ADIF o de QRZ.

9. Privacidad y datos

• Todo se guarda solo en este navegador: contactos, diseño, fondo, iconos y configuración. El servidor no guarda nada: no hay base de datos ni registros con tus datos.
• El Session ID de QRZ y la contraseña de Gmail se guardan solo si marcas las casillas Recordar. Si no, se olvidan al cerrar la página.
• Como los datos viven en el navegador, no aparecen en otro equipo ni en otro navegador, y se pierden si borras los datos de navegación.
• En un equipo compartido, usa 🗑 Borrar todo al terminar.

Llevar la configuración a otro computador

En 6. Guardar / cargar configuración puedes pasar tu trabajo a otro equipo o navegador:

1. En el computador de origen pulsa 💾 Guardar configuración. Se descarga un archivo QSL_config_INDICATIVO_fecha.json.
2. Copia ese archivo al otro computador, por ejemplo con una memoria USB o por correo.
3. En el otro computador entra con tu indicativo, pulsa 📂 Cargar configuración y elige el archivo.

El archivo siempre incluye los datos de la estación, el diseño completo (fondo, logos, iconos personales y textos) y la configuración del correo (remitente, asunto, mensaje y opciones). Además puedes marcar:

• Incluir contactos, estado de envíos y datos de QRZ: para continuar el trabajo donde lo dejaste, sin volver a cargar el ADIF ni consultar QRZ.
• Incluir Session ID de QRZ y contraseña de Gmail: quedan sin cifrar dentro del archivo. Úsalo solo si guardas el archivo en un lugar seguro.

11. Solución de problemas