eww

custom desktop widget system

TLDR

Start the daemon
$ eww daemon
Open a widget
$ eww [-c|--config] [path/to/source_code_directory] open [window_name]
Close a widget
$ eww [-c|--config] [path/to/source_code_directory] close [window_name]
Reload configuration
$ eww reload
Kill the daemon
$ eww kill
Get the value of a variable
$ eww get [variable_name]
Update a variable
$ eww update [variable_name]="[value]"
Print and watch logs
$ eww logs

SYNOPSIS

eww [options] command [arguments]

DESCRIPTION

eww (ElKowar's Wacky Widgets) creates custom desktop widgets for any window manager. It uses a configuration language to define widgets with dynamic content and styling.Popular for creating status bars, sidebars, and other desktop elements.

PARAMETERS

daemon

Start the daemon process.
open window
Open a widget window.
open-many windows...
Open multiple widget windows at once.
close window
Close a widget window.
close-all
Close all open widget windows.
reload
Reload configuration files.
kill
Stop the daemon.
logs
Display and watch logs.
get variable
Print the current value of a variable.
update var=value
Update a variable value.
state
Display the current state of all variables.
inspect
Open the GTK debugger.
shell-completions shell
Generate shell completions (bash, fish, zsh).
-c, --config path
Specify config directory.
--no-daemonize
Don't fork the daemon process to the background.

CONFIGURATION

~/.config/eww/eww.yuck

Widget definitions and structure written in the eww configuration language.
~/.config/eww/eww.scss
Widget styling using CSS/SCSS syntax.

INSTALL

sudo zypper install eww
nix profile install nixpkgs#eww

CAVEATS

Requires configuration files in eww format. Daemon must be running for widgets to display. Works with X11 and Wayland.

SEE ALSO

polybar(1), conky(1), waybar(1)