Sign inSign up

nurefexc/radicale-ntfy-birthday-alert

By nurefexc

•Updated 8 months ago

Birthday alerts from Radicale CardDAV to ntfy.

Image
Message queues
Monitoring & observability
0

1.4K

nurefexc/radicale-ntfy-birthday-alert repository overview

⁠Docker Overview

⁠Radicale Birthday ntfy Alert

A lightweight Python-based birthday monitoring tool that syncs with your Radicale CardDAV address book and sends real-time alerts via ntfy⁠ when a contact's birthday is today.

⁠Quick Start
docker run -d \
  --name birthday-monitor \
  --restart always \
  -e RADICALE_URL=https://your-radicale-server.com/user/addressbook/ \
  -e RADICALE_USER=your_username \
  -e RADICALE_PASS=your_password \
  -e NTFY_URL=https://ntfy.sh/your_topic \
  -e TZ=Europe/Budapest \
  nurefexc/radicale-ntfy-birthday-alert:latest
⁠Environment Variables
VariableRequiredDefaultDescription
RADICALE_URL✅-Full URL to your Radicale address book
RADICALE_USER✅-Radicale username
RADICALE_PASS✅-Radicale password
NTFY_URL✅-ntfy topic URL
NTFY_TOKEN❌-ntfy auth token
TZ❌UTCSystem timezone
⁠Required Mounts

No mounts required – the container communicates with Radicale via HTTP/HTTPS.

⁠Ports

No ports required – only outbound HTTP connections to the Radicale server and ntfy.

⁠Features
  • 📅 Daily Check: Runs automatically between 00:00 and 01:00 in your local timezone
  • 🎂 Smart Birthday Parsing: Supports various formats (YYYY-MM-DD, YYYYMMDD, --MMDD, etc.)
  • 📞 Actionable Notifications: One-tap call button if phone number exists
  • 💬 Matrix Integration: Direct link to Matrix chat if Matrix ID is in contact notes
⁠Supported Architectures
  • linux/amd64
⁠Source

Tag summary

Content type

Image

Digest

sha256:798039330…

Size

45.1 MB

Last updated

8 months ago

docker pull nurefexc/radicale-ntfy-birthday-alert