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

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

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 ];
}

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

{ 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 {hint} as the value for the relevant flag in your command; it will be substituted with the appropriate text as needed.

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

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 --placeholder '{hint}' {password_flag:--password}"

Available Options

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.