Desktop app

The desktop app organizes builds by game and lets you fetch, update, inspect, and publish them without using the command line. For your first download, use the desktop quick start.

Select a game

The app is scoped to one game at a time. Choose the current game from the game picker. If the server has no games, Create game registers the first one.

Deleting a game from Settings removes all of its streams and build metadata, including pinned builds. Its unreferenced chunks are reclaimed by server garbage collection later.

Browse builds

The Builds page groups matching platform builds into one version row. Use search and stream filters to narrow the feed. A row can show:

• Version or source revision.
• Platforms available for that build.
• Stream membership.
• Author, age, notes, and broken status.
• Whether a checkout is already local.
• How much data must be downloaded.

Open a build to see its complete metadata and platform variants.

Fetch a build

Select a platform and choose Fetch build. You can create a new checkout or update a checkout associated with a stream.

Vsync downloads only missing chunks. The new checkout is staged before it replaces the old one. If you cancel or the operation fails, downloaded chunks remain cached for the next attempt and the previous checkout remains usable.

From a local build you can:

• Open its directory.
• Fetch it again to verify and repair the checkout.
• Update it when a newer build has landed in its stream.
• Delete the checkout without clearing the shared cache.

Work with streams

The Streams page shows each stream, its description, the newest build of each platform in it, and your local status. Open a stream to see its builds newest-first and fetch an earlier one.

New stream creates one. Builds join a stream only when they are committed, so create the stream before the build that belongs in it.

Deleting a stream asks what to do with its builds: keep them, in which case they leave the stream and are kept only while pinned or young, or delete them with the stream - pinned builds included.

Publish a build

Create a game and stream first if the server is empty. Then open Commit and:

1. Choose the build directory.
2. Wait for Vsync to stage and price the upload.
3. Select the platform.
4. Choose the stream, and enter a version and optional source revision, build configuration, release notes, and pin status.
5. Review the number of missing chunks and bytes to upload.
6. Choose Commit.

A version is unique within the chosen stream (per platform) and may repeat across streams - a rebuild of the same changelist can live in another stream. The stream is chosen here and nowhere else: a published build cannot be moved into another stream afterwards.

Settings and storage

Settings controls start-on-login, download notifications, crash reports, updates, the connection check, and diagnostic logs. Crash reporting is enabled by default, shared with the CLI, and can be disabled there; the change takes effect after restart.

Settings also changes the build root, shows cache and checkout usage, opens or deletes checkouts, clears cached downloads, and signs out.

Clearing the cache keeps checkouts but makes future downloads transfer those chunks again. A local-only commit that has never been uploaded can no longer be reconstructed after its cached data is cleared.