pingerplot 1.6.0__tar.gz → 1.7.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. {pingerplot-1.6.0 → pingerplot-1.7.0}/PKG-INFO +37 -27
  2. {pingerplot-1.6.0 → pingerplot-1.7.0}/README.md +35 -24
  3. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/__init__.py +1 -1
  4. pingerplot-1.7.0/pingerplot/errorlog.py +137 -0
  5. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui.py +60 -8
  6. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_updates.py +5 -5
  7. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_widgets.py +32 -6
  8. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/headless.py +5 -1
  9. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/history.py +2 -0
  10. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/monitor.py +30 -5
  11. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tcpudp.py +46 -8
  12. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/theme.py +18 -3
  13. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/trouble.py +34 -2
  14. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/updater.py +35 -1
  15. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/winplatform.py +117 -7
  16. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/PKG-INFO +37 -27
  17. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/SOURCES.txt +8 -0
  18. {pingerplot-1.6.0 → pingerplot-1.7.0}/pyproject.toml +4 -4
  19. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_lock_discipline.py +2 -2
  20. pingerplot-1.7.0/tests/test_alert_where.py +87 -0
  21. pingerplot-1.7.0/tests/test_button_corners.py +15 -0
  22. pingerplot-1.7.0/tests/test_capture_mode.py +95 -0
  23. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_elevate.py +2 -2
  24. pingerplot-1.7.0/tests/test_errorlog.py +108 -0
  25. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_updates.py +1 -1
  26. pingerplot-1.7.0/tests/test_keyboard.py +92 -0
  27. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_map_trouble.py +35 -0
  28. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_packaging.py +19 -1
  29. pingerplot-1.7.0/tests/test_single_instance_posix.py +75 -0
  30. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_theme_platform.py +0 -3
  31. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_trouble.py +32 -0
  32. pingerplot-1.7.0/tests/test_update_in_use.py +40 -0
  33. {pingerplot-1.6.0 → pingerplot-1.7.0}/LICENSE +0 -0
  34. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/__main__.py +0 -0
  35. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/appicon.py +0 -0
  36. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/compare.py +0 -0
  37. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/ed25519.py +0 -0
  38. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/geoip.py +0 -0
  39. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gfx.py +0 -0
  40. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_charts.py +0 -0
  41. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_history.py +0 -0
  42. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_hopinfo.py +0 -0
  43. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_recording.py +0 -0
  44. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/gui_settings.py +0 -0
  45. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/icmp.py +0 -0
  46. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/icmp_posix.py +0 -0
  47. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/investigate.py +0 -0
  48. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/launch.py +0 -0
  49. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/locating.py +0 -0
  50. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/model.py +0 -0
  51. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/places.py +0 -0
  52. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/routes.py +0 -0
  53. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/selfcheck.py +0 -0
  54. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/selftest.py +0 -0
  55. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/settings.py +0 -0
  56. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tkthreads.py +0 -0
  57. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/tray.py +0 -0
  58. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/update_key.py +0 -0
  59. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/worldmap.py +0 -0
  60. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot/xdg.py +0 -0
  61. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/dependency_links.txt +0 -0
  62. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/entry_points.txt +0 -0
  63. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/requires.txt +0 -0
  64. {pingerplot-1.6.0 → pingerplot-1.7.0}/pingerplot.egg-info/top_level.txt +0 -0
  65. {pingerplot-1.6.0 → pingerplot-1.7.0}/setup.cfg +0 -0
  66. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_responder_change.py +0 -0
  67. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alert_route_change.py +0 -0
  68. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_alerts.py +0 -0
  69. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_appicon.py +0 -0
  70. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_autostart_command.py +0 -0
  71. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_background.py +0 -0
  72. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_bom_tolerance.py +0 -0
  73. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_capture_precedence.py +0 -0
  74. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_capture_refusal_text.py +0 -0
  75. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_ci_coverage_gate.py +0 -0
  76. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_compare.py +0 -0
  77. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_compare_thread_safety.py +0 -0
  78. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_dns_follow.py +0 -0
  79. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_draw_gating.py +0 -0
  80. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_dscp_and_source.py +0 -0
  81. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_ed25519.py +0 -0
  82. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_elevated_log_paths.py +0 -0
  83. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_events_view_bounded.py +0 -0
  84. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_export.py +0 -0
  85. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_export_header.py +0 -0
  86. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_geoip.py +0 -0
  87. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_geoip_cache.py +0 -0
  88. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_history.py +0 -0
  89. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_hopinfo.py +0 -0
  90. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_recording.py +0 -0
  91. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_gui_sessions.py +0 -0
  92. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless.py +0 -0
  93. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_events.py +0 -0
  94. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_icmp_preflight.py +0 -0
  95. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_streams.py +0 -0
  96. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_headless_supervision.py +0 -0
  97. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_history.py +0 -0
  98. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_history_monitor.py +0 -0
  99. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_addr.py +0 -0
  100. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix.py +0 -0
  101. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix_matching.py +0 -0
  102. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_icmp_posix_timestamps.py +0 -0
  103. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_interval_note.py +0 -0
  104. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_investigate.py +0 -0
  105. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_launch.py +0 -0
  106. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_launcher.py +0 -0
  107. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_lifecycle.py +0 -0
  108. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_desktop.py +0 -0
  109. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_notify.py +0 -0
  110. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_linux_theme.py +0 -0
  111. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_locating.py +0 -0
  112. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_close_race.py +0 -0
  113. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_open_failure.py +0 -0
  114. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_precision.py +0 -0
  115. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_log_rotation_failure.py +0 -0
  116. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_low_severity_fixes.py +0 -0
  117. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_malformed_sessions.py +0 -0
  118. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_map_labels.py +0 -0
  119. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_model.py +0 -0
  120. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_mos.py +0 -0
  121. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_mos_alert.py +0 -0
  122. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_no_real_addresses.py +0 -0
  123. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_non_finite.py +0 -0
  124. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_option_ceilings.py +0 -0
  125. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_per_target_log.py +0 -0
  126. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_places.py +0 -0
  127. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_probe_rounds.py +0 -0
  128. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_probe_waves.py +0 -0
  129. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_refresh_loop.py +0 -0
  130. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_report_mode.py +0 -0
  131. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_route.py +0 -0
  132. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_route_history.py +0 -0
  133. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_routes.py +0 -0
  134. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_row_colours.py +0 -0
  135. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_save_soon.py +0 -0
  136. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_selfcheck.py +0 -0
  137. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings.py +0 -0
  138. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings_failures.py +0 -0
  139. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_settings_private.py +0 -0
  140. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_source_ip_enforced.py +0 -0
  141. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_stale_worker.py +0 -0
  142. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_stop_all_concurrently.py +0 -0
  143. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_target_settings_persist.py +0 -0
  144. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcp_hop_sockets_close.py +0 -0
  145. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcp_timeout_floor.py +0 -0
  146. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tcpudp.py +0 -0
  147. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_tkthreads.py +0 -0
  148. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_update_helper.py +0 -0
  149. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_updater.py +0 -0
  150. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_webhook_secrets.py +0 -0
  151. {pingerplot-1.6.0 → pingerplot-1.7.0}/tests/test_wheel.py +0 -0
