📸 Demo

✨ Features

• WPA Enterprise (802.1X) Support
• Station & Access Point Modes
• QR Code Network Sharing
• Support hidden networks

💡 Prerequisites

• A Linux based OS
• iwd running.
• nerdfonts (Optional) for icons.

[!IMPORTANT] To avoid conflicts, ensure wireless management services like NetworkManager or wpa_supplicant are disabled.

🚀 Installation

📥 Binary release

You can download the pre-built binaries from the release page release page

📦 crates.io

You can install impala from crates.io

cargo install impala

🐧Arch Linux

You can install impala from the official repositories with using pacman.

pacman -S impala

Nixpkgs

nix-env -iA nixpkgs.impala

⚒️ Build from source

Run the following command:

git clone https://github.com/pythops/impala
cd impala
cargo build --release

This will produce an executable file at target/release/impala that you can copy to a directory in your $PATH.

🪄 Usage

$ impala

You can run impala with options:

$ impala --help
Options:
  -m, --mode <mode>  Device mode [possible values: station, ap]
      --ascii        Ascii display
  -h, --help         Print help
  -V, --version      Print version

🛠️Custom keybindings and themes

Keybindings and themes can be customized in the config file $HOME/.config/impala/config.toml. Please refer to the ratatui Color docs for valid color configurations.

ascii = false # ascii display (false = do not show icons)
switch = "r"
mode = "station"
esc_quit = false  # Set to true to enable Esc key to quit the app

[device]
infos = "i"
toggle_power = "o"

[access_point]
start = 'n'
stop = 'x'

[station]
toggle_scanning = "s"

[station.known_network]
toggle_autoconnect = "t"
remove = "d"
show_all = "a"
share = "p"

[station.new_network]
show_all = "a"
connect_hidden = "n"

[theme]
background = "dark gray"
border = "green"
text_color = "white"
hidden_color = "dark gray"
info_color = "green"
warning_color = "yellow"
error_color = "red"

Contributing

• Strict No LLM.
• Only submit a pull request after having a prior issue or discussion.
• Keep PRs small and focused.

⚖️ License

GPLv3