Software connection to Wi-Fi via a QR code on Android

Modern mobile devices based on Android have powerful tools for managing wireless networks, which are often hidden from the eyes of the average user. One of these tools is the ability to generate and read QR codes for instant connection to an access point. However, for developers and advanced enthusiasts the question arises: how to implement this process programmatically, bypassing the standard camera or settings interface? The answer lies in a deep understanding of the structure of the data transmitted through the visual marker and the use of system APIs.

The mechanism is based on a special format string that encodes the network SSID, encryption type and password. When you scan such a code, the operating system parses this string and initiates the connection procedure. Understanding this process allows you not only to create your own applications for managing networks, but also to automate the connection of devices in a corporate environment or when setting up a smart home. It is important to distinguish between a standard user action and a software implementation that requires certain access rights.

In this article we will analyze in detail the architecture of Wi-Fi QR codes, methods for generating them through code, and methods for programmatically initiating a connection. We will look at both standard platform tools and specific commands that may be required for debugging or creating custom solutions. Be prepared to dive into the technical details of how network protocols work at the mobile application level.

The architecture and data format of a Wi-Fi QR code

Before moving on to writing the code, you need to clearly understand what exactly is stored inside the image. A QR code for Wi-Fi is not just a picture, but an encoded text string starting with the prefix WIFI:. This line follows a strictly defined syntax that ensures compatibility with the vast majority of scanners and operating systems. An error in one character can make the code unreadable to the device.

The string structure includes several key parameters, separated by semicolons. The main ones are SSID (network name), P (password) and T (authentication type). There may also be a Hparameter indicating the network is hidden, although it is used less frequently. The correct formation of this string is the first and most important step in software implementation.

• 📡 SSID: Network ID, which must exactly match the name of the access point, including letter case.
• 🔐 P: Access password; if the network is open, this parameter may be empty or absent.
• 🛡️ T: Security type, most often WPA, WEP or nopass for open networks.
• 👁️ H: Hidden network flag (true/false), used for specific configurations.

An example of a correctly formed string for a network with WPA encryption looks like this:

WIFI:T:WPA;S:MyNetworkName;P:MySecretPassword;;

Note the double semicolon at the end of the line - this is a required terminator indicating the end of the data. Ignoring this rule will result in the scanner not being able to correctly interpret the payload. It is critical for the developer to escape special characters if they appear in the network name or password, since the semicolon is a delimiter.

⚠️ Attention: Special characters (such as semicolons, backslashes, or quotes) inside the SSID or password must be escaped with a backslash (\), otherwise the parser will abort reading lines ahead of time.

Generating a QR code programmatically

To create a QR code image directly inside an Android app the most popular and reliable solution is to use the library ZXing (Zebra Crossing). This open library provides a complete set of tools for working with 2D barcodes, including generation and scanning. Integration of ZXing allows you to convert a previously generated string WIFI:... into a graphic object Bitmap.

The generation process begins with initializing the encoder and setting the necessary parameters, such as image size and error correction level. The correction level (L, M, Q, H) determines how much of the code can be damaged or obscured while still being readable. For Wi-Fi codes that are often printed or displayed on screens, it is recommended to use a level M or Q to balance between data density and reliability.

After setting the parameters, the encoding method is called, which returns a matrix of bits. This matrix then needs to be rendered into an image object, which can be displayed in ImageView or save to device memory. It is important to consider that generation occurs in the execution thread, and for complex codes with a large amount of data this can take a noticeable amount of time, so it is better to move the operation to a background thread.

Parameter	Description	Recommended value
ERROR_CORRECTION	Data recovery level	L (7%), M (15%), Q (25%), H (30%)
MARGIN	Size of the white frame around the code	4 (standard value)
CHARACTER_SET	Character encoding	UTF-8 (to support Cyrillic in SSID)
WIDTH	Image width in pixels	Minimum 200x200 for reliable scanning

When working with Cyrillic network names, it is critical to explicitly specify the encoding UTF-8 in the generator settings. By default, some implementations may use ISO-8859-1, which will result in a "cracker" when the code is scanned by a device expecting UTF-8. This is a common error due to which the phone cannot find a network with a Russian name.

Reading and parsing code through the camera

The inverse task is reading the code with the device’s camera and extracting connection data from it. In modern versions of Android (starting from 10 and higher), this function is built into the system level via the API CameraX or the standard camera application. However, to create your own application that automatically connects after scanning, you will need to implement logic to parse the received string.

When the camera captures a QR code, the library returns a string of contents. The developer's task is to check whether this line begins with a prefix WIFI:. If the prefix is ​​present, you need to parse the string, dividing it by a semicolon, and extract the values ​​of the keys S:, P: and T:. The received data is then transferred to the Wi-Fi system manager.

It is worth noting that direct connection to the network without user confirmation on new versions of Android is limited by security policies. The system may require the user to explicitly confirm the "Connect to the network..." action, even if the application already has all the data. This is done to prevent hidden surveillance of the user's movements through automatic connections to known access points.

⚠️ Attention: Starting with Android 10, access to real information about connected Wi-Fi networks (SSID, BSSID) for third-party applications is severely limited. You can initiate a connection, but getting a list of available networks programmatically without special privileges is difficult.

Features of working on Android 10+

In versions of Android 10 and higher, the WifiConfiguration class was hidden (deprecated) for third-party developers. Instead, it is recommended to use WifiNetworkSpecifier to request a connection to a specific network.

Using WifiNetworkSpecifier to connect

The modern and correct way to programmatically connect to Wi-Fi on Android is to use the class WifiNetworkSpecifier. This mechanism was introduced to replace legacy methods and provides a more secure interaction with the network stack. It allows an application to request a connection to a network with a specific SSID and credentials, without requiring full rights to manage all Wi-Fi settings.

