Colaborar: espacios compartidos

Un espacio es un lugar compartido con otras personas donde subir proyectos y archivos. Cada uno tiene su historial de versiones y sus comentarios (en videos, en un segundo concreto). Los cambios llegan en vivo a quienes tienen el espacio abierto.

#Privacidad: cifrado de extremo a extremo

Al crear un espacio, Genesis genera una clave secreta que solo viaja en el enlace de invitación. Con esa clave se cifra en tu equipo todo lo que se comparte:

• los nombres de los archivos y del espacio;
• el contenido;
• los nombres de los miembros;
• los comentarios.

El cifrado es XChaCha20-Poly1305 y cada espacio tiene sus propias claves (HKDF-SHA256). El servidor solo guarda datos cifrados con nombres opacos, más el hash del token de acceso: no puede leer ni modificar nada.

• Comparte el enlace por un canal privado. Quien lo tenga puede entrar.
• Si alguien deja el espacio, sus copias descargadas siguen en su equipo.

#Formas de usarlo

#En la misma red (sin nube)

Útil en una oficina o en casa.

1. En Espacios compartidos, activa Compartir en esta red. Este equipo hace de servidor en el puerto 8787.
2. Crea un espacio con la opción En esta red y envía el enlace.
3. Quien esté en la misma red hace clic en el enlace: Genesis se abre en Espacios compartidos con la invitación ya puesta y solo pide su nombre. También se puede pegar en Unirme, por ejemplo si el enlace llega a otro dispositivo.

El equipo que hace de servidor tiene que estar encendido para que los demás sincronicen. Si el sistema pregunta, permite las conexiones entrantes de Genesis en el cortafuegos.

#Con un servidor propio (desde cualquier lugar)

Un único comando, en cualquier máquina con Linux, macOS o Windows:

genesis share serve --port 8787 --data /var/lib/genesis-share --admin-token "una-clave-larga"

Si compilas genesis tú mismo, compila antes la página de revisión (pnpm --filter @genesis/review build): se incluye dentro del binario.

• --admin-token (o la variable GENESIS_SHARE_ADMIN_TOKEN) hace que solo quien la conozca pueda crear espacios. Unirse a uno solo requiere su enlace.

• Pon delante un proxy con HTTPS. Con Caddy basta:

  CódigoCopiar

  share.ejemplo.com {
      reverse_proxy 127.0.0.1:8787
  }

• Como servicio de systemd:

  ConfiguraciónCopiar

  [Unit]
  Description=Genesis share
  After=network.target
  
  [Service]
  ExecStart=/usr/local/bin/genesis share serve --host 127.0.0.1 --port 8787 --data /var/lib/genesis-share
  Environment=GENESIS_SHARE_ADMIN_TOKEN=una-clave-larga
  Restart=on-failure
  DynamicUser=yes
  StateDirectory=genesis-share
  
  [Install]
  WantedBy=multi-user.target

Al crear el espacio en Genesis, elige En un servidor y escribe https://share.ejemplo.com y la clave de administración.

#Editar a la vez

Los montajes de video, documentos y hojas de cálculo de un espacio se editan en vivo. Ábrelos desde Espacios compartidos y, si otra persona tiene abierto el mismo elemento, veréis los cambios del otro al momento.

• Arriba aparece En vivo con las iniciales de quien está dentro.
• Lo que hace cada persona se ve:
  • en los documentos, su cursor con su nombre;
  • en las hojas, la celda en la que está;
  • en el montaje, el clip que tiene seleccionado.
• Los cambios se fusionan. Si cada uno toca clips, celdas o párrafos distintos, se conservan ambos. Si dos personas cambian el mismo valor, queda el último.
• Deshacer (Ctrl+Z) solo deshace lo tuyo, nunca lo de los demás.
• Sin conexión sigues editando. Al volver, tus cambios se envían y recibes los de los demás.
• Los medios que añades (un video, una imagen) se suben cifrados y les aparecen a los demás cuando terminan de descargarse.
• Cifrado: el servidor solo reenvía y guarda cambios cifrados, en una sala con un nombre que no revela qué elemento es. Cada cierto tiempo los compacta en un único estado cifrado.
• Para guardar una versión en el historial (y que se pueda aprobar desde el móvil), pulsa Compartir como siempre.

