> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kurse-und-community/untertitel-fur-video-lektionen-hinzufugen.md).

# Untertitel für Video-Lektionen hinzufügen

Hinterlege Untertiteldateien in Video-Lektionen, bearbeite Zeitmarken sicher und prüfe die Darstellung aus Sicht deiner Lernenden.

Untertitel machen Video-Lektionen verständlicher, wenn Teilnehmende ohne Ton lernen, eine andere Sprache bevorzugen oder gesprochene Inhalte zusätzlich lesen möchten. Du hinterlegst für jede Sprache eine eigene Untertiteldatei und prüfst anschließend im Videoplayer, ob Text und Bild genau zusammenpassen.

## Was du vorher vorbereitest

Die Plattform unterstützt für Untertitel ausschließlich Dateien im Format **.srt**. Eine solche Datei enthält nacheinander einzelne Texteinblendungen mit Start- und Endzeit.

Bereite für jede Sprache eine eigene Datei vor, zum Beispiel eine deutsche und eine englische Version. Prüfe vor dem Hochladen:

* Die Datei endet auf **.srt**.
* Jede Einblendung enthält einen Text und passende Zeitmarken.
* Start- und Endzeiten passen zum tatsächlichen Video.
* Die Sprache der Datei ist eindeutig.
* Namen, Fachbegriffe und wichtige Hinweise sind korrekt geschrieben.

Untertitel werden nicht automatisch an das Video angepasst. Die Zeitmarken deiner Datei bestimmen, wann ein Text im Player erscheint.

## Untertiteldatei hochladen

1. Öffne den Bereich **Kurse** und wähle den Kurs aus.
2. Öffne eine Lektion, die ein Video enthält.
3. Suche neben dem Videoplayer die Option **Untertitel hochladen**.
4. Klicke auf **Untertitel hochladen** und wähle die vorbereitete **.srt**-Datei von deinem Gerät.
5. Wähle in der Auswahlliste die Sprache dieser Datei.
6. Speichere die Lektion.

Nach dem Speichern ist die Datei dem Video zugeordnet. Wiederhole den Ablauf für weitere Sprachen. Jede Datei erhält eine eigene Sprachzuordnung, damit Teilnehmende sie im Player auswählen können.

## Mehrere Sprachen sinnvoll einsetzen

Lege nur die Sprachen an, die du tatsächlich geprüft hast. Eine Untertiteldatei mit der falschen Sprachzuordnung führt dazu, dass Teilnehmende im Player die falsche Auswahl treffen.

Beispiel: Du lädst zuerst die deutsche Datei hoch, wählst **Deutsch** und speicherst. Danach lädst du die englische Datei hoch, wählst **Englisch** und speicherst erneut. Im Videoplayer stehen anschließend beide Sprachversionen zur Auswahl.

## Untertitel im Editor überarbeiten

Neben einer hochgeladenen Datei findest du die Option **Untertitel bearbeiten**. Der Editor zeigt die Einträge in einer strukturierten Liste mit Zeitmarken und Text.

So arbeitest du damit:

1. Klicke bei der hochgeladenen Datei auf **Untertitel bearbeiten**.
2. Prüfe jeden Eintrag mit seiner Start- und Endzeit.
3. Klicke auf eine Zeitmarke, um im Video direkt zu dieser Stelle zu springen.
4. Klicke in den Text, wenn du eine Formulierung korrigieren möchtest.
5. Passe bei Bedarf die Zeitmarken an.
6. Klicke auf **Änderungen speichern**.

Diese Ansicht eignet sich für normale Text- und Zeitkorrekturen, weil du die Einträge direkt zusammen mit dem passenden Videomoment prüfen kannst.

## Warnungen richtig behandeln

Der Editor zeigt Warnsymbole, wenn Untertitel nicht sauber zum Ablauf passen. Typische Ursachen sind überlappende Einblendungen oder Lücken in den Zeitmarken.

Bewege den Mauszeiger über das Warnsymbol, um die Beschreibung des Problems zu sehen. Springe dann über die Zeitmarke zur betroffenen Stelle, korrigiere Text oder Zeiten und speichere die Änderung erneut.

