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
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.
TBD
<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:
- [subtitleStatus](https://github.com/c3subtitles/subtitleStatus) (Django-App @ c3subtitles.de)
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)
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 |