eping 3.60__tar.gz → 3.84__tar.gz

{eping-3.60 → eping-3.84}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eping
-Version: 3.60
+Version: 3.84
 Summary: Continuous ICMP reachability monitor built on fping, with a CSV logfile analyser (epinga)
 Author-email: Ewald Jeitler <ewald@jeitler.cc>
 License: GPL-3.0-or-later
@@ -12,12 +12,12 @@ Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: MacOS
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: System :: Networking :: Monitoring
-Requires-Python: >=3.8
+Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# eping.py 3.60
+# eping.py 3.84
 
 Continuous ICMP reachability monitor built on `fping`. Scans a host list in a loop,
 reports each host UP/DOWN/NO-DNS, counts state changes. CLI (curses) or web GUI.
@@ -26,10 +26,11 @@ Written by Ewald Jeitler — <https://www.jeitler.cc>
 
 ## Requirements
 
-- Python 3.6+
+- Python 3.6+ (eping.py and epinga.py)
 - `fping` in `$PATH`
 - A terminal supporting `curs_set()` for CLI mode
 - `--check-source` used automatically if fping supports it (5.0+)
+- Non-UTF-8 terminal locale (e.g. `LANG=C`): works, but box-drawing characters are shown as ASCII/`?`; `LC_ALL=C.UTF-8` gives the full look
 
 ## Installation / Update
 
@@ -47,6 +48,19 @@ Standalone scripts (installs/updates `eping.py`, `epinga.py`, `esplit.py`):
 
 `esplit.py` isn't part of the pip package - use the standalone install for it.
 
