Support
Email support@headwall.app. Say what you're running Headwall on — just the app, a Headwall box, or an Apple TV — what the screen shows, and what you expected instead. We read every message.
What you need
- On your own: an iPhone or iPad (iOS 16.4 or later) with Headwall. That is the whole list — the timer runs in the app, with or without a network.
- For heart rate: an iPhone and a Bluetooth heart-rate strap or watch. Not iPad.
- To share or follow a timer: an iPhone or iPad with Headwall, and an internet connection on both devices. Not the Apple TV or the box.
- On a wall: a Headwall box connected to a TV over HDMI, or an Apple TV (tvOS 16 or later) with Headwall TV — with the phone and the wall on the same Wi-Fi network.
FAQ
Do I have to pair with anything?
Only if you want a wall — the app's own timer needs no pairing at all. To drive a wall, open its PHONE screen. It shows a QR code and a short code underneath. Scan the QR with Headwall, or type the code. You do this once; the phone remembers the wall, and you can switch between it and the phone's own timer whenever you like.
Does it need the internet?
No — and it does not need a network at all if you are using the app's own timer. When you do drive a wall, that happens over your local network. Headwall contacts a server only when you share your timer or follow someone else's, and the timer keeps working if the connection to the outside world drops.
My phone can't find the wall.
First, check you meant to use one — the app runs its own timer with no wall in sight. If you do want the wall: check the phone and the wall are on the same Wi-Fi — not a guest network. Some routers have "client isolation" or "AP isolation" that stops devices seeing each other; turn it off for the gym's network. If the wall is an Apple TV, Headwall TV must be open on screen: tvOS pauses apps in the background, and a paused app is invisible to the phone.
Can I have more than one screen?
Yes. From its own menu, an extra screen joins the head timer and mirrors it. Boxes and Apple TVs can mix; the one running the clock is the head timer, the rest follow.
Someone else took control of the timer.
Only one phone drives a wall at a time. When a new phone pairs, the previous one is told it was replaced. Scan the code again to take over.
How do I share my timer?
On the app's own timer, open the ⋯ menu and choose Share timer (on iPad, it is among the side buttons). Headwall shows a six-character code and a QR. Read the code out or let people scan the QR. Stop sharing ends it for everyone. It needs an internet connection, and only the app's own timer can be shared.
How do I follow someone's timer?
On an iPhone or iPad, open the timer picker, choose Follow a shared timer, and type the code or scan the QR. If you scanned the QR with the Camera app you landed on a page with the same steps. You watch the clock; only the person sharing controls it, and you can still tally, finish and log for yourself.
The shared timer stopped.
A shared timer ends after four hours with no change, or twelve hours in all. It also ends when the person sharing taps Stop sharing, and then the follower reads THIS SHARED TIMER HAS ENDED. Ask them to share again and follow the new code.
Can I share what's on the gym's wall?
No: sharing is for the app's own timer.
Do I need the iPhone app?
Yes, to drive a wall from a phone: the app scans the wall's code and becomes its remote. For the timer, heart rate, your log and your own workout library, the app is the product. A wall does not need a phone to run, though: a Headwall box or an Apple TV is driven by its own remote.