> For the complete documentation index, see [llms.txt](https://learn.firecut.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.firecut.ai/features/detect-chapters.md).

# Add chapters

## ❓ What is it?

Dividing your timeline into chapters can be very helpful.

When you're close to a final cut, **Add chapters** can give you markers that you can export as timestamps for YouTube (so YouTube can mark them as chapters in the video), and can even generate pretty motion graphics clips you can show at the start of each chapter. It can also suggest titles and a description for your video.

You can also use it early in the process to put markers on your timeline (e.g. to mark things like "Introduction", "Topic 1, 2, 3", "Sponsor segment", "Conclusion") for reference while you edit your video, making the project easier to navigate. These are just like any other markers and can be moved around and edited. **However, this is not the recommended use case at the moment,** because analysing a long sequence takes a while.

{% hint style="info" %}
**Tip:** Analysing a long sequence (more than 20 mins) can take a while, about 2 mins for every 10 mins of audio. We suggest you run this feature close to the end of your editing process, after removing silences and repetitions.
{% endhint %}

## 🤔 How does it work?

Chapter detection in FireCut:

* Analyses the words being spoken in the selected portion of your sequence to detect when new topics are starting (click **Go!** to start)
* Shows these topics as timestamps in a list you can review and edit: rename chapters, change their times (hh:mm:ss), add more with **+**, and delete the ones you don't want. Click a chapter's name to move the playhead to it
* If **Generate title & description** is on, also suggests 3 titles and a description for your video, for **YOUTUBE** and for **SHORT-FORM**. Click the copy button next to any of them to copy it
* Lets you do 3 actions with this finalised list:
  1. **Copy timestamps to clipboard**, as a text snippet (e.g. `00:01:23 - Chapter name`) for pasting into your YouTube video's description
  2. **Add markers**: put these timestamps as chapter markers in your timeline
  3. **Add clips**: generate divider motion graphics clips that show an animated title; these are added to a new video track at the top of your sequence

Click **CLEAR RESULTS** to start again.

{% embed url="<https://www.youtube.com/watch?v=ukWuIyXEgEI>" %}

## ⚙️ Settings

There are 4 main settings for chapter detection:

1. **Chapters count:** Roughly how many chapters you want. Drag the two ends of the slider to set a range, from 1 to 20+. With both ends at the edges (the default), the slider shows **Auto** and FireCut decides. Otherwise it shows your range, e.g. "up to 8", "5+" or "4-10"
2. **Scope:** You can decide whether to run the operation on your **Full sequence** or only on a certain portion that you specify with **In / Out points** (you can place these in your sequence using the `I` and `O` hotkeys).
3. **Language:** We are constantly adding support for new languages. However, please note this is experimental and may create unpredictable results when compared with English. This is the case for every AI tool even if they don't mention it, because [training sets for AI tend to be in English](https://www.wired.com/story/chatgpt-non-english-languages-ai-revolution/). On occasion, this might cause the operation to fail. Please do let us know (<support@firecut.ai>) if this happens, so we can improve it for you!
4. **Generate title & description:** Also suggests titles and a description for your video, for posting on YouTube and on short-form platforms. It's on by default, and experimental

## ⚒️ Markers and chapter clips

**Markers** has 2 settings:

* **Mark regions:** When it's on (the default), each marker covers its whole chapter. When it's off, each marker is a single point at the start of the chapter
* **Marker colour:** The colour of the markers. The default is **Green**

Click **Add markers** to add them. They're Premiere Pro chapter markers, so you can move and rename them like any other marker.

**Chapter clips** adds an animated title clip at the start of each chapter, on a new video track at the top of your sequence. Pick a style from the grid, choose a **Text colour**, and turn **Create gradient** on or off (it's on by default). Then click **Add clips**. Adding clips doesn't work on Premiere Pro 2022, and may not work reliably in some languages.

**Clear all markers** shows when your sequence has chapter markers. It removes every chapter marker in the sequence, not just the ones FireCut added, including the red "FC Highlight" markers from [Create highlights](https://learn.firecut.ai/features/create-highlights.md). FireCut asks you first, and you can't undo it.

## 💡 Tips for best outcomes

* **Use towards the end of your workflow** so that your sequence is fairly short (<20 min)
* **Make sure your audio is loud and clear**, with any music / sound effects muted
* **Try it on a short section of your timeline first** to get familiar with the tool; processing larger sequences can take a while (\~2 min for every \~10 min of sequence)
* **You can edit the generated motion graphics clips** after they are placed in the timeline, e.g. changing the font size and text
* **Don't work in the timeline** while FireCut is working in the background

## 🙋‍♂️ Common questions, issues, watch-outs

* **"I can't see the motion graphics clips"** --> These are always added to a new video track at the top of your sequence - this can often be hidden at the top of your sequence, so try scrolling up to make sure it's not hiding from you!
* **"The chapter topics / timestamps don't match up with my video"** --> Make sure you have a clear speaker in the audio so that your script can be picked up and analysed. If there are any sound effects, multiple speakers, music, noise, etc., this can throw off the analysis in some occasions
* **"It didn't work on my non-English video"** --> Please drop a note at <support@firecut.ai>. We are keen to make sure this feature works reliably on all supported languages!
