Installation

Choose the installation method for your platform.

macOS

DMG Installer

Download the DMG from the releases page and drag Cook Sync to your Applications folder.

Supports automatic updates.

Windows

Installer (.exe)

Download the installer from the releases page and run it.

Linux

AppImage

Download the AppImage from the releases page:

1. Make it executable:

   chmod +x cook-sync-*.AppImage

2. Double-click the AppImage or run:

   ./cook-sync-*.AppImage start

On first launch, Cook Sync will automatically install desktop integration (menu entry and icons).

System Tray Requirements

The system tray icon requires specific packages depending on your desktop environment:

GNOME Users

Install the AppIndicator extension:

sudo apt install gnome-shell-extension-appindicator
gnome-extensions enable [email protected]

Then restart GNOME Shell (Alt+F2, type 'r', press Enter).

XFCE Users

sudo apt install xfce4-indicator-plugin

Then add the Indicator Plugin to your panel.

KDE/MATE Users

System tray works out of the box - no additional setup needed.

From Source

If you prefer to build from source, you'll need Rust installed:

# Clone the repository
git clone https://github.com/cook-md/sync-agent.git
cd sync-agent

# Build
cargo build --release

# The binary will be at: target/release/cook-sync
./target/release/cook-sync start

Build Dependencies

Ubuntu/Debian:

sudo apt install libayatana-appindicator3-dev libgtk-3-dev libxdo-dev

Fedora/RHEL:

sudo dnf install libappindicator-gtk3-devel gtk3-devel

Arch Linux:

sudo pacman -S libappindicator-gtk3 gtk3