Nola-Translator README

项目的 README,来自 github.com/CerealAxis/Nola-Translator。合并为一个 markdown 文件:README.md。

Nola Translator Logo

Nola Translator

A real-time captioning and translation app.

English · 简体中文 · 繁體中文(台灣) · 繁體中文(香港) · 日本語 · 한국어

GPL v3 license Build workflow status Download from GitHub Actions Latest GitHub release Download the latest release QQ Group: 701699932 Electron React 19 Vite 7

Nola Translator interface preview

Overview

Nola Translator turns speech into real-time captions and translations. Run speech recognition and translation locally, use cloud services, or combine the two.

Features

Interface Preview

Home Floating Captions Video Captions
Home Floating captions Video captions
Local Model Installation Inference Environment Settings Dark Mode Support
Local model installation Inference environment settings Dark mode support

The floating and browser caption scenes use a cropped frame from Tears of Steel, © Blender Foundation, under CC BY 3.0.

Installation

Windows x64 is supported. You can choose the EXE or MSI installer. Support for other platforms is planned once development has stabilized.

Local Recognition Models

[!TIP] The languages available for recognition and translation depend on the selected model's capabilities. The tables below show the capabilities of the recommended models included in the app. If you have a model to recommend, submit it as an issue; we will evaluate it for possible inclusion. For first-time users, we recommend SenseVoiceSmall for recognition and HY-MT2 for translation.

Model Number of Languages Details
Qwen3-ASR 30 Chinese, English, Cantonese, Arabic, German, French, Spanish, Portuguese, Indonesian, Italian, Korean, Russian, Thai, Vietnamese, Japanese, Turkish, Hindi, Malay, Dutch, Swedish, Danish, Finnish, Polish, Czech, Filipino, Persian, Greek, Hungarian, Macedonian, and Romanian
SenseVoiceSmall 5 Chinese, English, Cantonese, Japanese, and Korean
Fun-ASR Nano 4 Chinese, English, Japanese, and Cantonese
VibeVoice-ASR 48 English, Chinese, Spanish, Portuguese, German, Japanese, Korean, French, Russian, Indonesian, Swedish, Italian, Hebrew, Dutch, Polish, Norwegian, Turkish, Thai, Arabic, Hungarian, Catalan, Czech, Danish, Persian, Afrikaans, Hindi, Finnish, Estonian, Greek, Romanian, Vietnamese, Bulgarian, Icelandic, Slovenian, Slovak, Lithuanian, Swahili, Ukrainian, Latvian, Croatian, Nepali, Serbian, Filipino, Malay, Urdu, Mongolian, Armenian, and Javanese
MiMo-V2.5-ASR 3 Chinese, English, and Cantonese

Local Translation Models

Model Number of Languages Details
HY-MT2 38 Simplified Chinese, Traditional Chinese, English, French, Portuguese, Spanish, Japanese, Turkish, Russian, Arabic, Korean, Thai, Italian, German, Vietnamese, Malay, Indonesian, Filipino, Hindi, Polish, Czech, Dutch, Khmer, Burmese, Persian, Gujarati, Urdu, Telugu, Marathi, Hebrew, Bengali, Tamil, Ukrainian, Tibetan, Kazakh, Mongolian, Uyghur, and Cantonese
M2M100 418M 100 Afrikaans, Amharic, Arabic, Asturian, Azerbaijani, Bashkir, Belarusian, Bulgarian, Bengali, Breton, Bosnian, Catalan, Cebuano, Czech, Welsh, Danish, German, Greek, English, Spanish, Estonian, Persian, Fula, Finnish, French, Western Frisian, Irish, Scottish Gaelic, Galician, Gujarati, Hausa, Hebrew, Hindi, Croatian, Haitian Creole, Hungarian, Armenian, Indonesian, Igbo, Ilocano, Icelandic, Italian, Japanese, Javanese, Georgian, Kazakh, Khmer, Kannada, Korean, Luxembourgish, Ganda (Luganda), Lingala, Lao, Lithuanian, Latvian, Malagasy, Macedonian, Malayalam, Mongolian, Marathi, Malay, Burmese, Nepali, Dutch, Norwegian, Northern Sotho, Occitan, Odia, Punjabi, Polish, Pashto, Portuguese, Romanian, Russian, Sindhi, Sinhala, Slovak, Slovenian, Somali, Albanian, Serbian, Swati, Sundanese, Swedish, Swahili, Tamil, Thai, Filipino, Tswana, Turkish, Ukrainian, Urdu, Uzbek, Vietnamese, Wolof, Xhosa, Yiddish, Yoruba, Chinese, and Zulu
Index-Translate 150 English, Chinese, German, French, Spanish, Japanese, Korean, Portuguese, Russian, Arabic, Italian, Dutch, Polish, Romanian, Swedish, Turkish, Hindi, Vietnamese, Thai, Indonesian, Malay, Filipino, Ukrainian, Persian, Czech, Greek, Danish, Hungarian, Finnish, Norwegian (written), Slovak, Bulgarian, Bosnian, Catalan, Bengali, Hebrew, Lithuanian, Slovenian, Estonian, Albanian, Latvian, Azerbaijani, Croatian, Tamil, Nepali, Urdu, Macedonian, Serbian (Cyrillic), Marathi, Georgian, Malayalam, Kazakh, Icelandic, Galician, Kannada, Moroccan Arabic, Gujarati, Belarusian, Afrikaans, Armenian, Mongolian, Khmer, Basque, Burmese, Latin, Uzbek (Cyrillic), Telugu, Odia, Norwegian Nynorsk, Uzbek, Swahili, Sinhala, Kyrgyz, Somali, Punjabi, Egyptian Arabic, Welsh, Norman, Pashto, Irish, Serbian (Latin), Hausa, Kurdish (Sorani), Maltese, Cantonese, Tajik, Kurdish (Kurmanji), Betawi, Amharic, Lao, Luxembourgish, Frisian, Divehi, Esperanto, Kinyarwanda, Najdi Arabic, Faroese, Malagasy, Assamese, Sindhi, Xhosa, Turkmen, Haitian Creole, Scottish Gaelic, Cebuano, Yiddish, Javanese, Bashkir, Papiamento, Maori, Uyghur, Tatar, Tibetan, Hmong, Western Armenian, Yoruba, Zulu, Southern Kurdish, Samoan, Corsican, Fiji Hindi, Sundanese, Chichewa, Igbo, Hawaiian, Sesotho, Mizo, Shona, Chuvash, South Azerbaijani, Romansh, Rundi, Hindi (Latin), Sakha, Tigrinya, Asturian, Occitan, Hakha Chin, Northern Sami, Low German, Ossetian, Urdu (Latin), Swiss German, Angika, Levantine Arabic, Oromo, Neapolitan, Upper Sorbian, Hiligaynon, and Greenlandic

