Skip to content

Commit d6b94a3

Browse files
committed
docs: update READMEs
1 parent 84ae80c commit d6b94a3

2 files changed

Lines changed: 23 additions & 35 deletions

File tree

README.en.md

Lines changed: 12 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ An IP address scanner and speed testing tool for the Google Translate API server
2121
When using this open-source software, please comply with local laws and regulations, as well as relevant Google policies. <strong>You are solely responsible for any consequences arising from illegal or non-compliant use.</strong>
2222
</details>
2323

24-
If you are using Windows or macOS, you can download the pre-built releases directly here:
24+
If you are using Windows or macOS, you can download the latest pre-built releases directly here:
2525

2626
- [https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases)
2727

@@ -43,21 +43,19 @@ For Windows, we provide two versions with identical functionality but different
4343
4444
## Quick Start
4545

46-
Standard usage steps (Speed test + Write to Hosts):
46+
Standard usage steps:
4747

48-
1. Download the executable file for your respective system (links above).
49-
2. Open with administrator/sudo privileges. **This is required to use the Write to Hosts feature.**
50-
3. Select "Speedtest" and wait for the operation to complete.
51-
4. Click "Write to Hosts", and the Google Translate API will function normally.
48+
1. Download the executable file for your OS from the Releases page (links above).
49+
2. Run the program. If you plan to update your Hosts file in step 4, please manually run the program with elevated privileges.
50+
3. Select "Speedtest", and the program will find the IP address with the lowest latency.
51+
4. (Optional) If you wish to optimize custom network resolution, click "Write to Hosts" and confirm the changes in the pop-up window that appears.
5252

5353
> [!TIP]
5454
>
5555
> Difference between "Speed Test" and "Scan":
5656
>
5757
> - **Speed Test**: Finds available IPs from the IPs to be tested (i.e., the IP library) and sorts them by response time. After this operation is complete, you can write the results to your Hosts file.
58-
> - **Scan**: Finds available IPs from GWS IP ranges and puts them into the IP library. *Because the GWS network is extremely large, scanning even a small preset portion usually takes a long time.*
59-
>
60-
> Generally, after starting the program, you can directly select "Speed Test" (using the default IP library) and then write to Hosts to restore the Google Translate web service.
58+
> - **Scan**: Finds available IPs from selected IP ranges and puts them into the IP library. *Because the GWS network is extremely large, scanning even a small preset portion usually takes a long time.*
6159
6260
Windows 11 system demonstration:
6361

@@ -77,13 +75,13 @@ Windows 11 system demonstration:
7775

7876
Running from source code is applicable to all operating systems that support graphical interfaces. It requires Python >= 3.10 (3.12 and above is recommended).
7977

80-
For Linux systems:
78+
For Linux:
8179

8280
```bash
83-
$ git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
84-
$ cd GoogleTranslate_IPFinder
85-
$ pip3 install PySide6 aiohttp
86-
$ python3 run.py
81+
git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
82+
cd GoogleTranslate_IPFinder
83+
pip3 install PySide6 aiohttp
84+
python3 run.py
8785
```
8886

