labelito
Self-hosted solution para impresión de etiquetas en impresoras Brother QL. Utiliza plantillas YAML declarativas, interfaz web y API HTTP para integrarse con Home Assistant o scripts. Soporta previsualización en vivo y gestión de historial de impresión.
Ficha actualizada 27 sept 2026, 8:05 · upstream 27 sept 2026, 8:00 · release v0.19.0
Qué es labelito
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
labelito es una herramienta auto-alojada diseñada específicamente para impresoras Brother QL (como el modelo QL-810W). Permite definir etiquetas mediante plantillas YAML, ofreciendo carga dinámica sin necesidad de reconstruir la imagen del contenedor. La aplicación incluye una interfaz web para seleccionar plantillas y rellenar campos, además de una API RESTful para automatizaciones externas.
La arquitectura se basa en Docker con soporte para FastAPI (Python) y Next.js, ejecutándose en el puerto 8765. Incluye mecanismos de seguridad como tokens API o autenticación básica web, y verifica el estado de la impresora antes de imprimir para evitar errores por rollos incorrectos. Soporta integración nativa con Home Assistant mediante comandos REST o intenciones de voz.
Las plantillas soportan fechas automáticas, iconos y múltiples idiomas. El sistema gestiona historial de impresión en modo memoria o archivo persistente. Es ideal para entornos domésticos (Home Lab) o pequeñas empresas que requieren etiquetado rápido sin depender de soluciones en la nube.
- Impresión de etiquetas de congelador con fecha automática desde Home Assistant
- Generación de etiquetas de activos o cables mediante scripts personalizados
- Previsualización de diseños de etiquetas antes de gastar material físico
- Gestión de inventario local sin conexión a internet (self-hosted)
- Actualización de etiquetas en tiempo real tras cambios en la base de datos
- API HTTP robusta con endpoints para previsualización, impresión y estado de la impresora
- Verificación del rollo cargado antes de imprimir mediante SNMP o consulta USB
- Plantillas YAML hot-reloadables sin reiniciar el contenedor
- Integración nativa con Home Assistant vía rest_command o intenciones de voz
- Soporte para múltiples modelos de Brother QL (19 modelos en brother_ql_next)
- Interfaz web intuitiva con previsualización en vivo y gestión de plantillas
- Requiere configuración manual de variables de entorno (API_TOKEN, PRINTER_URI) al iniciar
- No expone el puerto 8765 a internet público sin proxy TLS o autenticación adecuada
- Depende del soporte SNMP para impresoras de red para verificar estado correcto
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Ejecutar con Docker Compose, asegurando que el puerto 8765 esté protegido (API_TOKEN o ALLOW_UNAUTHENTICATED). Configurar PRINTER_URI según el modelo (tcp://ip:9100 o usb://). Montar volúmenes para templates y datos de historial. Usar proxy inverso TLS si se expone a red externa. Verificar permisos UID/GID en el host Linux para escritura en ./data.
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.