Skip to content
LowSkillDeveloper edited this page Jan 25, 2024 · 5 revisions

Wiki navigation for Unofficial 3WiFi Locator v2:

Connect to the 3WIFI server directly by IP address (Adding HOST to POST requests to server IP)

Q: What is the purpose of connecting to the 3WIFI server directly by IP?

A: Connecting directly to the 3WIFI server by IP allows the app to bypass potential DNS issues or restrictions, ensuring a more reliable connection. This is particularly useful when the domain name of the server is not accessible due to network restrictions or other issues.

Q: How does adding HOST to POST requests help?

A: By adding the HOST header to POST requests, the app can communicate with the server using its IP address while still ensuring that the request is properly routed to the correct virtual host on the server. This is essential when servers are configured to serve multiple domains.

Q: Can I enable or disable this feature?

A: Yes. This feature can be toggled in the app's settings. Enabling it will add the HOST header (3wifi.stascorp.com) to your POST requests, but only to the this ip adress: 134.0.119.34, if a different ip or domain name is specified, then nothing will be added to the POST request.

Q: Is it safe to connect directly by IP?

A: Yes. It is safer and faster than using a third-party proxy server to forward requests to the main server.

Q: What should I do if I'm unable to connect after enabling this feature?

A: Perhaps the server is completely unavailable or you have problems with your account on the site. Contact the admin in the telegram channel. You can also try disabling adding host in post requests in the settings. If all else fails, try using a third-party proxy server to redirect to the official server.

Q: Will I notice any difference in the app's functionality with this feature enabled?

A: Functionally, the app remains the same. The only difference is in how it connects to the server, which should be seamless to the user.

Q: Is this feature enabled by default?

A: Yes, it is enabled by default, since it does not affect other servers or IP addresses, the setting applies only to ip 134.0.119.34. But you can also turn it off in the settings.

Q: What are the benefits of using an IP address over a domain name?

A: Using an IP address can bypass certain network filters or issues with DNS resolution, potentially resulting in a more stable and faster connection to the server.


Server List

Q: What is the Server List feature?

A: The Server List feature provides a selection of servers on the app's main page, including the main server and a backup proxy server. This ensures reliable connectivity, especially when direct access to the main server is problematic.

Q: Where does the app get its list of servers?

A: The list is fetched from a servers.json file within our GitHub repository. You can view it here.

Q: Can I see which server is currently selected?

A: Yes. The current server is shown on the start page above the dropdown menu.

Q: Can I add my own server to the list?

A: Absolutely! You can add your preferred server by choosing “Enter your server” in the app's menu. However, this only adds the server to your application. You cannot add your server to the list that is loaded from our repository.

Q: Will the server that I enter in the server field in the application settings appear in this list?

A: No, they won't. The servers added in the app settings are separate and do not automatically sync with the server list on the main page.

Q: How do I manage the server list?

A: You can manage the server list using a button at the bottom of the start page, allowing you to clear or refresh the list as needed.

Q: What happens to the server list when I'm offline?

A: In offline mode, the app will only display the main hardcoded server in the list.


Double Scanning Feature

Q: What is the Double Scanning feature?

A: The Double Scanning feature is a functionality that performs two consecutive network scans, each separated by an interval of 4 seconds. After these scans, the results are merged into one comprehensive list, providing a broader range of detected networks.

Q: How does the Double Scanning feature improve network detection?

A: By performing two scans in quick succession, the app can potentially pick up on networks that might have been missed in a single scan. This increases the chances of detecting more networks in your vicinity.

Q: Is the Double Scanning feature enabled by default?

A: No, the Double Scanning feature is disabled by default.

Q: How can I enable the Double Scanning feature?

A: To enable it, go to the app's settings: Settings -> Locator Settings. There, you'll find the option to turn on the Double Scanning feature.

Q: Will enabling the Double Scanning feature slow down the app?

A: Yes. At a minimum, the scanning time will double, and a 4-second wait between scans will be added. Plus it takes time to compare the lists and put them into one, but this doesn’t slow down the process much.


Local WiFi Database (Network History)

Q: What is the Local WiFi Database (Networks History)?

A: This is a feature that stores a history of networks data discovered in 3wifi for networks you've scanned. It creates a local database within the app, saving networks when you find relevant data in 3wifi.

Q: Is there an option to disable automatic data addition from 3wifi to the local database?

A: Yes, there is a switch in the settings to disable the automatic addition of data received from 3wifi to the local database.

Q: Can I import and export data from the local database?

A: Yes, you can export and import the entire database to and from a JSON file. Exported files are saved in the smartphone's download folder.

Q: Is there an option for manually adding data to the database?

A: Absolutely! You can manually add network details to the database, providing greater flexibility in managing your network information.

Q: What interactions are possible with networks in the database?

A: The database allows various interactions, including WPS generation, WPS connection, and copying ESSID, among other functionalities.

Q: Does the database include login and password columns for router admin panels?

A: Yes, there are added columns for router admin panel login and password. These can be filled manually or imported from a routerscan TXT file.

