RUNSTAT
Help
If something is unclear while using RunStat, look here first. If you can’t find it, send an email.
About RunStat
RunStat is an iPhone app that turns the routes you run into drawings and grows a character as you run. It reads the runs saved in Apple Health and shows them to you.
- Each route becomes a drawing card. Name it, pick a color, and send it as an image or a link.
- Your runs become three stats, Endurance, Consistency and Art. As their sum (Total) rises, a character hatches from an egg and grows.
- There is no account, server, advertising or analytics. Your records stay on your iPhone, and where you ran is never stored.
- From RunStat 1.1 you can place a sketch on the map to plan a drawing before you run, and see your character in Home Screen and Lock Screen widgets.
- It is free, with no subscription and no in-app purchases.
Please note. RunStat is an app for enjoying your running records. It does not advise on or diagnose your body, injuries or training, and it is not a medical device. Stats are just your records turned into game numbers.
Getting started
How do I connect Apple Health?
Tap “Connect Apple Health” on the Home tab or in Settings, then allow reading Workouts and Workout Routes in the iOS permission sheet. Connecting imports your runs from the last 90 days. After that, new runs are imported each time you open the app.
What does it read?
Only running workouts (start and end time, duration, distance, and the name of the app or device that recorded them) and the workout route of each run. It only reads and never writes to the Health app. See the Privacy Policy for details.
Can I look around without any runs in the Health app?
Yes. Tap “Look around with sample runs” to see the Home, Runs, card and Sketches screens with nine made-up runs and two sketches. While the “Viewing sample runs” bar is shown at the top, you are looking at samples. They are not saved and are never mixed into your own records. Tap “Exit” on the bar to return to your own records.
Which watch or app should I run with?
The Workout app on Apple Watch, or any app that saves your run to Apple Health as a workout. For a drawing to appear, the workout needs to include a workout route.
When records don’t show up
My runs are not imported
- Check that the Health app actually has running workouts. Other workouts such as walking are not imported.
- In the Health app > your profile (top right) > Apps > RunStat, check that reading Workouts is turned on. iOS does not tell an app whether read access was allowed, so if it is off the app simply sees no runs.
- Tap Settings > Import now in RunStat.
- Health data cannot be read while the iPhone is locked. Unlock it and open the app.
- Runs from more than 90 days before the day you connect are not imported.
A run is there but has no drawing
- A drawing can’t be made for a run with no route, such as an indoor (treadmill) run.
- In the Health app > your profile (top right) > Apps > RunStat, turn on reading Workout Routes. The drawing appears the next time runs are imported.
- Right after a run, the route can take a little while to arrive on your iPhone from your watch. Open the app again a bit later.
What happens when I delete a run in the Health app?
From RunStat 1.1, a run you delete in the Health app is also removed from RunStat the next time it imports, and your character’s growth is recalculated from the runs that remain. The Runs tab and Settings show how many were removed until you tap “OK”. A run is removed only when it is certain that it was deleted. If the Health app could not be read, or the result has no runs at all, nothing is removed. So if you deleted every run in the Health app, use Settings > Delete all records in RunStat.
Distances are shown in km (or miles)
The app follows Settings > General > Language & Region > Measurement System on your iPhone: kilometers for Metric, miles otherwise. On the website you can switch with the button at the bottom of the page. The app is available in Korean and English; if your iPhone language is not Korean, it is shown in English.
Character and stats
How do stats go up?
- Endurance: 1 for every 3 minutes run, up to 20 a day (60 minutes).
- Consistency: based on the number of days you ran that week (Monday to Sunday): 10 for the first day, 14 for the second, 18 for the third and fourth, and 4 from the fifth day on. A day with less than 5 minutes of running is not counted.
- Art: 8 for each run with a route, and 8 more when you name that drawing.
Running faster or farther does not earn more. Time beyond 60 minutes a day and days from the fifth in a week add only a little, and streaks are not counted. Rest days are fine.
When does the character grow?
When Total, the sum of the three stats, reaches 100, the egg hatches. The highest stat at that moment decides the type: Strider (Endurance), Ticktock (Consistency) or Doodle (Art). After that it grows every time Total rises by 100, evolves to Lv.2 at 500, and gains a level every 500.
Why don’t runs from before I connected count toward growth?
So that the character does not grow all at once from past records the moment you connect, only runs from the day you connect Apple Health count toward growth. Runs from the 90 days before that can still be viewed as drawings and made into cards.
Does a character grow on the website too?
Yes. “My drawings” on the website grows a character by the same rules. Only drawings you made by uploading a run (GPX) and kept with their date are counted. Sketches and drawings received by link are not counted. The character is recalculated from the kept drawings each time, so deleting a drawing can change it. The character on the website exists only in that browser and is not linked to the one in the app.
Drawing cards and sharing
What is on a card?
The shape of the drawing, its name, distance, duration, pace, the date (which you can turn off) and your character’s level. There is no map and no latitude or longitude. A link made with “Copy link” carries the same information only, and the person who receives it can view the drawing on the web.
What is “Hide the first and last 150 m”?
A card has no location, but the shape of a route alone can hint at a neighborhood. Because many runs start and end at home, the setting that leaves the first and last 150 m out of the drawing is on by default. You can turn it off for each card.
Do you store where I ran?
No. The coordinates of a route you ran are turned into the shape of a drawing on your iPhone and then discarded. No latitude or longitude of where you ran is left in the app’s storage or in shared cards and links. A sketch you place on the map yourself is different. Where you placed it is stored only on this iPhone (see “Sketches and the map” below).
What can I do on the website?
On the RunStat website you can sketch a drawing to run and save it as GPX, or upload a GPX file from another watch or app to make a drawing card. Everything is calculated in your browser and no file is sent anywhere.
Is a sketch a route that is safe to run?
No. A sketch is just a line in the shape you chose. It is not a route checked against real roads or access. Always check a map and the place itself before you run.
Sketches and the map (from RunStat 1.1)
How do I make a sketch in the app?
On the Sketches tab, tap “New sketch”, pick one of six shapes (Heart, Star, Cat, Fish, House, Bolt) and set its length and direction. The sketch stays in the middle of the screen. Move the map under it to the place you want to run, then save. You can open a saved sketch again to edit or delete it.
The map does not show where I am
RunStat does not ask for location permission, so the map does not show where you are. Zoom in and move the map to find the place you want to run. The map is Apple Maps, and the map of the area you are looking at is loaded from Apple.
Where is the place I put a sketch stored?
Sketches and where you place them are stored only on this iPhone. They are not stored in iCloud or in iPhone backups, so they do not move to a new device. Export a GPX file if you want to keep one.
Can I export a sketch as a GPX file?
Yes. On a saved sketch, turn on “I understand this sketch has not been checked against roads or access” and a “Share GPX” button appears. The GPX file contains where you placed the sketch, so anyone who gets the file can see that place.
Can I see a sketch and a run side by side?
Yes. On a saved sketch, use “Side by side with a run” to choose one run and link it. The sketch (dashed line) and the drawing of the run (solid line) become one image, which you can send with “Share image”. The image shows only the sketch length, the run distance, the time and the date. RunStat does not measure how alike the two are.
Widgets (from RunStat 1.1)
What do the widgets show?
The small Home Screen widget shows your character and its stage. The medium widget shows your character, the days you ran this week and your latest drawing. The Lock Screen widget shows no drawing and no drawing name.
The widget shows old numbers
Widgets do not read the Health app themselves. They show the value from the last time you opened the app. If that value is not from today, the widget says so, for example “As of yesterday”. It updates when you open the app. Before you connect Apple Health, the widget asks you to open the app and connect.
Moving and deleting records
Do my records move to a new iPhone?
Imported records are not stored in iCloud or in iPhone backups, so they do not move as they are. When you connect again on the new iPhone, runs from the last 90 days in the Health app are imported again. Names you gave your drawings and your sketches do not carry over, and character growth starts again from the day you reconnect.
How do I delete my records?
- Settings > Delete all records deletes all imported runs, drawing names and sketches and disconnects Apple Health. The value shown in widgets is deleted too. This can’t be undone.
- To delete just one sketch, use “Delete sketch” on the Sketches tab or on that sketch.
- Settings > Disconnect stops importing new runs. Records already imported remain.
- Deleting the app deletes its records from your iPhone.
Deleting in RunStat does not delete the runs in the Health app.
Contact
Send an email to choishiam@gmail.com.
It helps if you say which screen you were on and what happened, along with your iPhone model and iOS version. You do not need to send running records or route files.