canido.dev
Projects/pythops / impala

impala

A terminal UI for managing Wi-Fi with iwd

Get it on GitHub
Unclaimed

Built by @pythops on GitHub. This page was written by @iluxav from public sources, last updated for v0.9.0 (2026-08-27), and may lag behind new releases.

Maintain impala? Claim it
v0.9.0 / 2026-08-2710 things you can do3 changes to know before upgradingFollow (Atom feed)

Scan for, connect to and manage Wi-Fi networks, including WPA Enterprise and hidden ones, or run a hotspot, from a terminal on Linux with iwd.

What you can do with it

Scan for Wi-Fi networks and connect to or disconnect from one.

Good to know

Works only with iwd; other wireless managers must be off.

Present at v0.3.0

Turn auto-connect on or off for saved networks, or forget them.

Present at v0.3.0

Turn the Wi-Fi adapter into an access point and see which devices are connected.

Good to know

The adapter must support access point mode in iwd.

Present at v0.3.0

Turn the Wi-Fi adapter on or off and see its details.

Present at v0.3.0

Change the key bindings and the startup mode in a config file.

Present at v0.3.0

Connect to WPA2 Enterprise (802.1X) networks such as eduroam.

Since v0.6.0

Share a saved network as a QR code that a phone can scan to join.

Since v0.6.0

Connect to a Wi-Fi network that does not broadcast its name.

Since v0.7.0
Show all 10

Change impala's colors in the config file.

Since v0.9.0

Run impala without icon glyphs on terminals or fonts that lack them.

Since v0.9.0

Before you upgrade

Newest first
v0.6.02025-11-27

station.toggle_connect is no longer configurable; connect with Space or Enter. Remove the setting from config.toml.

Behavior changedAffects: Configs that set station.toggle_connect
Read the evidence
v0.4.02025-10-16

Key help now appears as a banner instead of a popup on ?.

Behavior changedInferredAffects: Users who opened the help popup
Read the evidence
Release history 8
v0.9.02026-08-27

Set your own colors for impala in the config file.

Details

A [theme] section sets background, border, text, hidden, info, warning and error colors (v0.9.0). v0.8.0 added an ASCII display without icons (--ascii or ascii = true) and j/k now wrap around in network lists.

Also: Fixed a "no station found" error when connecting or disconnecting.

v0.9.0.

Added: Change impala's colors in the config file.Added: Run impala without icon glyphs on terminals or font…Now works: Share a saved network as a QR code that a phone can…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.7.42026-02-13

Join enterprise networks whose Phase 2 method iwd previously rejected.

Details

Phase 2 method names now match what iwd expects.

v0.7.4.

Now works: Connect to WPA2 Enterprise (802.1X) networks such a…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.7.32026-02-03

Join PEAP enterprise networks.

Details

PEAP network configs now use the correct field names.

v0.7.3.

Now works: Connect to WPA2 Enterprise (802.1X) networks such a…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.7.22026-01-11

Join enterprise networks that use TTLS.

Details

TTLS validation was fixed (v0.7.1).

v0.7.2.

Now works: Connect to WPA2 Enterprise (802.1X) networks such a…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.7.02025-12-29

Connect to a hidden network by typing its name.

Details

Hidden networks are supported from the new networks section (connect_hidden binding). Sharing a network now also shows its passphrase. Static binaries are published.

v0.7.0; static binaries on the releases page.

Added: Connect to a Wi-Fi network that does not broadcast…Improved: Share a saved network as a QR code that a phone can…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.6.02025-11-27

Join WPA2 Enterprise networks such as eduroam.

Details

WPA2 Enterprise (802.1X) and eduroam support (v0.5.0). v0.6.0 adds sharing a network as a QR code (p), a list of all configured networks (a), and esc_quit to let Esc quit. Auto-connect moved from a to t, and the station toggle_connect key setting was removed.

Also: No longer crashes when the Wi-Fi adapter is switched off; network names are encoded correctly.

v0.6.0.

Added: Connect to WPA2 Enterprise (802.1X) networks such a…Added: Share a saved network as a QR code that a phone can…Improved: Turn auto-connect on or off for saved networks, or…Behavior changed: Turn auto-connect on or off for saved networks, or…Behavior changed: Change the key bindings and the startup mode in a c…Improved: Change the key bindings and the startup mode in a c…Now works: Turn the Wi-Fi adapter on or off and see its detail…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.4.02025-10-16

Connect to or disconnect from a network with Enter as well as Space.

Details

Enter now connects and disconnects. The help popup was replaced by a help banner, and the sections were rearranged.

v0.4.0.

Improved: Scan for Wi-Fi networks and connect to or disconnec…Behavior changed / inferred

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.3.02025-07-10
Starting point

Connect to Wi-Fi networks from a keyboard-driven terminal interface on top of iwd.

Details

State of impala up to v0.3.0: station mode to scan and connect, known networks with auto-connect, access point mode, device power and information, startup mode from the CLI or config, and key bindings in ~/.config/impala/config.toml.

Pre-built binaries on the releases page, cargo install impala, pacman -S impala on Arch, nixpkgs; needs iwd.

Added: Scan for Wi-Fi networks and connect to or disconnec…Added: Turn auto-connect on or off for saved networks, or…Added: Turn the Wi-Fi adapter into an access point and see…Added: Turn the Wi-Fi adapter on or off and see its detail…Added: Change the key bindings and the startup mode in a c…

Seeded by @iluxav with Claude Code (canido)

Read the evidence