Skip to main content

This module allows you to retrieve your Linky consumption data from your Enedis account.

Project description

Linkpy - Access your Linky data via Python

What is this?

This Python 3 library allows you to retrieve your Linky power consumption data without any hardware, just a connection to your Enedis account.

This module was previously part of Linkindle and was extracted for better modularity and easier usage.

How to install

pip3 install linkpy

Help, it's not working!

  1. First, check that the Enedis website itself is working.
  2. You might need to accept updated terms and conditions on the website. Linkpy won't work until you do.
  3. Check that you have the latest version of this package. As Enedis changes its website, stuff can and occasionally does break.
  4. If everything else fails, you can report an issue. I'll try to get to it on my free time, but contributions are welcome!

How to use

from linkpy import Linky, LinkyLoginException, LinkyServiceException

    linky = Linky()
    linky.login(USERNAME, PASSWORD)

    today =
    res_year = linky.get_data_per_year()

    # 6 months ago - today
    res_month = linky.get_data_per_month(dtostr(
        today - relativedelta(months=6)), dtostr(today))

    # One month ago - yesterday
    res_day = linky.get_data_per_day(
                dtostr(today - relativedelta(days=1, months=1)),
                dtostr(today - relativedelta(days=1)))

    # Yesterday - today
    res_hour = linky.get_data_per_hour(
                dtostr(today - relativedelta(days=1)), 
except LinkyLoginException as exc:

except LinkyServiceException as exc:


See my Linkindle project for a real-life example.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

linkpy-1.0.tar.gz (4.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page