OpenSync

Desktop

Instalar OpenSync Desktop

BetaLinux (.deb / .AppImage), Windows (.exe NSIS / .msi) e macOS (.dmg) publicados via Vercel Blob Storage.

App desktop nativa construída com Tauri 2 (Rust + React 19 + Vite + Tailwind 4). Reutiliza o motor Rust sync-core do daemon do servidor — comportamento de sync idêntico em todas as plataformas.

Linux (Ubuntu / Debian) — instalação rápida (1 comando)

Cola no terminal — o script descarrega o .deb, instala via apt e cria os atalhos.

bash
curl -fsSL https://opensync.space/install/ubuntu-desktop | bash

Download direto: /download. O script vive em https://opensync.space/install/ubuntu-desktop.

macOS — instalação rápida (1 comando)

Cola no Terminal — o script detecta a arquitectura (Apple Silicon ou Intel), descarrega o .dmg, monta-o, copia o app para /Applications e abre-o.

bash
curl -fsSL https://opensync.space/install/macos-desktop | bash

O script vive em https://opensync.space/install/macos-desktop. Como o app ainda não está notarizado pela Apple, o instalador remove a flag de quarentena automaticamente — se preferires aprovar manualmente, abre System Settings → Privacy & Security depois do primeiro arranque.

Ainda não existe .dmg macOS publicado. Corre pnpm desktop-macos:deploy num Mac para gerar e publicar.

Windows 10 / 11 — descarrega e instala

Sem linha de comando. Três passos:

Ainda não existe instalador Windows publicado. Corre pnpm desktop-windows:deploy para gerar e publicar.
  1. Clica no botão acima (ou na página /download) para descarregar o instalador.
  2. Abre o ficheiro opensync-desktop_X.Y.Z_x64-setup.exe. O Windows SmartScreen pode avisar "Unknown publisher" — clica More info Run anyway.
  3. Segue o wizard (Next → Install → Finish). Instala em %LocalAppData%\Programs\OpenSync\ (sem pedir password de admin) e cria atalhos no menu Iniciar e no ambiente de trabalho.
Nota: o binário ainda não é assinado com certificado code-signing — por isso o SmartScreen aparece. Vamos assinar em breve. Se preferires um .msi (silent install via msiexec), está também disponível em /download.

Plataformas suportadas

macOS

12+ (Intel & Apple Silicon)

Em construção

Linux

.deb / .AppImage

Disponível

Windows

10/11 · .exe NSIS (x64)

Disponível

Primeiro arranque

  1. Abre a app — vai aparecer o ecrã de login.
  2. Cola o teu token usk_… (gera em Definições → Tokens de acesso).
  3. A app valida o token contra /user/me e abre o dashboard com a tua lista de spaces.
  4. Em cada space, clica Configurar pasta, escolhe a pasta local a sincronizar e guarda — gera um sync token automaticamente.
  5. Clica Iniciar sync para arrancar a sincronização bidirecional em background. O badge muda para A sincronizar.

Onde fica guardada a configuração

  • ~/.config/opensync-desktop/{space_id}.json — pasta local + URL API + intervalo de polling.
  • ~/.config/opensync-desktop/{space_id}.token — sync token (chmod 600 em Unix).
  • ~/.local/share/opensync/{space_id}.sqlite — estado local dos ficheiros (partilhado com o daemon).

Roadmap

  • Fatia 1 — Login + dashboard de spaces. Pronto
  • Fatia 2 — Sincronização local em background (start/stop por space, eventos para UI). Pronto
  • Fatia 3 — File tree expansível + diff side-by-side de conflitos com 3 ações (manter local / remoto / ambos). Pronto
  • Fatia 4 — Tray icon (mostrar/esconder, parar todas as syncs, sair) + notificações nativas (sync iniciado, falha). Pronto
  • Fatia 5 — Auto-updater (tauri-plugin-updater) + workflow CI desktop.yml (mac/linux/windows) + página /download. Pronto — assinatura/keyring ainda pendentes.

Estado completo em docs/install.