Problemas frecuentes
Encuentra una comprobación inicial para los errores más comunes antes de repetir operaciones o preparar un reporte.
Guía basada en el código 2.0.1-rc.7. Las capturas muestran la interfaz en inglés de una edición de prelanzamiento; sus valores ilustran ejemplos, no necesariamente los ajustes iniciales. Los paquetes de Descargas pueden ser diferentes: revisa sus notas y las opciones de guardado antes de procesar.
En esta página
La aplicación no abre
Verifica sistema, arquitectura y que el paquete esté completo. En Windows portable, extrae todo el ZIP y conserva los archivos junto a Yagua.exe. En Linux, revisa permiso de ejecución, FUSE y la alternativa de extracción. Las instalaciones desde código necesitan su propio entorno y dependencias; instalar paquetes en otro Python no repara automáticamente un ejecutable.
Consulta Windows, Linux y el registro. Si el perfil no permite escribir logs, puede no crearse el archivo: su ausencia no es prueba de que no haya fallado.
No encuentro una herramienta o un botón
Revisa Ajustes → Módulos visibles, aplica y espera el reinicio. Amplía la ventana y desplaza los paneles; según escala y ancho, un control puede quedar más abajo. Compara tu versión con la de la guía. No existe una pestaña accesible Ajustes → Logs en la revisión documentada.
Seleccioné más archivos que los que aparecen
Comprueba el límite del módulo. OCR y Quitar Fondo permiten 10; varias operaciones permiten 100; Paleta y LQIP usan una sola imagen. Metadatos reúne hasta 100 en una lista compartida y abre una por vez. Agregar imágenes amplía esa lista; en los demás módulos, una selección nueva reemplaza la anterior.
Un archivo aparece en el diálogo pero falla
El filtro por extensión no comprueba todos los códecs o características internas. Abre el archivo en otro visor y prueba una copia PNG/JPEG. Algunas herramientas rechazan animación o varias páginas para no producir una salida incompleta. No cambies solamente el sufijo del nombre para “convertir” un archivo.
Para AVIF o ICO en Redimensionar/Recortar/Canvas, convierte primero a PNG/JPEG: el selector actual no implica que esa ruta de guardado resuelva esos formatos correctamente.
La tarea tarda o los controles están bloqueados
Espera la operación activa y revisa su estado. OCR puede cargar modelos al abrir el módulo y Quitar Fondo puede descargarlos al procesar. Imágenes grandes y varios modelos consumen memoria. Prueba un lote más pequeño o una copia menos grande; no hay un tiempo fijo garantizado ni un botón universal de cancelación.
Comprimir no reduce el peso
Puede ocurrir con imágenes optimizadas o formatos que no usan la calidad. Si la codificación pesa igual o más, Comprimir puede omitir la salida. Revisa el resumen para distinguir archivos guardados, omitidos y errores. PNG además puede reducir colores. Consulta Comprimir.
La foto quedó estirada, cortada o con márgenes enormes
Un preset de tamaño fuerza dimensiones y puede deformar. Recortar elimina bordes desde el centro. Canvas no amplía imágenes pequeñas y centra la imagen completa, incluido el espacio vacío que ya tuviera. Elige la operación adecuada y prueba una sola foto.
Perdí la transparencia
JPEG no admite alfa. LQIP y Base64 siempre producen JPEG opaco; Canvas conserva el formato de entrada y no lo convierte por elegir Transparente. Prepara PNG/WebP y verifica la salida en un visor con transparencia. El blanco o negro que dibuja un visor no siempre forma parte del archivo.
Quitar Fondo falla o deja un borde imperfecto
Comprueba conexión inicial, caché y disponibilidad de la dependencia en el paquete. La selección de modelo y el refinamiento son automáticos; no hay pincel o umbral manual. Mejores contraste y encuadre pueden ayudar, pero los objetos transparentes o muy parecidos al fondo pueden requerir otra herramienta de retoque.
OCR devuelve errores o no encuentra texto
Elige el idioma del contenido, no el idioma de la interfaz. Solo se ofrecen español, inglés o ambos. Usa una imagen nítida, sin perspectiva extrema y con letras suficientes. Columnas, manuscritos y fondos complejos pueden fallar. AVIF puede omitirse si falta soporte; prueba una copia PNG/JPEG. Revisa el texto, incluidas cifras y signos.
El editor EXIF no borra un campo o no permite guardar
Un campo vacío se ignora, no se elimina. Para GPS hay una casilla de eliminación; para limpieza general existe Limpiar lote. Los campos numéricos necesitan valores válidos y el GPS necesita latitud y longitud juntas. Si nada guardable cambió, puede avisar que no hay cambios. Revisa el nombre sobre el formulario, las marcas, el alcance de Guardar… y el selector Guardado antes de confirmar.
Renombrar omitió archivos
Si un nombre ya está ocupado, se omite el conflicto. No se añade contador automáticamente. Puede haber resultados parciales y archivos que ya tenían el nombre propuesto. Revisa la carpeta y vuelve a cargar antes de repetir; no existe deshacer automático.
No puedo copiar todo el código LQIP/Base64
Usa Copiar código, no una selección parcial de la vista abreviada. La exportación también conserva el resultado completo. Si el portapapeles no se puede verificar, exporta TXT o JSON. Cambiar parámetros invalida el resultado: genera de nuevo. Elige entre Data URI y Base64 puro según lo que espera el destino.
No detecta una actualización
Revisa plataforma y versión; RC.4/RC.5 tienen un comprobador anterior. Una consulta fallida no prueba que no haya paquetes nuevos. Abre Releases y compara las publicaciones manualmente.
Si el problema continúa, prepara un ejemplo mínimo sin datos sensibles y sigue Registros y reportes.