{"id":16075472,"url":"https://github.com/ptz0n/homebridge-verisure","last_synced_at":"2025-03-16T08:32:17.058Z","repository":{"id":38129656,"uuid":"79654680","full_name":"ptz0n/homebridge-verisure","owner":"ptz0n","description":" Platform plugin for Homebridge allowing to manage and control Verisure devices.","archived":false,"fork":false,"pushed_at":"2023-12-05T09:00:34.000Z","size":264,"stargazers_count":67,"open_issues_count":18,"forks_count":15,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-11T23:28:26.547Z","etag":null,"topics":["homebridge","homebridge-plugin","iot","verisure"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/homebridge-verisure","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/ptz0n.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["ptz0n"],"custom":["https://www.paypal.com/paypalme/ptz0n"]}},"created_at":"2017-01-21T15:41:49.000Z","updated_at":"2025-03-08T11:27:07.000Z","dependencies_parsed_at":"2024-11-06T16:39:36.884Z","dependency_job_id":"0705684c-6a06-4213-9229-8249587cb895","html_url":"https://github.com/ptz0n/homebridge-verisure","commit_stats":{"total_commits":197,"total_committers":7,"mean_commits":"28.142857142857142","dds":"0.15736040609137059","last_synced_commit":"02f1a40bc5febb06e121dcf451159aac3ef4ef7c"},"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptz0n%2Fhomebridge-verisure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptz0n%2Fhomebridge-verisure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptz0n%2Fhomebridge-verisure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptz0n%2Fhomebridge-verisure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ptz0n","download_url":"https://codeload.github.com/ptz0n/homebridge-verisure/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243762257,"owners_count":20343978,"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":["homebridge","homebridge-plugin","iot","verisure"],"created_at":"2024-10-09T09:05:24.580Z","updated_at":"2025-03-16T08:32:16.517Z","avatar_url":"https://github.com/ptz0n.png","language":"JavaScript","funding_links":["https://github.com/sponsors/ptz0n","https://www.paypal.com/paypalme/ptz0n"],"categories":[],"sub_categories":[],"readme":"# homebridge-verisure\n\n[![Verified by Homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n[![Synk badge](https://snyk.io/test/github/ptz0n/homebridge-verisure/badge.svg)](https://snyk.io/)\n\n[![GitHub Actions badge](https://github.com/ptz0n/homebridge-verisure/workflows/Test/badge.svg)](https://github.com/ptz0n/homebridge-verisure/actions?query=workflow%3ATest)\n\nThis is a plugin for [Homebridge](https://github.com/nfarina/homebridge). It's\nan implementation for your Verisure installation and exposes the following devices:\n\n- Security alarm\n- Climate sensor\n- Magnetic contact\n- Night Control\n- Siren\n- SmartLock\n- SmartPlug\n- Smoke detector\n- Vibration detector\n\n## Protect linked devices \u0026 accounts\n\nIf configured, this plugin will expose your security system and door lock.\nPlease protect you installation from unauthorised access:\n\n1. Generate a unique `pin` for your config. Never, ever use the default one.\n2. Lock all devices with access to your installation when not in use.\n3. Remove access from users that no longer need it.\n4. Keep your devices up to date.\n\n## Installation\n\n```bash\nnpm install -g homebridge-verisure\n```\n\nNow you can update your configuration file to enable the plugin, see sample\nsnippet below.\n\n## Configuration\n\nAs part of your configuration, add an object with your Verisure credentials to\nyour array (list) of enabled platform plugins. Example config:\n\n```json\n\"platforms\": [\n  {\n    \"platform\" : \"verisure\",\n    \"name\" : \"Verisure\",\n    \"email\": \"your@email.com\",\n    \"password\": \"yourT0p5ecre7Passw0rd\",\n    \"cookies\": [\n      \"vid=myTopSecretToken\",\n      \"vs-access=myAccessToken\",\n      \"vs-refresh=myRefreshToken\"\n    ],\n    \"alarmCode\": \"0000\",\n    \"doorCode\": \"000000\",\n    \"installations\": [\"Alias\"],\n    \"pollInterval\": 60\n  }\n]\n```\n\n* __`email`__ Required string containing your Verisure account email address.\n* __`password`__ Required string containing your Verisure account password. Not needed if you use `cookies`.\n* __`cookies`__ Required array of strings for accounts with MFA enabled.\n* `alarmCode` Optional string containing your security system alarm code.\n* `doorCode` Optional string containing your door lock code.\n* `installations` Optional array for filtering installations based on Verisure alias. Defaults to `[]`\n* `pollInterval` Optional integer containing poll interval in seconds. Defaults to `60`.\n* `showAutoLockSwitch` Optional boolean for exposing door lock auto lock switch. Defaults to `true`.\n* `showAudioSwitch` Optional boolean for exposing door audio volume switch. Defaults to `true`.\n* `audioOffValue` Optional string for door audio volume, `SILENCE` or `LOW`. Defaults to `SILENCE`.\n* `audioOnValue` Optional string for door audio volume, `LOW` or `HIGH`. Defaults to `LOW`.\n\n### Multi-factor authentication\n\n\u003e [Verisure] MFA is enabled for user. Please see README.\n\nIn 2021 Verisure started enrolling MFA which requires you to obtain cookies. These cookies are used instead of a `password` in your config and will need to be renewed yearly. After installing the plugin, run `npx homebridge-verisure` in your terminal and copy the output values into your config.\n\n```bash\n$ npx homebridge-verisure\n✔ What is your login email? · foo@bar.com\n✔ What is your password? · ********************\n\n One-time code sent.\n\n✔ What is your one-time code? · FAKE12\n\n Your config is ready.\n\n{\n  \"platform\": \"verisure\",\n  \"name\": \"Verisure\",\n  \"email\": \"foo@bar.com\",\n  \"cookies\": [\n    \"vid=myTopSecretToken\",\n    \"vs-access=myAccessToken\",\n    \"vs-refresh=myRefreshToken\"\n  ]\n}\n```\n\n### Environment variables\n\nFor convenience, the following environment variables can be used instead of placing secrets in your `config.json`.\n\n* `VERISURE_ALARM_CODE`\n* `VERISURE_COOKIES` - Join into a string, separated by `;`. Example: `vid=myTopSecretToken;vs-access=myAccessToken;vs-refresh=myRefreshToken`.\n* `VERISURE_DOOR_CODE`\n* `VERISURE_EMAIL`\n* `VERISURE_PASSWORD`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptz0n%2Fhomebridge-verisure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fptz0n%2Fhomebridge-verisure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptz0n%2Fhomebridge-verisure/lists"}