Goooy
English
← All documentation

Goooy Desktop

The whole Goooy suite (mail, calendar, chat, files, meetings and office), in one native window on your desktop, connected to your own Goooy server.

Goooy Desktop is a native shell around your Goooy server’s web app. It shows the exact same suite you use in the browser, so there’s nothing new to learn and nothing extra to keep updated: the app is always exactly as new as your server. What it adds is everything a browser tab can’t do, a system-tray icon with an unread badge, real OS notifications, goooy:// links, Goooy Drive folder sync, and (if you want) taking over as your computer’s email program.

Download

Goooy Desktop is a small native app (~4 MB download, ~9 MB installed). It doesn’t bundle a browser like Chromium: it renders in your operating system’s own web engine.

Debian / Ubuntu (.deb) Fedora / openSUSE (.rpm) AppImage (any distro) Windows 10/11 (installer)

Linux builds are ready to download. Install the package for your distribution, or use the AppImage on any distro:

sudo apt install ./goooy-desktop-latest-linux-amd64.deb    # Debian / Ubuntu
sudo dnf install ./goooy-desktop-latest-linux-amd64.rpm    # Fedora / openSUSE

chmod +x goooy-desktop-latest-linux-amd64.AppImage         # any distro
./goooy-desktop-latest-linux-amd64.AppImage

Windows: download the installer and run it. It isn’t code-signed yet, so Microsoft SmartScreen may warn on first run: choose More info → Run anyway. WebView2 is installed automatically if your PC doesn’t have it yet.

macOS: a ready-to-run download is on the way. In the meantime, Mac users can use Goooy in the browser as usual.

Goooy Desktop works with any Goooy server. Native notifications and the unread badge need a server running this release or newer, on an older server the app still works fine as a plain window.

