You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Moved core and UI code into `src/`.
- Moved assets and generated files into `resources/` and `src/ui/generated/`.
- Added `run.py` as entry point and `build_ui.py` for Qt compilation.
- Updated docs and GitHub Actions workflow.
Google Translate API server (`translate.googleapis.com`) IP address scanning and speed test tool.
16
+
An IP address scanner and speed testing tool for the Google Translate API server (`translate.googleapis.com`) in mainland China.
17
17
18
18
<details>
19
19
<summary>Project Background</summary>
20
-
Google stopped providing translation services on mainland China GWS servers in September 2022. This project aims to help users find usable GWS IPs and override local domain name resolution to access Google Translate servers.
20
+
Google stopped translation services on GWS servers in mainland China in September 2022. This project aims to help users find usable GWS IPs for translation and override local DNS resolution results to regain access to Google Translate servers.
21
21
</details>
22
22
23
23
<details>
24
24
<summary>Disclaimer</summary>
25
-
Please comply with local laws and Google's policies when using this open-source software. <strong>All consequences of illegal or unauthorized use are your own responsibility.</strong>
25
+
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>
- Mac OS: [https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases/download/alpha/checker-mac.zip](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/releases/download/alpha/checker-mac.zip)
36
36
37
37
<details>
38
38
<summary>About the English translations</summary>
39
-
We <a href="https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/38">noticed</a> that the tool might also be helpful in other countries/regions, thus English translations are added on 21 Sep, 2024. This document is mostly translated with ChatGPT and the UI is translated all by myself. Feel free to open an issue if something is wrong.
39
+
We <a href="https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/38">noticed</a> that the tool might also be helpful in other countries/regions, thus English translations are added on 21 Sep, 2024. This document is mostly translated with <strong>Gemini 3.1 Pro</strong> and the UI is translated all by myself. Feel free to open an issue if something is wrong.
40
40
</details>
41
41
42
-
43
42
> [!NOTE]
44
43
>
45
-
> **This project has only been tested on Windows 11.** If you encounter bugs on other operating systems, please [submit an issue](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/new).
44
+
> **This project has only been tested on Windows 11.** If the program does not work properly on other operating systems, please [open an issue](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/new).
46
45
>
47
-
> *Due to the limitations of Python, this project does not support Windows 7 or earlier.*
46
+
> *Due to Python limitations, this project does not support Windows 7 and below.*
48
47
49
48
## Quick Start
50
49
51
-
Steps for basic usage (speed test + Hosts file update):
50
+
Standard usage steps (Speed test + Write to Hosts):
52
51
53
-
1. Download the executable file for your system (links above).
54
-
2. Open it with administrator/sudo permissions. **This is required to use the Hosts file writing feature.**
55
-
3. Select "Test" and wait for the operation to complete.
56
-
4. Click "Update hosts," and the Google Translate API will be accessible.
52
+
1. Download the executable file for your respective system (links above).
53
+
2. Open with administrator/sudo privileges. **This is required to use the Write to Hosts feature.**
54
+
3. Select "Speedtest" and wait for the operation to complete.
55
+
4. Click "Write to Hosts", and the Google Translate API will function normally.
57
56
58
57
> [!TIP]
59
58
>
60
-
> Difference between "Test" and "Scan":
59
+
> Difference between "Speed Test" and "Scan":
61
60
>
62
-
> -**Test**: Identifies usable IPs from the available IPs (IP library) and sorts them by response time. Once this process is complete, you can write to the Hosts file.
63
-
> -**Scan**: Finds usable IPs from the GWS IP range and adds them to the IP library. *Since the GWS network is very large, scanning even a small preset part often takes a long time.*
61
+
> -**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.
62
+
> -**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.*
64
63
>
65
-
> Generally, just start the program, select "Test" (using the default IP library), and then write to the Hosts file to restore access to Google Translate services.
64
+
> 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.
66
65
67
-
A demonstration for Windows 11:
66
+
Windows 11 system demonstration:
68
67
69
68
70
69
71
70
> [!WARNING]
72
71
>
73
-
> **The stability of IPv6 addresses is generally poor, so avoid using them unless absolutely necessary.**
72
+
> **The stability of IPv6 addresses is generally poor; try to avoid using them unless absolutely necessary.**
74
73
>
75
-
> Considering IP stability, all IPs must pass at least 3 tests before they appear in the speed test results by default. If you want to verify the stability of a single IP, use the "Debug" feature.
74
+
> Considering IP stability issues, under default settings, all IPs must pass at least 3 tests before being displayed in the speed test results. If you want to verify the stability of a single IP, please use the "Debug" feature.
76
75
>
77
-
> If you must use IPv6, it's recommended to set the number of speed tests to the maximum (10) in "Settings > Speed Test."
76
+
> If you must use IPv6, it is recommended to adjust the test count to the maximum value of 10 under "Settings > Speedtest".
78
77
>
79
-
> For discussions on IP availability, see [#42](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/42).
80
-
81
-
## Feature Comparison
82
-
83
-
| Feature | This Project |[GoogleTranslateIpCheck](https://github.com/Ponderfly/GoogleTranslateIpCheck)|[google-translate-cn-ip](https://github.com/hcfyapp/google-translate-cn-ip)|[ip-scanner](https://github.com/csyezheng/ip-scanner)|[gscan_quic](https://codeberg.org/antigng/gscan_quic)|
> For discussions regarding IP availability issues, please refer to [#42](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues/42).
91
79
92
-
## Running from Source
80
+
## Running from Source Code
93
81
94
-
Running from source works on any operating system with a graphical interface, as long as Python >= 3.6 is installed (with the additional `PySide6` package).
82
+
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).
...(If you have other requests, feel free to submit them in the [issues](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues)).
111
+
...(If you have other feature requests, feel free to raise them in [issues](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/issues))
124
112
125
-
## About Online Syncing
113
+
## About the Online Sync Feature
126
114
127
-
> [!WARNING]
128
-
>
129
-
> The following mentioned libraries are designed for use in Mainland China. Consider running a full scan to get available IPs.
130
-
>
131
-
> This part may be outdated. Please refer to the Chinese README for accurate information.
115
+
The [Official IPv4 Address Library](https://github.com/GoodCoder666/gtdb) is built into the program and is updated periodically alongside feature updates. You can sync the latest IP library via `Import -> Online Services`. Additionally, two IP libraries from GoogleTranslateIpCheck are provided as options (Thanks to @Ponderfly). The URLs for the three libraries are as follows:
132
116
133
-
The [official IPv4 address library](https://github.com/GoodCoder666/gtdb) is built into the program and is periodically updated with new features. You can sync the latest IP library via `Import -> Online service`. Two IP libraries from GoogleTranslateIpCheck are also available (thanks to @Ponderfly). The URLs of the three libraries are as follows:
117
+
* Official IPv4: https://raw.githubusercontent.com/GoodCoder666/gtdb/main/src/ip.txt
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.
138
122
139
123
Additionally, if GitHub Raw cannot be connected, the program will attempt to use the [ghproxy](https://ghproxy.net/) mirror. Please be patient.
140
124
141
-
## License Information
125
+
## License
142
126
143
-
This project is licensed under the [GPLv3](https://github.com/GoodCoder666/GoogleTranslate_IPFinder/blob/main/LICENSE). The IP scanning logic references[gscan_quic](https://codeberg.org/antigng/gscan_quic).
127
+
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).
144
128
145
-
Similar projects: [hcfyapp/google-translate-cn-ip](https://github.com/hcfyapp/google-translate-cn-ip)[Ponderfly/GoogleTranslateIpCheck](https://github.com/Ponderfly/GoogleTranslateIpCheck)[csyezheng/ip-scanner](https://github.com/csyezheng/ip-scanner).
129
+
Similar projects: [hcfyapp/google-translate-cn-ip](https://github.com/hcfyapp/google-translate-cn-ip)| [Ponderfly/GoogleTranslateIpCheck](https://github.com/Ponderfly/GoogleTranslateIpCheck)| [csyezheng/ip-scanner](https://github.com/csyezheng/ip-scanner)
0 commit comments