iwmenu

About

iwmenu (iNet Wireless Menu) manages Wi-Fi through your launcher of choice.

Dependencies

Build

• Rust (includes cargo)

Runtime

• iwd – iNet Wireless Daemon
• dbus – For communicating with iwd
• A launcher with stdin mode support

Optional

• NerdFonts – For font-based icons (default mode)
• XDG icon theme – For image-based icons (used with -i xdg, included with DEs or can be installed manually)
• Notification daemon – For system notifications (e.g. dunst or fnott, included with DEs or can be installed manually)

Compatibility

Launcher	Font Icons	XDG Icons	Notes
Fuzzel	✅	✅	XDG icons supported in main branch
Rofi	✅	🔄	XDG icon support pending via PR #2122
Walker	✅	✅	XDG icons supported since v0.12.21
dmenu	✅	❌	No XDG icon support
Custom (stdin)	✅	❔	Depends on launcher implementation

Tip

If your preferred launcher isn't directly supported, use custom mode with appropriate command flags.

Note

For proper XDG icon display launchers must support fallback icons in stdin mode with comma-separated values. This ensures compatibility with various themes and desktop environments.

Installation

Build from source

Run the following commands:

git clone https://github.com/e-tho/iwmenu
cd iwmenu
cargo build --release

An executable file will be generated at target/release/iwmenu, which you can then copy to a directory in your $PATH.

Nix

Install from nixpkgs:

{ pkgs, ... }:
{
  environment.systemPackages = [ pkgs.iwmenu ];
}

Alternative: Install from flake

Add flake as an input:

inputs.iwmenu.url = "github:e-tho/iwmenu";

Install from flake:

{ inputs, ... }:
{
  environment.systemPackages = [ inputs.iwmenu.packages.${pkgs.system}.default ];
}

Alpine Linux

Install from the testing repository:

apk add iwmenu

Arch Linux

Install from AUR with your favorite helper:

paru -S iwmenu # or iwmenu-git

Gentoo

Install from GURU overlay:

sudo eselect repository enable guru
sudo emaint sync -r guru
sudo emerge -a net-wireless/iwmenu

Usage

Supported launchers

Specify an application using -l or --launcher flag.

iwmenu -l fuzzel

Custom launchers

Specify custom as the launcher and set your command using the --launcher-command flag. Ensure your launcher supports stdin mode, and that it is properly configured in the command.

iwmenu -l custom --launcher-command "my_custom_launcher --flag"

Prompt and Placeholder support

Use either {prompt} or {placeholder} as the value for the relevant flag in your command; each will be replaced with the appropriate text as needed. They return the same string, with {prompt} adding a colon at the end.

iwmenu -l custom --launcher-command "my_custom_launcher --prompt-flag '{prompt}'" # or --placeholder-flag '{placeholder}'

Password obfuscation support

To enable support for password obfuscation, set the appropriate flag via {password_flag:--my-password-flag}.

iwmenu -l custom --launcher-command "my_custom_launcher {password_flag:--my-password-flag}"

Example to enable all features

This example demonstrates enabling all available features in custom mode with fuzzel.

iwmenu -l custom --launcher-command "fuzzel -d -p '{prompt}' {password_flag:--password}"

Available Options

Flag	Description	Supported Values	Default Value
-l, --launcher	Specify the launcher to use (required).	dmenu, rofi, fuzzel, walker, custom	None
--launcher-command	Specify the command to use when custom launcher is set.	Any valid shell command	None
-i, --icon	Specify the icon type to use.	font, xdg	font
-s, --spaces	Specify icon to text space count (font icons only).	Any positive integer	1

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

License

This project is licensed under the terms of the GNU General Public License version 3, or (at your option) any later version.

Support this project

If you find this project useful and would like to help me dedicate more time to its development, consider supporting my work.