# CVVCalendarSync A Python script with docker container to sync Classeviva's Agenda with Google Calendar, Dockerized with cron to run every hour not to exced API rate limits

Installation and Usage

See wiki

Common Commands

View Logs

# Real-time logs
docker compose logs -f classeviva_sync

# Last 100 lines
docker compose logs --tail 100 classeviva_sync

Force a Sync

docker compose exec classeviva_sync python3 /app/classevivaSync.py

Clean Up Calendar (Remove Duplicates)

# Preview what would be deleted
docker compose exec classeviva_sync python3 /app/clear_calendar.py --dry-run

# Delete all events and start fresh (recommended for cleanup)
docker compose exec classeviva_sync python3 /app/clear_calendar.py

# Delete only events created by this sync
docker compose exec classeviva_sync python3 /app/clear_calendar.py --only-synced

See CLEANUP_GUIDE.md for detailed cleanup instructions.

Debug API

docker compose exec classeviva_sync python3 /app/debug_api.py

Check Health

docker compose ps

References

• Classeviva-Official-Endpoints