immich-autotag
Motor de reglas para organizar por lotes bibliotecas de fotos y videos en Immich: crea álbumes, asigna etiquetas, corrige fechas desde un archivo de configuración YAML.
Ficha actualizada 22 sept 2026, 18:04 · upstream 22 sept 2026, 16:08 · release sin release detectada
Qué es immich-autotag
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Immich AutoTag es un motor de reglas diseñado para aplicar cambios por lotes a activos (imágenes y vídeos) en la plataforma open source Immich. Permite crear y asignar álbumes automáticamente, generar y asignar etiquetas, corregir fechas basándose en análisis de duplicados o patrones de nombres de archivos, y asignar permisos automáticamente. Todo ello se configura mediante un archivo YAML personalizado.
La herramienta está orientada a usuarios que gestionan grandes volúmenes de medios importados desde sistemas antiguos o aplicaciones externas, donde la organización manual resulta lenta y tediosa. Proporciona capacidades no disponibles por defecto en Immich, como la detección de conflictos de clasificación, corrección automática de fechas y gestión de permisos por grupos de usuarios.
El proyecto soporta múltiples métodos de ejecución: mediante pipx (sin descarga de código), Docker (con imágenes oficiales o locales) y directamente desde el repositorio local. Incluye scripts para ejecución única o en bucle, ideal para automatización nocturna con cron. Se recomienda usar la imagen pipx si se encuentran problemas de acceso a la API de Immich en ciertas versiones de Docker.
- Organizar automáticamente una biblioteca de fotos importada desde Google Photos o NAS sin perder metadatos
- Corregir fechas de activos basándose en patrones de nombres de archivo (ej. Android, WhatsApp)
- Asignar permisos de álbumes a grupos de usuarios mediante reglas por palabras clave
- Detectar y etiquetar activos con conflictos de clasificación o duplicados para revisión manual
- Motor de reglas flexible basado en configuración YAML sin necesidad de código personalizado
- Soporte nativo para ejecución continua vía cron o scripts en bucle
- Generación automática de enlaces directos a álbumes y etiquetas con conflictos en la interfaz de Immich
- Logs detallados de modificaciones y estadísticas para auditoría del proceso de organización
- Conocida inestabilidad al acceder a la API de Immich en la imagen Docker versión 0.80.3 (ver Issue #43)
- La imagen cron debe construirse y publicarse manualmente antes de usarla como txemi/immich-autotag:cron
- Requiere configuración manual del archivo YAML; no incluye interfaz gráfica para edición de reglas
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para despliegue rápido, use pipx run immich-autotag si tiene Python instalado. Para Docker, use scripts como run_docker_public.sh o configure docker-compose.yml con la variable CRON_SCHEDULE para automatización periódica. Asegúrese de montar el volumen ~/.config/immich_autotag en el contenedor. Evite la imagen Docker 0.80.3 si tiene problemas de acceso a la API; use pipx como alternativa estable.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.