Installation
Linux
Installation steps
- Download
.zippackage from releases - Unzip the content to
/:
sudo unzip -d / [archive name].zip
- Test lwp by running
lwp - To make lwp run on startup, add
lwp &command to Your desktop enviroment.rcfile
Build from source instead
- Install
SDL2using Your package manager - Clone the repository and install
lwp:
git clone https://github.com/jszczerbinsky/lwp
cd lwp
make
sudo make install
- Test lwp by running
lwp - To make lwp run on startup, add
lwp &command to Your desktop enviroment.rcfile
Windows
Installation steps
- Download
.zippackage from releases - Extract the package
- Run
install.batas Administrator - Lwp should run immediately after the installation
Build from source instead
- You need
MinGWwith SDL2-devel
git clone https://github.com/jszczerbinsky/lwp
cd lwp
build.bat
- Download SDL2 and put
SDL2.dllindatadirectory - Run
install.batas Administrator - Lwp should run immediately after the installation
Configuration
Create a configuration file
Linux
- Copy default config file to
.config/lwp/lwp.cfg:
mkdir ~/.config/lwp cp /etc/lwp.cfg ~/.config/lwp/lwp.cfg
Windows
- Press ⊞ Win + R
- Type
%appdata%and pressOk - Create new directory and name it
lwp - Copy file
C:Program FileslwpdefaultWin.cfgto directory created in the previous step and rename it tolwp.cfg - Open
lwp.cfgin notepad
Using config file
- Do not put spaces between
=and values - Do not leave trailing spaces
- Comments start with
# - Do not put strings in quotation marks
Available options:
| Type | Name | Description |
|---|---|---|
| int | reload_rootwindow | Set this to 1 if You are using a compositor (linux only) |
| float | smooth | Smooth movement multipler |
| int | monitors | Monitors count |
| int | monitor[n]_x | Position of nth monitor in X axis |
| int | monitor[n]_y | Position of nth monitor in Y axis |
| int | monitor[n]_w | Width of nth monitor |
| int | monitor[n]_h | Height of nth monitor |
| string | monitor[n]_wallpaper | Absolute path to the wallpaper directory |
| int | monitor[n]_wallpaper_x | Position of the wallpaper relative to the monitor |
| int | monitor[n]_wallpaper_y | Position of the wallpaper relative to the monitor |
| int | monitor[n]_wallpaper_w | Wallpaper resolution |
| int | monitor[n]_wallpaper_h | Wallpaper resolution |
Creating Wallpapers
Want to share Your wallpaper? Join our discord!
Parallax wallpapers are not popular. Because of this if You want some cool parallax wallpaper, You have to either find a parallax game background on the internet and use it as a wallpaper or cut some real wallpaper into layers using Gimp or Photoshop.
How to create a wallpaper for lwp
- Create a directory for Your wallpaper
- Save each layer to this directory as
.bmpfile and name them1.bmp,2.bmp… (1.bmpis bottom most layer) - Create a wallpaper config file and name it
wallpaper.cfg(You can make a copy fromC:Program FileslwpdefaultWin.cfg)
Example:
File structure:
C:
└ MyCoolWallpaperDirectory
└ wallpaper.cfg
└ 1.bmp
└ 2.bmp
└ 3.bmp
Config file:
| Type | Name | Description |
|---|---|---|
| int | count | Wallpaper layers count |
| float | movement_x | Mouse sensitivity in X axis |
| float | movement_y | Mouse sensitivity in Y axis |
| float | movement_x_[n] | Mouse sensitivity in X axis for nth layer (optional) |
| float | movement_y_[n] | Mouse sensitivity in Y axis for nth layer (optional) |
| int | repeat_x | Repeat the wallpaper in X axis |
| int | repeat_y | Repeat the wallpaper in Y axis |
License
MIT License
Copyright (c) 2022 Jakub Szczerbiński
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT
