Guide

Friends Run Repeat keeps your races, medals, training plan and running friends in one place. On your home screen it's called Friends Run. Search FRR in Spotlight or ask Siri to "Open FRR".

On this page: Getting started · Using the app · Sharing · Training plans · Workouts, backup and offline · Help

Getting started

Install. Friends Run Repeat is in testing: get it through TestFlight. Turn on automatic updates in TestFlight so you always have the latest version.
Sign in with Apple to share with family and friends and back up your data. You can also look around first without an account.
Your name. Enter the name friends know you by; it shows on races and photos you share. Tap Later to skip.
Allow notifications when asked. That's how you hear that someone added you to a race, run or group.
Connect Apple Health in Profile, so runs from your Apple Watch, or a Garmin that syncs to Apple Health, tick off your plan by themselves.

Using the app

Area	What it's for
Today	Today's planned run, and new workouts from Apple Health to match to your plan
Plan	Your training plan week by week, and importing a new one
Together	Your people, groups, invitations, and races and runs you share
Passport	Every race you've done or entered: List, Globe and Medals

Passport. Tap + to add a race weekend: name, dates, place, and the races in it. Open a race to add results, your medal, bib and certificate, and notes.

The With filter. At the top of Passport, tap With anyone to pick people or groups, several at once. Pick two people and you see only races all of you ran together, with a summary of races, places and miles. The filter stays on as you switch between List, Globe and Medals; tap Clear to turn it off.

Medals. Group your medals by year, distance, club or people. Tap a medal to open the race.

Photos. On a race, tap Add under Medals and photos, pick photos, then say what they are: medal, finish line, group, bib, certificate or other. Tap ⋯ under a photo (or press and hold it) to change what it is, or to use it as the backdrop, the big picture on the race card.

On an iPhone with a fold-out inner screen, the app uses the whole screen, with the areas in a bar on the right.

Sharing needs an account, and nothing is shared until you choose to share it.

Connect. In Together, tap Invite to send a link, or Code to swap a code in person. The link works even if they don't have the app yet: it shows them how to get it.
Share a race. Open a race and add people you're connected with. Past races work too: add the friends who ran it with you.
Accept. When someone adds you, you get a notification and an invitation in Together. Accept it and the race lands in your Passport with their medal and group photos. Choose which races in the weekend you ran.
Photos both ways. Photos added to a shared race go to everyone in it. You get the race owner's backdrop by default; pick your own any time, and it only changes on your phone.
Groups. Make a group for your crew. When you add someone, tick the past runs and races they were actually at. Plan a run so everyone sees it.
Removing people. If you started a race, run or group, tap ⋯ (or the person's name on a run) to remove someone or cancel an invite they haven't accepted. Anyone can leave at any time.
Report and block. Tap ⋯ under a photo someone shared to report it; it disappears from your phone. On a person's page you can report or block them. Blocking disconnects you, cancels their invitations to you and hides their photos; unblock in Profile. Reports are reviewed within 24 hours.

Privacy. Until someone accepts an invitation, they see only the race's name, date, place and who invited them. There's no public profile or search. Read the privacy policy.

Training plans

The app doesn't write training plans. It reads the plan you already have and puts each day in Plan and Today. Check with your doctor before starting any running plan.

A file or picture: CSV, Excel, PDF, a calendar file, a screenshot of a plan, or a photo of a printed one.
Paste text: a table or a list of days from an email or website.
From an AI: copy the prompt the app gives you into ChatGPT, Claude or any AI with your plan, then paste the answer back.

You see every day before anything is saved: fix a row, skip a line, then approve. If you already have a plan, you can replace its future days with the new one; days you've done stay.

No plan yet? Tap Make one with an AI. Pick your race and date and the app writes a prompt for any AI, which asks about injuries, limits and schedule first, then writes a plan the app can import.

Workouts, backup and offline

Workouts. With Apple Health connected, a run that clearly matches the day's plan ticks it off. Others wait under New workouts on Today: match one to a day, keep it as an extra run, or ignore it. A run recorded by two devices counts once.

Backup. Signed in, your races, medals, photos and plan back up once a week on Wi-Fi. Profile has Back up now, Restore from my backup, a switch for the weekly backup, and saving a copy to Files.

Offline. Everything shared with you is saved on your phone, so it shows without signal, and photos you add offline upload when you're back online.

Help