# Extensiones del navegador

# Sincronizar marcadores con Floccus y Linkwarden

---

### Introducción

Floccus permite sincronizar los marcadores del navegador con diferentes servicios. En este caso se usa **Linkwarden**, un gestor autohospedado que centraliza los enlaces guardados en una interfaz web. Con esta integración, los marcadores creados en el navegador se mantienen sincronizados con la base de datos de Linkwarden, evitando duplicar el trabajo de añadir enlaces en ambos sitios.

---

### Requisitos previos

* Tener **Linkwarden** instalado y funcionando (con acceso vía HTTPS).
* Usuario y contraseña activos en Linkwarden.
* Extensión de **Floccus** instalada en el navegador.
* Conexión estable entre el navegador y el servidor.

---

### Configuración en Floccus

#### 1. Instalar la extensión

Descargar Floccus desde la tienda de extensiones del navegador (Firefox, Chrome, Brave, etc.). Una vez instalada, aparecerá el icono en la barra del navegador.

#### 2. Crear un nuevo perfil de sincronización

1. Abrir el menú de Floccus.
2. Pulsar en **Nuevo perfil**.
3. Seleccionar el tipo de servicio: **Linkwarden**.

#### 3. Configurar la conexión

En el formulario de configuración introducir:

* **URL**: dirección de Linkwarden (ejemplo: `https://linkwarden.midominio.com`).
* **Usuario** y **Contraseña**: credenciales válidas de Linkwarden.
* **Ruta de carpeta** (opcional): definir en qué carpeta del navegador se sincronizarán los marcadores.

#### 4. Guardar y sincronizar

1. Pulsar en **Guardar**.
2. Forzar una primera sincronización manual para que se cree la estructura inicial.
3. Revisar en Linkwarden que los marcadores aparezcan correctamente.

#### 5. Ajustar opciones de sincronización

En los ajustes del perfil conviene activar:

* **Autosincronización**: permite que la extensión sincronice automáticamente cada cierto intervalo de tiempo, evitando tener que hacerlo manualmente.
* **Enviar credenciales del cliente**: en algunos entornos (por ejemplo, si Linkwarden está protegido detrás de un SSO como Authentik) es necesario marcar esta opción para evitar errores 401. En instalaciones sin protección adicional normalmente no hace falta, pero puede activarse si la sincronización falla.

#### 6. Reutilizar perfiles en varios equipos

Si se usan distintos ordenadores o navegadores, no es necesario repetir el proceso de creación del perfil en cada uno. Floccus permite **exportar un perfil** desde un navegador ya configurado e **importarlo** en otro, simplificando la configuración y manteniendo la coherencia en los ajustes.

---

### Errores comunes o decisiones importantes

* **Duplicados**: si ya había marcadores en Linkwarden y en el navegador, es posible que se creen entradas duplicadas. Conviene limpiar antes de la primera sincronización.
* **HTTPS obligatorio**: sin un certificado válido, Floccus no permitirá conectar.
* **Sincronización en segundo plano**: la extensión no sincroniza en tiempo real, sino en intervalos definidos. Puede ajustarse en las opciones.
* **Error 401**: si aparece, probar a activar la opción de *Enviar credenciales del cliente* en los ajustes del perfil de Floccus.

---

### Resumen breve

* Instalar Floccus en el navegador.
* Crear nuevo perfil → elegir Linkwarden.
* Configurar URL y credenciales.
* Sincronizar manualmente la primera vez.
* Activar autosincronización en los ajustes del perfil.
* Si aparece error 401, activar *Enviar credenciales del cliente*.
* Exportar/importar perfiles para usarlos en varios equipos.
* Revisar duplicados y comprobar que la conexión funciona.

---

### Enlaces de interés

* [Página oficial de Floccus](https://floccus.org)
* [Artículo en mi wiki sobre Linkwarden](https://wiki.jtrapero.eu.org/books/contenedores-instalacion/page/linkwarden-gestor-de-marcadores-autohospedado-para-almacenar-y-organizar-enlaces)