> 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/video-library.md).

# Video Library

Add your workout videos, find them fast, and tag them.

The **Library** is where all your workout videos live: the files on your computer, plus any [YouTube playlists](/homeworkouthero/user-guide/youtube-playlists.md) you've imported.

![Library](https://832542023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUdDjJmApNQZTPNxTsyE%2Fuploads%2Fwu3SiuSkNSuU6gFXPpGw%2Flibrary_overview.png?alt=media)

## Adding your videos

1. Go to **Settings → Workouts**.
2. In **Video Library Path**, enter the full path of the folder with your videos.
3. Click **Scan**.

HomeWorkoutHero looks through that folder and all its subfolders, reads each video's length and makes a thumbnail. Your files stay exactly where they are; nothing is copied, moved or uploaded.

**Added new videos to the folder later?** Click **Scan** again. New videos are added and deleted ones are removed.

**Folders to skip:** in **Settings → Workouts → Exclude Folders**, add any subfolder you don't want in the library (for example, a folder of unfinished downloads).

{% hint style="info" %}
Each [profile](/homeworkouthero/user-guide/profiles.md) has its own video folder, so people can keep their workouts in different places.
{% endhint %}

## Folders

Each subfolder of your video folder becomes a **folder** in the Library, so a tidy folder structure (Cardio, Strength, Yoga…) pays off. Two more folders appear automatically:

* **Favourites:** every video you've starred.
* **YouTube albums:** one for each playlist you've imported.

Open a folder to see its videos. Inside a folder you can sort subfolders and videos separately, and **Include subfolders** lists everything below it in one place.

![A folder of videos](https://832542023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUdDjJmApNQZTPNxTsyE%2Fuploads%2FVBVRpZCyckyQcBaIQKEx%2Flibrary_folder.png?alt=media)

On the Library page, **Show all videos** lists every video in one list, with its folder and the date it was added. **Recently added** at the top shows your newest videos.

## Finding a video

* **Search** by name.
* **Filters:** narrow by equipment, training type, body part, intensity or **length** (from / up to, with quick ranges).
* **Sort:** A → Z, Z → A, longest or shortest first, newest or oldest.
* **All / My files / YouTube** switches between your own files and imported YouTube videos.
* **Grid or list:** the two buttons on the right.

## Tags

Tags are what the filters, the plan builder and the [AI Plan Builder](/homeworkouthero/user-guide/ai-plan-builder.md) use to find the right video, so they're worth filling in.

| Tag               | Values                                                                                                                                             |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Intensity**     | Low, Medium, High                                                                                                                                  |
| **Training type** | HIIT, Cardio, Strength, Mobility, Yoga, Pilates, Functional Strength Training, Warmup, Cooldown, Stretching, Standing, No Jumping, Period-Friendly |
| **Body parts**    | Full body, Upper body, Lower body, Core, Back, Legs, Arms, Shoulders, Glutes, Chest                                                                |
| **Equipment**     | Dumbbells, Mat, Gym ball, Resistance bands, Pilates ball, Pilates bar, Kettlebell, Barbell, Step, Bench, No equipment                              |

**To tag a video:** hover it and click the info button (or click the video), then **Edit details**. You can also add a description there; it shows in the player.

Videos imported from YouTube are tagged automatically from their titles, and you can adjust the tags the same way.

## Favourites

Click the ♡ on any video to star it. Starred videos gather in the **Favourites** folder.

## Playing a video on its own

Hover a video and click **Play** to watch it outside of a plan. If you mark it done in the [player](/homeworkouthero/user-guide/player.md), it's added to your [Workout Log](/homeworkouthero/user-guide/workout-log.md) for today.

**Related:** [Plans and the Plan Builder](/homeworkouthero/user-guide/plans-and-the-plan-builder.md) · [YouTube Playlists](/homeworkouthero/user-guide/youtube-playlists.md) · [Settings and Themes](/homeworkouthero/user-guide/settings-and-themes.md)