WiFi-rs

A rust crate to interface and manage Wi-Fi networks.

How it works

The command creates a new connection and then activates it on a device.
This is a command-line counterpart of clicking an SSID in a GUI client.
The command always creates a new connection and thus it is mainly useful for connecting to new Wi-Fi networks.
If a connection for the network already exists, it is better to bring up (activate) the existing connection as follows: WiFi::connection_up("SSID").

Currently supported network types

Note that only open, WEP and WPA-PSK networks are supported at the moment.

It is also supposed that IP configuration is obtained via DHCP.

Supported Operating Systems

Windows
Linux
OSx

Example

extern crate wifi_rs;
use wifi_rs::{WiFi, Config, NetworkError};

fn main() -> Result<(), NetworkError> {
    let config = Some(Config {
        interface: Some("wlo1"), // interface : None would default to `wlan0`.
    });

    let wifi = WiFi::new("AndroidAPSD", config)?;

    match wifi.connect("belm4235") {
        Ok(result) => println!(
            "{}",
            if result == true {
                "Connection Successfull."
            } else {
                "Invalid password."
            }
        ),
        Err(err) => println!("The following error occurred: {:?}", err),
    }

    Ok(())
}

}

To do

Bundle windows profile sample as literals
Add support for Windows
Add support for linux
Add disconnect feature
Use tempfile crate on windows to generate windows profile temporary file.
Add support for OSX
Fix the implementation for check_if_wifi_is_enabled for windows.
Add get network type feature
Add create hotspot functionality
Write documentation
Write tests
Add multi-threaded support

Contribution

Any feature you feel is missing, why not send in a Pull Request, and let's help make this project better. Or are there any bugs, kindly create an issue, so we could work towards fixing it.

Support

Love this project, and you'll love to buy me a coffee, kindly visit:

2.1 KiB Raw Blame History