diff --git a/.vscode/settings.json b/.vscode/settings.json index cbac569..c3119b7 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,3 +1,4 @@ { - "deno.enable": true + "deno.enable": true, + "licenser.license": "WTFPL" } diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..eeb8a94 --- /dev/null +++ b/LICENSE @@ -0,0 +1,13 @@ +DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE +Version 2, December 2004 + +Copyright (C) 2025 Jake Walker + +Everyone is permitted to copy and distribute verbatim or modified +copies of this license document, and changing it is allowed as long +as the name is changed. + +DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +0. You just DO WHAT THE FUCK YOU WANT TO. diff --git a/README.md b/README.md new file mode 100644 index 0000000..18aff17 --- /dev/null +++ b/README.md @@ -0,0 +1,14 @@ +# Octoplus Coffee Check + +[Octopus Energy](https://octopus.energy) give away free coffee to customers each week, but since they started releasing codes every day, rather than at the start of each week, I'm struggling to get them. This is a simple tool that will check for available coffee codes and notify via a webhook. + +## Usage + +Setup a cronjob to run the script with `deno run -A main.ts`. + +The following environment variables are configurable: + +- **`OCTOPUS_API_KEY`** - your Octopus Energy API key, [available here](https://octopus.energy/dashboard/new/accounts/personal-details/api-access) +- **`OCTOPUS_ACCOUNT_NUMBER`** - your Octopus Energy account number (like `A-XXXXXXXX`) +- **`WEBHOOK_URL`** - a webhook to your messaging service of choice (e.g. Discord, Slack, etc...) +- _`STATE_FILENAME` - this sets the location of the script's state. By default it'll be `state.json` in the current working directory._