Pi66

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

← back to log

V1.1.7

author: pixel2175
date: 2025-06-23 22:34
hash: cfbfbf3ae916b597f8b2de50bffc303acf773ae0

Diffstat:

M

walrs.1
68 +++++++++++++++++-------------
  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