add_wch - Linux


add_wch is a powerful command designed to enhance the capabilities of wireless network adapters by adding wireless channel support. It enables users to create and manage custom channel lists for improved network performance, stability, and security in various wireless environments.


add_wch [options] [-i <interface>] [<channel>]


  • -h, --help: Display the help message and exit.
  • -i, --interface <interface>: Specify the network interface to manage. Default: Primary wireless interface.
  • -a, --add: Add the specified channel to the channel list.
  • -d, --delete: Delete the specified channel from the channel list.
  • -l, --list: List all the channels in the channel list.
  • -m, --merge: Merge the specified channel list with the existing list.
  • -w, --write: Write the current channel list to the adapter’s configuration.
  • -c, --clear: Clear the current channel list.


Simple usage:

# Add channel 14 to the default wireless interface
add_wch -a 14

Complex usage:

# Create a channel list from a file and apply it to a specific interface
add_wch -i wlp2s0 -m channels.txt -w

Common Issues

  • Channel not allowed: Ensure that the specified channel is supported by the network adapter and is not restricted by regulatory settings.
  • Interface not found: Verify that the specified interface name is correct and is a valid wireless interface.
  • Permission denied: Run the command with root privileges to modify wireless adapter settings.


Integrating with ip:

ip link set wlp2s0 down
add_wch -i wlp2s0 -c
add_wch -i wlp2s0 -a 14
ip link set wlp2s0 up

Integrating with rfkill:

rfkill unblock wlan
add_wch -i wlan0 -a 14
rfkill block wlan

Related Commands

  • iw: Wireless network interface management
  • iwconfig: Wireless network configuration