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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114 | diff --git a/walrs.1 b/walrs.1
index 55cd68c..3de0117 100644
--- a/walrs.1
+++ b/walrs.1
@@ -3,70 +3,80 @@
walrs \- Fast Rust-based wallpaper and colorscheme generator
.SH SYNOPSIS
.B walrs
-[\-i <image|directory>] [\-k <backend>] [\-b <value>] [\-s <value>]
-[\-r | \-R] [\-t <theme|themes>] [\-g <theme_name>] [\-q]
+[\-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|directory>
-Generate colorscheme from specified image or a random image in the directory.
+.B \-i, \-\-image <image|directory>
+Path to image or directory. Generate colorscheme from specified image or a random image in the directory.
.TP
-.B \-k <backend>
-Select color extraction backend. Options: kmeans, color_thief, palette_extract, all (default).
+.B \-r, \-\-reload
+Reload without changing the wallpaper.
.TP
-.B \-b <value>
-Adjust brightness. Range: -128 to 127.
+.B \-R, \-\-reload\-no
+Will be removed in the next update; use \-w instead.
.TP
-.B \-s <value>
-Adjust saturation. Range: -128 to 127.
+.B \-t, \-\-theme <theme>
+Use external theme file from .config/walrs/colorschemes.
.TP
-.B \-r
-Reload colors without changing wallpaper.
+.B \-g, \-\-generate <theme_name>
+Generate & save theme to .config/walrs/colorschemes.
.TP
-.B \-R
-Reload colors and reset wallpaper.
+.B \-s, \-\-saturation <value>
+Set saturation value. Range: -128 to 127.
.TP
-.B \-t <theme|themes>
-Apply specified theme or list available themes.
+.B \-b, \-\-brightness <value>
+Set brightness value. Range: -128 to 127.
.TP
-.B \-g <theme_name>
-Save current colors as a new theme with the given name.
+.B \-S, \-\-scripts
+Skip running scripts in ~/.config/walrs/scripts/.
.TP
-.B \-q
-Quiet mode. Suppress output, useful for scripts.
+.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
-Generate colorscheme using kmeans backend:
-.B
-walrs \-i photo.jpg \-k kmeans
-.PP
Adjust brightness and saturation:
.B
walrs \-i image.jpg \-b 20 \-s 40
.PP
Apply existing theme:
.B
-walrs \-t vscode
+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/templates/
-Templates directory.
-.TP
-~/.config/wal/colorschemes/
+~/.config/walrs/colorschemes/
Themes directory.
.TP
+~/.config/walrs/scripts/
+Scripts directory.
+.TP
~/.cache/wal/colors
Generated colors file.
.TP
|