1jwm(1) General Commands Manual jwm(1)
2
3
4
6 JWM - Joe's Window Manager
7
8
10 jwm [options]
11
13 JWM is a window manager for the X11 Window System.
14
15
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
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
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
1487 Joe Wingbermuehle <joewing@joewing.net>
1488
1489
1491 X(1)
1492
1493
1494
1495
1496v2.3.7 2021-07-22 jwm(1)