/wifi-rs

🛰📡Interface and manage WiFi networks in Rust.

Primary LanguageRust

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::prelude::*;
use wifi_rs::{WiFi, Config};

fn main() -> Result<(), WifiConnectionError> {
    let config = Some(Config {
        interface: Some("wlo1"),
    });

    let mut wifi = WiFi::new(config);

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

    Ok(())
}

Features

Windows

  • Support for Windows.
  • Bundle windows profile sample as literals.
  • Add hotspot functionality.
  • Use tempfile crate on windows to generate windows profile temporary file.
  • Fix the implementation for is_wifi_enabled for windows.
  • Add implementation for WifiInterface trait.
  • Add get network type feature.

Linux

  • Support for linux.
  • Add disconnect feature.
  • Add hotspot functionality.
  • Add get network type feature.

OsX

  • Add support for OSX.
  • Add get network type feature.
  • Add hotspot functionality.

General

  • Return detailed error messages.
  • Write documentation.
  • Update wifi-CLI with recent updates.
  • Write tests.

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, please feel free to buy me a coffee below:
Buy Me A Coffee