amnweb/yasb
Yasb
YASB is a customizable status bar framework and desktop shell component for Windows. It provides a toolkit for building personalized information bars using a modular class-based widget architecture and CSS-based styling.
The framework distinguishes itself through deep integration with Windows tiling window managers, allowing users to display active workspaces, tiling layouts, and window focus states. It also features automated visual consistency by generating system color schemes based on the current desktop wallpaper.
The project covers a wide range of capabilities, including real-time system hardware monitoring for CPU, GPU, and memory, as well as productivity tools such as clipboard history, Pomodoro timers, and task lists. It further integrates external data through API dashboards for weather, cryptocurrency, and GitHub notifications, while providing developer utilities for unit conversion and encoding.
Configuration is managed via YAML files with schema-based validation to ensure correctness before runtime.
Features
- Status Bars - Provides a comprehensive framework for building personalized, CSS-stylable status bars with modular widgets on Windows.
- Status Bar Customizers - Offers a comprehensive framework for building personalized status bars using custom widgets and CSS styling.
- Desktop Productivity Utilities - Provides quick access to notes, task lists, Pomodoro timers, and developer utilities through a centralized interface.
- Tiling Window Managers - Integrates with tiling window managers to manage their lifecycle, including starting, stopping, and reloading services.
- Tiling Window Manager Panels - Integrates with Windows tiling window managers to display active workspaces and tiling layouts.
- Workspace Status Indicators - Displays active window manager workspaces with labels and icons to indicate current focus and populate status.
- Desktop Shells - Functions as a desktop shell component that manages system metrics and application launching for the Windows environment.
- Window Manager Integrations - Displays active workspaces and populated areas for deep integration with Windows tiling window managers.
- YAML Configuration Files - Uses YAML files to define the placement, dimensions, and behavioral settings of status bar elements.
- Hardware Monitoring Utilities - Tracks real-time CPU, GPU, memory, and battery usage alongside network traffic and hardware sensor data.
- Real-Time Monitoring Dashboards - Implements a real-time dashboard of widgets to track system hardware performance and network health.
- System Metrics - Exposes real-time hardware performance data including CPU usage, GPU temperature, memory, and disk space.
- System Performance Monitors - Provides real-time monitoring of hardware metrics including CPU, GPU, and memory usage.
- Configuration-Driven Layouts - Allows defining the placement and behavior of status bar widgets using external YAML configuration files.
- CSS Styling - Provides comprehensive visual theme and layout management using CSS stylesheets to decouple styling from logic.
- Custom Widget Implementation - Provides a class-based architecture for implementing personalized status bar elements with custom layout and rendering logic.
- Interface Appearance Customizations - Enables deep visual customization of the bar and its widgets using a CSS-based styling format.
- Interface Layout Configurations - Provides comprehensive controls for defining the dimensions, screen placement, and alignment of the status bar interface.
- Window Manager Interaction Modes - Displays the active input or binding mode of integrated window managers using customizable icons and labels.
- Visual Themes - Supports the application of custom CSS to define the overall visual identity and aesthetic of the interface.
- Window Managers - Integrates with window managers to execute lifecycle commands like start, stop, and reload.
- Component-Based Architectures - Implements a modular UI architecture where individual widgets manage their own state and event callbacks.
- Automation And Scripting - Manages power plans, system volume, and application shortcuts using custom hotkeys and interactive buttons.
- Virtual Desktop Organizers - Provides interactive controls to switch, create, rename, and delete virtual desktop workspaces.
- Note Management - Provides a lightweight system for storing and editing simple text-based quick notes via a popup menu.
- Personal Productivity Tools - Provides integrated tools for tracking tasks via to-do lists and maintaining simple notes.
- Productivity Widgets - Ships an integrated set of interactive widgets for managing tasks, Pomodoro timers, clipboard history, and quick notes.
- Task Management Widgets - Implements interactive components for tracking, adding, and deleting personal tasks and to-do lists.
- Browser Bookmark Managers - Indexes and allows searching for bookmarks across multiple installed browsers including Chrome, Firefox, and Edge.
- Clipboard Managers - Provides a searchable history of previous clipboard entries including text and images.
- Hotkey - Executes specific system commands or scripts in response to defined keyboard input events.
- Desktop Application Launchers - Allows adding application icons to the status bar that launch specific programs when clicked.
- External Data Integrations - Fetches and displays real-time information from third-party sources such as weather services and AI models.
- Deep Work Timers - Includes a Pomodoro-style timer for managing work and break cycles.
- Developer Utilities - Includes a suite of developer tools for UUID generation, Base64 encoding, and API usage tracking directly in the bar.
- Widget Mapping Utilities - Maps global keyboard shortcuts to specific widget callbacks based on the active window or cursor.
- Window Stacking - Displays a list of windows in the active window stack for efficient navigation.
- Media Playback Controls - Manages media playback states and navigation through integrated buttons and popup menus.
- Media Track Displays - Shows current media metadata, thumbnails, and playback progress with customizable labels.
- Bluetooth Connectivity - Displays Bluetooth connection states and lists connected devices with customizable aliases.
- Window Switching and Tiling - Provides a searchable interface to switch focus between open application windows for efficient multitasking.
- Window Metadata Displays - Shows the title and icon of the currently focused application window with truncation and filtering.
- Power State Controllers - Implements a customizable menu to trigger system power actions such as shutdown, restart, and sleep.
- System Audio Controls - Allows changing system volume via mouse scroll events or clickable callbacks.
- System Control Center Interfaces - Provides a unified interface for adjusting system volume, screen brightness, and power plans.
- Global Hotkey Mappings - Allows users to trigger specific widget callbacks or system commands via global keyboard shortcuts.
- CPU Utilization Monitoring - Provides real-time processor utilization monitoring via labels, histograms, or progress bars.
- Memory Usage Analyzers - Provides real-time visualization of virtual and swap memory metrics using labels, histograms, and progress bars.
- Disk and Swap Monitoring - Monitors disk partition usage and storage capacity with visual progress bars.
- Network Connectivity Monitoring - Tracks real-time WiFi connectivity, available networks, and general network status.
- Network Interface Monitors - Shows detailed network connection status, including SSID, signal strength, and IP address.
- GPU Performance Monitoring - Reports real-time GPU metrics including utilization, temperature, and memory usage.
- Real-Time Network Monitors - Displays live network upload and download speeds for selected interfaces.
- System Clock Displays - Shows the current system time and date using customizable format strings and locale settings.
- System Volume Displays - Shows the current audio level using customizable text, level-specific icons, or progress bars.
- API Information Dashboards - Fetches and displays live external data from services including GitHub, weather providers, and cryptocurrency markets.
- Application Shortcuts - Provides a searchable grid interface to launch and manage application and URL shortcuts.
- Battery Status Indicators - Renders battery charge levels, charging states, and remaining time using customizable icons and progress bars.
- Wallpaper Color Extractors - Automatically generates a system color scheme by analyzing the current desktop wallpaper for visual consistency.
- System Tray Customizations - Renders active system tray icons with capabilities to pin, hide, or toggle grid views.
- Quick-Launch Application Interfaces - Provides quick-access launchers for favorite applications and system settings.
- Hardware Status Displays - Fetches and displays real-time hardware metrics, including values, units, and activity histograms.
- Running Application Trackers - Displays a list of running windows with configurable icons, labels, and filtering rules.
- Window Management - Enables triggering window actions like toggling visibility or opening context menus through mouse click callbacks.
- Window Previews - Shows thumbnail previews of open applications upon hovering with adjustable dimensions and delay.
- Data Polling - Periodically retrieves data from system commands and external APIs to keep the status bar updated.
- Desktop Customization - Creates customizable status bars.
