Skip to content

DeepLX Local Deployment Translation Channel

What is it?

DeepLX is an open-source project that simulates DeepL client behavior to call DeepL's translation interface without requiring an official DeepL API key. However, please note that DeepLX is essentially an unofficial workaround and may become unstable. If you encounter errors, confirm your deployment is correct and then consider switching to another translation channel.

Prerequisites

  • DeepLX executable downloaded (from GitHub Releases)

Deployment Steps

Step 1: Download DeepLX

Go to https://github.com/OwO-Network/DeepLX/releases and download the version for your operating system:

Download page

Operating SystemFile Name
Windows 64-bitdeeplx_windows_amd64.exe
macOS (Intel)deeplx_darwin_amd64
macOS (Apple Silicon)deeplx_darwin_arm64
Linuxdeeplx_linux_amd64

Step 2: Run DeepLX

On Windows, double-click deeplx_windows_amd64.exe to launch it. The following interface indicates a successful deployment:

Running successfully

The number 1188 is the local listening port.

Step 3: Configure in pyVideoTrans

  1. Open the menu bar → Translation SettingsDeepLX Settings
  2. Enter http://127.0.0.1:1188 in the API URL field (i.e., http://127.0.0.1:port-number)
  3. Click the Test button to verify the connection
  4. Save after a successful test

Configuration panel

SettingRecommended Value
API URLhttp://127.0.0.1:1188 (default port)
API KeyLeave empty (DeepLX typically does not require a key)

Important Notes

  1. Unstable: DeepLX relies on an unofficial DeepL interface that may stop working at any time. It is not recommended as a primary translation channel.
  2. Must stay running: The DeepLX program must remain running — translations won't work after it's closed.
  3. Port conflicts: If the default port 1188 is already in use, the program will automatically use a different port. Check the actual port number displayed in the running interface.

Most AI translation channels may limit requests per minute. If you encounter rate limit errors, go to MenuTools/OptionsAdvanced OptionsPost-translation pause time and set a delay in seconds (e.g., 30) to avoid exceeding the limit.

Post-translation pause setting

Troubleshooting

IssueCauseSolution
Connection refusedDeepLX not runningMake sure the DeepLX program is running
Translation errorDeepLX interface has stopped workingTry updating DeepLX to the latest version, or switch to another channel
Wrong port numberDeepLX using a non-default portCheck the actual port displayed in the DeepLX interface
Empty translation resultDeepLX service issueRestart the DeepLX program