Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Procesador de Fotos SAT/CURP

Aplicación de escritorio para convertir fotografías al formato digital exigido por el gobierno mexicano (SAT, CURP/RENAPO, CONOCER y otros trámites federales).


Requisitos del sistema

  • Windows 10 u 11 (64 bits)
  • Para ejecutar el .exe: ningún requisito adicional
  • Para ejecutar desde el código fuente: Python 3.11 o superior y uv

Instalación y ejecución

Ejecutable (usuarios finales)

  1. Copie SATPhotoProcessor.exe a cualquier carpeta.
  2. Haga doble clic para abrir el programa.
  3. La configuración se guarda automáticamente en config.json, en la misma carpeta que el .exe.

Uso del programa

  1. Seleccionar carpeta — haga clic en el botón y elija la carpeta que contiene las fotografías originales.
  2. Configuración (opcional) — ajuste los parámetros antes de procesar (ver sección siguiente).
  3. Iniciar procesamiento — el programa revisa cada imagen y la clasifica:
Carpeta Contenido
resultados_ok/ Fotografías convertidas y listas para el trámite
orig_ok/ Originales de las fotos procesadas exitosamente
orig_mal/ Originales de las fotos que no pudieron procesarse

El registro de actividad muestra en verde cada éxito (tamaño final y calidad JPEG) y en rojo cada error con el motivo exacto del rechazo.


Especificaciones oficiales SAT/CURP

El programa convierte las fotografías para cumplir con los siguientes requisitos:

Parámetro Valor requerido
Formato JPEG
Dimensiones 640 × 480 píxeles
Resolución 300 DPI (mínimo oficial: 90 DPI)
Tamaño de archivo 20 KB – 300 KB
Fondo Blanco, sin texturas ni sombras
Color RGB (color, no escala de grises)

Fuente: Especificaciones publicadas por CONOCER, SAT y RENAPO para trámites digitales de RFC, CURP y certificación de competencias laborales.


Parámetros de configuración

Accesibles desde el botón Configuración ⚙ en la ventana principal.

Geometría de salida

Parámetro Valor por defecto Descripción
Ancho 640 px Ancho de la imagen de salida
Alto 480 px Alto de la imagen de salida
DPI 300 Resolución embebida en el archivo

No modifique estos valores a menos que un trámite específico indique dimensiones distintas.

Límites de tamaño de archivo

Parámetro Valor por defecto Descripción
Tamaño mínimo 20 KB Archivos más pequeños serán rechazados por el portal
Tamaño máximo 300 KB Archivos más grandes serán rechazados por el portal

Ajuste de calidad JPEG

El programa ajusta automáticamente la calidad JPEG para que el archivo quede dentro del rango de tamaño permitido.

Parámetro Valor por defecto Descripción
Calidad inicial 85 Punto de partida (1–95). 85 es un buen equilibrio entre nitidez y tamaño
Calidad mínima 10 Límite inferior; por debajo de ~20 aparecen artefactos visibles
Calidad máxima 95 Límite superior; 95 es prácticamente sin pérdida
Paso de calidad 5 Incremento por iteración al afinar el tamaño

Control de ampliación

Parámetro Valor por defecto Descripción
Factor máximo de ampliación 3.0× Rechaza imágenes demasiado pequeñas para ampliar sin pixelarse. Con el valor 3.0, una imagen debe medir al menos ~213 × 160 px para ser aceptada

Detección de desenfoque

Parámetro Valor por defecto Descripción
Activar verificación Rechaza automáticamente fotos borrosas
Umbral de nitidez 50.0 Puntuación mínima de bordes. Fotos nítidas suelen superar 100; fotos borrosas bajan de 30

Si el programa rechaza fotos que visualmente se ven aceptables, reduzca el umbral de nitidez o desactive la verificación temporalmente.

Formato de salida

  • JPEG (predeterminado y requerido por SAT/CURP)
  • PNG — lossless, pero puede superar el límite de 300 KB; úselo solo si un trámite específico lo exige

Pre-requisitos de las fotografías originales

Para que el procesamiento sea exitoso, las fotos originales deben cumplir las siguientes condiciones:

