github jokob-sk/NetAlertX v23.9.10
๐ŸงฑBuilding solid foundations & ๐ŸงนCleanup

latest releases: v24.9.12, v24.7.18, v24.6.8...
12 months ago

This release is about building solid foundations by moving a lot of functionality into Plugins and keeping the core app clean. The app will thus be easier to maintain, and the core app functionality is easier to understand, debug, and extend. I also leveled up the Plugin capabilities to cover even more use cases. @cvc90 was making huge contributions to this release. ๐Ÿ™ His contributions include more UI capabilities a lot of Spanish translations and more.

Please be patient, this has been an enormous release and there will be bugs ๐Ÿ› I also have a LOT going on in my work and life so any ever-so-small recurring sponsorship makes the effort I put into this app easier to justify (e.g. waking up 2h earlier for work just so I contribute to the app a bit) - I'm super grateful for any contribution โค

Screenshots

Screen 1 Screen 2 Screen 5
Screen 3 Screen 4 Screen 6
๐Ÿ†• - New features ๐Ÿš‘ - Fixer & Improvements โš  Possibly breaking changes

๐Ÿ’” Breaking changes

Sometimes I have to introduce breaking changes - it breaks my heart, but we must move forward

Removed setting: DHCP_ACTIVE

  • Functionality replaced by the DHCPLSS plugin:
    • DHCPLSS_RUN: You need to map :/etc/pihole/dhcp.leases in the docker-compose.yml file if you enable this setting. This has to be matched with a corresponding DHCPLSS_paths_to_check setting entry (the path in the container must contain pihole).
      Removed setting: SCAN_CYCLE_MINUTES
  • Replaced by corresponding plugin scan intervals. E.g. PIHOLE_RUN_SCHD or DHCPLSS_RUN_SCHD

๐Ÿ“šDocs updates

โš™Settings

I removed some hard-coded settings and moved them into plugins. Thus some settings were obsolete or replaced by plugin settings.

  • Removed settings: SCAN_CYCLE_MINUTES, ENABLE_PLUGINS, PHOLUS_FORCE, PHOLUS_ACTIVE , DHCP_ACTIVE, PIHOLE_ACTIVE, ENABLE_ARPSCAN

๐ŸŒŸ๐Ÿ”ŒPlugins

  • New Spanish plugin translations by @cvc90 ๐Ÿ™
  • Added plugins:
    • SETPWD for setting the UI password via the UI (๐Ÿ†•)
    • PIHOLE replacing the built-in PiHole database mapping (๐Ÿš‘, ๐Ÿ†•)
    • ARPSCAN replacing the built-in Arp-Scan (๐Ÿš‘, ๐Ÿ†•)
    • PHOLUS replacing the built-in Pholus-Scan name discovery functionality (๐Ÿš‘, ๐Ÿ†•)
    • NMAP replacing the built-in Nmap functionality (๐Ÿš‘, ๐Ÿ†•)
    • UNFIMP Unifi plugin improvements by @andreasbrett and @tuhriel ๐Ÿ™ (๐Ÿš‘, ๐Ÿ†•)
    • CSVBCKP CSV backup script for scheduling regular exports that can be imported via the Maintenance section. (๐Ÿ†•)

๐Ÿ–ผ UI

  • Network view UI fixes (double digit port number, click node to select) #298 (๐Ÿš‘)
  • Day filter and hover-over message moved to the bottom courtesy of @leiweibau ๐Ÿ™ #294 (๐Ÿš‘, ๐Ÿ†•)
  • Version display in footer and email (๐Ÿ†•๐Ÿ›) by @cvc90
  • System info section (๐Ÿ†•) by @cvc90 and based on work by @leiweibau
  • Reports section (๐Ÿ†•) by @cvc90
  • Removal of Pholus and Nmap tabs as moved into Plugins
  • More network tools on specific devices in the Tools tab (๐Ÿ†•) by @cvc90

๐Ÿ’ Core app updates

Internal changes significant to developers ๐Ÿ‘ฉโ€๐Ÿ’ป๐Ÿ‘จโ€๐Ÿ’ป

  • Settings now store also metadata in a separate __metadata config entry. It will be used to add more capabilities to settings.
  • Most of the settings page rewritten to JavaScript for easier debugging & development
  • String files rewritten from PHP to JSON
  • PiHole import removed from the core app
  • Arp-scan removed from the core app
  • Pholus-scan removed from the core app (table still present - flagged for future removal)
  • Mapping a plugin to the CurrentScan table manages online status of devices and updates scan results accordingly
  • Plugins support querying data from external SQLite databases (added to the docs)
  • Plugins now support to be executed on before_config_save of the pialert.conf file that allows to modify the file with Plugins (used in the new SETPWD plugin) (added to the docs)
  • Plugins now allow for default value for a column mapping via the "mapped_to_column_data": { "value": "my_value" } property (added to the docs)
  • UI resolvers for values shown in Plugin tables now support chaining. You can chain multiple resolvers with .. For example regex.url_http_https. This will apply the regex resolver and then the url_http_https resolver. (added to the docs)
  • De-duplication is run once an hour on the Plugins_Objects database table and duplicate entries with the same value in columns Object_PrimaryID, Object_SecondaryID, Plugin (auto-filled based on unique_prefix of the plugin), UserData (can be populated with the "type": "textboxsave" column type) are removed. (this is a workaround for the duplicate entries bug that is probably caused by a race condition somewhere in the code)
  • Removal of now unnecessary database tables: DHCP_Leases, PiHole_Network, ScanCycles (โš )

New Contributors

Full Changelog: v23.7.22...v23.9.10

Don't miss a new NetAlertX release

NewReleases is sending notifications on new releases.