🐝 Beedav - Beeminder CalDAV Server

📅 How to Add to Your Calendar

1. Get Your Beeminder Credentials

You'll need:

Username: Your Beeminder username
Auth Token: Get it from https://www.beeminder.com/api/v1/auth_token.json

2. Construct Your CalDAV URL

Replace YOUR_USERNAME and YOUR_AUTH_TOKEN with your actual credentials:

http://localhost:8081/beedav/YOUR_USERNAME/YOUR_AUTH_TOKEN/

3. Add to Your Calendar App

🌩️ Thunderbird

Open Thunderbird Calendar
Right-click in the calendar list → "New Calendar"
Choose "On the Network"
Select "CalDAV"
Enter your constructed URL above
The calendar "🐝 Beeminder (your_username)" will appear

📱 Other Calendar Apps

Most calendar applications support CalDAV subscriptions. Look for options like:

"Add Calendar" → "CalDAV"
"Subscribe to Calendar" → "CalDAV URL"
"Internet Calendar" → "CalDAV"

⚠️ Security Note: This server runs on localhost (your computer only) and doesn't support HTTPS. Your auth token will be visible in server logs. For production use, consider adding HTTPS and authentication.

📋 What You'll See

Each Beeminder goal with an upcoming deadline becomes a calendar event:

📅 Event Title: 🐝 goal_slug
⏰ Time: 1 hour ending at your Beeminder deadline
📝 Description: Goal details, units, and fine print
📂 Calendar Name: 🐝 Beeminder (your_username)

🔧 Technical Details

This server implements the CalDAV protocol to expose Beeminder goals as calendar events. It:

Fetches your goals from the Beeminder API
Converts deadlines to calendar events
Serves them via standard CalDAV protocol
Updates automatically when you refresh your calendar

🏠 Legacy Endpoint

The original endpoint is still available at /caldav/ but uses hardcoded credentials.