1CLAWSKER(1)                                                        CLAWSKER(1)
2
3
4

NAME

6       Clawsker - A Claws Mail Tweaker
7

SYNOPSIS

9       clawsker [-a|--alternate-config-dir dirname] [-b|--verbose]
10       [-c|--clawsrc filename] [-i|--ignore-versions]
11       [-k|--hide-disabled-keys] [-r|--read-only] [-s|--small-screen]
12       [-u|--use-claws-version version]
13
14       clawsker [-v|--version]
15
16       clawsker [-h|--help]
17

DESCRIPTION

19       Clawsker is an applet to edit the so called Claws Mail hidden
20       preferences.
21
22       Claws Mail is a fast, lightweight and feature-rich MUA with a high
23       number of configurable options. To keep the binary small and fast some
24       of these preferences which are not widely used are not provided with a
25       graphical interface for inspection and/or modification.
26
27       Users wanting to edit such preferences had to face raw editing of their
28       configuration files, now you can do it with a convenient GTK interface
29       using Clawsker.
30
31       In adition to hidden features Clawsker can edit also some other
32       settings which usually can only be set indirectly. These include
33       currently the saved positions (and sizes when available) of Claws Mail
34       windows and all hot key mappings from application menus.
35

OPTIONS

37       -a | --alternate-config-dir dirname
38           Uses dirname as Claws Mail configuration directory.
39
40       -b | --verbose
41           Tells more on the standard output.
42
43       -c | --clawsrc filename
44           Uses filename as Claws Mail resource configuration file. This sets
45           the full file name overriding any previous setting.
46
47       -h | --help
48           Shows a brief help screen.
49
50       -i | --ignore-versions
51           Ignores any version detected or set by -u option. Almost all
52           options will be available.
53
54       -k | --hide-disabled-keys
55           On hotkeys columns sets foreground colour of unassigned keys to the
56           same colour used as background, rendering them invisible until
57           selected. This may help locating assigned keys on very long lists.
58
59       -r | --read-only
60           Edits hidden preferences without saving the changes. It also works
61           while Claws Mail is running.
62
63       -s | --small-screen
64           Resolution of display is autodetected to adjust UI for screens
65           where default rendering would exceed available space. This option
66           forces those small screen adjustments. This can be useful for
67           screens where the UI fits resolution, but the screen state is
68           already used by other programs.
69
70       -u | --use-claws-version version
71           Uses version as Claws Mail version instead of the real one. The
72           version argument is a list of integers, separated by dots if
73           needed.
74
75       -v | --version
76           Shows version information for program, Perl-GTK and Claws Mail.
77
78       Weird option specifications may produce weird results (but otherwise
79       correct).
80

LIMITATIONS

82       A running Claws Mail cannot be detected when using the --clawsrc option
83       because the directory containing the given file is not expected to be a
84       full Claws Mail configuration folder. If that is the case use the
85       --alternate-config-dir option instead.
86
87       Detection will also fail if the temporary directory resolution differs.
88       This may happen, for example, when the value of the environment
89       variable TMPDIR, under Clawsker is not the same that it was when Claws
90       Mail was launched. For Claws Mail versions greater than 3.17.8
91       different values for XDG_RUNTIME_DIR or XDG_CACHE_HOME may also cause
92       this.
93

SEE ALSO

95       Clawsker homepage <http://www.claws-mail.org/clawsker.php>, List of
96       hidden preferences <http://www.claws-mail.org/manual/claws-mail-
97       manual.html#adv_hidden>
98

AUTHOR

100       Main author is Ricardo Mones <ricardo@mones.org> with the help of
101       others. See the AUTHORS file on source tarball or git for a detailed
102       list of contributors.
103

105       Clawsker is Copyright 2007-2022 by Ricardo Mones Lastra.
106

LICENSE

108       This program is free software: you can redistribute it and/or modify it
109       under the terms of the GNU General Public License as published by the
110       Free Software Foundation, either version 3 of the License, or (at your
111       option) any later version.
112
113       This program is distributed in the hope that it will be useful, but
114       WITHOUT ANY WARRANTY; without even the implied warranty of
115       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
116       General Public License for more details.
117
118       You should have received a copy of the GNU General Public License along
119       with this program. If not, see <http://www.gnu.org/licenses/>.
120
121
122
1231.3.7                             2023-07-19                       CLAWSKER(1)
Impressum