{"id":13583634,"url":"https://github.com/vervallsweg/cast-web-api","last_synced_at":"2025-04-06T21:32:42.327Z","repository":{"id":18347731,"uuid":"84064418","full_name":"vervallsweg/cast-web-api","owner":"vervallsweg","description":"Quick and dirty web API for Google Cast enabled devices.","archived":false,"fork":false,"pushed_at":"2022-12-08T16:58:04.000Z","size":448,"stargazers_count":139,"open_issues_count":52,"forks_count":73,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-04-14T19:22:08.808Z","etag":null,"topics":["chromecast","chromecast-api","google-cast","nodejs"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vervallsweg.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","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":"2017-03-06T11:16:29.000Z","updated_at":"2024-03-28T22:53:55.000Z","dependencies_parsed_at":"2023-01-13T19:47:10.666Z","dependency_job_id":null,"html_url":"https://github.com/vervallsweg/cast-web-api","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/vervallsweg%2Fcast-web-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vervallsweg%2Fcast-web-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vervallsweg%2Fcast-web-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vervallsweg%2Fcast-web-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vervallsweg","download_url":"https://codeload.github.com/vervallsweg/cast-web-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222818707,"owners_count":17042228,"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":["chromecast","chromecast-api","google-cast","nodejs"],"created_at":"2024-08-01T15:03:39.839Z","updated_at":"2024-11-06T00:30:31.534Z","avatar_url":"https://github.com/vervallsweg.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# cast-web-api\n[![npm version](https://badge.fury.io/js/cast-web-api.svg)](https://badge.fury.io/js/cast-web-api)\n[![Dependency Status](https://img.shields.io/david/vervallsweg/cast-web-api.svg)](https://david-dm.org/vervallsweg/cast-web-api)\n[![npm](https://img.shields.io/npm/dm/cast-web-api.svg?maxAge=2592000)]()\n\nWeb API for Google Cast enabled devices, based on the [node-castv2](https://github.com/thibauts/node-castv2 \"node-castv2\") implementation by thibauts.\n\nThis API is only intended to be used on your local network **not for hosting on the public internet**.\n\n## Installation\nYou probably don't want to install the api directly. For a GUI install [cast-web-api-desktop](https://github.com/vervallsweg/cast-web-api-desktop), for headless server installation use [cast-web-api-cli](https://github.com/vervallsweg/cast-web-api-cli).\n\n## Usage\n\n### Basics\ncast-web-api tries to behave like the Google Home app. All available devices will be connected to, if a device goes down, it'll be removed. If it randomly disconnects, it'll try to reconnect.\nThe autoConnect behavior can be turned of with the config parameter `autoConnect`. This can be helpful for [large speaker groups](https://github.com/vervallsweg/cast-web-api/issues/92).\n\n### Parameters\n\nEvery changed parameter will be saved in `/config/config.json`. This location will be changed in the next release.\n\n### Documentation\n\n#### Online\nParse the [swagger.json](https://raw.githubusercontent.com/vervallsweg/cast-web-api/master/lib/swagger/swagger.json \"swagger.json\"), in the [online editor](https://editor.swagger.io/).\n\n#### Local\nInstall the devDependencies for instance `git clone` this repo then `npm install` into the repo. Docs now available at `/swagger`.\n\n## Debugging //TODO: remove/edit\nEvery log output follows this format: {time} {device id} {function name}: {message}. For easy differentiation between those components, device id is inverted in color and function name underlined. Info messages appear in your standard terminal color. Error messages in red, warning messages in red and server related messages in blue.\n```\n2018-03-31T18:27:09.508Z a90824f40764eb5df1fccc4f5cb95dd3 reconnectionManagement(): reconnecting\n```\n\nBy default only certain messages are logged, to enable all log-levels see the swagger documentation on /config.\n\n## Further information\n[thibauts](https://github.com/thibauts \"thibauts profile\") wrote a great [protocol description](https://github.com/thibauts/node-castv2#protocol-description \"protocol description\"). I can only highly recommend reading it.\n\nIf you read the first sentences of this file it goes without saying that you **should not** run this API on the internet. Run it behind a firewall only in your local network!\n\nIf you find a bug or typo, feel free to contact me, open an issue, fork it, open prs, you name it.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvervallsweg%2Fcast-web-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvervallsweg%2Fcast-web-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvervallsweg%2Fcast-web-api/lists"}