Desktop App
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 under Desktop Application.
- Windows App downloads an
.msifor 64-bit Windows. Run it, then start the app. - Mac App downloads a
.dmgfor 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.
- In the app, click Login under Login to Continue. Your default browser opens.
- If you are not signed in to syn.bike in that browser, sign in as usual.
- 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.
- 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.
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.
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.
- 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). 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.
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