From 52bdcec3e8b6b1eeba68e5704a222fe2e4fb0352 Mon Sep 17 00:00:00 2001 From: gi8 Date: Thu, 13 Aug 2026 10:26:29 +0200 Subject: [PATCH] docs: restore product screenshots --- content/lua/guides/context-menus.md | 2 ++ .../easybar/configuration/builtins.md | 4 +++ .../configuration/builtins/calendar.md | 14 ++++++++++ .../easybar/configuration/builtins/inbox.md | 2 ++ .../easybar/configuration/builtins/spaces.md | 14 ++++++++++ .../easybar/configuration/builtins/wifi.md | 2 ++ content/products/easybar/index.md | 26 +++++++++++++++++++ content/products/easybar/runtime/control.md | 2 ++ 8 files changed, 66 insertions(+) diff --git a/content/lua/guides/context-menus.md b/content/lua/guides/context-menus.md index a8aad7f..ce6664c 100644 --- a/content/lua/guides/context-menus.md +++ b/content/lua/guides/context-menus.md @@ -30,6 +30,8 @@ github:subscribe(easybar.events.context_menu.clicked, function(event) end) ``` +[![Lua widget with a native nested context menu](../../assets/custom_context.png){ .screenshot-compact .screenshot-context }](../../assets/custom_context.png) + Selectable entries require a non-empty `id` and `title`. `enabled` defaults to `true`; disabled entries remain visible but cannot emit an action. `checked` defaults to `false` and controls the native checkmark. A separator uses `{ separator = true }`. A submenu heading requires a `title` diff --git a/content/products/easybar/configuration/builtins.md b/content/products/easybar/configuration/builtins.md index 1efbee3..2aff571 100644 --- a/content/products/easybar/configuration/builtins.md +++ b/content/products/easybar/configuration/builtins.md @@ -101,6 +101,8 @@ The generated [Configuration Reference](reference.md) lists every key and defaul Interactive built-ins expose their common settings and native actions directly from the bar: +[![CPU widget with history graph](../../../assets/cpu.png){ .screenshot-compact .screenshot-cpu }](../../../assets/cpu.png) + | Built-in | Context-menu controls | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Battery | Display mode, color mode, and refresh. | @@ -123,6 +125,8 @@ enable or disable any top-level built-in widget. Checked items are enabled. Each immediately updates the corresponding `builtins..enabled` value in `config.toml` and reloads the bar, while preserving comments, whitespace, and unrelated settings. +[![Native Widgets menu with enabled built-ins](../../../assets/native_widgets.png){ .screenshot-compact .screenshot-native-widgets }](../../../assets/native_widgets.png) + Every visible native widget also has a right-click context menu with **Reload Widget** and **Disable Widget**. Disabling is written to the active config file immediately; use **Native Widgets** from the bar or controller menu to enable it again. Widgets with interactive settings add diff --git a/content/products/easybar/configuration/builtins/calendar.md b/content/products/easybar/configuration/builtins/calendar.md index 51cc614..72a52e7 100644 --- a/content/products/easybar/configuration/builtins/calendar.md +++ b/content/products/easybar/configuration/builtins/calendar.md @@ -2,6 +2,20 @@ The calendar built-in combines a configurable time/date anchor with month, upcoming-event, appointment, and composer popups. Calendar data and permission handling belong to the separately installed calendar agent. +
+ +
+[![Calendar month popup](../../../../assets/month.png){ .screenshot-compact .screenshot-month }](../../../../assets/month.png) +
Month view with event indicators and the day's appointments
+
+ +
+[![Upcoming calendar events](../../../../assets/upcoming.png){ .screenshot-compact .screenshot-upcoming }](../../../../assets/upcoming.png) +
Upcoming events grouped into a compact agenda
+
+ +
+ ## Anchor The anchor uses an ordered list of `time` and `date` fields. A row places them beside each other, a column stacks them, and a one-element list creates a single-field anchor. diff --git a/content/products/easybar/configuration/builtins/inbox.md b/content/products/easybar/configuration/builtins/inbox.md index 9d893c2..b33c594 100644 --- a/content/products/easybar/configuration/builtins/inbox.md +++ b/content/products/easybar/configuration/builtins/inbox.md @@ -4,6 +4,8 @@ The native inbox collects structured messages published by Lua widgets or the `e into one bar item. It displays the total unread count and can group messages by source, date, category, severity, or not at all. +[![EasyBar native inbox with grouped notifications](../../../../assets/inbox.png){ .screenshot-compact .screenshot-inbox }](../../../../assets/inbox.png) + ```toml [builtins.inbox] enabled = true diff --git a/content/products/easybar/configuration/builtins/spaces.md b/content/products/easybar/configuration/builtins/spaces.md index bffaf0d..0aff0bb 100644 --- a/content/products/easybar/configuration/builtins/spaces.md +++ b/content/products/easybar/configuration/builtins/spaces.md @@ -7,6 +7,20 @@ The native spaces widget renders AeroSpace workspaces and their visible applicat - `[builtins.spaces.text]` controls labels. - `[builtins.spaces.icons]` controls application icons. +
+ +
+[![EasyBar Spaces widget with workspace labels](../../../../assets/spaces.png){ .screenshot-compact .screenshot-spaces }](../../../../assets/spaces.png) +
Workspace labels with the focused space highlighted
+
+ +
+[![EasyBar Spaces widget with front-app icons](../../../../assets/spaces_front_app.png){ .screenshot-compact .screenshot-spaces-front-app }](../../../../assets/spaces_front_app.png) +
Workspace labels combined with visible application icons
+
+ +
+ ## Collapsed inactive spaces The content settings interact as follows: diff --git a/content/products/easybar/configuration/builtins/wifi.md b/content/products/easybar/configuration/builtins/wifi.md index 3a52473..c7f49de 100644 --- a/content/products/easybar/configuration/builtins/wifi.md +++ b/content/products/easybar/configuration/builtins/wifi.md @@ -2,6 +2,8 @@ The native Wi-Fi widget always renders signal bars as its anchor. Its content mode controls whether additional network values appear inline or in a popup. +[![EasyBar Wi-Fi details popup](../../../../assets/wifi.png){ .screenshot-compact .screenshot-wifi }](../../../../assets/wifi.png) + ```toml [builtins.wifi] enabled = true diff --git a/content/products/easybar/index.md b/content/products/easybar/index.md index 91f9016..90f0f3a 100644 --- a/content/products/easybar/index.md +++ b/content/products/easybar/index.md @@ -12,6 +12,32 @@ Use EasyBar when you want: - the Calendar and Network helper agents for permission-sensitive data; - Lua widgets and Widget Store packages beside the native built-ins. +## See EasyBar in action + +
+ +
+[![Calendar month popup](../../assets/month.png){ .screenshot-compact .screenshot-month }](../../assets/month.png) +
Calendar month view with event indicators
+
+ +
+[![Upcoming calendar events](../../assets/upcoming.png){ .screenshot-compact .screenshot-upcoming }](../../assets/upcoming.png) +
A compact agenda for upcoming events
+
+ +
+[![EasyBar native inbox](../../assets/inbox.png){ .screenshot-compact .screenshot-inbox }](../../assets/inbox.png) +
One actionable inbox for multiple sources
+
+ +
+[![EasyBar Wi-Fi details](../../assets/wifi.png){ .screenshot-compact .screenshot-wifi }](../../assets/wifi.png) +
Native network details at a glance
+
+ +
+ ## Default paths ```text diff --git a/content/products/easybar/runtime/control.md b/content/products/easybar/runtime/control.md index d91b723..3c9eeac 100644 --- a/content/products/easybar/runtime/control.md +++ b/content/products/easybar/runtime/control.md @@ -8,6 +8,8 @@ EasyBar shows a persistent controller icon in the macOS menu bar by default. It The controller and an empty-area right-click on the bar share the common runtime, native-widget, theme, and file actions. The controller additionally owns application lifecycle, helper-agent, and quit actions. +[![EasyBar menu-bar controller](../../../assets/topbar_app.png){ .screenshot-compact .screenshot-topbar }](../../../assets/topbar_app.png) + Disable the controller icon with: ```toml