Pi66

walrs
pywal but if its Fast-Minimal-Simple
git clone https://git.pi66.xyz/walrs

walrs.1 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
.TH WALRS 1 "June 2025" "Version 1.1.4" "User Commands"
.SH NAME
walrs \- Fast Rust-based wallpaper and colorscheme generator
.SH SYNOPSIS
.B walrs
[\-i <image|directory>] [\-b <value>] [\-s <value>]
[\-r | \-R] [\-t <theme>] [\-g <theme_name>] [\-S] [\-W] [\-q] [\-v]
.SH DESCRIPTION
.B walrs
is a command-line utility that generates a color scheme from the dominant colors in an image. This palette can then be applied system-wide and on the fly in various programs.
.SH OPTIONS
.TP
.B \-i, \-\-image <image|directory>
Path to image or directory. Generate colorscheme from specified image or a random image in the directory.
.TP
.B \-r, \-\-reload
Reload without changing the wallpaper.
.TP
.B \-R, \-\-reload\-no
Will be removed in the next update; use \-w instead.
.TP
.B \-t, \-\-theme <theme>
Use external theme file from .config/walrs/colorschemes.
.TP
.B \-g, \-\-generate <theme_name>
Generate & save theme to .config/walrs/colorschemes.
.TP
.B \-s, \-\-saturation <value>
Set saturation value. Range: -128 to 127.
.TP
.B \-b, \-\-brightness <value>
Set brightness value. Range: -128 to 127.
.TP
.B \-S, \-\-scripts
Skip running scripts in ~/.config/walrs/scripts/.
.TP
.B \-W, \-\-walless
Skip changing the wallpaper.
.TP
.B \-q, \-\-quiet
Set quit mode (no output).
.TP
.B \-v, \-\-version
Show version.
.SH EXAMPLES
Generate colorscheme from an image:
.B
walrs \-i ~/Pictures/sunset.jpg
.PP
Adjust brightness and saturation:
.B
walrs \-i image.jpg \-b 20 \-s 40
.PP
Apply existing theme:
.B
walrs \-t my_theme
.PP
Save current colors as a new theme:
.B
walrs \-g my_sunset_theme
.PP
Skip wallpaper change and scripts:
.B
walrs \-i photo.jpg \-W \-S
.PP
Reload colors without changing wallpaper:
.B
walrs \-r
.SH FILES
.TP
~/.config/walrs/
Configuration directory.
.TP
~/.config/walrs/colorschemes/
Themes directory.
.TP
~/.config/walrs/scripts/
Scripts directory.
.TP
~/.cache/wal/colors
Generated colors file.
.TP
~/.cache/wal/colors.json
Generated colors in JSON format.
.TP
~/.cache/wal/wal
Current wallpaper path.
.SH AUTHOR
Developed by Pixel.
.SH LICENSE
GNU General Public License v3.0