Support
Fix a problem, get more out of Wristbeat, or tell us what to build next.
Getting started with Wristbeat
Connect your music, download your first playlist and head out with just your watch.
Read the guide →- 1Connect your music
- 2Download a playlist
- 3Connect headphones
- 4Leave your phone at home
Answers to common setup, sync and playback problems, and how to report one we haven't covered.
Find a fix →Small habits that make Wristbeat faster to use, kinder to your battery and better on a run.
Read the tips →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.
Version 1.0.2 · macOS 13 Ventura or later · Apple silicon and Intel · 2.0 MB · Free
- Install. Open the downloaded file and drag Wristbeat Bridge into your Applications folder.
- Open it. Its icon appears in the menu bar at the top right of your screen. There's no Dock icon.
- Allow access. Let Bridge read your Music library when asked. If macOS asks whether Bridge may accept incoming network connections, click Allow.
- 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:4533for 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. .localnames 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.
A real person reads every message. We aim to reply within two working days.
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.
- Downloading over Wi-Fi. This is the biggest drain, and it lasts as long as the download does.
- GPS. The Workout app turns it on when you open it, and keeps it on for outdoor workouts.
- Short bursts. These come from the screen being on while you scroll, dictation or Siri, starting Bluetooth audio, and launching apps.
- Heart-rate sensor. It reads continuously during a workout.
- Playing downloaded music with your wrist down. This uses the least.
A healthy battery handles all of these easily. On an older battery, the trick is not to stack them.
Recommended start-up sequence
- Before you go. Download your playlists while the watch is on its charger.
- Connect your headphones to the watch.
- Start your workout first. Open Workout, choose your workout without long, fast scrolling, and let the countdown finish so the workout is running.
- Then start your music. Open Wristbeat and start your playlist. Wait until you hear it.
- Lower your wrist and go. During the workout, avoid long scrolling, Siri, sending feedback and downloads.
- Afterwards, end the workout, then pause your music. Send any feedback once the watch is back on its charger.
Free and Pro
- Free: 60 minutes of listening every week, starting from your first play. When the week is up, the next play starts a new week. Pairing, browsing and downloading are always free. Settings → Wristbeat Pro on the watch shows your minutes left and when they reset.
- Wristbeat Pro: unlimited listening, $9.99 a year. Wristbeat never stops music mid-run: the upgrade screen only appears when you start a playlist.
- Buying while offline: a purchase needs a connection. If your watch is offline, connect to Wi-Fi or bring your iPhone nearby, then tap Try Again.
- Restore: on a new or reset watch, open Settings → Wristbeat Pro → Restore Purchases.
- Manage or cancel: in your Apple Account settings on your iPhone, under Subscriptions. If Pro ends, you go back to the free hour each week, and your music stays on the watch.
- Refunds: handled by Apple at reportaproblem.apple.com.
Privacy
Wristbeat has no accounts, ads or tracking. Usage data stays on your watch unless you turn on sharing. Read the full privacy policy.