hubio-sync gui

Launch the native graphical user interface for hubio-sync.

Synopsis

hubio-sync gui

Description

The gui command launches a native desktop application for managing data migrations. The GUI provides a visual interface for:

  • Configuring data sources and destinations
  • Creating and managing migrations
  • Scheduling automated syncs
  • Monitoring migration progress
  • Viewing logs and status

Availability

The GUI is only available in builds compiled with GUI support. The standard distribution includes GUI support for:

  • macOS: Intel and Apple Silicon (.app bundle in .zip)
  • Linux: x86_64 and ARM64 (standalone binary)
  • Windows: x86_64 (.exe)

Usage

hubio-sync gui

When launched, you’ll see:

🚀 Starting hubio Sync GUI...

The GUI window will open with dimensions 1200x800 pixels.

Requirements

macOS

No additional requirements. The app bundle includes all dependencies.

Linux

Requires X11 or Wayland display server and the following libraries:

  • libgl1-mesa-dev
  • libx11-dev
  • libxcursor-dev
  • libxrandr-dev
  • libxinerama-dev
  • libxi-dev
  • libxxf86vm-dev

Install on Ubuntu/Debian:

sudo apt-get install -y \
  libgl1-mesa-dev \
  libx11-dev \
  libxcursor-dev \
  libxrandr-dev \
  libxinerama-dev \
  libxi-dev \
  libxxf86vm-dev

Windows

No additional requirements.

Non-GUI Builds

If you run hubio-sync gui on a build without GUI support, you’ll see:

❌ GUI support not available

This binary was built without GUI support.
To enable GUI support, you need to:

1. Install required libraries:
   devbox install

2. Enter devbox shell:
   devbox shell

3. Build with GUI support:
   go build -tags gui -o hubio-sync ./cmd/hubio-sync

Or use the web UI instead:
   ./hubio-sync serve --port 8080

Shared Configuration

The GUI shares configuration with the CLI and daemon. Changes made in the GUI are saved to:

  • macOS/Linux: ~/.config/hubio-sync/config.json
  • Windows: %APPDATA%\hubio-sync\config.json

This allows you to:

  1. Configure sources and schedules in the GUI
  2. Run the daemon with hubio-sync serve to execute schedules
  3. Install as a system service with hubio-sync service install

Examples

Launch GUI

hubio-sync gui

macOS: Launch from Applications

After installing the .app bundle to Applications:

  1. Double-click hubio-sync.app in Finder
  2. Or use Spotlight: Cmd+Space, type “hubio sync”, press Enter

Windows: Launch from Start Menu

After installation, the GUI can be launched from the Start Menu or by double-clicking the .exe file.

See Also