casahome2000/plex_ical repository overview

⁠📅 plex_ical – Merge Sonarr & Radarr calendars into one iCal feed

plex_ical is a lightweight Python/Flask service that merges multiple iCal feeds (from Sonarr and Radarr) into a single calendar subscription.
It runs in Docker and is perfect for Synology NAS, Portainer, or any container host.

⁠✨ Features

• Merge Sonarr + Radarr calendars into a single .ics
• Auto-refresh & cache events to reduce load on your apps
• Custom calendar name (CAL_NAME) via env var
• Works with Apple Calendar, Google Calendar, Outlook, etc.
• Simple JSON health endpoint (/health)

⁠🚀 Quick Start

docker run -d   --name plex_ical   -p 5181:8000   -e SONARR_ICAL_URL="http://sonarr-ip:8989/feed/v3/calendar/Sonarr.ics?apikey=YOUR_SONARR_API_KEY"   -e RADARR_ICAL_URL="http://radarr-ip:7878/feed/v3/calendar/Radarr.ics?apikey=YOUR_RADARR_API_KEY"   -e CAL_NAME="plex_ical_Entertainment"   casahome2000/plex_ical:latest

Then subscribe to:

http://<host-ip>:5181/calendar

⁠🔧 Environment Variables

⁠📂 Endpoints

• /calendar → Merged iCal feed
• /health → JSON service health
• / → Basic service info

⁠⚠️ Notes

• Apple Calendar may reject webcal:// — use http://<ip>:5181/calendar.
• The .env file is not included in the image. Always supply environment variables at runtime.
• For production, pin a version (:3, :4) instead of :latest.