chore: update README and LICENSE
This commit is contained in:
57
README.md
57
README.md
@@ -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
BIN
docs/demo.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 763 KiB |
Reference in New Issue
Block a user