Install and configure AWWW for Omarchy | Omacom | Page 1

hearty flame Jan 17, 2026, 2:14 AM

#

This guide installs awww, sets up its background daemon so it starts at login, and keeps it running with auto-restarts.

1) Install awww

sudo pacman -S awww-git

Verify:

command -v awww
command -v awww-daemon

2) Create the systemd user service (keeps the daemon running)

Create ~/.config/systemd/user/awww-daemon.service:

[Unit]
Description=awww daemon
PartOf=graphical-session.target
After=graphical-session.target

[Service]
ExecStart=/usr/bin/awww-daemon
Restart=always
RestartSec=1

[Install]
WantedBy=default.target

3) Add a small override file for Wayland

First, find your Wayland display name:

echo "$WAYLAND_DISPLAY"

Now create ~/.config/systemd/user/awww-daemon.service.d/override.conf using that value:

[Service]
Environment=WAYLAND_DISPLAY=wayland-1
Environment=XDG_RUNTIME_DIR=/run/user/%U

Replace wayland-1 with the value you just printed.

4) Enable and start the daemon (auto-start + auto-restart)

systemctl --user daemon-reload
systemctl --user enable --now awww-daemon.service

Check:

systemctl --user status awww-daemon.service --no-pager

At this point the awww-daemon will start automatically when you log in, and it will restart if it crashes (because of Restart=always and RestartSec=1 in the service file).

5) Quick manual test (basic animation)

Run this to set a wallpaper with a basic animation:

awww img "/path/to/your/wallpaper.jpg" --transition-type grow --transition-duration 1.0

Enjoy!!

A little support goes a long way! If you’d like to help me keep creating, you can do so at https://ko-fi.com/oldjobobo

bright drum Jan 17, 2026, 2:17 PM

#

Hello @hearty flame I don't know what's happening

bright drum Jan 17, 2026, 2:47 PM

#

surreal flint Jan 17, 2026, 2:58 PM

#

bright drum

bro, is the waybar share-able please?

bright drum Jan 17, 2026, 3:03 PM

#

https://github.com/eososlinux/waybar#

GitHub

GitHub - eososlinux/waybar

Contribute to eososlinux/waybar development by creating an account on GitHub.

hearty flame Jan 17, 2026, 3:14 PM

#

contiue here with this when I get back,

hearty flame Jan 17, 2026, 3:41 PM

#

ok I'm back for a while

hearty flame Jan 17, 2026, 3:48 PM

#

bright drum https://github.com/eososlinux/waybar#

between the language barrier and the fact that like I say in the guide, this is just how i got it to work, I'm not sure how much i will be able to help. if you followed the steps exactly I think it should work

hearty flame Jan 17, 2026, 3:50 PM

#

bright drum

honestly it looks like its working fine to me.

bright drum Jan 17, 2026, 4:35 PM

#

pkill awww

#

awww-daemon &

#

then it works

hearty flame Jan 17, 2026, 8:14 PM

#

bright drum then it works

do this

ps -ef | grep -E 'awww(-daemon)?' | grep -v grep
systemctl --user status awww-daemon.service --no-pager

then show the results

bright drum Jan 17, 2026, 8:16 PM

#

Okey

hearty flame Jan 17, 2026, 8:17 PM

#

bright drum Okey

you need to do that when it is not working before you pkill anything

bright drum Jan 17, 2026, 8:19 PM

#

bright drum Hello <@225708636758867971> I don't know what's happening

@hearty flame .

hearty flame Jan 17, 2026, 8:22 PM

#

bright drum <@225708636758867971> .

are you using the correct wayland display? usualy i it is wayland-1 i think it is saying it is trying wayland 10 and 16 ?

hearty flame Jan 17, 2026, 8:23 PM

#

bright drum <@225708636758867971> .

that is similar but not the same as the command I gave you to do.

bright drum Jan 17, 2026, 8:24 PM

#

hearty flame Jan 17, 2026, 8:32 PM

#

bright drum

Edit: ~/.config/systemd/user/awww-daemon.service

Use this:

[Unit]
Description=awww daemon
PartOf=graphical-session.target
After=graphical-session.target

[Service]
ExecStart=/usr/bin/awww-daemon
Restart=on-failure
RestartSec=1

[Install]
WantedBy=default.target

Then:

systemctl --user daemon-reload
systemctl --user enable --now awww-daemon.service

bright drum Jan 17, 2026, 8:34 PM

#

Okay, it works.

#

I'm going to restart

#

Okay, after restarting I have to do this

#

…/.config/bin ❯ sh awww-wallpaper.sh

…/.config/bin ❯ awww-daemon

thread '<unnamed>' (1922) panicked at daemon/src/main.rs:696:55:
called Result::unwrap() on an Err value: "There is an awww-daemon instance already running on this socket!"
note: run with RUST_BACKTRACE=1 environment variable to display a backtrace
fatal runtime error: failed to initiate panic, error 5, aborting
Aborted (core dumped) awww-daemon

…/.config/bin ✗ systemctl --user stop awww-daemon.service
pkill awww-daemon
pkill awww

…/.config/bin ✗ aw
awk@ awww awww-daemon