Contenido de la fotografía

  • ✅ Foto reciente (no mayor a 6 meses)
  • ✅ Fondo blanco o muy claro, sin texturas, patrones ni paisajes
  • ✅ Buena iluminación, sin sombras sobre el rostro ni el fondo
  • ✅ Rostro centrado, visible desde los hombros, mirando de frente
  • ✅ Ojos abiertos y visibles
  • ✅ Cabello recogido o detrás de los hombros (sin cubrir el rostro)
  • ✅ Sin accesorios que obstruyan rasgos faciales (lentes oscuros, sombreros, cubrebocas)
  • ✅ Expresión neutral, boca cerrada
  • ❌ Sin efectos de edición, filtros ni marcos decorativos

Calidad técnica del archivo original

  • Formato aceptado: JPG, PNG, BMP, TIFF
  • Resolución mínima recomendada: 800 × 600 px (para evitar pixelación al convertir a 640 × 480)
  • Tamaño mínimo recomendado: al menos 213 × 160 px (límite del factor de ampliación 3×)
  • Nitidez: la imagen debe estar enfocada; fotos movidas o borrosas serán rechazadas
  • Color: RGB; las fotos en escala de grises se convierten automáticamente a color

Razones comunes de rechazo y cómo resolverlas

Error en el registro Causa probable Solución
Imagen demasiado borrosa Foto tomada con movimiento o mal enfoque Tome una nueva foto con la cámara quieta y buena luz
Imagen demasiado pequeña para ampliar Foto de muy baja resolución Use una imagen de al menos 300 × 300 px
No se puede ajustar al rango de KB Imagen con ruido extremo o patrón muy complejo Tome la foto con menos ruido digital (mejor iluminación)
cannot identify image file Archivo dañado o con extensión incorrecta Verifique que el archivo se abra en el visor de fotos de Windows

Sugerencias para obtener fotografías que cumplan los requisitos

Captura con teléfono inteligente

  1. Use la cámara trasera (mayor resolución que la frontal).
  2. Coloque al sujeto frente a una pared blanca bien iluminada.
  3. Use luz natural de frente, evite sombras.
  4. Mantenga el teléfono a la altura de los ojos, a ~60 cm de distancia.
  5. Active el modo retrato o el temporizador para evitar movimiento.
  6. Guarde en la máxima calidad disponible (JPG o PNG).

Captura con escáner (fotografías físicas impresas)

  • Escanee a 300 DPI o superior.
  • Use el modo color RGB (no blanco y negro).
  • Guarde como JPG o PNG sin compresión adicional.

Edición previa recomendada (opcional)

Si la foto tiene fondo de color distinto al blanco, puede reemplazarlo antes de procesar con herramientas gratuitas como:

  • remove.bg — elimina el fondo automáticamente; luego exporte con fondo blanco
  • Canva — permite ajustar y exportar con fondo blanco
  • Paint.NET o GIMP — herramientas de escritorio gratuitas para edición manual

El programa no reemplaza el fondo; solo redimensiona y convierte. Si la foto original tiene fondo de color, el archivo resultante también lo tendrá.

Verificación final antes de subir al portal

Tras el procesamiento, revise las imágenes en resultados_ok/ con el Explorador de Windows:

  1. Clic derecho en la imagen → Propiedades → pestaña Detalles
  2. Confirme: Ancho 640, Alto 480, Resolución horizontal/vertical 300 DPI
  3. Confirme que el tamaño del archivo esté entre 20 KB y 300 KB

Estructura de carpetas generada

carpeta-seleccionada/
├── foto1.jpg              ← originales (se mueven al procesar)
├── foto2.png
├── resultados_ok/         ← fotos convertidas y listas para subir
│   ├── foto1.jpg
│   └── foto2.jpg
├── orig_ok/               ← originales de las fotos exitosas
│   ├── foto1.jpg
│   └── foto2.png
└── orig_mal/              ← originales de las fotos con error
    └── foto_borrosa.jpg

Créditos

Procesador de Fotos SAT/CURP Copyright 2026. Alberto Yañez — albyanez@gmail.com

About

Format images in accordance with government requirements

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages