1jwm(1) General Commands Manual jwm(1)
2
6 JWM - Joe's Window Manager
7
10 jwm [options]
11
13 JWM is a window manager for the X11 Window System.
14
17 -display display
18 This option specifies the display to use; see X(1).
19 -exit
21 Exit JWM by sending _JWM_EXIT to the root window.
22 -f file
24 Specify an alternate configuration file to use.
25 -h
27 Display a help message and exit.
28 -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 -restart
35 Restart JWM by sending _JWM_RESTART to the root window.
36 -reload
38 Reload menus by sending _JWM_RELOAD to the root window.
39 -v
41 Display version information and exit.
42
45 /etc/system.jwmrc
46 The default JWM configuration file.
47 ~/.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
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 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 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 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 labeled bool
85 Determines if a label appears at the top of the menu. De‐
86 fault is false.
87 label string
89 The label to display at the top of the menu. Default is
90 "JWM".
91 dynamic string
93 A dynamically loaded menu. If the text starts with exec:,
94 the output of the specified program is used.
95 Within the RootMenu tag, the following tags are supported:
97 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 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 label string
110 The label to use. No default.
111 tooltip string
113 A tooltip to display. No default.
114 icon string
116 The icon to use for this menu. No default.
117 labeled bool
119 Determines if a label appears at the top of the
120 menu. Default is false.
121 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. A timeout
128 attribute may be specified to set a timeout in millisec‐
129 onds. The default timeout is 5000 milliseconds (5 sec‐
130 onds).
131 Include
133 Include the contents of a file into the menu structure.
134 The file must start with a "JWM" tag. The file is speci‐
135 fied by the text of the tag. If the text starts with
136 "exec:" then the output of a program is used. A timeout
137 attribute may be specified to set a timeout in millisec‐
138 onds. The default timeout is 5000 milliseconds (5 sec‐
139 onds).
140 Program
142 The Program tag provides a way to start an external pro‐
143 gram. The text in this tag is the command used to start
144 the program. The following attributes are supported:
145 label string
147 The label to display. Default is the text of the
148 tag.
149 tooltip string
151 A tooltip to display. No default.
152 icon string
154 The icon to use. No default.
155 Separator
157 This tag simply puts a line in the menu allowing menu di‐
158 visions. No text or attributes are used.
159 Desktops
161 Add a desktop menu. This will add a submenu with a list
162 of desktops that can be used to change the current desk‐
163 top. The following attributes are supported:
164 label string
166 The label to use for the menu. The default is
167 "Desktops".
168 tooltip string
170 A tooltip to display. No default.
171 icon string
173 The icon to use for this item. No default.
174 SendTo
176 Add a "send to" menu to the menu. After selecting an item
177 from this menu, a window may be selected to send that
178 window to the selected desktop. The following attributes
179 are supported:
180 label string
182 The label to use. The default is "SendTo".
183 tooltip string
185 A tooltip to display. No default.
186 icon string
188 The icon to use for this item. No default.
189 Stick
191 Add a stick/unstick window operation to the menu. After
192 selecting this item a window may be selected to toggle
193 the sticky state of that window. The following at‐
194 tributes are supported:
195 label string
197 The label to use. The default is "Stick".
198 tooltip string
200 A tooltip to display. No default.
201 icon string
203 The icon to use for this item. No default.
204 Maximize
206 Add a maximize window operation to the menu. After se‐
207 lecting this item a window may be selected to toggle the
208 maximized state of that window. The following attributes
209 are supported:
210 label string
212 The label to use. The default is "Maximize".
213 tooltip string
215 A tooltip to display. No default.
216 icon string
218 The icon to use for this item. No default.
219 Minimize
221 Add a minimize window operation to the menu. After se‐
222 lecting this item a window may be selected to minimize
223 that window. The following attributes are supported:
224 label string
226 The label to use. The default is "Minimize".
227 tooltip string
229 A tooltip to display. No default.
230 icon string
232 The icon to use for this item. No default.
233 Shade
235 Add a shade/unshade window operation to the menu. After
236 selecting this item a window may be selected to toggle
237 the shaded status of that window. The following at‐
238 tributes are supported:
239 label string
241 The label to use. The default is "Shade".
242 tooltip string
244 A tooltip to display. No default.
245 icon string
247 The icon to use for this item. No default.
248 Move
250 Add a move window operation to the menu. After selecting
251 this item a window may be selected to move that window.
252 The following attributes are supported:
253 label string
255 The label to use. The default is "Move".
256 tooltip string
258 A tooltip to display. No default.
259 icon string
261 The icon to use for this item. No default.
262 Resize
264 Add a resize window operation to the menu. After select‐
265 ing this item a window may be selected to resize that
266 window. The following attributes are supported:
267 label string
269 The label to use. The default is "Resize".
270 tooltip string
272 A tooltip to display. No default.
273 icon string
275 The icon to use for this item. No default.
276 Kill
278 Add a kill window operation to the menu. After selecting
279 this item a window may be selected to kill that window.
280 The following attributes are supported:
281 label string
283 The label to use. The default is "Kill".
284 tooltip string
286 A tooltip to display. No default.
287 icon string
289 The icon to use for this item. No default.
290 Close
292 Add a close window operation to the menu. After selecting
293 this item a window may be selected to close that window.
294 The following attributes are supported:
295 label string
297 The label to use. The default is "Close".
298 tooltip string
300 A tooltip to display. No default.
301 icon string
303 The icon to use for this item. No default.
304 Restart
306 This tag adds a menu item to restart the window manager.
307 The following attributes are supported:
308 label string
310 The label to use. The default is "Restart".
311 tooltip string
313 A tooltip to display. No default.
314 icon string
316 The icon to use. No default.
317 Exit
319 This tag adds a menu item to exit the window manager. If
320 text is present within this tag, it is interpreted as a
321 command to run when JWM exits. This can be used to start
322 another window manager. The following attributes are
323 supported:
324 label string
326 The label to use. The default is "Exit".
327 tooltip string
329 A tooltip to display. No default.
330 icon string
332 The icon to use. No default.
333 confirm bool
335 Determine if a confirm dialog appears before exit‐
336 ing. Default is true.
337 Note that confirm dialogs can be disabled completely at
339 the compile-time.
340 TRAYS
342 One or more trays may be created via the Tray tag. This tag
343 supports the following attributes:
344 autohide string
346 Specifies the location to hide the tray when not acti‐
347 vated. Default is "off" to disable hiding. Possible val‐
348 ues are "left", "right", "top", "bottom", "off", "on"
349 (JWM picks the location), and "invisible" (trays must be
350 activated by a key binding).
351 delay int
353 The delay before hiding the tray in milliseconds. Default
354 is 0 milliseconds.
355 x int
357 The x-coordinate of the tray. This may be negative to in‐
358 dicate an offset from the right of the screen.
359 y int
361 The y-coordinate of the tray. This may be negative to in‐
362 dicate an offset from the bottom of the screen.
363 width int
365 The width of the tray. 0 indicates that the tray should
366 compute an optimal width depending on what it contains
367 and the layout. A negative value subtracts from with
368 screen width. 0 is the default.
369 height int
371 The height of the tray. 0 indicates that the tray should
372 compute an optimal height depending on what it contains
373 and the layout. A negative value subtracts from the
374 screen height. 0 is the default.
375 screen int
377 The index of the screen on which to start the tray. 0 is
378 the default (the primary screen).
379 layer { below | normal | above }
381 The layer of the tray. The default is above.
382 layout { vertical | horizontal }
384 The layout of the tray. The default is horizontal.
385 valign { fixed | top | center | bottom }
387 The vertical alignment of the tray. The default is fixed.
388 halign { fixed | left | center | right }
390 The horizontal alignment of the tray. The default is
391 fixed.
392 Within this tag the following tags are supported:
394 Clock
396 Add a clock to the tray. The text of this tag determines
397 what action to take when the clock is clicked. Option‐
398 ally, one or more Button tags may be specified to bind
399 actions to specific mouse buttons specified via the mask
400 attribute. By default, the button mask is "123". The
401 following actions are supported:
402 root:n
404 Show root menu n. Note that the default TrayBut‐
405 ton action is root:1.
406 exec: string
408 Execute a command.
409 showdesktop
411 Minimize all windows on the current desktop.
412 This tag supports the following attributes:
414 format string
416 The format of the clock. See strftime(3).
417 zone string
419 The time zone of the clock. See tzset(3).
420 width int
422 The width of the clock. 0 indicates that the width
423 should be determined from the length of the text
424 to be displayed.
425 height int
427 The height of the clock. 0 indicates that the
428 height should be determined from the font used.
429 Dock
431 Add a dock for system notifications. This can be used by
432 those programs that use the _NET_SYSTEM_TRAY_Sn selec‐
433 tion. The size of the Dock is dynamic based on the size
434 of the tray and the number of items contained. Only one
435 Dock is allowed per instance of JWM. This tag supports
436 the following attributes:
437 width int
439 The maximum width of an item contained in the
440 dock. This defaults to the width or height of the
441 tray (whichever is smaller).
442 spacing int
444 The spacing of items contained in the dock (in
445 pixels). This defaults to 0.
446 Pager
448 Add a pager to the tray. A pager shows a miniature rep‐
449 resentation of a desktop. When over the pager, the
450 scroll wheel will switch desktops. Holding down the
451 right mouse button allows you to drag a window around in
452 the pager which changes its position on the real desktop.
453 You can also drag a window in the pager from one desktop
454 to another. This tag supports the following attributes:
455 labeled bool
457 Determines if the pager has text labels. Default
458 is false.
459 Also see the PAGER STYLE section for more information.
461 Spacer
463 Add empty space to the tray. This tag supports the fol‐
464 lowing attributes:
465 width int
467 The width of the spacer (0 to fill all available
468 space). 0 is the default.
469 height int
471 The height of the spacer (0 to fill all available
472 space). 0 is the default.
473 Swallow
475 Swallow a program into the tray. The text of this tag
476 gives the command to run. This tag supports the follow‐
477 ing attributes:
478 name string
480 The name of the program to swallow. This attribute
481 is required.
482 width int
484 The width of the swallowed program. 0 indicates
485 that the width should be determined from the tray
486 and size requested from the program. 0 is the de‐
487 fault.
488 height int
490 The height of the swallowed program. 0 indicates
491 that the height should be determined from the tray
492 and the size requested from the program. 0 is the
493 default.
494 TaskList
496 Add a task list to the tray. This tag supports the fol‐
497 lowing attributes:
498 height int
500 The height of an item in the task list. 0 indi‐
501 cates that the height should be taken from the
502 tray. The default is 0.
503 labeled bool
505 Determines if a label is shown for items in the
506 task list. The default is true.
507 maxwidth int
509 The maximum width of an item in the task list. 0
510 indicates no maximum. The default is 0.
511 TrayButton
513 Add a button to the tray. The text of this tag determines
514 what action to take when the button is clicked. Option‐
515 ally, one or more Button tags may be specified to bind
516 actions to specific mouse buttons specified via the mask
517 attribute. By default, the button mask is "123". The
518 following actions are supported:
519 root:n
521 Show root menu n. Note that the default TrayBut‐
522 ton action is root:1.
523 exec: string
525 Execute a command.
526 showdesktop
528 Minimize all windows on the current desktop.
529 This tag supports the following attributes:
531 label string
533 A label to display. No default.
534 popup string
536 A string to be displayed for a popup. This will
537 default to the value specified for label, if pro‐
538 vided. If neither popup nor label are specified no
539 popup will be shown.
540 icon string
542 An icon to display. No default.
543 INCLUDES
545 Other configuration files or the output of programs may be in‐
546 cluded under the JWM tag via the Include tag. The text of this
547 tag specifies the location of an additional configuration file
548 or program. The path may be relative to the location JWM was
549 started, an absolute path, or a path referencing an environment
550 variable (using '$'). If the text starts with "exec:", the
551 specified program is executed and its output is used. The for‐
552 mat of the configuration file or program output is the same as
553 the main configuration file.
554 GROUP SETTINGS
556 Program groups allow one to specify options which apply to a
557 group of programs by name, class, window type and machine. A
558 program group is created with the Group tag. As many program
559 groups can be created as desired. If one or more Name tags is
560 specified, at least one name must match. Likewise, if one or
561 more Class tags is specified, at least one class must match.
562 JWM matches using extended POSIX regular expressions for both
563 Name and Class tags. See regex(7). Within the Group tag the
564 following tags are supported:
565 Name
567 The window name of a program to match to be in this group
568 (the first string in WM_CLASS).
569 Class
570 The window class for a program to match to be in this
571 group (the second string in WM_CLASS).
572 Type
573 The window type for a program to match to be in this
574 group. Possible values are desktop, dialog, dock, menu,
575 normal, notification, splash, toolbar, utility.
576 Machine
577 The machine on which a program runs to match to be in
578 this group. (the string WM_CLIENT_MACHINE)
579 Option
580 An option for this group. Possible options are:
581 aerosnap
584 Enable auto-maximization when a window is dragged
585 to the corner of the screen.
586 border
589 Causes windows in this group to have a border.
590 centered
593 Center windows in this group upon initial place‐
594 ment instead of using cascaded placement.
595 constrain
598 Constrain windows in this group to the screen.
599 desktop:#
602 The desktop on which windows in this group will be
603 started.
604 drag
607 Do not pass mouse events to the window. Instead,
608 use the mouse to move/resize the window.
609 fixed
612 Fix windows in this group to their initial desk‐
613 top. This causes the current desktop to change
614 when the window is activated rather than the de‐
615 fault behavior of bringing the window to the cur‐
616 rent desktop.
617 fullscreen
620 Make windows in this group initially fullscreen.
621 height:#
624 Set the initial window height (in pixels).
625 hmax
628 Make windows in this group maximize horizontally.
629 icon:string
632 The icon to be used for windows in this group.
633 ilist
636 Ignore the program-specified list setting for win‐
637 dows in this group. If specified with nolist,
638 windows will not be listed in the task list, oth‐
639 erwise windows will be listed.
640 iignore
643 Ignore the size increment hint when maximizing
644 windows in this group.
645 ipager
648 Ignore the program-specified pager setting for
649 windows in this group. If specified with nopager,
650 windows will not be shown in the pager, otherwise
651 windows will be shown.
652 layer:string
655 The layer on which windows in this group will be
656 started. Valid options are below, normal, and
657 above
658 maximized
661 Make windows in this group initially maximized.
662 minimized
665 Make windows in this group initially minimized.
666 noborder
669 Causes windows in this group to be displayed with‐
670 out a border.
671 noclose
674 Prevent windows in this group from being closed.
675 nodrag
678 Disable mod1+drag moving/resizing for windows in
679 this group.
680 nofocus
683 Prevents windows in the group from grabbing the
684 focus when mapped.
685 nofullscreen
688 Prevent windows in this group from being
689 fullscreen.
690 nolist
693 Causes the tray to ignore windows in this group
694 when the window is initially mapped.
695 nopager
698 Causes the pager to ignore windows in this group.
699 nomax
702 Prevent windows in this group from being maxi‐
703 mized.
704 nomaxborder
707 Do not show a border on maximized windows in this
708 group.
709 nomaxtitle
712 Do not show a title bar on maximized windows in
713 this group.
714 nomin
717 Prevent windows in this group from being mini‐
718 mized.
719 nomove
722 Prevent windows in this group from being moved.
723 noresize
726 Prevent windows in this group from being resized.
727 noshade
730 Prevent windows in this group from being shaded.
731 notitle
734 Causes windows in this group to be displayed with‐
735 out a title bar.
736 noturgent
739 Ignore the urgent hint for windows in this group.
740 opacity:#
743 Set the opacity for windows in this group. The
744 value is a number between 0.0 and 1.0 inclusive.
745 pignore
748 Ignore initial window position requested by pro‐
749 gram.
750 shaded
753 Make windows in this group initially shaded.
754 sticky
757 Make windows in this group sticky.
758 tiled
761 Attempt to tile windows in this group upon initial
762 placement. If tiled placement fails, windows will
763 fall back to cascaded placement (the default) or
764 centered if specified.
765 title
768 Forces windows in this group to have a title bar.
769 vmax
772 Make windows in this group maximize vertically.
773 width:#
776 Set the initial window width (in pixels).
777 x:#
780 Set the initial x-coordinate of the window. Nega‐
781 tive numbers indicate that the value is relative
782 to the right side of the screen.
783 y:#
786 Set the initial y-coordinate of the window. Nega‐
787 tive numbers indicate that the value is relative
788 to the bottom of the screen.
789 WINDOW STYLE
792 The WindowStyle tag controls the look of window borders. This
793 tag supports the following attribute:
794 decorations
796 The window decorations to use. Valid options are flat and
797 motif. flat is the default.
798 Within this tag, the following tags are supported:
800 Font
802 The font used for title bars. See the FONTS section for
803 more information. This tag supports the following attri‐
804 bute:
805 align
807 The window title alignment. Valid options are
808 left, right, and center. left is the default.
809 Width
811 The width of window borders in pixels. The default is 4,
812 the minimum is 1, and the maximum is 128.
813 Height
815 The height of window title bars in pixels. By default
816 this is set to the size of the title font. The minimum is
817 1, and the maximum is 256.
818 Corner
820 The corner width of the window border for rounded window
821 borders. The default is 4, the minimum is 0 (rectangu‐
822 lar), and the maximum is 5 (most rounded).
823 Active
825 The colors/opacity used for the active window. See the
826 COLORS section for more information on colors. The fol‐
827 lowing tags are supported:
828 Foreground
830 The color of the text and buttons in the title
831 bar. The default is white.
832 Background
834 The color of the title bar (gradients are sup‐
835 ported). The default is #CC7700:#884400.
836 Opacity
838 The opacity of the window. This is a floating
839 point value between 0.0 and 1.0. The default is
840 1.0. Note that a composite manager, such as
841 xcompmgr, is required for this.
842 Outline
844 The color of the window outline. The default is a
845 darkened version of the window background. If mo‐
846 tif window decorations are specified, two colors
847 may be given separated by a ':' to set the down
848 and up colors respectively.
849 Foreground
851 The color of text and buttons in the title bar of inac‐
852 tive windows. The default is white.
853 Background
855 The color of the title bar (gradients are supported) of
856 inactive windows. The default is #333333:#111111.
857 Opacity
859 The opacity of inactive windows. This is a floating point
860 value between 0.0 and 1.0. The default is 0.75. Note
861 that a composite manager, such as xcompmgr, is required
862 for this.
863 Outline
865 The color of the window outline for inactive windows.
866 The default is a darkened version of the window back‐
867 ground. If motif window decorations are specified, two
868 colors may be given separated by a ':' to set the down
869 and up colors respectively.
870 TRAY STYLE
872 The TrayStyle tag controls the look of trays. The following at‐
873 tribute is supported:
874 decorations
876 The type of decorations to use for trays. Possible val‐
877 ues are flat and motif. The default is flat.
878 Within this tag the following tags are supported:
880 Font
882 The default tray font to use. See the FONTS section for
883 more information.
884 Foreground
886 The default foreground color. See the COLORS section for
887 more information.
888 Background
890 The default background color. See the COLORS section for
891 more information.
892 Outline
894 The color of the tray outline. See the COLORS section for
895 more information. The default is a darkened version of
896 the tray background. If motif tray decorations are spec‐
897 ified, this may be given as two colors separated by a ':'
898 to indicate the down and up colors respectively.
899 Opacity
901 The opacity of trays. This is a floating point value be‐
902 tween 0.0 and 1.0. Note that a composite manager, such
903 as xcompmgr, is required for this.
904 Active
906 The default colors for active items on the tray. See the
907 COLORS section for more information. The following tags
908 are supported:
909 Foreground
911 The default foreground color for active items.
912 Background
914 The default background color for active items.
915 Outline
917 The default outline color for active items. See
918 the COLORS section for more information. The de‐
919 fault is a darkened version of the background. If
920 motif tray decorations are specified, this may be
921 given as two colors separated by a ':' to indicate
922 the down and up colors respectively.
923 TASK LIST STYLE
925 The TaskListStyle tag controls the look of task lists. The fol‐
926 lowing attributea are supported:
927 decorations
929 The window decorations to use. Valid options are flat and
930 motif. The default is inherited from TrayStyle.
931 group
933 Determines if windows are grouped by class when shown in
934 task bars. Possible values are true and false. The de‐
935 fault is false.
936 list
938 Determines which windows are shown in task bars. Possi‐
939 ble values are desktop and all. The default is desktop.
940 Within this tag the following tags are supported:
942 Font
944 The font to use. See the FONTS section for more informa‐
945 tion.
946 Foreground
948 The foreground color. See the COLORS section for more in‐
949 formation.
950 Background
952 The background color. See the COLORS section for more in‐
953 formation.
954 Outline
956 The color of the button outline. See the COLORS section
957 for more information. The default is a darkened version
958 of the background. If motif tray decorations are speci‐
959 fied, this may be given as two colors separated by a ':'
960 to indicate the down and up colors respectively.
961 Active
963 The colors for the active items. See the COLORS section
964 for more information. The following tags are supported:
965 Foreground
967 The foreground color for active items.
968 Background
970 The background color for active items.
971 Outline
973 The outline color for active items. See the COLORS
974 section for more information. The default is a
975 darkened version of the background. If motif tray
976 decorations are specified, this may be given as
977 two colors separated by a ':' to indicate the down
978 and up colors respectively.
979 TRAY BUTTON STYLE
981 The TrayButtonStyle tag controls the look of tray buttons.
982 Within this tag the following tags are supported:
984 Font
986 The font to use. See the FONTS section for more informa‐
987 tion.
988 Foreground
990 The foreground color. See the COLORS section for more in‐
991 formation.
992 Background
994 The background color. See the COLORS section for more in‐
995 formation.
996 Outline
998 The color of the button outline. See the COLORS section
999 for more information. The default is a darkened version
1000 of the background. If motif tray decorations are speci‐
1001 fied, this may be given as two colors separated by a ':'
1002 to indicate the down and up colors respectively.
1003 Active
1005 The colors for pressed buttons. See the COLORS section
1006 for more information. The following tags are supported:
1007 Foreground
1009 The foreground color for pressed buttons.
1010 Background
1012 The background color for pressed buttons.
1013 Outline
1015 The outline color for pressed buttons. See the
1016 COLORS section for more information. The default
1017 is a darkened version of the background. If motif
1018 tray decorations are specified, this may be given
1019 as two colors separated by a ':' to indicate the
1020 down and up colors respectively.
1021 PAGER STYLE
1023 The PagerStyle tag controls the look of pagers. Within this
1024 tag, the following tags are supported:
1025 Outline
1027 The color of the outline around windows shown in the
1028 pager. See the COLORS section for more information.
1029 Foreground
1031 The color of inactive windows shown in the pager. See the
1032 COLORS section for more information.
1033 Background
1035 The background color of inactive desktops shown in the
1036 pager. See the COLORS section for more information.
1037 Active
1039 The colors used for active items in the pager. See the
1040 COLORS section for more information. The following tags
1041 are supported:
1042 Foreground
1044 The color of active windows shown in the pager.
1045 Background
1047 The background color of active desktops shown in
1048 the pager.
1049 Text
1051 The color to use for pager labels. See the COLORS section
1052 for more information.
1053 Font
1055 The font to use for pager labels. See the COLORS section
1056 for more information.
1057 CLOCK STYLE
1059 The ClockStyle tag controls the look of clocks. Within this
1060 tag, the following tags are supported:
1061 Font
1063 The font to use for clocks. This defaults to the tray
1064 font. See the COLORS section for more information.
1065 Foreground
1066 The foreground (text) color of clocks. This defaults to
1067 the tray foreground color. See the COLORS section for
1068 more information.
1069 Background
1070 The background color of clocks (gradients are supported).
1071 This defaults to the tray background color. See the COL‐
1072 ORS section for more information.
1073 MENU STYLE
1075 The MenuStyle tag controls the look of the menus in JWM (this
1076 includes the root menu and window menus). The following attri‐
1077 bute is supported:
1078 decorations
1080 The type of decorations to use for menus. Possible val‐
1081 ues are flat and motif. The default is flat.
1082 Within this tag the following tags are supported:
1083 Font
1085 The font used on menus See the FONTS section for more in‐
1086 formation.
1087 Foreground
1089 The text color of inactive menu items. See the COLORS
1090 section for more information.
1091 Background
1093 The background color of inactive menu items. See the COL‐
1094 ORSsection for more information.
1095 Outline
1097 The color of the menu outline. See the COLORS section for
1098 more information. The default is a darkened version of
1099 the menu background. If motif decorations are used, this
1100 may be given as two colors separated by a ':' to indicate
1101 the down and up colors respectively.
1102 Active
1104 The colors used for active menu items. See the COLORS
1106 section for more information. The following tags are
1107 supported:
1108 Foreground
1110 The text color of active menu items.
1111 Background
1113 Text background color of active menu items (gradi‐
1114 ents are supported).
1115 Opacity
1117 The opacity of menus. This is a floating point value be‐
1118 tween 0.0 and 1.0. Note that a composite manager, such
1119 as xcompmgr, is required for this.
1120 POPUP STYLE
1122 The PopupStyle tag controls the look of popup windows such as
1123 those shown when the mouse sits over a task list item. This tag
1124 supports the following attributes:
1125 delay int
1127 The delay in milliseconds before popups activate. The
1128 default is 600.
1129 enabled string
1131 Determine if popups are shown. This is a comma-separated
1132 list of one or more of the following: true (all enabled),
1133 false (no popups enabled), button (tray buttons), clock
1134 (clocks), menu (menus), pager (pagers), and task (task
1135 list items). The default is true.
1136 Within this tag the following tags are supported:
1138 Font
1140 The font to use. See the FONTS section for more informa‐
1141 tion.
1142 Outline
1144 The color of the window outline. See the COLORS section
1145 for more information. The default is black.
1146 Foreground
1148 The text color. See the COLORS section for more informa‐
1149 tion.
1150 Background
1152 The background color. See the COLORS section for more in‐
1153 formation.
1154 FONTS
1156 Fonts for various parts of JWM are specified within a Font tag.
1157 The text of this tag determines the font to use. This can be
1158 either an XLFD font string or, if compiled with Pango support,
1159 an XFT font string.
1160 COLORS
1162 Colors for various parts of JWM are specified within specific
1163 tags (described above). Colors may either be hex triplets in RGB
1164 format (for example, #FF0000 is red) or by a name recognized by
1165 the X server. For components that support gradients, two colors
1166 may be specified separated by a colon.
1167 ICONS
1169 Icons for windows that don't supply an icon via the _NET_WM_ICON
1170 hint are located by searching the icon search path(s) for an
1171 icon whose name (minus the ".xpm" or ".png" extension) matches
1172 the instance name of the window as returned in the WM_CLASS
1173 hint. If this lookup fails, a default icon is supplied. This
1174 icon will be displayed for the window on it's title bar and on
1175 the task list. Icons that are not an appropriate size will be
1176 scaled. Square icons work best.
1177 For menu items, the icon path is searched for a match. the icon
1179 specified for a menu item must be the exact name of the icon
1180 file with the extension. If no match is found, a blank area
1181 will appear where the icon should appear. If an icon is not
1182 specified for any menu item in a menu, no space will be allo‐
1183 cated for icons.
1184 Zero or more IconPath tags may be specified. The text of this
1186 tag is assumed to be an absolute directory path to a directory
1187 containing XPM, PNG, and/or JPEG icons. When searching for
1188 icons, if multiple paths are provided, they will be searched in
1189 order until a match is made. Note that icon, PNG, JPEG, and XPM
1190 support are compile-time options.
1191 KEY BINDINGS
1193 Keyboard bindings in JWM are specified in Key tags. Either the
1194 key or keycode attributes must be specified to determine which
1195 key will cause an action. The optional attribute, mask, speci‐
1196 fies what key mask, if any, must be in effect for the binding to
1197 match. Finally, the text of the Key tag is the action to per‐
1198 form. The last action to match is used if there are duplicates.
1199 One or more of the following key masks may be specified for mask
1201 (see xmodmap(1)):
1202 A The "Alt" key (mod1).
1204 C Control
1206 S Shift
1208 1 mod1
1210 2 mod2
1212 3 mod3
1214 4 mod4
1216 5 mod5
1218 The key specified in the key attribute must contain a valid key
1220 string for XStringToKeysym(3). These values are usually what one
1221 would expect (for example, the escape key is called "Escape").
1222 Valid actions for a key binding are:
1224 up Move up.
1226 down Move down.
1228 right Move right.
1230 left Move left.
1232 escape Stop a move/resize, exit a menu, or cancel an ac‐
1234 tion.
1235 fullscreen
1237 Toggle between fullscreen and not fullscreen.
1238 select Make a menu selection or confirm an action.
1240 next Move to the next window in the task list.
1242 nextstacked
1244 Move to the next window in the stacking order.
1245 none Remove the current binding.
1247 prev Move to the previous window in the task list.
1249 prevstacked
1251 Move to the previous window in the stacking order.
1252 close Close the active window.
1254 minimize
1256 Minimize the active window.
1257 maximize
1259 Maximize the active window.
1260 maxv Maximize the active window vertically.
1262 maxh Maximize the active window horizontally.
1264 maxtop Maximize the active window to the top of the
1266 screen.
1267 maxbottom
1269 Maximize the active window to the bottom of the
1270 screen.
1271 maxleft
1273 Maximize the active window to the left of the
1274 screen.
1275 maxright
1277 Maximize the active window to the right of the
1278 screen.
1279 restore
1281 Restore a maximized window.
1282 send# Send the active window to the specified desktop.
1284 To use this, "#" must be specified in the key sec‐
1285 tion. The number 1 to the number of desktops con‐
1286 figured are then substituted for "#".
1287 sendl Send the active window left.
1289 sendr Send the active window right.
1291 sendu Send the active window up.
1293 sendd Send the active window down.
1295 shade Shade the active window.
1297 stick Stick/unstick the active window.
1299 move Move the active window.
1301 resize Resize the active window. An optional suffix may
1303 be applied to this option to specify the corner of
1304 the window to resize. The options are:
1305 resize:n
1307 Resize the north side
1308 resize:s
1310 Resize the south side
1311 resize:e
1313 Resize the east side
1314 resize:w
1316 Resize the west side
1317 resize:nw
1319 Resize the north-west corner
1320 resize:ne
1322 Resize the north-east corner
1323 resize:sw
1325 Resize the south-west corner
1326 resize:se
1328 Resize the south-east corner
1329 center Center the current window.
1331 root:n Show root menu n.
1333 window Show the window menu for the active window.
1335 desktop#
1337 Switch to a specific desktop. To use this, "#"
1338 must be specified in the key section. The number 1
1339 to the number of desktops configured are then sub‐
1340 stituted for "#".
1341 rdesktop
1343 Move one desktop to the right.
1344 ldesktop
1346 Move one desktop to the left.
1347 udesktop
1349 Move up one desktop.
1350 ddesktop
1352 Move down one desktop.
1353 showdesktop
1355 Show/hide the desktop (maximize/minimize all win‐
1356 dows).
1357 showtray
1359 Unhide the tray (when using autohide).
1360 exec:command
1362 Execute command.
1363 restart
1365 Restart JWM.
1366 Note that there are no default key bindings. It is possible to
1368 bind multiple key combinations to the same action.
1369 MOUSE BINDINGS
1371 Mouse bindings are configured using Mouse tags. The context at‐
1372 tribute determines the context in which the binding applies, the
1373 button attribute species the mouse button, and the (optional)
1374 mask attribute specifies the key mask that must be in effect for
1375 the binding to match. Finally, the text of the Mouse tag deter‐
1376 mines the action to perform (see KEY BINDINGS for a list of ac‐
1377 tions). The button is a mouse button number, starting at 1
1378 (typically the left button). A positive value for the button in‐
1379 dicates that the action applies on mouse press and a negative
1380 value indicates that the action applies on release. The button
1381 number can be repeated to bind to double clicks. The following
1382 mouse contexts are supported:
1383 border
1385 The window border.
1386 close
1388 The close button on a window.
1389 icon
1391 The icon button on a window.
1392 maximize
1394 The maximize button on a window.
1395 minimize
1397 The minimize button on a window.
1398 root
1400 The root window.
1401 title
1403 The title bar of a window.
1404 Other bindings:
1406 Button 1 (typically the left button):
1408 Over a task bar, restores or minimizes the window. Over
1409 a pager, switches the active desktop.
1410 Button 2 (typically the middle button):
1412 Over a task bar, closes the window. Over a pager,
1413 switches the active desktop.
1414 Button 3 (typically the right button):
1416 Over a task bar, shows the window menu. Over a pager,
1417 dragging while holding button 3 will move a window.
1418 When a menu is open, the scroll wheel will move through menu
1420 items. When over the pager, the scroll wheel will switch desk‐
1421 tops. When over a task list, the scroll wheel will switch win‐
1422 dows.
1423 DESKTOPS
1425 Virtual desktops are controlled with the Desktops tag. Within
1426 this tag the following attribute is supported:
1427 width int
1429 The number of virtual desktops in the horizontal direc‐
1430 tion. The default is 4.
1431 height int
1433 The number of virtual desktops in the vertical direction.
1434 The default is 1.
1435 backandforth string
1437 Controls whether changing the desktop to the currently
1438 active desktop using the desktop# action should instead
1439 switch to the previously active desktop. Default is
1440 "off" to do nothing when switching to the currently ac‐
1441 tive desktop. Possible values are "on" and "off".
1442 Within the Desktops tag the following tags are supported:
1444 Background
1446 The default background for desktops. The type attribute
1447 determines the type of background and the text contained
1448 within this tag is the value. Valid types are:
1449 solid
1451 A solid color. See the COLORS section for more in‐
1452 formation. This is the default.
1453 gradient
1454 A gradient color. See the COLORS section for more
1455 information.
1456 image
1457 A stretched image. This may be an XPM, PNG, or
1458 JPEG image. Note that support for XPM, PNG, and
1459 JPEG images must be compiled in and icon support
1460 is required.
1461 tile
1462 A tiled image. Like image, but the image is tiled
1463 instead of stretched.
1464 scale
1465 A scaled image. Like image, but the aspect ratio
1466 of the image is preserved.
1467 command
1468 A command to run for setting the background.
1469 Desktop
1471 Desktop-specific data. The name attribute may be speci‐
1472 fied to name the desktop (the default is the desktop num‐
1473 ber). Within this tag a Background tag may be specified
1474 for a desktop-specific background. See Background above
1475 for more information.
1476 OTHER SETTINGS
1478 The following tags may also be supplied:
1480 ButtonClose
1482 An icon to display for the close button on client windows
1483 instead of the default.
1484 ButtonMax
1485 An icon to display for the maximize button on client win‐
1486 dows instead of the default.
1487 ButtonMaxActive
1488 An icon to display for the maximize button on maximized
1489 client windows instead of the default.
1490 ButtonMenu
1491 An icon to display for the menu button on client windows
1492 instead of the default. This is used for client windows
1493 that do not specify an icon.
1494 ButtonMin
1495 An icon to display for the minimize button on client win‐
1496 dows instead of the default.
1497 DefaultIcon
1498 An icon to display for windows that do not specify an
1499 icon.
1500 DoubleClickDelta
1501 The number of pixels the mouse can move during a double
1502 click. The default is 2. Valid values are between 0 and
1503 32 inclusive.
1504 DoubleClickSpeed
1506 The maximum number of milliseconds between clicks for a
1507 double click. The default is 400. Valid values are be‐
1508 tween 1 and 2000 inclusive.
1509 FocusModel
1511 The focus model to be used. The default is "sloppy".
1512 Valid values are:
1513 click
1515 Click to focus and raise.
1516 clicktitle
1518 Click to focus. Click the title bar to raise.
1519 sloppy
1521 Focus follows mouse. Click to raise.
1522 sloppytitle
1524 Focus follows mouse. Click the title bar to raise.
1525 MoveMode
1527 The move mode. The default is "opaque". Valid values are
1528 "opaque" and "outline". This tag supports the following
1529 attributes:
1530 coordinates { off | corner | window | screen }
1532 The location of the status window. The default is
1533 screen.
1534 delay int
1536 The delay in milliseconds before moving a window
1537 to a different desktop. Setting this to 0 dis‐
1538 ables dragging windows between desktops. The de‐
1539 fault is 1000.
1540 mask string
1542 The key mask of the modifier that, when held, al‐
1543 lows one to move the window by dragging it. The
1544 default is "A".
1545 ResizeMode
1547 The resize mode. The default is "opaque". Valid values
1548 are "opaque" and "outline". The optional coordinates at‐
1549 tribute determines the location of the move status win‐
1550 dow. Possible values are: This tag supports the following
1551 attribute:
1552 coordinates { off | corner | window | screen }
1554 The location of the status window. The default is
1555 screen.
1556 RestartCommand
1558 A command to run when JWM restarts.
1559 SnapMode
1561 The snap mode. The default is "border". Valid values are
1562 "none" (for no snapping), "screen" (for snapping to the
1563 edge of the screen), and "border" (for snapping to the
1564 borders of windows and the screen). An optional attri‐
1565 bute, distance, specifies the distance for snapping. The
1566 default is 5. Valid values are between 1 and 32 inclu‐
1567 sive.
1568 StartupCommand
1570 A command to run when JWM starts.
1571 ShutdownCommand
1573 A command to run when JWM exits.
1574 TitleButtonOrder
1576 Change the order of buttons in title bars. This is a
1577 string of zero or more of the following characters to de‐
1578 termine the order of items in the window title bar:
1579 m Maximize button
1581 i Minimize (iconify) button
1583 t Window title
1585 w Window menu button
1587 x Close button
1589
1591 Joe Wingbermuehle <joewing@joewing.net>
1592
1595 X(1)
1596v2.4.2 2023-07-20 jwm(1)