Subtitles / Untertitel
software:voctoweb hat mehr aktuell zwei Varianten über die publizierte Vorträge Untertitel bekommen können:
- die klassischen Workflows über die Django-App auf c3subtitles.de (subtitleStatus) - per Whisper/Transcribee über die Publishing API
Vereinfacht gesagt geht es dabei immer um zwei Tasks:
- das Publizieren der SRT/VTT Datei - das Anlegen der Metadaten (aka “Subtitle Recording”) in voctoweb, damit die Untertitel auch im Player angezeigt werden
Publishing Gateway/API
Um sich nicht mit den Eigenheiten der c3voc Infrastrktur herumschlagen zu müssen wurde 2023/2024 eine REST API eingerichtet die es erlaubt Zusatzdaten wie Slides, Subtitles etc. rein per REST zu publizieren, ohne das SFTP o.ä. verwendet werden muss:
- https://publishing.c3voc.de/docs - https://github.com/voc/publishing-gw
Die dazu notwendigen API Keys sind aktuell noch statisch konfiguriert, sollen aber perspektivisch an https://sso.c3voc.de/ angebunden werden.
Transcribee
TBD
Classic workflow via c3subtitles.de/Amara/etc.
<callout type=“warning”>Achtung: Der Rest dieser Seite beschreibt den alten Workflow, der aktuell nicht mehr aktiv in Verwendung ist. Das Team hat hatte zwischenzeitlich eigene Infrastruktur unter https://wiki.c3subtitles.de die bei selfnet gehostet war – inzwischen ist diese VM aber leider aus unbekannten Gründen nicht mehr erreichbar. </callout>
Components
- sync_media_recordings.py uses CSV export from `subtitlesStatus` to publish subtiles in vocotoweb via REST API:
- was running every 10 minutes via systemd timer intern:server:releasing.c3voc.de`:/etc/systemd/system/publish-subtitles.timer`
- [subtitleStatus](https://github.com/c3subtitles/subtitleStatus) (Django-App @ c3subtitles.de)
- Dashboard mit Übersicht des Transkriptionsstatus pro Konferenz und Vortrag
- Workflow-Manager
- …
- schiebt fertige Untertitel-Dateien (SRT) per rsync auf mirror.selfnet.de
CSV-Export from C3Subtitles:
https://c3subtitles.de/media_export/2020-12-30T0:00:00.99Z
Example:
| `GUID` | `complete` | `media_language` | `srt_language` |
|---|
`last_changed_on_amara` ^ `revision` ^ `url` ^ `touched` ^ `amara_key` ^ `amara_language` ^ `state` ^ `amara_subtitle_url`
To download the raw (draft) subtitles from Amara, append use `https:amara.org/api/videos/{amara_key}/languages/{amara_lanuage}/subtitles/?format=vtt` (compare https://apidocs.amara.org/#fetch-raw-subtitles)
States
For voctoweb (media.ccc.de) only states 7, 8 and 12 are relevant. Subtitle files in all other states should be ignored. tablelayout ^ ID ^ voctoweb ^ c3subtitles ^ additional information ^
| 1 | Nothing available yet | irrelevant should not exist | |
| 2 | todo | Transcribed until | should exist |
| 3 | Transcript finished | might exist - still no timestamps | |
| 4 | Please do not touch, work in progress | Autotiming in process no timestamps | |
| 5 | Synced until | rare case of syncing by hand | |
| 6 | Syncing finished | with timestamps, usable as draft | |
| 7 | draft | Quality control done until | with timestamps, usable as draft |
| 8 | complete | Job completed | finished, obviously with timestamps and usable |
| 9 | Unknown | should not exist | |
| 11 | todo | Translated until | translation, not usable as draft |
| 12 | translated | Translation is finished | finished, obviously with timestamps and usable |