PeerClock Metronome User Manual
Practice alone or together · Tempo and meter · Auto Tempo · Local Wi-Fi sync
Updated November 15, 2026 · PeerClock Metronome 1.1.0 (13) · PeerClock 0.4.2
Version, devices and scope
PeerClock Metronome plays a regular click and shows an animated conducting pattern. Use one device for individual practice, or open the app on several devices on the same local Wi-Fi network to share timing and playback controls.
This manual covers PeerClock Metronome 1.1.0 (build 13), using PeerClock 0.4.2. The public version was checked on November 15, 2026. It requires iOS 17 or later on iPhone, or iPadOS 17 or later on iPad. The App Store listing also lists Apple Silicon Mac and Apple Vision compatibility; the touch instructions here describe iPhone and iPad, and do not establish testing on those other platforms.
No account or synchronization subscription is required. The app is free and includes advertising. This guide describes the released interface and reviewed source paths. It is not a new measurement of multi-device timing, Bluetooth performance or background reliability.
Your first practice session
- Open the app and set a comfortable device volume. Allow Local Network access if you want to synchronize with other devices.
- For a steady-tempo exercise, open Auto Tempo, turn off Increase tempo automatically, and tap Done.
- Drag the large BPM number upward to increase the tempo, or downward to decrease it. Select 4/4 from the row below.
- Tap the circular triangle button. It changes to a square while playing. Follow the clicks and moving dot.
- Tap the square to stop. When peers are connected, this also sends a stop command to them.
For your first group session, connect everyone before starting, wait for the synchronization display, and let one person operate the controls. A regular-tempo start follows the shared beat grid: the first audible click is not a guaranteed count-in or beat 1. Listen for the stronger downbeat before entering.
Set the tempo
The large number is the tempo in BPM. Its range is 30–300 BPM. Drag vertically on the number; upward movement increases it in integer steps. Double-tap the number to return to 120 BPM. There is no numeric-entry field or tap-tempo function: repeated tapping does not measure your rhythm.
With Auto Tempo off, tempo and time-signature changes can be made while playing and are sent to connected peers. The audio change is scheduled on the shared clock with about 200 ms lead; the display may change first. This is not an instantaneous change or a promise to wait for the next bar.
While Auto Tempo is playing, the main tempo and meter controls are disabled. Stop first. If Auto Tempo is enabled while stopped, changing the large BPM number changes its starting tempo; the target is raised if necessary so it cannot be below the start.
Choose the meter and subdivisions
Tap a time-signature capsule beneath BPM. Swipe the row horizontally if the desired option is outside the visible area. The selected meter is highlighted. These are the available patterns:
| Meter | Main beats per bar | Clicks per main beat | BPM counts |
|---|---|---|---|
| 4/4 | 4 | 1 | Quarter-note beats |
| 3/4 | 3 | 1 | Quarter-note beats |
| 4/8 | 4 | 1 | Eighth-note beats |
| 3/8 | 3 | 1 | Eighth-note beats |
| 6/8 | 2 | 3 | Dotted-quarter groups |
| 9/8 | 3 | 3 | Dotted-quarter groups |
| 12/8 | 4 | 3 | Dotted-quarter groups |
In compound meters, the three clicks inside each main beat are automatic. At 60 BPM in 6/8, a main beat lasts 1 second, with three evenly spaced clicks; a bar lasts 2 seconds. Do not read that BPM as the rate of each eighth-note click.
The same grouping drives the conductor animation and the bar count used by Auto Tempo. Subdivision and accent patterns are fixed by the chosen meter. There is no separate subdivision selector, swing control or custom-meter editor.
Clicks, accents and volume
The first click of a bar is strongest and highest. Other main beats use a medium click; compound-meter subdivisions use a softer, lower click. This makes the bar boundary and internal grouping audible without programming an accent pattern.
The released app uses one fixed synthesized click set. It does not expose sound selection, per-beat mute, accent editing or an independent in-app volume slider. Adjust the device volume and choose headphones or speakers through the operating system. Each device renders its own clicks, so its output choice and volume remain local.
The audio session permits mixing with other audio. A backing track may therefore play alongside the metronome, depending on the other app and system audio state. This does not synchronize the backing track to the metronome. The app does not record your instrument or listen through the microphone to detect tempo.
Read the conductor display
The center of the screen shows a conducting path, numbered main beats and a moving light. The path has 2, 3 or 4 main beats according to the meter: 6/8 uses 2, 9/8 uses 3 and 12/8 uses 4. The stronger flash marks the bar opening; weaker flashes distinguish the remaining clicks.
Use this display for orientation and silent visual following. It is an animation, not a touch-sensitive conducting surface: dragging the path does not conduct the ensemble or create beats. The question-mark button opens the built-in help, and its Done button returns to the main screen.
Screen refresh and audio scheduling follow different paths. The graphic is not a precision measurement of speaker onset, and comparing two moving dots is not a substitute for checking audible clicks. The path preserves its proportions when the available window shape changes.
Practice with Auto Tempo
Auto Tempo increases speed after complete bars, then continues at the target. Stop playback, tap Auto Tempo, and enable Increase tempo automatically. Use the stepper buttons to set:
- Starting tempo: 30–300 BPM.
- Target tempo: from the starting tempo through 300 BPM.
- BPM increase: 1–270 BPM per step.
- Bars per increase: 1–64 complete bars.
Tap Done to save, or Cancel to discard the sheet's edits. The initial settings are 80 → 120 BPM, +2 BPM every 4 bars. For example, four bars play at 80, then four at 82, and so on. The final step is limited to the target; playback does not stop there. Equal start and target values give a constant tempo.
Pressing Play begins a new progression at the starting tempo. Stop and Play restart it; they do not pause and resume its bar count. With connected peers, the start has at least 0.5 seconds of preparation time so devices can receive the shared timeline. Every participating device needs an Auto Tempo-compatible version. Set up the whole group while stopped, then start from one device.
What the app remembers
Auto Tempo's start, target, increase, bar interval and enabled state are saved on the device when you tap Done. They are restored after reopening the app. When enabled, its starting BPM is restored to the main display. Ramp settings received from another device are also saved locally, so a group session can change the progression you see next time.
The ordinary BPM and selected time signature are not separately saved as a practice preset. A fresh launch normally starts at 120 BPM and 4/4, except for the restored Auto Tempo starting BPM. Playback itself does not resume automatically.
There is one saved Auto Tempo setup, with no named preset library, set list, song sequence, export or cloud backup interface. Write down the meter and desired exercise separately if you need to reproduce a session. Saving Auto Tempo on one stopped device does not by itself start the other devices.
Connect several devices
- Install a compatible version on every device and connect them to the same local Wi-Fi network.
- Open PeerClock Metronome on each device and allow Local Network access. Leave all devices stopped during setup.
- Wait for the peer count and Synced status. The count represents other discovered peers, not a roster with their names.
- On the device you will operate, choose the tempo, meter and Auto Tempo setup, then press Play.
- Confirm that every device is playing the intended pattern before starting the exercise.
Discovery is automatic using Bonjour. There is no Host, Join, pairing code, IP-entry field or room selector in this app. An internal clock reference is chosen automatically; musicians do not have to select a master.
A device arriving after playback has started is not guaranteed to receive the current playing state and settings immediately. To include it reliably, stop the group, wait for synchronization, check the intended settings and start again from the operating device. Rejoining is also a reason to recheck the whole group.
Read synchronization status
- Standalone: no peers are currently counted; local practice remains available.
- Searching…: peers exist but the app does not currently show a synchronized clock state.
- Synced: the clock library reports a synchronized state.
The adjacent ±x.xms number needs careful interpretation. In this release it is calculated as half of the reported round-trip network delay. It is not a measured difference between the audible clicks, a measured residual clock offset, or a guaranteed error bound.
The automatically selected reference device can show ±0.0ms because its reference quality is reported as zero round-trip delay. That does not prove perfect alignment of every speaker. Use the status and count to diagnose connection state, then listen to the actual outputs. A brief transition while a device joins, leaves or reconnects may require the group to settle and restart.
How synchronization and latency work
PeerClock estimates clock differences through repeated four-timestamp exchanges. Its default round requests 40 measurements, keeps the faster half and averages their offsets. It repeats synchronization, with intervals adapting from 5 to 30 seconds. Each app then schedules locally generated clicks against that common time; it does not stream one device's audio to the others.
The advertised ±2 ms clock figure describes an intended timing capability under suitable network conditions. It is not an unconditional acoustic guarantee. Network congestion, asymmetric delays, device load and audio hardware can affect the result. No new end-to-end timing measurements were made for this manual.
The app automatically schedules clicks earlier using the operating system's reported output latency. There is no manual latency slider or calibration procedure. Bluetooth can add variable buffering; route changes may briefly interrupt playback. For a predictable setup, compare outputs before practice and try built-in speakers or wired headphones if Bluetooth sounds late. Speaker distance also changes when sound reaches each listener.
Network and permission checks
Synchronization needs local device-to-device communication, not internet access. Devices on a guest Wi-Fi, isolated school or venue network, separate subnet, or filtered VPN connection may be unable to discover or reach one another even when the Wi-Fi names look similar. Ask the network administrator to permit local discovery and communication, or use a suitable shared local network.
If access was denied, open Settings → Privacy & Security → Local Network and enable PeerClock Metronome, then reopen it. Apple's Local Network permission guide explains this control.
The released app has no room code, peer approval list or password for separating simultaneous groups. Use a trusted rehearsal network and check the peer count. Internet-separated locations are outside this workflow. The library's other transport options do not establish a Bluetooth-only, cellular or remote-session mode in this app.
Background playback and interruptions
The app declares background audio support and uses an audio playback session. Playback can continue when the screen locks or another app is foregrounded, subject to operating-system audio and lifecycle behavior. This does not guarantee uninterrupted peer discovery, reconnection or synchronization under every background condition.
The engine attempts recovery after an interruption that the system permits it to resume, an audio-route configuration change, or an audio-services reset. During an Auto Tempo interruption, the shared progression can continue advancing; resumed sound may therefore be at a later tempo instead of where you last heard it.
For ensemble setup, keep the apps visible until all devices are synchronized. After a call, output switch or long background interval, compare the displayed tempo and listen again. If a device remains silent or out of step, stop the group and restart. The app provides no user-facing pause that freezes the common exercise timeline.
Advertising, permissions and privacy
The reviewed release is free with advertising. It has no purchase screen, subscription, Restore Purchases action or paid ad-removal control. An interstitial can appear after every 3 locally initiated stops when an ad is ready. A remotely received stop does not increment that counter. Availability varies.
Who processes data, and why
Hakaru Hirose provides the app and uses Google services for advertising, usage analysis and stability diagnostics. Google AdMob can process device identifiers, advertising interactions, IP addresses and diagnostic information to deliver and measure ads. Firebase Analytics handles usage events and app/device information; the app also logs tracking-authorization status and advertising/consent errors. Firebase Crashlytics handles crash reports and associated installation/device information to investigate faults. These services can contact external servers; local clock synchronization does not make the whole app internet-free.
Permissions and choices
Local Network permission enables nearby peer discovery and communication. The App Tracking Transparency (ATT) request concerns tracking and access to the advertising identifier (IDFA). You can refuse it and still use the metronome. Change it in Settings → Privacy & Security → Tracking; refusing tracking is not a switch that disables all advertising or diagnostics. See Apple's tracking controls.
The app requests consent information through Google User Messaging Platform (UMP) and asks it to show a consent form when required. The displayed choices depend on the service's regional and account configuration. Respond to the form if it appears. Version 1.1.0 has no separate in-app privacy-options screen for reopening that form, and no analytics or crash-reporting switch. Contact support about choices you cannot access. The UMP documentation describes the service; its full recommended settings are not all exposed by this app.
Location, audio and saved settings
The app does not request GPS/location permission or record microphone audio. Advertising services may nevertheless infer a general location from the IP address. Auto Tempo settings are stored locally; synchronization exchanges timing and control data between local peers, not recordings. If you email support, your message and email address are available to the recipient for handling your request.
Consult the Google Mobile Ads data disclosure, Firebase privacy information and App Store privacy disclosure. This guide does not establish an app-specific retention period or promise deletion on uninstall. For privacy, retention or deletion questions, contact hirose@hakaru.net.
Troubleshooting, support and sources
| Symptom | What to do |
|---|---|
| No peers / Standalone | Check the same local network, Local Network permission and client isolation. Reopen the apps after correcting access. |
| Peers found, still Searching… | Allow time for synchronization. Reduce congestion and keep devices foregrounded; reconnect if the state does not settle. |
| Synced, but one device is silent | Check its volume, audio route and Play state. Clock synchronization alone does not start a late joiner. Stop and restart the group. |
| Different tempo or pattern | Compare BPM, meter and Auto Tempo on every device. Use one operator and restart after all peers connect. |
| Auto Tempo unexpectedly stops accelerating | In 1.1.0, a stopped peer turning Auto Tempo off can interfere. Stop everyone before editing, then restart the intended progression. |
| A click sounds late or doubled | Compare built-in or wired output, check speaker distance and network quality, and stop/restart after route changes. The ±ms display is not an acoustic error reading. |
| Controls cannot be changed | Stop an active Auto Tempo exercise. Wait for playback setup to finish before editing. |
| Settings changed after reopening | Only Auto Tempo settings persist; received ramp settings can replace them. Ordinary BPM and meter are not a saved preset. |
For support, include the app version, OS version, device models, number of devices, meter, BPM or ramp settings, network type, audio outputs and the shortest reproduction steps. Describe whether the problem affects sound, the animation or the connection display. Contact hirose@hakaru.net.
Basis of this guide
Public version data was checked with Apple Lookup. The application behavior was reviewed against the source associated with the 1.1.0 build 13 submission; that application repository is private and is not a public download. The timing library is public: PeerClock 0.4.2. Later development fixes are not described as shipped features. No app launch, audio test, network synchronization trial or new screenshot capture was performed for this guide.