wavemon(1)

📦
version 0.9.7 · 2 versions
, in alpine 3.24, arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu stonking

💖 wavemon(1) — the wireless network monitor glow-up 💖

okay bestie, sit down, grab a strawberry 🍓, because we're about to talk about wavemon, and she is that girl. this is a manual page, she's from the User Manuals section, and she's literally here to make your wireless network make sense. no cap. 👑

✨ NAME ✨

wavemon — a wireless network monitor 🦋

🌸 SYNOPSIS 🌸

wavemon [-h] [-i ifname ] [-g] [-v]

💅 DESCRIPTION 💅

so wavemon is a ncurses-based monitoring application for wireless network devices. she plots levels in real-time and shows you wireless and network related device information. it's giving dashboard. it's giving main character energy. ✨

the wavemon interface splits into different "screens". each screen presents information in a specific manner. for example, the "info" screen shows current levels as bargraphs, whereas the "level" screen represents the same levels as a moving histogram. same tea, different cup. 🫖

on startup, you'll see (depending on configuration) one of the different monitor screens. at the bottom, you'll find a menu-bar listing the screens and their activating keys. each screen is activated by either:

  • the corresponding function key (F1..10),
  • its numeric shortcut (1..0), or
  • the underlined shortcut letter of the screen name.

the following screens can be selected:

Info (F1 or 'i') 👑

this is the most comprehensive screen. it displays a condensed overview of wireless-specific parameters and network statistics, as well as bar graphs. the layout is arranged into several sub-sections. she's organized, she's thorough, she's everything.

the Interface section at the top shows information about the monitoring interface, including interface name, type, ESSID, and available encryption formats.

below, in the Levels section, you can see up to four bargraphs showing (1) relative signal quality and (2) signal level in dBm. if the wireless driver also supports noise level information, additionally (3) noise level in dBm and (4) Signal-Noise-Ratio (SNR) in dB are shown. the colour of the signal level bargraph changes from red to yellow and green at fixed levels. if thresholds have been set, two arrows on the signal level graph will show the positions of the current thresholds. arrows?? pointing?? at your thresholds?? iconic. 🎯

the Statistics section displays packet and byte counters and a few other packet-related statistics.

the subsequent Info subsection lists the current operational mode and configuration of the wireless interface. what parameters are actually shown depends on the capabilities and selected mode of your network device. so like, it depends on the vibe of your hardware, fr fr. 🙈

lastly, the Network section shows network-level parameters. the MAC-address is resolved from ethers(5). the IPv4 address is shown in CIDR notation (RFC 4632 address/prefix_len format). since often those two values also determine the broadcast address (last 32 - prefix_len bits set to 1), that address is shown only if it does not derive from the interface address and prefix length. likewise, the interface MTU is shown only if it differs from the default Ethernet MTU of 1500 bytes. she's not gonna show you redundant info, she's got standards. 💅

Level histogram (F2 or 'l') 📈

this is a full-screen histogram plot showing the evolution of the signal level over time. the screen is partitioned into a grid, with dBm levels shown in green at the right hand side. watch it move. obsessed.

Scan window (F3 or 's') 🔍

a periodically updated network scan, showing access points and other wireless clients. it is sorted depending on sort_order and sort_ascending, see wavemonrc(5). each entry starts with the ESSID, followed by the colour-coded MAC address and the signal/channel information.

a green/red MAC address indicates an (un-)encrypted access point, the colour changes to yellow for non-access points (in this case the mode is shown at the end of the line). the uncoloured information following the MAC address lists relative and absolute signal strengths, channel, frequency, and station-specific information. the station-specific information includes the station type (ESS for Access Point, IBSS for Ad-Hoc network), station count and channel utilisation.

a status line at the bottom informs about the current sort order and a few statistics, such as most (least) crowded channels (least crowded channels are listed when sorting by descending channel).

the sort_order can also directly be changed via these keyboard shortcuts: ascending, descending; by essid, signal, channel (C also with signal), mac address, or by open access (O also with signal).

please note that sorting order changes at the time new data comes in, not when the setting is activated. don't come for her, she's just built different. 😭

you can filter the bands via these keyboard shortcuts: 2 (2.4GHz only), 5 (5GHz only), and b (both bands). hidden ESSIDs can be excluded from display via the h shortcut. 💜

Preferences (F7 or 'p') 🎀

this screen allows you to change all program options such as interface and level scale parameters, and to save the new settings to the configuration file. select a parameter with <up> and <down>, then change the value with <left> and <right>. please refer to wavemonrc(5) for an in-depth description of applicable settings. customize her, she loves that.

Help (F8 or 'h') 🧚

this page might show an online-help.

About (F9 or 'a') 🌈

release information and contact URLs.

Quit (F10 or 'q') 🚪

exit wavemon. bye bestie, love u, come back soon. 🫶

✨ OPTIONS ✨

  • -i interface — override autodetection and use the specified interface. you pick her, she doesn't pick for you. 💁‍♀️
  • -g — check screen geometry: a minimum size is required for proper display; this flag adds a check to ensure it is sufficiently large. enable this if window does not display properly. vibe check for your terminal window, literally. 📐
  • -h — print help and exit.
  • -v — print version information and exit.

🩹 Troubleshooting 🩹

  • wavemon will exit with 'no supported wireless interfaces found' if no usable wireless interfaces were detected. check if your wireless interface is otherwise usable, using e.g. iw(8). if your interface is not listed, causes can be a missing (or not loaded) kernel module; or missing firmware, which some cards need to operate. not her fault, she swears. 😤
  • some operations, such as displaying encryption information or performing scans, require CAP_NET_ADMIN privileges (see capabilities(7)). for non-root users, these can be enabled by installing wavemon setuid-root. ✨
  • running wavemon inside screen(1) may cause garbled output on certain locales. this can be fixed calling screen like this:
$ LC_ALL=C screen

📁 FILES 📁

  • $XDG_CONFIG_HOME/wavemon/wavemonrc — the local per-user configuration file.

💖 AUTHOR 💖

written by Jan Morgenstern <jan@jm-music.de>. king behavior. 👑

🐛 REPORTING BUGS 🐛

open an issue on https://github.com/uoaerg/wavemon/issues. found a bug? tell her, don't be shy. 🦋

👀 SEE ALSO 👀

wavemonrc(5), ethers(5), capabilities(7), iw(8), locale(1)

and that's the whole page, bestie 💫 this little love letter lives in the Linux manual collection and it's dated September 2021 — so yes, technically she's a little vintage, but vintage is a lifestyle, periodt. 🌸💅✨

📦 where this page comes from