{"id":15655337,"url":"https://github.com/grover/homebridge-callmonitor","last_synced_at":"2025-05-04T08:29:30.256Z","repository":{"id":54247021,"uuid":"113069942","full_name":"grover/homebridge-callmonitor","owner":"grover","description":"Signals incoming and outgoing calls using the call monitor facility in Fritz!Box devices via HomeKit","archived":false,"fork":false,"pushed_at":"2021-03-02T19:02:38.000Z","size":8,"stargazers_count":24,"open_issues_count":7,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-03T18:52:19.039Z","etag":null,"topics":["call","callmonitor","fritz","fritz-callmonitor","fritzbox","home-automation","homebridge","homebridge-plugin","homekit","homekit-accessory","monitor"],"latest_commit_sha":null,"homepage":null,"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/grover.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":"2017-12-04T16:57:56.000Z","updated_at":"2025-03-25T19:48:53.000Z","dependencies_parsed_at":"2022-08-13T10:00:22.732Z","dependency_job_id":null,"html_url":"https://github.com/grover/homebridge-callmonitor","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/grover%2Fhomebridge-callmonitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grover%2Fhomebridge-callmonitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grover%2Fhomebridge-callmonitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grover%2Fhomebridge-callmonitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grover","download_url":"https://codeload.github.com/grover/homebridge-callmonitor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252307340,"owners_count":21726988,"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":["call","callmonitor","fritz","fritz-callmonitor","fritzbox","home-automation","homebridge","homebridge-plugin","homekit","homekit-accessory","monitor"],"created_at":"2024-10-03T12:58:12.362Z","updated_at":"2025-05-04T08:29:30.239Z","avatar_url":"https://github.com/grover.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Homebridge Plugin to monitor calls\n\nAccessories created by this platform provide a contact sensor, which is opened for every\nincoming or outgoing call. A use for this could be to automatically turn down the volume\nof played back music to be able to recognize the ringing phone.\n\nIntegrates with HomeKit via [Homebridge](https://github.com/nfarina/homebridge).\n\n## Why a Call Monitor Plugin\n\nI have trouble hearing in noisy environments and sometimes fail to notice that my phone\nrings. I don't think I'm alone with this.\n\nI configured this plugin to turn down any music that might be playing to enable me to\nnotice that the phone rings. Another aspect is that the music playback remains turned down\nwhile I am on the phone and is raised as soon as I hang up.\n\nThis callmonitor plugin exposes two contact sensors - one for incoming calls and one\nfor outgoing calls. These enable the separate handling by call direction and the application\nof different rules.\n\n## Installation instructions\n\nAfter [Homebridge](https://github.com/nfarina/homebridge) has been installed:\n\n ```sudo npm install -g homebridge-callmonitor```\n\n## Example config.json\n\n```json\n{\n  \"bridge\": {\n      ...\n  },\n  \"platforms\": [\n    {\n      \"platform\": \"CallMonitor\",\n      \"devices\": [\n        {\n          \"name\": \"AVM Fritz!Box 7490\",\n          \"address\": \"192.168.178.1\",\n          \"port\": \"1012\",\n          \"outgoingName\": \"Ausgehender Anruf\",\n          \"incomingName\": \"Eingehender Anruf\"\n        }\n      ]\n    }\n  ]\n}\n```\n\nThe platform can connect to any number of devices, which support the call monitor protocol supported by AVM Fritz!Box devices. I've tested it with an AVM Fritz!Box 7490, other models may work as well. If you want to report a different\ndevice as working, please file an issue.\n\nA device is configured by specifying the following:\n\n| Attributes | Usage |\n|------------|-------|\n| name | The name of the device. Must be specified. |\n| address | The IPv4 address of the AVM Fritz device. If no address is specified, the accessory will not be created. |\n| port | The port where the Fritz device reports call statistic data. This default is 1012. |\n| incomingName | The name of the contact sensor service for incoming calls. If not specified this is the name of the device with `- incoming` appended. |\n| outgoingName | The name of the contact sensor service for outgoing calls.  If not specified this is the name of the device with `- outgoing` appended. |\n\n\n## Accessory Services\n\nEach bot will expose two services:\n\n* Accessory Information Service\n* Contact Sensor Service for incoming calls\n* Contact Sensor Service for outgoing calls\n\n## Supported clients\n\nThis platform and the bots it drives have been verified to work with the following apps on iOS 11\n\n* Elgato Eve\n* Home\n\n## Supported devices\n\n* AVM Fritz!Box 7490\n\nOther devices not listed here may work. If you have another device that works, please report\nit via a [GitHub](https://github.com/grover/homebridge-callmonitor/issues) issue.\n\n### Configuration\n\nYou need to enable the call monitor on most devices. For AVM Fritz!Box devices this can be done by dialing `#96*5*` on a connected phone. To disable the call monitor dial `#96*4*`.\n\n## Some asks for friendly gestures\n\nIf you use this and like it - please leave a note by staring this package here or on GitHub.\n\nIf you use it and have a problem, file an issue at [GitHub](https://github.com/grover/homebridge-callmonitor/issues) - I'll try to help.\n\nIf you tried this, but don't like it: tell me about it in an issue too. I'll try my best\nto address these in my spare time.\n\nIf you fork this, go ahead - I'll accept pull requests for enhancements.\n\n## License\n\nMIT License\n\nCopyright (c) 2017 Michael Fröhlich\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrover%2Fhomebridge-callmonitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrover%2Fhomebridge-callmonitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrover%2Fhomebridge-callmonitor/lists"}