Releases: jokob-sk/NetAlertX
24.2.17 - 🩹Hotfix + 🌍Easier translations, NEW 🔔Pushover &🔍NSLOOKUP plugins and more
I was a bit too quick to push a release yesterday - sorry guys! 🙏
🩹 Hotfix:
- The devices list didn't populate unless the network tab was previously fully set up #568 (🚑)
Another month, another release 🥳
Thank you to @Schlump for treating a Pushover plugin. I spend time creating an NSLOOKUP
plugin for better name resolution, I started on Workflows 🦺 (Event capture only - feedback here) and integrated Weblate for easier translations. Help translate and suggest languages in the online portal of Weblate - no Git experience needed (French & Norwegian in the works) - Create an account and contribute right away. Check the below details for new settings and configuration options 👇
Screenshots
🏘️ Community content
The user @liability4400 noticed an unusual entry within PiAlert, with an IP address that changed to a different one after about 5 minutes. The user wonders "Am I in danger?" Help him solve this question. 🤔
Do you want another icon pack? Feedback here on which one you'd like to see supported: #550
📚Docs updates
- A short guide on setting up Reverse DNS on AdGuard for better name discovery on your network (🆕)
⚙Settings
- The
NTFY
plugin now has a priority selection #553 (🆕) - The
NEWDEV
plugin comes with a MAC filter #539 (🆕) - Renamed
All Devices
toMy Devices
and added a settingUI_MY_DEVICES
to select which devices based on their status to show #548 (🆕) - You can now exclude Mac addresses from being marked as random via the
UI_NOT_RANDOM_MAC
setting #566 (🆕)
🔌Plugins
- New
NSLOOKUP
plugin for better name discovery #543 - thanks to @uldtot for the tip (🆕) - New native
PUSHOVER
plugin by @Schlump 🙏 (🆕) - Vendors were not brought over in the
UNFIMP
plugin #567 (🚑)
🖼 UI
- The
New
status now takes precedence over theOnline
status as per request #549 (🚑) - German translation improvements and fixes by @leiweibau 🙏(🚑)
- New columns for Port and Connections in the Devices list to show how many Devices are connected to a Network device #556 (🚑)
- Dark theme fixes (darker loading screen overlay) (🚑)
- Small Network page fixes to always display bottom tabs no matter the screen size (🚑)
Other Info
🆕 - New features | 🚑 - Fixes & Improvements | ⚠ - Possibly breaking changes | 🧪 - Experimental feature |
---|
24.01.18 - 📩 MQTT Home Assistant integration, 📣 Notifications , 🍓 PiHole improvements and 🧪ARMv6 support
Happy 2024! 🥳
This release enhances user control with new settings, plugins, and UI improvements, making it easier to manage notifications and integrate seamlessly with Home Assistant. Plus, enjoy experimental ARMv6 support for Raspberry Pi Zero users!
Thank you @dtech77pl @demolishedman50 @sky4055, @jordantrizz, @kurfuer, @wial88, @cristiarcaleanu for the sponsorship 🙏 - this is sometimes the motivation boost I need 💪 My sponsorship goal is to dedicate one full workday a week to this project.
Screenshots
📚Docs updates
- Added a link to a Chinese community guide: 📄 网络入侵探测器Pi.Alert (Chinese) (May 2023)
- Plugin troubleshooting
⚙Settings
- A new
NTFPRCS_alert_down_time
setting to specify how long in minutes to wait before a device is reported as being down #242 (🆕) - A new
NTFPRCS_new_dev_condition
setting to filter out New devices from reports (🆕) - A new
NTFPRCS_event_condition
setting to filter out Events from reports (🆕) - This version renames the
PIHOLE_CMD
setting toPIHOLE_CMD_OLD
to re-initialize the correct SQL query value. #521 (🚑) - Ad-hoc notification/publisher execution was not working (🚑)
- This version renames the settings:
INCLUDED_SECTIONS
setting toNTFPRCS_INCLUDED_SECTIONS
to clean up the General section of the settings a bit (🚑)DIG_GET_IP_ARG
toINTRNT_DIG_GET_IP_ARG
as the setting is used by theINTRNT
plugin (🚑)
- New
MQTT
settings (#364 (🆕))MQTT_SEND_STATS
to select if overall device stats are sent to the brokerMQTT_SEND_DEVICES
to select if specific devices are sent to the broker
🔌Plugins
- A new Notifications processing plugin (
NTFPRCS
) to fine-tune how notifications are handled (🆕) - The
PIHOLE
plugin was only syncing the devices once after the app restart even with a schedule selected #513 (🚑) - Partial IP v6 support added #523 (🆕, 🚑)
- Added the scheduling option to the
MQTT
publisher plugin if you want to update the MQTT state more often #522 (🆕) - Added options to select what's sent to the broker in the
MQTT
plugin #364 (🆕)
🖼 UI
- The dashboard of enabled settings has now clickable links to take you to the relevant setting (🆕)
💠Core app updates
Internal changes affecting the whole app and usually significant to developers 👩💻👨💻
- Experimental (community supported) ARMv6 support #527 (🆕, 🧪)
Other Info
🆕 - New features | 🚑 - Fixes & Improvements | ⚠ - Possibly breaking changes | 🧪 - Experimental feature |
---|
Full Changelog: jokob-sk/Pi.Alert@v23.12.16...v24.01.18
23.12.16 - ⚓Stability & fixes
This is a release focusing on stabilizing the application ⚓Previous releases introduced a lot of changes and this is now one to focus on bug fixes and the reliability of the application. I hope I'm not overpromising 😅 I also went through the flu 😷 and a pretty stressful period at work so taking things a bit slowly.
Thanks for the patience and support 🖤
Thank you @sky4055, @jordantrizz, @kurfuer, @wial88 for the sponsorship 🙏 - this is sometimes the motivation boost I need 💪 My sponsorship goal is to dedicate one whole workday a week to this project.
Screenshots
📚Docs updates
- Added a community guides section in the installation instructions
- More detailed on-server-hardware installation instructions by @lorki97🙏
🔌Plugins
UNFIMP
didn't handle empty IP addresses correctly #508 (🚑)- Fixed a bug in the
SNMP_DISCOVERY
plugin #512 (🚑) - The
SMTP_PUBLISHER
plugin wouldn't send notifications if the server used SSL #518 by @LouisOb 🙏(🚑) - HomeAssistant required a change in the
MQTT
publisher in sensor names, otherwise, warnings are shown #514 (🚑) - The
DHCP_LEASES
plugin now checks for MAC address validity #516 (🚑)
🖼 UI
- The cycling thru devices via the arrows in the top left corner is working again #509 (🚑)
- Custom Vendor names will not be overwritten anymore #509 (🚑)
- The Devices screen now shows a
Refreshing...
message until fresh data is populated #509 (🆕)
💠Core app updates
Internal changes affecting the whole app and usually significant to developers 👩💻👨💻
- If the timezone (
TZ
) setting was specified the application would always report a new version - Fixed by @mscreations 🙏 #509 (🚑) - The experimental on-server (
CURL
orWGET
) installation approach fixes & better docs by @orki97 🙏 #495 (🧪)
Other Info
🆕 - New features | 🚑 - Fixes & Improvements | ⚠ - Possibly breaking changes | 🧪 - Experimental feature |
---|
What's Changed
- fixed typos by @jasonehines in https://github.com/jokob-sk/Pi.Alert/pull/502
- fix: Hardware installation by @lorki97 in https://github.com/jokob-sk/Pi.Alert/pull/505
- Fix date parsing for release check by @mscreations in https://github.com/jokob-sk/Pi.Alert/pull/511
- FIX unable to send mail with publisher mail plugin by @LouisOb in https://github.com/jokob-sk/Pi.Alert/pull/518
New Contributors
- @mscreations made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/511
- @LouisOb made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/518
Full Changelog: jokob-sk/Pi.Alert@v23.11.11...v23.12.16
23.11.11 - 💬 Publishers as plugins, Settings and Installation improvements
I wanted to keep this release small and here we are 😅 judge yourself based on the below changes:
I spent a lot of time converting publishers into plugins. This unlocks a granular log of event notifications in the Plugins section with links to the actual report notification via a notification GUID. I rewrote the installation process to make it easier and maintainable. I also fit in quite a few Settings page improvements. There is a new plugin to maintain the log file too.
Thank you @ameer1234567890 (and others) who tested the pi.alert_dev
image, I usually am low on energy testing all use cases so this is appreciated 🙏
Thanks to all the contributors who submitted PRs in the past few weeks!
Grateful to @sky4055, @jordantrizz, @kurfuer for their sponsorship 🙏
Sponsorship Goal: Dedicate one full workday a week to this project.
Screenshots
💔 Breaking changes
Sometimes I have to introduce breaking changes - it breaks my heart, but we must move forward
- There shouldn't be any, however, I implemented a settings rewrite method where I'm rewriting old setting names to new ones generated by the new plugins.
📚Docs updates
- Traefik reverse proxy guide added to the Reverse proxy docs with help from @cvc90 & @Isegrimm 🙏 (🆕)
⚙Settings
- Added a new dashboard to give an overview of enabled plugins and most important settings (🆕)
- Added a warning if Device scanner schedules are not synchronized #462 (🆕,🚑)
- Updated the UI and added settings sections so you can find the setting you are looking for easier (🆕,🚑)
- Added icons indicating if a Plugin is enabled (🆕)
- Triggering ad-hoc actions via Settings is working again #472 (🚑)
- A new
ARPSCAN_ARGS
setting to change the parameters of the arp-scan to make it faster if needed #485 (🆕) LISTEN_ADDR
docker variable to set a specific IP Address for the listener address for the nginx webserver (web interface). This could be useful when using multiple subnets to hide the web interface from all untrusted networks by @silverbios 🙏 (🆕)
🔌Plugins
- New Internet speedtest (
INTRSPD
) plugin (🆕) - New maintenance tasks (
MAINT
) plugin currently including the cleanup of thepialert.log
file (🆕) - Core functionality rewritten into plugins (🚑):
- MQTT publisher
- SMTP (Email) publisher
- Apprise publisher
- NTFY publisher
- Pushsafer publisher
- Webhook publisher
- The PIHOLE plugin isn't crashing the app but failing gracefully if misconfigured #479 (🚑)
- A bugfix by @jhonderson where the
DBCLNP
plugin would delete all devices marked as new #498 (🚑)
🖼 UI
- Icon preview by @ScottRoach #476 🙏 (🆕)
- The 🏳Report section has now a Notification history and an option to show the JSON and Text format (🆕)
- If the network tree topology contained less than 35 devices the node content would overflow the node box #465 (🚑 )
- Network topology improvements by @ScottRoach #475 🙏 (🚑)
- More robust error and input handling so it's easier to configure the Network tree topology #467 (🚑)
- Showing the
nginx/error.log
file in Maintenance > Logs to debug server-side errors (such as error 500) #483 (🆕,🚑 ) - Slightly better optimized mobile experience (🚑 )
💠Core app updates
Internal changes affecting the whole app and usually significant to developers 👩💻👨💻
- Rewrote the
dockerfile
and installation scripts so they are used by the on-HW install option as well as Docker-install option (e.g. for potential Proxmox support 🧪⚠) - The devices listing page now uses the JSON API endpoint (causes a slight delay in reflecting DB changes, but minimizes SQL queries and DB load) (🚑,⚠)
- Pholus name resolution looks up IP matches now as well (name contains
(IP match)
suffix) (🆕) - Boolean values were not initialized correctly (e.g.
NEWDEV
template initialized all values asTrue
) (🚑)
What's Changed
- Fix device types not loading in device details page by @lorki97 in https://github.com/jokob-sk/Pi.Alert/pull/466
- Include device vendor in event notifications by @ScottRoach in https://github.com/jokob-sk/Pi.Alert/pull/468
- Network cleanup by @ScottRoach in https://github.com/jokob-sk/Pi.Alert/pull/475
- Show current device icon as it changes by @ScottRoach in https://github.com/jokob-sk/Pi.Alert/pull/476
- Add missing german translations by @lorki97 in https://github.com/jokob-sk/Pi.Alert/pull/470
- Add option to set IP Address for web interface in Docker env by @silverbios in https://github.com/jokob-sk/Pi.Alert/pull/490
- Update config.json by @jasonehines in https://github.com/jokob-sk/Pi.Alert/pull/497
- Fix DB Clean plugin new devices deletion bug by @jhonderson in https://github.com/jokob-sk/Pi.Alert/pull/498
New Contributors
- @lorki97 made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/466
- @ScottRoach made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/468
- @silverbios made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/490
- @jasonehines made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/497
- @jhonderson made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/498
Full Changelog: jokob-sk/Pi.Alert@v23.10.2...v23.11.11
23.10.2 - 📥🧪On server HW install, Docs & Fixes
This version is wrapping up the conversion of important scheduled events into 17(❗) Plugins. Now you can adjust schedules for database cleanup, vendor DB updates, or Internet IP scans. And you can configure network types. 🥳
I also managed to include a couple of docs, such as the GMX SMTP guide or the webhook signatures docs by @nimec01.
Lastly, I played around and drafted an experimental 🧪 on server HW install script.
I can now hopefully focus on some open feature requests and have a closer look at the notification system.
Note
There is a schedule for each scan, including the internet scan. These schedules should be set to the same value if you want them to be reported in the same result (otherwise you get false device down messages). Check your settings on your scans. The internet scan (INTRNT_RUN_SCHD
) is performed every 5 minutes by default (*/5 * * * *
). Set the same schedule value on all scans (<plugin>_RUN_SCHD
) if you want them reported in the same run. More info in #462
Super grateful to @sky4055 and @jordantrizz for their sponsorship 🙏
⏳ Current Sponsorship Goal: Dedicate one full workday a week to this project.
Screenshots
Full changelog
💔 Breaking changes
Sometimes I have to introduce breaking changes - it breaks my heart, but we must move forward
- Please remove the
UNFIMP_CMD
setting from yourpialert.conf
file to re-initialize it with the new value (🚑, ⚠)
📚Docs updates
- New GMX SMTP guide ( 🆕)
- Detailed webhook signatures docs by @nimec01 (🆕)
⚙Settings
- Setting (and amazing docs) to use webhook signatures to validate that the received webhook delivery was sent by Pi.Alert (and was not changed along the way) by @nimec01 🙏 (🆕)
- A new
NETWORK_DEVICE_TYPES
setting to add new device types representing network nodes that can be then displayed on the Network topology page (🆕)
🔌Plugins
- A new option to import all devices vs. only online ones by @tuhriel 🙏 (🆕)
DHCPSRVS
bugfix - didn't clean past entries (🚑)- Created new plugins for more flexibility in scheduling and maintenance for existing, previously app-entangled functionality:
- The vendor database update into the
VNDRPDT
plugin (🚑, 🆕) - The internet IP check into the
INTRNT
plugin (🚑, 🆕) - Database cleanup moved into the
DBCLNP
plugin (🚑, 🆕) - DDNS update tasks into the
DDNS
plugin (🚑, 🆕)
- The vendor database update into the
🖼 UI
- Better UI indicator that settings are being imported and a more granular status message (🆕)
💠Core app updates
Internal changes affecting the whole app and usually significant to developers 👩💻👨💻
- Faster and less DB locks during initialization time and config and Plugin re-load by bulk-inserting language strings (🚑)
- A new
app_state.json
endpoint to drive the status header in the front-end of the app and to reduce DB queries and DB locks (🆕)- Unified the new version check to prevent backend and UI inconsistencies in reporting new versions via the new
app_state.json
API endpoint #458 (🚑)
- Unified the new version check to prevent backend and UI inconsistencies in reporting new versions via the new
What's Changed
- Added functionality to perform a full import by @tuhriel in https://github.com/jokob-sk/Pi.Alert/pull/442
- Add webhook signatures by @nimec01 in https://github.com/jokob-sk/Pi.Alert/pull/459
New Contributors
- @nimec01 made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/459
Full Changelog: jokob-sk/Pi.Alert@v23.9.12...v23.10.2
🩹Hotfix: Network map, PiHole, Reverse proxy, DHCP leases
- Network topology map not loading correctly #424
- Small styling issues in the Report page #433
- Fixed setting saving on reverse proxied setups by @cvc90 🙏
- Better null handling in the
DHCPLSS
plugin - Fixed the new version email template
- Hopefully correct now by @cvc90 🙏: PiHole scan has incorrect SQL query (the below has to be only done if you saved your settings on the
23.9.10
or23.9.11
version)- Fix: remove the
PIHOLE_CMD
setting from yourpialert.conf
file or replace the value in the Settings page withSELECT n.hwaddr AS Object_PrimaryID, {s-quote}null{s-quote} AS Object_SecondaryID, datetime() AS DateTime, na.ip AS Watched_Value1, n.lastQuery AS Watched_Value2, na.name AS Watched_Value3, n.macVendor AS Watched_Value4, {s-quote}null{s-quote} AS Extra, n.hwaddr AS ForeignKey FROM EXTERNAL_PIHOLE.Network AS n LEFT JOIN EXTERNAL_PIHOLE.Network_Addresses AS na ON na.network_id = n.id WHERE n.hwaddr NOT LIKE {s-quote}ip-%{s-quote} AND n.hwaddr <> {s-quote}00:00:00:00:00:00{s-quote};
- Fix: remove the
🩹Hotfix: PiHole, Reverse proxy, DHCP leases, German language
- Invalid
de_de.json
breaks German translation #419 fixed by 🙏@cvc90 - Incorrect API path in
initDeviceListAll_JSON
breaks proxied setups fixed by 🙏@cvc90 - PiHole dhcp.leases files were not processed #420
- PiHole scan has incorrect SQL query #418 (the below has to be only done if you saved your settings on the
23.9.10
version)- Fix: remove the
PIHOLE_CMD
setting from yourpialert.conf
file or replace the value in the Settings page withSELECT n.hwaddr AS Object_PrimaryID, {s-quote}null{s-quote} AS Object_SecondaryID, datetime() AS DateTime, na.ip AS Watched_Value1, n.lastQuery AS Watched_Value2, na.name AS Watched_Value3, n.macVendor AS Watched_Value4, {s-quote}null{s-quote} AS Extra, n.hwaddr AS ForeignKey FROM EXTERNAL_PIHOLE.Network AS n LEFT JOIN EXTERNAL_PIHOLE.Network_Addresses AS na ON na.network_id = n.id WHERE n.hwaddr NOT LIKE {s-quote}ip-%{s-quote} AND n.hwaddr <> {s-quote}00:00:00:00:00:00{s-quote};
- Fix: remove the
🧱Building solid foundations & 🧹Cleanup
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
🆕 - 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 thedocker-compose.yml
file if you enable this setting. This has to be matched with a correspondingDHCPLSS_paths_to_check
setting entry (the path in the container must containpihole
).
Removed setting:SCAN_CYCLE_MINUTES
- Replaced by corresponding plugin scan intervals. E.g.
PIHOLE_RUN_SCHD
orDHCPLSS_RUN_SCHD
📚Docs updates
- Explanation on how the Setting system works (🆕)
- Huge improvement on the Reverse proxy configuration including NGINX, APACHE by @cvc90 🙏 (🆕)
- Additions to the Plugins docs about
before_config_save
run option, SQLite database plugins,CurrentScan
behavior (🆕) - Plugin translations + some doc translation into Spanish by @cvc90 🙏 (🆕)
- Frontend development guidelines and tips (🆕)
⚙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 thepialert.conf
file that allows to modify the file with Plugins (used in the newSETPWD
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 exampleregex.url_http_https
. This will apply theregex
resolver and then theurl_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 columnsObject_PrimaryID
,Object_SecondaryID
,Plugin
(auto-filled based onunique_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
- @cvc90 made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/306
- @dlgreenwald made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/312
- @Steve-Tech made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/351
- @andreasbrett made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/400
- @tuhriel made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/401
Full Changelog: jokob-sk/Pi.Alert@v23.7.22...v23.9.10
23.7.22 - 🔎Filter all the plugin objects 🕳
This release is packed with goodies. The plugin system now supports 🔎Filters 🕳🥳 that allow displaying device-specific plugin entries under Device details and I added a template
plugin type for setting up defaults of new devices (NEWDEV
plugin). The UI got some love too. There are a ton of fixes and smaller improvements, and tweaks, so check the details below.
🙏 A big shout out to @ajtatum for sponsoring me 🙏 (these contributions mean a lot to me to keep me motivated).
This release is bigger than usual, which means that there might be bugs.
🆕 New features
- 🌟🔌Plugins:
- New plugin type:
template
- Used in the New Devices plugin (NEWDEV
) - Plugins now support filters 🥳
- Plugins are now also displayed under specific Device details
- New plugin type:
- Attempt number 2: Version number added in the application footer (let's see if this works after the release) with help from @jordantrizz #209
- More detailed Home Assistant guide
- Detailed Docs on the application structure by @Data-Monkey 🙏
- Port number is now shown in the network diagram
- Settings to configure notification defaults for new devices #274
- Reverse proxy SWAG container guide by @s33d1ing 🙏
- A new webhook setting (
WEBHOOK_SIZE
) to specify the size of the payload - A new Database upkeep setting (
PLUGINS_KEEP_HIST
) to specify the max number of Plugin history entries - Maintenance section now includes number of DB entries for tables to debug DB size issues
- Copy device details from a device #276
- New maintenance setting to delete New Devices older than X hours #250
🚑 Fixes and Improvements
- The version check in the Maintenance page has better GitHub API exception handling (e.g.: API rate limits)
- Better handling of loading bigger-sized
pialert.log
files into theMaintenance
>Logs
section #255 - Bugfix of displaying device details for devices with numbers as names #269
- Improvements to the SNMP Discovery plugin (tested with pfSense) #258
- Fix of update-check spamming #283
⚠ Possibly breaking changes
- Discord Webhooks should use the payload type
text
(previouslyhtml
) #271
Screenshots
🧪 Anyone wants features sooner?
Test them by using the dev image!
Please backup everything and create a CSV export of your devices before proceeding if you plan to use your existing DB.
version: "3"
services:
pialert:
container_name: pialert
image: "jokobsk/pi.alert_dev"
...
What's Changed
- Speedup docker builds with a cache by @sbe-arg in https://github.com/jokob-sk/Pi.Alert/pull/254
- Update README.md by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/265
- fix: docker cache to github registry mistake by @sbe-arg in https://github.com/jokob-sk/Pi.Alert/pull/267
- fix: github packages 403 by @sbe-arg in https://github.com/jokob-sk/Pi.Alert/pull/268
- Fix update check interval by @Final-Hawk in https://github.com/jokob-sk/Pi.Alert/pull/284
New Contributors
- @sbe-arg made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/254
Full Changelog: jokob-sk/Pi.Alert@v23.6.16...v23.7.22
23.6.16 - Split it up & the undiscoverables 🪓
This release is about splitting things up. 🪓 Huge thanks to @Data-Monkey for help on this. 🎉 from now on, this work should make contributions easier as the script becomes more readable and logically divided. @Data-Monkey also created a new plugin for creating dummy devices - and you can create plugins too! Check the docs for details!
🆕 New features
- Spanish translated strings by @BanCrash
UI_PRESENCE
Setting to select which statuses should show up in the Device presence over time chart #221- New docs on the database structure
- Tip on how to use Pro Font Awesome icons if you own them by @webysther added to the Icons docs
- Version number added in the application footer (let's see if this works after the release) with help from @jordantrizz #209
- ⛔ not working
- Added
pialert.php_errors.log
into the Maintenance > Logs section - Day filter available now in the Presence view based on @leiweibau 's work
- Added support for self-hosted unauthenticated SMTP servers #234
- Plugins:
- Un-Discoverable Devices Plugin by @Data-Monkey to manually add dummy devices to your network
- @Data-Monkey created a handy helper to interface between a custom plugin and the main app making it easier to create custom plugins
🚑 Fixes and Improvements
- Breaking up the code to make it easier to extend, understand and maintain - big thanks to @Data-Monkey
- More detailed and unified debugging output courtesy of @Data-Monkey
- Simplified timezone handling by @Data-Monkey
- Attempt to fix
RTNETLINK answers: Network is unreachable
errors causing device display issues such as #228 - Null values are hidden from HTML based reports (e.g. Emails) #247
🖼 Screenshots
What's Changed
- Fix table mobile view by @Final-Hawk in https://github.com/jokob-sk/Pi.Alert/pull/226
- Update README.md by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/227
- feat: Place buildnumber and version in footer. by @jordantrizz in https://github.com/jokob-sk/Pi.Alert/pull/229
- get_plugin_config changed to top level folders by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/231
- Un-Discoverable Devices Plugin by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/233
- Update spanish strings by @BanCrash in https://github.com/jokob-sk/Pi.Alert/pull/235
- Update pialert.py by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/237
- Split it up by @Data-Monkey in https://github.com/jokob-sk/Pi.Alert/pull/243
- Split it up by @jokob-sk in https://github.com/jokob-sk/Pi.Alert/pull/244
- Split it up by @jokob-sk in https://github.com/jokob-sk/Pi.Alert/pull/245
- Split it up by @jokob-sk in https://github.com/jokob-sk/Pi.Alert/pull/246
- fix issue #4 by @jokob-sk in https://github.com/jokob-sk/Pi.Alert/pull/248
- Split up work 2023 05 30 by @jokob-sk in https://github.com/jokob-sk/Pi.Alert/pull/249
New Contributors
- @Data-Monkey made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/227
- @jordantrizz made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/229
- @BanCrash made their first contribution in https://github.com/jokob-sk/Pi.Alert/pull/235
Full Changelog: jokob-sk/Pi.Alert@v23.5.7...v23.6.16