Local Text-to-Speech

Model Number of Languages Details
Qwen3-TTS 10 Chinese, English, Japanese, Korean, German, French, Russian, Portuguese, Spanish, and Italian

Cloud Recognition Models

Provider Model Supported languages Details
Aliyun Qwen3.5 / Qwen3.8 LiveTranslate 60 Chinese, English, Arabic, German, French, Spanish, Portuguese, Indonesian, Italian, Korean, Russian, Thai, Vietnamese, Japanese, Turkish, Hindi, Malay, Dutch, Urdu, Norwegian Bokmål, Swedish, Danish, Hebrew, Finnish, Polish, Icelandic, Czech, Filipino, Persian, Cantonese, Greek, Afrikaans, Asturian, Belarusian, Bulgarian, Bengali, Bosnian, Catalan, Cebuano, Estonian, Galician, Gujarati, Croatian, Hungarian, Javanese, Kazakh, Kannada, Kyrgyz, Latvian, Macedonian, Malayalam, Marathi, Punjabi, Romanian, Slovak, Slovenian, Swahili, Tajik, Azerbaijani, and Ukrainian. Version 3.8 detects the source language automatically; version 3.5 allows you to specify the source language.
MiniMax Speech-to-Text asr-1.0 20 Arabic, Cantonese, Chinese, English, Filipino, French, German, Indonesian, Italian, Japanese, Korean, Malay, Polish, Portuguese, Russian, Spanish, Thai, Turkish, Ukrainian, and Vietnamese.

Cloud Translation Models

Model Number of Languages Details
Aliyun LiveTranslate 60 Automatic source-language detection
Index-Translate-35B-A3B 150 English, Chinese, German, French, Spanish, Japanese, Korean, Portuguese, Russian, Arabic, Italian, Dutch, Polish, Romanian, Swedish, Turkish, Hindi, Vietnamese, Thai, Indonesian, Malay, Filipino, Ukrainian, Persian, Czech, Greek, Danish, Hungarian, Finnish, Norwegian (written), Slovak, Bulgarian, Bosnian, Catalan, Bengali, Hebrew, Lithuanian, Slovenian, Estonian, Albanian, Latvian, Azerbaijani, Croatian, Tamil, Nepali, Urdu, Macedonian, Serbian (Cyrillic), Marathi, Georgian, Malayalam, Kazakh, Icelandic, Galician, Kannada, Moroccan Arabic, Gujarati, Belarusian, Afrikaans, Armenian, Mongolian, Khmer, Basque, Burmese, Latin, Uzbek (Cyrillic), Telugu, Odia, Norwegian Nynorsk, Uzbek, Swahili, Sinhala, Kyrgyz, Somali, Punjabi, Egyptian Arabic, Welsh, Norman, Pashto, Irish, Serbian (Latin), Hausa, Kurdish (Sorani), Maltese, Cantonese, Tajik, Kurdish (Kurmanji), Betawi, Amharic, Lao, Luxembourgish, Frisian, Divehi, Esperanto, Kinyarwanda, Najdi Arabic, Faroese, Malagasy, Assamese, Sindhi, Xhosa, Turkmen, Haitian Creole, Scottish Gaelic, Cebuano, Yiddish, Javanese, Bashkir, Papiamento, Maori, Uyghur, Tatar, Tibetan, Hmong, Western Armenian, Yoruba, Zulu, Southern Kurdish, Samoan, Corsican, Fiji Hindi, Sundanese, Chichewa, Igbo, Hawaiian, Sesotho, Mizo, Shona, Chuvash, South Azerbaijani, Romansh, Rundi, Hindi (Latin), Sakha, Tigrinya, Asturian, Occitan, Hakha Chin, Northern Sami, Low German, Ossetian, Urdu (Latin), Swiss German, Angika, Levantine Arabic, Oromo, Neapolitan, Upper Sorbian, Hiligaynon, and Greenlandic
Microsoft Translator 100+ Per the official language table
Google Translate 100+ Per the official language table
MyMemory (free translation) 100+ Per the official language table
LLM API (OpenAI-compatible, Anthropic, Ollama) Depends on the chosen model —

