Obsidian

En esta experiencid de que ahora todos somos developers gracias a la IA, hice un par de complementos para Obsidian, uno de ellos es Export Folder to ZIP, un plugin open source para Obsidian (desktop) que comprime cualquier carpeta de tu vault usando los motores de compresión que ya tenés en tu sistema: 7-Zip o WinRAR. Sin subir nada a la nube, sin motores embebidos: usa tus propios binarios o si no los tenes podes bajarlos de un repositorio publico y te devuelve el archivo listo para compartir.

La versión 1.0.4 salió hoy y trae la interfaz localizada en inglés y castellano.

Cómo funciona

Clic derecho sobre una carpeta en el explorador de Obsidian → Export folder to ZIP. Ahí elegís formato, nivel de compresión, nombre (opcional) y cifrado si el formato lo admite. El plugin captura la ruta física de la carpeta, corre el motor en una ruta temporal del sistema (nunca dentro del vault) y cuando termina te ofrece guardar el archivo junto a la carpeta o descargarlo con el diálogo nativo de tu sistema.

Motores y formatos comunes

Motor Formatos Niveles de compresión
7-Zip .zip, .7z, .tar, .tar.gz Almacenar (0), Rápido (3), Normal (5), Máximo (9)
WinRAR .rar, .zip Almacenar (0) … Máximo (5)

El diálogo combina los formatos de todos los motores configurados: elegís el formato y el plugin usa el motor compatible con sus niveles correspondientes.

Características

  • Menú contextual directo: clic derecho en cualquier carpeta → exportar.
  • Exclusiones fijas: .obsidian/* y .git/* nunca entran al archivo (así, si exportás la raíz del vault, no se cuela tu configuración ni el historial de git).
  • Modal de progreso: porcentaje en vivo con dos acciones: Cancelar (mata el proceso y limpia el temporal) y Enviar a segundo plano (seguís usando Obsidian mientras el status bar muestra 📦 Comprimiendo… 42%; clic para reabrir el modal).
  • Guardado flexible: “Guardar junto a la carpeta” lo deja al mismo nivel (nunca dentro de la carpeta que se acaba de comprimir) y nunca pisa archivos: si ya existe uno con el mismo nombre, agrega un sufijo con timestamp. “Descargar” abre el diálogo de guardado nativo del sistema.
  • Panel de configuración: alta, edición y borrado de binarios con autodetección de instalaciones comunes de Windows y del PATH, selección del motor activo y formato por defecto.
  • Descarga opcional de 7-Zip: solo con tu confirmación explícita, desde una revisión fijada del proyecto develar/7zip-bin, verificando tamaño y SHA-256; el binario se guarda en la carpeta del plugin (no en el vault ni en un temporal). También acepta una URL HTTPS alternativa con su SHA-256 obligatorio. Compatible con Windows (x64/ia32/arm64), macOS (x64/arm64) y Linux (x64/ia32/arm/arm64).
  • Interfaz localizada: sigue el idioma que tengas configurado en Obsidian (inglés y castellano).
  • Privacidad: sin telemetría y sin enviar datos del vault. La única actividad de red ocurre cuando pedís explícitamente la descarga de un binario.

Por debajo, todo se ejecuta con spawn sin shell (las rutas con espacios y caracteres especiales no son problema), se limpia el directorio temporal en todos los caminos (éxito, error y cancelación), y el ID interno del plugin es export-folder-to-zip (el catálogo de plugins de comunidad no permite obsidian en el identificador).

Instalación

La inslacion podes hacerla directamente desde el navegador de plugins del propio obsidian o podes realizarla de forma manual siguiendo los siguientes pasos:
  1. Creá la carpeta .obsidian/plugins/export-folder-to-zip/ dentro de tu vault.
  2. Copiá ahí manifest.json, main.js y styles.css (ya compilados en el repositorio).
  3. Reiniciá Obsidian → Ajustes → Plugins de comunidad → habilitá Export Folder to ZIP.
  4. Andá a Ajustes → Export Folder to ZIP → “Buscar instalaciones locales” (Windows) o agregá el binario a mano. Si no tenés ningún motor instalado, usá “Descargar 7-Zip” y listo.

Requiere Obsidian 1.13.0 o superior y la versión de escritorio del editor (el plugin depende de child_process de Node.js, así que no funciona en móvil).

Fuera de alcance

A propósito, el plugin no hace: exportaciones desde móvil, motores de compresión embebidos, descompresión de archivos ni exportaciones automáticas programadas. Hace solo una cosa y la hace bien y sencilla, ejecuta una compresion simple solo con hacer clic derecho sobre el objeto.

Desarrollo

Si querés contribuir: necesitás Node.js 18+, npm install, npm run build (typecheck + bundle) y npm run dev para modo watch. Cada release se valida con npm run validate:release y debe incluir los tres archivos de release con la versión del manifest.json. El código está en src/ bien separado: motores (engines.ts), compresión (compress.ts), modales de progreso/guardado/opciones, descarga verificada de 7-Zip (download-7zip.ts) y ajustes (settings.ts).

Links

  • Repositorio: https://github.com/radixtenshi/obsidian-export-folder-to-zip
  • Licencia: MIT
  • Changelog y seguridad: en el repo (CHANGELOG.md y SECURITY.md)

Cualquier duda o idea, abrí una issue en GitHub. ¡A comprimir!