? A cross-platform word-marking translation software (QQ channel)
word translation | Enter translation | external call |
---|---|---|
Select the text that needs to be translated with the mouse and press the set word translation shortcut key. | Press the input translation shortcut key to call out the translation window, enter the text to be translated and press Enter to translate. | More convenient and efficient functions can be realized by being called by other software. For details, see External Calling |
Clipboard listening mode | Screenshot OCR | screenshot translation |
---|---|---|
Click the icon in the upper left corner of any translation panel to start the clipboard monitoring by default, and copy the text to complete the translation. | Press the screenshot OCR shortcut key and select the area to be recognized to complete the recognition. | Press the screenshot translation shortcut key and select the area to be identified to complete the translation. |
For more interface support, see the plug-in system
For more interface support, see the plug-in system
For more interface support, see the plug-in system
For more interface support, see the plug-in system
The number of built-in interfaces in the software is limited, but you can extend the functionality of the software through the plug-in system.
You can find the plug-in you need in the Plugin List, and then go to the plug-in repository to download the plug-in.
The extension of the pot plug-in is .potext
. After downloading the .potext
file, go to Preferences-Service Settings-Add External Plug-in-Install External Plug-in and select the corresponding .potext
to install successfully. Add it to the service list and it will be like a built-in service. Used normally.
The specified module could not be found (Windows)
Errors like this occur because the system lacks the C++ library. Go here to install it to solve the problem.
Not a valid Win32 application (Windows)
If an error like this occurs, it means that you have not downloaded the plug-in for the corresponding system or architecture. Go to the plug-in warehouse and download the correct plug-in to solve the problem.
The template chapter in the Plugin List provides development templates for various plug-ins. For specific development documents, please check the corresponding template repository.
winget install Pylogmon.pot
Download the latest exe
installation package on the Release page.
pot_{version}_x64-setup.exe
for 64-bit machinespot_{version}_x86-setup.exe
for 32-bit machinespot_{version}_arm64-setup.exe
Double-click the installation package to install.
There is no interface after startup, and there is no response when clicking the tray icon.
Check whether WebView2 is uninstalled/disabled. If WebView2 is uninstalled/disabled, please install WebView2 manually or restore it.
If the enterprise version system is inconvenient to install or cannot install WebView2, please try to download the built-in WebView2 version pot_{version}_{arch}_fix_webview2_runtime-setup.exe
in Release
If the problem persists, try booting in Windows 7 compatibility mode.
brew tap pot-app/homebrew-tap
brew install --cask pot
brew upgrade --cask pot
dmg
installation package from the Release page. (If you are using the M1 chip, please download the installation package named pot_{version}_aarch64.dmg
, otherwise please download the installation package named pot_{version}_x64.dmg
)"pot" cannot be opened because the developer cannot be verified.
Click the Cancel button, then go to the Settings->Privacy and Security page, click the Open Anyway button, and then click the Open button in the pop-up window. There will no longer be any pop-up warnings when you open the pot in the future.
If you can't find the above options in Privacy and Security, or it prompts that the file is damaged when starting. Open Terminal.app, enter the following command, and then restart pot:
sudo xattr -d com.apple.quarantine /Applications/pot.app
If you encounter an accessibility permission prompt every time you open it, or cannot translate words, please go to Settings -> Privacy & Security -> Accessibility, remove "pot", and add "pot" again.
Download the latest deb
installation package corresponding to the architecture from the Release page.
Install using apt-get
sudo apt-get install ./pot_{version}_amd64.deb
Warning
In the latest version of Webkit2Gtk (2.42.0), because the Nvidia proprietary driver does not fully implement DMABUF, it will cause failure to start and crash.
Please downgrade or add WEBKIT_DISABLE_DMABUF_RENDERER=1
environment variable to /etc/environment
(or other places where environment variables are set) to turn off the use of DMABUF.
Install using AUR helper
:
yay -S pot-translation # 或 pot-translation-bin
# paru -S pot-translation # 或 pot-translation-bin
archlinuxcn
source, you can install it directly using pacman sudo pacman -S pot-translation
Warning
Flatpak version is missing tray icon.
Pot provides a complete HTTP interface so that it can be called by other software. You can call pot by sending an HTTP request to 127.0.0.1:port
, where port
is the port number that pot listens to. The default is 60828
, which can be changed in the software settings.
POST " / " = > 翻译指定文本(body为需要翻译的文本),
GET " /config " = > 打开设置,
POST " /translate " = > 翻译指定文本(同" / " ),
GET " /selection_translate " = > 划词翻译,
GET " /input_translate " = > 输入翻译,
GET " /ocr_recognize " = > 截图OCR,
GET " /ocr_translate " = > 截图翻译,
GET " /ocr_recognize?screenshot=false " = > 截图OCR(不使用软件内截图),
GET " /ocr_translate?screenshot=false " = > 截图翻译(不使用软件内截图),
GET " /ocr_recognize?screenshot=true " = > 截图OCR,
GET " /ocr_translate?screenshot=true " = > 截图翻译,
Call the word translation:
If you want to call pot word translation, you only need to send a request to 127.0.0.1:port
.
For example, send a request through curl:
curl " 127.0.0.1:60828/selection_translate "
This function allows you to call the screenshot OCR/screenshot translation function without using the screenshot in the software, so that you can use your favorite screenshot tool to take screenshots, and can also solve the problem of pot's own screenshots on some platforms. Unusable problem.
$CACHE/com.pot-app.desktop/pot_screenshot_cut.png
127.0.0.1:port/ocr_recognize?screenshot=false
to call successfully
$CACHE
is the system cache directory, for example, on Windows it isC:Users{用户名}AppDataLocalcom.pot-app.desktoppot_screenshot_cut.png
Call Flameshot for screenshot OCR under Linux:
rm ~ /.cache/com.pot-app.desktop/pot_screenshot_cut.png && flameshot gui -s -p ~ /.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl " 127.0.0.1:60828/ocr_recognize?screenshot=false "
Starry is still under development, so you can only compile it manually.
Github: ccslykx/Starry
Since major distributions have different levels of support for Wayland, pot itself cannot provide particularly perfect support. Here we can provide solutions to some common problems. After reasonable settings, pot can also run perfectly under Wayland.
Since Tauri's shortcut key scheme does not support Wayland, the shortcut key settings in the pot application cannot be used in Wayland. You can set up a system shortcut to send a request using curl to trigger pot. For details, see External Call
On some pure Wayland desktop environments/window managers (such as Hyprland), the built-in screenshots of pot cannot be used. In this case, you can use other screenshot tools instead. For details, see Not using in-software screenshots
The following is a configuration example under Hyprland (screenshot through grim and slurp):
bind = ALT, X, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_recognize?screenshot=false"
bind = ALT, C, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_translate?screenshot=false"
Other desktop environments/window managers have similar operations
Since pot currently cannot obtain the correct mouse coordinates under Wayland, the internal implementation cannot work. For some desktop environments/window managers, you can set window rules to enable the window to follow the mouse position. Here is Hyprland as an example:
windowrulev2 = float, class:(pot), title:(Translator|OCR|PopClip|Screenshot Translate) # Translation window floating
windowrulev2 = move cursor 0 0, class:(pot), title:(Translator|PopClip|Screenshot Translate) # Translation window follows the mouse position.
Node.js >= 18.0.0
pnpm >= 8.5.0
Rust >= 1.80.0
Clone repository
git clone https://github.com/pot-app/pot-desktop.git
Install dependencies
cd pot-desktop
pnpm install
Install dependencies (only required for Linux)
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libayatana-appindicator3-dev librsvg2-dev patchelf libxdo-dev libxcb1 libxrandr2 libdbus-1-3
Development and debugging
pnpm tauri dev # Run the app in development mode
Package build
pnpm tauri build # Build into installation package