{"id":16485885,"url":"https://github.com/fabsrc/tvcal","last_synced_at":"2025-05-02T04:30:20.294Z","repository":{"id":57382467,"uuid":"50740118","full_name":"fabsrc/tvcal","owner":"fabsrc","description":":tv:  :calendar: Air dates of upcoming TV show episodes as ical/webcal.","archived":false,"fork":false,"pushed_at":"2021-12-13T20:27:19.000Z","size":578,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-06T22:11:20.228Z","etag":null,"topics":["calendar","ical","tv-series","tv-shows","webcal"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/fabsrc.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-01-30T19:07:11.000Z","updated_at":"2023-05-24T21:08:03.000Z","dependencies_parsed_at":"2022-09-26T16:50:21.148Z","dependency_job_id":null,"html_url":"https://github.com/fabsrc/tvcal","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabsrc%2Ftvcal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabsrc%2Ftvcal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabsrc%2Ftvcal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabsrc%2Ftvcal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabsrc","download_url":"https://codeload.github.com/fabsrc/tvcal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251986606,"owners_count":21675950,"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":["calendar","ical","tv-series","tv-shows","webcal"],"created_at":"2024-10-11T13:27:36.375Z","updated_at":"2025-05-02T04:30:19.901Z","avatar_url":"https://github.com/fabsrc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TVCal\n[![Build Status](https://img.shields.io/travis/fabsrc/tvcal.svg?style=flat-square)](https://travis-ci.org/fabsrc/tvcal)\n[![Dependencies](https://img.shields.io/david/fabsrc/tvcal.svg?style=flat-square)](https://david-dm.org/fabsrc/tvcal)\n[![Development Dependencies](https://img.shields.io/david/dev/fabsrc/tvcal.svg?style=flat-square)](https://david-dm.org/fabsrc/tvcal?type=dev)\n[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](http://standardjs.com/)\n\n\nA Node.js server providing the air dates of upcoming TV show episodes as ical/webcal.\n\n## Install\n\n```bash\n$ npm install\n```\n\n## Start\n\n```bash\n$ npm start\n```\n\nUse the `PORT` environment variable to set a custom port (default is `5000`).\n\n## Usage\n\n### Web UI\n\nTo select shows to get air dates for go to `http://localhost:5000` and use the web UI. It will create a webcal URL which you can add to your calendar.\n\n### Get air dates by show titles\n\n```http\nwebcal://localhost:5000/shows/?q=shameless;brooklyn%20nine-nine\n```\n\n### Get air dates by [TVMaze](http://tvmaze.com/) ids\n\n```http\nwebcal://localhost:5000/shows/150;49\n```\n\n### Use as a Module\n\nReturns a calendar object which is created by [ical-generator](https://github.com/sebbo2002/ical-generator).\n\n```js\nconst tvcal = require('tvcal')\n\ntvcal({\n\tname: 'Cal-Name',\n\tdomain: 'Cal-Domain',\n\tshowIds: [150, 49], // Use either showIds or showTitles\n\t// showTitles: ['Shameless', 'Brooklyn Nine-Nine'], // Alternative to showIds\n\tfilterDate: new Date(new Date() - 14 * 24 * 60 * 60 * 1000) // Filter episodes which are older than two weeks\n}).then(cal =\u003e {\n\tconsole.log(cal.toString())\n})\n```\n\n## Development\n\n```bash\n$ npm run dev\n```\n\n## Test\n\n```bash\n$ npm test\n```\n\n## Credits\n\nThis application makes use of the [TVMaze API](http://www.tvmaze.com/api).\n\n## License\n\nLicensed under the [MIT License](http://opensource.org/licenses/mit-license.php).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabsrc%2Ftvcal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabsrc%2Ftvcal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabsrc%2Ftvcal/lists"}