# Detect chapters

## ❓ What is it?

Dividing your timeline into chapters can be very helpful.

When you're close to a final cut, chapter detection 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.

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 (>20 mins) can take quite a while with current technology.

{% hint style="success" %}
**Tip:** Analyzing a long sequence (>20 mins) can take a while with current technology. We suggest to 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
* Shows these topics as timestamps in a list you can review and edit; you can add more topics, change the names of topics, and delete topics you don't want
* Lets you do 3 actions with this finalised list:
  1. **Copy** your chapter timestamps as a text snippet to clipboard, for pasting into your YouTube video's description
  2. Put these timestamps as **markers** in your timeline
  3. Generate divider motion graphics **clips** that show an animated title; these are added to a new video track at the top of your sequence

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

## ⚙️ Settings

There are two main settings for chapter detection:

1. **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)
2. **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!

## 💡 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!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.firecut.ai/features/detect-chapters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
