# TTML Guide

Create a TTML file for Spicy Lyrics by preparing accurate lyrics, timing each word, adding credits, and testing the finished file locally.


:::warning
# ==New TTML maker role applications (tickets) are closed until further notice.== [==Upload locally==](https://guides.spicylyrics.org/s/ttml/doc/6-export-and-test-the-ttml-nzae0Py9JJ#h-run-a-local-test) ==instead.==

:::


---

> **Creating your first TTML?** Start with accurate whole-word timing. Syllable splitting is optional and can be learned after you are comfortable with the basic workflow. When you are ready, use [Basics Of Splitting](https://guides.spicylyrics.org/s/splitting/doc/basics-of-splitting-ULtyX3rrzK) for the tool workflow and the [Splitting Guidelines](https://guides.spicylyrics.org/s/splitting/doc/splitting-guidelines-IyXtGi4ta6) for the accepted standards.


:::warning
Your finished file must follow the [Uploading and TTML Rules](https://guides.spicylyrics.org/s/tools/doc/uploading-and-ttml-rules-rvofBBi0PV). AI-generated lyric transcription and timing are forbidden. Built-in TTML Tool automation and compatible forks are allowed only when you manually check and correct their output.

:::

## Before you start

This guide uses the [Spicy Lyrics TTML Tool](https://tool.spicylyrics.org/). Allow a few **hours** for a first song, or roughly **30–60 minutes** once you are comfortable with accurate timing.


:::tip
### Recommended workflow

Work in this order: **import the exact audio → import and correct lyrics → mark vocal roles → sync → add songwriters → export → test locally → submit or upload → clear the cache and verify in Spicy Lyrics**.

For every available editor feature, see the [TTML Tool Feature Reference](https://guides.spicylyrics.org/s/tools/doc/ttml-tool-feature-reference-hx9XAG06L8).

:::

---

**Documents**

- [1. Import the song](https://guides.spicylyrics.org/s/ttml/doc/1-import-the-song-iHfycCuOSU)
- [2. Import the lyrics](https://guides.spicylyrics.org/s/ttml/doc/2-import-the-lyrics-CK0YxRxPwp)
- [3. Check the lyrics](https://guides.spicylyrics.org/s/ttml/doc/3-check-the-lyrics-ZHDMonddCz)
- [4. Sync the lyrics](https://guides.spicylyrics.org/s/ttml/doc/4-sync-the-lyrics-MJsQ3M0dIS)
- [5. Add the songwriters](https://guides.spicylyrics.org/s/ttml/doc/5-add-the-songwriters-cP7OWZhyKd)
- [6. Export and test the TTML](https://guides.spicylyrics.org/s/ttml/doc/6-export-and-test-the-ttml-nzae0Py9JJ)
- [Submit Your First TTML](https://guides.spicylyrics.org/s/ttml/doc/submit-your-first-ttml-sX53doCeNh)
- [Welcome, TTML Maker](https://guides.spicylyrics.org/s/ttml/doc/welcome-ttml-maker-YfBvAkFWDG)
- [Welcome, TTML Self-Uploader](https://guides.spicylyrics.org/s/ttml/doc/welcome-ttml-self-uploader-qBEzTbTnkN)