…/.config/bin ✗ awww-daemon
[INFO] BumpPool with: 1 buffers. Size: 22500Kb
[WARN] We failed to find wayland buffer with id: 10. This should be impossible.
[INFO] BumpPool with: 1 buffers. Size: 22500Kb
[WARN] We failed to find wayland buffer with id: 10. This should be impossible.

hearty flame Jan 17, 2026, 8:40 PM

#

your trying to load it twice somehow

bright drum Jan 17, 2026, 8:42 PM

#

The demon does not start

hearty flame Jan 17, 2026, 8:42 PM

#

if you useing systemd you do not run awww-daemon again

#

systemd is running it so if you manualy doing awww-daemon or you put a exec-once of it somewhere you need to remove the

bright drum Jan 17, 2026, 8:42 PM

#

I'm using Arch - Hyperland, OMarchy installation

hearty flame Jan 17, 2026, 8:43 PM

#

do you understand?

bright drum Jan 17, 2026, 8:43 PM

#

yes I understand

#

I don't understand how it works awww

#

I have a binary and a running daemon

hearty flame Jan 17, 2026, 8:44 PM

#

do not run the daemon

#

the systed stuff sets it up so that the daemon is always running. so once you do the systemd stuff, You NEVER RUN 'awww-daemon' AGAIN! you use 'awww' thats it

#

you have it working your just still trying to run awww-daemon stop it

#

just use awww

#

ok thats it

#

any of that make sense?

#

a daemon is a process that runs always waiting for requests

bright drum Jan 17, 2026, 8:51 PM

#

Okay, how do I prove it works?

#

awww img "/path/to/your/wallpaper.jpg" --transition-type grow --transition-duration 1.0 ?

#

The command doesn't work

hearty flame Jan 17, 2026, 8:52 PM

#

awww img "/path/to/your/wallpaper.jpg" --transition-type grow --transition-duration 1.0

#

you need to change the "/path/to/your/wallpaper.jpg" to a real file

#

give that a valid path

bright drum Jan 17, 2026, 8:54 PM

#

awww img "/home/$USER/.config/omarchy/current/theme/backgrounds/2-cat-waves-mocha.png" --transition-type grow --transition-duration 2.5
Error: "Socket file '/run/user/1000/wayland-1-awww-daemon..sock' not found. Make sure awww-daemon is running, and that the --namespace argument matches for the client and the daemon"

#

The daemon is not running

#

It needs to be started manually.

#

It is understood

#

No problem, I'll find a solution later.

hearty flame Jan 17, 2026, 8:57 PM

#

ok try this

#

[Unit]
Description=awww daemon
PartOf=graphical-session.target
After=graphical-session.target

[Service]
ExecStart=/usr/bin/awww-daemon
Restart=always
RestartSec=1

[Install]
WantedBy=default.target

#

change Restart to always

hearty flame Jan 17, 2026, 9:13 PM

#

Well hoe you figure it out if that does not work. have to leave for now.. i'll check back later.

bright drum Jan 17, 2026, 9:14 PM

#

Okay, now it works

#

I'm going to restart the system

#

restart the laptop

hearty flame Jan 17, 2026, 9:18 PM

#

cool i've updated the guide so hopefully no one else should run into this in the future.

bright drum Jan 17, 2026, 9:19 PM

#

After restarting the laptop, it stops working

bright drum Jan 17, 2026, 9:46 PM

#

1 - pkill awww-daemon 1-run script example

#

That's how it works for me

hearty flame Jan 17, 2026, 9:48 PM

#

show me the script

bright drum Jan 18, 2026, 12:12 AM

#

hearty flame Jan 18, 2026, 12:34 AM

#

🤷‍♂️

#

I am run out of ideas. you need to sort out the daemon and or the wayland display id it seems but unfortunetly I am still new to systemd so I'm not sure how to help you further at this point

bright drum Jan 18, 2026, 12:49 AM

#

No problem, don't worry. 😅

#

Estoy preguntando en otro servidor gracias 👌

hearty flame Apr 11, 2026, 2:23 PM

#

bump

#

Install and configure AWWW for Omarchy

gilded saddle Apr 12, 2026, 9:54 AM

#

Install mpvpaper using '''yay -S mpvpaper'''
Save your video file .mp4 in ~/Pictures/
Comment this line "exec-once = uwsm-app -- swaybg -i ~/.config/omarchy/current/background -m fill" in /home/$USER/.local/share/omarchy/default/hypr/autostart.conf
4.add the line in .config/hypr/autostart.conf exec-once = mpvpaper -o "loop=yes mute=yes" eDP-1 /home/$USER/Pictures/video_file.mp4
*Change eDP-1 to your hyprctl monitors
*Change $USER to your username eg. rick
*if more monitors add the line on step 4 again, change ePD-1 to HDMI-1 or whatever

hearty flame Apr 12, 2026, 2:45 PM

#

K that is cool, why is it on this post?

gilded saddle Apr 12, 2026, 4:33 PM

#

oh, cause it's another way to set a wallpaper and I did not wanted to start a new post, this way the users can have options in a single thread ig

#

feel free to move it if you don't agree

hearty flame Apr 12, 2026, 4:40 PM

#

I am not an admin.

#Install and configure AWWW for Omarchy

1) Install awww

2) Create the systemd user service (keeps the daemon running)

3) Add a small override file for Wayland

4) Enable and start the daemon (auto-start + auto-restart)

5) Quick manual test (basic animation)