mirror of
https://github.com/Stone-Red-Code/HotspotAutoLogin.git
synced 2026-11-01 23:05:40 +01:00
Stone_RedandClaude Opus 5.5
12c5808dd0
- "Check Now" in the tray menu and in the log window ends the current wait (the check_every_second interval, the auto mode network wait and the session expiry wait), so the connection is checked and the login is sent right away if needed. - Document it in the README. Co-Authored-By: Claude Opus 5.5 <[email protected]>
130 lines
9.0 KiB
Markdown
130 lines
9.0 KiB
Markdown
# HotspotAutoLogin: Automatic Wi-Fi/Ethernet WEB Logins (Automate WEB/Captive Portal Logins)
|
|
HotspotAutoLogin is a script that designed to automate the login process for Wi-Fi or Ethernet networks that require web-based authentication. This script is intended for situations where you often connect to networks that require a web login, such as public hotspots in cafes, hotels, or airports. The script continuously monitors the internet connection and automatically logs you in when necessary.
|
|
|
|
<img title="Profile Selection" src='examples/Profile.png' width='100%'>
|
|
|
|
|
|
|
|
> # [Download the Latest Executable (.exe) Release](https://github.com/denizsafak/HotspotAutoLogin/releases/latest)
|
|
> You can download the executable (.exe) version of the same script, making it easy to use without the need to install Python or other libraries.
|
|
|
|
## `How to Run?`
|
|
|
|
### Option 1: Executable Script
|
|
- If you don't want to install Python, you can download the precompiled executable version from the Releases section.
|
|
[Download the Latest Executable (.exe) Release](https://github.com/denizsafak/HotspotAutoLogin/releases/latest)
|
|
- Double-click on HotspotAutoLogin.exe to launch the application.
|
|
|
|
### Option 2: Run with Python
|
|
- Clone or [download the repository](https://github.com/denizsafak/HotspotAutoLogin/archive/refs/heads/main.zip) to your local machine.
|
|
- Extract from zip.
|
|
- Run "run.bat" file.
|
|
|
|
## `Features`
|
|
- The script will continuously monitor the internet connection. When you connect to the specified SSID but there is no internet access, it will attempt to log in automatically.
|
|
- If you are connected to the correct SSID but lack internet access, the script attempts to log in by sending an POST request to the provided URL with the specified credentials. If the login is successful, the script will continue monitoring.
|
|
- Any important events or actions taken by the script are logged both in a log file (log.txt) and in the log window that can be accessed via the system tray icon.
|
|
- The script reads its configuration from a config.json file. This file contains the necessary information, such as your login credentials, the URL of the authentication portal, the SSID (network name) to which you want to connect, and the frequency of network checks in seconds.
|
|
|
|
## `Auto Mode & Start with Windows`
|
|
- **Auto mode:** Click the **Auto** button in the profile selection window (or run with `--auto`). Instead of using a single profile, the program looks at the network you are actually connected to and picks the matching profile automatically:
|
|
- **Wi-Fi:** the profile whose `ssid` matches the connected Wi-Fi (case-insensitive).
|
|
- **Ethernet:** profiles without an `ssid` are Ethernet profiles. The one whose login `url` is reachable on the current network is used.
|
|
- If the connected network doesn't match any profile, nothing is sent and the program just waits for a known network. It never forces a connection to another network in this mode.
|
|
- `config.json` is re-read on every check, so edits apply without restarting.
|
|
- **Start with Windows:** Tick **Start with Windows (Auto)** in the profile selection window. The program will then start at sign-in in Auto mode, in the background (tray icon only). Untick it to disable. This uses the current user's `Run` registry key, so no admin rights are needed.
|
|
- Command line flags: `--auto` (skip profile selection, use Auto mode) and `--background` (don't open the log window at startup). E.g. `run.bat --auto`.
|
|
|
|
## `Usage`
|
|
- Edit the config.json file with your specific information, including your login credentials, the portal URL, the SSID of the network you want to connect to, and the check interval in seconds. [Click to learn how to Configure the config.json](#how-to-configure-the-configjson)
|
|
- When you run the script, a system tray icon will appear. Right-click on the icon to access options like showing the log or exiting the application.
|
|
- To check the connection right away instead of waiting for the next check, click **Check Now** in the tray menu or in the log window. If the internet is down, it logs in immediately.
|
|
- You can view the log of the script's actions by clicking the "Show Log" option in the system tray menu.
|
|
|
|
## `How to Configure the config.json?`
|
|
> [!TIP]
|
|
> I recently, added "Add new" button to the program, so you can achieve the same thing without needing to edit the config.json.
|
|
|
|
|
|
|
|
1) When you're in the web login page, open your browser's Developer Tools. (You can press F12 or Ctrl + Shift + I (or Cmd + Option + I on Mac) to open the Developer Tools. Alternatively, you can right-click anywhere on the page and select "Inspect" or "Inspect Element.")
|
|
2) **Navigate to the Network Tab:** In the Developer Tools, click on the "Network" tab.
|
|
3) **Trigger the POST Request:** Perform the action that sends the POST request. <ins>**(You can try to login with incorrect password)**</ins>. The network tab will capture all network requests made by the page, including your POST request.
|
|
4) **Locate the POST Request:** You need to find yours. Look for the POST request in the list of network requests. It will typically have a method of "POST" and the URL it was sent to.
|
|
|
|
`"payload":` Go to "Payload" tab and enter the payload values here.
|
|
|
|
|
|
|
|
`"url":` Enter the "Request URL" in the "Headers" tab here.
|
|
|
|
`"internet_check_url":` URL to check your internet connection. Program will try to access this address to check if you have internet connection. If 8.8.8.8 is accessible **before** you log into your network, change this.
|
|
|
|
|
|
|
|
|
|
`"ssid":` This is your network's SSID. For example "MyHome_5G" **(If you are using a wired (ethernet) connection, you don't need to enter ssid**
|
|
|
|
`"check_every_second":` The frequency of the script for checking your internet connection status. For example "100", it will try to check the internet every 100 seconds.
|
|
|
|
`"session_hours":` *(optional)* If your network logs you out a fixed time after logging in (for example every 24 hours), enter that here, e.g. `24`. The program remembers when it last logged in (in `session_state.json`) and checks the connection every 5 seconds from 2 minutes before the expected expiry until 10 minutes after it, so you are logged back in within seconds instead of waiting for the next `check_every_second` check.
|
|
|
|
> ## Example useage:
|
|
>
|
|
|
|
```json
|
|
{
|
|
"profiles": [
|
|
{
|
|
"name": "Example Wi-Fi",
|
|
"ssid": "EXAMPLE_WIFI_5G",
|
|
"url": "https://connect.schoolwifi.com/api/portal/dynamic/authenticate",
|
|
"internet_check_url": "8.8.8.8",
|
|
"payload": {
|
|
"username": "[email protected]",
|
|
"password": "123455678"
|
|
},
|
|
"headers": {
|
|
"Content-Type": "application/json;charset=UTF-8",
|
|
"Connection": "keep-alive",
|
|
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3"
|
|
},
|
|
"check_every_second": 600,
|
|
"dialog_geometry": {
|
|
"width": 1024,
|
|
"height": 500
|
|
}
|
|
},
|
|
{
|
|
"name": "Example ETHERNET",
|
|
"url": "http://10.3.41.15:8002/index.php?zone=dormnet",
|
|
"payload": "&auth_user=85795013%40myschool.com&auth_pass=123455678&redirurl=&accept=Login",
|
|
"internet_check_url": "8.8.8.8",
|
|
"headers": {
|
|
"Content-Type": "application/x-www-form-urlencoded",
|
|
"Connection": "keep-alive",
|
|
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 Edg/118.0.2088.69"
|
|
},
|
|
"check_every_second": 600,
|
|
"dialog_geometry": {
|
|
"width": 1024,
|
|
"height": 500
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
|
|
> [!CAUTION]
|
|
> Recent Windows updates restricts third-party apps from accessing Wi-Fi names unless location services are enabled. To fix this, turn on location services in your settings. For more details, check the article from 04/02/2024 [Changes to API behavior for Wi-Fi access and location](https://learn.microsoft.com/en-us/windows/win32/nativewifi/wi-fi-access-location-changes).
|
|
|
|
> [!NOTE]
|
|
> - The script relies on the assumption that the web portal uses basic authentication. If the portal uses a more complex login mechanism, additional adjustments may be necessary.
|
|
> - This script is primarily intended for Windows. Adaptations might be needed for other operating systems.
|
|
|
|
## Disclaimer
|
|
> Use this script responsibly and only on networks where you have the right to access and use the provided services. Unauthorized access to networks is illegal and unethical.
|
|
|
|
> Tags: Auto Connect WiFi, Wifi Login Wizard, Wifi Auto Login, Auto Hotspot Login, Hotspot Auto Connect, Hotspot Automator, Auto Hotspot Sign In, Wifi Auto Sign In, Web Login Automator, WiFi Login Automator, Hotspot Login Automator, WEB Portal Auto Login, Quick Hotspot Connect
|