Skip to content

Commit cc47bc9

Browse files
committed
Update README.md
1 parent df45b8b commit cc47bc9

File tree

2 files changed

+377
-153
lines changed

2 files changed

+377
-153
lines changed

README.md

Lines changed: 160 additions & 153 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# King Translator AI - Công cụ dịch thuật đa năng tích hợp AI
1+
# King Translator AI - Versatile AI-Powered Translation Tool
22

33
![Version](https://img.shields.io/badge/version-4.2-blue)
44
![Status](https://img.shields.io/badge/status-updated-green)
@@ -7,209 +7,216 @@
77
<div align="center">
88
<img src="kings.jpg" alt="Translator AI Logo" width="200"/>
99
<br>
10-
<i>Công cụ dịch thuật thông minh tích hợp AI (Google Gemini) cho trình duyệt</i>
10+
<i>Intelligent AI-powered translation tool (Google Gemini) for browsers</i>
1111
</div>
1212

13-
## 📖 Mục lục
14-
- [Giới thiệu](#-giới-thiệu)
15-
- [Ảnh màn hình](#-ảnh-màn-hình)
16-
- [Tính năng](#-tính-năng)
17-
- [Hướng dẫn cài đặt](#-hướng-dẫn-cài-đặt)
18-
- [Hướng dẫn sử dụng](#-hướng-dẫn-sử-dụng)
19-
- [Cấu hình](#-cấu-hình)
20-
- [Phím tắt](#-phím-tắt)
21-
- [Lưu ý](#-lưu-ý)
22-
- [Đóng góp](#-đóng-góp)
23-
- [Giấy phép](#-giấy-phép)
24-
- [Cài đặt](#-cài-đặt)
13+
## 📖 Table of Contents
14+
- [Introduction](#-introduction)
15+
- [Screenshots](#-screenshots)
16+
- [Features](#-features)
17+
- [Installation Guide](#-installation-guide)
18+
- [Usage Instructions](#-usage-instructions)
19+
- [Configuration](#-configuration)
20+
- [Shortcuts](#-shortcuts)
21+
- [Notes](#-notes)
22+
- [Contributions](#-contributions)
23+
- [License](#-license)
24+
- [Download](#-download)
25+
- [Hướng dẫn tiếng Việt](README_vi.md)
2526

26-
## 🌟 Giới thiệu
27+
## 🌟 Introduction
2728

28-
Translator AI là userscript dịch thuật tích hợp AI, cho phép dịch văn bản, hình ảnh, media và trang web trực tiếp trên trình duyệt. Sử dụng Google Gemini API để mang lại kết quả dịch chất lượng cao.
29+
Translator AI is an AI-integrated translation userscript that allows you to translate text, images, media, and web pages directly in your browser. It utilizes the Google Gemini API to deliver high-quality translation results.
2930

30-
## 📸 Ảnh màn hình
31+
## 📸 Screenshots
3132

3233
### 📱 Mobile
3334
<details>
34-
<summary>Click để xem</summary>
35-
36-
![Mobile Screenshot 1](https://i.imgur.com/7pi9USr.jpeg)
37-
![Mobile Screenshot 2](https://i.imgur.com/3ksRC8R.jpeg)
38-
![Mobile Screenshot 3](https://i.imgur.com/Wu5jXLv.jpeg)
39-
![Mobile Screenshot 4](https://i.imgur.com/Bcy8QIu.jpeg)
40-
![Mobile Screenshot 5](https://i.imgur.com/AcXGewv.jpeg)
41-
![Mobile Screenshot 6](https://i.imgur.com/KQtCnnk.jpeg)
42-
![Mobile Screenshot 7](https://i.imgur.com/vmA7OW7.jpeg)
43-
![Mobile Screenshot 8](https://i.imgur.com/lWDs7Iu.jpeg)
35+
<summary>Click to view</summary>
36+
37+
<div style="display: flex; flex-wrap: wrap; justify-content: space-between;">
38+
<img src="https://i.imgur.com/7pi9USr.jpeg" width="45%" />
39+
<img src="https://i.imgur.com/3ksRC8R.jpeg" width="45%" />
40+
<img src="https://i.imgur.com/Wu5jXLv.jpeg" width="45%" />
41+
<img src="https://i.imgur.com/Bcy8QIu.jpeg" width="45%" />
42+
<img src="https://i.imgur.com/AcXGewv.jpeg" width="45%" />
43+
<img src="https://i.imgur.com/KQtCnnk.jpeg" width="45%" />
44+
<img src="https://i.imgur.com/vmA7OW7.jpeg" width="45%" />
45+
<img src="https://i.imgur.com/lWDs7Iu.jpeg" width="45%" />
46+
</div>
4447

4548
</details>
4649

4750
### 💻 PC
4851
<details>
49-
<summary>Click để xem</summary>
50-
51-
![PC Screenshot 1](https://i.imgur.com/tZ5NqOG.jpeg)
52-
![PC Screenshot 2](https://i.imgur.com/esxZv9N.jpeg)
53-
![PC Screenshot 3](https://i.imgur.com/4tTFvZW.jpeg)
54-
![PC Screenshot 4](https://i.imgur.com/gIExWnd.jpeg)
55-
![PC Screenshot 5](https://i.imgur.com/X7CG6kk.png)
56-
![PC Screenshot 6](https://i.imgur.com/y0Ym8iX.jpeg)
57-
![PC Screenshot 7](https://i.imgur.com/QcwfvAH.jpeg)
58-
![PC Screenshot 8](https://i.imgur.com/QvUpwfR.jpeg)
52+
<summary>Click to view</summary>
53+
54+
<div style="display: flex; flex-wrap: wrap; justify-content: space-between;">
55+
<img src="https://i.imgur.com/tZ5NqOG.jpeg" width="45%" />
56+
<img src="https://i.imgur.com/esxZv9N.jpeg" width="45%" />
57+
<img src="https://i.imgur.com/4tTFvZW.jpeg" width="45%" />
58+
<img src="https://i.imgur.com/gIExWnd.jpeg" width="45%" />
59+
<img src="https://i.imgur.com/X7CG6kk.png" width="45%" />
60+
<img src="https://i.imgur.com/y0Ym8iX.jpeg" width="45%" />
61+
<img src="https://i.imgur.com/QcwfvAH.jpeg" width="45%" />
62+
<img src="https://i.imgur.com/QvUpwfR.jpeg" width="45%" />
63+
</div>
5964

6065
</details>
6166

62-
## Tính năng
67+
## Features
6368

64-
### 📝 Dịch Văn Bản
65-
- Dịch nhanh khi bôi đen văn bản
66-
- Dịch popup với giao diện đẹp
67-
- Dịch nâng cao với phân tích từ vựng
68-
- Tự động dịch trong ô nhập liệu
69+
### 📝 Text Translation
70+
- Quick translation when text is highlighted
71+
- Popup translation with an attractive interface
72+
- Advanced translation with vocabulary analysis
73+
- Automatic translation in input fields
6974

70-
### 🖼️ Dịch Hình Ảnh (OCR)
71-
- Dịch file ảnh từ máy tính
72-
- Chụp và dịch màn hình
73-
- Dịch ảnh trên web
74-
- Dịch manga với overlay text
75+
### 🖼️ Image Translation (OCR)
76+
- Translate image files from your computer
77+
- Capture and translate screenshots
78+
- Translate images on the web
79+
- Manga translation with overlay text
7580

76-
### 🎵 Dịch Media
77-
- Hỗ trợ file audio (MP3, WAV, OGG,...)
78-
- Hỗ trợ file video (MP4, WEBM,...)
79-
- Tự động tạo phụ đề SRT
81+
### 🎵 Media Translation
82+
- Supports audio files (MP3, WAV, OGG,...)
83+
- Supports video files (MP4, WEBM,...)
84+
- Automatically generate SRT subtitles
8085

81-
### 🌐 Dịch Trang Web
82-
- Dịch toàn bộ trang web
83-
- Tự động nhận diện ngôn ngữ
84-
- Dịch file HTML PDF
85-
- Tùy chọn loại trừ elements
86+
### 🌐 Website Translation
87+
- Translate entire web pages
88+
- Automatically detect language
89+
- Translate HTML and PDF files
90+
- Exclude specific elements as options
8691

87-
## 🔧 Hướng dẫn cài đặt chi tiết
92+
## 🔧 Detailed Installation Guide
8893

89-
### Bước 1: Cài Extension Quản lý Script
90-
- **Firefox (Khuyên dùng):**
91-
- Cài Violentmonkey (Open source, khuyên dùng) hoặc Tampermonkey
92-
- Mở Firefox Add-ons click "Add to Firefox"
94+
### Step 1: Install Script Manager Extension
95+
- **Firefox (Recommended):**
96+
- Install Violentmonkey (Open source, recommended) or Tampermonkey
97+
- Open Firefox Add-ons and click "Add to Firefox"
9398

9499
- **Chrome:**
95-
- Cài Violentmonkey hoặc Tampermonkey từ Chrome Web Store
96-
- Click "Thêm vào Chrome"
100+
- Install Violentmonkey or Tampermonkey from the Chrome Web Store
101+
- Click "Add to Chrome"
97102

98-
### Bước 2: Lấy API Key Gemini
99-
1. Truy cập [Google AI Studio](https://makersuite.google.com/app/apikey)
100-
2. Đăng nhập Google
103+
### Step 2: Obtain Gemini API Key
104+
1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey)
105+
2. Sign in with Google
101106
3. Click "Create API Key"
102-
4. Sao chép API key
103-
104-
### Bước 3: Cài đặt Script
105-
1. Click biểu tượng Violentmonkey
106-
2. Vào Dashboard > Utilities
107-
3. Dán link script vào "Install from URL" (link script ở cuối bài viết)
108-
4. Xác nhận cài đặt
109-
110-
### Bước 4: Cấu hình
111-
1. Mở cài đặt (Alt + S hoặc chạm 4 ngón)
112-
2. Chọn Gemini làm provider
113-
3. Nhập API key
114-
4. Lưu cài đặt
115-
116-
## 📚 Hướng dẫn sử dụng chi tiết
117-
118-
### Dịch Văn Bản
119-
1. Bôi đen văn bản cần dịch
120-
2. Chọn kiểu dịch:
121-
- Click đơn: Dịch nhanh
122-
- Click đúp: Dịch popup
123-
- Giữ click: Dịch nâng cao
124-
125-
### Dịch Trong Input
126-
- 🌐 : Dịch sang ngôn ngữ đích
127-
- 🔄 : Dịch sang ngôn ngữ nguồn
128-
- Alt + T: Dịch nhanh
129-
130-
### Tools Dịch
131-
Click "Tools Dịch" góc phải màn hình:
132-
- Dịch Trang
133-
- Dịch Ảnh/OCR
134-
- Dịch Media
135-
- Dịch File
136-
137-
## ⌨️ Phím tắt
138-
139-
| Phím tắt | Chức năng |
107+
4. Copy the API key
108+
109+
### Step 3: Install the Script
110+
1. Click the Violentmonkey icon
111+
2. Go to Dashboard > Utilities
112+
3. Paste the script link into "Install from URL" (script link at the end of this document)
113+
4. Confirm the installation
114+
115+
### Step 4: Configuration
116+
1. Open settings (Alt + S or tap 4 fingers)
117+
2. Choose Gemini as the provider
118+
3. Enter the API key
119+
4. Save the settings
120+
121+
## 📚 Detailed Usage Instructions
122+
123+
### Text Translation
124+
1. Highlight the text to be translated
125+
2. Choose the type of translation:
126+
- Single click: Quick translation
127+
- Double click: Popup translation
128+
- Hold click: Advanced translation
129+
130+
### Input Translation
131+
- 🌐 : Translate to target language
132+
- 🔄 : Translate to source language
133+
- Alt + T: Quick translation
134+
135+
### Translation Tools
136+
Click "Translation Tools" in the bottom right of the screen:
137+
- Translate Page
138+
- Translate Image/OCR
139+
- Translate Media
140+
- Translate File
141+
142+
## ⌨️ Shortcuts
143+
144+
| Shortcut | Function |
140145
|----------|-----------|
141-
| Alt + F | Dịch trang |
142-
| Alt + Q | Dịch nhanh |
143-
| Alt + E | Dịch popup |
144-
| Alt + A | Dịch nâng cao |
145-
| Alt + T | Dịch input |
146-
| Alt + S | Mở cài đặt |
147-
148-
## 📱 Cảm ứng (Mobile)
149-
150-
| Thao tác | Chức năng |
151-
|----------|-----------|
152-
| 2 ngón | Dịch popup |
153-
| 3 ngón | Dịch nâng cao |
154-
| 4 ngón | Mở cài đặt |
155-
| 5 ngón | Bật/tắt Tools |
156-
157-
## ⚙️ Cấu hình
158-
159-
### Giao diện
160-
- Theme sáng/tối
146+
| Alt + F | Translate page |
147+
| Alt + Q | Quick translation |
148+
| Alt + E | Popup translation |
149+
| Alt + A | Advanced translation |
150+
| Alt + T | Translate input |
151+
| Alt + S | Open settings |
152+
153+
## 📱 Touch (Mobile)
154+
155+
| Gesture | Function |
156+
|---------|-----------|
157+
| 2 fingers | Popup translation |
158+
| 3 fingers | Advanced translation |
159+
| 4 fingers | Open settings |
160+
| 5 fingers | Toggle Tools |
161+
162+
## ⚙️ Configuration
163+
164+
### Interface
165+
- Light/Dark theme
161166
- Font size
162-
- Vị trí nút dịch
167+
- Position of the translate button
163168

164169
### API & Models
165170
- Provider: Gemini AI
166171
- API Keys
167-
- Lựa chọn model
172+
- Model selection
168173

169-
### Tùy chỉnh
170-
- Prompt dịch
171-
- Phím tắt
174+
### Customization
175+
- Translation prompt
176+
- Shortcuts
172177
- Cache
173-
- Sao lưu/Khôi phục
178+
- Backup/Restore
174179

175-
## Lưu ý
180+
## Notes
176181

177-
- Cần API key Gemini
178-
- Giới hạn 5 request/10s
179-
- Cache tăng tốc độ dịch
180-
- Hỗ trợ dịch offline với cache
181-
- Tự động phát hiện ngôn ngữ
182-
- Hỗ trợ nhiều ngôn ngữ
183-
- **Những lưu ý khi sử dụng chi tiết:** https://voz.vn/t/script-dung-ai-%C4%91e-dich-moi-thu-text-anh-audio-video.1072947/#-huong-dan-su-dung
182+
- Gemini API key required
183+
- Limit of 5 requests/10s
184+
- Cache speeds up translation
185+
- Supports offline translation with cache
186+
- Automatic language detection
187+
- Supports multiple languages
188+
- **Detailed usage notes:** https://voz.vn/t/script-dung-ai-%C4%91e-dich-moi-thu-text-anh-audio-video.1072947/#-huong-dan-su-dung
184189

185-
## 🤝 Đóng góp
190+
## 🤝 Contributions
186191

187-
Mọi đóng góp đều được chào đón! Hãy:
188-
1. Fork project
189-
2. Tạo branch mới
192+
All contributions are welcome! Please:
193+
1. Fork the project
194+
2. Create a new branch
190195
3. Commit changes
191196
4. Push to branch
192-
5. Tạo Pull Request
197+
5. Create a Pull Request
193198

194-
## 📄 Giấy phép
199+
## 📄 License
195200

196-
Dự án này được phân phối dưới giấy phép GNU General Public License v3.0. Xem `LICENSE` để biết thêm chi tiết.
201+
This project is distributed under the GNU General Public License v3.0. See `LICENSE` for more details.
197202

198-
## Donate? Muốn hỗ trợ mình 1 ly cà phê
199-
> Hãy truy cập liên kết chứa thông tin Donate sau: https://kingsmanvn.pages.dev
203+
## Donate? Want to support me with a coffee?
204+
> Please visit the following link for donation information:<br>
205+
Patreon: [https://www.patreon.com/c/king1x32/posts](https://www.patreon.com/c/king1x32/posts)<br>
206+
Website: [https://kingsmanvn.pages.dev](https://kingsmanvn.pages.dev)
200207

201-
## 🔧 Cài đặt
208+
## 🔧 Download
202209

203-
1. Phiên bản bình thường: [Github](https://github.com/king1x32/UserScripts/raw/main/King_Translator_AI.user.js) hoặc [Greasyfork](https://greasyfork.org/vi/scripts/529348-king-translator-ai)
210+
1. Normal version: [Github](https://github.com/king1x32/UserScripts/raw/main/King_Translator_AI.user.js) or [Greasyfork](https://greasyfork.org/vi/scripts/529348-king-translator-ai)
204211

205-
2. Phiên bản nén (nhẹ hơn, mượt hơn): [Github](https://raw.githubusercontent.com/king1x32/compiledUserscripts/release/release/King20Translator20AI.user.js)
212+
2. Compressed version (lighter, smoother): [Github](https://raw.githubusercontent.com/king1x32/compiledUserscripts/release/release/King20Translator20AI.user.js)
206213

207214
---
208215

209216
<div align="center">
210217
Made with ❤️ by King1x32
211218
<br>
212-
<a href="https://github.com/king1x32">GitHub</a>
213-
<a href="https://discord.gg/v2DsBW6d">Discord</a> •
219+
<a href="https://www.patreon.com/c/king1x32/posts">Patreon</a>
220+
<a href="https://discord.gg/8DTwr8QpsM">Discord</a> •
214221
<a href="https://t.me/king1x32">Telegram</a>
215222
</div>

0 commit comments

Comments
 (0)