chore: update README and LICENSE

This commit is contained in:
2026-04-11 16:21:26 +02:00
parent fb3b82d33d
commit 59f214d956
3 changed files with 50 additions and 7 deletions

View File

View File

@@ -1,17 +1,60 @@
# wallpaper <div align="center">
<h1>pihkaal's wallpaper</h1>
<img src="docs/demo.gif" alt="demo" />
</div>
An animated and interactive wallpaper I'm building for myself, designed to run on [Hyprland](https://hyprland.org/).
## What it does
- Animated stars
- Metaballs-like effect with the "clouds"
## Limitations
- The wallpaper will only work on one monitor and on 1920x1080px for now
## Stack
- [C](https://en.wikipedia.org/wiki/C_(programming_language))
- [Raylib](https://www.raylib.com/)
- [Hyprland](https://hypr.land/)
## Quick start ## Quick start
### Build and install
```console ```console
$ make $ make
# generate distance field with 50px search radius # generate distance field with 100px ball radius (needed to offset vertically the effect)
# note that i already ship a generated distance field # NOTE: I already ship a generated distance field
$ ./distance_field_generator ./resources/textures/background_mask.png ./resources/textures/background_distance_field.png 50 # USAGE: distance_field_generator <mask_path> <output_path> <ball_radius>
$ ./distance_field_generator ./assets/textures/background_mask.png ./assets/textures/background_distance_field.png 100
# run wallpaper, image paths are customizables
$ ./wallpaper
# install # install
$ make install $ make install
# uninstall
$ make uninstall
```
### Run as wallpaper
You'll need to install [hyprwinwrap](https://code.hyprland.org/hyprwm/hyprland-plugins/src/branch/main/hyprwinwrap), then add this to your hyprland configuration:
```ini
plugin {
hyprwinwrap {
class = pkl-wallpaper
}
}
```
### Run as debug
Even if you've configured the app to always run as wallpaper using hyprwinwrap, you can still run it in debug mode:
```console
$ DEBUG=1 ./pkl-wallpaper
``` ```

BIN
docs/demo.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 763 KiB