|
@@ -112,10 +112,16 @@ You can copy the `assets` folder manually:
|
|
|
2. Copy the `assets` folder
|
|
2. Copy the `assets` folder
|
|
|
3. Paste it into the same folder where the `linux-wallpaperengine` binary is located (build/output if you followed the build instructions)
|
|
3. Paste it into the same folder where the `linux-wallpaperengine` binary is located (build/output if you followed the build instructions)
|
|
|
|
|
|
|
|
|
|
+Another option is to specify the path manually with the `--assets-dir` option, like this:
|
|
|
|
|
+```bash
|
|
|
|
|
+linux-wallpaperengine --assets-dir /path/to/assets
|
|
|
|
|
+```
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
### 2. Build from Source
|
|
### 2. Build from Source
|
|
|
|
|
|
|
|
|
|
+> ⚠️ If you installed the AUR package mentioned before, you can skip this step.
|
|
|
|
|
+
|
|
|
Clone the repo:
|
|
Clone the repo:
|
|
|
|
|
|
|
|
```bash
|
|
```bash
|
|
@@ -134,8 +140,6 @@ make
|
|
|
Once the build process is finished, this should create a new `output` folder containing the app and all the required
|
|
Once the build process is finished, this should create a new `output` folder containing the app and all the required
|
|
|
support files to run.
|
|
support files to run.
|
|
|
|
|
|
|
|
-> ✅ Remember: Place the `assets` folder next to the built binary if it isn’t detected automatically.
|
|
|
|
|
-
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## 🧪 Usage
|
|
## 🧪 Usage
|
|
@@ -143,7 +147,7 @@ support files to run.
|
|
|
Basic syntax:
|
|
Basic syntax:
|
|
|
|
|
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine [options] <background_id or path>
|
|
|
|
|
|
|
+linux-wallpaperengine [options] <background_id or path>
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
You can use either:
|
|
You can use either:
|
|
@@ -190,34 +194,34 @@ If you're one of those developers, feel free to open an issue to get your projec
|
|
|
|
|
|
|
|
#### Run a background by ID
|
|
#### Run a background by ID
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine 1845706469
|
|
|
|
|
|
|
+linux-wallpaperengine 1845706469
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
#### Run a background from a folder
|
|
#### Run a background from a folder
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine ~/backgrounds/1845706469/
|
|
|
|
|
|
|
+linux-wallpaperengine ~/backgrounds/1845706469/
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
#### Assign backgrounds to screens with scaling
|
|
#### Assign backgrounds to screens with scaling
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine \
|
|
|
|
|
|
|
+linux-wallpaperengine \
|
|
|
--scaling stretch --screen-root eDP-1 --bg 2667198601 \
|
|
--scaling stretch --screen-root eDP-1 --bg 2667198601 \
|
|
|
--scaling fill --screen-root HDMI-1 --bg 2667198602
|
|
--scaling fill --screen-root HDMI-1 --bg 2667198602
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
#### Run in a window
|
|
#### Run in a window
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine --window 0x0x1280x720 1845706469
|
|
|
|
|
|
|
+linux-wallpaperengine --window 0x0x1280x720 1845706469
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
#### Limit FPS to save power
|
|
#### Limit FPS to save power
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine --fps 30 1845706469
|
|
|
|
|
|
|
+linux-wallpaperengine --fps 30 1845706469
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
#### Take a screenshot
|
|
#### Take a screenshot
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine --screenshot ~/wallpaper.png 1845706469
|
|
|
|
|
|
|
+linux-wallpaperengine --screenshot ~/wallpaper.png 1845706469
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
This can be useful as output for pywal or other color systems that use images as basis to generate a set of colors
|
|
This can be useful as output for pywal or other color systems that use images as basis to generate a set of colors
|
|
@@ -225,7 +229,7 @@ to apply to your system.
|
|
|
|
|
|
|
|
#### View and change properties
|
|
#### View and change properties
|
|
|
```bash
|
|
```bash
|
|
|
-./linux-wallpaperengine --list-properties 2370927443
|
|
|
|
|
|
|
+linux-wallpaperengine --list-properties 2370927443
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
The output includes all the relevant information for each of the different properties:
|
|
The output includes all the relevant information for each of the different properties:
|
|
@@ -280,7 +284,7 @@ visualizerwidth - slider
|
|
|
|
|
|
|
|
Any of these values can be modified with the --set-property switch. Say you want to enable the bloom in this background, you would do so like this:
|
|
Any of these values can be modified with the --set-property switch. Say you want to enable the bloom in this background, you would do so like this:
|
|
|
```
|
|
```
|
|
|
-./linux-wallpaperengine --set-property bloom=1 2370927443
|
|
|
|
|
|
|
+linux-wallpaperengine --set-property bloom=1 2370927443
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
---
|
|
---
|