{"id":21100699,"url":"https://github.com/kadams54/upcomingjs","last_synced_at":"2026-05-17T12:41:47.313Z","repository":{"id":138584943,"uuid":"89364465","full_name":"kadams54/upcomingjs","owner":"kadams54","description":"Displays upcoming events from public Google calendars in a customizable fashion.","archived":false,"fork":false,"pushed_at":"2017-05-24T14:05:04.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-14T08:11:31.223Z","etag":null,"topics":["google-api-client","google-calendar","javascript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/kadams54.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-25T13:34:48.000Z","updated_at":"2024-08-28T09:33:46.000Z","dependencies_parsed_at":"2023-04-15T12:01:05.305Z","dependency_job_id":null,"html_url":"https://github.com/kadams54/upcomingjs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kadams54/upcomingjs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadams54%2Fupcomingjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadams54%2Fupcomingjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadams54%2Fupcomingjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadams54%2Fupcomingjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kadams54","download_url":"https://codeload.github.com/kadams54/upcomingjs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadams54%2Fupcomingjs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28116431,"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","status":"online","status_checked_at":"2025-12-29T02:00:07.021Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-api-client","google-calendar","javascript"],"created_at":"2024-11-19T23:15:09.354Z","updated_at":"2025-12-29T13:03:46.644Z","avatar_url":"https://github.com/kadams54.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Upcoming.js [![Build Status](https://secure.travis-ci.org/kadams54/upcomingjs.png?branch=master)](https://travis-ci.org/kadams54/upcomingjs)\n\nDisplays upcoming events from public Google calendars in a customizable fashion.\n\n* Free software: [Apache License](https://github.com/kadams54/upcomingjs/blob/master/LICENSE)\n* History: [HISTORY.md](https://github.com/kadams54/upcomingjs/blob/master/HISTORY.md)\n* How to contribute: [CONTRIBUTING.md](https://github.com/kadams54/upcomingjs/blob/master/CONTRIBUTING.md)\n\n## Demo\n\nCheck out the [live demo](http://kadams54.github.io/upcomingjs/demo/) or run the\ndemo locally:\n\n1. Make sure you have NPM and Grunt installed.\n2. Set up Upcoming.js and run it:\n\n  ```bash\n  git clone https://github.com/kadams54/upcomingjs.git\n  cd upcomingjs/\n  npm install\n  grunt\n  ```\n\n## Usage\n\n1. Include the code:\n\n\t```html\n\t\u003cscript src=\"upcoming.min.js\"\u003e\u003c/script\u003e\n\t```\n\n2. Call upcomingjs:\n\n\t```javascript\n\twindow.upcomingjs(\n    '#my-upcoming',  // Element selector\n    'MY GOOGLE CALENDAR API KEY',  // Google Calendar API key\n    'MY CALENDAR ID'  // Google Calendar ID\n\t);\n\t```\n\nUpcoming.js requires three pieces of information, passed in as the three\nparameters above:\n\n1. The selector for the DOM element into which Upcoming.js should render\n   the event list.\n2. Your Google Calendar API key.\n3. The public calendar's ID - note that the calendar *must* be made\n   public.\n\nThe first bit of information, the DOM selector, is easy. Unfortunately\nthe last two require a bit of work.\n\n### Obtaining Your Google Calendar API Key\n\nHat tip to [Full Calendar](https://fullcalendar.io/) for [these instructions](https://fullcalendar.io/docs/google_calendar/):\n\n1. Go to the [Google Developer Console](https://console.developers.google.com/)\n   and create a new project (it might take a second).\n2. Once in the project, go to **APIs \u0026 auth \u003e APIs** on the sidebar.\n3. Find \"Calendar API\" in the list and turn it ON.\n4. On the sidebar, click **APIs \u0026 auth \u003e Credentials**.\n5. In the \"Public API access\" section, clikc \"Create new Key\".\n6. Choose \"Browser key\".\n7. If you know what domains will host your calendar, enter them into the\n   box. Otherwise, leave it blank. You can always change it later.\n8. Your new API key will appear. It might take a second or two before it\n   starts working.\n\n### Making Your Google Calendar Public\n\nTODO\n\n### Finding Your Google Calendar ID\n\nTODO\n\n## Team\n\nUpcoming.js was created by Kyle Adams, with help from these [contributors](https://github.com/kadams54/upcomingjs/graphs/contributors).\n\n### Credits\n\n* [Zeno Rocha](http://zenorocha.com) and [Addy Osmani](http://addyosmani.com) for creating [jquery-boilerplate](https://github.com/jquery-boilerplate/jquery-boilerplate).\n* [Audrey Roy](http://www.audreymroy.com) for creating [cookiecutter-jquery](https://github.com/audreyr/cookiecutter-jquery).\n\n\n### Sites Using This Widget\n\n* None listed yet. Why not be the first?\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadams54%2Fupcomingjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkadams54%2Fupcomingjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadams54%2Fupcomingjs/lists"}