diff --git a/octopus-energy/README.md b/octopus-energy/README.md
--- a/octopus-energy/README.md
+++ b/octopus-energy/README.md
#
+### Octopus Energy Telegraf Plugin
#
+This is an exec based plugin for Telegraf designed to collect Electricity usage and tariff details from the [Octopus Energy API](https://developer.octopus.energy/docs/api/)
#
+This plugin calls the Octopus API in order to retrieve information so that [Telegraf](https://github.com/influxdata/telegraf) can write it into InfluxDB for easy visualisation.
#
+Note: Octopus fetch consumption from the meter once daily, so although this plugin can collect consumption it cannot provide a realtime view (you need something like the [Glow IHD](https://www.bentasker.co.uk/posts/blog/house-stuff/connecting-my-smart-meter-to-influxdb-using-telegraf-and-a-glow-display.html) or the [Octopus Home Mini](https://octopus.energy/blog/octopus-home-mini/) for that).
#
+* Python Requests Module
#
+The API details can be passed via the `environment` configuration option
#
+ "/usr/local/src/telegraf_plugins/octopus-energy.py",
#
+ data_format = "influx"
#
+ # Update the value of these
#
+The plugin doesn't need to be run too often - Octopus fetch consumption information from your meter once daily, so consumption stats are not generally available until the day after.
#
+Tariff details (if you're on a tariff like Agile Octopus) are update more frequently though, so it's worth triggering the plugin once an hour to capture the latest pricing (as well as future pricing).
#
+### Measurements and Fields
#
+- `octopus_consumption`
#
+ - consumption (`kWh` consumed in period)
#
+ - meter_serial: serial number of the meter
#
+ - tariff_code: Octopus's tariff code (allowing Joining to pricing info)
#
+ - start_date: when service started for this meter
#
+ - account: Octopus account number
#
+ - property: Octopus property ID
#
+ - cost_exc_vat: unit price excluding vat
#
+ - cost_inc_vat: unit price including vat
#
+ - valid_from: time price came into effect
#
+ - valid_to: when price ends (or `None` if no current expiry)
#
+ - charge_type: Standing-charge or usage-charge
#
+ - payment_method: whether it's the Direct Debit or Non Direct Debit price
#
+ - tariff_code: The octopus tariff code
#
+- The `octopus_meter` measurement exists purely to make information on the meter available, it's most useful values are the tagset rather than the fields
#
+- The timestamp used in `octopus_consumption` is the *end* of the indicated period, so if Octopus's API reports 1kWh used between 00:00 and 00:30, the timestamp on the point will be for 00:30
#
+- For ease of joining, the plugin calculates `octopus_pricing` points every 30 minutes between `valid_from` and `valid_to`
#
+- Export tariffs don't currently have any specific handling (that will be added later)
#
+- Gas isn't currently handled
#
+Copyright 2023, B Tasker. Released under [BSD 3 Clause](https://www.bentasker.co.uk/pages/licenses/bsd-3-clause.html).