{"id":13856771,"url":"https://github.com/domenp/aircal","last_synced_at":"2025-07-13T19:32:41.760Z","repository":{"id":56635915,"uuid":"255712308","full_name":"domenp/aircal","owner":"domenp","description":"Visualize Airflow's schedule by exporting future DAG runs as events to Google Calendar.","archived":false,"fork":false,"pushed_at":"2023-07-27T16:53:28.000Z","size":34,"stargazers_count":70,"open_issues_count":3,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-09T07:46:38.564Z","etag":null,"topics":["airflow","calendar","dag","google-calendar","schedule"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/domenp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-14T19:58:54.000Z","updated_at":"2023-08-17T17:57:50.000Z","dependencies_parsed_at":"2022-08-15T22:20:32.602Z","dependency_job_id":null,"html_url":"https://github.com/domenp/aircal","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domenp%2Faircal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domenp%2Faircal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domenp%2Faircal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domenp%2Faircal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/domenp","download_url":"https://codeload.github.com/domenp/aircal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225912254,"owners_count":17544133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airflow","calendar","dag","google-calendar","schedule"],"created_at":"2024-08-05T03:01:12.639Z","updated_at":"2024-11-22T14:30:46.321Z","avatar_url":"https://github.com/domenp.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Update: The library is not actively maintained. In case of issues, you might be on your own. However, you're free to open a PR :)\n\n# Aircal\n\nThis library helps visualizing Airflow's DAG run schedule. It does that by exporting future DAG runs as events to Google Calendar.\n\nHaving DAG run as events in the calendar might help you:\n- visualize the utilization of your airflow workers to better spread your jobs\n- determine when a certain DAG should be finished to monitor the service.\n\n![DAG run visualization](https://user-images.githubusercontent.com/6691247/80535228-c28cc700-89a0-11ea-8cdc-0050a3c91298.png)\n\nThe library will also observe the changes to your DAGs and synchronize it with the calendar:\n- add runs for the freshly added DAGs\n- change start and/or end time when an existing DAG changes the schedule (or the execution time changes significantly)\n- delete run events when a DAG is removed (or paused)\n\nTip: run the sync script regularly, perhaps, with you know, Airflow :)\n\nThe library only support DAG schedules that use the standard cron syntax. The rest will be ignored (with a warning).\n\n**Warning: This is an beta stage software. Expect occassional bugs and rough edges (PR welcome).**\n\n## Installation \u0026 setup\n\n```\npip install aircal\n```\n\nAlternatively you can clone the repo and install it from there:\n\n```\npip install -e .\n```\n\nGoogle API credentials are required to create events in the calendar. You can obtain them [here](https://console.developers.google.com/apis/credentials). Store `credentials.json` into a directory accessible by your code.\n\n**The library is modifying and deleting calendar events. I highly recommend creating a new calendar to be used by this software:** \"add calendar\" -\u003e \"create new calendar\" in Google calendar settings.\n\n## Usage\n\nSee `example.py` for an example of the potential pipeline that can be run on the regular intervals.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomenp%2Faircal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdomenp%2Faircal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomenp%2Faircal/lists"}