git404hub

what is cosy-watch-octopus-heat-pump-widget fr?

tstomsmith-arch/cosy-watch-octopus-heat-pump-widget — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · generalComplexity · 2/5Setup · easy

tl;dr

An unofficial iPhone Scriptable widget that shows Octopus Cosy heat pump status, temperatures, and energy use on your Home Screen.

vibe map

mindmap
  root((cosy watch))
    What it does
      iPhone widget
      Shows heat pump data
      Runs in Scriptable
    Data shown
      Pump status
      Hot water temp
      COP and power use
      Fault codes
    Tech stack
      JavaScript
      Scriptable app
      Octopus API
    Use cases
      Home Screen monitoring
      Fault spotting
      Energy usage tracking

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Add a Home Screen widget that shows your heat pump's status without opening the Octopus Energy app.

VIBE 2

Monitor hot water temperature and Coefficient of Performance to check heating efficiency at a glance.

VIBE 3

Spot fault states quickly using the widget's highlighted fault codes.

VIBE 4

Track today's and yesterday's energy usage from a Cosy heat pump directly on the phone screen.

what's the stack?

JavaScriptScriptableOctopus Energy API

how it stacks up fr

tstomsmith-arch/cosy-watch-octopus-heat-pump-widget0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Requires the Scriptable app, an Octopus Cosy heat pump, and Octopus API credentials to connect.

in plain english

Cosy Watch is a widget for the iPhone app Scriptable, built to show information from an Octopus Cosy heat pump right on your Home Screen. Instead of opening the Octopus Energy app each time you want to check your heating system, this widget pulls the same kind of data and displays it as a small, always visible tile. The widget can show the heat pump's current status, hot water temperature, its Coefficient of Performance which is a measure of how efficiently it is running, heat output, power usage, and outside temperature. It also shows data from Cosy Pods, small sensors placed around a home, including average room temperature, the range of temperatures across different pods, and average humidity. It tracks today's and yesterday's energy usage, and highlights fault states with fault codes when they are available, so a problem with the heat pump is easy to spot at a glance. To use it, you need an iPhone or iPad, the free Scriptable app from the App Store, an Octopus Cosy heat pump, and access to the Octopus API. Setup involves installing Scriptable, downloading the Cosy Watch script, opening it inside Scriptable, entering your API credentials, running it once to confirm it connects correctly, and then adding it as a widget on your Home Screen. This is an independent, unofficial project made by an Octopus Cosy customer, and it is not affiliated with, endorsed by, or supported by Octopus Energy in any way. The project has a companion GitHub Pages website with more detailed setup instructions and screenshots, and the author welcomes bug reports and feature suggestions through GitHub Issues or Discussions.

prompts (copy fr)

prompt 1
Walk me through installing the Scriptable app and setting up this Cosy Watch widget on my iPhone.
prompt 2
Explain what API credentials I need to enter for this widget to connect to my Octopus Cosy heat pump.
prompt 3
Explain what Coefficient of Performance means in the context of this heat pump widget.
prompt 4
Help me troubleshoot why the widget is not showing fault codes for my heat pump.

Frequently asked questions

what is cosy-watch-octopus-heat-pump-widget fr?

An unofficial iPhone Scriptable widget that shows Octopus Cosy heat pump status, temperatures, and energy use on your Home Screen.

What language is cosy-watch-octopus-heat-pump-widget written in?

Mainly JavaScript. The stack also includes JavaScript, Scriptable, Octopus Energy API.

How hard is cosy-watch-octopus-heat-pump-widget to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is cosy-watch-octopus-heat-pump-widget for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.