JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 22
  • Score
    100M100P100Q65301F

Transposer connector is a PeerTube language tool plugin to transcribe and translate with Whisper

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (peertube-plugin-transposer-connector) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Transposer Connector

    A multilingual video plugin for PeerTube, developed by fairkom.

    Transposer enables automatic transcription and translation of video content using Whisper by OpenAI. It's designed to make video content accessible in multiple languages and supports modern web protocols like ActivityPub and REST.

    ✨ Features

    • Transcribe and translate videos automatically
    • Translate transcripts into 26 languages
    • Save transcriptions as captions
    • Edit captions directly in the UI
    • Translate video metadata into 26 languages
    • Switch metadata language in the UI
    • Change the UI language dynamically
    • Access metadata via:
      • ActivityPub (JSON-LD)
      • REST API endpoint

    🌍 Supported Languages

    Transposer currently supports translation into 26 languages. (A complete list can be added here if desired.)

    • 🇦🇪 Arabic (ar)
    • 🇧🇦 Bosnian (bs)
    • 🇧🇬 Bulgarian (bg)
    • 🇭🇷 Croatian (hr)
    • 🇨🇿 Czech (cs)
    • 🇳🇱 Dutch (nl)
    • 🇬🇧 English (en)
    • 🇪🇪 Estonian (et)
    • 🇫🇮 Finnish (fi)
    • 🇫🇷 French (fr)
    • 🇩🇪 German (de)
    • 🇬🇷 Greek (el)
    • 🇮🇱 Hebrew (he)
    • 🇭🇺 Hungarian (hu)
    • 🇮🇹 Italian (it)
    • 🇵🇱 Polish (pl)
    • 🇵🇹 Portuguese (pt)
    • 🇷🇴 Romanian (ro)
    • 🇷🇺 Russian (ru)
    • 🇷🇸 Serbian (sr)
    • 🇸🇰 Slovak (sk)
    • 🇸🇮 Slovenian (sl)
    • 🇪🇸 Spanish (es)
    • 🇸🇪 Swedish (sv)
    • 🇹🇷 Turkish (tr)
    • 🇺🇦 Ukrainian (uk)

    🚀 Getting Started

    Visit: https://tube.dev.displ.eu/p/transposer

    From there, you can:

    • Trigger transcription, translation, and metadata translation
    • Edit and manage captions
    • View and switch between language versions of metadata and UI

    Query Parameters

    • Switch metadata language:
      ?metadatalanguage={langcode}
    • Switch UI language:
      ?uilanguage={langcode}

    🔗 Accessing Metadata

    You can access translated metadata using different endpoints:

    • REST API (proxied):

    https://api.transposer.eu/dev/peertube/metadata/

    • REST API (direct PeerTube plugin)

    https:///plugins/transposer-connector//router/language/metadata/video/

    • ActivityPub (JSON-LD format)

    curl -H "Accept: application/activity+json"
    https:///videos/watch/

    ⚙️ How It Works

    To support high-volume PeerTube instances, Transposer is designed for asynchronous processing using a queuing system.

    The architecture includes:

    • A dedicated Transposer Engine
    • Support for multiple adapters, including one for Whisper
    • A Kafka pipeline for distributed processing
    • Kong Gateway for exposing APIs and managing routing

    This ensures scalable handling of transcription and translation jobs with minimal impact on the PeerTube server.

    🔧 Dependencies

    ! Note: This plugin is still under development.

    You’ll need a Language Transposer Service account to enable transcription and translation features.

    To request test access, email: support@fairkom.eu After receiving credentials, configure the plugin in the PeerTube admin interface by adding the provided service URL.

    🧑‍💻 Codebase

    📦 Changelog

    0.2.0 – Transcription triggered only on video updates

    0.3.0 – Improved UI: transposer page

    0.4.0 – Added metadata language switcher in UI

    0.5.0 – Improved saving metadata

    0.6.0 –

    TODOs

    Here's a more polished version of your list:

    • 🆕 Support UUID and Short UUID: Enhance functionality to support requests using both UUID and short UUID formats, in addition to short IDs.
    • 🔐 Restrict Access to Authenticated Users: Ensure the page is only accessible to users who are logged in.
    • 🆕 Allow Language Change via Query Parameter: Add the ability to change the caption language using a query parameter, for example, &lang=es.
    • ⏳ Provide Feedback on Processing Time: Display a notification indicating that the process may take up to 10 minutes. If it doesn't complete within this time, instruct users to contact support at support@fairkom.eu.
    • 🔒 Metadata Update Restrictions: Implement authentication for the metadata API, allowing updates only from users who own the respective video.
    • 📖 Update README: Revise the README to provide comprehensive and clear information about the tool's features and usage.
    • 🛠️ Create Debugging Documentation: Write detailed documentation on how to debug the Transposer plugin and its related services.
    • 🧪 Add GitLab CI Pipeline: Set up a GitLab CI pipeline with SonarQube for automated testing and quality checks.
    • 🔄 Refactor Code: Refactor the codebase to improve maintainability, performance, and clarity.