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 im‐
50 portant 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 vscreen 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 key Run whenever a top level key is pressed (by default C-a).
97 newwindow
99 Run after a new window is mapped.
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 switchscreen
111 Run when the user switches to a different screen.
112 switchvscreen
114 Run when the user switches to a different virtual 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 be‐
149 longing 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 vscreen that
156 was last accessed and has another resource class but is not cur‐
157 rently 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. De‐
164 fault keymaps are top normally only containing C-a, which reads a
165 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 de‐
181 fault 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 getenv variable
278 Output the value of the environment variable variable.
279 getsel Paste the current X Selection into the current window.
281 gravity [nw | w | sw | n | c | s | ne | e | se]
283 Change how in its frame the current window is aligned.
284 help [keymap]
286 If the optional parameter keymap is given, list all keybindings
287 in this keymap, otherwise list all key bindings in keymap root.
288 hsplit [l/p | [-]pixels] (C-a S)
290 Split the current frame into left frame and a right frame. If no
291 parameter is given, split in halves. If two numbers separated by
292 a slash (‘/’) are given, the left one is l times the pth part and
293 the right one (p - l) times the pth part of the prior width.
294 Otherwise the right half is pixels wide or the left one is pixels
295 wide, depending whether there is ‘-’ in front of the number or
296 not.
297 inext Like next but switch to the next window with the same resource
299 class as the current one. (That means the next window belonging
300 to the same application as the current one.)
301 info (C-a i)
303 Output the current the width, height, window number and window
304 name of the current window. (What name means is chosen by “set
305 winname”.)
306 iprev Like prev but switch to the previous window with the same re‐
308 source class as the current one. (That means the previous window
309 belonging to the same application as the current one.)
310 iother Like other but switch to the window of the current vscreen that
312 was last accessed and has the same resource class but is not cur‐
313 rently visible.
314 kill (C-a K)
316 Close the X-connection of the X-client responsible for the cur‐
317 rent window.
318 lastmsg (C-a m)
320 Reshow the last message.
321 link key [keymap]
323 Do what key is bound to in the keymap keymap if supplied. Other‐
324 wise what key is bound to in keymap root.
325 listhook event
327 List all commands specified with addhook to be executed when even
328 event occurs.
329 meta [key] (C-a t)
331 Send the escape key (that which normally is C-a) to the current
332 window. If a key is specified, this is sent instead. Note that
333 some applications by default ignore the synthetic key that is
334 sent using this command as it is considered a security hole.
335 xterm is one such application.
336 newkmap keymap
338 Generate a new keymap named keymap. This keymap can be used to
339 add new key-command mappings to it with definekey and can be
340 called with readkey.
341 next (C-a Return | C-a n | C-a space)
343 Switch to the next window in the current vscreen.
344 nextscreen (C-a N)
346 Switch to the next screen. (If you have multiple physical ones.)
347 number new [old]
349 Give the number new to the window with the number old or the cur‐
350 rent window.
351 only (C-a Q)
353 Remove all frames on the current screen except the current frame
354 and maximize this one to the size of the whole screen.
355 other (C-a C-a)
357 Switch to the window of the current vscreen that was last ac‐
358 cessed but is not currently visible.
359 prev (C-a p)
361 Switch to the previous window in the current vscreen.
362 prevscreen (C-a P)
364 Switch to the previous screen. (If you have multiple physical
365 ones.)
366 prompt [prompt]
368 sdorfehs will ask the user for input, showing prompt (or a single
369 colon, if no argument is given) and output the input the user has
370 made. Note that this command probably does not make much sense
371 in interactive mode.
372 putsel x-selection
374 Replace the X selection with the text x-selection. It can be in‐
375 serted into the current window with getsel.
376 quit Quit sdorfehs.
378 ratinfo
380 Display the x y coordinates of the rat cursor relative to the
381 screen.
382 ratrelinfo
384 Display the x y coordinates of the rat cursor relative to the
385 current window or current frame if no window is focused
386 ratwarp x y
388 Move the rat cursor to the position (x, y).
389 ratrelwarp deltax deltay
391 Move the rat cursor to (deltax, deltay), relative to the current
392 position.
393 ratclick [button]
395 Simulate a rat click with button (button 1=left button if none
396 given).
397 rathold (up | down) [button]
399 Simulate pressing|releasing rat button button (1=left button if
400 none given).
401 readkey keymap
403 Grab the next key pressed, and execute the command associated to
404 this key in keymap. To show it is waiting for a key, sdorfehs
405 will change the rat cursor to a square if waitcursor is set.
406 This command is perhaps best described with its usage in the de‐
407 fault configuration: by pressing C-a, which is the only key in
408 the keymap top , the command "readkey root" is executed. The
409 next key then executes the command in keymap root belonging to
410 this command.
411 redisplay (C-a l)
413 Extend the current window to the whole size of its current frame
414 and redisplay it. (Useful to redisplay normal windows or bring
415 transient windows to the full size of the frame as only normal
416 windows are maximized by sdorfehs)
417 redo (C-a U)
419 Revert the last undo of frame changes.
420 remhook event command
422 Remove command command from the list of commands to be called
423 when event event is hit. (The command has to specified, as an
424 event can have multiple commands attached to it.) Use "listhook
425 hook" to get a list of all attached commands.
426 remove (C-a R)
428 Remove the current frame and extend some frames around to fill
429 the remaining gap.
430 resize [deltax deltay] (C-a r)
432 If deltax and deltay are supplied, resize the current frame by
433 that (i.e. move the bottom right corner by the given offsets and
434 then move this frame and resize adjacent frames to make the
435 frames fill the whole screen again.)
436 If in interactive mode no arguments are supplied, resize the cur‐
438 rent frame interactively:
439 Return finish resizing
441 C-g, Escape abort resizing
442 C-n, Down, j grow vertically
443 C-p, Up, k shrink vertically
444 C-f, Right, l grow horizontally
445 C-b, Left, h shrink horizontally
446 s shrink to size of current window
447 While resizing interactively, changes are in multiples of the
449 amount of pixels given by set resizeunit (by default 10).
450 restart
452 Restart sdorfehs.
453 sdump Output the list of all screens. The screens are separated by
455 commas. Each screen is shown as 6 values: its number, its x-co‐
456 ordinate, its y-coordinate, its width, its height and if it is
457 currently selected (1=true, 0=false).
458 select (- | name | number) (C-a ')
460 If a number is given, switch to the window with number number.
461 If a name is given, switch to the window in the current vscreen
462 with name name. Blank the current frame, if - is given.
463 set [variable [value]]
465 If no argument is given, output all sdorfehs variables and their
466 values.
467 If one argument is given, output the value of sdorfehs variable
469 variable. Otherwise set variable to value. What values are
470 valid depends on the variable. See the section VARIABLES later
471 in this document for details.
472 setenv variable value
474 Set the environment variable variable to value. (Environment
475 variables will be passed to all programs started from sdorfehs.)
476 sfdump Output all frames similar to fdump, but not limited to one
478 screen, but all screens at once and with the screen number after
479 each frame.
480 sfrestore frames
482 Replace the current frames with the ones specified in frames in
483 the format as generated by sfdump.
484 shrink Shrink the current frame to the size of the current window with
486 in.
487 split [split] (C-a s)
489 alias for vsplit
490 source file
492 Read file and execute each line as sdorfehs command.
493 sselect screennumber
495 Switch to the screen screennumber. (If you have multiple physi‐
496 cal ones.)
497 smove [screen]
499 Move the current window to the current frame and vscreen on
500 screen screen and focus it.
501 stick Mark the current window as sticky in its current frame, making it
503 unavailable to other frames when selecting an available window.
504 swap dest-frame [src-frame] (C-a x)
506 Exchange the window in src-frame (or the current frame if there
507 is no second argument) with the window dest-frame (or ask inter‐
508 actively which frame to swap with if there is no argument).
509 title newname (C-a A)
511 Overwrite the title of the current window with newname. All fol‐
512 lowing sdorfehs commands will only know the window under the new
513 name.
514 unalias alias
516 Remove the alias alias.
517 unbind key
519 alias for
520 undefinekey root key
521 undefinekey keymap key
523 Remove the binding for key from keymap.
524 undo (C-a _, C-a u)
526 Un-do the last change to the frameset. (Like splitting, resiz‐
527 ing, deleting, ...)
528 The amount of steps that can be undone is specified by the vari‐
530 able maxundos.
531 unmanage [name]
533 Add name to the list of unmanaged windows. Thus, windows of this
534 name will not be managed but allowed to choose their position
535 themselves.
536 In non-interactive mode calling it without arguments will print
538 the list.
539 The list can be cleared again by calling clrunmanaged.
541 unsetenv variable
543 Remove variable variable from the list of environment variables.
544 unstick
546 No longer consider the current window as sticky in its current
547 frame, making it again available to appear in other frames.
548 verbexec cmdline
550 Spawn a shell executing cmdline after showing a message with the
551 command.
552 version (C-a v)
554 Output version and compile time information.
555 vmove [vscreen]
557 Move the current window to the current frame on vscreen vscreen
558 and switch to it.
559 vrename
561 Rename current vscreen.
562 vscreens
564 Output a list of all vscreens with their number.
565 vselect vscreen
567 Select the vscreen named vscreen.
568 vsplit [l/p | pixels-from-top | -pixels-from-bottom] (C-a s)
570 Split the current frame into upper frame and a lower frame. If
571 no parameter is given, split in halves. If two numbers separated
572 by a slash (“/”) are given, the upper one is l times the pth part
573 and the lower one (p - l) times the pth part of the prior height.
574 Otherwise the lower one is pixels from bottom wide or the upper
575 one pixels from top high, depending whether there is a “-” in
576 front of the number or not.
577 windows [format] (C-a w)
579 In interactive mode, show the list of all windows in the current
580 vscreen for the duration specified by the variable msgwait. If
581 msgwait was zero, toggle between indefinitely showing and not
582 showing.
583 The messages are shown in columns or rows depending on the value
585 of winliststyle in the format set by set winfmt. The following
586 substitutions happen in format:
587 %a application name (resource name)
589 %c resource class
590 %f frame number
591 %g gravity of the window
592 %h height of the window
593 %H unit to resize the window vertically (height_inc)
594 %i X Window ID
595 %p process ID
596 %l last access number
597 %M string Maxsize, if it specifies a maximum size
598 %n window number
599 %s window status (‘*’ is active window, ‘+’ would be chosen by
600 other, ‘-’ otherwise)
601 %S screen number
602 %t window name (see set winname),
603 %T the string “Transient”, if it is a transient window
604 %w width of the window
605 %W unit to resize the window horizontally (width_inc)
606 %x xrandr screen number
607 %% litteral ‘%’
608 Additionally there can be a positive decimal integer number be‐
610 tween the percent sign and the format string to specify the
611 length this value should be truncated to if longer. (For
612 example: %20t)
613 In non-interactive mode, output the list of windows in the cur‐
615 rent vscreen line by line. The format string can be overwritten
616 by the optional parameter format.
617
619 sdorfehs variables can be shown and set with set. The following vari‐
620 ables are supported:
621 barborder pixels
623 Selects how thick the frame around sdorfehs's bar, prompt, and
624 message windows is.
625 Default is 1.
627 barbordercolor color
629 The color of the bar, prompt, and message windows sdorfehs cre‐
630 ates.
631 Default is black.
633 bargravity nw | w | sw | n | c | s | ne | e | se
635 Select the location where message and prompt bars appear.
636 Default is nw.
638 barinpadding 0 | 1
640 If there is padding, determines whether the bar appears at the
641 edge of the screen (1) or at the edge of the window area (0).
642 Default is 1.
644 barpadding x y
646 Set horizontal padding of sdorfehs windows to x and vertical pad‐
647 ding to y.
648 Default is 14 10.
650 barsticky 0 | 1
652 When set to 1, the bar remains on screen at all times and when
653 messages or lists are not being shown, it displays the output of
654 the current window information formatted with stickyfmt.
655 Default is 1.
657 bgcolor color
659 The background color of the windows sdorfehs creates.
660 Default is black.
662 border pixels
664 Selects how thick the frame around windows is.
665 Default is 1.
667 bwcolor color
669 The border color of unfocused windows.
670 Default is black.
672 fgcolor color
674 The foreground color of the windows sdorfehs creates.
675 Default is #eeeee.
677 font font
679 Make sdorfehs use font font.
680 framefmt format
682 Choose the default format for the window label shown when select‐
683 ing a different frame.
684 Default is Frame %f (%Wx%H).
686 framemsgwait seconds
688 The duration the ‘Current frame’ indicator is shown. If seconds
689 is zero, wait until the next interactive command. If seconds is
690 -1, don't show any message.
691 framesels selectors
693 Override the frame selectors fselect uses. The first character
694 is the selector for the first frame, the second character is the
695 selector for the second frame and so on.
696 Using this variable, one can directly access more than 10 frames.
698 Default is an empty string, which is equivalent to "0123456789".
700 fwcolor color
702 The border color of the focused window.
703 Default is black.
705 gap pixels
707 Specify the number of pixels surrounding each frame, except for
708 the outer edges which border the screen or its padding.
709 Default is 20.
711 historysize number
713 Specify maximum number of values kept in input history.
714 Default is 20.
716 ignoreresizehints 0 | 1
718 When set to (1), window resize hints will be ignored, forcing
719 windows to be the exact sizes of their containing frame.
720 Default is 0.
722 inputwidth pixels
724 Determine the width of the input window.
725 Default is 200.
727 maxsizegravity nw | w | sw | n | c | s | ne | e | se
729 Set the default gravity new self-maximized windows will get.
730 Possible values are the same as in the gravity command, which
731 changes the gravity of an existing window: cardinal points or
732 numbers 1 to 9.
733 Default is c.
735 maxundos number
737 The maximal amount of step sdorfehs can undo with the undo com‐
738 mand.
739 Default is 20.
741 msgwait seconds
743 The duration the message window is shown. If seconds is zero,
744 wait infinitely.
745 Default is 3.
747 onlyborder 0 | 1
749 Determine whether to show borders and gaps (1) or not (0) when
750 there is only one frame on the screen.
751 Default is 1.
753 padding left top right bottom
755 Set how much space at the borders of the screen will not be used.
756 Default is 20 20 20 20.
758 resizefmt format
760 Choose the default format for the window label shown when inter‐
761 actively resizing a window.
762 Default is Resize frame (%Wx%H) which shows the window width and
764 height divided by any PResizeInc hints, which for terminals will
765 show the number of columns and lines.
766 resizeunit pixels
768 Set the amount of pixels interactive resize will add/subtract in
769 each step.
770 Default is 5.
772 rudeness number
774 Show or set what kind of windows are allowed to jostle into the
775 foreground.
776 number is a bitwise OR of the following values:
778 1 Transient windows may raise.
780 2 Normal windows may raise.
781 4 New transient windows end up in the foreground.
782 8 New normal windows end up in the foreground.
783 Default is all allowed i.e. 15.
785 startupmessage 0 | 1
787 Decide whether to show a greeting message at startup.
788 The default is 1.
790 stickyfmt format
792 Choose the default format for current window information shown in
793 the bar when the barsticky setting is enabled.
794 Default is %t.
796 topkmap kmap
798 Make kmap the top keymap sdorfehs grabs directly.
799 The default value is top.
801 transgravity nw | w | sw | n | c | s | ne | e | se
803 Set the default gravity new transient windows will get. Possible
804 values are the same as in the gravity command, which changes the
805 gravity of an existing window: cardinal points or numbers 1 to 9.
806 Default is c.
808 vscreens number
810 Set the number of virtual screens (vscreens).
811 Default is 12.
813 warp 0 | 1
815 Decide if focusing a window moves the rat cursor to the place it
816 had been last time this window was focused, or not.
817 Default is 0 (off).
819 wingravity nw | w | sw | n | c | s | ne | e | se
821 Set the default gravity new normal windows will get. Possible
822 values are the same as in the gravity command, which changes the
823 gravity of an existing window: cardinal points or numbers 1 to 9.
824 Default is nw.
826 waitcursor 0 | 1
828 Determine whether to change the rat cursor when waiting for a key
829 (1) or not (0) See readkey and describekey.
830 Default is 1.
832 winfmt format
834 Choose the default format for the windows command.
835 Default is %n%s%t.
837 winliststyle row | column
839 Determines whether windows are shown in rows or in columns.
840 Default is column.
842 winname title | name | class
844 Choose what is considered the "name" of the window by sdorfehs:
845 title The title of the window.
847 name The resource name of the window.
848 class The resource class i.e. the name of the application.
849 Default is title.
851
853 ~/.config/sdorfehs/config
854 Configuration file read at startup time, if present.
855 ~/.config/sdorfehs/control
857 Unix socket which accepts remote control commands sent by
858 sdorfehs -c.
859 ~/.config/sdorfehs/bar
861 FIFO/named pipe which accepts input to show on the sticky bar
862 when barsticky is enabled.
863
865 The sdorfehs utility exits 0 on success, and >0 if an error occurs.
866
868 sdorfehs is maintained by joshua stein <jcs@jcs.org> and is derived from
869 ratpoison which was originally written by Shawn Betts
870 <sabetts@gmail.com>.
871BSD Aug 22, 2019 BSD