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
32 ensure 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.
86 Default 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
101 allowed 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.
128 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 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 label string
141 The label to display. Default is the text of the
142 tag.
143 tooltip string
145 A tooltip to display. No default.
146 icon string
148 The icon to use. No default.
149 Separator
151 This tag simply puts a line in the menu allowing menu
152 divisions. No text or attributes are used.
153 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 label string
160 The label to use for the menu. The default is
161 "Desktops".
162 tooltip string
164 A tooltip to display. No default.
165 icon string
167 The icon to use for this item. No default.
168 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 label string
176 The label to use. The default is "SendTo".
177 tooltip string
179 A tooltip to display. No default.
180 icon string
182 The icon to use for this item. No default.
183 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
188 attributes are supported:
189 label string
191 The label to use. The default is "Stick".
192 tooltip string
194 A tooltip to display. No default.
195 icon string
197 The icon to use for this item. No default.
198 Maximize
200 Add a maximize window operation to the menu. After
201 selecting this item a window may be selected to toggle
202 the maximized state of that window. The following
203 attributes are supported:
204 label string
206 The label to use. The default is "Maximize".
207 tooltip string
209 A tooltip to display. No default.
210 icon string
212 The icon to use for this item. No default.
213 Minimize
215 Add a minimize window operation to the menu. After
216 selecting this item a window may be selected to minimize
217 that window. The following attributes are supported:
218 label string
220 The label to use. The default is "Minimize".
221 tooltip string
223 A tooltip to display. No default.
224 icon string
226 The icon to use for this item. No default.
227 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
232 attributes are supported:
233 label string
235 The label to use. The default is "Shade".
236 tooltip string
238 A tooltip to display. No default.
239 icon string
241 The icon to use for this item. No default.
242 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 label string
249 The label to use. The default is "Move".
250 tooltip string
252 A tooltip to display. No default.
253 icon string
255 The icon to use for this item. No default.
256 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 label string
263 The label to use. The default is "Resize".
264 tooltip string
266 A tooltip to display. No default.
267 icon string
269 The icon to use for this item. No default.
270 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 label string
277 The label to use. The default is "Kill".
278 tooltip string
280 A tooltip to display. No default.
281 icon string
283 The icon to use for this item. No default.
284 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 label string
291 The label to use. The default is "Close".
292 tooltip string
294 A tooltip to display. No default.
295 icon string
297 The icon to use for this item. No default.
298 Restart
300 This tag adds a menu item to restart the window manager.
301 The following attributes are supported:
302 label string
304 The label to use. The default is "Restart".
305 tooltip string
307 A tooltip to display. No default.
308 icon string
310 The icon to use. No default.
311 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 label string
320 The label to use. The default is "Exit".
321 tooltip string
323 A tooltip to display. No default.
324 icon string
326 The icon to use. No default.
327 confirm bool
329 Determine if a confirm dialog appears before exit‐
330 ing. Default is true.
331 Note that confirm dialogs can be disabled completely at
333 the compile-time.
334 TRAYS
336 One or more trays may be created via the Tray tag. This tag
337 supports the following attributes:
338 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 x int
345 The x-coordinate of the tray. This may be negative to
346 indicate an offset from the right of the screen.
347 y int
349 The y-coordinate of the tray. This may be negative to
350 indicate an offset from the bottom of the screen.
351 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 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 layer { below | normal | above }
365 The layer of the tray. The default is above.
366 layout { vertical | horizontal }
368 The layout of the tray. The default is horizontal.
369 valign { fixed | top | center | bottom }
371 The vertical alignment of the tray. The default is fixed.
372 halign { fixed | left | center | right }
374 The horizontal alignment of the tray. The default is
375 fixed.
376 Within this tag the following tags are supported:
378 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 root:n
388 Show root menu n. Note that the default TrayBut‐
389 ton action is root:1.
390 exec: string
392 Execute a command.
393 showdesktop
395 Minimize all windows on the current desktop.
396 This tag supports the following attributes:
398 format string
400 The format of the clock. See strftime(3).
401 zone string
403 The time zone of the clock. See tzset(3).
404 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 height int
411 The height of the clock. 0 indicates that the
412 height should be determined from the font used.
413 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 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 spacing int
428 The spacing of items contained in the dock (in
429 pixels). This defaults to 0.
430 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 labeled bool
441 Determines if the pager has text labels. Default
442 is false.
443 Also see the PAGER STYLE section for more information.
445 Spacer
447 Add empty space to the tray. This tag supports the fol‐
448 lowing attributes:
449 width int
451 The width of the spacer (0 to fill all available
452 space). 0 is the default.
453 height int
455 The height of the spacer (0 to fill all available
456 space). 0 is the default.
457 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 name string
464 The name of the program to swallow. This attribute
465 is required.
466 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
471 default.
472 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 TaskList
480 Add a task list to the tray. This tag supports the fol‐
481 lowing attributes:
482 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 labeled bool
489 Determines if a label is shown for items in the
490 task list. The default is true.
491 maxwidth int
493 The maximum width of an item in the task list. 0
494 indicates no maximum. The default is 0.
495 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 root:n
505 Show root menu n. Note that the default TrayBut‐
506 ton action is root:1.
507 exec: string
509 Execute a command.
510 showdesktop
512 Minimize all windows on the current desktop.
513 This tag supports the following attributes:
515 label string
517 A label to display. No default.
518 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 icon string
526 An icon to display. No default.
527 INCLUDES
529 Other configuration files or the output of programs may be
530 included 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 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 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 aerosnap
561 Enable auto-maximization when a window is dragged
562 to the corner of the screen.
563 border
566 Causes windows in this group to have a border.
567 centered
570 Center windows in this group upon initial place‐
571 ment instead of using cascaded placement.
572 constrain
575 Constrain windows in this group to the screen.
576 desktop:#
579 The desktop on which windows in this group will be
580 started.
581 drag
584 Do not pass mouse events to the window. Instead,
585 use the mouse to move/resize the window.
586 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
592 default behavior of bringing the window to the
593 current desktop.
594 fullscreen
597 Make windows in this group initially fullscreen.
598 height:#
601 Set the initial window height (in pixels).
602 hmax
605 Make windows in this group maximize horizontally.
606 icon:string
609 The icon to be used for windows in this group.
610 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 iignore
620 Ignore the size increment hint when maximizing
621 windows in this group.
622 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 layer:string
632 The layer on which windows in this group will be
633 started. Valid options are below, normal, and
634 above
635 maximized
638 Make windows in this group initially maximized.
639 minimized
642 Make windows in this group initially minimized.
643 noborder
646 Causes windows in this group to be displayed with‐
647 out a border.
648 noclose
651 Prevent windows in this group from being closed.
652 nodrag
655 Disable mod1+drag moving/resizing for windows in
656 this group.
657 nofocus
660 Prevents windows in the group from grabbing the
661 focus when mapped.
662 nofullscreen
665 Prevent windows in this group from being
666 fullscreen.
667 nolist
670 Causes the tray to ignore windows in this group
671 when the window is initially mapped.
672 nopager
675 Causes the pager to ignore windows in this group.
676 nomax
679 Prevent windows in this group from being maxi‐
680 mized.
681 nomin
684 Prevent windows in this group from being mini‐
685 mized.
686 nomove
689 Prevent windows in this group from being moved.
690 noresize
693 Prevent windows in this group from being resized.
694 noshade
697 Prevent windows in this group from being shaded.
698 notitle
701 Causes windows in this group to be displayed with‐
702 out a title bar.
703 noturgent
706 Ignore the urgent hint for windows in this group.
707 opacity:#
710 Set the opacity for windows in this group. The
711 value is a number between 0.0 and 1.0 inclusive.
712 pignore
715 Ignore initial window position requested by pro‐
716 gram.
717 shaded
720 Make windows in this group initially shaded.
721 sticky
724 Make windows in this group sticky.
725 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 title
735 Forces windows in this group to have a title bar.
736 vmax
739 Make windows in this group maximize vertically.
740 width:#
743 Set the initial window width (in pixels).
744 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 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 WINDOW STYLE
759 The WindowStyle tag controls the look of window borders. This
760 tag supports the following attribute:
761 decorations
763 The window decorations to use. Valid options are flat and
764 motif. flat is the default.
765 Within this tag, the following tags are supported:
767 Font
769 The font used for title bars. See the FONTS section for
770 more information. This tag supports the following
771 attribute:
772 align
774 The window title alignment. Valid options are
775 left, right, and center. left is the default.
776 Width
778 The width of window borders in pixels. The default is 4,
779 the minimum is 1, and the maximum is 128.
780 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 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 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 Foreground
797 The color of the text and buttons in the title
798 bar. The default is white.
799 Background
801 The color of the title bar (gradients are sup‐
802 ported). The default is #CC7700:#884400.
803 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 Outline
811 The color of the window outline. The default is a
812 darkened version of the window background. If
813 motif window decorations are specified, two colors
814 may be given separated by a ':' to set the down
815 and up colors respectively.
816 Foreground
818 The color of text and buttons in the title bar of inac‐
819 tive windows. The default is white.
820 Background
822 The color of the title bar (gradients are supported) of
823 inactive windows. The default is #333333:#111111.
824 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 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 TRAY STYLE
839 The TrayStyle tag controls the look of trays. The following
840 attributes are supported:
841 decorations
843 The type of decorations to use for trays. Possible val‐
844 ues are flat and motif. The default is flat.
845 group
847 Determines if windows are grouped by class when shown in
848 task bars. Possible values are true and false. The
849 default is false.
850 list
852 Determines which windows are shown in task bars. Possi‐
853 ble values are desktop and all. The default is desktop.
854 Within this tag the following tags are supported:
856 Font
858 The default tray font to use. See the FONTS section for
859 more information.
860 Foreground
862 The default foreground color. See the COLORS section for
863 more information.
864 Background
866 The default background color. See the COLORS section for
867 more information.
868 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 Opacity
877 The opacity of trays. This is a floating point value
878 between 0.0 and 1.0. Note that a composite manager, such
879 as xcompmgr, is required for this.
880 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 Foreground
887 The default foreground color for active items.
888 Background
890 The default background color for active items.
891 Outline
893 The default outline color for active items. See
894 the COLORS section for more information. The
895 default is a darkened version of the background.
896 If motif tray decorations are specified, this may
897 be given as two colors separated by a ':' to indi‐
898 cate the down and up colors respectively.
899 TASK LIST STYLE
901 The TaskListStyle tag controls the look of task lists. The fol‐
902 lowing attribute is supported:
903 decorations
905 The window decorations to use. Valid options are flat and
906 motif. The default is inherited from TrayStyle.
907 Within this tag the following tags are supported:
909 Font
911 The font to use. See the FONTS section for more informa‐
912 tion.
913 Foreground
915 The foreground color. See the COLORS section for more
916 information.
917 Background
919 The background color. See the COLORS section for more
920 information.
921 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 Active
930 The colors for the active items. See the COLORS section
931 for more information. The following tags are supported:
932 Foreground
934 The foreground color for active items.
935 Background
937 The background color for active items.
938 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 TRAY BUTTON STYLE
948 The TrayButtonStyle tag controls the look of tray buttons.
949 Within this tag the following tags are supported:
951 Font
953 The font to use. See the FONTS section for more informa‐
954 tion.
955 Foreground
957 The foreground color. See the COLORS section for more
958 information.
959 Background
961 The background color. See the COLORS section for more
962 information.
963 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 Active
972 The colors for pressed buttons. See the COLORS section
973 for more information. The following tags are supported:
974 Foreground
976 The foreground color for pressed buttons.
977 Background
979 The background color for pressed buttons.
980 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 PAGER STYLE
990 The PagerStyle tag controls the look of pagers. Within this
991 tag, the following tags are supported:
992 Outline
994 The color of the outline around windows shown in the
995 pager. See the COLORS section for more information.
996 Foreground
998 The color of inactive windows shown in the pager. See the
999 COLORS section for more information.
1000 Background
1002 The background color of inactive desktops shown in the
1003 pager. See the COLORS section for more information.
1004 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 Foreground
1011 The color of active windows shown in the pager.
1012 Background
1014 The background color of active desktops shown in
1015 the pager.
1016 Text
1018 The color to use for pager labels. See the COLORS section
1019 for more information.
1020 Font
1022 The font to use for pager labels. See the COLORS section
1023 for more information.
1024 CLOCK STYLE
1026 The ClockStyle tag controls the look of clocks. Within this
1027 tag, the following tags are supported:
1028 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 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
1044 attribute is supported:
1045 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 Font
1052 The font used on menus See the FONTS section for more
1053 information.
1054 Foreground
1056 The text color of inactive menu items. See the COLORS
1057 section for more information.
1058 Background
1060 The background color of inactive menu items. See the COL‐
1061 ORSsection for more information.
1062 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 Active
1071 The colors used for active menu items. See the COLORS
1073 section for more information. The following tags are
1074 supported:
1075 Foreground
1077 The text color of active menu items.
1078 Background
1080 Text background color of active menu items (gradi‐
1081 ents are supported).
1082 Opacity
1084 The opacity of menus. This is a floating point value
1085 between 0.0 and 1.0. Note that a composite manager, such
1086 as xcompmgr, is required for this.
1087 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 delay int
1094 The delay in milliseconds before popups activate. The
1095 default is 600.
1096 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 Within this tag the following tags are supported:
1105 Font
1107 The font to use. See the FONTS section for more informa‐
1108 tion.
1109 Outline
1111 The color of the window outline. See the COLORS section
1112 for more information. The default is black.
1113 Foreground
1115 The text color. See the COLORS section for more informa‐
1116 tion.
1117 Background
1119 The background color. See the COLORS section for more
1120 information.
1121 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 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 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 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 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 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 One or more of the following key masks may be specified for mask
1168 (see xmodmap(1)):
1169 A The "Alt" key (mod1).
1171 C Control
1173 S Shift
1175 1 mod1
1177 2 mod2
1179 3 mod3
1181 4 mod4
1183 5 mod5
1185 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 Valid actions for a key binding are:
1191 up Move up.
1193 down Move down.
1195 right Move right.
1197 left Move left.
1199 escape Stop a move/resize, exit a menu, or cancel an
1201 action.
1202 fullscreen
1204 Toggle between fullscreen and not fullscreen.
1205 select Make a menu selection or confirm an action.
1207 next Move to the next window in the task list.
1209 nextstacked
1211 Move to the next window in the stacking order.
1212 prev Move to the previous window in the task list.
1214 prevstacked
1216 Move to the previous window in the stacking order.
1217 close Close the active window.
1219 minimize
1221 Minimize the active window.
1222 maximize
1224 Maximize the active window.
1225 maxv Maximize the active window vertically.
1227 maxh Maximize the active window horizontally.
1229 maxtop Maximize the active window to the top of the
1231 screen.
1232 maxbottom
1234 Maximize the active window to the bottom of the
1235 screen.
1236 maxleft
1238 Maximize the active window to the left of the
1239 screen.
1240 maxright
1242 Maximize the active window to the right of the
1243 screen.
1244 restore
1246 Restore a maximized window.
1247 sendl Send the active window left.
1249 sendr Send the active window right.
1251 sendu Send the active window up.
1253 sendd Send the active window down.
1255 shade Shade the active window.
1257 stick Stick/unstick the active window.
1259 move Move the active window.
1261 resize Resize the active window.
1263 root:n Show root menu n.
1265 window Show the window menu for the active window.
1267 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 rdesktop
1275 Move one desktop to the right.
1276 ldesktop
1278 Move one desktop to the left.
1279 udesktop
1281 Move up one desktop.
1282 ddesktop
1284 Move down one desktop.
1285 showdesktop
1287 Show/hide the desktop (maximize/minimize all win‐
1288 dows).
1289 showtray
1291 Unhide the tray (when using autohide).
1292 exec:command
1294 Execute command.
1295 restart
1297 Restart JWM.
1298 Note that there are no default key bindings. It is possible to
1300 bind multiple key combinations to the same action.
1301 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 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 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 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
1330 unshaded. On the maximize button, clicking toggles
1331 between horizontally maximized and normal. On the close
1332 button, clicking closes the window. Over a task bar,
1333 shows the window menu. Over a pager, dragging while
1334 holding button 3 will move a window.
1335 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 DESKTOPS
1343 Virtual desktops are controlled with the Desktops tag. Within
1344 this tag the following attribute is supported:
1345 width int
1347 The number of virtual desktops in the horizontal direc‐
1348 tion. The default is 4.
1349 height int
1351 The number of virtual desktops in the vertical direction.
1352 The default is 1.
1353 Within the Desktops tag the following tags are supported:
1355 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 solid
1362 A solid color. See the COLORS section for more
1363 information. 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 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 OTHER SETTINGS
1389 The following tags may also be supplied:
1391 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 DoubleClickSpeed
1417 The maximum number of milliseconds between clicks for a
1418 double click. The default is 400. Valid values are
1419 between 1 and 2000 inclusive.
1420 FocusModel
1422 The focus model to be used. The default is "sloppy".
1423 Valid values are:
1424 click
1426 Click to focus and raise.
1427 clicktitle
1429 Click to focus. Click the title bar to raise.
1430 sloppy
1432 Focus follows mouse. Click to raise.
1433 sloppytitle
1435 Focus follows mouse. Click the title bar to raise.
1436 MoveMode
1438 The move mode. The default is "opaque". Valid values are
1439 "opaque" and "outline". This tag supports the following
1440 attributes:
1441 coordinates { off | corner | window | screen }
1443 The location of the status window. The default is
1444 screen.
1445 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
1450 default is 1000.
1451 mask string
1453 The key mask of the modifier that, when held,
1454 allows one to move the window by dragging it. The
1455 default is "A".
1456 ResizeMode
1458 The resize mode. The default is "opaque". Valid values
1459 are "opaque" and "outline". The optional coordinates
1460 attribute determines the location of the move status win‐
1461 dow. Possible values are: This tag supports the following
1462 attribute:
1463 coordinates { off | corner | window | screen }
1465 The location of the status window. The default is
1466 screen.
1467 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
1473 attribute, distance, specifies the distance for snapping.
1474 The default is 5. Valid values are between 1 and 32
1475 inclusive.
1476 StartupCommand
1478 A command to run when JWM starts.
1479 ShutdownCommand
1481 A command to run when JWM exits.
1482 RestartCommand
1484 A command to run when JWM restarts.
1485
1487 Joe Wingbermuehle <joewing@joewing.net>
1488
1491 X(1)
1492v2.3.7 2019-02-01 jwm(1)