Pot (Translator of Pylogmon)

🌈 A cross-platform software for text translation (Telegram Group)

---

Instructions

Selection Translation	Select the text to be translated, then press the shortcut key for word translation.
Input Translation	Press the shortcut key for translation input, enter the text to be translated, and press Enter to translate.
Plugin Invocation	Select the text to be translated and click the plugin icon. More infomation Plugin Invocation
Clipboard Listening Mode	Open the translation window, start the clipboard listening mode, and copy the content you want to translate
Screenshot OCR	Press the shortcut key for screenshot OCR, select the screenshot area in the box
Screenshot Translation	Press the shortcut key for screenshot translation, select the screenshot area in the box

Features

• Input text and translate
• Selection text and translate
• Invoke by other software to translate (Detial)
• Listening clipboard to translate
• OpenAI API support
• Multi-API support (Support Apis)
• Multi-language support
• Export to Anki/Eudic (or add more)
• Available on all PC platforms (Windows, macOS, and Linux)
• Good Wayland support (Test on KDE and Gnome)
• OCR support (Support Apis)
• Screenshot translate

Support Apis

Translation

• OpenAI
• Alibaba
• Baidu
• Caiyun
• Tencent
• TranSmart
• Volcengine
• Xiaoniu
• Lingva
• Google
• Bing
• Bing Dict
• DeepL
• Youdao
• and more...

OCR

• Tesseract (Offline)
• Baidu
• Tencent
• OCR Space
• Volcengine
• iFlytek
• Tencent Image Translation
• Simple Latex
• and more...

Installation

Windows

Install via Winget

winget install Pylogmon.pot

Install Manually

1. Download the installation package ending in .exe from the Latest Release page.
2. Double click the downloaded file to install it.

MacOS

Install via Brew

1. Add our tap:

brew tap pot-app/homebrew-tap

2. Install pot:

brew install --cask pot

3. Upgrade pot

brew upgrade --cask pot

Install Manually

1. Download the installation package ending in .dmg from the Latest Release page. (If you are using M1, please download the installation package named pot_{version}_aarch64.dmg, otherwise download the installation package named pot_{version}_x64.dmg)
2. Double click the downloaded file to install it.

Troubleshooting

• "pot" can’t be opened because the developer cannot be verified.

  Click the Cancel button, then go to the Settings -> Privacy and Security page, click the Still Open button, and then click the Open button in the pop-up window. After that, there will be no more pop-up warnings when opening pot.

  If you cannot find the above options in Privacy & Security, or get error prompts such as broken files with Apple Silicon machines. Open Terminal.app and enter the following command (you may need to enter a password halfway through), then restart pot:

  sudo xattr -d com.apple.quarantine /Applications/pot.app

• If you encounter a permission prompt every time you open it, or if you cannot perform a shortcut translation, please go to Settings -> Privacy & Security -> Supporting Features to remove pot, and then re-add pot.

Linux

Debian/Ubuntu

We provide AppImage and deb packages for Linux.

Please note that: There are two deb package, universal is based on glibc2.28 and openssl-1.1, If the regular deb package can't run on your machine due to dependency problems, please download the universal package, Due to its low version dependency, it can run on most systems.

Arch/Manjaro

View on AUR

Use aur helper：

yay -S pot-translation
# or
paru -S pot-translation

Plugin Invocation

Introduction

Pot supports invoke by other software. In this way, with the help of other software, it is very convenient to translate.

Pot provides two ways to call it from outside, you can also call it through other software you like

Both ways require the pot to keep running in the background.

1. Call the pot via the command line

pot popclip "hello world" # The second parameter is what you want to translate

2. Call the pot via the HTTP Request

curl 'http://127.0.0.1:60828' -X POST -d "Hello world" # The body content is what you want to translate

Existing Usage

SnipDo (Windows)

1. Download and install SnipDo in the Microsoft Store
2. Download the SnipDo extension of pot from the Latest Release (pot.pbar)
3. Double click the downloaded file to install it.
4. Selection some text, you can see the pot icon in the upper right corner of the selection, click the icon to translate.

PopClip (MacOS)

1. Download and install PopClip in the App Store
2. Download the PopClip extension of pot from the Latest Release (pot.popclipextz)
3. Double click the downloaded file to install it.
4. Enable the pot extension in PopClip settings, and then you can translate by selecting text.

Starry (Linux)

Starry is still in the development stage, so you can only compile him manually

Github: ccslykx/Starry

Contributors

Manual compilation

Requirements

Node.js >= 18.0.0

pnpm >= 8.5.0

Rust >= 1.69.0

Start compilation

1. Clone the repository

   git clone https://github.com/pot-app/pot-desktop.git

2. Install dependencies

   cd pot-desktop
   pnpm install

3. Development (Optional)

   pnpm tauri dev # Run the app in development mode

4. Build

   pnpm tauri build # Build into installation package

Acknowledgement

• Bob Inspiration
• bob-plugin-openai-translator OpenAI API Reference
• @uiYzzi Implementation ideas
• @Lichenkass Maintaining the Deepin App Store.
• Tauri A user-friendly GUI framework.