Installation

Installing ewwii

The first step of using Ewwii is installing it. You would need to have the following prerequesties installed on your system to build/install ewwii.

Prerequesties:

rustc
cargo

Rather than with your system package manager, I strongly recommend installing it using rustup.

Additionally, eww requires some dynamic libraries to be available on your system. The exact names of the packages that provide these may differ depending on your distribution. The following list of package names should work for arch linux:

Packages (click here)

gtk3 (libgdk-3, libgtk-3)
gtk-layer-shell (only on Wayland)
pango (libpango)
gdk-pixbuf2 (libgdk_pixbuf-2)
libdbusmenu-gtk3
cairo (libcairo, libcairo-gobject)
glib2 (libgio, libglib-2, libgobject-2)
gcc-libs (libgcc)
glibc

Note that you will most likely need the -devel variants of your distro’s packages to be able to compile ewwii.

Building

Once you have the prerequisites ready, you’re ready to install and build ewwii.

First clone the repo:

git clone https://github.com/Ewwii-sh/ewwii

cd ewwii

Then build:

cargo build --release --no-default-features --features x11

NOTE: When you’re on Wayland, build with:

cargo build --release --no-default-features --features=wayland

Running ewwii

Once you’ve built it you can now run it by entering:

cd target/release

Then make the Eww binary executable:

chmod +x ./ewwii

Then to run it, enter:

./ewwii daemon
./ewwii open <window_name>

Installing via package managers

If you don’t want to go through the very tedious task of cloning and building ewwii, you can install it using Cargo (Rust crate manager).

You can run the following command to install ewwii from cargo:

cargo install --git https://github.com/Ewwii-sh/ewwii

Installing eiipm

eiipm is the official package manager for Ewwii. It’s recommended to install it alongside Ewwii to easily manage packages.

You can install eiipm using the same methods as Ewwii:

1. From source

git clone https://github.com/Ewwii-sh/eiipm
cd eiipm
cargo build --release

This will generate the eiipm binary in target/release.

2. Using Cargo

cargo install --git https://github.com/Ewwii-sh/eiipm

After installation, verify it works:

eiipm --version