Steam Workshop and Glossary Management

TransBox supports packaging visual themes, domain glossaries, UI language packs, ASR, MT, TTS, AI copilots, and pipeline tools into Extensions (MODs).

In the latest release, the app includes a standalone Workshop Hub window, allowing users to browse, search, and subscribe to Steam Workshop items directly within the desktop client, with zero-restart instant hot-reload upon download!

---

1. Built-in Standalone "Workshop Hub"

You can open the Workshop Hub window anytime:

• Shortcut 1: Click "Workshop Hub" from the title bar quick menu;
• Shortcut 2: Navigate to Settings → Workshop, and click the "Workshop Hub" button at the top toolbar.

1.1 Browse Workshop

• Search & Tag Filters: Quickly filter by Glossaries, Subtitle Themes, ASR Engines, MT Engines, TTS Engines, AI Assistant, UI Language Packs, etc.;
• Item Cards: Displays banner cover, title, author avatar, user rating/likes, download size, and the "Glossary-ready" capability badge;
• One-Click Subscribe with Live Progress: Click "Subscribe" to trigger a background download with live percentage and size indicators;
• Automatic Instant Hot-Reload: Once downloaded, Steam callbacks trigger an immediate plugin registry refresh. No client restart required! The new extension is ready to use immediately.

1.2 My Subscriptions

• Centralized overview of all locally installed Workshop MODs;
• Clear status badges: Installed, Downloading, or Updates Available;
• Offers One-Click Re-download, Open Local Directory, and Unsubscribe (Uninstall).

1.3 Publish & Update

For plugin developers, select your local plugin folder directly within the client. The hub will automatically inspect mod.json, map official Steam tags, and support both brand new item creation and incremental version updates. See Steam Workshop Publishing Guide.

---

2. Settings "Workshop" Control Panel

Settings → Workshop serves as your local command center for managing all installed plugins:

• Dual-Track Hybrid Architecture:
  • Steam Workshop: Automatically synced and updated via the Workshop Hub (AppID: 5521270);
  • Local Extensions: Unpacked plugins or offline zip archives placed in your local extensions/ directory;
• Category Filters: AI Copilots, ASR, MT, TTS, End-to-end SI, subtitle themes, domain glossaries, pipeline middleware, UI language packs, etc.;
• Visual Controls:
  • Enable / Disable Toggle: Instantly activate or deactivate any plugin;
  • Configure Button: Opens a dynamic settings form for API keys, custom models, or voice choices;
  • Export Button: Exports any installed plugin into a standardized .zip file for offline sharing;
  • Safe Reset: One-click disables all third-party extensions to recover to a clean baseline.

---

3. Plugin Setup Guide (Website Downloads & Offline Install)

For offline environments or manual distribution outside Steam Workshop:

3-Step Setup:

1. Download Archive: Visit our official Plugin Hub and download your desired extension .zip;
2. Place in Directory:
   • Go to TransBox Settings → Workshop;
   • Click the "Open local MOD directory" button to open the extensions folder;
   • Extract the .zip archive into this folder (ensure mod.json is located at extensions/<plugin_folder>/mod.json);
3. Refresh and Enable:
   • Return to TransBox and click Refresh;
   • Toggle the switch to Enabled;
   • If the plugin requires credentials (e.g. API keys), click Configure and save. All changes take effect without restarting the app!

---

4. Glossaries (Fix Machine-Translation Name Errors)

General models often mistranslate game jargon, character names, and domain terminology. TransBox implements glossaries as fully decoupled plugins: you can freely subscribe to or download other creators' term packs, enable them on demand, and switch anytime.

What happens when enabled (Automatic):

1. ASR Hotwords: Automatically turns enabled terms into ASR hotwords to boost proper-noun recognition accuracy;
2. MT Context Injection: Automatically injects matching source/target term pairs into MT prompt context;
3. Local Regex Fallback: Automatically corrects terms on local engines that lack cloud hotword capabilities.

Recommended format: terms.json

Simple mapping (universal entries, any language direction):

{
  "Elden Ring": "艾尔登法环",
  "Tarnished": "褪色者",
  "Malenia": "玛莲妮亚"
}

Multi-language directed mapping:

[
  { "src": "Malenia", "tgt": "玛莲妮亚", "src_lang": "en", "tgt_lang": "zh" },
  { "src": "Malenia", "tgt": "マレニア", "src_lang": "en", "tgt_lang": "ja" },
  { "src": "マレニア", "tgt": "玛莲妮亚", "src_lang": "ja", "tgt_lang": "zh" },
  { "src": "Elden Ring", "tgt": { "zh": "艾尔登法环", "ja": "エルデンリング" } }
]

Text format: terms.txt / terms.tsv

• Empty lines and # comments are ignored;
• Separators must be = or Tab (\t);
• -> or => syntax is not supported.

Elden Ring=艾尔登法环
Tarnished	褪色者
マレニア=玛莲妮亚|ja|zh

---

5. Subtitle Themes & Language Packs

• Themes: Alter font, colors, opacity, and dynamic QML background components. Full themes (style_layer: full) are mutually exclusive;
• Language Packs: Switch the entire application interface to new languages seamlessly. Missing strings gracefully fall back to official base locales.

---

6. Safety & Community Guidelines

1. Pure Data Packs (Glossaries / Themes / Locales): Contain no executable code and are completely safe;
2. Code / Script Plugins (ASR / MT / TTS / AI Assistant / Middleware): Run as native Python scripts with the same system privileges as the application. Always verify high ratings and trusted creators in the Workshop.