Electricity Maps
A real-time visualization of the CO2 emissions from electricity consumption.
https://github.com/electricitymaps/electricitymaps-contrib
Category: Emissions
Sub Category: Carbon Intensity and Accounting
Keywords
app climate-change data-visualization electricity electricity-consumption electricity-prices electricitymap electricitymaps hacktoberfest map sustainability
Keywords from Contributors
carbon-footprint climate community varta-storage varta business-intelligence alerting life-cycle-assessment climate-impact carbon-model
Last synced: 2 minutes ago
JSON representation
Repository metadata
The open source repository for Electricity Maps data parsers that powers the world's most comprehensive electricity data platform
- Host: GitHub
- URL: https://github.com/electricitymaps/electricitymaps-contrib
- Owner: electricitymaps
- License: agpl-3.0
- Created: 2016-05-21T16:36:17.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2026-02-11T14:30:01.000Z (8 days ago)
- Last Synced: 2026-02-11T15:57:21.289Z (8 days ago)
- Topics: app, climate-change, data-visualization, electricity, electricity-consumption, electricity-prices, electricitymap, electricitymaps, hacktoberfest, map, sustainability
- Language: Python
- Homepage: https://app.electricitymaps.com
- Size: 200 MB
- Stars: 3,943
- Watchers: 73
- Forks: 1,031
- Open Issues: 144
- Releases: 650
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
README.md
Introduction
This project aims to provide a free, open-source, and transparent visualisation of the electricity data around the world.
We fetch the raw production data from public, free, and official sources. They include official government and transmission system operators' data. We then run our flow-tracing algorithm, estimation models, forecast engine and much more to calculate the most accurate view of how electricity consumption changes over time for each country.
Try it out at app.electricitymaps.com, or download the app on Google Play or App store.
Contributing
The Electricity Maps app is a community project and we welcome contributions from anyone!
We are always looking for help to build parsers for new countries, fix broken parsers, improve accuracy of data sources, discuss new potential data sources, update region capacities, and much more.
Read our contribution guidelines to get started.
Community & Support
Use these channels to be part of the community, ask for help while using Electricity Maps, or just learn more about what's going on:
- GitHub Issues: Raise any issues you encounter with the data or bugs you find while using the app.
- GitHub Discussions: Join discussions and share new ideas for features.
- GitHub Wiki: Learn more about methodology, guides for how to set up development environment, etc.
- Our Commercial Website: Learn more about how you or your company can use the data too.
- Our Blog: Read about the green transition and how Electricity Maps is helping to accelerate it.
- Twitter: Follow for latest news
- LinkedIn: Follow for latest news
License
This repository is licensed under GNU-AGPLv3 since v1.5.0, find our license here. Contributions prior to commit cb9664f were licensed under MIT license
Frequently asked questions
Where does the data come from?
The data comes from many different sources. You can check them out here
Why do you calculate the carbon intensity of consumption?
In short, citizens should not be responsible for the emissions associated with all the products they export, but only for what they consume.
Consumption-based accounting (CBA) is a very important aspect of climate policy and allows assigning responsibility to consumers instead of producers.
Furthermore, this method is robust to governments relocating dirty production to neighboring countries in order to green their image while still importing from it.
You can read more in our blog post here.
Why don't you show emissions per capita?
A country that has few inhabitants but a lot of factories will appear high on CO2/capita.
This means you can "trick" the numbers by moving your factory abroad and import the produced good instead of the electricity itself.
That country now has a low CO2/capita number because we only count CO2 for electricity (not for imported/exported goods).
The CO2/capita metric, by involving the size of the population, and by not integrating all CO2 emission sources, is thus an incomplete metric.
CO2 intensity on the other hand only describes where is the best place to put that factory (and when it is best to use electricity), enabling proper decisions.
CO2 emission factors look high — what do they cover exactly?
The carbon intensity of each type of power plant takes into account emissions arising from the whole life cycle of the plant (construction, fuel production, operational emissions and decommissioning). Read more on the Emissions Factor Wiki page.
How can I get access to the API?
All this and more can be found here.
You can also visit our data portal to download historical datasets.
Is the map frontend open source?
In the past, the map frontend was open source, but we have since rewritten the app completely and moved it to our own platform in order to expand the available features and provide a consistent user experience across our product offerings.
Owner metadata
- Name: Electricity Maps
- Login: electricitymaps
- Email:
- Kind: organization
- Description: Mapping the carbon footprint of electricity worldwide
- Website: https://electricitymaps.com
- Location: Denmark
- Twitter: electricitymaps
- Company:
- Icon url: https://avatars.githubusercontent.com/u/24733017?v=4
- Repositories: 9
- Last ynced at: 2024-04-24T05:28:08.468Z
- Profile URL: https://github.com/electricitymaps
GitHub Events
Total
- Create event: 672
- Release event: 87
- Issues event: 1045
- Watch event: 357
- Delete event: 551
- Issue comment event: 2223
- Push event: 2620
- Gollum event: 328
- Pull request review comment event: 1083
- Pull request review event: 1920
- Pull request event: 1473
- Fork event: 102
Last Year
- Create event: 672
- Release event: 87
- Issues event: 1045
- Watch event: 357
- Delete event: 551
- Issue comment event: 2223
- Push event: 2620
- Gollum event: 328
- Pull request review comment event: 1083
- Pull request review event: 1920
- Pull request event: 1473
- Fork event: 102
Committers metadata
Last synced: 2 days ago
Total Commits: 6,630
Total Committers: 432
Avg Commits per committer: 15.347
Development Distribution Score (DDS): 0.739
Commits in past year: 633
Committers in past year: 52
Avg Commits per committer in past year: 12.173
Development Distribution Score (DDS) in past year: 0.787
| Name | Commits | |
|---|---|---|
| Olivier Corradi | o****i@g****m | 1733 |
| Viktor Andersson | 3****9 | 633 |
| dependabot[bot] | 4****] | 507 |
| electricitymapsbot | e****b@e****m | 298 |
| Mads Nedergaard | n****s@g****m | 243 |
| Tony | t****t@e****m | 210 |
| Chris | 3****h | 154 |
| Robin TROESCH | 3****m | 122 |
| Pierre Segonne | 3****e | 120 |
| Mathilde Daugy | 1****y | 119 |
| Silke Bonnen | 9****n | 106 |
| Alex | a****z | 83 |
| Felix Qvist | f****t@g****m | 79 |
| nessie2013 | t****1@h****m | 71 |
| Filip Barl | f****l@g****m | 67 |
| tmrow-bot | k****t@t****m | 58 |
| Maxime Bellec | m****c@g****m | 56 |
| Kenneth Skovhus | s****s | 56 |
| Magnus Österlund | m****8@g****m | 55 |
| Markus Killendahl | m****l@t****m | 53 |
| Bruno Lajoie | b****e@g****m | 52 |
| jarek | j****k@p****a | 52 |
| q-- | q****- | 49 |
| Raffox97 | R****7 | 45 |
| Cadence Banulis | c****s@g****m | 45 |
| hectorespert | b****g | 42 |
| KabelWlan | 4****n | 42 |
| Phiphou | p****u | 37 |
| Jakob Buverud | j****d@g****m | 36 |
| Roberta Hunt | r****t@t****m | 36 |
| and 402 more... | ||
Committer domains:
- electricitymaps.com: 7
- tmrow.com: 4
- anu.edu.au: 2
- uwaterloo.ca: 2
- msn.com: 2
- gmx.de: 1
- edu.hefr.ch: 1
- fionatay.com: 1
- thibaultmilan.com: 1
- rajamane.me: 1
- nyu.edu: 1
- ic.ac.uk: 1
- reidmiller.name: 1
- student.tudelft.nl: 1
- vitstudent.ac.in: 1
- tobiasseidel.de: 1
- ergens.org: 1
- mac.com: 1
- snips.net: 1
- strassburger.name: 1
- fit.cvut.cz: 1
- piorkowski.ca: 1
- iovi.io: 1
- vianello.ai: 1
- student.ecp.fr: 1
- ualberta.ca: 1
- uni-hamburg.de: 1
- airbnb.com: 1
- virginia.edu: 1
- muffincompiler.de: 1
- iamguico.com: 1
- itu.dk: 1
- hkdir.no: 1
- shindogu.com: 1
- ryanb.org: 1
- laroueverte.com: 1
- fika.studio: 1
- spotify.com: 1
- geoff.kelsall.name: 1
- function1.nl: 1
- guarana.org: 1
- dahoiv.net: 1
- stojnic.com: 1
- komendera.com: 1
- gapple.ca: 1
- frogeye.fr: 1
- me.com: 1
- devmount.de: 1
- ehrat.io: 1
- yahoo.com.mx: 1
- roeckx.be: 1
- laurenceandrews.com: 1
- outlook.fr: 1
- gmx.net: 1
- microsoft.com: 1
- physik.fu-berlin.de: 1
- jonlauridsen.com: 1
- naver.com: 1
- ist.utl.pt: 1
- vt.edu: 1
- dague.net: 1
- sebastian-lay.de: 1
- cam.ac.uk: 1
- mckiernan.space: 1
- too.gy: 1
- paulstrobel.de: 1
- afroken.org: 1
- tcd.ie: 1
- abv.bg: 1
- bluewin.ch: 1
- github.com: 1
- bluerivertech.com: 1
- tteles.dev: 1
- exlabs.pl: 1
- cs.stanford.edu: 1
- qq.com: 1
- cmail.carleton.ca: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 2,877
Total pull requests: 6,635
Average time to close issues: 4 months
Average time to close pull requests: 10 days
Total issue authors: 716
Total pull request authors: 507
Average comments per issue: 4.16
Average comments per pull request: 1.49
Merged pull request: 5,312
Bot issues: 5
Bot pull requests: 1,057
Past year issues: 90
Past year pull requests: 837
Past year average time to close issues: 21 days
Past year average time to close pull requests: 4 days
Past year issue authors: 55
Past year pull request authors: 68
Past year average comments per issue: 2.22
Past year average comments per pull request: 0.82
Past year merged pull request: 531
Past year bot issues: 0
Past year bot pull requests: 240
Top Issue Authors
- corradio (468)
- tmrow-bot (412)
- VIKTORVAV99 (111)
- alixunderplatz (100)
- q-- (77)
- brunolajoie (73)
- electricitymapsbot (62)
- madsnedergaard (51)
- phiphou (50)
- jarek (48)
- systemcatch (42)
- Manu1400 (36)
- fbarl (33)
- strassburger (29)
- pierresegonne (26)
Top Pull Request Authors
- dependabot[bot] (1,057)
- VIKTORVAV99 (984)
- tonypls (372)
- madsnedergaard (295)
- silkeholmebonnen (189)
- corradio (186)
- systemcatch (157)
- mathilde-daugy (143)
- pierresegonne (140)
- unitrium (126)
- cadeban (112)
- alixunderplatz (90)
- FelixDQ (89)
- nessie2013 (78)
- Kongkille (74)
Top Issue Labels
- parser (817)
- help wanted (704)
- bug 🐞 (505)
- frontend 🎨 (488)
- data (199)
- needs triage (132)
- idea 💡 (127)
- science (79)
- good first issue (67)
- parser buildable! (63)
- data needed (63)
- question 🤔 (59)
- mobile app 📱 (56)
- capacity (39)
- duplicate (35)
- research library 📚 (25)
- historical data :calendar: (23)
- estimated data (22)
- techdebt (22)
- performance 🏎 (21)
- emission factors (16)
- translations 🗣 (12)
- fixed-in-refactor 🚀 (11)
- infrastructure (11)
- external (11)
- hacktoberfest (11)
- python (10)
- geometry (10)
- exchange config (8)
- BLOCKED (7)
Top Pull Request Labels
- frontend 🎨 (2,295)
- dependencies (1,478)
- parser (1,064)
- javascript (875)
- python (770)
- zone config (634)
- tests (407)
- infrastructure (290)
- translations 🗣 (287)
- mobile app 📱 (137)
- exchange config (134)
- performance 🏎 (102)
- github_actions (102)
- techdebt (81)
- capacity parser (52)
- capacity (50)
- change requested (35)
- Frontend 🎨 (25)
- hacktoberfest-accepted (22)
- science (21)
- Review effort [1-5]: 3 (21)
- Enhancement (18)
- BLOCKED (17)
- emission factors (10)
- bug 🐞 (10)
- Bug fix (8)
- Review effort [1-5]: 2 (7)
- help wanted (4)
- Review effort [1-5]: 1 (3)
- Review effort [1-5]: 4 (3)
Package metadata
- Total packages: 2
-
Total downloads:
- pypi: 86 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 453
- Total maintainers: 1
proxy.golang.org: github.com/electricitymaps/electricitymaps-contrib
- Homepage:
- Documentation: https://pkg.go.dev/github.com/electricitymaps/electricitymaps-contrib#section-documentation
- Licenses: agpl-3.0
- Latest release: v1.320.0 (published about 1 month ago)
- Last Synced: 2026-02-16T04:02:01.785Z (3 days ago)
- Versions: 452
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.375%
- Average: 5.556%
- Dependent repos count: 5.736%
pypi.org: electricitymaps
Official Electricity Maps Python SDK
- Homepage: https://github.com/electricitymaps/electricitymaps-contrib
- Documentation: https://docs.electricitymaps.com
- Licenses: MIT
- Latest release: 0.0.1 (published 6 months ago)
- Last Synced: 2026-02-16T04:01:56.201Z (3 days ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 86 Last month
-
Rankings:
- Forks count: 1.843%
- Stargazers count: 1.913%
- Dependent packages count: 8.651%
- Average: 15.289%
- Dependent repos count: 48.748%
- Maintainers (1)
Dependencies
- actions/checkout v4 composite
- tj-actions/changed-files v39.0.1 composite
- actions/checkout v4 composite
- github/codeql-action/analyze v2 composite
- github/codeql-action/init v2 composite
- actions/labeler v4 composite
- click <=8.0 develop
- flake8 ^3.9.2 develop
- mock ^2.0.0 develop
- pylint ^2.13.7 develop
- pylint-pydantic ^0.1.8 develop
- pytest ^7.1.2 develop
- requests-mock ~1.3.0 develop
- testfixtures ^7.0.0 develop
- Pillow ^9.1.1
- PyYAML ^6.0
- arrow 0.16.0
- beautifulsoup4 ~4.6.0
- black 22.12.0
- demjson3 ^3.0.5
- freezegun ^0.3.15
- html5lib ^1.1
- imageio ^2.18.0
- isort 5.12.0
- lxml ^4.9.1
- mock ^2.0.0
- odfpy ^1.4.1
- opencv-python 4.6.0.66
- openpyxl ^3.1.2
- pandas ^1.4.4
- pydantic ^1.9.0
- pydataxm ^0.3.2
- pytesseract 0.2.0
- python >= 3.10, < 3.11
- ree 2.3.2
- requests ~2.25.1
- ruamel-yaml ^0.17.24
- signalr-client-threads ~0.0.12
- tqdm ^4.64.0
- xlrd ^2.0.1
- xmltodict ^0.13.0
- pydantic >=1.10.17,<2
- aiohappyeyeballs 2.6.1
- aiohttp 3.13.3
- aiosignal 1.4.0
- async-timeout 5.0.1
- asyncio 4.0.0
- attrs 25.4.0
- beautifulsoup4 4.6.3
- certifi 2026.1.4
- charset-normalizer 3.4.4
- click 8.3.1
- colorama 0.4.6
- defusedxml 0.7.1
- demjson3 3.0.6
- electricitymap-contrib 1.5.5
- electricitymap-contrib-types 1.0.0
- et-xmlfile 2.0.0
- exceptiongroup 1.3.1
- freezegun 0.3.15
- frozenlist 1.8.0
- idna 3.11
- imageio 2.37.2
- iniconfig 2.3.0
- lxml 4.9.4
- multidict 6.7.0
- nest-asyncio 1.6.0
- numpy 1.26.4
- odfpy 1.4.1
- opencv-python 4.8.1.78
- openpyxl 3.1.5
- packaging 25.0
- pandas 2.3.3
- pillow 12.1.0
- pluggy 1.6.0
- propcache 0.4.1
- pycountry 22.3.5
- pydantic 1.10.26
- pydataxm 0.3.16
- pytesseract 0.2.0
- pytest 7.4.4
- python-dateutil 2.9.0.post0
- pytz 2025.2
- pyyaml 6.0.3
- requests 2.32.5
- requests-mock 1.3.0
- ruamel-yaml 0.17.40
- ruamel-yaml-clib 0.2.15
- ruff 0.11.2
- setuptools 80.9.0
- signalr-client-threads 0.0.12
- six 1.17.0
- sseclient 0.0.27
- syrupy 4.9.1
- testfixtures 7.2.2
- tomli 2.4.0
- typing-extensions 4.15.0
- tzdata 2025.3
- urllib3 2.6.3
- websocket-client 1.9.0
- xlrd 2.0.2
- xmltodict 0.13.0
- yarl 1.22.0
- actions/checkout v6 composite
- actions/checkout v6 composite
- actions/setup-python v6 composite
- ad-m/github-push-action v1.0.0 composite
- google-github-actions/auth v3 composite
- google-github-actions/setup-gcloud v3 composite
- actions/checkout v6 composite
- earthly/actions-setup v1 composite
Score: 18.84990019046297