Wristbeat · Guide

Set up Wristbeat Bridge

Wristbeat Bridge is a free Mac app that shares the music in your Music library with Wristbeat. Set it up once, and your playlists download to your watch over your home Wi-Fi.

What you need

1. Download and install

Wristbeat Bridge for Mac

Version 1.0.2 · macOS 13 Ventura or later · Apple silicon and Intel · 2.0 MB · Free

Download for Mac

If Safari asks whether to allow downloads from widget.foo, click Allow. Then open the downloaded file and drag Wristbeat Bridge onto the Applications folder.

The Wristbeat Bridge disk image window, with the WristbeatBridge app next to the Applications folder

2. Open Bridge

  1. Open Wristbeat Bridge from your Applications folder. macOS checks the app and asks whether you're sure you want to open it. Click Open. You only see this the first time.
    macOS asks: WristbeatBridge is an app downloaded from the Internet. Are you sure you want to open it? Cancel or Open
  2. Let Bridge read your Music library. Click Allow when macOS asks. Your music stays on your Mac and your home network.
    macOS asks: Allow WristbeatBridge to access your music, video activity, and media library in Apple Music? Don’t Allow or Allow
  3. Find Bridge in the menu bar. A welcome window confirms that Bridge can see your playlists. After that, Bridge lives in the menu bar at the top right of your screen. There's no Dock icon. Click its icon to see what it's doing.
    The Welcome to Wristbeat Bridge window: Lives in your menu bar, Music library access with 2 playlists ready, and Next: on your Apple Watch
    The Bridge menu: Serving your Music library, 2 playlists, 12 songs, 1 missing or unsupported
  4. If macOS asks about incoming network connections, click Allow. Most Macs don't ask. If yours does, your watch needs this to download music from your Mac.
    macOS asks: Do you want the application WristbeatBridge.app to accept incoming network connections? Deny or Allow

3. Connect your watch

  1. Open Wristbeat on your watch. It looks for Bridge on your network.
  2. Click Allow on your Mac when Bridge asks whether your watch may connect. That's it: your watch and Mac are paired. If your watch went to sleep while you waited, open Wristbeat again and it finishes connecting.
    Bridge asks: Allow Apple Watch to connect? It will be able to browse and download your Music library playlists over your local network. Don't Allow or Allow
  3. If the watch doesn't find Bridge, choose Pair with phone instead on the watch. Then click the Bridge icon in the menu bar, click Show QR Code, and scan the code with your phone.
    The Bridge menu with its QR code shown

4. Choose what to sync

Wristbeat shows the playlists from your Music library. Choose one and Wristbeat saves every song to the watch.

What Bridge can share

Bridge shares the music you own: purchases, CD rips and DRM-free downloads. It can't share:

Bridge skips these and shows how many it left out.

Day to day

The Bridge menu while syncing: Syncing to watch, 68 percent, 0.4 MB/s
The Bridge menu after syncing: the songs sent this session with their speeds

If something isn't working