Integración domótica Trilium Notes, gratuita y de código abierto
Sus notas de Trilium en Gladys: contadores, tareas, notas modificadas, diario del día desde escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conecte Gladys a Trilium Notes (TriliumNext), la aplicación autoalojada de toma de notas jerárquica: siga sus contadores y sus tareas abiertas, reaccione cuando se crea o modifica una nota, cree notas desde sus escenas y lleve un diario de la casa en la nota del día de Trilium, que Gladys rellena línea a línea. Todo se queda en su red local: Gladys habla directamente con su servidor Trilium, a través de su ETAPI.
Probada con un TriliumNext v0.106.1 real (la imagen Docker
triliumnext/trilium). Sus comentarios son bienvenidos en el foro de Gladys.
Requisitos previos
- Gladys Assistant 5.1 o posterior.
- Un servidor Trilium accesible desde la máquina de Gladys: TriliumNext (probado con 0.106.1; las versiones anteriores con ETAPI deberían funcionar, sin probar). La aplicación de escritorio sola no tiene servidor: use su edición servidor o un servidor de sincronización.
- Un token ETAPI: en Trilium, abra Opciones → ETAPI y haga clic en Crear un nuevo token ETAPI. Cópielo: solo se muestra una vez.
Configuración
- Abra la pestaña Configuración de la integración.
- En Dirección de Trilium, introduzca la dirección en la que abre
Trilium, por ejemplo
192.168.1.50:8080ohttps://notes.example.org. - Pegue el Token ETAPI.
- Leer Trilium cada: 5, 15 (por defecto), 30 o 60 minutos. Las notas modificadas se anuncian en la siguiente lectura.
- Etiqueta de las tareas: la etiqueta de sus tareas,
todopor defecto. Una tarea está abierta mientras la nota lleva esta etiqueta y no la etiqueta#done. - Idioma de nombres y mensajes fija los nombres de las funciones (definidos al añadir el dispositivo) y los textos de la integración. Francés por defecto.
- Guarde y use Probar la conexión: muestra la versión de Trilium y el número de notas.
- En la pestaña Descubrimiento, añada el dispositivo Trilium.
Dispositivos
Trilium (un dispositivo para el servidor):
| Función | Valor |
|---|---|
| Notas | número de notas (salvo las archivadas y ocultas) |
| Notas modificadas hoy | notas creadas o modificadas desde medianoche |
| Tareas abiertas | notas con la etiqueta de tareas y sin #done |
| Última nota modificada | título de la última nota creada o modificada |
Los contadores conservan su historial. El dispositivo conserva su identidad cuando cambia la dirección del servidor.
Widget del panel
Trilium: tres casillas (notas, modificadas hoy, tareas) y las ocho últimas
notas modificadas, con la hora del cambio. En los ajustes del widget,
Etiqueta (por ejemplo todo o compras) lista en su lugar las notas que
la llevan y no #done: una lista de tareas en el panel. Ocultar los
contadores deja solo la lista. Cuando se accede a Trilium por https, cada
nota se abre en Trilium.
Disparadores de escena
- Nota de Trilium creada o modificada: se crea o modifica una nota en Trilium. Filtro: Cambio (creada, modificada o vacío: ambos).
- Nota de Trilium etiquetada modificada: lo mismo, para las notas con una
etiqueta: Etiqueta (obligatoria, el nombre de la etiqueta sin
#, exactamente como en Trilium, p. ej.todo) y Cambio. Cuentan las etiquetas heredadas y las de una plantilla. Una nota con varias etiquetas se dispara una vez por nombre de etiqueta: una escena configurada con una etiqueta se ejecuta una sola vez.
Variables: Título de la nota, Cambio (created o updated),
Dirección de la nota, Etiquetas (las de la propia nota, como
#nombre=valor), Id. de la nota y Etiqueta para el segundo
disparador.
La primera lectura tras la instalación es silenciosa: las notas ya existentes no se anuncian. Las notas escritas por esta integración nunca se anuncian. Se anuncian como máximo diez notas por lectura, las más antiguas primero; las siguientes esperan a la próxima lectura. Más allá de 50 cambios entre dos lecturas (una importación), se anuncian diez y el resto se cuenta como visto.
Acciones de escena
- Añadir una línea a la nota del día de Trilium: Línea, añadida al final de la nota de hoy del diario de Trilium, como nuevo párrafo, empezando por la hora salvo si Empezar con la hora está desactivado. Trilium crea la nota del día (y su mes y su año) cuando falta, a partir de su plantilla de día si tiene una. La línea se escribe como texto sin formato.
- Crear una nota de Trilium: Título, y si lo desea Nota padre (el
título exacto o el id. de una nota existente; vacío: la raíz), Contenido
(texto sin formato, un párrafo por línea) y Etiquetas (separadas por
comas,
nombre=valorpara una etiqueta con valor). La etiqueta de tareas (todopor defecto) la convierte en tarea. Una nota padre desconocida es un error: la integración nunca crea una.
Ambas devuelven Id. de la nota, Título de la nota y Dirección de la nota; Crear una nota de Trilium devuelve también Nota padre.
Ejemplos de escenas
- Diario de la casa: cuando la presión de la caldera baja de 1 bar → Añadir una línea a la nota del día de Trilium, «Presión de la caldera por debajo de 1 bar». Cada día, la nota del día guarda lo que pasó en la casa.
- Tarea por voz: una escena de voz → Crear una nota de Trilium, padre
Compras, título tomado de la petición, etiquetastodo. El contador Tareas abiertas y el widget la muestran. - Saber qué ha cambiado: disparador Nota de Trilium etiquetada
modificada, etiqueta
familia→ enviar un mensaje «{{triggerEvent.data.note_title}} se ha modificado». - Recordatorio de tareas: cada tarde, cuando Tareas abiertas supera 5 → enviar un mensaje.
Solución de problemas
- «Trilium rechazó el token ETAPI»: el token se eliminó o se copió mal. Cree uno nuevo en Opciones → ETAPI.
- «Trilium no responde»: compruebe la dirección y el puerto desde la
máquina de Gladys. El contenedor usa una red en puente:
localhostes el propio contenedor, introduzca en su lugar la dirección IP del servidor. - «Trilium responde en otra dirección»: la dirección redirige, normalmente
de http a https. Introduzca la dirección a la que llega su navegador, con
https://. - «Esta dirección no responde como Trilium»: responde la página de inicio de sesión de un proxy en lugar de Trilium. Introduzca la dirección del propio Trilium.
- «La nota del día está protegida»: Trilium no entrega el contenido de una nota protegida a la ETAPI. Quite la protección del diario, o escriba en otro lugar con Crear una nota de Trilium.
- Para ver más en los registros de la integración, defina
LOG_LEVEL=debug.
Límites
- Los disparadores se activan en la siguiente lectura (15 minutos por defecto), no al instante: Trilium no envía nada por sí mismo. Las notas eliminadas o movidas no se anuncian, ni una etiqueta añadida sola (Trilium no cambia entonces la hora de modificación de la nota); una nota guardada varias veces entre dos lecturas se anuncia una vez.
- Las notas protegidas se cuentan, pero su contenido nunca se lee ni se escribe, y su título aparece como «Nota protegida».
- Las notas archivadas se ignoran en todas partes: contadores, tareas y disparadores.
- Una lectura son unas pocas búsquedas ETAPI. Los recuentos leen la lista de notas como un flujo, sin guardarla: una base de decenas de miles de notas cabe en la memoria del contenedor, pero tarda un poco más en contarse.
- La integración nunca elimina ni mueve nada en Trilium.
- Sin relación con Trilium Notes ni TriliumNext.
Parámetros de configuración
Estos son los parámetros que Trilium Notes te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar Trilium | section | No | Introduzca la dirección de su servidor Trilium (Trilium Notes o TriliumNext) y un token ETAPI: en Trilium, abra Opciones → ETAPI → Crear un nuevo token ETAPI. |
| Dirección de Trilium | string | Sí | La dirección en la que abre Trilium en un navegador. |
| Token ETAPI | secret | Sí | Se muestra una sola vez, al crear el token. |
| Leer Trilium cada | select | No | Las notas modificadas se anuncian en la siguiente lectura. |
| Etiqueta de las tareas | string | No | Las tareas abiertas son las notas con esta etiqueta y sin #done. |
| Idioma de nombres y mensajes | select | No | Los nombres de las funciones se fijan al añadir un dispositivo a Gladys. |
Cómo instalar Trilium Notes en Gladys
- En Gladys, abre Integraciones: Trilium Notes aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-trilium:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-trilium.
Trilium Notes requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Trilium Notes es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación