readme.md

ｇｉｆｗ

[ run full animated gifs as your wallpaper ]

✧ features

• 🎬 full gif animation support
• 🖼️ multiple display modes (stretch/center/tile)
• 🚀 lightweight x11 implementation
• 📦 easy installation

✧ preview

✧ known issues

• ⚠️ does not work on wayland
• ⚠️ might have conflicts with compositors like picom

✧ dependencies

• 📝 c compiler (gcc or clang)
• 🔧 make
• 🖥️ x11 libraries and headers (xlib)

✧ installation

git clone https://github.com/getjared/gifw.git
cd gifw
make
sudo make install

✧ quick start guide

basic usage

./gifw path/to/your/awesome.gif [stretch|center|tile]

display modes

• stretch: fills the entire screen
• center: places gif in the middle
• tile: repeats the gif across the screen

autostart

add to your .xinitrc:

gifw /home/user/wallpapers/avd.gif stretch &

✧ protips

• 🎨 use with solid-color compositors for best performance
• 🖥️ works great with minimalist window managers
• 💡 try different modes for different gif sizes
• ⚡ consider gif size vs performance trade-offs

╭─────────────────────────╮
│  made with ♥ by jared   │
╰─────────────────────────╯