Eine Warnung bedeutet nicht automatisch, dass alle Untertitel unbrauchbar sind. Sie zeigt dir aber genau die Stellen, die du vor der Veröffentlichung prüfen solltest.

## Rohmodus nur für präzise Korrekturen nutzen

Der **Rohmodus** gibt dir direkten Zugriff auf die Struktur der Untertiteldatei. Dort bearbeitest du Zeitmarken und Text in der üblichen Reihenfolge einer .srt-Datei.

Nutze diesen Modus nur, wenn du mit Zeitformaten vertraut bist:

1. Öffne im Untertitel-Editor **In den Rohmodus wechseln**.
2. Passe nur die Einträge an, die wirklich korrigiert werden müssen.
3. Kontrolliere besonders die Zeitmarken und die Reihenfolge der Einträge.
4. Klicke auf **Speichern**.
5. Prüfe die geänderten Stellen anschließend im Videoplayer.

Ein fehlendes Zeichen oder eine falsch geschriebene Zeitmarke kann dazu führen, dass einzelne Untertitel nicht mehr richtig dargestellt werden. Für einfache Korrekturen ist der normale Editor sicherer.

## Aus Sicht der Lernenden testen

Prüfe jede Sprache mit einem Testzugang:

1. Öffne die veröffentlichte Lektion.
2. Starte das Video.
3. Öffne die Untertitel-Auswahl im Videoplayer.
4. Wähle eine Sprache aus.
5. Kontrolliere, ob der Text erscheint und zeitlich zum Gesprochenen passt.
6. Wiederhole den Test für jede weitere Sprache.
7. Prüfe lange Namen, Fachbegriffe, schnelle Sprecherwechsel und wichtige Handlungsanweisungen besonders sorgfältig.

Teste auch ohne Ton. So erkennst du, ob die Untertitel den Inhalt verständlich genug wiedergeben.

## Praxisbeispiel

Eine Kursleitung veröffentlicht eine wichtige Video-Lektion auf Deutsch und Englisch. Sie erstellt zwei .srt-Dateien, lädt sie einzeln hoch und ordnet jeder Datei die passende Sprache zu. Beim Testzugang prüft sie beide Versionen im Videoplayer.

In der deutschen Fassung erscheint ein Warnsymbol an einer Stelle, an der zwei Einblendungen überlappen. Sie öffnet **Untertitel bearbeiten**, springt über die Zeitmarke zu dieser Stelle, verschiebt die Endzeit der ersten Einblendung und speichert die Änderung. Erst danach gibt sie die Lektion für die Lerngruppe frei.

## Häufige Probleme und Lösungen

| Beobachtung                         | Wahrscheinliche Ursache                                             | Lösung                                                           |
| ----------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Datei wird nicht akzeptiert         | Die Datei ist nicht im Format .srt.                                 | Datei im .srt-Format speichern und erneut hochladen.             |
| Text erscheint zu früh oder zu spät | Die Zeitmarken passen nicht zum Video.                              | Im Editor zu der Stelle springen und die Zeiten korrigieren.     |
| Warnsymbol erscheint                | Einblendungen überlappen sich oder Zeitmarken enthalten eine Lücke. | Warnung öffnen, betroffene Einträge anpassen und speichern.      |
| Sprache fehlt im Player             | Die Datei wurde nicht gespeichert oder keiner Sprache zugeordnet.   | Lektion öffnen, Sprachzuordnung prüfen und den Test wiederholen. |
| Text ist schwer zu lesen            | Der Text ist zu lang oder enthält unklare Formulierungen.           | Einblendung kürzen, klare Wörter verwenden und erneut testen.    |

## Wichtige Grenzen

* Es werden nur **.srt**-Dateien unterstützt.
* Jede Sprachversion braucht eine eigene Datei und eine eindeutige Sprachzuordnung.
* Die Untertitel folgen den Zeitmarken der Datei; sie richten sich nicht selbst am Video aus.
* Rohmodus ist optional. Für die meisten Korrekturen reicht der normale Untertitel-Editor.
* Speichere nach jedem Upload und jeder Korrektur, bevor du die Darstellung im Player prüfst.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kurse-und-community/untertitel-fur-video-lektionen-hinzufugen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
