Skip to content

Latest commit

 

History

History
145 lines (104 loc) · 8.86 KB

README.en.md

File metadata and controls

145 lines (104 loc) · 8.86 KB

GoogleTranslate_IPFinder

GitHub release GitHub Release Date License GitHub stars

简体中文 | English

Project summary

Google Translate API server (translate.googleapis.com) IP address scanning and speed test tool.

Project Background 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.
Disclaimer Please comply with local laws and Google's policies when using this open-source software. All consequences of illegal or unauthorized use are your own responsibility.

Stable version download link:

Preview version (alpha) download links:

About the English translations We noticed 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.

Note

This project has only been tested on Windows 11. If you encounter bugs on other operating systems, please submit an issue.

Due to the limitations of Python, this project does not support Windows 7 or earlier.

Quick Start

Steps for basic usage (speed test + Hosts file update):

  1. Download the executable file for your system (links above).
  2. Open it with administrator/sudo permissions. This is required to use the Hosts file writing feature.
  3. Select "Test" and wait for the operation to complete.
  4. Click "Update hosts," and the Google Translate API will be accessible.

Tip

Difference between "Test" and "Scan":

  • 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.
  • 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.

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.

A demonstration for Windows 11:

Warning

The stability of IPv6 addresses is generally poor, so avoid using them unless absolutely necessary.

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.

If you must use IPv6, it's recommended to set the number of speed tests to the maximum (10) in "Settings > Speed Test."

For discussions on IP availability, see #42.

Feature Comparison

Feature This Project GoogleTranslateIpCheck google-translate-cn-ip ip-scanner gscan_quic
IP Collection ✔️ ✔️ ✔️ ✔️ ❌
IP Scanning ✔️ ✔️ ❌ ✔️ ✔️
IP Speed Test ✔️ ✔️ ✔️ ❌ ❌
Hosts File Write ✔️ ✔️ ❌ ❌ ❌
GUI ✔️ ❌ ❌ ❌ ❌
English Support ✔️ ❌ ❌ ❌ ❌

Running from Source

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).

For Linux:

$ git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
$ cd GoogleTranslate_IPFinder
$ pip3 install PySide6
$ python3 main.py

For non-Linux systems:

git clone https://github.com/GoodCoder666/GoogleTranslate_IPFinder.git
cd GoogleTranslate_IPFinder
pip install -r requirements.txt
python main.py

Development Roadmap

  • IP Speed Test
  • IP Scanning
  • Automatic Hosts File Write
  • Automatic IP List Retrieval
  • Speed Test/Scan Progress Bar
  • Customizable IP Range Scanning

...(If you have other requests, feel free to submit them in the issues).

About Online Syncing

Warning

The following mentioned libraries are designed for use in Mainland China. Consider running a full scan to get available IPs.

This part may be outdated. Please refer to the Chinese README for accurate information.

The official IPv4 address library 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:

Additionally, if GitHub Raw cannot be connected, the program will attempt to use the ghproxy mirror. Please be patient.

License Information

This project is licensed under the GPLv3. The IP scanning logic references gscan_quic.

Similar projects: hcfyapp/google-translate-cn-ip Ponderfly/GoogleTranslateIpCheck csyezheng/ip-scanner.