Stride BPM

Welcome to Stride BPM

Stride BPM reads your Apple Music library and tags each song with its beats per minute (BPM). That single number lets StrideSync automatically choose music whose rhythm matches the pace you're walking or running.

Think of Stride BPM as a preparation tool. You run it at your desk, tag your library, and StrideSync does the rest during your workout.

What Stride BPM does:

  • Reads every song in your Apple Music library or any playlist
  • Analyzes the audio of non-protected songs to detect BPM automatically
  • Lets you set BPM manually or by tapping in time with the beat
  • Writes the BPM value back into the Music library so it persists across devices
  • Stores BPM values for DRM-protected songs in iCloud so StrideSync can read them

What Stride BPM does not do:

  • It does not play music during workouts. That is StrideSync's job.
  • It does not require an internet connection for detection (local audio only).
  • It cannot analyze encrypted DRM tracks. Those must be tagged manually.

System Requirements

Required:

  • macOS 26.4 or later
  • Apple Music app installed and signed in with your Apple ID
  • iCloud account signed in, which is required to sync DRM song BPMs to StrideSync

Recommended:

  • Apple Music subscription, which gives access to your full iCloud Music Library
  • StrideSync installed on your iPhone, the companion app that uses BPM data during workouts
  • Songs downloaded locally, because BPM detection requires the audio file on disk

Permissions Stride BPM will request:

  • Apple Music access: to read your library and song list
  • Music folder access: to read audio files for BPM detection and preview playback
  • Automate Music: to write BPM values back into the Music app's library database
  • iCloud / CloudKit: to store BPM values for DRM-protected songs

Getting Started

Step 1: Connect to Apple Music

On first launch, click Connect to Apple Music. macOS will ask whether Stride BPM may access your media library. Click Allow. If you accidentally click Don't Allow, go to System Settings → Privacy & Security → Media & Apple Music and re-enable access.

Step 2: Grant Music Folder Access

After Music access is granted, click Grant Access to Music Folder. A folder picker opens at your home directory. Single-click the Musicfolder to select it, then click Grant Access. Do notdouble-click or navigate inside the folder. Selecting a subfolder will break file access. You only need to do this once.

Step 3: Allow Automation (first BPM write)

The first time you save a BPM value, macOS asks whether Stride BPM may control the Music app. Click Allow. Without this permission, BPM values cannot be written into the Music library database.

Step 4: Browse and Tag

Your library loads in the sidebar. Select All Songs or a playlist, then start detecting or entering BPM values.


Your Music Library

Sidebar:

  • All Songs: every song in your Music library, sorted alphabetically
  • Playlists: all user-created playlists, sorted alphabetically

Song table columns:

  • Title, Artist, Album: track metadata from Music
  • Genre: used by the genre filter dropdown
  • Time: track length in m:ss
  • BPM: displayed in green when tagged, or a dash when untagged
  • Cloud: indicates iCloud Music Library status and download state
  • DRM: a lock icon marks DRM-protected songs that cannot be automatically analyzed

Click any column header to sort by that column. Click again to reverse the sort.

Filter bar:

  • Search: filter by title or artist
  • Genre: narrow the list to one genre
  • All / Tagged / Untagged: focus on songs that still need BPM values
  • Reset columns: restores every column to its default width

Click the Refresh (⟳) button to reload the library from Music.


Detecting BPM

BPM detection analyzes the audio waveform of a song to find its beat. Detection typically takes 3–8 seconds per song for local files.

Single song: Select a song, then click Detect BPM in the detail panel on the right.

Batch detection: Right-click one or more songs and choose Detect BPM for N Songs. Click Cancel to stop after the current song finishes.

Requirements for detection:

  • The song must be downloaded locally. Cloud-only tracks cannot be analyzed.
  • The song must not be DRM-protected. Encrypted files cannot be read.
  • The song must be a standard audio file macOS can decode (such as M4A, AAC, MP3, AIFF, or WAV) and at least 10 seconds long.

Downloading cloud songs: Songs not yet downloaded show an orange ↓ icon in the Cloud column. Click the icon. Stride BPM copies the song title to your clipboard and opens Music. Paste into the Music search bar, find the song, and click its download button. Return to Stride BPM and click ⟳ to refresh.

If a song already has a BPM tag in Music, Stride BPM displays it immediately without running the analyzer.

Automatic BPM Adjustments

You can set these under Stride BPM → Settings… (⌘,):

  • Divide by 2 (default 190 BPM): Songs detected above this threshold are halved. Beats at 160–200 BPM are almost always double-timed. Halving lands them in the 80–100 BPM walking range.
  • Multiply by 2 (default 50 BPM): Songs detected below this threshold are doubled. Beats at 40–60 BPM are almost always half-timed. Doubling lands them in the 80–120 BPM walking range.

Halving is applied first, then doubling. Adjusting these thresholds can significantly increase the number of songs available to StrideSync without manual re-tagging.


Tagging Manually

Manual tagging is useful for DRM-protected songs, inaccurate detection results, or any song where you know the correct BPM.

Manual BPM entry: Select a song. In the detail panel, click Set BPM(or click the existing BPM value to edit it). Type the BPM value and press Return, or click Apply.

