> For the complete documentation index, see [llms.txt](https://bigdeckit.gitbook.io/homeworkouthero/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bigdeckit.gitbook.io/homeworkouthero/user-guide/faq-and-troubleshooting.md).

# FAQ and Troubleshooting

Answers to common questions and fixes for common problems.

## General

**Is HomeWorkoutHero free?** Yes. It's open source under the [HomeWorkoutHero Community License](https://github.com/Klodizaur/MyFitnessPlan/blob/main/LICENSE): free for personal, educational and community use.

**Wasn't this called MyFitnessPlan?** Yes, up to version 2.2.0. It's the same app with a new name. Updating keeps all your plans, videos and progress, and plan files and backups from MyFitnessPlan still import.

**Does it come with workout videos?** No. HomeWorkoutHero is a planner for **your own** videos: files you have, or [YouTube playlists](/homeworkouthero/user-guide/youtube-playlists.md). Use content you're allowed to use.

**Does it need the internet?** Only for YouTube videos (they play from YouTube), a cloud AI provider if you use the [AI Plan Builder](/homeworkouthero/user-guide/ai-plan-builder.md), and checking for updates. Your own videos, plans and Log work offline.

**Where is my data?** On your computer only:

* macOS: `~/Library/Application Support/HomeWorkoutHero/data`
* Windows: `%APPDATA%\HomeWorkoutHero\data`

If you've used the app since it was called MyFitnessPlan, it's in a `MyFitnessPlan` folder in the same place instead. Your video files stay in your own folder; HomeWorkoutHero never moves or copies them.

**Can several people use it?** Yes. Each person gets a [profile](/homeworkouthero/user-guide/profiles.md) with their own plans and progress.

## Installing

**macOS says the app "is damaged and should be moved to the Trash".** It isn't damaged: the app isn't code-signed yet. Open **Terminal** and run `xattr -cr "/Applications/HomeWorkoutHero.app"`, then open it normally. You only need to do this once. See [Getting Started](/homeworkouthero/user-guide/getting-started.md#macos).

**Windows says "Windows protected your PC".** Click **More info → Run anyway**. The installer isn't code-signed yet.

## Videos

**Scan didn't find my videos.**

* Check the **Video Library Path** in Settings → Workouts is the full path of the folder, and click **Scan** again.
* On macOS, if it asks whether HomeWorkoutHero may access a folder (Documents, Desktop, an external drive…), click **Allow**.
* *"Some folders couldn't be read"* means part of the folder wasn't accessible, so nothing was removed from your library. Fix the access, then scan again.

**I added videos to the folder but they're not in the Library.** Click **Scan** again in Settings → Workouts.

**A video says "Converting" and takes a moment to start.** That device can't play the file as it is (an MKV on an iPad, for example), so it's converted while it plays. MP4 files play directly almost everywhere.

**Total time in the Log says "rescan library".** Some videos have no length recorded. Click **Scan** in Settings → Workouts.

## YouTube

**The import fails.** The playlist must be **Public** or **Unlisted**; YouTube blocks private ones. Paste the playlist link (with `list=`).

**YouTube videos don't play.** They play from YouTube, so the computer (or phone, or TV) needs an internet connection.

## Plans and progress

**If I edit a plan, do I lose my progress?** No. Days you've done stay done; only what's left changes. Your Log is never affected. See [Plans → Editing a plan](/homeworkouthero/user-guide/plans-and-the-plan-builder.md#editing-a-plan).

**I need a break. Will I fall behind?** Use **Freeze**: nothing is skipped, the plan simply moves back. See [Calendar → Freezing days](/homeworkouthero/user-guide/calendar.md#freezing-days).

**How do I record a workout I did outside a plan?** **Log → Log a workout**. See [Workout Log](/homeworkouthero/user-guide/workout-log.md).

## Phones, tablets and TV

**My phone can't open the address.**

* Sharing must be on: Settings → Devices, or the menu-bar/tray icon → Share on Local Network.
* The phone and computer must be on the **same Wi-Fi** (not a guest network).
* The computer must be awake with HomeWorkoutHero running.
* If the computer's firewall asks about HomeWorkoutHero, allow it.

**The TV app can't find my computer.** Type the address shown under **TV** in Settings → Devices with the remote.

## Profiles and backups

**I forgot my PIN.** On the **computer running HomeWorkoutHero**, pick your profile and click **Forgot PIN?**. See [Profiles → PIN](/homeworkouthero/user-guide/profiles.md#pin).

**How do I move to a new computer?** Make a backup (Settings → My profile → **Back up now**), install HomeWorkoutHero on the new computer, then on **Who's training?** → **Add profile**, restore the backup as a profile. Or use the tray's **Back Up Everything…** on the old computer and **Import Database** on the new one. Point Settings → Workouts at your videos on the new computer. See [Backups](/homeworkouthero/user-guide/backups.md).

Still stuck? [Open an issue](https://github.com/Klodizaur/MyFitnessPlan/issues) and describe what you did, what you expected, and what happened, with a screenshot if you can.