{"id":47170602,"url":"https://github.com/jasondostal/tunnelvision-ha","last_synced_at":"2026-03-15T10:37:26.191Z","repository":{"id":341909031,"uuid":"1171338589","full_name":"jasondostal/tunnelvision-ha","owner":"jasondostal","description":"Home Assistant HACS integration for TunnelVision VPN containers","archived":false,"fork":false,"pushed_at":"2026-03-03T20:48:07.000Z","size":199,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-04T00:23:09.355Z","etag":null,"topics":["hacs","home-assistant","killswitch","qbittorrent","vpn","wireguard"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/jasondostal.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,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-03T05:47:25.000Z","updated_at":"2026-03-03T20:48:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jasondostal/tunnelvision-ha","commit_stats":null,"previous_names":["jasondostal/tunnelvision-ha"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jasondostal/tunnelvision-ha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasondostal%2Ftunnelvision-ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasondostal%2Ftunnelvision-ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasondostal%2Ftunnelvision-ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasondostal%2Ftunnelvision-ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jasondostal","download_url":"https://codeload.github.com/jasondostal/tunnelvision-ha/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasondostal%2Ftunnelvision-ha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30459210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T03:55:51.346Z","status":"ssl_error","status_checked_at":"2026-03-13T03:55:33.055Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["hacs","home-assistant","killswitch","qbittorrent","vpn","wireguard"],"created_at":"2026-03-13T05:00:56.733Z","updated_at":"2026-03-13T05:02:05.922Z","avatar_url":"https://github.com/jasondostal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/tunnelvision-readme-banner.png\" alt=\"TunnelVision for Home Assistant\" width=\"800\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jasondostal/tunnelvision-ha/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/jasondostal/tunnelvision-ha?style=flat-square\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/hacs/integration\"\u003e\u003cimg src=\"https://img.shields.io/badge/HACS-Custom-orange?style=flat-square\" alt=\"HACS\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/HA-2024.1+-41BDF5?style=flat-square\u0026logo=home-assistant\" alt=\"HA\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/entities-33-brightgreen?style=flat-square\" alt=\"Entities\"\u003e\n\u003c/p\u003e\n\n---\n\nNative Home Assistant integration for [TunnelVision](https://github.com/jasondostal/tunnelvision). 33 entities, real-time SSE updates, HTTPS support, config flow, zero YAML.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/screenshot-ha.png\" alt=\"TunnelVision Home Assistant Entities\" width=\"400\"\u003e\n\u003c/p\u003e\n\n## Install\n\n### HACS (Recommended)\n\n1. Open Home Assistant → HACS → Integrations\n2. Click the three dots (top right) → **Custom Repositories**\n3. Paste `https://github.com/jasondostal/tunnelvision-ha`\n4. Select category **Integration** → click **Add**\n5. Close the dialog → search for **TunnelVision** in the HACS store\n6. Click **Download** → **Restart Home Assistant**\n\n### Manual\n\n1. Download the [latest release](https://github.com/jasondostal/tunnelvision-ha/releases)\n2. Copy the `custom_components/tunnelvision/` folder into your HA `config/custom_components/` directory\n3. Restart Home Assistant\n\n## Setup\n\n**Settings → Integrations → Add → TunnelVision** → enter host + port. Done.\n\nIf TunnelVision is behind a reverse proxy with TLS, check **Use HTTPS** and optionally uncheck **Verify SSL certificate** for self-signed certs.\n\n\u003e **Tip:** If HA runs in `network_mode: host`, use your server IP and the mapped port (e.g. `192.168.1.x:8181`). If HA is on the same Docker network, use the container name and internal port (e.g. `tunnelvision:8081`).\n\n## What You Get\n\n**16 sensors** — VPN state, public IP, country, city, location, download/upload speed, active/total torrents, total downloaded/uploaded, provider, forwarded port, DNS state, HTTP proxy state, SOCKS proxy state\n\n**7 binary sensors** — VPN connected, killswitch active, healthy, qBittorrent running, DNS, HTTP proxy, SOCKS proxy\n\n**5 buttons** — Restart VPN, rotate server, restart qBit, pause/resume torrents\n\n**2 switches** — VPN on/off, Killswitch on/off (reflect actual state)\n\n**3 services** — For automations:\n\n```yaml\nservice: tunnelvision.vpn\ndata:\n  action: restart  # disconnect, reconnect, rotate\n\nservice: tunnelvision.qbittorrent\ndata:\n  action: restart  # pause, resume\n\nservice: tunnelvision.killswitch\ndata:\n  action: enable  # disable\n```\n\n## Automations\n\n\u003cdetails\u003e\n\u003csummary\u003eNotify when VPN drops\u003c/summary\u003e\n\n```yaml\nautomation:\n  - alias: \"TunnelVision VPN Down\"\n    trigger:\n      - platform: state\n        entity_id: binary_sensor.tunnelvision_vpn_connected\n        to: \"off\"\n    action:\n      - service: notify.mobile_app\n        data:\n          title: \"VPN Down\"\n          message: \"TunnelVision VPN disconnected\"\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAuto-reconnect after 1 minute\u003c/summary\u003e\n\n```yaml\nautomation:\n  - alias: \"TunnelVision Auto-Reconnect\"\n    trigger:\n      - platform: state\n        entity_id: binary_sensor.tunnelvision_vpn_connected\n        to: \"off\"\n        for: \"00:01:00\"\n    action:\n      - service: tunnelvision.vpn\n        data:\n          action: reconnect\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eRotate server daily at 4am\u003c/summary\u003e\n\n```yaml\nautomation:\n  - alias: \"TunnelVision Daily Rotation\"\n    trigger:\n      - platform: time\n        at: \"04:00:00\"\n    action:\n      - service: tunnelvision.vpn\n        data:\n          action: rotate\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003ePause torrents when VPN drops\u003c/summary\u003e\n\n```yaml\nautomation:\n  - alias: \"TunnelVision Pause on VPN Drop\"\n    trigger:\n      - platform: state\n        entity_id: binary_sensor.tunnelvision_vpn_connected\n        to: \"off\"\n    action:\n      - service: tunnelvision.qbittorrent\n        data:\n          action: pause\n```\n\n\u003c/details\u003e\n\n## MQTT Alternative\n\nTunnelVision also supports **MQTT with auto-discovery**. Set `MQTT_ENABLED=true` in your TunnelVision container and entities appear in HA without this integration. Use whichever method fits your setup — this integration uses direct API polling (every 15s), MQTT provides real-time push.\n\n## License\n\n[GPL-3.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasondostal%2Ftunnelvision-ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasondostal%2Ftunnelvision-ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasondostal%2Ftunnelvision-ha/lists"}