deblan/i3-wallpaper-manager
1
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages 1 Wiki Activity Actions
No description
24 commits 3 branches 5 tags 1.6 MiB
  • Go 64.1%
  • Makefile 26.7%
  • Shell 9.2%
Find a file
Simon Vieille 0157a6a002
All checks were successful
ci/woodpecker/push/test Pipeline was successful
Details
ci/woodpecker/push/build Pipeline was successful
Details
update readme
2024-07-31 23:30:16 +02:00
.woodpecker fix shell script 2024-07-30 21:35:43 +02:00
bin fix shell script 2024-07-30 21:35:43 +02:00
.fpm add CI files 2024-07-30 21:34:05 +02:00
.gitignore add CI files 2024-07-30 21:34:05 +02:00
CHANGELOG.md update wallpapers on start 2024-07-31 23:13:59 +02:00
config.go refactoring: move logic in different files 2024-07-31 12:38:34 +02:00
config.yaml.example update configuration example 2024-07-30 21:54:58 +02:00
feh.go refactoring: move logic in different files 2024-07-31 12:38:34 +02:00
go.mod go mod tidy 2024-07-30 20:01:33 +02:00
go.sum go mod tidy 2024-07-30 20:01:33 +02:00
LICENCE add licence 2024-07-30 21:39:30 +02:00
main.go update wallpapers on start 2024-07-31 23:13:59 +02:00
Makefile add CI files 2024-07-30 21:34:05 +02:00
README.md update readme 2024-07-31 23:30:16 +02:00
wallpaper.go update wallpapers on start 2024-07-31 23:13:59 +02:00

README.md

🖥️ i3 wallpaper manager

i3 wallpaper manager is a command-line tool designed to change the wallpaper depending of active workspaces on i3.

Thanks AZProductions!

📗 How to install the project

Dependencies

Pre-compiled versions

Pre-compiled versions are available in the Releases. For Debian users, a package is also provided.

From source

If you want to compile the project from source, you will need at least the GO compiler version 1.22. Clone the project and run the make command. The compiled output will be located in the build directory.

$ git clone https://gitnet.fr/deblan/i3-wallpaper-manager
$ make

🧪 How to use the project

To start, you need to create a configuration file in YAML format. This file consists of two keys: default to define the path of the default wallpaper, and workspaces which allows you to associate each workspace with its corresponding wallpaper.

default: /home/alice/wallpapers/default.jpg
workspaces:
  "Name of the workspace 1": /home/alice/wallpapers/1.jpg
  "Name of the workspace 2": /home/alice/wallpapers/2.jpg
  "Name of the workspace 3": /home/alice/wallpapers/3.jpg

Next, you simply need to run i3-wallpaper-manager while specify the path to the configuration file.

DISPLAY=:0 i3-wallpaper-manager /path/to/config.yaml

To run it when i3 starts, add this to your i3 configuration:

exec_always DISPLAY=:0 i3-wallpaper-manager /path/to/config.yaml