@@ -1,9 +1,9 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pingerplot
3
- Version: 1.6.0
3
+ Version: 1.7.0
4
4
  Summary: A continuous-traceroute network path monitor (MTR-style) with a Tkinter GUI: per-hop latency, loss, jitter and MOS over time.
5
5
  Author: James Cupps
6
- License: MIT
6
+ License-Expression: MIT
7
7
  Project-URL: Homepage, https://github.com/jamesccupps/PingerPlot
8
8
  Project-URL: Source, https://github.com/jamesccupps/PingerPlot
9
9
  Project-URL: Issues, https://github.com/jamesccupps/PingerPlot/issues
@@ -13,7 +13,6 @@ Classifier: Environment :: Win32 (MS Windows)
13
13
  Classifier: Environment :: X11 Applications
14
14
  Classifier: Intended Audience :: System Administrators
15
15
  Classifier: Intended Audience :: Information Technology
16
- Classifier: License :: OSI Approved :: MIT License
17
16
  Classifier: Operating System :: Microsoft :: Windows
18
17
  Classifier: Operating System :: POSIX :: Linux
19
18
  Classifier: Operating System :: MacOS :: MacOS X
@@ -30,7 +29,7 @@ Dynamic: license-file
30
29
 
31
30
  [![Latest release](https://img.shields.io/github/v/release/jamesccupps/PingerPlot?label=release)](https://github.com/jamesccupps/PingerPlot/releases/latest)
32
31
  [![CI](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml/badge.svg)](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml)
33
- [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/LICENSE)
32
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE)
34
33
 
35
34
  Shows you *where* along a network path a connection goes wrong. Like `mtr` or WinMTR, PingerPlot finds every
36
35
  router between you and a target and then keeps probing all of them, so loss, latency, jitter and a voice-quality
@@ -42,10 +41,10 @@ when the destination degrades, and needs no administrator rights for ICMP.
42
41
  (`PingerPlot-Setup.exe`, Windows 10 or 11, 64-bit) ·
43
42
  [Portable zip](https://github.com/jamesccupps/PingerPlot/releases/latest/download/PingerPlot-win64.zip) ·
44
43
  [All releases](https://github.com/jamesccupps/PingerPlot/releases) ·
45
- [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) ·
44
+ [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) ·
46
45
  [Website](https://jamesccupps.github.io/PingerPlot/)
47
46
 
48
- ![PingerPlot in the dark theme: four targets on the left; the selected one is alerting, with its MOS, a red banner for loss and latency at the destination, a hop table where trouble starts at hop 4, and the destination's latency graph](https://raw.githubusercontent.com/jamesccupps/PingerPlot/v1.6.0/site/images/hops-dark.png)
47
+ ![PingerPlot in the dark theme: four targets on the left; the selected one is alerting, with its MOS, a red banner for loss and latency at the destination, a hop table where trouble starts at hop 4, and the destination's latency graph](https://raw.githubusercontent.com/jamesccupps/PingerPlot/v1.7.0/site/images/hops-dark.png)
49
48
 
50
49
  <sub>Demo mode: simulated paths with documentation addresses.</sub>
51
50
 
@@ -101,11 +100,11 @@ scoop install jamesccupps/pingerplot
101
100
  It installs the portable zip with a Start menu shortcut, keeps its settings in `%APPDATA%\PingerPlot`, and puts
102
101
  `pingerplot-headless` on your PATH. `scoop update pingerplot` updates it.
103
102
 
104
- **Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) below: one `pipx` command.
103
+ **Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) below: one `pipx` command.
105
104
 
106
105
  **From source** (Windows, Linux, macOS): Python 3.10 or newer, nothing to `pip install`.
107
106
  `git clone https://github.com/jamesccupps/PingerPlot`, then `python main.py`, or on Windows double-click
108
- `PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#running-from-source) for shortcuts and an elevated
107
+ `PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#running-from-source) for shortcuts and an elevated
109
108
  logon task.
110
109
 
111
110
  > **About antivirus warnings.** Some antivirus engines flag PyInstaller programs heuristically, and this one is a
@@ -127,17 +126,18 @@ or newer and Tk, which most distributions package separately:
127
126
  | openSUSE | `sudo zypper install python3-tk` |
128
127
 
129
128
  Then, with [pipx](https://pipx.pypa.io/) (`sudo apt install pipx` on Debian and Ubuntu, `sudo dnf install pipx` on
130
- Fedora, `sudo pacman -S python-pipx` on Arch), install it for your user and start it:
129
+ Fedora, `sudo pacman -S python-pipx` on Arch), install it from [PyPI](https://pypi.org/project/pingerplot/) for your
130
+ user and start it:
131
131
 
132
132
  ```bash
133
- pipx install git+https://github.com/jamesccupps/PingerPlot
133
+ pipx install pingerplot
134
134
  pingerplot
135
135
  ```
136
136
 
137
137
  In **Settings**, turn on **Show in the applications menu** to add it, with its icon, to your desktop's menu and
138
138
  search, and **Start when you sign in** if you want it monitoring from sign-in. To update: `pipx reinstall
139
139
  pingerplot` (the app checks once a day and says when there's a new version). To remove it, see
140
- [Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
140
+ [Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
141
141
 
142
142
  ICMP needs no root: it uses the kernel's unprivileged ICMP sockets, which most systemd-based distributions allow
143
143
  by default. If PingerPlot says the ICMP backend is unavailable, it names the one `sysctl` to run.
@@ -168,19 +168,23 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
168
168
  database (each says which), whose network it's on, and every router seen at that hop in the last day.
169
169
  - **Timeline**: every hop stacked on one time axis.
170
170
  - **Map**: the path on a map, zoomed to fit, each router placed by its name when that names a city and by
171
- the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#updates-and-privacy)), unless its round trip shows the database
171
+ the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#updates-and-privacy)), unless its round trip shows the database
172
172
  is wrong: a reply can't come from farther away than light in fiber travels in the time, so 1.1.1.1
173
173
  answering in 3 ms isn't in Brisbane. A router answering as fast as the one beside it, placed by its name,
174
174
  but put hundreds of kilometers from it is doubted too. Such a router is left off, and Details says why. The target's other
175
175
  routes from the last day are dashed underneath. Below it, **where the trouble is**: each place on the path, the delay it adds
176
176
  and the loss that starts there and carries to the destination (loss that stops at a router is that router
177
- ignoring pings, and isn't counted), with a one-line verdict.
177
+ ignoring pings, and isn't counted), with a one-line verdict. When other targets' loss starts at the same
178
+ router, the verdict says so: the trouble is that router or something before it, often your own side.
178
179
  - **Events**: route changes, alerts raised and cleared, warnings.
179
180
  3. **Pause**, **Stop** and **Edit settings** are at the top right. Editing a target's settings restarts it with
180
181
  them.
181
182
 
182
183
  - **⋯** on a card, or a right-click, has *Edit settings…*, *Pause*/*Resume*, *Stop*/*Start* and *Remove*.
183
184
  Right-click a hop for its details, or to copy its address, hostname or row. Ctrl+N goes back to the box.
185
+ - **From the keyboard**: Tab moves through everything, with the focus outlined; Return or Space chooses a tab, and
186
+ Left and Right move between tabs. In the target list, Up and Down change the target and the Menu key (or
187
+ Shift+F10) opens its menu. Ctrl+1 to Ctrl+4 open Hops, Timeline, Map and Events, and Ctrl+, opens Settings.
184
188
  - **Settings** holds the defaults for new targets (probing, alerts, logging and webhooks) and the app's own
185
189
  options: theme, resuming your targets at start, Start with Windows, the notification area, notifications and
186
190
  updates.
@@ -208,7 +212,9 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
208
212
  Y ms, MOS at or below Z, over the last N probes. The window is what makes it "sustained": a single spike won't trip
209
213
  a 20-probe window. `0` turns a check off. An alert raises when it crosses the threshold and clears by itself when it
210
214
  recovers; both go into Events, the banner, a notification (**Settings → Show a notification for alerts**), the
211
- optional sound and the webhook.
215
+ optional sound and the webhook. An alert's Events entry and webhook also say where on the path the trouble is, as
216
+ the Map does ("Loss reaching the destination starts in Chicago, US (hop 7, 12%)"), with each router placed by its
217
+ name; one whose name names no city stands for itself.
212
218
 
213
219
  Alerts judge the destination only, the one hop whose numbers aren't muddied by routers deprioritizing ICMP, and
214
220
  only once it has answered, so a target that simply blocks ICMP never false-alarms. The window counts only probes
@@ -217,7 +223,8 @@ held that TTL in the meantime, and its rate-limited "TTL exceeded" replies aren'
217
223
  table still shows per-TTL statistics across responders, as `mtr` does.
218
224
 
219
225
  **Webhook** (**Settings → Logging and webhooks**): an `https://` or `http://` address gets a JSON POST when an alert
220
- raises or clears. A delivery that fails is a warning in Events naming only the host, never the full address
226
+ raises or clears: `app`, `event` (`alert` or `clear`), `target`, `target_ip`, `text` and `time`, and for an alert
227
+ `where`, the places on the path worst first, each `{place, hops, delay_added_ms, loss_starts_pct}`. A delivery that fails is a warning in Events naming only the host, never the full address
221
228
  (Slack, Teams and ntfy put the secret in the path).
222
229
 
223
230
  ## Probe modes
@@ -279,7 +286,7 @@ pinned run measured something different from a plain one.
279
286
  Everything PingerPlot measures is kept, with nothing to set up: every probe and the router that answered it,
280
287
  per-minute loss, latency and jitter for each hop and router, every event (alerts, reroutes, DNS moves, warnings),
281
288
  and which route each target was on, when. It goes into one SQLite database on this computer (see
282
- [Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
289
+ [Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
283
290
 
284
291
  - **Reroutes, not noise.** A hop whose router changes and stays changed for 3 rounds is a reroute: one event that
285
292
  names the hops that moved. A hop that takes turns between routers (load balancing over parallel links) is noted
@@ -350,7 +357,9 @@ problem…** opens a GitHub issue form with the version filled in, which you edi
350
357
  ## Where it keeps things
351
358
 
352
359
  - `%APPDATA%\PingerPlot\` holds `settings.json` (your targets, each with its settings, and the app's options),
353
- `update.log`, the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a month).
360
+ `update.log`, `error.log` (errors, and when PingerPlot started and quit; the headless runner's is
361
+ `headless-error.log`), the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a
362
+ month).
354
363
  On Linux and macOS it's `$XDG_CONFIG_HOME/PingerPlot`, usually `~/.config/PingerPlot`.
355
364
  - A portable copy keeps them beside `PingerPlot.exe` instead. Delete `portable.txt` to make it use `%APPDATA%`.
356
365
  - On Linux, the menu and sign-in entries are `~/.local/share/applications/pingerplot.desktop` and
@@ -391,7 +400,7 @@ task at `pingerplot-headless.exe C:\path\to\monitor.json` (or `pythonw.exe -m pi
391
400
  Besides the status lines, it prints every event as it happens: alerts raised and cleared, route changes, and
392
401
  warnings such as a probe log it couldn't open or a webhook that wasn't delivered.
393
402
 
394
- It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#history) as the window, so the window shows what it measured. A `recording`
403
+ It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#history) as the window, so the window shows what it measured. A `recording`
395
404
  object in the config changes that: `"recording": {"enabled": false}` turns it off, and `probe_days`,
396
405
  `summary_days`, `event_days` and `max_mb` set how much is kept, as in Settings → Recording.
397
406
 
@@ -431,7 +440,7 @@ example.net: now vs last-week
431
440
  **Windows 10 and 11: tested**, and the only platform with a download. The ICMP backend (`icmp.py`) uses the Win32
432
441
  IP Helper API, so it needs no admin rights and no capture driver.
433
442
 
434
- **Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
443
+ **Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
435
444
  from source. `icmp_posix.py` uses
436
445
  unprivileged `SOCK_DGRAM`/`IPPROTO_ICMP` sockets, the same technique `mtr` uses, and `icmp.ping()` dispatches to it,
437
446
  so the engine, window and headless runner don't know which backend answered.
@@ -501,17 +510,18 @@ session if you want the probes logged.
501
510
 
502
511
  | What you see | Fix |
503
512
  |---|---|
513
+ | Something went wrong, or PingerPlot quit or stopped recording | `error.log` in the settings folder (above) has the error and when PingerPlot started and quit. Web addresses in it are cut to their host, so it's safe to attach to an issue. |
504
514
  | Loss at a hop in the middle | Usually normal: that router rate-limits the replies it generates. Only loss that reaches the destination row is a problem. |
505
515
  | "Full TCP/UDP traceroute needs Administrator" | Click **Restart as administrator** beside it (or ⋯ → Restart as administrator), or use ICMP, or TCP with **Destination only**. From source, `launch.ps1 -Elevated`. |
506
516
  | "Full TCP/UDP traceroute is Windows-only for now" (Linux, macOS) | Use ICMP, or TCP with **Destination only**. |
507
- | "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux)). |
517
+ | "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux)). |
508
518
  | A target shows "Cannot resolve" | DNS for that name failed. The window doesn't retry by itself: **⋯ → Start** on its card once the network is up. (The headless runner retries.) |
509
519
  | No notification for an alert | **Settings → Show a notification for alerts**, then Windows' *Settings → System → Notifications* for PingerPlot, and Do not disturb. |
510
- | The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back. |
520
+ | The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back, on Linux too (one copy runs at a time). |
511
521
  | "Windows protected your PC" | **More info** should show the publisher, James Cupps, then **Run anyway**. |
512
522
  | "The probe log couldn't roll over" in Events | The CSV is open in another program, usually Excel. It keeps appending and tries again a minute later. |
513
- | The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. |
514
- | "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#platform)). |
523
+ | The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. If the headless runner runs from PingerPlot's folder (a Task Scheduler task), stop it first: Windows won't replace a program that's running, and PingerPlot says so rather than start an update that can't finish. |
524
+ | "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#platform)). |
515
525
 
516
526
  ## Uninstalling
517
527
 
@@ -569,14 +579,14 @@ failure), then builds the Windows release files, runs the built app's self-test,
569
579
  the installer, and has a copy update itself to the build. A version tag (`v1.4.0`) builds, tests, signs and
570
580
  publishes the release. The release workflow's build job is read-only, only a job that installs nothing holds the
571
581
  signing key, and only one that runs nothing but `gh` can publish; every action is pinned by commit SHA and the
572
- build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/CLAUDE.md) has the architecture, the release process and
573
- what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/CONTRIBUTING.md) how to
582
+ build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CLAUDE.md) has the architecture, the release process and
583
+ what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CONTRIBUTING.md) how to
574
584
  help.
575
585
 
576
586
  ## License
577
587
 
578
- MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
579
- [THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/THIRD-PARTY-NOTICES.md).
588
+ MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
589
+ [THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/THIRD-PARTY-NOTICES.md).
580
590
 
581
591
  PingerPlot is an independent hobby project, not affiliated with or endorsed by any commercial network-monitoring
582
592
  product. It is a **read-only diagnostic**: it sends probes and reads replies, and never writes to or reconfigures
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![Latest release](https://img.shields.io/github/v/release/jamesccupps/PingerPlot?label=release)](https://github.com/jamesccupps/PingerPlot/releases/latest)
4
4
  [![CI](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml/badge.svg)](https://github.com/jamesccupps/PingerPlot/actions/workflows/ci.yml)
5
- [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/LICENSE)
5
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE)
6
6
 
7
7
  Shows you *where* along a network path a connection goes wrong. Like `mtr` or WinMTR, PingerPlot finds every
8
8
  router between you and a target and then keeps probing all of them, so loss, latency, jitter and a voice-quality
@@ -14,10 +14,10 @@ when the destination degrades, and needs no administrator rights for ICMP.
14
14
  (`PingerPlot-Setup.exe`, Windows 10 or 11, 64-bit) ·
15
15
  [Portable zip](https://github.com/jamesccupps/PingerPlot/releases/latest/download/PingerPlot-win64.zip) ·
16
16
  [All releases](https://github.com/jamesccupps/PingerPlot/releases) ·
17
- [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) ·
17
+ [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) ·
18
18
  [Website](https://jamesccupps.github.io/PingerPlot/)
19
19
 
20
- ![PingerPlot in the dark theme: four targets on the left; the selected one is alerting, with its MOS, a red banner for loss and latency at the destination, a hop table where trouble starts at hop 4, and the destination's latency graph](https://raw.githubusercontent.com/jamesccupps/PingerPlot/v1.6.0/site/images/hops-dark.png)
20
+ ![PingerPlot in the dark theme: four targets on the left; the selected one is alerting, with its MOS, a red banner for loss and latency at the destination, a hop table where trouble starts at hop 4, and the destination's latency graph](https://raw.githubusercontent.com/jamesccupps/PingerPlot/v1.7.0/site/images/hops-dark.png)
21
21
 
22
22
  <sub>Demo mode: simulated paths with documentation addresses.</sub>
23
23
 
@@ -73,11 +73,11 @@ scoop install jamesccupps/pingerplot
73
73
  It installs the portable zip with a Start menu shortcut, keeps its settings in `%APPDATA%\PingerPlot`, and puts
74
74
  `pingerplot-headless` on your PATH. `scoop update pingerplot` updates it.
75
75
 
76
- **Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) below: one `pipx` command.
76
+ **Linux:** see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) below: one `pipx` command.
77
77
 
78
78
  **From source** (Windows, Linux, macOS): Python 3.10 or newer, nothing to `pip install`.
79
79
  `git clone https://github.com/jamesccupps/PingerPlot`, then `python main.py`, or on Windows double-click
80
- `PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#running-from-source) for shortcuts and an elevated
80
+ `PingerPlot.vbs` (no console window). See [Running from source](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#running-from-source) for shortcuts and an elevated
81
81
  logon task.
82
82
 
83
83
  > **About antivirus warnings.** Some antivirus engines flag PyInstaller programs heuristically, and this one is a
@@ -99,17 +99,18 @@ or newer and Tk, which most distributions package separately:
99
99
  | openSUSE | `sudo zypper install python3-tk` |
100
100
 
101
101
  Then, with [pipx](https://pipx.pypa.io/) (`sudo apt install pipx` on Debian and Ubuntu, `sudo dnf install pipx` on
102
- Fedora, `sudo pacman -S python-pipx` on Arch), install it for your user and start it:
102
+ Fedora, `sudo pacman -S python-pipx` on Arch), install it from [PyPI](https://pypi.org/project/pingerplot/) for your
103
+ user and start it:
103
104
 
104
105
  ```bash
105
- pipx install git+https://github.com/jamesccupps/PingerPlot
106
+ pipx install pingerplot
106
107
  pingerplot
107
108
  ```
108
109
 
109
110
  In **Settings**, turn on **Show in the applications menu** to add it, with its icon, to your desktop's menu and
110
111
  search, and **Start when you sign in** if you want it monitoring from sign-in. To update: `pipx reinstall
111
112
  pingerplot` (the app checks once a day and says when there's a new version). To remove it, see
112
- [Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
113
+ [Uninstalling](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#uninstalling). Or skip pipx: `git clone` and `python3 main.py` works the same.
113
114
 
114
115
  ICMP needs no root: it uses the kernel's unprivileged ICMP sockets, which most systemd-based distributions allow
115
116
  by default. If PingerPlot says the ICMP backend is unavailable, it names the one `sysctl` to run.
@@ -140,19 +141,23 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
140
141
  database (each says which), whose network it's on, and every router seen at that hop in the last day.
141
142
  - **Timeline**: every hop stacked on one time axis.
142
143
  - **Map**: the path on a map, zoomed to fit, each router placed by its name when that names a city and by
143
- the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#updates-and-privacy)), unless its round trip shows the database
144
+ the IP database otherwise (see [privacy](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#updates-and-privacy)), unless its round trip shows the database
144
145
  is wrong: a reply can't come from farther away than light in fiber travels in the time, so 1.1.1.1
145
146
  answering in 3 ms isn't in Brisbane. A router answering as fast as the one beside it, placed by its name,
146
147
  but put hundreds of kilometers from it is doubted too. Such a router is left off, and Details says why. The target's other
147
148
  routes from the last day are dashed underneath. Below it, **where the trouble is**: each place on the path, the delay it adds
148
149
  and the loss that starts there and carries to the destination (loss that stops at a router is that router
149
- ignoring pings, and isn't counted), with a one-line verdict.
150
+ ignoring pings, and isn't counted), with a one-line verdict. When other targets' loss starts at the same
151
+ router, the verdict says so: the trouble is that router or something before it, often your own side.
150
152
  - **Events**: route changes, alerts raised and cleared, warnings.
151
153
  3. **Pause**, **Stop** and **Edit settings** are at the top right. Editing a target's settings restarts it with
152
154
  them.
153
155
 
154
156
  - **⋯** on a card, or a right-click, has *Edit settings…*, *Pause*/*Resume*, *Stop*/*Start* and *Remove*.
155
157
  Right-click a hop for its details, or to copy its address, hostname or row. Ctrl+N goes back to the box.
158
+ - **From the keyboard**: Tab moves through everything, with the focus outlined; Return or Space chooses a tab, and
159
+ Left and Right move between tabs. In the target list, Up and Down change the target and the Menu key (or
160
+ Shift+F10) opens its menu. Ctrl+1 to Ctrl+4 open Hops, Timeline, Map and Events, and Ctrl+, opens Settings.
156
161
  - **Settings** holds the defaults for new targets (probing, alerts, logging and webhooks) and the app's own
157
162
  options: theme, resuming your targets at start, Start with Windows, the notification area, notifications and
158
163
  updates.
@@ -180,7 +185,9 @@ CI starts the app on Ubuntu on every push: the window's self-test, a probe of lo
180
185
  Y ms, MOS at or below Z, over the last N probes. The window is what makes it "sustained": a single spike won't trip
181
186
  a 20-probe window. `0` turns a check off. An alert raises when it crosses the threshold and clears by itself when it
182
187
  recovers; both go into Events, the banner, a notification (**Settings → Show a notification for alerts**), the
183
- optional sound and the webhook.
188
+ optional sound and the webhook. An alert's Events entry and webhook also say where on the path the trouble is, as
189
+ the Map does ("Loss reaching the destination starts in Chicago, US (hop 7, 12%)"), with each router placed by its
190
+ name; one whose name names no city stands for itself.
184
191
 
185
192
  Alerts judge the destination only, the one hop whose numbers aren't muddied by routers deprioritizing ICMP, and
186
193
  only once it has answered, so a target that simply blocks ICMP never false-alarms. The window counts only probes
@@ -189,7 +196,8 @@ held that TTL in the meantime, and its rate-limited "TTL exceeded" replies aren'
189
196
  table still shows per-TTL statistics across responders, as `mtr` does.
190
197
 
191
198
  **Webhook** (**Settings → Logging and webhooks**): an `https://` or `http://` address gets a JSON POST when an alert
192
- raises or clears. A delivery that fails is a warning in Events naming only the host, never the full address
199
+ raises or clears: `app`, `event` (`alert` or `clear`), `target`, `target_ip`, `text` and `time`, and for an alert
200
+ `where`, the places on the path worst first, each `{place, hops, delay_added_ms, loss_starts_pct}`. A delivery that fails is a warning in Events naming only the host, never the full address
193
201
  (Slack, Teams and ntfy put the secret in the path).
194
202
 
195
203
  ## Probe modes
@@ -251,7 +259,7 @@ pinned run measured something different from a plain one.
251
259
  Everything PingerPlot measures is kept, with nothing to set up: every probe and the router that answered it,
252
260
  per-minute loss, latency and jitter for each hop and router, every event (alerts, reroutes, DNS moves, warnings),
253
261
  and which route each target was on, when. It goes into one SQLite database on this computer (see
254
- [Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
262
+ [Where it keeps things](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#where-it-keeps-things)), shared by the window and the headless runner.
255
263
 
256
264
  - **Reroutes, not noise.** A hop whose router changes and stays changed for 3 rounds is a reroute: one event that
257
265
  names the hops that moved. A hop that takes turns between routers (load balancing over parallel links) is noted
@@ -322,7 +330,9 @@ problem…** opens a GitHub issue form with the version filled in, which you edi
322
330
  ## Where it keeps things
323
331
 
324
332
  - `%APPDATA%\PingerPlot\` holds `settings.json` (your targets, each with its settings, and the app's options),
325
- `update.log`, the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a month).
333
+ `update.log`, `error.log` (errors, and when PingerPlot started and quit; the headless runner's is
334
+ `headless-error.log`), the history in `history\history.sqlite3`, and `lookups.json` (where routers are, kept a
335
+ month).
326
336
  On Linux and macOS it's `$XDG_CONFIG_HOME/PingerPlot`, usually `~/.config/PingerPlot`.
327
337
  - A portable copy keeps them beside `PingerPlot.exe` instead. Delete `portable.txt` to make it use `%APPDATA%`.
328
338
  - On Linux, the menu and sign-in entries are `~/.local/share/applications/pingerplot.desktop` and
@@ -363,7 +373,7 @@ task at `pingerplot-headless.exe C:\path\to\monitor.json` (or `pythonw.exe -m pi
363
373
  Besides the status lines, it prints every event as it happens: alerts raised and cleared, route changes, and
364
374
  warnings such as a probe log it couldn't open or a webhook that wasn't delivered.
365
375
 
366
- It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#history) as the window, so the window shows what it measured. A `recording`
376
+ It records into the same [history](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#history) as the window, so the window shows what it measured. A `recording`
367
377
  object in the config changes that: `"recording": {"enabled": false}` turns it off, and `probe_days`,
368
378
  `summary_days`, `event_days` and `max_mb` set how much is kept, as in Settings → Recording.
369
379
 
@@ -403,7 +413,7 @@ example.net: now vs last-week
403
413
  **Windows 10 and 11: tested**, and the only platform with a download. The ICMP backend (`icmp.py`) uses the Win32
404
414
  IP Helper API, so it needs no admin rights and no capture driver.
405
415
 
406
- **Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
416
+ **Linux: tested in CI** (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux) for installing it). **macOS: implemented, untested on a Mac.** Both run
407
417
  from source. `icmp_posix.py` uses
408
418
  unprivileged `SOCK_DGRAM`/`IPPROTO_ICMP` sockets, the same technique `mtr` uses, and `icmp.ping()` dispatches to it,
409
419
  so the engine, window and headless runner don't know which backend answered.
@@ -473,17 +483,18 @@ session if you want the probes logged.
473
483
 
474
484
  | What you see | Fix |
475
485
  |---|---|
486
+ | Something went wrong, or PingerPlot quit or stopped recording | `error.log` in the settings folder (above) has the error and when PingerPlot started and quit. Web addresses in it are cut to their host, so it's safe to attach to an issue. |
476
487
  | Loss at a hop in the middle | Usually normal: that router rate-limits the replies it generates. Only loss that reaches the destination row is a problem. |
477
488
  | "Full TCP/UDP traceroute needs Administrator" | Click **Restart as administrator** beside it (or ⋯ → Restart as administrator), or use ICMP, or TCP with **Destination only**. From source, `launch.ps1 -Elevated`. |
478
489
  | "Full TCP/UDP traceroute is Windows-only for now" (Linux, macOS) | Use ICMP, or TCP with **Destination only**. |
479
- | "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#linux)). |
490
+ | "PingerPlot's window needs Tk" (Linux) | Install the package it names for your distribution (see [Linux](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#linux)). |
480
491
  | A target shows "Cannot resolve" | DNS for that name failed. The window doesn't retry by itself: **⋯ → Start** on its card once the network is up. (The headless runner retries.) |
481
492
  | No notification for an alert | **Settings → Show a notification for alerts**, then Windows' *Settings → System → Notifications* for PingerPlot, and Do not disturb. |
482
- | The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back. |
493
+ | The window is gone | It's in the notification area: click the tray icon. Starting PingerPlot again also brings it back, on Linux too (one copy runs at a time). |
483
494
  | "Windows protected your PC" | **More info** should show the publisher, James Cupps, then **Run anyway**. |
484
495
  | "The probe log couldn't roll over" in Events | The CSV is open in another program, usually Excel. It keeps appending and tries again a minute later. |
485
- | The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. |
486
- | "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/README.md#platform)). |
496
+ | The update didn't install | Details are in `update.log` in the settings folder. The previous version keeps running; the release page always has the full installer. If the headless runner runs from PingerPlot's folder (a Task Scheduler task), stop it first: Windows won't replace a program that's running, and PingerPlot says so rather than start an update that can't finish. |
497
+ | "ICMP backend unavailable" on Linux | `sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"` (see [Platform](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/README.md#platform)). |
487
498
 
488
499
  ## Uninstalling
489
500
 
@@ -541,14 +552,14 @@ failure), then builds the Windows release files, runs the built app's self-test,
541
552
  the installer, and has a copy update itself to the build. A version tag (`v1.4.0`) builds, tests, signs and
542
553
  publishes the release. The release workflow's build job is read-only, only a job that installs nothing holds the
543
554
  signing key, and only one that runs nothing but `gh` can publish; every action is pinned by commit SHA and the
544
- build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/CLAUDE.md) has the architecture, the release process and
545
- what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/CONTRIBUTING.md) how to
555
+ build tools by hash, all enforced by tests. [CLAUDE.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CLAUDE.md) has the architecture, the release process and
556
+ what was learned along the way; [ROADMAP.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/ROADMAP.md) what's planned; [CONTRIBUTING.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/CONTRIBUTING.md) how to
546
557
  help.
547
558
 
548
559
  ## License
549
560
 
550
- MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
551
- [THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.6.0/THIRD-PARTY-NOTICES.md).
561
+ MIT: see [LICENSE](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/LICENSE). The libraries inside the Windows build are listed, with their licenses, in
562
+ [THIRD-PARTY-NOTICES.md](https://github.com/jamesccupps/PingerPlot/blob/v1.7.0/THIRD-PARTY-NOTICES.md).
552
563
 
553
564
  PingerPlot is an independent hobby project, not affiliated with or endorsed by any commercial network-monitoring
554
565
  product. It is a **read-only diagnostic**: it sends probes and reads replies, and never writes to or reconfigures
@@ -5,4 +5,4 @@ Npcap are required for ICMP: Windows uses the IP Helper API via ctypes, and
5
5
  Linux/macOS use unprivileged SOCK_DGRAM ICMP sockets (see icmp_posix).
6
6
  """
7
7
 
8
- __version__ = "1.6.0"
8
+ __version__ = "1.7.0"
@@ -0,0 +1,137 @@
1
+ """What went wrong, kept: a small log in the settings folder of errors, and of
2
+ when PingerPlot started, quit and restarted.
3
+
4
+ The installed app has no console. An exception in a window callback or a
5
+ background thread was printed to a stderr that doesn't exist, and the
6
+ package's loggers (updates, the tray icon, Start with Windows) wrote to the
7
+ same nowhere, so a copy that quit early or stopped recording left no trace
8
+ (2026-11-18: 25 targets ended half a minute after an update, and nothing
9
+ said why). Everything logged under "pingerplot" now lands here, with each
10
+ uncaught exception's traceback.
11
+
12
+ Run as administrator, PingerPlot writes this file like the history: never
13
+ through a link or junction, which any program running as you could plant
14
+ in the settings folder. A URL is cut to its host: a webhook's secret is its
15
+ path.
16
+ """
17
+ from __future__ import annotations
18
+
19
+ import logging
20
+ import logging.handlers
21
+ import re
22
+ import sys
23
+ import threading
24
+ import traceback
25
+ from pathlib import Path
26
+ from typing import Optional
27
+
28
+ NAMES = {"gui": "error.log", "headless": "headless-error.log"}
29
+ MAX_BYTES = 256 * 1024 # then one older file, error.log.1
30
+
31
+ log = logging.getLogger("pingerplot")
32
+
33
+ _URL = re.compile(r"(\b[a-z][a-z0-9+.-]*://[^/\s'\"<>]+)[^\s'\"<>]*", re.I)
34
+
35
+
36
+ def scrub(text: str) -> str:
37
+ """``text`` with every URL cut to its scheme and host."""
38
+ return _URL.sub(lambda m: m.group(1) + ("/…" if len(m.group(0)) > len(m.group(1)) else ""), text)
39
+
40
+
41
+ class _Scrubbed(logging.Formatter):
42
+ def format(self, record: logging.LogRecord) -> str:
43
+ return scrub(super().format(record))
44
+
45
+
46
+ class _Handler(logging.handlers.RotatingFileHandler):
47
+ def _open(self):
48
+ from .history import _is_link
49
+ path = Path(self.baseFilename)
50
+ for p in (path.parent, path):
51
+ if _is_link(p):
52
+ raise OSError(f"{p} is a link or junction, and PingerPlot won't write through one")
53
+ return super()._open()
54
+
55
+
56
+ _installed: Optional[_Handler] = None
57
+ _previous_hooks = None
58
+
59
+
60
+ def _default_folder() -> Path:
61
+ from . import settings
62
+ return settings.config_dir()
63
+
64
+
65
+ def install(program: str = "gui", folder: Optional[Path] = None) -> Optional[Path]:
66
+ """Start logging to ``folder`` (the settings folder by default) and catch
67
+ uncaught exceptions on every thread. Returns the log's path, or None when
68
+ it can't be written (a link, a folder that can't be made)."""
69
+ global _installed
70
+ if _installed is not None:
71
+ return Path(_installed.baseFilename)
72
+ path = Path(folder if folder is not None else _default_folder()) / NAMES[program]
73
+ try:
74
+ path.parent.mkdir(parents=True, exist_ok=True)
75
+ handler = _Handler(path, maxBytes=MAX_BYTES, backupCount=1, encoding="utf-8", delay=True)
76
+ except OSError:
77
+ return None
78
+ handler.setFormatter(_Scrubbed("%(asctime)s %(levelname)s %(name)s: %(message)s", "%Y-%m-%d %H:%M:%S"))
79
+ log.addHandler(handler)
80
+ if sys.stderr is not None:
81
+ # Run from a terminal, warnings and tracebacks still show there too
82
+ # (the handler above stops logging's own last-resort printing).
83
+ console = logging.StreamHandler()
84
+ console.setLevel(logging.WARNING)
85
+ console.setFormatter(_Scrubbed("%(levelname)s %(name)s: %(message)s"))
86
+ log.addHandler(console)
87
+ log.setLevel(logging.INFO)
88
+ _installed = handler
89
+ global _previous_hooks
90
+ previous_hook, previous_thread_hook = _previous_hooks = sys.excepthook, threading.excepthook
91
+
92
+ def hook(exc_type, exc, tb):
93
+ if issubclass(exc_type, KeyboardInterrupt):
94
+ previous_hook(exc_type, exc, tb)
95
+ return
96
+ exception("Uncaught", (exc_type, exc, tb))
97
+ if previous_hook is not sys.__excepthook__: # the default would print it twice
98
+ previous_hook(exc_type, exc, tb)
99
+
100
+ def thread_hook(args):
101
+ if args.exc_type is SystemExit:
102
+ return
103
+ name = args.thread.name if args.thread is not None else "?"
104
+ exception(f"Uncaught in thread {name}", (args.exc_type, args.exc_value, args.exc_traceback))
105
+ if previous_thread_hook is not threading.__excepthook__:
106
+ previous_thread_hook(args)
107
+
108
+ sys.excepthook, threading.excepthook = hook, thread_hook
109
+ return path
110
+
111
+
112
+ def uninstall() -> None:
113
+ """Stop logging to the file and put back the exception hooks found (tests)."""
114
+ global _installed, _previous_hooks
115
+ for h in list(log.handlers):
116
+ log.removeHandler(h)
117
+ h.close()
118
+ _installed = None
119
+ if _previous_hooks is not None:
120
+ sys.excepthook, threading.excepthook = _previous_hooks
121
+ _previous_hooks = None
122
+
123
+
124
+ def exception(where: str, exc_info) -> None:
125
+ text = "".join(traceback.format_exception(*exc_info)).rstrip()
126
+ log.error("%s:\n%s", where, text)
127
+
128
+
129
+ def tk_callback(exc_type, exc, tb) -> None:
130
+ """For ``Tk.report_callback_exception``: Tk's own prints to stderr, which
131
+ the installed app doesn't have."""
132
+ exception("In the window", (exc_type, exc, tb))
133
+
134
+
135
+ def note(message: str) -> None:
136
+ """A line about the app itself: started, quit, restarted."""
137
+ logging.getLogger("pingerplot.app").info(message)