1SDORFEHS(1) BSD General Commands Manual SDORFEHS(1)
2
4 sdorfehs — window manager without mouse dependency
5
7 sdorfehs [-hv]
8 sdorfehs [-d dpy] [-s num] [-f file]
9 sdorfehs [-d dpy] [-s num] [-i] -c command [-c command ...]
10
12 sdorfehs is a window manager without fat library dependencies, fancy
13 graphics or dependence on a mouse.
14 The screen can be split into non-overlapping frames. All windows are
16 kept maximized inside their frames.
17 All interaction with the window manager is done through keystrokes.
19 sdorfehs has a prefix map to minimize key clobbering.
20 The options are as follows:
22 -c command
24 Send sdorfehs a command. There must be a sdorfehs instance running
25 as window manager for the given display/screen for this to work. Do
26 not forget to quote the command if it contains spaces. For example:
27 sdorfehs -c "echo hello world"
29 -d display
31 Set the X display to use or send commands to.
32 -f filename
34 Specify an alternate configuration file. If this is not given,
35 sdorfehs will try $HOME/.config/sdorfehs/config and execute each com‐
36 mand when starting up.
37 -h Show summary of options.
39 -i Execute commands given with -c in interactive mode. That means it
41 will behave exactly as if called with C-a : like prompting for miss‐
42 ing arguments and things like that.
43 -s number
45 Only use the specified screen.
46
48 To avoid conflicts with other programs, all default sdorfehs key bindings
49 start with an escape key which, by default, is C-a (Control-a). Some
50 important default key bindings:
51 C-a ? Show key bindings
53 C-a a Send a Control-a to the current window
55 C-a c Start an X terminal
57 C-a n Switch to next window
59 C-a p Switch to previous window
61 C-a 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
63 Switch to window number 0 | 1 | 2 | ...
64 C-a k Close the current window
66 C-a K XKill the current application
68 C-a s | S
70 Split the current frame into two vertical | horizontal ones
71 C-a Tab | Left | Up | Right | Down
73 Switch to the next | left | top | right | bottom frame.
74 C-a Q Make the current frame the only one
76 C-a : Execute a sdorfehs command
78 C-a F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | F9 | F10 | F11 | F12
80 Switch to virtual screen number 0 | 1 | 2 | ...
81 Further default key bindings can be found in parentheses after the com‐
83 mands in the next section.
84
86 abort (C-a C-g) Do nothing and that successfully. (Useful if you
87 pressed C-a in error).
88 addhook event command
90 Add a hook: run command whenever event is called. Possible
91 events are:
92 deletewindow
94 Run after a window is withdrawn.
95 newwindow
97 Run after a new window is mapped.
98 key Run whenever a top level key is pressed (by default C-a).
100 quit Run before exiting sdorfehs.
102 restart
104 Run before restarting sdorfehs.
105 switchframe
107 Run after a frame actually switched, but before the win‐
108 dow in it is focused.
109 switchgroup
111 Run after selecting a new group.
112 switchscreen
114 Run when the user switches to a different screen.
115 switchwin
117 Run after a new window is selected. (With dedication, it
118 may already be inactive again, if it was put into another
119 frame)
120 alias alias command
122 Add alias as new way to call command.
123 bind key command
125 alias for "definekey root key command"
126 banish (C-a b) Banish the rat cursor to the lower right corner of the
128 screen.
129 banishrel
131 Banish the rat cursor to the lower right corner of the current
132 window. If there isn't a window in the current frame, it ban‐
133 ishes the rat cursor to the lower right corner of the frame.
134 chdir [directory]
136 If the optional argument is given, change the current directory
137 of sdorfehs to directory. If nothing is given, change it to the
138 value of the environment variable "HOME".
139 clrunmanaged
141 Clears the unmanaged window list.
142 cnext Like next but switch to the next window with another resource
144 class than the current one. (That means the next window belong‐
145 ing to another type of application than the current one.)
146 cprev Like prev but switch to the previous window with another resource
148 class than the current one. (That means the previous window
149 belonging to another type of application than the current one.)
150 colon sdorfehs-command (C-a :)
152 Execute sdorfehs-command interactively. (i.e. ask for possible
153 missing arguments.)
154 cother Like other but switch to the window of the current group that was
156 last accessed and has another resource class but is not currently
157 visible.
158 curframe (C-a F)
160 Show a bar marking the current frame.
161 definekey keymap key command
163 Add a new key binding in keymap for key to execute command.
164 Default keymaps are top normally only containing C-a, which reads
165 a key from root, containing all the normal commands.
166 Note that you have to describe ":" by "colon", "!" by "exclam"
168 and so on. If you cannot guess a name of a key, try either C-a
169 key and look at the error message, or try :describekey root and
170 pressing the key.
171 dedicate [0 | 1]
173 Consider the current frame dedicated/chaste (1) or promiscuous
174 (0).
175 A dedicated frame will not accept new windows. When new windows
177 are to be focused, they will be opened in a non-dedicated frame
178 instead.
179 If no argument is given, toggle the current dedicateness. By
181 default no windows are dedicated.
182 delete (C-a k)
184 Close the current window.
185 delkmap keymap
187 Deletes the keymap named keymap, that was generated with newkmap.
188 The keymaps top (or whatever was specified by set topkmap) and
189 root cannot be deleted.
190 describekey keymap
192 Grab the next key. Similar to readkey, describekey shows only
193 the command in keymap, that would be executed by readkey.
194 echo text
196 Show text as sdorfehs message.
197 escape key
199 Update the default escape key to key.
200 Strictly speaking it updates the readkey root command in the
202 keymap top to key, the other binding in root to key, and meta
203 binding in root to key without modifiers or C-key if key has no
204 modifiers. (If set topkmap was called with an argument other
205 than top that will be used instead of top.)
206 exchangedown (C-a C-Down)
208 Exchange the window in the current frame with the window in the
209 frame below the current frame.
210 exchangeleft (C-a C-Left)
212 Exchange the window in the current frame with the window in the
213 frame left of the current frame.
214 exchangeright (C-a C-Right)
216 Exchange the window in the current frame with the window in the
217 frame right of the current frame.
218 exchangeup (C-a C-Up)
220 Exchange the window in the current frame with the window in the
221 frame above the current frame.
222 exec shell-command (C-a !)
224 Spawn a shell executing shell-command.
225 execa shell-command
227 Spawn a shell executing shell-command, without remembering the
228 current frame, so that _NET_WM_PID declaring programs will be
229 placed into the frame active when they open a window instead of
230 the frame active when sdorfehs gets this command.
231 execf frame shell-command
233 Spawn a shell executing shell-command, showing _NET_WM_PID sup‐
234 porting programs in the given frame instead of the frame selected
235 when this program is run.
236 fdump [screenno]
238 Output the defining data for all frames of the current screen, or
239 for screen number screenno if this is specified.
240 focus (C-a Tab)
242 Focus the next frame.
243 focuslast
245 Switch to the last selected focus.
246 focusleft (C-a Left)
248 Switch to the frame to the left of the current one.
249 focusdown (C-a Down)
251 Switch to the frame beneath the current one.
252 focusright (C-a Right)
254 Switch to the frame to the right of the current one.
255 focusprev
257 Focus the previous frame.
258 focusup (C-a Up)
260 Switch to the frame above the current one.
261 frestore frames
263 Replace the current frames with the ones specified in frames in
264 the format as generated by fdump.
265 fselect [frameno] (C-a f)
267 If an argument is supplied, switch to a frame given by number
268 frameno.
269 If no argument is given, show a frame selector in each frame and
271 wait for a key to be pressed. If the key matches an existing
272 frame selector, this frame gets focused.
273 Frame selectors are by default the numbers starting with zero,
275 but they can be changed by setting framesels.
276 gdelete [group]
278 If the optional argument group is supplied, delete group. Other‐
279 wise delete the current group. If the last group is deleted, a
280 new group with name default is created. The group has to be
281 empty, otherwise it cannot be deleted.
282 getenv variable
284 Output the value of the environment variable variable.
285 getsel Paste the current X Selection into the current window.
287 gmerge group
289 Move all windows from group group into the current group.
290 gmove group
292 Move the current window into group group.
293 gnew group
295 Create a new group with name group and select it. Most window
296 commands only see (and thus select, consider next, previous or
297 last) windows within the group active when they are issued.
298 gnewbg group
300 Create a new group named group, but do not select it.
301 gnext Select the next group. Most window commands only see windows in
303 the effective group.
304 gnumber [old new]
306 Give the number new to the group with the number old or the cur‐
307 rent group.
308 gother Select the last accessed group. Most window commands only see
310 windows in the effective group.
311 gprev Select the prior group. Most window commands only see windows in
313 the effective group.
314 gravity [nw | w | sw | n | c | s | ne | e | se]
316 Change how in its frame the current window is aligned.
317 grename
319 Rename current group.
320 groups Output a list of all groups with their number.
322 gselect group
324 Select the group named group.
325 help [keymap]
327 If the optional parameter keymap is given, list all keybindings
328 in this keymap, otherwise list all key bindings in keymap root.
329 hsplit [l/p | [-]pixels] (C-a S)
331 Split the current frame into left frame and a right frame. If no
332 parameter is given, split in halves. If two numbers separated by
333 a slash (‘/’) are given, the left one is l times the pth part and
334 the right one (p - l) times the pth part of the prior width.
335 Otherwise the right half is pixels wide or the left one is pixels
336 wide, depending whether there is ‘-’ in front of the number or
337 not.
338 inext Like next but switch to the next window with the same resource
340 class as the current one. (That means the next window belonging
341 to the same application as the current one.)
342 info (C-a i)
344 Output the current the width, height, window number and window
345 name of the current window. (What name means is chosen by “set
346 winname”.)
347 iprev Like prev but switch to the previous window with the same
349 resource class as the current one. (That means the previous win‐
350 dow belonging to the same application as the current one.)
351 iother Like other but switch to the window of the current group that was
353 last accessed and has the same resource class but is not cur‐
354 rently visible.
355 kill (C-a K)
357 Close the X-connection of the X-client responsible for the cur‐
358 rent window.
359 lastmsg (C-a m)
361 Reshow the last message.
362 link key [keymap]
364 Do what key is bound to in the keymap keymap if supplied. Other‐
365 wise what key is bound to in keymap root.
366 listhook event
368 List all commands specified with addhook to be executed when even
369 event occurs.
370 meta [key] (C-a t)
372 Send the escape key (that which normally is C-a) to the current
373 window. If a key is specified, this is sent instead. Note that
374 some applications by default ignore the synthetic key that is
375 sent using this command as it is considered a security hole.
376 xterm is one such application.
377 newkmap keymap
379 Generate a new keymap named keymap. This keymap can be used to
380 add new key-command mappings to it with definekey and can be
381 called with readkey.
382 next (C-a Return | C-a n | C-a space)
384 Switch to the next window in the current group.
385 nextscreen (C-a N)
387 Switch to the next screen. (If you have multiple physical ones.)
388 number new [old]
390 Give the number new to the window with the number old or the cur‐
391 rent window.
392 only (C-a Q)
394 Remove all frames on the current screen except the current frame
395 and maximize this one to the size of the whole screen.
396 other (C-a C-a)
398 Switch to the window of the current group that was last accessed
399 but is not currently visible.
400 prev (C-a p)
402 Switch to the previous window in the current group.
403 prevscreen (C-a P)
405 Switch to the previous screen. (If you have multiple physical
406 ones.)
407 prompt [prompt]
409 sdorfehs will ask the user for input, showing prompt (or a single
410 colon, if no argument is given) and output the input the user has
411 made. Note that this command probably does not make much sense
412 in interactive mode.
413 putsel x-selection
415 Replace the X selection with the text x-selection. It can be
416 inserted into the current window with getsel.
417 quit Quit sdorfehs.
419 ratinfo
421 Display the x y coordinates of the rat cursor relative to the
422 screen.
423 ratrelinfo
425 Display the x y coordinates of the rat cursor relative to the
426 current window or current frame if no window is focused
427 ratwarp x y
429 Move the rat cursor to the position (x, y).
430 ratrelwarp deltax deltay
432 Move the rat cursor to (deltax, deltay), relative to the current
433 position.
434 ratclick [button]
436 Simulate a rat click with button (button 1=left button if none
437 given).
438 rathold (up | down) [button]
440 Simulate pressing|releasing rat button button (1=left button if
441 none given).
442 readkey keymap
444 Grab the next key pressed, and execute the command associated to
445 this key in keymap. To show it is waiting for a key, sdorfehs
446 will change the rat cursor to a square if waitcursor is set.
447 This command is perhaps best described with its usage in the
448 default configuration: by pressing C-a, which is the only key in
449 the keymap top , the command "readkey root" is executed. The
450 next key then executes the command in keymap root belonging to
451 this command.
452 redisplay (C-a l)
454 Extend the current window to the whole size of its current frame
455 and redisplay it. (Useful to redisplay normal windows or bring
456 transient windows to the full size of the frame as only normal
457 windows are maximized by sdorfehs)
458 redo (C-a U)
460 Revert the last undo of frame changes.
461 remhook event command
463 Remove command command from the list of commands to be called
464 when event event is hit. (The command has to specified, as an
465 event can have multiple commands attached to it.) Use "listhook
466 hook" to get a list of all attached commands.
467 remove (C-a R)
469 Remove the current frame and extend some frames around to fill
470 the remaining gap.
471 resize [deltax deltay] (C-a r)
473 If deltax and deltay are supplied, resize the current frame by
474 that (i.e. move the bottom right corner by the given offsets and
475 then move this frame and resize adjacent frames to make the
476 frames fill the whole screen again.)
477 If in interactive mode no arguments are supplied, resize the cur‐
479 rent frame interactively:
480 Return finish resizing
482 C-g, Escape abort resizing
483 C-n, Down, j grow vertically
484 C-p, Up, k shrink vertically
485 C-f, Right, l grow horizontally
486 C-b, Left, h shrink horizontally
487 s shrink to size of current window
488 While resizing interactively, changes are in multiples of the
490 amount of pixels given by set resizeunit (by default 10).
491 restart
493 Restart sdorfehs.
494 sdump Output the list of all screens. The screens are separated by
496 commas. Each screen is shown as 6 values: its number, its x-
497 coordinate, its y-coordinate, its width, its height and if it is
498 currently selected (1=true, 0=false).
499 select (- | name | number) (C-a ')
501 If a number is given, switch to the window with number number.
502 If a name is given, switch to the window in the current group
503 with name name. Blank the current frame, if - is given.
504 set [variable [value]]
506 If no argument is given, output all sdorfehs variables and their
507 values.
508 If one argument is given, output the value of sdorfehs variable
510 variable. Otherwise set variable to value. What values are
511 valid depends on the variable. See the section VARIABLES later
512 in this document for details.
513 setenv variable value
515 Set the environment variable variable to value. (Environment
516 variables will be passed to all programs started from sdorfehs.)
517 sfdump Output all frames similar to fdump, but not limited to one
519 screen, but all screens at once and with the screen number after
520 each frame.
521 sfrestore frames
523 Replace the current frames with the ones specified in frames in
524 the format as generated by sfdump.
525 shrink Shrink the current frame to the size of the current window with
527 in.
528 split [split] (C-a s)
530 alias for vsplit
531 source file
533 Read file and execute each line as sdorfehs command.
534 sselect screennumber
536 Switch to the screen screennumber. (If you have multiple physi‐
537 cal ones.)
538 stick Mark the current window as sticky in its current frame, making it
540 unavailable to other frames when selecting an available window.
541 swap dest-frame [src-frame] (C-a x)
543 Exchange the window in src-frame (or the current frame if there
544 is no second argument) with the window dest-frame (or ask inter‐
545 actively which frame to swap with if there is no argument).
546 title newname (C-a A)
548 Overwrite the title of the current window with newname. All fol‐
549 lowing sdorfehs commands will only know the window under the new
550 name.
551 unalias alias
553 Remove the alias alias.
554 unbind key
556 alias for
557 undefinekey root key
558 undefinekey keymap key
560 Remove the binding for key from keymap.
561 undo (C-a _, C-a u)
563 Un-do the last change to the frameset. (Like splitting, resiz‐
564 ing, deleting, ...)
565 The amount of steps that can be undone is specified by the vari‐
567 able maxundos.
568 unmanage [name]
570 Add name to the list of unmanaged windows. Thus, windows of this
571 name will not be managed but allowed to choose their position
572 themselves.
573 In non-interactive mode calling it without arguments will print
575 the list.
576 The list can be cleared again by calling clrunmanaged.
578 unsetenv variable
580 Remove variable variable from the list of environment variables.
581 unstick
583 No longer consider the current window as sticky in its current
584 frame, making it again available to appear in other frames.
585 verbexec cmdline
587 Spawn a shell executing cmdline after showing a message with the
588 command.
589 version (C-a v)
591 Output version and compile time information.
592 vselect [vscreenno]
594 Switch to the virtual screen numbered vscreenno.
595 vmove [vscreenno]
597 Move the current window to the virtual screen numbered vscreenno.
598 vsplit [l/p | pixels-from-top | -pixels-from-bottom] (C-a s)
600 Split the current frame into upper frame and a lower frame. If
601 no parameter is given, split in halves. If two numbers separated
602 by a slash (“/”) are given, the upper one is l times the pth part
603 and the lower one (p - l) times the pth part of the prior height.
604 Otherwise the lower one is pixels from bottom wide or the upper
605 one pixels from top high, depending whether there is a “-” in
606 front of the number or not.
607 windows [format] (C-a w)
609 In interactive mode, show the list of all windows in the current
610 group for the duration specified by the variable msgwait. If
611 msgwait was zero, toggle between indefinitely showing and not
612 showing.
613 The messages are shown in columns or rows depending on the value
615 of winliststyle in the format set by set winfmt. The following
616 substitutions happen in format:
617 %a application name (resource name)
619 %c resource class
620 %f frame number
621 %g gravity of the window
622 %h height of the window
623 %H unit to resize the window vertically (height_inc)
624 %i X Window ID
625 %p process ID
626 %l last access number
627 %M string Maxsize, if it specifies a maximum size
628 %n window number
629 %s window status (‘*’ is active window, ‘+’ would be chosen by
630 other, ‘-’ otherwise)
631 %S screen number
632 %t window name (see set winname),
633 %T the string “Transient”, if it is a transient window
634 %w width of the window
635 %W unit to resize the window horizontally (width_inc)
636 %x xrandr screen number
637 %% litteral ‘%’
638 Additionally there can be a positive decimal integer number
640 between the percent sign and the format string to specify the
641 length this value should be truncated to if longer. (For
642 example: %20t)
643 In non-interactive mode, output the list of windows in the cur‐
645 rent group line by line. The format string can be overwritten by
646 the optional parameter format.
647
649 sdorfehs variables can be shown and set with set. The following vari‐
650 ables are supported:
651 barborder pixels
653 Selects how thick the frame around sdorfehs's prompt or message
654 windows is.
655 Default is 1.
657 bargravity nw | w | sw | n | c | s | ne | e | se
659 Select the location where message and prompt bars appear.
660 Default is nw.
662 barinpadding 0 | 1
664 If there is padding, determines whether the bar appears at the
665 edge of the screen (1) or at the edge of the window area (0).
666 Default is 0.
668 barpadding x y
670 Set horizontal padding of sdorfehs windows to x and vertical pad‐
671 ding to y.
672 Default is 14 10.
674 barsticky 0 | 1
676 When set to 1, the bar remains on screen at all times and when
677 messages or lists are not being shown, it displays the output of
678 the current window information formatted with stickyfmt.
679 Default is 1.
681 bgcolor color
683 The background color of the windows sdorfehs creates.
684 Default is black.
686 border pixels
688 Selects how thick the frame around windows is.
689 Default is 1.
691 bwcolor color
693 The border color of unfocused windows.
694 Default is black.
696 fgcolor color
698 The foreground color of the windows sdorfehs creates.
699 Default is #eeeee.
701 font font
703 Make sdorfehs use font font.
704 framefmt format
706 Choose the default format for the window label shown when select‐
707 ing a different frame.
708 Default is Frame %f (%Wx%H).
710 framemsgwait seconds
712 The duration the ‘Current frame’ indicator is shown. If seconds
713 is zero, wait until the next interactive command. If seconds is
714 -1, don't show any message.
715 framesels selectors
717 Override the frame selectors fselect uses. The first character
718 is the selector for the first frame, the second character is the
719 selector for the second frame and so on.
720 Using this variable, one can directly access more than 10 frames.
722 Default is an empty string, which is equivalent to "0123456789".
724 fwcolor color
726 The border color of the focused window.
727 Default is black.
729 gap pixels
731 Specify the number of pixels surrounding each frame, except for
732 the outer edges which border the screen.
733 Default is 20.
735 historysize number
737 Specify maximum number of values kept in input history.
738 Default is 20.
740 ignoreresizehints 0 | 1
742 When set to (1), window resize hints will be ignored, forcing
743 windows to be the exact sizes of their containing frame.
744 Default is 0.
746 inputwidth pixels
748 Determine the width of the input window.
749 Default is 200.
751 maxsizegravity nw | w | sw | n | c | s | ne | e | se
753 Set the default gravity new self-maximized windows will get.
754 Possible values are the same as in the gravity command, which
755 changes the gravity of an existing window: cardinal points or
756 numbers 1 to 9.
757 Default is c.
759 maxundos number
761 The maximal amount of step sdorfehs can undo with the undo com‐
762 mand.
763 Default is 20.
765 msgwait seconds
767 The duration the message window is shown. If seconds is zero,
768 wait infinitely.
769 Default is 3.
771 onlyborder 0 | 1
773 Determine whether to show borders and gaps (1) or not (0) when
774 there is only one frame on the screen.
775 Default is 1.
777 padding left top right bottom
779 Set how much space at the borders of the screen will not be used.
780 Default is 0 0 0 0.
782 resizefmt format
784 Choose the default format for the window label shown when inter‐
785 actively resizing a window.
786 Default is Resize frame (%Wx%H) which shows the window width and
788 height divided by any PResizeInc hints, which for terminals will
789 show the number of columns and lines.
790 resizeunit pixels
792 Set the amount of pixels interactive resize will add/subtract in
793 each step.
794 Default is 5.
796 rudeness number
798 Show or set what kind of windows are allowed to jostle into the
799 foreground.
800 number is a bitwise OR of the following values:
802 1 Transient windows may raise.
804 2 Normal windows may raise.
805 4 New transient windows end up in the foreground.
806 8 New normal windows end up in the foreground.
807 Default is all allowed i.e. 15.
809 startupmessage 0 | 1
811 Decide whether to show a greeting message at startup.
812 The default is 1.
814 stickyfmt format
816 Choose the default format for current window information shown in
817 the bar when the barsticky setting is enabled.
818 Default is %t.
820 topkmap kmap
822 Make kmap the top keymap sdorfehs grabs directly.
823 The default value is top.
825 transgravity nw | w | sw | n | c | s | ne | e | se
827 Set the default gravity new transient windows will get. Possible
828 values are the same as in the gravity command, which changes the
829 gravity of an existing window: cardinal points or numbers 1 to 9.
830 Default is c.
832 vscreens number
834 Set the number of virtual screens.
835 Default is 12.
837 warp 0 | 1
839 Decide if focusing a window moves the rat cursor to the place it
840 had been last time this window was focused, or not.
841 Default is 0 (off).
843 wingravity nw | w | sw | n | c | s | ne | e | se
845 Set the default gravity new normal windows will get. Possible
846 values are the same as in the gravity command, which changes the
847 gravity of an existing window: cardinal points or numbers 1 to 9.
848 Default is nw.
850 waitcursor 0 | 1
852 Determine whether to change the rat cursor when waiting for a key
853 (1) or not (0) See readkey and describekey.
854 Default is 1.
856 winfmt format
858 Choose the default format for the windows command.
859 Default is %n%s%t.
861 winliststyle row | column
863 Determines whether windows are shown in rows or in columns.
864 Default is column.
866 winname title | name | class
868 Choose what is considered the "name" of the window by sdorfehs:
869 title The title of the window.
871 name The resource name of the window.
872 class The resource class i.e. the name of the application.
873 Default is title.
875
877 ~/.config/sdorfehs/config Configuration file read at startup
878 time, if present.
879 ~/.config/sdorfehs/control Unix Socket which accepts remote con‐
881 trol commands sent by sdorfehs -c.
882 ~/.config/sdorfehs/bar FIFO/named pipe which accepts input to
884 show on the sticky bar when barsticky
885 is enabled.
886
888 The sdorfehs utility exits 0 on success, and >0 if an error occurs.
889
891 sdorfehs is maintained by joshua stein <jcs@jcs.org> and is derived from
892 ratpoison which was originally written by Shawn Betts
893 <sabetts@gmail.com>.
894BSD Aug 22, 2019 BSD