# Desktop App

> Install the syn.bike desktop app on Windows or Mac, sign in through your browser, open and save bike files on disk, and see what works offline.

The desktop app is the same linkage designer as the web app, in its own window. It also opens and saves bike files directly on your disk, and it keeps solving kinematics when you have no connection.

## Download and Install

The installers are on the [Downloads page](https://syn.bike/downloads) under **Desktop Application**.

- **Windows App** downloads an `.msi` for 64-bit Windows. Run it, then start the app.
- **Mac App** downloads a `.dmg` for a Mac with Apple Silicon and macOS 13 or later. Open it and drag the app into **Applications**.

On a Mac, use `Cmd` wherever this page says `Ctrl`.

## Sign In

You sign in through your browser, with the same sign-in method you use on the web. The app never asks for your password.

1. In the app, click **Login** under **Login to Continue**. Your default browser opens.
2. If you are not signed in to syn.bike in that browser, sign in as usual.
3. The browser shows **Authenticate App** with the account you are about to use. Click **Continue**. To use a different account, click **Not you? Use another account** first.
4. When the browser shows **You are signed in**, close the tab and go back to the app.

You have five minutes to finish in the browser. After that, or if you click **Cancel**, start again from the app.

If the browser does not open, click **Browser did not open?** in the app and copy the address it shows into a browser.

The app remembers your sign-in between launches. **Logout** in the app menu signs you out.

### When Sign-In Fails

Click **Try Again** where it is offered, or start again from the app. Two cases need something else:

- "Finishing sign in..." does not go away. Click **Taking too long? Start over**.
- The browser shows **Invalid sign-in request**. The page was opened without the app, for example from a bookmark. Start the sign-in from the app.

## Open and Save Local Files

**Open File** in the app menu (`Ctrl+O`) opens one bike file at a time. It reads syn.bike files (`.syn` and `.json`) and Linkage X3 files (`.ltx`).

A bike opened from disk is a local bike: its **Database** in **Bike Info** is **Local**, an option that only exists in the desktop app. Two menu items save it.

| Menu item | Shortcut | What it does |
|---|---|---|
| **Save File** | `Ctrl+S` | Writes the selected bike back to the file it came from. If the bike has no file yet, it asks where to save. |
| **Save File As** | `Ctrl+Shift+S` | Always asks where to save, as `.syn` or `.json`. |

A bike opened from an `.ltx` file never writes back to that file. The first **Save File** asks for a new `.syn` or `.json`.

**Save File** only works on local bikes. With a database bike selected it shows `Hotkey save is only enabled for local files. Please use the Save button for cloud files.`

- To keep a copy of a database bike on disk, set its **Database** to **Local** in **Bike Info** and then use **Save File**.
- To move a local bike to a database, set its **Database** to **Private** or **Team** and save it as described in [Loading and Saving](https://syn.bike/docs/loading-and-saving-bikes.md).

Double-clicking a `.syn` file does not open it. Start the app and use **Open File**.

Downloads, such as the bike file, kinematic results and the ZIP export on the **Files** page, ask for a folder and file name each time.

### Desktop App File Messages

| Message | Cause |
|---|---|
| `This file appears to be a ZIP archive. Please extract it and open the .syn, .json or .ltx file inside.` | You picked a `.zip`, or a zipped file renamed to `.syn`. Extract it first. |
| `Unable to read file — it does not contain valid JSON.` | The file is damaged or is not a bike file. |
| `File is not a valid Syn bike` | The file is valid JSON but not a bike. |
| `Too many bikes loaded. Please close some and try again.` | The workspace is full. Close a bike with the **×** on its chip. |

## Desktop App Zoom

The app menu has **Zoom In** (`Ctrl+Shift+=`) and **Zoom Out** (`Ctrl+Shift+-`). Zoom moves in 10% steps between 80% and 160%, and the app remembers the level between launches. **Reset Zoom** (`Ctrl+Shift+0`) appears in the menu whenever the level is not 100%.

Zoom scales the interface and the chart text. The bike drawing keeps its size.

`Ctrl+Q`, or **Exit** in the app menu, closes the app. The shortcuts the desktop app shares with the browser are listed in [The Workspace](https://syn.bike/docs/workspace.md#keyboard-shortcuts).

## Desktop App Updates

When a new version is available, the app shows an **Update available** dialog as it starts. Click **Install** to download it while you keep working, or **Later** to be asked again the next time the app starts.

> [!WARNING]
> Save your work before you click **Install**. On Windows, the installer takes over when the download finishes and the app closes without asking.

On a Mac, an **Update installed** dialog asks whether to restart. **Restart** finishes the update now, and **Later** applies it the next time the app starts.

If the update cannot be installed, an **Update failed** dialog gives the reason and the app keeps running on the current version.

## Working Offline

With no connection you can still open local files, edit them, read every chart and save back to disk. You need to have signed in on that computer beforehand.

These need a connection:

- Saving a bike to a database. Offline, the save stops with `You appear to be offline. Saving needs a connection to check for an existing bike.`
- The [Optimizer](https://syn.bike/docs/optimizer.md).
- Signing in.

If the app cannot load your account when it starts, it shows `Unable to fetch user data. Please try logging in again.`

## Other Differences From the Web App

The desktop app cannot connect to a synDAQ device. Use Chrome or Edge for that (see [Browser Support](https://syn.bike/docs/data-acquisition/settings.md#browser-support)). You can still load recordings copied off the SD card with the file field at the top of the **DAQ** sidebar, as described in [Data Acquisition](https://syn.bike/docs/data-acquisition/overview.md#load-a-recording).

These open in your default browser rather than inside the app:

- **Account** in the app menu, where plans and billing live
- links to syn.bike pages such as **Help**
