{"id":19325174,"url":"https://github.com/locaal-ai/obs-polyglot","last_synced_at":"2025-04-22T20:31:23.198Z","repository":{"id":201144183,"uuid":"706916002","full_name":"locaal-ai/obs-polyglot","owner":"locaal-ai","description":"Realtime local AI translation services for OBS based on CTranslate2","archived":true,"fork":false,"pushed_at":"2024-12-18T18:33:24.000Z","size":125,"stargazers_count":74,"open_issues_count":6,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-15T17:21:42.641Z","etag":null,"topics":["ctranslate2","obs","obs-plugin","obs-studio","obs-studio-plugin","real-time-translation","realtime-translator","translation"],"latest_commit_sha":null,"homepage":"https://obsproject.com/forum/resources/polyglot-real-time-local-translation-ai-service-for-obs.1818/","language":"CMake","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/locaal-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-18T21:26:46.000Z","updated_at":"2025-03-01T01:44:32.000Z","dependencies_parsed_at":"2024-03-25T18:27:00.199Z","dependency_job_id":"4515669f-bd56-47ee-9856-a3fcf4f64989","html_url":"https://github.com/locaal-ai/obs-polyglot","commit_stats":{"total_commits":39,"total_committers":1,"mean_commits":39.0,"dds":0.0,"last_synced_commit":"1cb4708103d403fdc0102b614b507a54ba6da373"},"previous_names":["obs-ai/obs-polyglot","occ-ai/obs-polyglot","locaal-ai/obs-polyglot"],"tags_count":2,"template":false,"template_full_name":"obsproject/obs-plugintemplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-polyglot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-polyglot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-polyglot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-polyglot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/locaal-ai","download_url":"https://codeload.github.com/locaal-ai/obs-polyglot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249838996,"owners_count":21332697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ctranslate2","obs","obs-plugin","obs-studio","obs-studio-plugin","real-time-translation","realtime-translator","translation"],"created_at":"2024-11-10T02:09:09.923Z","updated_at":"2025-04-22T20:31:23.191Z","avatar_url":"https://github.com/locaal-ai.png","language":"CMake","funding_links":["https://github.com/sponsors/royshil"],"categories":[],"sub_categories":[],"readme":"# ⚠️ Stalled ⚠️ This project is not under active development\n\n## Ployglot - Translation AI assistant OBS Plugin\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub](https://img.shields.io/github/license/obs-ai/obs-polyglot)](https://github.com/obs-ai/obs-polyglot/blob/main/LICENSE)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/obs-ai/obs-polyglot/push.yaml)](https://github.com/obs-ai/obs-polyglot/actions/workflows/push.yaml)\n[![Total downloads](https://img.shields.io/github/downloads/obs-ai/obs-polyglot/total)](https://github.com/obs-ai/obs-polyglot/releases)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/obs-ai/obs-polyglot)](https://github.com/obs-ai/obs-polyglot/releases)\n[![Discord](https://img.shields.io/discord/1200229425141252116)](https://discord.gg/KbjGU2vvUz)\n\n\u003c/div\u003e\n\n## Introduction\n\nPolyglot translation AI plugin allows you to translate text in multiple languages in real-time and locally on your machine. ✅ No GPU required, ✅ no cloud costs, ✅ no network and ✅ no downtime! Privacy first - all data stays on your machine.\n\n\"polyglot\" is derived from the Greek words: \"poly-\" meaning \"many\"and \"glōtta\" (or \"glōssa\") meaning \"tongue\" or \"language\".\n\nIt's using the excellent [CTranslate2](https://github.com/OpenNMT/CTranslate2) project from [OpenNMT](https://opennmt.net/).\n\nIf this free plugin has been valuable to you consider adding a ⭐ to this GH repo, subscribing to [my YouTube channel](https://www.youtube.com/@royshilk) where I post updates, and supporting my work: https://github.com/sponsors/royshil\n\n### Usage Tutorial\nWatch a short tutorial on how to use and setup Polyglot on your OBS scene.\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://youtu.be/ZMNILPWDkDw\" target=\"_blank\"\u003e\n    \u003cimg width=\"40%\" src=\"https://github-production-user-asset-6210df.s3.amazonaws.com/441170/277700000-629554d9-0f71-42a4-a251-71dec1e0b864.PNG\" /\u003e\n  \u003c/a\u003e\n  \u003cbr/\u003e\n  https://youtu.be/ZMNILPWDkDw\n\u003c/div\u003e\n\nCurrent Features:\n- Translate in real time using an internal HTTP server\n- Choice of CTranslate2 model file\n\nRoadmap:\n- Translation directly on OBS text sources, e.g. with a filter\n- Translation of live stream or recording captions\n\nCheck out our other plugins:\n- [Background Removal](https://github.com/royshil/obs-backgroundremoval) removes background from webcam without a green screen.\n- 🚧 Experimental 🚧 [CleanStream](https://github.com/obs-ai/obs-cleanstream) for real-time filler word (uh,um) and profanity removal from live audio stream\n- [URL/API Source](https://github.com/obs-ai/obs-urlsource) that allows fetching live data from an API and displaying it in OBS.\n- [LocalVocal](https://github.com/royshil/obs-localvocal) speech AI assistant plugin for real-time transcription (captions), translation and more language functions\n\n\n## Download\nCheck out the [latest releases](https://github.com/obs-ai/obs-polyglot/releases) for downloads and install instructions.\n\n### Models\n_You need to download a CT2 model for the translation service to work._\n\nHere are download links for models that are compatible with the plugin:\n- https://forum.opennmt.net/t/nllb-200-with-ctranslate2/5090 NLLB-200 multilingual model (recommended) ([List of NLLB language codes](https://github.com/facebookresearch/LASER/blob/main/nllb/README.md))\n- https://huggingface.co/models?sort=trending\u0026search=ctranslate CTranslate2 models on HuggingFace\n\nDownload models options: (get e.g. `model.bin` and SPM = SentencePiece Model `.model` file)\n- https://forum.opennmt.net/t/nllb-200-with-ctranslate2/5090 (NLLB)\n- https://huggingface.co/JustFrederik/m2m_100_418m_ct2_int8/tree/main (M2M100)\n- https://huggingface.co/Rohith04/ct2fast_m2m100_418M/tree/main (M2M100)\n- https://huggingface.co/jncraton/m2m100_418M-ct2-int8/tree/main (M2M100)\n\n## Building\n\nThe plugin was built and tested on Mac OSX  (Intel \u0026 Apple silicon), Windows and Linux.\n\nStart by cloning this repo to a directory of your choice.\n\nRemember to sync and fetch the submodules before building, e.g.\n```sh\n$ git submodule sync --recursive\n$ git update --init --recursive\n```\n\n### Mac OSX\n\nUsing the CI pipeline scripts, locally you would just call the zsh script. By default this builds a universal binary for both Intel and Apple Silicon. To build for a specific architecture please see `.github/scripts/.build.zsh` for the `-arch` options.\n\n```sh\n$ ./.github/scripts/build-macos -c Release\n```\n\n#### Install\nThe above script should succeed and the plugin files (e.g. `obs-urlsource.plugin`) will reside in the `./release/Release` folder off of the root. Copy the `.plugin` file to the OBS directory e.g. `~/Library/Application Support/obs-studio/plugins`.\n\nTo get `.pkg` installer file, run for example\n```sh\n$ ./.github/scripts/package-macos -c Release\n```\n(Note that maybe the outputs will be in the `Release` folder and not the `install` folder like `pakage-macos` expects, so you will need to rename the folder from `build_x86_64/Release` to `build_x86_64/install`)\n\n### Linux (Ubuntu)\n\nUse the CI scripts again\n```sh\n$ ./.github/scripts/build-linux.sh\n```\n\nCopy the results to the standard OBS folders on Ubuntu\n```sh\n$ sudo cp -R release/RelWithDebInfo/lib/* /usr/lib/x86_64-linux-gnu/\n$ sudo cp -R release/RelWithDebInfo/share/* /usr/share/\n```\nNote: The official [OBS plugins guide](https://obsproject.com/kb/plugins-guide) recommends adding plugins to the `~/.config/obs-studio/plugins` folder.\n\n### Windows\n\nUse the CI scripts again, for example:\n\n```powershell\n\u003e .github/scripts/Build-Windows.ps1 -Target x64 -CMakeGenerator \"Visual Studio 17 2022\"\n```\n\nThe build should exist in the `./release` folder off the root. You can manually install the files in the OBS directory.\n\n\u003c!-- #### Building with CUDA support on Windows\n\nTo build with CUDA support on Windows, you need to install the CUDA toolkit from NVIDIA. The CUDA toolkit is available for download from [here](https://developer.nvidia.com/cuda-downloads).\n\nAfter installing the CUDA toolkit, you need to set variables to point CMake to the CUDA toolkit installation directory. For example, if you have installed the CUDA toolkit in `C:\\Program Files\\NVIDIA GPU Computing Toolkit\\CUDA\\v11.4`, you need to set `CUDA_TOOLKIT_ROOT_DIR` to `C:\\Program Files\\NVIDIA GPU Computing Toolkit\\CUDA\\v11.4` and `POLYGLOT_WITH_CUDA` to `ON` when running `.github/scripts/Build-Windows.ps1`.\n\nFor example\n```powershell\n.github/scripts/Build-Windows.ps1 -Target x64 -ExtraCmakeArgs '-D','POLYGLOT_WITH_CUDA=ON','-D',\"CUDA_TOOLKIT_ROOT_DIR='C:\\Program Files\\NVIDIA GPU Computing Toolkit\\CUDA\\v12.2'\"\n```\n\nYou will need to copy a few CUDA .dll files to the location of the plugin .dll for it to run. The required .dll files from CUDA (which are located in the `bin` folder of the CUDA toolkit installation directory) are:\n\n- `cudart64_NN.dll`\n- `cublas64_NN.dll`\n- `cublasLt64_NN.dll`\n\nwhere `NN` is the CUDA major version number. For example, if you have installed CUDA 12.2 as in example above, then `NN` is `12`. --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocaal-ai%2Fobs-polyglot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocaal-ai%2Fobs-polyglot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocaal-ai%2Fobs-polyglot/lists"}