1jwm(1)                      General Commands Manual                     jwm(1)
2
3
4

NAME

6       JWM - Joe's Window Manager
7
8

SYNOPSIS

10       jwm [options]
11

DESCRIPTION

13       JWM is a window manager for the X11 Window System.
14
15

OPTIONS

17       -display display
18              This option specifies the display to use; see X(1).
19
20       -exit
21              Exit JWM by sending _JWM_EXIT to the root window.
22
23       -f file
24              Specify an alternate configuration file to use.
25
26       -h
27              Display a help message and exit.
28
29       -p
30              Parse the configuration file and exit.  It is a good idea to use
31              this after making modifications to the configuration file to en‐
32              sure there are no errors.
33
34       -restart
35              Restart JWM by sending _JWM_RESTART to the root window.
36
37       -reload
38              Reload menus by sending _JWM_RELOAD to the root window.
39
40       -v
41              Display version information and exit.
42
43

FILES

45       /etc/system.jwmrc
46              The default JWM configuration file.
47
48       ~/.jwmrc
49              Default local configuration file. Copy the default configuration
50              file to this location to make user-specific changes.  See  also,
51              option -f.
52
53

CONFIGURATION

55       OVERVIEW
56              Configuration of JWM is done by editing ".jwmrc" (or the config‐
57              uration file specified with the -f option).  This  file  is  XML
58              making  it easy to edit, either by hand or programmatically. The
59              example.jwmrc  gives  an  example  configuration  file.   Before
60              restarting  JWM,  it is a good idea to run "jwm -p" to make sure
61              the configuration file is free of errors.  Otherwise you may end
62              up without a root menu.
63
64       ROOT MENU
65              The  root  menu  in JWM is the primary way of starting programs.
66              It also provides a way to restart or exit  the  window  manager.
67              The  outer  most  tag  is RootMenu. The following attributes are
68              supported:
69
70              onroot list
71                     Determine which buttons on the root window  activate  the
72                     menu.  This is a list of integers specifying buttons. The
73                     default is "123".  Note that multiple root menus  may  be
74                     specified by using different buttons for different menus.
75                     The range of possible values is 0 to 9 inclusive as  well
76                     as  a to z inclusive, providing for up to 36 menus.  Note
77                     that only the numeric values map to mouse buttons.
78
79              height int
80                     Height of each menu  item  in  pixels.  0  indicates  the
81                     largest  menu item will determine the height. The default
82                     is 0.
83
84              labeled bool
85                     Determines if a label appears at the top of the menu. De‐
86                     fault is false.
87
88              label string
89                     The  label  to display at the top of the menu. Default is
90                     "JWM".
91
92              dynamic string
93                     A dynamically loaded menu. If the text starts with exec:,
94                     the output of the specified program is used.
95
96              Within the RootMenu tag, the following tags are supported:
97
98              Menu
99                     This  tag creates a submenu item. Any of the tags allowed
100                     within the RootMenu tag, including the Menu tag  are  al‐
101                     lowed  within  this element. The following attributes are
102                     supported:
103
104                     height int
105                            Height of each menu item in  pixels.  0  indicates
106                            the  largest  menu item will determine the height.
107                            The default is inherited from the parent menu.
108
109                     label string
110                            The label to use. No default.
111
112                     tooltip string
113                            A tooltip to display. No default.
114
115                     icon string
116                            The icon to use for this menu. No default.
117
118                     labeled bool
119                            Determines if a label appears at the  top  of  the
120                            menu. Default is false.
121
122              Dynamic
123                     Dynamically  include the contents of a file or executable
124                     into a submenu.  The file must start with  a  "JWM"  tag.
125                     The file is specified by the text of the tag. If the text
126                     starts with "exec:" then the output of a program is used.
127                     This tag supports the same attributes as Menu.
128
129              Include
130                     Include  the  contents of a file into the menu structure.
131                     The file must start with a "JWM" tag. The file is  speci‐
132                     fied  by  the  text  of the tag.  If the text starts with
133                     "exec:" then the output of a program is used.
134
135              Program
136                     The Program tag provides a way to start an external  pro‐
137                     gram.  The  text in this tag is the command used to start
138                     the program.  The following attributes are supported:
139
140                     label string
141                            The label to display. Default is the text  of  the
142                            tag.
143
144                     tooltip string
145                            A tooltip to display. No default.
146
147                     icon string
148                            The icon to use. No default.
149
150              Separator
151                     This tag simply puts a line in the menu allowing menu di‐
152                     visions.  No text or attributes are used.
153
154              Desktops
155                     Add a desktop menu. This will add a submenu with  a  list
156                     of  desktops that can be used to change the current desk‐
157                     top.  The following attributes are supported:
158
159                     label string
160                            The label to use for  the  menu.  The  default  is
161                            "Desktops".
162
163                     tooltip string
164                            A tooltip to display. No default.
165
166                     icon string
167                            The icon to use for this item. No default.
168
169              SendTo
170                     Add a "send to" menu to the menu. After selecting an item
171                     from this menu, a window may be  selected  to  send  that
172                     window to the selected desktop.  The following attributes
173                     are supported:
174
175                     label string
176                            The label to use. The default is "SendTo".
177
178                     tooltip string
179                            A tooltip to display. No default.
180
181                     icon string
182                            The icon to use for this item. No default.
183
184              Stick
185                     Add a stick/unstick window operation to the  menu.  After
186                     selecting  this  item  a window may be selected to toggle
187                     the sticky state  of  that  window.   The  following  at‐
188                     tributes are supported:
189
190                     label string
191                            The label to use. The default is "Stick".
192
193                     tooltip string
194                            A tooltip to display. No default.
195
196                     icon string
197                            The icon to use for this item. No default.
198
199              Maximize
200                     Add  a  maximize  window operation to the menu. After se‐
201                     lecting this item a window may be selected to toggle  the
202                     maximized state of that window.  The following attributes
203                     are supported:
204
205                     label string
206                            The label to use. The default is "Maximize".
207
208                     tooltip string
209                            A tooltip to display. No default.
210
211                     icon string
212                            The icon to use for this item. No default.
213
214              Minimize
215                     Add a minimize window operation to the  menu.  After  se‐
216                     lecting  this  item  a window may be selected to minimize
217                     that window.  The following attributes are supported:
218
219                     label string
220                            The label to use. The default is "Minimize".
221
222                     tooltip string
223                            A tooltip to display. No default.
224
225                     icon string
226                            The icon to use for this item. No default.
227
228              Shade
229                     Add a shade/unshade window operation to the  menu.  After
230                     selecting  this  item  a window may be selected to toggle
231                     the shaded status of  that  window.   The  following  at‐
232                     tributes are supported:
233
234                     label string
235                            The label to use. The default is "Shade".
236
237                     tooltip string
238                            A tooltip to display. No default.
239
240                     icon string
241                            The icon to use for this item. No default.
242
243              Move
244                     Add  a move window operation to the menu. After selecting
245                     this item a window may be selected to move  that  window.
246                     The following attributes are supported:
247
248                     label string
249                            The label to use. The default is "Move".
250
251                     tooltip string
252                            A tooltip to display. No default.
253
254                     icon string
255                            The icon to use for this item. No default.
256
257              Resize
258                     Add  a resize window operation to the menu. After select‐
259                     ing this item a window may be  selected  to  resize  that
260                     window.  The following attributes are supported:
261
262                     label string
263                            The label to use. The default is "Resize".
264
265                     tooltip string
266                            A tooltip to display. No default.
267
268                     icon string
269                            The icon to use for this item. No default.
270
271              Kill
272                     Add  a kill window operation to the menu. After selecting
273                     this item a window may be selected to kill  that  window.
274                     The following attributes are supported:
275
276                     label string
277                            The label to use. The default is "Kill".
278
279                     tooltip string
280                            A tooltip to display. No default.
281
282                     icon string
283                            The icon to use for this item. No default.
284
285              Close
286                     Add a close window operation to the menu. After selecting
287                     this item a window may be selected to close that  window.
288                     The following attributes are supported:
289
290                     label string
291                            The label to use. The default is "Close".
292
293                     tooltip string
294                            A tooltip to display. No default.
295
296                     icon string
297                            The icon to use for this item. No default.
298
299              Restart
300                     This  tag adds a menu item to restart the window manager.
301                     The following attributes are supported:
302
303                     label string
304                            The label to use. The default is "Restart".
305
306                     tooltip string
307                            A tooltip to display. No default.
308
309                     icon string
310                            The icon to use. No default.
311
312              Exit
313                     This tag adds a menu item to exit the window manager.  If
314                     text  is  present within this tag, it is interpreted as a
315                     command to run when JWM exits. This can be used to  start
316                     another  window  manager.   The  following attributes are
317                     supported:
318
319                     label string
320                            The label to use. The default is "Exit".
321
322                     tooltip string
323                            A tooltip to display. No default.
324
325                     icon string
326                            The icon to use. No default.
327
328                     confirm bool
329                            Determine if a confirm dialog appears before exit‐
330                            ing. Default is true.
331
332                     Note  that  confirm dialogs can be disabled completely at
333                     the compile-time.
334
335       TRAYS
336              One or more trays may be created via the  Tray  tag.   This  tag
337              supports the following attributes:
338
339              autohide string
340                     Specifies  the  location  to hide the tray when not acti‐
341                     vated. Default is "off" to disable hiding.  Possible val‐
342                     ues are "left", "right", "top", "bottom", and "off".
343
344              x int
345                     The x-coordinate of the tray. This may be negative to in‐
346                     dicate an offset from the right of the screen.
347
348              y int
349                     The y-coordinate of the tray. This may be negative to in‐
350                     dicate an offset from the bottom of the screen.
351
352              width int
353                     The  width  of the tray. 0 indicates that the tray should
354                     compute an optimal width depending on  what  it  contains
355                     and  the  layout.  A  negative  value subtracts from with
356                     screen width. 0 is the default.
357
358              height int
359                     The height of the tray. 0 indicates that the tray  should
360                     compute  an  optimal height depending on what it contains
361                     and the layout.  A  negative  value  subtracts  from  the
362                     screen height. 0 is the default.
363
364              layer { below | normal | above }
365                     The layer of the tray. The default is above.
366
367              layout { vertical | horizontal }
368                     The layout of the tray. The default is horizontal.
369
370              valign { fixed | top | center | bottom }
371                     The vertical alignment of the tray. The default is fixed.
372
373              halign { fixed | left | center | right }
374                     The  horizontal  alignment  of  the  tray. The default is
375                     fixed.
376
377              Within this tag the following tags are supported:
378
379              Clock
380                     Add a clock to the tray. The text of this tag  determines
381                     what  action  to take when the clock is clicked.  Option‐
382                     ally, one or more Button tags may be  specified  to  bind
383                     actions  to specific mouse buttons specified via the mask
384                     attribute.  By default, the button mask  is  "123".   The
385                     following actions are supported:
386
387                     root:n
388                            Show  root menu n.  Note that the default TrayBut‐
389                            ton action is root:1.
390
391                     exec: string
392                            Execute a command.
393
394                     showdesktop
395                            Minimize all windows on the current desktop.
396
397                     This tag supports the following attributes:
398
399                     format string
400                            The format of the clock. See strftime(3).
401
402                     zone string
403                            The time zone of the clock.  See tzset(3).
404
405                     width int
406                            The width of the clock. 0 indicates that the width
407                            should  be  determined from the length of the text
408                            to be displayed.
409
410                     height int
411                            The height of the  clock.  0  indicates  that  the
412                            height should be determined from the font used.
413
414              Dock
415                     Add  a dock for system notifications. This can be used by
416                     those programs that use  the  _NET_SYSTEM_TRAY_Sn  selec‐
417                     tion.  The  size of the Dock is dynamic based on the size
418                     of the tray and the number of items contained.  Only  one
419                     Dock  is  allowed  per instance of JWM. This tag supports
420                     the following attributes:
421
422                     width int
423                            The maximum width of  an  item  contained  in  the
424                            dock.  This defaults to the width or height of the
425                            tray (whichever is smaller).
426
427                     spacing int
428                            The spacing of items contained  in  the  dock  (in
429                            pixels).  This defaults to 0.
430
431              Pager
432                     Add  a pager to the tray.  A pager shows a miniature rep‐
433                     resentation of a  desktop.   When  over  the  pager,  the
434                     scroll  wheel  will  switch  desktops.   Holding down the
435                     right mouse button allows you to drag a window around  in
436                     the pager which changes its position on the real desktop.
437                     You can also drag a window in the pager from one  desktop
438                     to another.  This tag supports the following attributes:
439
440                     labeled bool
441                            Determines  if  the pager has text labels. Default
442                            is false.
443
444                     Also see the PAGER STYLE section for more information.
445
446              Spacer
447                     Add empty space to the tray.  This tag supports the  fol‐
448                     lowing attributes:
449
450                     width int
451                            The  width  of the spacer (0 to fill all available
452                            space).  0 is the default.
453
454                     height int
455                            The height of the spacer (0 to fill all  available
456                            space).  0 is the default.
457
458              Swallow
459                     Swallow  a  program  into  the tray. The text of this tag
460                     gives the command to run.  This tag supports the  follow‐
461                     ing attributes:
462
463                     name string
464                            The name of the program to swallow. This attribute
465                            is required.
466
467                     width int
468                            The width of the swallowed  program.  0  indicates
469                            that  the width should be determined from the tray
470                            and size requested from the program. 0 is the  de‐
471                            fault.
472
473                     height int
474                            The  height  of the swallowed program. 0 indicates
475                            that the height should be determined from the tray
476                            and  the size requested from the program. 0 is the
477                            default.
478
479              TaskList
480                     Add a task list to the tray.  This tag supports the  fol‐
481                     lowing attributes:
482
483                     height int
484                            The  height  of  an item in the task list. 0 indi‐
485                            cates that the height should  be  taken  from  the
486                            tray.  The default is 0.
487
488                     labeled bool
489                            Determines  if  a  label is shown for items in the
490                            task list.  The default is true.
491
492                     maxwidth int
493                            The maximum width of an item in the task  list.  0
494                            indicates no maximum.  The default is 0.
495
496              TrayButton
497                     Add a button to the tray. The text of this tag determines
498                     what action to take when the button is  clicked.  Option‐
499                     ally,  one  or  more Button tags may be specified to bind
500                     actions to specific mouse buttons specified via the  mask
501                     attribute.   By  default,  the button mask is "123".  The
502                     following actions are supported:
503
504                     root:n
505                            Show root menu n.  Note that the default  TrayBut‐
506                            ton action is root:1.
507
508                     exec: string
509                            Execute a command.
510
511                     showdesktop
512                            Minimize all windows on the current desktop.
513
514                     This tag supports the following attributes:
515
516                     label string
517                            A label to display. No default.
518
519                     popup string
520                            A  string  to  be displayed for a popup. This will
521                            default to the value specified for label, if  pro‐
522                            vided. If neither popup nor label are specified no
523                            popup will be shown.
524
525                     icon string
526                            An icon to display. No default.
527
528       INCLUDES
529              Other configuration files or the output of programs may  be  in‐
530              cluded  under  the JWM tag via the Include tag. The text of this
531              tag specifies the location of an additional  configuration  file
532              or  program.  The  path  may be relative to the location JWM was
533              started, an absolute path, or a path referencing an  environment
534              variable  (using  '$').   If  the  text starts with "exec:", the
535              specified program is executed and its output is used.  The  for‐
536              mat  of  the configuration file or program output is the same as
537              the main configuration file.
538
539       GROUP SETTINGS
540              Program groups allow one to specify options  which  apply  to  a
541              group  of programs by name and/or class. A program group is cre‐
542              ated with the Group tag. As many program groups can  be  created
543              as desired.  If one or more Name tags is specified, at least one
544              name must match.  Likewise, if one or more Class tags is  speci‐
545              fied, at least one class must match.  JWM matches using extended
546              POSIX regular expressions for both Name  and  Class  tags.   See
547              regex(7).   Within  the  Group  tag  the following tags are sup‐
548              ported:
549
550              Name
551                     The window name of a program to match to be in this group
552                     (the first string in WM_CLASS).
553              Class
554                     The  window  class  for  a program to match to be in this
555                     group (the second string in WM_CLASS).
556              Option
557                     An option for this group. Possible options are:
558
559
560                     aerosnap
561                            Enable auto-maximization when a window is  dragged
562                            to the corner of the screen.
563
564
565                     border
566                            Causes windows in this group to have a border.
567
568
569                     centered
570                            Center  windows  in this group upon initial place‐
571                            ment instead of using cascaded placement.
572
573
574                     constrain
575                            Constrain windows in this group to the screen.
576
577
578                     desktop:#
579                            The desktop on which windows in this group will be
580                            started.
581
582
583                     drag
584                            Do  not pass mouse events to the window.  Instead,
585                            use the mouse to move/resize the window.
586
587
588                     fixed
589                            Fix windows in this group to their  initial  desk‐
590                            top.   This  causes  the current desktop to change
591                            when the window is activated rather than  the  de‐
592                            fault  behavior of bringing the window to the cur‐
593                            rent desktop.
594
595
596                     fullscreen
597                            Make windows in this group initially fullscreen.
598
599
600                     height:#
601                            Set the initial window height (in pixels).
602
603
604                     hmax
605                            Make windows in this group maximize horizontally.
606
607
608                     icon:string
609                            The icon to be used for windows in this group.
610
611
612                     ilist
613                            Ignore the program-specified list setting for win‐
614                            dows  in  this  group.   If specified with nolist,
615                            windows will not be listed in the task list,  oth‐
616                            erwise windows will be listed.
617
618
619                     iignore
620                            Ignore  the  size  increment  hint when maximizing
621                            windows in this group.
622
623
624                     ipager
625                            Ignore the  program-specified  pager  setting  for
626                            windows in this group.  If specified with nopager,
627                            windows will not be shown in the pager,  otherwise
628                            windows will be shown.
629
630
631                     layer:string
632                            The  layer  on which windows in this group will be
633                            started.  Valid options  are  below,  normal,  and
634                            above
635
636
637                     maximized
638                            Make windows in this group initially maximized.
639
640
641                     minimized
642                            Make windows in this group initially minimized.
643
644
645                     noborder
646                            Causes windows in this group to be displayed with‐
647                            out a border.
648
649
650                     noclose
651                            Prevent windows in this group from being closed.
652
653
654                     nodrag
655                            Disable mod1+drag moving/resizing for  windows  in
656                            this group.
657
658
659                     nofocus
660                            Prevents  windows  in  the group from grabbing the
661                            focus when mapped.
662
663
664                     nofullscreen
665                            Prevent  windows  in   this   group   from   being
666                            fullscreen.
667
668
669                     nolist
670                            Causes  the  tray  to ignore windows in this group
671                            when the window is initially mapped.
672
673
674                     nopager
675                            Causes the pager to ignore windows in this group.
676
677
678                     nomax
679                            Prevent windows in this  group  from  being  maxi‐
680                            mized.
681
682
683                     nomin
684                            Prevent  windows  in  this  group from being mini‐
685                            mized.
686
687
688                     nomove
689                            Prevent windows in this group from being moved.
690
691
692                     noresize
693                            Prevent windows in this group from being resized.
694
695
696                     noshade
697                            Prevent windows in this group from being shaded.
698
699
700                     notitle
701                            Causes windows in this group to be displayed with‐
702                            out a title bar.
703
704
705                     noturgent
706                            Ignore the urgent hint for windows in this group.
707
708
709                     opacity:#
710                            Set  the  opacity  for windows in this group.  The
711                            value is a number between 0.0 and 1.0 inclusive.
712
713
714                     pignore
715                            Ignore initial window position requested  by  pro‐
716                            gram.
717
718
719                     shaded
720                            Make windows in this group initially shaded.
721
722
723                     sticky
724                            Make windows in this group sticky.
725
726
727                     tiled
728                            Attempt to tile windows in this group upon initial
729                            placement.  If tiled placement fails, windows will
730                            fall  back  to cascaded placement (the default) or
731                            centered if specified.
732
733
734                     title
735                            Forces windows in this group to have a title bar.
736
737
738                     vmax
739                            Make windows in this group maximize vertically.
740
741
742                     width:#
743                            Set the initial window width (in pixels).
744
745
746                     x:#
747                            Set the initial x-coordinate of the window.  Nega‐
748                            tive  numbers  indicate that the value is relative
749                            to the right side of the screen.
750
751
752                     y:#
753                            Set the initial y-coordinate of the window.  Nega‐
754                            tive  numbers  indicate that the value is relative
755                            to the bottom of the screen.
756
757
758       WINDOW STYLE
759              The WindowStyle tag controls the look of window  borders.   This
760              tag supports the following attribute:
761
762              decorations
763                     The window decorations to use. Valid options are flat and
764                     motif. flat is the default.
765
766              Within this tag, the following tags are supported:
767
768              Font
769                     The font used for title bars. See the FONTS  section  for
770                     more information.  This tag supports the following attri‐
771                     bute:
772
773                     align
774                            The window title  alignment.   Valid  options  are
775                            left, right, and center.  left is the default.
776
777              Width
778                     The  width of window borders in pixels. The default is 4,
779                     the minimum is 1, and the maximum is 128.
780
781              Height
782                     The height of window title bars  in  pixels.  By  default
783                     this is set to the size of the title font. The minimum is
784                     1, and the maximum is 256.
785
786              Corner
787                     The corner width of the window border for rounded  window
788                     borders.   The  default is 4, the minimum is 0 (rectangu‐
789                     lar), and the maximum is 5 (most rounded).
790
791              Active
792                     The colors/opacity used for the active  window.  See  the
793                     COLORS  section  for more information on colors. The fol‐
794                     lowing tags are supported:
795
796                     Foreground
797                            The color of the text and  buttons  in  the  title
798                            bar.  The default is white.
799
800                     Background
801                            The  color  of  the  title bar (gradients are sup‐
802                            ported).  The default is #CC7700:#884400.
803
804                     Opacity
805                            The opacity of the  window.  This  is  a  floating
806                            point  value  between 0.0 and 1.0.  The default is
807                            1.0.  Note  that  a  composite  manager,  such  as
808                            xcompmgr, is required for this.
809
810                     Outline
811                            The color of the window outline.  The default is a
812                            darkened version of the window background.  If mo‐
813                            tif  window  decorations are specified, two colors
814                            may be given separated by a ':' to  set  the  down
815                            and up colors respectively.
816
817              Foreground
818                     The  color  of text and buttons in the title bar of inac‐
819                     tive windows.  The default is white.
820
821              Background
822                     The color of the title bar (gradients are  supported)  of
823                     inactive windows.  The default is #333333:#111111.
824
825              Opacity
826                     The opacity of inactive windows. This is a floating point
827                     value between 0.0 and 1.0.  The default  is  0.75.   Note
828                     that  a  composite manager, such as xcompmgr, is required
829                     for this.
830
831              Outline
832                     The color of the window  outline  for  inactive  windows.
833                     The  default  is  a  darkened version of the window back‐
834                     ground.  If motif window decorations are  specified,  two
835                     colors  may  be  given separated by a ':' to set the down
836                     and up colors respectively.
837
838       TRAY STYLE
839              The TrayStyle tag controls the look of trays.  The following at‐
840              tributes are supported:
841
842              decorations
843                     The  type of decorations to use for trays.  Possible val‐
844                     ues are flat and motif. The default is flat.
845
846              group
847                     Determines if windows are grouped by class when shown  in
848                     task  bars.   Possible values are true and false. The de‐
849                     fault is false.
850
851              list
852                     Determines which windows are shown in task bars.   Possi‐
853                     ble values are desktop and all. The default is desktop.
854
855              Within this tag the following tags are supported:
856
857              Font
858                     The  default  tray font to use. See the FONTS section for
859                     more information.
860
861              Foreground
862                     The default foreground color. See the COLORS section  for
863                     more information.
864
865              Background
866                     The  default background color. See the COLORS section for
867                     more information.
868
869              Outline
870                     The color of the tray outline. See the COLORS section for
871                     more  information.   The default is a darkened version of
872                     the tray background.  If motif tray decorations are spec‐
873                     ified, this may be given as two colors separated by a ':'
874                     to indicate the down and up colors respectively.
875
876              Opacity
877                     The opacity of trays. This is a floating point value  be‐
878                     tween  0.0  and 1.0.  Note that a composite manager, such
879                     as xcompmgr, is required for this.
880
881              Active
882                     The default colors for active items on the tray.  See the
883                     COLORS  section for more information.  The following tags
884                     are supported:
885
886                     Foreground
887                            The default foreground color for active items.
888
889                     Background
890                            The default background color for active items.
891
892                     Outline
893                            The default outline color for  active  items.  See
894                            the  COLORS section for more information.  The de‐
895                            fault is a darkened version of the background.  If
896                            motif  tray decorations are specified, this may be
897                            given as two colors separated by a ':' to indicate
898                            the down and up colors respectively.
899
900       TASK LIST STYLE
901              The TaskListStyle tag controls the look of task lists.  The fol‐
902              lowing attribute is supported:
903
904              decorations
905                     The window decorations to use. Valid options are flat and
906                     motif. The default is inherited from TrayStyle.
907
908              Within this tag the following tags are supported:
909
910              Font
911                     The  font to use. See the FONTS section for more informa‐
912                     tion.
913
914              Foreground
915                     The foreground color. See the COLORS section for more in‐
916                     formation.
917
918              Background
919                     The background color. See the COLORS section for more in‐
920                     formation.
921
922              Outline
923                     The color of the button outline. See the  COLORS  section
924                     for  more information.  The default is a darkened version
925                     of the background.  If motif tray decorations are  speci‐
926                     fied,  this may be given as two colors separated by a ':'
927                     to indicate the down and up colors respectively.
928
929              Active
930                     The colors for the active items.  See the COLORS  section
931                     for more information.  The following tags are supported:
932
933                     Foreground
934                            The foreground color for active items.
935
936                     Background
937                            The background color for active items.
938
939                     Outline
940                            The outline color for active items. See the COLORS
941                            section for more information.  The  default  is  a
942                            darkened version of the background.  If motif tray
943                            decorations are specified, this may  be  given  as
944                            two colors separated by a ':' to indicate the down
945                            and up colors respectively.
946
947       TRAY BUTTON STYLE
948              The TrayButtonStyle tag controls the look of tray buttons.
949
950              Within this tag the following tags are supported:
951
952              Font
953                     The font to use. See the FONTS section for more  informa‐
954                     tion.
955
956              Foreground
957                     The foreground color. See the COLORS section for more in‐
958                     formation.
959
960              Background
961                     The background color. See the COLORS section for more in‐
962                     formation.
963
964              Outline
965                     The  color  of the button outline. See the COLORS section
966                     for more information.  The default is a darkened  version
967                     of  the background.  If motif tray decorations are speci‐
968                     fied, this may be given as two colors separated by a  ':'
969                     to indicate the down and up colors respectively.
970
971              Active
972                     The  colors  for pressed buttons.  See the COLORS section
973                     for more information.  The following tags are supported:
974
975                     Foreground
976                            The foreground color for pressed buttons.
977
978                     Background
979                            The background color for pressed buttons.
980
981                     Outline
982                            The outline color for  pressed  buttons.  See  the
983                            COLORS  section for more information.  The default
984                            is a darkened version of the background.  If motif
985                            tray  decorations are specified, this may be given
986                            as two colors separated by a ':' to  indicate  the
987                            down and up colors respectively.
988
989       PAGER STYLE
990              The  PagerStyle  tag  controls  the look of pagers.  Within this
991              tag, the following tags are supported:
992
993              Outline
994                     The color of the outline  around  windows  shown  in  the
995                     pager. See the COLORS section for more information.
996
997              Foreground
998                     The color of inactive windows shown in the pager. See the
999                     COLORS section for more information.
1000
1001              Background
1002                     The background color of inactive desktops  shown  in  the
1003                     pager. See the COLORS section for more information.
1004
1005              Active
1006                     The  colors  used for active items in the pager.  See the
1007                     COLORS section for more information.  The following  tags
1008                     are supported:
1009
1010                     Foreground
1011                            The color of active windows shown in the pager.
1012
1013                     Background
1014                            The  background  color of active desktops shown in
1015                            the pager.
1016
1017              Text
1018                     The color to use for pager labels. See the COLORS section
1019                     for more information.
1020
1021              Font
1022                     The  font to use for pager labels. See the COLORS section
1023                     for more information.
1024
1025       CLOCK STYLE
1026              The ClockStyle tag controls the look  of  clocks.   Within  this
1027              tag, the following tags are supported:
1028
1029              Font
1030                     The  font  to  use for clocks.  This defaults to the tray
1031                     font.  See the COLORS section for more information.
1032              Foreground
1033                     The foreground (text) color of clocks.  This defaults  to
1034                     the  tray  foreground  color.  See the COLORS section for
1035                     more information.
1036              Background
1037                     The background color of clocks (gradients are supported).
1038                     This defaults to the tray background color.  See the COL‐
1039                     ORS section for more information.
1040
1041       MENU STYLE
1042              The MenuStyle tag controls the look of the menus  in  JWM  (this
1043              includes  the root menu and window menus).  The following attri‐
1044              bute is supported:
1045
1046              decorations
1047                     The type of decorations to use for menus.  Possible  val‐
1048                     ues are flat and motif. The default is flat.
1049              Within this tag the following tags are supported:
1050
1051              Font
1052                     The font used on menus See the FONTS section for more in‐
1053                     formation.
1054
1055              Foreground
1056                     The text color of inactive menu  items.  See  the  COLORS
1057                     section for more information.
1058
1059              Background
1060                     The background color of inactive menu items. See the COL‐
1061                     ORSsection for more information.
1062
1063              Outline
1064                     The color of the menu outline. See the COLORS section for
1065                     more  information.   The default is a darkened version of
1066                     the menu background.  If motif decorations are used, this
1067                     may be given as two colors separated by a ':' to indicate
1068                     the down and up colors respectively.
1069
1070              Active
1071
1072                     The colors used for active menu items.   See  the  COLORS
1073                     section  for  more  information.   The following tags are
1074                     supported:
1075
1076                     Foreground
1077                            The text color of active menu items.
1078
1079                     Background
1080                            Text background color of active menu items (gradi‐
1081                            ents are supported).
1082
1083              Opacity
1084                     The  opacity of menus. This is a floating point value be‐
1085                     tween 0.0 and 1.0.  Note that a composite  manager,  such
1086                     as xcompmgr, is required for this.
1087
1088       POPUP STYLE
1089              The  PopupStyle  tag  controls the look of popup windows such as
1090              those shown when the mouse sits over a task list item.  This tag
1091              supports the following attributes:
1092
1093              delay int
1094                     The  delay  in  milliseconds before popups activate.  The
1095                     default is 600.
1096
1097              enabled string
1098                     Determine if popups are shown. This is a  comma-separated
1099                     list of one or more of the following: true (all enabled),
1100                     false (no popups enabled), button (tray  buttons),  clock
1101                     (clocks),  menu  (menus),  pager (pagers), and task (task
1102                     list items).  The default is true.
1103
1104              Within this tag the following tags are supported:
1105
1106              Font
1107                     The font to use. See the FONTS section for more  informa‐
1108                     tion.
1109
1110              Outline
1111                     The  color  of the window outline. See the COLORS section
1112                     for more information.  The default is black.
1113
1114              Foreground
1115                     The text color. See the COLORS section for more  informa‐
1116                     tion.
1117
1118              Background
1119                     The background color. See the COLORS section for more in‐
1120                     formation.
1121
1122       FONTS
1123              Fonts for various parts of JWM are specified within a Font  tag.
1124              The  text  of  this tag determines the font to use.  This can be
1125              either a standard X font string or, if compiled  with  XFT  sup‐
1126              port, an XFT font string.
1127
1128       COLORS
1129              Colors  for  various  parts of JWM are specified within specific
1130              tags (described above). Colors may either be hex triplets in RGB
1131              format  (for example, #FF0000 is red) or by a name recognized by
1132              the X server.  For components that support gradients, two colors
1133              may be specified separated by a colon.
1134
1135       ICONS
1136              Icons for windows that don't supply an icon via the _NET_WM_ICON
1137              hint are located by searching the icon  search  path(s)  for  an
1138              icon  whose  name (minus the ".xpm" or ".png" extension) matches
1139              the instance name of the window  as  returned  in  the  WM_CLASS
1140              hint.  If  this  lookup  fails, a default icon is supplied. This
1141              icon will be displayed for the window on it's title bar  and  on
1142              the  task  list.  Icons that are not an appropriate size will be
1143              scaled. Square icons work best.
1144
1145              For menu items, the icon path is searched for a match. the  icon
1146              specified  for  a  menu  item must be the exact name of the icon
1147              file with the extension.  If no match is  found,  a  blank  area
1148              will  appear  where  the  icon should appear.  If an icon is not
1149              specified for any menu item in a menu, no space  will  be  allo‐
1150              cated for icons.
1151
1152              Zero  or  more  IconPath tags may be specified. The text of this
1153              tag is assumed to be an absolute directory path to  a  directory
1154              containing  XPM,  PNG,  and/or  JPEG  icons.  When searching for
1155              icons, if multiple paths are provided, they will be searched  in
1156              order until a match is made.  Note that icon, PNG, JPEG, and XPM
1157              support are compile-time options.
1158
1159       KEY BINDINGS
1160              Keyboard bindings in JWM are specified in Key tags.  Either  the
1161              key  or  keycode attributes must be specified to determine which
1162              key will cause an action. The optional attribute,  mask,  speci‐
1163              fies what key mask, if any, must be in effect for the binding to
1164              match. Finally, the text of the Key tag is the  action  to  per‐
1165              form.
1166
1167              One or more of the following key masks may be specified for mask
1168              (see xmodmap(1)):
1169
1170                     A      The "Alt" key (mod1).
1171
1172                     C      Control
1173
1174                     S      Shift
1175
1176                     1      mod1
1177
1178                     2      mod2
1179
1180                     3      mod3
1181
1182                     4      mod4
1183
1184                     5      mod5
1185
1186              The key specified in the key attribute must contain a valid  key
1187              string for XStringToKeysym(3). These values are usually what one
1188              would expect (for example, the escape key is called "Escape").
1189
1190              Valid actions for a key binding are:
1191
1192                     up     Move up.
1193
1194                     down   Move down.
1195
1196                     right  Move right.
1197
1198                     left   Move left.
1199
1200                     escape Stop a move/resize, exit a menu, or cancel an  ac‐
1201                            tion.
1202
1203                     fullscreen
1204                            Toggle between fullscreen and not fullscreen.
1205
1206                     select Make a menu selection or confirm an action.
1207
1208                     next   Move to the next window in the task list.
1209
1210                     nextstacked
1211                            Move to the next window in the stacking order.
1212
1213                     prev   Move to the previous window in the task list.
1214
1215                     prevstacked
1216                            Move to the previous window in the stacking order.
1217
1218                     close  Close the active window.
1219
1220                     minimize
1221                            Minimize the active window.
1222
1223                     maximize
1224                            Maximize the active window.
1225
1226                     maxv   Maximize the active window vertically.
1227
1228                     maxh   Maximize the active window horizontally.
1229
1230                     maxtop Maximize  the  active  window  to  the  top of the
1231                            screen.
1232
1233                     maxbottom
1234                            Maximize the active window to the  bottom  of  the
1235                            screen.
1236
1237                     maxleft
1238                            Maximize  the  active  window  to  the left of the
1239                            screen.
1240
1241                     maxright
1242                            Maximize the active window to  the  right  of  the
1243                            screen.
1244
1245                     restore
1246                            Restore a maximized window.
1247
1248                     sendl  Send the active window left.
1249
1250                     sendr  Send the active window right.
1251
1252                     sendu  Send the active window up.
1253
1254                     sendd  Send the active window down.
1255
1256                     shade  Shade the active window.
1257
1258                     stick  Stick/unstick the active window.
1259
1260                     move   Move the active window.
1261
1262                     resize Resize the active window.
1263
1264                     root:n Show root menu n.
1265
1266                     window Show the window menu for the active window.
1267
1268                     desktop#
1269                            Switch  to  a  specific  desktop. To use this, "#"
1270                            must be specified in the key section. The number 1
1271                            to the number of desktops configured are then sub‐
1272                            stituted for "#".
1273
1274                     rdesktop
1275                            Move one desktop to the right.
1276
1277                     ldesktop
1278                            Move one desktop to the left.
1279
1280                     udesktop
1281                            Move up one desktop.
1282
1283                     ddesktop
1284                            Move down one desktop.
1285
1286                     showdesktop
1287                            Show/hide the desktop (maximize/minimize all  win‐
1288                            dows).
1289
1290                     showtray
1291                            Unhide the tray (when using autohide).
1292
1293                     exec:command
1294                            Execute command.
1295
1296                     restart
1297                            Restart JWM.
1298
1299              Note  that there are no default key bindings.  It is possible to
1300              bind multiple key combinations to the same action.
1301
1302       MOUSE BINDINGS
1303              Any button other than the scroll wheel (buttons 4 and 5) on  the
1304              root  window will bring up the root menu unless otherwise speci‐
1305              fied via the onroot attribute of RootMenu. Scrolling up  on  the
1306              root  window  switches  to  the  left desktop and scrolling down
1307              switches to the right desktop.
1308
1309              Button 1 (typically the left button):
1310                     Over the border, dragging resizes the window.   Over  the
1311                     title  bar, dragging moves the window and double clicking
1312                     toggles the maximized state.  Over the window while hold‐
1313                     ing the appropriate modifier key, dragging moves the win‐
1314                     dow.  Over the menu  button,  clicking  shows  the  menu.
1315                     Over  the minimize button, clicking minimizes the window.
1316                     Over the maximize button, clicking toggles between  maxi‐
1317                     mized and normal.  Over the close button, clicking closes
1318                     the window.  Over a task bar, restores or  minimizes  the
1319                     window.  Over a pager, switches the active desktop.
1320
1321              Button 2 (typically the middle button):
1322                     Over the maximize button, clicking toggles between verti‐
1323                     cally maximized and normal.  Anywhere else  on  a  window
1324                     frame, dragging while holding button 2 will move the win‐
1325                     dow.  Over a pager, switches the active desktop.
1326
1327              Button 3 (typically the right button):
1328                     Over the frame, clicking shows the window menu.   On  the
1329                     minimize  button, clicking toggles between shaded and un‐
1330                     shaded.  On the maximize button, clicking toggles between
1331                     horizontally  maximized and normal.  On the close button,
1332                     clicking closes the window.  Over a task bar,  shows  the
1333                     window menu.  Over a pager, dragging while holding button
1334                     3 will move a window.
1335
1336              Scrolling up over the  title  bar  will  shade  the  window  and
1337              scrolling  down  will  unshade the window.  When a menu is open,
1338              the scroll wheel will move through menu items.   When  over  the
1339              pager,  the scroll wheel will switch desktops.  When over a task
1340              list, the scroll wheel will switch windows.
1341
1342       DESKTOPS
1343              Virtual desktops are controlled with the Desktops  tag.   Within
1344              this tag the following attribute is supported:
1345
1346              width int
1347                     The  number  of virtual desktops in the horizontal direc‐
1348                     tion.  The default is 4.
1349
1350              height int
1351                     The number of virtual desktops in the vertical direction.
1352                     The default is 1.
1353
1354              Within the Desktops tag the following tags are supported:
1355
1356              Background
1357                     The  default  background for desktops. The type attribute
1358                     determines the type of background and the text  contained
1359                     within this tag is the value. Valid types are:
1360
1361                     solid
1362                            A solid color. See the COLORS section for more in‐
1363                            formation.  This is the default.
1364                     gradient
1365                            A gradient color. See the COLORS section for  more
1366                            information.
1367                     image
1368                            A  stretched  image.  This  may be an XPM, PNG, or
1369                            JPEG image. Note that support for  XPM,  PNG,  and
1370                            JPEG  images  must be compiled in and icon support
1371                            is required.
1372                     tile
1373                            A tiled image. Like image, but the image is  tiled
1374                            instead of stretched.
1375                     scale
1376                            A  scaled  image. Like image, but the aspect ratio
1377                            of the image is preserved.
1378                     command
1379                            A command to run for setting the background.
1380
1381              Desktop
1382                     Desktop-specific data. The name attribute may  be  speci‐
1383                     fied to name the desktop (the default is the desktop num‐
1384                     ber). Within this tag a Background tag may  be  specified
1385                     for  a desktop-specific background.  See Background above
1386                     for more information.
1387
1388       OTHER SETTINGS
1389
1390              The following tags may also be supplied:
1391
1392              ButtonClose
1393                     An icon to display for the close button on client windows
1394                     instead of the default.
1395              ButtonMax
1396                     An icon to display for the maximize button on client win‐
1397                     dows instead of the default.
1398              ButtonMaxActive
1399                     An icon to display for the maximize button  on  maximized
1400                     client windows instead of the default.
1401              ButtonMenu
1402                     An  icon to display for the menu button on client windows
1403                     instead of the default. This is used for  client  windows
1404                     that do not specify an icon.
1405              ButtonMin
1406                     An icon to display for the minimize button on client win‐
1407                     dows instead of the default.
1408              DefaultIcon
1409                     An icon to display for windows that  do  not  specify  an
1410                     icon.
1411              DoubleClickDelta
1412                     The  number  of pixels the mouse can move during a double
1413                     click.  The default is 2. Valid values are between 0  and
1414                     32 inclusive.
1415
1416              DoubleClickSpeed
1417                     The  maximum  number of milliseconds between clicks for a
1418                     double click.  The default is 400. Valid values  are  be‐
1419                     tween 1 and 2000 inclusive.
1420
1421              FocusModel
1422                     The  focus  model  to  be  used. The default is "sloppy".
1423                     Valid values are:
1424
1425                     click
1426                            Click to focus and raise.
1427
1428                     clicktitle
1429                            Click to focus. Click the title bar to raise.
1430
1431                     sloppy
1432                            Focus follows mouse. Click to raise.
1433
1434                     sloppytitle
1435                            Focus follows mouse. Click the title bar to raise.
1436
1437              MoveMode
1438                     The move mode. The default is "opaque". Valid values  are
1439                     "opaque"  and "outline".  This tag supports the following
1440                     attributes:
1441
1442                     coordinates { off | corner | window | screen }
1443                            The location of the status window. The default  is
1444                            screen.
1445
1446                     delay int
1447                            The  delay  in milliseconds before moving a window
1448                            to a different desktop.  Setting this  to  0  dis‐
1449                            ables  dragging windows between desktops.  The de‐
1450                            fault is 1000.
1451
1452                     mask string
1453                            The key mask of the modifier that, when held,  al‐
1454                            lows  one  to move the window by dragging it.  The
1455                            default is "A".
1456
1457              ResizeMode
1458                     The resize mode. The default is  "opaque".  Valid  values
1459                     are  "opaque" and "outline". The optional coordinates at‐
1460                     tribute determines the location of the move  status  win‐
1461                     dow. Possible values are: This tag supports the following
1462                     attribute:
1463
1464                     coordinates { off | corner | window | screen }
1465                            The location of the status window. The default  is
1466                            screen.
1467
1468              SnapMode
1469                     The  snap mode. The default is "border". Valid values are
1470                     "none" (for no snapping), "screen" (for snapping  to  the
1471                     edge  of  the  screen), and "border" (for snapping to the
1472                     borders of windows and the screen).  An  optional  attri‐
1473                     bute,  distance, specifies the distance for snapping. The
1474                     default is 5. Valid values are between 1  and  32  inclu‐
1475                     sive.
1476
1477              StartupCommand
1478                     A command to run when JWM starts.
1479
1480              ShutdownCommand
1481                     A command to run when JWM exits.
1482
1483              RestartCommand
1484                     A command to run when JWM restarts.
1485

AUTHOR

1487       Joe Wingbermuehle <joewing@joewing.net>
1488
1489

SEE ALSO

1491       X(1)
1492
1493
1494
1495
1496v2.3.7                            2022-01-20                            jwm(1)
Impressum