mirror of
https://github.com/JanDeDobbeleer/oh-my-posh.git
synced 2024-12-28 04:19:41 -08:00
86 lines
3.8 KiB
Plaintext
86 lines
3.8 KiB
Plaintext
---
|
|
id: carbonintensity
|
|
title: Carbon Intensity
|
|
sidebar_label: Carbon Intensity
|
|
---
|
|
|
|
## What
|
|
|
|
Shows the actual and forecast carbon intensity in gCO2/kWh using data from the [Carbon Intensity API][carbonintensity-api].
|
|
|
|
:::note
|
|
Note that this segment only provides data for Great Britain at the moment. Support for other countries may become available in the future.
|
|
:::
|
|
|
|
## Sample Configuration
|
|
|
|
:::caution
|
|
The API can be slow. It's recommended to set the `http_timeout` property to a large value (e.g. `5000`).
|
|
:::
|
|
|
|
import Config from "@site/src/components/Config.js";
|
|
|
|
<Config
|
|
data={{
|
|
type: "carbonintensity",
|
|
style: "powerline",
|
|
powerline_symbol: "\uE0B0",
|
|
foreground: "#000000",
|
|
background: "#ffffff",
|
|
background_templates: [
|
|
'{{if eq "very low" .Index}}#a3e635{{end}}',
|
|
'{{if eq "low" .Index}}#bef264{{end}}',
|
|
'{{if eq "moderate" .Index}}#fbbf24{{end}}',
|
|
'{{if eq "high" .Index}}#ef4444{{end}}',
|
|
'{{if eq "very high" .Index}}#dc2626{{end}}',
|
|
],
|
|
template:
|
|
" CO₂ {{ .Index.Icon }}{{ .Actual.String }} {{ .TrendIcon }} {{ .Forecast.String }} ",
|
|
properties: {
|
|
http_timeout: 5000,
|
|
cache_timeout: 10,
|
|
},
|
|
}}
|
|
/>
|
|
|
|
## Properties
|
|
|
|
| Name | Type | Default | Description |
|
|
| --------------- | :---: | :-----: | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| `http_timeout` | `int` | `20` | Timeout (in milliseconds) for HTTP requests. The default is 20ms, but you may need to set this to as high as 5000ms to handle slow API requests. |
|
|
| `cache_timeout` | `int` | `10` | Timeout (in minutes) for the response cache. The default is 10m. A value of 0 disables the cache. |
|
|
|
|
## Template ([info][templates])
|
|
|
|
:::note default template
|
|
|
|
```template
|
|
CO₂ {{ .Index.Icon }}{{ .Actual.String }} {{ .TrendIcon }} {{ .Forecast.String }}
|
|
```
|
|
|
|
:::
|
|
|
|
### Properties
|
|
|
|
| Name | Type | Description |
|
|
| ------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `.Forecast` | `Number` | The forecast carbon intensity in gCO2/kWh. Equal to `0` if no data is available. |
|
|
| `.Actual` | `Number` | The actual carbon intensity in gCO2/kWh. Equal to `0` if no data is available. |
|
|
| `.Index` | `Index` | A rating of the current carbon intensity. Possible values are `"very low"`, `"low"`, `"moderate"`, `"high"`, or `"very high"`. Equal to `"??"` if no data is available. |
|
|
| `.TrendIcon` | `string` | An icon representation of the predicted trend in carbon intensity based on the Actual and Forecast values. Possible values are `"↗"`, `"↘"`, or `"→"`. |
|
|
|
|
#### Number
|
|
|
|
| Name | Type | Description |
|
|
| --------- | -------- | ---------------------------------- |
|
|
| `.String` | `string` | string representation of the value |
|
|
|
|
#### Index
|
|
|
|
| Name | Type | Description |
|
|
| ------- | -------- | -------------------------------- |
|
|
| `.Icon` | `string` | icon representation of the value |
|
|
|
|
[templates]: /docs/configuration/templates
|
|
[carbonintensity-api]: https://carbon-intensity.github.io/api-definitions
|