8987
For non-Linux systems:
@@ -103,10 +101,6 @@ The [Official IPv4 Address Library](https://github.com/GoodCoder666/gtdb) is bui
103101
* Extended IPv4: https://raw.githubusercontent.com/Ponderfly/GoogleTranslateIpCheck/master/src/GoogleTranslateIpCheck/GoogleTranslateIpCheck/ip.txt
104102
* Extended IPv6: https://raw.githubusercontent.com/Ponderfly/GoogleTranslateIpCheck/master/src/GoogleTranslateIpCheck/GoogleTranslateIpCheck/IPv6.txt
105103

106-
There is also a newly included [Super Address Library](https://github.com/GoodCoder666/gtdb/tree/main/full), which is recommended to try when all the above IPs become invalid.
107-
108-
Additionally, if GitHub Raw cannot be connected, the program will attempt to use the [ghproxy](https://ghproxy.net/) mirror. Please be patient.
109-
110104
## License
111105

112106
This project is licensed under the [GPLv3](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/blob/main/LICENSE) license. The IP scanning logic is inspired by [gscan_quic](https://codeberg.org/antigng/gscan_quic).

README.md

Lines changed: 11 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
使用此开源软件时,请您遵守当地法律法规以及 Google 的相关规定。<strong>一切违法/违规用途后果自负。</strong>
2222
</details>
2323

24-
若您使用 Windows 或 Mac OS 系统,可以直接在这里下载打包好的版本
24+
若您使用 Windows 或 macOS 系统,可以直接在这里下载打包好的最新版
2525

2626
- [https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases/latest](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases/latest)
2727

@@ -38,21 +38,19 @@
3838
3939
## 快速上手
4040

41-
无特殊需求的使用步骤(测速+写入Hosts)
41+
基本使用步骤
4242

43-
1. 下载对应系统的可执行文件(链接见上方)。
44-
2. 使用管理员/sudo权限打开。**只有这样才能使用 Hosts 写入功能。**
45-
3. 选择“测速”,等待操作完成
46-
4. 点击“写入Hosts”,谷歌翻译 API 即可正常使用
43+
1. 从 Releases 下载对应系统的可执行文件(链接见上方)。
44+
2. 运行程序。若需要第四步更新 Hosts,请手动提权执行。
45+
3. 选择“测速”,程序会找到延迟最低的 IP
46+
4. (可选)若您希望优化自定义网络解析,请点击“写入Hosts”,并在随后的弹窗中确认修改
4747

4848
> [!TIP]
4949
>
5050
> 区分“测速”和“扫描”:
5151
>
5252
> - **测速**:从待测速的 IP(即 IP 库)中找出可用 IP,并按照响应时间排序。此操作完成后可以写入 Hosts。
53-
> - **扫描**:从 GWS 的 IP 段中找到可用的 IP,并置于 IP 库中。*由于 GWS 网络极为庞大,即使是扫描预设的一小部分通常也需要很长时间。*
54-
>
55-
> 一般来说,启动程序后直接选择“测速”(使用默认 IP 库)再写入 Hosts 即可恢复谷歌翻译网络服务。
53+
> - **扫描**:从选择的 IP 段中找到可用的 IP,并置于 IP 库中。*由于 GWS 网络极为庞大,即使是扫描预设的一小部分通常也需要很长时间。*
5654
5755
Windows 11 系统演示如下:
5856

@@ -75,10 +73,10 @@ Windows 11 系统演示如下:
7573
对于 Linux 系统:
7674

7775
```bash
78-
$ git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
79-
$ cd GoogleTranslate_IPFinder
80-
$ pip3 install PySide6 aiohttp
81-
$ python3 run.py
76+
git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
77+
cd GoogleTranslate_IPFinder
78+
pip3 install PySide6 aiohttp
79+
python3 run.py
8280
```
8381

8482
对于非 Linux 系统:
@@ -98,10 +96,6 @@ python run.py
9896
- 扩展 IPv4:https://raw.githubusercontent.com/Ponderfly/GoogleTranslateIpCheck/master/src/GoogleTranslateIpCheck/GoogleTranslateIpCheck/ip.txt
9997
- 扩展 IPv6:https://raw.githubusercontent.com/Ponderfly/GoogleTranslateIpCheck/master/src/GoogleTranslateIpCheck/GoogleTranslateIpCheck/IPv6.txt
10098

101-
另有新收录的[超级地址库](https://github.com/GoodCoder666/gtdb/tree/main/full),建议在上面的所有 IP 全部失效时尝试。
102-
103-
同时,若 GitHub Raw 无法连接,程序将尝试使用 [ghproxy](https://ghproxy.net/) 镜像,请耐心等待。
104-
10599
## 版权说明
106100

107101
本项目使用 [GPLv3](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/blob/main/LICENSE) 版权许可。IP 扫描逻辑参考 [gscan_quic](https://codeberg.org/antigng/gscan_quic)

0 commit comments

Comments
 (0)