LLM API Configuration

[!TIP] The LLM protocols here are used for translation. Aliyun and MiniMax ASR models use separate connection settings and credentials under Audio and Recognition. Local models require no API configuration.

Supported Protocols

The app supports the following API protocols:

Protocol
OpenAI Chat Completions
OpenAI Responses
Anthropic Messages
Ollama Chat

Configuration Examples

Provider API Format Example API URL Example Model ID
DeepSeek OpenAI Chat Completions https://api.deepseek.com deepseek-flash
MiniMax OpenAI Chat Completions https://api.minimax.io/v1 MiniMax-M3
MiMo OpenAI Chat Completions https://api.xiaomimimo.com/v1 mimo-v2.6-pro

Configuration Steps

LLM configuration screen

  1. Select Cloud Translation in the translation settings.
  2. Choose the API format supported by your provider.
  3. Enter the API URL, API key, and model ID.
  4. Adjust the context window and maximum output tokens as needed.

Project Structure

assets/brand/                  Logo and brand assets
docs/                          VitePress product website and multilingual documentation
engine/nola_translator_engine/  Python audio, recognition, and translation engine
engine/tests/                   Python tests
scripts/                        Setup and build scripts
src/main/                       Electron main process
src/preload/                    IPC bridge
src/renderer/                   React interface
src/shared/                     Shared contracts and settings
tests/                          Application tests

Development and Build

npm run typecheck
npm test
.\.venv\Scripts\python.exe -m pytest engine\tests
npm run build

Build the Windows x64 installer:

npm run dist:win

Contributing

Fork the repository, create a branch, make your changes, and open a pull request. Briefly describe your changes and the checks you ran. For design and code conventions, see DESIGN.md and the contribution guide.

Sponsorship

You can support this project through the channels below. Sponsors receive benefits including priority help with issues, one-on-one guidance, permanent recognition in the sponsor list and in the app, and custom features.

1. Mainland China

2. Other regions

License

Nola Translator's original code is licensed under GNU GPL v3.0 only. Third-party components and models are subject to their respective licenses; see Third-Party Notices.

Star History Chart

Nola-Translator (CerealAxis/Nola-Translator)

正在搜索数据库…

这是什么?Nola Translator 是一款开源的 Windows 应用,可以使用本地或云端的语音识别和翻译模型,把语音实时转换成字幕和译文。
这是桌面应用,还是只是一个浏览器扩展?它主要是一款 Windows 桌面应用,另外还提供一个可选的配套浏览器扩展(适用于 Chrome 和 Edge),可以在视频页面上叠加显示双语字幕。
使用前是否需要设置 API 密钥或下载模型?使用本地模型无需注册账号,应用可以直接从 Hugging Face 搜索并安装 Qwen3-ASR、SenseVoiceSmall、HY-MT2 等模型。如果要使用云端识别或翻译(阿里云、MiniMax,或兼容 OpenAI 的接口、Anthropic、Ollama 的 API),则需要自行填写 API 地址、密钥和模型 ID。
它也能在 macOS 或 Linux 上运行吗?暂时还不行,目前只提供 Windows x64 版本(EXE/MSI),对其他平台的支持计划在后续版本中推出。
我的 API 密钥和音频会被保密吗?你输入的 API 凭据由应用本身安全存储;使用本地模型时,所有识别和翻译都在你自己的电脑上完成,不会经过云服务商。
字幕可以导出为哪些格式?字幕历史记录可以导出为 TXT、SRT 或 WebVTT 格式,你还可以选择在显示字幕的同时录制音频。
支持多少种语言?这取决于所用的模型:推荐的本地模型最多支持 37 种(HY-MT2)或 100 种(M2M100)语言,而阿里云 LiveTranslate 等云端选项最多支持 60 种语言。
第一次使用的人应该选哪个模型?README 推荐语音识别使用 SenseVoiceSmall,翻译使用 HY-MT2 1.8B,这是最容易上手的组合。
可以用显卡加速处理吗?可以。应用会检测可用的计算设备,并允许你分别为识别和翻译独立指定设备(GPU 或 CPU)。
大小
189.5 MB
星标
345
时长
1个月
提交 · 90 天