{"id":41729146,"url":"https://github.com/jayme-github/fritzbox_smarthome_exporter","last_synced_at":"2026-01-24T23:21:25.914Z","repository":{"id":57567392,"uuid":"140881176","full_name":"jayme-github/fritzbox_smarthome_exporter","owner":"jayme-github","description":"AVM FRITZ!Box Home Automation / Smart Home exporter for Prometheus","archived":false,"fork":false,"pushed_at":"2023-10-16T14:45:59.000Z","size":100,"stargazers_count":39,"open_issues_count":3,"forks_count":11,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-06-20T16:41:02.808Z","etag":null,"topics":["avm-fritz","fritz-box","fritzbox","home-automation","prometheus","prometheus-exporter","smarthome"],"latest_commit_sha":null,"homepage":"","language":"Go","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/jayme-github.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-13T18:35:07.000Z","updated_at":"2024-04-13T13:17:30.000Z","dependencies_parsed_at":"2024-06-20T16:25:53.775Z","dependency_job_id":"bbf5df40-a300-4706-9074-144613212121","html_url":"https://github.com/jayme-github/fritzbox_smarthome_exporter","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/jayme-github/fritzbox_smarthome_exporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayme-github%2Ffritzbox_smarthome_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayme-github%2Ffritzbox_smarthome_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayme-github%2Ffritzbox_smarthome_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayme-github%2Ffritzbox_smarthome_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jayme-github","download_url":"https://codeload.github.com/jayme-github/fritzbox_smarthome_exporter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayme-github%2Ffritzbox_smarthome_exporter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28738982,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["avm-fritz","fritz-box","fritzbox","home-automation","prometheus","prometheus-exporter","smarthome"],"created_at":"2026-01-24T23:21:18.676Z","updated_at":"2026-01-24T23:21:23.972Z","avatar_url":"https://github.com/jayme-github.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FRITZ!Box Smarthome exporter for prometheus\nExport information about your smarthome devices (switches, powermeters, thermostat, ...) to prometheus.\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/jaymedh/fritzbox_smarthome_exporter)](https://hub.docker.com/r/jaymedh/fritzbox_smarthome_exporter)\n\n# Usage\n\n* Setup a (restricted) user account for the exporter to use. This accounts only need access to smarthome devices, see [Setting up users with restricted authorization](https://en.avm.de/service/fritzbox/fritzbox-5490/knowledge-base/publication/show/1522_Accessing-FRITZ-Box-from-the-home-network-with-user-accounts/) for details.\n* [Download your FRITZ!Box certificate](https://en.avm.de/service/fritzbox/fritzbox-7390/knowledge-base/publication/show/1523_Downloading-your-FRITZ-Box-certificate-and-importing-it-to-your-computer/) (recommended)\n\n```\nUsage of ./fritzbox_smarthome_exporter:\n  -cert=\"\": Path to the FRITZ!Box certificate.\n  -loglevel=\"warn\": Logging verbosity (debug, info, warn or error)\n  -noverify=false: Omit TLS verification of the FRITZ!Box certificate.\n  -password=\"\": FRITZ!Box password.\n  -url=\"https://fritz.box\": FRITZ!Box URL.\n  -username=\"\": FRITZ!Box username.\n```\nCommand line arguments or environment variables (the argument as uppercase, like `CERT` for `-cert`) may be used.\n\n\nThe exporter will bind to TCP Port 9103 and export the following metrics via `/metrics`:\n\n```\n# HELP fritzbox_battery_charge_level Battery charge level in percent\n# TYPE fritzbox_battery_charge_level gauge\nfritzbox_battery_charge_level{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 70\nfritzbox_battery_charge_level{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 100\n# HELP fritzbox_batterylow 0 if the battery is OK, 1 if it is running low on capacity (this seems to be very unreliable)\n# TYPE fritzbox_batterylow gauge\nfritzbox_batterylow{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 0\nfritzbox_batterylow{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 0\n# HELP fritzbox_device_info Device information\n# TYPE fritzbox_device_info gauge\nfritzbox_device_info{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\",functionbitmask=\"35712\",fw_version=\"04.16\",internal_id=\"16\",manufacturer=\"AVM\"} 1\nfritzbox_device_info{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\",functionbitmask=\"320\",fw_version=\"03.54\",internal_id=\"21\",manufacturer=\"AVM\"} 1\nfritzbox_device_info{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\",functionbitmask=\"1048864\",fw_version=\"05.21\",internal_id=\"26\",manufacturer=\"AVM\"} 1\n# HELP fritzbox_device_present Device connected (1) or not (0)\n# TYPE fritzbox_device_present gauge\nfritzbox_device_present{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 1\nfritzbox_device_present{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 1\nfritzbox_device_present{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 1\n# HELP fritzbox_energy Absolute energy consumption (in  Wh) since the device started operating\n# TYPE fritzbox_energy gauge\nfritzbox_energy{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 339584\n# HELP fritzbox_humidity_percent Relative humidity measured as full percentile\n# TYPE fritzbox_humidity_percent gauge\nfritzbox_humidity_percent{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 54\n# HELP fritzbox_power Current power (in W), refreshed approx every 2 minutes\n# TYPE fritzbox_power gauge\nfritzbox_power{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\n# HELP fritzbox_switch_boxlock Switching via FRITZ!Box disabled? 1/0, -1 if not known or error\n# TYPE fritzbox_switch_boxlock gauge\nfritzbox_switch_boxlock{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\n# HELP fritzbox_switch_devicelock Switching via device disabled 1/0, -1 if not known or error\n# TYPE fritzbox_switch_devicelock gauge\nfritzbox_switch_devicelock{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\n# HELP fritzbox_switch_mode Switch mode 1/0 (manual/automatic), -1 if not known or error\n# TYPE fritzbox_switch_mode gauge\nfritzbox_switch_mode{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\n# HELP fritzbox_switch_state Switch state 1/0 (on/off), -1 if not known or error\n# TYPE fritzbox_switch_state gauge\nfritzbox_switch_state{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\n# HELP fritzbox_temperature Temperature measured at the device sensor in units of 0.1 °C\n# TYPE fritzbox_temperature gauge\nfritzbox_temperature{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 20\nfritzbox_temperature{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 19\nfritzbox_temperature{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 17.5\n# HELP fritzbox_temperature_offset Temperature offset (set by the user) in units of 0.1 °C\n# TYPE fritzbox_temperature_offset gauge\nfritzbox_temperature_offset{device_id=\"12345 0000001\",device_name=\"SW_1\",device_type=\"FRITZ!DECT 200\"} 0\nfritzbox_temperature_offset{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 0\nfritzbox_temperature_offset{device_id=\"12345 0000007\",device_name=\"BUTTON_1\",device_type=\"FRITZ!DECT 440\"} 0\n# HELP fritzbox_thermostat_battery_charge_level Battery charge level in percent\n# TYPE fritzbox_thermostat_battery_charge_level gauge\nfritzbox_thermostat_battery_charge_level{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 70\n# HELP fritzbox_thermostat_batterylow 0 if the battery is OK, 1 if it is running low on capacity (this seems to be very unreliable)\n# TYPE fritzbox_thermostat_batterylow gauge\nfritzbox_thermostat_batterylow{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 0\n# HELP fritzbox_thermostat_comfort Comfort temperature configured in units of 0.1 °C\n# TYPE fritzbox_thermostat_comfort gauge\nfritzbox_thermostat_comfort{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 19\n# HELP fritzbox_thermostat_errorcode Thermostat error code (0 = OK), see https://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/AHA-HTTP-Interface.pdf\n# TYPE fritzbox_thermostat_errorcode gauge\nfritzbox_thermostat_errorcode{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 0\n# HELP fritzbox_thermostat_goal Desired temperature (user controlled) in units of 0.1 °C\n# TYPE fritzbox_thermostat_goal gauge\nfritzbox_thermostat_goal{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 16\n# HELP fritzbox_thermostat_saving Configured energy saving temperature in units of 0.1 °C\n# TYPE fritzbox_thermostat_saving gauge\nfritzbox_thermostat_saving{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 16\n# HELP fritzbox_thermostat_state Thermostat state 1/0 (on/off), -1 if unknown or error\n# TYPE fritzbox_thermostat_state gauge\nfritzbox_thermostat_state{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 1\n# HELP fritzbox_thermostat_window_open 1 if detected an open window (usually turns off heating), 0 if not.\n# TYPE fritzbox_thermostat_window_open gauge\nfritzbox_thermostat_window_open{device_id=\"12345 0000002\",device_name=\"HKR_1\",device_type=\"Comet DECT\"} 0\n```\n\n\n# Docker\nDocker images are build for tags [jaymedh/fritzbox_smarthome_exporter](https://hub.docker.com/r/jaymedh/fritzbox_smarthome_exporter/).\n\nFRITZ!Box certificate may be mounted into the container, configuration can be done via arguments or environment variables (or both):\n```\ndocker run -d --name fritzbox_smarthome_exporter -p 9103:9103 \\\n  -v $(pwd)/boxcert.cer:/fritzbox.pem:ro \\\n  -e PASSWORD=SuperSecret \\\n  -e USERNAME=SmarthomeUser \\\n  jaymedh/fritzbox_smarthome_exporter -url=\"https://fritz.box:8443\" -cert=/fritzbox.pem\n```\n\n\n# Grafana\n\nExample Grafana dashboard can be found at https://grafana.com/dashboards/7019\nAnother sample dashboard can be found here: https://grafana.com/grafana/dashboards/19759\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayme-github%2Ffritzbox_smarthome_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjayme-github%2Ffritzbox_smarthome_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayme-github%2Ffritzbox_smarthome_exporter/lists"}