Wristbeat · Support

Support

Fix a problem, get more out of Wristbeat, or tell us what to build next.

Featured guide

Getting started with Wristbeat

Connect your music, download your first playlist and head out with just your watch.

Read the guide →
  1. 1Connect your music
  2. 2Download a playlist
  3. 3Connect headphones
  4. 4Leave your phone at home
Fix a problem
Troubleshooting

Answers to common setup, sync and playback problems, and how to report one we haven't covered.

Find a fix →
Get more from it
Tips

Small habits that make Wristbeat faster to use, kinder to your battery and better on a run.

Read the tips →
Shape what's next
Ideas and roadmap

See what we're working on and suggest what Wristbeat should do next.

See the roadmap →

Download Wristbeat Bridge

Wristbeat Bridge is a free Mac app that shares the music in your Music library with Wristbeat. You don't need it if you use a music server. Read the step-by-step setup guide.

Wristbeat Bridge for Mac

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

Download for Mac
  1. Install. Open the downloaded file and drag Wristbeat Bridge into your Applications folder.
  2. Open it. Its icon appears in the menu bar at the top right of your screen. There's no Dock icon.
  3. Allow access. Let Bridge read your Music library when asked. If macOS asks whether Bridge may accept incoming network connections, click Allow.
  4. That's it. Bridge starts when you log in and keeps itself up to date.

Troubleshooting

Downloads are slow or stall
  • Keep Wristbeat open on screen during a large sync, and keep the watch near your Wi-Fi router.
  • Before a big download, turn off Bluetooth on the watch: Settings → Bluetooth → off. While your iPhone is nearby, Apple Watch sends its internet traffic through the phone over Bluetooth, which is much slower than Wi-Fi. With Bluetooth off, the watch uses Wi-Fi directly. This is true of every Apple Watch, including the newest. Wristbeat reminds you to turn Bluetooth back on when you play music.
  • Apple Watch Series 5 and earlier, and Apple Watch SE, only use 2.4 GHz Wi-Fi, which Bluetooth also uses, so turning Bluetooth off helps even more on these models. Series 6 and later, and Ultra, can also join 5 GHz networks: if your router has a separate 5 GHz network, connect the watch to it.
  • Even the newest Apple Watch uses an older Wi-Fi standard (Wi-Fi 4), so it downloads more slowly than your phone or Mac on the same network. That's normal. If only your watch is slow and everything else is fine, restart your router.
  • If a sync stops, tap Retry. Tracks already downloaded are kept.
The watch can't connect to my server
  • Enter the full address including the port, for example http://192.168.1.20:4533 for Navidrome on your home network.
  • For a home-network address, the watch must be on the same Wi-Fi network as the server.
  • Check that your username and password work in your server's own web page.
  • If your server is reachable from the internet, use its https:// address instead.
  • Use http:// at home. Apple Watch doesn't trust self-signed or private certificates. Use http:// with your server's home-network address, or a publicly trusted certificate (for example Let's Encrypt).
  • Login pages get in the way. If your server sits behind a login portal (Authelia, Authentik, Cloudflare Access), the watch can't get past it. Allow /rest/* through, or use the home-network address.
  • Tailscale addresses (100.x.x.x, *.ts.net) only work while your watch is going through an iPhone that's on Tailscale. Use the home-network address instead.
  • .local names may not work on the watch. Use the IP address.
Setup says your watch couldn't use the details

Your watch checked the server and something stopped it. The setup page on your phone shows what went wrong. Fix the details there and tap Fix and resend: you don't need a new code. The most common causes:

  • Certificate not trusted: use http:// at home (see above).
  • Wrong username or password: try them in your server's own web page first.
  • Not answering like a music server: a login page or a wrong path is in front of it.
  • Can't reach the server: for a home address, the watch must be on the same Wi-Fi. Check the port.

If the page says it didn't hear back, keep Wristbeat open on the watch with the code showing, and try again.

