{"id":16632709,"url":"https://github.com/benwebber/toronto-hydro-green-button","last_synced_at":"2025-10-30T04:30:30.085Z","repository":{"id":57476656,"uuid":"226031375","full_name":"benwebber/toronto-hydro-green-button","owner":"benwebber","description":":electric_plug: Export Green Button (ESPI) energy usage data from Toronto Hydro","archived":false,"fork":false,"pushed_at":"2019-12-05T06:55:12.000Z","size":5,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T06:24:21.483Z","etag":null,"topics":["energy-consumption","espi","green-button","home-automation","toronto-hydro"],"latest_commit_sha":null,"homepage":"","language":"Python","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/benwebber.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":"2019-12-05T06:24:01.000Z","updated_at":"2024-08-12T13:50:06.000Z","dependencies_parsed_at":"2022-09-10T04:12:13.782Z","dependency_job_id":null,"html_url":"https://github.com/benwebber/toronto-hydro-green-button","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Ftoronto-hydro-green-button","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Ftoronto-hydro-green-button/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Ftoronto-hydro-green-button/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Ftoronto-hydro-green-button/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benwebber","download_url":"https://codeload.github.com/benwebber/toronto-hydro-green-button/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238930129,"owners_count":19554122,"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":["energy-consumption","espi","green-button","home-automation","toronto-hydro"],"created_at":"2024-10-12T05:09:54.662Z","updated_at":"2025-10-30T04:30:24.791Z","avatar_url":"https://github.com/benwebber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# toronto-hydro-green-button\n\nExport [Green Button](https://green-button.github.io/) ([ESPI](https://www.naesb.org//ESPI_Standards.asp)) energy usage data from your [Toronto Hydro](https://torontohydro.com/) account.\n\nToronto Hydro offers a Green Button XML export through the customer portal, but does not offer programmatic API access.\nThis script logs into the dashboard with [Selenium](https://selenium.dev/), then downloads the report with [Requests](https://2.python-requests.org/en/master/).\n\n## Requirements\n\n* a [Toronto Hydro](https://torontohydro.com/) account\n* Python 3.6+\n* Firefox 57+ or Google Chrome and ChromeDriver\n\n## Installation\n\nInstall with pip:\n\n```\npip install toronto-hydro-green-button\n```\n\n## Usage\n\nThe script needs your username and password to log into the dashboard.\nIt will check, in order of precedence:\n\n* `--username`/`-u` and `--password`/`-p` arguments\n* `TORONTO_HYDRO_USERNAME` and `TORONTO_HYDRO_PASSWORD` environment variables\n* prompt input\n\nUse `--start-date` and `--end-date` to query data between two dates (inclusive).\n\n```\n$ toronto-hydro-green-button --start-date 2019-11-01 --end-date 2019-11-31\n```\n\nIf ChromeDriver is installed, the script attempts to use it by default.\nOtherwise it falls back on headless Firefox.\nChromeDriver was slightly faster in my limited testing.\n\nRun `toronto-hydro-green-button --help` for additional usage information.\n\n## Tips\n\nToronto Hydro usage data lags by 2\u0026ndash;3 days.\nThis script defaults to querying data from two days ago.\n\nIf you run this script frequently, you may not always see fresh data.\nIt should be sufficient to run it daily.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwebber%2Ftoronto-hydro-green-button","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenwebber%2Ftoronto-hydro-green-button","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwebber%2Ftoronto-hydro-green-button/lists"}