Q: Can I import data from RouterScan or myuploads.txt from 3wifi?

A: The app supports importing TXT files from RouterScan and myuploads.txt from 3wifi site. It's even capable of handling large myuploads.txt files containing more than 100K lines. But adding such an amount may take 5 minutes and if you already have records in the database, it may take longer, since each added record will be checked for duplicates.

Q: Can I edit entries in the Local WiFi Database?

A: Yes, the app provides the option to edit any entry in the Local WiFi Database.

Q: Is there an option for a complete database reset?

A: Definitely. If you need to start fresh, there's a feature to completely clear out the entire database, removing all previously stored data.

Q: What are the options available when importing data into the database?

A: When importing data, you have two choices:

  1. Clear and Import: This option will first clear the existing database and then import new data from the selected file.
  2. Append Without Duplicates: With this choice, new records are added to the existing database, and the app ensures that duplicates are not added.

Q: Can I disable the automatic check in the local database after an online 3wifi check?

A: Another switch in the settings allows you to disable the automatic check in the local database after conducting an online 3wifi check.


Dark Theme Mode

Q: What is the Dark Theme mode?

A: The Dark Theme mode is a visual option that changes the app's interface to a darker color palette.

Q: How do I enable the Dark Theme mode?

A: To enable the Dark Theme, go to the app settings. Here's the path: Settings -> Locator Settings. In this section, you'll find the option to switch to the Dark Theme.

Q: Is the Dark Theme mode enabled by default?

A: No, the Dark Theme mode is not enabled by default.


3WiFi API Keys Display

Q: Why was the API key display feature added?

A: Due to recent access issues with the 3WiFi site and problems logging into user accounts, some users faced challenges in retrieving their API keys. To tackle this, I've integrated a feature in the app that displays the received keys from the 3WiFi server and includes a handy copy button for ease of use.

Q: Where can I find my 3WiFi API keys in the app?

A: Your API keys are conveniently located on the "User info" page. Additionally, you can also find them in the app's settings under the "Other Settings" section.

Q: How can I copy my API keys?

A: Next to your displayed API keys, there's a "Copy" button. Simply click on this button to copy the keys to your clipboard, making it easy to use them wherever needed.


Offline Vendor Database

Q: What is the Offline Vendor Database?

A: The Offline Vendor Database is a built-in feature in the 3WiFi Locator app that provides information about the router vendor. It's particularly useful when there's no internet connection or when online vendor information retrieval faces issues.

Q: When does the Offline Vendor Database come into play?

A: This database is always functional. It activates regardless of your online status, ensuring you have access to vendor information at all times.

Q: Where is the vendor information displayed in the app?

A: The vendor details obtained from the Offline Vendor Database are displayed on the WPS PIN Generator page.

Q: Can I turn off the Offline Vendor Database?

A: The Offline Vendor Database is a permanent feature of the app and cannot be turned off.

Q: Does the Offline Vendor Database require regular updates?

A: No. Updates occur rarely and only come with a full application update.


Offline Mode Button

Q: What is the Offline Mode Button?

A: The Offline Mode Button is a feature in the 3WiFi Locator app that allows users to use the app effectively even without an internet connection.

Q: Why was the Offline Mode Button reintroduced?

A: In earlier versions, the Offline Mode Button was a part of the app. However, it was unintentionally removed during a redesign and the migrated from Java to Kotlin by drygdryg. Recognizing its importance, especially in light of recent connectivity issues, the button has been brought back.

Q: Where can I find the Offline Mode Button?

A: The Offline Mode Button is conveniently located in the start menu of the app, making it easily accessible for users to switch to offline mode as needed.


Application Update Check Feature

Q: What is the Application Update Check feature?

A: The Application Update Check is a feature that automatically checks for updates to the app upon startup. It ensures that users always have the latest version with all the new features and bug fixes.

Q: Is there a way to manually check for updates?

A: Yes, besides the automatic check at startup, users can manually check for updates through a dedicated button in the app settings.

Q: How can I disable the automatic update check on startup?

A: To disable this automatic check, go to Settings -> Locator Settings in the app. Here, you can toggle off the option for automatic update checks.

Q: Where does the app check for new updates and download changelogs?

A: The app checks for new versions and downloads changelogs directly from our GitHub repository. This is done through the update.json file, which you can view here: update.json.

Q: Where does the update link direct to?

A: The link for downloading the new version directs users to the 'releases' page of our GitHub repository, found here: releases. This link is hardcoded into the app, ensuring that users always get a safe and direct link to our official repository, with no external or third-party resources involved.


Account Logout Buttons

Q: What has changed with the account logout buttons?

A: Initially, the app had a single logout button located at the root of the settings. Now, we've added more logout buttons for easier access. These are located on the 'Account Information' page and in the 'Other Settings' section.

Q: Why were additional logout buttons added?

A: The addition of these buttons is to provide more convenience and flexibility. It makes logging out of your account more accessible, without having to navigate back to the main settings menu.

Q: Will the functionality of logging out be different in these locations?

A: No, the functionality remains the same regardless of which logout button you use.

Clone this wiki locally