Wristbeat can't find Bridge
  • Make sure Bridge is running. Its icon appears in the Mac menu bar.
  • The Mac and the watch need to be on the same Wi-Fi network.
  • Otherwise, choose Pair with phone instead on the watch and scan the code shown in the Bridge menu.
Some songs are missing (Bridge)

Bridge shares the music you own: purchases, CD rips and DRM-free downloads. Apple Music subscription tracks are protected so they only play in Apple's own apps, and cloud-only or missing files can't be copied. Bridge skips these and shows how many it left out.

Wristbeat asks me to connect Bluetooth

Wristbeat plays through Bluetooth headphones or a speaker. It doesn't use the watch's own speaker.

  • AirPods: open the case near your watch. If they're set up on your iPhone, they usually appear on the watch automatically.
  • Other headphones: on the watch, open Settings → Bluetooth, put the headphones in pairing mode, and tap them when they appear.

Then tap Play again.

My watch is running out of space

Open a playlist and choose Remove from watch to free up space. Wristbeat checks free space before downloading and tells you if a playlist won't fit.

Why did my watch turn off while using Wristbeat?

Apple Watch batteries wear with age. A worn battery can still show plenty of charge but struggle to deliver a sudden burst of power. When the demand spikes, the voltage drops and the watch switches itself off and restarts. This mostly affects watches that are a few years old.

Playing downloaded music with your wrist down uses little power. The heavier moments in Wristbeat are:

  • Downloading playlists. This keeps Wi-Fi busy for minutes at a time, and it's the biggest drain Wristbeat causes.
  • Starting playback. Your headphones connect and audio starts up, which is a short burst.
  • Sending feedback. Dictation uses the microphone and the network at the same time.

To avoid it:

  • Download playlists while the watch is on its charger.
  • Start your music when nothing else is going on: not during a download, and not while you're scrolling through another app.
  • Send feedback when the watch is on its charger, or at least well charged.
  • Check Settings → Battery → Battery Health on the watch. If Maximum Capacity is below 80%, Apple recommends a battery service.
  • If the watch restarts, open Wristbeat. It reopens on the same song at the same point, paused, so just tap Play. Your downloaded music is still on the watch.

If you also use the Workout app, see the next question.

Why did my watch turn off when using Wristbeat with the Workout app?

As soon as you open the Workout app, it starts finding your location with GPS so it's ready when you begin. During the workout it keeps GPS on and reads your heart rate continuously. GPS is one of the most power-hungry parts of the watch.

On its own that's fine. The problem comes when several heavy things happen in the same few seconds, for example opening Workout, scrolling quickly through the workout list and starting your music at once. A worn battery can't cover all of them together, and the watch turns off.

Do one heavy thing at a time. Follow the recommended start-up sequence below.

Changing or disconnecting your server

Go to Settings → Server on the watch. Disconnect removes the saved login from the watch, and you can then connect a different server.

Still stuck? Report a problem

Tell us what you were doing, what you expected and what happened instead. Reports sent from the watch include diagnostics, so we can usually find the cause without a lot of back and forth.

Email us

A real person reads every message. We aim to reply within two working days.

From your watch
Settings → Send feedback

Dictate a message. It includes app diagnostics that help us find the problem (see the privacy policy).

Battery, workouts and music

These are the things that use the most power on Apple Watch when you exercise with music.

A healthy battery handles all of these easily. On an older battery, the trick is not to stack them.

Recommended start-up sequence

  1. Before you go. Download your playlists while the watch is on its charger.
  2. Connect your headphones to the watch.
  3. Start your workout first. Open Workout, choose your workout without long, fast scrolling, and let the countdown finish so the workout is running.
  4. Then start your music. Open Wristbeat and start your playlist. Wait until you hear it.
  5. Lower your wrist and go. During the workout, avoid long scrolling, Siri, sending feedback and downloads.
  6. Afterwards, end the workout, then pause your music. Send any feedback once the watch is back on its charger.

Free and Pro

Privacy

Wristbeat has no accounts, ads or tracking. Usage data stays on your watch unless you turn on sharing. Read the full privacy policy.