The process begins by creating a_builder specifier, which is passed the SSID and password (or encryption type for open networks). This specifier is then wrapped in NetworkRequest and passed to ConnectivityManager. The system tries to find a network that meets the requirements and connect to it. Success or failure is reported through the callback interface NetworkCallback.

An important feature of this approach is that the connection initiated through WifiNetworkSpecifier, usually only valid in the context of a given application or as long as the application is active. After the application is terminated or the network is explicitly released, the device can switch to another preferred network. This behavior is different from permanently saving the network in system settings.

WifiNetworkSpecifier specifier = new WifiNetworkSpecifier.Builder
.setSsid("MyNetworkName")
.setWpa2Passphrase("MySecretPassword")
.build;

NetworkRequest request = new NetworkRequest.Builder
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build;

Using this API requires permission CHANGE_NETWORK_STATE in the application manifest. To work with secure networks, you may also need to request location rights, since scanning and connecting to Wi-Fi on Android is closely related to location services. Without these permissions, the connection request will be rejected by the system.

Working with privileged rights and ADB

For scenarios that require full control over the Wi-Fi module, for example, when developing system firmware or IT administration tools, it is possible to use privileged commands. These methods often require root access or signing the application with a system key, which is not available for regular user applications from Google Play.

One ​​such tool is the Command Line ADB (Android Debug Bridge). Through it you can send commands directly to the Wi-Fi service. For example, the command cmd wifi connect-network allows you to initiate a connection by passing the SSID and password as arguments. This is a powerful tool for automating testing or quickly setting up a fleet of devices.

• 🔧 ADB Shell: Allows you to execute commands on behalf of the system if USB debugging is available.
• 📝 Intent filters: Some system settings can be accessed through hidden Intents, but their operation is unstable on different firmware.
• 👑 Root access: Allows you to edit Wi-Fi configuration files directly in /data/misc/wifi/.

When using ADB, the command to connect may look like this:

adb shell cmd wifi connect-network"MyNetworkName""WPA2""MySecretPassword"

This method bypasses many of the limitations imposed on regular applications, but requires physical access to the device or prior debugging setup. It is ideal for zero-touch scenarios when deploying devices in enterprises where the administrator has full control over the infrastructure.

⚠️ Attention: Command line interfaces (cmd wifi) may change between Android versions. What works on Android 11 may be removed or changed in Android 14. Always check the documentation for your specific OS version.

Frequent problems and connection debugging

Despite its apparent simplicity, the process of software connection to Wi-Fi via QR code can face a number of problems. One of the most common is incompatibility of encryption types. If the QR code specifies the type WPA, and the network actually uses WPA2 or WPA3, some older parsers may not be able to handle the connection, although modern devices can usually auto-detect the protocol.

Another common problem is related to the length and complexity of the password. The Wi-Fi QR code specification does not impose strict restrictions on password length, but some older scanners may cut off the line or handle special characters incorrectly. When generating codes for corporate networks using clear passwords, it is recommended to conduct a test scan on various device models.

It is also worth considering the influence of energy-saving modes. On many smartphones, aggressive battery settings can block the network scanner from running in the background or interrupt the connection process if the application goes into the background during a handshake with the access point. To debug such situations, it is useful to use system logs via logcat, filtering messages by tag WifiService.

The table below shows the main error codes and their possible causes that you may encounter during a software connection:

Code/Message	Probable cause	Solution method
NETWORK_NOT_AVAILABLE	SSID not found within the radius actions	Check whether Wi-Fi is turned on and the proximity of the router
AUTHENTICATION_FAILURE	Incorrect password or encryption type	Recheck the WIFI line:... and character escaping
DISABLED	The network is saved, but disabled by the user	Use the enableNetwork method or forget the network
IP_FAILED	Failure to obtain an IP address (DHCP)	Problems with the router or static IP in the settings

For in-depth diagnostics, it is recommended to use the developer mode on Android by enabling the "Wi-Fi logging" option (Wi-Fi Verbose Logging). This will allow you to obtain detailed information about each stage of the association process with the access point, which is indispensable when searching for the reasons for connection failure.

Questions and answers (FAQ)

Is it possible to connect a phone to Wi-Fi by simply showing it a QR code from the screen of another phone?

Yes, this is a standard feature of Android 10 and above. You don't need to write code for this: just open the Wi-Fi settings on a device that's already connected, click on the gear next to the network and select Share (or the QR icon). On the second device, open the camera or scanner in the Wi-Fi settings and point at the code.

Why is my generated QR code not readable, although the line looks correct?

Most often the problem is in the encoding. Make sure that the encoding is explicitly specified when generating the image UTF-8, especially if the network name contains Russian letters. Also check the contrast of the image and the presence of a sufficient white field (quiet zone) around the code.

Is it safe to store Wi-Fi passwords in QR codes?

The QR code contains the password in clear text (as a text string). Anyone who scans the code will see the password. Do not post such codes in public places if you do not want all visitors to have access to your network. For guest networks, it is better to use a separate guest VLAN.

Does this method work on all versions of Android?

Native support for scanning Wi-Fi QR codes appeared in Android 10. On older versions (9 and below), you will need to install a third-party scanner from the Play Market that can recognize the prefix WIFI: and suggest connection.

How to connect to a hidden network via a QR code?

You need to add a parameter to the generation line H:true. Example: WIFI:T:WPA;S:HiddenNet;P:password;H:true;;. However, support for hidden networks via QR code is not implemented in all scanners and OS versions, so the result may vary.