Install

Download CorosLink, fix common install issues, and build from source.

Download

Get the latest installer from GitHub Releases.

PlatformFile
macOS (Apple Silicon)CorosLink-*-arm64.dmg
macOS (Intel)CorosLink-*-x64.dmg
WindowsCorosLink Setup *.exe
Linux (x64)CorosLink-*-x86_64.AppImage

Open the DMG, then drag CorosLink into Applications when the installer window appears. If Finder only shows a plain folder, drag CorosLink.app into Applications manually.

macOS: "app is damaged" or won't open

Release DMGs from GitHub are signed and notarized. If Gatekeeper still blocks an older or locally built unsigned copy, clear the quarantine flag after installing:

xattr -cr "/Applications/CorosLink.app"

Then open normally. If that still fails, right-click the app → Open → Open again.

Windows and Linux:

Windows may show a SmartScreen prompt for unsigned installers — click More info → Run anyway. On Linux, mark the AppImage executable (chmod +x CorosLink-*.AppImage) before running it.

In-app updates

Packaged builds check GitHub Releases for new versions on launch. When an update is available, CorosLink downloads it in the background and shows Restart to update in the header. You can also click the version badge to check manually.

First release with in-app updates:

Users on v0.1.7 or earlier must install manually once. After that, updates arrive in-app. Signed macOS builds (v0.1.16+) support reliable in-app update install.

Build from source

1

Clone and install

git clone https://github.com/JunAkerBuilds/CorosLink.git
cd CorosLink
npm install
npm run rebuild
2

Package for your platform

npm run dist:mac    # macOS DMG (run on macOS)
npm run dist:win    # Windows NSIS installer (run on Windows)
npm run dist:linux  # Linux AppImage (run on Linux)

Installers are written to release/.

Requirements

  • macOS, Windows, or Linux
  • USB cable to connect your COROS watch for music and map sync
  • yt-dlp and ffmpeg — bundled in packaged builds; falls back to PATH if missing
  • OpenRouteService API key (optional) — only needed for Route Builder
  • Spotify Developer app (optional) — only needed for Spotify sync
  • Google Cloud OAuth app (optional) — only needed for YouTube Playlists sync
  • Python 3.10+ and ytmusicapi (optional) — only needed for YouTube Music sync
  • COROS account (optional) — only needed for Training Hub

See Development for the local dev workflow, native binary prep, and release packaging.