jack-does-trading/codeforces-x-apple_calender

This project connects Codeforces, a website that hosts competitive programming contests, to Apple Calendar on a Mac. The idea is simple: the author's calendar had no idea contests existed, and Codeforces had no idea a calendar existed, so this small tool makes the two talk to each other automatically. It works by asking the official Codeforces API which contests have not started yet. For every contest coming up in the next 30 days, it creates an event on a calendar named Codeforces, sized to match the contest's actual start and end time, and attaches a reminder alert 30 minutes before it begins. It can be run again and again, by hand or on a schedule, and it remembers which contests it already added so it never creates the same event twice. Setup involves copying two files, a Python script and an AppleScript helper, to a folder on the Mac, then creating a calendar named Codeforces in Calendar.app (or pointing the script at an existing calendar). Running the script once by hand lets macOS ask for permission to control Calendar.app, which the user has to approve. After that first run, contests should start appearing on the calendar automatically. For people who want it to run without any manual steps, the project includes a launchd configuration file, a built in macOS way of scheduling background tasks, so the sync can happen every 24 hours without the user needing to remember to run anything. A few settings can be adjusted at the top of the main script, including which calendar to use, how many days ahead to look for contests, and how many minutes before a contest to send the reminder. The project requires macOS with Calendar.app and Python 3.8 or newer, which comes preinstalled on modern Macs. No license is mentioned in the source material provided.