#Revisar desde el móvil o el navegador

No hace falta instalar nada. El servidor del espacio también sirve una página de revisión:

1. En Espacios compartidos, pulsa Enlace para el móvil y envíalo por un canal privado. Tiene la forma https://servidor/#espacio=…&k=….
2. Al abrirlo, se ven los elementos del espacio y sus versiones. Desde ahí se puede:
   • reproducir la vista previa;
   • comentar en un segundo concreto (tocar el tiempo de un comentario salta a ese momento);
   • aprobar una versión.
3. Todo llega al momento a la app de escritorio: los comentarios, y "Aprobada por …" en el historial de versiones.

Cifrado de principio a fin:

• La clave va después de #, una parte del enlace que el navegador nunca envía al servidor.
• La página descifra en el propio teléfono (XChaCha20-Poly1305, igual que la app) y quita la clave de la barra de direcciones.
• La clave se recuerda en ese dispositivo hasta que pulses Olvidar este espacio en este dispositivo.

Vista previa ligera:

• Al compartir un video, Genesis sube además una copia de hasta 720p, cifrada como lo demás, para que el móvil no descargue el original.
• Con audio sube una copia en AAC, y con una foto, un JPEG.
• Los proyectos de Genesis no tienen vista previa. De los demás archivos se puede descargar el original.

Instalar como app:

• Con HTTPS (un servidor propio con Caddy, o un túnel), la página se puede añadir a la pantalla de inicio y se abre como una app (Añadir a pantalla de inicio en Android o iPhone).
• No necesita tiendas de aplicaciones ni cuentas de desarrollador.

Sin servidor público: si usas Compartir en esta red, el enlace funciona en el móvil conectado al mismo Wi-Fi. Para revisar desde fuera sin contratar nada:

• Cloudflare Tunnel: cloudflared tunnel --url http://localhost:8787 da una dirección https://… temporal.
• Tailscale (tailscale funnel 8787).

En ambos casos, crea el espacio con esa dirección https://… como servidor.

#Qué se comparte y cómo

• Proyectos (.gvideo.json, .gdoc.json, .gslides.json, .gsheet.json, .gimg.json, .gaudio.json):
  • viajan con todos los videos, imágenes y audios que usan;
  • al descargarlos, las rutas apuntan a las copias descargadas, así que se abren tal cual.
• Cualquier otro archivo (video, PDF, Word…) se comparte tal cual.
• Versiones:
  • compartir de nuevo un archivo que salió del espacio (o que ya compartiste) crea una versión nueva del mismo elemento;
  • los demás ven el aviso Versión nueva;
  • las versiones anteriores se pueden abrir desde el historial.
• Eficiencia: los archivos viajan en trozos de 8 MiB, y un trozo que ya está en el servidor no se vuelve a subir. Cambiar el título de un montaje de 2 GB sube unos pocos KB.
• Comentarios: en videos y audios se puede indicar el segundo (01:23); pulsarlo abre el editor en ese instante.
• Lo descargado se guarda en Documentos/Genesis/Espacios/<espacio>/.

#Desde la CLI y por MCP

Todo está disponible como herramientas share.*:

Ejemplo:

genesis run share.push space=<id> path=~/Proyectos/Anuncio.gvideo.json note="Corto la intro"

Una IA conectada por MCP puede, por ejemplo, «subir el montaje al espacio del equipo y avisar en un comentario de qué cambió».

#Límites

• El editor de imagen y el de audio funcionan por versiones: cada persona trabaja en su copia y comparte. Si dos personas comparten a la vez, quedan las dos versiones en el historial y no se pierde nada.
• El servidor acepta archivos de hasta 8 GB (ya cifrados).
• Dónde se guardan las claves de los espacios:
  • En el llavero del sistema (Llavero de macOS, Administrador de credenciales de Windows o Secret Service en Linux). Las de versiones anteriores se mueven allí solas.
  • En los equipos sin llavero (un Linux sin escritorio, la CLI en un servidor), se guardan en un archivo legible solo por tu usuario. Espacios compartidos lo indica.
  • Si el llavero pierde una clave, vuelve a abrir el enlace de invitación y se recupera.