# AI Audio&Video Translation and Dubbing Tool

**[English](./README.md)｜[简体中文](docs/zh/README.md)｜[日本語](./docs/jp/README.md)｜[한국어](./docs/kr/README.md)｜[Tiếng Việt](./docs/vi/README.md)｜[Français](./docs/fr/README.md)｜[Deutsch](./docs/de/README.md)｜[Español](./docs/es/README.md)｜[Português](./docs/pt/README.md)｜[Русский](./docs/rus/README.md)｜[اللغة العربية](./docs/ar/README.md)** [![Twitter](https://img.shields.io/badge/Twitter-KrillinAI-orange?logo=twitter)](https://x.com/KrillinAI) [![Discord](https://img.shields.io/discord/1333374141092331605?label=Discord&logo=discord&style=flat-square)](https://discord.gg/sKUAsHfy) [![Bilibili](https://img.shields.io/badge/dynamic/json?label=Bilibili&query=%24.data.follower&suffix=%20followers&url=https%3A%2F%2Fapi.bilibili.com%2Fx%2Frelation%2Fstat%3Fvmid%3D242124650&logo=bilibili&color=00A1D6&labelColor=FE7398&logoColor=FFFFFF)](https://space.bilibili.com/242124650) [![QQ 群](https://img.shields.io/badge/QQ%20群-754069680-green?logo=tencent-qq)](https://jq.qq.com/?_wv=1027&k=754069680)

### 📢 New Release for Win & Mac Desktop Version – Welcome to Test and Provide Feedback ## Overview Krillin AI is an all-in-one solution for effortless video localization and enhancement. This minimalist yet powerful tool handles everything from translation, dubbing to voice cloning，formatting—seamlessly converting videos between landscape and portrait modes for optimal display across all content platforms(YouTube, TikTok, Bilibili, Douyin, WeChat Channel, RedNote, Kuaishou). With its end-to-end workflow, Krillin AI transforms raw footage into polished, platform-ready content in just a few clicks. ## Key Features: 🎯 **One-Click Start** - Launch your workflow instantly,New desktop version available—easier to use! 📥 **Video download** - yt-dlp and local file uploading supported 📜 **Precise Subtitles** - Whisper-powered high-accuracy recognition 🧠 **Smart Segmentation** - LLM-based subtitle chunking & alignment 🌍 **Professional Translation** - Paragraph-level translation for consistency 🔄 **Term Replacement** - One-click domain-specific vocabulary swap 🎙️ **Dubbing and Voice Cloning** - CosyVoice selected or cloning voices 🎬 **Video Composition** - Auto-formatting for horizontal/vertical layouts ## Showcase The following picture demonstrates the effect after the subtitle file, which was generated through a one-click operation after importing a 46-minute local video, was inserted into the track. There was no manual adjustment involved at all. There are no missing or overlapping subtitles, the sentence segmentation is natural, and the translation quality is also quite high. ![Alignment](./docs/images/alignment.png)

### Subtitle Translation --- https://github.com/user-attachments/assets/bba1ac0a-fe6b-4947-b58d-ba99306d0339

### Dubbing --- https://github.com/user-attachments/assets/0b32fad3-c3ad-4b6a-abf0-0865f0dd2385

### Portrait --- https://github.com/user-attachments/assets/c2c7b528-0ef8-4ba9-b8ac-f9f92f6d4e71

## 🔍 Speech Recognition Support _**All local models in the table below support automatic installation of executable files + model files. Just make your selection, and KrillinAI will handle everything else for you.**_ | Service | Supported Platforms | Model Options | Local/Cloud | Notes | |-----------------|------------------------------|-----------------------------------|-------------|----------------| | **OpenAI Whisper** | Cross-platform | - | Cloud | Fast with excellent results | | **FasterWhisper** | Windows/Linux | `tiny`/`medium`/`large-v2` (recommend medium+) | Local | Faster speed, no cloud service overhead | | **WhisperKit** | macOS (Apple Silicon only) | `large-v2` | Local | Native optimization for Apple chips | | **Alibaba Cloud ASR** | Cross-platform | - | Cloud | Bypasses China mainland network issues | ## 🚀 Large Language Model Support ✅ Compatible with all **OpenAI API-compatible** cloud/local LLM services including but not limited to: - OpenAI - DeepSeek - Qwen (Tongyi Qianwen) - Self-hosted open-source models - Other OpenAI-format compatible API services ## 🌍 Language Support Input language support: Chinese, English, Japanese, German, Turkish, Korean, Russian, Malay (continuously expanding) Translation languages: 101 languages supported, including English, Chinese, Russian, Spanish, French, etc. ## Interface Preview ![ui preview](./docs/images/ui_desktop.png) ## 🚀 Quick Start ### Basic Steps First, download the Release executable file that matches your device's system. Follow the instructions below to choose between the desktop or non-desktop version, then place the software in an empty folder. Running the program will generate some directories, so keeping it in an empty folder makes management easier. [For the desktop version (release files with "desktop" in the name), refer here] _The desktop version is newly released to address the difficulty beginners face in editing configuration files correctly. It still has some bugs and is being continuously updated._ Double-click the file to start using it. (The desktop version also requires configuration, which is done within the software.) [For the non-desktop version (release files without "desktop" in the name), refer here] _The non-desktop version is the original release, with more complex configuration but stable functionality. It is also suitable for server deployment, as it provides a web-based UI._ Create a `config` folder in the directory, then create a `config.toml` file inside it. Copy the contents of the `config-example.toml` file from the source code's `config` directory into your `config.toml` and fill in your configuration details. Double-click the executable or run it in the terminal to start the service. Open your browser and enter http://127.0.0.1:8888 to begin using it. (Replace 8888 with the port number you specified in the config file.) ### To: macOS Users [For the desktop version, i.e., release files with "desktop" in the name, refer here] The current packaging method for the desktop version cannot support direct double-click execution or DMG installation due to signing issues. Manual trust configuration is required as follows: 1. Open the directory containing the executable file (assuming the filename is KrillinAI_1.0.0_desktop_macOS_arm64) in Terminal 2. Execute the following commands sequentially: ``` sudo xattr -cr ./KrillinAI_1.0.0_desktop_macOS_arm64 sudo chmod +x ./KrillinAI_1.0.0_desktop_macOS_arm64 ./KrillinAI_1.0.0_desktop_macOS_arm64 ``` [For the non-desktop version, i.e., release files without "desktop" in the name, refer here] This software is not signed, so after completing the file configuration in the "Basic Steps," you will need to manually trust the application on macOS. Follow these steps: 1. Open the terminal and navigate to the directory where the executable file (assuming the file name is `KrillinAI_1.0.0_macOS_arm64`) is located. 2. Execute the following commands in sequence: ``` sudo xattr -rd com.apple.quarantine ./KrillinAI_1.0.0_macOS_arm64 sudo chmod +x ./KrillinAI_1.0.0_macOS_arm64 ./KrillinAI_1.0.0_macOS_arm64 ``` This will start the service. ### Docker Deployment This project supports Docker deployment. Please refer to the [Docker Deployment Instructions](./docker.md). ### Cookie Configuration Instructions If you encounter video download failures, please refer to the [Cookie Configuration Instructions](./get_cookies.md) to configure your cookie information. ### Configuration Help The quickest and most convenient configuration method: * Select `openai` for both `transcription_provider` and `llm_provider`. In this way, you only need to fill in `openai.apikey` in the following three major configuration item categories, namely `openai`, `local_model`, and `aliyun`, and then you can conduct subtitle translation. (Fill in `app.proxy`, `model` and `openai.base_url` as per your own situation.) The configuration method for using the local speech recognition model (macOS is not supported for the time being) (a choice that takes into account cost, speed, and quality): * Fill in `fasterwhisper` for `transcription_provider` and `openai` for `llm_provider`. In this way, you only need to fill in `openai.apikey` and `local_model.faster_whisper` in the following three major configuration item categories, namely `openai` and `local_model`, and then you can conduct subtitle translation. The local model will be downloaded automatically. (The same applies to `app.proxy` and `openai.base_url` as mentioned above.) The following usage situations require the configuration of Alibaba Cloud: * If `llm_provider` is filled with `aliyun`, it indicates that the large model service of Alibaba Cloud will be used. Consequently, the configuration of the `aliyun.bailian` item needs to be set up. * If `transcription_provider` is filled with `aliyun`, or if the "voice dubbing" function is enabled when starting a task, the voice service of Alibaba Cloud will be utilized. Therefore, the configuration of the `aliyun.speech` item needs to be filled in. * If the "voice dubbing" function is enabled and local audio files are uploaded for voice timbre cloning at the same time, the OSS cloud storage service of Alibaba Cloud will also be used. Hence, the configuration of the `aliyun.oss` item needs to be filled in. Configuration Guide: [Alibaba Cloud Configuration Instructions](./aliyun.md) ## Frequently Asked Questions Please refer to [Frequently Asked Questions](./faq.md) ## Contribution Guidelines - Do not submit unnecessary files like `.vscode`, `.idea`, etc. Please make good use of `.gitignore` to filter them. - Do not submit `config.toml`; instead, submit `config-example.toml`. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=krillinai/KrillinAI&type=Date)](https://star-history.com/#krillinai/KrillinAI&Date)