Tap Tempo: Tap in time with the beat to measure BPM.

  • Click the TAP button (or press Space) at least 4 times in time with the beat
  • The current BPM reading updates after every tap
  • Click Apply or press Return to save the displayed value
  • Taps reset automatically after 3 seconds of inactivity
  • Click Reset to start over

Tip: For best accuracy, play the song in Apple Music while tapping. Aim for 8–16 taps.

Undo: Any BPM change can be undone with ⌘Z and redone with ⌘⇧Z.


DRM-Protected Songs

Some songs are DRM-protected. Their audio is encrypted and cannot be read by third-party apps. This includes:

  • Older iTunes Store purchases (before 2009) in .m4p format
  • Apple Music subscription tracks, shown as "Apple Music AAC audio file" in the Music app, whether streamed or downloaded
  • Downloads in .movpkg format

All of these use Apple's FairPlay encryption.

DRM songs display a lock icon in the DRM column of the song table. Stride BPM cannot detect their BPM automatically.

Tagging DRM songs has two options:

  • Tap Tempo: play the song in Apple Music and tap along in Stride BPM
  • Manual entry: look up the BPM online and type it in

Because Stride BPM cannot write to encrypted DRM files, BPM values for DRM songs are stored in your private iCloud database (CloudKit). They are never visible to anyone else.

StrideSync on your iPhone reads these CloudKit records automatically, so DRM songs tagged in Stride BPM work in workouts just like any other tagged song.

Use Help → CloudKit Diagnostics… to confirm DRM BPM values are stored correctly in iCloud.


StrideSync

StrideSync is the companion iPhone and Apple Watch app that automatically selects music from your library to match your walking or running cadence.

Your Apple Watch measures your step rate every second and sends it to the iPhone app. StrideSync looks through your library for songs whose BPM tag falls within your chosen tolerance of your current stride rate.

  • Cadence is detected automatically, with no buttons to press during your workout
  • Song matching uses a configurable ±1–10 BPM tolerance window
  • Apple Watch provides skip, pause, shuffle, and tolerance controls

StrideSync cannot analyze audio on its own. A song without a BPM tag is completely invisible to StrideSync's cadence matcher. Stride BPM is the tool that adds those tags.

DRM-protected tracks (.m4p files, Apple Music tracks, and .movpkg downloads) cannot be analyzed automatically. Stride BPM stores their BPM values in CloudKit, and StrideSync reads those records automatically.

How BPM data reaches StrideSync:

  • Standard songs (M4A / MP3): BPM is written into the Music library database and syncs to your iPhone via iCloud Music Library
  • DRM-protected songs (.m4p / Apple Music / .movpkg): BPM is stored in CloudKit and read directly by StrideSync. No manual sync step is required.

Tips for Best Results

Aim for at least 50–100 tagged songs spread across your target BPM ranges.

BPM ranges by activity:

ActivityBPM Range
Walking90–125
Brisk Walking110–135
Light Jog135–155
Running155–185
Elliptical100–160
  • Create activity-specific playlists in the Music app (e.g. Walking, Running, Gym) and point StrideSync at the right one per workout.
  • Tag music you actually enjoy. A library of 200 songs you love will produce far better workouts than 1,000 you're indifferent to.
  • Use Tap Tempo for DRM songs. Don't skip them. Play in Apple Music and tap along. 8–16 taps gives a reliable reading.
  • BPM detection occasionally returns exactly half or double the actual tempo (e.g. 68 instead of 136). If a result seems off, use Tap Tempo to verify and correct it.

Diagnostics

Stride BPM includes two diagnostic tools, both in the Help menu.

Music Access Diagnostics

Help → Music Access Diagnostics…

Run this if songs fail to load, BPM detection cannot read audio files, or you see file permission errors.

What each check means:

  • Apple Music (MusicKit) authorization: confirms Stride BPM is allowed to read your Apple Music library
  • Music folder security-scoped bookmark: confirms a Music folder bookmark has been saved
  • Bookmarked folder path: verifies the bookmark points to ~/Music, not a subfolder. A subfolder means access was granted incorrectly and must be re-granted.
  • Music folder file-system access: confirms the app can list files inside ~/Music using the stored bookmark
  • iTunes Library (ITLibrary) access: confirms the iTunes library database can be opened
  • DRM-protected file format detection: reports how many songs in the current view are DRM-protected and scans your Music folder for .m4p and .movpkg files

If the folder path check fails: click Grant Access to Music Folderin the diagnostic window. When the picker appears, single-click the Music folder (do not navigate inside it), then click Grant Access.

Click Email Diagnostics to send the full report to [email protected], or Copy Report to copy it to your clipboard.

CloudKit Diagnostics

Help → CloudKit Diagnostics…

Run this if DRM song BPM values appear in Stride BPM but are not visible in StrideSync.

What each step means:

  • iCloud account reachable: confirms your Mac is signed into iCloud
  • Write test record: creates a harmless temporary record in your private iCloud database
  • Read test record: fetches the record back and verifies its value
  • Remove test record: deletes the temporary record, so nothing is left behind
  • Fetch stored BPM values: retrieves the BPM for each DRM song in your current view

Switch to All Songs before opening diagnostics to see your entire DRM song inventory.

Click Email CloudKit Diagnostic to send the full report to [email protected].