athena-eww

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #golang #machine-learning #docker #java #windows #awesome #cli #awesome-list #security #openai #open-source

(★ 174)

Elkowars wacky widget ecosystem for Athena

파일 탐색기

최종 버전 다운로드 (.zip)

- - dunstrc
- - eww.scss
  - eww.yuck
  - toggle_theme.sh
- - arch.txt
  - config.jsonc
- - kitty-theme.conf
  - kitty.conf
- - clipboard.rasi
  - config.rasi
  - password.rasi
- - starship.toml
- - main.yml
- battery.yuck
- README.md
.zshrc
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Athena Elkowars Wacky Widgets</h1>
<p align="center">

![Arch Linux](https://img.shields.io/badge/Arch_Linux-11111b?style=for-the-badge&logo=arch-linux&logoColor=89b4fa)
![Hyprland](https://img.shields.io/badge/Hyprland-11111b?style=for-the-badge&logo=hyprland&logoColor=89dceb)
![GitHub Repo stars](https://img.shields.io/github/stars/haikal-hakim/athena-eww?style=for-the-badge&logo=github&labelColor=11111b&color=cba6f7)
<a href="https://github.com/haikal-hakim/athena-eww/blob/main/LICENSE">
  <img src="https://img.shields.io/badge/license-MIT-f38ba8?style=for-the-badge&labelColor=11111b" />
</a>

</div>

<p align="center">
  Built on freedom, where users control the system, not the other way around.
</p>

https://github.com/user-attachments/assets/02678c41-7e7c-4dc8-a5f4-0c05b2a4679c

| Rofi Launcher | Clipboard Manager |
| :---: | :---: |
| <img src="https://github.com/user-attachments/assets/2c04699c-4ff1-49a7-9bbd-1548b23314fd" /> | <img src="https://github.com/user-attachments/assets/1a959cae-91a0-42e2-80d2-c75659826cc0" /> |
 
---

Here is the folder structure configuration:

```directory
athena-eww/
├── .config/
│   ├── dunst/
│   ├── eww/
│   │   ├── assets/           # Icons and widget images
│   │   ├── bar/
│   │   ├── corner/
│   │   ├── dashboard/
│   │   ├── panel/
│   │   ├── theme/            # Theme state and color palettes
│   │   ├── eww.yuck
│   │   ├── eww.scss
│   │   └── toggle_theme.sh   # Theme switcher script
│   ├── fastfetch/
│   ├── kitty/
│   ├── rofi/
│   └── starship/
├── extras/                   # Optional Eww configurations
└── .zshrc
```

---

### Dependencies

<details>
  <summary><b>Click here to see dependencies</b></summary>

To ensure all features of the Athena Eww setup work correctly, make sure the following packages are installed on your system:

### Install (Arch Linux)

You can install the required packages using `pacman`:

```bash
sudo pacman -S awk bluez-utils brightnessctl curl dbus dunst grep hyprshutdown inotify-tools jq libnotify networkmanager power-profiles-daemon python socat ttf-jetbrains-mono-nerd inter-font wireplumber
```

</details>

### Installation

Clone this repository:

```bash
git clone https://github.com/haikal-hakim/athena-eww.git
cd athena-eww
```

Copy configuration files:
```bash
cp -r .config/* ~/.config/
cp .zshrc ~/
```

---

<h1 align="center">Required Configuration</h1>
<p align="center">
  These settings are required for the widgets to work properly on your system.
</p>

### Script Permissions

All scripts inside the `scripts/` directories must be executable:

```bash
chmod +x ~/.config/eww/toggle_theme.sh
chmod +x ~/.config/eww/bar/scripts/*.sh
chmod +x ~/.config/eww/corner/scripts/*.sh
chmod +x ~/.config/eww/dashboard/scripts/*.sh
chmod +x ~/.config/eww/panel/scripts/*.sh
```

### Weather API (Dashboard)

Create an API key from [OpenWeatherMap](https://openweathermap.org/). Activation may take around 30 minutes.
Open the weather script:

```text
.config/eww/dashboard/scripts/weather.py
```

Set your API key and city:

```python
API_KEY = "YOUR_API_KEY" #example: API_KEY = "a1b2c3d4blablabla"
CITY = "YOUR_CITY"       #example: CITY = "New York"
```

### Weather Forecast Scale (Dashboard)

Widget weather forecast uses a vertical progress bar that serves as a temperature graph. My local tropical climate ranges from **15°C** to **36°C**, and yours may be different.

Open file:

```text
.config/eww/dashboard/src/weather_forecast.yuck
```

Find this section:

```lisp
:value {(day.temp - MIN_TEMP) / (MAX_TEMP - MIN_TEMP) * 100}
```

### Hardware Temperature Sensor (Dashboard)

This setting uses Eww's built-in [Magic Variables](https://elkowar.github.io/eww/magic-vars.html), not external scripts.
By default, configured with **`CORETEMP_PACKAGE_ID_0`** because my device uses an Intel CPU. Your device may have different hardware.

Check your available sensors, command in your terminal:

```bash
eww get EWW_TEMPS
```

Look for your sensor key or `main packages` in the output, and update key inside:

```text
.config/eww/dashboard/src/sysinfo.yuck:
```

Find section:

```lisp
(circular-progress :value {((EWW_TEMPS["YOUR_SENSOR_KEY"] ?: EWW_TEMPS["Tdie"] ?: 0) / 100) * 100}
                      ....
                            ....
                   (label :class "sysinfo-stat"
                          :text "${EWW_TEMPS["YOUR_SENSOR_KEY"] ?: EWW_TEMPS["Tdie"] ?: 0}°C")
                   )
)
```

> [!TIP]
> An alternative `battery.yuck` using Eww built-in `magic variables` is available inside the [extras/](./extras/) folder.
> This version removes polling scripts but does not include notifications or remaining time estimation.

### Todo Widget File (Dashboard)

- **Path:** `~/Documents/todo.txt`
- **Format:** A simple text file containing your tasks (maximum 3 lines).

Example:

```text
Task one
Task two
Task three
```

---

<h1 align="center">Optional Customization</h1>
<p align="center">
  These settings are optional and purely based on personal preference.
</p>

### Themes (panel)

If you want to modify an existing theme or add your own custom color scheme, you can do so. However, to prevent config corruption, any new theme must use the exact same color variable names (such as `base`, `mantle`, `crust`, `peach`, `mauve`, etc.) as the original Catppuccin Mocha theme.

Available themes:
- Catppuccin Mocha
- Catppuccin Latte
- Tokyo Night
- Tokyo Night Light

Create a new .scss palette inside `.config/eww/theme/`, and edit:

1. scripts Actions.`config/eww/toggle_theme.sh`
2. Widget file `.config/eww/panel/src/switcher.yuck`
3. Style Customization `.config/eww/panel/styles/switcher.scss`

### Website Shortcuts (Corner)

1. Script Actions `.config/eww/corner/scripts/website.sh`
2. Widget file `.config/eww/corner/src/website.yuck`
3. Style Customization `.config/eww/corner/styles/website.scss`

### App Launcher (Corner)

1. Put new `.png` icons inside the assets directory `.config/eww/assets/apps/`
2. Modify the Apps and Commands

```text
.config/eww/corner/src/launcher.yuck.
```

Example:

```lisp
(launcher-btn :icon "${EWW_CONFIG_DIR}/assets/apps/firefox.png"
              :cmd "firefox &")
```

---

<h1 align="center">Features</h1>

### Bar

### Panel

> [!TIP]
> The **Screenshot** and **Screen Record** features are tied to my custom Hyprland scripts. Paths are defined inside `~/.config/eww/panel/src/quicktoggle.yuck`.

> **Universal Wi-Fi Input:** Uses a custom Rofi theme [password.rasi](.config/rofi/password.rasi) for password entries, with automatic fallback support for Fuzzel and Wofi.

---

<h1 align="center">Autostart</h1>

Example `hyprland.lua` style:

```lua
hl.exec_cmd("eww daemon")
hl.exec_cmd("sleep 2 && eww open window_bar")
hl.exec_cmd("sleep 3 && eww open window_website")
hl.exec_cmd("sleep 4 && eww open window_launcher")
hl.exec_cmd("sleep 5 && eww open window_power")
```

---

<h1 align="center">Keybindings</h1>

Dashboard toggle:

```bash
eww open window_dashboard
```

Example `hyprland.lua` style:

```lua
hl.bind(mainMod .. " + D", function()
	hl.dispatch(hl.dsp.exec_cmd("eww close window_dashboard || eww open window_dashboard"))
end)
```

### Multimedia Control

To enable the OSD volume and brightness buttons on your keyboard. Example `hyprland.lua` style:

```lua
-- Volume --
hl.bind("XF86AudioRaiseVolume", function()
	hl.dispatch(hl.dsp.exec_cmd("bash " .. home .. "/.config/eww/corner/scripts/osd_vol.sh vol-up"))
end, { repeating = true })

hl.bind("XF86AudioLowerVolume", function()
	hl.dispatch(hl.dsp.exec_cmd("bash " .. home .. "/.config/eww/corner/scripts/osd_vol.sh vol-down"))
end, { repeating = true })

-- Brightness --
hl.bind("XF86MonBrightnessUp", function()
	hl.dispatch(hl.dsp.exec_cmd("bash " .. home .. "/.config/eww/corner/scripts/osd_bright.sh bright-up"))
end, { repeating = true })

hl.bind("XF86MonBrightnessDown", function()
	hl.dispatch(hl.dsp.exec_cmd("bash " .. home .. "/.config/eww/corner/scripts/osd_bright.sh bright-down"))
end, { repeating = true })
```

---

## Acknowledgments

* **[Eww](https://github.com/elkowar/eww)** - Created by **Elkowar**. Huge thanks to the creator and contributors for this amazing widget ecosystem.
* Also thanks to everyone whose open source configurations were inspiring.

*Muhammad Haikal Hakim*

athena-eww

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

athena-eww

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README