Skip to content

n-ovux/eww

 
 

Repository files navigation

Eww

Elkowars Wacky Widgets is a standalone widget system made in Rust that allows you to implement your own, custom widgets in any window manager.

Documentation and instructions on how to install can be found here.

Current maintenance status

To those of you looking at the current slow progress, commit frequency and general activity: Don't worry, eww is not dead! I'm currently in the process of focussing on my bachelors thesis, thus work on eww has currently slowed down significantly. I hope to find more time to continue working on new features in the not-so-distant future.

Thanks for sticking around!

Installing

If you would like to install eww the best way to do so would be to compile it manully.

Dependencies

In order to compile eww you must have the following packages

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

Compiling eww

cd eww
cargo build --release

Note: if your on wayland then do

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

Adding eww to bin

cd target/release
chmod +x ./eww
sudo install --mode +x ./eww /usr/local/bin/

Examples

(Note that some of these still make use of the old configuration syntax.)

Contribewwting

If you want to contribute anything, like adding new widgets, features, or subcommands (Including sample configs), you should definitely do so.

Steps

  1. Fork this repository
  2. Install dependencies
  3. Smash your head against the keyboard from frustration (coding is hard)
  4. Write down your changes in CHANGELOG.md
  5. Open a pull request once you're finished

Packages

No packages published

Languages

  • Rust 97.8%
  • TypeScript 1.5%
  • Nix 0.7%