First run

  1. Install and start Goooy Desktop. The first launch asks for your server address (for example https://mail.yourcompany.com): point it at any self-hosted Goooy server. The app checks the address is really a Goooy server before it connects.
  2. Sign in with your usual Goooy email and password. From here on it’s the same suite as on the web: Mail, Calendar, Contacts, Tasks, Notes, Chat, Files, Meet and Office, in one window.
  3. That’s it. You can change the server later from the tray icon’s Settings: the app restarts onto the new server.

What it adds

  • The whole suite in one window. The full Goooy web app, outside the browser. Because it runs your server’s app, it never lags behind: update the server and the desktop app is up to date too.
  • Unread badge in the tray. The tray icon and your taskbar/dock badge show your unread count: mail and chat combined. You can turn the badge off in settings.
  • Native notifications. New mail and calendar reminders arrive as real system notifications, and so do chat messages, which even the web app doesn’t toast. Chat notifications follow your notification preferences in Goooy.
  • Close to tray. Closing the window keeps Goooy running in the tray, so notifications and the badge keep coming. Reopen it any time from the tray icon.
  • Start with your computer. Optionally launch at login, minimized to the tray.
  • goooy:// links. Links like goooy://open/calendar open the right part of the app, even when it isn’t running yet.
  • Your default email program (optional). Turn it on in settings and clicking an email address in any app opens Goooy’s composer, prefilled with the recipient, subject and text.
  • Goooy Drive folder sync built in. Keep a folder on your computer in sync with your files in Goooy, the way Dropbox or OneDrive do: set it up in the desktop settings, and the tray shows the live status with Sync now and Open sync folder at hand. See Goooy Drive folder sync below for how it works (and for the goooy-drive command-line tool for servers).

Goooy Drive folder sync

Goooy Drive sync mirrors a folder on your computer with your files in Goooy, like Dropbox, OneDrive or Nextcloud, but on your own Goooy server. Save a document on your laptop and it appears in Goooy; drop a file into Goooy from the web and it lands in your folder. It works in both directions, runs quietly in the background, and never silently overwrites your work. If the same file changed in two places, both versions are kept.

Setting it up

Folder sync is built into Goooy Desktop. Once you’re signed in:

  1. Open Desktop settings from the tray icon.
  2. In the Drive sync section, click Set up: enter your server address (for example https://mail.yourcompany.com), your email and password (the same ones you use to sign in to Goooy on the web) and choose the local folder to sync. To mirror just one folder of your drive instead of all of it, fill in the optional drive sub-folder.
  3. Click Connect & sync. The folder syncs right away, and from then on automatically in the background.

The tray menu shows the live sync status and gives you Sync now and Open sync folder; the settings window shows the same status while it’s open.

Upgrading from the old standalone Goooy Drive tray app? Your settings and sync state carry over automatically: install Goooy Desktop and it picks up exactly where the old app left off, without a fresh download of your files.

The command-line tool

The same sync engine as a single small binary (~5 MB, no runtime to install), for servers, headless machines or power users.

Linux (x86-64) Windows (x86-64)

On Linux, make it executable first (chmod +x goooy-drive-latest-linux). On macOS, build it from source (cargo build --release in apps/desktop-app/sync), a ready-to-run download is on the way.

# Connect once (stores your settings + verifies the login):
goooy-drive login --server https://mail.yourcompany.com \
                  --email you@yourcompany.com \
                  --password '••••••••' \
                  --dir ~/GoooyDrive

goooy-drive run      # sync once, now
goooy-drive watch    # keep syncing on a schedule (default: every 30s)
goooy-drive status   # show your settings and check the server is reachable

By default the whole drive is mirrored. To sync just one folder of your drive, add --remote-base "Projects" (the folder is created if it doesn’t exist yet). The CLI and Goooy Desktop share the same settings file, so you can use both on one machine.

How syncing works

  • Two-way. Changes flow both directions: new and edited files upload, new and edited files on the server download, and folders are created on whichever side is missing them.
  • Deletes propagate. Delete a file in your folder and it’s removed from Goooy; delete it in Goooy and it disappears from your folder. (Files removed in Goooy go to the Recycle bin, so they’re recoverable.)
  • Conflicts keep both versions. If a file was changed both on your computer and in Goooy since the last sync, Goooy Drive doesn’t pick a winner. It keeps the server’s version as the file, and saves your local edit alongside it as name (conflict <date>).ext, on both sides, so nothing is lost.
  • The first sync may take a while if you have a lot of files; after that only changes are transferred.
  • Goooy Docs and Sheets (documents you create and edit live in Goooy’s web editor) aren’t downloaded as files. Open and edit those in the web app.
  • You can sync the same Goooy account to several computers. Each keeps its own folder in step with the drive.

Good to know

  • Video meetings on Linux: the system web engine can’t use your camera and microphone yet, so join Meet calls from a regular browser on Linux.
  • Clicking a notification shows it but doesn’t yet jump to the right place in the app: that’s planned.
  • While the window is hidden in the tray, the unread badge can take a little longer to update on Linux and Windows.
  • There’s no auto-update yet: grab new versions from this page when they’re released.

Frequently asked

Is my data sent anywhere else? No. The app talks only to your own Goooy server over an encrypted (HTTPS) connection. Nothing passes through any third party.

Do I need to update the app when my server updates? No. Goooy Desktop shows your server’s own app, so it’s always exactly as new as your server. Only the small shell itself occasionally gets a new release.

Which Goooy servers does it work with? Any. The first-run screen asks for your server address, so it works with any self-hosted Goooy server. Native notifications and the unread badge need a server running this release or newer; older servers still work as a plain window.

What if I rename a synced file? A rename is treated as removing the old name and adding the new one. Both sides end up with the new name after the next sync.

Does folder sync need the app running all the time? For continuous background sync, yes. Leave Goooy Desktop running in the tray (or goooy-drive watch on a server). You can also sync on demand any time with Sync now or goooy-drive run.