Entwicklung
Kommandozeile
Installiere die SubFT-CLI, binde lokale Projekte und führe Untertiteloperationen im Terminal aus.
pip install subft-cli
subft login
subft project sync /media/library --create
subft operation start /media/library --lang deWorkflow
Von der Anmeldung zur lokalen Ausgabe
Einmal authentifizieren, ein lokales Verzeichnis binden, Remote-Arbeit starten und das Ergebnis lokal anwenden.
- 1AnmeldenToken speichern und API-Gateway auswählen.
- 2Binden und synchronisierenEin Verzeichnis mit einem Projekt verbinden und Medien abgleichen.
- 3Starten und beobachtenOperation erstellen, Fortschritt abwarten oder für später trennen.
- 4Ausgabe anwendenFertige Spuren oder eingebettete Ausgaben ins lokale Verzeichnis schreiben.
Referenz
Befehle und Optionen
Dies sind die stabilen, öffentlich nutzbaren Befehlsgruppen. Globale Automatisierungsoptionen können verwendet werden, wo sie unterstützt werden.
Globale Optionen
| Befehl | Optionen | Zweck |
|---|---|---|
subft COMMAND | [--json] [--yes] | Jeden Befehl mit versionierter JSON-Ausgabe oder deterministischer Bestätigungsbehandlung ausführen. |
subft --version | — | Installierte CLI-Version ausgeben. |
subft --help | — | Referenz des Hauptbefehls anzeigen; jeder Unterbefehl unterstützt ebenfalls --help. |
Authentifizierung
| Befehl | Optionen | Zweck |
|---|---|---|
subft login | [--api-url URL] [--token TOKEN] | Mit einem Token authentifizieren und optional ein anderes Gateway wählen. |
subft status | [--api-url URL] | Aktuelles Gateway, Identität und Quelle der Anmeldedaten anzeigen. |
subft logout | — | Das von der CLI gespeicherte Token entfernen. |
Projekte und Synchronisierung
| Befehl | Optionen | Zweck |
|---|---|---|
subft project bind PATH | [--project-id ID | --create [--name NAME]] [--api-url URL] | Einen lokalen Pfad an ein bestehendes oder neues Projekt binden. |
subft project forget PATH | [--project-id ID | --all] [--api-url URL] | Eine oder alle lokalen Projektbindungen entfernen. |
subft project bindings | [PATH] | Gespeicherte Bindungen auflisten, optional nach Pfad gefiltert. |
subft project sync PATH | [--preview] [--include-hidden] [--project-id ID | --create [--name NAME]] [--api-url URL] | Deterministische Synchronisierung zwischen lokalem Pfad und Projekt prüfen oder anwenden. |
Operationen
| Befehl | Optionen | Zweck |
|---|---|---|
subft operation start PATH --lang CODE | [--output-target TARGET] [--remove-track] [--wait | --detach] [--include-hidden] [--project-id ID | --create [--name NAME]] [--allow-partial] [--api-url URL] | Eine Untertiteloperation für das gebundene Projekt und die gewählte Sprache starten. |
subft operation watch OPERATION_ID | [--api-url URL] | Eine Operation bis zu ihrem Endzustand verfolgen. |
subft operation apply OPERATION_ID PATH | [--output-target TARGET] [--remove-track | --keep-track] [--allow-partial] [--api-url URL] | Eine abgeschlossene Operation herunterladen und auf lokale Dateien anwenden. |
Unterstützte CLI-Eingaben
Ausgabeziele
Wähle eine externe Sidecar-Datei, SubFT-JSON oder eine eingebettete Medienausgabe.
external_srtexternal_vttexternal_assexternal_csubs_jsonembedded
Gateway und lokale Konfiguration
Nutze --api-url oder diese Umgebungsvariablen für andere Gateways und Anmeldedaten.
SUBFT_API_URLSUBFT_API_TOKEN
Die CLI nutzt diese XDG-Orte und fällt auf die gezeigten Pfade im Home-Verzeichnis zurück. Unter POSIX sind private Berechtigungen erforderlich.
$XDG_CONFIG_HOME/subft/config.json~/.config/subft/config.json$XDG_STATE_HOME/subft/projects.json~/.local/state/subft/projects.json
Fehlerbehebung