+## Windows
+
+Portable Windows version (web GUI only, no installation): download and unpack
+[`eping-windows.zip`](https://github.com/ewaldj/eping/blob/main/Windows_Version/eping-windows.zip)
+([folder](https://github.com/ewaldj/eping/tree/main/Windows_Version/)), then start `eping.exe`.
+
+- Contains `eping.exe` (small launcher window: web port, Start / Stop / Restart, open web GUI),
+  `eping.py`, `epinga.py`, `fping.exe` + `cygwin1.dll` (fping for Windows) and an embedded Python.
+- The web GUI opens in the browser (default `http://127.0.0.1:8080`). The port is read from the hosts file
+  (`opt: -port 9000`); a port already in use is reported and can be changed in the launcher window.
+- No terminal (curses) mode and no `-wv`/`-wvc` on Windows; log file names use `-` instead of `:`.
+- Extra options: put them in `eping-args.txt` next to `eping.exe`. Details: `README-WINDOWS.txt` in the zip.
+
 ## Quick start
 
 pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
@@ -60,7 +74,7 @@ pip install: use `eping`/`epinga` instead of `./eping.py`/`./epinga.py` below.
 ./eping.py -wvc                        # CLI + controllable web view
 ```
 
-No args: creates a sample `eping-hosts.txt`. `-df`: start with no hosts, add at runtime.
+No args: creates a sample `eping-hosts.txt` and `eping-hosts-sample.csv` (same hosts with invented inventory values, a template for the *Inventory CSV import*; never loaded by eping). `-df`: start with no hosts, add at runtime.
 
 ### Running unattended (screen / tmux)
 
@@ -73,7 +87,7 @@ Combinable:
 
 | Source | Option |
 |---|---|
-| Host file | `-f FILE[,FILE...]`, comma/space separated, disable with `-df` |
+| Host file | `-f FILE[,FILE...]`, comma/space separated, disable with `-df`; `.txt` host list or inventory `.csv` (see *Inventory CSV import*) |
 | CIDR network | `-n` (mask /13 … /32), comma separated |
 | IP range | `-r`, `start-end`, comma separated |
 
@@ -85,7 +99,7 @@ expansion includes network/broadcast. Several `-f` files are combined before ded
 
 ### Host file format
 
-Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD FILE:
+Same parser for `-f`, `F`/ADD FILE (CLI), and web GUI ADD HOSTS FILE:
 
 ```
 # comment to end of line
@@ -98,7 +112,7 @@ www.google.com            # hostname/FQDN
 2606:4700:4700::1111/128  # IPv6 with /128 - single host
 ```
 
-Network mask range /13…/32 everywhere (host file, ADD FILE, web upload, ADD/DELETE
+Network mask range /13…/32 everywhere (host file, ADD HOSTS FILE, web upload, ADD/DELETE
 host input); out of range is rejected (message names the allowed range; `-f` warns and
 ignores). IPv6: only `/128` accepted, any other mask rejected. Anything else is ignored.
 
@@ -116,12 +130,54 @@ opt: -web -port 9000
 Multiple `opt:` lines join in file order. `#` comments out the rest of the line (or
 the whole line at the start). Quote values with spaces: `opt: -f "my hosts.txt"`. A
 flag typed on the command line wins over the same flag from a file. Only applies to
-the initial `-f` read at startup — `F`/ADD FILE (CLI or web, FROM CLIENT/FROM SERVER)
+the initial `-f` read at startup — `F`/ADD FILE (CLI) and ADD HOSTS FILE (web)
 never parse `opt:` lines, they're just text.
 
+`opt:` lines also work at the top of an inventory `.csv`. SAVE HOSTS FILE and DOWNLOAD ALL/ACTIVE HOSTS write every option that differs from the default there (start-up flags and live ADV OPTIONS changes; not `-f -df -n -r -o -up -setref -gn -cl`).
+
 The default `eping-hosts.txt`: sample hosts, this section, then every CLI option as a
 commented-out `opt:` line with its default (remove `# ` to activate).
 
+## Inventory CSV import
+
+A `.csv` inventory export (one device per row) can be used as host file: `-f FILE.csv`,
+`F`/ADD FILE (CLI), web GUI FILE OPERATIONS > ADD HOSTS FILE (FROM CLIENT, FROM SERVER, drag and drop). Files
+named `*.txt` are never treated as CSV - they keep the plain host file format above.
+
+- **Detection**: first line that is not blank, a `#` comment or an `opt:` line is a header with the columns `IP Address` and
+  `Hostname` (case-insensitive); the delimiter (`;`, `,` or tab) is detected.
+- **Columns used**: `IP Address`, `Hostname`, `Serial Number`, `Model`, `Location`,
+  `sysLocation`, `Type`, `Comment`. All other columns are ignored.
+- **Host entry**: the `Hostname` (default; rows without an IP are pinged by name too,
+  NO-DNS if it does not resolve). A name that is not a valid hostname falls back to the
+  IP; rows without a usable entry are ignored. In the IP modes (`-ipo`, PREFER IP
+  ADDRESS, also when active while the file is added) the entry is the IP address
+  instead and rows without a valid IP are ignored. `-ph` is not needed for a CSV.
+- **Duplicates**: one host per entry, the first row wins. The count of ignored and
+  duplicate rows is reported when the file is added (startup message / web footer).
+- **Log**: the six inventory values and the CSV hostname are written with every row
+  of that host, see *Logging*. A `Hostname` that is not the host entry (IP mode) is
+  only kept there as information.
+- **Filters**: `M` matches the inventory values as text, `V` / ADV FILTER selects them
+  (see *ADV FILTER*).
+- **Save**: if the displayed hosts carry inventory values, `SAVE HOSTS FILE` writes an
+  inventory `.csv` (see *Web GUI*); plain `.txt` hosts are saved as `.txt`.
+
+Example (`;` delimited, extra columns are ignored):
+
+```
+Hostname;IP Address;Serial Number;Model;Location;sysLocation;Type;Comment
+sw-core-01;10.0.0.1;FOC1234A1BC;C9300-48P;Vienna DC1;Rack A3;Switch;spare PSU missing
+sw-core-02;10.0.0.2;FOC1234A1BD;C9300-48P;Vienna DC1;Rack A4;Switch;
+ap-lobby-01;;FCW2528P5PSV;C9120AXI-E;Graz HQ;Lobby;AP;
+rtr-edge-01;192.0.2.10;FTX9876B2CD;ISR4331;Linz POP;Rack B1;Router;uplink to ISP
+sw-access-01;10.0.1.1;FOC5678C3DE;C9200L-24P;Vienna DC1;Rack C1;Switch;
+fw-edge-01;192.0.2.1;JMX2345F6GH;ASA5516;Linz POP;Rack B2;Firewall;ASA 5516 - EoL 2027
+```
+
+This gives 6 hosts, named by `Hostname`. In an IP mode it gives 5 hosts (the IP
+addresses); `ap-lobby-01` has no IP and is ignored.
+
 ## CLI mode
 
 Sorted table (IPv4 numerically, then hostnames), 64-column blocks. Green = UP, red =
@@ -130,7 +186,8 @@ DOWN. Columns: hostname/IP, state, RTT (ms), last-change timestamp, change count
 | Key | Action |
 |---|---|
 | `U` | view picker — all 9 views (see *Views and sort orders*) |
-| `M` | match filter — regex on hostname/IP, display only (see *Match filter*) |
+| `M` | match filter — regex on hostname/IP and inventory fields, display only (see *Match filter*) |
+| `V` | ADV FILTER — check/uncheck Model/Location/sysLocation/Type/Comment values (show only / hide), display only (see *ADV FILTER*) |
 | `A` | add host — IP, hostname, CIDR (/13…/32), or `ip1-ip2` (max 524288) |
 | `D` | delete host — same formats/limits as add |
 | `F` | add hosts from a file |
@@ -153,7 +210,7 @@ same option set as the matching web GUI dropdown.
 Dialogs: ENTER confirms, ESC/empty cancels. Key bar shortens on narrow terminals.
 `PLEASE WAIT` box with elapsed counter shown until the first round has results.
 
-Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`T`) is open — same
+Ping checks keep running while a dialog (`A`/`D`/`F`/`M`/`V`/`T`) is open — same
 retry/state/logging logic as the main loop; screen repaints once the dialog closes.
 
 Screen repaints ~7×/s independent of fping. `UP`, `SET REFERENCE`, `DEL HOST`, `ZERO
@@ -178,9 +235,9 @@ Single self-contained page, no external resources.
 
 - Table: CLI-style columns, filled top-down then next column right. Horizontal scroll
   if needed ("SCROLL RIGHT FOR MORE" hint in the stats bar).
-- Footer stats: RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
-  of the match filter. RUNTIME shows `n/a` briefly during a background round.
-- Adding many hosts (`ADD`, `ADD FILE`, upload) shows "added N host(s) - please wait,
+- Footer stats: HOSTS, RUNTIME, HOST UP/DOWN/FLAPPING, for the whole current view regardless
+  of the match filter and the ADV FILTER (HOSTS-SHOWN = shown count). The CLI footer counts the same way. RUNTIME shows `n/a` briefly during a background round.
+- Adding many hosts (`ADD`, ADD HOSTS FILE, upload) shows "added N host(s) - please wait,
   pinging ..." until they appear with a state, then `done`.
 - Font size 6–28px (slider, `A−`/`A+`, `+`/`−` keys), stored in `localStorage`.
 - Column headers sort the list (IPv4-aware).
@@ -188,37 +245,46 @@ Single self-contained page, no external resources.
   - Row 1: view select (9 views), sort order select, SET REFERENCE, ZERO CHANGES,
     CLEAR ALL, address mode select, GET NAMES, ADV OPTIONS, RESET LOG, FILE OPERATIONS
     select, EXIT, font size.
-  - Row 2: match filter (SET/CLEAR), host field (ADD/DELETE), comment field (COMMENT),
-    ADD FILE select, GENERATE REPORT select.
+  - Row 2: match filter (SET/CLEAR), ADV FILTER, host field (ADD/DELETE), comment
+    field (COMMENT), GENERATE REPORT select.
   - View select, sort order select, address mode select and ADV OPTIONS all match the
-    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS and ADD FILE > FROM CLIENT/
-    FROM SERVER are web-gui-only (no CLI key - CLI already runs on the server's own
+    CLI's `U`/`O`/`P`/`X` pickers exactly. FILE OPERATIONS (incl. ADD HOSTS FILE FROM CLIENT/
+    FROM SERVER) is web-gui-only (no CLI key - CLI already runs on the server's own
     filesystem).
 - **FILE OPERATIONS** dropdown, in this order:
   | Entry | Does |
   |---|---|
-  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched |
+  | ADD HOSTS FILE FROM SERVER | picks one or more `.txt` files or inventory `.csv` files already on the server, adds their hosts; a `.csv` without the inventory header, e.g. an eping log, is refused |
+  | ADD HOSTS FILE FROM CLIENT | local file picker (`.txt`/`.csv`), adds the hosts; a file can also be dropped anywhere on the page |
+  | SAVE HOSTS FILE ON SERVER | confirmation, then saves the currently displayed hosts; blank name overwrites the active `-f` hostfile (first one, if eping.py was started with one) or, with none active, the default `eping-hosts.txt`; a typed name always saves as that new file instead, `.txt` appended once, active hostfile left untouched. If the displayed hosts carry inventory values (CSV import) an inventory `.csv` is written instead (`;` delimited, columns as in *Inventory CSV import*); a `.txt` name or hostfile then becomes `.csv`, the default is `eping-hosts.csv`. The options that differ from the default are written first as `opt:` lines (see *Host file format*); for a `.csv` the checkboxes `include options (opt: lines)` (default on) and `save as .txt (hosts only, no inventory)` (default off) are offered |
   | UPLOAD FILE TO SERVER | picks a local `.txt`/`.csv`, saves as-is server-side, no host parsing; never overwrites, appends `-1`/`-2`/... |
-  | DOWNLOAD ALL HOSTS | full reference list, plain text |
-  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), plain text |
+  | DOWNLOAD ALL HOSTS | full reference list: inventory `.csv` if the hosts carry inventory values, else `.txt`; non-default options first as `opt:` lines (`.csv`: checkboxes `include options`, default on, and `save as .txt`, default off) |
+  | DOWNLOAD ACTIVE HOSTS | currently displayed hosts (view/address mode/filter applied), same format and options as DOWNLOAD ALL HOSTS |
   | DOWNLOAD ACTIVE LOGFILE | active CSV log, zipped; disabled while logging off |
   | DOWNLOAD SELECTED FILES | picker: every `.csv`/`.txt`/`.html` in the working dir, table (name/size/date), extension filter, "select all", "no compression" checkbox (single-file selection only); multi-select bundles into one ZIP |
   | DELETE FILES FROM SERVER | same picker as DOWNLOAD SELECTED FILES, red DELETE button, confirms with file count; active logfile can't be deleted |
   | VIEW FILE FROM SERVER | picker: every `.csv`/`.txt` in the working dir, table (name/size/date), "select all"; opens each picked file read-only, raw content, COPY/DOWNLOAD buttons - see *VIEW FILE FROM SERVER* below |
-- **ADD FILE** dropdown: `FROM CLIENT` (local file picker) / `FROM SERVER` (picks one
-  or more `.txt` files already on the server, adds their hosts).
 - Keyboard shortcuts (no modifier, only while no text field has focus; own quick
   variants, not the CLI's picker keys of the same letter): `U` cycles the original 3
   views (ALL HOSTS → CURRENTLY-UP → UP+FLAPPING → ALL HOSTS), the other 6 need the
   dropdown; `O` cycles all 5 sort orders one at a time; `P`/`I` toggle PREFER HOSTNAME /
   SWITCH TO IP ONLY directly, the address mode select reaches all 4 modes; `G`/`S`/`Z`/
   `C`/`L`/`E` click the matching button (`E`/`C`/`L` confirm); `A`/`D` focus host field;
-  `M`/`T` focus their field; `F` opens the file picker; `R` forces a status refresh;
+  `M`/`T` focus their field; `V` opens ADV FILTER; `F` opens the ADD HOSTS FILE FROM CLIENT picker; `R` forces a status refresh;
   `+`/`−` font size (works while typing). No keyboard shortcut for `X`/ADV OPTIONS or
   GENERATE REPORT - click required.
 - Host field feeds both ADD/DELETE; ENTER triggers the button used last, ESC clears.
 - Files can also be dropped anywhere on the page (max 16MB, see *Host file format*).
 - Commands acknowledge immediately; a click aborts the running round.
+- **Host popup**: hovering a host row (after ~350 ms) shows everything known about it:
+  state, previous state, RTT, last check, changes, time in the current state, resolved/CSV
+  IP, inventory values (Model, Location, sysLocation, Type, Comment, serial) and its
+  history (last up to 50 state changes, newest first, merged with the log `COMMENT`s
+  by time). The data is fetched per host on demand (`GET /api/host`), the polled status
+  stays small. A click on the row pins the popup: the text can be selected, `COPY` copies
+  all of it, `DELETE` removes the host immediately (no confirmation; not shown in `-wv`),
+  `×`/ESC/click elsewhere closes it. The history lives in memory only; it is cleared by
+  ZERO CHANGES and CLEAR ALL.
 
 ### Views and sort orders
 
@@ -290,7 +356,8 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 |---|---|---|---|
 | GET | `/` | — | the page |
 | GET | `/api/status` | — | JSON: rows, counters, scan/phase info |
-| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS, ADD FILE > FROM SERVER) |
+| GET | `/api/host?name=...` | — | JSON: all known data and history of one host (mouse-over popup) |
+| GET | `/api/logfiles` | — | JSON list of `.csv`/`.txt`/`.html` files (FILE OPERATIONS > ADD HOSTS FILE FROM SERVER) |
 | GET | `/api/download/hosts_all` | — | full reference list, `.txt` |
 | GET | `/api/download/hosts_shown` | — | shown hosts, `.txt` |
 | GET | `/api/download/logfile` | — | active CSV log, zipped; `404` if logging off |
@@ -301,11 +368,14 @@ Same bounds as the matching CLI flags (`-lms`/`-lmf` for the last two - see *Out
 | POST | `/api/add_from_server` | `{"names":[...]}` | add hosts from listed `.txt` files |
 | GET | `/api/report` | — | last GENERATE REPORT HTML; `404` until done |
 | POST | `/api/command` | `{"cmd":"...","value":"..."}` | control (see cmd list below) |
+| POST | `/api/advvalues` | `{"filter":{...}}` | ADV FILTER: values still selectable for a draft selection (same format as `adv_filter`) |
 | POST | `/api/upload` | host list, text | add hosts |
 
 `cmd` values: `up_only`, `set_filter`, `addr_mode`, `get_names`, `match_filter`,
-`sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
-`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `set_option`
+`adv_filter`, `sort`, `add`, `del`, `set_ref`, `zero`, `add_comment`, `reset_log`, `clear`,
+`set_option`, `reset_options`, `run_report`, `save_hosts_file`, `exit`. `adv_filter` value: JSON object `{"<field>":{"mode":"in|out","values":[...]}}` with the fields `model`,
+`location`, `sysloc`, `type`, `comment`; `\u0001none` as value = hosts without a value; `{}` = off
+(the old `{"<field>":"<value>"}` form is still accepted as `in` with one value). `set_option`
 value: `key=value`. `reset_log` value: logging off - optional custom file name (blank =
 auto-generated); logging on - `y` (clear) or `new`/`new=<name>` (new file, optional
 custom name). `run_report`: `value` = empty (active logfile) or one `.csv` filename; or
@@ -321,7 +391,9 @@ authentication. Default bind `0.0.0.0` — use `-bind 127.0.0.1` outside trusted
 1. Hostnames resolved once (32 parallel), cached around `-dns` seconds (randomized a
    bit so a large batch resolved together doesn't all expire - and need re-resolving -
    in the same round later). Same-address names share one probe. Unresolvable → NO-DNS,
-   no fping call. `-dns 0` = fping-side resolve.
+   no fping call. `-dns 0` = fping-side resolve. A command (filter, add, ...) cuts
+   the name resolution short as well, so it applies at once even with thousands of
+   hostnames.
 2. UP/new hosts get full `-re` retries; confirmed-DOWN hosts get `-dr` retries. Every
    `-fs`-th round probes everything with full retries.
 3. Only 1/`-ds` of DOWN hosts probed per round, strided.
@@ -389,9 +461,13 @@ Hard-enforced at startup and live via ADV OPTIONS (`-web` only), same bounds.
 Unless `-dl`, every round appends to `eping-log_YYYY-MM-DD_HH:MM:SS.csv` (or `-o FILE`):
 
 ```
-TIMESTAMP,HOSTNAME,PREVIOUS_STATE,CURRENT_STATE,RTT,NO_OF_CHANGES,CHANGE_TIMESTAMP,TBD,IP
+TIMESTAMP,HOSTNAME,PREVIOUS_STATE,CURRENT_STATE,RTT,NO_OF_CHANGES,CHANGE_TIMESTAMP,TBD,IP,INV_HOSTNAME,SERIAL_NUMBER,MODEL,LOCATION,SYSLOCATION,TYPE,INV_COMMENT
 ```
 
+`INV_HOSTNAME` … `INV_COMMENT`: the inventory values of a host added from an inventory CSV (see
+*Inventory CSV import*), empty for all other hosts. Logs without these columns (older
+versions) stay readable by epinga.py.
+
 `TBD`: suppressed DOWN observations (`-cf`). `IP`: address actually pinged (empty for
 NO-DNS). Log rotates to a new file once it reaches `-lms` MB; a single round's data is
 always written in full to one file, rotation only starts the next round in a new file.
@@ -487,7 +563,9 @@ limit shown in the modal text.
 `PREFER HOSTNAME` (`-ph`): drops a raw-IP host from pinging when another entry resolves
 to the same address. Redundancy check cached `-dns` seconds. `PREFER IP ADDRESS`: the
 mirror - drops a hostname entry once its resolved address is already covered by a
-raw-IP entry. Both non-destructive, restored by switching to another mode.
+raw-IP entry. Both non-destructive, restored by switching to another mode. Starting
+with `-ph` resolves every hostname first (in parallel): the CLI shows a PLEASE WAIT
+box with an elapsed counter meanwhile, the web mode a line in the terminal.
 
 `SWITCH TO IP ONLY` (`-ipo`): resolves every hostname to its address (v4/v6 per
 `-4`/`-6`, A preferred by default) and renames it in place (history/uptime carry over).
@@ -513,11 +591,37 @@ message shows for 3s after. Re-triggering while running shows "already running".
 ## Match filter
 
 `M` (CLI) / match filter field (web): case-insensitive regex, display only, matched
-against shown name and resolved IP. Every host keeps being pinged regardless. Empty
+against shown name, resolved IP and the inventory fields (CSV hostname, serial
+number, model, location, sysLocation, type, comment). Every host keeps being pinged regardless. Empty
 value turns it off. CLI: replaces the version banner with `MATCH FILTER '<regex>'
 active (N of M hosts shown, all still pinged)`. Invalid regex: error shown, previous
 filter unchanged.
 
+## ADV FILTER
+
+Excel-style display filter on the inventory values of a CSV import (*Inventory CSV
+import*) for `Model`, `Location`, `sysLocation`, `Type` and `Comment`. Display only -
+every host keeps being pinged. Needs hosts with inventory values; without them the
+dialog says so.
+
+- **Open**: CLI `V`, web GUI button `ADV FILTER` or key `V`. A separate window; the
+  filter only changes when applied.
+- **Per field**: check any number of values (with host count; `(empty)` = hosts without
+  a value) and choose the mode: `SHOW ONLY CHECKED` (include) or `HIDE CHECKED`
+  (exclude). Nothing checked = field not filtered.
+- **Combination**: values within a field are ORed, fields are ANDed with each other, with
+  the match filter (`M`) and the view. The lists narrow as you select: only values still
+  possible with the other fields' selection are offered.
+- **Web window**: one list per field with search box, `ALL`/`NONE` (act on the entries
+  matching the search), the mode toggle, APPLY, RESET ALL, CLOSE. Lists show the first
+  500 entries, the rest via search.
+- **CLI window**: `↑`/`↓` field, ENTER opens the value list (`SPACE` check, `I` show-only/hide,
+  `A` all, `N` none, ENTER ok, ESC cancel), then `A` APPLY, `R` RESET ALL, ESC CANCEL.
+  No search in the CLI list.
+- **Banner**: while active the CLI banner shows e.g. `ADV Type not in (Firewall, Switch)`.
+- **Reset**: SET REFERENCE and CLEAR ALL turn the filter off. It is not saved
+  with `SAVE HOSTS FILE`.
+
 ## IPv6
 
 IPv4/IPv6 mixed freely. Resolution follows `-4`/`-6` (preference, not restriction; A
@@ -543,7 +647,7 @@ phases: eping's own work (~0.12s on 4109 hosts).
 - `-p` > 1 and `-i 0` reduce accuracy (false DOWN) — defaults avoid both.
 - `-dr 0` produces flapping hosts in practice — keep the default of 1.
 
-# epinga.py 2.27
+# epinga.py 2.35
 
 Analyses an eping.py CSV log: terminal summary + self-contained HTML report (no
 server, no external assets) with per-host detail, state-change timelines, and
@@ -593,13 +697,23 @@ Top bar: total/UP/flapping/DOWN/no-DNS/duplicate-host counts. Toolbar:
 
 | Control | Does |
 |---|---|
-| Filter | text or regex (case-insensitive), hostname + IP; invalid regex falls back to substring |
+| Filter | text or regex (case-insensitive), hostname + IP + inventory fields (CSV hostname, serial, model, location, sysLocation, type, comment); invalid regex falls back to substring |
 | Show | restrict to one state (flapping independent of UP/DOWN/NO-DNS) |
 | Sort | name / uptime% / avg RTT / changes; click a header, shift+click adds a tie-breaker (①②③ badge), shift+click again flips direction |
 | IP View | toggle primary label hostname↔IP (table + buckets); independent of dedup |
 | Deduplication | No dedup / Prefer IP / Prefer hostname - hides the redundant side across table, buckets, top-bar cards; DUPLICATES card is `0` once a mode is active |
+| Reset | clears Filter, Show and the inventory drop-downs (sort, IP View and deduplication stay) |
 | Download | saves the report exactly as shown (theme/dedup/sort/filter/collapsed state) as a standalone `.html`, client-side; hidden on `file://` |
 
+**Inventory filters** (logs with inventory columns, see *Inventory CSV import*): to the
+right of the top-bar counters, one drop-down each for Model, Location, sysLocation,
+Type and Comment, listing the values found in the log with their host count (`(empty)` for hosts
+without a value). They combine with each other and with Filter/Show and affect the
+Host List only. A column without any value gets no drop-down; serial number and CSV
+hostname are unique per device and searched via Filter instead. The drop-downs are
+narrow; the one in use widens while it has focus and the others move aside. A host's detail shows
+all inventory values, the Host List CSV download adds them as columns.
+
 **Comments**: section above Host List from `#COMMENT#` rows, collapsed by default,
 timestamp + text in log order. Also appear inline in a host's STATE CHANGES timeline
 (orange, 💬 marker), HTML-escaped. Same merge in text output (`PER-HOST DETAIL`,