0xTsoa
←/

eww

▲ 0✓
01. Overview & Architecture02. Installation & Deployment03. Screenshot Gallery04. Documentation & Guide

01. Overview & Architecture

Profile: v0.6.0
Schema validatedSource pinned
Purpose
ElKowars Wacky Widgets: build bars and widgets with Yuck and SCSS, written in Rust.
Compatibility
Any distro (Server: BOTH)
Desktop Part
Widgets & shells
Window Manager & Theme
Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
Origingithub.com/elkowar/ewwPinned to 48f5aa8b379a · reviewed in this config file
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: eww (some from the Arch AUR)
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/elkowar/eww ~/0xtsoa-review/elkowar-eww# 1. clone to a review folder
$git -C ~/0xtsoa-review/elkowar-eww checkout --detach 48f5aa8b379adf29da0b0bb9ca04164f65d8bdaa# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install eww (AUR)
$yay -S eww # AUR
$# Other distros: see the upstream README
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/elkowar/eww/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // eww

Capture 01 // Fullscreen
Example 1
01 / 11

04. Documentation & Guide

Source: elkowar/ewwRef: 48f5aa8b37
README.md|GitHub Flavored Markdown
RawSource ↗

![dependency status](https://deps.rs/repo/github/elkowar/eww/status.svg)

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.

Dharmx also wrote a nice, beginner friendly introductory guide for eww here.

Check out another cool project by me

I'm currently busy working yolk, which is a dotfile management solution that supports a unique spin on templating: templating without template files.

To find out more, check out the website and documentation!

Examples

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

Rxyhn-rice

eww-top-bar

Activate Linux

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

Widget

https://en.wikipedia.org/wiki/Wikipedia:Widget

GitHub Flavored Markdown (github-markdown-css)README snapshot at 48f5aa8b37