{"id":15746710,"url":"https://github.com/hanse00/lectocal","last_synced_at":"2026-03-04T21:32:53.297Z","repository":{"id":43367802,"uuid":"54325491","full_name":"Hanse00/LecToCal","owner":"Hanse00","description":"Synchronising Lectio schedules into Google Calendar.","archived":false,"fork":false,"pushed_at":"2022-12-08T09:33:04.000Z","size":131,"stargazers_count":5,"open_issues_count":13,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-22T17:07:04.092Z","etag":null,"topics":["google-calendar","lectio","python","schedule"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hanse00.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-20T15:36:38.000Z","updated_at":"2022-02-05T23:11:35.000Z","dependencies_parsed_at":"2023-01-25T11:31:21.268Z","dependency_job_id":null,"html_url":"https://github.com/Hanse00/LecToCal","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/Hanse00/LecToCal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hanse00%2FLecToCal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hanse00%2FLecToCal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hanse00%2FLecToCal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hanse00%2FLecToCal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hanse00","download_url":"https://codeload.github.com/Hanse00/LecToCal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hanse00%2FLecToCal/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261330126,"owners_count":23142482,"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":["google-calendar","lectio","python","schedule"],"created_at":"2024-10-04T05:01:15.186Z","updated_at":"2026-03-04T21:32:53.230Z","avatar_url":"https://github.com/Hanse00.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lectocal\n\n[![CircleCI](https://circleci.com/gh/Hanse00/LecToCal.svg?style=svg)](https://circleci.com/gh/Hanse00/LecToCal)\n[![Coverage Status](https://coveralls.io/repos/github/Hanse00/LecToCal/badge.svg?branch=master)](https://coveralls.io/github/Hanse00/LecToCal)\n\nLectocal is a python module for syncronizing Lectio schedules into Google Calendar.\n\nBy leveraging the Google Calendar backend, it can provide: Notifications, Sharing, Access across most devices, integration with other services such as [If This Then That](https://ifttt.com).\n\n## Development\n\nSo you want to work with the code? Awesome!\n\nThis project uses [Pipenv](https://pipenv.readthedocs.io/en/latest/), after cloning the repo, do the following:\n\n1. Make sure you have python 3 installed.\n2. Create a pipenv in your working directory with `pipenv --python 3`.\n3. Install both the default and development packages from the Pipfile with `pipenv install --dev`.\n\nYou should now be ready to work.\n\nFor more information on pipenv check out [the documentation](https://pipenv.readthedocs.io/en/latest/). If you run into any issues working with the project, feel free to [open an issue on GitHub](https://github.com/Hanse00/LecToCal/issues).\n\n## Installation\n\nInstallation is easiest using pip, as Lectocal is availble on Pypi as a package (http://pypi.org/project/lectocal/). Simply run `pip install lectocal`.\n\nFor more details on using pip, check out [the official documentation](https://packaging.python.org/tutorials/installing-packages/).\n\nAlternatively the source code can be downloaded straight from GitHub, using the \"Clone or download\" button in the top right.\n\n## Usage\n\n### Dependencies\n\nIf the package is installed via pip, dependencies will be handled automatically.\n\nOtherwise, these dependencies will need to be downloaded manually - We recommend using [pipenv](https://docs.pipenv.org) and installing the packages as listed in the [Pipfile](Pipfile).\n\n### Invocation\n\nAfter installation, the module can be invoced with:\n\n```\npython -m lectocal.gauth\npython -m lectocal.run\n```\n\nIf installed via setuptools (pip does this) two executables will also be generated:\n```\nlectocal.gauth\nlectocal.run\n```\n\nThese can be executed by the system directly.\n\n### Parameters\n\nFor all the parameters supported, run the intended module with the -h or --help parameters.\n\n### Example use\n\n1. Generating Calendar OAuth credentials.\n\n    The first step is to generate OAuth credentials for the Google account, to which the schedule must be written.\n\n    This is done by running `lectocal.gauth`, and following the steps in the browser. \n\n    These steps authorize lectocal to get a credential which gives full calendar access, so new events can be written, and old ones deleted.\n\n1. Syncronizing the schedule.\n\n    After the OAuth credential exists, Lectocal can now write into the calendar using the API.\n\n    Running `lectocal.run` at this point, scrapes the schedule for the chosen individual, and writes it to the calendar.\n\n1. Repeat.\n\n    To keep a calendar up to date, step 2 will need to be repeated at a given interval.\n    This can for example be done using cron, or a similar task scheduling system.\n\n    As long as the OAuth credentials are not deleted from the system, or revoked from the Google account, step 1 should not need to be re-run.\n\n**Note**\n\nThe generated Google Calendar should not be deleted or renamed, this may cause the system to break, or act in unexpected ways, such as creating a duplicate calendar.\n\n## Bugs, Feedback, Thoughts, etc.\n\nFor bugs, issues, or questions about the software, use the [issue tracker built into GitHub](https://github.com/Hanse00/LecToCal/issues).\n\nFor general discussion, feedback, etc. there's a mailgroup at [lectocal@googlegroups.com](https://groups.google.com/forum/#!forum/lectocal).\n\n## License\n\nLectocal is licensed under the Apache 2.0 license, see [LICENSE](LICENSE) or\napache.org for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanse00%2Flectocal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhanse00%2Flectocal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanse00%2Flectocal/lists"}