{"id":18116409,"url":"https://github.com/glzr-io/zebar","last_synced_at":"2026-03-15T23:21:30.269Z","repository":{"id":204205978,"uuid":"660603097","full_name":"glzr-io/zebar","owner":"glzr-io","description":"Zebar is a tool for creating customizable and cross-platform taskbars, desktop widgets, and popups.","archived":false,"fork":false,"pushed_at":"2026-03-14T13:52:37.000Z","size":3936,"stargazers_count":2741,"open_issues_count":61,"forks_count":110,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-03-15T00:39:18.192Z","etag":null,"topics":["bar","desktop","dock","linux","macos","ricing","statusbar","taskbar","unixporn","widget","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glzr-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-30T11:37:12.000Z","updated_at":"2026-03-14T13:52:41.000Z","dependencies_parsed_at":"2023-12-19T15:08:28.245Z","dependency_job_id":"cc4fe8fa-ee31-4f69-baef-8c7eb0ef458d","html_url":"https://github.com/glzr-io/zebar","commit_stats":null,"previous_names":["glazerdesktop/zebar","glzr-io/zebar"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/glzr-io/zebar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glzr-io%2Fzebar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glzr-io%2Fzebar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glzr-io%2Fzebar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glzr-io%2Fzebar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glzr-io","download_url":"https://codeload.github.com/glzr-io/zebar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glzr-io%2Fzebar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30550789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-15T15:03:43.933Z","status":"ssl_error","status_checked_at":"2026-03-15T15:03:37.630Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bar","desktop","dock","linux","macos","ricing","statusbar","taskbar","unixporn","widget","windows"],"created_at":"2024-11-01T04:01:31.608Z","updated_at":"2026-03-15T23:21:30.256Z","avatar_url":"https://github.com/glzr-io.png","language":"Rust","funding_links":[],"categories":["Rust","Windows","Status Bars"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003cbr\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/d1e10485-2cbb-4434-9d98-5c74702eebcc\" width=\"350\" alt=\"Zebar logo\" /\u003e\n  \u003cbr\u003e\n\n# Zebar 🦓\n\n**Zebar lets you create customizable and cross-platform desktop widgets.**\n\n[![Discord invite][discord-badge]][discord-link]\n[![Good first issues][issues-badge]][issues-link]\n\n[Installation](#%EF%B8%8F-installation) •\n[Intro](#-intro-to-zebar) •\n[FAQ](#-faq) •\n[Contributing ↗](https://github.com/glzr-io/zebar/blob/main/CONTRIBUTING.md)\n\n![zebar-demo](https://github.com/user-attachments/assets/7a3aa5d2-2c7a-4171-9ede-d88839b91666)\n\n\u003c/div\u003e\n\n## ⚙️ Installation\n\n**Downloads for Windows, MacOS, and Linux are available in the [latest release](https://github.com/glzr-io/zebar/releases)**.\n\nFor building locally, follow the instructions [here](https://github.com/glzr-io/zebar/blob/main/CONTRIBUTING.md).\n\n## 🚀 Quick start\n\n### Accessing Zebar GUI\n\nClick the Zebar icon in your system tray to open the GUI interface.\n\n### Installing widgets\n\nNavigate to the marketplace within the GUI to browse and install widget packs.\n\n### Auto-starting widgets\n\nWidgets can be set to run on startup by right clicking the Zebar tray icon then going to `Widget packs` -\u003e `\u003cpack name\u003e` -\u003e `\u003cwidget name\u003e` -\u003e `Run on startup` and clicking the widget name to check it.\n\n## 🌟 Intro to Zebar\n\nWidgets are powered by native webviews (_similar_ to Electron, but more lightweight).\n\n## Creating your own widgets\n\nZebar looks within the `~/.glzr/zebar` directory for directories containing a `zpack.json` file. Each `zpack.json` file defines a widget pack. Each widget pack can contain multiple widgets, each defined  individually within the `zpack.json` file.\n\nFor example, a widget pack config could be located at `~/.glzr/zebar/example-widget/zpack.json`, which would create a widget pack with an id of `example-widget`.\nZebar only looks for `zpack.json` files one level deep within the `~/.glzr/zebar` directory, so `~/glzr/zebar/example-widget/widget-1/zpack.json` is invalid.\n\nIn the `My widgets` tab of the Zebar GUI, you can click `Create new pack` to generate a widget pack scaffold with the given name and description.\n\nWithin each widget pack, in the `Widgets` section you can click `Add widget` to create a new widget within that pack. When creating a new widget you can pick between some templates to get you started.\n\n\u003e Apart from the React buildless template, other available templates require you to have Node.js and a package manager (npm/pnpm) installed. For these templates, run the build command (e.g. pnpm build) from the widget directory after any source code changes.\n\n### Modifying marketplace widgets\n\nTo edit a marketplace widget without fear of your changes being overridden, you should copy the folder from the marketplace directory (located at `%AppData%/zebar/downloads/`) to your own Zebar directory (located at `~/.glzr/zebar/`).\n\n\u003e **DO NOT** re-publish other peoples widgets without permission.\n\n### Advanced Customization\n\n#### What is the zpack.json file?\n\nWidgets are stored in packs, with each pack being defined by a `zpack.json` file. Each pack can contain multiple widgets, each individually defined within `zpack.json`.\n\nWidgets consist of an HTML file, and any surrounding assets (e.g. CSS, JS, images, etc.).\n\nThe schema for `zpack.json` can be found [here](https://github.com/glzr-io/zebar/blob/main/resources/zpack-schema.json) although all options can also be configured via the GUI.\n\n#### Querying system information\n\nZebar exposes various system information (referred to as \"providers\") which can be used and displayed by your frontend. This includes stats like CPU usage, battery info, various window manager integrations, and lots more. See [Providers](#-providers) for a list of available providers.\n\n## ❓ FAQ\n\n**Q: Help! On Windows, Zebar is failing to start?**\n\nIn some cases, updating to the latest Microsoft Webview2 version is needed ([standalone download](https://developer.microsoft.com/en-us/microsoft-edge/webview2/?form=MA13LH#download)). Run the \"Evergreen Standalone Installer\" as administrator.\n\n## 🧩 Providers\n\nThrough the `zebar` NPM package, Zebar exposes various system information via reactive \"providers\". Providers are a collection of functions and variables that can change over time.\n\n- [audio](#audio)\n- [battery](#battery)\n- [cpu](#cpu)\n- [date](#date)\n- [disk](#disk)\n- [glazewm](#glazewm)\n- [host](#host)\n- [ip](#ip)\n- [keyboard](#keyboard)\n- [komorebi](#komorebi)\n- [media](#media)\n- [memory](#memory)\n- [network](#network)\n- [systray](#systray)\n- [weather](#weather)\n\n### Audio\n\n#### Config\n\nNo config options.\n\n#### Outputs\n\n| Variable            | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `defaultPlaybackDevice`         | Default audio playback device.        | `AudioDevice \\| null`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `defaultRecordingDevice`         | Default audio recording device.        | `AudioDevice \\| null`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `playbackDevices`         | All audio playback devices.        | `AudioDevice[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `recordingDevices`         | All audio recording devices.        | `AudioDevice[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allDevices`         | All audio devices (both playback and recording).        | `AudioDevice[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n| Function   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `setVolume` | Sets the volume of an audio device. Changes the volume of the default playback device, unless `SetVolumeOptions.deviceId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e - `volume`: _`number`_ Volume as a % of maximum volume. Returned value is between `0` and `100`. \u003cbr\u003e - `options`: _`SetVolumeOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n#### Related types\n\n#### `AudioDevice`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `deviceId`         | Device ID. | `string` |\n| `name`      | Friendly display name of device. | `string` |\n| `volume`    | Volume as a % of maximum volume. Returned value is between `0` and `100`. | `number` |\n| `type` | Type of the device. | `'playback' \\| 'recording'` |\n| `isDefaultPlayback` | `true` if the device is selected as the default playback device.| `boolean` |\n| `isDefaultRecording` | `true` if the device is selected as the default recording device.| `boolean` |\n\n#### `SetVolumeOptions`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `deviceId`         | Device ID to set the volume of. | `string \\| undefined` |\n\n### Battery\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `5000`        |\n\n#### Outputs\n\n| Variable           | Description                                                                                                          | Return type                                                        | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `chargePercent`    | Battery charge as a percentage of maximum capacity (aka. 'state of charge'). Returned value is between `0` to `100`. | `number`                                                           | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `healthPercent`    | Condition of the battery as a percentage of perfect health. Returned value is between `0` to `100`.                  | `number`                                                           | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `cycleCount`       | Number of charge/discharge cycles.                                                                                   | `number`                                                           | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `state`            | State of the battery.                                                                                                | `'discharging' \\| 'charging'   \\| 'full'  \\| 'empty' \\| 'unknown'` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `isCharging`       | Whether the battery is in a `charging` state.                                                                        | `boolean`                                                          | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `timeTillEmpty`    | Approximate time in milliseconds till battery is empty.                                                              | `number \\| null`                                                   | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `timeTillFull`     | Approximate time in milliseconds till battery is fully charged.                                                      | `number \\| null`                                                   | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `powerConsumption` | Battery power consumption in watts.                                                                                  | `number`                                                           | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `voltage`          | Battery voltage.                                                                                                     | `number \\| null`                                                   | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n### CPU\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `5000`        |\n\n#### Outputs\n\n| Variable            | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `frequency`         | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `usage`             | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `logicalCoreCount`  | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `physicalCoreCount` | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `vendor`            | TODO        | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n## Date\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `formatting`         | Formatting of the current date into a custom string format. Affects the output of [`formatted`](#outputs-2). \u003cbr\u003e\u003cbr\u003eRefer to [table of tokens](https://moment.github.io/luxon/#/formatting?id=table-of-tokens) for available date/time tokens. \u003cbr\u003e\u003cbr\u003e **Examples:**\u003cbr\u003e - `'yyyy LLL dd'` -\u003e `2023 Feb 13`\u003cbr\u003e - `\"HH 'hours and' mm 'minutes'\"` -\u003e `20 hours and 55 minutes` | `string`    | `EEE d MMM t`       |\n| `timezone`         | Either a UTC offset (eg. `UTC+8`) or an IANA timezone (eg. `America/New_York`). Affects the output of [`formatted`](#outputs-2).\u003cbr\u003e\u003cbr\u003e A full list of available IANA timezones can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).| `string`    | `local`       |\n| `locale`           | An ISO-639-1 locale, which is either a 2-letter language code (eg. `en`) or a 4-letter language + country code (eg. `en-gb`). Affects the output of [`formatted`](#outputs-2).\u003cbr\u003e\u003cbr\u003e A full list of ISO-639-1 locales can be found [here](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes#Table).  | `string`    |       |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `1000`        |\n\n#### Outputs\n\n| Variable | Description                                                                                                              | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| -------- | ------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `formatted` | Current date/time as a formatted string. | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `new`    | Current date/time as a JavaScript `Date` object. Uses `new Date()` under the hood.                                       | `Date`      | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `now`    | Current date/time as milliseconds since epoch. Uses `Date.now()` under the hood.                                         | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `iso`    | Current date/time as an ISO-8601 string (eg. `2017-04-22T20:47:05.335-04:00`). Uses `date.toISOString()` under the hood. | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n### Disk\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `60000`        |\n\n#### Outputs\n\n| Variable            | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `disks`         | Available disks on the system.        | `Disk[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n#### Related types\n\n#### `Disk`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `name`         | Disk name.    | `string \\| null` |\n| `fileSystem`      | File system used on the disk (e.g. `EXT4`, `NTFS`). | `string` |\n| `mountPoint`    | Mount point of the disk (e.g. `/`, `C:\\\\`).         | `string` |\n| `totalSpace` | Total disk size.      | `DataSizeMeasure` |\n| `availableSpace` | Available disk size.      | `DataSizeMeasure` |\n| `isRemovable` | Whether the disk is removable.      | `boolean` |\n| `driveType` | Type of disk (e.g. `HDD`, `SSD`).      | `string` |\n\n#### `DataSizeMeasure`\n\n| Variable   | Description                                                                 | Return type |\n| ---------- | --------------------------------------------------------------------------- | ----------- |\n| `bytes`    | Raw byte value.                                                             | `number`    |\n| `siValue`  | Bytes converted in according to the SI standard. 1000 bytes in a kilobyte.  | `number`    |\n| `siUnit`   | Unit of the converted bytes in according to the SI standard. KB, MB, ...    | `string`    |\n| `iecValue` | Bytes converted in according to the IEC standard. 1024 bytes in a kibibyte. | `number`    |\n| `iecUnit`  | Unit of the converted bytes in according to the IEC standard. KiB, MiB, ... | `string`    |\n\n### GlazeWM\n\n#### Config\n\nNo config options.\n\n#### Outputs\n\n| Variable              | Description | Return type   | Supported OS                                                                                                                      |\n| --------------------- | ----------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------- |\n| `displayedWorkspace` | Workspace displayed on the current monitor.        | `Workspace` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `focusedWorkspace` | Workspace that currently has focus (on any monitor).        | `Workspace` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `currentWorkspaces` | Workspaces on the current monitor.        | `Workspace[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allWorkspaces` | Workspaces across all monitors.        | `Workspace[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allMonitors` | All monitors.        | `Monitor[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allWindows` | All windows.        | `Window[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `focusedMonitor` | Monitor that currently has focus.        | `Monitor` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `currentMonitor` | Monitor that is nearest to this Zebar widget.        | `Monitor` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `focusedContainer` | Container that currently has focus (on any monitor).        | `Container` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `tilingDirection` | Tiling direction of the focused container.        | `TilingDirection` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `bindingModes` | Active binding modes.        | `BindingModeConfig[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `isPaused` | Whether the WM is paused. | `boolean` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n| Function   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `runCommand` | Invokes a WM command. \u003cbr\u003e\u003cbr\u003e **Examples:**\u003cbr\u003e - `runCommand(\"focus --workspace 1\")`\u003cbr\u003e - `runCommand(\"set-floating\", containerId)`\u003cbr\u003e \u003cbr\u003e **Parameters:**\u003cbr\u003e - `command`: _`string`_ WM command to run (e.g. `\"focus --workspace 1\"`).\u003cbr\u003e - `subjectContainerId`: _`string \\| undefined`_ (Optional) ID of container to use as subject. If not provided, this defaults to the currently focused container. | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n## Host\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `60000`       |\n\n#### Outputs\n\n| Variable            | Description                                                                                                                                                                                                                                                  | Return type      | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `hostname`          | Name used to identify the device in various network-related activities.                                                                                                                                                                                      | `string \\| null` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `osName`            | Name of the operating system. This is `Darwin` on MacOS, `Windows` on Windows, or the Linux distro name retrieved from either `/etc/os-release` or `/etc/lsb-release` (eg. `Debian GNU/Linux` on Debian).                                                    | `string \\| null` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `osVersion`         | Operating system version. This is the version number on MacOS (eg. `13.2.1`), the major version + build number on Windows (eg. `11 22000`), or the Linux distro version retrieved from either `/etc/os-release` or `/etc/lsb-release` (eg. `9` on Debian 9). | `string \\| null` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `friendlyOsVersion` | Friendly name of operating system version (eg. `MacOS 13.2.1`, `Windows 10 Pro`, `Linux Debian GNU/Linux 9`).                                                                                                                                                | `string \\| null` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `bootTime`          | Time when the system booted since UNIX epoch in milliseconds (eg. `1699452379304`).                                                                                                                                                                          | `string`         | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `uptime`            | Time in milliseconds since boot.                                                                                                                                                                                                                             | `string`         | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n### IP\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `3600000`     |\n\n#### Outputs\n\n| Variable          | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ----------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `address`         | TODO        | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `approxCity`      | TODO        | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `approxCountry`   | TODO        | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `approxLatitude`  | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `approxLongitude` | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n### Keyboard\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `5000`        |\n\n#### Outputs\n\n| Variable      | Description                           | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------- | ------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `layout`    | Current keyboard layout, for example 'en-US'. | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\n\n### Komorebi\n\n#### Config\n\nNo config options.\n\n#### Outputs\n\n| Variable              | Description | Return type   | Supported OS                                                                                                                      |\n| --------------------- | ----------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------- |\n| `displayedWorkspace` | Workspace displayed on the current monitor.        | `KomorebiWorkspace` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `focusedWorkspace` | Workspace that currently has focus (on any monitor).        | `KomorebiWorkspace` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `currentWorkspaces` | Workspaces on the current monitor.        | `KomorebiWorkspace[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allWorkspaces` | Workspaces across all monitors.        | `KomorebiWorkspace[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allMonitors` | All monitors.        | `KomorebiMonitor[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `focusedMonitor` | Monitor that currently has focus.        | `KomorebiMonitor` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `currentMonitor` | Monitor that is nearest to this Zebar widget.        | `KomorebiMonitor` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n### Media\n\n#### Config\n\nNo config options.\n\n#### Outputs\n\n| Variable            | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `currentSession`         | Currently playing media session.        | `MediaSession \\| null`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `allSessions`         | All active media sessions.        | `MediaSession[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n| Function   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `play` | Plays the media session. Affects the current media session, unless `MediaControlOptions.sessionId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e`options`: _`MediaControlOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `pause` | Pauses the media session. Affects the current media session, unless `MediaControlOptions.sessionId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e`options`: _`MediaControlOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `togglePlayPause` | Toggles between playing/pausing the media session. Affects the current media session, unless `MediaControlOptions.sessionId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e`options`: _`MediaControlOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `next` | Skips to the next track. Affects the current media session, unless `MediaControlOptions.sessionId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e`options`: _`MediaControlOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n| `previous` | Skips to the previous track. Affects the current media session, unless `MediaControlOptions.sessionId` is specified. \u003cbr\u003e\u003cbr\u003e **Parameters:**\u003cbr\u003e`options`: _`MediaControlOptions \\| undefined`_ Additional options.\u003cbr\u003e  | `Promise\u003cvoid\u003e`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n#### Related types\n\n#### `MediaSession`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `sessionId`         | Unique identifier for the media session.    | `string` |\n| `title`         | Title of the media session.    | `string` |\n| `artist`      | Artist of the media session. | `string \\| null` |\n| `albumTitle`    | Album title of the media session.         | `string \\| null` |\n| `albumArtist` | Artist of the album (may differ from track artist). | `string \\| null` |\n| `trackNumber` | Position of the track within its album.      | `number` |\n| `startTime` | Timestamp (in seconds) where playback begins.      | `number` |\n| `endTime` | Timestamp (in seconds) where playback ends.      | `number` |\n| `position` | Timestamp (in seconds) of current playback position.      | `number` |\n| `isPlaying` | Whether the media session is currently playing.      | `boolean` |\n| `isCurrentSession` | Whether this is the currently active session (i.e. `currentSession`).      | `boolean` |\n\n#### `MediaControlOptions`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `sessionId`         | ID of the session to control. If `undefined`, the current session is used. | `string \\| undefined` |\n\n### Memory\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `5000`        |\n\n#### Outputs\n\n| Variable      | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `usage`       | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `freeMemory`  | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `usedMemory`  | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `totalMemory` | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `freeSwap`    | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `usedSwap`    | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `totalSwap`   | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n### Network\n\n#### Config\n\n| Option             | Description                                        | Option type | Default value |\n| ------------------ | -------------------------------------------------- | ----------- | ------------- |\n| `refreshInterval` | How often this provider refreshes in milliseconds. | `number`    | `5000`        |\n\n#### Outputs\n\n| Variable           | Description                            | Return type          | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ------------------ | -------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `defaultInterface` | TODO                                   | `NetworkInterface`   | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `defaultGateway`   | TODO                                   | `Gateway`            | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `interfaces`       | TODO                                   | `NetworkInterface[]` | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `traffic`          | Returns the network traffic per second. | `NetworkTraffic`     | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n#### Related types\n\n#### `NetworkTraffic`\n\n| Variable           | Description                   | Return type             |\n| ------------------ | ----------------------------- | ----------------------- |\n| `received`         | Received bytes per second.    | `DataSizeMeasure` |\n| `transmitted`      | Transmitted bytes per second. | `DataSizeMeasure` |\n| `totalReceived`    | Total received bytes.         | `DataSizeMeasure` |\n| `totalTransmitted` | Total transmitted bytes.      | `DataSizeMeasure` |\n\n#### `DataSizeMeasure`\n\n| Variable   | Description                                                                 | Return type |\n| ---------- | --------------------------------------------------------------------------- | ----------- |\n| `bytes`    | Raw byte value.                                                             | `number`    |\n| `siValue`  | Bytes converted in according to the SI standard. 1000 bytes in a kilobyte.  | `number`    |\n| `siUnit`   | Unit of the converted bytes in according to the SI standard. KB, MB, ...    | `string`    |\n| `iecValue` | Bytes converted in according to the IEC standard. 1024 bytes in a kibibyte. | `number`    |\n| `iecUnit`  | Unit of the converted bytes in according to the IEC standard. KiB, MiB, ... | `string`    |\n\n### Systray\n\n#### Config\n\nNo config options.\n\n#### Outputs\n\n| Variable          | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ----------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `icons`         | All Windows taskbar system tray icons.  | `SystrayIcon[]`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e |\n\n#### Related Types\n\n#### SystrayIcon\n\n| Variable          | Description | Return type |\n| ----------------- | ----------- | ----------- |\n| `id`         | ID of the icon. |  `string`    |\n| `iconBytes`         | Icon image as a PNG byte array. |  `number[]`    |\n| `iconBlob`         | Icon image as a PNG blob. |  `Blob`    |\n| `iconHash`         | Hash of the icon image. Used to determine if the icon image has changed.  |  `string`    |\n| `iconUrl`         | Icon image URL ready to be be referenced in `\u003cimg\u003e` elements.  |  `string`    |\n| `tooltip`         | Tooltip text when hovering over the icon.  |  `string`    |\n\n### Weather\n\n#### Config\n\n| Option             | Description                                                                                            | Option type           | Default value |\n| ------------------ | ------------------------------------------------------------------------------------------------------ | --------------------- | ------------- |\n| `latitude`         | Latitude to retrieve weather for. If not provided, latitude is instead estimated based on public IP.   | `number \\| undefined` | `undefined`   |\n| `longitude`        | Longitude to retrieve weather for. If not provided, longitude is instead estimated based on public IP. | `number \\| undefined` | `undefined`   |\n| `refreshInterval` | How often this provider refreshes in milliseconds.                                                     | `number`              | `3600000`     |\n\n#### Outputs\n\n| Variable          | Description | Return type | Supported OS                                                                                                                                                                                                                                                                                                                                                                                |\n| ----------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `isDaytime`         | TODO        | `string`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `status`      | TODO        | `WeatherStatus`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `celsiusTemp`   | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `fahrenheitTemp`  | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n| `windSpeed` | TODO        | `number`    | \u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/568e90c8-cd32-49a5-a17f-ab233d41f1aa\" alt=\"microsoft icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/005a0760-da9d-460e-b533-9b2aba7f5c03\" alt=\"apple icon\" width=\"24\"\u003e\u003cimg src=\"https://github.com/glzr-io/zebar/assets/34844898/1c5d91b1-879f-42a6-945e-912a11daebb4\" alt=\"linux icon\" width=\"24\"\u003e |\n\n[discord-badge]: https://img.shields.io/discord/1041662798196908052.svg?logo=discord\u0026colorB=7289DA\n[discord-link]: https://discord.gg/ud6z3qjRvM\n[issues-badge]: https://img.shields.io/badge/good_first_issues-7057ff\n[issues-link]: https://github.com/glzr-io/zebar/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglzr-io%2Fzebar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglzr-io%2Fzebar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglzr-io%2Fzebar/lists"}