How danxliu/eww-widgets works
Project type and purpose
• This is a user-configured EWW (Elkow Window Widgets) “vertical bar” widget for Linux desktops.
• It consists of UI definitions (YUCK files), style sheets (SCSS), shell scripts for dynamic data (weather, notifications, media, etc.), and a launcher script to start the bar.
File structure
• Top-level:
– bar.sh – launcher for the EWW bar
– scss/ – style definitions in SCSS, compiled to CSS by EWW at runtime
– yuck/ – EWW UI templates, describing panels, controls, notifications, power menu, etc.
– scripts/ – shell/ZSH scripts providing dynamic data (weather from OpenWeather API, workspace manager, powermenu actions, sysinfo, logger for notifications, etc.)
• Patterns:
– UI layer: YUCK templates + SCSS for appearance
– Logic layer: standalone scripts invoked by UI events or EWW polling
– Launcher: bar.sh starts an EWW daemon instance pointed at these configs
Insights from README
• Describes required fonts, OpenWeather API key, Dunst integration for notifications
• Instructs where to install ($HOME/.config/eww/vertical-bar) and how to hook into Dunst
• No external service beyond OpenWeather and the local notification daemon
Detail without over-partitioning
• 3 layers (UI, style, logic) distinctly.
• Associations between YUCK widgets and corresponding SCSS rules.
• Which scripts are polled vs. event-driven.
• Notes on required fonts & permissions (chmod +x).