Skip to content

Commit ce78863

Browse files
committed
+ new preview and readme
1 parent 00530cc commit ce78863

File tree

2 files changed

+57
-11
lines changed

2 files changed

+57
-11
lines changed

README.MD

+57-11
Original file line numberDiff line numberDiff line change
@@ -66,11 +66,22 @@ Now run it with
6666

6767
## Or build it yourself
6868

69-
Install [go](https://go.dev/doc/install) and [git](https://git-scm.com/downloads)
69+
1. **Install Prerequisites:**
70+
- [Go](https://go.dev/doc/install)
71+
- [Git](https://git-scm.com/downloads)
7072

71-
Now open your terminal & clone the project with
73+
2. **Clone the Project:**
74+
Open your terminal and run:
75+
`git clone https://github.com/Kuucheen/KC-Checker.git`
7276

73-
`git clone https://github.com/Kuucheen/KC-Checker.git`
77+
3. **(OPTIONAL) Set Up GeoLite2 Database:**
78+
If you want to determine the country and type (ISP, Datacenter, or Residential), you'll need to download the [GeoLite2 Country and GeoLite2 ASN Database](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) from MaxMind.
79+
80+
- After downloading, replace the existing databases in the `helper` directory.
81+
- Ensure they have the same names: `GeoLite2-ASN.mmdb` and `GeoLite2-Country.mmdb`.
82+
83+
> [!NOTE]
84+
> These databases are not included in the repository due to their licensing restrictions. However, they are bundled in the [prebuilt version](https://github.com/Kuucheen/KC-Checker/releases/).
7485
7586
**Build**
7687
<details>
@@ -110,9 +121,22 @@ Build with
110121
Now you have an executable. You can run it like described in **Getting Started**
111122
</details>
112123

124+
# How to Use
125+
126+
**Navigation**: Use the arrow keys on your keyboard to navigate through the program:
127+
128+
↑ Up
129+
↓ Down
130+
← Left
131+
→ Right
132+
Press Enter (↵) to select/confirm
133+
134+
**Saving Proxies**: When you save the proxies, they will always be stored in the `output` folder.
135+
113136
# Customize Settings
114137

115-
Note: Normally you don't have to change these settings
138+
> [!NOTE]
139+
> For most users, the default settings will probably be sufficient.
116140
117141
<details>
118142
<summary>Details for settings.json</summary>
@@ -129,31 +153,53 @@ Note: Normally you don't have to change these settings
129153
4. **privacy_mode**: <br>
130154
If set to true, the proxies will be blured with "*" while checking
131155

132-
5. **iplookup**: <br>
133-
A website that returns the <a href="https://de.wikipedia.org/wiki/Internet_Protocol">ip</a><br>
156+
5. **autoSelect**: <br>
157+
When setting one or more protocols are set to true, it will automatically start checking with the selected protocols.
158+
159+
6. **autoSave**: <br>
160+
**timeBetweenSafes**: Seconds between the autoSave<br>
161+
**ip:port**: If set to true it will automatically save the proxies with these format every timeBetweenSafes seconds<br>
162+
**protocol://ip:port**: Same here<br>
163+
**ip:port;time**: Same here<br>
164+
**custom**: You can set a custom autoSave format here. If its not empty it will save it with this format. At the end of a checking process theres an option for "CUSTOM", where you can build your own output. You can put the output you built there in here.<br>
134165

135-
6. **judges_threads**: <br>
166+
7. **timeBetweenRefresh**: <br>
167+
This is how often the screen updates in ms. If you experience high CPU usage, it is recommended to set it higher.
168+
169+
8. **iplookup**: <br>
170+
A website that returns the <a href="https://de.wikipedia.org/wiki/Internet_Protocol">ip</a>. This is needed to know if the proxies are Transparent. The website will only be used once when starting the checker.
171+
172+
9. **judges_threads**: <br>
136173
Maximum threads for selecting the judge
137174

138175
7. **judges_timeout**: <br>
139176
Timeout duration of judges in ms
140177

141178
8. **judges**: <br>
142-
Websites that returns the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers">headers</a> of the request<br>
179+
These websites are the sites the proxies will connect to. These have to return the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers">headers</a> of the request so the checker can determine what anonymity level the proxy is.
143180

144181
9. **blacklisted**:<br>
145-
Websites that contain blacklisted ips. These ips won't be checked<br>
182+
Websites that contain blacklisted ips. These ips won't be checked
146183

147184
10. **bancheck**: <br>
148-
If here's a website the program will check if the proxy is able to reach the site. These will land in the `banchecked` directory<br>
185+
If here's a website the program will check if the proxy is able to reach the site. These will land in the `banchecked` directory.
149186

150187
11. **keywords**: <br>
151-
It will check if the website the proxy has opened contains the text given<br>
188+
It will check if the website the proxy has opened contains the text given
189+
190+
12. **transport**: <br>
191+
These are the settings used for making a request. Only touch this option if you know what you are doing.
152192

153193
</details>
154194

155195
You can blacklist custom proxies by adding them in `blacklisted.txt`
156196

197+
## License
198+
199+
The code for this project is licensed under the [MIT License](LICENSE).
200+
201+
The GeoLite2 databases used by this project are provided by MaxMind and are licensed under the [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/).
202+
157203
## <p align="center">Other
158204

159205
<div align="center">

assets/preview.gif

19.8 KB
Loading

0 commit comments

Comments
 (0)